@weasel-js/core 1.14.2 → 1.15.1

package/dist/core/scene/poseHold.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/poseHold.ts
+// src/core/scene/poseHold.ts
 /** Build the {@link PoseHold} a table hands out from `hold()`. `pliesOf`
 *  answers a node's plies, bottom first. */
 function createPoseHold(table, pliesOf) {
@@ -61,6 +61,5 @@ function* mapped(poses) {
 	for (const [id, pose] of poses) yield [id, { pose }];
 }
 
-//#endregion
 export { createPoseHold };
 //# sourceMappingURL=poseHold.js.map

package/dist/core/scene/poseOverrides.js

@@ -5,7 +5,7 @@ import { foldPlies } from "./posePlies.js";
 import { createPlyStacks, plyPath } from "./plyStacks.js";
 import { createEmitter } from "@weasel-js/registry";
 
-//#region src/core/scene/poseOverrides.ts
+// src/core/scene/poseOverrides.ts
 /**
 * Build a {@link PoseOverrides} map.
 *
@@ -105,6 +105,5 @@ function createPoseOverrides(getNode, onInvalidate) {
 	return table;
 }
 
-//#endregion
 export { createPoseOverrides };
 //# sourceMappingURL=poseOverrides.js.map

package/dist/core/scene/posePlies.js

@@ -1,6 +1,6 @@
 import { kit, last, mix, mul, patch } from "@msb235/blits";
 
-//#region src/core/scene/posePlies.ts
+// src/core/scene/posePlies.ts
 /** What a ply says about a node with fewer plies than its depth. */
 var NOTHING = Object.freeze({});
 /** Per lower function, per upper one, the two run in turn: kept, so a node
@@ -54,6 +54,5 @@ function foldPlies(plies) {
 	};
 }
 
-//#endregion
 export { foldPlies };
 //# sourceMappingURL=posePlies.js.map

package/dist/core/scene/poseRemovals.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/poseRemovals.ts
+// src/core/scene/poseRemovals.ts
 function createRemovalLog(shown) {
 	const removals = /* @__PURE__ */ new Map();
 	return {
@@ -54,6 +54,5 @@ function createRemovalLog(shown) {
 	};
 }
 
-//#endregion
 export { createRemovalLog };
 //# sourceMappingURL=poseRemovals.js.map

package/dist/core/scene/poseSnapshot.js

@@ -1,6 +1,6 @@
 import { isPlainObject, isPlainPrototype } from "../isPlainObject.js";
 
-//#region src/core/scene/poseSnapshot.ts
+// src/core/scene/poseSnapshot.ts
 /**
 * Comparing a pose against what it was, by value.
 *
@@ -70,6 +70,5 @@ function samePoseValue(snapshot, value, depth = DEPTH) {
 	return false;
 }
 
-//#endregion
 export { samePoseValue, snapshotPose };
 //# sourceMappingURL=poseSnapshot.js.map

package/dist/core/scene/poseWrites.js

@@ -1,18 +1,20 @@
 import { createRemovalLog } from "./poseRemovals.js";
 import { createEmitter, deepEqual } from "@weasel-js/registry";
 
-//#region src/core/scene/poseWrites.ts
+// src/core/scene/poseWrites.ts
 /**
 * What a scene reports about the poses it writes: each change's net pose per
 * node, the nodes it removed as they were last shown, and where each came
 * from, handed to `onPoseWrite` once the change reaches the scene's
 * subscribers.
 */
+var NOTHING = () => {};
 function createPoseWriteLog(env) {
 	const listeners = createEmitter();
 	const pending = /* @__PURE__ */ new Map();
 	const removals = createRemovalLog(env.shown);
-	let edit = null;
+	let editLabel = null;
+	let editVia = "call";
 	let replays = 0;
 	let layouts = 0;
 	let quiets = 0;
@@ -22,9 +24,9 @@ function createPoseWriteLog(env) {
 		if (replays > 0) return { origin: reverted ? "undo" : "redo" };
 		if (layouts > 0) return { origin: "layout" };
 		if (env.untracked()) return { origin: "untracked" };
-		return edit ? {
-			origin: edit.via,
-			label: edit.label
+		return editLabel !== null ? {
+			origin: editVia,
+			label: editLabel
 		} : { origin: "call" };
 	}
 	function noteSet(id, from, to, reverted) {
@@ -47,7 +49,7 @@ function createPoseWriteLog(env) {
 			...stamp(reverted)
 		});
 	}
-	const seeOff = (roots, nodes, reverted) => collecting() ? removals.seeOff(roots, nodes, stamp(reverted), pending) : () => {};
+	const seeOff = (roots, nodes, reverted) => collecting() ? removals.seeOff(roots, nodes, stamp(reverted), pending) : NOTHING;
 	function around(fn, enter, leave) {
 		enter();
 		try {
@@ -74,7 +76,7 @@ function createPoseWriteLog(env) {
 			...h,
 			apply: (p) => {
 				h.apply(p);
-				noteAdded([p], false);
+				if (collecting()) noteAdded([p], false);
 			},
 			revert: (p) => {
 				const done = seeOff([p], [p], true);
@@ -117,15 +119,14 @@ function createPoseWriteLog(env) {
 			};
 		},
 		labeled(label, via, fn) {
-			if (edit) return fn();
-			return around(fn, () => {
-				edit = {
-					label,
-					via
-				};
-			}, () => {
-				edit = null;
-			});
+			if (editLabel !== null) return fn();
+			editLabel = label;
+			editVia = via;
+			try {
+				return fn();
+			} finally {
+				editLabel = null;
+			}
 		},
 		replaying: (fn) => around(fn, () => {
 			replays++;
@@ -146,6 +147,5 @@ function createPoseWriteLog(env) {
 	};
 }
 
-//#endregion
 export { createPoseWriteLog };
 //# sourceMappingURL=poseWrites.js.map

package/dist/core/scene/poseWrites.js.map

@@ -1 +1 @@
-{"version":3,"file":"poseWrites.js","names":[],"sources":["../../../src/core/scene/poseWrites.ts"],"sourcesContent":["/**\n * What a scene reports about the poses it writes: each change's net pose per\n * node, the nodes it removed as they were last shown, and where each came\n * from, handed to `onPoseWrite` once the change reaches the scene's\n * subscribers.\n */\nimport { createEmitter, deepEqual } from '@weasel-js/registry';\nimport { createRemovalLog } from './poseRemovals';\nimport type { RegisteredOp } from './types';\nimport type { LayoutMove } from './layoutTypes';\nimport type { NodeId } from '@weasel-js/routing';\n\n/**\n * Where a reported pose write came from.\n *\n * - `'call'` — a scene method called directly, alone or inside `scene.batch`:\n *   a button's `scene.setPose`, a `scene.add`.\n * - `'ops'` — ops applied as one edit through `applyBatch` or `history.apply`,\n *   which is how actions commit: a drag's release, a resize, a nudge, an align.\n * - `'undo'` / `'redo'` — a history step, a jump through the history included.\n * - `'layout'` — a container's layout arranging what a live edit changed; also\n *   reported to `onReflow`.\n * - `'untracked'` — a write inside `scene.untracked`, such as a pose target\n *   committing an animation's destination.\n */\nexport type PoseWriteOrigin = 'call' | 'ops' | 'undo' | 'redo' | 'layout' | 'untracked';\n\n/** One node's pose as a scene change left it, in the node's stored frame. */\nexport interface PoseWrite<TPose> {\n  id: NodeId;\n  /** The pose before the change; `undefined` for a node the change added. */\n  from: TPose | undefined;\n  to: TPose;\n  origin: PoseWriteOrigin;\n  /** The edit's label (`'setPose'`, a batch's, an action's `'Move'`) for\n   *  `'call'` and `'ops'`; `undefined` otherwise. */\n  label?: string;\n}\n\n/** A removed node as it was last shown, with the descendants it took along. */\nexport interface RemovedNode<TPose, TNode = unknown> {\n  /** The node as it stood before the change removed it. */\n  node: TNode;\n  /** Where it was shown, override included, in its stored frame. */\n  pose: TPose;\n  children: readonly RemovedNode<TPose, TNode>[];\n}\n\n/** One node a scene change removed, a removal's root: its descendants ride\n *  beneath it rather than being reported apart. */\nexport interface PoseRemoval<TPose, TNode = unknown> extends RemovedNode<TPose, TNode> {\n  id: NodeId;\n  /** The parent it was removed from, which may still be in the scene. */\n  parent: NodeId | null;\n  origin: PoseWriteOrigin;\n  label?: string;\n}\n\n/** What a scene reports about the poses its edits write. */\nexport interface ScenePoseReports<TPose, TNode = unknown> {\n  /** Called with the poses each live edit's layout pass wrote, after the\n   *  edit lands — never for an undo or redo, which restore poses rather than\n   *  arrange them. What a reflow animation glides from. */\n  onReflow(listener: (moves: readonly LayoutMove<TPose>[]) => void): () => void;\n  /** Called once per change, before the scene's subscribers hear of it, with\n   *  every node whose pose the change wrote or that it added, and every node\n   *  it removed — an undone add among them. A node written back to the pose\n   *  it had, or both added and removed by the change, is left out of both.\n   *  Not called for `loadState` or the scene's initial nodes. */\n  onPoseWrite(\n    listener: (writes: readonly PoseWrite<TPose>[], removed: readonly PoseRemoval<TPose, TNode>[]) => void,\n  ): () => void;\n}\n\n/** What the log reads of the scene it reports for. */\nexport interface PoseWriteEnv<TPose, TNode> {\n  /** A node still in the scene, with the pose it is shown at. */\n  shown(id: NodeId): { node: TNode; pose: TPose } | undefined;\n  /** Whether the edit running now is inside `scene.untracked`. */\n  untracked(): boolean;\n  /** The scene's change notice. The log reports on it, subscribed before\n   *  anyone else so a change's writes arrive ahead of its re-reads. */\n  changes: { subscribe(listener: () => void): () => void };\n}\n\nexport interface PoseWriteLog<TPose, TNode = unknown> {\n  subscribe: ScenePoseReports<TPose, TNode>['onPoseWrite'];\n  /** Run `fn` as an edit labeled `label`; an enclosing edit's label stands. */\n  labeled<T>(label: string, via: 'call' | 'ops', fn: () => T): T;\n  /** Run `fn` as a history step replaying recorded ops. */\n  replaying<T>(fn: () => T): T;\n  /** Run `fn` as a layout pass writing arranged poses. */\n  layout<T>(fn: () => T): T;\n  /** Run `fn` with nothing it writes reported. */\n  quiet<T>(fn: () => T): T;\n  /** `register` with the kit's pose-bearing ops reporting what they write. */\n  reporting(register: (kind: string, handler: RegisteredOp<unknown>) => void):\n    (kind: string, handler: RegisteredOp<unknown>) => void;\n}\n\ninterface Posed<TPose> { id: NodeId; pose: TPose }\ninterface Parented { id: NodeId; parent: NodeId | null }\n\nexport function createPoseWriteLog<TPose, TNode = unknown>(env: PoseWriteEnv<TPose, TNode>): PoseWriteLog<TPose, TNode> {\n  const listeners = createEmitter<[writes: readonly PoseWrite<TPose>[], removed: readonly PoseRemoval<TPose, TNode>[]]>();\n  const pending = new Map<NodeId, PoseWrite<TPose>>();\n  const removals = createRemovalLog<TPose, TNode>(env.shown);\n  let edit: { label: string; via: 'call' | 'ops' } | null = null;\n  let replays = 0;\n  let layouts = 0;\n  let quiets = 0;\n  let listening = 0;\n\n  const collecting = (): boolean => listening > 0 && quiets === 0;\n\n  function stamp(reverted: boolean): Pick<PoseWrite<TPose>, 'origin' | 'label'> {\n    if (replays > 0) return { origin: reverted ? 'undo' : 'redo' };\n    if (layouts > 0) return { origin: 'layout' };\n    if (env.untracked()) return { origin: 'untracked' };\n    return edit ? { origin: edit.via, label: edit.label } : { origin: 'call' };\n  }\n\n  function noteSet(id: NodeId, from: TPose, to: TPose, reverted: boolean): void {\n    if (!collecting()) return;\n    const held = pending.get(id);\n    if (held) held.to = to;\n    else pending.set(id, { id, from, to, ...stamp(reverted) });\n  }\n\n  function noteAdded(nodes: readonly Posed<TPose>[], reverted: boolean): void {\n    if (!collecting()) return;\n    for (const n of nodes) {\n      // Removed and back within one change: it moved, if anything.\n      pending.set(n.id, { id: n.id, from: removals.takeBack(n.id), to: n.pose, ...stamp(reverted) });\n    }\n  }\n\n  const seeOff = (roots: readonly Parented[], nodes: readonly Parented[], reverted: boolean): () => void =>\n    collecting() ? removals.seeOff(roots, nodes, stamp(reverted), pending) : () => {};\n\n  function around<T>(fn: () => T, enter: () => void, leave: () => void): T {\n    enter();\n    try {\n      return fn();\n    } finally {\n      leave();\n    }\n  }\n\n  type SetPayload = { id: NodeId; from: TPose; to: TPose };\n  type AddPayload = Posed<TPose> & Parented;\n  type RemovePayload = { nodes: readonly (Posed<TPose> & Parented)[]; detached: readonly Parented[] };\n  const wrap: Record<string, (h: RegisteredOp<unknown>) => RegisteredOp<unknown>> = {\n    'kit:setPose': (h) => ({\n      ...h,\n      apply: (p) => { h.apply(p); const s = p as SetPayload; noteSet(s.id, s.from, s.to, false); },\n      revert: (p) => { h.revert(p); const s = p as SetPayload; noteSet(s.id, s.to, s.from, true); },\n    }),\n    'kit:add': (h) => ({\n      ...h,\n      apply: (p) => { h.apply(p); noteAdded([p as AddPayload], false); },\n      revert: (p) => { const done = seeOff([p as AddPayload], [p as AddPayload], true); h.revert(p); done(); },\n    }),\n    'kit:remove': (h) => ({\n      ...h,\n      apply: (p) => {\n        const r = p as RemovePayload;\n        const done = seeOff(r.detached, r.nodes, false);\n        h.apply(p);\n        done();\n      },\n      revert: (p) => { h.revert(p); noteAdded((p as RemovePayload).nodes, true); },\n    }),\n  };\n\n  function flush(): void {\n    const removed = removals.drain();\n    if (pending.size === 0 && removed.length === 0) return;\n    const writes = [...pending.values()].filter((w) => !deepEqual(w.from, w.to));\n    pending.clear();\n    if (writes.length > 0 || removed.length > 0) listeners.emit(writes, removed);\n  }\n  env.changes.subscribe(flush);\n\n  return {\n    subscribe(listener) {\n      const off = listeners.subscribe(listener);\n      listening++;\n      let on = true;\n      return () => {\n        if (!on) return;\n        on = false;\n        listening--;\n        off();\n      };\n    },\n    labeled(label, via, fn) {\n      if (edit) return fn();\n      return around(fn, () => { edit = { label, via }; }, () => { edit = null; });\n    },\n    replaying: (fn) => around(fn, () => { replays++; }, () => { replays--; }),\n    layout: (fn) => around(fn, () => { layouts++; }, () => { layouts--; }),\n    quiet: (fn) => around(fn, () => { quiets++; }, () => { quiets--; }),\n    reporting: (register) => (kind, handler) => register(kind, wrap[kind]?.(handler) ?? handler),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"poseWrites.js","names":[],"sources":["../../../src/core/scene/poseWrites.ts"],"sourcesContent":["/**\n * What a scene reports about the poses it writes: each change's net pose per\n * node, the nodes it removed as they were last shown, and where each came\n * from, handed to `onPoseWrite` once the change reaches the scene's\n * subscribers.\n */\nimport { createEmitter, deepEqual } from '@weasel-js/registry';\nimport { createRemovalLog } from './poseRemovals';\nimport type { RegisteredOp } from './types';\nimport type { LayoutMove } from './layoutTypes';\nimport type { NodeId } from '@weasel-js/routing';\n\n/**\n * Where a reported pose write came from.\n *\n * - `'call'` — a scene method called directly, alone or inside `scene.batch`:\n *   a button's `scene.setPose`, a `scene.add`.\n * - `'ops'` — ops applied as one edit through `applyBatch` or `history.apply`,\n *   which is how actions commit: a drag's release, a resize, a nudge, an align.\n * - `'undo'` / `'redo'` — a history step, a jump through the history included.\n * - `'layout'` — a container's layout arranging what a live edit changed; also\n *   reported to `onReflow`.\n * - `'untracked'` — a write inside `scene.untracked`, such as a pose target\n *   committing an animation's destination.\n */\nexport type PoseWriteOrigin = 'call' | 'ops' | 'undo' | 'redo' | 'layout' | 'untracked';\n\n/** One node's pose as a scene change left it, in the node's stored frame. */\nexport interface PoseWrite<TPose> {\n  id: NodeId;\n  /** The pose before the change; `undefined` for a node the change added. */\n  from: TPose | undefined;\n  to: TPose;\n  origin: PoseWriteOrigin;\n  /** The edit's label (`'setPose'`, a batch's, an action's `'Move'`) for\n   *  `'call'` and `'ops'`; `undefined` otherwise. */\n  label?: string;\n}\n\n/** A removed node as it was last shown, with the descendants it took along. */\nexport interface RemovedNode<TPose, TNode = unknown> {\n  /** The node as it stood before the change removed it. */\n  node: TNode;\n  /** Where it was shown, override included, in its stored frame. */\n  pose: TPose;\n  children: readonly RemovedNode<TPose, TNode>[];\n}\n\n/** One node a scene change removed, a removal's root: its descendants ride\n *  beneath it rather than being reported apart. */\nexport interface PoseRemoval<TPose, TNode = unknown> extends RemovedNode<TPose, TNode> {\n  id: NodeId;\n  /** The parent it was removed from, which may still be in the scene. */\n  parent: NodeId | null;\n  origin: PoseWriteOrigin;\n  label?: string;\n}\n\n/** What a scene reports about the poses its edits write. */\nexport interface ScenePoseReports<TPose, TNode = unknown> {\n  /** Called with the poses each live edit's layout pass wrote, after the\n   *  edit lands — never for an undo or redo, which restore poses rather than\n   *  arrange them. What a reflow animation glides from. */\n  onReflow(listener: (moves: readonly LayoutMove<TPose>[]) => void): () => void;\n  /** Called once per change, before the scene's subscribers hear of it, with\n   *  every node whose pose the change wrote or that it added, and every node\n   *  it removed — an undone add among them. A node written back to the pose\n   *  it had, or both added and removed by the change, is left out of both.\n   *  Not called for `loadState` or the scene's initial nodes. */\n  onPoseWrite(\n    listener: (writes: readonly PoseWrite<TPose>[], removed: readonly PoseRemoval<TPose, TNode>[]) => void,\n  ): () => void;\n}\n\n/** What the log reads of the scene it reports for. */\nexport interface PoseWriteEnv<TPose, TNode> {\n  /** A node still in the scene, with the pose it is shown at. */\n  shown(id: NodeId): { node: TNode; pose: TPose } | undefined;\n  /** Whether the edit running now is inside `scene.untracked`. */\n  untracked(): boolean;\n  /** The scene's change notice. The log reports on it, subscribed before\n   *  anyone else so a change's writes arrive ahead of its re-reads. */\n  changes: { subscribe(listener: () => void): () => void };\n}\n\nexport interface PoseWriteLog<TPose, TNode = unknown> {\n  subscribe: ScenePoseReports<TPose, TNode>['onPoseWrite'];\n  /** Run `fn` as an edit labeled `label`; an enclosing edit's label stands. */\n  labeled<T>(label: string, via: 'call' | 'ops', fn: () => T): T;\n  /** Run `fn` as a history step replaying recorded ops. */\n  replaying<T>(fn: () => T): T;\n  /** Run `fn` as a layout pass writing arranged poses. */\n  layout<T>(fn: () => T): T;\n  /** Run `fn` with nothing it writes reported. */\n  quiet<T>(fn: () => T): T;\n  /** `register` with the kit's pose-bearing ops reporting what they write. */\n  reporting(register: (kind: string, handler: RegisteredOp<unknown>) => void):\n    (kind: string, handler: RegisteredOp<unknown>) => void;\n}\n\nconst NOTHING = (): void => {};\n\ninterface Posed<TPose> { id: NodeId; pose: TPose }\ninterface Parented { id: NodeId; parent: NodeId | null }\n\nexport function createPoseWriteLog<TPose, TNode = unknown>(env: PoseWriteEnv<TPose, TNode>): PoseWriteLog<TPose, TNode> {\n  const listeners = createEmitter<[writes: readonly PoseWrite<TPose>[], removed: readonly PoseRemoval<TPose, TNode>[]]>();\n  const pending = new Map<NodeId, PoseWrite<TPose>>();\n  const removals = createRemovalLog<TPose, TNode>(env.shown);\n  // Two fields rather than one object: every bare scene call opens an edit.\n  let editLabel: string | null = null;\n  let editVia: 'call' | 'ops' = 'call';\n  let replays = 0;\n  let layouts = 0;\n  let quiets = 0;\n  let listening = 0;\n\n  const collecting = (): boolean => listening > 0 && quiets === 0;\n\n  function stamp(reverted: boolean): Pick<PoseWrite<TPose>, 'origin' | 'label'> {\n    if (replays > 0) return { origin: reverted ? 'undo' : 'redo' };\n    if (layouts > 0) return { origin: 'layout' };\n    if (env.untracked()) return { origin: 'untracked' };\n    return editLabel !== null ? { origin: editVia, label: editLabel } : { origin: 'call' };\n  }\n\n  function noteSet(id: NodeId, from: TPose, to: TPose, reverted: boolean): void {\n    if (!collecting()) return;\n    const held = pending.get(id);\n    if (held) held.to = to;\n    else pending.set(id, { id, from, to, ...stamp(reverted) });\n  }\n\n  function noteAdded(nodes: readonly Posed<TPose>[], reverted: boolean): void {\n    if (!collecting()) return;\n    for (const n of nodes) {\n      // Removed and back within one change: it moved, if anything.\n      pending.set(n.id, { id: n.id, from: removals.takeBack(n.id), to: n.pose, ...stamp(reverted) });\n    }\n  }\n\n  const seeOff = (roots: readonly Parented[], nodes: readonly Parented[], reverted: boolean): () => void =>\n    collecting() ? removals.seeOff(roots, nodes, stamp(reverted), pending) : NOTHING;\n\n  function around<T>(fn: () => T, enter: () => void, leave: () => void): T {\n    enter();\n    try {\n      return fn();\n    } finally {\n      leave();\n    }\n  }\n\n  type SetPayload = { id: NodeId; from: TPose; to: TPose };\n  type AddPayload = Posed<TPose> & Parented;\n  type RemovePayload = { nodes: readonly (Posed<TPose> & Parented)[]; detached: readonly Parented[] };\n  const wrap: Record<string, (h: RegisteredOp<unknown>) => RegisteredOp<unknown>> = {\n    'kit:setPose': (h) => ({\n      ...h,\n      apply: (p) => { h.apply(p); const s = p as SetPayload; noteSet(s.id, s.from, s.to, false); },\n      revert: (p) => { h.revert(p); const s = p as SetPayload; noteSet(s.id, s.to, s.from, true); },\n    }),\n    'kit:add': (h) => ({\n      ...h,\n      apply: (p) => { h.apply(p); if (collecting()) noteAdded([p as AddPayload], false); },\n      revert: (p) => { const done = seeOff([p as AddPayload], [p as AddPayload], true); h.revert(p); done(); },\n    }),\n    'kit:remove': (h) => ({\n      ...h,\n      apply: (p) => {\n        const r = p as RemovePayload;\n        const done = seeOff(r.detached, r.nodes, false);\n        h.apply(p);\n        done();\n      },\n      revert: (p) => { h.revert(p); noteAdded((p as RemovePayload).nodes, true); },\n    }),\n  };\n\n  function flush(): void {\n    const removed = removals.drain();\n    if (pending.size === 0 && removed.length === 0) return;\n    const writes = [...pending.values()].filter((w) => !deepEqual(w.from, w.to));\n    pending.clear();\n    if (writes.length > 0 || removed.length > 0) listeners.emit(writes, removed);\n  }\n  env.changes.subscribe(flush);\n\n  return {\n    subscribe(listener) {\n      const off = listeners.subscribe(listener);\n      listening++;\n      let on = true;\n      return () => {\n        if (!on) return;\n        on = false;\n        listening--;\n        off();\n      };\n    },\n    labeled(label, via, fn) {\n      if (editLabel !== null) return fn();\n      editLabel = label;\n      editVia = via;\n      try {\n        return fn();\n      } finally {\n        editLabel = null;\n      }\n    },\n    replaying: (fn) => around(fn, () => { replays++; }, () => { replays--; }),\n    layout: (fn) => around(fn, () => { layouts++; }, () => { layouts--; }),\n    quiet: (fn) => around(fn, () => { quiets++; }, () => { quiets--; }),\n    reporting: (register) => (kind, handler) => register(kind, wrap[kind]?.(handler) ?? handler),\n  };\n}\n"],"mappings":"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"}

package/dist/core/scene/reconcileSpecs.js

@@ -1,6 +1,6 @@
 import { sameValue } from "./sameValue.js";
 
-//#region src/core/scene/reconcileSpecs.ts
+// src/core/scene/reconcileSpecs.ts
 /**
 * Bring `scene` from `prev` to `next`: add what `next` gained, remove what it
 * lost, and write only the fields that changed between the two.
@@ -11,7 +11,9 @@ import { sameValue } from "./sameValue.js";
 * outside data is not an undo step.
 *
 * Every spec needs an `id`, and `next` must be in an order `createScene` would
-* accept — parents and dependencies before what names them. A node whose
+* accept — parents and dependencies before what names them. Siblings stand in
+* `next`'s order wherever a parent's children in it differ from `prev`'s, by an
+* addition or a reorder; elsewhere a reorder made in the scene stays. A node whose
 * `kind` or derive functions change is removed and added again, along with
 * everything its removal takes with it, and stays selected if it was.
 */
@@ -47,9 +49,31 @@ function reconcileSpecs(scene, prev, next) {
 			if (spec.hidden === true !== (before.hidden === true)) scene.setHidden(id, spec.hidden === true);
 			if (spec.locked === true && before.locked !== true) scene.setLocked(id, true);
 		}
+		reorderToSpecs(scene, prev, next);
 		if (selected.some((id) => removed.has(id))) scene.setSelection(selected.filter((id) => scene.get(id) !== void 0));
 	});
 }
+/** Each parent whose spec children `next` lists differently from `prev` gets
+*  them in `next`'s order, in the slots they hold among its children now, so
+*  a child no spec names keeps its place. */
+function reorderToSpecs(scene, prev, next) {
+	const before = childLists(prev);
+	for (const [parent, wanted] of childLists(next)) {
+		if (sameValue(wanted, before.get(parent))) continue;
+		const named = new Set(wanted);
+		const siblings = parent === null ? scene.roots : scene.childrenOf(parent);
+		const slots = siblings.flatMap((id, i) => named.has(id) ? [i] : []);
+		wanted.filter((id) => siblings.includes(id)).forEach((id, k) => scene.reorder(id, slots[k]));
+	}
+}
+function childLists(specs) {
+	const out = /* @__PURE__ */ new Map();
+	for (const spec of specs) {
+		const parent = spec.parent ?? null;
+		out.set(parent, [...out.get(parent) ?? [], spec.id]);
+	}
+	return out;
+}
 function byId(specs) {
 	const out = /* @__PURE__ */ new Map();
 	for (const spec of specs) {
@@ -63,6 +87,5 @@ function needsReplace(a, b) {
 	return a.kind !== b.kind || a.pickable !== b.pickable || a.consumesChildren !== b.consumesChildren || a.derivePath !== b.derivePath || a.derivePose !== b.derivePose || a.clipFromPose !== b.clipFromPose || a.copiesFromPose !== b.copiesFromPose || a.layout !== b.layout;
 }
 
-//#endregion
 export { reconcileSpecs };
 //# sourceMappingURL=reconcileSpecs.js.map

package/dist/core/scene/reconcileSpecs.js.map

@@ -1 +1 @@
-{"version":3,"file":"reconcileSpecs.js","names":["same"],"sources":["../../../src/core/scene/reconcileSpecs.ts"],"sourcesContent":["import { sameValue as same } from './sameValue';\nimport type { AddNodeSpec, NodeId, Scene } from './types';\n\n/**\n * Bring `scene` from `prev` to `next`: add what `next` gained, remove what it\n * lost, and write only the fields that changed between the two.\n *\n * The diff is spec against spec, not spec against scene, so whatever the scene\n * did since `prev` — a node dragged, an edge authored by a gesture — survives\n * unless `next` changes that same field. The writes are untracked: syncing to\n * outside data is not an undo step.\n *\n * Every spec needs an `id`, and `next` must be in an order `createScene` would\n * accept — parents and dependencies before what names them. A node whose\n * `kind` or derive functions change is removed and added again, along with\n * everything its removal takes with it, and stays selected if it was.\n */\nexport function reconcileSpecs<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  prev: readonly AddNodeSpec<TData, TLayer, TPose>[],\n  next: readonly AddNodeSpec<TData, TLayer, TPose>[],\n): void {\n  const prevById = byId(prev);\n  const nextById = byId(next);\n  const gone: NodeId[] = [];\n  for (const [id, before] of prevById) {\n    const after = nextById.get(id);\n    if (after === undefined || needsReplace(before, after)) gone.push(id);\n  }\n  const removing = scene.removalClosure(gone.filter((id) => scene.get(id) !== undefined));\n  const removed = new Set(removing);\n\n  // A replaced node is the same node to whoever selected it.\n  const selected = scene.getSelection();\n\n  scene.untracked(() => {\n    scene.removeMany(removing);\n    for (const spec of next) {\n      const id = spec.id!;\n      const before = prevById.get(id);\n      if (scene.get(id) === undefined || before === undefined || removed.has(id)) {\n        scene.add(spec);\n        continue;\n      }\n      // An unlock goes first and a lock last, so the writes between can land.\n      if (before.locked === true && spec.locked !== true) scene.setLocked(id, false);\n      const parent = spec.parent ?? null;\n      if (parent !== (before.parent ?? null)) scene.move(id, parent);\n      if (spec.layer !== before.layer) scene.setLayer(id, spec.layer);\n      if (!same(spec.data, before.data)) scene.update(id, { data: spec.data });\n      if (!same(spec.dependsOn, before.dependsOn)) scene.setDependsOn(id, spec.dependsOn);\n      if (!same(spec.units, before.units)) scene.setUnits(id, spec.units ?? null);\n      if (spec.clip !== before.clip) scene.setClip(id, spec.clip ?? null);\n      if (!same(spec.pose, before.pose)) scene.setPose(id, spec.pose);\n      if ((spec.hidden === true) !== (before.hidden === true)) scene.setHidden(id, spec.hidden === true);\n      if (spec.locked === true && before.locked !== true) scene.setLocked(id, true);\n    }\n    if (selected.some((id) => removed.has(id))) {\n      scene.setSelection(selected.filter((id) => scene.get(id) !== undefined));\n    }\n  });\n}\n\nfunction byId<T extends { id?: NodeId }>(specs: readonly T[]): Map<NodeId, T> {\n  const out = new Map<NodeId, T>();\n  for (const spec of specs) {\n    if (spec.id === undefined) throw new Error('reconcileSpecs: every spec needs an id');\n    if (out.has(spec.id)) throw new Error(`reconcileSpecs: id \"${spec.id}\" appears more than once`);\n    out.set(spec.id, spec);\n  }\n  return out;\n}\n\nfunction needsReplace<TData, TLayer extends string, TPose>(\n  a: AddNodeSpec<TData, TLayer, TPose>,\n  b: AddNodeSpec<TData, TLayer, TPose>,\n): boolean {\n  return a.kind !== b.kind\n    || a.pickable !== b.pickable\n    || a.consumesChildren !== b.consumesChildren\n    || a.derivePath !== b.derivePath\n    || a.derivePose !== b.derivePose\n    || a.clipFromPose !== b.clipFromPose\n    || a.copiesFromPose !== b.copiesFromPose\n    || a.layout !== b.layout;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,eACd,OACA,MACA,MACM;CACN,MAAM,WAAW,KAAK,IAAI;CAC1B,MAAM,WAAW,KAAK,IAAI;CAC1B,MAAM,OAAiB,CAAC;CACxB,KAAK,MAAM,CAAC,IAAI,WAAW,UAAU;EACnC,MAAM,QAAQ,SAAS,IAAI,EAAE;EAC7B,IAAI,UAAU,UAAa,aAAa,QAAQ,KAAK,GAAG,KAAK,KAAK,EAAE;CACtE;CACA,MAAM,WAAW,MAAM,eAAe,KAAK,QAAQ,OAAO,MAAM,IAAI,EAAE,MAAM,MAAS,CAAC;CACtF,MAAM,UAAU,IAAI,IAAI,QAAQ;CAGhC,MAAM,WAAW,MAAM,aAAa;CAEpC,MAAM,gBAAgB;EACpB,MAAM,WAAW,QAAQ;EACzB,KAAK,MAAM,QAAQ,MAAM;GACvB,MAAM,KAAK,KAAK;GAChB,MAAM,SAAS,SAAS,IAAI,EAAE;GAC9B,IAAI,MAAM,IAAI,EAAE,MAAM,UAAa,WAAW,UAAa,QAAQ,IAAI,EAAE,GAAG;IAC1E,MAAM,IAAI,IAAI;IACd;GACF;GAEA,IAAI,OAAO,WAAW,QAAQ,KAAK,WAAW,MAAM,MAAM,UAAU,IAAI,KAAK;GAC7E,MAAM,SAAS,KAAK,UAAU;GAC9B,IAAI,YAAY,OAAO,UAAU,OAAO,MAAM,KAAK,IAAI,MAAM;GAC7D,IAAI,KAAK,UAAU,OAAO,OAAO,MAAM,SAAS,IAAI,KAAK,KAAK;GAC9D,IAAI,CAACA,UAAK,KAAK,MAAM,OAAO,IAAI,GAAG,MAAM,OAAO,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;GACvE,IAAI,CAACA,UAAK,KAAK,WAAW,OAAO,SAAS,GAAG,MAAM,aAAa,IAAI,KAAK,SAAS;GAClF,IAAI,CAACA,UAAK,KAAK,OAAO,OAAO,KAAK,GAAG,MAAM,SAAS,IAAI,KAAK,SAAS,IAAI;GAC1E,IAAI,KAAK,SAAS,OAAO,MAAM,MAAM,QAAQ,IAAI,KAAK,QAAQ,IAAI;GAClE,IAAI,CAACA,UAAK,KAAK,MAAM,OAAO,IAAI,GAAG,MAAM,QAAQ,IAAI,KAAK,IAAI;GAC9D,IAAK,KAAK,WAAW,UAAW,OAAO,WAAW,OAAO,MAAM,UAAU,IAAI,KAAK,WAAW,IAAI;GACjG,IAAI,KAAK,WAAW,QAAQ,OAAO,WAAW,MAAM,MAAM,UAAU,IAAI,IAAI;EAC9E;EACA,IAAI,SAAS,MAAM,OAAO,QAAQ,IAAI,EAAE,CAAC,GACvC,MAAM,aAAa,SAAS,QAAQ,OAAO,MAAM,IAAI,EAAE,MAAM,MAAS,CAAC;CAE3E,CAAC;AACH;AAEA,SAAS,KAAgC,OAAqC;CAC5E,MAAM,sBAAM,IAAI,IAAe;CAC/B,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,OAAO,QAAW,MAAM,IAAI,MAAM,wCAAwC;EACnF,IAAI,IAAI,IAAI,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,uBAAuB,KAAK,GAAG,yBAAyB;EAC9F,IAAI,IAAI,KAAK,IAAI,IAAI;CACvB;CACA,OAAO;AACT;AAEA,SAAS,aACP,GACA,GACS;CACT,OAAO,EAAE,SAAS,EAAE,QACf,EAAE,aAAa,EAAE,YACjB,EAAE,qBAAqB,EAAE,oBACzB,EAAE,eAAe,EAAE,cACnB,EAAE,eAAe,EAAE,cACnB,EAAE,iBAAiB,EAAE,gBACrB,EAAE,mBAAmB,EAAE,kBACvB,EAAE,WAAW,EAAE;AACtB"}
+{"version":3,"file":"reconcileSpecs.js","names":["same"],"sources":["../../../src/core/scene/reconcileSpecs.ts"],"sourcesContent":["import { sameValue as same } from './sameValue';\nimport type { AddNodeSpec, NodeId, Scene } from './types';\n\n/**\n * Bring `scene` from `prev` to `next`: add what `next` gained, remove what it\n * lost, and write only the fields that changed between the two.\n *\n * The diff is spec against spec, not spec against scene, so whatever the scene\n * did since `prev` — a node dragged, an edge authored by a gesture — survives\n * unless `next` changes that same field. The writes are untracked: syncing to\n * outside data is not an undo step.\n *\n * Every spec needs an `id`, and `next` must be in an order `createScene` would\n * accept — parents and dependencies before what names them. Siblings stand in\n * `next`'s order wherever a parent's children in it differ from `prev`'s, by an\n * addition or a reorder; elsewhere a reorder made in the scene stays. A node whose\n * `kind` or derive functions change is removed and added again, along with\n * everything its removal takes with it, and stays selected if it was.\n */\nexport function reconcileSpecs<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  prev: readonly AddNodeSpec<TData, TLayer, TPose>[],\n  next: readonly AddNodeSpec<TData, TLayer, TPose>[],\n): void {\n  const prevById = byId(prev);\n  const nextById = byId(next);\n  const gone: NodeId[] = [];\n  for (const [id, before] of prevById) {\n    const after = nextById.get(id);\n    if (after === undefined || needsReplace(before, after)) gone.push(id);\n  }\n  const removing = scene.removalClosure(gone.filter((id) => scene.get(id) !== undefined));\n  const removed = new Set(removing);\n\n  // A replaced node is the same node to whoever selected it.\n  const selected = scene.getSelection();\n\n  scene.untracked(() => {\n    scene.removeMany(removing);\n    for (const spec of next) {\n      const id = spec.id!;\n      const before = prevById.get(id);\n      if (scene.get(id) === undefined || before === undefined || removed.has(id)) {\n        scene.add(spec);\n        continue;\n      }\n      // An unlock goes first and a lock last, so the writes between can land.\n      if (before.locked === true && spec.locked !== true) scene.setLocked(id, false);\n      const parent = spec.parent ?? null;\n      if (parent !== (before.parent ?? null)) scene.move(id, parent);\n      if (spec.layer !== before.layer) scene.setLayer(id, spec.layer);\n      if (!same(spec.data, before.data)) scene.update(id, { data: spec.data });\n      if (!same(spec.dependsOn, before.dependsOn)) scene.setDependsOn(id, spec.dependsOn);\n      if (!same(spec.units, before.units)) scene.setUnits(id, spec.units ?? null);\n      if (spec.clip !== before.clip) scene.setClip(id, spec.clip ?? null);\n      if (!same(spec.pose, before.pose)) scene.setPose(id, spec.pose);\n      if ((spec.hidden === true) !== (before.hidden === true)) scene.setHidden(id, spec.hidden === true);\n      if (spec.locked === true && before.locked !== true) scene.setLocked(id, true);\n    }\n    reorderToSpecs(scene, prev, next);\n    if (selected.some((id) => removed.has(id))) {\n      scene.setSelection(selected.filter((id) => scene.get(id) !== undefined));\n    }\n  });\n}\n\n/** Each parent whose spec children `next` lists differently from `prev` gets\n *  them in `next`'s order, in the slots they hold among its children now, so\n *  a child no spec names keeps its place. */\nfunction reorderToSpecs<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  prev: readonly AddNodeSpec<TData, TLayer, TPose>[],\n  next: readonly AddNodeSpec<TData, TLayer, TPose>[],\n): void {\n  const before = childLists(prev);\n  for (const [parent, wanted] of childLists(next)) {\n    if (same(wanted, before.get(parent))) continue;\n    const named = new Set(wanted);\n    const siblings = parent === null ? scene.roots : scene.childrenOf(parent);\n    const slots = siblings.flatMap((id, i) => (named.has(id) ? [i] : []));\n    const order = wanted.filter((id) => siblings.includes(id));\n    // Filling the slots left to right, each move leaves every earlier slot as it should end.\n    order.forEach((id, k) => scene.reorder(id, slots[k]!));\n  }\n}\n\nfunction childLists<T extends { id?: NodeId; parent?: NodeId | null }>(specs: readonly T[]): Map<NodeId | null, NodeId[]> {\n  const out = new Map<NodeId | null, NodeId[]>();\n  for (const spec of specs) {\n    const parent = spec.parent ?? null;\n    out.set(parent, [...(out.get(parent) ?? []), spec.id!]);\n  }\n  return out;\n}\n\nfunction byId<T extends { id?: NodeId }>(specs: readonly T[]): Map<NodeId, T> {\n  const out = new Map<NodeId, T>();\n  for (const spec of specs) {\n    if (spec.id === undefined) throw new Error('reconcileSpecs: every spec needs an id');\n    if (out.has(spec.id)) throw new Error(`reconcileSpecs: id \"${spec.id}\" appears more than once`);\n    out.set(spec.id, spec);\n  }\n  return out;\n}\n\nfunction needsReplace<TData, TLayer extends string, TPose>(\n  a: AddNodeSpec<TData, TLayer, TPose>,\n  b: AddNodeSpec<TData, TLayer, TPose>,\n): boolean {\n  return a.kind !== b.kind\n    || a.pickable !== b.pickable\n    || a.consumesChildren !== b.consumesChildren\n    || a.derivePath !== b.derivePath\n    || a.derivePose !== b.derivePose\n    || a.clipFromPose !== b.clipFromPose\n    || a.copiesFromPose !== b.copiesFromPose\n    || a.layout !== b.layout;\n}\n"],"mappings":"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"}

package/dist/core/scene/recorder.js

@@ -1,6 +1,6 @@
 import { bindOpToAdapter } from "./boundOps.js";
 
-//#region src/core/scene/recorder.ts
+// src/core/scene/recorder.ts
 /** Take back ops that wrote outside the scene, newest first. The scene's own
 *  writes are reverted by the applied log. */
 function unwind(outer) {
@@ -123,6 +123,5 @@ function createRecorder(env) {
 	};
 }
 
-//#endregion
 export { createRecorder };
 //# sourceMappingURL=recorder.js.map

package/dist/core/scene/renderOrder.js

@@ -1,6 +1,6 @@
 import { hasChildren } from "./treeShape.js";
 
-//#region src/core/scene/renderOrder.ts
+// src/core/scene/renderOrder.ts
 /**
 * A scene's render order: its nodes layer-major, each layer in tree preorder,
 * cached until the structure changes.
@@ -131,6 +131,5 @@ function createRenderOrder(state) {
 	};
 }
 
-//#endregion
 export { createRenderOrder };
 //# sourceMappingURL=renderOrder.js.map

package/dist/core/scene/sameValue.js

@@ -1,6 +1,6 @@
 import { isPlainObject } from "../isPlainObject.js";
 
-//#region src/core/scene/sameValue.ts
+// src/core/scene/sameValue.ts
 /** Structural equality over plain objects and arrays; anything else by identity. */
 function sameValue(a, b) {
 	if (Object.is(a, b)) return true;
@@ -12,6 +12,5 @@ function sameValue(a, b) {
 	return false;
 }
 
-//#endregion
 export { sameValue };
 //# sourceMappingURL=sameValue.js.map

package/dist/core/scene/scene.js

@@ -1,24 +1,24 @@
-import { RIGID_POSE_COMPOSITION } from "./composePose.js";
-import { effectivePose } from "./effectivePose.js";
-import { createScrollOffsets } from "./scrollOffsets.js";
-import { asNodeId } from "./types.js";
-import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { withKitRegistry } from "./kitRegistry.js";
 import { createPoseOverrides } from "./poseOverrides.js";
+import { createScrollOffsets } from "./scrollOffsets.js";
 import { createArrivalWindow } from "./arrivalWindow.js";
+import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { createNotifier } from "./notifier.js";
 import { sceneChanges } from "./sceneChanges.js";
 import { createPoseWriteLog } from "./poseWrites.js";
+import { effectivePose } from "./effectivePose.js";
 import { createEditMode } from "./editMode.js";
-import { resolveLayoutFrame, runLayoutPass } from "./layoutPass.js";
-import { systemLayerRecord } from "./layerStack.js";
 import { createSceneEdits } from "./sceneEdits.js";
 import { createSceneRecording } from "./sceneRecording.js";
 import { createSceneSelection } from "./sceneSelection.js";
-import { layerFromSerialized, specsFromSerialized } from "./serialization.js";
 import { createSceneState } from "./sceneState.js";
+import { systemLayerRecord } from "./layerStack.js";
+import { layerFromSerialized, specsFromSerialized } from "./serialization.js";
+import { resolveLayoutFrame, runLayoutPass } from "./layoutPass.js";
+import { RIGID_POSE_COMPOSITION } from "./composePose.js";
+import { asNodeId } from "./types.js";
 
-//#region src/core/scene/scene.ts
+// src/core/scene/scene.ts
 /** A node still in `scene`, with the pose it is shown at. */
 function shownNode(scene, id) {
 	const node = scene.get(id);
@@ -59,7 +59,7 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 		writePose
 	});
 	const generateId = options.generateId ?? defaultGenerateId;
-	const selection = createSceneSelection(locks.reachable);
+	const selection = createSceneSelection(locks.reachable, (id) => state.nodes.get(id)?.parent);
 	selection.subscribe(notifier.notify);
 	/** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */
 	const overrides = createPoseOverrides((id) => state.nodes.get(id), doc.store.invalidateDependents);
@@ -133,7 +133,7 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 			doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);
 			recording.clearHistory();
 			poseWrites.quiet(() => edits.construct(specs));
-			selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));
+			selection.replace(selection.legal(selection.get().filter((id) => state.nodes.has(id))));
 			notifier.notify();
 		},
 		...sceneChanges(notifier, selection)
@@ -154,6 +154,5 @@ function sceneFromJSON(json, options = {}) {
 	return buildScene(options, json.systemLayers.map(layerFromSerialized), (registry) => specsFromSerialized(json, registry, options), json.doc);
 }
 
-//#endregion
 export { createScene, sceneFromJSON };
 //# sourceMappingURL=scene.js.map

package/dist/core/scene/scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createScrollOffsets } from './scrollOffsets';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { documentReads, sceneMutators } from './sceneMutators';\nimport { createNotifier } from './notifier';\nimport type { SerializedDoc } from './docValues';\nimport { sceneChanges } from './sceneChanges';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized, type SpecsFromSerializedOptions } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport type { SceneOptions } from './useSceneOptions';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SavedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<SceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial' | 'doc'>;\n\n/** A scene holding `layers`, the document values `initialDoc`, and the nodes\n *  `initialNodes` answers with once it is handed the registry their functions\n *  resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n  initialDoc: SerializedDoc | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot carrying a kit-attached\n  // function (a grouped container's derived pose) reloads in any scene, not only one that registered it.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared(), initialDoc);\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void => poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = options.generateId ?? defaultGenerateId;\n  const selection = createSceneSelection(locks.reachable);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */\n  const overrides = createPoseOverrides<TPose, TData>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n  const scroll = createScrollOffsets();\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    passAdapter: () => ({ ...sceneMutators(scene), ...documentReads(scene) }),\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (RIGID_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n    scroll,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json, opts) {\n      // Validate + map up front: throws on a bad version or registry key before live state is touched.\n      const specs = specsFromSerialized(json, registry, { composition: scene.composition, ...opts });\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      scroll.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    ...sceneChanges(notifier, selection),\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: SceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: SceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAS,UAA+C,OAAoC,IAAY;CACtG,MAAM,OAAO,MAAM,IAAI,EAAE;CACzB,OAAO,QAAQ;EAAE;EAAM,MAAM,cAAc,OAAO,IAAI;CAAE;AAC1D;AAEA,IAAI,mBAAmB;AACvB,IAAM,0BACJ,SAAS,KAAK,mBAAA,CAAoB,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG;;;;AAK5F,SAAgB,YACd,SAC6B;CAC7B,OAAO,WAAW,UAAU,QAAQ,gBAAgB,CAAC,EAAA,CAAG,IAAI,iBAAiB,SAAS,QAAQ,SAAS,QAAQ,GAAG;AACpH;;;;AAQA,SAAS,WACP,SACA,QACA,cACA,YAC6B;CAC7B,IAAI,OAAO,WAAW,GAAG,MAAM,IAAI,MAAM,qDAAqD;CAI9F,MAAM,WAAW,gBAAgB,QAAQ,YAAY,CAAC,CAAC;CAEvD,MAAM,MAAM,iBAAuC,UAAU,cAAc,SAAS,eAAe,GAAG,UAAU;CAChH,MAAM,EAAE,OAAO,OAAO,UAAU;CAChC,MAAM,WAAW,eAAe;CAChC,MAAM,OAAO,eAAe;CAC5B,MAAM,aAAa,mBAAmB;EAAE,WAAW,KAAK;EAAW,SAAS;EAAU,QAAQ,OAAO,UAAU,OAAO,EAAE;CAAE,CAAC;CAC3H,MAAM,aAAa,IAAY,SAAwB,WAAW,aAAa,MAAM,QAAQ,SAAS,EAAE,GAAG,IAAa,CAAC;CAEzH,MAAM,cAAc,mBAAmB,QAAQ,WAAW;CAC1D,MAAM,WAAW,oBAA0C;EACzD,OAAO,MAAM;EACb,aAAa,SAAS,SAAS,aAC7B,cAAc,OAAO,MAAM,UAAU,SAAS,SAAS,aAAa,QAAQ;EAC9E,wBAAwB,CAAC,KAAK,KAAK;EACnC;CACF,CAAC;CAED,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,YAAY,qBAAqB,MAAM,SAAS;CAEtD,UAAU,UAAU,SAAS,MAAM;;CAGnC,MAAM,YAAY,qBAAmC,OAAO,MAAM,MAAM,IAAI,EAAE,GAAG,IAAI,MAAM,oBAAoB;CAC/G,MAAM,SAAS,oBAAoB;CAEnC,MAAM,YAAY,qBAAqB;EACrC;EACA;EACA,oBAAoB;GAAE,GAAG,cAAc,KAAK;GAAG,GAAG,cAAc,KAAK;EAAE;EACvE,OAAO,IAAI;EACX,QAAQ,MAAM;EACd;EACA;EACA;EACA;EACA,QAAQ;CACV,CAAC;CAED,MAAM,QAAQ,iBAAuC;EACnD;EACA,OAAO,IAAI;EACX;EACA,QAAQ,IAAI;EACZ,iBAAiB,IAAI,MAAM;EAC3B,UAAU,IAAI;EACd,KAAK;GAAE,GAAG,UAAU;GAAK,UAAU,WAAW,UAAU,UAAU,IAAI,QAAQ;EAAE;EAChF,UAAU,UAAU;EACpB;EACA;EACA;EACA,iBAAiB,UAAU;EAC3B,eAAe,UAAU;CAC3B,CAAC;CACD,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,QAAQ,OAAO,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,MAAM,OAAO;CAErG,MAAM,QAAqC;EACzC,IAAI,QAAQ;GAAE,OAAO,MAAM;EAAO;EAClC,IAAI,QAAQ;GAAE,OAAO,MAAM;EAAO;EAClC,IAAI,SAAS;GAAE,OAAO,MAAM;EAAQ;EACpC;EAEA,GAAG;EAEH,QAAQ;EACR,aAAa,QAAQ,eAAgB;EAErC,GAAG,MAAM;EACT,GAAG,UAAU;EAEb,WAAW,OAAO,MAAM,OAAO,EAAE;EAEjC,mBAAmB,SAAS;EAC5B,UAAU,SAAS;EACnB,aAAa,WAAW;EAExB;EACA;EAEA,cAAc,UAAU;EACxB,eAAe,QAAQ,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC;EAE7C,UAAU,MAAM,MAAM;GAEpB,MAAM,QAAQ,oBAAoB,MAAM,UAAU;IAAE,aAAa,MAAM;IAAa,GAAG;GAAK,CAAC;GAC7F,IAAI,KAAK,KAAK,GACZ,MAAM,IAAI,MAAM,+FAA+F;GAGjH,UAAU,SAAS;GACnB,OAAO,SAAS;GAChB,IAAI,MAAM,KAAK,aAAa,IAAI,mBAAmB,GAAG,KAAK,GAAG;GAC9D,UAAU,aAAa;GACvB,WAAW,YAAY,MAAM,UAAU,KAAK,CAAC;GAC7C,UAAU,QAAQ,MAAM,UAAU,UAAU,IAAI,CAAC,CAAC,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;GACtF,SAAS,OAAO;EAClB;EAEA,GAAG,aAAa,UAAU,SAAS;CACrC;CAEA,MAAM,UAAU,aAAa,QAAQ;CACrC,IAAI,SAAS;EACX,WAAW,YAAY,MAAM,UAAU,OAAO,CAAC;EAC/C,SAAS,OAAO;CAClB;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,cACd,MACA,UAQuD,CAAC,GAC3B;CAC7B,OAAO,WACL,SACA,KAAK,aAAa,IAAI,mBAAmB,IACxC,aAAa,oBAAoB,MAAM,UAAU,OAAO,GACzD,KAAK,GACP;AACF"}
+{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createScrollOffsets } from './scrollOffsets';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { documentReads, sceneMutators } from './sceneMutators';\nimport { createNotifier } from './notifier';\nimport type { SerializedDoc } from './docValues';\nimport { sceneChanges } from './sceneChanges';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized, type SpecsFromSerializedOptions } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport type { SceneOptions } from './useSceneOptions';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SavedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<SceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial' | 'doc'>;\n\n/** A scene holding `layers`, the document values `initialDoc`, and the nodes\n *  `initialNodes` answers with once it is handed the registry their functions\n *  resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n  initialDoc: SerializedDoc | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot carrying a kit-attached\n  // function (a grouped container's derived pose) reloads in any scene, not only one that registered it.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared(), initialDoc);\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void => poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = options.generateId ?? defaultGenerateId;\n  const selection = createSceneSelection(locks.reachable, (id) => state.nodes.get(id)?.parent);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */\n  const overrides = createPoseOverrides<TPose, TData>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n  const scroll = createScrollOffsets();\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    passAdapter: () => ({ ...sceneMutators(scene), ...documentReads(scene) }),\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (RIGID_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n    scroll,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json, opts) {\n      // Validate + map up front: throws on a bad version or registry key before live state is touched.\n      const specs = specsFromSerialized(json, registry, { composition: scene.composition, ...opts });\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      scroll.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(selection.legal(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    ...sceneChanges(notifier, selection),\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: SceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: SceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\n  );\n}\n"],"mappings":"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"}

package/dist/core/scene/sceneChanges.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/sceneChanges.ts
+// src/core/scene/sceneChanges.ts
 /** A scene's change members, over its notifier and its selection's own count of changes. */
 function sceneChanges(notifier, selection) {
 	return {
@@ -8,6 +8,5 @@ function sceneChanges(notifier, selection) {
 	};
 }
 
-//#endregion
 export { sceneChanges };
 //# sourceMappingURL=sceneChanges.js.map

package/dist/core/scene/sceneEdits.js

@@ -6,7 +6,7 @@ import { createNodeFlags } from "./nodeFlags.js";
 import { createLayerEdits } from "./layerStack.js";
 import { createTreeEdits } from "./treeEdits.js";
 
-//#region src/core/scene/sceneEdits.ts
+// src/core/scene/sceneEdits.ts
 function createSceneEdits(env) {
 	const { state, store, locks, layers, fnFields, recorder, arrivals } = env;
 	const { layoutRefs } = registerKitOps({
@@ -84,6 +84,5 @@ function createSceneEdits(env) {
 	};
 }
 
-//#endregion
 export { createSceneEdits };
 //# sourceMappingURL=sceneEdits.js.map

package/dist/core/scene/sceneJournals.js

@@ -0,0 +1,77 @@
+// src/core/scene/sceneJournals.ts
+/** A journal drives adapter mutation itself, so its applies and undos
+*  re-enter scene mutation methods the way the facade's do. */
+function wrapJournal(raw, env, open) {
+	const { replay, notify } = env;
+	const wrapped = {
+		targetId: raw.targetId,
+		forkedAtEntryId: raw.forkedAtEntryId,
+		applyBatch(ops, label) {
+			env.labeled(label, () => env.runArrivalEdit(ops, (all) => {
+				env.applying(() => raw.applyBatch(all.map(env.causing), label));
+				notify();
+			}));
+		},
+		undo() {
+			replay(() => raw.undo());
+			notify();
+		},
+		redo() {
+			replay(() => raw.redo());
+			notify();
+		},
+		canUndo: () => raw.canUndo(),
+		canRedo: () => raw.canRedo(),
+		entries: () => raw.entries(),
+		seal: () => raw.seal(),
+		observe: (listener) => raw.observe(listener),
+		beginJournal: (opts) => open.wrap(raw.beginJournal(opts)),
+		getVersion: () => raw.getVersion(),
+		subscribe: (listener) => raw.subscribe(listener),
+		commit(label) {
+			raw.commit(label);
+			open.close(wrapped);
+			notify();
+		},
+		cancel() {
+			replay(() => raw.cancel());
+			open.close(wrapped);
+			notify();
+		},
+		suspend: () => raw.suspend(),
+		isActive: () => raw.isActive()
+	};
+	return wrapped;
+}
+function createSceneJournals(env) {
+	/** Wrapped journal → the engine's own: the engine keys resumability off
+	*  journal identity, which a wrapper would not match. */
+	const raws = /* @__PURE__ */ new WeakMap();
+	const opened = [];
+	const open = {
+		wrap(raw) {
+			const wrapped = wrapJournal(raw, env, open);
+			raws.set(wrapped, raw);
+			opened.push(wrapped);
+			return wrapped;
+		},
+		close(wrapped) {
+			const i = opened.indexOf(wrapped);
+			if (i >= 0) opened.splice(i, 1);
+		}
+	};
+	return {
+		begin(opts) {
+			const parent = env.activeJournal();
+			return open.wrap(parent ? (raws.get(parent) ?? parent).beginJournal(opts) : env.engine.beginJournal(opts));
+		},
+		resume: (journal) => env.engine.resumeJournal(raws.get(journal) ?? journal),
+		innermost() {
+			for (let i = opened.length - 1; i >= 0; i--) if (opened[i].isActive()) return opened[i];
+			return null;
+		}
+	};
+}
+
+export { createSceneJournals };
+//# sourceMappingURL=sceneJournals.js.map

package/dist/core/scene/sceneJournals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneJournals.js","names":[],"sources":["../../../src/core/scene/sceneJournals.ts"],"sourcesContent":["/**\n * The journals opened on `scene.history`: each wrapped so its applies and\n * undos re-enter scene mutation the way the facade's do, and tracked while\n * open, so the scene's edits go to the innermost.\n */\nimport type { BeginJournalOptions, Journal } from '@weasel-js/history';\nimport type { SceneHistoryEnv } from './historyFacade';\n\ninterface OpenJournals {\n  wrap(raw: Journal): Journal;\n  close(wrapped: Journal): void;\n}\n\n/** A journal drives adapter mutation itself, so its applies and undos\n *  re-enter scene mutation methods the way the facade's do. */\nfunction wrapJournal(raw: Journal, env: SceneHistoryEnv, open: OpenJournals): Journal {\n  const { replay, notify } = env;\n  const wrapped: Journal = {\n    targetId: raw.targetId,\n    forkedAtEntryId: raw.forkedAtEntryId,\n    applyBatch(ops, label) {\n      env.labeled(label, () => env.runArrivalEdit(ops, (all) => {\n        env.applying(() => raw.applyBatch(all.map(env.causing), label));\n        notify();\n      }));\n    },\n    undo() {\n      replay(() => raw.undo());\n      notify();\n    },\n    redo() {\n      replay(() => raw.redo());\n      notify();\n    },\n    canUndo: () => raw.canUndo(),\n    canRedo: () => raw.canRedo(),\n    entries: () => raw.entries(),\n    seal: () => raw.seal(),\n    observe: (listener) => raw.observe(listener),\n    beginJournal: (opts) => open.wrap(raw.beginJournal(opts)),\n    getVersion: () => raw.getVersion(),\n    subscribe: (listener) => raw.subscribe(listener),\n    commit(label) {\n      // Flushes the session's net ops to the parent stack — no apply, but\n      // the parent's undo depth changes and listeners read that.\n      raw.commit(label);\n      open.close(wrapped);\n      notify();\n    },\n    cancel() {\n      replay(() => raw.cancel());\n      open.close(wrapped);\n      notify();\n    },\n    suspend: () => raw.suspend(),\n    isActive: () => raw.isActive(),\n  };\n  return wrapped;\n}\n\nexport interface SceneJournals {\n  /** Open a journal inside the one edits go to now, else on the engine: an\n   *  edit session started during a mode's lands in the mode's as one entry. */\n  begin(opts: BeginJournalOptions): Journal;\n  resume(journal: Journal): void;\n  /** The innermost active journal opened here, or null. */\n  innermost(): Journal | null;\n}\n\nexport function createSceneJournals(env: SceneHistoryEnv): SceneJournals {\n  /** Wrapped journal → the engine's own: the engine keys resumability off\n   *  journal identity, which a wrapper would not match. */\n  const raws = new WeakMap<Journal, Journal>();\n  const opened: Journal[] = [];\n  const open: OpenJournals = {\n    wrap(raw) {\n      const wrapped = wrapJournal(raw, env, open);\n      raws.set(wrapped, raw);\n      opened.push(wrapped);\n      return wrapped;\n    },\n    close(wrapped) {\n      const i = opened.indexOf(wrapped);\n      if (i >= 0) opened.splice(i, 1);\n    },\n  };\n  return {\n    begin(opts) {\n      const parent = env.activeJournal();\n      return open.wrap(parent ? (raws.get(parent) ?? parent).beginJournal(opts) : env.engine.beginJournal(opts));\n    },\n    resume: (journal) => env.engine.resumeJournal(raws.get(journal) ?? journal),\n    innermost() {\n      for (let i = opened.length - 1; i >= 0; i--) if (opened[i]!.isActive()) return opened[i]!;\n      return null;\n    },\n  };\n}\n"],"mappings":";;;AAeA,SAAS,YAAY,KAAc,KAAsB,MAA6B;CACpF,MAAM,EAAE,QAAQ,WAAW;CAC3B,MAAM,UAAmB;EACvB,UAAU,IAAI;EACd,iBAAiB,IAAI;EACrB,WAAW,KAAK,OAAO;GACrB,IAAI,QAAQ,aAAa,IAAI,eAAe,MAAM,QAAQ;IACxD,IAAI,eAAe,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,CAAC;IAC9D,OAAO;GACT,CAAC,CAAC;EACJ;EACA,OAAO;GACL,aAAa,IAAI,KAAK,CAAC;GACvB,OAAO;EACT;EACA,OAAO;GACL,aAAa,IAAI,KAAK,CAAC;GACvB,OAAO;EACT;EACA,eAAe,IAAI,QAAQ;EAC3B,eAAe,IAAI,QAAQ;EAC3B,eAAe,IAAI,QAAQ;EAC3B,YAAY,IAAI,KAAK;EACrB,UAAU,aAAa,IAAI,QAAQ,QAAQ;EAC3C,eAAe,SAAS,KAAK,KAAK,IAAI,aAAa,IAAI,CAAC;EACxD,kBAAkB,IAAI,WAAW;EACjC,YAAY,aAAa,IAAI,UAAU,QAAQ;EAC/C,OAAO,OAAO;GAGZ,IAAI,OAAO,KAAK;GAChB,KAAK,MAAM,OAAO;GAClB,OAAO;EACT;EACA,SAAS;GACP,aAAa,IAAI,OAAO,CAAC;GACzB,KAAK,MAAM,OAAO;GAClB,OAAO;EACT;EACA,eAAe,IAAI,QAAQ;EAC3B,gBAAgB,IAAI,SAAS;CAC/B;CACA,OAAO;AACT;AAWA,SAAgB,oBAAoB,KAAqC;;;CAGvE,MAAM,uBAAO,IAAI,QAA0B;CAC3C,MAAM,SAAoB,CAAC;CAC3B,MAAM,OAAqB;EACzB,KAAK,KAAK;GACR,MAAM,UAAU,YAAY,KAAK,KAAK,IAAI;GAC1C,KAAK,IAAI,SAAS,GAAG;GACrB,OAAO,KAAK,OAAO;GACnB,OAAO;EACT;EACA,MAAM,SAAS;GACb,MAAM,IAAI,OAAO,QAAQ,OAAO;GAChC,IAAI,KAAK,GAAG,OAAO,OAAO,GAAG,CAAC;EAChC;CACF;CACA,OAAO;EACL,MAAM,MAAM;GACV,MAAM,SAAS,IAAI,cAAc;GACjC,OAAO,KAAK,KAAK,UAAU,KAAK,IAAI,MAAM,KAAK,OAAA,CAAQ,aAAa,IAAI,IAAI,IAAI,OAAO,aAAa,IAAI,CAAC;EAC3G;EACA,SAAS,YAAY,IAAI,OAAO,cAAc,KAAK,IAAI,OAAO,KAAK,OAAO;EAC1E,YAAY;GACV,KAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK,IAAI,OAAO,EAAE,CAAE,SAAS,GAAG,OAAO,OAAO;GACtF,OAAO;EACT;CACF;AACF"}

package/dist/core/scene/sceneMutators.js

@@ -1,9 +1,9 @@
 import { documentPose } from "./effectivePose.js";
-import { asNodeId } from "./types.js";
 import { fnFieldsOfNode } from "./nodeFnFields.js";
 import { statedFields } from "./statedFields.js";
+import { asNodeId } from "./types.js";
 
-//#region src/core/scene/sceneMutators.ts
+// src/core/scene/sceneMutators.ts
 function sceneMutators(scene) {
 	const getChildren = (parentId) => parentId === null ? [...scene.roots] : [...scene.childrenOf(asNodeId(parentId))];
 	return {
@@ -53,6 +53,5 @@ function documentReads(scene) {
 	};
 }
 
-//#endregion
 export { documentReads, sceneMutators };
 //# sourceMappingURL=sceneMutators.js.map

package/dist/core/scene/scenePoseAdapter.js

@@ -1,7 +1,7 @@
 import { definesFrame, documentPose } from "./effectivePose.js";
 import { viewPoseAdapter } from "./scrollOffsets.js";
 
-//#region src/core/scene/scenePoseAdapter.ts
+// src/core/scene/scenePoseAdapter.ts
 /** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.
 *  `getParent` returns the live parent at call time so mid-batch
 *  parent updates compose correctly. */
@@ -24,6 +24,5 @@ function sceneViewPoseAdapter(scene) {
 	return viewPoseAdapter(scene, scenePoseAdapter(scene));
 }
 
-//#endregion
 export { scenePoseAdapter, sceneViewPoseAdapter };
 //# sourceMappingURL=scenePoseAdapter.js.map