@weasel-js/core 1.14.2 → 1.15.1

package/dist/canvas/pickWalk.js

@@ -1,12 +1,12 @@
+import { ownClipOf } from "./ownClip.js";
 import { inheritedPaintOf, inheritsPaint } from "../core/scene/inheritedPaint.js";
 import { clipCarrier } from "./planeClips.js";
-import { ownClipOf } from "./ownClip.js";
 import { reaches } from "./pickReach.js";
 import { scenePickSource, scenePlaneOf } from "./scenePickSource.js";
 import { adapterPickSource } from "./adapterPickSource.js";
 import { invert } from "@weasel-js/geom";
 
-//#region src/canvas/pickWalk.ts
+// src/canvas/pickWalk.ts
 /**
 * The one hit-test walk. Everything that decides whether a node *can* be hit lives here; a
 * query supplies only the shape test and the clip predicate for its own region.
@@ -62,6 +62,12 @@ function pickWalk(src, q) {
 		}
 		return found;
 	};
+	const lookups = {
+		clipOf,
+		copiesOf,
+		carry
+	};
+	const parentsOf = (node) => src.parentsOf(node);
 	const order = src.order();
 	const copying = order.some((n) => typeof n.copiesFromPose === "function");
 	const visit = (q.broad !== void 0 ? src.candidates?.((layer) => {
@@ -80,16 +86,11 @@ function pickWalk(src, q) {
 		const pose = src.poseOf(node);
 		const derived = src.derivedPathOf?.(node);
 		const inherited = inheritsPaint(node) ? inheritedPaintOf(node, src.parentsOf(node)) : void 0;
-		if (!reaches(node, pose, derived, inherited, query, () => src.parentsOf(node), copying, {
-			clipOf,
-			copiesOf,
-			carry
-		})) continue;
+		if (!reaches(node, pose, derived, inherited, query, parentsOf, copying, lookups)) continue;
 		out.push(node.id);
 	}
 	return out;
 }
 
-//#endregion
 export { adapterPickSource, pickWalk, scenePickSource, scenePlaneOf };
 //# sourceMappingURL=pickWalk.js.map

package/dist/canvas/pickWalk.js.map

@@ -1 +1 @@
-{"version":3,"file":"pickWalk.js","names":[],"sources":["../../src/canvas/pickWalk.ts"],"sourcesContent":["/**\n * The one hit-test walk. Everything that decides whether a node *can* be hit lives here; a\n * query supplies only the shape test and the clip predicate for its own region.\n *\n * The gates, in the order the walk applies them:\n *   1. groups, when the query does not want them\n *   2. the node is painted at all — not hidden in the scene (`nodeGates`),\n *      and on a layer the asking view's `layerVisibility` / `layerOrder` paints\n *   3. painted alpha is above zero\n *   4. the node is not locked, unless the query asks for locked nodes\n *   5. the query's own shape test\n *   6. every ancestor clip admits the query region\n *\n * 2, 3 and 6 are all \"the renderer did not put this on screen\". A pick path\n * that skips one answers for a node the user cannot see. 4 is the other axis:\n * a locked node is on screen and still out of reach.\n */\n\nimport { invert, type Affine, type Path } from '@weasel-js/geom';\nimport type { CopiesFromPoseFn } from 'core/scene/types';\nimport { ownClipOf, type ClipBearing } from './ownClip';\nimport { inheritedPaintOf, inheritsPaint, type InheritedPaint } from 'core/scene/inheritedPaint';\nimport { rectToPlane, type PlaneMap } from 'core/viewport/parallax';\nimport { clipCarrier } from './planeClips';\nimport { reaches } from './pickReach';\n\n/** The subset of a node the walk itself reads. Deliberately structural: a\n *  bare adapter's node satisfies it as readily as a `SceneNode`. */\nexport interface PickCandidate<TPose> extends ClipBearing<TPose> {\n  id: string;\n  kind?: string;\n  layer?: string;\n  pose: TPose;\n  /** `false` makes the node transparent to the walk — see `SceneNode.pickable`. */\n  pickable?: boolean;\n  /** Read for an `'inherit'` fill or stroke, which takes its containers'. */\n  data?: unknown;\n  copiesFromPose?: CopiesFromPoseFn<TPose>;\n}\n\n/**\n * Everything the walk reads that a **view** owns.\n *\n * A layer must not hold state a view owns, so none of these are closed over\n * at construction — each is asked per walk, of the view being dispatched to.\n */\nexport interface PickSource<TPose> {\n  /** Candidates in paint order, back-to-front. Containers included; the\n   *  query decides whether they can be hit. */\n  order(): readonly PickCandidate<TPose>[];\n  /** The pose the renderer draws — override-aware. Not `node.pose`, which is\n   *  how the render and pick paths came to disagree about where a node is. */\n  poseOf(node: PickCandidate<TPose>): TPose;\n  /** Ancestors, innermost first. Only walked for candidates that already\n   *  passed their own shape test. */\n  parentsOf(node: PickCandidate<TPose>): readonly PickCandidate<TPose>[];\n  /** Painted alpha for the asking view: the view's `alphaFor` times any\n   *  per-node override alpha. Omit when the source has no alpha concept. */\n  alphaOf?(id: string): number;\n  /** Whether this layer reaches the screen in the asking view. Omit for a\n   *  source with no layers. */\n  layerIsPainted?(layer: string): boolean;\n  /** Whether the node is locked — painted, but not something a pointer can\n   *  take. Omit for a source with no lock concept. */\n  isLocked?(node: PickCandidate<TPose>): boolean;\n  /** Whether the source hides the node, so nothing of it is on screen. Omit\n   *  for a source that hides nothing. */\n  isHidden?(node: PickCandidate<TPose>): boolean;\n  /** The path a node computes from its dependencies, or null for none. */\n  derivedPathOf?(node: PickCandidate<TPose>): Path | null;\n  /** How the asking view's world maps into a parallax layer's, or null for a\n   *  layer that moves with the camera. Omit for a source with no planes. */\n  planeOf?(layer: string): PlaneMap | null;\n  /**\n   * The candidates a query with these broad boxes can hit, back-to-front: a\n   * subset of `order()` that drops only nodes no query inside the box could\n   * hit. `broadFor(layer)` is the box for that layer's query: `null` for a\n   * layer it cannot reach, `undefined` for one with no box, which makes this\n   * answer `null` and the walk visit `order()`. Omit for a source with no index.\n   */\n  candidates?(\n    broadFor: (layer: string | undefined) => PickBroad | null | undefined,\n  ): readonly PickCandidate<TPose>[] | null;\n}\n\n/** The box a query cannot hit outside of, for a source's index to look up. */\nexport interface PickBroad {\n  /** World box, already grown by the query's own slop. */\n  box: { x: number; y: number; width: number; height: number };\n  /** Screen px per world unit at the asking view (least axis); grows the box\n   *  by the largest `outsetPx` the index holds. Omit for a query whose test\n   *  reads no `outsetPx`. */\n  pxPerWorld?: number;\n}\n\n/** `broad` carried into a plane's world, as `inPlane` carries the query. */\nexport function broadInPlane(broad: PickBroad, m: PlaneMap): PickBroad {\n  const box = rectToPlane(m, broad.box);\n  if (broad.pxPerWorld === undefined) return { box };\n  // A plane's pixel is the same on screen, so its world unit holds fewer of them.\n  const k = Math.max(Math.abs(m.scale.x), Math.abs(m.scale.y));\n  return { box, pxPerWorld: broad.pxPerWorld / k };\n}\n\n/** One hit-test question: what region, and what counts as covering it. */\nexport interface PickQuery<TPose> {\n  /** Default `true`. The area walks exclude groups so a marquee does not\n   *  return a group and its members both. */\n  includeGroups?: boolean;\n  /** Default `false`. Every selecting or editing query passes over locked\n   *  nodes; one that only samples what is painted can take them back. */\n  includeLocked?: boolean;\n  /** Where the query can hit at all, for a source with an index. `inPlane`\n   *  carries it with the query; without it the walk visits every node. */\n  broad?: PickBroad;\n  /** Does this node, drawn at this pose, cover the query region? `derived`\n   *  is the node's resolved path when it has one — a derived node's pose is a\n   *  placeholder, so a region test that reads only the pose answers for the\n   *  wrong box. `inherited` is what its `'inherit'` fields take from its\n   *  containers, for the ink it is tested against; absent when it inherits\n   *  nothing. */\n  hits(node: PickCandidate<TPose>, pose: TPose, derived?: Path | null, inherited?: InheritedPaint): boolean;\n  /**\n   * Does an ancestor's clip leave anything of `node` for this query to hit?\n   *\n   * A point query asks point-in-clip and ignores the node. An area query has\n   * to ask about the node as well: the clip and the area can overlap where\n   * the node is not, and the node and the clip can overlap where the area is\n   * not, and only the two terms together reject both.\n   */\n  clipAdmits(\n    clip: Path,\n    node: PickCandidate<TPose>,\n    pose: TPose,\n    derived?: Path | null,\n  ): boolean;\n  /** The same question asked in a parallax plane's world: the region carried\n   *  through `map`, and any screen-pixel slop re-derived at the plane's scale.\n   *  A query without it cannot reach nodes on a plane — it would test them\n   *  where their poses sit rather than where they are painted. */\n  inPlane?(map: PlaneMap): PickQuery<TPose>;\n  /** The same question carried by `m`, an affine from world into the source\n   *  frame of a copy a container draws. A query without it cannot reach\n   *  copies — see `GroupNode.copiesFromPose`. */\n  inCopy?(m: Affine): PickQuery<TPose>;\n}\n\n/**\n * Collect every candidate the query hits, back-to-front — the last element is\n * the topmost, which is the order `pickTopMostHit` expects.\n */\nexport function pickWalk<TPose>(\n  src: PickSource<TPose>,\n  q: PickQuery<TPose>,\n): string[] {\n  const includeGroups = q.includeGroups ?? true;\n  const isLocked = q.includeLocked === true ? undefined : src.isLocked;\n  const out: string[] = [];\n\n  // Resolving a container's clip is the expensive half, so the *path* is memoized per\n  // container for the walk. The predicate re-runs per candidate: caching its answer per\n  // container would answer the wrong question for an area query.\n  const clipPath = new Map<string, Path | null>();\n  // A clip is in its container's plane; the query is in the candidate's.\n  const carry = clipCarrier(src.planeOf ?? null);\n\n  const clipOf = (ancestor: PickCandidate<TPose>): Path | null => {\n    const cached = clipPath.get(ancestor.id);\n    if (cached !== undefined) return cached;\n    const resolved = ownClipOf(\n      ancestor, src.poseOf(ancestor), () => src.derivedPathOf?.(ancestor),\n    );\n    clipPath.set(ancestor.id, resolved);\n    return resolved;\n  };\n\n  const copyMaps = new Map<string, readonly Affine[]>();\n  const copiesOf = (ancestor: PickCandidate<TPose>): readonly Affine[] => {\n    let found = copyMaps.get(ancestor.id);\n    if (found === undefined) {\n      const fn = ancestor.copiesFromPose;\n      const copies = fn ? fn(src.poseOf(ancestor), ancestor as never) ?? [] : [];\n      found = copies.map(invert).filter((m): m is Affine => m !== null);\n      copyMaps.set(ancestor.id, found);\n    }\n    return found;\n  };\n\n  // One reprojected query per plane per walk; `null` marks a plane this\n  // query cannot reach.\n  const planeQueries = new Map<string, PickQuery<TPose> | null>();\n  const queryFor = (layer: string | undefined): PickQuery<TPose> | null => {\n    if (layer === undefined || src.planeOf === undefined) return q;\n    let found = planeQueries.get(layer);\n    if (found === undefined) {\n      const map = src.planeOf(layer);\n      found = map === null ? q : (q.inPlane?.(map) ?? null);\n      planeQueries.set(layer, found);\n    }\n    return found;\n  };\n\n  const order = src.order();\n  const copying = order.some((n) => typeof n.copiesFromPose === 'function');\n  const visit = (q.broad !== undefined ? src.candidates?.((layer) => {\n    const query = queryFor(layer);\n    return query === null ? null : query.broad;\n  }) : null) ?? order;\n  for (const node of visit) {\n    if (!includeGroups && node.kind === 'group') continue;\n    // Transparent to picking: the click belongs to whatever is behind it,\n    // which for a label inside a box is the box.\n    if (node.pickable === false) continue;\n    if (src.isHidden?.(node) === true) continue;\n    if (node.layer !== undefined && src.layerIsPainted?.(node.layer) === false) continue;\n    if (src.alphaOf !== undefined && src.alphaOf(node.id) <= 0) continue;\n    if (isLocked !== undefined && isLocked(node)) continue;\n\n    const query = queryFor(node.layer);\n    if (query === null) continue;\n    const pose = src.poseOf(node);\n    const derived = src.derivedPathOf?.(node);\n    const inherited = inheritsPaint(node) ? inheritedPaintOf(node, src.parentsOf(node)) : undefined;\n    if (!reaches(node, pose, derived, inherited, query, () => src.parentsOf(node), copying, { clipOf, copiesOf, carry })) continue;\n    out.push(node.id);\n  }\n\n  return out;\n}\n\n/**\n * The two answers a pick needs from the view it is asked for rather than from\n * the data behind it: how that view paints a node, and whether it paints a\n * layer at all. A scene and a bare adapter take the same pair.\n */\nexport interface ViewPickGates {\n  /** Painted alpha: the view's `alphaFor` times any per-node override alpha.\n   *  A node painted at alpha 0 cannot be hit. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node's `layer` reaches the screen in the asking view. */\n  layerIsPainted?: (layer: string) => boolean;\n}\n\n/** The gates a bare adapter takes from its view, plus how that view's camera\n *  maps into each parallax layer — see `scenePlaneOf`. */\nexport interface AdapterPickGates extends ViewPickGates {\n  planeOf?: (layer: string) => PlaneMap | null;\n}\n\nexport { scenePickSource, scenePlaneOf, type ScenePickSourceOptions } from './scenePickSource';\nexport { adapterPickSource } from './adapterPickSource';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuJA,SAAgB,SACd,KACA,GACU;CACV,MAAM,gBAAgB,EAAE,iBAAiB;CACzC,MAAM,WAAW,EAAE,kBAAkB,OAAO,SAAY,IAAI;CAC5D,MAAM,MAAgB,CAAC;CAKvB,MAAM,2BAAW,IAAI,IAAyB;CAE9C,MAAM,QAAQ,YAAY,IAAI,WAAW,IAAI;CAE7C,MAAM,UAAU,aAAgD;EAC9D,MAAM,SAAS,SAAS,IAAI,SAAS,EAAE;EACvC,IAAI,WAAW,QAAW,OAAO;EACjC,MAAM,WAAW,UACf,UAAU,IAAI,OAAO,QAAQ,SAAS,IAAI,gBAAgB,QAAQ,CACpE;EACA,SAAS,IAAI,SAAS,IAAI,QAAQ;EAClC,OAAO;CACT;CAEA,MAAM,2BAAW,IAAI,IAA+B;CACpD,MAAM,YAAY,aAAsD;EACtE,IAAI,QAAQ,SAAS,IAAI,SAAS,EAAE;EACpC,IAAI,UAAU,QAAW;GACvB,MAAM,KAAK,SAAS;GAEpB,SADe,KAAK,GAAG,IAAI,OAAO,QAAQ,GAAG,QAAiB,KAAK,CAAC,IAAI,CAAC,EACjE,CAAO,IAAI,MAAM,CAAC,CAAC,QAAQ,MAAmB,MAAM,IAAI;GAChE,SAAS,IAAI,SAAS,IAAI,KAAK;EACjC;EACA,OAAO;CACT;CAIA,MAAM,+BAAe,IAAI,IAAqC;CAC9D,MAAM,YAAY,UAAuD;EACvE,IAAI,UAAU,UAAa,IAAI,YAAY,QAAW,OAAO;EAC7D,IAAI,QAAQ,aAAa,IAAI,KAAK;EAClC,IAAI,UAAU,QAAW;GACvB,MAAM,MAAM,IAAI,QAAQ,KAAK;GAC7B,QAAQ,QAAQ,OAAO,IAAK,EAAE,UAAU,GAAG,KAAK;GAChD,aAAa,IAAI,OAAO,KAAK;EAC/B;EACA,OAAO;CACT;CAEA,MAAM,QAAQ,IAAI,MAAM;CACxB,MAAM,UAAU,MAAM,MAAM,MAAM,OAAO,EAAE,mBAAmB,UAAU;CACxE,MAAM,SAAS,EAAE,UAAU,SAAY,IAAI,cAAc,UAAU;EACjE,MAAM,QAAQ,SAAS,KAAK;EAC5B,OAAO,UAAU,OAAO,OAAO,MAAM;CACvC,CAAC,IAAI,SAAS;CACd,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,iBAAiB,KAAK,SAAS,SAAS;EAG7C,IAAI,KAAK,aAAa,OAAO;EAC7B,IAAI,IAAI,WAAW,IAAI,MAAM,MAAM;EACnC,IAAI,KAAK,UAAU,UAAa,IAAI,iBAAiB,KAAK,KAAK,MAAM,OAAO;EAC5E,IAAI,IAAI,YAAY,UAAa,IAAI,QAAQ,KAAK,EAAE,KAAK,GAAG;EAC5D,IAAI,aAAa,UAAa,SAAS,IAAI,GAAG;EAE9C,MAAM,QAAQ,SAAS,KAAK,KAAK;EACjC,IAAI,UAAU,MAAM;EACpB,MAAM,OAAO,IAAI,OAAO,IAAI;EAC5B,MAAM,UAAU,IAAI,gBAAgB,IAAI;EACxC,MAAM,YAAY,cAAc,IAAI,IAAI,iBAAiB,MAAM,IAAI,UAAU,IAAI,CAAC,IAAI;EACtF,IAAI,CAAC,QAAQ,MAAM,MAAM,SAAS,WAAW,aAAa,IAAI,UAAU,IAAI,GAAG,SAAS;GAAE;GAAQ;GAAU;EAAM,CAAC,GAAG;EACtH,IAAI,KAAK,KAAK,EAAE;CAClB;CAEA,OAAO;AACT"}
+{"version":3,"file":"pickWalk.js","names":[],"sources":["../../src/canvas/pickWalk.ts"],"sourcesContent":["/**\n * The one hit-test walk. Everything that decides whether a node *can* be hit lives here; a\n * query supplies only the shape test and the clip predicate for its own region.\n *\n * The gates, in the order the walk applies them:\n *   1. groups, when the query does not want them\n *   2. the node is painted at all — not hidden in the scene (`nodeGates`),\n *      and on a layer the asking view's `layerVisibility` / `layerOrder` paints\n *   3. painted alpha is above zero\n *   4. the node is not locked, unless the query asks for locked nodes\n *   5. the query's own shape test\n *   6. every ancestor clip admits the query region\n *\n * 2, 3 and 6 are all \"the renderer did not put this on screen\". A pick path\n * that skips one answers for a node the user cannot see. 4 is the other axis:\n * a locked node is on screen and still out of reach.\n */\n\nimport { invert, type Affine, type Path } from '@weasel-js/geom';\nimport type { CopiesFromPoseFn } from 'core/scene/types';\nimport { ownClipOf, type ClipBearing } from './ownClip';\nimport { inheritedPaintOf, inheritsPaint, type InheritedPaint } from 'core/scene/inheritedPaint';\nimport { rectToPlane, type PlaneMap } from 'core/viewport/parallax';\nimport { clipCarrier } from './planeClips';\nimport { reaches } from './pickReach';\n\n/** The subset of a node the walk itself reads. Deliberately structural: a\n *  bare adapter's node satisfies it as readily as a `SceneNode`. */\nexport interface PickCandidate<TPose> extends ClipBearing<TPose> {\n  id: string;\n  kind?: string;\n  layer?: string;\n  pose: TPose;\n  /** `false` makes the node transparent to the walk — see `SceneNode.pickable`. */\n  pickable?: boolean;\n  /** Read for an `'inherit'` fill or stroke, which takes its containers'. */\n  data?: unknown;\n  copiesFromPose?: CopiesFromPoseFn<TPose>;\n}\n\n/**\n * Everything the walk reads that a **view** owns.\n *\n * A layer must not hold state a view owns, so none of these are closed over\n * at construction — each is asked per walk, of the view being dispatched to.\n */\nexport interface PickSource<TPose> {\n  /** Candidates in paint order, back-to-front. Containers included; the\n   *  query decides whether they can be hit. */\n  order(): readonly PickCandidate<TPose>[];\n  /** The pose the renderer draws — override-aware. Not `node.pose`, which is\n   *  how the render and pick paths came to disagree about where a node is. */\n  poseOf(node: PickCandidate<TPose>): TPose;\n  /** Ancestors, innermost first. Only walked for candidates that already\n   *  passed their own shape test. */\n  parentsOf(node: PickCandidate<TPose>): readonly PickCandidate<TPose>[];\n  /** Painted alpha for the asking view: the view's `alphaFor` times any\n   *  per-node override alpha. Omit when the source has no alpha concept. */\n  alphaOf?(id: string): number;\n  /** Whether this layer reaches the screen in the asking view. Omit for a\n   *  source with no layers. */\n  layerIsPainted?(layer: string): boolean;\n  /** Whether the node is locked — painted, but not something a pointer can\n   *  take. Omit for a source with no lock concept. */\n  isLocked?(node: PickCandidate<TPose>): boolean;\n  /** Whether the source hides the node, so nothing of it is on screen. Omit\n   *  for a source that hides nothing. */\n  isHidden?(node: PickCandidate<TPose>): boolean;\n  /** The path a node computes from its dependencies, or null for none. */\n  derivedPathOf?(node: PickCandidate<TPose>): Path | null;\n  /** How the asking view's world maps into a parallax layer's, or null for a\n   *  layer that moves with the camera. Omit for a source with no planes. */\n  planeOf?(layer: string): PlaneMap | null;\n  /**\n   * The candidates a query with these broad boxes can hit, back-to-front: a\n   * subset of `order()` that drops only nodes no query inside the box could\n   * hit. `broadFor(layer)` is the box for that layer's query: `null` for a\n   * layer it cannot reach, `undefined` for one with no box, which makes this\n   * answer `null` and the walk visit `order()`. Omit for a source with no index.\n   */\n  candidates?(\n    broadFor: (layer: string | undefined) => PickBroad | null | undefined,\n  ): readonly PickCandidate<TPose>[] | null;\n}\n\n/** The box a query cannot hit outside of, for a source's index to look up. */\nexport interface PickBroad {\n  /** World box, already grown by the query's own slop. */\n  box: { x: number; y: number; width: number; height: number };\n  /** Screen px per world unit at the asking view (least axis); grows the box\n   *  by the largest `outsetPx` the index holds. Omit for a query whose test\n   *  reads no `outsetPx`. */\n  pxPerWorld?: number;\n}\n\n/** `broad` carried into a plane's world, as `inPlane` carries the query. */\nexport function broadInPlane(broad: PickBroad, m: PlaneMap): PickBroad {\n  const box = rectToPlane(m, broad.box);\n  if (broad.pxPerWorld === undefined) return { box };\n  // A plane's pixel is the same on screen, so its world unit holds fewer of them.\n  const k = Math.max(Math.abs(m.scale.x), Math.abs(m.scale.y));\n  return { box, pxPerWorld: broad.pxPerWorld / k };\n}\n\n/** One hit-test question: what region, and what counts as covering it. */\nexport interface PickQuery<TPose> {\n  /** Default `true`. The area walks exclude groups so a marquee does not\n   *  return a group and its members both. */\n  includeGroups?: boolean;\n  /** Default `false`. Every selecting or editing query passes over locked\n   *  nodes; one that only samples what is painted can take them back. */\n  includeLocked?: boolean;\n  /** Where the query can hit at all, for a source with an index. `inPlane`\n   *  carries it with the query; without it the walk visits every node. */\n  broad?: PickBroad;\n  /** Does this node, drawn at this pose, cover the query region? `derived`\n   *  is the node's resolved path when it has one — a derived node's pose is a\n   *  placeholder, so a region test that reads only the pose answers for the\n   *  wrong box. `inherited` is what its `'inherit'` fields take from its\n   *  containers, for the ink it is tested against; absent when it inherits\n   *  nothing. */\n  hits(node: PickCandidate<TPose>, pose: TPose, derived?: Path | null, inherited?: InheritedPaint): boolean;\n  /**\n   * Does an ancestor's clip leave anything of `node` for this query to hit?\n   *\n   * A point query asks point-in-clip and ignores the node. An area query has\n   * to ask about the node as well: the clip and the area can overlap where\n   * the node is not, and the node and the clip can overlap where the area is\n   * not, and only the two terms together reject both.\n   */\n  clipAdmits(\n    clip: Path,\n    node: PickCandidate<TPose>,\n    pose: TPose,\n    derived?: Path | null,\n  ): boolean;\n  /** The same question asked in a parallax plane's world: the region carried\n   *  through `map`, and any screen-pixel slop re-derived at the plane's scale.\n   *  A query without it cannot reach nodes on a plane — it would test them\n   *  where their poses sit rather than where they are painted. */\n  inPlane?(map: PlaneMap): PickQuery<TPose>;\n  /** The same question carried by `m`, an affine from world into the source\n   *  frame of a copy a container draws. A query without it cannot reach\n   *  copies — see `GroupNode.copiesFromPose`. */\n  inCopy?(m: Affine): PickQuery<TPose>;\n}\n\n/**\n * Collect every candidate the query hits, back-to-front — the last element is\n * the topmost, which is the order `pickTopMostHit` expects.\n */\nexport function pickWalk<TPose>(\n  src: PickSource<TPose>,\n  q: PickQuery<TPose>,\n): string[] {\n  const includeGroups = q.includeGroups ?? true;\n  const isLocked = q.includeLocked === true ? undefined : src.isLocked;\n  const out: string[] = [];\n\n  // Resolving a container's clip is the expensive half, so the *path* is memoized per\n  // container for the walk. The predicate re-runs per candidate: caching its answer per\n  // container would answer the wrong question for an area query.\n  const clipPath = new Map<string, Path | null>();\n  // A clip is in its container's plane; the query is in the candidate's.\n  const carry = clipCarrier(src.planeOf ?? null);\n\n  const clipOf = (ancestor: PickCandidate<TPose>): Path | null => {\n    const cached = clipPath.get(ancestor.id);\n    if (cached !== undefined) return cached;\n    const resolved = ownClipOf(\n      ancestor, src.poseOf(ancestor), () => src.derivedPathOf?.(ancestor),\n    );\n    clipPath.set(ancestor.id, resolved);\n    return resolved;\n  };\n\n  const copyMaps = new Map<string, readonly Affine[]>();\n  const copiesOf = (ancestor: PickCandidate<TPose>): readonly Affine[] => {\n    let found = copyMaps.get(ancestor.id);\n    if (found === undefined) {\n      const fn = ancestor.copiesFromPose;\n      const copies = fn ? fn(src.poseOf(ancestor), ancestor as never) ?? [] : [];\n      found = copies.map(invert).filter((m): m is Affine => m !== null);\n      copyMaps.set(ancestor.id, found);\n    }\n    return found;\n  };\n\n  // One reprojected query per plane per walk; `null` marks a plane this\n  // query cannot reach.\n  const planeQueries = new Map<string, PickQuery<TPose> | null>();\n  const queryFor = (layer: string | undefined): PickQuery<TPose> | null => {\n    if (layer === undefined || src.planeOf === undefined) return q;\n    let found = planeQueries.get(layer);\n    if (found === undefined) {\n      const map = src.planeOf(layer);\n      found = map === null ? q : (q.inPlane?.(map) ?? null);\n      planeQueries.set(layer, found);\n    }\n    return found;\n  };\n\n  const lookups = { clipOf, copiesOf, carry };\n  const parentsOf = (node: PickCandidate<TPose>) => src.parentsOf(node);\n  const order = src.order();\n  const copying = order.some((n) => typeof n.copiesFromPose === 'function');\n  const visit = (q.broad !== undefined ? src.candidates?.((layer) => {\n    const query = queryFor(layer);\n    return query === null ? null : query.broad;\n  }) : null) ?? order;\n  for (const node of visit) {\n    if (!includeGroups && node.kind === 'group') continue;\n    // Transparent to picking: the click belongs to whatever is behind it,\n    // which for a label inside a box is the box.\n    if (node.pickable === false) continue;\n    if (src.isHidden?.(node) === true) continue;\n    if (node.layer !== undefined && src.layerIsPainted?.(node.layer) === false) continue;\n    if (src.alphaOf !== undefined && src.alphaOf(node.id) <= 0) continue;\n    if (isLocked !== undefined && isLocked(node)) continue;\n\n    const query = queryFor(node.layer);\n    if (query === null) continue;\n    const pose = src.poseOf(node);\n    const derived = src.derivedPathOf?.(node);\n    const inherited = inheritsPaint(node) ? inheritedPaintOf(node, src.parentsOf(node)) : undefined;\n    if (!reaches(node, pose, derived, inherited, query, parentsOf, copying, lookups)) continue;\n    out.push(node.id);\n  }\n\n  return out;\n}\n\n/**\n * The two answers a pick needs from the view it is asked for rather than from\n * the data behind it: how that view paints a node, and whether it paints a\n * layer at all. A scene and a bare adapter take the same pair.\n */\nexport interface ViewPickGates {\n  /** Painted alpha: the view's `alphaFor` times any per-node override alpha.\n   *  A node painted at alpha 0 cannot be hit. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node's `layer` reaches the screen in the asking view. */\n  layerIsPainted?: (layer: string) => boolean;\n}\n\n/** The gates a bare adapter takes from its view, plus how that view's camera\n *  maps into each parallax layer — see `scenePlaneOf`. */\nexport interface AdapterPickGates extends ViewPickGates {\n  planeOf?: (layer: string) => PlaneMap | null;\n}\n\nexport { scenePickSource, scenePlaneOf, type ScenePickSourceOptions } from './scenePickSource';\nexport { adapterPickSource } from './adapterPickSource';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuJA,SAAgB,SACd,KACA,GACU;CACV,MAAM,gBAAgB,EAAE,iBAAiB;CACzC,MAAM,WAAW,EAAE,kBAAkB,OAAO,SAAY,IAAI;CAC5D,MAAM,MAAgB,CAAC;CAKvB,MAAM,2BAAW,IAAI,IAAyB;CAE9C,MAAM,QAAQ,YAAY,IAAI,WAAW,IAAI;CAE7C,MAAM,UAAU,aAAgD;EAC9D,MAAM,SAAS,SAAS,IAAI,SAAS,EAAE;EACvC,IAAI,WAAW,QAAW,OAAO;EACjC,MAAM,WAAW,UACf,UAAU,IAAI,OAAO,QAAQ,SAAS,IAAI,gBAAgB,QAAQ,CACpE;EACA,SAAS,IAAI,SAAS,IAAI,QAAQ;EAClC,OAAO;CACT;CAEA,MAAM,2BAAW,IAAI,IAA+B;CACpD,MAAM,YAAY,aAAsD;EACtE,IAAI,QAAQ,SAAS,IAAI,SAAS,EAAE;EACpC,IAAI,UAAU,QAAW;GACvB,MAAM,KAAK,SAAS;GAEpB,SADe,KAAK,GAAG,IAAI,OAAO,QAAQ,GAAG,QAAiB,KAAK,CAAC,IAAI,CAAC,EACjE,CAAO,IAAI,MAAM,CAAC,CAAC,QAAQ,MAAmB,MAAM,IAAI;GAChE,SAAS,IAAI,SAAS,IAAI,KAAK;EACjC;EACA,OAAO;CACT;CAIA,MAAM,+BAAe,IAAI,IAAqC;CAC9D,MAAM,YAAY,UAAuD;EACvE,IAAI,UAAU,UAAa,IAAI,YAAY,QAAW,OAAO;EAC7D,IAAI,QAAQ,aAAa,IAAI,KAAK;EAClC,IAAI,UAAU,QAAW;GACvB,MAAM,MAAM,IAAI,QAAQ,KAAK;GAC7B,QAAQ,QAAQ,OAAO,IAAK,EAAE,UAAU,GAAG,KAAK;GAChD,aAAa,IAAI,OAAO,KAAK;EAC/B;EACA,OAAO;CACT;CAEA,MAAM,UAAU;EAAE;EAAQ;EAAU;CAAM;CAC1C,MAAM,aAAa,SAA+B,IAAI,UAAU,IAAI;CACpE,MAAM,QAAQ,IAAI,MAAM;CACxB,MAAM,UAAU,MAAM,MAAM,MAAM,OAAO,EAAE,mBAAmB,UAAU;CACxE,MAAM,SAAS,EAAE,UAAU,SAAY,IAAI,cAAc,UAAU;EACjE,MAAM,QAAQ,SAAS,KAAK;EAC5B,OAAO,UAAU,OAAO,OAAO,MAAM;CACvC,CAAC,IAAI,SAAS;CACd,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,iBAAiB,KAAK,SAAS,SAAS;EAG7C,IAAI,KAAK,aAAa,OAAO;EAC7B,IAAI,IAAI,WAAW,IAAI,MAAM,MAAM;EACnC,IAAI,KAAK,UAAU,UAAa,IAAI,iBAAiB,KAAK,KAAK,MAAM,OAAO;EAC5E,IAAI,IAAI,YAAY,UAAa,IAAI,QAAQ,KAAK,EAAE,KAAK,GAAG;EAC5D,IAAI,aAAa,UAAa,SAAS,IAAI,GAAG;EAE9C,MAAM,QAAQ,SAAS,KAAK,KAAK;EACjC,IAAI,UAAU,MAAM;EACpB,MAAM,OAAO,IAAI,OAAO,IAAI;EAC5B,MAAM,UAAU,IAAI,gBAAgB,IAAI;EACxC,MAAM,YAAY,cAAc,IAAI,IAAI,iBAAiB,MAAM,IAAI,UAAU,IAAI,CAAC,IAAI;EACtF,IAAI,CAAC,QAAQ,MAAM,MAAM,SAAS,WAAW,OAAO,WAAW,SAAS,OAAO,GAAG;EAClF,IAAI,KAAK,KAAK,EAAE;CAClB;CAEA,OAAO;AACT"}

package/dist/canvas/planeClips.js

@@ -1,7 +1,7 @@
 import { planeMatrix, planeToPlane } from "../core/viewport/parallax.js";
 import { mat3, transformPath } from "@weasel-js/geom";
 
-//#region src/canvas/planeClips.ts
+// src/canvas/planeClips.ts
 /**
 * Carries a container's clip into the world a descendant is drawn or picked
 * in. A clip is built from the container's pose, so it is in the container's
@@ -41,6 +41,5 @@ function pathFromPlane(path, m) {
 	return back === null ? path : transformPath(path, planeMatrix(back));
 }
 
-//#endregion
 export { clipCarrier, pathFromPlane, planeTransform };
 //# sourceMappingURL=planeClips.js.map

package/dist/canvas/poseRotation.js

@@ -1,6 +1,6 @@
 import { mat3, poseFrameOf, rotateAboutPoint } from "@weasel-js/geom";
 
-//#region src/canvas/poseRotation.ts
+// src/canvas/poseRotation.ts
 /** Rotation by `rotation` about `(cx, cy)` as the render-tree's column-major
 *  3×3 affine. */
 function rotationMatrixAbout(cx, cy, rotation) {
@@ -26,6 +26,5 @@ function wrapWithPoseRotation(cmds, pose) {
 	}];
 }
 
-//#endregion
 export { rotateAroundAABBCenter, rotationMatrixAbout, wrapWithPoseRotation };
 //# sourceMappingURL=poseRotation.js.map

package/dist/canvas/publishPreviews.js

@@ -1,6 +1,6 @@
 import { isPlainObject } from "@weasel-js/registry";
 
-//#region src/canvas/publishPreviews.ts
+// src/canvas/publishPreviews.ts
 /**
 * `publishPreviews` — what in-flight handles propose, published to the scene.
 *
@@ -92,6 +92,5 @@ function collect(handle, frame, exists, dataFor) {
 	}
 }
 
-//#endregion
 export { publishPreviews };
 //# sourceMappingURL=publishPreviews.js.map

package/dist/canvas/rasterReadback.js

@@ -1,4 +1,4 @@
-//#region src/canvas/rasterReadback.ts
+// src/canvas/rasterReadback.ts
 /** A GL readback (bottom-up, premultiplied RGBA) as image bytes: top-down
 *  rows of straight RGBA. */
 function straightTopDown(raw, width, height) {
@@ -25,6 +25,5 @@ function unpremultiply(data) {
 	}
 }
 
-//#endregion
 export { straightTopDown };
 //# sourceMappingURL=rasterReadback.js.map

package/dist/canvas/rasterToPng.js

@@ -1,4 +1,4 @@
-//#region src/canvas/rasterToPng.ts
+// src/canvas/rasterToPng.ts
 /** Encode a raster as a PNG `Blob` — for download, upload, or the clipboard.
 *  Needs a 2D canvas: `OffscreenCanvas` where there is one, else the DOM's. */
 async function rasterToPng(image) {
@@ -22,6 +22,5 @@ async function rasterToPng(image) {
 	});
 }
 
-//#endregion
 export { rasterToPng };
 //# sourceMappingURL=rasterToPng.js.map

package/dist/canvas/renderDebugSnapshot.js

@@ -2,7 +2,7 @@ import { renderSceneToPixels } from "./renderSceneToPixels.js";
 import { buildDebugOverlayCommands } from "../debug/createDebugOverlayLayer.js";
 import { mat3 } from "@weasel-js/geom";
 
-//#region src/canvas/renderDebugSnapshot.ts
+// src/canvas/renderDebugSnapshot.ts
 /**
 * `renderDebugSnapshot` — the canvas as its debug overlay showed it, scene and
 * overlay in one raster, for attaching to a bug report.
@@ -45,6 +45,5 @@ function debugSnapshotArgs(args) {
 	};
 }
 
-//#endregion
 export { debugSnapshotArgs, renderDebugSnapshot };
 //# sourceMappingURL=renderDebugSnapshot.js.map

package/dist/canvas/renderNeeds.js

@@ -1,4 +1,4 @@
-//#region src/canvas/renderNeeds.ts
+// src/canvas/renderNeeds.ts
 /**
 * The fonts and paint kinds `commands` draw with, read off the commands
 * themselves: text runs, path fills and strokes, run fills and strokes, and
@@ -35,6 +35,5 @@ function renderNeeds(commands) {
 	};
 }
 
-//#endregion
 export { renderNeeds };
 //# sourceMappingURL=renderNeeds.js.map

package/dist/canvas/renderSceneToPixels.js

@@ -1,15 +1,15 @@
-import { sceneLayerKey } from "./sceneLayerPaint.js";
-import { CANVAS_CONTEXT_ATTRIBUTES } from "./contextAttributes.js";
-import { annotationLayerIds } from "../core/scene/annotation.js";
-import { defaultDrawOne } from "./defaultDrawOne.js";
 import { buildSceneViewCommands } from "./sceneViewRender.js";
+import { defaultDrawOne } from "./defaultDrawOne.js";
 import { renderNeeds } from "./renderNeeds.js";
 import { straightTopDown } from "./rasterReadback.js";
+import { annotationLayerIds } from "../core/scene/annotation.js";
+import { sceneLayerKey } from "./sceneLayerPaint.js";
+import { CANVAS_CONTEXT_ATTRIBUTES } from "./contextAttributes.js";
 import { WeaselRenderer, isPaintKindKnown, warmPaintKinds } from "@weasel-js/renderer";
 import { viewToMat3 as viewToMat3$1 } from "@weasel-js/geom";
 import { warmFonts } from "@weasel-js/font";
 
-//#region src/canvas/renderSceneToPixels.ts
+// src/canvas/renderSceneToPixels.ts
 /**
 * `renderSceneToPixels` — headless rasterization of a scene-space rect to raw RGBA pixels at an
 * explicit, per-axis scale. It drives the same WebGL2 pipeline (`WeaselRenderer` +
@@ -237,6 +237,5 @@ function renderSceneToPixels(args) {
 	}
 }
 
-//#endregion
 export { createRasterSession, planPixelRender, renderSceneToPixels, warmRender };
 //# sourceMappingURL=renderSceneToPixels.js.map

package/dist/canvas/sceneAdapter.js

@@ -1,18 +1,48 @@
-import { composeWorldPose, composesFrames, frameAtOrAbove, memoizeCompose } from "../core/scene/composeFrame.js";
 import { definesFrame, effectivePose } from "../core/scene/effectivePose.js";
-import { poseDescriptorForNode, translatePoseViaDescriptor, visualBoundsViaDescriptor } from "../core/geometry/poseDescriptor.js";
-import { scrolledFrames } from "../core/scene/scrollOffsets.js";
-import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
+import { sceneMutators } from "../core/scene/sceneMutators.js";
 import { asNodeId } from "../core/scene/types.js";
 import { nodeGates } from "../core/scene/nodeGates.js";
-import { sceneMutators } from "../core/scene/sceneMutators.js";
 import { applyOpsTo } from "../core/applyOps.js";
 import { hitTestArea, hitTestLassoPolygon, regionPickOptions } from "./deps/hitTestArea.js";
+import { poseDescriptorForNode, translatePoseViaDescriptor, visualBoundsViaDescriptor } from "../core/geometry/poseDescriptor.js";
+import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
+import { composeChildFrame, composeWorldPose, composesFrames, frameAtOrAbove, memoizeCompose } from "../core/scene/composeFrame.js";
+import { scrolledFrames } from "../core/scene/scrollOffsets.js";
 import { insertSite } from "./deps/insertSite.js";
 import { scenePoseTarget } from "../animation/poseTarget.js";
 import { pasteSceneSnapshot, snapshotSceneSelection } from "./sceneClipboard.js";
 
-//#region src/canvas/sceneAdapter.ts
+// src/canvas/sceneAdapter.ts
+/** A scene adapter's pose reads: the stored pose, the world pose, and the fold between them. */
+function scenePoseReads(scene) {
+	const composes = composesFrames(scene.composition);
+	const compose = memoizeCompose(scene.composition.compose);
+	const childFrame = composes ? scrolledFrames(scene) : void 0;
+	const reads = {
+		getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,
+		getPose(id) {
+			const n = scene.get(asNodeId(id));
+			if (!n) throw new Error(`sceneToAdapter: unknown node "${id}"`);
+			return effectivePose(scene, n);
+		},
+		definesFrame(id) {
+			const n = scene.get(asNodeId(id));
+			return n === void 0 || definesFrame(n);
+		},
+		...childFrame ? { childFrame } : {}
+	};
+	return {
+		getPose: reads.getPose,
+		definesFrame: reads.definesFrame,
+		getWorldPose: (id) => composes ? composeWorldPose(reads, id, compose) : reads.getPose(id),
+		worldOfStored(id, stored) {
+			const frame = composes ? frameAtOrAbove(reads, reads.getParent(id)) : null;
+			return frame === null ? stored : compose(composeChildFrame(reads, frame, compose), stored);
+		},
+		...composes ? { composePose: compose } : {},
+		...childFrame ? { childFrame } : {}
+	};
+}
 /** Derive the adapter for a scene. Reads go straight to the scene; writes are
 *  ops applied through its history, so anything done through the adapter is
 *  undoable. A container's pose is a frame its children are stored in, so the
@@ -24,10 +54,6 @@ function sceneToAdapter(scene, options = {}) {
 	const d = options.poseDescriptor ?? AUTO_POSE_DESCRIPTOR;
 	const poseBounds = (p, node) => visualBoundsViaDescriptor(p, poseDescriptorForNode(d, node));
 	const translate = (p, dx, dy, node) => translatePoseViaDescriptor(p, dx, dy, node === void 0 ? d : poseDescriptorForNode(d, node));
-	const composition = scene.composition;
-	const composes = composesFrames(composition);
-	const compose = memoizeCompose(composition.compose);
-	const childFrame = composes ? scrolledFrames(scene) : void 0;
 	const pickOpts = {};
 	const pickOptsFor = (view) => view ? {
 		...pickOpts,
@@ -47,22 +73,7 @@ function sceneToAdapter(scene, options = {}) {
 			const gates = nodeGates(scene);
 			return scene.renderOrderNodes().filter((n) => !gates.hidden(n.id));
 		},
-		getPose(id) {
-			const nid = asNodeId(id);
-			const n = scene.get(nid);
-			if (!n) throw new Error(`sceneToAdapter: unknown node "${id}"`);
-			return effectivePose(scene, n);
-		},
-		definesFrame(id) {
-			const n = scene.get(asNodeId(id));
-			return n === void 0 || definesFrame(n);
-		},
-		getWorldPose(id) {
-			if (!composes) return adapter.getPose(id);
-			return composeWorldPose(adapter, id, compose);
-		},
-		...composes ? { composePose: compose } : {},
-		...childFrame ? { childFrame } : {},
+		...scenePoseReads(scene),
 		poseTarget: (id, descriptor) => scenePoseTarget(scene, id, descriptor ?? d),
 		getLayers: () => scene.layers.map((l) => ({
 			id: l.id,
@@ -112,6 +123,5 @@ function sceneToAdapter(scene, options = {}) {
 	return adapter;
 }
 
-//#endregion
 export { sceneToAdapter };
 //# sourceMappingURL=sceneAdapter.js.map

package/dist/canvas/sceneAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneAdapter.js","names":[],"sources":["../../src/canvas/sceneAdapter.ts"],"sourcesContent":["/**\n * Synthesize a `<Canvas>`-compatible adapter from a `Scene` primitive.\n * `getPose` / `setPose` return / write **local** coordinates (relative to\n * parent); world composition is the renderer's job via `composeWorldPose`.\n */\nimport type {\n  AreaSelectAdapter,\n  ClipboardSnapshot,\n  InsertAdapter,\n  PasteCtx,\n  LassoHitMode,\n  LassoSelectAdapter,\n  RegionPickView,\n  LayerEnumerableAdapter,\n  MoveAdapter,\n  ResizeAdapter,\n  RotateAdapter,\n} from 'core/adapters/types';\nimport type { LayoutStrategy } from '../layout/types';\nimport type { Op } from 'core/ops/types';\nimport type { Node, Scene } from 'core/scene/types';\nimport { definesFrame, effectivePose } from 'core/scene/effectivePose';\nimport { sceneMutators } from 'core/scene/sceneMutators';\nimport { asNodeId } from 'core/scene/types';\nimport { nodeGates } from 'core/scene/nodeGates';\nimport { applyOpsTo } from 'core/applyOps';\nimport { hitTestArea, hitTestLassoPolygon, regionPickOptions } from 'canvas/deps/hitTestArea';\nimport type { ScenePickSourceOptions } from 'canvas/pickWalk';\nimport {\n  poseDescriptorForNode,\n  translatePoseViaDescriptor,\n  visualBoundsViaDescriptor,\n  type PoseDescriptor,\n} from 'interactions/actions/resize/geometry';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { composesFrames, composeWorldPose, frameAtOrAbove } from 'core/scene/composePose';\nimport { memoizeCompose } from 'core/scene/composeFrame';\nimport { scrolledFrames } from 'core/scene/scrollOffsets';\nimport { insertSite } from './deps/insertSite';\nimport type { Bounds } from '../core/viewport/fitViewToBounds';\nimport { scenePoseTarget } from '../animation/poseTarget';\nimport { pasteSceneSnapshot, snapshotSceneSelection, type SceneClipboardEnv } from './sceneClipboard';\n\n/** Minimal selection contract `sceneToAdapter` needs to wire `getSelection` /\n *  `setSelection`. Matches `useSelection().adapterMethods` plus an imperative\n *  read; pass `useSelection()` itself or `selection.adapterMethods`. */\nexport interface SceneAdapterSelection {\n  get?(): string[];\n  set?(ids: string[]): void;\n  getSelection?(): string[];\n  setSelection?(ids: string[]): void;\n}\n\n/** Sibling z-order surface used by reorder ops. Inlined here (rather than\n *  pulled from `core/ops/reorder` to avoid import cycles); the `null` parent\n *  channel addresses the root sibling list. */\n/** @internal */\ninterface ReorderAdapter {\n  getChildren(parentId: string | null): string[];\n  setChildOrder(parentId: string | null, ids: string[]): void;\n}\n\n/** Everything the interaction layer can ask of a scene, as one type: the\n *  move, resize, rotate, selection, layer and reorder contracts combined.\n *  `<SceneCanvas>` synthesizes one of these, which is why most consumers never\n *  touch an adapter directly. */\nexport type SceneCanvasAdapter<TData, TLayer extends string, TPose> =\n  & MoveAdapter<Node<TData, TLayer, TPose>, TPose>\n  & ResizeAdapter<Node<TData, TLayer, TPose>, TPose>\n  & RotateAdapter<Node<TData, TLayer, TPose>, TPose>\n  & AreaSelectAdapter\n  & LassoSelectAdapter\n  & LayerEnumerableAdapter<TLayer>\n  & ReorderAdapter\n  & Partial<InsertAdapter<Node<TData, TLayer, TPose>>>\n  // Optional on the underlying adapter contracts, but unconditionally\n  // provided by a scene-backed adapter.\n  & {\n      getParent(id: string): string | null;\n      getLayers: NonNullable<LayerEnumerableAdapter<TLayer>['getLayers']>;\n      /** The node's pose with every ancestor's frame folded in. Equal to\n       *  `getPose` unless the scene composes poses. */\n      getWorldPose(id: string): TPose;\n      /** Whether `id`'s pose is a frame its children are expressed in — see\n       *  `definesFrame`. */\n      definesFrame(id: string): boolean;\n      /** Present only when a composing strategy is configured; the render\n       *  walk feature-detects it. */\n      composePose?(parent: TPose, child: TPose): TPose;\n      /** The frame a container gives its children, scrolled by the scene's\n       *  `scroll` offset — see `PoseAdapter.childFrame`. Present only when the\n       *  composition can scroll. */\n      childFrame?(id: string, world: TPose): TPose;\n      getSelection(): string[];\n      setSelection(ids: string[]): void;\n      insertNode(node: Node<TData, TLayer, TPose>, index?: number): void;\n      removeNode(id: string): void;\n      /** Replace a node's `data` — what a `setData` op writes through. */\n      setData(id: string, data: TData): void;\n      /** Swap a container's layout — what a `setLayout` op writes through. */\n      setLayout(id: string, layout: LayoutStrategy<TPose> | string | null): void;\n      /** Move a node to another layer — what a `setLayer` op writes through. */\n      setLayer(id: string, layer: TLayer): void;\n      /** Retarget a derived node's sources — what a `setDependsOn` op writes through. */\n      setDependsOn(id: string, dependsOn: readonly string[] | 'children' | undefined): void;\n      /** Hide or show a node — what a `setHidden` op writes through. */\n      setHidden(id: string, hidden: boolean): void;\n      /** Lock or unlock a node — what a `setLocked` op writes through. */\n      setLocked(id: string, locked: boolean): void;\n      getRemovalClosure(ids: readonly string[]): string[];\n      applyOps(ops: Op[], label?: string): void;\n      snapshotSelection(ids: string[]): ClipboardSnapshot;\n      commitPaste(\n        clipboard: ClipboardSnapshot,\n        offset: { dx: number; dy: number },\n        ctx?: PasteCtx,\n      ): Node<TData, TLayer, TPose>[];\n      getPasteOffset(clipboard: ClipboardSnapshot): { dx: number; dy: number };\n    };\n\n/** Optional extras for the synthesized adapter. Pass `commitInsert` to wire\n *  the insert gesture into a Scene-owned canvas; the returned object becomes\n *  a leaf on the layer named by `layer` (default `'default'`). */\nexport interface SceneToAdapterOptions<TData, TLayer extends string, TPose> {\n  /** Factory for new objects. Returning `null` aborts the insert. */\n  commitInsert?: (bounds: Bounds) => {\n    pose: TPose;\n    data: TData;\n    id?: string;\n  } | null;\n  /** Layer to place inserted nodes on. Defaults to the trivial-form layer. */\n  insertLayer?: TLayer;\n  /** Selection source: the result of `useSelection()` (or its\n   *  `adapterMethods`). When omitted, `getSelection` returns `[]` and\n   *  `setSelection` is a noop, so the marquee gesture updates nothing. */\n  selection?: SceneAdapterSelection;\n  /** How to read and rewrite this scene's poses. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<TPose>;\n  /** The container a paste lands in, read at each paste: `<SceneCanvas>` passes the `insertInto` dep's. */\n  pasteInto?: () => string | null;\n}\n\n/** Derive the adapter for a scene. Reads go straight to the scene; writes are\n *  ops applied through its history, so anything done through the adapter is\n *  undoable. A container's pose is a frame its children are stored in, so the\n *  one pose written moves its contents. */\nexport function sceneToAdapter<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  options: SceneToAdapterOptions<TData, TLayer, TPose> = {},\n): SceneCanvasAdapter<TData, TLayer, TPose> {\n  const sel = options.selection;\n  const getSelection = sel?.getSelection ?? sel?.get ?? (() => [] as string[]);\n  const setSelection = sel?.setSelection ?? sel?.set ?? (() => {});\n  const d = (options.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const poseBounds = (p: TPose, node: unknown): Bounds =>\n    visualBoundsViaDescriptor(p, poseDescriptorForNode(d, node));\n  const translate = (p: TPose, dx: number, dy: number, node?: unknown): TPose =>\n    translatePoseViaDescriptor(p, dx, dy, node === undefined ? d : poseDescriptorForNode(d, node));\n\n  const composition = scene.composition;\n  const composes = composesFrames(composition);\n  const compose = memoizeCompose(composition.compose);\n  const childFrame = composes ? scrolledFrames(scene) : undefined;\n  const pickOpts: ScenePickSourceOptions<unknown> = {};\n  // The asking view's layer gate and camera, over the adapter's own options.\n  const pickOptsFor = (view: RegionPickView | undefined): ScenePickSourceOptions<unknown> =>\n    (view ? { ...pickOpts, ...regionPickOptions(view, undefined) } : pickOpts);\n\n  const clipboardEnv: SceneClipboardEnv<TData, TLayer, TPose> = {\n    scene,\n    worldPoseOf: (id) => adapter.getWorldPose(id),\n    frameAtOrAbove: (id) => frameAtOrAbove(adapter, id),\n    poseBounds,\n    translate, ...(options.pasteInto ? { landing: () => insertSite(scene as never, options.pasteInto!()) } : {}),\n  };\n\n  const adapter: SceneCanvasAdapter<TData, TLayer, TPose> = {\n    ...sceneMutators(scene),\n    // What is shown, where the mutators' other users read the document:\n    // the nodes not hidden, and the effective pose.\n    getNodes() {\n      const gates = nodeGates(scene);\n      return scene.renderOrderNodes().filter((n) => !gates.hidden(n.id));\n    },\n    getPose(id) {\n      const nid = asNodeId(id);\n      const n = scene.get(nid);\n      if (!n) throw new Error(`sceneToAdapter: unknown node \"${id}\"`);\n      return effectivePose(scene, n);\n    },\n    definesFrame(id) {\n      const n = scene.get(asNodeId(id));\n      return n === undefined || definesFrame(n);\n    },\n    getWorldPose(id) {\n      if (!composes) return adapter.getPose(id);\n      return composeWorldPose(adapter, id, compose);\n    },\n    // Only present when it would do something: the render walk skips the fold\n    // entirely when this is absent, which is the absolute-pose path.\n    ...(composes ? { composePose: compose } : {}),\n    ...(childFrame ? { childFrame } : {}),\n    poseTarget: (id, descriptor) => scenePoseTarget(scene, id, descriptor ?? d),\n    getLayers: () => scene.layers.map((l) => ({ id: l.id, visible: l.visible, parallax: l.parallax })),\n    subscribeLayers: (listener) => scene.subscribe(listener),\n    getLayout: (id) => scene.layoutOf(asNodeId(id)),\n    // With a label the ops are one batch checkpoint; without one they are\n    // applied transiently, with no checkpoint (the AreaSelectAdapter contract).\n    applyOps(ops: Op[], label?: string) {\n      if (label !== undefined) {\n        scene.applyBatch(ops, label, this);\n      } else {\n        applyOpsTo(this, ops);\n      }\n    },\n    getSelection,\n    setSelection,\n    // The live marquee's and lasso's own hit-tests. Groups come back:\n    // this adapter's consumer has nothing to fold children into them.\n    hitTestArea(rect: Bounds, view?: RegionPickView) {\n      return hitTestArea(\n        scene,\n        rect,\n        pickOptsFor(view),\n        d as PoseDescriptor<unknown>,\n        { includeGroups: true },\n      );\n    },\n    hitTestLasso(polygon, mode: LassoHitMode, view?: RegionPickView) {\n      return hitTestLassoPolygon(\n        scene,\n        polygon,\n        mode,\n        pickOptsFor(view),\n        d as PoseDescriptor<unknown>,\n        { includeGroups: true },\n      );\n    },\n    // A pure factory: it constructs a Node spec but does NOT touch the scene.\n    // The `InsertOp` → `adapter.insertNode` → `scene.add` path is the sole\n    // insertion path. Calling `scene.add` here too would double-insert, and\n    // the second add throws on id collision.\n    ...(options.commitInsert\n      ? {\n          commitInsert: (bounds: { x: number; y: number; width: number; height: number }) => {\n            const created = options.commitInsert!(bounds);\n            if (!created) return null;\n            const layer = (options.insertLayer ?? ('default' as TLayer));\n            const id = created.id === undefined ? scene.mintId() : asNodeId(created.id);\n            return {\n              kind: 'mark',\n              id,\n              layer,\n              pose: created.pose,\n              data: created.data,\n              parent: null,\n            } as Node<TData, TLayer, TPose>;\n          },\n        }\n      : {}),\n    // Clipboard seam (`useClipboardOps` / the paste ingestion path).\n    snapshotSelection(ids: string[]): ClipboardSnapshot {\n      return snapshotSceneSelection(clipboardEnv, ids);\n    },\n    commitPaste(\n      clipboard: ClipboardSnapshot,\n      offset: { dx: number; dy: number },\n      ctx?: PasteCtx,\n    ): Node<TData, TLayer, TPose>[] {\n      return pasteSceneSnapshot(clipboardEnv, clipboard, offset, ctx);\n    },\n    // Constant cascade: the hook re-snapshots the just-created items, so\n    // repeated pastes stack +12/+12 each time.\n    getPasteOffset(): { dx: number; dy: number } {\n      return { dx: 12, dy: 12 };\n    },\n  };\n\n  return adapter;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sceneAdapter.js","names":[],"sources":["../../src/canvas/sceneAdapter.ts"],"sourcesContent":["/**\n * Synthesize a `<Canvas>`-compatible adapter from a `Scene` primitive.\n * `getPose` / `setPose` return / write **local** coordinates (relative to\n * parent); world composition is the renderer's job via `composeWorldPose`.\n */\nimport type {\n  AreaSelectAdapter,\n  ClipboardSnapshot,\n  InsertAdapter,\n  PasteCtx,\n  LassoHitMode,\n  LassoSelectAdapter,\n  RegionPickView,\n  LayerEnumerableAdapter,\n  MoveAdapter,\n  ResizeAdapter,\n  RotateAdapter,\n} from 'core/adapters/types';\nimport type { LayoutStrategy } from '../layout/types';\nimport type { Op } from 'core/ops/types';\nimport type { Node, Scene } from 'core/scene/types';\nimport { definesFrame, effectivePose } from 'core/scene/effectivePose';\nimport { sceneMutators } from 'core/scene/sceneMutators';\nimport { asNodeId } from 'core/scene/types';\nimport { nodeGates } from 'core/scene/nodeGates';\nimport { applyOpsTo } from 'core/applyOps';\nimport { hitTestArea, hitTestLassoPolygon, regionPickOptions } from 'canvas/deps/hitTestArea';\nimport type { ScenePickSourceOptions } from 'canvas/pickWalk';\nimport {\n  poseDescriptorForNode,\n  translatePoseViaDescriptor,\n  visualBoundsViaDescriptor,\n  type PoseDescriptor,\n} from 'interactions/actions/resize/geometry';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { composeChildFrame, composesFrames, composeWorldPose, frameAtOrAbove, type PoseAdapter } from 'core/scene/composePose';\nimport { memoizeCompose } from 'core/scene/composeFrame';\nimport { scrolledFrames } from 'core/scene/scrollOffsets';\nimport { insertSite } from './deps/insertSite';\nimport type { Bounds } from '../core/viewport/fitViewToBounds';\nimport { scenePoseTarget } from '../animation/poseTarget';\nimport { pasteSceneSnapshot, snapshotSceneSelection, type SceneClipboardEnv } from './sceneClipboard';\n\n/** A scene adapter's pose reads: the stored pose, the world pose, and the fold between them. */\nfunction scenePoseReads<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>) {\n  const composes = composesFrames(scene.composition);\n  const compose = memoizeCompose(scene.composition.compose);\n  const childFrame = composes ? scrolledFrames(scene) : undefined;\n  const reads: PoseAdapter<TPose> & { definesFrame(id: string): boolean } = {\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    getPose(id) {\n      const n = scene.get(asNodeId(id));\n      if (!n) throw new Error(`sceneToAdapter: unknown node \"${id}\"`);\n      return effectivePose(scene, n);\n    },\n    definesFrame(id) {\n      const n = scene.get(asNodeId(id));\n      return n === undefined || definesFrame(n);\n    },\n    ...(childFrame ? { childFrame } : {}),\n  };\n  return {\n    getPose: reads.getPose,\n    definesFrame: reads.definesFrame,\n    getWorldPose: (id: string): TPose => (composes ? composeWorldPose(reads, id, compose) : reads.getPose(id)),\n    worldOfStored(id: string, stored: TPose): TPose {\n      const frame = composes ? frameAtOrAbove(reads, reads.getParent(id)) : null;\n      return frame === null ? stored : compose(composeChildFrame(reads, frame, compose), stored);\n    },\n    // Only present when it would do something: the render walk skips the fold\n    // entirely when this is absent, which is the absolute-pose path.\n    ...(composes ? { composePose: compose } : {}),\n    ...(childFrame ? { childFrame } : {}),\n  };\n}\n\n/** Minimal selection contract `sceneToAdapter` needs to wire `getSelection` /\n *  `setSelection`. Matches `useSelection().adapterMethods` plus an imperative\n *  read; pass `useSelection()` itself or `selection.adapterMethods`. */\nexport interface SceneAdapterSelection {\n  get?(): string[];\n  set?(ids: string[]): void;\n  getSelection?(): string[];\n  setSelection?(ids: string[]): void;\n}\n\n/** Sibling z-order surface used by reorder ops. Inlined here (rather than\n *  pulled from `core/ops/reorder` to avoid import cycles); the `null` parent\n *  channel addresses the root sibling list. */\n/** @internal */\ninterface ReorderAdapter {\n  getChildren(parentId: string | null): string[];\n  setChildOrder(parentId: string | null, ids: string[]): void;\n}\n\n/** Everything the interaction layer can ask of a scene, as one type: the\n *  move, resize, rotate, selection, layer and reorder contracts combined.\n *  `<SceneCanvas>` synthesizes one of these, which is why most consumers never\n *  touch an adapter directly. */\nexport type SceneCanvasAdapter<TData, TLayer extends string, TPose> =\n  & MoveAdapter<Node<TData, TLayer, TPose>, TPose>\n  & ResizeAdapter<Node<TData, TLayer, TPose>, TPose>\n  & RotateAdapter<Node<TData, TLayer, TPose>, TPose>\n  & AreaSelectAdapter\n  & LassoSelectAdapter\n  & LayerEnumerableAdapter<TLayer>\n  & ReorderAdapter\n  & Partial<InsertAdapter<Node<TData, TLayer, TPose>>>\n  // Optional on the underlying adapter contracts, but unconditionally\n  // provided by a scene-backed adapter.\n  & {\n      getParent(id: string): string | null;\n      getLayers: NonNullable<LayerEnumerableAdapter<TLayer>['getLayers']>;\n      /** The node's pose with every ancestor's frame folded in. Equal to\n       *  `getPose` unless the scene composes poses. */\n      getWorldPose(id: string): TPose;\n      /** Where `id` is drawn if it stores `stored`: `stored` folded into the\n       *  frame of its parent's world pose. */\n      worldOfStored(id: string, stored: TPose): TPose;\n      /** Whether `id`'s pose is a frame its children are expressed in — see\n       *  `definesFrame`. */\n      definesFrame(id: string): boolean;\n      /** Present only when a composing strategy is configured; the render\n       *  walk feature-detects it. */\n      composePose?(parent: TPose, child: TPose): TPose;\n      /** The frame a container gives its children, scrolled by the scene's\n       *  `scroll` offset — see `PoseAdapter.childFrame`. Present only when the\n       *  composition can scroll. */\n      childFrame?(id: string, world: TPose): TPose;\n      getSelection(): string[];\n      setSelection(ids: string[]): void;\n      insertNode(node: Node<TData, TLayer, TPose>, index?: number): void;\n      removeNode(id: string): void;\n      /** Replace a node's `data` — what a `setData` op writes through. */\n      setData(id: string, data: TData): void;\n      /** Swap a container's layout — what a `setLayout` op writes through. */\n      setLayout(id: string, layout: LayoutStrategy<TPose> | string | null): void;\n      /** Move a node to another layer — what a `setLayer` op writes through. */\n      setLayer(id: string, layer: TLayer): void;\n      /** Retarget a derived node's sources — what a `setDependsOn` op writes through. */\n      setDependsOn(id: string, dependsOn: readonly string[] | 'children' | undefined): void;\n      /** Hide or show a node — what a `setHidden` op writes through. */\n      setHidden(id: string, hidden: boolean): void;\n      /** Lock or unlock a node — what a `setLocked` op writes through. */\n      setLocked(id: string, locked: boolean): void;\n      getRemovalClosure(ids: readonly string[]): string[];\n      applyOps(ops: Op[], label?: string): void;\n      snapshotSelection(ids: string[]): ClipboardSnapshot;\n      commitPaste(\n        clipboard: ClipboardSnapshot,\n        offset: { dx: number; dy: number },\n        ctx?: PasteCtx,\n      ): Node<TData, TLayer, TPose>[];\n      getPasteOffset(clipboard: ClipboardSnapshot): { dx: number; dy: number };\n    };\n\n/** Optional extras for the synthesized adapter. Pass `commitInsert` to wire\n *  the insert gesture into a Scene-owned canvas; the returned object becomes\n *  a leaf on the layer named by `layer` (default `'default'`). */\nexport interface SceneToAdapterOptions<TData, TLayer extends string, TPose> {\n  /** Factory for new objects. Returning `null` aborts the insert. */\n  commitInsert?: (bounds: Bounds) => {\n    pose: TPose;\n    data: TData;\n    id?: string;\n  } | null;\n  /** Layer to place inserted nodes on. Defaults to the trivial-form layer. */\n  insertLayer?: TLayer;\n  /** Selection source: the result of `useSelection()` (or its\n   *  `adapterMethods`). When omitted, `getSelection` returns `[]` and\n   *  `setSelection` is a noop, so the marquee gesture updates nothing. */\n  selection?: SceneAdapterSelection;\n  /** How to read and rewrite this scene's poses. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<TPose>;\n  /** The container a paste lands in, read at each paste: `<SceneCanvas>` passes the `insertInto` dep's. */\n  pasteInto?: () => string | null;\n}\n\n/** Derive the adapter for a scene. Reads go straight to the scene; writes are\n *  ops applied through its history, so anything done through the adapter is\n *  undoable. A container's pose is a frame its children are stored in, so the\n *  one pose written moves its contents. */\nexport function sceneToAdapter<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  options: SceneToAdapterOptions<TData, TLayer, TPose> = {},\n): SceneCanvasAdapter<TData, TLayer, TPose> {\n  const sel = options.selection;\n  const getSelection = sel?.getSelection ?? sel?.get ?? (() => [] as string[]);\n  const setSelection = sel?.setSelection ?? sel?.set ?? (() => {});\n  const d = (options.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const poseBounds = (p: TPose, node: unknown): Bounds =>\n    visualBoundsViaDescriptor(p, poseDescriptorForNode(d, node));\n  const translate = (p: TPose, dx: number, dy: number, node?: unknown): TPose =>\n    translatePoseViaDescriptor(p, dx, dy, node === undefined ? d : poseDescriptorForNode(d, node));\n\n  const pickOpts: ScenePickSourceOptions<unknown> = {};\n  // The asking view's layer gate and camera, over the adapter's own options.\n  const pickOptsFor = (view: RegionPickView | undefined): ScenePickSourceOptions<unknown> =>\n    (view ? { ...pickOpts, ...regionPickOptions(view, undefined) } : pickOpts);\n\n  const clipboardEnv: SceneClipboardEnv<TData, TLayer, TPose> = {\n    scene,\n    worldPoseOf: (id) => adapter.getWorldPose(id),\n    frameAtOrAbove: (id) => frameAtOrAbove(adapter, id),\n    poseBounds,\n    translate, ...(options.pasteInto ? { landing: () => insertSite(scene as never, options.pasteInto!()) } : {}),\n  };\n\n  const adapter: SceneCanvasAdapter<TData, TLayer, TPose> = {\n    ...sceneMutators(scene),\n    // What is shown, where the mutators' other users read the document:\n    // the nodes not hidden, and the effective pose.\n    getNodes() {\n      const gates = nodeGates(scene);\n      return scene.renderOrderNodes().filter((n) => !gates.hidden(n.id));\n    },\n    ...scenePoseReads(scene),\n    poseTarget: (id, descriptor) => scenePoseTarget(scene, id, descriptor ?? d),\n    getLayers: () => scene.layers.map((l) => ({ id: l.id, visible: l.visible, parallax: l.parallax })),\n    subscribeLayers: (listener) => scene.subscribe(listener),\n    getLayout: (id) => scene.layoutOf(asNodeId(id)),\n    // With a label the ops are one batch checkpoint; without one they are\n    // applied transiently, with no checkpoint (the AreaSelectAdapter contract).\n    applyOps(ops: Op[], label?: string) {\n      if (label !== undefined) {\n        scene.applyBatch(ops, label, this);\n      } else {\n        applyOpsTo(this, ops);\n      }\n    },\n    getSelection,\n    setSelection,\n    // The live marquee's and lasso's own hit-tests. Groups come back:\n    // this adapter's consumer has nothing to fold children into them.\n    hitTestArea(rect: Bounds, view?: RegionPickView) {\n      return hitTestArea(\n        scene,\n        rect,\n        pickOptsFor(view),\n        d as PoseDescriptor<unknown>,\n        { includeGroups: true },\n      );\n    },\n    hitTestLasso(polygon, mode: LassoHitMode, view?: RegionPickView) {\n      return hitTestLassoPolygon(\n        scene,\n        polygon,\n        mode,\n        pickOptsFor(view),\n        d as PoseDescriptor<unknown>,\n        { includeGroups: true },\n      );\n    },\n    // A pure factory: it constructs a Node spec but does NOT touch the scene.\n    // The `InsertOp` → `adapter.insertNode` → `scene.add` path is the sole\n    // insertion path. Calling `scene.add` here too would double-insert, and\n    // the second add throws on id collision.\n    ...(options.commitInsert\n      ? {\n          commitInsert: (bounds: { x: number; y: number; width: number; height: number }) => {\n            const created = options.commitInsert!(bounds);\n            if (!created) return null;\n            const layer = (options.insertLayer ?? ('default' as TLayer));\n            const id = created.id === undefined ? scene.mintId() : asNodeId(created.id);\n            return {\n              kind: 'mark',\n              id,\n              layer,\n              pose: created.pose,\n              data: created.data,\n              parent: null,\n            } as Node<TData, TLayer, TPose>;\n          },\n        }\n      : {}),\n    // Clipboard seam (`useClipboardOps` / the paste ingestion path).\n    snapshotSelection(ids: string[]): ClipboardSnapshot {\n      return snapshotSceneSelection(clipboardEnv, ids);\n    },\n    commitPaste(\n      clipboard: ClipboardSnapshot,\n      offset: { dx: number; dy: number },\n      ctx?: PasteCtx,\n    ): Node<TData, TLayer, TPose>[] {\n      return pasteSceneSnapshot(clipboardEnv, clipboard, offset, ctx);\n    },\n    // Constant cascade: the hook re-snapshots the just-created items, so\n    // repeated pastes stack +12/+12 each time.\n    getPasteOffset(): { dx: number; dy: number } {\n      return { dx: 12, dy: 12 };\n    },\n  };\n\n  return adapter;\n}\n"],"mappings":"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"}

package/dist/canvas/sceneClipboard.js

@@ -1,11 +1,24 @@
+import { asNodeId } from "../core/scene/types.js";
+import { hasChildren } from "../core/scene/treeShape.js";
 import { sourcesOf } from "../core/scene/dependents.js";
 import { definesFrame } from "../core/scene/effectivePose.js";
-import { asNodeId } from "../core/scene/types.js";
 import { NODE_FN_FIELDS, createNodeFnFields, fnFieldsOfNode, fnKeysOf } from "../core/scene/nodeFnFields.js";
 import { statedFields } from "../core/scene/statedFields.js";
-import { hasChildren } from "../core/scene/treeShape.js";
+import { holderOf, outermost } from "@weasel-js/select";
 
-//#region src/canvas/sceneClipboard.ts
+// src/canvas/sceneClipboard.ts
+/**
+* The scene adapter's clipboard seam: what a copy captures and what a paste
+* mints from it.
+*
+* `pasteSceneSnapshot` is a pure factory — it mints fresh nodes and never
+* touches the scene. Insertion happens through the caller's InsertOps (one per
+* created node, parents before children).
+*
+* A snapshot item carries its node's function fields twice: live, for a paste
+* in the same session, and as the scene's registry keys, for a snapshot that
+* crossed JSON on the way back.
+*/
 function copyField(value) {
 	if (Array.isArray(value)) return [...value];
 	if (value !== null && typeof value === "object") return { ...value };
@@ -42,7 +55,8 @@ function snapshotSceneSelection(env, ids) {
 		});
 		if (hasChildren(n)) for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);
 	};
-	const covered = (id) => idSet.has(id) || scene.ancestorsOf(asNodeId(id)).some((a) => idSet.has(a));
+	const parentOf = (id) => scene.get(asNodeId(id))?.parent;
+	const covered = (id) => holderOf(idSet, id, parentOf) !== null;
 	const carrying = /* @__PURE__ */ new Set();
 	const carrySources = (id) => {
 		if (carrying.has(id)) return;
@@ -56,8 +70,7 @@ function snapshotSceneSelection(env, ids) {
 		}
 		if (hasChildren(n)) for (const cid of scene.childrenOf(asNodeId(id))) carrySources(cid);
 	};
-	for (const id of ids) {
-		if (scene.ancestorsOf(asNodeId(id)).some((a) => idSet.has(a))) continue;
+	for (const id of outermost(ids, parentOf)) {
 		carrySources(id);
 		capture(id, true);
 	}
@@ -176,6 +189,5 @@ function pasteSceneSnapshot(env, clipboard, offset, ctx) {
 	}));
 }
 
-//#endregion
 export { pasteSceneSnapshot, snapshotSceneSelection };
 //# sourceMappingURL=sceneClipboard.js.map

package/dist/canvas/sceneClipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneClipboard.js","names":[],"sources":["../../src/canvas/sceneClipboard.ts"],"sourcesContent":["/**\n * The scene adapter's clipboard seam: what a copy captures and what a paste\n * mints from it.\n *\n * `pasteSceneSnapshot` is a pure factory — it mints fresh nodes and never\n * touches the scene. Insertion happens through the caller's InsertOps (one per\n * created node, parents before children).\n *\n * A snapshot item carries its node's function fields twice: live, for a paste\n * in the same session, and as the scene's registry keys, for a snapshot that\n * crossed JSON on the way back.\n */\nimport type { ClipboardSnapshot, PasteCtx, PasteOmission } from 'core/adapters/types';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport { hasChildren } from 'core/scene/treeShape';\nimport { sourcesOf } from 'core/scene/dependents';\nimport { definesFrame } from 'core/scene/effectivePose';\nimport {\n  NODE_FN_FIELDS, createNodeFnFields, fnFieldsOfNode, fnKeysOf, type FnBearingNode,\n} from 'core/scene/nodeFnFields';\nimport { statedFields } from 'core/scene/statedFields';\nimport type { Bounds } from '../core/viewport/fitViewToBounds';\nimport type { InsertSite } from './deps/insertSite';\n\n/** What the seam needs from the adapter it serves. */\nexport interface SceneClipboardEnv<TData, TLayer extends string, TPose> {\n  scene: Scene<TData, TLayer, TPose>;\n  worldPoseOf(id: string): TPose;\n  /** The nearest frame-defining container at or above `id`. */\n  frameAtOrAbove(id: string | null): string | null;\n  poseBounds(pose: TPose, node: unknown): Bounds;\n  translate(pose: TPose, dx: number, dy: number, node?: unknown): TPose;\n  /** Where the pasted cluster's roots land; absent, or naming no parent, they keep their layer at the top of the tree. */\n  landing?: () => InsertSite;\n}\n\n// Spread-level copy per the clipboard contract: mutating a snapshot's\n// pose/data/children must not touch the scene.\nfunction copyField<T>(value: T): T {\n  if (Array.isArray(value)) return [...value] as T;\n  if (value !== null && typeof value === 'object') return { ...(value as object) } as T;\n  return value;\n}\n\ntype Item<TData, TLayer extends string, TPose> =\n  Node<TData, TLayer, TPose> & Record<string, unknown>;\n\nexport function snapshotSceneSelection<TData, TLayer extends string, TPose>(\n  env: SceneClipboardEnv<TData, TLayer, TPose>,\n  ids: string[],\n): ClipboardSnapshot {\n  const { scene } = env;\n  const fnFields = createNodeFnFields<TPose>(scene.registry as never);\n  const idSet = new Set(ids);\n  const taken = new Set<string>();\n  const items: Node<TData, TLayer, TPose>[] = [];\n  // A stored pose is relative to its frame, and a node whose frame is not\n  // copied with it lands somewhere else entirely on paste. Capture those in\n  // world coordinates: every root, and under an envelope root, the nodes\n  // sharing the frame the root left behind.\n  const poseFor = (n: Node<TData, TLayer, TPose>, isRoot: boolean): TPose => {\n    if (isRoot) return env.worldPoseOf(n.id);\n    const frame = env.frameAtOrAbove(n.parent);\n    return frame !== null && taken.has(frame) ? n.pose : env.worldPoseOf(n.id);\n  };\n\n  // DFS from one snapshot root: push the node, then its subtree —\n  // parents-before-children, so paste can re-insert in array order.\n  const capture = (id: string, isRoot = false): void => {\n    if (taken.has(id)) return;\n    const n = scene.get(asNodeId(id));\n    if (!n) return;\n    taken.add(id);\n    items.push({\n      kind: n.kind,\n      id: n.id,\n      layer: n.layer,\n      parent: n.parent,\n      pose: copyField(poseFor(n, isRoot)),\n      data: copyField(n.data),\n      ...(n.children !== undefined ? { children: [...n.children] } : {}),\n      ...statedFields(n),\n      ...(n.dependsOn !== undefined ? { dependsOn: copyField(n.dependsOn) } : {}),\n      ...fnFieldsOfNode(n),\n      ...fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey'),\n    } as Node<TData, TLayer, TPose>);\n    if (hasChildren(n)) {\n      for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);\n    }\n  };\n  const covered = (id: string): boolean =>\n    idSet.has(id) || scene.ancestorsOf(asNodeId(id)).some((a) => idSet.has(a));\n  // A hidden node cannot be selected, so one that a copied node derives from\n  // comes with it, ahead of it: without it the paste would leave the copy out.\n  const carrying = new Set<string>();\n  const carrySources = (id: string): void => {\n    if (carrying.has(id)) return;\n    carrying.add(id);\n    const n = scene.get(asNodeId(id));\n    if (!n) return;\n    for (const source of sourcesOf(n)) {\n      if (taken.has(source) || covered(source) || scene.get(source)?.hidden !== true) continue;\n      carrySources(source);\n      capture(source, true);\n    }\n    if (hasChildren(n)) for (const cid of scene.childrenOf(asNodeId(id))) carrySources(cid);\n  };\n  for (const id of ids) {\n    // Dedupe: an id whose ancestor is also selected is already covered\n    // by that ancestor's subtree walk.\n    if (scene.ancestorsOf(asNodeId(id)).some((a) => idSet.has(a))) continue;\n    carrySources(id);\n    capture(id, true);\n  }\n  return { items };\n}\n\n// JSON drops a function, and turns a layout strategy into an object with no\n// methods on it: neither is something a pasted node can run.\nconst isLive = (value: unknown): boolean =>\n  typeof value === 'function'\n  || (typeof value === 'object' && value !== null\n    && Object.values(value).some((member) => typeof member === 'function'));\n\n/**\n * The item's function fields: for each, what its registry key names in this\n * scene, else the live one it carries, else nothing.\n */\nfunction restoredFnFields<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  item: Item<TData, TLayer, TPose>,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  const registry = scene.registry as Record<string, Record<string, unknown> | undefined>;\n  for (const spec of NODE_FN_FIELDS) {\n    const key = item[spec.jsonKey];\n    const registered = typeof key === 'string' ? registry[spec.field]?.[key] : undefined;\n    const fn = registered ?? (isLive(item[spec.field]) ? item[spec.field] : undefined);\n    if (fn !== undefined) out[spec.field] = fn;\n  }\n  return out;\n}\n\n/**\n * Which items a paste leaves out, and why. A node deriving from an id list is\n * pasted only with everything it depends on, since a copy still naming the\n * originals would follow them rather than the copies beside it; and only with\n * a derivation to run, since without one it is a placeholder that paints\n * nothing. Leaving one out can strand another, so this runs to a fixed point.\n */\nfunction omissions<TData, TLayer extends string, TPose>(\n  src: readonly Item<TData, TLayer, TPose>[],\n  fns: ReadonlyMap<string, Record<string, unknown>>,\n): Map<string, PasteOmission> {\n  const out = new Map<string, PasteOmission>();\n  const present = new Set(src.map((item) => item.id as string));\n  for (let changed = true; changed;) {\n    changed = false;\n    for (const item of src) {\n      if (out.has(item.id)) continue;\n      let omission: PasteOmission | undefined;\n      const deps = sourcesOf(item);\n      const missing = deps.filter((dep) => !present.has(dep));\n      const fn = fns.get(item.id)!;\n      if (item.parent !== null && out.has(item.parent)) {\n        omission = { id: item.id, reason: 'container-not-pasted' };\n      } else if (missing.length > 0) {\n        omission = { id: item.id, reason: 'dependency-not-copied', missing };\n      } else if (deps.length > 0 && fn.derivePath === undefined && fn.derivePose === undefined) {\n        omission = { id: item.id, reason: 'derivation-not-registered' };\n      }\n      if (omission === undefined) continue;\n      out.set(item.id, omission);\n      present.delete(item.id);\n      changed = true;\n    }\n  }\n  return out;\n}\n\nexport function pasteSceneSnapshot<TData, TLayer extends string, TPose>(\n  env: SceneClipboardEnv<TData, TLayer, TPose>,\n  clipboard: ClipboardSnapshot,\n  offset: { dx: number; dy: number },\n  ctx?: PasteCtx,\n): Node<TData, TLayer, TPose>[] {\n  const all = clipboard.items as Item<TData, TLayer, TPose>[];\n  if (all.length === 0) return [];\n  const fns = new Map(all.map((item) => [item.id as string, restoredFnFields(env.scene, item)]));\n  const omitted = omissions(all, fns);\n  if (ctx?.onOmit) for (const item of all) {\n    const omission = omitted.get(item.id);\n    if (omission) ctx.onOmit(omission);\n  }\n  const src = omitted.size === 0 ? all : all.filter((item) => !omitted.has(item.id));\n\n  const idMap = new Map<string, NodeId>();\n  for (const item of src) idMap.set(item.id, env.scene.mintId());\n  // Items whose captured parent isn't part of the snapshot become roots\n  // of the pasted cluster.\n  const isRoot = (item: Node<TData, TLayer, TPose>): boolean =>\n    item.parent === null || !idMap.has(item.parent);\n  // A node inside a pasted frame rides it, and offsetting it as well would\n  // move it twice.\n  const byId = new Map(src.map((item) => [item.id as string, item]));\n  const ridesPastedFrame = (item: Node<TData, TLayer, TPose>): boolean => {\n    let p = item.parent === null ? undefined : byId.get(item.parent);\n    while (p !== undefined) {\n      if (definesFrame(p)) return true;\n      p = p.parent === null ? undefined : byId.get(p.parent);\n    }\n    return false;\n  };\n  let dx = offset.dx;\n  let dy = offset.dy;\n  if (ctx?.dropPoint) {\n    // Drop-point policy: land the cluster origin (min corner of the root\n    // items' bounds) on the drop point; `offset` is ignored.\n    let minX = Infinity;\n    let minY = Infinity;\n    for (const item of src) {\n      if (!isRoot(item)) continue;\n      const b = env.poseBounds(item.pose, item);\n      if (b.x < minX) minX = b.x;\n      if (b.y < minY) minY = b.y;\n    }\n    if (Number.isFinite(minX) && Number.isFinite(minY)) {\n      dx = ctx.dropPoint.x - minX;\n      dy = ctx.dropPoint.y - minY;\n    }\n  }\n  const site = env.landing?.();\n  const into = site?.parent != null ? site : null;\n  const placed = (item: Item<TData, TLayer, TPose>): TPose => {\n    if (ridesPastedFrame(item)) return copyField(item.pose);\n    const moved = env.translate(copyField(item.pose), dx, dy, item);\n    return into && isRoot(item) ? into.local(moved) as TPose : moved;\n  };\n  // `src` is parents-before-children and this keeps it, so children re-attach\n  // to freshly inserted parents when the caller's InsertOps apply in order.\n  return src.map((item) => ({\n    id: idMap.get(item.id)!,\n    kind: item.kind,\n    layer: into && isRoot(item) ? into.layer as TLayer : item.layer,\n    parent: isRoot(item) ? into?.parent ?? null : idMap.get(item.parent as string)!,\n    pose: placed(item),\n    data: copyField(item.data),\n    ...statedFields(item),\n    ...(item.children !== undefined\n      ? { children: item.children.filter((c) => idMap.has(c)).map((c) => idMap.get(c)!) }\n      : {}),\n    ...(item.dependsOn === 'children'\n      ? { dependsOn: 'children' as const }\n      : sourcesOf(item).length > 0\n        ? { dependsOn: sourcesOf(item).map((dep) => idMap.get(dep)!) }\n        : {}),\n    ...fns.get(item.id),\n  } as Node<TData, TLayer, TPose>));\n}\n"],"mappings":"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"}
+{"version":3,"file":"sceneClipboard.js","names":[],"sources":["../../src/canvas/sceneClipboard.ts"],"sourcesContent":["/**\n * The scene adapter's clipboard seam: what a copy captures and what a paste\n * mints from it.\n *\n * `pasteSceneSnapshot` is a pure factory — it mints fresh nodes and never\n * touches the scene. Insertion happens through the caller's InsertOps (one per\n * created node, parents before children).\n *\n * A snapshot item carries its node's function fields twice: live, for a paste\n * in the same session, and as the scene's registry keys, for a snapshot that\n * crossed JSON on the way back.\n */\nimport { holderOf, outermost } from '@weasel-js/select';\nimport type { ClipboardSnapshot, PasteCtx, PasteOmission } from 'core/adapters/types';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport { hasChildren } from 'core/scene/treeShape';\nimport { sourcesOf } from 'core/scene/dependents';\nimport { definesFrame } from 'core/scene/effectivePose';\nimport {\n  NODE_FN_FIELDS, createNodeFnFields, fnFieldsOfNode, fnKeysOf, type FnBearingNode,\n} from 'core/scene/nodeFnFields';\nimport { statedFields } from 'core/scene/statedFields';\nimport type { Bounds } from '../core/viewport/fitViewToBounds';\nimport type { InsertSite } from './deps/insertSite';\n\n/** What the seam needs from the adapter it serves. */\nexport interface SceneClipboardEnv<TData, TLayer extends string, TPose> {\n  scene: Scene<TData, TLayer, TPose>;\n  worldPoseOf(id: string): TPose;\n  /** The nearest frame-defining container at or above `id`. */\n  frameAtOrAbove(id: string | null): string | null;\n  poseBounds(pose: TPose, node: unknown): Bounds;\n  translate(pose: TPose, dx: number, dy: number, node?: unknown): TPose;\n  /** Where the pasted cluster's roots land; absent, or naming no parent, they keep their layer at the top of the tree. */\n  landing?: () => InsertSite;\n}\n\n// Spread-level copy per the clipboard contract: mutating a snapshot's\n// pose/data/children must not touch the scene.\nfunction copyField<T>(value: T): T {\n  if (Array.isArray(value)) return [...value] as T;\n  if (value !== null && typeof value === 'object') return { ...(value as object) } as T;\n  return value;\n}\n\ntype Item<TData, TLayer extends string, TPose> =\n  Node<TData, TLayer, TPose> & Record<string, unknown>;\n\nexport function snapshotSceneSelection<TData, TLayer extends string, TPose>(\n  env: SceneClipboardEnv<TData, TLayer, TPose>,\n  ids: string[],\n): ClipboardSnapshot {\n  const { scene } = env;\n  const fnFields = createNodeFnFields<TPose>(scene.registry as never);\n  const idSet = new Set(ids);\n  const taken = new Set<string>();\n  const items: Node<TData, TLayer, TPose>[] = [];\n  // A stored pose is relative to its frame, and a node whose frame is not\n  // copied with it lands somewhere else entirely on paste. Capture those in\n  // world coordinates: every root, and under an envelope root, the nodes\n  // sharing the frame the root left behind.\n  const poseFor = (n: Node<TData, TLayer, TPose>, isRoot: boolean): TPose => {\n    if (isRoot) return env.worldPoseOf(n.id);\n    const frame = env.frameAtOrAbove(n.parent);\n    return frame !== null && taken.has(frame) ? n.pose : env.worldPoseOf(n.id);\n  };\n\n  // DFS from one snapshot root: push the node, then its subtree —\n  // parents-before-children, so paste can re-insert in array order.\n  const capture = (id: string, isRoot = false): void => {\n    if (taken.has(id)) return;\n    const n = scene.get(asNodeId(id));\n    if (!n) return;\n    taken.add(id);\n    items.push({\n      kind: n.kind,\n      id: n.id,\n      layer: n.layer,\n      parent: n.parent,\n      pose: copyField(poseFor(n, isRoot)),\n      data: copyField(n.data),\n      ...(n.children !== undefined ? { children: [...n.children] } : {}),\n      ...statedFields(n),\n      ...(n.dependsOn !== undefined ? { dependsOn: copyField(n.dependsOn) } : {}),\n      ...fnFieldsOfNode(n),\n      ...fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey'),\n    } as Node<TData, TLayer, TPose>);\n    if (hasChildren(n)) {\n      for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);\n    }\n  };\n  const parentOf = (id: string) => scene.get(asNodeId(id))?.parent;\n  const covered = (id: string): boolean => holderOf(idSet, id, parentOf) !== null;\n  // A hidden node cannot be selected, so one that a copied node derives from\n  // comes with it, ahead of it: without it the paste would leave the copy out.\n  const carrying = new Set<string>();\n  const carrySources = (id: string): void => {\n    if (carrying.has(id)) return;\n    carrying.add(id);\n    const n = scene.get(asNodeId(id));\n    if (!n) return;\n    for (const source of sourcesOf(n)) {\n      if (taken.has(source) || covered(source) || scene.get(source)?.hidden !== true) continue;\n      carrySources(source);\n      capture(source, true);\n    }\n    if (hasChildren(n)) for (const cid of scene.childrenOf(asNodeId(id))) carrySources(cid);\n  };\n  // An id an ancestor holds comes with that ancestor's subtree walk.\n  for (const id of outermost(ids, parentOf)) {\n    carrySources(id);\n    capture(id, true);\n  }\n  return { items };\n}\n\n// JSON drops a function, and turns a layout strategy into an object with no\n// methods on it: neither is something a pasted node can run.\nconst isLive = (value: unknown): boolean =>\n  typeof value === 'function'\n  || (typeof value === 'object' && value !== null\n    && Object.values(value).some((member) => typeof member === 'function'));\n\n/**\n * The item's function fields: for each, what its registry key names in this\n * scene, else the live one it carries, else nothing.\n */\nfunction restoredFnFields<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  item: Item<TData, TLayer, TPose>,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  const registry = scene.registry as Record<string, Record<string, unknown> | undefined>;\n  for (const spec of NODE_FN_FIELDS) {\n    const key = item[spec.jsonKey];\n    const registered = typeof key === 'string' ? registry[spec.field]?.[key] : undefined;\n    const fn = registered ?? (isLive(item[spec.field]) ? item[spec.field] : undefined);\n    if (fn !== undefined) out[spec.field] = fn;\n  }\n  return out;\n}\n\n/**\n * Which items a paste leaves out, and why. A node deriving from an id list is\n * pasted only with everything it depends on, since a copy still naming the\n * originals would follow them rather than the copies beside it; and only with\n * a derivation to run, since without one it is a placeholder that paints\n * nothing. Leaving one out can strand another, so this runs to a fixed point.\n */\nfunction omissions<TData, TLayer extends string, TPose>(\n  src: readonly Item<TData, TLayer, TPose>[],\n  fns: ReadonlyMap<string, Record<string, unknown>>,\n): Map<string, PasteOmission> {\n  const out = new Map<string, PasteOmission>();\n  const present = new Set(src.map((item) => item.id as string));\n  for (let changed = true; changed;) {\n    changed = false;\n    for (const item of src) {\n      if (out.has(item.id)) continue;\n      let omission: PasteOmission | undefined;\n      const deps = sourcesOf(item);\n      const missing = deps.filter((dep) => !present.has(dep));\n      const fn = fns.get(item.id)!;\n      if (item.parent !== null && out.has(item.parent)) {\n        omission = { id: item.id, reason: 'container-not-pasted' };\n      } else if (missing.length > 0) {\n        omission = { id: item.id, reason: 'dependency-not-copied', missing };\n      } else if (deps.length > 0 && fn.derivePath === undefined && fn.derivePose === undefined) {\n        omission = { id: item.id, reason: 'derivation-not-registered' };\n      }\n      if (omission === undefined) continue;\n      out.set(item.id, omission);\n      present.delete(item.id);\n      changed = true;\n    }\n  }\n  return out;\n}\n\nexport function pasteSceneSnapshot<TData, TLayer extends string, TPose>(\n  env: SceneClipboardEnv<TData, TLayer, TPose>,\n  clipboard: ClipboardSnapshot,\n  offset: { dx: number; dy: number },\n  ctx?: PasteCtx,\n): Node<TData, TLayer, TPose>[] {\n  const all = clipboard.items as Item<TData, TLayer, TPose>[];\n  if (all.length === 0) return [];\n  const fns = new Map(all.map((item) => [item.id as string, restoredFnFields(env.scene, item)]));\n  const omitted = omissions(all, fns);\n  if (ctx?.onOmit) for (const item of all) {\n    const omission = omitted.get(item.id);\n    if (omission) ctx.onOmit(omission);\n  }\n  const src = omitted.size === 0 ? all : all.filter((item) => !omitted.has(item.id));\n\n  const idMap = new Map<string, NodeId>();\n  for (const item of src) idMap.set(item.id, env.scene.mintId());\n  // Items whose captured parent isn't part of the snapshot become roots\n  // of the pasted cluster.\n  const isRoot = (item: Node<TData, TLayer, TPose>): boolean =>\n    item.parent === null || !idMap.has(item.parent);\n  // A node inside a pasted frame rides it, and offsetting it as well would\n  // move it twice.\n  const byId = new Map(src.map((item) => [item.id as string, item]));\n  const ridesPastedFrame = (item: Node<TData, TLayer, TPose>): boolean => {\n    let p = item.parent === null ? undefined : byId.get(item.parent);\n    while (p !== undefined) {\n      if (definesFrame(p)) return true;\n      p = p.parent === null ? undefined : byId.get(p.parent);\n    }\n    return false;\n  };\n  let dx = offset.dx;\n  let dy = offset.dy;\n  if (ctx?.dropPoint) {\n    // Drop-point policy: land the cluster origin (min corner of the root\n    // items' bounds) on the drop point; `offset` is ignored.\n    let minX = Infinity;\n    let minY = Infinity;\n    for (const item of src) {\n      if (!isRoot(item)) continue;\n      const b = env.poseBounds(item.pose, item);\n      if (b.x < minX) minX = b.x;\n      if (b.y < minY) minY = b.y;\n    }\n    if (Number.isFinite(minX) && Number.isFinite(minY)) {\n      dx = ctx.dropPoint.x - minX;\n      dy = ctx.dropPoint.y - minY;\n    }\n  }\n  const site = env.landing?.();\n  const into = site?.parent != null ? site : null;\n  const placed = (item: Item<TData, TLayer, TPose>): TPose => {\n    if (ridesPastedFrame(item)) return copyField(item.pose);\n    const moved = env.translate(copyField(item.pose), dx, dy, item);\n    return into && isRoot(item) ? into.local(moved) as TPose : moved;\n  };\n  // `src` is parents-before-children and this keeps it, so children re-attach\n  // to freshly inserted parents when the caller's InsertOps apply in order.\n  return src.map((item) => ({\n    id: idMap.get(item.id)!,\n    kind: item.kind,\n    layer: into && isRoot(item) ? into.layer as TLayer : item.layer,\n    parent: isRoot(item) ? into?.parent ?? null : idMap.get(item.parent as string)!,\n    pose: placed(item),\n    data: copyField(item.data),\n    ...statedFields(item),\n    ...(item.children !== undefined\n      ? { children: item.children.filter((c) => idMap.has(c)).map((c) => idMap.get(c)!) }\n      : {}),\n    ...(item.dependsOn === 'children'\n      ? { dependsOn: 'children' as const }\n      : sourcesOf(item).length > 0\n        ? { dependsOn: sourcesOf(item).map((dep) => idMap.get(dep)!) }\n        : {}),\n    ...fns.get(item.id),\n  } as Node<TData, TLayer, TPose>));\n}\n"],"mappings":"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"}

package/dist/canvas/sceneLayerPaint.js

@@ -1,6 +1,6 @@
 import { paintedLayers } from "../core/layers/render.js";
 
-//#region src/canvas/sceneLayerPaint.ts
+// src/canvas/sceneLayerPaint.ts
 /**
 * Which scene layers a view paints.
 *
@@ -61,6 +61,5 @@ function paintedSceneLayers(layers, view) {
 	return (layerOrder ? layerOrder.map((key) => layers.find((l) => sceneLayerKey(l.id) === key)).filter((l) => l !== void 0) : layers).filter((l) => layerVisibility?.[sceneLayerKey(l.id)] !== false);
 }
 
-//#endregion
 export { createSceneLayerGate, paintedSceneLayers, sceneLayerKey, viewPaintedLayers };
 //# sourceMappingURL=sceneLayerPaint.js.map

package/dist/canvas/scenePickReads.js

@@ -1,7 +1,7 @@
 import { asNodeId } from "../core/scene/types.js";
 import { sceneDerivedPathOf, showsComputedPath } from "./derivedPath.js";
 
-//#region src/canvas/scenePickReads.ts
+// src/canvas/scenePickReads.ts
 /** Shared, never mutated: most scenes are flat and every node returns it. */
 var EMPTY_PARENTS = [];
 /** `(node) => its ancestors, innermost first`, stopping at a cycle or a missing parent. */
@@ -32,6 +32,5 @@ function sceneShownPathOf(scene) {
 	};
 }
 
-//#endregion
 export { sceneParentsOf, sceneShownPathOf };
 //# sourceMappingURL=scenePickReads.js.map