@weasel-js/core 1.10.1 → 1.11.1

package/dist/core/scene/serialization.js

@@ -1,71 +1,110 @@
-import { NODE_FN_FIELDS as e, fnKeysOf as t } from "./nodeFnFields.js";
-import { treePreorder as n } from "./treeOrder.js";
+import { NODE_FN_FIELDS, fnKeysOf } from "./nodeFnFields.js";
+import { treePreorder } from "./treeOrder.js";
+
 //#region src/core/scene/serialization.ts
-function r(e) {
-	return typeof e == "object" && !!e && e.version === 1 && Array.isArray(e.nodes);
+/**
+* A scene to and from its JSON snapshot: the walk that writes one, and the
+* two readers that turn one back into layer records and node specs.
+*/
+/** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */
+function isSerializedScene(value) {
+	return typeof value === "object" && value != null && value.version === 1 && Array.isArray(value.nodes);
 }
-function i(e) {
-	let t = {
-		id: e.id,
-		visible: e.visible ?? !0,
-		locked: e.locked ?? !1,
-		...e.parallax ? { parallax: e.parallax } : {}
+/** One layer record from its snapshot form. A snapshot with no `kind` predates
+*  user layers, so everything in it was a system layer. */
+function layerFromSerialized(spec) {
+	const base = {
+		id: spec.id,
+		visible: spec.visible ?? true,
+		locked: spec.locked ?? false,
+		...spec.parallax ? { parallax: spec.parallax } : {},
+		...spec.annotation ? { annotation: true } : {}
 	};
-	return e.kind === "user" ? {
-		...t,
+	return spec.kind === "user" ? {
+		...base,
 		kind: "user",
-		name: e.name ?? e.id
+		name: spec.name ?? spec.id
 	} : {
-		...t,
+		...base,
 		kind: "system"
 	};
 }
-function a(e, r) {
-	let i = [];
-	for (let a of n(e.roots, e.nodes)) {
-		let e = a.id, n = {
-			id: e,
-			kind: a.kind,
-			layer: a.layer,
-			pose: a.pose,
-			data: a.data
+/** The snapshot of `state`: layers in order, nodes in tree preorder, and the
+*  document values when there are any. Throws
+*  when a node carries a function the registry has no key for. */
+function serializeScene(state, fnFields, doc) {
+	const nodes = [];
+	for (const n of treePreorder(state.roots, state.nodes)) {
+		const id = n.id;
+		const out = {
+			id,
+			kind: n.kind,
+			layer: n.layer,
+			pose: n.pose,
+			data: n.data
 		};
-		a.parent != null && (n.parent = a.parent), a.dependsOn === "children" ? n.dependsOn = "children" : a.dependsOn && a.dependsOn.length > 0 && (n.dependsOn = a.dependsOn), a.pickable === !1 && (n.pickable = !1), a.kind === "container" && a.units !== void 0 && (n.units = a.units), Object.assign(n, t(r, a, "jsonKey", (t) => {
-			throw Error(`Scene.toJSON: node '${e}' has ${t.spec.field} but no matching registry key. The function must be registered via createScene's registry option to round-trip.`);
-		})), i.push(n);
+		if (n.parent != null) out.parent = n.parent;
+		if (n.dependsOn === "children") out.dependsOn = "children";
+		else if (n.dependsOn && n.dependsOn.length > 0) out.dependsOn = n.dependsOn;
+		if (n.pickable === false) out.pickable = false;
+		if (n.hidden === true) out.hidden = true;
+		if (n.locked === true) out.locked = true;
+		if (n.kind === "container" && n.units !== void 0) out.units = n.units;
+		Object.assign(out, fnKeysOf(fnFields, n, "jsonKey", (field) => {
+			throw new Error(`Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. The function must be registered via createScene's registry option to round-trip.`);
+		}));
+		nodes.push(out);
 	}
 	return {
 		version: 1,
-		systemLayers: e.layers.map((e) => {
-			let t = { id: e.id };
-			return e.visible === !1 && (t.visible = !1), e.locked === !0 && (t.locked = !0), e.parallax && (t.parallax = e.parallax), e.kind === "user" && (t.kind = "user", t.name = e.name), t;
+		systemLayers: state.layers.map((l) => {
+			const layer = { id: l.id };
+			if (l.visible === false) layer.visible = false;
+			if (l.locked === true) layer.locked = true;
+			if (l.parallax) layer.parallax = l.parallax;
+			if (l.annotation) layer.annotation = true;
+			if (l.kind === "user") {
+				layer.kind = "user";
+				layer.name = l.name;
+			}
+			return layer;
 		}),
-		nodes: i
+		nodes,
+		...doc ? { doc } : {}
 	};
 }
-function o(t, n) {
-	if (t.version !== 1) throw Error(`Scene: unsupported version ${t.version}; only v1 supported`);
-	return t.nodes.map((t) => {
-		let r = {
-			id: t.id,
-			kind: t.kind,
-			layer: t.layer,
-			pose: t.pose,
-			data: t.data
+/** Map a `SerializedScene` to construction specs. Shared by `sceneFromJSON`
+*  (new instance) and `Scene.loadState` (in-place). Validates version and
+*  resolves every `NODE_FN_FIELDS` key → function via the registry;
+*  throws on an unsupported version or an unknown registry key. */
+function specsFromSerialized(json, registry) {
+	if (json.version !== 1) throw new Error(`Scene: unsupported version ${json.version}; only v1 supported`);
+	return json.nodes.map((n) => {
+		const spec = {
+			id: n.id,
+			kind: n.kind,
+			layer: n.layer,
+			pose: n.pose,
+			data: n.data
 		};
-		t.parent !== void 0 && (r.parent = t.parent), t.pickable !== void 0 && (r.pickable = t.pickable), t.units !== void 0 && (r.units = t.units), t.dependsOn !== void 0 && (r.dependsOn = t.dependsOn === "children" ? "children" : t.dependsOn);
-		let i = t;
-		for (let t of e) {
-			let e = i[t.jsonKey];
-			if (e === void 0) continue;
-			let a = n[t.field]?.[e];
-			if (!a) throw Error(`Scene: unknown ${t.field} key '${e}'. Register a function with this key in the registry option.`);
-			r[t.field] = a;
+		if (n.parent !== void 0) spec.parent = n.parent;
+		if (n.pickable !== void 0) spec.pickable = n.pickable;
+		if (n.hidden === true) spec.hidden = true;
+		if (n.locked === true) spec.locked = true;
+		if (n.units !== void 0) spec.units = n.units;
+		if (n.dependsOn !== void 0) spec.dependsOn = n.dependsOn === "children" ? "children" : n.dependsOn;
+		const serialized = n;
+		for (const field of NODE_FN_FIELDS) {
+			const key = serialized[field.jsonKey];
+			if (key === void 0) continue;
+			const fn = registry[field.field]?.[key];
+			if (!fn) throw new Error(`Scene: unknown ${field.field} key '${key}'. Register a function with this key in the registry option.`);
+			spec[field.field] = fn;
 		}
-		return r;
+		return spec;
 	});
 }
-//#endregion
-export { r as isSerializedScene, i as layerFromSerialized, a as serializeScene, o as specsFromSerialized };
 
+//#endregion
+export { isSerializedScene, layerFromSerialized, serializeScene, specsFromSerialized };
 //# sourceMappingURL=serialization.js.map

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 type { SerializedDoc } from './docValues';\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, and the\n *  document values when there are any. 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  doc?: SerializedDoc,\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, ...(doc ? { doc } : {}) };\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