@weasel-js/core 1.10.1 → 1.11.0

package/dist/core/scene/kitOps.js

@@ -1,185 +1,257 @@
-import { dwarn as e } from "../../debug/flag.js";
-import { restoreFn as t } from "./nodeFnFields.js";
+import { dwarn } from "../../debug/flag.js";
+import { restoreFn } from "./nodeFnFields.js";
+import { statedFields } from "./statedFields.js";
+
 //#region src/core/scene/kitOps.ts
-function n(e, t) {
-	t === void 0 ? delete e.parallax : e.parallax = t;
+function setParallax(record, to) {
+	if (to === void 0) delete record.parallax;
+	else record.parallax = to;
 }
-function r(e, t) {
-	t === void 0 ? delete e.units : e.units = t;
+function setUnits(node, to) {
+	if (to === void 0) delete node.units;
+	else node.units = to;
 }
-function i(i) {
-	let { state: a, requireLayerIndex: o, rebuildLayerIndex: s, invalidateOrder: c, fnFields: l } = i, { dependents: u, childDerived: d, invalidateDependents: f, invalidateChildDerivedFrom: p, trackChildDerived: m, retarget: h, requireNode: g, detach: _, attach: v, addedFns: y, restoreNodeFunctions: b } = i.store;
-	function x(e, t) {
-		i.register(e, t);
+/** Register every kit op kind. Answers with the table a live `kit:setLayout`
+*  payload's strategies are kept in, which `scene.setLayout` fills. */
+function registerKitOps(env) {
+	const { state, requireLayerIndex, rebuildLayerIndex, invalidateOrder, fnFields } = env;
+	const { dependents, childDerived, invalidateDependents, invalidateChildDerivedFrom, trackChildDerived, retarget, requireNode, detach, attach, addedFns, restoreNodeFunctions } = env.store;
+	function registerKitOp(kind, handler) {
+		env.register(kind, handler);
 	}
-	x("kit:add", {
-		apply: (n) => {
-			if (a.nodes.has(n.id)) throw Error(`Scene: id collision on "${n.id}"`);
-			let r = n.kind === "container" ? {
+	registerKitOp("kit:add", {
+		apply: (p) => {
+			if (state.nodes.has(p.id)) throw new Error(`Scene: id collision on "${p.id}"`);
+			const node = p.kind === "container" ? {
 				kind: "container",
-				id: n.id,
-				layer: n.layer,
-				pose: n.pose,
-				data: n.data,
-				parent: n.parent,
+				id: p.id,
+				layer: p.layer,
+				pose: p.pose,
+				data: p.data,
+				parent: p.parent,
 				children: []
 			} : {
 				kind: "leaf",
-				id: n.id,
-				layer: n.layer,
-				pose: n.pose,
-				data: n.data,
-				parent: n.parent
+				id: p.id,
+				layer: p.layer,
+				pose: p.pose,
+				data: p.data,
+				parent: p.parent
 			};
-			a.nodes.set(n.id, r), v(n.id, n.parent, n.index), n.dependsOn !== void 0 && (r.dependsOn = n.dependsOn), n.pickable !== void 0 && (r.pickable = n.pickable), n.units !== void 0 && (r.units = n.units), u.add(n.id, n.dependsOn === "children" ? [] : n.dependsOn ?? []), m(n.id, n.dependsOn);
-			let i = r, o = y.get(n);
-			for (let r of l) {
-				let a = o?.get(r);
-				if (a !== void 0) {
-					r.write(i, a);
+			state.nodes.set(p.id, node);
+			attach(p.id, p.parent, p.index);
+			if (p.dependsOn !== void 0) node.dependsOn = p.dependsOn;
+			Object.assign(node, statedFields(p));
+			dependents.add(p.id, p.dependsOn === "children" ? [] : p.dependsOn ?? []);
+			trackChildDerived(p.id, p.dependsOn);
+			const target = node;
+			const attached = addedFns.get(p);
+			for (const field of fnFields) {
+				const fn = attached?.get(field);
+				if (fn !== void 0) {
+					field.write(target, fn);
 					continue;
 				}
-				let s = n[r.spec.opKey];
-				s !== void 0 && t(r, i, s, "kit:add", e);
+				const key = p[field.spec.opKey];
+				if (key !== void 0) restoreFn(field, target, key, "kit:add", dwarn);
 			}
-			f(n.id);
+			invalidateDependents(p.id);
 		},
-		revert: (e) => {
-			i.clearOverride(e.id), _(e.id), a.nodes.delete(e.id), u.remove(e.id), d.delete(e.id), p(e.parent), f(e.id);
-		}
-	}), x("kit:remove", {
-		apply: (e) => {
-			for (let t of e.nodes) i.clearOverride(t.id);
-			for (let t of e.detached) _(t.id);
-			for (let t of e.nodes) a.nodes.delete(t.id), u.remove(t.id), d.delete(t.id);
-			for (let t of e.detached) p(t.parent);
-			i.narrowSelection(new Set(e.nodes.map((e) => e.id)));
+		revert: (p) => {
+			env.clearOverride(p.id);
+			detach(p.id);
+			state.nodes.delete(p.id);
+			dependents.remove(p.id);
+			childDerived.delete(p.id);
+			invalidateChildDerivedFrom(p.parent);
+			invalidateDependents(p.id);
+		}
+	});
+	registerKitOp("kit:remove", {
+		apply: (p) => {
+			for (const n of p.nodes) env.clearOverride(n.id);
+			for (const d of p.detached) detach(d.id);
+			for (const n of p.nodes) {
+				state.nodes.delete(n.id);
+				dependents.remove(n.id);
+				childDerived.delete(n.id);
+			}
+			for (const d of p.detached) invalidateChildDerivedFrom(d.parent);
+			env.narrowSelection(new Set(p.nodes.map((n) => n.id)));
 		},
-		revert: (e) => {
-			let t = new Map((e.fnKeys ?? []).map((e) => [e.id, e]));
-			for (let n of e.nodes) {
-				let e = n.kind === "container" ? {
+		revert: (p) => {
+			const keys = new Map((p.fnKeys ?? []).map((k) => [k.id, k]));
+			for (const n of p.nodes) {
+				const clone = n.kind === "container" ? {
 					...n,
 					children: [...n.children]
 				} : { ...n };
-				b(e, t.get(n.id)), a.nodes.set(n.id, e), u.add(n.id, e.dependsOn === "children" ? [] : e.dependsOn ?? []), m(n.id, e.dependsOn);
+				restoreNodeFunctions(clone, keys.get(n.id));
+				state.nodes.set(n.id, clone);
+				dependents.add(n.id, clone.dependsOn === "children" ? [] : clone.dependsOn ?? []);
+				trackChildDerived(n.id, clone.dependsOn);
 			}
-			for (let t of e.detached) v(t.id, t.parent, t.index);
-			for (let t of e.detached) p(t.parent);
+			for (const d of p.detached) attach(d.id, d.parent, d.index);
+			for (const d of p.detached) invalidateChildDerivedFrom(d.parent);
 		}
-	}), x("kit:setPose", {
-		apply: (e) => {
-			g(e.id).pose = e.to, f(e.id);
+	});
+	registerKitOp("kit:setPose", {
+		apply: (p) => {
+			requireNode(p.id).pose = p.to;
+			invalidateDependents(p.id);
 		},
-		revert: (e) => {
-			g(e.id).pose = e.from, f(e.id);
+		revert: (p) => {
+			requireNode(p.id).pose = p.from;
+			invalidateDependents(p.id);
 		}
-	}), x("kit:setData", {
-		apply: (e) => {
-			g(e.id).data = e.to, f(e.id);
+	});
+	registerKitOp("kit:setData", {
+		apply: (p) => {
+			requireNode(p.id).data = p.to;
+			invalidateDependents(p.id);
 		},
-		revert: (e) => {
-			g(e.id).data = e.from, f(e.id);
+		revert: (p) => {
+			requireNode(p.id).data = p.from;
+			invalidateDependents(p.id);
 		}
-	}), x("kit:setLayer", {
-		apply: (e) => {
-			o(e.to), g(e.id).layer = e.to, c(), f(e.id);
+	});
+	registerKitOp("kit:setLayer", {
+		apply: (p) => {
+			requireLayerIndex(p.to);
+			requireNode(p.id).layer = p.to;
+			invalidateOrder();
+			invalidateDependents(p.id);
 		},
-		revert: (e) => {
-			g(e.id).layer = e.from, c(), f(e.id);
+		revert: (p) => {
+			requireNode(p.id).layer = p.from;
+			invalidateOrder();
+			invalidateDependents(p.id);
 		}
-	}), x("kit:setDependsOn", {
-		apply: (e) => {
-			h(e.id, e.to);
+	});
+	registerKitOp("kit:setDependsOn", {
+		apply: (p) => {
+			retarget(p.id, p.to);
 		},
-		revert: (e) => {
-			h(e.id, e.from);
+		revert: (p) => {
+			retarget(p.id, p.from);
 		}
-	}), x("kit:setUnits", {
-		apply: (e) => {
-			r(g(e.id), e.to);
+	});
+	registerKitOp("kit:setUnits", {
+		apply: (p) => {
+			setUnits(requireNode(p.id), p.to);
 		},
-		revert: (e) => {
-			r(g(e.id), e.from);
+		revert: (p) => {
+			setUnits(requireNode(p.id), p.from);
 		}
 	});
-	let S = /* @__PURE__ */ new WeakMap();
-	function C(n, r) {
-		let i = g(n.id), a = l.find((e) => e.spec.field === "layout"), o = S.get(n), s = r === "from" ? n.fromKey : n.toKey;
-		if (o === void 0 && s !== void 0) {
-			delete i.layout, t(a, i, s, "kit:setLayout", e);
+	/** The strategies each live `kit:setLayout` payload swaps between. A payload
+	*  replayed from a persisted history has none, and resolves its keys. */
+	const layoutRefs = /* @__PURE__ */ new WeakMap();
+	function placeLayout(p, side) {
+		const node = requireNode(p.id);
+		const field = fnFields.find((f) => f.spec.field === "layout");
+		const live = layoutRefs.get(p);
+		const key = side === "from" ? p.fromKey : p.toKey;
+		if (live === void 0 && key !== void 0) {
+			delete node.layout;
+			restoreFn(field, node, key, "kit:setLayout", dwarn);
 			return;
 		}
-		let c = o?.[r] ?? null;
-		c === null ? delete i.layout : a.write(i, c);
+		const layout = live?.[side] ?? null;
+		if (layout === null) delete node.layout;
+		else field.write(node, layout);
 	}
-	x("kit:setLayout", {
-		apply: (e) => {
-			C(e, "to");
+	registerKitOp("kit:setLayout", {
+		apply: (p) => {
+			placeLayout(p, "to");
 		},
-		revert: (e) => {
-			C(e, "from");
+		revert: (p) => {
+			placeLayout(p, "from");
 		}
-	}), x("kit:move", {
-		apply: (e) => {
-			_(e.id), v(e.id, e.toParent, e.toIndex), p(e.fromParent), f(e.id);
+	});
+	registerKitOp("kit:move", {
+		apply: (p) => {
+			detach(p.id);
+			attach(p.id, p.toParent, p.toIndex);
+			invalidateChildDerivedFrom(p.fromParent);
+			invalidateDependents(p.id);
 		},
-		revert: (e) => {
-			_(e.id), v(e.id, e.fromParent, e.fromIndex), p(e.toParent), f(e.id);
+		revert: (p) => {
+			detach(p.id);
+			attach(p.id, p.fromParent, p.fromIndex);
+			invalidateChildDerivedFrom(p.toParent);
+			invalidateDependents(p.id);
 		}
-	}), x("kit:setLayerVisible", {
-		apply: (e) => {
-			a.layers[o(e.layer)].visible = e.to;
+	});
+	registerKitOp("kit:setLayerVisible", {
+		apply: (p) => {
+			state.layers[requireLayerIndex(p.layer)].visible = p.to;
+			if (!p.to) env.narrowSelection();
 		},
-		revert: (e) => {
-			a.layers[o(e.layer)].visible = e.from;
+		revert: (p) => {
+			state.layers[requireLayerIndex(p.layer)].visible = p.from;
 		}
-	}), x("kit:setLayerLocked", {
-		apply: (e) => {
-			a.layers[o(e.layer)].locked = e.to, e.to && i.narrowSelection();
+	});
+	registerKitOp("kit:setLayerLocked", {
+		apply: (p) => {
+			state.layers[requireLayerIndex(p.layer)].locked = p.to;
+			if (p.to) env.narrowSelection();
 		},
-		revert: (e) => {
-			a.layers[o(e.layer)].locked = e.from;
+		revert: (p) => {
+			state.layers[requireLayerIndex(p.layer)].locked = p.from;
 		}
-	}), x("kit:setLayerParallax", {
-		apply: (e) => {
-			n(a.layers[o(e.layer)], e.to);
+	});
+	registerKitOp("kit:setLayerParallax", {
+		apply: (p) => {
+			setParallax(state.layers[requireLayerIndex(p.layer)], p.to);
 		},
-		revert: (e) => {
-			n(a.layers[o(e.layer)], e.from);
+		revert: (p) => {
+			setParallax(state.layers[requireLayerIndex(p.layer)], p.from);
 		}
-	}), x("kit:addLayer", {
-		apply: (e) => {
-			a.layers.splice(e.index, 0, { ...e.record }), s();
+	});
+	registerKitOp("kit:addLayer", {
+		apply: (p) => {
+			state.layers.splice(p.index, 0, { ...p.record });
+			rebuildLayerIndex();
 		},
-		revert: (e) => {
-			a.layers.splice(e.index, 1), s();
+		revert: (p) => {
+			state.layers.splice(p.index, 1);
+			rebuildLayerIndex();
 		}
-	}), x("kit:removeLayer", {
-		apply: (e) => {
-			a.layers.splice(e.index, 1), s();
+	});
+	registerKitOp("kit:removeLayer", {
+		apply: (p) => {
+			state.layers.splice(p.index, 1);
+			rebuildLayerIndex();
 		},
-		revert: (e) => {
-			a.layers.splice(e.index, 0, { ...e.record }), s();
+		revert: (p) => {
+			state.layers.splice(p.index, 0, { ...p.record });
+			rebuildLayerIndex();
 		}
-	}), x("kit:renameLayer", {
-		apply: (e) => {
-			a.layers[o(e.layer)].name = e.to;
+	});
+	registerKitOp("kit:renameLayer", {
+		apply: (p) => {
+			state.layers[requireLayerIndex(p.layer)].name = p.to;
 		},
-		revert: (e) => {
-			a.layers[o(e.layer)].name = e.from;
+		revert: (p) => {
+			state.layers[requireLayerIndex(p.layer)].name = p.from;
 		}
 	});
-	function w(e, t) {
-		let [n] = a.layers.splice(o(e), 1);
-		a.layers.splice(t, 0, n), s();
+	/** Finds the layer by id, not by where the payload last left it: moves of
+	*  one layer coalesce, and the entry then reverts the first payload from
+	*  wherever the last one put the layer. */
+	function placeLayer(layer, index) {
+		const [rec] = state.layers.splice(requireLayerIndex(layer), 1);
+		state.layers.splice(index, 0, rec);
+		rebuildLayerIndex();
 	}
-	return x("kit:moveLayer", {
-		apply: (e) => w(e.layer, e.to),
-		revert: (e) => w(e.layer, e.from)
-	}), { layoutRefs: S };
+	registerKitOp("kit:moveLayer", {
+		apply: (p) => placeLayer(p.layer, p.to),
+		revert: (p) => placeLayer(p.layer, p.from)
+	});
+	return { layoutRefs };
 }
-//#endregion
-export { i as registerKitOps };
 
+//#endregion
+export { registerKitOps };
 //# sourceMappingURL=kitOps.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"kitOps.js","names":["setParallax","to","record","setUnits","node","registerKitOps","env","registerKitOp","kind","handler","state","p","attach","dependents","trackChildDerived","target","attached","addedFns","field","fnFields","fn","key","restoreFn","dwarn","detach","childDerived","invalidateChildDerivedFrom","invalidateDependents","n","d","keys","k","clone","restoreNodeFunctions","requireLayerIndex","invalidateOrder","requireNode","layoutRefs","placeLayout","f","live","side","layout","rebuildLayerIndex","placeLayer","rec","layer","index"],"sources":["../../../src/core/scene/kitOps.ts"],"sourcesContent":["/**\n * The kit's own op kinds: `kit:add`, `kit:remove`, `kit:setPose`, and the\n * rest. They are registered like any other op; the scene's mutation methods\n * build serializable payloads and route through the same log and replay\n * machinery a consumer's ops do.\n */\nimport type { UnitScope } from '@weasel-js/quantity';\nimport type { ParallaxOpts } from 'core/viewport/parallax';\nimport { dwarn } from 'debug/flag';\nimport type { LayoutStrategy } from '../../layout/types';\nimport { restoreFn, type FnBearingNode, type NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type {\n  ContainerNode, LayerRecord, LeafNode, Node, NodeId, RegisteredOp, UserLayerRecord,\n} from './types';\n\n/**\n * Snapshot of every node a removal deletes, so revert restores it exactly.\n *\n * A cascade unlinks several disjoint subtrees, not one, so `detached` names\n * each node the tree has to re-link; everything else in `nodes` has a parent\n * that is also going and rides back in that parent's cloned `children`.\n * Entries are sorted by ascending sibling index — globally rather than\n * per-parent, because only same-parent order constrains re-insertion and\n * entries under different parents never interact.\n */\nexport interface RemoveSnapshot<TData, TLayer extends string, TPose> {\n  nodes: Node<TData, TLayer, TPose>[];\n  detached: { id: NodeId; parent: NodeId | null; index: number }[];\n  /** Registry keys for the function-valued fields on `nodes`. The functions\n   *  themselves do not survive a persisted history, so revert re-resolves\n   *  them the way `kit:add` does. */\n  fnKeys?: ({ id: NodeId } & Record<string, string | undefined>)[];\n}\n\n/** What a `kit:setLayout` op carries: the container, and each side's layout\n *  by registry key when it has one. */\nexport interface SetLayoutPayload { id: NodeId; fromKey?: string; toKey?: string }\n\n/** What the op table needs from the scene it mutates. */\nexport interface KitOpsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n  };\n  register(kind: string, handler: RegisteredOp<unknown>): void;\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  requireLayerIndex(layer: TLayer): number;\n  rebuildLayerIndex(): void;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  /** Drop from the selection whatever a layer lock just put out of reach, and\n   *  the ids in `gone`. */\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  /** Drop the pose override of a node that is about to leave the scene: ids\n   *  are reusable, and one left behind would attach itself to whatever is\n   *  added under that id next. */\n  clearOverride(id: NodeId): void;\n}\n\nfunction setParallax(record: { parallax?: ParallaxOpts }, to: ParallaxOpts | undefined): void {\n  if (to === undefined) delete record.parallax;\n  else record.parallax = to;\n}\n\nfunction setUnits(node: { units?: UnitScope }, to: UnitScope | undefined): void {\n  if (to === undefined) delete node.units;\n  else node.units = to;\n}\n\n/** Register every kit op kind. Answers with the table a live `kit:setLayout`\n *  payload's strategies are kept in, which `scene.setLayout` fills. */\nexport function registerKitOps<TData, TLayer extends string, TPose>(\n  env: KitOpsEnv<TData, TLayer, TPose>,\n): {\n  layoutRefs: WeakMap<object, { from: LayoutStrategy<TPose> | null; to: LayoutStrategy<TPose> | null }>;\n} {\n  const { state, requireLayerIndex, rebuildLayerIndex, invalidateOrder, fnFields } = env;\n  const {\n    dependents, childDerived, invalidateDependents, invalidateChildDerivedFrom, trackChildDerived, retarget,\n    requireNode, detach, attach, addedFns, restoreNodeFunctions,\n  } = env.store;\n\n  function registerKitOp<P>(kind: string, handler: RegisteredOp<P>): void {\n    env.register(kind, handler as RegisteredOp<unknown>);\n  }\n\n  registerKitOp<{\n    id: NodeId; kind: 'leaf' | 'container'; layer: TLayer; pose: TPose; data: TData;\n    parent: NodeId | null; index: number;\n    dependsOn?: readonly NodeId[] | 'children';\n    pickable?: boolean;\n    units?: UnitScope;\n  } & Record<string, unknown>>('kit:add', {\n    apply: (p) => {\n      if (state.nodes.has(p.id)) {\n        throw new Error(`Scene: id collision on \"${p.id}\"`);\n      }\n      const node: Node<TData, TLayer, TPose> = p.kind === 'container'\n        ? ({ kind: 'container', id: p.id, layer: p.layer, pose: p.pose, data: p.data, parent: p.parent, children: [] } as ContainerNode<TData, TLayer, TPose>)\n        : ({ kind: 'leaf', id: p.id, layer: p.layer, pose: p.pose, data: p.data, parent: p.parent } as LeafNode<TData, TLayer, TPose>);\n      state.nodes.set(p.id, node);\n      attach(p.id, p.parent, p.index);\n      if (p.dependsOn !== undefined) node.dependsOn = p.dependsOn;\n      if (p.pickable !== undefined) node.pickable = p.pickable;\n      if (p.units !== undefined) (node as ContainerNode<TData, TLayer, TPose>).units = p.units;\n      dependents.add(p.id, p.dependsOn === 'children' ? [] : p.dependsOn ?? []);\n      trackChildDerived(p.id, p.dependsOn);\n      // Two ways a function field comes back. Redo of a live add reads\n      // what `scene.add` attached, since it replays the op without a spec.\n      // A restored history has only the registry key the payload carries.\n      const target = node as unknown as FnBearingNode;\n      const attached = addedFns.get(p);\n      for (const field of fnFields) {\n        const fn = attached?.get(field);\n        if (fn !== undefined) {\n          field.write(target, fn);\n          continue;\n        }\n        const key = p[field.spec.opKey] as string | undefined;\n        if (key !== undefined) restoreFn(field, target, key, 'kit:add', dwarn);\n      }\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      env.clearOverride(p.id);\n      detach(p.id);\n      state.nodes.delete(p.id);\n      dependents.remove(p.id);\n      childDerived.delete(p.id);\n      invalidateChildDerivedFrom(p.parent);\n      invalidateDependents(p.id);\n    },\n  });\n\n  // Neither half invalidates dependents: removal's closure takes every live one.\n  registerKitOp<RemoveSnapshot<TData, TLayer, TPose>>('kit:remove', {\n    apply: (p) => {\n      for (const n of p.nodes) env.clearOverride(n.id);\n      for (const d of p.detached) detach(d.id);\n      for (const n of p.nodes) {\n        state.nodes.delete(n.id);\n        dependents.remove(n.id);\n        childDerived.delete(n.id);\n      }\n      // A `dependsOn: 'children'` container the removal did not take is now\n      // hugging a smaller set.\n      for (const d of p.detached) invalidateChildDerivedFrom(d.parent);\n      env.narrowSelection(new Set(p.nodes.map((n) => n.id)));\n    },\n    revert: (p) => {\n      const keys = new Map((p.fnKeys ?? []).map((k) => [k.id, k]));\n      // Order-independent: every clone carries its own parent and children.\n      for (const n of p.nodes) {\n        const clone: Node<TData, TLayer, TPose> = n.kind === 'container'\n          ? { ...n, children: [...n.children] }\n          : { ...n };\n        restoreNodeFunctions(clone, keys.get(n.id));\n        state.nodes.set(n.id, clone);\n        dependents.add(n.id, clone.dependsOn === 'children' ? [] : clone.dependsOn ?? []);\n        trackChildDerived(n.id, clone.dependsOn);\n      }\n      for (const d of p.detached) attach(d.id, d.parent, d.index);\n      for (const d of p.detached) invalidateChildDerivedFrom(d.parent);\n    },\n  });\n\n  registerKitOp<{ id: NodeId; from: TPose; to: TPose }>('kit:setPose', {\n    apply: (p) => {\n      (requireNode(p.id) as { pose: TPose }).pose = p.to;\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { pose: TPose }).pose = p.from;\n      invalidateDependents(p.id);\n    },\n  });\n\n  // A derivation is handed its dependencies' nodes, not only their poses, so a\n  // connector reading `data` or `layer` goes stale on these two exactly as it\n  // does on a move.\n  registerKitOp<{ id: NodeId; from: TData; to: TData }>('kit:setData', {\n    apply: (p) => {\n      (requireNode(p.id) as { data: TData }).data = p.to;\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { data: TData }).data = p.from;\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{ id: NodeId; from: TLayer; to: TLayer }>('kit:setLayer', {\n    apply: (p) => {\n      requireLayerIndex(p.to);\n      (requireNode(p.id) as { layer: TLayer }).layer = p.to;\n      invalidateOrder();\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { layer: TLayer }).layer = p.from;\n      invalidateOrder();\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{\n    id: NodeId;\n    from: Node<TData, TLayer, TPose>['dependsOn'];\n    to: Node<TData, TLayer, TPose>['dependsOn'];\n  }>('kit:setDependsOn', {\n    apply: (p) => { retarget(p.id, p.to); },\n    revert: (p) => { retarget(p.id, p.from); },\n  });\n\n  registerKitOp<{ id: NodeId; from?: UnitScope; to?: UnitScope }>('kit:setUnits', {\n    apply: (p) => { setUnits(requireNode(p.id) as { units?: UnitScope }, p.to); },\n    revert: (p) => { setUnits(requireNode(p.id) as { units?: UnitScope }, p.from); },\n  });\n\n  /** The strategies each live `kit:setLayout` payload swaps between. A payload\n   *  replayed from a persisted history has none, and resolves its keys. */\n  const layoutRefs = new WeakMap<object, { from: LayoutStrategy<TPose> | null; to: LayoutStrategy<TPose> | null }>();\n  function placeLayout(p: SetLayoutPayload, side: 'from' | 'to'): void {\n    const node = requireNode(p.id) as unknown as FnBearingNode;\n    const field = fnFields.find((f) => f.spec.field === 'layout')!;\n    const live = layoutRefs.get(p);\n    const key = side === 'from' ? p.fromKey : p.toKey;\n    if (live === undefined && key !== undefined) {\n      delete node.layout;\n      restoreFn(field, node, key, 'kit:setLayout', dwarn);\n      return;\n    }\n    const layout = live?.[side] ?? null;\n    if (layout === null) delete node.layout;\n    else field.write(node, layout);\n  }\n  registerKitOp<SetLayoutPayload>('kit:setLayout', {\n    apply: (p) => { placeLayout(p, 'to'); },\n    revert: (p) => { placeLayout(p, 'from'); },\n  });\n\n  registerKitOp<{\n    id: NodeId; fromParent: NodeId | null; fromIndex: number;\n    toParent: NodeId | null; toIndex: number;\n  }>('kit:move', {\n    apply: (p) => {\n      detach(p.id);\n      attach(p.id, p.toParent, p.toIndex);\n      // Both ends: the container it left no longer hugs it, and the one it\n      // joined now does.\n      invalidateChildDerivedFrom(p.fromParent);\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      detach(p.id);\n      attach(p.id, p.fromParent, p.fromIndex);\n      invalidateChildDerivedFrom(p.toParent);\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{ layer: TLayer; from: boolean; to: boolean }>('kit:setLayerVisible', {\n    apply: (p) => { state.layers[requireLayerIndex(p.layer)].visible = p.to; },\n    revert: (p) => { state.layers[requireLayerIndex(p.layer)].visible = p.from; },\n  });\n\n  registerKitOp<{ layer: TLayer; from: boolean; to: boolean }>('kit:setLayerLocked', {\n    apply: (p) => { state.layers[requireLayerIndex(p.layer)].locked = p.to; if (p.to) env.narrowSelection(); },\n    revert: (p) => { state.layers[requireLayerIndex(p.layer)].locked = p.from; },\n  });\n\n  registerKitOp<{ layer: TLayer; from?: ParallaxOpts; to?: ParallaxOpts }>('kit:setLayerParallax', {\n    apply: (p) => { setParallax(state.layers[requireLayerIndex(p.layer)], p.to); },\n    revert: (p) => { setParallax(state.layers[requireLayerIndex(p.layer)], p.from); },\n  });\n\n  registerKitOp<{ record: UserLayerRecord<TLayer>; index: number }>('kit:addLayer', {\n    apply: (p) => { state.layers.splice(p.index, 0, { ...p.record }); rebuildLayerIndex(); },\n    revert: (p) => { state.layers.splice(p.index, 1); rebuildLayerIndex(); },\n  });\n\n  registerKitOp<{ record: LayerRecord<TLayer>; index: number }>('kit:removeLayer', {\n    apply: (p) => { state.layers.splice(p.index, 1); rebuildLayerIndex(); },\n    revert: (p) => { state.layers.splice(p.index, 0, { ...p.record } as LayerRecord<TLayer>); rebuildLayerIndex(); },\n  });\n\n  registerKitOp<{ layer: TLayer; from: string; to: string }>('kit:renameLayer', {\n    apply: (p) => { (state.layers[requireLayerIndex(p.layer)] as UserLayerRecord<TLayer>).name = p.to; },\n    revert: (p) => { (state.layers[requireLayerIndex(p.layer)] as UserLayerRecord<TLayer>).name = p.from; },\n  });\n\n  /** Finds the layer by id, not by where the payload last left it: moves of\n   *  one layer coalesce, and the entry then reverts the first payload from\n   *  wherever the last one put the layer. */\n  function placeLayer(layer: TLayer, index: number): void {\n    const [rec] = state.layers.splice(requireLayerIndex(layer), 1);\n    state.layers.splice(index, 0, rec);\n    rebuildLayerIndex();\n  }\n\n  registerKitOp<{ layer: TLayer; from: number; to: number }>('kit:moveLayer', {\n    apply: (p) => placeLayer(p.layer, p.to),\n    revert: (p) => placeLayer(p.layer, p.from),\n  });\n\n  return { layoutRefs };\n}\n"],"mappings":"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"}
+{"version":3,"file":"kitOps.js","names":[],"sources":["../../../src/core/scene/kitOps.ts"],"sourcesContent":["/**\n * The kit's own op kinds: `kit:add`, `kit:remove`, `kit:setPose`, and the\n * rest. They are registered like any other op; the scene's mutation methods\n * build serializable payloads and route through the same log and replay\n * machinery a consumer's ops do.\n */\nimport type { UnitScope } from '@weasel-js/quantity';\nimport type { ParallaxOpts } from 'core/viewport/parallax';\nimport { dwarn } from 'debug/flag';\nimport type { LayoutStrategy } from '../../layout/types';\nimport { restoreFn, type FnBearingNode, type NodeFnField } from './nodeFnFields';\nimport { statedFields } from './statedFields';\nimport type { createNodeStore } from './nodeStore';\nimport type {\n  ContainerNode, LayerRecord, LeafNode, Node, NodeId, RegisteredOp, UserLayerRecord,\n} from './types';\n\n/**\n * Snapshot of every node a removal deletes, so revert restores it exactly.\n *\n * A cascade unlinks several disjoint subtrees, not one, so `detached` names\n * each node the tree has to re-link; everything else in `nodes` has a parent\n * that is also going and rides back in that parent's cloned `children`.\n * Entries are sorted by ascending sibling index — globally rather than\n * per-parent, because only same-parent order constrains re-insertion and\n * entries under different parents never interact.\n */\nexport interface RemoveSnapshot<TData, TLayer extends string, TPose> {\n  nodes: Node<TData, TLayer, TPose>[];\n  detached: { id: NodeId; parent: NodeId | null; index: number }[];\n  /** Registry keys for the function-valued fields on `nodes`. The functions\n   *  themselves do not survive a persisted history, so revert re-resolves\n   *  them the way `kit:add` does. */\n  fnKeys?: ({ id: NodeId } & Record<string, string | undefined>)[];\n}\n\n/** What a `kit:setLayout` op carries: the container, and each side's layout\n *  by registry key when it has one. */\nexport interface SetLayoutPayload { id: NodeId; fromKey?: string; toKey?: string }\n\n/** What the op table needs from the scene it mutates. */\nexport interface KitOpsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n  };\n  register(kind: string, handler: RegisteredOp<unknown>): void;\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  requireLayerIndex(layer: TLayer): number;\n  rebuildLayerIndex(): void;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  /** Drop from the selection whatever a lock or a hide just put out of\n   *  reach, and the ids in `gone`. */\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  /** Drop the pose override of a node that is about to leave the scene: ids\n   *  are reusable, and one left behind would attach itself to whatever is\n   *  added under that id next. */\n  clearOverride(id: NodeId): void;\n}\n\nfunction setParallax(record: { parallax?: ParallaxOpts }, to: ParallaxOpts | undefined): void {\n  if (to === undefined) delete record.parallax;\n  else record.parallax = to;\n}\n\nfunction setUnits(node: { units?: UnitScope }, to: UnitScope | undefined): void {\n  if (to === undefined) delete node.units;\n  else node.units = to;\n}\n\n/** Register every kit op kind. Answers with the table a live `kit:setLayout`\n *  payload's strategies are kept in, which `scene.setLayout` fills. */\nexport function registerKitOps<TData, TLayer extends string, TPose>(\n  env: KitOpsEnv<TData, TLayer, TPose>,\n): {\n  layoutRefs: WeakMap<object, { from: LayoutStrategy<TPose> | null; to: LayoutStrategy<TPose> | null }>;\n} {\n  const { state, requireLayerIndex, rebuildLayerIndex, invalidateOrder, fnFields } = env;\n  const {\n    dependents, childDerived, invalidateDependents, invalidateChildDerivedFrom, trackChildDerived, retarget,\n    requireNode, detach, attach, addedFns, restoreNodeFunctions,\n  } = env.store;\n\n  function registerKitOp<P>(kind: string, handler: RegisteredOp<P>): void {\n    env.register(kind, handler as RegisteredOp<unknown>);\n  }\n\n  registerKitOp<{\n    id: NodeId; kind: 'leaf' | 'container'; layer: TLayer; pose: TPose; data: TData;\n    parent: NodeId | null; index: number;\n    dependsOn?: readonly NodeId[] | 'children';\n    pickable?: boolean; hidden?: boolean; locked?: boolean;\n    units?: UnitScope;\n  } & Record<string, unknown>>('kit:add', {\n    apply: (p) => {\n      if (state.nodes.has(p.id)) {\n        throw new Error(`Scene: id collision on \"${p.id}\"`);\n      }\n      const node: Node<TData, TLayer, TPose> = p.kind === 'container'\n        ? ({ kind: 'container', id: p.id, layer: p.layer, pose: p.pose, data: p.data, parent: p.parent, children: [] } as ContainerNode<TData, TLayer, TPose>)\n        : ({ kind: 'leaf', id: p.id, layer: p.layer, pose: p.pose, data: p.data, parent: p.parent } as LeafNode<TData, TLayer, TPose>);\n      state.nodes.set(p.id, node);\n      attach(p.id, p.parent, p.index);\n      if (p.dependsOn !== undefined) node.dependsOn = p.dependsOn;\n      Object.assign(node, statedFields(p));\n      dependents.add(p.id, p.dependsOn === 'children' ? [] : p.dependsOn ?? []);\n      trackChildDerived(p.id, p.dependsOn);\n      // Two ways a function field comes back. Redo of a live add reads\n      // what `scene.add` attached, since it replays the op without a spec.\n      // A restored history has only the registry key the payload carries.\n      const target = node as unknown as FnBearingNode;\n      const attached = addedFns.get(p);\n      for (const field of fnFields) {\n        const fn = attached?.get(field);\n        if (fn !== undefined) {\n          field.write(target, fn);\n          continue;\n        }\n        const key = p[field.spec.opKey] as string | undefined;\n        if (key !== undefined) restoreFn(field, target, key, 'kit:add', dwarn);\n      }\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      env.clearOverride(p.id);\n      detach(p.id);\n      state.nodes.delete(p.id);\n      dependents.remove(p.id);\n      childDerived.delete(p.id);\n      invalidateChildDerivedFrom(p.parent);\n      invalidateDependents(p.id);\n    },\n  });\n\n  // Neither half invalidates dependents: removal's closure takes every live one.\n  registerKitOp<RemoveSnapshot<TData, TLayer, TPose>>('kit:remove', {\n    apply: (p) => {\n      for (const n of p.nodes) env.clearOverride(n.id);\n      for (const d of p.detached) detach(d.id);\n      for (const n of p.nodes) {\n        state.nodes.delete(n.id);\n        dependents.remove(n.id);\n        childDerived.delete(n.id);\n      }\n      // A `dependsOn: 'children'` container the removal did not take is now\n      // hugging a smaller set.\n      for (const d of p.detached) invalidateChildDerivedFrom(d.parent);\n      env.narrowSelection(new Set(p.nodes.map((n) => n.id)));\n    },\n    revert: (p) => {\n      const keys = new Map((p.fnKeys ?? []).map((k) => [k.id, k]));\n      // Order-independent: every clone carries its own parent and children.\n      for (const n of p.nodes) {\n        const clone: Node<TData, TLayer, TPose> = n.kind === 'container'\n          ? { ...n, children: [...n.children] }\n          : { ...n };\n        restoreNodeFunctions(clone, keys.get(n.id));\n        state.nodes.set(n.id, clone);\n        dependents.add(n.id, clone.dependsOn === 'children' ? [] : clone.dependsOn ?? []);\n        trackChildDerived(n.id, clone.dependsOn);\n      }\n      for (const d of p.detached) attach(d.id, d.parent, d.index);\n      for (const d of p.detached) invalidateChildDerivedFrom(d.parent);\n    },\n  });\n\n  registerKitOp<{ id: NodeId; from: TPose; to: TPose }>('kit:setPose', {\n    apply: (p) => {\n      (requireNode(p.id) as { pose: TPose }).pose = p.to;\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { pose: TPose }).pose = p.from;\n      invalidateDependents(p.id);\n    },\n  });\n\n  // A derivation is handed its dependencies' nodes, not only their poses, so a\n  // connector reading `data` or `layer` goes stale on these two exactly as it\n  // does on a move.\n  registerKitOp<{ id: NodeId; from: TData; to: TData }>('kit:setData', {\n    apply: (p) => {\n      (requireNode(p.id) as { data: TData }).data = p.to;\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { data: TData }).data = p.from;\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{ id: NodeId; from: TLayer; to: TLayer }>('kit:setLayer', {\n    apply: (p) => {\n      requireLayerIndex(p.to);\n      (requireNode(p.id) as { layer: TLayer }).layer = p.to;\n      invalidateOrder();\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      (requireNode(p.id) as { layer: TLayer }).layer = p.from;\n      invalidateOrder();\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{\n    id: NodeId;\n    from: Node<TData, TLayer, TPose>['dependsOn'];\n    to: Node<TData, TLayer, TPose>['dependsOn'];\n  }>('kit:setDependsOn', {\n    apply: (p) => { retarget(p.id, p.to); },\n    revert: (p) => { retarget(p.id, p.from); },\n  });\n\n  registerKitOp<{ id: NodeId; from?: UnitScope; to?: UnitScope }>('kit:setUnits', {\n    apply: (p) => { setUnits(requireNode(p.id) as { units?: UnitScope }, p.to); },\n    revert: (p) => { setUnits(requireNode(p.id) as { units?: UnitScope }, p.from); },\n  });\n\n  /** The strategies each live `kit:setLayout` payload swaps between. A payload\n   *  replayed from a persisted history has none, and resolves its keys. */\n  const layoutRefs = new WeakMap<object, { from: LayoutStrategy<TPose> | null; to: LayoutStrategy<TPose> | null }>();\n  function placeLayout(p: SetLayoutPayload, side: 'from' | 'to'): void {\n    const node = requireNode(p.id) as unknown as FnBearingNode;\n    const field = fnFields.find((f) => f.spec.field === 'layout')!;\n    const live = layoutRefs.get(p);\n    const key = side === 'from' ? p.fromKey : p.toKey;\n    if (live === undefined && key !== undefined) {\n      delete node.layout;\n      restoreFn(field, node, key, 'kit:setLayout', dwarn);\n      return;\n    }\n    const layout = live?.[side] ?? null;\n    if (layout === null) delete node.layout;\n    else field.write(node, layout);\n  }\n  registerKitOp<SetLayoutPayload>('kit:setLayout', {\n    apply: (p) => { placeLayout(p, 'to'); },\n    revert: (p) => { placeLayout(p, 'from'); },\n  });\n\n  registerKitOp<{\n    id: NodeId; fromParent: NodeId | null; fromIndex: number;\n    toParent: NodeId | null; toIndex: number;\n  }>('kit:move', {\n    apply: (p) => {\n      detach(p.id);\n      attach(p.id, p.toParent, p.toIndex);\n      // Both ends: the container it left no longer hugs it, and the one it\n      // joined now does.\n      invalidateChildDerivedFrom(p.fromParent);\n      invalidateDependents(p.id);\n    },\n    revert: (p) => {\n      detach(p.id);\n      attach(p.id, p.fromParent, p.fromIndex);\n      invalidateChildDerivedFrom(p.toParent);\n      invalidateDependents(p.id);\n    },\n  });\n\n  registerKitOp<{ layer: TLayer; from: boolean; to: boolean }>('kit:setLayerVisible', {\n    apply: (p) => { state.layers[requireLayerIndex(p.layer)].visible = p.to; if (!p.to) env.narrowSelection(); },\n    revert: (p) => { state.layers[requireLayerIndex(p.layer)].visible = p.from; },\n  });\n\n  registerKitOp<{ layer: TLayer; from: boolean; to: boolean }>('kit:setLayerLocked', {\n    apply: (p) => { state.layers[requireLayerIndex(p.layer)].locked = p.to; if (p.to) env.narrowSelection(); },\n    revert: (p) => { state.layers[requireLayerIndex(p.layer)].locked = p.from; },\n  });\n\n  registerKitOp<{ layer: TLayer; from?: ParallaxOpts; to?: ParallaxOpts }>('kit:setLayerParallax', {\n    apply: (p) => { setParallax(state.layers[requireLayerIndex(p.layer)], p.to); },\n    revert: (p) => { setParallax(state.layers[requireLayerIndex(p.layer)], p.from); },\n  });\n\n  registerKitOp<{ record: UserLayerRecord<TLayer>; index: number }>('kit:addLayer', {\n    apply: (p) => { state.layers.splice(p.index, 0, { ...p.record }); rebuildLayerIndex(); },\n    revert: (p) => { state.layers.splice(p.index, 1); rebuildLayerIndex(); },\n  });\n\n  registerKitOp<{ record: LayerRecord<TLayer>; index: number }>('kit:removeLayer', {\n    apply: (p) => { state.layers.splice(p.index, 1); rebuildLayerIndex(); },\n    revert: (p) => { state.layers.splice(p.index, 0, { ...p.record } as LayerRecord<TLayer>); rebuildLayerIndex(); },\n  });\n\n  registerKitOp<{ layer: TLayer; from: string; to: string }>('kit:renameLayer', {\n    apply: (p) => { (state.layers[requireLayerIndex(p.layer)] as UserLayerRecord<TLayer>).name = p.to; },\n    revert: (p) => { (state.layers[requireLayerIndex(p.layer)] as UserLayerRecord<TLayer>).name = p.from; },\n  });\n\n  /** Finds the layer by id, not by where the payload last left it: moves of\n   *  one layer coalesce, and the entry then reverts the first payload from\n   *  wherever the last one put the layer. */\n  function placeLayer(layer: TLayer, index: number): void {\n    const [rec] = state.layers.splice(requireLayerIndex(layer), 1);\n    state.layers.splice(index, 0, rec);\n    rebuildLayerIndex();\n  }\n\n  registerKitOp<{ layer: TLayer; from: number; to: number }>('kit:moveLayer', {\n    apply: (p) => placeLayer(p.layer, p.to),\n    revert: (p) => placeLayer(p.layer, p.from),\n  });\n\n  return { layoutRefs };\n}\n"],"mappings":";;;;;AA6DA,SAAS,YAAY,QAAqC,IAAoC;CAC5F,IAAI,OAAO,QAAW,OAAO,OAAO;MAC/B,OAAO,WAAW;AACzB;AAEA,SAAS,SAAS,MAA6B,IAAiC;CAC9E,IAAI,OAAO,QAAW,OAAO,KAAK;MAC7B,KAAK,QAAQ;AACpB;;;AAIA,SAAgB,eACd,KAGA;CACA,MAAM,EAAE,OAAO,mBAAmB,mBAAmB,iBAAiB,aAAa;CACnF,MAAM,EACJ,YAAY,cAAc,sBAAsB,4BAA4B,mBAAmB,UAC/F,aAAa,QAAQ,QAAQ,UAAU,yBACrC,IAAI;CAER,SAAS,cAAiB,MAAc,SAAgC;EACtE,IAAI,SAAS,MAAM,OAAgC;CACrD;CAEA,cAM6B,WAAW;EACtC,QAAQ,MAAM;GACZ,IAAI,MAAM,MAAM,IAAI,EAAE,EAAE,GACtB,MAAM,IAAI,MAAM,2BAA2B,EAAE,GAAG,EAAE;GAEpD,MAAM,OAAmC,EAAE,SAAS,cAC/C;IAAE,MAAM;IAAa,IAAI,EAAE;IAAI,OAAO,EAAE;IAAO,MAAM,EAAE;IAAM,MAAM,EAAE;IAAM,QAAQ,EAAE;IAAQ,UAAU,CAAC;GAAE,IAC1G;IAAE,MAAM;IAAQ,IAAI,EAAE;IAAI,OAAO,EAAE;IAAO,MAAM,EAAE;IAAM,MAAM,EAAE;IAAM,QAAQ,EAAE;GAAO;GAC5F,MAAM,MAAM,IAAI,EAAE,IAAI,IAAI;GAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK;GAC9B,IAAI,EAAE,cAAc,QAAW,KAAK,YAAY,EAAE;GAClD,OAAO,OAAO,MAAM,aAAa,CAAC,CAAC;GACnC,WAAW,IAAI,EAAE,IAAI,EAAE,cAAc,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;GACxE,kBAAkB,EAAE,IAAI,EAAE,SAAS;GAInC,MAAM,SAAS;GACf,MAAM,WAAW,SAAS,IAAI,CAAC;GAC/B,KAAK,MAAM,SAAS,UAAU;IAC5B,MAAM,KAAK,UAAU,IAAI,KAAK;IAC9B,IAAI,OAAO,QAAW;KACpB,MAAM,MAAM,QAAQ,EAAE;KACtB;IACF;IACA,MAAM,MAAM,EAAE,MAAM,KAAK;IACzB,IAAI,QAAQ,QAAW,UAAU,OAAO,QAAQ,KAAK,WAAW,KAAK;GACvE;GACA,qBAAqB,EAAE,EAAE;EAC3B;EACA,SAAS,MAAM;GACb,IAAI,cAAc,EAAE,EAAE;GACtB,OAAO,EAAE,EAAE;GACX,MAAM,MAAM,OAAO,EAAE,EAAE;GACvB,WAAW,OAAO,EAAE,EAAE;GACtB,aAAa,OAAO,EAAE,EAAE;GACxB,2BAA2B,EAAE,MAAM;GACnC,qBAAqB,EAAE,EAAE;EAC3B;CACF,CAAC;CAGD,cAAoD,cAAc;EAChE,QAAQ,MAAM;GACZ,KAAK,MAAM,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,EAAE;GAC/C,KAAK,MAAM,KAAK,EAAE,UAAU,OAAO,EAAE,EAAE;GACvC,KAAK,MAAM,KAAK,EAAE,OAAO;IACvB,MAAM,MAAM,OAAO,EAAE,EAAE;IACvB,WAAW,OAAO,EAAE,EAAE;IACtB,aAAa,OAAO,EAAE,EAAE;GAC1B;GAGA,KAAK,MAAM,KAAK,EAAE,UAAU,2BAA2B,EAAE,MAAM;GAC/D,IAAI,gBAAgB,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC;EACvD;EACA,SAAS,MAAM;GACb,MAAM,OAAO,IAAI,KAAK,EAAE,UAAU,CAAC,EAAA,CAAG,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;GAE3D,KAAK,MAAM,KAAK,EAAE,OAAO;IACvB,MAAM,QAAoC,EAAE,SAAS,cACjD;KAAE,GAAG;KAAG,UAAU,CAAC,GAAG,EAAE,QAAQ;IAAE,IAClC,EAAE,GAAG,EAAE;IACX,qBAAqB,OAAO,KAAK,IAAI,EAAE,EAAE,CAAC;IAC1C,MAAM,MAAM,IAAI,EAAE,IAAI,KAAK;IAC3B,WAAW,IAAI,EAAE,IAAI,MAAM,cAAc,aAAa,CAAC,IAAI,MAAM,aAAa,CAAC,CAAC;IAChF,kBAAkB,EAAE,IAAI,MAAM,SAAS;GACzC;GACA,KAAK,MAAM,KAAK,EAAE,UAAU,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK;GAC1D,KAAK,MAAM,KAAK,EAAE,UAAU,2BAA2B,EAAE,MAAM;EACjE;CACF,CAAC;CAED,cAAsD,eAAe;EACnE,QAAQ,MAAM;GACZ,YAAa,EAAE,EAAE,CAAC,CAAqB,OAAO,EAAE;GAChD,qBAAqB,EAAE,EAAE;EAC3B;EACA,SAAS,MAAM;GACb,YAAa,EAAE,EAAE,CAAC,CAAqB,OAAO,EAAE;GAChD,qBAAqB,EAAE,EAAE;EAC3B;CACF,CAAC;CAKD,cAAsD,eAAe;EACnE,QAAQ,MAAM;GACZ,YAAa,EAAE,EAAE,CAAC,CAAqB,OAAO,EAAE;GAChD,qBAAqB,EAAE,EAAE;EAC3B;EACA,SAAS,MAAM;GACb,YAAa,EAAE,EAAE,CAAC,CAAqB,OAAO,EAAE;GAChD,qBAAqB,EAAE,EAAE;EAC3B;CACF,CAAC;CAED,cAAwD,gBAAgB;EACtE,QAAQ,MAAM;GACZ,kBAAkB,EAAE,EAAE;GACtB,YAAa,EAAE,EAAE,CAAC,CAAuB,QAAQ,EAAE;GACnD,gBAAgB;GAChB,qBAAqB,EAAE,EAAE;EAC3B;EACA,SAAS,MAAM;GACb,YAAa,EAAE,EAAE,CAAC,CAAuB,QAAQ,EAAE;GACnD,gBAAgB;GAChB,qBAAqB,EAAE,EAAE;EAC3B;CACF,CAAC;CAED,cAIG,oBAAoB;EACrB,QAAQ,MAAM;GAAE,SAAS,EAAE,IAAI,EAAE,EAAE;EAAG;EACtC,SAAS,MAAM;GAAE,SAAS,EAAE,IAAI,EAAE,IAAI;EAAG;CAC3C,CAAC;CAED,cAAgE,gBAAgB;EAC9E,QAAQ,MAAM;GAAE,SAAS,YAAY,EAAE,EAAE,GAA4B,EAAE,EAAE;EAAG;EAC5E,SAAS,MAAM;GAAE,SAAS,YAAY,EAAE,EAAE,GAA4B,EAAE,IAAI;EAAG;CACjF,CAAC;;;CAID,MAAM,6BAAa,IAAI,QAA0F;CACjH,SAAS,YAAY,GAAqB,MAA2B;EACnE,MAAM,OAAO,YAAY,EAAE,EAAE;EAC7B,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,KAAK,UAAU,QAAQ;EAC5D,MAAM,OAAO,WAAW,IAAI,CAAC;EAC7B,MAAM,MAAM,SAAS,SAAS,EAAE,UAAU,EAAE;EAC5C,IAAI,SAAS,UAAa,QAAQ,QAAW;GAC3C,OAAO,KAAK;GACZ,UAAU,OAAO,MAAM,KAAK,iBAAiB,KAAK;GAClD;EACF;EACA,MAAM,SAAS,OAAO,SAAS;EAC/B,IAAI,WAAW,MAAM,OAAO,KAAK;OAC5B,MAAM,MAAM,MAAM,MAAM;CAC/B;CACA,cAAgC,iBAAiB;EAC/C,QAAQ,MAAM;GAAE,YAAY,GAAG,IAAI;EAAG;EACtC,SAAS,MAAM;GAAE,YAAY,GAAG,MAAM;EAAG;CAC3C,CAAC;CAED,cAGG,YAAY;EACb,QAAQ,MAAM;GACZ,OAAO,EAAE,EAAE;GACX,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO;GAGlC,2BAA2B,EAAE,UAAU;GACvC,qBAAqB,EAAE,EAAE;EAC3B;EACA,SAAS,MAAM;GACb,OAAO,EAAE,EAAE;GACX,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;GACtC,2BAA2B,EAAE,QAAQ;GACrC,qBAAqB,EAAE,EAAE;EAC3B;CACF,CAAC;CAED,cAA6D,uBAAuB;EAClF,QAAQ,MAAM;GAAE,MAAM,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE;GAAI,IAAI,CAAC,EAAE,IAAI,IAAI,gBAAgB;EAAG;EAC3G,SAAS,MAAM;GAAE,MAAM,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE;EAAM;CAC9E,CAAC;CAED,cAA6D,sBAAsB;EACjF,QAAQ,MAAM;GAAE,MAAM,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE;GAAI,IAAI,EAAE,IAAI,IAAI,gBAAgB;EAAG;EACzG,SAAS,MAAM;GAAE,MAAM,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE;EAAM;CAC7E,CAAC;CAED,cAAyE,wBAAwB;EAC/F,QAAQ,MAAM;GAAE,YAAY,MAAM,OAAO,kBAAkB,EAAE,KAAK,IAAI,EAAE,EAAE;EAAG;EAC7E,SAAS,MAAM;GAAE,YAAY,MAAM,OAAO,kBAAkB,EAAE,KAAK,IAAI,EAAE,IAAI;EAAG;CAClF,CAAC;CAED,cAAkE,gBAAgB;EAChF,QAAQ,MAAM;GAAE,MAAM,OAAO,OAAO,EAAE,OAAO,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;GAAG,kBAAkB;EAAG;EACvF,SAAS,MAAM;GAAE,MAAM,OAAO,OAAO,EAAE,OAAO,CAAC;GAAG,kBAAkB;EAAG;CACzE,CAAC;CAED,cAA8D,mBAAmB;EAC/E,QAAQ,MAAM;GAAE,MAAM,OAAO,OAAO,EAAE,OAAO,CAAC;GAAG,kBAAkB;EAAG;EACtE,SAAS,MAAM;GAAE,MAAM,OAAO,OAAO,EAAE,OAAO,GAAG,EAAE,GAAG,EAAE,OAAO,CAAwB;GAAG,kBAAkB;EAAG;CACjH,CAAC;CAED,cAA2D,mBAAmB;EAC5E,QAAQ,MAAM;GAAE,MAAO,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAA6B,OAAO,EAAE;EAAI;EACnG,SAAS,MAAM;GAAE,MAAO,OAAO,kBAAkB,EAAE,KAAK,EAAE,CAA6B,OAAO,EAAE;EAAM;CACxG,CAAC;;;;CAKD,SAAS,WAAW,OAAe,OAAqB;EACtD,MAAM,CAAC,OAAO,MAAM,OAAO,OAAO,kBAAkB,KAAK,GAAG,CAAC;EAC7D,MAAM,OAAO,OAAO,OAAO,GAAG,GAAG;EACjC,kBAAkB;CACpB;CAEA,cAA2D,iBAAiB;EAC1E,QAAQ,MAAM,WAAW,EAAE,OAAO,EAAE,EAAE;EACtC,SAAS,MAAM,WAAW,EAAE,OAAO,EAAE,IAAI;CAC3C,CAAC;CAED,OAAO,EAAE,WAAW;AACtB"}

package/dist/core/scene/kitRegistry.js

@@ -1,33 +1,60 @@
-import { unionAABB as e } from "../geometry/unionBounds.js";
+import { unionAABB } from "../geometry/unionBounds.js";
+
 //#region src/core/scene/kitRegistry.ts
-var t = "kit:unionOfChildren";
-function n(t, n) {
-	let i = [];
-	for (let e of n) {
-		if (e === void 0) continue;
-		let t = r(e.pose);
-		if (t === null) return null;
-		i.push(t);
+/**
+* The `SceneRegistry` entries the kit owns.
+*
+* A registry-keyed function has to be resolvable by key in whatever scene
+* loads a snapshot, so a function the *kit* attaches to a node cannot live in
+* the consumer's registry alone — a document saved with a grouped container
+* would come back with a dead key. `createScene` merges these under the
+* consumer's, which stays the winner on a key collision.
+*/
+/** Registry key for {@link unionOfChildren}. */
+var UNION_OF_CHILDREN = "kit:unionOfChildren";
+/**
+* A container's pose as the envelope of what it holds — `unionAABB`, so a
+* rotated member contributes the extent of its ink rather than its unrotated
+* box. Paired with `dependsOn: 'children'`, this is what makes a group's
+* bounds track its members.
+*
+* Returns `null` for an emptied container, which falls back to its authored
+* pose.
+*
+* Reads members as rect poses only: a scene whose poses are shaped otherwise
+* gets `null` here and its container keeps its authored pose. To make such a
+* container track its members, register `unionOfChildrenVia(itsDescriptor)`
+* under {@link UNION_OF_CHILDREN} — the consumer's entry wins the collision.
+*/
+function unionOfChildren(_node, deps) {
+	const poses = [];
+	for (const d of deps) {
+		if (d === void 0) continue;
+		const rect = asRectPose(d.pose);
+		if (rect === null) return null;
+		poses.push(rect);
 	}
-	if (i.length === 0) return null;
-	let a = e(i);
-	return a === null ? null : a;
+	if (poses.length === 0) return null;
+	const union = unionAABB(poses);
+	return union === null ? null : union;
 }
-function r(e) {
-	if (typeof e != "object" || !e) return null;
-	let t = e;
-	return typeof t.x == "number" && typeof t.y == "number" && typeof t.width == "number" && typeof t.height == "number" ? e : null;
+/** `pose` as a rect, or `null` when it is some other shape entirely. */
+function asRectPose(pose) {
+	if (pose === null || typeof pose !== "object") return null;
+	const p = pose;
+	return typeof p.x === "number" && typeof p.y === "number" && typeof p.width === "number" && typeof p.height === "number" ? pose : null;
 }
-function i(e) {
+/** Merge the kit's own entries under a consumer registry. */
+function withKitRegistry(registry) {
 	return {
-		...e,
+		...registry,
 		derivePose: {
-			[t]: n,
-			...e.derivePose
+			[UNION_OF_CHILDREN]: unionOfChildren,
+			...registry.derivePose
 		}
 	};
 }
-//#endregion
-export { t as UNION_OF_CHILDREN, r as asRectPose, n as unionOfChildren, i as withKitRegistry };
 
+//#endregion
+export { UNION_OF_CHILDREN, asRectPose, unionOfChildren, withKitRegistry };
 //# sourceMappingURL=kitRegistry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"kitRegistry.js","names":["UNION_OF_CHILDREN","unionOfChildren","poses","d","deps","rect","asRectPose","union","unionAABB","pose","p","withKitRegistry","registry"],"sources":["../../../src/core/scene/kitRegistry.ts"],"sourcesContent":["/**\n * The `SceneRegistry` entries the kit owns.\n *\n * A registry-keyed function has to be resolvable by key in whatever scene\n * loads a snapshot, so a function the *kit* attaches to a node cannot live in\n * the consumer's registry alone — a document saved with a grouped container\n * would come back with a dead key. `createScene` merges these under the\n * consumer's, which stays the winner on a key collision.\n */\nimport { unionAABB } from '../geometry/unionBounds';\nimport type { RectPose, SceneRegistry } from './types';\n\n/** Registry key for {@link unionOfChildren}. */\nexport const UNION_OF_CHILDREN = 'kit:unionOfChildren';\n\n/**\n * A container's pose as the envelope of what it holds — `unionAABB`, so a\n * rotated member contributes the extent of its ink rather than its unrotated\n * box. Paired with `dependsOn: 'children'`, this is what makes a group's\n * bounds track its members.\n *\n * Returns `null` for an emptied container, which falls back to its authored\n * pose.\n *\n * Reads members as rect poses only: a scene whose poses are shaped otherwise\n * gets `null` here and its container keeps its authored pose. To make such a\n * container track its members, register `unionOfChildrenVia(itsDescriptor)`\n * under {@link UNION_OF_CHILDREN} — the consumer's entry wins the collision.\n */\nexport function unionOfChildren<TPose>(\n  _node: unknown,\n  deps: readonly ({ pose: TPose } | undefined)[],\n): TPose | null {\n  const poses: RectPose[] = [];\n  for (const d of deps) {\n    if (d === undefined) continue;\n    const rect = asRectPose(d.pose);\n    if (rect === null) return null;\n    poses.push(rect);\n  }\n  if (poses.length === 0) return null;\n  const union = unionAABB(poses);\n  // Sound by the check above: every member read as a rect, so the union is one\n  // too, and a scene holding rect poses is a scene whose `TPose` is one.\n  return union === null ? null : (union as unknown as TPose);\n}\n\n/** `pose` as a rect, or `null` when it is some other shape entirely. */\nexport function asRectPose(pose: unknown): RectPose | null {\n  if (pose === null || typeof pose !== 'object') return null;\n  const p = pose as Partial<RectPose>;\n  const rect = typeof p.x === 'number' && typeof p.y === 'number'\n    && typeof p.width === 'number' && typeof p.height === 'number';\n  return rect ? (pose as RectPose) : null;\n}\n\n/** Merge the kit's own entries under a consumer registry. */\nexport function withKitRegistry<TPose, TData = unknown, TLayer extends string = string>(\n  registry: SceneRegistry<TPose, TData, TLayer>,\n): SceneRegistry<TPose, TData, TLayer> {\n  return {\n    ...registry,\n    derivePose: {\n      [UNION_OF_CHILDREN]: unionOfChildren as NonNullable<\n        SceneRegistry<TPose, TData, TLayer>['derivePose']\n      >[string],\n      ...registry.derivePose,\n    },\n  };\n}\n"],"mappings":";;AAaA,IAAaA,IAAoB;AAgBjC,SAAgBC,EACd,GACA,GACc;CACd,IAAMC,IAAoB,CAAC;CAC3B,KAAK,IAAMC,KAAKC,GAAM;EACpB,IAAID,MAAM,KAAA,GAAW;EACrB,IAAME,IAAOC,EAAWH,EAAE,IAAI;EAC9B,IAAIE,MAAS,MAAM,OAAO;EAC1B,EAAM,KAAKA,CAAI;CACjB;CACA,IAAIH,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAMK,IAAQC,EAAUN,CAAK;CAG7B,OAAOK,MAAU,OAAO,OAAQA;AAClC;AAGA,SAAgBD,EAAW,GAAgC;CACzD,IAAqB,OAAOG,KAAS,aAAjCA,GAA2C,OAAO;CACtD,IAAMC,IAAID;CAGV,OAFa,OAAOC,EAAE,KAAM,YAAY,OAAOA,EAAE,KAAM,YAClD,OAAOA,EAAE,SAAU,YAAY,OAAOA,EAAE,UAAW,WACzCD,IAAoB;AACrC;AAGA,SAAgBE,EACd,GACqC;CACrC,OAAO;EACL,GAAGC;EACH,YAAY;IACTZ,IAAoBC;GAGrB,GAAGW,EAAS;EACd;CACF;AACF"}
+{"version":3,"file":"kitRegistry.js","names":[],"sources":["../../../src/core/scene/kitRegistry.ts"],"sourcesContent":["/**\n * The `SceneRegistry` entries the kit owns.\n *\n * A registry-keyed function has to be resolvable by key in whatever scene\n * loads a snapshot, so a function the *kit* attaches to a node cannot live in\n * the consumer's registry alone — a document saved with a grouped container\n * would come back with a dead key. `createScene` merges these under the\n * consumer's, which stays the winner on a key collision.\n */\nimport { unionAABB } from '../geometry/unionBounds';\nimport type { RectPose, SceneRegistry } from './types';\n\n/** Registry key for {@link unionOfChildren}. */\nexport const UNION_OF_CHILDREN = 'kit:unionOfChildren';\n\n/**\n * A container's pose as the envelope of what it holds — `unionAABB`, so a\n * rotated member contributes the extent of its ink rather than its unrotated\n * box. Paired with `dependsOn: 'children'`, this is what makes a group's\n * bounds track its members.\n *\n * Returns `null` for an emptied container, which falls back to its authored\n * pose.\n *\n * Reads members as rect poses only: a scene whose poses are shaped otherwise\n * gets `null` here and its container keeps its authored pose. To make such a\n * container track its members, register `unionOfChildrenVia(itsDescriptor)`\n * under {@link UNION_OF_CHILDREN} — the consumer's entry wins the collision.\n */\nexport function unionOfChildren<TPose>(\n  _node: unknown,\n  deps: readonly ({ pose: TPose } | undefined)[],\n): TPose | null {\n  const poses: RectPose[] = [];\n  for (const d of deps) {\n    if (d === undefined) continue;\n    const rect = asRectPose(d.pose);\n    if (rect === null) return null;\n    poses.push(rect);\n  }\n  if (poses.length === 0) return null;\n  const union = unionAABB(poses);\n  // Sound by the check above: every member read as a rect, so the union is one\n  // too, and a scene holding rect poses is a scene whose `TPose` is one.\n  return union === null ? null : (union as unknown as TPose);\n}\n\n/** `pose` as a rect, or `null` when it is some other shape entirely. */\nexport function asRectPose(pose: unknown): RectPose | null {\n  if (pose === null || typeof pose !== 'object') return null;\n  const p = pose as Partial<RectPose>;\n  const rect = typeof p.x === 'number' && typeof p.y === 'number'\n    && typeof p.width === 'number' && typeof p.height === 'number';\n  return rect ? (pose as RectPose) : null;\n}\n\n/** Merge the kit's own entries under a consumer registry. */\nexport function withKitRegistry<TPose, TData = unknown, TLayer extends string = string>(\n  registry: SceneRegistry<TPose, TData, TLayer>,\n): SceneRegistry<TPose, TData, TLayer> {\n  return {\n    ...registry,\n    derivePose: {\n      [UNION_OF_CHILDREN]: unionOfChildren as NonNullable<\n        SceneRegistry<TPose, TData, TLayer>['derivePose']\n      >[string],\n      ...registry.derivePose,\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,oBAAoB;;;;;;;;;;;;;;;AAgBjC,SAAgB,gBACd,OACA,MACc;CACd,MAAM,QAAoB,CAAC;CAC3B,KAAK,MAAM,KAAK,MAAM;EACpB,IAAI,MAAM,QAAW;EACrB,MAAM,OAAO,WAAW,EAAE,IAAI;EAC9B,IAAI,SAAS,MAAM,OAAO;EAC1B,MAAM,KAAK,IAAI;CACjB;CACA,IAAI,MAAM,WAAW,GAAG,OAAO;CAC/B,MAAM,QAAQ,UAAU,KAAK;CAG7B,OAAO,UAAU,OAAO,OAAQ;AAClC;;AAGA,SAAgB,WAAW,MAAgC;CACzD,IAAI,SAAS,QAAQ,OAAO,SAAS,UAAU,OAAO;CACtD,MAAM,IAAI;CAGV,OAFa,OAAO,EAAE,MAAM,YAAY,OAAO,EAAE,MAAM,YAClD,OAAO,EAAE,UAAU,YAAY,OAAO,EAAE,WAAW,WACzC,OAAoB;AACrC;;AAGA,SAAgB,gBACd,UACqC;CACrC,OAAO;EACL,GAAG;EACH,YAAY;IACT,oBAAoB;GAGrB,GAAG,SAAS;EACd;CACF;AACF"}