<assembly.drawing.stage />

assembly.drawing.stage names a reusable selection of assembled parts and board substrates. Put it inside the owning assembly and select it with assembly.drawing.partview stageRef=".complete".

import { assembly } from "@tscircuit/core"
export default () => <assembly.device name="case">
  <board name="carrier" width={30} height={24}><hole name="H1" diameter={3} pcbX={8} pcbY={6} /></board>
  <assembly.part name="cover" cadModel={{jscad: {type: "cuboid", size: [28, 22, 2]}, positionOffset: {x: 0, y: 0, z: 6}}} />
  <assembly.part name="bolt" cadModel={{jscad: {type: "cylinder", radius: 1.5, height: 8}, positionOffset: {x: 8, y: 6, z: 4}}} />
  <assembly.explosion.stage name="lift-cover">
    <assembly.explosion.move targetRefs="cover, bolt" offZ={12} />
  </assembly.explosion.stage>
  <assembly.explosion.stage name="remove-bolt" prevStageRef="lift-cover">
    <assembly.explosion.move targetRefs="bolt" offZ={8} />
    <assembly.explosion.move targetRefs="bolt" offX={6} />
  </assembly.explosion.stage>
  <assembly.drawing.stage name="hardware" partRefs={[".cover", ".bolt"]} />
  <assembly.drawing.stage name="complete" boardRefs={[".carrier"]} includeStageRefs={[".hardware"]} />
  <assembly.drawing.page name="explosion" width={200} height={130} anchorAlignment="bottom_left">
    <assembly.drawing.partview name="assembled" stageRef=".complete" direction="isometric" centerX={50} centerY={65} width={72} height={85} />
    <assembly.drawing.explosionview name="exploded" stageRef="case.remove-bolt" direction="isometric" centerX={145} centerY={65} width={72} height={85} showTrails>
      <assembly.drawing.partlabel text="Cover" partRefs={[".cover"]} anchor={{x: 0, y: 0, z: 7}} xOffsetFromViewCenter={-35} yOffsetFromViewCenter={35} />
      <assembly.drawing.dimension heightOfView />
      <assembly.drawing.note text="Inherited moves" xOffsetFromViewCenter={-25} yOffsetFromViewCenter={-54} />
    </assembly.drawing.explosionview>
  </assembly.drawing.page>
  <assembly.drawing.page name="assembled-pose" width={100} height={100}>
    <assembly.drawing.explosionview stageRef="remove-bolt" factor={0} direction="isometric" width={80} height={80} />
  </assembly.drawing.page>
</assembly.device>

Here hardware contains the cover and bolt. complete includes that stage plus the carrier board. The left view shows this assembled selection; the right view inherits movement from the separate explosion-stage definitions.

Properties

Property	Description
`name`	Required name used by `stageRef` and `includeStageRefs` selectors.
`displayName`	Optional human-readable label.
`partRefs`	Array of component or assembly selectors, such as `[".cover", ".bolt"]`.
`boardRefs`	Array of board-substrate selectors, such as `[".carrier"]`.
`includeStageRefs`	Array of other drawing-stage selectors to include, such as `[".hardware"]`.

Provide at least one nonempty selection array. Nested selections are combined as a set, so repeated members appear once. Missing or ambiguous references and inclusion cycles are errors.

For a populated board, use partRefs={[".carrier"]} for its fitted parts and boardRefs={[".carrier"]} for its substrate. A board reference alone does not add component models.

Drawing stages describe membership, with no playback order or motion. Use assembly.explosion.stage for movement, and explosionview to draw its resulting pose.

Properties​

Properties