@weasel-js/core 1.13.0 → 1.14.1

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":";;;;;;;;;;;;AAkEA,SAAgB,kBAAkB,OAAgC,CAAC,GAAiB;CAClF,MAAM,QAAQ,cAAc,KAAK,WAAW;CAC5C,MAAM,EACJ,kBAAkB,MAAM,QACxB,kBAAkB,MAAM,QACxB,eAAe,MAAM,kBACrB,gBACA,eACA,cAAc,SACZ;CACJ,OAAO;EACL,yBAAyB;GACvB,QAAQ;GACR,OAAO;GACP,GAAI,gBACA,EAAE,QAAQ;IAAE,YAAY,cAAc;IAAY,aAAa,cAAc;GAAO,EAAE,IACtF,CAAC;EACP,CAAC;EACD,6BAA6B;GAAE;GAAiB,OAAO;EAAY,CAAC;EACpE,GAAI,iBACA,4BAA4B,gBAAgB,EAAE,WAAW,gBAAgB,CAAC,IAC1E,CAAC;CACP;AACF;;;;;;AAOA,SAAgB,gBACd,aAIA,UAC0B;CAC1B,aAAa;EACX,MAAM,MAAM,YAAY,CAAC,EAAE,IAAI,aAAa;EAC5C,IAAI,CAAC,KAAK,OAAO;EACjB,OAAO;GACL,WAAW,IAAI,aAAa;GAC5B,MAAM,IAAI,QAAQ;GAIlB,UAAU,OAAQ,WAAW,SAAS,IAAI,IAAI,gBAAgB,EAAE,CAAC,IAAI,IAAI,gBAAgB,EAAE;GAC3F,UAAU,OAAO,IAAI,aAAa,EAAE;GACpC,GAAI,IAAI,aAAa,EAAE,YAAY,IAAI,WAAW,IAAI,CAAC;GACvD,aAAa,OAAO;IAClB,MAAM,OAAO,IAAI,iBAAiB,EAAE,KAAK,IAAI,gBAAgB,EAAE;IAC/D,OAAO,WAAW,SAAS,IAAI,IAAI,IAAI;GACzC;EACF;CACF;AACF;;;;;;AAOA,SAAgB,kBACd,MACgE;CAChE,MAAM,EAAE,gBAAgB,SAAS,iBAAiB;CAClD,MAAM,cAAc,KAAK,eAAe,kBAAkB,IAAI;CAE9D,OAAO,SAAS,aAAa,EAAE,GAAG,IAAI,GAAG,MAAM;EAC7C,MAAM,MAAM,qBACV,aACA,IACA,IACA,eAAe,GACf,QAAQ,GACR,eAAe,CACjB;EACA,OAAO,MAAM,gBAAgB,GAAG,IAAI;CACtC;AACF;;;;;;AAOA,SAAS,gBAAgB,KAAyC;CAChE,MAAM,UAAW,IAAI,QAAQ,kBAAkB,CAAC;CAChD,OAAO;EACL,MAAM,IAAI,OAAO,WAAW,GAAG,IAAI,aAAa,GAAG,IAAI;EACvD,OAAO,IAAI;EACX,UAAU;EACV,GAAI,QAAQ,aAAa,SAAY,EAAE,WAAW,CAAC,QAAQ,QAAQ,EAAE,IAAI,CAAC;EAC1E,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;EACjE,GAAI,QAAQ,eAAe,SAAY,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;EAC7E,GAAI,IAAI,WAAW,SAAY,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;EACzD,GAAI,IAAI,QAAQ,mBAAmB,SAAY,EAAE,SAAS,IAAI,QAAQ,eAAe,IAAI,CAAC;CAC5F;AACF;;;;;;;;;;;;AAaA,SAAgB,oBACd,cACA,UACA,YACA,kBAC8D;CAC9D,OAAO,SAAS,eAAe,EAAE,GAAG,IAAI,GAAG,MAAM;EAC/C,MAAM,QAAQ,SAAS,IAAI,EAAE;EAC7B,IAAI,CAAC,OAAO,OAAO,EAAE,MAAM,QAAQ;EACnC,MAAM,MAAM,aAAa;EACzB,MAAM,YAAY,QAAgB;GAChC,MAAM,IAAI,SAAS,EAAE,IAAI,kBAA2B;GACpD,MAAM,aAAa,EAAE;GACrB;EACF;EACA,MAAM,QAAQ,mBAAmB,KAAK;EACtC,OAAO,UAAU,UAAa,UAAU,QACpC;GAAE,GAAG,SAAS,KAAK;GAAG,aAAa,SAAS,KAAK;EAAE,IACnD,SAAS,KAAK;CACpB;AACF;;;;AAKA,SAAgB,gBAAgB,SAAiB,OAAgC;CAC/E,OAAO;EACL,MAAM,SAAS;EACf,OAAO;EACP,UAAU,MAAM,YAAY;EAC5B,GAAI,MAAM,iBAAiB,SAAY,EAAE,cAAc,MAAM,aAAa,IAAI,CAAC;EAC/E,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;EAC7D,GAAI,MAAM,mBAAmB,SAAY,EAAE,SAAS,MAAM,eAAe,IAAI,CAAC;CAChF;AACF"}
+{"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/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/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"}

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

@@ -1 +1 @@
-{"version":3,"file":"insert.js","names":["e"],"sources":["../../../src/canvas/deps/insert.ts"],"sourcesContent":["/**\n * `useInsertDepSource` — wires the `insert` dep consumed by `insertAction`.\n *\n * `line`, `polygon`, `star`, and `pencil` receive the drag AABB from the insertAction invoker,\n * but `extras` may carry richer geometry (endpoints, center+radius+rotation, point trail).\n * `insertPreviewExtent` resolves the two into the node's real extent — the same resolution the\n * live preview and the reported gesture bounds use.\n */\nimport { useRef } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { InsertDep, InsertExtras, InsertLive } from 'interactions/actions/depSchema';\nimport { insertSite } from './insertSite';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport type { Op } from 'core/ops/types';\nimport { createInsertOp } from 'core/ops/create';\nimport {\n  rectPath,\n  ellipsePath,\n  regularPolygonPath,\n  starPath,\n  linePath,\n  polygonFromPoints,\n  schneiderFit,\n  type PathFillRule,\n  type PolygonPath,\n} from '@weasel-js/geom';\nimport { insertPreviewExtent } from '../insertPreviewExtent';\nimport type { ShapeGenerator } from 'features/paths/shapeGenerator';\nimport type { Stroke, Fill } from '@weasel-js/paint';\nimport { DEFAULT_TEXT_FILL } from '@weasel-js/text';\nimport { cycleFill, solid, strokeOf } from '../../util/paint';\nimport { stickyData, type StickyStyle } from '../../tools/builtin/sticky/stickyNode';\nimport { minSizeOf } from 'core/scene/minSize';\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/**\n * Consumer-supplied node factory for one insert `kind`. Given the drag AABB\n * and the tool's `extras`, returns the node's `data` (in the consumer's own\n * data shape) plus an optional `pose` override — the dep supplies id, layer,\n * and the undoable insert op. Return `null` to reject the insert.\n *\n * A factory registered for a kit kind (`rect`, `line`, …) fully replaces the\n * kit's default `{ path, fill }` factory for that kind; a factory for a novel\n * kind adds support the kit doesn't ship (e.g. `text`). To change only the\n * paint of a kit shape, pass an {@link InsertPaint}. See\n * `SceneCanvas`'s `insertNodeFactories` prop.\n */\nexport type InsertNodeFactory = (\n  bounds: { x: number; y: number; width: number; height: number },\n  extras: InsertExtras,\n) => { data: unknown; pose?: unknown } | null;\n\n/**\n * The paint a kit-built shape is inserted with. `kind` is the shape being\n * built and `seq` counts this canvas's inserts from 1. A key left out stays\n * off the node, which paints none of it, the same as `null`. A pencil\n * trail too short to fit is built as a rect and asks as one. A line and an\n * open pen path are inserted unfilled: a fill given to either is dropped.\n * `fillRule` is the rule a path that carries one is built with, where the\n * kit's own is nonzero; a rect or an ellipse has none to set.\n *\n * It paints only the shapes the kit builds: an `InsertNodeFactory` owns its\n * node's whole `data`. See `SceneCanvas`'s `insertPaint` prop.\n */\nexport type InsertPaint = (kind: string, seq: number) => {\n  fill?: Fill | null;\n  stroke?: Stroke | null;\n  fillRule?: PathFillRule;\n};\n\nfunction paintKeys({ fill, stroke }: ReturnType<InsertPaint>): { fill?: Fill | null; stroke?: Stroke | null } {\n  return { ...(fill !== undefined ? { fill } : {}), ...(stroke !== undefined ? { stroke } : {}) };\n}\n\nfunction withFillRule(data: unknown, rule: PathFillRule | undefined): unknown {\n  const path = (data as { path?: object } | undefined)?.path;\n  if (rule === undefined || path === undefined || !('fillRule' in path)) return data;\n  return { ...(data as object), path: { ...path, fillRule: rule } };\n}\n\n/** The default {@link InsertPaint}: the next color of the kit palette, as a\n *  fill on a closed shape, a fill and a stroke on a pen path, and a stroke\n *  alone on a line or a pencil trail. */\nexport const paletteInsertPaint: InsertPaint = (kind, seq) => {\n  const color = cycleFill(seq);\n  if (kind === 'line' || kind === 'pencil') return { stroke: strokeOf(color, 2) };\n  if (kind === 'path') return { fill: { paint: solid(color) }, stroke: strokeOf(color, 2) };\n  return { fill: { paint: solid(color) } };\n};\n\n/** The kit's default data for a kind drawn as a box, or `null` for a kind it has none for. */\nfunction boxKindData(\n  kind: string,\n  bounds: { x: number; y: number; width: number; height: number },\n  extras: InsertExtras,\n  painted: (as?: string) => ReturnType<typeof paintKeys>,\n): unknown {\n  switch (kind) {\n    case 'rect':\n      // The rect path lives at the origin and the pose carries position:\n      // `pathInPoseFrame` rebases a rect path onto the pose box, so don't\n      // double-count the position.\n      return { path: rectPath(0, 0, bounds.width, bounds.height), ...painted() };\n    case 'ellipse':\n      return { path: ellipsePath(bounds), ...painted() };\n    case 'path': {\n      const e = extras as { path: PolygonPath; closed: boolean; data?: Readonly<Record<string, unknown>> };\n      return { ...e.data, path: e.path, ...painted(), ...(e.closed ? {} : { fill: null }) };\n    }\n    case 'text': {\n      // The built-in text tool drags an empty text box you then type into, so\n      // `extras` carries no content. The kit:text painter matches on\n      // `data.text != null` and applies style defaults at render time.\n      const e = extras as Partial<{ text: string }>;\n      return { text: e.text ?? '', fill: DEFAULT_TEXT_FILL };\n    }\n    case 'sticky':\n      return stickyData(extras as StickyStyle & { text?: string });\n    case 'image': {\n      // The bitmap is loaded + cached by `imageCache` keyed on `src`;\n      // only the (serializable) `src` lives on the node.\n      const e = extras as Partial<{ src: string; opacity: number }>;\n      return { image: { src: e.src ?? '', ...(e.opacity !== undefined ? { opacity: e.opacity } : {}) } };\n    }\n    default:\n      return null;\n  }\n}\n\nexport function useInsertDepSource(\n  scene: Scene<unknown, string, unknown>,\n  adapter: OpsApplier,\n  factories?: Record<string, InsertNodeFactory>,\n  paint: InsertPaint = paletteInsertPaint,\n): void {\n  const sceneRef = useLatest(scene);\n  const adapterRef = useLatest(adapter);\n  const factoriesRef = useLatest(factories);\n  const paintRef = useLatest(paint);\n  const registry = useDepRegistry();\n  const insertSeqRef = useRef(0);\n  const liveRef = useRef<InsertLive>({ gesture: null });\n  useDepSource('insertLive', () => liveRef.current);\n\n  useDepSource('insert', (): InsertDep => {\n    const sc = sceneRef.current;\n    const ad = adapterRef.current;\n\n    const site = () => insertSite(sc, registry.get('insertInto')?.get(), registry.get('canDropInto'));\n    const build: NonNullable<InsertDep['build']> = (bounds, extras) => {\n        const kind = extras.kind;\n        const { parent, layer, local } = site();\n        const seq = ++insertSeqRef.current;\n        const id = sc.mintId();\n        let asked: ReturnType<InsertPaint> | undefined;\n        const painted = (as: string = kind) => paintKeys(asked = paintRef.current(as, seq));\n\n        // The nascent node's extent — drag AABB reconciled with whatever\n        // richer geometry `extras` carries.\n        const extent = insertPreviewExtent({ shape: kind, bounds, extras });\n        const pose: unknown = extent.bounds;\n\n        // Consumer factory wins over the kit default for this kind. It owns the node's\n        // data + optional pose; the dep still supplies id/layer/op.\n        const factory = factoriesRef.current?.[kind];\n        if (factory) {\n          const built = factory(bounds, extras);\n          if (built === null) return null;\n          return {\n            id,\n            ops: [createInsertOp({ node: { id, kind: 'mark', layer, parent, pose: local(built.pose ?? pose), data: built.data } as unknown as { id: string }, label: `Insert ${kind}` })],\n          };\n        }\n\n        const geom = extent.geometry;\n        let data: unknown;\n\n        switch (geom.kind) {\n          case 'line':\n            data = { path: linePath(geom.a, geom.b), ...painted(), fill: null };\n            break;\n          case 'polygon':\n            data = {\n              path: regularPolygonPath(geom.center, geom.radius, geom.sides, geom.rotation),\n              generator: { kind: 'polygon', sides: geom.sides, rotation: geom.rotation } satisfies ShapeGenerator,\n              ...painted(),\n            };\n            break;\n          case 'star':\n            data = {\n              path: starPath(geom.center, geom.outerRadius, geom.points, geom.innerRadius, geom.rotation),\n              generator: {\n                kind: 'star',\n                points: geom.points,\n                innerRadiusRatio: geom.outerRadius === 0 ? 0.5 : geom.innerRadius / geom.outerRadius,\n                rotation: geom.rotation,\n              } satisfies ShapeGenerator,\n              ...painted(),\n            };\n            break;\n          case 'pencil': {\n            const samples = geom.samples as { x: number; y: number }[];\n            if (samples.length >= 4) {\n              data = { path: schneiderFit(samples, 2.0), ...painted() };\n            } else if (samples.length >= 2) {\n              data = { path: polygonFromPoints(samples), ...painted() };\n            } else {\n              data = { path: rectPath(0, 0, extent.bounds.width, extent.bounds.height), ...painted('rect') };\n            }\n            break;\n          }\n          case 'box':\n            data = boxKindData(kind, extent.bounds, extras, painted);\n            if (data === null) {\n              console.warn(`weasel insertDep: no factory for kind=\"${kind}\". Skipping insert.`);\n              return null;\n            }\n            break;\n        }\n\n        data = withFillRule(data, asked?.fillRule);\n        const min = minSizeOf(extras);\n        if (min) data = { ...(data as object), minSize: min };\n        return {\n          id,\n          ops: [createInsertOp({ node: { id, kind: 'mark', layer, parent, pose: local(pose), data } as unknown as { id: string }, label: `Insert ${kind}` })],\n        };\n    };\n    return {\n      layer: () => site().layer,\n      build,\n      commit(bounds, extras, ends): NodeId | null {\n        const built = build(bounds, extras, ends);\n        if (built === null) return null;\n        ad.applyOps(built.ops, `Insert ${extras.kind}`);\n        return built.id;\n      },\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"insert.js","names":["e"],"sources":["../../../src/canvas/deps/insert.ts"],"sourcesContent":["/**\n * `useInsertDepSource` — wires the `insert` dep consumed by `insertAction`.\n *\n * `line`, `polygon`, `star`, and `pencil` receive the drag AABB from the insertAction invoker,\n * but `extras` may carry richer geometry (endpoints, center+radius+rotation, point trail).\n * `insertPreviewExtent` resolves the two into the node's real extent — the same resolution the\n * live preview and the reported gesture bounds use.\n */\nimport { useRef } from 'react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { InsertDep, InsertExtras, InsertLive } from 'interactions/actions/depSchema';\nimport { insertSite } from './insertSite';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport type { Op } from 'core/ops/types';\nimport { createInsertOp } from 'core/ops/create';\nimport {\n  rectPath,\n  ellipsePath,\n  regularPolygonPath,\n  starPath,\n  linePath,\n  polygonFromPoints,\n  schneiderFit,\n  type PathFillRule,\n  type PolygonPath,\n} from '@weasel-js/geom';\nimport { insertPreviewExtent } from '../insertPreviewExtent';\nimport type { ShapeGenerator } from 'domains/paths/shapeGenerator';\nimport type { Stroke, Fill } from '@weasel-js/paint';\nimport { DEFAULT_TEXT_FILL } from '@weasel-js/text';\nimport { cycleFill, solid, strokeOf } from '../../util/paint';\nimport { stickyData, type StickyStyle } from '../../tools/builtin/sticky/stickyNode';\nimport { minSizeOf } from 'core/scene/minSize';\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/**\n * Consumer-supplied node factory for one insert `kind`. Given the drag AABB\n * and the tool's `extras`, returns the node's `data` (in the consumer's own\n * data shape) plus an optional `pose` override — the dep supplies id, layer,\n * and the undoable insert op. Return `null` to reject the insert.\n *\n * A factory registered for a kit kind (`rect`, `line`, …) fully replaces the\n * kit's default `{ path, fill }` factory for that kind; a factory for a novel\n * kind adds support the kit doesn't ship (e.g. `text`). To change only the\n * paint of a kit shape, pass an {@link InsertPaint}. See\n * `SceneCanvas`'s `insertNodeFactories` prop.\n */\nexport type InsertNodeFactory = (\n  bounds: { x: number; y: number; width: number; height: number },\n  extras: InsertExtras,\n) => { data: unknown; pose?: unknown } | null;\n\n/**\n * The paint a kit-built shape is inserted with. `kind` is the shape being\n * built and `seq` counts this canvas's inserts from 1. A key left out stays\n * off the node, which paints none of it, the same as `null`. A pencil\n * trail too short to fit is built as a rect and asks as one. A line and an\n * open pen path are inserted unfilled: a fill given to either is dropped.\n * `fillRule` is the rule a path that carries one is built with, where the\n * kit's own is nonzero; a rect or an ellipse has none to set.\n *\n * It paints only the shapes the kit builds: an `InsertNodeFactory` owns its\n * node's whole `data`. See `SceneCanvas`'s `insertPaint` prop.\n */\nexport type InsertPaint = (kind: string, seq: number) => {\n  fill?: Fill | null;\n  stroke?: Stroke | null;\n  fillRule?: PathFillRule;\n};\n\nfunction paintKeys({ fill, stroke }: ReturnType<InsertPaint>): { fill?: Fill | null; stroke?: Stroke | null } {\n  return { ...(fill !== undefined ? { fill } : {}), ...(stroke !== undefined ? { stroke } : {}) };\n}\n\nfunction withFillRule(data: unknown, rule: PathFillRule | undefined): unknown {\n  const path = (data as { path?: object } | undefined)?.path;\n  if (rule === undefined || path === undefined || !('fillRule' in path)) return data;\n  return { ...(data as object), path: { ...path, fillRule: rule } };\n}\n\n/** The default {@link InsertPaint}: the next color of the kit palette, as a\n *  fill on a closed shape, a fill and a stroke on a pen path, and a stroke\n *  alone on a line or a pencil trail. */\nexport const paletteInsertPaint: InsertPaint = (kind, seq) => {\n  const color = cycleFill(seq);\n  if (kind === 'line' || kind === 'pencil') return { stroke: strokeOf(color, 2) };\n  if (kind === 'path') return { fill: { paint: solid(color) }, stroke: strokeOf(color, 2) };\n  return { fill: { paint: solid(color) } };\n};\n\n/** The kit's default data for a kind drawn as a box, or `null` for a kind it has none for. */\nfunction boxKindData(\n  kind: string,\n  bounds: { x: number; y: number; width: number; height: number },\n  extras: InsertExtras,\n  painted: (as?: string) => ReturnType<typeof paintKeys>,\n): unknown {\n  switch (kind) {\n    case 'rect':\n      // The rect path lives at the origin and the pose carries position:\n      // `pathInPoseFrame` rebases a rect path onto the pose box, so don't\n      // double-count the position.\n      return { path: rectPath(0, 0, bounds.width, bounds.height), ...painted() };\n    case 'ellipse':\n      return { path: ellipsePath(bounds), ...painted() };\n    case 'path': {\n      const e = extras as { path: PolygonPath; closed: boolean; data?: Readonly<Record<string, unknown>> };\n      return { ...e.data, path: e.path, ...painted(), ...(e.closed ? {} : { fill: null }) };\n    }\n    case 'text': {\n      // The built-in text tool drags an empty text box you then type into, so\n      // `extras` carries no content. The kit:text painter matches on\n      // `data.text != null` and applies style defaults at render time.\n      const e = extras as Partial<{ text: string }>;\n      return { text: e.text ?? '', fill: DEFAULT_TEXT_FILL };\n    }\n    case 'sticky':\n      return stickyData(extras as StickyStyle & { text?: string });\n    case 'image': {\n      // The bitmap is loaded + cached by `imageCache` keyed on `src`;\n      // only the (serializable) `src` lives on the node.\n      const e = extras as Partial<{ src: string; opacity: number }>;\n      return { image: { src: e.src ?? '', ...(e.opacity !== undefined ? { opacity: e.opacity } : {}) } };\n    }\n    default:\n      return null;\n  }\n}\n\nexport function useInsertDepSource(\n  scene: Scene<unknown, string, unknown>,\n  adapter: OpsApplier,\n  factories?: Record<string, InsertNodeFactory>,\n  paint: InsertPaint = paletteInsertPaint,\n): void {\n  const sceneRef = useLatest(scene);\n  const adapterRef = useLatest(adapter);\n  const factoriesRef = useLatest(factories);\n  const paintRef = useLatest(paint);\n  const registry = useDepRegistry();\n  const insertSeqRef = useRef(0);\n  const liveRef = useRef<InsertLive>({ gesture: null });\n  useDepSource('insertLive', () => liveRef.current);\n\n  useDepSource('insert', (): InsertDep => {\n    const sc = sceneRef.current;\n    const ad = adapterRef.current;\n\n    const site = () => insertSite(sc, registry.get('insertInto')?.get(), registry.get('canDropInto'));\n    const build: NonNullable<InsertDep['build']> = (bounds, extras) => {\n        const kind = extras.kind;\n        const { parent, layer, local } = site();\n        const seq = ++insertSeqRef.current;\n        const id = sc.mintId();\n        let asked: ReturnType<InsertPaint> | undefined;\n        const painted = (as: string = kind) => paintKeys(asked = paintRef.current(as, seq));\n\n        // The nascent node's extent — drag AABB reconciled with whatever\n        // richer geometry `extras` carries.\n        const extent = insertPreviewExtent({ shape: kind, bounds, extras });\n        const pose: unknown = extent.bounds;\n\n        // Consumer factory wins over the kit default for this kind. It owns the node's\n        // data + optional pose; the dep still supplies id/layer/op.\n        const factory = factoriesRef.current?.[kind];\n        if (factory) {\n          const built = factory(bounds, extras);\n          if (built === null) return null;\n          return {\n            id,\n            ops: [createInsertOp({ node: { id, kind: 'mark', layer, parent, pose: local(built.pose ?? pose), data: built.data } as unknown as { id: string }, label: `Insert ${kind}` })],\n          };\n        }\n\n        const geom = extent.geometry;\n        let data: unknown;\n\n        switch (geom.kind) {\n          case 'line':\n            data = { path: linePath(geom.a, geom.b), ...painted(), fill: null };\n            break;\n          case 'polygon':\n            data = {\n              path: regularPolygonPath(geom.center, geom.radius, geom.sides, geom.rotation),\n              generator: { kind: 'polygon', sides: geom.sides, rotation: geom.rotation } satisfies ShapeGenerator,\n              ...painted(),\n            };\n            break;\n          case 'star':\n            data = {\n              path: starPath(geom.center, geom.outerRadius, geom.points, geom.innerRadius, geom.rotation),\n              generator: {\n                kind: 'star',\n                points: geom.points,\n                innerRadiusRatio: geom.outerRadius === 0 ? 0.5 : geom.innerRadius / geom.outerRadius,\n                rotation: geom.rotation,\n              } satisfies ShapeGenerator,\n              ...painted(),\n            };\n            break;\n          case 'pencil': {\n            const samples = geom.samples as { x: number; y: number }[];\n            if (samples.length >= 4) {\n              data = { path: schneiderFit(samples, 2.0), ...painted() };\n            } else if (samples.length >= 2) {\n              data = { path: polygonFromPoints(samples), ...painted() };\n            } else {\n              data = { path: rectPath(0, 0, extent.bounds.width, extent.bounds.height), ...painted('rect') };\n            }\n            break;\n          }\n          case 'box':\n            data = boxKindData(kind, extent.bounds, extras, painted);\n            if (data === null) {\n              console.warn(`weasel insertDep: no factory for kind=\"${kind}\". Skipping insert.`);\n              return null;\n            }\n            break;\n        }\n\n        data = withFillRule(data, asked?.fillRule);\n        const min = minSizeOf(extras);\n        if (min) data = { ...(data as object), minSize: min };\n        return {\n          id,\n          ops: [createInsertOp({ node: { id, kind: 'mark', layer, parent, pose: local(pose), data } as unknown as { id: string }, label: `Insert ${kind}` })],\n        };\n    };\n    return {\n      layer: () => site().layer,\n      build,\n      commit(bounds, extras, ends): NodeId | null {\n        const built = build(bounds, extras, ends);\n        if (built === null) return null;\n        ad.applyOps(built.ops, `Insert ${extras.kind}`);\n        return built.id;\n      },\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/canvas/deps/insertSite.js

@@ -1,11 +1,13 @@
-import { composeWorldPose, composesFrames } from "../../core/scene/composeFrame.js";
+import { composeChildFrame, composesFrames } from "../../core/scene/composeFrame.js";
 import { definesFrame } from "../../core/scene/effectivePose.js";
+import { viewPoseAdapter } from "../../core/scene/scrollOffsets.js";
 import { insertParent } from "../../interactions/actions/insert/parent.js";
 
 //#region src/canvas/deps/insertSite.ts
 /**
 * Where an insert lands: the container the `insertInto` dep names, on that container's
 * layer, with the pose made local to it when the scene composes frames —
+* through its scroll offset, since the world pose is where the view shows it —
 * or the top of the tree, on the first layer, when it names no container.
 */
 function insertSite(sc, into, canDropInto) {
@@ -22,11 +24,11 @@ function insertSite(sc, into, canDropInto) {
 		layer: parent.layer,
 		local: (p) => p
 	};
-	const frame = composeWorldPose({
+	const frame = composeChildFrame(viewPoseAdapter(sc, {
 		getPose: (id) => sc.get(id).pose,
 		getParent: (id) => sc.get(id)?.parent ?? null,
 		definesFrame: (id) => definesFrame(sc.get(id) ?? {})
-	}, parent.id, composition.compose);
+	}), parent.id, composition.compose);
 	return {
 		parent: parent.id,
 		layer: parent.layer,

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

@@ -1 +1 @@
-{"version":3,"file":"insertSite.js","names":[],"sources":["../../../src/canvas/deps/insertSite.ts"],"sourcesContent":["import type { Scene, NodeId } from 'core/scene/types';\nimport type { CanDropIntoDep } from 'interactions/actions/layoutDeps';\nimport { insertParent } from 'interactions/actions/insert/parent';\nimport { composesFrames, composeWorldPose } from 'core/scene/composeFrame';\nimport { definesFrame } from 'core/scene/effectivePose';\n\n/** Where a new node lands: its parent, its layer, and how a world pose becomes its stored one. */\nexport interface InsertSite {\n  parent: NodeId | null;\n  layer: string;\n  local: (world: unknown) => unknown;\n}\n\n/**\n * Where an insert lands: the container the `insertInto` dep names, on that container's\n * layer, with the pose made local to it when the scene composes frames —\n * or the top of the tree, on the first layer, when it names no container.\n */\nexport function insertSite(\n  sc: Pick<Scene<unknown, string, unknown>, 'get' | 'layers' | 'composition'>,\n  into: string | null | undefined,\n  canDropInto?: CanDropIntoDep,\n): InsertSite {\n  const parentId = insertParent(sc, into, canDropInto);\n  if (parentId === null) {\n    return { parent: null, layer: (sc.layers[0]?.id ?? 'default') as string, local: (p) => p };\n  }\n  const parent = sc.get(parentId)!;\n  const composition = sc.composition;\n  if (composition === undefined || !composesFrames(composition)) {\n    return { parent: parent.id, layer: parent.layer, local: (p) => p };\n  }\n  const frame = composeWorldPose({\n    getPose: (id) => sc.get(id as NodeId)!.pose,\n    getParent: (id) => sc.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => definesFrame(sc.get(id as NodeId) ?? {}),\n  }, parent.id, composition.compose);\n  return { parent: parent.id, layer: parent.layer, local: (p) => composition.decompose(frame, p) };\n}\n"],"mappings":";;;;;;;;;;AAkBA,SAAgB,WACd,IACA,MACA,aACY;CACZ,MAAM,WAAW,aAAa,IAAI,MAAM,WAAW;CACnD,IAAI,aAAa,MACf,OAAO;EAAE,QAAQ;EAAM,OAAQ,GAAG,OAAO,EAAE,EAAE,MAAM;EAAsB,QAAQ,MAAM;CAAE;CAE3F,MAAM,SAAS,GAAG,IAAI,QAAQ;CAC9B,MAAM,cAAc,GAAG;CACvB,IAAI,gBAAgB,UAAa,CAAC,eAAe,WAAW,GAC1D,OAAO;EAAE,QAAQ,OAAO;EAAI,OAAO,OAAO;EAAO,QAAQ,MAAM;CAAE;CAEnE,MAAM,QAAQ,iBAAiB;EAC7B,UAAU,OAAO,GAAG,IAAI,EAAY,CAAC,CAAE;EACvC,YAAY,OAAO,GAAG,IAAI,EAAY,CAAC,EAAE,UAAU;EACnD,eAAe,OAAO,aAAa,GAAG,IAAI,EAAY,KAAK,CAAC,CAAC;CAC/D,GAAG,OAAO,IAAI,YAAY,OAAO;CACjC,OAAO;EAAE,QAAQ,OAAO;EAAI,OAAO,OAAO;EAAO,QAAQ,MAAM,YAAY,UAAU,OAAO,CAAC;CAAE;AACjG"}
+{"version":3,"file":"insertSite.js","names":[],"sources":["../../../src/canvas/deps/insertSite.ts"],"sourcesContent":["import type { Scene, NodeId } from 'core/scene/types';\nimport type { CanDropIntoDep } from 'interactions/actions/layoutDeps';\nimport { insertParent } from 'interactions/actions/insert/parent';\nimport { composeChildFrame, composesFrames, type PoseAdapter } from 'core/scene/composeFrame';\nimport { viewPoseAdapter } from 'core/scene/scrollOffsets';\nimport { definesFrame } from 'core/scene/effectivePose';\n\n/** Where a new node lands: its parent, its layer, and how a world pose becomes its stored one. */\nexport interface InsertSite {\n  parent: NodeId | null;\n  layer: string;\n  local: (world: unknown) => unknown;\n}\n\n/**\n * Where an insert lands: the container the `insertInto` dep names, on that container's\n * layer, with the pose made local to it when the scene composes frames —\n * through its scroll offset, since the world pose is where the view shows it —\n * or the top of the tree, on the first layer, when it names no container.\n */\nexport function insertSite(\n  sc: Pick<Scene<unknown, string, unknown>, 'get' | 'layers' | 'composition'> & Partial<Pick<Scene<unknown, string, unknown>, 'scroll'>>,\n  into: string | null | undefined,\n  canDropInto?: CanDropIntoDep,\n): InsertSite {\n  const parentId = insertParent(sc, into, canDropInto);\n  if (parentId === null) {\n    return { parent: null, layer: (sc.layers[0]?.id ?? 'default') as string, local: (p) => p };\n  }\n  const parent = sc.get(parentId)!;\n  const composition = sc.composition;\n  if (composition === undefined || !composesFrames(composition)) {\n    return { parent: parent.id, layer: parent.layer, local: (p) => p };\n  }\n  const frame = composeChildFrame(viewPoseAdapter(sc, {\n    getPose: (id) => sc.get(id as NodeId)!.pose,\n    getParent: (id) => sc.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => definesFrame(sc.get(id as NodeId) ?? {}),\n  } as PoseAdapter<unknown>), parent.id, composition.compose);\n  return { parent: parent.id, layer: parent.layer, local: (p) => composition.decompose(frame, p) };\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,WACd,IACA,MACA,aACY;CACZ,MAAM,WAAW,aAAa,IAAI,MAAM,WAAW;CACnD,IAAI,aAAa,MACf,OAAO;EAAE,QAAQ;EAAM,OAAQ,GAAG,OAAO,EAAE,EAAE,MAAM;EAAsB,QAAQ,MAAM;CAAE;CAE3F,MAAM,SAAS,GAAG,IAAI,QAAQ;CAC9B,MAAM,cAAc,GAAG;CACvB,IAAI,gBAAgB,UAAa,CAAC,eAAe,WAAW,GAC1D,OAAO;EAAE,QAAQ,OAAO;EAAI,OAAO,OAAO;EAAO,QAAQ,MAAM;CAAE;CAEnE,MAAM,QAAQ,kBAAkB,gBAAgB,IAAI;EAClD,UAAU,OAAO,GAAG,IAAI,EAAY,CAAC,CAAE;EACvC,YAAY,OAAO,GAAG,IAAI,EAAY,CAAC,EAAE,UAAU;EACnD,eAAe,OAAO,aAAa,GAAG,IAAI,EAAY,KAAK,CAAC,CAAC;CAC/D,CAAyB,GAAG,OAAO,IAAI,YAAY,OAAO;CAC1D,OAAO;EAAE,QAAQ,OAAO;EAAI,OAAO,OAAO;EAAO,QAAQ,MAAM,YAAY,UAAU,OAAO,CAAC;CAAE;AACjG"}

package/dist/canvas/deps/nodeAtPoint.js

@@ -3,22 +3,11 @@ import { useLatest } from "@weasel-js/react";
 import { useDepSource } from "@weasel-js/routing/react";
 
 //#region src/canvas/deps/nodeAtPoint.ts
-/**
-* `useNodeAtPointDepSource` — wires the `nodeAtPoint` dep consumed by
-* `moveAction` (reparent-on-drop) and any other action needing a
-* single-best pick. Delegates to `<SceneCanvas>`'s `pickEvery` (the
-* back-to-front pose-walking picker) so consumer-supplied geometry
-* overrides are honored automatically.
-*
-* The exclude set is consulted front-to-back: the dep returns the
-* topmost id that isn't in `exclude`, which lets callers ignore the
-* node(s) they're currently manipulating without separate plumbing.
-*/
 function useNodeAtPointDepSource(pickEvery) {
 	const pickRef = useLatest(pickEvery);
 	useDepSource("nodeAtPoint", () => {
 		return (point, exclude) => {
-			const ids = pickRef.current(point.x, point.y);
+			const ids = pickRef.current(point);
 			if (ids.length === 0) return null;
 			if (!exclude) return asNodeId(ids[ids.length - 1]);
 			const ex = exclude instanceof Set ? exclude : new Set(exclude);

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

@@ -1 +1 @@
-{"version":3,"file":"nodeAtPoint.js","names":[],"sources":["../../../src/canvas/deps/nodeAtPoint.ts"],"sourcesContent":["/**\n * `useNodeAtPointDepSource` — wires the `nodeAtPoint` dep consumed by\n * `moveAction` (reparent-on-drop) and any other action needing a\n * single-best pick. Delegates to `<SceneCanvas>`'s `pickEvery` (the\n * back-to-front pose-walking picker) so consumer-supplied geometry\n * overrides are honored automatically.\n *\n * The exclude set is consulted front-to-back: the dep returns the\n * topmost id that isn't in `exclude`, which lets callers ignore the\n * node(s) they're currently manipulating without separate plumbing.\n */\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeAtPointDep } from 'interactions/actions/depSchema';\nimport { asNodeId } from 'core/scene/types';\n\nexport function useNodeAtPointDepSource(\n  pickEvery: (worldX: number, worldY: number) => string[],\n): void {\n  const pickRef = useLatest(pickEvery);\n\n  useDepSource('nodeAtPoint', (): NodeAtPointDep => {\n    return (point, exclude) => {\n      const ids = pickRef.current(point.x, point.y);\n      if (ids.length === 0) return null;\n      if (!exclude) {\n        // `pickEvery` returns back-to-front; topmost is the last entry.\n        return asNodeId(ids[ids.length - 1]);\n      }\n      const ex = exclude instanceof Set ? exclude : new Set(exclude);\n      for (let i = ids.length - 1; i >= 0; i--) {\n        if (!ex.has(asNodeId(ids[i]))) return asNodeId(ids[i]);\n      }\n      return null;\n    };\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,wBACd,WACM;CACN,MAAM,UAAU,UAAU,SAAS;CAEnC,aAAa,qBAAqC;EAChD,QAAQ,OAAO,YAAY;GACzB,MAAM,MAAM,QAAQ,QAAQ,MAAM,GAAG,MAAM,CAAC;GAC5C,IAAI,IAAI,WAAW,GAAG,OAAO;GAC7B,IAAI,CAAC,SAEH,OAAO,SAAS,IAAI,IAAI,SAAS,EAAE;GAErC,MAAM,KAAK,mBAAmB,MAAM,UAAU,IAAI,IAAI,OAAO;GAC7D,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KACnC,IAAI,CAAC,GAAG,IAAI,SAAS,IAAI,EAAE,CAAC,GAAG,OAAO,SAAS,IAAI,EAAE;GAEvD,OAAO;EACT;CACF,CAAC;AACH"}
+{"version":3,"file":"nodeAtPoint.js","names":[],"sources":["../../../src/canvas/deps/nodeAtPoint.ts"],"sourcesContent":["/**\n * `useNodeAtPointDepSource` — wires the `nodeAtPoint` dep consumed by\n * `moveAction` (reparent-on-drop) and any other action needing a\n * single-best pick. Delegates to `<SceneCanvas>`'s `pickEvery` (the\n * back-to-front pose-walking picker) so consumer-supplied geometry\n * overrides are honored automatically.\n *\n * The exclude set is consulted front-to-back: the dep returns the\n * topmost id that isn't in `exclude`, which lets callers ignore the\n * node(s) they're currently manipulating without separate plumbing.\n */\nimport type { WorldPoint } from '@weasel-js/routing';\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { NodeAtPointDep } from 'interactions/actions/depSchema';\nimport { asNodeId } from 'core/scene/types';\n\nexport function useNodeAtPointDepSource(\n  pickEvery: (world: WorldPoint) => string[],\n): void {\n  const pickRef = useLatest(pickEvery);\n\n  useDepSource('nodeAtPoint', (): NodeAtPointDep => {\n    return (point, exclude) => {\n      const ids = pickRef.current(point);\n      if (ids.length === 0) return null;\n      if (!exclude) {\n        // `pickEvery` returns back-to-front; topmost is the last entry.\n        return asNodeId(ids[ids.length - 1]);\n      }\n      const ex = exclude instanceof Set ? exclude : new Set(exclude);\n      for (let i = ids.length - 1; i >= 0; i--) {\n        if (!ex.has(asNodeId(ids[i]))) return asNodeId(ids[i]);\n      }\n      return null;\n    };\n  });\n}\n"],"mappings":";;;;;AAiBA,SAAgB,wBACd,WACM;CACN,MAAM,UAAU,UAAU,SAAS;CAEnC,aAAa,qBAAqC;EAChD,QAAQ,OAAO,YAAY;GACzB,MAAM,MAAM,QAAQ,QAAQ,KAAK;GACjC,IAAI,IAAI,WAAW,GAAG,OAAO;GAC7B,IAAI,CAAC,SAEH,OAAO,SAAS,IAAI,IAAI,SAAS,EAAE;GAErC,MAAM,KAAK,mBAAmB,MAAM,UAAU,IAAI,IAAI,OAAO;GAC7D,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KACnC,IAAI,CAAC,GAAG,IAAI,SAAS,IAAI,EAAE,CAAC,GAAG,OAAO,SAAS,IAAI,EAAE;GAEvD,OAAO;EACT;CACF,CAAC;AACH"}

package/dist/canvas/deps/pathEditCommits.js

@@ -2,9 +2,9 @@ import { sceneDependentsOf } from "../../core/scene/dependents.js";
 import { createTransformOp } from "../../core/ops/transform.js";
 import { createSetDataOp } from "../../core/ops/setData.js";
 import { createDeleteOp } from "../../core/ops/delete.js";
-import { pathEditPathOf, storeEditablePath } from "../../features/paths/editablePath.js";
-import { withoutShapeGenerator } from "../../features/paths/shapeGenerator.js";
-import { withoutGeometryBoundData } from "../../features/paths/pathEditExtension.js";
+import { pathEditPathOf, storeEditablePath } from "../../domains/paths/editablePath.js";
+import { withoutShapeGenerator } from "../../domains/paths/shapeGenerator.js";
+import { withoutGeometryBoundData } from "../../domains/paths/pathEditExtension.js";
 import { writtenBy } from "../../core/ops/writtenBy.js";
 
 //#region src/canvas/deps/pathEditCommits.ts

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

@@ -1 +1 @@
-{"version":3,"file":"pathEditCommits.js","names":[],"sources":["../../../src/canvas/deps/pathEditCommits.ts"],"sourcesContent":["/**\n * What the `editAnchors` dep commits: an edit finished by every path-edit\n * extension, the other nodes the extensions change with it, and the same for\n * a whole-node transform's batch.\n */\nimport type { PointOrigin, PolygonPath } from '@weasel-js/geom';\nimport type { Op } from 'core/ops/types';\nimport { createTransformOp } from 'core/ops/transform';\nimport { createSetDataOp } from 'core/ops/setData';\nimport { createDeleteOp } from 'core/ops/delete';\nimport { writtenBy } from 'core/ops/writtenBy';\nimport type { TransformFollower, TransformPreviewNode } from 'interactions/actions/transformFinish';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { sceneDependentsOf } from 'core/scene/dependents';\nimport { pathEditPathOf, storeEditablePath } from 'features/paths/editablePath';\nimport { withoutShapeGenerator } from 'features/paths/shapeGenerator';\nimport {\n  withoutGeometryBoundData, type PathEditExtension, type PathEditFinishCtx, type PathEditOther, type PathTransformFinishCtx,\n} from 'features/paths/pathEditExtension';\n\ntype AnyScene = Scene<unknown, string, unknown>;\nexport type EditableNode = { pose: unknown; data: unknown };\n\n/** What {@link finishEdit} answers: the edited path, the data set beside it, and the other nodes it changes, by id. */\nexport interface Finished {\n  path: PolygonPath;\n  data: Record<string, unknown> | null;\n  others: Map<string, PathEditOther>;\n}\n\n/** The scene as an extension's `finishEdit` reads it. */\nexport function finishCtx(sc: AnyScene, id: string, extensions: readonly PathEditExtension[]): PathEditFinishCtx {\n  return {\n    id,\n    node(nid) {\n      const node = sc.get(nid as NodeId);\n      return node ? { pose: node.pose, data: node.data, dependsOn: node.dependsOn } : null;\n    },\n    path: (nid) => pathEditPathOf(sc.get(nid as NodeId) as EditableNode | undefined, extensions),\n    dependents: (nid) => sceneDependentsOf(sc, nid as NodeId),\n  };\n}\n\n/** `o` laid over what `others` already holds for its node. */\nfunction addOther(others: Map<string, PathEditOther>, o: PathEditOther): void {\n  const had = others.get(o.id);\n  others.set(o.id, {\n    id: o.id,\n    path: o.path ?? had?.path,\n    data: o.data || had?.data ? { ...had?.data, ...o.data } : undefined,\n    remove: o.remove || had?.remove,\n  });\n}\n\n/** `worldPath` finished by each of `extensions` in turn, the data they set\n *  beside it, and the other nodes they change; null when one cannot finish it. */\nexport function finishEdit(\n  extensions: readonly PathEditExtension[],\n  node: EditableNode,\n  worldPath: PolygonPath,\n  origins: readonly (PointOrigin | null)[] | undefined,\n  ctx: PathEditFinishCtx,\n): Finished | null {\n  let path = worldPath;\n  let data: Record<string, unknown> | null = null;\n  const others = new Map<string, PathEditOther>();\n  for (const ext of extensions) {\n    if (!ext.finishEdit) continue;\n    const done = ext.finishEdit(node, path, origins, ctx);\n    if (!done) return null;\n    path = done.path;\n    if (done.data) data = { ...(data ?? {}), ...done.data };\n    for (const o of done.others ?? []) addOther(others, o);\n  }\n  return { path, data, others };\n}\n\n/** The ops that commit `others`, each from its node as committed. */\nexport function otherOps(\n  sc: AnyScene,\n  others: ReadonlyMap<string, PathEditOther>,\n  label: string,\n  extensions: readonly PathEditExtension[],\n): Op[] {\n  return [...others.values()].flatMap((o) => {\n    const node = sc.get(o.id as NodeId) as EditableNode | undefined;\n    if (!node) return [];\n    if (o.remove) return [createDeleteOp({ node: sc.get(o.id as NodeId)!, label })];\n    if (o.path) return reshapeOps(o.id, node, o.path, label, o.data ?? null, extensions);\n    return o.data ? [createSetDataOp({ id: o.id, from: node.data, to: { ...(node.data as object), ...o.data }, label })] : [];\n  });\n}\n\n/** The ops that store `worldPath` where `node` keeps its polygon, with `patch` laid over its data. */\nexport function reshapeOps(\n  id: string,\n  node: EditableNode,\n  worldPath: PolygonPath,\n  label: string,\n  patch: Record<string, unknown> | null,\n  extensions: readonly PathEditExtension[],\n): Op[] {\n  const next = storeEditablePath(node, worldPath, extensions);\n  if (!next) return [];\n  const reshape = createTransformOp({ id, from: node.pose, to: next.pose, label });\n  // A path edited by hand is no longer what its generator or warp makes: it becomes plain geometry.\n  // Its skin and constraints stay, renumbered by the caller's patch where it has one, and the\n  // form it was drawn from as storing it left it.\n  const data = withoutGeometryBoundData(\n    next.data === node.data ? node.data : withoutShapeGenerator(next.data), ['skin', 'constraints', 'representation'],\n  );\n  if (data === node.data && !patch) return [reshape];\n  return [reshape, createSetDataOp({ id, from: node.data, to: { ...(data as object), ...patch }, label })];\n}\n\n/** The other nodes `extensions` change along with a transform that leaves the nodes in `after` as given; null when one refuses it. */\nfunction transformOthers(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  after: ReadonlyMap<string, EditableNode>,\n): Map<string, PathEditOther> | null {\n  const others = new Map<string, PathEditOther>();\n  const finishing = extensions.filter((e) => e.finishTransform);\n  if (finishing.length === 0 || after.size === 0) return others;\n  const nodeAfter = (id: string) => {\n    const node = sc.get(id as NodeId);\n    if (!node) return null;\n    const written = after.get(id);\n    return { pose: written?.pose ?? node.pose, data: written?.data ?? node.data, dependsOn: node.dependsOn };\n  };\n  const ctx: PathTransformFinishCtx = {\n    ids: [...after.keys()],\n    node: nodeAfter,\n    path: (id) => pathEditPathOf(nodeAfter(id) ?? undefined, extensions),\n    before: (id) => pathEditPathOf(sc.get(id as NodeId) as EditableNode | undefined, extensions),\n    dependents: (id) => sceneDependentsOf(sc, id as NodeId),\n  };\n  for (const ext of finishing) {\n    const done = ext.finishTransform!(ctx);\n    if (!done) return null;\n    for (const o of done) if (!after.has(o.id)) addOther(others, o);\n  }\n  return others;\n}\n\n/** `ops`, a whole-node transform's batch, with the ops `extensions` add for the other nodes it changes; null when one refuses it. */\nexport function transformOps(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  ops: readonly Op[],\n  label: string,\n): Op[] | null {\n  const after = extensions.some((e) => e.finishTransform) ? writtenBy(sc, ops) : null;\n  if (!after || after.size === 0) return [...ops];\n  const others = transformOthers(sc, extensions, after);\n  return others && [...ops, ...otherOps(sc, others, label, extensions)];\n}\n\n/**\n * The other nodes `extensions` change along with a transform frame that\n * poses the nodes in `poses` as given, each as it would be stored — what\n * {@link transformOps} would commit for that frame, read the same way. Empty\n * when nothing changes with it, or an extension refuses it.\n */\nexport function transformPreview(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  poses: ReadonlyMap<string, unknown>,\n): TransformPreviewNode[] {\n  if (poses.size === 0 || !extensions.some((e) => e.finishTransform)) return [];\n  const after = new Map<string, EditableNode>();\n  for (const [id, pose] of poses) {\n    const node = sc.get(id as NodeId);\n    if (node) after.set(id, { pose, data: node.data });\n  }\n  const others = transformOthers(sc, extensions, after);\n  return [...(others?.values() ?? [])].flatMap((o) => {\n    const node = sc.get(o.id as NodeId) as EditableNode | undefined;\n    const stored = node && o.path && !o.remove ? storeEditablePath(node, o.path, extensions) : null;\n    if (!node || !stored) return [];\n    return [stored.data === node.data ? { id: o.id, pose: stored.pose } : { id: o.id, pose: stored.pose, data: stored.data }];\n  });\n}\n\n/** The transform follower `extensions` make: each one's `finishTransform`, as\n *  {@link transformOps} and {@link transformPreview} read it. Null when none\n *  has one, so a transform runs no follower for them. */\nexport function pathEditFollower(sc: AnyScene, extensions: readonly PathEditExtension[]): TransformFollower | null {\n  if (!extensions.some((e) => e.finishTransform)) return null;\n  return {\n    finish: (ops, label) => transformOps(sc, extensions, ops, label),\n    preview: (poses) => transformPreview(sc, extensions, poses),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"pathEditCommits.js","names":[],"sources":["../../../src/canvas/deps/pathEditCommits.ts"],"sourcesContent":["/**\n * What the `editAnchors` dep commits: an edit finished by every path-edit\n * extension, the other nodes the extensions change with it, and the same for\n * a whole-node transform's batch.\n */\nimport type { PointOrigin, PolygonPath } from '@weasel-js/geom';\nimport type { Op } from 'core/ops/types';\nimport { createTransformOp } from 'core/ops/transform';\nimport { createSetDataOp } from 'core/ops/setData';\nimport { createDeleteOp } from 'core/ops/delete';\nimport { writtenBy } from 'core/ops/writtenBy';\nimport type { TransformFollower, TransformPreviewNode } from 'interactions/actions/transformFinish';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { sceneDependentsOf } from 'core/scene/dependents';\nimport { pathEditPathOf, storeEditablePath } from 'domains/paths/editablePath';\nimport { withoutShapeGenerator } from 'domains/paths/shapeGenerator';\nimport {\n  withoutGeometryBoundData, type PathEditExtension, type PathEditFinishCtx, type PathEditOther, type PathTransformFinishCtx,\n} from 'domains/paths/pathEditExtension';\n\ntype AnyScene = Scene<unknown, string, unknown>;\nexport type EditableNode = { pose: unknown; data: unknown };\n\n/** What {@link finishEdit} answers: the edited path, the data set beside it, and the other nodes it changes, by id. */\nexport interface Finished {\n  path: PolygonPath;\n  data: Record<string, unknown> | null;\n  others: Map<string, PathEditOther>;\n}\n\n/** The scene as an extension's `finishEdit` reads it. */\nexport function finishCtx(sc: AnyScene, id: string, extensions: readonly PathEditExtension[]): PathEditFinishCtx {\n  return {\n    id,\n    node(nid) {\n      const node = sc.get(nid as NodeId);\n      return node ? { pose: node.pose, data: node.data, dependsOn: node.dependsOn } : null;\n    },\n    path: (nid) => pathEditPathOf(sc.get(nid as NodeId) as EditableNode | undefined, extensions),\n    dependents: (nid) => sceneDependentsOf(sc, nid as NodeId),\n  };\n}\n\n/** `o` laid over what `others` already holds for its node. */\nfunction addOther(others: Map<string, PathEditOther>, o: PathEditOther): void {\n  const had = others.get(o.id);\n  others.set(o.id, {\n    id: o.id,\n    path: o.path ?? had?.path,\n    data: o.data || had?.data ? { ...had?.data, ...o.data } : undefined,\n    remove: o.remove || had?.remove,\n  });\n}\n\n/** `worldPath` finished by each of `extensions` in turn, the data they set\n *  beside it, and the other nodes they change; null when one cannot finish it. */\nexport function finishEdit(\n  extensions: readonly PathEditExtension[],\n  node: EditableNode,\n  worldPath: PolygonPath,\n  origins: readonly (PointOrigin | null)[] | undefined,\n  ctx: PathEditFinishCtx,\n): Finished | null {\n  let path = worldPath;\n  let data: Record<string, unknown> | null = null;\n  const others = new Map<string, PathEditOther>();\n  for (const ext of extensions) {\n    if (!ext.finishEdit) continue;\n    const done = ext.finishEdit(node, path, origins, ctx);\n    if (!done) return null;\n    path = done.path;\n    if (done.data) data = { ...(data ?? {}), ...done.data };\n    for (const o of done.others ?? []) addOther(others, o);\n  }\n  return { path, data, others };\n}\n\n/** The ops that commit `others`, each from its node as committed. */\nexport function otherOps(\n  sc: AnyScene,\n  others: ReadonlyMap<string, PathEditOther>,\n  label: string,\n  extensions: readonly PathEditExtension[],\n): Op[] {\n  return [...others.values()].flatMap((o) => {\n    const node = sc.get(o.id as NodeId) as EditableNode | undefined;\n    if (!node) return [];\n    if (o.remove) return [createDeleteOp({ node: sc.get(o.id as NodeId)!, label })];\n    if (o.path) return reshapeOps(o.id, node, o.path, label, o.data ?? null, extensions);\n    return o.data ? [createSetDataOp({ id: o.id, from: node.data, to: { ...(node.data as object), ...o.data }, label })] : [];\n  });\n}\n\n/** The ops that store `worldPath` where `node` keeps its polygon, with `patch` laid over its data. */\nexport function reshapeOps(\n  id: string,\n  node: EditableNode,\n  worldPath: PolygonPath,\n  label: string,\n  patch: Record<string, unknown> | null,\n  extensions: readonly PathEditExtension[],\n): Op[] {\n  const next = storeEditablePath(node, worldPath, extensions);\n  if (!next) return [];\n  const reshape = createTransformOp({ id, from: node.pose, to: next.pose, label });\n  // A path edited by hand is no longer what its generator or warp makes: it becomes plain geometry.\n  // Its skin and constraints stay, renumbered by the caller's patch where it has one, and the\n  // form it was drawn from as storing it left it.\n  const data = withoutGeometryBoundData(\n    next.data === node.data ? node.data : withoutShapeGenerator(next.data), ['skin', 'constraints', 'representation'],\n  );\n  if (data === node.data && !patch) return [reshape];\n  return [reshape, createSetDataOp({ id, from: node.data, to: { ...(data as object), ...patch }, label })];\n}\n\n/** The other nodes `extensions` change along with a transform that leaves the nodes in `after` as given; null when one refuses it. */\nfunction transformOthers(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  after: ReadonlyMap<string, EditableNode>,\n): Map<string, PathEditOther> | null {\n  const others = new Map<string, PathEditOther>();\n  const finishing = extensions.filter((e) => e.finishTransform);\n  if (finishing.length === 0 || after.size === 0) return others;\n  const nodeAfter = (id: string) => {\n    const node = sc.get(id as NodeId);\n    if (!node) return null;\n    const written = after.get(id);\n    return { pose: written?.pose ?? node.pose, data: written?.data ?? node.data, dependsOn: node.dependsOn };\n  };\n  const ctx: PathTransformFinishCtx = {\n    ids: [...after.keys()],\n    node: nodeAfter,\n    path: (id) => pathEditPathOf(nodeAfter(id) ?? undefined, extensions),\n    before: (id) => pathEditPathOf(sc.get(id as NodeId) as EditableNode | undefined, extensions),\n    dependents: (id) => sceneDependentsOf(sc, id as NodeId),\n  };\n  for (const ext of finishing) {\n    const done = ext.finishTransform!(ctx);\n    if (!done) return null;\n    for (const o of done) if (!after.has(o.id)) addOther(others, o);\n  }\n  return others;\n}\n\n/** `ops`, a whole-node transform's batch, with the ops `extensions` add for the other nodes it changes; null when one refuses it. */\nexport function transformOps(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  ops: readonly Op[],\n  label: string,\n): Op[] | null {\n  const after = extensions.some((e) => e.finishTransform) ? writtenBy(sc, ops) : null;\n  if (!after || after.size === 0) return [...ops];\n  const others = transformOthers(sc, extensions, after);\n  return others && [...ops, ...otherOps(sc, others, label, extensions)];\n}\n\n/**\n * The other nodes `extensions` change along with a transform frame that\n * poses the nodes in `poses` as given, each as it would be stored — what\n * {@link transformOps} would commit for that frame, read the same way. Empty\n * when nothing changes with it, or an extension refuses it.\n */\nexport function transformPreview(\n  sc: AnyScene,\n  extensions: readonly PathEditExtension[],\n  poses: ReadonlyMap<string, unknown>,\n): TransformPreviewNode[] {\n  if (poses.size === 0 || !extensions.some((e) => e.finishTransform)) return [];\n  const after = new Map<string, EditableNode>();\n  for (const [id, pose] of poses) {\n    const node = sc.get(id as NodeId);\n    if (node) after.set(id, { pose, data: node.data });\n  }\n  const others = transformOthers(sc, extensions, after);\n  return [...(others?.values() ?? [])].flatMap((o) => {\n    const node = sc.get(o.id as NodeId) as EditableNode | undefined;\n    const stored = node && o.path && !o.remove ? storeEditablePath(node, o.path, extensions) : null;\n    if (!node || !stored) return [];\n    return [stored.data === node.data ? { id: o.id, pose: stored.pose } : { id: o.id, pose: stored.pose, data: stored.data }];\n  });\n}\n\n/** The transform follower `extensions` make: each one's `finishTransform`, as\n *  {@link transformOps} and {@link transformPreview} read it. Null when none\n *  has one, so a transform runs no follower for them. */\nexport function pathEditFollower(sc: AnyScene, extensions: readonly PathEditExtension[]): TransformFollower | null {\n  if (!extensions.some((e) => e.finishTransform)) return null;\n  return {\n    finish: (ops, label) => transformOps(sc, extensions, ops, label),\n    preview: (poses) => transformPreview(sc, extensions, poses),\n  };\n}\n"],"mappings":"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"}