@weasel-js/core 1.13.0-rc.0 → 1.14.0

package/dist/canvas/affordanceAt.js.map

@@ -1 +1 @@
-{"version":3,"file":"affordanceAt.js","names":[],"sources":["../../src/canvas/affordanceAt.ts"],"sourcesContent":["/**\n * The dispatcher-side affordance classifier: answers \"what piece of selection\n * chrome is under this world point?\" by assembling the kit's affordances and\n * running the one shared walk (`hitAffordanceRegions`).\n */\n\nimport type { BodyClassification } from '@weasel-js/gestures';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { EditAnchorsDep } from 'interactions/actions/depSchema';\nimport type { View } from 'core/viewport/view';\nimport type { AffordanceHit } from '@weasel-js/routing';\nimport type { Affordance, CommonAffordanceScratch, LayerHit } from 'affordances/types';\nimport { hitAffordanceRegions, type AffordanceRegionHit } from 'affordances/hitAffordanceRegions';\nimport { createCornerResizeAffordance } from 'affordances/cornerResize';\nimport { createRotationAffordance } from 'affordances/rotationHandle';\nimport { createPathAnchorAffordances, type AnchorState } from 'affordances/pathAnchors';\nimport { targetSizesPx } from 'core/device/targets';\n\nexport type { AnchorState };\n\n/** What decides the kit's chrome affordances — their sizes and which ones\n *  exist. Shared by the hit-test and the slops overlay, which draws them. */\nexport interface ChromeAffordanceOptions {\n  /** Pointer-size multiplier from the live `DeviceProfile`. Every default\n   *  below is resolved through {@link targetSizesPx} at this scale, so the\n   *  grab zone tracks the painted chrome on a coarse pointer. Default 1. */\n  targetScale?: number;\n  /** Corner-handle hit radius in screen px. Overrides the device-scaled default. */\n  handleHitRadius?: number;\n  /** Anchor / control hit radius in screen px. Overrides the device-scaled default. */\n  anchorHitRadius?: number;\n  /** Minimum rotate-band thickness outside the selection AABB, in screen px.\n   *  Overrides the device-scaled default. */\n  rotateBandPx?: number;\n  /** The rotate badge the selection overlay paints (`rotationBadgeOf`), so\n   *  it can be grabbed where it is drawn. Omitted or null, only the rotate\n   *  ring is hit-tested. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n  /** Resize handles at the edge midpoints as well as the corners. Default true. */\n  edgeHandles?: boolean;\n  /** Anchor-editing state. When omitted, anchors aren't hit-tested. */\n  getAnchorState?: () => AnchorState | null;\n}\n\nexport interface BuildAffordanceAtOptions extends ChromeAffordanceOptions {\n  /** Live ChromeState at call time — current selection plus effective bounds,\n   *  including in-flight move/resize ghost poses. */\n  getChromeState: () => ChromeState;\n  /** Live view. Needed because region hit radii and the rotate band are\n   *  declared in screen pixels and resolved against the current scale. */\n  getView: () => View;\n  /** The affordances to walk, when the caller built them itself to share\n   *  them (`chromeAffordances`). Otherwise built from these options. */\n  affordances?: readonly Affordance[];\n  /** Chrome-caps resolver. Keeps the hit-test and the renderer agreeing on\n   *  which chrome is live (resize handles gated by\n   *  `'selection.resize-handles'`, rotation by `'selection.rotation-handle'`,\n   *  anchors by `'path-edit.anchors'`). Omitting defaults to always-visible. */\n  getIsVisible?: () => (id: string) => boolean;\n}\n\n/**\n * The kit's selection chrome as affordances, bottom → top: rotate ring (and\n * badge), resize handles, then anchors and their controls — a corner handle\n * beats the rotate band it sits inside, and a control handle beats everything.\n */\nexport function chromeAffordances(opts: ChromeAffordanceOptions = {}): Affordance[] {\n  const sizes = targetSizesPx(opts.targetScale);\n  const {\n    handleHitRadius = sizes.handle,\n    anchorHitRadius = sizes.anchor,\n    rotateBandPx = sizes.rotationDistance,\n    getAnchorState,\n    rotationBadge,\n    edgeHandles = true,\n  } = opts;\n  return [\n    createRotationAffordance({\n      bandPx: rotateBandPx,\n      paint: null,\n      ...(rotationBadge\n        ? { handle: { distancePx: rotationBadge.distancePx, hitRadiusPx: rotationBadge.sizePx } }\n        : {}),\n    }),\n    createCornerResizeAffordance({ handleHitRadius, edges: edgeHandles }),\n    ...(getAnchorState\n      ? createPathAnchorAffordances(getAnchorState, { hitRadius: anchorHitRadius })\n      : []),\n  ];\n}\n\n/**\n * Read anchor-editing state off a dep registry, for\n * {@link ChromeAffordanceOptions.getAnchorState}. Returns `null` while no\n * `editAnchors` dep is registered, so anchors are not hit-tested.\n */\nexport function anchorStateFrom(\n  getRegistry: () => { get(name: 'editAnchors'): EditAnchorsDep | undefined } | null,\n  /** The editable path in the world the hit-test is asked in. A node on a\n   *  parallax plane stores its path in the plane's world; the surface carries\n   *  it into the asking camera's. Default: unchanged. */\n  toCamera?: (id: string, path: unknown) => unknown,\n): () => AnchorState | null {\n  return () => {\n    const dep = getRegistry()?.get('editAnchors');\n    if (!dep) return null;\n    return {\n      editingId: dep.editingId ?? null,\n      tool: dep.tool ?? null,\n      // The hit-test reads world-coord anchor positions, so route through\n      // `getEditablePath`: both pose-as-polygon and `data.path` consumers\n      // resolve correctly.\n      getPose: (id) => (toCamera ? toCamera(id, dep.getEditablePath(id)) : dep.getEditablePath(id)),\n      getNode: (id) => dep.getNodeShape(id),\n      ...(dep.extensions ? { extensions: dep.extensions } : {}),\n      getOutline: (id) => {\n        const path = dep.getOutlinePath?.(id) ?? dep.getEditablePath(id);\n        return toCamera ? toCamera(id, path) : path;\n      },\n    };\n  };\n}\n\n/**\n * Build the `affordanceAt` thunk for `useSceneGestureDispatcher`. The point is\n * **world-space**; callers convert from client coords first. Priority follows\n * the order of {@link chromeAffordances}, topmost first.\n */\nexport function buildAffordanceAt(\n  opts: BuildAffordanceAtOptions,\n): (worldPoint: { x: number; y: number }) => AffordanceHit | null {\n  const { getChromeState, getView, getIsVisible } = opts;\n  const affordances = opts.affordances ?? chromeAffordances(opts);\n\n  return function affordanceAt({ x: wx, y: wy }) {\n    const hit = hitAffordanceRegions(\n      affordances,\n      wx,\n      wy,\n      getChromeState(),\n      getView(),\n      getIsVisible?.(),\n    );\n    return hit ? toAffordanceHit(hit) : null;\n  };\n}\n\n/**\n * Region hit → `AffordanceHit`. The scratch fields named by\n * {@link CommonAffordanceScratch} are lifted onto the hit because the actions\n * that consume them read them there; the whole scratch rides along as `payload`.\n */\nfunction toAffordanceHit(hit: AffordanceRegionHit): AffordanceHit {\n  const scratch = (hit.binding.initialScratch ?? {}) as CommonAffordanceScratch;\n  return {\n    kind: hit.region.hitKind ?? `${hit.affordanceId}:${hit.regionId}`,\n    owner: hit.affordanceId,\n    strength: 'shared',\n    ...(scratch.targetId !== undefined ? { targetIds: [scratch.targetId] } : {}),\n    ...(scratch.anchor !== undefined ? { anchor: scratch.anchor } : {}),\n    ...(scratch.fixedPoint !== undefined ? { fixedPoint: scratch.fixedPoint } : {}),\n    ...(hit.cursor !== undefined ? { cursor: hit.cursor } : {}),\n    ...(hit.binding.initialScratch !== undefined ? { payload: hit.binding.initialScratch } : {}),\n  } as AffordanceHit;\n}\n\n/**\n * Classify a world-space point against the current selection: `'empty'`,\n * `'selected-body'`, or `'unselected-body'`.\n *\n * @param kindOfNode - Resolver from a hit node id to its semantic kind.\n *   Omitting it leaves `kind` undefined, which makes every `kind:` TargetSpec\n *   form no-match.\n * @param doubleClickNames - The node a double-click on a hit names\n *   (`doubleClickTarget`). Where that is another node, it rides along as\n *   `doubleClick`, classified the same way.\n */\nexport function buildClassifyTarget(\n  getSelection: () => readonly string[],\n  pickBest: (wx: number, wy: number) => string | null,\n  kindOfNode?: (id: string) => string | undefined,\n  doubleClickNames?: (hitId: string) => string,\n): (worldPoint: { x: number; y: number }) => BodyClassification {\n  return function classifyTarget({ x: wx, y: wy }) {\n    const hitId = pickBest(wx, wy);\n    if (!hitId) return { body: 'empty' };\n    const sel = getSelection();\n    const classify = (id: string) => ({\n      body: sel.includes(id) ? 'selected-body' as const : 'unselected-body' as const,\n      kind: kindOfNode?.(id),\n      id,\n    });\n    const named = doubleClickNames?.(hitId);\n    return named !== undefined && named !== hitId\n      ? { ...classify(hitId), doubleClick: classify(named) }\n      : classify(hitId);\n  };\n}\n\n/** A registered layer's claim on a point, as the affordance the dispatcher\n *  routes: its kind names the layer, and it carries what the layer's hit-test\n *  resolved. */\nexport function layerAffordance(layerId: string, claim: LayerHit): AffordanceHit {\n  return {\n    kind: `layer:${layerId}`,\n    owner: layerId,\n    strength: claim.strength ?? 'shared',\n    ...(claim.claimedKinds !== undefined ? { claimedKinds: claim.claimedKinds } : {}),\n    ...(claim.cursor !== undefined ? { cursor: claim.cursor } : {}),\n    ...(claim.initialScratch !== undefined ? { payload: claim.initialScratch } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"affordanceAt.js","names":[],"sources":["../../src/canvas/affordanceAt.ts"],"sourcesContent":["/**\n * The dispatcher-side affordance classifier: answers \"what piece of selection\n * chrome is under this world point?\" by assembling the kit's affordances and\n * running the one shared walk (`hitAffordanceRegions`).\n */\n\nimport type { BodyClassification } from '@weasel-js/gestures';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { EditAnchorsDep } from 'interactions/actions/depSchema';\nimport type { View } from 'core/viewport/view';\nimport type { AffordanceHit, WorldPoint } from '@weasel-js/routing';\nimport type { Affordance, CommonAffordanceScratch, LayerHit } from 'affordances/types';\nimport { hitAffordanceRegions, type AffordanceRegionHit } from 'affordances/hitAffordanceRegions';\nimport { createCornerResizeAffordance } from 'affordances/cornerResize';\nimport { createRotationAffordance } from 'affordances/rotationHandle';\nimport { createPathAnchorAffordances, type AnchorState } from 'affordances/pathAnchors';\nimport { targetSizesPx } from 'core/device/targets';\n\nexport type { AnchorState };\n\n/** What decides the kit's chrome affordances — their sizes and which ones\n *  exist. Shared by the hit-test and the slops overlay, which draws them. */\nexport interface ChromeAffordanceOptions {\n  /** Pointer-size multiplier from the live `DeviceProfile`. Every default\n   *  below is resolved through {@link targetSizesPx} at this scale, so the\n   *  grab zone tracks the painted chrome on a coarse pointer. Default 1. */\n  targetScale?: number;\n  /** Corner-handle hit radius in screen px. Overrides the device-scaled default. */\n  handleHitRadius?: number;\n  /** Anchor / control hit radius in screen px. Overrides the device-scaled default. */\n  anchorHitRadius?: number;\n  /** Minimum rotate-band thickness outside the selection AABB, in screen px.\n   *  Overrides the device-scaled default. */\n  rotateBandPx?: number;\n  /** The rotate badge the selection overlay paints (`rotationBadgeOf`), so\n   *  it can be grabbed where it is drawn. Omitted or null, only the rotate\n   *  ring is hit-tested. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n  /** Resize handles at the edge midpoints as well as the corners. Default true. */\n  edgeHandles?: boolean;\n  /** Anchor-editing state. When omitted, anchors aren't hit-tested. */\n  getAnchorState?: () => AnchorState | null;\n}\n\nexport interface BuildAffordanceAtOptions extends ChromeAffordanceOptions {\n  /** Live ChromeState at call time — current selection plus effective bounds,\n   *  including in-flight move/resize ghost poses. */\n  getChromeState: () => ChromeState;\n  /** Live view. Needed because region hit radii and the rotate band are\n   *  declared in screen pixels and resolved against the current scale. */\n  getView: () => View;\n  /** The affordances to walk, when the caller built them itself to share\n   *  them (`chromeAffordances`). Otherwise built from these options. */\n  affordances?: readonly Affordance[];\n  /** Chrome-caps resolver. Keeps the hit-test and the renderer agreeing on\n   *  which chrome is live (resize handles gated by\n   *  `'selection.resize-handles'`, rotation by `'selection.rotation-handle'`,\n   *  anchors by `'path-edit.anchors'`). Omitting defaults to always-visible. */\n  getIsVisible?: () => (id: string) => boolean;\n}\n\n/**\n * The kit's selection chrome as affordances, bottom → top: rotate ring (and\n * badge), resize handles, then anchors and their controls — a corner handle\n * beats the rotate band it sits inside, and a control handle beats everything.\n */\nexport function chromeAffordances(opts: ChromeAffordanceOptions = {}): Affordance[] {\n  const sizes = targetSizesPx(opts.targetScale);\n  const {\n    handleHitRadius = sizes.handle,\n    anchorHitRadius = sizes.anchor,\n    rotateBandPx = sizes.rotationDistance,\n    getAnchorState,\n    rotationBadge,\n    edgeHandles = true,\n  } = opts;\n  return [\n    createRotationAffordance({\n      bandPx: rotateBandPx,\n      paint: null,\n      ...(rotationBadge\n        ? { handle: { distancePx: rotationBadge.distancePx, hitRadiusPx: rotationBadge.sizePx } }\n        : {}),\n    }),\n    createCornerResizeAffordance({ handleHitRadius, edges: edgeHandles }),\n    ...(getAnchorState\n      ? createPathAnchorAffordances(getAnchorState, { hitRadius: anchorHitRadius })\n      : []),\n  ];\n}\n\n/**\n * Read anchor-editing state off a dep registry, for\n * {@link ChromeAffordanceOptions.getAnchorState}. Returns `null` while no\n * `editAnchors` dep is registered, so anchors are not hit-tested.\n */\nexport function anchorStateFrom(\n  getRegistry: () => { get(name: 'editAnchors'): EditAnchorsDep | undefined } | null,\n  /** The editable path in the world the hit-test is asked in. A node on a\n   *  parallax plane stores its path in the plane's world; the surface carries\n   *  it into the asking camera's. Default: unchanged. */\n  toCamera?: (id: string, path: unknown) => unknown,\n): () => AnchorState | null {\n  return () => {\n    const dep = getRegistry()?.get('editAnchors');\n    if (!dep) return null;\n    return {\n      editingId: dep.editingId ?? null,\n      tool: dep.tool ?? null,\n      // The hit-test reads world-coord anchor positions, so route through\n      // `getEditablePath`: both pose-as-polygon and `data.path` consumers\n      // resolve correctly.\n      getPose: (id) => (toCamera ? toCamera(id, dep.getEditablePath(id)) : dep.getEditablePath(id)),\n      getNode: (id) => dep.getNodeShape(id),\n      ...(dep.extensions ? { extensions: dep.extensions } : {}),\n      getOutline: (id) => {\n        const path = dep.getOutlinePath?.(id) ?? dep.getEditablePath(id);\n        return toCamera ? toCamera(id, path) : path;\n      },\n    };\n  };\n}\n\n/**\n * Build the `affordanceAt` thunk for `useSceneGestureDispatcher`. The point is\n * **world-space**; callers convert from client coords first. Priority follows\n * the order of {@link chromeAffordances}, topmost first.\n */\nexport function buildAffordanceAt(\n  opts: BuildAffordanceAtOptions,\n): (worldPoint: WorldPoint) => AffordanceHit | null {\n  const { getChromeState, getView, getIsVisible } = opts;\n  const affordances = opts.affordances ?? chromeAffordances(opts);\n\n  return function affordanceAt({ x: wx, y: wy }) {\n    const hit = hitAffordanceRegions(\n      affordances,\n      wx,\n      wy,\n      getChromeState(),\n      getView(),\n      getIsVisible?.(),\n    );\n    return hit ? toAffordanceHit(hit) : null;\n  };\n}\n\n/**\n * Region hit → `AffordanceHit`. The scratch fields named by\n * {@link CommonAffordanceScratch} are lifted onto the hit because the actions\n * that consume them read them there; the whole scratch rides along as `payload`.\n */\nfunction toAffordanceHit(hit: AffordanceRegionHit): AffordanceHit {\n  const scratch = (hit.binding.initialScratch ?? {}) as CommonAffordanceScratch;\n  return {\n    kind: hit.region.hitKind ?? `${hit.affordanceId}:${hit.regionId}`,\n    owner: hit.affordanceId,\n    strength: 'shared',\n    ...(scratch.targetId !== undefined ? { targetIds: [scratch.targetId] } : {}),\n    ...(scratch.anchor !== undefined ? { anchor: scratch.anchor } : {}),\n    ...(scratch.fixedPoint !== undefined ? { fixedPoint: scratch.fixedPoint } : {}),\n    ...(hit.cursor !== undefined ? { cursor: hit.cursor } : {}),\n    ...(hit.binding.initialScratch !== undefined ? { payload: hit.binding.initialScratch } : {}),\n  } as AffordanceHit;\n}\n\n/**\n * Classify a world-space point against the current selection: `'empty'`,\n * `'selected-body'`, or `'unselected-body'`.\n *\n * @param kindOfNode - Resolver from a hit node id to its semantic kind.\n *   Omitting it leaves `kind` undefined, which makes every `kind:` TargetSpec\n *   form no-match.\n * @param doubleClickNames - The node a double-click on a hit names\n *   (`doubleClickTarget`). Where that is another node, it rides along as\n *   `doubleClick`, classified the same way.\n */\nexport function buildClassifyTarget(\n  getSelection: () => readonly string[],\n  pickBest: (world: WorldPoint) => string | null,\n  kindOfNode?: (id: string) => string | undefined,\n  doubleClickNames?: (hitId: string) => string,\n): (worldPoint: WorldPoint) => BodyClassification {\n  return function classifyTarget(world) {\n    const hitId = pickBest(world);\n    if (!hitId) return { body: 'empty' };\n    const sel = getSelection();\n    const classify = (id: string) => ({\n      body: sel.includes(id) ? 'selected-body' as const : 'unselected-body' as const,\n      kind: kindOfNode?.(id),\n      id,\n    });\n    const named = doubleClickNames?.(hitId);\n    return named !== undefined && named !== hitId\n      ? { ...classify(hitId), doubleClick: classify(named) }\n      : classify(hitId);\n  };\n}\n\n/** A registered layer's claim on a point, as the affordance the dispatcher\n *  routes: its kind names the layer, and it carries what the layer's hit-test\n *  resolved. */\nexport function layerAffordance(layerId: string, claim: LayerHit): AffordanceHit {\n  return {\n    kind: `layer:${layerId}`,\n    owner: layerId,\n    strength: claim.strength ?? 'shared',\n    ...(claim.claimedKinds !== undefined ? { claimedKinds: claim.claimedKinds } : {}),\n    ...(claim.cursor !== undefined ? { cursor: claim.cursor } : {}),\n    ...(claim.initialScratch !== undefined ? { payload: claim.initialScratch } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/canvas/buildSceneLayer.js

@@ -44,7 +44,7 @@ function buildSceneLayer(cfg, adapter, boundsOfFn, hideIds, slot) {
 		y: 0,
 		width: dims.width,
 		height: dims.height
-	}) : (cmds) => cmds;
+	}, dims.dpr) : (cmds) => cmds;
 	const paintBounds = cfg.cull ? cfg.paintBounds : void 0;
 	const culledIn = (view, dims) => paintBounds ? paintMissesView(paintBounds, view, {
 		x: 0,

package/dist/canvas/buildSceneLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildSceneLayer.js","names":[],"sources":["../../src/canvas/buildSceneLayer.ts"],"sourcesContent":["/**\n * The scene slot: an adapter's tree as render layers, one per scene layer.\n */\nimport type { Path } from '@weasel-js/geom';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { View } from 'core/viewport/view';\nimport { cullDrawCommands, viewToMat3, type DrawCommand } from '@weasel-js/renderer';\nimport { adapterDerivedPathOf } from './adapterDerivedPath';\nimport { buildSceneTree, type HierarchicalAdapter } from './buildSceneTree';\nimport { debugSinkFrom } from './drawEnvelope';\nimport type { NodePaintCtx } from './NodeShape';\nimport { paintMissesView, type PaintBoundsFn } from './paintCull';\nimport { sceneLayerKey } from './sceneLayerPaint';\nimport { wrapNodeOutput } from './wrapNodeOutput';\n\n/** Scene slot config — describes how to draw one object with its effective pose. */\nexport interface SceneSlotConfig<TNode extends { id: string }, TPose> {\n  /** Paint these, in this order, in place of the adapter's tree: one flat run with no\n   *  scene layers, no container clips, and no pose composition. */\n  objects?: TNode[];\n  /** The pose an object is painted at. Defaults to `adapter.getPose(obj.id)`. `<SceneCanvas>`\n   *  hands it each node as the scene shows it, its `pose` an override's or a derived one,\n   *  and carries an override's `path` into the box it answers; return a pose placed from\n   *  `obj.pose`, or a drag in flight and a rig's motion do not show in this view. */\n  toPose?: (obj: TNode) => TPose;\n  /** Draw a single object as a `DrawCommand` tree. `ctx` carries a derived\n   *  node's path: `<SceneCanvas>` resolves it from the scene, and\n   *  `buildSceneLayer` called without one from its adapter. */\n  drawOne: (obj: TNode, pose: TPose, view: View, ctx?: NodePaintCtx) => DrawCommand[];\n  /** The path a container derives from its dependencies' poses, for the clip\n   *  it imposes on its subtree — `drawOne`'s `ctx` carries the derived path a\n   *  node *paints*, this one the clip it *imposes*. A scene-aware caller\n   *  supplies it; left out, both are resolved off the adapter. */\n  derivedPathOf?: (obj: TNode, pose: TPose) => Path | null;\n  /** Default ghost alpha for the move-overlay slot. Default 0.85. */\n  ghostAlpha?: number;\n  /** Per-id alpha multiplier. A node's emitted `DrawCommand[]` is wrapped in a\n   *  `{ kind: 'group', alpha }` when the returned value is not 1. */\n  alphaFor?: (id: string) => number;\n  /**\n   * Post-processor for the scene slot's emitted commands: called with the final\n   * world-space `DrawCommand[]` each time a scene canvas layer draws (after per-node\n   * rotation wrapping and `alphaFor`), once per layer when the slot is split into\n   * `scene:<layerId>` layers. Its return value replaces the array handed to the renderer.\n   *\n   * Commands are world-space — `drawLayers` applies the view transform afterward. Clip\n   * nesting is capped at 7 levels; a wrapping group with `clip` consumes one. The\n   * move-overlay ghost (drag preview) is not post-processed.\n   */\n  postProcess?: (cmds: DrawCommand[], view: View, dims: Dims) => DrawCommand[];\n  /**\n   * Skip what cannot reach the view. A node `paintBounds` places outside the\n   * `dims` rectangle under `view` is not painted at all; then, after\n   * `postProcess`, `cullDrawCommands` drops any remaining command that cannot\n   * reach it — see there for what it can and cannot bound. So `postProcess`\n   * sees an empty group where a culled node would have painted.\n   *\n   * Off by default because it makes the layer's world-space output depend on\n   * the view: anything that draws this layer once and shows the result under\n   * another view — a cache keyed without `view`, a consumer re-wrapping the\n   * commands — would show the first view's cull.\n   */\n  cull?: boolean;\n  /**\n   * Where `drawOne`'s output for a node can reach, in the frame it paints in\n   * — before the pose rotation the slot wraps it in. `null` for a node it\n   * cannot bound cheaply. Read only under `cull`, which skips `drawOne` for a\n   * node whose box misses the view, so it must enclose everything `drawOne`\n   * paints: a box too small makes a node vanish before it leaves the screen.\n   *\n   * `<SceneCanvas>` supplies `defaultPaintBounds` while `drawOne` is\n   * `defaultDrawOne`. Omit it with any other `drawOne` and culling only\n   * trims commands after painting.\n   */\n  paintBounds?: PaintBoundsFn<TNode, TPose>;\n}\n\n/**\n * `cfg`'s `drawOne` and clip lookup, resolving derived paths off the adapter\n * when nothing scene-aware filled `derivedPathOf` in.\n */\nfunction withAdapterDerivedPaths<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  toPose: (obj: TNode) => TPose,\n): Pick<SceneSlotConfig<TNode, TPose>, 'drawOne' | 'derivedPathOf'> {\n  const drawOne = cfg.drawOne;\n  if (cfg.derivedPathOf !== undefined || !drawOne || !adapter) return cfg;\n  const pathOf = adapterDerivedPathOf<TPose>(cfg.toPose === undefined ? adapter : {\n    getNode: (id) => adapter.getNode(id),\n    getPose: (id) => {\n      const obj = adapter.getNode(id);\n      return obj ? toPose(obj) : adapter.getPose(id);\n    },\n    getChildren: (id) => adapter.getChildren(id),\n  });\n  return {\n    derivedPathOf: (obj) => pathOf(obj.id),\n    drawOne: (obj, pose, view, ctx) => ((obj as { dependsOn?: unknown }).dependsOn === undefined\n      ? drawOne(obj, pose, view, ctx)\n      : drawOne(obj, pose, view, { ...ctx, derivedPath: pathOf(obj.id) })),\n  };\n}\n\n/**\n * Build the scene layer, which draws committed poses. `hideIds()` skips the committed paint\n * of ids the active tool is currently ghosting so the source doesn't show through. With a\n * debug sink on its draw envelope, it records each node's bounds and origin there.\n */\nexport function buildSceneLayer<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  boundsOfFn: ((id: string) => Bounds | null) | undefined,\n  hideIds: () => Set<string> | null,\n  /** When set, the returned layer carries this `id` and paints ONLY the named\n   *  scene layer (the rest are walked for ancestor clips). Omit for the single\n   *  bundled `scene` layer. */\n  slot?: { id: string; forLayer: string },\n): RenderLayer<unknown> {\n  const toPose =\n    cfg.toPose ??\n    ((obj: TNode) => (adapter ? adapter.getPose(obj.id) : (obj as unknown as TPose)));\n  const { drawOne, derivedPathOf } = withAdapterDerivedPaths(cfg, adapter, toPose);\n  const postProcess = cfg.postProcess;\n  const finish = cfg.cull\n    ? (cmds: DrawCommand[], view: View, dims: Dims): DrawCommand[] =>\n      cullDrawCommands(cmds, viewToMat3(view), { x: 0, y: 0, width: dims.width, height: dims.height })\n    : (cmds: DrawCommand[]): DrawCommand[] => cmds;\n  const paintBounds = cfg.cull ? cfg.paintBounds : undefined;\n  const culledIn = (view: View, dims: Dims) => paintBounds\n    ? paintMissesView(paintBounds, view, { x: 0, y: 0, width: dims.width, height: dims.height })\n    : undefined;\n  return {\n    id: slot?.id ?? 'scene',\n    label: slot ? `Scene: ${slot.forLayer}` : 'Scene',\n    draw: (data, view, dims) => {\n      const debugSink = debugSinkFrom(data);\n      const hidden = hideIds();\n      const a = adapter;\n      if (a && cfg.objects === undefined && drawOne) {\n        const filteredDrawOne = (obj: TNode, pose: TPose, v: View): DrawCommand[] => {\n          if (hidden && hidden.has(obj.id)) return [];\n          const cmds = drawOne(obj, pose, v);\n          if (debugSink) {\n            const b = boundsOfFn ? boundsOfFn(obj.id) : null;\n            if (b) debugSink.recordBounds(obj.id, b);\n            const ox = (pose as { x?: number }).x ?? (b ? b.x : 0);\n            const oy = (pose as { y?: number }).y ?? (b ? b.y : 0);\n            debugSink.recordOrigin(obj.id, { x: ox, y: oy });\n          }\n          return wrapNodeOutput(cmds, pose, cfg.alphaFor ? cfg.alphaFor(obj.id) : 1);\n        };\n        // Honor cfg.toPose on the hierarchical path by shimming getPose on the\n        // adapter so buildSceneTree routes through it instead of the raw adapter.\n        const hierarchicalAdapter = cfg.toPose\n          ? {\n              ...a,\n              getPose: (id: string) => {\n                const obj = a.getNode(id);\n                return obj ? toPose(obj) : a.getPose(id);\n              },\n            }\n          : a;\n        // World-space commands; drawLayers wraps in viewToMat3 automatically.\n        const tree = buildSceneTree(\n          hierarchicalAdapter as unknown as Parameters<typeof buildSceneTree>[0],\n          filteredDrawOne as unknown as Parameters<typeof buildSceneTree>[1],\n          view,\n          slot?.forLayer,\n          derivedPathOf as Parameters<typeof buildSceneTree>[4],\n          culledIn(view, dims) as Parameters<typeof buildSceneTree>[5],\n        );\n        return finish(postProcess ? postProcess(tree, view, dims) : tree, view, dims);\n      }\n      // `cfg.objects`: the caller's own list, which has no scene layers to split by.\n      const objects = cfg.objects ?? [];\n      const children: DrawCommand[] = [];\n      const culled = culledIn(view, dims);\n      for (const obj of objects) {\n        if (hidden && hidden.has(obj.id)) continue;\n        const pose: TPose = toPose(obj);\n        if (drawOne && !culled?.(obj, pose)) {\n          const cmds = drawOne(obj, pose, view);\n          const wrapped = wrapNodeOutput(cmds, pose, cfg.alphaFor ? cfg.alphaFor(obj.id) : 1);\n          for (const cmd of wrapped) children.push(cmd);\n        }\n        if (debugSink) {\n          const b = boundsOfFn ? boundsOfFn(obj.id) : null;\n          if (b) debugSink.recordBounds(obj.id, { x: b.x, y: b.y, width: b.width, height: b.height });\n          const ox = (pose as { x?: number }).x ?? (b ? b.x : 0);\n          const oy = (pose as { y?: number }).y ?? (b ? b.y : 0);\n          debugSink.recordOrigin(obj.id, { x: ox, y: oy });\n        }\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return finish(postProcess ? postProcess(children, view, dims) : children, view, dims);\n    },\n  };\n}\n\n/**\n * The scene slot as one canvas layer **per scene layer** — keyed `scene:<layerId>` — so\n * consumers can interleave custom layers *between* scene layers via the standard slot\n * anchoring (`before: 'scene:plantings'`). A single `scene` layer when `cfg.objects` replaces\n * the tree, or the adapter declares no layers.\n */\nexport function buildSceneLayers<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  boundsOfFn: ((id: string) => Bounds | null) | undefined,\n  hideIds: () => Set<string> | null,\n): Array<{ key: string; layer: RenderLayer<unknown> }> {\n  const sceneLayerIds =\n    cfg.objects === undefined && adapter ? adapter.getLayers().map((l) => l.id) : null;\n  if (!sceneLayerIds || sceneLayerIds.length === 0) {\n    return [{ key: 'scene', layer: buildSceneLayer(cfg, adapter, boundsOfFn, hideIds) }];\n  }\n  return sceneLayerIds.map((id) => ({\n    key: sceneLayerKey(id),\n    layer: buildSceneLayer(cfg, adapter, boundsOfFn, hideIds, {\n      id: sceneLayerKey(id),\n      forLayer: id,\n    }),\n  }));\n}\n"],"mappings":"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"}
+{"version":3,"file":"buildSceneLayer.js","names":[],"sources":["../../src/canvas/buildSceneLayer.ts"],"sourcesContent":["/**\n * The scene slot: an adapter's tree as render layers, one per scene layer.\n */\nimport type { Path } from '@weasel-js/geom';\nimport type { Dims, LayerDims, RenderLayer } from 'core/layers/render';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { View } from 'core/viewport/view';\nimport { cullDrawCommands, viewToMat3, type DrawCommand } from '@weasel-js/renderer';\nimport { adapterDerivedPathOf } from './adapterDerivedPath';\nimport { buildSceneTree, type HierarchicalAdapter } from './buildSceneTree';\nimport { debugSinkFrom } from './drawEnvelope';\nimport type { NodePaintCtx } from './NodeShape';\nimport { paintMissesView, type PaintBoundsFn } from './paintCull';\nimport { sceneLayerKey } from './sceneLayerPaint';\nimport { wrapNodeOutput } from './wrapNodeOutput';\n\n/** Scene slot config — describes how to draw one object with its effective pose. */\nexport interface SceneSlotConfig<TNode extends { id: string }, TPose> {\n  /** Paint these, in this order, in place of the adapter's tree: one flat run with no\n   *  scene layers, no container clips, and no pose composition. */\n  objects?: TNode[];\n  /** The pose an object is painted at. Defaults to `adapter.getPose(obj.id)`. `<SceneCanvas>`\n   *  hands it each node as the scene shows it, its `pose` an override's or a derived one,\n   *  and carries an override's `path` into the box it answers; return a pose placed from\n   *  `obj.pose`, or a drag in flight and a rig's motion do not show in this view. */\n  toPose?: (obj: TNode) => TPose;\n  /** Draw a single object as a `DrawCommand` tree. `ctx` carries a derived\n   *  node's path: `<SceneCanvas>` resolves it from the scene, and\n   *  `buildSceneLayer` called without one from its adapter. */\n  drawOne: (obj: TNode, pose: TPose, view: View, ctx?: NodePaintCtx) => DrawCommand[];\n  /** The path a container derives from its dependencies' poses, for the clip\n   *  it imposes on its subtree — `drawOne`'s `ctx` carries the derived path a\n   *  node *paints*, this one the clip it *imposes*. A scene-aware caller\n   *  supplies it; left out, both are resolved off the adapter. */\n  derivedPathOf?: (obj: TNode, pose: TPose) => Path | null;\n  /** Default ghost alpha for the move-overlay slot. Default 0.85. */\n  ghostAlpha?: number;\n  /** Per-id alpha multiplier. A node's emitted `DrawCommand[]` is wrapped in a\n   *  `{ kind: 'group', alpha }` when the returned value is not 1. */\n  alphaFor?: (id: string) => number;\n  /**\n   * Post-processor for the scene slot's emitted commands: called with the final\n   * world-space `DrawCommand[]` each time a scene canvas layer draws (after per-node\n   * rotation wrapping and `alphaFor`), once per layer when the slot is split into\n   * `scene:<layerId>` layers. Its return value replaces the array handed to the renderer.\n   *\n   * Commands are world-space — `drawLayers` applies the view transform afterward. Clip\n   * nesting is capped at 7 levels; a wrapping group with `clip` consumes one. The\n   * move-overlay ghost (drag preview) is not post-processed.\n   */\n  postProcess?: (cmds: DrawCommand[], view: View, dims: Dims) => DrawCommand[];\n  /**\n   * Skip what cannot reach the view. A node `paintBounds` places outside the\n   * `dims` rectangle under `view` is not painted at all; then, after\n   * `postProcess`, `cullDrawCommands` drops any remaining command that cannot\n   * reach it — see there for what it can and cannot bound. So `postProcess`\n   * sees an empty group where a culled node would have painted.\n   *\n   * Off by default because it makes the layer's world-space output depend on\n   * the view: anything that draws this layer once and shows the result under\n   * another view — a cache keyed without `view`, a consumer re-wrapping the\n   * commands — would show the first view's cull.\n   */\n  cull?: boolean;\n  /**\n   * Where `drawOne`'s output for a node can reach, in the frame it paints in\n   * — before the pose rotation the slot wraps it in. `null` for a node it\n   * cannot bound cheaply. Read only under `cull`, which skips `drawOne` for a\n   * node whose box misses the view, so it must enclose everything `drawOne`\n   * paints: a box too small makes a node vanish before it leaves the screen.\n   *\n   * `<SceneCanvas>` supplies `defaultPaintBounds` while `drawOne` is\n   * `defaultDrawOne`. Omit it with any other `drawOne` and culling only\n   * trims commands after painting.\n   */\n  paintBounds?: PaintBoundsFn<TNode, TPose>;\n}\n\n/**\n * `cfg`'s `drawOne` and clip lookup, resolving derived paths off the adapter\n * when nothing scene-aware filled `derivedPathOf` in.\n */\nfunction withAdapterDerivedPaths<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  toPose: (obj: TNode) => TPose,\n): Pick<SceneSlotConfig<TNode, TPose>, 'drawOne' | 'derivedPathOf'> {\n  const drawOne = cfg.drawOne;\n  if (cfg.derivedPathOf !== undefined || !drawOne || !adapter) return cfg;\n  const pathOf = adapterDerivedPathOf<TPose>(cfg.toPose === undefined ? adapter : {\n    getNode: (id) => adapter.getNode(id),\n    getPose: (id) => {\n      const obj = adapter.getNode(id);\n      return obj ? toPose(obj) : adapter.getPose(id);\n    },\n    getChildren: (id) => adapter.getChildren(id),\n  });\n  return {\n    derivedPathOf: (obj) => pathOf(obj.id),\n    drawOne: (obj, pose, view, ctx) => ((obj as { dependsOn?: unknown }).dependsOn === undefined\n      ? drawOne(obj, pose, view, ctx)\n      : drawOne(obj, pose, view, { ...ctx, derivedPath: pathOf(obj.id) })),\n  };\n}\n\n/**\n * Build the scene layer, which draws committed poses. `hideIds()` skips the committed paint\n * of ids the active tool is currently ghosting so the source doesn't show through. With a\n * debug sink on its draw envelope, it records each node's bounds and origin there.\n */\nexport function buildSceneLayer<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  boundsOfFn: ((id: string) => Bounds | null) | undefined,\n  hideIds: () => Set<string> | null,\n  /** When set, the returned layer carries this `id` and paints ONLY the named\n   *  scene layer (the rest are walked for ancestor clips). Omit for the single\n   *  bundled `scene` layer. */\n  slot?: { id: string; forLayer: string },\n): RenderLayer<unknown> {\n  const toPose =\n    cfg.toPose ??\n    ((obj: TNode) => (adapter ? adapter.getPose(obj.id) : (obj as unknown as TPose)));\n  const { drawOne, derivedPathOf } = withAdapterDerivedPaths(cfg, adapter, toPose);\n  const postProcess = cfg.postProcess;\n  const finish = cfg.cull\n    ? (cmds: DrawCommand[], view: View, dims: LayerDims): DrawCommand[] =>\n      cullDrawCommands(cmds, viewToMat3(view), { x: 0, y: 0, width: dims.width, height: dims.height }, dims.dpr)\n    : (cmds: DrawCommand[]): DrawCommand[] => cmds;\n  const paintBounds = cfg.cull ? cfg.paintBounds : undefined;\n  const culledIn = (view: View, dims: Dims) => paintBounds\n    ? paintMissesView(paintBounds, view, { x: 0, y: 0, width: dims.width, height: dims.height })\n    : undefined;\n  return {\n    id: slot?.id ?? 'scene',\n    label: slot ? `Scene: ${slot.forLayer}` : 'Scene',\n    draw: (data, view, dims) => {\n      const debugSink = debugSinkFrom(data);\n      const hidden = hideIds();\n      const a = adapter;\n      if (a && cfg.objects === undefined && drawOne) {\n        const filteredDrawOne = (obj: TNode, pose: TPose, v: View): DrawCommand[] => {\n          if (hidden && hidden.has(obj.id)) return [];\n          const cmds = drawOne(obj, pose, v);\n          if (debugSink) {\n            const b = boundsOfFn ? boundsOfFn(obj.id) : null;\n            if (b) debugSink.recordBounds(obj.id, b);\n            const ox = (pose as { x?: number }).x ?? (b ? b.x : 0);\n            const oy = (pose as { y?: number }).y ?? (b ? b.y : 0);\n            debugSink.recordOrigin(obj.id, { x: ox, y: oy });\n          }\n          return wrapNodeOutput(cmds, pose, cfg.alphaFor ? cfg.alphaFor(obj.id) : 1);\n        };\n        // Honor cfg.toPose on the hierarchical path by shimming getPose on the\n        // adapter so buildSceneTree routes through it instead of the raw adapter.\n        const hierarchicalAdapter = cfg.toPose\n          ? {\n              ...a,\n              getPose: (id: string) => {\n                const obj = a.getNode(id);\n                return obj ? toPose(obj) : a.getPose(id);\n              },\n            }\n          : a;\n        // World-space commands; drawLayers wraps in viewToMat3 automatically.\n        const tree = buildSceneTree(\n          hierarchicalAdapter as unknown as Parameters<typeof buildSceneTree>[0],\n          filteredDrawOne as unknown as Parameters<typeof buildSceneTree>[1],\n          view,\n          slot?.forLayer,\n          derivedPathOf as Parameters<typeof buildSceneTree>[4],\n          culledIn(view, dims) as Parameters<typeof buildSceneTree>[5],\n        );\n        return finish(postProcess ? postProcess(tree, view, dims) : tree, view, dims);\n      }\n      // `cfg.objects`: the caller's own list, which has no scene layers to split by.\n      const objects = cfg.objects ?? [];\n      const children: DrawCommand[] = [];\n      const culled = culledIn(view, dims);\n      for (const obj of objects) {\n        if (hidden && hidden.has(obj.id)) continue;\n        const pose: TPose = toPose(obj);\n        if (drawOne && !culled?.(obj, pose)) {\n          const cmds = drawOne(obj, pose, view);\n          const wrapped = wrapNodeOutput(cmds, pose, cfg.alphaFor ? cfg.alphaFor(obj.id) : 1);\n          for (const cmd of wrapped) children.push(cmd);\n        }\n        if (debugSink) {\n          const b = boundsOfFn ? boundsOfFn(obj.id) : null;\n          if (b) debugSink.recordBounds(obj.id, { x: b.x, y: b.y, width: b.width, height: b.height });\n          const ox = (pose as { x?: number }).x ?? (b ? b.x : 0);\n          const oy = (pose as { y?: number }).y ?? (b ? b.y : 0);\n          debugSink.recordOrigin(obj.id, { x: ox, y: oy });\n        }\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return finish(postProcess ? postProcess(children, view, dims) : children, view, dims);\n    },\n  };\n}\n\n/**\n * The scene slot as one canvas layer **per scene layer** — keyed `scene:<layerId>` — so\n * consumers can interleave custom layers *between* scene layers via the standard slot\n * anchoring (`before: 'scene:plantings'`). A single `scene` layer when `cfg.objects` replaces\n * the tree, or the adapter declares no layers.\n */\nexport function buildSceneLayers<TNode extends { id: string }, TPose>(\n  cfg: SceneSlotConfig<TNode, TPose>,\n  adapter: HierarchicalAdapter<TNode, TPose> | undefined,\n  boundsOfFn: ((id: string) => Bounds | null) | undefined,\n  hideIds: () => Set<string> | null,\n): Array<{ key: string; layer: RenderLayer<unknown> }> {\n  const sceneLayerIds =\n    cfg.objects === undefined && adapter ? adapter.getLayers().map((l) => l.id) : null;\n  if (!sceneLayerIds || sceneLayerIds.length === 0) {\n    return [{ key: 'scene', layer: buildSceneLayer(cfg, adapter, boundsOfFn, hideIds) }];\n  }\n  return sceneLayerIds.map((id) => ({\n    key: sceneLayerKey(id),\n    layer: buildSceneLayer(cfg, adapter, boundsOfFn, hideIds, {\n      id: sceneLayerKey(id),\n      forLayer: id,\n    }),\n  }));\n}\n"],"mappings":"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"}

package/dist/canvas/buildSceneTree.js

@@ -35,7 +35,8 @@ function wrapInChain(cmds, chain, toLayer, carry) {
 * **that node's own `layer`** — not its parent's. A node carrying `hidden` is skipped with
 * its whole subtree; see `nodeGates`. So a child whose `layer` differs from its
 * parent draws in its own layer's pass while staying a tree child for hit-testing / move /
-* reparent. Output is one group per visible layer, in adapter (`getLayers`) order.
+* reparent. Output is one group per visible layer, in adapter (`getLayers`) order. A node that
+* consumes its children paints none of them.
 *
 * A node paints before its children. What its `drawOne` wraps in `overChildren` paints after
 * them instead, in the node's own layer.
@@ -57,6 +58,7 @@ function buildSceneTree(adapter, drawOne, view, forLayer, derivedPathOf, culled)
 	let planeViews = null;
 	for (const l of layers) if (l.parallax) (planeViews ??= /* @__PURE__ */ new Map()).set(l.id, deriveParallaxView(view, l.parallax));
 	const compose = adapter.composePose?.bind(adapter);
+	const scrolled = compose ? adapter.childFrame?.bind(adapter) : void 0;
 	const carry = clipCarrier(planeViews ? scenePlaneOf(layers, view) : null);
 	function visit(id, ancestorClips, parentFrame, copied) {
 		const node = adapter.getNode(id);
@@ -82,8 +84,8 @@ function buildSceneTree(adapter, drawOne, view, forLayer, derivedPathOf, culled)
 			children: cmds
 		};
 		if (bucket) bucket.push(wrap(self));
-		const childFrame = definesFrame(node) ? pose : parentFrame;
-		const children = adapter.getChildren(id);
+		const childFrame = definesFrame(node) ? scrolled ? scrolled(id, pose) : pose : parentFrame;
+		const children = node.consumesChildren === true ? [] : adapter.getChildren(id);
 		for (const cid of children) visit(cid, ownClips, childFrame, copied);
 		const copies = typeof maybeContainer.copiesFromPose === "function" ? maybeContainer.copiesFromPose(pose, node) : null;
 		for (const copy of copies ?? []) {

package/dist/canvas/buildSceneTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildSceneTree.js","names":[],"sources":["../../src/canvas/buildSceneTree.ts"],"sourcesContent":["import type { DrawCommand, GroupDrawCommand } from '@weasel-js/renderer';\nimport type { View } from 'core/viewport/view';\nimport { ownClipOf, type ClipBearing } from './ownClip';\nimport { mat3, type Affine, type Path } from '@weasel-js/geom';\nimport { definesFrame } from 'core/scene/effectivePose';\nimport { deriveParallaxView, planeMap, type ParallaxOpts } from 'core/viewport/parallax';\nimport { scenePlaneOf } from './pickWalk';\nimport { clipCarrier, planeTransform } from './planeClips';\nimport { splitOverChildren } from './overChildren';\nimport { hidesSubtree } from 'core/scene/nodeGates';\n\n/** The scene-tree reading surface `buildSceneTree` walks. A `SceneCanvasAdapter` is one. */\nexport interface HierarchicalAdapter<TNode, TPose> {\n  getLayers(): readonly { id: string; visible: boolean; parallax?: ParallaxOpts }[];\n  getNode(id: string): TNode | undefined;\n  getChildren(parentId: string | null): readonly string[];\n  getPose(id: string): TPose;\n  /** Folds a child's local pose into its parent's frame. Absent means the\n   *  scene stores absolute poses and a parent contributes no transform —\n   *  see `PoseComposition`. */\n  composePose?(parent: TPose, child: TPose): TPose;\n}\n\n/** A clip on the chain, with the layer whose world it is drawn in, or the\n *  transform of a copy a container draws — see `GroupNode.copiesFromPose`. */\ntype ChainEntry = { path: Path; layer: string } | { copy: Affine };\n\n/** Wrap `cmds` in one nested group per chain entry, so the renderer intersects\n *  the clips and applies each copy's transform to everything inside it.\n *  Outermost group carries the ancestor-most entry; innermost holds `cmds`. */\nfunction wrapInChain(\n  cmds: DrawCommand[],\n  chain: readonly ChainEntry[],\n  toLayer: string,\n  carry: ReturnType<typeof clipCarrier>,\n): DrawCommand {\n  let node: GroupDrawCommand = { kind: 'group', children: cmds };\n  for (let i = chain.length - 1; i >= 0; i--) {\n    const e = chain[i];\n    node = 'copy' in e\n      ? { kind: 'group', children: [node], transform: mat3.fromAffine(e.copy) }\n      : { kind: 'group', children: [node], clip: carry(e.path, e.layer, toLayer) };\n  }\n  return node;\n}\n\n/**\n * Walk the adapter's scene tree once and emit each node's own paint into the bucket for\n * **that node's own `layer`** — not its parent's. A node carrying `hidden` is skipped with\n * its whole subtree; see `nodeGates`. So a child whose `layer` differs from its\n * parent draws in its own layer's pass while staying a tree child for hit-testing / move /\n * reparent. Output is one group per visible layer, in adapter (`getLayers`) order.\n *\n * A node paints before its children. What its `drawOne` wraps in `overChildren` paints after\n * them instead, in the node's own layer.\n *\n * `drawOne` returns world-coord commands. Because a node may be drawn outside its parent's\n * group, the tree nesting cannot carry geometry as renderer state; the walk folds each node's\n * pose into its parent's frame on the way down and hands the painter a **world** pose. Clips\n * are accumulated the same way — each in its container's plane, carried into the plane of the\n * node it clips. With no `composePose` on the adapter the fold is the identity.\n *\n * A layer carrying `parallax` is a plane: its painters and its cull see the view derived for\n * it, and its group carries the transform from its world to the camera's, so the caller's\n * single camera wrap still lands it right.\n */\nexport function buildSceneTree<\n  TNode extends { id: string; layer: string; hidden?: boolean },\n  TPose,\n>(\n  adapter: HierarchicalAdapter<TNode, TPose>,\n  drawOne: (obj: TNode, pose: TPose, view: View) => DrawCommand[],\n  view: View,\n  /** When set, only nodes on this layer paint (others are still walked for\n   *  ancestor clips) and only this layer's group is returned. */\n  forLayer?: string,\n  /** The path a container computes from its dependencies' poses: the scene's\n   *  lookup, or `adapterDerivedPathOf` for an adapter with no scene. Left out,\n   *  a derived container contributes no clip. */\n  derivedPathOf?: (node: TNode, pose: TPose) => Path | null,\n  /** True for a node whose paint cannot be seen — see `paintMissesView`. Its\n   *  painter is not called; its clip and its children are walked as usual. */\n  culled?: (node: TNode, pose: TPose, view: View) => boolean,\n): DrawCommand[] {\n  const layers = adapter.getLayers();\n  // A hidden layer gets no bucket, and a node with no bucket is not painted.\n  const buckets = new Map<string, DrawCommand[]>();\n  for (const l of layers) if (l.visible) buckets.set(l.id, []);\n  let planeViews: Map<string, View> | null = null;\n  for (const l of layers) {\n    if (l.parallax) (planeViews ??= new Map()).set(l.id, deriveParallaxView(view, l.parallax));\n  }\n\n  const compose = adapter.composePose?.bind(adapter);\n  const carry = clipCarrier(planeViews ? scenePlaneOf(layers, view) : null);\n\n  function visit(\n    id: string,\n    ancestorClips: readonly ChainEntry[],\n    parentFrame: TPose | null,\n    /** Under a copy: the pose is not where it paints, so the cull cannot judge it. */\n    copied: boolean,\n  ): void {\n    const node = adapter.getNode(id);\n    if (!node || hidesSubtree(node)) return;\n    const local = adapter.getPose(id);\n    // Fold once, on the way down: O(1) per node where walking the parent chain\n    // per node would be O(depth).\n    const pose = compose && parentFrame !== null ? compose(parentFrame, local) : local;\n    // Skip the (potentially expensive) painter for nodes we won't emit; their\n    // clip still extends the chain for descendants below.\n    const bucket = forLayer === undefined || node.layer === forLayer\n      ? buckets.get(node.layer) : undefined;\n    const v = planeViews?.get(node.layer) ?? view;\n    const { under: self, over } = splitOverChildren(\n      bucket && (copied || !culled?.(node, pose, v)) ? drawOne(node, pose, v) : [],\n    );\n\n    let ownClips = ancestorClips;\n    let ownClip: ChainEntry | null = null;\n    const maybeContainer = node as ClipBearing<TPose> & {\n      copiesFromPose?: (pose: TPose, node: unknown) => readonly Affine[] | null;\n    };\n    const clip = ownClipOf(maybeContainer, pose, () => derivedPathOf?.(node, pose));\n    if (clip) {\n      ownClip = { path: clip, layer: node.layer };\n      ownClips = [...ancestorClips, ownClip];\n    }\n\n    // Every node emits a wrapper group even with empty paint, keeping the per-node tree\n    // shape stable. A node's own clip is its children's, so its own paint, over\n    // its children or under them, takes only the clips above it.\n    const wrap = (cmds: DrawCommand[]): DrawCommand => (ancestorClips.length > 0\n      ? wrapInChain(cmds, ancestorClips, node.layer, carry) : { kind: 'group', children: cmds });\n    if (bucket) bucket.push(wrap(self));\n\n    // An envelope's children share its own parent's frame.\n    const childFrame = definesFrame(node as never) ? pose : parentFrame;\n    const children = adapter.getChildren(id);\n    for (const cid of children) visit(cid, ownClips, childFrame, copied);\n\n    // A copy is a copy of the clipped content, so its transform encloses the\n    // container's own clip and sits inside every clip above it.\n    const copies = typeof maybeContainer.copiesFromPose === 'function'\n      ? maybeContainer.copiesFromPose(pose, node) : null;\n    for (const copy of copies ?? []) {\n      const chain: ChainEntry[] = [...ancestorClips, { copy }, ...(ownClip ? [ownClip] : [])];\n      for (const cid of children) visit(cid, chain, childFrame, true);\n    }\n\n    if (bucket && over.length > 0) bucket.push(wrap(over));\n  }\n\n  for (const rootId of adapter.getChildren(null)) visit(rootId, [], null, false);\n\n  const out: DrawCommand[] = [];\n  for (const layer of layers) {\n    if (!layer.visible) continue;\n    if (forLayer !== undefined && layer.id !== forLayer) continue;\n    const children = buckets.get(layer.id) ?? [];\n    const transform = layer.parallax ? planeTransform(planeMap(view, layer.parallax), null) : undefined;\n    out.push(transform ? { kind: 'group', transform, children } : { kind: 'group', children });\n  }\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"buildSceneTree.js","names":[],"sources":["../../src/canvas/buildSceneTree.ts"],"sourcesContent":["import type { DrawCommand, GroupDrawCommand } from '@weasel-js/renderer';\nimport type { View } from 'core/viewport/view';\nimport { ownClipOf, type ClipBearing } from './ownClip';\nimport { mat3, type Affine, type Path } from '@weasel-js/geom';\nimport { definesFrame } from 'core/scene/effectivePose';\nimport { deriveParallaxView, planeMap, type ParallaxOpts } from 'core/viewport/parallax';\nimport { scenePlaneOf } from './pickWalk';\nimport { clipCarrier, planeTransform } from './planeClips';\nimport { splitOverChildren } from './overChildren';\nimport { hidesSubtree } from 'core/scene/nodeGates';\n\n/** The scene-tree reading surface `buildSceneTree` walks. A `SceneCanvasAdapter` is one. */\nexport interface HierarchicalAdapter<TNode, TPose> {\n  getLayers(): readonly { id: string; visible: boolean; parallax?: ParallaxOpts }[];\n  getNode(id: string): TNode | undefined;\n  getChildren(parentId: string | null): readonly string[];\n  getPose(id: string): TPose;\n  /** Folds a child's local pose into its parent's frame. Absent means the\n   *  scene stores absolute poses and a parent contributes no transform —\n   *  see `PoseComposition`. */\n  composePose?(parent: TPose, child: TPose): TPose;\n  /** The frame a container gives its children from its world pose: moved by\n   *  its scroll offset where the view scrolls it. Absent means the pose itself. */\n  childFrame?(id: string, world: TPose): TPose;\n}\n\n/** A clip on the chain, with the layer whose world it is drawn in, or the\n *  transform of a copy a container draws — see `GroupNode.copiesFromPose`. */\ntype ChainEntry = { path: Path; layer: string } | { copy: Affine };\n\n/** Wrap `cmds` in one nested group per chain entry, so the renderer intersects\n *  the clips and applies each copy's transform to everything inside it.\n *  Outermost group carries the ancestor-most entry; innermost holds `cmds`. */\nfunction wrapInChain(\n  cmds: DrawCommand[],\n  chain: readonly ChainEntry[],\n  toLayer: string,\n  carry: ReturnType<typeof clipCarrier>,\n): DrawCommand {\n  let node: GroupDrawCommand = { kind: 'group', children: cmds };\n  for (let i = chain.length - 1; i >= 0; i--) {\n    const e = chain[i];\n    node = 'copy' in e\n      ? { kind: 'group', children: [node], transform: mat3.fromAffine(e.copy) }\n      : { kind: 'group', children: [node], clip: carry(e.path, e.layer, toLayer) };\n  }\n  return node;\n}\n\n/**\n * Walk the adapter's scene tree once and emit each node's own paint into the bucket for\n * **that node's own `layer`** — not its parent's. A node carrying `hidden` is skipped with\n * its whole subtree; see `nodeGates`. So a child whose `layer` differs from its\n * parent draws in its own layer's pass while staying a tree child for hit-testing / move /\n * reparent. Output is one group per visible layer, in adapter (`getLayers`) order. A node that\n * consumes its children paints none of them.\n *\n * A node paints before its children. What its `drawOne` wraps in `overChildren` paints after\n * them instead, in the node's own layer.\n *\n * `drawOne` returns world-coord commands. Because a node may be drawn outside its parent's\n * group, the tree nesting cannot carry geometry as renderer state; the walk folds each node's\n * pose into its parent's frame on the way down and hands the painter a **world** pose. Clips\n * are accumulated the same way — each in its container's plane, carried into the plane of the\n * node it clips. With no `composePose` on the adapter the fold is the identity.\n *\n * A layer carrying `parallax` is a plane: its painters and its cull see the view derived for\n * it, and its group carries the transform from its world to the camera's, so the caller's\n * single camera wrap still lands it right.\n */\nexport function buildSceneTree<\n  TNode extends { id: string; layer: string; hidden?: boolean; consumesChildren?: boolean },\n  TPose,\n>(\n  adapter: HierarchicalAdapter<TNode, TPose>,\n  drawOne: (obj: TNode, pose: TPose, view: View) => DrawCommand[],\n  view: View,\n  /** When set, only nodes on this layer paint (others are still walked for\n   *  ancestor clips) and only this layer's group is returned. */\n  forLayer?: string,\n  /** The path a container computes from its dependencies' poses: the scene's\n   *  lookup, or `adapterDerivedPathOf` for an adapter with no scene. Left out,\n   *  a derived container contributes no clip. */\n  derivedPathOf?: (node: TNode, pose: TPose) => Path | null,\n  /** True for a node whose paint cannot be seen — see `paintMissesView`. Its\n   *  painter is not called; its clip and its children are walked as usual. */\n  culled?: (node: TNode, pose: TPose, view: View) => boolean,\n): DrawCommand[] {\n  const layers = adapter.getLayers();\n  // A hidden layer gets no bucket, and a node with no bucket is not painted.\n  const buckets = new Map<string, DrawCommand[]>();\n  for (const l of layers) if (l.visible) buckets.set(l.id, []);\n  let planeViews: Map<string, View> | null = null;\n  for (const l of layers) {\n    if (l.parallax) (planeViews ??= new Map()).set(l.id, deriveParallaxView(view, l.parallax));\n  }\n\n  const compose = adapter.composePose?.bind(adapter);\n  const scrolled = compose ? adapter.childFrame?.bind(adapter) : undefined;\n  const carry = clipCarrier(planeViews ? scenePlaneOf(layers, view) : null);\n\n  function visit(\n    id: string,\n    ancestorClips: readonly ChainEntry[],\n    parentFrame: TPose | null,\n    /** Under a copy: the pose is not where it paints, so the cull cannot judge it. */\n    copied: boolean,\n  ): void {\n    const node = adapter.getNode(id);\n    if (!node || hidesSubtree(node)) return;\n    const local = adapter.getPose(id);\n    // Fold once, on the way down: O(1) per node where walking the parent chain\n    // per node would be O(depth).\n    const pose = compose && parentFrame !== null ? compose(parentFrame, local) : local;\n    // Skip the (potentially expensive) painter for nodes we won't emit; their\n    // clip still extends the chain for descendants below.\n    const bucket = forLayer === undefined || node.layer === forLayer\n      ? buckets.get(node.layer) : undefined;\n    const v = planeViews?.get(node.layer) ?? view;\n    const { under: self, over } = splitOverChildren(\n      bucket && (copied || !culled?.(node, pose, v)) ? drawOne(node, pose, v) : [],\n    );\n\n    let ownClips = ancestorClips;\n    let ownClip: ChainEntry | null = null;\n    const maybeContainer = node as ClipBearing<TPose> & {\n      copiesFromPose?: (pose: TPose, node: unknown) => readonly Affine[] | null;\n    };\n    const clip = ownClipOf(maybeContainer, pose, () => derivedPathOf?.(node, pose));\n    if (clip) {\n      ownClip = { path: clip, layer: node.layer };\n      ownClips = [...ancestorClips, ownClip];\n    }\n\n    // Every node emits a wrapper group even with empty paint, keeping the per-node tree\n    // shape stable. A node's own clip is its children's, so its own paint, over\n    // its children or under them, takes only the clips above it.\n    const wrap = (cmds: DrawCommand[]): DrawCommand => (ancestorClips.length > 0\n      ? wrapInChain(cmds, ancestorClips, node.layer, carry) : { kind: 'group', children: cmds });\n    if (bucket) bucket.push(wrap(self));\n\n    // An envelope's children share its own parent's frame.\n    const childFrame = definesFrame(node as never) ? (scrolled ? scrolled(id, pose) : pose) : parentFrame;\n    const children = node.consumesChildren === true ? [] : adapter.getChildren(id);\n    for (const cid of children) visit(cid, ownClips, childFrame, copied);\n\n    // A copy is a copy of the clipped content, so its transform encloses the\n    // container's own clip and sits inside every clip above it.\n    const copies = typeof maybeContainer.copiesFromPose === 'function'\n      ? maybeContainer.copiesFromPose(pose, node) : null;\n    for (const copy of copies ?? []) {\n      const chain: ChainEntry[] = [...ancestorClips, { copy }, ...(ownClip ? [ownClip] : [])];\n      for (const cid of children) visit(cid, chain, childFrame, true);\n    }\n\n    if (bucket && over.length > 0) bucket.push(wrap(over));\n  }\n\n  for (const rootId of adapter.getChildren(null)) visit(rootId, [], null, false);\n\n  const out: DrawCommand[] = [];\n  for (const layer of layers) {\n    if (!layer.visible) continue;\n    if (forLayer !== undefined && layer.id !== forLayer) continue;\n    const children = buckets.get(layer.id) ?? [];\n    const transform = layer.parallax ? planeTransform(planeMap(view, layer.parallax), null) : undefined;\n    out.push(transform ? { kind: 'group', transform, children } : { kind: 'group', children });\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/canvas/canvasRenderer.js

@@ -18,6 +18,10 @@ var TENANTS = /* @__PURE__ */ new WeakMap();
 /** Canvases whose context the renderer refused, so a redraw does not rebuild
 *  and fail again, and the reason is reported once. */
 var REFUSED = /* @__PURE__ */ new WeakSet();
+/** The density a canvas given `dpr` paints at. */
+function resolveDpr(dpr) {
+	return dpr ?? (typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1);
+}
 /** Identifies a set of custom programs by their ids, in order. */
 var shaderKeyOf = (shaders) => shaders?.map((h) => h.id).join("|") ?? "";
 function registerShaders(renderer, shaders) {
@@ -42,7 +46,7 @@ function leaseCanvasRenderer() {
 	const restored = createEmitter();
 	const bind = (canvas, size, options = {}) => {
 		const { width, height } = size;
-		const dpr = size.dpr ?? (typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1);
+		const dpr = resolveDpr(size.dpr);
 		const tile = options.tile ?? null;
 		const shared = tile !== null;
 		if (held && (held.canvas !== canvas || held.shared !== shared)) {
@@ -186,5 +190,5 @@ function releaseCanvasRenderer(canvas) {
 }
 
 //#endregion
-export { leaseCanvasRenderer, paintCanvas, releaseCanvasRenderer, shaderKeyOf };
+export { leaseCanvasRenderer, paintCanvas, releaseCanvasRenderer, resolveDpr, shaderKeyOf };
 //# sourceMappingURL=canvasRenderer.js.map

package/dist/canvas/canvasRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasRenderer.js","names":["viewToMat3"],"sources":["../../src/canvas/canvasRenderer.ts"],"sourcesContent":["/**\n * The one renderer lifetime in core. Every on-screen surface holds its\n * `WeaselRenderer` through a `leaseCanvasRenderer` lease.\n *\n * A lease holds its own renderer, so several can share one element: each\n * tenant painting a `tile` of a shared buffer gets a renderer of its own on\n * the element's one context. Release frees only what that renderer created;\n * the context itself is never lost.\n */\nimport { WeaselRenderer, type FlattenTolerance, type ImageMinification, type RenderOptions } from '@weasel-js/renderer';\nimport { viewToMat3 } from '@weasel-js/geom';\nimport type { ShaderProgramHandle } from '@weasel-js/renderer';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { View } from '../core/viewport/view';\nimport { createEmitter } from '@weasel-js/registry';\nimport { CANVAS_CONTEXT_ATTRIBUTES } from './contextAttributes';\n\n/** The live renderers painting into each element, across every lease. */\nconst TENANTS: WeakMap<HTMLCanvasElement, Set<WeaselRenderer>> = new WeakMap();\n\n/** Canvases whose context the renderer refused, so a redraw does not rebuild\n *  and fail again, and the reason is reported once. */\nconst REFUSED: WeakSet<HTMLCanvasElement> = new WeakSet();\n\n/** A renderer painting into the canvas, if any lease holds one. Test seam. */\nexport function cachedCanvasRenderer(canvas: HTMLCanvasElement): WeaselRenderer | undefined {\n  const set = TENANTS.get(canvas);\n  return set ? set.values().next().value : undefined;\n}\n\n/** The size and density to paint a canvas at. `dpr` defaults to\n *  `window.devicePixelRatio`, read per paint. */\nexport interface CanvasPaintSize {\n  width: number;\n  height: number;\n  dpr?: number;\n}\n\n/** How one paint reaches the canvas, beyond its size. */\nexport interface CanvasPaintOptions {\n  /** Paint a `width × height` tile of a buffer other surfaces share, at this\n   *  origin in CSS pixels. The buffer is then the caller's to size: the\n   *  renderer never resizes the element, which would have every co-tenant\n   *  resize it to its own pane. Omit to own the whole element. */\n  tile?: { x: number; y: number } | null;\n  /** `WeaselRendererOptions.flattenTolerance`, applied from this paint on. */\n  flattenTolerance?: FlattenTolerance;\n  /** `WeaselRendererOptions.retainBudget`, applied from this paint on. */\n  retainBudget?: number;\n  /** `WeaselRendererOptions.imageMinification`, applied from this paint on. */\n  imageMinification?: ImageMinification;\n  /** Custom programs to compile on the renderer. Compiled when the renderer\n   *  is created, and again when the set of ids changes. */\n  shaders?: readonly ShaderProgramHandle[];\n}\n\n/** A paint's options, plus what `paint` hands `WeaselRenderer.render`. */\nexport interface CanvasRenderOptions extends CanvasPaintOptions {\n  render?: RenderOptions;\n}\n\n/** A canvas renderer held for a surface's lifetime. */\nexport interface CanvasRendererLease {\n  /** Draw `commands` into `canvas` — screen-space, one unit per CSS pixel,\n   *  with `view` passed on as the frame's world→screen transform. `bind`,\n   *  then render. Returns `false` without painting where `bind` finds no\n   *  renderer. */\n  paint(\n    canvas: HTMLCanvasElement,\n    commands: DrawCommand[],\n    view: View,\n    size: CanvasPaintSize,\n    options?: CanvasRenderOptions,\n  ): boolean;\n  /** The renderer that paints `canvas` at `size`, ready to render: created on\n   *  first use, resized, and given this paint's tile, tolerance, retain\n   *  budget, and shaders.\n   *  Frees the previous renderer first if the surface moved to another\n   *  element, or between owning it whole and painting a tile of it. `null`\n   *  where no WebGL2 context is available (jsdom, a failed context creation,\n   *  or a context that is lost for now). */\n  bind(canvas: HTMLCanvasElement, size: CanvasPaintSize, options?: CanvasPaintOptions): WeaselRenderer | null;\n  /** Run `fn` when the canvas gets a lost context back, after the renderer\n   *  has rebuilt itself on it. Nothing repaints a restored buffer on its own.\n   *  Returns an unsubscribe. */\n  subscribeRestored(fn: () => void): () => void;\n  /** Free the held renderer and every GL object it owns. A later `paint`\n   *  creates a fresh one. */\n  release(): void;\n}\n\ninterface Held {\n  canvas: HTMLCanvasElement;\n  renderer: WeaselRenderer;\n  shared: boolean;\n  lost: boolean;\n  onLost: () => void;\n  onRestored: () => void;\n  width: number;\n  height: number;\n  dpr: number;\n  tileX: number | null;\n  tileY: number | null;\n  flattenTolerance: FlattenTolerance | undefined;\n  retainBudget: number | undefined;\n  imageMinification: ImageMinification | undefined;\n  shaderKey: string;\n}\n\n/** Identifies a set of custom programs by their ids, in order. */\nexport const shaderKeyOf = (shaders: readonly ShaderProgramHandle[] | undefined): string =>\n  shaders?.map((h) => h.id).join('|') ?? '';\n\nfunction registerShaders(renderer: WeaselRenderer, shaders: readonly ShaderProgramHandle[] | undefined): void {\n  if (!shaders) return;\n  for (const handle of shaders) {\n    try {\n      renderer.registerProgram(handle);\n    } catch (e) {\n      console.warn(`weasel: failed to register shader \"${handle.id}\":`, e);\n    }\n  }\n}\n\nfunction free(held: Held): void {\n  const set = TENANTS.get(held.canvas);\n  set?.delete(held.renderer);\n  held.canvas.removeEventListener('webglcontextlost', held.onLost);\n  held.canvas.removeEventListener('webglcontextrestored', held.onRestored);\n  if (set && set.size === 0) TENANTS.delete(held.canvas);\n  held.renderer.dispose();\n}\n\n/** Hold the renderer of the canvas a surface paints into, until released. */\nexport function leaseCanvasRenderer(): CanvasRendererLease {\n  let held: Held | null = null;\n  const restored = createEmitter();\n  const bind = (canvas: HTMLCanvasElement, size: CanvasPaintSize, options: CanvasPaintOptions = {}): WeaselRenderer | null => {\n    const { width, height } = size;\n    const dpr = size.dpr ?? (typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1);\n    const tile = options.tile ?? null;\n    const shared = tile !== null;\n\n    if (held && (held.canvas !== canvas || held.shared !== shared)) {\n      free(held);\n      held = null;\n    }\n    if (!held) {\n      if (REFUSED.has(canvas)) return null;\n      const gl = canvas.getContext('webgl2', CANVAS_CONTEXT_ATTRIBUTES);\n      if (!gl || typeof (gl as Partial<WebGL2RenderingContext>).enable !== 'function') return null;\n      let renderer: WeaselRenderer;\n      try {\n        renderer = new WeaselRenderer({\n          gl: gl as WebGL2RenderingContext,\n          ...(shared ? {} : { canvas }),\n          width, height, dpr,\n          flattenTolerance: options.flattenTolerance,\n          retainBudget: options.retainBudget,\n          imageMinification: options.imageMinification,\n        });\n      } catch (e) {\n        // A lost context fails to compile and may yet come back; anything\n        // else fails the same way next time.\n        if (!(gl as Partial<WebGL2RenderingContext>).isContextLost?.()) {\n          REFUSED.add(canvas);\n          console.warn('weasel: this canvas cannot be painted:', e);\n        }\n        return null;\n      }\n      // Added after the renderer's own listeners, so a subscriber runs against\n      // a renderer that has already recompiled.\n      const mine: Held = held = {\n        canvas, renderer, shared, width, height, dpr, tileX: null, tileY: null,\n        flattenTolerance: options.flattenTolerance, retainBudget: options.retainBudget,\n        imageMinification: options.imageMinification, shaderKey: '',\n        lost: false,\n        onLost: () => { mine.lost = true; },\n        onRestored: () => {\n          mine.lost = false;\n          restored.emit();\n        },\n      };\n      canvas.addEventListener('webglcontextlost', held.onLost);\n      canvas.addEventListener('webglcontextrestored', held.onRestored);\n      let set = TENANTS.get(canvas);\n      if (!set) { set = new Set(); TENANTS.set(canvas, set); }\n      set.add(renderer);\n    } else {\n      // React writes the element's `width` and `height` attributes in CSS\n      // pixels on every size change, so a size that went away and came back\n      // matches the record while the buffer does not.\n      const stale = !shared\n        && (canvas.width !== Math.round(width * dpr) || canvas.height !== Math.round(height * dpr));\n      if (stale || held.width !== width || held.height !== height || held.dpr !== dpr) {\n        held.renderer.resize({ width, height, dpr });\n        held.width = width;\n        held.height = height;\n        held.dpr = dpr;\n      }\n      if (held.flattenTolerance !== options.flattenTolerance) {\n        held.renderer.setFlattenTolerance(options.flattenTolerance);\n        held.flattenTolerance = options.flattenTolerance;\n      }\n      if (held.retainBudget !== options.retainBudget) {\n        held.renderer.setRetainBudget(options.retainBudget);\n        held.retainBudget = options.retainBudget;\n      }\n      if (held.imageMinification !== options.imageMinification) {\n        held.renderer.setImageMinification(options.imageMinification);\n        held.imageMinification = options.imageMinification;\n      }\n    }\n\n    if (held.lost) return null;\n    const { renderer } = held;\n    const shaderKey = shaderKeyOf(options.shaders);\n    if (shaderKey !== held.shaderKey) {\n      registerShaders(renderer, options.shaders);\n      held.shaderKey = shaderKey;\n    }\n    const tileX = tile?.x ?? null;\n    const tileY = tile?.y ?? null;\n    if (tileX !== held.tileX || tileY !== held.tileY) {\n      renderer.setTarget(tile ? { origin: { x: tile.x, y: tile.y } } : null);\n      held.tileX = tileX;\n      held.tileY = tileY;\n    }\n    return renderer;\n  };\n  return {\n    bind,\n    paint(canvas, commands, view, size, options) {\n      const renderer = bind(canvas, size, options);\n      if (!renderer) return false;\n      renderer.render(commands, viewToMat3(view), options?.render);\n      return true;\n    },\n    subscribeRestored: restored.subscribe,\n    release() {\n      if (held) free(held);\n      held = null;\n    },\n  };\n}\n\n/** Leases held on a canvas's behalf by `paintCanvas`, one per element. */\nconst CANVAS_LEASES: WeakMap<HTMLCanvasElement, CanvasRendererLease> = new WeakMap();\n\n/**\n * Paint `canvas` through a lease held for the element itself, for callers\n * with no component lifetime of their own. The renderer lives until\n * `releaseCanvasRenderer(canvas)`.\n */\nexport function paintCanvas(\n  canvas: HTMLCanvasElement,\n  commands: DrawCommand[],\n  view: View,\n  size: CanvasPaintSize,\n): boolean {\n  let lease = CANVAS_LEASES.get(canvas);\n  if (!lease) {\n    lease = leaseCanvasRenderer();\n    CANVAS_LEASES.set(canvas, lease);\n  }\n  return lease.paint(canvas, commands, view, size);\n}\n\n/** Free the renderer `paintCanvas` holds for the canvas, and every GL object\n *  it owns. The next paint creates a fresh one. Renderers a surface component\n *  holds are that component's to free, on unmount. */\nexport function releaseCanvasRenderer(canvas: HTMLCanvasElement): void {\n  const lease = CANVAS_LEASES.get(canvas);\n  if (!lease) return;\n  CANVAS_LEASES.delete(canvas);\n  lease.release();\n}\n"],"mappings":"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"}
+{"version":3,"file":"canvasRenderer.js","names":["viewToMat3"],"sources":["../../src/canvas/canvasRenderer.ts"],"sourcesContent":["/**\n * The one renderer lifetime in core. Every on-screen surface holds its\n * `WeaselRenderer` through a `leaseCanvasRenderer` lease.\n *\n * A lease holds its own renderer, so several can share one element: each\n * tenant painting a `tile` of a shared buffer gets a renderer of its own on\n * the element's one context. Release frees only what that renderer created;\n * the context itself is never lost.\n */\nimport { WeaselRenderer, type FlattenTolerance, type ImageMinification, type RenderOptions } from '@weasel-js/renderer';\nimport { viewToMat3 } from '@weasel-js/geom';\nimport type { ShaderProgramHandle } from '@weasel-js/renderer';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { View } from '../core/viewport/view';\nimport { createEmitter } from '@weasel-js/registry';\nimport { CANVAS_CONTEXT_ATTRIBUTES } from './contextAttributes';\n\n/** The live renderers painting into each element, across every lease. */\nconst TENANTS: WeakMap<HTMLCanvasElement, Set<WeaselRenderer>> = new WeakMap();\n\n/** Canvases whose context the renderer refused, so a redraw does not rebuild\n *  and fail again, and the reason is reported once. */\nconst REFUSED: WeakSet<HTMLCanvasElement> = new WeakSet();\n\n/** A renderer painting into the canvas, if any lease holds one. Test seam. */\nexport function cachedCanvasRenderer(canvas: HTMLCanvasElement): WeaselRenderer | undefined {\n  const set = TENANTS.get(canvas);\n  return set ? set.values().next().value : undefined;\n}\n\n/** The size and density to paint a canvas at. `dpr` defaults to\n *  `window.devicePixelRatio`, read per paint. */\nexport interface CanvasPaintSize {\n  width: number;\n  height: number;\n  dpr?: number;\n}\n\n/** The density a canvas given `dpr` paints at. */\nexport function resolveDpr(dpr: number | undefined): number {\n  return dpr ?? (typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1);\n}\n\n/** How one paint reaches the canvas, beyond its size. */\nexport interface CanvasPaintOptions {\n  /** Paint a `width × height` tile of a buffer other surfaces share, at this\n   *  origin in CSS pixels. The buffer is then the caller's to size: the\n   *  renderer never resizes the element, which would have every co-tenant\n   *  resize it to its own pane. Omit to own the whole element. */\n  tile?: { x: number; y: number } | null;\n  /** `WeaselRendererOptions.flattenTolerance`, applied from this paint on. */\n  flattenTolerance?: FlattenTolerance;\n  /** `WeaselRendererOptions.retainBudget`, applied from this paint on. */\n  retainBudget?: number;\n  /** `WeaselRendererOptions.imageMinification`, applied from this paint on. */\n  imageMinification?: ImageMinification;\n  /** Custom programs to compile on the renderer. Compiled when the renderer\n   *  is created, and again when the set of ids changes. */\n  shaders?: readonly ShaderProgramHandle[];\n}\n\n/** A paint's options, plus what `paint` hands `WeaselRenderer.render`. */\nexport interface CanvasRenderOptions extends CanvasPaintOptions {\n  render?: RenderOptions;\n}\n\n/** A canvas renderer held for a surface's lifetime. */\nexport interface CanvasRendererLease {\n  /** Draw `commands` into `canvas` — screen-space, one unit per CSS pixel,\n   *  with `view` passed on as the frame's world→screen transform. `bind`,\n   *  then render. Returns `false` without painting where `bind` finds no\n   *  renderer. */\n  paint(\n    canvas: HTMLCanvasElement,\n    commands: DrawCommand[],\n    view: View,\n    size: CanvasPaintSize,\n    options?: CanvasRenderOptions,\n  ): boolean;\n  /** The renderer that paints `canvas` at `size`, ready to render: created on\n   *  first use, resized, and given this paint's tile, tolerance, retain\n   *  budget, and shaders.\n   *  Frees the previous renderer first if the surface moved to another\n   *  element, or between owning it whole and painting a tile of it. `null`\n   *  where no WebGL2 context is available (jsdom, a failed context creation,\n   *  or a context that is lost for now). */\n  bind(canvas: HTMLCanvasElement, size: CanvasPaintSize, options?: CanvasPaintOptions): WeaselRenderer | null;\n  /** Run `fn` when the canvas gets a lost context back, after the renderer\n   *  has rebuilt itself on it. Nothing repaints a restored buffer on its own.\n   *  Returns an unsubscribe. */\n  subscribeRestored(fn: () => void): () => void;\n  /** Free the held renderer and every GL object it owns. A later `paint`\n   *  creates a fresh one. */\n  release(): void;\n}\n\ninterface Held {\n  canvas: HTMLCanvasElement;\n  renderer: WeaselRenderer;\n  shared: boolean;\n  lost: boolean;\n  onLost: () => void;\n  onRestored: () => void;\n  width: number;\n  height: number;\n  dpr: number;\n  tileX: number | null;\n  tileY: number | null;\n  flattenTolerance: FlattenTolerance | undefined;\n  retainBudget: number | undefined;\n  imageMinification: ImageMinification | undefined;\n  shaderKey: string;\n}\n\n/** Identifies a set of custom programs by their ids, in order. */\nexport const shaderKeyOf = (shaders: readonly ShaderProgramHandle[] | undefined): string =>\n  shaders?.map((h) => h.id).join('|') ?? '';\n\nfunction registerShaders(renderer: WeaselRenderer, shaders: readonly ShaderProgramHandle[] | undefined): void {\n  if (!shaders) return;\n  for (const handle of shaders) {\n    try {\n      renderer.registerProgram(handle);\n    } catch (e) {\n      console.warn(`weasel: failed to register shader \"${handle.id}\":`, e);\n    }\n  }\n}\n\nfunction free(held: Held): void {\n  const set = TENANTS.get(held.canvas);\n  set?.delete(held.renderer);\n  held.canvas.removeEventListener('webglcontextlost', held.onLost);\n  held.canvas.removeEventListener('webglcontextrestored', held.onRestored);\n  if (set && set.size === 0) TENANTS.delete(held.canvas);\n  held.renderer.dispose();\n}\n\n/** Hold the renderer of the canvas a surface paints into, until released. */\nexport function leaseCanvasRenderer(): CanvasRendererLease {\n  let held: Held | null = null;\n  const restored = createEmitter();\n  const bind = (canvas: HTMLCanvasElement, size: CanvasPaintSize, options: CanvasPaintOptions = {}): WeaselRenderer | null => {\n    const { width, height } = size;\n    const dpr = resolveDpr(size.dpr);\n    const tile = options.tile ?? null;\n    const shared = tile !== null;\n\n    if (held && (held.canvas !== canvas || held.shared !== shared)) {\n      free(held);\n      held = null;\n    }\n    if (!held) {\n      if (REFUSED.has(canvas)) return null;\n      const gl = canvas.getContext('webgl2', CANVAS_CONTEXT_ATTRIBUTES);\n      if (!gl || typeof (gl as Partial<WebGL2RenderingContext>).enable !== 'function') return null;\n      let renderer: WeaselRenderer;\n      try {\n        renderer = new WeaselRenderer({\n          gl: gl as WebGL2RenderingContext,\n          ...(shared ? {} : { canvas }),\n          width, height, dpr,\n          flattenTolerance: options.flattenTolerance,\n          retainBudget: options.retainBudget,\n          imageMinification: options.imageMinification,\n        });\n      } catch (e) {\n        // A lost context fails to compile and may yet come back; anything\n        // else fails the same way next time.\n        if (!(gl as Partial<WebGL2RenderingContext>).isContextLost?.()) {\n          REFUSED.add(canvas);\n          console.warn('weasel: this canvas cannot be painted:', e);\n        }\n        return null;\n      }\n      // Added after the renderer's own listeners, so a subscriber runs against\n      // a renderer that has already recompiled.\n      const mine: Held = held = {\n        canvas, renderer, shared, width, height, dpr, tileX: null, tileY: null,\n        flattenTolerance: options.flattenTolerance, retainBudget: options.retainBudget,\n        imageMinification: options.imageMinification, shaderKey: '',\n        lost: false,\n        onLost: () => { mine.lost = true; },\n        onRestored: () => {\n          mine.lost = false;\n          restored.emit();\n        },\n      };\n      canvas.addEventListener('webglcontextlost', held.onLost);\n      canvas.addEventListener('webglcontextrestored', held.onRestored);\n      let set = TENANTS.get(canvas);\n      if (!set) { set = new Set(); TENANTS.set(canvas, set); }\n      set.add(renderer);\n    } else {\n      // React writes the element's `width` and `height` attributes in CSS\n      // pixels on every size change, so a size that went away and came back\n      // matches the record while the buffer does not.\n      const stale = !shared\n        && (canvas.width !== Math.round(width * dpr) || canvas.height !== Math.round(height * dpr));\n      if (stale || held.width !== width || held.height !== height || held.dpr !== dpr) {\n        held.renderer.resize({ width, height, dpr });\n        held.width = width;\n        held.height = height;\n        held.dpr = dpr;\n      }\n      if (held.flattenTolerance !== options.flattenTolerance) {\n        held.renderer.setFlattenTolerance(options.flattenTolerance);\n        held.flattenTolerance = options.flattenTolerance;\n      }\n      if (held.retainBudget !== options.retainBudget) {\n        held.renderer.setRetainBudget(options.retainBudget);\n        held.retainBudget = options.retainBudget;\n      }\n      if (held.imageMinification !== options.imageMinification) {\n        held.renderer.setImageMinification(options.imageMinification);\n        held.imageMinification = options.imageMinification;\n      }\n    }\n\n    if (held.lost) return null;\n    const { renderer } = held;\n    const shaderKey = shaderKeyOf(options.shaders);\n    if (shaderKey !== held.shaderKey) {\n      registerShaders(renderer, options.shaders);\n      held.shaderKey = shaderKey;\n    }\n    const tileX = tile?.x ?? null;\n    const tileY = tile?.y ?? null;\n    if (tileX !== held.tileX || tileY !== held.tileY) {\n      renderer.setTarget(tile ? { origin: { x: tile.x, y: tile.y } } : null);\n      held.tileX = tileX;\n      held.tileY = tileY;\n    }\n    return renderer;\n  };\n  return {\n    bind,\n    paint(canvas, commands, view, size, options) {\n      const renderer = bind(canvas, size, options);\n      if (!renderer) return false;\n      renderer.render(commands, viewToMat3(view), options?.render);\n      return true;\n    },\n    subscribeRestored: restored.subscribe,\n    release() {\n      if (held) free(held);\n      held = null;\n    },\n  };\n}\n\n/** Leases held on a canvas's behalf by `paintCanvas`, one per element. */\nconst CANVAS_LEASES: WeakMap<HTMLCanvasElement, CanvasRendererLease> = new WeakMap();\n\n/**\n * Paint `canvas` through a lease held for the element itself, for callers\n * with no component lifetime of their own. The renderer lives until\n * `releaseCanvasRenderer(canvas)`.\n */\nexport function paintCanvas(\n  canvas: HTMLCanvasElement,\n  commands: DrawCommand[],\n  view: View,\n  size: CanvasPaintSize,\n): boolean {\n  let lease = CANVAS_LEASES.get(canvas);\n  if (!lease) {\n    lease = leaseCanvasRenderer();\n    CANVAS_LEASES.set(canvas, lease);\n  }\n  return lease.paint(canvas, commands, view, size);\n}\n\n/** Free the renderer `paintCanvas` holds for the canvas, and every GL object\n *  it owns. The next paint creates a fresh one. Renderers a surface component\n *  holds are that component's to free, on unmount. */\nexport function releaseCanvasRenderer(canvas: HTMLCanvasElement): void {\n  const lease = CANVAS_LEASES.get(canvas);\n  if (!lease) return;\n  CANVAS_LEASES.delete(canvas);\n  lease.release();\n}\n"],"mappings":"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"}

package/dist/canvas/deps/editAnchors.js

@@ -1,10 +1,10 @@
 import { locksOf } from "../../interactions/actions/edit-anchors/params.js";
-import { representationOf } from "../../features/paths/pathRepresentation.js";
-import { classifyPathStorage, pathEditPathOf, resolveEditablePathOf } from "../../features/paths/editablePath.js";
-import { anchorDataPatch } from "../../features/paths/anchorData.js";
+import { representationOf } from "../../domains/paths/pathRepresentation.js";
+import { classifyPathStorage, pathEditPathOf, resolveEditablePathOf } from "../../domains/paths/editablePath.js";
+import { anchorDataPatch } from "../../domains/paths/anchorData.js";
 import { finishCtx, finishEdit, otherOps, pathEditFollower, reshapeOps } from "./pathEditCommits.js";
 import { useTransformFollower } from "./transformFollowers.js";
-import { createPathEditState, isSelectedNode } from "../../features/paths/pathEditState.js";
+import { createPathEditState, isSelectedNode } from "../../domains/paths/pathEditState.js";
 import { useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { resolveParams } from "@weasel-js/routing";

package/dist/canvas/deps/editAnchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"editAnchors.js","names":[],"sources":["../../../src/canvas/deps/editAnchors.ts"],"sourcesContent":["/**\n * `useEditAnchorsDepSource` — wires the `editAnchors` dep.\n *\n * A node's editable polygon lives in one of two places: the pose itself\n * (`pose.kind === 'polygon'`), or `data.path` with a rect pose, stored pose-local.\n * `getEditablePath` returns it in **world coords** either way, and `applyEdit` commits in the\n * correct storage shape as one undoable batch, preserving the render invariant\n * `pathInWorld(stored, pose) === world`. What the node keeps per anchor — a `data.skin`, vertex\n * colors — is renumbered in that batch when the caller says where the points came from, and each path-edit extension finishes\n * the edit first (`PathEditExtension.finishEdit`). Live previews ride the standard\n * `OngoingHandle.previewIds/Pose/Data` triple — this dep doesn't own preview state.\n */\nimport { useState } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { EditAnchorsDep } from 'interactions/actions/depSchema';\nimport { locksOf, type EditAnchorsParams } from 'interactions/actions/edit-anchors/params';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { PointOrigin, PolygonPath } from '@weasel-js/geom';\nimport { anchorDataPatch } from 'features/paths/anchorData';\nimport { classifyPathStorage, pathEditPathOf, resolveEditablePathOf } from 'features/paths/editablePath';\nimport { representationOf } from 'features/paths/pathRepresentation';\nimport type { PathEditExtension } from 'features/paths/pathEditExtension';\nimport {\n  finishCtx, finishEdit, otherOps, pathEditFollower, reshapeOps, type EditableNode,\n} from './pathEditCommits';\nimport { useTransformFollower } from './transformFollowers';\nimport { createPathEditState, isSelectedNode, type PathEditState } from 'features/paths/pathEditState';\nimport { resolveParams, type ActionTunings } from '@weasel-js/routing';\nimport type { Op } from 'core/ops/types';\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/** The part of a `PathEditState` the dep reads and writes. */\nexport type EditAnchorsStateRef = Omit<PathEditState, 'subscribe' | 'getEditingIds' | 'setExtensions'>;\n/** The same, with the change notice chrome reading the dep waits on. */\nexport type EditAnchorsStateSource = EditAnchorsStateRef & Partial<Pick<PathEditState, 'subscribe'>>;\n\nexport { resolveEditablePathOf };\n\nfunction tunedHandleLock(tune: ActionTunings | undefined): EditAnchorsParams['handleLock'] {\n  const params = resolveParams(tune?.editAnchors?.params as Parameters<typeof resolveParams>[0]);\n  return (params as EditAnchorsParams | undefined)?.handleLock;\n}\n\nconst EMPTY_ANCHOR_SELECTION: ReadonlySet<number> = new Set<number>();\n\n/**\n * Publish the `editAnchors` dep for `scene`: its path access and commits\n * through `adapter`, and the edit state of `externalState` (or one of its\n * own), with the extensions that state holds finishing every edit.\n */\nexport function useEditAnchorsDepSource(\n  scene: Scene<unknown, string, unknown>,\n  selection: SelectionApi,\n  adapter: OpsApplier,\n  externalState?: EditAnchorsStateRef,\n  /** `<SceneCanvas tune>`: the handle locks start from its `editAnchors`\n   *  `handleLock` param until a toggle sets them. */\n  tune?: ActionTunings,\n): void {\n  const registry = useDepRegistry();\n  const tuneRef = useLatest(tune);\n  const sceneRef = useLatest(scene);\n  const selectionRef = useLatest(selection);\n  const adapterRef = useLatest(adapter);\n\n  // A caller that shares the state with nothing else gets one of its own.\n  const [ownState] = useState(() => createPathEditState({\n    isSelectedNode: (id) => isSelectedNode(sceneRef.current, selectionRef.current, id),\n  }));\n  const stateRef = useLatest(externalState ?? ownState);\n\n  useDepSource('editAnchors', (): EditAnchorsDep => {\n    const sc = sceneRef.current;\n    const ad = adapterRef.current;\n    const state = stateRef.current;\n    const effectiveId = state.getEditingId();\n    // Anchor selection and the marquee belong to one specific edited node, so never\n    // hand them out alongside an empty id.\n    const selectedAnchors = effectiveId ? state.getSelectedAnchors() : EMPTY_ANCHOR_SELECTION;\n    const marquee = effectiveId ? state.getMarquee() : null;\n    const tool = effectiveId ? state.getTool() : null;\n    return {\n      editingId: effectiveId,\n      setEditingId(id: string | null) {\n        const next = id ?? '';\n        if (effectiveId !== next) {\n          registry.get('dispatchTrace')?.recordModeSwitch(\n            'editAnchors.editingId',\n            effectiveId || null,\n            next || null,\n            next ? 'enter' : 'exit',\n          );\n          // Anchor indices only mean something relative to one path.\n          state.setSelectedAnchors(EMPTY_ANCHOR_SELECTION);\n          state.setSelectedMark(null);\n          state.setMarquee(null);\n        }\n        stateRef.current.setEditingId(id);\n      },\n      selectedAnchors,\n      setSelectedAnchors(next: Iterable<number>) {\n        if (!effectiveId) return;\n        const set = new Set(next);\n        if (set.size > 0) state.setSelectedMark(null);\n        state.setSelectedAnchors(set);\n      },\n      selectedMark: effectiveId ? state.getSelectedMark() : null,\n      setSelectedMark(mark) {\n        if (!effectiveId) return;\n        if (mark !== null) state.setSelectedAnchors(EMPTY_ANCHOR_SELECTION);\n        state.setSelectedMark(mark);\n      },\n      extensions: state.getExtensions(),\n      marquee,\n      setMarquee(rect) {\n        if (!effectiveId) return;\n        state.setMarquee(rect);\n      },\n      handleLocks: state.getHandleLocks() ?? locksOf(tunedHandleLock(tuneRef.current)),\n      setHandleLocks(next) {\n        state.setHandleLocks(next);\n        registry.changed?.();\n      },\n      tool,\n      setTool(id) {\n        if (!effectiveId) return;\n        state.setTool(id);\n      },\n      ...pathAccess(sc, ad, state.getExtensions()),\n    };\n  });\n  useTransformFollower(() => pathEditFollower(sceneRef.current, stateRef.current.getExtensions()));\n}\n\n/** The members of the dep that read the scene and commit to it. */\nfunction pathAccess(\n  sc: Scene<unknown, string, unknown>,\n  ad: OpsApplier,\n  extensions: readonly PathEditExtension[],\n): Pick<\n  EditAnchorsDep,\n  | 'getEditablePath' | 'getOutlinePath' | 'getStorageKind' | 'getNodeShape' | 'applyEdit' | 'editOps' | 'finishEdit'\n  | 'store'\n> {\n  const editOps = (id: string, worldPath: unknown, label: string, origins?: readonly (PointOrigin | null)[]): Op[] => {\n    const node = sc.get(id as NodeId) as EditableNode | undefined;\n    if (!node) return [];\n    const done = finishEdit(extensions, node, worldPath as PolygonPath, origins, finishCtx(sc, id, extensions));\n    if (!done) return [];\n    // A form's origins number the anchors of its edit path, not data.path's.\n    const before = origins && !representationOf(extensions, node.data) ? resolveEditablePathOf(node) : null;\n    const patch = { ...(before && origins ? anchorDataPatch(node.data, before, done.path, origins) : {}), ...done.data };\n    return [\n      ...reshapeOps(id, node, done.path, label, Object.keys(patch).length > 0 ? patch : null, extensions),\n      ...otherOps(sc, done.others, label, extensions),\n    ];\n  };\n  return {\n    getEditablePath(id: string): PolygonPath | null {\n      const node = sc.get(id as NodeId);\n      return pathEditPathOf(node as { pose: unknown; data: unknown }, extensions);\n    },\n    getOutlinePath(id: string): PolygonPath | null {\n      return resolveEditablePathOf(sc.get(id as NodeId) as { pose: unknown; data: unknown });\n    },\n    getStorageKind(id: string): 'pose' | 'data' | null {\n      const node = sc.get(id as NodeId);\n      const storage = classifyPathStorage(node as { pose: unknown; data: unknown });\n      return storage?.kind ?? null;\n    },\n    getNodeShape(id: string): { pose: unknown; data: unknown } | null {\n      const node = sc.get(id as NodeId);\n      if (!node) return null;\n      return { pose: node.pose, data: node.data };\n    },\n    applyEdit(id: string, worldPath: unknown, label: string, origins?: readonly (PointOrigin | null)[]) {\n      const ops = editOps(id, worldPath, label, origins);\n      if (ops.length > 0) ad.applyOps(ops, label);\n    },\n    editOps,\n    finishEdit(id: string, worldPath: unknown, origins?: readonly (PointOrigin | null)[]) {\n      const node = sc.get(id as NodeId) as EditableNode | undefined;\n      if (!node) return { path: worldPath, others: [] };\n      const done = finishEdit(extensions, node, worldPath as PolygonPath, origins, finishCtx(sc, id, extensions));\n      if (!done) return null;\n      const others = [...done.others.values()].flatMap((o) => (o.path && !o.remove ? [{ id: o.id, path: o.path }] : []));\n      return { path: done.path, others };\n    },\n    store(id, worldPath, label, data) {\n      const node = sc.get(id as NodeId) as EditableNode | undefined;\n      const ops = node ? reshapeOps(id, node, worldPath, label, data ?? null, extensions) : [];\n      if (ops.length > 0) ad.applyOps(ops, label);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"editAnchors.js","names":[],"sources":["../../../src/canvas/deps/editAnchors.ts"],"sourcesContent":["/**\n * `useEditAnchorsDepSource` — wires the `editAnchors` dep.\n *\n * A node's editable polygon lives in one of two places: the pose itself\n * (`pose.kind === 'polygon'`), or `data.path` with a rect pose, stored pose-local.\n * `getEditablePath` returns it in **world coords** either way, and `applyEdit` commits in the\n * correct storage shape as one undoable batch, preserving the render invariant\n * `pathInWorld(stored, pose) === world`. What the node keeps per anchor — a `data.skin`, vertex\n * colors — is renumbered in that batch when the caller says where the points came from, and each path-edit extension finishes\n * the edit first (`PathEditExtension.finishEdit`). Live previews ride the standard\n * `OngoingHandle.previewIds/Pose/Data` triple — this dep doesn't own preview state.\n */\nimport { useState } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { EditAnchorsDep } from 'interactions/actions/depSchema';\nimport { locksOf, type EditAnchorsParams } from 'interactions/actions/edit-anchors/params';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { PointOrigin, PolygonPath } from '@weasel-js/geom';\nimport { anchorDataPatch } from 'domains/paths/anchorData';\nimport { classifyPathStorage, pathEditPathOf, resolveEditablePathOf } from 'domains/paths/editablePath';\nimport { representationOf } from 'domains/paths/pathRepresentation';\nimport type { PathEditExtension } from 'domains/paths/pathEditExtension';\nimport {\n  finishCtx, finishEdit, otherOps, pathEditFollower, reshapeOps, type EditableNode,\n} from './pathEditCommits';\nimport { useTransformFollower } from './transformFollowers';\nimport { createPathEditState, isSelectedNode, type PathEditState } from 'domains/paths/pathEditState';\nimport { resolveParams, type ActionTunings } from '@weasel-js/routing';\nimport type { Op } from 'core/ops/types';\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/** The part of a `PathEditState` the dep reads and writes. */\nexport type EditAnchorsStateRef = Omit<PathEditState, 'subscribe' | 'getEditingIds' | 'setExtensions'>;\n/** The same, with the change notice chrome reading the dep waits on. */\nexport type EditAnchorsStateSource = EditAnchorsStateRef & Partial<Pick<PathEditState, 'subscribe'>>;\n\nexport { resolveEditablePathOf };\n\nfunction tunedHandleLock(tune: ActionTunings | undefined): EditAnchorsParams['handleLock'] {\n  const params = resolveParams(tune?.editAnchors?.params as Parameters<typeof resolveParams>[0]);\n  return (params as EditAnchorsParams | undefined)?.handleLock;\n}\n\nconst EMPTY_ANCHOR_SELECTION: ReadonlySet<number> = new Set<number>();\n\n/**\n * Publish the `editAnchors` dep for `scene`: its path access and commits\n * through `adapter`, and the edit state of `externalState` (or one of its\n * own), with the extensions that state holds finishing every edit.\n */\nexport function useEditAnchorsDepSource(\n  scene: Scene<unknown, string, unknown>,\n  selection: SelectionApi,\n  adapter: OpsApplier,\n  externalState?: EditAnchorsStateRef,\n  /** `<SceneCanvas tune>`: the handle locks start from its `editAnchors`\n   *  `handleLock` param until a toggle sets them. */\n  tune?: ActionTunings,\n): void {\n  const registry = useDepRegistry();\n  const tuneRef = useLatest(tune);\n  const sceneRef = useLatest(scene);\n  const selectionRef = useLatest(selection);\n  const adapterRef = useLatest(adapter);\n\n  // A caller that shares the state with nothing else gets one of its own.\n  const [ownState] = useState(() => createPathEditState({\n    isSelectedNode: (id) => isSelectedNode(sceneRef.current, selectionRef.current, id),\n  }));\n  const stateRef = useLatest(externalState ?? ownState);\n\n  useDepSource('editAnchors', (): EditAnchorsDep => {\n    const sc = sceneRef.current;\n    const ad = adapterRef.current;\n    const state = stateRef.current;\n    const effectiveId = state.getEditingId();\n    // Anchor selection and the marquee belong to one specific edited node, so never\n    // hand them out alongside an empty id.\n    const selectedAnchors = effectiveId ? state.getSelectedAnchors() : EMPTY_ANCHOR_SELECTION;\n    const marquee = effectiveId ? state.getMarquee() : null;\n    const tool = effectiveId ? state.getTool() : null;\n    return {\n      editingId: effectiveId,\n      setEditingId(id: string | null) {\n        const next = id ?? '';\n        if (effectiveId !== next) {\n          registry.get('dispatchTrace')?.recordModeSwitch(\n            'editAnchors.editingId',\n            effectiveId || null,\n            next || null,\n            next ? 'enter' : 'exit',\n          );\n          // Anchor indices only mean something relative to one path.\n          state.setSelectedAnchors(EMPTY_ANCHOR_SELECTION);\n          state.setSelectedMark(null);\n          state.setMarquee(null);\n        }\n        stateRef.current.setEditingId(id);\n      },\n      selectedAnchors,\n      setSelectedAnchors(next: Iterable<number>) {\n        if (!effectiveId) return;\n        const set = new Set(next);\n        if (set.size > 0) state.setSelectedMark(null);\n        state.setSelectedAnchors(set);\n      },\n      selectedMark: effectiveId ? state.getSelectedMark() : null,\n      setSelectedMark(mark) {\n        if (!effectiveId) return;\n        if (mark !== null) state.setSelectedAnchors(EMPTY_ANCHOR_SELECTION);\n        state.setSelectedMark(mark);\n      },\n      extensions: state.getExtensions(),\n      marquee,\n      setMarquee(rect) {\n        if (!effectiveId) return;\n        state.setMarquee(rect);\n      },\n      handleLocks: state.getHandleLocks() ?? locksOf(tunedHandleLock(tuneRef.current)),\n      setHandleLocks(next) {\n        state.setHandleLocks(next);\n        registry.changed?.();\n      },\n      tool,\n      setTool(id) {\n        if (!effectiveId) return;\n        state.setTool(id);\n      },\n      ...pathAccess(sc, ad, state.getExtensions()),\n    };\n  });\n  useTransformFollower(() => pathEditFollower(sceneRef.current, stateRef.current.getExtensions()));\n}\n\n/** The members of the dep that read the scene and commit to it. */\nfunction pathAccess(\n  sc: Scene<unknown, string, unknown>,\n  ad: OpsApplier,\n  extensions: readonly PathEditExtension[],\n): Pick<\n  EditAnchorsDep,\n  | 'getEditablePath' | 'getOutlinePath' | 'getStorageKind' | 'getNodeShape' | 'applyEdit' | 'editOps' | 'finishEdit'\n  | 'store'\n> {\n  const editOps = (id: string, worldPath: unknown, label: string, origins?: readonly (PointOrigin | null)[]): Op[] => {\n    const node = sc.get(id as NodeId) as EditableNode | undefined;\n    if (!node) return [];\n    const done = finishEdit(extensions, node, worldPath as PolygonPath, origins, finishCtx(sc, id, extensions));\n    if (!done) return [];\n    // A form's origins number the anchors of its edit path, not data.path's.\n    const before = origins && !representationOf(extensions, node.data) ? resolveEditablePathOf(node) : null;\n    const patch = { ...(before && origins ? anchorDataPatch(node.data, before, done.path, origins) : {}), ...done.data };\n    return [\n      ...reshapeOps(id, node, done.path, label, Object.keys(patch).length > 0 ? patch : null, extensions),\n      ...otherOps(sc, done.others, label, extensions),\n    ];\n  };\n  return {\n    getEditablePath(id: string): PolygonPath | null {\n      const node = sc.get(id as NodeId);\n      return pathEditPathOf(node as { pose: unknown; data: unknown }, extensions);\n    },\n    getOutlinePath(id: string): PolygonPath | null {\n      return resolveEditablePathOf(sc.get(id as NodeId) as { pose: unknown; data: unknown });\n    },\n    getStorageKind(id: string): 'pose' | 'data' | null {\n      const node = sc.get(id as NodeId);\n      const storage = classifyPathStorage(node as { pose: unknown; data: unknown });\n      return storage?.kind ?? null;\n    },\n    getNodeShape(id: string): { pose: unknown; data: unknown } | null {\n      const node = sc.get(id as NodeId);\n      if (!node) return null;\n      return { pose: node.pose, data: node.data };\n    },\n    applyEdit(id: string, worldPath: unknown, label: string, origins?: readonly (PointOrigin | null)[]) {\n      const ops = editOps(id, worldPath, label, origins);\n      if (ops.length > 0) ad.applyOps(ops, label);\n    },\n    editOps,\n    finishEdit(id: string, worldPath: unknown, origins?: readonly (PointOrigin | null)[]) {\n      const node = sc.get(id as NodeId) as EditableNode | undefined;\n      if (!node) return { path: worldPath, others: [] };\n      const done = finishEdit(extensions, node, worldPath as PolygonPath, origins, finishCtx(sc, id, extensions));\n      if (!done) return null;\n      const others = [...done.others.values()].flatMap((o) => (o.path && !o.remove ? [{ id: o.id, path: o.path }] : []));\n      return { path: done.path, others };\n    },\n    store(id, worldPath, label, data) {\n      const node = sc.get(id as NodeId) as EditableNode | undefined;\n      const ops = node ? reshapeOps(id, node, worldPath, label, data ?? null, extensions) : [];\n      if (ops.length > 0) ad.applyOps(ops, label);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/canvas/deps/enteredGroup.js

@@ -10,17 +10,26 @@ import { useDepRegistry, useDepSource } from "@weasel-js/routing/react";
 * innermost of those still in the scene, so deleting the group lands on its
 * parent, and an undo that brings it back lands on it again.
 */
-/** Whether `id` is reachable while `group` is entered: inside it, and not the group itself. With
-*  nothing entered every node is. Picking, region selects and select-all all ask this. */
+/** Whether a node is entered as a group is: a group, or a node that consumes its children. */
+function isEnterable(node) {
+	return node?.kind === "group" || node?.consumesChildren === true;
+}
+/** Whether `id` is reachable while `group` is entered: inside it, and not the group itself, and
+*  not consumed by a node inside it (`SceneNode.consumesChildren`). With nothing entered every node
+*  no node consumes is. Picking, region selects and select-all all ask this. */
 function reachableInGroup(scene, group, id) {
-	return group === null || scene.ancestorsOf(id).includes(group);
+	for (const above of scene.ancestorsOf(id)) {
+		if (above === group) return true;
+		if (scene.get(above)?.consumesChildren === true) return false;
+	}
+	return group === null;
 }
 /** An entered-group store over `scene`, with nothing entered. */
 function createEnteredGroup(scene) {
 	let chain = [];
 	let announced = null;
 	const listeners = /* @__PURE__ */ new Set();
-	const isGroup = (id) => scene.get(id)?.kind === "group";
+	const isGroup = (id) => isEnterable(scene.get(id));
 	const get = () => chain.find(isGroup) ?? null;
 	const groupsFrom = (id) => [id, ...scene.ancestorsOf(id)].filter(isGroup);
 	const announce = () => {
@@ -77,5 +86,5 @@ function useEnteredGroupApiSource(dep) {
 }
 
 //#endregion
-export { createEnteredGroup, reachableInGroup, useEnteredGroup, useEnteredGroupApiSource };
+export { createEnteredGroup, isEnterable, reachableInGroup, useEnteredGroup, useEnteredGroupApiSource };
 //# sourceMappingURL=enteredGroup.js.map

package/dist/canvas/deps/enteredGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"enteredGroup.js","names":[],"sources":["../../../src/canvas/deps/enteredGroup.ts"],"sourcesContent":["/**\n * The entered group: the group a press resolves inside of. Session state beside\n * the selection, not scene data, so it is never saved and never undone.\n *\n * It remembers the entered group and the groups above it. `get()` answers the\n * innermost of those still in the scene, so deleting the group lands on its\n * parent, and an undo that brings it back lands on it again.\n */\nimport { useEffect, useMemo } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport type { NodeId, Scene } from 'core/scene/types';\n\n/** The group a press resolves inside of, held beside the selection; `<SceneCanvas enteredGroup>` takes one. */\nexport interface EnteredGroupApi {\n  get(): NodeId | null;\n  enter(id: NodeId): void;\n  /** Moves to the nearest group above the current one, or to none. */\n  leave(): void;\n  /** Leaves every entered group at once. */\n  leaveAll(): void;\n  subscribe(fn: () => void): () => void;\n}\n\n/** Whether `id` is reachable while `group` is entered: inside it, and not the group itself. With\n *  nothing entered every node is. Picking, region selects and select-all all ask this. */\nexport function reachableInGroup(\n  scene: Pick<Scene<unknown, string, unknown>, 'ancestorsOf'>,\n  group: NodeId | null,\n  id: string,\n): boolean {\n  return group === null || scene.ancestorsOf(id as NodeId).includes(group);\n}\n\ntype SceneReads = Pick<Scene<unknown, string, unknown>, 'get' | 'ancestorsOf' | 'subscribe'>;\n\n/** An entered-group store over `scene`, with nothing entered. */\nexport function createEnteredGroup(scene: SceneReads): EnteredGroupApi {\n  let chain: NodeId[] = [];\n  let announced: NodeId | null = null;\n  const listeners = new Set<() => void>();\n\n  const isGroup = (id: NodeId) => scene.get(id)?.kind === 'group';\n  const get = (): NodeId | null => chain.find(isGroup) ?? null;\n  const groupsFrom = (id: NodeId): NodeId[] => [id, ...scene.ancestorsOf(id)].filter(isGroup);\n\n  const announce = () => {\n    announced = get();\n    for (const fn of [...listeners]) fn();\n  };\n\n  let stopScene: (() => void) | null = null;\n  const watchScene = () => scene.subscribe(() => {\n    if (get() !== announced) announce();\n  });\n\n  return {\n    get,\n    enter(id) {\n      if (!isGroup(id)) return;\n      chain = groupsFrom(id);\n      announce();\n    },\n    leave() {\n      const here = get();\n      if (here === null) return;\n      chain = groupsFrom(here).slice(1);\n      announce();\n    },\n    leaveAll() {\n      if (get() === null) return;\n      chain = [];\n      announce();\n    },\n    subscribe(fn) {\n      if (listeners.size === 0) {\n        announced = get();\n        stopScene = watchScene();\n      }\n      listeners.add(fn);\n      return () => {\n        listeners.delete(fn);\n        if (listeners.size === 0) { stopScene?.(); stopScene = null; }\n      };\n    },\n  };\n}\n\n/** One entered-group store for the life of the scene. */\nexport function useEnteredGroup(scene: SceneReads): EnteredGroupApi {\n  return useMemo(() => createEnteredGroup(scene), [scene]);\n}\n\nexport function useEnteredGroupApiSource(dep: EnteredGroupApi): void {\n  useDepSource('enteredGroup', () => dep);\n  // What is drawn or pasted while a group is entered lands in it, unless a source\n  // registered under this one, such as a symmetry group, names a container.\n  useDepSource('insertInto', (below) => ({ get: () => below()?.get() ?? dep.get() }));\n  const registry = useDepRegistry();\n  useEffect(() => dep.subscribe(() => registry.changed?.()), [dep, registry]);\n}\n"],"mappings":";;;;;;;;;;;;;;AAyBA,SAAgB,iBACd,OACA,OACA,IACS;CACT,OAAO,UAAU,QAAQ,MAAM,YAAY,EAAY,CAAC,CAAC,SAAS,KAAK;AACzE;;AAKA,SAAgB,mBAAmB,OAAoC;CACrE,IAAI,QAAkB,CAAC;CACvB,IAAI,YAA2B;CAC/B,MAAM,4BAAY,IAAI,IAAgB;CAEtC,MAAM,WAAW,OAAe,MAAM,IAAI,EAAE,CAAC,EAAE,SAAS;CACxD,MAAM,YAA2B,MAAM,KAAK,OAAO,KAAK;CACxD,MAAM,cAAc,OAAyB,CAAC,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO;CAE1F,MAAM,iBAAiB;EACrB,YAAY,IAAI;EAChB,KAAK,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,GAAG;CACtC;CAEA,IAAI,YAAiC;CACrC,MAAM,mBAAmB,MAAM,gBAAgB;EAC7C,IAAI,IAAI,MAAM,WAAW,SAAS;CACpC,CAAC;CAED,OAAO;EACL;EACA,MAAM,IAAI;GACR,IAAI,CAAC,QAAQ,EAAE,GAAG;GAClB,QAAQ,WAAW,EAAE;GACrB,SAAS;EACX;EACA,QAAQ;GACN,MAAM,OAAO,IAAI;GACjB,IAAI,SAAS,MAAM;GACnB,QAAQ,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC;GAChC,SAAS;EACX;EACA,WAAW;GACT,IAAI,IAAI,MAAM,MAAM;GACpB,QAAQ,CAAC;GACT,SAAS;EACX;EACA,UAAU,IAAI;GACZ,IAAI,UAAU,SAAS,GAAG;IACxB,YAAY,IAAI;IAChB,YAAY,WAAW;GACzB;GACA,UAAU,IAAI,EAAE;GAChB,aAAa;IACX,UAAU,OAAO,EAAE;IACnB,IAAI,UAAU,SAAS,GAAG;KAAE,YAAY;KAAG,YAAY;IAAM;GAC/D;EACF;CACF;AACF;;AAGA,SAAgB,gBAAgB,OAAoC;CAClE,OAAO,cAAc,mBAAmB,KAAK,GAAG,CAAC,KAAK,CAAC;AACzD;AAEA,SAAgB,yBAAyB,KAA4B;CACnE,aAAa,sBAAsB,GAAG;CAGtC,aAAa,eAAe,WAAW,EAAE,WAAW,MAAM,CAAC,EAAE,IAAI,KAAK,IAAI,IAAI,EAAE,EAAE;CAClF,MAAM,WAAW,eAAe;CAChC,gBAAgB,IAAI,gBAAgB,SAAS,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AAC5E"}
+{"version":3,"file":"enteredGroup.js","names":[],"sources":["../../../src/canvas/deps/enteredGroup.ts"],"sourcesContent":["/**\n * The entered group: the group a press resolves inside of. Session state beside\n * the selection, not scene data, so it is never saved and never undone.\n *\n * It remembers the entered group and the groups above it. `get()` answers the\n * innermost of those still in the scene, so deleting the group lands on its\n * parent, and an undo that brings it back lands on it again.\n */\nimport { useEffect, useMemo } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport type { NodeId, Scene } from 'core/scene/types';\n\n/** The group a press resolves inside of, held beside the selection; `<SceneCanvas enteredGroup>` takes one. */\nexport interface EnteredGroupApi {\n  get(): NodeId | null;\n  enter(id: NodeId): void;\n  /** Moves to the nearest group above the current one, or to none. */\n  leave(): void;\n  /** Leaves every entered group at once. */\n  leaveAll(): void;\n  subscribe(fn: () => void): () => void;\n}\n\n/** Whether a node is entered as a group is: a group, or a node that consumes its children. */\nexport function isEnterable(node: { kind?: string; consumesChildren?: boolean } | undefined): boolean {\n  return node?.kind === 'group' || node?.consumesChildren === true;\n}\n\n/** Whether `id` is reachable while `group` is entered: inside it, and not the group itself, and\n *  not consumed by a node inside it (`SceneNode.consumesChildren`). With nothing entered every node\n *  no node consumes is. Picking, region selects and select-all all ask this. */\nexport function reachableInGroup(\n  scene: Pick<Scene<unknown, string, unknown>, 'ancestorsOf' | 'get'>,\n  group: NodeId | null,\n  id: string,\n): boolean {\n  for (const above of scene.ancestorsOf(id as NodeId)) {\n    if (above === group) return true;\n    if (scene.get(above)?.consumesChildren === true) return false;\n  }\n  return group === null;\n}\n\ntype SceneReads = Pick<Scene<unknown, string, unknown>, 'get' | 'ancestorsOf' | 'subscribe'>;\n\n/** An entered-group store over `scene`, with nothing entered. */\nexport function createEnteredGroup(scene: SceneReads): EnteredGroupApi {\n  let chain: NodeId[] = [];\n  let announced: NodeId | null = null;\n  const listeners = new Set<() => void>();\n\n  const isGroup = (id: NodeId) => isEnterable(scene.get(id));\n  const get = (): NodeId | null => chain.find(isGroup) ?? null;\n  const groupsFrom = (id: NodeId): NodeId[] => [id, ...scene.ancestorsOf(id)].filter(isGroup);\n\n  const announce = () => {\n    announced = get();\n    for (const fn of [...listeners]) fn();\n  };\n\n  let stopScene: (() => void) | null = null;\n  const watchScene = () => scene.subscribe(() => {\n    if (get() !== announced) announce();\n  });\n\n  return {\n    get,\n    enter(id) {\n      if (!isGroup(id)) return;\n      chain = groupsFrom(id);\n      announce();\n    },\n    leave() {\n      const here = get();\n      if (here === null) return;\n      chain = groupsFrom(here).slice(1);\n      announce();\n    },\n    leaveAll() {\n      if (get() === null) return;\n      chain = [];\n      announce();\n    },\n    subscribe(fn) {\n      if (listeners.size === 0) {\n        announced = get();\n        stopScene = watchScene();\n      }\n      listeners.add(fn);\n      return () => {\n        listeners.delete(fn);\n        if (listeners.size === 0) { stopScene?.(); stopScene = null; }\n      };\n    },\n  };\n}\n\n/** One entered-group store for the life of the scene. */\nexport function useEnteredGroup(scene: SceneReads): EnteredGroupApi {\n  return useMemo(() => createEnteredGroup(scene), [scene]);\n}\n\nexport function useEnteredGroupApiSource(dep: EnteredGroupApi): void {\n  useDepSource('enteredGroup', () => dep);\n  // What is drawn or pasted while a group is entered lands in it, unless a source\n  // registered under this one, such as a symmetry group, names a container.\n  useDepSource('insertInto', (below) => ({ get: () => below()?.get() ?? dep.get() }));\n  const registry = useDepRegistry();\n  useEffect(() => dep.subscribe(() => registry.changed?.()), [dep, registry]);\n}\n"],"mappings":";;;;;;;;;;;;;AAwBA,SAAgB,YAAY,MAA0E;CACpG,OAAO,MAAM,SAAS,WAAW,MAAM,qBAAqB;AAC9D;;;;AAKA,SAAgB,iBACd,OACA,OACA,IACS;CACT,KAAK,MAAM,SAAS,MAAM,YAAY,EAAY,GAAG;EACnD,IAAI,UAAU,OAAO,OAAO;EAC5B,IAAI,MAAM,IAAI,KAAK,CAAC,EAAE,qBAAqB,MAAM,OAAO;CAC1D;CACA,OAAO,UAAU;AACnB;;AAKA,SAAgB,mBAAmB,OAAoC;CACrE,IAAI,QAAkB,CAAC;CACvB,IAAI,YAA2B;CAC/B,MAAM,4BAAY,IAAI,IAAgB;CAEtC,MAAM,WAAW,OAAe,YAAY,MAAM,IAAI,EAAE,CAAC;CACzD,MAAM,YAA2B,MAAM,KAAK,OAAO,KAAK;CACxD,MAAM,cAAc,OAAyB,CAAC,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO;CAE1F,MAAM,iBAAiB;EACrB,YAAY,IAAI;EAChB,KAAK,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,GAAG;CACtC;CAEA,IAAI,YAAiC;CACrC,MAAM,mBAAmB,MAAM,gBAAgB;EAC7C,IAAI,IAAI,MAAM,WAAW,SAAS;CACpC,CAAC;CAED,OAAO;EACL;EACA,MAAM,IAAI;GACR,IAAI,CAAC,QAAQ,EAAE,GAAG;GAClB,QAAQ,WAAW,EAAE;GACrB,SAAS;EACX;EACA,QAAQ;GACN,MAAM,OAAO,IAAI;GACjB,IAAI,SAAS,MAAM;GACnB,QAAQ,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC;GAChC,SAAS;EACX;EACA,WAAW;GACT,IAAI,IAAI,MAAM,MAAM;GACpB,QAAQ,CAAC;GACT,SAAS;EACX;EACA,UAAU,IAAI;GACZ,IAAI,UAAU,SAAS,GAAG;IACxB,YAAY,IAAI;IAChB,YAAY,WAAW;GACzB;GACA,UAAU,IAAI,EAAE;GAChB,aAAa;IACX,UAAU,OAAO,EAAE;IACnB,IAAI,UAAU,SAAS,GAAG;KAAE,YAAY;KAAG,YAAY;IAAM;GAC/D;EACF;CACF;AACF;;AAGA,SAAgB,gBAAgB,OAAoC;CAClE,OAAO,cAAc,mBAAmB,KAAK,GAAG,CAAC,KAAK,CAAC;AACzD;AAEA,SAAgB,yBAAyB,KAA4B;CACnE,aAAa,sBAAsB,GAAG;CAGtC,aAAa,eAAe,WAAW,EAAE,WAAW,MAAM,CAAC,EAAE,IAAI,KAAK,IAAI,IAAI,EAAE,EAAE;CAClF,MAAM,WAAW,eAAe;CAChC,gBAAgB,IAAI,gBAAgB,SAAS,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AAC5E"}

package/dist/canvas/deps/ingestion.js

@@ -3,11 +3,12 @@ import { useLatest } from "@weasel-js/react";
 import { useDepSource } from "@weasel-js/routing/react";
 
 //#region src/canvas/deps/ingestion.ts
-function useIngestionDepSource(canvasRef, getView, resolveSrc, svg, clipboard) {
+function useIngestionDepSource(canvasRef, getView, resolveSrc, svg, clipboard, handlers) {
 	const getViewRef = useLatest(getView);
 	const resolveSrcRef = useLatest(resolveSrc);
 	const svgRef = useLatest(svg);
 	const clipboardRef = useLatest(clipboard);
+	const handlersRef = useLatest(handlers);
 	useDepSource("ingestion", () => ({
 		viewportWorldRect() {
 			const canvas = canvasRef.current;
@@ -27,6 +28,9 @@ function useIngestionDepSource(canvasRef, getView, resolveSrc, svg, clipboard) {
 		},
 		get clipboard() {
 			return clipboardRef.current;
+		},
+		get handlers() {
+			return handlersRef.current;
 		}
 	}));
 }

package/dist/canvas/deps/ingestion.js.map

@@ -1 +1 @@
-{"version":3,"file":"ingestion.js","names":[],"sources":["../../../src/canvas/deps/ingestion.ts"],"sourcesContent":["/**\n * `useIngestionDepSource` — wires the `ingestion` dep consumed by\n * `ingestAction`, for the canvas's own view. Computes the visible world rect\n * from the canvas's client rect + current view, and forwards the consumer's\n * optional `resolveSrc`. A `<CanvasView>` overlays this dep with its own rect.\n */\nimport type { RefObject } from 'react';\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ClipboardIngestCtx, IngestionDep, SvgIngestOptions } from 'interactions/actions/depSchema';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport type { View } from 'core/viewport/view';\n\nexport function useIngestionDepSource(\n  canvasRef: RefObject<HTMLElement | null>,\n  getView: () => View,\n  resolveSrc?: (file: File) => Promise<string>,\n  svg?: SvgIngestOptions,\n  clipboard?: ClipboardIngestCtx,\n): void {\n  const getViewRef = useLatest(getView);\n  const resolveSrcRef = useLatest(resolveSrc);\n  const svgRef = useLatest(svg);\n  const clipboardRef = useLatest(clipboard);\n\n  useDepSource('ingestion', (): IngestionDep => ({\n    viewportWorldRect() {\n      const canvas = canvasRef.current;\n      if (!canvas) return { x: 0, y: 0, width: 0, height: 0 };\n      return viewportWorldRect(getViewRef.current(), canvas.getBoundingClientRect());\n    },\n    get resolveSrc() {\n      return resolveSrcRef.current;\n    },\n    get svg() {\n      return svgRef.current;\n    },\n    get clipboard() {\n      return clipboardRef.current;\n    },\n  }));\n}\n"],"mappings":";;;;;AAaA,SAAgB,sBACd,WACA,SACA,YACA,KACA,WACM;CACN,MAAM,aAAa,UAAU,OAAO;CACpC,MAAM,gBAAgB,UAAU,UAAU;CAC1C,MAAM,SAAS,UAAU,GAAG;CAC5B,MAAM,eAAe,UAAU,SAAS;CAExC,aAAa,oBAAkC;EAC7C,oBAAoB;GAClB,MAAM,SAAS,UAAU;GACzB,IAAI,CAAC,QAAQ,OAAO;IAAE,GAAG;IAAG,GAAG;IAAG,OAAO;IAAG,QAAQ;GAAE;GACtD,OAAO,kBAAkB,WAAW,QAAQ,GAAG,OAAO,sBAAsB,CAAC;EAC/E;EACA,IAAI,aAAa;GACf,OAAO,cAAc;EACvB;EACA,IAAI,MAAM;GACR,OAAO,OAAO;EAChB;EACA,IAAI,YAAY;GACd,OAAO,aAAa;EACtB;CACF,EAAE;AACJ"}
+{"version":3,"file":"ingestion.js","names":[],"sources":["../../../src/canvas/deps/ingestion.ts"],"sourcesContent":["/**\n * `useIngestionDepSource` — wires the `ingestion` dep consumed by\n * `ingestAction`, for the canvas's own view. Computes the visible world rect\n * from the canvas's client rect + current view, and forwards the consumer's\n * optional `resolveSrc`, `svg`, the clipboard seam and the canvas's content handlers. A `<CanvasView>` overlays this dep with its own rect.\n */\nimport type { RefObject } from 'react';\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ClipboardIngestCtx, IngestionDep, SvgIngestOptions } from 'interactions/actions/depSchema';\nimport type { ContentHandlerEntry } from 'domains/ingestion/contentHandlers';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport type { View } from 'core/viewport/view';\n\nexport function useIngestionDepSource(\n  canvasRef: RefObject<HTMLElement | null>,\n  getView: () => View,\n  resolveSrc?: (file: File) => Promise<string>,\n  svg?: SvgIngestOptions,\n  clipboard?: ClipboardIngestCtx,\n  handlers?: readonly ContentHandlerEntry[],\n): void {\n  const getViewRef = useLatest(getView);\n  const resolveSrcRef = useLatest(resolveSrc);\n  const svgRef = useLatest(svg);\n  const clipboardRef = useLatest(clipboard);\n  const handlersRef = useLatest(handlers);\n\n  useDepSource('ingestion', (): IngestionDep => ({\n    viewportWorldRect() {\n      const canvas = canvasRef.current;\n      if (!canvas) return { x: 0, y: 0, width: 0, height: 0 };\n      return viewportWorldRect(getViewRef.current(), canvas.getBoundingClientRect());\n    },\n    get resolveSrc() {\n      return resolveSrcRef.current;\n    },\n    get svg() {\n      return svgRef.current;\n    },\n    get clipboard() {\n      return clipboardRef.current;\n    },\n    get handlers() {\n      return handlersRef.current;\n    },\n  }));\n}\n"],"mappings":";;;;;AAcA,SAAgB,sBACd,WACA,SACA,YACA,KACA,WACA,UACM;CACN,MAAM,aAAa,UAAU,OAAO;CACpC,MAAM,gBAAgB,UAAU,UAAU;CAC1C,MAAM,SAAS,UAAU,GAAG;CAC5B,MAAM,eAAe,UAAU,SAAS;CACxC,MAAM,cAAc,UAAU,QAAQ;CAEtC,aAAa,oBAAkC;EAC7C,oBAAoB;GAClB,MAAM,SAAS,UAAU;GACzB,IAAI,CAAC,QAAQ,OAAO;IAAE,GAAG;IAAG,GAAG;IAAG,OAAO;IAAG,QAAQ;GAAE;GACtD,OAAO,kBAAkB,WAAW,QAAQ,GAAG,OAAO,sBAAsB,CAAC;EAC/E;EACA,IAAI,aAAa;GACf,OAAO,cAAc;EACvB;EACA,IAAI,MAAM;GACR,OAAO,OAAO;EAChB;EACA,IAAI,YAAY;GACd,OAAO,aAAa;EACtB;EACA,IAAI,WAAW;GACb,OAAO,YAAY;EACrB;CACF,EAAE;AACJ"}