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

package/dist/canvas/poseCascade.js.map

@@ -1 +1 @@
-{"version":3,"file":"poseCascade.js","names":[],"sources":["../../src/canvas/poseCascade.ts"],"sourcesContent":["import { poseDescriptorForNode, translatePoseViaDescriptor, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport type { NodeId } from 'core/scene/types';\nimport type { PoseCascade } from '../animation/poseTarget';\n\n/** The part of a scene a container's cascade reads. */\ninterface CascadeScene<TPose> {\n  get(id: NodeId): { pose: TPose; kind?: 'leaf' | 'container' } | undefined;\n  childrenOf(id: NodeId): readonly NodeId[];\n}\n\n/** The part of a scene a cascading `setPose` writes. */\ninterface CascadeTarget<TPose> extends CascadeScene<TPose> {\n  setPose(id: NodeId, pose: TPose): void;\n  batch<T>(label: string, fn: () => T): T;\n}\n\n/** Every node under `id`, each after its parent. */\nexport function descendantsOf(scene: Pick<CascadeScene<unknown>, 'childrenOf'>, id: NodeId): NodeId[] {\n  const out: NodeId[] = [];\n  const collect = (root: NodeId): void => {\n    for (const child of scene.childrenOf(root)) {\n      out.push(child);\n      collect(child);\n    }\n  };\n  collect(id);\n  return out;\n}\n\n/**\n * How container `id`'s pose target carries its descendants where each holds a pose of its own\n * in the same space: `write` commits a pose and moves them, and while the container shows\n * somewhere else each is shown moved by as much.\n */\nexport function containerCascade<TPose>(\n  scene: CascadeScene<TPose>,\n  id: NodeId,\n  d: PoseDescriptor<TPose>,\n  write: (pose: TPose) => void,\n): PoseCascade<TPose> {\n  return {\n    write,\n    *beside(pose) {\n      const node = scene.get(id);\n      if (!node) return;\n      const g = poseDescriptorForNode(d, node);\n      const from = g.getBounds(node.pose);\n      const to = g.getBounds(pose);\n      for (const child of descendantsOf(scene, id)) {\n        const n = scene.get(child);\n        if (!n) continue;\n        yield [child, translatePoseViaDescriptor(n.pose, to.x - from.x, to.y - from.y, poseDescriptorForNode(d, n))];\n      }\n    },\n  };\n}\n\n/**\n * `setPose` for a scene of absolute poses: posing a container moves every\n * descendant by as much, in one undo step.\n */\nexport function cascadingSetPose<TPose>(\n  scene: CascadeTarget<TPose>,\n  d: PoseDescriptor<TPose>,\n): (id: NodeId, pose: TPose) => void {\n  return (id, pose) => {\n    const node = scene.get(id);\n    if (!node || node.kind !== 'container') return scene.setPose(id, pose);\n    const g = poseDescriptorForNode(d, node);\n    const from = g.getBounds(node.pose);\n    const to = g.getBounds(pose);\n    const dx = to.x - from.x;\n    const dy = to.y - from.y;\n    if (dx === 0 && dy === 0) return scene.setPose(id, pose);\n    scene.batch('move container', () => {\n      scene.setPose(id, pose);\n      for (const child of descendantsOf(scene, id)) {\n        const n = scene.get(child);\n        if (!n) continue;\n        scene.setPose(child, translatePoseViaDescriptor(n.pose, dx, dy, poseDescriptorForNode(d, n)));\n      }\n    });\n  };\n}\n"],"mappings":";;;;AAiBA,SAAgB,cAAc,OAAkD,IAAsB;CACpG,MAAM,MAAgB,CAAC;CACvB,MAAM,WAAW,SAAuB;EACtC,KAAK,MAAM,SAAS,MAAM,WAAW,IAAI,GAAG;GAC1C,IAAI,KAAK,KAAK;GACd,QAAQ,KAAK;EACf;CACF;CACA,QAAQ,EAAE;CACV,OAAO;AACT;;;;;;AAOA,SAAgB,iBACd,OACA,IACA,GACA,OACoB;CACpB,OAAO;EACL;EACA,CAAC,OAAO,MAAM;GACZ,MAAM,OAAO,MAAM,IAAI,EAAE;GACzB,IAAI,CAAC,MAAM;GACX,MAAM,IAAI,sBAAsB,GAAG,IAAI;GACvC,MAAM,OAAO,EAAE,UAAU,KAAK,IAAI;GAClC,MAAM,KAAK,EAAE,UAAU,IAAI;GAC3B,KAAK,MAAM,SAAS,cAAc,OAAO,EAAE,GAAG;IAC5C,MAAM,IAAI,MAAM,IAAI,KAAK;IACzB,IAAI,CAAC,GAAG;IACR,MAAM,CAAC,OAAO,2BAA2B,EAAE,MAAM,GAAG,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,sBAAsB,GAAG,CAAC,CAAC,CAAC;GAC7G;EACF;CACF;AACF;;;;;AAMA,SAAgB,iBACd,OACA,GACmC;CACnC,QAAQ,IAAI,SAAS;EACnB,MAAM,OAAO,MAAM,IAAI,EAAE;EACzB,IAAI,CAAC,QAAQ,KAAK,SAAS,aAAa,OAAO,MAAM,QAAQ,IAAI,IAAI;EACrE,MAAM,IAAI,sBAAsB,GAAG,IAAI;EACvC,MAAM,OAAO,EAAE,UAAU,KAAK,IAAI;EAClC,MAAM,KAAK,EAAE,UAAU,IAAI;EAC3B,MAAM,KAAK,GAAG,IAAI,KAAK;EACvB,MAAM,KAAK,GAAG,IAAI,KAAK;EACvB,IAAI,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM,QAAQ,IAAI,IAAI;EACvD,MAAM,MAAM,wBAAwB;GAClC,MAAM,QAAQ,IAAI,IAAI;GACtB,KAAK,MAAM,SAAS,cAAc,OAAO,EAAE,GAAG;IAC5C,MAAM,IAAI,MAAM,IAAI,KAAK;IACzB,IAAI,CAAC,GAAG;IACR,MAAM,QAAQ,OAAO,2BAA2B,EAAE,MAAM,IAAI,IAAI,sBAAsB,GAAG,CAAC,CAAC,CAAC;GAC9F;EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"poseCascade.js","names":[],"sources":["../../src/canvas/poseCascade.ts"],"sourcesContent":["import { poseDescriptorForNode, translatePoseViaDescriptor, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport type { NodeId } from 'core/scene/types';\nimport type { PoseCascade } from '../animation/poseTarget';\n\n/** The part of a scene a container's cascade reads. */\ninterface CascadeScene<TPose> {\n  get(id: NodeId): { pose: TPose; kind?: 'mark' | 'group' } | undefined;\n  childrenOf(id: NodeId): readonly NodeId[];\n}\n\n/** The part of a scene a cascading `setPose` writes. */\ninterface CascadeTarget<TPose> extends CascadeScene<TPose> {\n  setPose(id: NodeId, pose: TPose): void;\n  batch<T>(label: string, fn: () => T): T;\n}\n\n/** Every node under `id`, each after its parent. */\nexport function descendantsOf(scene: Pick<CascadeScene<unknown>, 'childrenOf'>, id: NodeId): NodeId[] {\n  const out: NodeId[] = [];\n  const collect = (root: NodeId): void => {\n    for (const child of scene.childrenOf(root)) {\n      out.push(child);\n      collect(child);\n    }\n  };\n  collect(id);\n  return out;\n}\n\n/**\n * How container `id`'s pose target carries its descendants where each holds a pose of its own\n * in the same space: `write` commits a pose and moves them, and while the container shows\n * somewhere else each is shown moved by as much.\n */\nexport function containerCascade<TPose>(\n  scene: CascadeScene<TPose>,\n  id: NodeId,\n  d: PoseDescriptor<TPose>,\n  write: (pose: TPose) => void,\n): PoseCascade<TPose> {\n  return {\n    write,\n    *beside(pose) {\n      const node = scene.get(id);\n      if (!node) return;\n      const g = poseDescriptorForNode(d, node);\n      const from = g.getBounds(node.pose);\n      const to = g.getBounds(pose);\n      for (const child of descendantsOf(scene, id)) {\n        const n = scene.get(child);\n        if (!n) continue;\n        yield [child, translatePoseViaDescriptor(n.pose, to.x - from.x, to.y - from.y, poseDescriptorForNode(d, n))];\n      }\n    },\n  };\n}\n\n/**\n * `setPose` for a scene of absolute poses: posing a container moves every\n * descendant by as much, in one undo step.\n */\nexport function cascadingSetPose<TPose>(\n  scene: CascadeTarget<TPose>,\n  d: PoseDescriptor<TPose>,\n): (id: NodeId, pose: TPose) => void {\n  return (id, pose) => {\n    const node = scene.get(id);\n    if (!node || node.kind !== 'group') return scene.setPose(id, pose);\n    const g = poseDescriptorForNode(d, node);\n    const from = g.getBounds(node.pose);\n    const to = g.getBounds(pose);\n    const dx = to.x - from.x;\n    const dy = to.y - from.y;\n    if (dx === 0 && dy === 0) return scene.setPose(id, pose);\n    scene.batch('move container', () => {\n      scene.setPose(id, pose);\n      for (const child of descendantsOf(scene, id)) {\n        const n = scene.get(child);\n        if (!n) continue;\n        scene.setPose(child, translatePoseViaDescriptor(n.pose, dx, dy, poseDescriptorForNode(d, n)));\n      }\n    });\n  };\n}\n"],"mappings":";;;;AAiBA,SAAgB,cAAc,OAAkD,IAAsB;CACpG,MAAM,MAAgB,CAAC;CACvB,MAAM,WAAW,SAAuB;EACtC,KAAK,MAAM,SAAS,MAAM,WAAW,IAAI,GAAG;GAC1C,IAAI,KAAK,KAAK;GACd,QAAQ,KAAK;EACf;CACF;CACA,QAAQ,EAAE;CACV,OAAO;AACT;;;;;;AAOA,SAAgB,iBACd,OACA,IACA,GACA,OACoB;CACpB,OAAO;EACL;EACA,CAAC,OAAO,MAAM;GACZ,MAAM,OAAO,MAAM,IAAI,EAAE;GACzB,IAAI,CAAC,MAAM;GACX,MAAM,IAAI,sBAAsB,GAAG,IAAI;GACvC,MAAM,OAAO,EAAE,UAAU,KAAK,IAAI;GAClC,MAAM,KAAK,EAAE,UAAU,IAAI;GAC3B,KAAK,MAAM,SAAS,cAAc,OAAO,EAAE,GAAG;IAC5C,MAAM,IAAI,MAAM,IAAI,KAAK;IACzB,IAAI,CAAC,GAAG;IACR,MAAM,CAAC,OAAO,2BAA2B,EAAE,MAAM,GAAG,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,sBAAsB,GAAG,CAAC,CAAC,CAAC;GAC7G;EACF;CACF;AACF;;;;;AAMA,SAAgB,iBACd,OACA,GACmC;CACnC,QAAQ,IAAI,SAAS;EACnB,MAAM,OAAO,MAAM,IAAI,EAAE;EACzB,IAAI,CAAC,QAAQ,KAAK,SAAS,SAAS,OAAO,MAAM,QAAQ,IAAI,IAAI;EACjE,MAAM,IAAI,sBAAsB,GAAG,IAAI;EACvC,MAAM,OAAO,EAAE,UAAU,KAAK,IAAI;EAClC,MAAM,KAAK,EAAE,UAAU,IAAI;EAC3B,MAAM,KAAK,GAAG,IAAI,KAAK;EACvB,MAAM,KAAK,GAAG,IAAI,KAAK;EACvB,IAAI,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM,QAAQ,IAAI,IAAI;EACvD,MAAM,MAAM,wBAAwB;GAClC,MAAM,QAAQ,IAAI,IAAI;GACtB,KAAK,MAAM,SAAS,cAAc,OAAO,EAAE,GAAG;IAC5C,MAAM,IAAI,MAAM,IAAI,KAAK;IACzB,IAAI,CAAC,GAAG;IACR,MAAM,QAAQ,OAAO,2BAA2B,EAAE,MAAM,IAAI,IAAI,sBAAsB,GAAG,CAAC,CAAC,CAAC;GAC9F;EACF,CAAC;CACH;AACF"}

package/dist/canvas/publishPreviews.js

@@ -0,0 +1,97 @@
+import { isPlainObject } from "@weasel-js/registry";
+
+//#region src/canvas/publishPreviews.ts
+/**
+* `publishPreviews` — what in-flight handles propose, published to the scene.
+*
+* A handle answering `previewPose` / `previewData` shows its proposal in the
+* preview ghost, which nothing else reads. Publishing it as the scene's pose
+* and data overrides is what lets the scene's other readers see it: a path
+* effect over a path whose anchors are being dragged, text laid along it, a
+* second view of the same scene.
+*/
+/**
+* Publish every in-flight handle's `previewPose` and `previewData` to
+* `scene`'s overrides each time `dispatcher` notifies, through one hold, and
+* release them when the handles end. Returns the unsubscribe, which also
+* releases what is still published.
+*
+* Previewed data is shown as the fields it changes from what the node stored
+* when its preview began, laid over what the node stores now: a write made
+* mid-gesture, or its undo, shows through, as it will be kept when the edit
+* commits against the node as it then stands. Data that is not a plain
+* object is shown as it is.
+*
+* A handle with `previewHidesSource: false` previews a copy rather than its
+* source, so it is left out. On an id another writer's override already holds —
+* a transform's own frame, a live route — the preview is a ply over it, so a
+* field the handle does not propose shows what that writer says. The dispatcher
+* notifies after a handle's `onEnd`, so a commit has landed before its preview
+* goes.
+*/
+function publishPreviews(scene, dispatcher) {
+	const hold = scene.overrides.hold();
+	const shownData = /* @__PURE__ */ new Map();
+	const dataFor = (id, value) => {
+		const held = shownData.get(id);
+		if (held !== void 0 && held.value === value) return held.data;
+		const origin = held !== void 0 ? held.origin : scene.get(id)?.data;
+		const data = changesOver(origin, value);
+		shownData.set(id, {
+			origin,
+			value,
+			data
+		});
+		return data;
+	};
+	const publish = () => {
+		const frame = /* @__PURE__ */ new Map();
+		for (const handle of dispatcher.getInFlightHandles()) {
+			if (handle.previewHidesSource === false) continue;
+			collect(handle, frame, (id) => scene.get(id) !== void 0, dataFor);
+		}
+		for (const id of shownData.keys()) if (frame.get(id)?.data === void 0) shownData.delete(id);
+		if (frame.size === 0) hold.drop();
+		else hold.show(frame);
+	};
+	const unsubscribe = dispatcher.subscribe(publish);
+	publish();
+	return () => {
+		unsubscribe();
+		hold.drop();
+		shownData.clear();
+	};
+}
+/** `(stored) => value`'s changes from `origin` laid over `stored`. */
+function changesOver(origin, value) {
+	if (!isPlainObject(origin) || !isPlainObject(value)) return () => value;
+	const changed = /* @__PURE__ */ new Set();
+	for (const key of /* @__PURE__ */ new Set([...Object.keys(origin), ...Object.keys(value)])) if (origin[key] !== value[key]) changed.add(key);
+	return (stored) => {
+		if (stored === origin || !isPlainObject(stored)) return value;
+		const out = { ...stored };
+		for (const key of changed) if (key in value) out[key] = value[key];
+		else delete out[key];
+		return out;
+	};
+}
+/** `handle`'s proposals into `frame`, first answer per id winning. */
+function collect(handle, frame, exists, dataFor) {
+	const ids = handle.previewIds?.();
+	if (!ids) return;
+	for (const raw of ids) {
+		const id = raw;
+		if (frame.has(id) || !exists(id)) continue;
+		const pose = handle.previewPose?.(raw);
+		const data = handle.previewData?.(raw);
+		if (pose == null && data == null) continue;
+		frame.set(id, {
+			...pose == null ? {} : { pose },
+			...data == null ? {} : { data: dataFor(id, data) }
+		});
+	}
+}
+
+//#endregion
+export { publishPreviews };
+//# sourceMappingURL=publishPreviews.js.map

package/dist/canvas/publishPreviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishPreviews.js","names":[],"sources":["../../src/canvas/publishPreviews.ts"],"sourcesContent":["/**\n * `publishPreviews` — what in-flight handles propose, published to the scene.\n *\n * A handle answering `previewPose` / `previewData` shows its proposal in the\n * preview ghost, which nothing else reads. Publishing it as the scene's pose\n * and data overrides is what lets the scene's other readers see it: a path\n * effect over a path whose anchors are being dragged, text laid along it, a\n * second view of the same scene.\n */\nimport { isPlainObject } from '@weasel-js/registry';\nimport type { Dispatcher, OngoingHandle } from '@weasel-js/routing';\nimport type { NodeId, Scene, ShownOverride } from 'core/scene/types';\n\ntype Fields = Record<string, unknown>;\n\n/** One id's previewed data and the function showing it, kept while the handle answers the same data. */\ninterface ShownData<TData> {\n  /** What the node stored when its preview began: what the handle's data was worked out from. */\n  origin: unknown;\n  value: unknown;\n  data: (stored: TData) => TData;\n}\n\n/**\n * Publish every in-flight handle's `previewPose` and `previewData` to\n * `scene`'s overrides each time `dispatcher` notifies, through one hold, and\n * release them when the handles end. Returns the unsubscribe, which also\n * releases what is still published.\n *\n * Previewed data is shown as the fields it changes from what the node stored\n * when its preview began, laid over what the node stores now: a write made\n * mid-gesture, or its undo, shows through, as it will be kept when the edit\n * commits against the node as it then stands. Data that is not a plain\n * object is shown as it is.\n *\n * A handle with `previewHidesSource: false` previews a copy rather than its\n * source, so it is left out. On an id another writer's override already holds —\n * a transform's own frame, a live route — the preview is a ply over it, so a\n * field the handle does not propose shows what that writer says. The dispatcher\n * notifies after a handle's `onEnd`, so a commit has landed before its preview\n * goes.\n */\nexport function publishPreviews<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  dispatcher: Pick<Dispatcher, 'getInFlightHandles' | 'subscribe'>,\n): () => void {\n  const hold = scene.overrides.hold();\n  const shownData = new Map<NodeId, ShownData<TData>>();\n\n  const dataFor = (id: NodeId, value: unknown): ((stored: TData) => TData) => {\n    const held = shownData.get(id);\n    if (held !== undefined && held.value === value) return held.data;\n    const origin = held !== undefined ? held.origin : scene.get(id)?.data;\n    const data = changesOver(origin, value) as (stored: TData) => TData;\n    shownData.set(id, { origin, value, data });\n    return data;\n  };\n\n  const publish = (): void => {\n    const frame = new Map<NodeId, ShownOverride<TPose, TData>>();\n    for (const handle of dispatcher.getInFlightHandles()) {\n      if (handle.previewHidesSource === false) continue;\n      collect(handle, frame, (id) => scene.get(id) !== undefined, dataFor);\n    }\n    for (const id of shownData.keys()) {\n      if (frame.get(id)?.data === undefined) shownData.delete(id);\n    }\n    if (frame.size === 0) hold.drop();\n    else hold.show(frame);\n  };\n\n  const unsubscribe = dispatcher.subscribe(publish);\n  publish();\n  return () => {\n    unsubscribe();\n    hold.drop();\n    shownData.clear();\n  };\n}\n\n/** `(stored) => value`'s changes from `origin` laid over `stored`. */\nfunction changesOver(origin: unknown, value: unknown): (stored: unknown) => unknown {\n  if (!isPlainObject(origin) || !isPlainObject(value)) return () => value;\n  const changed = new Set<string>();\n  for (const key of new Set([...Object.keys(origin), ...Object.keys(value)])) {\n    if (origin[key] !== value[key]) changed.add(key);\n  }\n  return (stored) => {\n    if (stored === origin || !isPlainObject(stored)) return value;\n    const out: Fields = { ...stored };\n    for (const key of changed) {\n      if (key in value) out[key] = value[key];\n      else delete out[key];\n    }\n    return out;\n  };\n}\n\n/** `handle`'s proposals into `frame`, first answer per id winning. */\nfunction collect<TPose, TData>(\n  handle: OngoingHandle,\n  frame: Map<NodeId, ShownOverride<TPose, TData>>,\n  exists: (id: NodeId) => boolean,\n  dataFor: (id: NodeId, value: unknown) => (stored: TData) => TData,\n): void {\n  const ids = handle.previewIds?.();\n  if (!ids) return;\n  for (const raw of ids) {\n    const id = raw as NodeId;\n    if (frame.has(id) || !exists(id)) continue;\n    const pose = handle.previewPose?.(raw);\n    const data = handle.previewData?.(raw);\n    if (pose == null && data == null) continue;\n    frame.set(id, {\n      ...(pose == null ? {} : { pose: pose as TPose }),\n      ...(data == null ? {} : { data: dataFor(id, data) }),\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,gBACd,OACA,YACY;CACZ,MAAM,OAAO,MAAM,UAAU,KAAK;CAClC,MAAM,4BAAY,IAAI,IAA8B;CAEpD,MAAM,WAAW,IAAY,UAA+C;EAC1E,MAAM,OAAO,UAAU,IAAI,EAAE;EAC7B,IAAI,SAAS,UAAa,KAAK,UAAU,OAAO,OAAO,KAAK;EAC5D,MAAM,SAAS,SAAS,SAAY,KAAK,SAAS,MAAM,IAAI,EAAE,CAAC,EAAE;EACjE,MAAM,OAAO,YAAY,QAAQ,KAAK;EACtC,UAAU,IAAI,IAAI;GAAE;GAAQ;GAAO;EAAK,CAAC;EACzC,OAAO;CACT;CAEA,MAAM,gBAAsB;EAC1B,MAAM,wBAAQ,IAAI,IAAyC;EAC3D,KAAK,MAAM,UAAU,WAAW,mBAAmB,GAAG;GACpD,IAAI,OAAO,uBAAuB,OAAO;GACzC,QAAQ,QAAQ,QAAQ,OAAO,MAAM,IAAI,EAAE,MAAM,QAAW,OAAO;EACrE;EACA,KAAK,MAAM,MAAM,UAAU,KAAK,GAC9B,IAAI,MAAM,IAAI,EAAE,CAAC,EAAE,SAAS,QAAW,UAAU,OAAO,EAAE;EAE5D,IAAI,MAAM,SAAS,GAAG,KAAK,KAAK;OAC3B,KAAK,KAAK,KAAK;CACtB;CAEA,MAAM,cAAc,WAAW,UAAU,OAAO;CAChD,QAAQ;CACR,aAAa;EACX,YAAY;EACZ,KAAK,KAAK;EACV,UAAU,MAAM;CAClB;AACF;;AAGA,SAAS,YAAY,QAAiB,OAA8C;CAClF,IAAI,CAAC,cAAc,MAAM,KAAK,CAAC,cAAc,KAAK,GAAG,aAAa;CAClE,MAAM,0BAAU,IAAI,IAAY;CAChC,KAAK,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,GACvE,IAAI,OAAO,SAAS,MAAM,MAAM,QAAQ,IAAI,GAAG;CAEjD,QAAQ,WAAW;EACjB,IAAI,WAAW,UAAU,CAAC,cAAc,MAAM,GAAG,OAAO;EACxD,MAAM,MAAc,EAAE,GAAG,OAAO;EAChC,KAAK,MAAM,OAAO,SAChB,IAAI,OAAO,OAAO,IAAI,OAAO,MAAM;OAC9B,OAAO,IAAI;EAElB,OAAO;CACT;AACF;;AAGA,SAAS,QACP,QACA,OACA,QACA,SACM;CACN,MAAM,MAAM,OAAO,aAAa;CAChC,IAAI,CAAC,KAAK;CACV,KAAK,MAAM,OAAO,KAAK;EACrB,MAAM,KAAK;EACX,IAAI,MAAM,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG;EAClC,MAAM,OAAO,OAAO,cAAc,GAAG;EACrC,MAAM,OAAO,OAAO,cAAc,GAAG;EACrC,IAAI,QAAQ,QAAQ,QAAQ,MAAM;EAClC,MAAM,IAAI,IAAI;GACZ,GAAI,QAAQ,OAAO,CAAC,IAAI,EAAQ,KAAc;GAC9C,GAAI,QAAQ,OAAO,CAAC,IAAI,EAAE,MAAM,QAAQ,IAAI,IAAI,EAAE;EACpD,CAAC;CACH;AACF"}

package/dist/canvas/renderSceneToPixels.js

@@ -151,7 +151,7 @@ function createRasterSession(options = {}) {
 				});
 				renderer.setFlattenTolerance(flattenTolerance);
 			}
-			renderer.render(plan.commands, viewToMat3$1(plan.view));
+			renderer.render(plan.commands, viewToMat3$1(plan.view), { screen: args.screen });
 			if (isLost(ctx)) throw new Error("raster session: the WebGL2 context was lost during render");
 			const raw = new Uint8Array(width * height * 4);
 			ctx.readPixels(0, 0, width, height, ctx.RGBA, ctx.UNSIGNED_BYTE, raw);

package/dist/canvas/renderSceneToPixels.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderSceneToPixels.js","names":["viewToMat3"],"sources":["../../src/canvas/renderSceneToPixels.ts"],"sourcesContent":["/**\n * `renderSceneToPixels` — headless rasterization of a scene-space rect to raw RGBA pixels at an\n * explicit, per-axis scale. It drives the same WebGL2 pipeline (`WeaselRenderer` +\n * `buildSceneViewCommands`) as the on-screen view, so print, thumbnail, and export callers get\n * the same pixels the screen would produce at that scale.\n *\n * Environment contract:\n * - Density arrives exclusively via `scale`; this function never reads\n *   `window.devicePixelRatio`.\n * - Rounding: output width = max(1, round(sourceRect.width × |scale.x|)), height analogously.\n *   When round() lands below rect × scale, the rightmost/bottom sub-pixel band of scene content\n *   is cropped; when it rounds up, that band is padded (the `background` fill, or transparent).\n * - Context lifetime: a caller-supplied `gl` is caller-owned. It is never disposed here, and\n *   its drawing buffer must be at least width × height pixels (the render targets the\n *   bottom-left region). Auto-created canvases are discarded with the session.\n * - Context loss: throws — a lost context cannot produce pixels, and the silent-noop\n *   convention of the screen path would return all-zero bytes.\n * - Output: top-down row order, NON-premultiplied (\"straight\") RGBA. The GL framebuffer is\n *   premultiplied and bottom-up; readback flips and unpremultiplies.\n * - Determinism: same context + same inputs → same bytes. Cross-driver / cross-machine byte\n *   equality is NOT guaranteed; do not build golden-image tests on committed bytes.\n * - Image quality: image textures upload with mipmaps so minified bitmaps don't moiré, and\n *   curve tessellation runs at an output-scale tolerance (`flattenTolerancePx`, default 0.25\n *   output px).\n */\nimport { WeaselRenderer } from '@weasel-js/renderer';\nimport { viewToMat3 } from '@weasel-js/geom';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { View } from '../core/viewport/view';\nimport type { Node, Scene } from 'core/scene/types';\nimport { buildSceneViewCommands, type SceneViewDrawOne } from './sceneViewRender';\nimport type { ColorOverrideRegistry } from '@weasel-js/animator';\nimport { defaultDrawOne } from './defaultDrawOne';\nimport { warmFonts, type FontRequest } from '@weasel-js/font';\nimport { isPaintKindKnown, warmPaintKinds } from '@weasel-js/renderer';\nimport { renderNeeds } from './renderNeeds';\nimport { straightTopDown } from './rasterReadback';\nimport { annotationLayerIds } from 'core/scene/annotation';\nimport { sceneLayerKey } from './sceneLayerPaint';\nimport { CANVAS_CONTEXT_ATTRIBUTES } from './contextAttributes';\n\n/** Plain RGBA raster — structurally `ImageData`-compatible ({ width, height,\n *  data }), deliberately free of printer/dpi/physical-unit concepts. */\nexport interface RasterImage {\n  width: number;\n  height: number;\n  /** Top-down, straight (non-premultiplied) RGBA, 4 bytes per pixel. */\n  data: Uint8ClampedArray;\n}\n\n/** Minimal canvas contract for `createCanvas` injection: `OffscreenCanvas`,\n *  an HTML canvas, or a test fake. */\nexport interface HeadlessCanvasLike {\n  width: number;\n  height: number;\n  getContext(contextId: 'webgl2', options?: WebGLContextAttributes): unknown;\n}\n\n/** What to render, at what resolution, and with which quality settings. */\nexport interface RenderSceneToPixelsArgs<TData, TLayer extends string, TPose> {\n  scene: Scene<TData, TLayer, TPose>;\n  /** Scene-space rect to render (origin + size in scene units). Output pixel\n   *  dimensions follow from rect × scale (round, min 1 — see module doc). */\n  sourceRect: { x: number; y: number; width: number; height: number };\n  /** Output pixels per scene unit, per axis. Anisotropic values supported. A\n   *  negative axis is flipped: the output is sized from its magnitude, and the\n   *  rect's far edge on that axis lands on the output's top or left. */\n  scale: { x: number; y: number };\n  /** Per-node draw callback. Default: `defaultDrawOne` with `resolveImage`\n   *  merged into the `NodePaintCtx` the scene walk supplies. Custom `drawOne`\n   *  callers that still want resolver injection should call\n   *  `defaultDrawOne(node, pose, view, { ...ctx, resolveImage })` themselves —\n   *  dropping the walk's `ctx` drops derived geometry with it. */\n  drawOne?: SceneViewDrawOne<TData, TLayer, TPose>;\n  /** Bitmap resolver for image nodes — lets consumers reuse their own decode\n   *  caches. `undefined` results paint the deterministic grey placeholder\n   *  outline (see `NodePaintCtx.resolveImage`). */\n  resolveImage?: (node: Node<TData, TLayer, TPose>) => ImageBitmap | undefined;\n  /** Per-id alpha multiplier, mirroring `<SceneCanvas>`'s scene-slot\n   *  `alphaFor`. Pass the same function the on-screen canvas uses so an\n   *  export matches what the user is looking at. Defaults to `() => 1`. */\n  alphaFor?: (id: string) => number;\n  /** Animated vertex colors to paint, typically an animator's\n   *  `colorOverrides`, so an export shows the frame on screen. */\n  colorOverrides?: ColorOverrideRegistry;\n  /** Background fill (any CSS color accepted by the renderer). Default:\n   *  fully transparent. Passing a color is always valid. */\n  background?: string;\n  /** Caller-owned WebGL2 context to render with. Mutually exclusive with\n   *  `createCanvas`. Never disposed by this call. */\n  gl?: WebGL2RenderingContext;\n  /** One-shot canvas factory (DOM canvas, OffscreenCanvas, or test fake).\n   *  Mutually exclusive with `gl`. Default: `OffscreenCanvas` when\n   *  available, else `document.createElement('canvas')`. */\n  createCanvas?: (widthPx: number, heightPx: number) => HeadlessCanvasLike;\n  /** Max curve-flattening error in OUTPUT pixels. Default 0.25. Measured\n   *  along each path's most stretched axis. */\n  flattenTolerancePx?: number;\n  /** Commands drawn over the scene in output-pixel space — origin at the\n   *  output's top-left, one unit per output pixel. Annotations, watermarks,\n   *  and `renderDebugSnapshot`'s overlay ride here. */\n  overlay?: readonly DrawCommand[];\n  /** Draw the scene's annotation layers (`isAnnotationLayer`). Default\n   *  `false`: a raster is an export, which leaves them out as the SVG export\n   *  does. Pass `true` to reproduce the canvas as it looked. */\n  annotations?: boolean;\n}\n\n/** The result of planning a headless render: how big the output is, the view\n *  that maps the source rect onto it, and the commands to draw. */\nexport interface PixelRenderPlan {\n  width: number;\n  height: number;\n  view: View;\n  commands: DrawCommand[];\n}\n\n/** Pure planning half of `renderSceneToPixels`: output dimensions, the\n *  anisotropic `View`, and the full command list (background + view-wrapped\n *  scene). Exported for tests and for callers targeting their own renderer. */\nexport function planPixelRender<TData, TLayer extends string, TPose>(\n  args: Omit<RenderSceneToPixelsArgs<TData, TLayer, TPose>, 'gl' | 'createCanvas' | 'flattenTolerancePx'>,\n): PixelRenderPlan {\n  const { sourceRect, scale } = args;\n  for (const [label, v] of [\n    ['sourceRect.width', sourceRect.width], ['sourceRect.height', sourceRect.height],\n  ] as const) {\n    if (!Number.isFinite(v) || v <= 0) {\n      throw new Error(`renderSceneToPixels: ${label} must be a positive finite number, got ${v}`);\n    }\n  }\n  for (const [label, v] of [['scale.x', scale.x], ['scale.y', scale.y]] as const) {\n    if (!Number.isFinite(v) || v === 0) {\n      throw new Error(`renderSceneToPixels: ${label} must be a nonzero finite number, got ${v}`);\n    }\n  }\n  for (const [label, v] of [\n    ['sourceRect.x', sourceRect.x], ['sourceRect.y', sourceRect.y],\n  ] as const) {\n    if (!Number.isFinite(v)) {\n      throw new Error(`renderSceneToPixels: ${label} must be a finite number, got ${v}`);\n    }\n  }\n  const width = Math.max(1, Math.round(sourceRect.width * Math.abs(scale.x)));\n  const height = Math.max(1, Math.round(sourceRect.height * Math.abs(scale.y)));\n  const view: View = {\n    x: scale.x < 0 ? sourceRect.x + sourceRect.width : sourceRect.x,\n    y: scale.y < 0 ? sourceRect.y + sourceRect.height : sourceRect.y,\n    scale: { x: scale.x, y: scale.y },\n  };\n\n  const resolveImage = args.resolveImage as ((n: Node<unknown, string, unknown>) => ImageBitmap | undefined) | undefined;\n  const drawOne: SceneViewDrawOne<TData, TLayer, TPose> =\n    args.drawOne ?? ((node, pose, view, ctx) => defaultDrawOne(node, pose, view, { ...ctx, resolveImage }));\n\n  const commands: DrawCommand[] = [];\n  if (args.background !== undefined) {\n    // Screen-space (pre-view) fill so rounding can never leave uncovered\n    // edge pixels.\n    commands.push({\n      kind: 'path',\n      path: { kind: 'rect', x: 0, y: 0, width, height },\n      fill: { paint: { kind: 'solid', color: args.background } },\n    });\n  }\n  const layers = args.annotations ? undefined : {\n    layerVisibility: Object.fromEntries([...annotationLayerIds(args.scene.layers)].map((id) => [sceneLayerKey(id), false])),\n  };\n  commands.push(...buildSceneViewCommands(\n    args.scene, view, drawOne, undefined, args.alphaFor, layers, args.colorOverrides,\n  ));\n  if (args.overlay) commands.push(...args.overlay);\n  return { width, height, view, commands };\n}\n\nfunction defaultCreateCanvas(width: number, height: number): HeadlessCanvasLike {\n  if (typeof OffscreenCanvas !== 'undefined') {\n    return new OffscreenCanvas(width, height);\n  }\n  if (typeof document !== 'undefined') {\n    const c = document.createElement('canvas');\n    c.width = width;\n    c.height = height;\n    return c;\n  }\n  throw new Error('renderSceneToPixels: no canvas source in this environment — supply `gl` or `createCanvas`');\n}\n\n/** Where a {@link RasterSession} draws. Pass `gl` or `createCanvas`, or\n *  neither for the default canvas source. */\nexport interface RasterSessionOptions {\n  /** Caller-owned WebGL2 context. The session never disposes it. Its drawing\n   *  buffer must be at least as large as every render the session does. */\n  gl?: WebGL2RenderingContext;\n  /** Canvas factory, called once, at the size of the first render. The\n   *  session grows the canvas when a later render needs more room and never\n   *  shrinks it. Default: `OffscreenCanvas` when available, else a detached\n   *  DOM canvas. */\n  createCanvas?: (widthPx: number, heightPx: number) => HeadlessCanvasLike;\n}\n\n/** One render through a {@link RasterSession}: everything\n *  `renderSceneToPixels` takes except where to draw. */\nexport type RasterRenderArgs<TData, TLayer extends string, TPose> =\n  Omit<RenderSceneToPixelsArgs<TData, TLayer, TPose>, 'gl' | 'createCanvas'>;\n\n/** One renderer and its GPU caches, kept across any number of headless\n *  renders. Scenes, source rects and scales may differ per render. */\nexport interface RasterSession {\n  /** Same contract as `renderSceneToPixels`. Throws once disposed. */\n  render<TData, TLayer extends string, TPose>(args: RasterRenderArgs<TData, TLayer, TPose>): RasterImage;\n  /** Free every GL resource the session created — programs, geometry, and\n   *  the texture and mesh caches — and drop its own canvas. A caller-owned\n   *  context stays open. Idempotent. */\n  dispose(): void;\n}\n\n/**\n * Open a raster session: one `WeaselRenderer` that many headless renders\n * share, for a consumer producing thumbnails or pages in bulk. Programs\n * compile once, and a bitmap or recurring mesh uploads once, rather than per\n * render. `renderSceneToPixels` is a session opened for one render.\n *\n * The renderer is created on the first render, so opening a session costs\n * nothing and fails nothing. Each render draws into the bottom-left\n * `width × height` of the buffer and reads that region back.\n */\nexport function createRasterSession(options: RasterSessionOptions = {}): RasterSession {\n  if (options.gl && options.createCanvas) {\n    throw new Error('raster session: `gl` and `createCanvas` are mutually exclusive');\n  }\n  let canvas: HeadlessCanvasLike | null = null;\n  let gl: WebGL2RenderingContext | undefined = options.gl;\n  let renderer: WeaselRenderer | null = null;\n  let disposed = false;\n\n  function contextFor(width: number, height: number): WebGL2RenderingContext {\n    if (!options.gl) {\n      if (!canvas) {\n        canvas = (options.createCanvas ?? defaultCreateCanvas)(width, height);\n        canvas.width = width;\n        canvas.height = height;\n        gl = (canvas.getContext('webgl2', CANVAS_CONTEXT_ATTRIBUTES) as WebGL2RenderingContext | null) ?? undefined;\n      } else {\n        if (canvas.width < width) canvas.width = width;\n        if (canvas.height < height) canvas.height = height;\n      }\n    }\n    if (!gl || typeof (gl as Partial<WebGL2RenderingContext>).enable !== 'function') {\n      throw new Error('raster session: WebGL2 is unavailable — supply `gl` or a WebGL2-capable `createCanvas`');\n    }\n    if (isLost(gl)) {\n      throw new Error('raster session: the WebGL2 context is lost — dispose this session and open another');\n    }\n    // A context clamps a drawing buffer it cannot allocate, and reading past\n    // the real one returns transparent pixels rather than failing.\n    const { drawingBufferWidth: bufferW, drawingBufferHeight: bufferH } = gl;\n    if (bufferW < width || bufferH < height) {\n      throw new Error(\n        `raster session: a ${width} × ${height} render does not fit the context's `\n        + `${bufferW} × ${bufferH} drawing buffer — lower \\`scale\\` or render the source rect in tiles`,\n      );\n    }\n    return gl;\n  }\n\n  return {\n    render(args) {\n      if (disposed) throw new Error('raster session: render() on a disposed session');\n      const plan = planPixelRender(args);\n      const { width, height } = plan;\n      const ctx = contextFor(width, height);\n      const flattenTolerance = { px: args.flattenTolerancePx ?? 0.25 };\n      if (!renderer) {\n        renderer = new WeaselRenderer({\n          gl: ctx,\n          width,\n          height,\n          dpr: 1,\n          imageMinification: 'mipmap',\n          flattenTolerance,\n          // Dynamic canvas-SDF glyphs must all bake inline — this path is\n          // synchronous with no notify-and-redraw, and print must be complete.\n          bakeBudget: Infinity,\n        });\n      } else {\n        renderer.resize({ width, height, dpr: 1 });\n        renderer.setFlattenTolerance(flattenTolerance);\n      }\n      renderer.render(plan.commands, viewToMat3(plan.view));\n      if (isLost(ctx)) {\n        throw new Error('raster session: the WebGL2 context was lost during render');\n      }\n      const raw = new Uint8Array(width * height * 4);\n      ctx.readPixels(0, 0, width, height, ctx.RGBA, ctx.UNSIGNED_BYTE, raw);\n      return { width, height, data: straightTopDown(raw, width, height) };\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      renderer?.dispose();\n      renderer = null;\n      // A browser caps live contexts per page and evicts the oldest, which is\n      // a canvas on screen; a dropped reference frees nothing until collected.\n      if (canvas && !options.createCanvas) gl?.getExtension('WEBGL_lose_context')?.loseContext();\n      canvas = null;\n      gl = undefined;\n    },\n  };\n}\n\nfunction isLost(gl: WebGL2RenderingContext): boolean {\n  return typeof gl.isContextLost === 'function' && gl.isContextLost() === true;\n}\n\n/** What {@link warmRender} loads. */\nexport interface WarmRenderOptions<TData = unknown, TLayer extends string = string, TPose = unknown> {\n  /** The render about to happen, as `renderSceneToPixels` or\n   *  `RasterSession.render` will take it. Its commands are built the way the\n   *  render builds them, and only the faces and paint kinds they draw with\n   *  load. */\n  render?: RasterRenderArgs<TData, TLayer, TPose>;\n  /** Commands about to be drawn, read the same way as `render`'s. Both may be\n   *  given; what either needs loads. */\n  commands?: readonly DrawCommand[];\n  /** Fonts to load in place of the ones derived — family names or single\n   *  variants, as `warmFonts` takes them. */\n  families?: readonly (string | FontRequest)[];\n  /** Paint kinds to load in place of the ones derived, as `warmPaintKinds`\n   *  takes them. */\n  paintKinds?: readonly string[];\n}\n\n/**\n * Load everything a synchronous render would otherwise draw as nothing — the\n * lazily registered font atlases and the paint kinds loaded on demand — so\n * that a `renderSceneToPixels` or `RasterSession.render` issued after it\n * resolves is complete.\n *\n * Pass the render (`{ render: args }`) or its commands, and only what they\n * draw with loads: each face their text is set in, through the same\n * resolution the renderer does, and each paint kind they name. A rejection\n * then means something this render needs failed to load. `families` and\n * `paintKinds` replace either derived list.\n *\n * With neither `render` nor `commands`, an omitted list loads everything\n * registered: every font family and every kind that has a loader — which\n * fails when any one of them does, and fetches what nothing draws.\n */\nexport function warmRender<TData, TLayer extends string, TPose>(\n  opts: WarmRenderOptions<TData, TLayer, TPose> = {},\n): Promise<void> {\n  let { families, paintKinds } = opts;\n  if (opts.render || opts.commands) {\n    let planned: DrawCommand[];\n    try {\n      planned = opts.render ? planPixelRender(opts.render).commands : [];\n    } catch (err) {\n      return Promise.reject(err);\n    }\n    const needs = renderNeeds([...planned, ...(opts.commands ?? [])]);\n    families ??= needs.fonts;\n    // A kind nothing registered draws nothing whether or not this waits.\n    paintKinds ??= needs.paintKinds.filter(isPaintKindKnown);\n  }\n  return Promise.all([warmFonts(families), warmPaintKinds(paintKinds)]).then(() => undefined);\n}\n\n/**\n * Render part of a scene to raw pixels, with no canvas mounted and no React\n * involved — for export, thumbnails, print, and pixel-diff tests.\n *\n * Output size follows from the source rect and the requested scale, so\n * rendering the same region at a higher scale is a real resolution increase\n * rather than an upscale: curves are re-flattened and glyphs re-rasterized for\n * the output resolution.\n *\n * Synchronous, so nothing lands mid-render: a paint kind loaded on demand\n * (`mesh-gradient`, or one declared with `registerPaintKindLoader`) that has\n * not loaded yet draws nothing, and neither does text set in a font atlas\n * still fetching — one registered `{ lazy: true }` is not fetched until text\n * first asks for it. `await warmRender({ render: args })` first.\n *\n * Each call opens a {@link RasterSession} and disposes it before returning.\n * Rendering many scenes, open one with `createRasterSession` instead.\n */\nexport function renderSceneToPixels<TData, TLayer extends string, TPose>(\n  args: RenderSceneToPixelsArgs<TData, TLayer, TPose>,\n): RasterImage {\n  const { gl, createCanvas, ...renderArgs } = args;\n  const session = createRasterSession({ gl, createCanvas });\n  try {\n    return session.render(renderArgs);\n  } finally {\n    session.dispose();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"renderSceneToPixels.js","names":["viewToMat3"],"sources":["../../src/canvas/renderSceneToPixels.ts"],"sourcesContent":["/**\n * `renderSceneToPixels` — headless rasterization of a scene-space rect to raw RGBA pixels at an\n * explicit, per-axis scale. It drives the same WebGL2 pipeline (`WeaselRenderer` +\n * `buildSceneViewCommands`) as the on-screen view, so print, thumbnail, and export callers get\n * the same pixels the screen would produce at that scale.\n *\n * Environment contract:\n * - Density arrives exclusively via `scale`; this function never reads\n *   `window.devicePixelRatio`.\n * - Rounding: output width = max(1, round(sourceRect.width × |scale.x|)), height analogously.\n *   When round() lands below rect × scale, the rightmost/bottom sub-pixel band of scene content\n *   is cropped; when it rounds up, that band is padded (the `background` fill, or transparent).\n * - Context lifetime: a caller-supplied `gl` is caller-owned. It is never disposed here, and\n *   its drawing buffer must be at least width × height pixels (the render targets the\n *   bottom-left region). Auto-created canvases are discarded with the session.\n * - Context loss: throws — a lost context cannot produce pixels, and the silent-noop\n *   convention of the screen path would return all-zero bytes.\n * - Output: top-down row order, NON-premultiplied (\"straight\") RGBA. The GL framebuffer is\n *   premultiplied and bottom-up; readback flips and unpremultiplies.\n * - Determinism: same context + same inputs → same bytes. Cross-driver / cross-machine byte\n *   equality is NOT guaranteed; do not build golden-image tests on committed bytes.\n * - Image quality: image textures upload with mipmaps so minified bitmaps don't moiré, and\n *   curve tessellation runs at an output-scale tolerance (`flattenTolerancePx`, default 0.25\n *   output px).\n */\nimport { WeaselRenderer } from '@weasel-js/renderer';\nimport { viewToMat3, type GlMat3 } from '@weasel-js/geom';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { View } from '../core/viewport/view';\nimport type { Node, Scene } from 'core/scene/types';\nimport { buildSceneViewCommands, type SceneViewDrawOne } from './sceneViewRender';\nimport type { ColorOverrideRegistry } from '@weasel-js/animator';\nimport { defaultDrawOne } from './defaultDrawOne';\nimport { warmFonts, type FontRequest } from '@weasel-js/font';\nimport { isPaintKindKnown, warmPaintKinds } from '@weasel-js/renderer';\nimport { renderNeeds } from './renderNeeds';\nimport { straightTopDown } from './rasterReadback';\nimport { annotationLayerIds } from 'core/scene/annotation';\nimport { sceneLayerKey } from './sceneLayerPaint';\nimport { CANVAS_CONTEXT_ATTRIBUTES } from './contextAttributes';\n\n/** Plain RGBA raster — structurally `ImageData`-compatible ({ width, height,\n *  data }), deliberately free of printer/dpi/physical-unit concepts. */\nexport interface RasterImage {\n  width: number;\n  height: number;\n  /** Top-down, straight (non-premultiplied) RGBA, 4 bytes per pixel. */\n  data: Uint8ClampedArray;\n}\n\n/** Minimal canvas contract for `createCanvas` injection: `OffscreenCanvas`,\n *  an HTML canvas, or a test fake. */\nexport interface HeadlessCanvasLike {\n  width: number;\n  height: number;\n  getContext(contextId: 'webgl2', options?: WebGLContextAttributes): unknown;\n}\n\n/** What to render, at what resolution, and with which quality settings. */\nexport interface RenderSceneToPixelsArgs<TData, TLayer extends string, TPose> {\n  scene: Scene<TData, TLayer, TPose>;\n  /** Scene-space rect to render (origin + size in scene units). Output pixel\n   *  dimensions follow from rect × scale (round, min 1 — see module doc). */\n  sourceRect: { x: number; y: number; width: number; height: number };\n  /** Output pixels per scene unit, per axis. Anisotropic values supported. A\n   *  negative axis is flipped: the output is sized from its magnitude, and the\n   *  rect's far edge on that axis lands on the output's top or left. */\n  scale: { x: number; y: number };\n  /** Per-node draw callback. Default: `defaultDrawOne` with `resolveImage`\n   *  merged into the `NodePaintCtx` the scene walk supplies. Custom `drawOne`\n   *  callers that still want resolver injection should call\n   *  `defaultDrawOne(node, pose, view, { ...ctx, resolveImage })` themselves —\n   *  dropping the walk's `ctx` drops derived geometry with it. */\n  drawOne?: SceneViewDrawOne<TData, TLayer, TPose>;\n  /** Bitmap resolver for image nodes — lets consumers reuse their own decode\n   *  caches. `undefined` results paint the deterministic grey placeholder\n   *  outline (see `NodePaintCtx.resolveImage`). */\n  resolveImage?: (node: Node<TData, TLayer, TPose>) => ImageBitmap | undefined;\n  /** Per-id alpha multiplier, mirroring `<SceneCanvas>`'s scene-slot\n   *  `alphaFor`. Pass the same function the on-screen canvas uses so an\n   *  export matches what the user is looking at. Defaults to `() => 1`. */\n  alphaFor?: (id: string) => number;\n  /** Animated vertex colors to paint, typically an animator's\n   *  `colorOverrides`, so an export shows the frame on screen. */\n  colorOverrides?: ColorOverrideRegistry;\n  /** Background fill (any CSS color accepted by the renderer). Default:\n   *  fully transparent. Passing a color is always valid. */\n  background?: string;\n  /** Caller-owned WebGL2 context to render with. Mutually exclusive with\n   *  `createCanvas`. Never disposed by this call. */\n  gl?: WebGL2RenderingContext;\n  /** One-shot canvas factory (DOM canvas, OffscreenCanvas, or test fake).\n   *  Mutually exclusive with `gl`. Default: `OffscreenCanvas` when\n   *  available, else `document.createElement('canvas')`. */\n  createCanvas?: (widthPx: number, heightPx: number) => HeadlessCanvasLike;\n  /** Max curve-flattening error in OUTPUT pixels. Default 0.25. Measured\n   *  along each path's most stretched axis. */\n  flattenTolerancePx?: number;\n  /** Commands drawn over the scene in output-pixel space — origin at the\n   *  output's top-left, one unit per output pixel. Annotations, watermarks,\n   *  and `renderDebugSnapshot`'s overlay ride here. */\n  overlay?: readonly DrawCommand[];\n  /** Draw the scene's annotation layers (`isAnnotationLayer`). Default\n   *  `false`: a raster is an export, which leaves them out as the SVG export\n   *  does. Pass `true` to reproduce the canvas as it looked. */\n  annotations?: boolean;\n  /** Screen space → output pixels, which `'screen'`-unit paint is measured in. Default: output pixels. A\n   *  raster standing in for part of a larger surface, such as an export's page, names the whole here. */\n  screen?: GlMat3;\n}\n\n/** The result of planning a headless render: how big the output is, the view\n *  that maps the source rect onto it, and the commands to draw. */\nexport interface PixelRenderPlan {\n  width: number;\n  height: number;\n  view: View;\n  commands: DrawCommand[];\n}\n\n/** Pure planning half of `renderSceneToPixels`: output dimensions, the\n *  anisotropic `View`, and the full command list (background + view-wrapped\n *  scene). Exported for tests and for callers targeting their own renderer. */\nexport function planPixelRender<TData, TLayer extends string, TPose>(\n  args: Omit<RenderSceneToPixelsArgs<TData, TLayer, TPose>, 'gl' | 'createCanvas' | 'flattenTolerancePx'>,\n): PixelRenderPlan {\n  const { sourceRect, scale } = args;\n  for (const [label, v] of [\n    ['sourceRect.width', sourceRect.width], ['sourceRect.height', sourceRect.height],\n  ] as const) {\n    if (!Number.isFinite(v) || v <= 0) {\n      throw new Error(`renderSceneToPixels: ${label} must be a positive finite number, got ${v}`);\n    }\n  }\n  for (const [label, v] of [['scale.x', scale.x], ['scale.y', scale.y]] as const) {\n    if (!Number.isFinite(v) || v === 0) {\n      throw new Error(`renderSceneToPixels: ${label} must be a nonzero finite number, got ${v}`);\n    }\n  }\n  for (const [label, v] of [\n    ['sourceRect.x', sourceRect.x], ['sourceRect.y', sourceRect.y],\n  ] as const) {\n    if (!Number.isFinite(v)) {\n      throw new Error(`renderSceneToPixels: ${label} must be a finite number, got ${v}`);\n    }\n  }\n  const width = Math.max(1, Math.round(sourceRect.width * Math.abs(scale.x)));\n  const height = Math.max(1, Math.round(sourceRect.height * Math.abs(scale.y)));\n  const view: View = {\n    x: scale.x < 0 ? sourceRect.x + sourceRect.width : sourceRect.x,\n    y: scale.y < 0 ? sourceRect.y + sourceRect.height : sourceRect.y,\n    scale: { x: scale.x, y: scale.y },\n  };\n\n  const resolveImage = args.resolveImage as ((n: Node<unknown, string, unknown>) => ImageBitmap | undefined) | undefined;\n  const drawOne: SceneViewDrawOne<TData, TLayer, TPose> =\n    args.drawOne ?? ((node, pose, view, ctx) => defaultDrawOne(node, pose, view, { ...ctx, resolveImage }));\n\n  const commands: DrawCommand[] = [];\n  if (args.background !== undefined) {\n    // Screen-space (pre-view) fill so rounding can never leave uncovered\n    // edge pixels.\n    commands.push({\n      kind: 'path',\n      path: { kind: 'rect', x: 0, y: 0, width, height },\n      fill: { paint: { kind: 'solid', color: args.background } },\n    });\n  }\n  const layers = args.annotations ? undefined : {\n    layerVisibility: Object.fromEntries([...annotationLayerIds(args.scene.layers)].map((id) => [sceneLayerKey(id), false])),\n  };\n  commands.push(...buildSceneViewCommands(\n    args.scene, view, drawOne, undefined, args.alphaFor, layers, args.colorOverrides,\n  ));\n  if (args.overlay) commands.push(...args.overlay);\n  return { width, height, view, commands };\n}\n\nfunction defaultCreateCanvas(width: number, height: number): HeadlessCanvasLike {\n  if (typeof OffscreenCanvas !== 'undefined') {\n    return new OffscreenCanvas(width, height);\n  }\n  if (typeof document !== 'undefined') {\n    const c = document.createElement('canvas');\n    c.width = width;\n    c.height = height;\n    return c;\n  }\n  throw new Error('renderSceneToPixels: no canvas source in this environment — supply `gl` or `createCanvas`');\n}\n\n/** Where a {@link RasterSession} draws. Pass `gl` or `createCanvas`, or\n *  neither for the default canvas source. */\nexport interface RasterSessionOptions {\n  /** Caller-owned WebGL2 context. The session never disposes it. Its drawing\n   *  buffer must be at least as large as every render the session does. */\n  gl?: WebGL2RenderingContext;\n  /** Canvas factory, called once, at the size of the first render. The\n   *  session grows the canvas when a later render needs more room and never\n   *  shrinks it. Default: `OffscreenCanvas` when available, else a detached\n   *  DOM canvas. */\n  createCanvas?: (widthPx: number, heightPx: number) => HeadlessCanvasLike;\n}\n\n/** One render through a {@link RasterSession}: everything\n *  `renderSceneToPixels` takes except where to draw. */\nexport type RasterRenderArgs<TData, TLayer extends string, TPose> =\n  Omit<RenderSceneToPixelsArgs<TData, TLayer, TPose>, 'gl' | 'createCanvas'>;\n\n/** One renderer and its GPU caches, kept across any number of headless\n *  renders. Scenes, source rects and scales may differ per render. */\nexport interface RasterSession {\n  /** Same contract as `renderSceneToPixels`. Throws once disposed. */\n  render<TData, TLayer extends string, TPose>(args: RasterRenderArgs<TData, TLayer, TPose>): RasterImage;\n  /** Free every GL resource the session created — programs, geometry, and\n   *  the texture and mesh caches — and drop its own canvas. A caller-owned\n   *  context stays open. Idempotent. */\n  dispose(): void;\n}\n\n/**\n * Open a raster session: one `WeaselRenderer` that many headless renders\n * share, for a consumer producing thumbnails or pages in bulk. Programs\n * compile once, and a bitmap or recurring mesh uploads once, rather than per\n * render. `renderSceneToPixels` is a session opened for one render.\n *\n * The renderer is created on the first render, so opening a session costs\n * nothing and fails nothing. Each render draws into the bottom-left\n * `width × height` of the buffer and reads that region back.\n */\nexport function createRasterSession(options: RasterSessionOptions = {}): RasterSession {\n  if (options.gl && options.createCanvas) {\n    throw new Error('raster session: `gl` and `createCanvas` are mutually exclusive');\n  }\n  let canvas: HeadlessCanvasLike | null = null;\n  let gl: WebGL2RenderingContext | undefined = options.gl;\n  let renderer: WeaselRenderer | null = null;\n  let disposed = false;\n\n  function contextFor(width: number, height: number): WebGL2RenderingContext {\n    if (!options.gl) {\n      if (!canvas) {\n        canvas = (options.createCanvas ?? defaultCreateCanvas)(width, height);\n        canvas.width = width;\n        canvas.height = height;\n        gl = (canvas.getContext('webgl2', CANVAS_CONTEXT_ATTRIBUTES) as WebGL2RenderingContext | null) ?? undefined;\n      } else {\n        if (canvas.width < width) canvas.width = width;\n        if (canvas.height < height) canvas.height = height;\n      }\n    }\n    if (!gl || typeof (gl as Partial<WebGL2RenderingContext>).enable !== 'function') {\n      throw new Error('raster session: WebGL2 is unavailable — supply `gl` or a WebGL2-capable `createCanvas`');\n    }\n    if (isLost(gl)) {\n      throw new Error('raster session: the WebGL2 context is lost — dispose this session and open another');\n    }\n    // A context clamps a drawing buffer it cannot allocate, and reading past\n    // the real one returns transparent pixels rather than failing.\n    const { drawingBufferWidth: bufferW, drawingBufferHeight: bufferH } = gl;\n    if (bufferW < width || bufferH < height) {\n      throw new Error(\n        `raster session: a ${width} × ${height} render does not fit the context's `\n        + `${bufferW} × ${bufferH} drawing buffer — lower \\`scale\\` or render the source rect in tiles`,\n      );\n    }\n    return gl;\n  }\n\n  return {\n    render(args) {\n      if (disposed) throw new Error('raster session: render() on a disposed session');\n      const plan = planPixelRender(args);\n      const { width, height } = plan;\n      const ctx = contextFor(width, height);\n      const flattenTolerance = { px: args.flattenTolerancePx ?? 0.25 };\n      if (!renderer) {\n        renderer = new WeaselRenderer({\n          gl: ctx,\n          width,\n          height,\n          dpr: 1,\n          imageMinification: 'mipmap',\n          flattenTolerance,\n          // Dynamic canvas-SDF glyphs must all bake inline — this path is\n          // synchronous with no notify-and-redraw, and print must be complete.\n          bakeBudget: Infinity,\n        });\n      } else {\n        renderer.resize({ width, height, dpr: 1 });\n        renderer.setFlattenTolerance(flattenTolerance);\n      }\n      renderer.render(plan.commands, viewToMat3(plan.view), { screen: args.screen });\n      if (isLost(ctx)) {\n        throw new Error('raster session: the WebGL2 context was lost during render');\n      }\n      const raw = new Uint8Array(width * height * 4);\n      ctx.readPixels(0, 0, width, height, ctx.RGBA, ctx.UNSIGNED_BYTE, raw);\n      return { width, height, data: straightTopDown(raw, width, height) };\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      renderer?.dispose();\n      renderer = null;\n      // A browser caps live contexts per page and evicts the oldest, which is\n      // a canvas on screen; a dropped reference frees nothing until collected.\n      if (canvas && !options.createCanvas) gl?.getExtension('WEBGL_lose_context')?.loseContext();\n      canvas = null;\n      gl = undefined;\n    },\n  };\n}\n\nfunction isLost(gl: WebGL2RenderingContext): boolean {\n  return typeof gl.isContextLost === 'function' && gl.isContextLost() === true;\n}\n\n/** What {@link warmRender} loads. */\nexport interface WarmRenderOptions<TData = unknown, TLayer extends string = string, TPose = unknown> {\n  /** The render about to happen, as `renderSceneToPixels` or\n   *  `RasterSession.render` will take it. Its commands are built the way the\n   *  render builds them, and only the faces and paint kinds they draw with\n   *  load. */\n  render?: RasterRenderArgs<TData, TLayer, TPose>;\n  /** Commands about to be drawn, read the same way as `render`'s. Both may be\n   *  given; what either needs loads. */\n  commands?: readonly DrawCommand[];\n  /** Fonts to load in place of the ones derived — family names or single\n   *  variants, as `warmFonts` takes them. */\n  families?: readonly (string | FontRequest)[];\n  /** Paint kinds to load in place of the ones derived, as `warmPaintKinds`\n   *  takes them. */\n  paintKinds?: readonly string[];\n}\n\n/**\n * Load everything a synchronous render would otherwise draw as nothing — the\n * lazily registered font atlases and the paint kinds loaded on demand — so\n * that a `renderSceneToPixels` or `RasterSession.render` issued after it\n * resolves is complete.\n *\n * Pass the render (`{ render: args }`) or its commands, and only what they\n * draw with loads: each face their text is set in, through the same\n * resolution the renderer does, and each paint kind they name. A rejection\n * then means something this render needs failed to load. `families` and\n * `paintKinds` replace either derived list.\n *\n * With neither `render` nor `commands`, an omitted list loads everything\n * registered: every font family and every kind that has a loader — which\n * fails when any one of them does, and fetches what nothing draws.\n */\nexport function warmRender<TData, TLayer extends string, TPose>(\n  opts: WarmRenderOptions<TData, TLayer, TPose> = {},\n): Promise<void> {\n  let { families, paintKinds } = opts;\n  if (opts.render || opts.commands) {\n    let planned: DrawCommand[];\n    try {\n      planned = opts.render ? planPixelRender(opts.render).commands : [];\n    } catch (err) {\n      return Promise.reject(err);\n    }\n    const needs = renderNeeds([...planned, ...(opts.commands ?? [])]);\n    families ??= needs.fonts;\n    // A kind nothing registered draws nothing whether or not this waits.\n    paintKinds ??= needs.paintKinds.filter(isPaintKindKnown);\n  }\n  return Promise.all([warmFonts(families), warmPaintKinds(paintKinds)]).then(() => undefined);\n}\n\n/**\n * Render part of a scene to raw pixels, with no canvas mounted and no React\n * involved — for export, thumbnails, print, and pixel-diff tests.\n *\n * Output size follows from the source rect and the requested scale, so\n * rendering the same region at a higher scale is a real resolution increase\n * rather than an upscale: curves are re-flattened and glyphs re-rasterized for\n * the output resolution.\n *\n * Synchronous, so nothing lands mid-render: a paint kind loaded on demand\n * (`mesh-gradient`, or one declared with `registerPaintKindLoader`) that has\n * not loaded yet draws nothing, and neither does text set in a font atlas\n * still fetching — one registered `{ lazy: true }` is not fetched until text\n * first asks for it. `await warmRender({ render: args })` first.\n *\n * Each call opens a {@link RasterSession} and disposes it before returning.\n * Rendering many scenes, open one with `createRasterSession` instead.\n */\nexport function renderSceneToPixels<TData, TLayer extends string, TPose>(\n  args: RenderSceneToPixelsArgs<TData, TLayer, TPose>,\n): RasterImage {\n  const { gl, createCanvas, ...renderArgs } = args;\n  const session = createRasterSession({ gl, createCanvas });\n  try {\n    return session.render(renderArgs);\n  } finally {\n    session.dispose();\n  }\n}\n"],"mappings":"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"}

package/dist/canvas/sceneAdapter.js

@@ -7,6 +7,7 @@ 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 { insertSite } from "./deps/insertSite.js";
 import { scenePoseTarget } from "../animation/poseTarget.js";
 import { cascadingSetPose, containerCascade } from "./poseCascade.js";
 import { pasteSceneSnapshot, snapshotSceneSelection } from "./sceneClipboard.js";
@@ -42,7 +43,8 @@ function sceneToAdapter(scene, options = {}) {
 		worldPoseOf: (id) => adapter.getWorldPose(id),
 		frameAtOrAbove: (id) => frameAtOrAbove(adapter, id),
 		poseBounds,
-		translate
+		translate,
+		...options.pasteInto ? { landing: () => insertSite(scene, options.pasteInto()) } : {}
 	};
 	const adapter = {
 		...sceneMutators(scene),
@@ -67,7 +69,7 @@ function sceneToAdapter(scene, options = {}) {
 		...composes ? { composePose: composition.compose } : {},
 		...cascade ? { setPose: (id, pose) => cascade.setPose(asNodeId(id), pose) } : {},
 		poseTarget(id, descriptor) {
-			if (cascade === null || scene.get(asNodeId(id))?.kind !== "container") return scenePoseTarget(scene, id, descriptor ?? d);
+			if (cascade === null || scene.get(asNodeId(id))?.kind !== "group") return scenePoseTarget(scene, id, descriptor ?? d);
 			const carried = containerCascade(scene, asNodeId(id), d, (pose) => adapter.setPose(id, pose));
 			return scenePoseTarget(scene, id, descriptor ?? d, carried);
 		},
@@ -85,17 +87,17 @@ function sceneToAdapter(scene, options = {}) {
 		getSelection,
 		setSelection,
 		hitTestArea(rect, view) {
-			return hitTestArea(scene, rect, pickOptsFor(view), d, { includeContainers: true });
+			return hitTestArea(scene, rect, pickOptsFor(view), d, { includeGroups: true });
 		},
 		hitTestLasso(polygon, mode, view) {
-			return hitTestLassoPolygon(scene, polygon, mode, pickOptsFor(view), d, { includeContainers: true });
+			return hitTestLassoPolygon(scene, polygon, mode, pickOptsFor(view), d, { includeGroups: true });
 		},
 		...options.commitInsert ? { commitInsert: (bounds) => {
 			const created = options.commitInsert(bounds);
 			if (!created) return null;
 			const layer = options.insertLayer ?? "default";
 			return {
-				kind: "leaf",
+				kind: "mark",
 				id: created.id === void 0 ? scene.mintId() : asNodeId(created.id),
 				layer,
 				pose: created.pose,

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 type { Bounds } from '../core/viewport/fitViewToBounds';\nimport { scenePoseTarget } from '../animation/poseTarget';\nimport { cascadingSetPose, containerCascade } from './poseCascade';\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      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}\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.\n *\n *  Moving a container carries its contents either way the scene composes\n *  poses. Under a frame (`scene.composition`) the one pose written moves them.\n *  Under the absolute-pose model `setPose` on a container translates every\n *  descendant by the same delta, and a batch that poses descendants too undoes\n *  exactly only when it goes through this adapter's `applyOps`. */\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(\n      p, dx, dy, node === undefined ? d : poseDescriptorForNode(d, node),\n    );\n\n  const composition = scene.composition;\n  const composes = composesFrames(composition);\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 cascade = composes ? null : { setPose: cascadingSetPose(scene, d) };\n\n  const clipboardEnv: SceneClipboardEnv<TData, TLayer, TPose> = {\n    scene,\n    composes,\n    worldPoseOf: (id) => adapter.getWorldPose(id),\n    frameAtOrAbove: (id) => frameAtOrAbove(adapter, id),\n    poseBounds,\n    translate,\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, composition.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: composition.compose } : {}),\n    ...(cascade ? { setPose: (id: string, pose: TPose) => cascade.setPose(asNodeId(id), pose) } : {}),\n    poseTarget(id, descriptor) {\n      if (cascade === null || scene.get(asNodeId(id))?.kind !== 'container') {\n        return scenePoseTarget(scene, id, descriptor ?? d);\n      }\n      // Its descendants hold poses of their own: a commit moves them, and they are shown beside it.\n      const carried = containerCascade(scene, asNodeId(id), d, (pose) => adapter.setPose(id, pose));\n      return scenePoseTarget(scene, id, descriptor ?? d, carried);\n    },\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. Containers 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        { includeContainers: 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        { includeContainers: 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: 'leaf',\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 { composesFrames, composeWorldPose, frameAtOrAbove } from 'core/scene/composePose';\nimport { insertSite } from './deps/insertSite';\nimport type { Bounds } from '../core/viewport/fitViewToBounds';\nimport { scenePoseTarget } from '../animation/poseTarget';\nimport { cascadingSetPose, containerCascade } from './poseCascade';\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      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.\n *\n *  Moving a container carries its contents either way the scene composes\n *  poses. Under a frame (`scene.composition`) the one pose written moves them.\n *  Under the absolute-pose model `setPose` on a container translates every\n *  descendant by the same delta, and a batch that poses descendants too undoes\n *  exactly only when it goes through this adapter's `applyOps`. */\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(\n      p, dx, dy, node === undefined ? d : poseDescriptorForNode(d, node),\n    );\n\n  const composition = scene.composition;\n  const composes = composesFrames(composition);\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 cascade = composes ? null : { setPose: cascadingSetPose(scene, d) };\n\n  const clipboardEnv: SceneClipboardEnv<TData, TLayer, TPose> = {\n    scene,\n    composes,\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, composition.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: composition.compose } : {}),\n    ...(cascade ? { setPose: (id: string, pose: TPose) => cascade.setPose(asNodeId(id), pose) } : {}),\n    poseTarget(id, descriptor) {\n      if (cascade === null || scene.get(asNodeId(id))?.kind !== 'group') {\n        return scenePoseTarget(scene, id, descriptor ?? d);\n      }\n      // Its descendants hold poses of their own: a commit moves them, and they are shown beside it.\n      const carried = containerCascade(scene, asNodeId(id), d, (pose) => adapter.setPose(id, pose));\n      return scenePoseTarget(scene, id, descriptor ?? d, carried);\n    },\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,7 +1,9 @@
+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";
 
 //#region src/canvas/sceneClipboard.ts
 function copyField(value) {
@@ -9,7 +11,6 @@ function copyField(value) {
 	if (value !== null && typeof value === "object") return { ...value };
 	return value;
 }
-var dependencyList = (item) => Array.isArray(item.dependsOn) ? item.dependsOn : [];
 function snapshotSceneSelection(env, ids) {
 	const { scene } = env;
 	const fnFields = createNodeFnFields(scene.registry);
@@ -34,13 +35,13 @@ function snapshotSceneSelection(env, ids) {
 			parent: n.parent,
 			pose: copyField(poseFor(n, isRoot)),
 			data: copyField(n.data),
-			...n.kind === "container" ? { children: [...n.children] } : {},
+			...n.children !== void 0 ? { children: [...n.children] } : {},
 			...statedFields(n),
 			...n.dependsOn !== void 0 ? { dependsOn: copyField(n.dependsOn) } : {},
 			...fnFieldsOfNode(n),
 			...fnKeysOf(fnFields, n, "jsonKey")
 		});
-		if (n.kind === "container") for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);
+		if (hasChildren(n)) for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);
 	};
 	for (const id of ids) {
 		if (scene.ancestorsOf(asNodeId(id)).some((a) => idSet.has(a))) continue;
@@ -57,7 +58,6 @@ function restoredFnFields(scene, item) {
 	const out = {};
 	const registry = scene.registry;
 	for (const spec of NODE_FN_FIELDS) {
-		if (spec.containersOnly && item.kind !== "container") continue;
 		const key = item[spec.jsonKey];
 		const fn = (typeof key === "string" ? registry[spec.field]?.[key] : void 0) ?? (isLive(item[spec.field]) ? item[spec.field] : void 0);
 		if (fn !== void 0) out[spec.field] = fn;
@@ -79,7 +79,7 @@ function omissions(src, fns) {
 		for (const item of src) {
 			if (out.has(item.id)) continue;
 			let omission;
-			const deps = dependencyList(item);
+			const deps = sourcesOf(item);
 			const missing = deps.filter((dep) => !present.has(dep));
 			const fn = fns.get(item.id);
 			if (item.parent !== null && out.has(item.parent)) omission = {
@@ -142,16 +142,23 @@ function pasteSceneSnapshot(env, clipboard, offset, ctx) {
 			dy = ctx.dropPoint.worldY - minY;
 		}
 	}
+	const site = env.landing?.();
+	const into = site?.parent != null ? site : null;
+	const placed = (item) => {
+		if (ridesPastedFrame(item)) return copyField(item.pose);
+		const moved = env.translate(copyField(item.pose), dx, dy, item);
+		return into && isRoot(item) ? into.local(moved) : moved;
+	};
 	return src.map((item) => ({
 		id: idMap.get(item.id),
 		kind: item.kind,
-		layer: item.layer,
-		parent: isRoot(item) ? null : idMap.get(item.parent),
-		pose: ridesPastedFrame(item) ? copyField(item.pose) : env.translate(copyField(item.pose), dx, dy, item),
+		layer: into && isRoot(item) ? into.layer : item.layer,
+		parent: isRoot(item) ? into?.parent ?? null : idMap.get(item.parent),
+		pose: placed(item),
 		data: copyField(item.data),
 		...statedFields(item),
-		...item.kind === "container" ? { children: item.children.filter((c) => idMap.has(c)).map((c) => idMap.get(c)) } : {},
-		...item.dependsOn === "children" ? { dependsOn: "children" } : dependencyList(item).length > 0 ? { dependsOn: dependencyList(item).map((dep) => idMap.get(dep)) } : {},
+		...item.children !== void 0 ? { children: item.children.filter((c) => idMap.has(c)).map((c) => idMap.get(c)) } : {},
+		...item.dependsOn === "children" ? { dependsOn: "children" } : sourcesOf(item).length > 0 ? { dependsOn: sourcesOf(item).map((dep) => idMap.get(dep)) } : {},
 		...fns.get(item.id)
 	}));
 }

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 { 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';\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  /** Whether a stored pose is relative to its container's frame. */\n  composes: boolean;\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}\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\nconst dependencyList = (item: { dependsOn?: readonly NodeId[] | 'children' }): readonly NodeId[] =>\n  (Array.isArray(item.dependsOn) ? item.dependsOn : []);\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 (!env.composes) return n.pose;\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.kind === 'container' ? { 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 (n.kind === 'container') {\n      for (const cid of scene.childrenOf(asNodeId(id))) capture(cid);\n    }\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    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    if (spec.containersOnly && item.kind !== 'container') continue;\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 = dependencyList(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  // Under a composing strategy a node inside a pasted frame rides it, and\n  // offsetting it as well would 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    if (!env.composes) return false;\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  // Without composition poses are absolute, so the delta applies to EVERY\n  // pasted node.\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.worldX - minX;\n      dy = ctx.dropPoint.worldY - minY;\n    }\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: item.layer,\n    parent: isRoot(item) ? null : idMap.get(item.parent as string)!,\n    pose: ridesPastedFrame(item)\n      ? copyField(item.pose)\n      : env.translate(copyField(item.pose), dx, dy, item),\n    data: copyField(item.data),\n    ...statedFields(item),\n    ...(item.kind === 'container'\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      : dependencyList(item).length > 0\n        ? { dependsOn: dependencyList(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 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  /** Whether a stored pose is relative to its container's frame. */\n  composes: boolean;\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 (!env.composes) return n.pose;\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  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    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  // Under a composing strategy a node inside a pasted frame rides it, and\n  // offsetting it as well would 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    if (!env.composes) return false;\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  // Without composition poses are absolute, so the delta applies to EVERY\n  // pasted node.\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.worldX - minX;\n      dy = ctx.dropPoint.worldY - 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/scenePickReads.js

@@ -0,0 +1,37 @@
+import { asNodeId } from "../core/scene/types.js";
+import { sceneDerivedPathOf, showsComputedPath } from "./derivedPath.js";
+
+//#region 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. */
+function sceneParentsOf(scene) {
+	return (node) => {
+		let parentId = node.parent ?? null;
+		if (parentId === null) return EMPTY_PARENTS;
+		const chain = [];
+		const seen = /* @__PURE__ */ new Set();
+		while (parentId !== null) {
+			if (seen.has(parentId)) break;
+			seen.add(parentId);
+			const parent = scene.get(asNodeId(parentId));
+			if (!parent) break;
+			chain.push(parent);
+			parentId = parent.parent ?? null;
+		}
+		return chain;
+	};
+}
+/** `(node) => the path it shows in place of its pose`, or null: an override's
+*  path or the one it derives, at the poses the scene paints its dependencies. */
+function sceneShownPathOf(scene) {
+	const derived = sceneDerivedPathOf(scene);
+	return (node) => {
+		const n = node;
+		return showsComputedPath(scene, n) ? derived(n) : null;
+	};
+}
+
+//#endregion
+export { sceneParentsOf, sceneShownPathOf };
+//# sourceMappingURL=scenePickReads.js.map

package/dist/canvas/scenePickReads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenePickReads.js","names":[],"sources":["../../src/canvas/scenePickReads.ts"],"sourcesContent":["/** What a scene-backed pick reads per node, shared by `scenePickSource` and the\n *  pick index so the two cannot disagree about a node's ancestors or path. */\nimport type { Path } from '@weasel-js/geom';\nimport { asNodeId, type Node, type Scene } from 'core/scene/types';\nimport { sceneDerivedPathOf, showsComputedPath } from './derivedPath';\nimport type { PickCandidate } from './pickWalk';\n\n/** Shared, never mutated: most scenes are flat and every node returns it. */\nconst EMPTY_PARENTS: readonly never[] = [];\n\n/** `(node) => its ancestors, innermost first`, stopping at a cycle or a missing parent. */\nexport function sceneParentsOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): (node: PickCandidate<TPose>) => readonly PickCandidate<TPose>[] {\n  return (node) => {\n    let parentId = (node as { parent?: string | null }).parent ?? null;\n    if (parentId === null) return EMPTY_PARENTS;\n    const chain: PickCandidate<TPose>[] = [];\n    const seen = new Set<string>();\n    while (parentId !== null) {\n      if (seen.has(parentId)) break;\n      seen.add(parentId);\n      const parent = scene.get(asNodeId(parentId));\n      if (!parent) break;\n      chain.push(parent as unknown as PickCandidate<TPose>);\n      parentId = parent.parent ?? null;\n    }\n    return chain;\n  };\n}\n\n/** `(node) => the path it shows in place of its pose`, or null: an override's\n *  path or the one it derives, at the poses the scene paints its dependencies. */\nexport function sceneShownPathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): (node: PickCandidate<TPose>) => Path | null {\n  const derived = sceneDerivedPathOf(scene);\n  return (node) => {\n    const n = node as unknown as Node<TData, TLayer, TPose>;\n    return showsComputedPath(scene, n) ? derived(n) : null;\n  };\n}\n"],"mappings":";;;;;AAQA,IAAM,gBAAkC,CAAC;;AAGzC,SAAgB,eACd,OACiE;CACjE,QAAQ,SAAS;EACf,IAAI,WAAY,KAAoC,UAAU;EAC9D,IAAI,aAAa,MAAM,OAAO;EAC9B,MAAM,QAAgC,CAAC;EACvC,MAAM,uBAAO,IAAI,IAAY;EAC7B,OAAO,aAAa,MAAM;GACxB,IAAI,KAAK,IAAI,QAAQ,GAAG;GACxB,KAAK,IAAI,QAAQ;GACjB,MAAM,SAAS,MAAM,IAAI,SAAS,QAAQ,CAAC;GAC3C,IAAI,CAAC,QAAQ;GACb,MAAM,KAAK,MAAyC;GACpD,WAAW,OAAO,UAAU;EAC9B;EACA,OAAO;CACT;AACF;;;AAIA,SAAgB,iBACd,OAC6C;CAC7C,MAAM,UAAU,mBAAmB,KAAK;CACxC,QAAQ,SAAS;EACf,MAAM,IAAI;EACV,OAAO,kBAAkB,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI;CACpD;AACF"}