@weasel-js/core 1.10.0 → 1.11.0

package/dist/core/scene/scene.js

@@ -1,94 +1,147 @@
-import { IDENTITY_POSE_COMPOSITION as e } from "./composeFrame.js";
-import { asNodeId as t } from "./types.js";
-import { withKitRegistry as n } from "./kitRegistry.js";
-import { createPoseOverrides as r } from "./poseOverrides.js";
-import { createArrivalWindow as i } from "./arrivalWindow.js";
-import { createNotifier as a } from "./notifier.js";
-import { createEditMode as o } from "./editMode.js";
-import { resolveLayoutFrame as s, runLayoutPass as c } from "./layoutPass.js";
-import { systemLayerRecord as l } from "./layerStack.js";
-import { createSceneEdits as u } from "./sceneEdits.js";
-import { createSceneRecording as d } from "./sceneRecording.js";
-import { createSceneSelection as f } from "./sceneSelection.js";
-import { layerFromSerialized as p, specsFromSerialized as m } from "./serialization.js";
-import { createSceneState as h } from "./sceneState.js";
+import { IDENTITY_POSE_COMPOSITION } from "./composeFrame.js";
+import { effectivePose } from "./effectivePose.js";
+import { asNodeId } from "./types.js";
+import { withKitRegistry } from "./kitRegistry.js";
+import { createPoseOverrides } from "./poseOverrides.js";
+import { createArrivalWindow } from "./arrivalWindow.js";
+import { createNotifier } from "./notifier.js";
+import { createPoseWriteLog } from "./poseWrites.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";
+
 //#region src/core/scene/scene.ts
-var g = 0, _ = () => t(`n${(g++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
-function v(e) {
-	return y(e, (e.systemLayers ?? []).map(l), () => e.initial);
+/** A node still in `scene`, with the pose it is shown at. */
+function shownNode(scene, id) {
+	const node = scene.get(id);
+	return node && {
+		node,
+		pose: effectivePose(scene, node)
+	};
+}
+var defaultIdCounter = 0;
+var defaultGenerateId = () => asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
+/** Build a scene outside React. `useScene` is the usual entry point; reach for
+*  this in tests, in headless rendering, or wherever a scene must outlive a
+*  component. Throws if no system layers are declared. */
+function createScene(options) {
+	return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial);
 }
-function y(l, g, v) {
-	if (g.length === 0) throw Error("Scene: systemLayers must declare at least one layer");
-	let y = n(l.registry ?? {}), b = h(y, g, () => O.layoutDeclared()), { state: x, locks: S, reads: C } = b, w = a(), T = o(), E = (e, n) => {
-		P.setPose(t(e), n);
-	}, D = s(l.layoutFrame), O = i({
-		nodes: x.nodes,
-		layoutPass: (e, t, n) => c(P, C.layoutOf, e, t, D, n),
-		recordsBareEdits: () => !T.open(),
-		writePose: E
-	}), k = l.generateId ?? _, A = f(S.reachable);
-	A.subscribe(w.notify);
-	let j = r((e) => x.nodes.get(e), b.store.invalidateDependents), M = d({
-		notifier: w,
-		mode: T,
-		stale: b.stale,
-		lifted: S.lifted,
-		selection: A,
-		arrivals: O,
-		writePose: E,
-		config: l
-	}), N = u({
-		state: x,
-		store: b.store,
-		locks: S,
-		layers: b.layers,
-		invalidateOrder: b.order.invalidate,
-		fnFields: b.fnFields,
-		ops: M.ops,
-		recorder: M.recorder,
-		arrivals: O,
-		layoutFrame: D,
-		generateId: k,
-		narrowSelection: A.narrow,
-		clearOverride: j.clear
+/** A scene holding `layers`, and the nodes `initialNodes` answers with once
+*  it is handed the registry their functions resolve against. */
+function buildScene(options, layers, initialNodes) {
+	if (layers.length === 0) throw new Error("Scene: systemLayers must declare at least one layer");
+	const registry = withKitRegistry(options.registry ?? {});
+	const doc = createSceneState(registry, layers, () => arrivals.layoutDeclared());
+	const { state, locks, reads } = doc;
+	const notifier = createNotifier();
+	const mode = createEditMode();
+	const poseWrites = createPoseWriteLog({
+		untracked: mode.untracked,
+		changes: notifier,
+		shown: (id) => shownNode(scene, id)
+	});
+	const writePose = (id, pose) => poseWrites.layout(() => scene.setPose(asNodeId(id), pose));
+	const layoutFrame = resolveLayoutFrame(options.layoutFrame);
+	const arrivals = createArrivalWindow({
+		nodes: state.nodes,
+		layoutPass: (arrived, touched, departed) => runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),
+		recordsBareEdits: () => !mode.open(),
+		writePose
+	});
+	const generateId = options.generateId ?? defaultGenerateId;
+	const selection = createSceneSelection(locks.reachable);
+	selection.subscribe(notifier.notify);
+	/** Ephemeral per-node overrides. Deliberately not part of `state`: not
+	*  document content, never reaches `toJSON`, and never touches history. */
+	const overrides = createPoseOverrides((id) => state.nodes.get(id), doc.store.invalidateDependents);
+	const recording = createSceneRecording({
+		notifier,
+		mode,
+		stale: doc.stale,
+		lifted: locks.lifted,
+		selection,
+		arrivals,
+		writePose,
+		poseWrites,
+		config: options
 	});
-	for (let [e, t] of Object.entries(l.ops ?? {})) M.ops.register(e, t);
-	let P = {
+	const edits = createSceneEdits({
+		state,
+		store: doc.store,
+		locks,
+		layers: doc.layers,
+		invalidateOrder: doc.order.invalidate,
+		fnFields: doc.fnFields,
+		ops: {
+			...recording.ops,
+			register: poseWrites.reporting(recording.ops.register)
+		},
+		recorder: recording.recorder,
+		arrivals,
+		layoutFrame,
+		generateId,
+		narrowSelection: selection.narrow,
+		clearOverride: overrides.clear
+	});
+	for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);
+	const scene = {
 		get nodes() {
-			return x.nodes;
+			return state.nodes;
 		},
 		get roots() {
-			return x.roots;
+			return state.roots;
 		},
 		get layers() {
-			return x.layers;
+			return state.layers;
 		},
-		registry: y,
-		...C,
-		mintId: k,
-		composition: l.composition ?? e,
-		...N.methods,
-		...M.methods,
-		unlocked: (e) => S.lifted(e),
-		setArrivalHandler: O.setHandler,
-		onReflow: O.onReflow,
-		overrides: j,
-		getSelection: A.get,
-		setSelection: (e) => A.set([...e]),
-		loadState(e) {
-			let t = m(e, y);
-			if (T.open()) throw Error("Scene: cannot loadState inside another edit — it replaces the state that edit would revert to");
-			j.clearAll(), b.reset(e.systemLayers.map(p)), M.clearHistory(), N.construct(t), A.replace(S.reachable(A.get().filter((e) => x.nodes.has(e)))), w.notify();
+		registry,
+		...reads,
+		mintId: generateId,
+		composition: options.composition ?? IDENTITY_POSE_COMPOSITION,
+		...edits.methods,
+		...recording.methods,
+		unlocked: (fn) => locks.lifted(fn),
+		setArrivalHandler: arrivals.setHandler,
+		onReflow: arrivals.onReflow,
+		onPoseWrite: poseWrites.subscribe,
+		overrides,
+		getSelection: selection.get,
+		setSelection: (ids) => selection.set([...ids]),
+		loadState(json) {
+			const specs = specsFromSerialized(json, registry);
+			if (mode.open()) throw new Error("Scene: cannot loadState inside another edit — it replaces the state that edit would revert to");
+			overrides.clearAll();
+			doc.reset(json.systemLayers.map(layerFromSerialized));
+			recording.clearHistory();
+			poseWrites.quiet(() => edits.construct(specs));
+			selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));
+			notifier.notify();
 		},
-		subscribe: w.subscribe,
-		getVersion: w.version
-	}, F = v(y);
-	return F && (N.construct(F), w.notify()), P;
+		subscribe: notifier.subscribe,
+		getVersion: notifier.version
+	};
+	const initial = initialNodes(registry);
+	if (initial) {
+		poseWrites.quiet(() => edits.construct(initial));
+		notifier.notify();
+	}
+	return scene;
 }
-function b(e, t = {}) {
-	return y(t, e.systemLayers.map(p), (t) => m(e, t));
+/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.
+*  Function fields (e.g., `clipFromPose`) are resolved by string key via the
+*  registry passed in `options`. Throws on unknown version, unknown registry
+*  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).
+*  The scene starts with empty history. */
+function sceneFromJSON(json, options = {}) {
+	return buildScene(options, json.systemLayers.map(layerFromSerialized), (registry) => specsFromSerialized(json, registry));
 }
-//#endregion
-export { v as createScene, b as sceneFromJSON };
 
+//#endregion
+export { createScene, sceneFromJSON };
 //# sourceMappingURL=scene.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scene.js","names":["defaultIdCounter","defaultGenerateId","asNodeId","createScene","buildScene","options","systemLayerRecord","layers","registry","withKitRegistry","doc","createSceneState","arrivals","notifier","createNotifier","mode","createEditMode","writePose","id","pose","layoutFrame","resolveLayoutFrame","createArrivalWindow","state","runLayoutPass","scene","reads","arrived","touched","departed","generateId","selection","createSceneSelection","locks","overrides","createPoseOverrides","recording","createSceneRecording","edits","createSceneEdits","kind","handler","IDENTITY_POSE_COMPOSITION","fn","ids","specs","specsFromSerialized","json","layerFromSerialized","initial","initialNodes","sceneFromJSON"],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { createNotifier } from './notifier';\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 } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport { IDENTITY_POSE_COMPOSITION, type PoseComposition } from './composeFrame';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SerializedScene,\n  type UseSceneOptions,\n} from './types';\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);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<UseSceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial'>;\n\n/** A scene holding `layers`, and the nodes `initialNodes` answers with once\n *  it is handed the registry their functions 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): 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\n  // carrying a kit-attached function (a grouped container's derived pose)\n  // reloads in any scene, not only one whose consumer registered the key.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared());\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const writePose = (id: string, pose: unknown): void => { 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 per-node overrides. Deliberately not part of `state`: not\n   *  document content, never reaches `toJSON`, and never touches history. */\n  const overrides = createPoseOverrides<TPose>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\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,\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 ?? (IDENTITY_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\n    overrides,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json) {\n      // Validate + map up front (throws before we touch live state on a bad\n      // version or unknown registry key).\n      const specs = specsFromSerialized(json, registry);\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      doc.reset(json.systemLayers.map(layerFromSerialized));\n      recording.clearHistory();\n      edits.construct(specs);\n      selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    subscribe: notifier.subscribe,\n    getVersion: notifier.version,\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    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: SerializedScene<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?: UseSceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: UseSceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { createNotifier } from './notifier';\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 } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport { IDENTITY_POSE_COMPOSITION, type PoseComposition } from './composeFrame';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SerializedScene,\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);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<UseSceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial'>;\n\n/** A scene holding `layers`, and the nodes `initialNodes` answers with once\n *  it is handed the registry their functions 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): 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\n  // carrying a kit-attached function (a grouped container's derived pose)\n  // reloads in any scene, not only one whose consumer registered the key.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared());\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 =>\n    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 per-node overrides. Deliberately not part of `state`: not\n   *  document content, never reaches `toJSON`, and never touches history. */\n  const overrides = createPoseOverrides<TPose>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\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 ?? (IDENTITY_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\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json) {\n      // Validate + map up front (throws before we touch live state on a bad\n      // version or unknown registry key).\n      const specs = specsFromSerialized(json, registry);\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      doc.reset(json.systemLayers.map(layerFromSerialized));\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    subscribe: notifier.subscribe,\n    getVersion: notifier.version,\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: SerializedScene<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?: UseSceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: UseSceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry),\n  );\n}\n"],"mappings":"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"}

package/dist/core/scene/sceneEdits.js

@@ -1,58 +1,71 @@
-import { createFieldEdits as e } from "./fieldEdits.js";
-import { registerKitOps as t } from "./kitOps.js";
-import { createLayerEdits as n } from "./layerStack.js";
-import { createTreeEdits as r } from "./treeEdits.js";
+import { createFieldEdits } from "./fieldEdits.js";
+import { registerKitOps } from "./kitOps.js";
+import { createNodeFlags } from "./nodeFlags.js";
+import { createLayerEdits } from "./layerStack.js";
+import { createTreeEdits } from "./treeEdits.js";
+
 //#region src/core/scene/sceneEdits.ts
-function i(i) {
-	let { state: a, store: o, locks: s, layers: c, fnFields: l, recorder: u, arrivals: d } = i, { layoutRefs: f } = t({
-		state: a,
-		register: i.ops.register,
-		store: o,
-		requireLayerIndex: c.requireLayerIndex,
-		rebuildLayerIndex: c.rebuildLayerIndex,
-		invalidateOrder: i.invalidateOrder,
-		fnFields: l,
-		narrowSelection: i.narrowSelection,
-		clearOverride: i.clearOverride
-	}), { construct: p, ...m } = r({
-		nodes: a.nodes,
-		generateId: i.generateId,
-		store: o,
-		locks: s,
-		layers: c,
-		fnFields: l,
-		runOp: i.ops.run,
-		recorder: u,
-		arrivals: d
-	}), h = e({
-		store: o,
-		locks: s,
-		layers: c,
-		recorder: u,
-		arrivals: d,
-		layoutFrame: i.layoutFrame,
-		layoutField: l.find((e) => e.spec.field === "layout"),
-		layoutRefs: f
-	}), g = n({
-		layers: a.layers,
-		layerIndex: a.layerIndex,
-		nodes: a.nodes,
-		requireLayerIndex: c.requireLayerIndex,
-		record: u.record,
-		lifted: s.lifted,
-		batch: u.batch,
-		removeMany: m.removeMany
+function createSceneEdits(env) {
+	const { state, store, locks, layers, fnFields, recorder, arrivals } = env;
+	const { layoutRefs } = registerKitOps({
+		state,
+		register: env.ops.register,
+		store,
+		requireLayerIndex: layers.requireLayerIndex,
+		rebuildLayerIndex: layers.rebuildLayerIndex,
+		invalidateOrder: env.invalidateOrder,
+		fnFields,
+		narrowSelection: env.narrowSelection,
+		clearOverride: env.clearOverride
+	});
+	const { construct, ...treeEdits } = createTreeEdits({
+		nodes: state.nodes,
+		generateId: env.generateId,
+		store,
+		locks,
+		layers,
+		fnFields,
+		runOp: env.ops.run,
+		recorder,
+		arrivals
+	});
+	const fieldEdits = createFieldEdits({
+		store,
+		locks,
+		layers,
+		recorder,
+		arrivals,
+		layoutFrame: env.layoutFrame,
+		layoutField: fnFields.find((f) => f.spec.field === "layout"),
+		layoutRefs
+	});
+	const layerEdits = createLayerEdits({
+		layers: state.layers,
+		layerIndex: state.layerIndex,
+		nodes: state.nodes,
+		requireLayerIndex: layers.requireLayerIndex,
+		record: recorder.record,
+		lifted: locks.lifted,
+		batch: recorder.batch,
+		removeMany: treeEdits.removeMany
+	});
+	const flagEdits = createNodeFlags({
+		register: env.ops.register,
+		requireNode: store.requireNode,
+		record: recorder.record,
+		narrowSelection: () => env.narrowSelection()
 	});
 	return {
-		construct: p,
+		construct,
 		methods: {
-			...m,
-			...h,
-			...g
+			...treeEdits,
+			...fieldEdits,
+			...layerEdits,
+			...flagEdits
 		}
 	};
 }
-//#endregion
-export { i as createSceneEdits };
 
+//#endregion
+export { createSceneEdits };
 //# sourceMappingURL=sceneEdits.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sceneEdits.js","names":["createSceneEdits","env","registerKitOps","layers","treeEdits","createTreeEdits","state","fieldEdits","createFieldEdits","fnFields","f","layerEdits","createLayerEdits","recorder","locks"],"sources":["../../../src/core/scene/sceneEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its document — tree, node fields, and layers — with\n * the kit ops they record.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { createFieldEdits, type FieldEdits } from './fieldEdits';\nimport { registerKitOps } from './kitOps';\nimport { createLayerEdits, type LayerEdits, type createLayerStack } from './layerStack';\nimport type { ResolvedLayoutFrame } from './layoutPass';\nimport type { LockGuard } from './lockGuard';\nimport type { NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { OpTable } from './opTable';\nimport type { Recorder } from './recorder';\nimport { createTreeEdits, type TreeEdits } from './treeEdits';\nimport type { LayerRecord, Node, NodeId } from './types';\n\nexport interface SceneEditsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n    layerIndex: Map<TLayer, number>;\n  };\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<\n    ReturnType<typeof createLayerStack<TLayer>>,\n    'requireLayerIndex' | 'rebuildLayerIndex' | 'assertSubtreeLayer'\n  >;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  ops: Pick<OpTable, 'register' | 'run'>;\n  recorder: Pick<Recorder, 'record' | 'edit' | 'batch'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange' | 'layoutDeclared'>;\n  layoutFrame: ResolvedLayoutFrame<TPose>;\n  generateId(): NodeId;\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  clearOverride(id: NodeId): void;\n}\n\nexport interface SceneEdits<TData, TLayer extends string, TPose> {\n  construct: TreeEdits<TData, TLayer, TPose>['construct'];\n  methods: Omit<TreeEdits<TData, TLayer, TPose>, 'construct'>\n    & FieldEdits<TData, TLayer, TPose>\n    & LayerEdits<TData, TLayer, TPose>;\n}\n\nexport function createSceneEdits<TData, TLayer extends string, TPose>(\n  env: SceneEditsEnv<TData, TLayer, TPose>,\n): SceneEdits<TData, TLayer, TPose> {\n  const { state, store, locks, layers, fnFields, recorder, arrivals } = env;\n\n  const { layoutRefs } = registerKitOps<TData, TLayer, TPose>({\n    state,\n    register: env.ops.register,\n    store,\n    requireLayerIndex: layers.requireLayerIndex,\n    rebuildLayerIndex: layers.rebuildLayerIndex,\n    invalidateOrder: env.invalidateOrder,\n    fnFields,\n    narrowSelection: env.narrowSelection,\n    clearOverride: env.clearOverride,\n  });\n\n  const { construct, ...treeEdits } = createTreeEdits<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    generateId: env.generateId,\n    store,\n    locks,\n    layers,\n    fnFields,\n    runOp: env.ops.run,\n    recorder,\n    arrivals,\n  });\n\n  const fieldEdits = createFieldEdits<TData, TLayer, TPose>({\n    store,\n    locks,\n    layers,\n    recorder,\n    arrivals,\n    layoutFrame: env.layoutFrame,\n    layoutField: fnFields.find((f) => f.spec.field === 'layout')!,\n    layoutRefs,\n  });\n\n  const layerEdits = createLayerEdits<TData, TLayer, TPose>({\n    layers: state.layers,\n    layerIndex: state.layerIndex,\n    nodes: state.nodes,\n    requireLayerIndex: layers.requireLayerIndex,\n    record: recorder.record,\n    lifted: locks.lifted,\n    batch: recorder.batch,\n    removeMany: treeEdits.removeMany,\n  });\n\n  return { construct, methods: { ...treeEdits, ...fieldEdits, ...layerEdits } };\n}\n"],"mappings":";;;;;AA+CA,SAAgBA,EACd,GACkC;CAClC,IAAM,EAAE,UAAO,UAAO,UAAO,WAAQ,aAAU,aAAU,gBAAaC,GAEhE,EAAE,kBAAeC,EAAqC;EAC1D;EACA,UAAUD,EAAI,IAAI;EAClB;EACA,mBAAmBE,EAAO;EAC1B,mBAAmBA,EAAO;EAC1B,iBAAiBF,EAAI;EACrB;EACA,iBAAiBA,EAAI;EACrB,eAAeA,EAAI;CACrB,CAAC,GAEK,EAAE,cAAW,GAAGG,MAAcC,EAAsC;EACxE,OAAOC,EAAM;EACb,YAAYL,EAAI;EAChB;EACA;EACA;EACA;EACA,OAAOA,EAAI,IAAI;EACf;EACA;CACF,CAAC,GAEKM,IAAaC,EAAuC;EACxD;EACA;EACA;EACA;EACA;EACA,aAAaP,EAAI;EACjB,aAAaQ,EAAS,MAAM,MAAMC,EAAE,KAAK,UAAU,QAAQ;EAC3D;CACF,CAAC,GAEKC,IAAaC,EAAuC;EACxD,QAAQN,EAAM;EACd,YAAYA,EAAM;EAClB,OAAOA,EAAM;EACb,mBAAmBH,EAAO;EAC1B,QAAQU,EAAS;EACjB,QAAQC,EAAM;EACd,OAAOD,EAAS;EAChB,YAAYT,EAAU;CACxB,CAAC;CAED,OAAO;EAAE;EAAW,SAAS;GAAE,GAAGA;GAAW,GAAGG;GAAY,GAAGI;EAAW;CAAE;AAC9E"}
+{"version":3,"file":"sceneEdits.js","names":[],"sources":["../../../src/core/scene/sceneEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its document — tree, node fields, and layers — with\n * the kit ops they record.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { createFieldEdits, type FieldEdits } from './fieldEdits';\nimport { registerKitOps } from './kitOps';\nimport { createNodeFlags } from './nodeFlags';\nimport { createLayerEdits, type LayerEdits, type createLayerStack } from './layerStack';\nimport type { ResolvedLayoutFrame } from './layoutPass';\nimport type { LockGuard } from './lockGuard';\nimport type { NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { OpTable } from './opTable';\nimport type { Recorder } from './recorder';\nimport { createTreeEdits, type TreeEdits } from './treeEdits';\nimport type { LayerRecord, Node, NodeId } from './types';\n\nexport interface SceneEditsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n    layerIndex: Map<TLayer, number>;\n  };\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<\n    ReturnType<typeof createLayerStack<TLayer>>,\n    'requireLayerIndex' | 'rebuildLayerIndex' | 'assertSubtreeLayer'\n  >;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  ops: Pick<OpTable, 'register' | 'run'>;\n  recorder: Pick<Recorder, 'record' | 'edit' | 'batch'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange' | 'layoutDeclared'>;\n  layoutFrame: ResolvedLayoutFrame<TPose>;\n  generateId(): NodeId;\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  clearOverride(id: NodeId): void;\n}\n\nexport interface SceneEdits<TData, TLayer extends string, TPose> {\n  construct: TreeEdits<TData, TLayer, TPose>['construct'];\n  methods: Omit<TreeEdits<TData, TLayer, TPose>, 'construct'>\n    & FieldEdits<TData, TLayer, TPose>\n    & LayerEdits<TData, TLayer, TPose>\n    & ReturnType<typeof createNodeFlags<TData, TLayer, TPose>>;\n}\n\nexport function createSceneEdits<TData, TLayer extends string, TPose>(\n  env: SceneEditsEnv<TData, TLayer, TPose>,\n): SceneEdits<TData, TLayer, TPose> {\n  const { state, store, locks, layers, fnFields, recorder, arrivals } = env;\n\n  const { layoutRefs } = registerKitOps<TData, TLayer, TPose>({\n    state,\n    register: env.ops.register,\n    store,\n    requireLayerIndex: layers.requireLayerIndex,\n    rebuildLayerIndex: layers.rebuildLayerIndex,\n    invalidateOrder: env.invalidateOrder,\n    fnFields,\n    narrowSelection: env.narrowSelection,\n    clearOverride: env.clearOverride,\n  });\n\n  const { construct, ...treeEdits } = createTreeEdits<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    generateId: env.generateId,\n    store,\n    locks,\n    layers,\n    fnFields,\n    runOp: env.ops.run,\n    recorder,\n    arrivals,\n  });\n\n  const fieldEdits = createFieldEdits<TData, TLayer, TPose>({\n    store,\n    locks,\n    layers,\n    recorder,\n    arrivals,\n    layoutFrame: env.layoutFrame,\n    layoutField: fnFields.find((f) => f.spec.field === 'layout')!,\n    layoutRefs,\n  });\n\n  const layerEdits = createLayerEdits<TData, TLayer, TPose>({\n    layers: state.layers,\n    layerIndex: state.layerIndex,\n    nodes: state.nodes,\n    requireLayerIndex: layers.requireLayerIndex,\n    record: recorder.record,\n    lifted: locks.lifted,\n    batch: recorder.batch,\n    removeMany: treeEdits.removeMany,\n  });\n\n  const flagEdits = createNodeFlags<TData, TLayer, TPose>({\n    register: env.ops.register,\n    requireNode: store.requireNode,\n    record: recorder.record,\n    narrowSelection: () => env.narrowSelection(),\n  });\n\n  return { construct, methods: { ...treeEdits, ...fieldEdits, ...layerEdits, ...flagEdits } };\n}\n"],"mappings":";;;;;;;AAiDA,SAAgB,iBACd,KACkC;CAClC,MAAM,EAAE,OAAO,OAAO,OAAO,QAAQ,UAAU,UAAU,aAAa;CAEtE,MAAM,EAAE,eAAe,eAAqC;EAC1D;EACA,UAAU,IAAI,IAAI;EAClB;EACA,mBAAmB,OAAO;EAC1B,mBAAmB,OAAO;EAC1B,iBAAiB,IAAI;EACrB;EACA,iBAAiB,IAAI;EACrB,eAAe,IAAI;CACrB,CAAC;CAED,MAAM,EAAE,WAAW,GAAG,cAAc,gBAAsC;EACxE,OAAO,MAAM;EACb,YAAY,IAAI;EAChB;EACA;EACA;EACA;EACA,OAAO,IAAI,IAAI;EACf;EACA;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD;EACA;EACA;EACA;EACA;EACA,aAAa,IAAI;EACjB,aAAa,SAAS,MAAM,MAAM,EAAE,KAAK,UAAU,QAAQ;EAC3D;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO,MAAM;EACb,mBAAmB,OAAO;EAC1B,QAAQ,SAAS;EACjB,QAAQ,MAAM;EACd,OAAO,SAAS;EAChB,YAAY,UAAU;CACxB,CAAC;CAED,MAAM,YAAY,gBAAsC;EACtD,UAAU,IAAI,IAAI;EAClB,aAAa,MAAM;EACnB,QAAQ,SAAS;EACjB,uBAAuB,IAAI,gBAAgB;CAC7C,CAAC;CAED,OAAO;EAAE;EAAW,SAAS;GAAE,GAAG;GAAW,GAAG;GAAY,GAAG;GAAY,GAAG;EAAU;CAAE;AAC5F"}

package/dist/core/scene/sceneMutators.js

@@ -1,49 +1,57 @@
-import { documentPose as e } from "./effectivePose.js";
-import { asNodeId as t } from "./types.js";
-import { fnFieldsOfNode as n } from "./nodeFnFields.js";
-import { statedFields as r } from "./statedFields.js";
+import { documentPose } from "./effectivePose.js";
+import { asNodeId } from "./types.js";
+import { fnFieldsOfNode } from "./nodeFnFields.js";
+import { statedFields } from "./statedFields.js";
+
 //#region src/core/scene/sceneMutators.ts
-function i(e) {
-	let i = (n) => n === null ? [...e.roots] : [...e.childrenOf(t(n))];
+function sceneMutators(scene) {
+	const getChildren = (parentId) => parentId === null ? [...scene.roots] : [...scene.childrenOf(asNodeId(parentId))];
 	return {
-		getNode: (n) => e.get(t(n)),
-		getParent: (n) => e.get(t(n))?.parent ?? null,
-		getChildren: i,
-		getRemovalClosure: (n) => [...e.removalClosure(n.map(t))],
-		setPose: (n, r) => e.setPose(t(n), r),
-		setParent: (n, r) => e.move(t(n), r == null ? null : t(r)),
-		setChildOrder: (n, r) => {
-			e.batch("Reorder", () => {
-				for (let a = 0; a < r.length; a++) i(n)[a] !== r[a] && e.reorder(t(r[a]), a);
+		getNode: (id) => scene.get(asNodeId(id)),
+		getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,
+		getChildren,
+		getRemovalClosure: (ids) => [...scene.removalClosure(ids.map(asNodeId))],
+		setPose: (id, pose) => scene.setPose(asNodeId(id), pose),
+		setParent: (id, parentId) => scene.move(asNodeId(id), parentId == null ? null : asNodeId(parentId)),
+		setChildOrder: (parentId, ids) => {
+			scene.batch("Reorder", () => {
+				for (let i = 0; i < ids.length; i++) {
+					if (getChildren(parentId)[i] === ids[i]) continue;
+					scene.reorder(asNodeId(ids[i]), i);
+				}
 			});
 		},
-		setData: (n, r) => e.update(t(n), { data: r }),
-		setLayer: (n, r) => e.setLayer(t(n), r),
-		setLayout: (n, r) => e.setLayout(t(n), r),
-		removeNode: (n) => e.remove(t(n)),
-		insertNode: (t, i) => {
-			e.add({
-				kind: t.kind,
-				layer: t.layer,
-				pose: t.pose,
-				data: t.data,
-				id: t.id,
-				...i === void 0 ? {} : { index: i },
-				...t.parent == null ? {} : { parent: t.parent },
-				...t.dependsOn === void 0 ? {} : { dependsOn: t.dependsOn },
-				...r(t),
-				...n(t)
+		setData: (id, data) => scene.update(asNodeId(id), { data }),
+		setLayer: (id, layer) => scene.setLayer(asNodeId(id), layer),
+		setLayout: (id, layout) => scene.setLayout(asNodeId(id), layout),
+		setHidden: (id, hidden) => scene.setHidden(asNodeId(id), hidden),
+		setLocked: (id, locked) => scene.setLocked(asNodeId(id), locked),
+		removeNode: (id) => scene.remove(asNodeId(id)),
+		insertNode: (node, index) => {
+			scene.add({
+				kind: node.kind,
+				layer: node.layer,
+				pose: node.pose,
+				data: node.data,
+				id: node.id,
+				...index !== void 0 ? { index } : {},
+				...node.parent != null ? { parent: node.parent } : {},
+				...node.dependsOn !== void 0 ? { dependsOn: node.dependsOn } : {},
+				...statedFields(node),
+				...fnFieldsOfNode(node)
 			});
 		}
 	};
 }
-function a(n) {
+/** The pose and node-list reads of an adapter ops commit through: the document,
+*  whatever a gesture is showing and whichever layers are hidden. */
+function documentReads(scene) {
 	return {
-		getPose: (r) => e(n, n.get(t(r))),
-		getNodes: () => [...n.renderOrderNodes()]
+		getPose: (id) => documentPose(scene, scene.get(asNodeId(id))),
+		getNodes: () => [...scene.renderOrderNodes()]
 	};
 }
-//#endregion
-export { a as documentReads, i as sceneMutators };
 
+//#endregion
+export { documentReads, sceneMutators };
 //# sourceMappingURL=sceneMutators.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sceneMutators.js","names":["sceneMutators","getChildren","parentId","scene","asNodeId","id","ids","pose","i","layer","layout","node","index","statedFields","fnFieldsOfNode","documentReads","documentPose"],"sources":["../../../src/core/scene/sceneMutators.ts"],"sourcesContent":["/**\n * What every scene-backed adapter shares: the writes an op applies through,\n * and the structural reads those ops need. `sceneToAdapter`,\n * `defaultCommitAdapter`, and `moveGestureAdapter` all build on it.\n *\n * It leaves out the pose and node-list reads, where the adapters differ on\n * purpose. The canvas adapter answers with what is shown: the effective pose,\n * visible layers only. An adapter ops commit through answers with what the\n * document holds, which is {@link documentReads}.\n */\nimport type { LayoutStrategy } from '../../layout/types';\nimport { documentPose } from './effectivePose';\nimport { fnFieldsOfNode } from './nodeFnFields';\nimport { statedFields } from './statedFields';\nimport { asNodeId, type Node, type Scene } from './types';\n\nexport interface SceneMutators<TData, TLayer extends string, TPose> {\n  getNode(id: string): Node<TData, TLayer, TPose> | undefined;\n  getParent(id: string): string | null;\n  /** Ordered children of `parentId`; `null` names the root siblings. */\n  getChildren(parentId: string | null): string[];\n  /** Every id removing `ids` takes: their subtrees and their dependents. */\n  getRemovalClosure(ids: readonly string[]): string[];\n  setPose(id: string, pose: TPose): void;\n  setParent(id: string, parentId: string | null): void;\n  /** One undo step when called bare; inside a batch it joins that batch. */\n  setChildOrder(parentId: string | null, ids: string[]): void;\n  setData(id: string, data: TData): void;\n  setLayer(id: string, layer: TLayer): void;\n  setLayout(id: string, layout: LayoutStrategy<TPose> | string | null): void;\n  removeNode(id: string): void;\n  /** Re-add `node` as it was, at sibling `index` when one is given. */\n  insertNode(node: Node<TData, TLayer, TPose>, index?: number): void;\n}\n\nexport function sceneMutators<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): SceneMutators<TData, TLayer, TPose> {\n  const getChildren = (parentId: string | null): string[] =>\n    (parentId === null ? [...scene.roots] : [...scene.childrenOf(asNodeId(parentId))]);\n  return {\n    getNode: (id) => scene.get(asNodeId(id)),\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    getChildren,\n    getRemovalClosure: (ids) => [...scene.removalClosure(ids.map(asNodeId))],\n    setPose: (id, pose) => scene.setPose(asNodeId(id), pose),\n    setParent: (id, parentId) => scene.move(asNodeId(id), parentId == null ? null : asNodeId(parentId)),\n    setChildOrder: (parentId, ids) => {\n      scene.batch('Reorder', () => {\n        for (let i = 0; i < ids.length; i++) {\n          // Re-read each time: a reorder shifts later ids, sometimes into place.\n          if (getChildren(parentId)[i] === ids[i]) continue;\n          scene.reorder(asNodeId(ids[i]), i);\n        }\n      });\n    },\n    setData: (id, data) => scene.update(asNodeId(id), { data }),\n    setLayer: (id, layer) => scene.setLayer(asNodeId(id), layer),\n    setLayout: (id, layout) => scene.setLayout(asNodeId(id), layout),\n    removeNode: (id) => scene.remove(asNodeId(id)),\n    insertNode: (node, index) => {\n      scene.add({\n        kind: node.kind,\n        layer: node.layer,\n        pose: node.pose,\n        data: node.data,\n        id: node.id,\n        ...(index !== undefined ? { index } : {}),\n        ...(node.parent != null ? { parent: node.parent } : {}),\n        // Derivation travels with the node, or undo of a delete brings an\n        // edge back as a static path that never follows its endpoints again.\n        ...(node.dependsOn !== undefined ? { dependsOn: node.dependsOn } : {}),\n        ...statedFields(node),\n        ...fnFieldsOfNode(node),\n      });\n    },\n  };\n}\n\n/** The pose and node-list reads of an adapter ops commit through: the document,\n *  whatever a gesture is showing and whichever layers are hidden. */\nexport function documentReads<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): { getPose(id: string): TPose; getNodes(): Node<TData, TLayer, TPose>[] } {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(asNodeId(id))!),\n    getNodes: () => [...scene.renderOrderNodes()],\n  };\n}\n"],"mappings":";;;;;AAmCA,SAAgBA,EACd,GACqC;CACrC,IAAMC,KAAe,MAClBC,MAAa,OAAO,CAAC,GAAGC,EAAM,KAAK,IAAI,CAAC,GAAGA,EAAM,WAAWC,EAASF,CAAQ,CAAC,CAAC;CAClF,OAAO;EACL,UAAU,MAAOC,EAAM,IAAIC,EAASC,CAAE,CAAC;EACvC,YAAY,MAAOF,EAAM,IAAIC,EAASC,CAAE,CAAC,CAAC,EAAE,UAAU;EACtD;EACA,oBAAoB,MAAQ,CAAC,GAAGF,EAAM,eAAeG,EAAI,IAAIF,CAAQ,CAAC,CAAC;EACvE,UAAU,GAAI,MAASD,EAAM,QAAQC,EAASC,CAAE,GAAGE,CAAI;EACvD,YAAY,GAAI,MAAaJ,EAAM,KAAKC,EAASC,CAAE,GAAGH,KAAY,OAAO,OAAOE,EAASF,CAAQ,CAAC;EAClG,gBAAgB,GAAU,MAAQ;GAChC,EAAM,MAAM,iBAAiB;IAC3B,KAAK,IAAIM,IAAI,GAAGA,IAAIF,EAAI,QAAQ,KAE9B,AAAIL,EAAYC,CAAQ,CAAC,CAACM,OAAOF,EAAIE,MACrCL,EAAM,QAAQC,EAASE,EAAIE,EAAE,GAAGA,CAAC;GAErC,CAAC;EACH;EACA,UAAU,GAAI,MAASL,EAAM,OAAOC,EAASC,CAAE,GAAG,EAAE,QAAK,CAAC;EAC1D,WAAW,GAAI,MAAUF,EAAM,SAASC,EAASC,CAAE,GAAGI,CAAK;EAC3D,YAAY,GAAI,MAAWN,EAAM,UAAUC,EAASC,CAAE,GAAGK,CAAM;EAC/D,aAAa,MAAOP,EAAM,OAAOC,EAASC,CAAE,CAAC;EAC7C,aAAa,GAAM,MAAU;GAC3B,EAAM,IAAI;IACR,MAAMM,EAAK;IACX,OAAOA,EAAK;IACZ,MAAMA,EAAK;IACX,MAAMA,EAAK;IACX,IAAIA,EAAK;IACT,GAAIC,MAAU,KAAA,IAAwB,CAAC,IAAb,EAAE,SAAM;IAClC,GAAID,EAAK,UAAU,OAAiC,CAAC,IAA3B,EAAE,QAAQA,EAAK,OAAO;IAGhD,GAAIA,EAAK,cAAc,KAAA,IAA4C,CAAC,IAAjC,EAAE,WAAWA,EAAK,UAAU;IAC/D,GAAGE,EAAaF,CAAI;IACpB,GAAGG,EAAeH,CAAI;GACxB,CAAC;EACH;CACF;AACF;AAIA,SAAgBI,EACd,GAC0E;CAC1E,OAAO;EACL,UAAU,MAAOC,EAAab,GAAOA,EAAM,IAAIC,EAASC,CAAE,CAAC,CAAE;EAC7D,gBAAgB,CAAC,GAAGF,EAAM,iBAAiB,CAAC;CAC9C;AACF"}
+{"version":3,"file":"sceneMutators.js","names":[],"sources":["../../../src/core/scene/sceneMutators.ts"],"sourcesContent":["/**\n * What every scene-backed adapter shares: the writes an op applies through,\n * and the structural reads those ops need. `sceneToAdapter`,\n * `defaultCommitAdapter`, and `moveGestureAdapter` all build on it.\n *\n * It leaves out the pose and node-list reads, where the adapters differ on\n * purpose. The canvas adapter answers with what is shown: the effective pose,\n * visible layers only. An adapter ops commit through answers with what the\n * document holds, which is {@link documentReads}.\n */\nimport type { LayoutStrategy } from '../../layout/types';\nimport { documentPose } from './effectivePose';\nimport { fnFieldsOfNode } from './nodeFnFields';\nimport { statedFields } from './statedFields';\nimport { asNodeId, type Node, type Scene } from './types';\n\nexport interface SceneMutators<TData, TLayer extends string, TPose> {\n  getNode(id: string): Node<TData, TLayer, TPose> | undefined;\n  getParent(id: string): string | null;\n  /** Ordered children of `parentId`; `null` names the root siblings. */\n  getChildren(parentId: string | null): string[];\n  /** Every id removing `ids` takes: their subtrees and their dependents. */\n  getRemovalClosure(ids: readonly string[]): string[];\n  setPose(id: string, pose: TPose): void;\n  setParent(id: string, parentId: string | null): void;\n  /** One undo step when called bare; inside a batch it joins that batch. */\n  setChildOrder(parentId: string | null, ids: string[]): void;\n  setData(id: string, data: TData): void;\n  setLayer(id: string, layer: TLayer): void;\n  setLayout(id: string, layout: LayoutStrategy<TPose> | string | null): void;\n  /** What a `setHidden` op writes through. */\n  setHidden(id: string, hidden: boolean): void;\n  /** What a `setLocked` op writes through. */\n  setLocked(id: string, locked: boolean): void;\n  removeNode(id: string): void;\n  /** Re-add `node` as it was, at sibling `index` when one is given. */\n  insertNode(node: Node<TData, TLayer, TPose>, index?: number): void;\n}\n\nexport function sceneMutators<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): SceneMutators<TData, TLayer, TPose> {\n  const getChildren = (parentId: string | null): string[] =>\n    (parentId === null ? [...scene.roots] : [...scene.childrenOf(asNodeId(parentId))]);\n  return {\n    getNode: (id) => scene.get(asNodeId(id)),\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    getChildren,\n    getRemovalClosure: (ids) => [...scene.removalClosure(ids.map(asNodeId))],\n    setPose: (id, pose) => scene.setPose(asNodeId(id), pose),\n    setParent: (id, parentId) => scene.move(asNodeId(id), parentId == null ? null : asNodeId(parentId)),\n    setChildOrder: (parentId, ids) => {\n      scene.batch('Reorder', () => {\n        for (let i = 0; i < ids.length; i++) {\n          // Re-read each time: a reorder shifts later ids, sometimes into place.\n          if (getChildren(parentId)[i] === ids[i]) continue;\n          scene.reorder(asNodeId(ids[i]), i);\n        }\n      });\n    },\n    setData: (id, data) => scene.update(asNodeId(id), { data }),\n    setLayer: (id, layer) => scene.setLayer(asNodeId(id), layer),\n    setLayout: (id, layout) => scene.setLayout(asNodeId(id), layout),\n    setHidden: (id, hidden) => scene.setHidden(asNodeId(id), hidden),\n    setLocked: (id, locked) => scene.setLocked(asNodeId(id), locked),\n    removeNode: (id) => scene.remove(asNodeId(id)),\n    insertNode: (node, index) => {\n      scene.add({\n        kind: node.kind,\n        layer: node.layer,\n        pose: node.pose,\n        data: node.data,\n        id: node.id,\n        ...(index !== undefined ? { index } : {}),\n        ...(node.parent != null ? { parent: node.parent } : {}),\n        // Derivation travels with the node, or undo of a delete brings an\n        // edge back as a static path that never follows its endpoints again.\n        ...(node.dependsOn !== undefined ? { dependsOn: node.dependsOn } : {}),\n        ...statedFields(node),\n        ...fnFieldsOfNode(node),\n      });\n    },\n  };\n}\n\n/** The pose and node-list reads of an adapter ops commit through: the document,\n *  whatever a gesture is showing and whichever layers are hidden. */\nexport function documentReads<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n): { getPose(id: string): TPose; getNodes(): Node<TData, TLayer, TPose>[] } {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(asNodeId(id))!),\n    getNodes: () => [...scene.renderOrderNodes()],\n  };\n}\n"],"mappings":";;;;;;AAuCA,SAAgB,cACd,OACqC;CACrC,MAAM,eAAe,aAClB,aAAa,OAAO,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,WAAW,SAAS,QAAQ,CAAC,CAAC;CAClF,OAAO;EACL,UAAU,OAAO,MAAM,IAAI,SAAS,EAAE,CAAC;EACvC,YAAY,OAAO,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU;EACtD;EACA,oBAAoB,QAAQ,CAAC,GAAG,MAAM,eAAe,IAAI,IAAI,QAAQ,CAAC,CAAC;EACvE,UAAU,IAAI,SAAS,MAAM,QAAQ,SAAS,EAAE,GAAG,IAAI;EACvD,YAAY,IAAI,aAAa,MAAM,KAAK,SAAS,EAAE,GAAG,YAAY,OAAO,OAAO,SAAS,QAAQ,CAAC;EAClG,gBAAgB,UAAU,QAAQ;GAChC,MAAM,MAAM,iBAAiB;IAC3B,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;KAEnC,IAAI,YAAY,QAAQ,CAAC,CAAC,OAAO,IAAI,IAAI;KACzC,MAAM,QAAQ,SAAS,IAAI,EAAE,GAAG,CAAC;IACnC;GACF,CAAC;EACH;EACA,UAAU,IAAI,SAAS,MAAM,OAAO,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC;EAC1D,WAAW,IAAI,UAAU,MAAM,SAAS,SAAS,EAAE,GAAG,KAAK;EAC3D,YAAY,IAAI,WAAW,MAAM,UAAU,SAAS,EAAE,GAAG,MAAM;EAC/D,YAAY,IAAI,WAAW,MAAM,UAAU,SAAS,EAAE,GAAG,MAAM;EAC/D,YAAY,IAAI,WAAW,MAAM,UAAU,SAAS,EAAE,GAAG,MAAM;EAC/D,aAAa,OAAO,MAAM,OAAO,SAAS,EAAE,CAAC;EAC7C,aAAa,MAAM,UAAU;GAC3B,MAAM,IAAI;IACR,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,MAAM,KAAK;IACX,IAAI,KAAK;IACT,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC;IACvC,GAAI,KAAK,UAAU,OAAO,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;IAGrD,GAAI,KAAK,cAAc,SAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;IACpE,GAAG,aAAa,IAAI;IACpB,GAAG,eAAe,IAAI;GACxB,CAAC;EACH;CACF;AACF;;;AAIA,SAAgB,cACd,OAC0E;CAC1E,OAAO;EACL,UAAU,OAAO,aAAa,OAAO,MAAM,IAAI,SAAS,EAAE,CAAC,CAAE;EAC7D,gBAAgB,CAAC,GAAG,MAAM,iBAAiB,CAAC;CAC9C;AACF"}

package/dist/core/scene/scenePoseAdapter.js

@@ -1,16 +1,20 @@
-import { definesFrame as e, documentPose as t } from "./effectivePose.js";
+import { definesFrame, documentPose } from "./effectivePose.js";
+
 //#region src/core/scene/scenePoseAdapter.ts
-function n(n) {
+/** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.
+*  `getParent` returns the live parent at call time so mid-batch
+*  parent updates compose correctly. */
+function scenePoseAdapter(scene) {
 	return {
-		getPose: (e) => t(n, n.get(e)),
-		getParent: (e) => n.get(e)?.parent ?? null,
-		definesFrame: (t) => {
-			let r = n.get(t);
-			return r === void 0 || e(r);
+		getPose: (id) => documentPose(scene, scene.get(id)),
+		getParent: (id) => scene.get(id)?.parent ?? null,
+		definesFrame: (id) => {
+			const node = scene.get(id);
+			return node === void 0 || definesFrame(node);
 		}
 	};
 }
-//#endregion
-export { n as scenePoseAdapter };
 
+//#endregion
+export { scenePoseAdapter };
 //# sourceMappingURL=scenePoseAdapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scenePoseAdapter.js","names":["scenePoseAdapter","documentPose","scene","id","node","definesFrame"],"sources":["../../../src/core/scene/scenePoseAdapter.ts"],"sourcesContent":["import { definesFrame, documentPose } from 'core/scene/effectivePose';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { PoseAdapter } from './composePose';\n\n/** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.\n *  `getParent` returns the live parent at call time so mid-batch\n *  parent updates compose correctly. */\nexport function scenePoseAdapter(\n  scene: Scene<unknown, string, unknown>,\n): PoseAdapter<unknown> {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(id as NodeId)!),\n    getParent: (id) => scene.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => {\n      const node = scene.get(id as NodeId);\n      return node === undefined || definesFrame(node);\n    },\n  };\n}\n"],"mappings":";;AAOA,SAAgBA,EACd,GACsB;CACtB,OAAO;EACL,UAAU,MAAOC,EAAaC,GAAOA,EAAM,IAAIC,CAAY,CAAE;EAC7D,YAAY,MAAOD,EAAM,IAAIC,CAAY,CAAC,EAAE,UAAU;EACtD,eAAe,MAAO;GACpB,IAAMC,IAAOF,EAAM,IAAIC,CAAY;GACnC,OAAOC,MAAS,KAAA,KAAaC,EAAaD,CAAI;EAChD;CACF;AACF"}
+{"version":3,"file":"scenePoseAdapter.js","names":[],"sources":["../../../src/core/scene/scenePoseAdapter.ts"],"sourcesContent":["import { definesFrame, documentPose } from 'core/scene/effectivePose';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { PoseAdapter } from './composePose';\n\n/** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.\n *  `getParent` returns the live parent at call time so mid-batch\n *  parent updates compose correctly. */\nexport function scenePoseAdapter(\n  scene: Scene<unknown, string, unknown>,\n): PoseAdapter<unknown> {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(id as NodeId)!),\n    getParent: (id) => scene.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => {\n      const node = scene.get(id as NodeId);\n      return node === undefined || definesFrame(node);\n    },\n  };\n}\n"],"mappings":";;;;;;AAOA,SAAgB,iBACd,OACsB;CACtB,OAAO;EACL,UAAU,OAAO,aAAa,OAAO,MAAM,IAAI,EAAY,CAAE;EAC7D,YAAY,OAAO,MAAM,IAAI,EAAY,CAAC,EAAE,UAAU;EACtD,eAAe,OAAO;GACpB,MAAM,OAAO,MAAM,IAAI,EAAY;GACnC,OAAO,SAAS,UAAa,aAAa,IAAI;EAChD;CACF;AACF"}