OptionalapplyOptionalcommitMaterialize a new node from drag-rect bounds (drag-to-insert tools).
Optional — hooks that don't drive insertion (e.g. useClone,
read-only clipboard) won't call it, and sceneToAdapter only fills
it in when options.commitInsert is supplied. Hooks that do call
it (insert tools) document the requirement at their own surface.
OptionalcommitMaterialize one or more new nodes from a clipboard snapshot. Optional
— required by useClipboard.paste, ignored by other consumers.
Optionalctx: { dropPoint?: { worldX: number; worldY: number } }OptionalfindOptionalgetOptional: direct children of id. When present (alongside the
cascadeWorldPose option on useMove), dragging a node
auto-cascades its descendants in the live overlay so structurally-
grouped children visually follow the parent during the drag. No
additional ops are generated — children's local poses don't change
when the parent's local pose moves.
OptionalgetOptional: layout strategy attached to a container, or null if the
container uses absolute positioning (default behavior). When present,
useMove uses the strategy to compute drop targets, sibling reflow,
and the commit op batch when a drag ends over the container.
Enumerate all nodes. <Canvas> derives a default rect-pose pickEvery
and the scene-iteration loop from this.
OptionalgetOptional. Required only by hierarchy-aware paths: layout-pass drop
targeting (getLayout present), nested-hit collapse
(pickTopMostHit), and group-pose composition. Flat scenes may omit.
OptionalgetReturns the current selection. Used by clone behaviors.
OptionalhitReturns ids of nodes intersecting the world-space rect.
OptionalhitHit-test against a closed polygon. Vertex order may be CW or CCW; the closing edge from last → first is implicit.
OptionalsetOptional. Used only by reparent ops (e.g. drag-into-container drops via layout strategies). Flat scenes that never reparent may omit.
Mutator wired by setSelection ops batched alongside paste.
OptionalsnapshotSnapshot the current selection into the clipboard payload shape.
Optional — required by useClipboard.copy / cut and useClone's
ghost capture, ignored by other consumers.
Combined adapter satisfying every narrow adapter the kit ships. Methods with no default implementation (e.g.
commitInsertwithoutcreateDefault) return null/[]/noop — sufficient to typecheck againstInsertAdapter/AreaSelectAdapter, and the corresponding gesture hook simply produces no commit.