@weasel-js/core 1.10.0 → 1.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"serialization.js","names":["isSerializedScene","value","layerFromSerialized","base","spec","serializeScene","nodes","n","treePreorder","state","id","out","fnKeysOf","fnFields","field","layer","l","specsFromSerialized","json","serialized","NODE_FN_FIELDS","key","fn","registry"],"sources":["../../../src/core/scene/serialization.ts"],"sourcesContent":["/**\n * A scene to and from its JSON snapshot: the walk that writes one, and the\n * two readers that turn one back into layer records and node specs.\n */\nimport {\n  NODE_FN_FIELDS, fnKeysOf, type FnBearingNode, type NodeFnField,\n} from './nodeFnFields';\nimport { treePreorder } from './treeOrder';\nimport type {\n  AddNodeSpec, LayerRecord, Node, NodeId, SceneRegistry, SerializedLayer, SerializedNode, SerializedScene,\n} from './types';\n\n/** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */\nexport function isSerializedScene<TData, TLayer extends string, TPose>(\n  value: unknown,\n): value is SerializedScene<TData, TLayer, TPose> {\n  return typeof value === 'object' && value != null\n    && (value as { version?: unknown }).version === 1\n    && Array.isArray((value as { nodes?: unknown }).nodes);\n}\n\n/** What a snapshot is written from. */\nexport interface SerializableState<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  roots: NodeId[];\n  layers: LayerRecord<TLayer>[];\n}\n\n/** One layer record from its snapshot form. A snapshot with no `kind` predates\n *  user layers, so everything in it was a system layer. */\nexport function layerFromSerialized<TLayer extends string>(\n  spec: SerializedLayer<TLayer>,\n): LayerRecord<TLayer> {\n  const base = {\n    id: spec.id,\n    visible: spec.visible ?? true,\n    locked: spec.locked ?? false,\n    ...(spec.parallax ? { parallax: spec.parallax } : {}),\n  };\n  return spec.kind === 'user'\n    ? { ...base, kind: 'user', name: spec.name ?? spec.id }\n    : { ...base, kind: 'system' };\n}\n\n/** The snapshot of `state`: layers in order, nodes in tree preorder. Throws\n *  when a node carries a function the registry has no key for. */\nexport function serializeScene<TData, TLayer extends string, TPose>(\n  state: SerializableState<TData, TLayer, TPose>,\n  fnFields: readonly NodeFnField[],\n): SerializedScene<TData, TLayer, TPose> {\n  const nodes: SerializedNode<TData, TLayer, TPose>[] = [];\n  for (const n of treePreorder(state.roots, state.nodes)) {\n    const id = n.id;\n    const out: SerializedNode<TData, TLayer, TPose> = {\n      id,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent != null) out.parent = n.parent;\n    if (n.dependsOn === 'children') out.dependsOn = 'children';\n    else if (n.dependsOn && n.dependsOn.length > 0) out.dependsOn = n.dependsOn;\n    if (n.pickable === false) out.pickable = false;\n    if (n.kind === 'container' && n.units !== undefined) out.units = n.units;\n    Object.assign(\n      out,\n      fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey', (field) => {\n        throw new Error(\n          `Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. ` +\n          `The function must be registered via createScene's registry option to round-trip.`\n        );\n      }),\n    );\n    nodes.push(out);\n  }\n  const systemLayers = state.layers.map((l) => {\n    const layer: SerializedLayer<TLayer> = { id: l.id };\n    if (l.visible === false) layer.visible = false;\n    if (l.locked === true) layer.locked = true;\n    if (l.parallax) layer.parallax = l.parallax;\n    if (l.kind === 'user') {\n      layer.kind = 'user';\n      layer.name = l.name;\n    }\n    return layer;\n  });\n  return { version: 1, systemLayers, nodes };\n}\n\n/** Map a `SerializedScene` to construction specs. Shared by `sceneFromJSON`\n *  (new instance) and `Scene.loadState` (in-place). Validates version and\n *  resolves every `NODE_FN_FIELDS` key → function via the registry;\n *  throws on an unsupported version or an unknown registry key. */\nexport function specsFromSerialized<TData, TLayer extends string, TPose>(\n  json: SerializedScene<TData, TLayer, TPose>,\n  registry: SceneRegistry<TPose, TData, TLayer>,\n): AddNodeSpec<TData, TLayer, TPose>[] {\n  if (json.version !== 1) {\n    throw new Error(`Scene: unsupported version ${json.version}; only v1 supported`);\n  }\n  return json.nodes.map((n) => {\n    const spec: AddNodeSpec<TData, TLayer, TPose> = {\n      id: n.id as NodeId,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent !== undefined) spec.parent = n.parent as NodeId;\n    if (n.pickable !== undefined) spec.pickable = n.pickable;\n    if (n.units !== undefined) spec.units = n.units;\n    if (n.dependsOn !== undefined) {\n      spec.dependsOn = n.dependsOn === 'children'\n        ? 'children'\n        : (n.dependsOn as readonly NodeId[]);\n    }\n    const serialized = n as unknown as Record<string, string | undefined>;\n    for (const field of NODE_FN_FIELDS) {\n      const key = serialized[field.jsonKey];\n      if (key === undefined) continue;\n      const fn = (registry[field.field] as Record<string, unknown> | undefined)?.[key];\n      if (!fn) {\n        throw new Error(\n          `Scene: unknown ${field.field} key '${key}'. ` +\n          `Register a function with this key in the registry option.`,\n        );\n      }\n      (spec as unknown as Record<string, unknown>)[field.field] = fn;\n    }\n    return spec;\n  });\n}\n"],"mappings":";;;AAaA,SAAgBA,EACd,GACgD;CAChD,OAAO,OAAOC,KAAU,cAAYA,KAC9BA,EAAgC,YAAY,KAC7C,MAAM,QAASA,EAA8B,KAAK;AACzD;AAWA,SAAgBC,EACd,GACqB;CACrB,IAAMC,IAAO;EACX,IAAIC,EAAK;EACT,SAASA,EAAK,WAAW;EACzB,QAAQA,EAAK,UAAU;EACvB,GAAIA,EAAK,WAAW,EAAE,UAAUA,EAAK,SAAS,IAAI,CAAC;CACrD;CACA,OAAOA,EAAK,SAAS,SACjB;EAAE,GAAGD;EAAM,MAAM;EAAQ,MAAMC,EAAK,QAAQA,EAAK;CAAG,IACpD;EAAE,GAAGD;EAAM,MAAM;CAAS;AAChC;AAIA,SAAgBE,EACd,GACA,GACuC;CACvC,IAAMC,IAAgD,CAAC;CACvD,KAAK,IAAMC,KAAKC,EAAaC,EAAM,OAAOA,EAAM,KAAK,GAAG;EACtD,IAAMC,IAAKH,EAAE,IACPI,IAA4C;GAChD;GACA,MAAMJ,EAAE;GACR,OAAOA,EAAE;GACT,MAAMA,EAAE;GACR,MAAMA,EAAE;EACV;EAeA,AAdIA,EAAE,UAAU,SAAM,EAAI,SAASA,EAAE,SACjCA,EAAE,cAAc,aAAY,EAAI,YAAY,aACvCA,EAAE,aAAaA,EAAE,UAAU,SAAS,MAAG,EAAI,YAAYA,EAAE,YAC9DA,EAAE,aAAa,OAAO,EAAI,WAAW,KACrCA,EAAE,SAAS,eAAeA,EAAE,UAAU,KAAA,MAAW,EAAI,QAAQA,EAAE,QACnE,OAAO,OACLI,GACAC,EAASC,GAAUN,GAA+B,YAAY,MAAU;GACtE,MAAU,MACR,uBAAuBG,EAAG,QAAQI,EAAM,KAAK,MAAM,gHAErD;EACF,CAAC,CACH,GACAR,EAAM,KAAKK,CAAG;CAChB;CAYA,OAAO;EAAE,SAAS;EAAG,cAXAF,EAAM,OAAO,KAAK,MAAM;GAC3C,IAAMM,IAAiC,EAAE,IAAIC,EAAE,GAAG;GAQlD,OAPIA,EAAE,YAAY,OAAO,EAAM,UAAU,KACrCA,EAAE,WAAW,OAAM,EAAM,SAAS,KAClCA,EAAE,aAAU,EAAM,WAAWA,EAAE,WAC/BA,EAAE,SAAS,WACb,EAAM,OAAO,QACb,EAAM,OAAOA,EAAE,OAEVD;EACT,CACqB;EAAc;CAAM;AAC3C;AAMA,SAAgBE,EACd,GACA,GACqC;CACrC,IAAIC,EAAK,YAAY,GACnB,MAAU,MAAM,8BAA8BA,EAAK,QAAQ,oBAAoB;CAEjF,OAAOA,EAAK,MAAM,KAAK,MAAM;EAC3B,IAAMd,IAA0C;GAC9C,IAAIG,EAAE;GACN,MAAMA,EAAE;GACR,OAAOA,EAAE;GACT,MAAMA,EAAE;GACR,MAAMA,EAAE;EACV;EAIA,AAHIA,EAAE,WAAW,KAAA,MAAW,EAAK,SAASA,EAAE,SACxCA,EAAE,aAAa,KAAA,MAAW,EAAK,WAAWA,EAAE,WAC5CA,EAAE,UAAU,KAAA,MAAW,EAAK,QAAQA,EAAE,QACtCA,EAAE,cAAc,KAAA,MAClB,EAAK,YAAYA,EAAE,cAAc,aAC7B,aACCA,EAAE;EAET,IAAMY,IAAaZ;EACnB,KAAK,IAAMO,KAASM,GAAgB;GAClC,IAAMC,IAAMF,EAAWL,EAAM;GAC7B,IAAIO,MAAQ,KAAA,GAAW;GACvB,IAAMC,IAAMC,EAAST,EAAM,MAAM,GAA2CO;GAC5E,IAAI,CAACC,GACH,MAAU,MACR,kBAAkBR,EAAM,MAAM,QAAQO,EAAI,6DAE5C;GAEF,EAA6CP,EAAM,SAASQ;EAC9D;EACA,OAAOlB;CACT,CAAC;AACH"}
+{"version":3,"file":"serialization.js","names":[],"sources":["../../../src/core/scene/serialization.ts"],"sourcesContent":["/**\n * A scene to and from its JSON snapshot: the walk that writes one, and the\n * two readers that turn one back into layer records and node specs.\n */\nimport {\n  NODE_FN_FIELDS, fnKeysOf, type FnBearingNode, type NodeFnField,\n} from './nodeFnFields';\nimport { treePreorder } from './treeOrder';\nimport type {\n  AddNodeSpec, LayerRecord, Node, NodeId, SceneRegistry, SerializedLayer, SerializedNode, SerializedScene,\n} from './types';\n\n/** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */\nexport function isSerializedScene<TData, TLayer extends string, TPose>(\n  value: unknown,\n): value is SerializedScene<TData, TLayer, TPose> {\n  return typeof value === 'object' && value != null\n    && (value as { version?: unknown }).version === 1\n    && Array.isArray((value as { nodes?: unknown }).nodes);\n}\n\n/** What a snapshot is written from. */\nexport interface SerializableState<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  roots: NodeId[];\n  layers: LayerRecord<TLayer>[];\n}\n\n/** One layer record from its snapshot form. A snapshot with no `kind` predates\n *  user layers, so everything in it was a system layer. */\nexport function layerFromSerialized<TLayer extends string>(\n  spec: SerializedLayer<TLayer>,\n): LayerRecord<TLayer> {\n  const base = {\n    id: spec.id,\n    visible: spec.visible ?? true,\n    locked: spec.locked ?? false,\n    ...(spec.parallax ? { parallax: spec.parallax } : {}),\n    ...(spec.annotation ? { annotation: true } : {}),\n  };\n  return spec.kind === 'user'\n    ? { ...base, kind: 'user', name: spec.name ?? spec.id }\n    : { ...base, kind: 'system' };\n}\n\n/** The snapshot of `state`: layers in order, nodes in tree preorder. Throws\n *  when a node carries a function the registry has no key for. */\nexport function serializeScene<TData, TLayer extends string, TPose>(\n  state: SerializableState<TData, TLayer, TPose>,\n  fnFields: readonly NodeFnField[],\n): SerializedScene<TData, TLayer, TPose> {\n  const nodes: SerializedNode<TData, TLayer, TPose>[] = [];\n  for (const n of treePreorder(state.roots, state.nodes)) {\n    const id = n.id;\n    const out: SerializedNode<TData, TLayer, TPose> = {\n      id,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent != null) out.parent = n.parent;\n    if (n.dependsOn === 'children') out.dependsOn = 'children';\n    else if (n.dependsOn && n.dependsOn.length > 0) out.dependsOn = n.dependsOn;\n    if (n.pickable === false) out.pickable = false;\n    if (n.hidden === true) out.hidden = true;\n    if (n.locked === true) out.locked = true;\n    if (n.kind === 'container' && n.units !== undefined) out.units = n.units;\n    Object.assign(\n      out,\n      fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey', (field) => {\n        throw new Error(\n          `Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. ` +\n          `The function must be registered via createScene's registry option to round-trip.`\n        );\n      }),\n    );\n    nodes.push(out);\n  }\n  const systemLayers = state.layers.map((l) => {\n    const layer: SerializedLayer<TLayer> = { id: l.id };\n    if (l.visible === false) layer.visible = false;\n    if (l.locked === true) layer.locked = true;\n    if (l.parallax) layer.parallax = l.parallax;\n    if (l.annotation) layer.annotation = true;\n    if (l.kind === 'user') {\n      layer.kind = 'user';\n      layer.name = l.name;\n    }\n    return layer;\n  });\n  return { version: 1, systemLayers, nodes };\n}\n\n/** Map a `SerializedScene` to construction specs. Shared by `sceneFromJSON`\n *  (new instance) and `Scene.loadState` (in-place). Validates version and\n *  resolves every `NODE_FN_FIELDS` key → function via the registry;\n *  throws on an unsupported version or an unknown registry key. */\nexport function specsFromSerialized<TData, TLayer extends string, TPose>(\n  json: SerializedScene<TData, TLayer, TPose>,\n  registry: SceneRegistry<TPose, TData, TLayer>,\n): AddNodeSpec<TData, TLayer, TPose>[] {\n  if (json.version !== 1) {\n    throw new Error(`Scene: unsupported version ${json.version}; only v1 supported`);\n  }\n  return json.nodes.map((n) => {\n    const spec: AddNodeSpec<TData, TLayer, TPose> = {\n      id: n.id as NodeId,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent !== undefined) spec.parent = n.parent as NodeId;\n    if (n.pickable !== undefined) spec.pickable = n.pickable;\n    if (n.hidden === true) spec.hidden = true;\n    if (n.locked === true) spec.locked = true;\n    if (n.units !== undefined) spec.units = n.units;\n    if (n.dependsOn !== undefined) {\n      spec.dependsOn = n.dependsOn === 'children'\n        ? 'children'\n        : (n.dependsOn as readonly NodeId[]);\n    }\n    const serialized = n as unknown as Record<string, string | undefined>;\n    for (const field of NODE_FN_FIELDS) {\n      const key = serialized[field.jsonKey];\n      if (key === undefined) continue;\n      const fn = (registry[field.field] as Record<string, unknown> | undefined)?.[key];\n      if (!fn) {\n        throw new Error(\n          `Scene: unknown ${field.field} key '${key}'. ` +\n          `Register a function with this key in the registry option.`,\n        );\n      }\n      (spec as unknown as Record<string, unknown>)[field.field] = fn;\n    }\n    return spec;\n  });\n}\n"],"mappings":"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"}

package/dist/core/scene/staleReplay.js

@@ -1,51 +1,60 @@
 //#region src/core/scene/staleReplay.ts
-var e = class extends Error {};
-function t(e) {
-	let t = 0, n = /* @__PURE__ */ new WeakMap(), r = (t) => t === null || e.has(t), i = (t, n) => {
-		let r = e.get(t);
-		return r?.kind !== "container" || r.children.every((e) => n?.has(e) === !0);
+/** A scene edit named a node the scene does not hold, or one it already does. */
+var SceneMembershipError = class extends Error {};
+function createStaleReplay(nodes) {
+	let replaying = 0;
+	/** Kit payloads whose last replay was skipped, by the direction it ran in. */
+	const skipped = /* @__PURE__ */ new WeakMap();
+	const holds = (id) => id === null || nodes.has(id);
+	const childless = (id, within) => {
+		const node = nodes.get(id);
+		return node?.kind !== "container" || node.children.every((c) => within?.has(c) === true);
 	};
-	function a(t, n, a) {
-		switch (t) {
+	function stale(kind, payload, forward) {
+		switch (kind) {
 			case "kit:add": {
-				let t = n;
-				return a ? e.has(t.id) || !r(t.parent) : !e.has(t.id) || !i(t.id);
+				const p = payload;
+				return forward ? nodes.has(p.id) || !holds(p.parent) : !nodes.has(p.id) || !childless(p.id);
 			}
 			case "kit:remove": {
-				let t = n;
-				if (!a) return t.nodes.some((t) => e.has(t.id)) || !t.detached.every((e) => r(e.parent));
-				let o = new Set(t.nodes.map((e) => e.id));
-				return !t.nodes.every((t) => e.has(t.id) && i(t.id, o));
+				const p = payload;
+				if (!forward) return p.nodes.some((n) => nodes.has(n.id)) || !p.detached.every((d) => holds(d.parent));
+				const taken = new Set(p.nodes.map((n) => n.id));
+				return !p.nodes.every((n) => nodes.has(n.id) && childless(n.id, taken));
 			}
 			case "kit:move": {
-				let t = n;
-				return !e.has(t.id) || !r(a ? t.toParent : t.fromParent);
+				const p = payload;
+				return !nodes.has(p.id) || !holds(forward ? p.toParent : p.fromParent);
 			}
 			case "kit:setPose":
 			case "kit:setData":
 			case "kit:setLayer":
 			case "kit:setDependsOn":
 			case "kit:setLayout":
-			case "kit:setUnits": return !e.has(n.id);
-			default: return !1;
+			case "kit:setUnits": return !nodes.has(payload.id);
+			default: return false;
 		}
 	}
-	function o(e, r, i) {
-		return t === 0 || typeof r != "object" || !r ? !1 : n.get(r) === !i ? n.delete(r) : a(e, r, i) ? (n.set(r, i), !0) : !1;
+	function skips(kind, payload, forward) {
+		if (replaying === 0 || typeof payload !== "object" || payload === null) return false;
+		if (skipped.get(payload) === !forward) return skipped.delete(payload);
+		if (!stale(kind, payload, forward)) return false;
+		skipped.set(payload, forward);
+		return true;
 	}
 	return {
-		during(e) {
-			t++;
+		during(step) {
+			replaying++;
 			try {
-				return e();
+				return step();
 			} finally {
-				t--;
+				replaying--;
 			}
 		},
-		skips: o
+		skips
 	};
 }
-//#endregion
-export { e as SceneMembershipError, t as createStaleReplay };
 
+//#endregion
+export { SceneMembershipError, createStaleReplay };
 //# sourceMappingURL=staleReplay.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"staleReplay.js","names":["SceneMembershipError","createStaleReplay","replaying","skipped","holds","id","nodes","childless","node","within","c","stale","kind","p","payload","forward","n","d","taken","skips","step"],"sources":["../../../src/core/scene/staleReplay.ts"],"sourcesContent":["/**\n * What a replay does with an op whose node is not where its entry left it.\n *\n * An untracked edit changes the tree without the history stack hearing of it,\n * so an entry can name a node that edit removed, or add one it already put\n * back. Replaying such an op is skipped rather than refused: a refusal leaves\n * the entry on top of its stack, and every entry beneath it out of reach. The\n * inverse of a skipped op is skipped too, so undo then redo changes nothing.\n */\nimport type { RemoveSnapshot } from './kitOps';\nimport type { Node, NodeId } from './types';\n\n/** A scene edit named a node the scene does not hold, or one it already does. */\nexport class SceneMembershipError extends Error {}\n\nexport interface StaleReplay {\n  /** Run a step that replays recorded ops. */\n  during<T>(step: () => T): T;\n  /** Whether replaying this kit op would address a node that is gone, or\n   *  restore one that is already there. Always false outside `during`. */\n  skips(kind: string, payload: unknown, forward: boolean): boolean;\n}\n\nexport function createStaleReplay<TData, TLayer extends string, TPose>(\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>,\n): StaleReplay {\n  let replaying = 0;\n  /** Kit payloads whose last replay was skipped, by the direction it ran in. */\n  const skipped = new WeakMap<object, boolean>();\n  const holds = (id: NodeId | null): boolean => id === null || nodes.has(id);\n  const childless = (id: NodeId, within?: ReadonlySet<NodeId>): boolean => {\n    const node = nodes.get(id);\n    return node?.kind !== 'container' || node.children.every((c) => within?.has(c) === true);\n  };\n\n  function stale(kind: string, payload: unknown, forward: boolean): boolean {\n    switch (kind) {\n      case 'kit:add': {\n        const p = payload as { id: NodeId; parent: NodeId | null };\n        return forward ? nodes.has(p.id) || !holds(p.parent) : !nodes.has(p.id) || !childless(p.id);\n      }\n      case 'kit:remove': {\n        const p = payload as RemoveSnapshot<TData, TLayer, TPose>;\n        if (!forward) return p.nodes.some((n) => nodes.has(n.id)) || !p.detached.every((d) => holds(d.parent));\n        const taken = new Set(p.nodes.map((n) => n.id));\n        return !p.nodes.every((n) => nodes.has(n.id) && childless(n.id, taken));\n      }\n      case 'kit:move': {\n        const p = payload as { id: NodeId; fromParent: NodeId | null; toParent: NodeId | null };\n        return !nodes.has(p.id) || !holds(forward ? p.toParent : p.fromParent);\n      }\n      case 'kit:setPose':\n      case 'kit:setData':\n      case 'kit:setLayer':\n      case 'kit:setDependsOn':\n      case 'kit:setLayout':\n      case 'kit:setUnits':\n        return !nodes.has((payload as { id: NodeId }).id);\n      default:\n        return false;\n    }\n  }\n\n  function skips(kind: string, payload: unknown, forward: boolean): boolean {\n    if (replaying === 0 || typeof payload !== 'object' || payload === null) return false;\n    if (skipped.get(payload) === !forward) return skipped.delete(payload);\n    if (!stale(kind, payload, forward)) return false;\n    skipped.set(payload, forward);\n    return true;\n  }\n\n  return {\n    during(step) {\n      replaying++;\n      try {\n        return step();\n      } finally {\n        replaying--;\n      }\n    },\n    skips,\n  };\n}\n"],"mappings":";AAaA,IAAaA,IAAb,cAA0C,MAAM,CAAC;AAUjD,SAAgBC,EACd,GACa;CACb,IAAIC,IAAY,GAEVC,oBAAU,IAAI,QAAyB,GACvCC,KAAS,MAA+BC,MAAO,QAAQC,EAAM,IAAID,CAAE,GACnEE,KAAa,GAAY,MAA0C;EACvE,IAAMC,IAAOF,EAAM,IAAID,CAAE;EACzB,OAAOG,GAAM,SAAS,eAAeA,EAAK,SAAS,OAAO,MAAMC,GAAQ,IAAIC,CAAC,MAAM,EAAI;CACzF;CAEA,SAASC,EAAM,GAAc,GAAkB,GAA2B;EACxE,QAAQC,GAAR;GACE,KAAK,WAAW;IACd,IAAMC,IAAIC;IACV,OAAOC,IAAUT,EAAM,IAAIO,EAAE,EAAE,KAAK,CAACT,EAAMS,EAAE,MAAM,IAAI,CAACP,EAAM,IAAIO,EAAE,EAAE,KAAK,CAACN,EAAUM,EAAE,EAAE;GAC5F;GACA,KAAK,cAAc;IACjB,IAAMA,IAAIC;IACV,IAAI,CAACC,GAAS,OAAOF,EAAE,MAAM,MAAM,MAAMP,EAAM,IAAIU,EAAE,EAAE,CAAC,KAAK,CAACH,EAAE,SAAS,OAAO,MAAMT,EAAMa,EAAE,MAAM,CAAC;IACrG,IAAMC,IAAQ,IAAI,IAAIL,EAAE,MAAM,KAAK,MAAMG,EAAE,EAAE,CAAC;IAC9C,OAAO,CAACH,EAAE,MAAM,OAAO,MAAMP,EAAM,IAAIU,EAAE,EAAE,KAAKT,EAAUS,EAAE,IAAIE,CAAK,CAAC;GACxE;GACA,KAAK,YAAY;IACf,IAAML,IAAIC;IACV,OAAO,CAACR,EAAM,IAAIO,EAAE,EAAE,KAAK,CAACT,EAAMW,IAAUF,EAAE,WAAWA,EAAE,UAAU;GACvE;GACA,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,gBACH,OAAO,CAACP,EAAM,IAAKQ,EAA2B,EAAE;GAClD,SACE,OAAO;EACX;CACF;CAEA,SAASK,EAAM,GAAc,GAAkB,GAA2B;EAKxE,OAJIjB,MAAc,KAAK,OAAOY,KAAY,aAAYA,IAAyB,KAC3EX,EAAQ,IAAIW,CAAO,MAAM,CAACC,IAAgBZ,EAAQ,OAAOW,CAAO,IAC/DH,EAAMC,GAAME,GAASC,CAAO,KACjCZ,EAAQ,IAAIW,GAASC,CAAO,GACrB,MAFoC;CAG7C;CAEA,OAAO;EACL,OAAO,GAAM;GACX;GACA,IAAI;IACF,OAAOK,EAAK;GACd,UAAU;IACR;GACF;EACF;EACA;CACF;AACF"}
+{"version":3,"file":"staleReplay.js","names":[],"sources":["../../../src/core/scene/staleReplay.ts"],"sourcesContent":["/**\n * What a replay does with an op whose node is not where its entry left it.\n *\n * An untracked edit changes the tree without the history stack hearing of it,\n * so an entry can name a node that edit removed, or add one it already put\n * back. Replaying such an op is skipped rather than refused: a refusal leaves\n * the entry on top of its stack, and every entry beneath it out of reach. The\n * inverse of a skipped op is skipped too, so undo then redo changes nothing.\n */\nimport type { RemoveSnapshot } from './kitOps';\nimport type { Node, NodeId } from './types';\n\n/** A scene edit named a node the scene does not hold, or one it already does. */\nexport class SceneMembershipError extends Error {}\n\nexport interface StaleReplay {\n  /** Run a step that replays recorded ops. */\n  during<T>(step: () => T): T;\n  /** Whether replaying this kit op would address a node that is gone, or\n   *  restore one that is already there. Always false outside `during`. */\n  skips(kind: string, payload: unknown, forward: boolean): boolean;\n}\n\nexport function createStaleReplay<TData, TLayer extends string, TPose>(\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>,\n): StaleReplay {\n  let replaying = 0;\n  /** Kit payloads whose last replay was skipped, by the direction it ran in. */\n  const skipped = new WeakMap<object, boolean>();\n  const holds = (id: NodeId | null): boolean => id === null || nodes.has(id);\n  const childless = (id: NodeId, within?: ReadonlySet<NodeId>): boolean => {\n    const node = nodes.get(id);\n    return node?.kind !== 'container' || node.children.every((c) => within?.has(c) === true);\n  };\n\n  function stale(kind: string, payload: unknown, forward: boolean): boolean {\n    switch (kind) {\n      case 'kit:add': {\n        const p = payload as { id: NodeId; parent: NodeId | null };\n        return forward ? nodes.has(p.id) || !holds(p.parent) : !nodes.has(p.id) || !childless(p.id);\n      }\n      case 'kit:remove': {\n        const p = payload as RemoveSnapshot<TData, TLayer, TPose>;\n        if (!forward) return p.nodes.some((n) => nodes.has(n.id)) || !p.detached.every((d) => holds(d.parent));\n        const taken = new Set(p.nodes.map((n) => n.id));\n        return !p.nodes.every((n) => nodes.has(n.id) && childless(n.id, taken));\n      }\n      case 'kit:move': {\n        const p = payload as { id: NodeId; fromParent: NodeId | null; toParent: NodeId | null };\n        return !nodes.has(p.id) || !holds(forward ? p.toParent : p.fromParent);\n      }\n      case 'kit:setPose':\n      case 'kit:setData':\n      case 'kit:setLayer':\n      case 'kit:setDependsOn':\n      case 'kit:setLayout':\n      case 'kit:setUnits':\n        return !nodes.has((payload as { id: NodeId }).id);\n      default:\n        return false;\n    }\n  }\n\n  function skips(kind: string, payload: unknown, forward: boolean): boolean {\n    if (replaying === 0 || typeof payload !== 'object' || payload === null) return false;\n    if (skipped.get(payload) === !forward) return skipped.delete(payload);\n    if (!stale(kind, payload, forward)) return false;\n    skipped.set(payload, forward);\n    return true;\n  }\n\n  return {\n    during(step) {\n      replaying++;\n      try {\n        return step();\n      } finally {\n        replaying--;\n      }\n    },\n    skips,\n  };\n}\n"],"mappings":";;AAaA,IAAa,uBAAb,cAA0C,MAAM,CAAC;AAUjD,SAAgB,kBACd,OACa;CACb,IAAI,YAAY;;CAEhB,MAAM,0BAAU,IAAI,QAAyB;CAC7C,MAAM,SAAS,OAA+B,OAAO,QAAQ,MAAM,IAAI,EAAE;CACzE,MAAM,aAAa,IAAY,WAA0C;EACvE,MAAM,OAAO,MAAM,IAAI,EAAE;EACzB,OAAO,MAAM,SAAS,eAAe,KAAK,SAAS,OAAO,MAAM,QAAQ,IAAI,CAAC,MAAM,IAAI;CACzF;CAEA,SAAS,MAAM,MAAc,SAAkB,SAA2B;EACxE,QAAQ,MAAR;GACE,KAAK,WAAW;IACd,MAAM,IAAI;IACV,OAAO,UAAU,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE;GAC5F;GACA,KAAK,cAAc;IACjB,MAAM,IAAI;IACV,IAAI,CAAC,SAAS,OAAO,EAAE,MAAM,MAAM,MAAM,MAAM,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,MAAM,MAAM,EAAE,MAAM,CAAC;IACrG,MAAM,QAAQ,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,EAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,OAAO,MAAM,MAAM,IAAI,EAAE,EAAE,KAAK,UAAU,EAAE,IAAI,KAAK,CAAC;GACxE;GACA,KAAK,YAAY;IACf,MAAM,IAAI;IACV,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,UAAU,EAAE,WAAW,EAAE,UAAU;GACvE;GACA,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,gBACH,OAAO,CAAC,MAAM,IAAK,QAA2B,EAAE;GAClD,SACE,OAAO;EACX;CACF;CAEA,SAAS,MAAM,MAAc,SAAkB,SAA2B;EACxE,IAAI,cAAc,KAAK,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO;EAC/E,IAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,SAAS,OAAO,QAAQ,OAAO,OAAO;EACpE,IAAI,CAAC,MAAM,MAAM,SAAS,OAAO,GAAG,OAAO;EAC3C,QAAQ,IAAI,SAAS,OAAO;EAC5B,OAAO;CACT;CAEA,OAAO;EACL,OAAO,MAAM;GACX;GACA,IAAI;IACF,OAAO,KAAK;GACd,UAAU;IACR;GACF;EACF;EACA;CACF;AACF"}

package/dist/core/scene/statedFields.js

@@ -1,9 +1,14 @@
 //#region src/core/scene/statedFields.ts
-var e = (e) => ({
-	...e.pickable === void 0 ? {} : { pickable: e.pickable },
-	...e.kind === "container" && e.units !== void 0 ? { units: e.units } : {}
+/** The plain optional fields of a node or spec as a spread for `scene.add`:
+*  each present only when stated, so an unstated one keeps the scene's
+*  default. A leaf states no `units`, and a flag states only `true`. */
+var statedFields = (n) => ({
+	...n.pickable !== void 0 ? { pickable: n.pickable } : {},
+	...n.hidden === true ? { hidden: true } : {},
+	...n.locked === true ? { locked: true } : {},
+	...n.kind === "container" && n.units !== void 0 ? { units: n.units } : {}
 });
-//#endregion
-export { e as statedFields };
 
+//#endregion
+export { statedFields };
 //# sourceMappingURL=statedFields.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"statedFields.js","names":["statedFields","n"],"sources":["../../../src/core/scene/statedFields.ts"],"sourcesContent":["import type { UnitScope } from '@weasel-js/quantity';\n\ninterface Stated { kind?: 'leaf' | 'container'; pickable?: boolean; units?: UnitScope }\n\n/** The plain optional fields of a node or spec as a spread for `scene.add`:\n *  each present only when stated, so an unstated one keeps the scene's\n *  default. A leaf states no `units`. */\nexport const statedFields = (n: Stated): { pickable?: boolean; units?: UnitScope } => ({\n  ...(n.pickable !== undefined ? { pickable: n.pickable } : {}),\n  ...(n.kind === 'container' && n.units !== undefined ? { units: n.units } : {}),\n});\n"],"mappings":";AAOA,IAAaA,KAAgB,OAA0D;CACrF,GAAIC,EAAE,aAAa,KAAA,IAAuC,CAAC,IAA5B,EAAE,UAAUA,EAAE,SAAS;CACtD,GAAIA,EAAE,SAAS,eAAeA,EAAE,UAAU,KAAA,IAAY,EAAE,OAAOA,EAAE,MAAM,IAAI,CAAC;AAC9E"}
+{"version":3,"file":"statedFields.js","names":[],"sources":["../../../src/core/scene/statedFields.ts"],"sourcesContent":["import type { UnitScope } from '@weasel-js/quantity';\n\ninterface Stated {\n  kind?: 'leaf' | 'container'; pickable?: boolean; hidden?: boolean; locked?: boolean; units?: UnitScope;\n}\n\n/** The plain optional fields of a node or spec as a spread for `scene.add`:\n *  each present only when stated, so an unstated one keeps the scene's\n *  default. A leaf states no `units`, and a flag states only `true`. */\nexport const statedFields = (n: Stated): Omit<Stated, 'kind'> => ({\n  ...(n.pickable !== undefined ? { pickable: n.pickable } : {}),\n  ...(n.hidden === true ? { hidden: true } : {}),\n  ...(n.locked === true ? { locked: true } : {}),\n  ...(n.kind === 'container' && n.units !== undefined ? { units: n.units } : {}),\n});\n"],"mappings":";;;;AASA,IAAa,gBAAgB,OAAqC;CAChE,GAAI,EAAE,aAAa,SAAY,EAAE,UAAU,EAAE,SAAS,IAAI,CAAC;CAC3D,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,SAAS,eAAe,EAAE,UAAU,SAAY,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC9E"}

package/dist/core/scene/treeEdits.js

@@ -1,127 +1,158 @@
-import { fnKeysOf as e } from "./nodeFnFields.js";
-import { statedFields as t } from "./statedFields.js";
-import { SceneMembershipError as n } from "./staleReplay.js";
+import { fnKeysOf } from "./nodeFnFields.js";
+import { statedFields } from "./statedFields.js";
+import { SceneMembershipError } from "./staleReplay.js";
+
 //#region src/core/scene/treeEdits.ts
-function r(t, n, r, i) {
-	let a = t.map((e) => {
-		let t = r.requireNode(e);
-		return t.kind === "container" ? {
-			...t,
-			children: [...t.children]
-		} : { ...t };
-	}), o = a.filter((e) => e.parent === null || !n.has(e.parent)).map((e) => ({
-		id: e.id,
-		parent: e.parent,
-		index: r.siblingsOf(e.parent).indexOf(e.id)
-	})).sort((e, t) => e.index - t.index), s = a.flatMap((t) => {
-		let n = e(i, t, "opKey");
-		return Object.keys(n).length === 0 ? [] : [{
-			id: t.id,
-			...n
+/** What `kit:remove` carries for the nodes `ids`, read before any of them
+*  goes. Throws on an id that is not in the scene. */
+function removeSnapshot(ids, removing, store, fnFields) {
+	const nodes = ids.map((nid) => {
+		const n = store.requireNode(nid);
+		return n.kind === "container" ? {
+			...n,
+			children: [...n.children]
+		} : { ...n };
+	});
+	const detached = nodes.filter((n) => n.parent === null || !removing.has(n.parent)).map((n) => ({
+		id: n.id,
+		parent: n.parent,
+		index: store.siblingsOf(n.parent).indexOf(n.id)
+	})).sort((l, r) => l.index - r.index);
+	const fnKeys = nodes.flatMap((n) => {
+		const keys = fnKeysOf(fnFields, n, "opKey");
+		return Object.keys(keys).length === 0 ? [] : [{
+			id: n.id,
+			...keys
 		}];
 	});
 	return {
-		nodes: a,
-		detached: o,
-		...s.length > 0 ? { fnKeys: s } : {}
+		nodes,
+		detached,
+		...fnKeys.length > 0 ? { fnKeys } : {}
 	};
 }
-function i(i) {
-	let { nodes: a, fnFields: o } = i, { requireNode: s, siblingsOf: c, descendants: l, removalClosure: u, patchNodeFunctions: d } = i.store, { refuse: f, refuseLayer: p } = i.locks, { requireLayerIndex: m, assertSubtreeLayer: h } = i.layers, { record: g, edit: _ } = i.recorder, { noteArrival: v, noteDeparture: y, noteChange: b } = i.arrivals;
-	function x(r) {
-		let l = r.id ?? i.generateId();
-		if (a.has(l)) throw new n(`Scene: id collision on "${l}"`);
-		m(r.layer), p(r.layer, "add to");
-		let u = r.parent ?? null;
-		if (u !== null) {
-			let e = s(u);
-			if (e.kind !== "container") throw Error(`Scene: parent "${u}" is not a container`);
-			h(r.id, r.layer, u, e.layer), f(u, "add under");
+function createTreeEdits(env) {
+	const { nodes, fnFields } = env;
+	const { requireNode, siblingsOf, descendants, removalClosure, patchNodeFunctions } = env.store;
+	const { refuse, refuseLayer } = env.locks;
+	const { requireLayerIndex, assertSubtreeLayer } = env.layers;
+	const { record, edit } = env.recorder;
+	const { noteArrival, noteDeparture, noteChange } = env.arrivals;
+	/** Check that `spec` can be placed, and answer with the `kit:add` payload
+	*  that places it. Throws on an id collision, an unknown or locked layer,
+	*  a parent that is not a container or is locked, and a layer below the
+	*  parent's. */
+	function addPayload(spec) {
+		const id = spec.id ?? env.generateId();
+		if (nodes.has(id)) throw new SceneMembershipError(`Scene: id collision on "${id}"`);
+		requireLayerIndex(spec.layer);
+		refuseLayer(spec.layer, "add to");
+		const parent = spec.parent ?? null;
+		if (parent !== null) {
+			const p = requireNode(parent);
+			if (p.kind !== "container") throw new Error(`Scene: parent "${parent}" is not a container`);
+			assertSubtreeLayer(spec.id, spec.layer, parent, p.layer);
+			refuse(parent, "add under");
 		}
 		return {
-			id: l,
-			kind: r.kind,
-			layer: r.layer,
-			pose: r.pose,
-			data: r.data,
-			parent: u,
-			index: r.index ?? c(u).length,
-			...r.dependsOn === void 0 ? {} : { dependsOn: r.dependsOn },
-			...t(r),
-			...e(o, {
-				...r,
-				id: l,
-				kind: r.kind
+			id,
+			kind: spec.kind,
+			layer: spec.layer,
+			pose: spec.pose,
+			data: spec.data,
+			parent,
+			index: spec.index ?? siblingsOf(parent).length,
+			...spec.dependsOn !== void 0 ? { dependsOn: spec.dependsOn } : {},
+			...statedFields(spec),
+			...fnKeysOf(fnFields, {
+				...spec,
+				id,
+				kind: spec.kind
 			}, "opKey")
 		};
 	}
-	function S(e) {
-		if (e.length === 0) return;
-		let { ids: t, removing: n } = u(e);
-		for (let e of t) f(e, "remove");
-		let a = r(t, n, i.store, o), { detached: s } = a;
-		_("remove", s.some((e) => e.parent !== null), () => {
-			for (let e of s) y(e.id, e.parent, null);
-			g("kit:remove", a, "remove");
+	function removeMany(rootIds) {
+		if (rootIds.length === 0) return;
+		const { ids, removing } = removalClosure(rootIds);
+		for (const nid of ids) refuse(nid, "remove");
+		const payload = removeSnapshot(ids, removing, env.store, fnFields);
+		const { detached } = payload;
+		edit("remove", detached.some((d) => d.parent !== null), () => {
+			for (const d of detached) noteDeparture(d.id, d.parent, null);
+			record("kit:remove", payload, "remove");
 		});
 	}
 	return {
-		construct(e) {
-			i.locks.lifted(() => {
-				for (let t of e) {
-					let e = x(t);
-					i.runOp("kit:add", e), d(t, e.id, null);
+		construct(specs) {
+			env.locks.lifted(() => {
+				for (const spec of specs) {
+					const payload = addPayload(spec);
+					env.runOp("kit:add", payload);
+					patchNodeFunctions(spec, payload.id, null);
 				}
 			});
 		},
-		add(e) {
-			let t = x(e), n = `add ${e.kind}`;
-			return _(n, t.parent !== null, () => (v(t.id, t.parent, null), g("kit:add", t, n), d(e, t.id, t), t.id));
+		add(spec) {
+			const payload = addPayload(spec);
+			const label = `add ${spec.kind}`;
+			return edit(label, payload.parent !== null, () => {
+				noteArrival(payload.id, payload.parent, null);
+				record("kit:add", payload, label);
+				patchNodeFunctions(spec, payload.id, payload);
+				return payload.id;
+			});
 		},
-		remove: (e) => S([e]),
-		removalClosure: (e) => u(e).ids,
-		removeMany: S,
-		move(e, t, n) {
-			let r = s(e);
-			if (f(e, "move"), t !== null) {
-				f(t, "move nodes into");
-				let n = s(t);
-				if (n.kind !== "container") throw Error(`Scene: parent "${t}" is not a container`);
-				if (h(e, r.layer, t, n.layer), t === e) throw Error("Scene: cannot parent a node to itself");
-				let i = [];
-				if (l(e, i), i.includes(t)) throw Error("Scene: cannot parent a node to its own descendant");
+		remove: (id) => removeMany([id]),
+		removalClosure: (rootIds) => removalClosure(rootIds).ids,
+		removeMany,
+		move(id, parent, index) {
+			const node = requireNode(id);
+			refuse(id, "move");
+			if (parent !== null) {
+				refuse(parent, "move nodes into");
+				const p = requireNode(parent);
+				if (p.kind !== "container") throw new Error(`Scene: parent "${parent}" is not a container`);
+				assertSubtreeLayer(id, node.layer, parent, p.layer);
+				if (parent === id) throw new Error("Scene: cannot parent a node to itself");
+				const desc = [];
+				descendants(id, desc);
+				if (desc.includes(parent)) throw new Error("Scene: cannot parent a node to its own descendant");
 			}
-			let i = r.parent;
-			_("move", t !== null || i !== null, () => {
-				let r = c(i).indexOf(e), a = n ?? c(t).length;
-				v(e, t, i), y(e, i, t), b(i), g("kit:move", {
-					id: e,
-					fromParent: i,
-					fromIndex: r,
-					toParent: t,
-					toIndex: a
+			const fromParent = node.parent;
+			edit("move", parent !== null || fromParent !== null, () => {
+				const fromIndex = siblingsOf(fromParent).indexOf(id);
+				const toIndex = index ?? siblingsOf(parent).length;
+				noteArrival(id, parent, fromParent);
+				noteDeparture(id, fromParent, parent);
+				noteChange(fromParent);
+				record("kit:move", {
+					id,
+					fromParent,
+					fromIndex,
+					toParent: parent,
+					toIndex
 				}, "move");
 			});
 		},
-		reorder(e, t) {
-			let n = s(e);
-			f(e, "reorder");
-			let r = n.parent;
-			_("reorder", r !== null, () => {
-				b(r);
-				let n = c(r).indexOf(e);
-				g("kit:move", {
-					id: e,
-					fromParent: r,
-					fromIndex: n,
-					toParent: r,
-					toIndex: t
+		reorder(id, index) {
+			const node = requireNode(id);
+			refuse(id, "reorder");
+			const parent = node.parent;
+			edit("reorder", parent !== null, () => {
+				noteChange(parent);
+				const fromIndex = siblingsOf(parent).indexOf(id);
+				record("kit:move", {
+					id,
+					fromParent: parent,
+					fromIndex,
+					toParent: parent,
+					toIndex: index
 				}, "reorder");
 			});
 		}
 	};
 }
-//#endregion
-export { i as createTreeEdits };
 
+//#endregion
+export { createTreeEdits };
 //# sourceMappingURL=treeEdits.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"treeEdits.js","names":["removeSnapshot","nodes","ids","n","store","nid","detached","removing","l","r","fnKeys","keys","fnKeysOf","fnFields","createTreeEdits","env","addPayload","id","spec","SceneMembershipError","requireLayerIndex","refuseLayer","parent","p","requireNode","assertSubtreeLayer","refuse","siblingsOf","statedFields","removeMany","rootIds","removalClosure","payload","d","specs","patchNodeFunctions","label","edit","noteArrival","record","node","desc","descendants","fromParent","fromIndex","toIndex","index","noteDeparture","noteChange"],"sources":["../../../src/core/scene/treeEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its tree: adding and removing nodes, reparenting, and\n * reordering siblings. Each checks its arguments, then records one kit op.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport type { RemoveSnapshot } from './kitOps';\nimport type { createLayerStack } from './layerStack';\nimport type { LockGuard } from './lockGuard';\nimport { fnKeysOf, type FnBearingNode, type NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { Recorder } from './recorder';\nimport { SceneMembershipError } from './staleReplay';\nimport { statedFields } from './statedFields';\nimport type { AddNodeSpec, Node, NodeId, Scene } from './types';\n\nexport interface TreeEditsEnv<TData, TLayer extends string, TPose> {\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>;\n  generateId(): NodeId;\n  store: Pick<\n    ReturnType<typeof createNodeStore<TData, TLayer, TPose>>,\n    'requireNode' | 'siblingsOf' | 'descendants' | 'removalClosure' | 'patchNodeFunctions'\n  >;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<ReturnType<typeof createLayerStack<TLayer>>, 'requireLayerIndex' | 'assertSubtreeLayer'>;\n  fnFields: readonly NodeFnField[];\n  /** Run a registered op without recording it. */\n  runOp(kind: string, payload: unknown): void;\n  recorder: Pick<Recorder, 'record' | 'edit'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange'>;\n}\n\nexport interface TreeEdits<TData, TLayer extends string, TPose>\n  extends Pick<Scene<TData, TLayer, TPose>, 'add' | 'remove' | 'removalClosure' | 'removeMany' | 'move' | 'reorder'> {\n  /** Place nodes as the document a scene starts from, or is loaded with:\n   *  nothing is recorded, and no lock refuses. Specs list parents before\n   *  children, the order `toJSON()` emits. */\n  construct(specs: readonly AddNodeSpec<TData, TLayer, TPose>[]): void;\n}\n\n/** What `kit:remove` carries for the nodes `ids`, read before any of them\n *  goes. Throws on an id that is not in the scene. */\nfunction removeSnapshot<TData, TLayer extends string, TPose>(\n  ids: readonly NodeId[],\n  removing: ReadonlySet<NodeId>,\n  store: Pick<TreeEditsEnv<TData, TLayer, TPose>['store'], 'requireNode' | 'siblingsOf'>,\n  fnFields: readonly NodeFnField[],\n): RemoveSnapshot<TData, TLayer, TPose> {\n  const nodes: Node<TData, TLayer, TPose>[] = ids.map((nid) => {\n    const n = store.requireNode(nid);\n    return n.kind === 'container' ? { ...n, children: [...n.children] } : { ...n };\n  });\n  // The rest is reachable through a snapshotted parent's cloned `children`.\n  const detached = nodes\n    .filter((n) => n.parent === null || !removing.has(n.parent))\n    .map((n) => ({ id: n.id, parent: n.parent, index: store.siblingsOf(n.parent).indexOf(n.id) }))\n    .sort((l, r) => l.index - r.index);\n  const fnKeys = nodes.flatMap((n) => {\n    const keys = fnKeysOf(fnFields, n as unknown as FnBearingNode, 'opKey');\n    return Object.keys(keys).length === 0 ? [] : [{ id: n.id, ...keys }];\n  });\n  return { nodes, detached, ...(fnKeys.length > 0 ? { fnKeys } : {}) };\n}\n\nexport function createTreeEdits<TData, TLayer extends string, TPose>(\n  env: TreeEditsEnv<TData, TLayer, TPose>,\n): TreeEdits<TData, TLayer, TPose> {\n  const { nodes, fnFields } = env;\n  const { requireNode, siblingsOf, descendants, removalClosure, patchNodeFunctions } = env.store;\n  const { refuse, refuseLayer } = env.locks;\n  const { requireLayerIndex, assertSubtreeLayer } = env.layers;\n  const { record, edit } = env.recorder;\n  const { noteArrival, noteDeparture, noteChange } = env.arrivals;\n\n  /** Check that `spec` can be placed, and answer with the `kit:add` payload\n   *  that places it. Throws on an id collision, an unknown or locked layer,\n   *  a parent that is not a container or is locked, and a layer below the\n   *  parent's. */\n  function addPayload(spec: AddNodeSpec<TData, TLayer, TPose>) {\n    const id = spec.id ?? env.generateId();\n    if (nodes.has(id)) throw new SceneMembershipError(`Scene: id collision on \"${id}\"`);\n    requireLayerIndex(spec.layer);\n    refuseLayer(spec.layer, 'add to');\n    const parent = spec.parent ?? null;\n    if (parent !== null) {\n      const p = requireNode(parent);\n      if (p.kind !== 'container') {\n        throw new Error(`Scene: parent \"${parent}\" is not a container`);\n      }\n      assertSubtreeLayer(spec.id, spec.layer, parent, p.layer);\n      refuse(parent, 'add under');\n    }\n    return {\n      id, kind: spec.kind, layer: spec.layer, pose: spec.pose, data: spec.data,\n      parent, index: spec.index ?? siblingsOf(parent).length,\n      ...(spec.dependsOn !== undefined ? { dependsOn: spec.dependsOn } : {}),\n      ...statedFields(spec),\n      ...fnKeysOf(fnFields, { ...spec, id, kind: spec.kind } as unknown as FnBearingNode, 'opKey'),\n    };\n  }\n\n  function removeMany(rootIds: readonly NodeId[]): void {\n    if (rootIds.length === 0) return;\n    // Every id resolves against the pre-removal tree, so an id another one\n    // cascades away is absorbed rather than being a second, failing removal.\n    const { ids, removing } = removalClosure(rootIds);\n    for (const nid of ids) refuse(nid, 'remove');\n    const payload = removeSnapshot(ids, removing, env.store, fnFields);\n    const { detached } = payload;\n    edit('remove', detached.some((d) => d.parent !== null), () => {\n      for (const d of detached) noteDeparture(d.id, d.parent, null);\n      record('kit:remove', payload, 'remove');\n    });\n  }\n\n  return {\n    construct(specs) {\n      env.locks.lifted(() => {\n        for (const spec of specs) {\n          const payload = addPayload(spec);\n          env.runOp('kit:add', payload);\n          patchNodeFunctions(spec, payload.id, null);\n        }\n      });\n    },\n\n    add(spec) {\n      const payload = addPayload(spec);\n      const label = `add ${spec.kind}`;\n      return edit(label, payload.parent !== null, () => {\n        noteArrival(payload.id, payload.parent, null);\n        record('kit:add', payload, label);\n        patchNodeFunctions(spec, payload.id, payload);\n        return payload.id;\n      });\n    },\n\n    remove: (id) => removeMany([id]),\n\n    removalClosure: (rootIds) => removalClosure(rootIds).ids,\n\n    removeMany,\n\n    move(id, parent, index) {\n      const node = requireNode(id);\n      refuse(id, 'move');\n      if (parent !== null) {\n        refuse(parent, 'move nodes into');\n        const p = requireNode(parent);\n        if (p.kind !== 'container') {\n          throw new Error(`Scene: parent \"${parent}\" is not a container`);\n        }\n        assertSubtreeLayer(id, node.layer, parent, p.layer);\n        if (parent === id) throw new Error('Scene: cannot parent a node to itself');\n        const desc: NodeId[] = [];\n        descendants(id, desc);\n        if (desc.includes(parent)) {\n          throw new Error('Scene: cannot parent a node to its own descendant');\n        }\n      }\n      const fromParent = node.parent;\n      edit('move', parent !== null || fromParent !== null, () => {\n        const fromIndex = siblingsOf(fromParent).indexOf(id);\n        const toIndex = index ?? siblingsOf(parent).length;\n        noteArrival(id, parent, fromParent);\n        noteDeparture(id, fromParent, parent);\n        noteChange(fromParent);\n        record('kit:move', { id, fromParent, fromIndex, toParent: parent, toIndex }, 'move');\n      });\n    },\n\n    reorder(id, index) {\n      const node = requireNode(id);\n      refuse(id, 'reorder');\n      const parent = node.parent;\n      edit('reorder', parent !== null, () => {\n        noteChange(parent);\n        const fromIndex = siblingsOf(parent).indexOf(id);\n        record('kit:move', { id, fromParent: parent, fromIndex, toParent: parent, toIndex: index }, 'reorder');\n      });\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"treeEdits.js","names":[],"sources":["../../../src/core/scene/treeEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its tree: adding and removing nodes, reparenting, and\n * reordering siblings. Each checks its arguments, then records one kit op.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport type { RemoveSnapshot } from './kitOps';\nimport type { createLayerStack } from './layerStack';\nimport type { LockGuard } from './lockGuard';\nimport { fnKeysOf, type FnBearingNode, type NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { Recorder } from './recorder';\nimport { SceneMembershipError } from './staleReplay';\nimport { statedFields } from './statedFields';\nimport type { AddNodeSpec, Node, NodeId, Scene } from './types';\n\nexport interface TreeEditsEnv<TData, TLayer extends string, TPose> {\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>;\n  generateId(): NodeId;\n  store: Pick<\n    ReturnType<typeof createNodeStore<TData, TLayer, TPose>>,\n    'requireNode' | 'siblingsOf' | 'descendants' | 'removalClosure' | 'patchNodeFunctions'\n  >;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<ReturnType<typeof createLayerStack<TLayer>>, 'requireLayerIndex' | 'assertSubtreeLayer'>;\n  fnFields: readonly NodeFnField[];\n  /** Run a registered op without recording it. */\n  runOp(kind: string, payload: unknown): void;\n  recorder: Pick<Recorder, 'record' | 'edit'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange'>;\n}\n\nexport interface TreeEdits<TData, TLayer extends string, TPose>\n  extends Pick<Scene<TData, TLayer, TPose>, 'add' | 'remove' | 'removalClosure' | 'removeMany' | 'move' | 'reorder'> {\n  /** Place nodes as the document a scene starts from, or is loaded with:\n   *  nothing is recorded, and no lock refuses. Specs list parents before\n   *  children, the order `toJSON()` emits. */\n  construct(specs: readonly AddNodeSpec<TData, TLayer, TPose>[]): void;\n}\n\n/** What `kit:remove` carries for the nodes `ids`, read before any of them\n *  goes. Throws on an id that is not in the scene. */\nfunction removeSnapshot<TData, TLayer extends string, TPose>(\n  ids: readonly NodeId[],\n  removing: ReadonlySet<NodeId>,\n  store: Pick<TreeEditsEnv<TData, TLayer, TPose>['store'], 'requireNode' | 'siblingsOf'>,\n  fnFields: readonly NodeFnField[],\n): RemoveSnapshot<TData, TLayer, TPose> {\n  const nodes: Node<TData, TLayer, TPose>[] = ids.map((nid) => {\n    const n = store.requireNode(nid);\n    return n.kind === 'container' ? { ...n, children: [...n.children] } : { ...n };\n  });\n  // The rest is reachable through a snapshotted parent's cloned `children`.\n  const detached = nodes\n    .filter((n) => n.parent === null || !removing.has(n.parent))\n    .map((n) => ({ id: n.id, parent: n.parent, index: store.siblingsOf(n.parent).indexOf(n.id) }))\n    .sort((l, r) => l.index - r.index);\n  const fnKeys = nodes.flatMap((n) => {\n    const keys = fnKeysOf(fnFields, n as unknown as FnBearingNode, 'opKey');\n    return Object.keys(keys).length === 0 ? [] : [{ id: n.id, ...keys }];\n  });\n  return { nodes, detached, ...(fnKeys.length > 0 ? { fnKeys } : {}) };\n}\n\nexport function createTreeEdits<TData, TLayer extends string, TPose>(\n  env: TreeEditsEnv<TData, TLayer, TPose>,\n): TreeEdits<TData, TLayer, TPose> {\n  const { nodes, fnFields } = env;\n  const { requireNode, siblingsOf, descendants, removalClosure, patchNodeFunctions } = env.store;\n  const { refuse, refuseLayer } = env.locks;\n  const { requireLayerIndex, assertSubtreeLayer } = env.layers;\n  const { record, edit } = env.recorder;\n  const { noteArrival, noteDeparture, noteChange } = env.arrivals;\n\n  /** Check that `spec` can be placed, and answer with the `kit:add` payload\n   *  that places it. Throws on an id collision, an unknown or locked layer,\n   *  a parent that is not a container or is locked, and a layer below the\n   *  parent's. */\n  function addPayload(spec: AddNodeSpec<TData, TLayer, TPose>) {\n    const id = spec.id ?? env.generateId();\n    if (nodes.has(id)) throw new SceneMembershipError(`Scene: id collision on \"${id}\"`);\n    requireLayerIndex(spec.layer);\n    refuseLayer(spec.layer, 'add to');\n    const parent = spec.parent ?? null;\n    if (parent !== null) {\n      const p = requireNode(parent);\n      if (p.kind !== 'container') {\n        throw new Error(`Scene: parent \"${parent}\" is not a container`);\n      }\n      assertSubtreeLayer(spec.id, spec.layer, parent, p.layer);\n      refuse(parent, 'add under');\n    }\n    return {\n      id, kind: spec.kind, layer: spec.layer, pose: spec.pose, data: spec.data,\n      parent, index: spec.index ?? siblingsOf(parent).length,\n      ...(spec.dependsOn !== undefined ? { dependsOn: spec.dependsOn } : {}),\n      ...statedFields(spec),\n      ...fnKeysOf(fnFields, { ...spec, id, kind: spec.kind } as unknown as FnBearingNode, 'opKey'),\n    };\n  }\n\n  function removeMany(rootIds: readonly NodeId[]): void {\n    if (rootIds.length === 0) return;\n    // Every id resolves against the pre-removal tree, so an id another one\n    // cascades away is absorbed rather than being a second, failing removal.\n    const { ids, removing } = removalClosure(rootIds);\n    for (const nid of ids) refuse(nid, 'remove');\n    const payload = removeSnapshot(ids, removing, env.store, fnFields);\n    const { detached } = payload;\n    edit('remove', detached.some((d) => d.parent !== null), () => {\n      for (const d of detached) noteDeparture(d.id, d.parent, null);\n      record('kit:remove', payload, 'remove');\n    });\n  }\n\n  return {\n    construct(specs) {\n      env.locks.lifted(() => {\n        for (const spec of specs) {\n          const payload = addPayload(spec);\n          env.runOp('kit:add', payload);\n          patchNodeFunctions(spec, payload.id, null);\n        }\n      });\n    },\n\n    add(spec) {\n      const payload = addPayload(spec);\n      const label = `add ${spec.kind}`;\n      return edit(label, payload.parent !== null, () => {\n        noteArrival(payload.id, payload.parent, null);\n        record('kit:add', payload, label);\n        patchNodeFunctions(spec, payload.id, payload);\n        return payload.id;\n      });\n    },\n\n    remove: (id) => removeMany([id]),\n\n    removalClosure: (rootIds) => removalClosure(rootIds).ids,\n\n    removeMany,\n\n    move(id, parent, index) {\n      const node = requireNode(id);\n      refuse(id, 'move');\n      if (parent !== null) {\n        refuse(parent, 'move nodes into');\n        const p = requireNode(parent);\n        if (p.kind !== 'container') {\n          throw new Error(`Scene: parent \"${parent}\" is not a container`);\n        }\n        assertSubtreeLayer(id, node.layer, parent, p.layer);\n        if (parent === id) throw new Error('Scene: cannot parent a node to itself');\n        const desc: NodeId[] = [];\n        descendants(id, desc);\n        if (desc.includes(parent)) {\n          throw new Error('Scene: cannot parent a node to its own descendant');\n        }\n      }\n      const fromParent = node.parent;\n      edit('move', parent !== null || fromParent !== null, () => {\n        const fromIndex = siblingsOf(fromParent).indexOf(id);\n        const toIndex = index ?? siblingsOf(parent).length;\n        noteArrival(id, parent, fromParent);\n        noteDeparture(id, fromParent, parent);\n        noteChange(fromParent);\n        record('kit:move', { id, fromParent, fromIndex, toParent: parent, toIndex }, 'move');\n      });\n    },\n\n    reorder(id, index) {\n      const node = requireNode(id);\n      refuse(id, 'reorder');\n      const parent = node.parent;\n      edit('reorder', parent !== null, () => {\n        noteChange(parent);\n        const fromIndex = siblingsOf(parent).indexOf(id);\n        record('kit:move', { id, fromParent: parent, fromIndex, toParent: parent, toIndex: index }, 'reorder');\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/scene/treeOrder.js

@@ -1,13 +1,18 @@
 //#region src/core/scene/treeOrder.ts
-function e(e, t) {
-	let n = [], r = [...e].reverse();
-	for (; r.length > 0;) {
-		let e = t.get(r.pop());
-		if (e && (n.push(e), e.kind === "container")) for (let t = e.children.length - 1; t >= 0; t--) r.push(e.children[t]);
+/** Every node reachable from `roots`, in tree preorder: a parent before its
+*  children, siblings in sibling order, whatever layer each sits on. */
+function treePreorder(roots, nodes) {
+	const out = [];
+	const stack = [...roots].reverse();
+	while (stack.length > 0) {
+		const node = nodes.get(stack.pop());
+		if (!node) continue;
+		out.push(node);
+		if (node.kind === "container") for (let i = node.children.length - 1; i >= 0; i--) stack.push(node.children[i]);
 	}
-	return n;
+	return out;
 }
-//#endregion
-export { e as treePreorder };
 
+//#endregion
+export { treePreorder };
 //# sourceMappingURL=treeOrder.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"treeOrder.js","names":["treePreorder","out","stack","roots","node","nodes","i"],"sources":["../../../src/core/scene/treeOrder.ts"],"sourcesContent":["import type { Node, NodeId } from './types';\n\n/** Every node reachable from `roots`, in tree preorder: a parent before its\n *  children, siblings in sibling order, whatever layer each sits on. */\nexport function treePreorder<TData, TLayer extends string, TPose>(\n  roots: readonly NodeId[],\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>,\n): Node<TData, TLayer, TPose>[] {\n  const out: Node<TData, TLayer, TPose>[] = [];\n  const stack: NodeId[] = [...roots].reverse();\n  while (stack.length > 0) {\n    const node = nodes.get(stack.pop()!);\n    if (!node) continue;\n    out.push(node);\n    if (node.kind === 'container') {\n      for (let i = node.children.length - 1; i >= 0; i--) stack.push(node.children[i]);\n    }\n  }\n  return out;\n}\n"],"mappings":";AAIA,SAAgBA,EACd,GACA,GAC8B;CAC9B,IAAMC,IAAoC,CAAC,GACrCC,IAAkB,CAAC,GAAGC,CAAK,CAAC,CAAC,QAAQ;CAC3C,OAAOD,EAAM,SAAS,IAAG;EACvB,IAAME,IAAOC,EAAM,IAAIH,EAAM,IAAI,CAAE;EACnC,IAAKE,MACLH,EAAI,KAAKG,CAAI,GACTA,EAAK,SAAS,cAChB,KAAK,IAAIE,IAAIF,EAAK,SAAS,SAAS,GAAGE,KAAK,GAAG,KAAK,EAAM,KAAKF,EAAK,SAASE,EAAE;CAEnF;CACA,OAAOL;AACT"}
+{"version":3,"file":"treeOrder.js","names":[],"sources":["../../../src/core/scene/treeOrder.ts"],"sourcesContent":["import type { Node, NodeId } from './types';\n\n/** Every node reachable from `roots`, in tree preorder: a parent before its\n *  children, siblings in sibling order, whatever layer each sits on. */\nexport function treePreorder<TData, TLayer extends string, TPose>(\n  roots: readonly NodeId[],\n  nodes: ReadonlyMap<NodeId, Node<TData, TLayer, TPose>>,\n): Node<TData, TLayer, TPose>[] {\n  const out: Node<TData, TLayer, TPose>[] = [];\n  const stack: NodeId[] = [...roots].reverse();\n  while (stack.length > 0) {\n    const node = nodes.get(stack.pop()!);\n    if (!node) continue;\n    out.push(node);\n    if (node.kind === 'container') {\n      for (let i = node.children.length - 1; i >= 0; i--) stack.push(node.children[i]);\n    }\n  }\n  return out;\n}\n"],"mappings":";;;AAIA,SAAgB,aACd,OACA,OAC8B;CAC9B,MAAM,MAAoC,CAAC;CAC3C,MAAM,QAAkB,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ;CAC3C,OAAO,MAAM,SAAS,GAAG;EACvB,MAAM,OAAO,MAAM,IAAI,MAAM,IAAI,CAAE;EACnC,IAAI,CAAC,MAAM;EACX,IAAI,KAAK,IAAI;EACb,IAAI,KAAK,SAAS,aAChB,KAAK,IAAI,IAAI,KAAK,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,MAAM,KAAK,KAAK,SAAS,EAAE;CAEnF;CACA,OAAO;AACT"}

package/dist/core/scene/treeReads.js

@@ -1,26 +1,35 @@
 //#region src/core/scene/treeReads.ts
-function e(e) {
-	let t = /* @__PURE__ */ new WeakMap(), n = 1;
+function createTreeReads(nodes) {
+	const incarnations = /* @__PURE__ */ new WeakMap();
+	let nextIncarnation = 1;
 	return {
-		get: (t) => e.get(t),
-		incarnation(r) {
-			let i = e.get(r);
-			if (!i) return;
-			let a = t.get(i);
-			return a === void 0 && (a = n++, t.set(i, a)), a;
+		get: (id) => nodes.get(id),
+		incarnation(id) {
+			const node = nodes.get(id);
+			if (!node) return void 0;
+			let token = incarnations.get(node);
+			if (token === void 0) {
+				token = nextIncarnation++;
+				incarnations.set(node, token);
+			}
+			return token;
 		},
-		childrenOf(t) {
-			let n = e.get(t);
+		childrenOf(id) {
+			const n = nodes.get(id);
 			return n && n.kind === "container" ? n.children : [];
 		},
-		ancestorsOf(t) {
-			let n = [], r = e.get(t)?.parent ?? null;
-			for (; r !== null;) n.push(r), r = e.get(r)?.parent ?? null;
-			return n;
+		ancestorsOf(id) {
+			const out = [];
+			let cur = nodes.get(id)?.parent ?? null;
+			while (cur !== null) {
+				out.push(cur);
+				cur = nodes.get(cur)?.parent ?? null;
+			}
+			return out;
 		}
 	};
 }
-//#endregion
-export { e as createTreeReads };
 
+//#endregion
+export { createTreeReads };
 //# sourceMappingURL=treeReads.js.map