@weasel-js/core 1.15.0 → 1.15.2

package/dist/core/scene/lockGuard.js

@@ -1,6 +1,6 @@
 import { isNodeHidden, isNodeLocked, nodeGates } from "./nodeGates.js";
 
-//#region src/core/scene/lockGuard.ts
+// src/core/scene/lockGuard.ts
 /**
 * The scene's lock guard: what a lock refuses, what the selection may hold,
 * and how a caller that is restoring an already-legal state gets past it.
@@ -47,6 +47,5 @@ function createLockGuard(state) {
 	};
 }
 
-//#endregion
 export { createLockGuard };
 //# sourceMappingURL=lockGuard.js.map

package/dist/core/scene/minSize.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/minSize.ts
+// src/core/scene/minSize.ts
 /** A node's minimum, from `data.minSize`, or `null` when it has none. A
 *  side that is not a positive number holds nothing. */
 function minSizeOf(data) {
@@ -12,6 +12,5 @@ function minSizeOf(data) {
 	} : null;
 }
 
-//#endregion
 export { minSizeOf };
 //# sourceMappingURL=minSize.js.map

package/dist/core/scene/nestedHit.js

@@ -2,7 +2,7 @@ import { worldPoseLookup } from "./composePose.js";
 import { poseDescriptorForNode } from "../geometry/poseDescriptor.js";
 import { AUTO_POSE_DESCRIPTOR } from "../geometry/autoPoseDescriptor.js";
 
-//#region src/core/scene/nestedHit.ts
+// src/core/scene/nestedHit.ts
 /** Build hit-testers that respect containers: a plain click selects the
 *  top-level ancestor, and alt-clicking descends one level at a time toward
 *  the leaf actually under the pointer. */
@@ -49,6 +49,5 @@ function nestedHitTester(adapter, opts) {
 	};
 }
 
-//#endregion
 export { nestedHitTester };
 //# sourceMappingURL=nestedHit.js.map

package/dist/core/scene/nodeAsShown.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/nodeAsShown.ts
+// src/core/scene/nodeAsShown.ts
 /** Marks a node whose data is already shown. An own enumerable key, so a spread
 *  of the node (`{ ...node, pose }`) carries it, and applying an override to a
 *  copy of a shown node is a no-op however the copy was made. */
@@ -67,6 +67,5 @@ function nodesAsShown(overrides, nodes) {
 	return held.any ? nodes.map((node) => nodeAsShown(overrides, node)) : nodes;
 }
 
-//#endregion
 export { nodeAsShown, nodesAsShown, shownCopyOf, shownLookup, withShownData };
 //# sourceMappingURL=nodeAsShown.js.map

package/dist/core/scene/nodeFlags.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/nodeFlags.ts
+// src/core/scene/nodeFlags.ts
 /** Stored only while set, so a snapshot of an unflagged node carries neither. */
 function write(node, flag, to) {
 	if (to) node[flag] = true;
@@ -44,6 +44,5 @@ function createNodeFlags(env) {
 	};
 }
 
-//#endregion
 export { createNodeFlags };
 //# sourceMappingURL=nodeFlags.js.map

package/dist/core/scene/nodeFnFields.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/nodeFnFields.ts
+// src/core/scene/nodeFnFields.ts
 var NODE_FN_FIELDS = [
 	{
 		field: "clipFromPose",
@@ -93,6 +93,5 @@ function fnFieldsOfNode(node) {
 	return out;
 }
 
-//#endregion
 export { NODE_FN_FIELDS, createNodeFnFields, fnFieldsOfNode, fnKeysOf, restoreFn };
 //# sourceMappingURL=nodeFnFields.js.map

package/dist/core/scene/nodeGates.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/nodeGates.ts
+// src/core/scene/nodeGates.ts
 /** Whether `node`'s own flag hides it and its subtree. A walk from the roots
 *  down prunes where this holds instead of asking {@link NodeGates.hidden}
 *  per node; the two agree because this is the flag that answer climbs for. */
@@ -102,6 +102,5 @@ function isNodeLocked(scene, id) {
 	return climbs(scene, id, layers === null ? (node) => node.locked === true : (node) => node.locked === true || layers.has(node.layer));
 }
 
-//#endregion
 export { hidesSubtree, isNodeHidden, isNodeLocked, nodeGates };
 //# sourceMappingURL=nodeGates.js.map

package/dist/core/scene/nodeMemo.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/nodeMemo.ts
+// src/core/scene/nodeMemo.ts
 function createNodeMemoScope() {
 	return /* @__PURE__ */ new WeakMap();
 }
@@ -114,6 +114,5 @@ function dropPoseKeyedMemoSlots(node) {
 	for (const [slot, entry] of record.slots) if (entry.pose !== void 0) record.slots.delete(slot);
 }
 
-//#endregion
 export { bumpNodeMemoGeneration, createNodeMemoScope, dropPoseKeyedMemoSlots, nodeMemo, nodeMemoGeneration };
 //# sourceMappingURL=nodeMemo.js.map

package/dist/core/scene/nodeStore.js

@@ -1,10 +1,10 @@
+import { dwarn } from "../../debug/flag.js";
 import { createDependentsIndex } from "./dependents.js";
 import { dropPoseKeyedMemoSlots } from "./nodeMemo.js";
-import { dwarn } from "../../debug/flag.js";
 import { restoreFn } from "./nodeFnFields.js";
 import { SceneMembershipError } from "./staleReplay.js";
 
-//#region src/core/scene/nodeStore.ts
+// src/core/scene/nodeStore.ts
 /**
 * The scene's node store: the tree links, the reverse index of who derives
 * from whom, and the function fields a node carries beside its data.
@@ -200,6 +200,5 @@ function createNodeStore(state, invalidateOrder, fnFields) {
 	};
 }
 
-//#endregion
 export { createNodeStore };
 //# sourceMappingURL=nodeStore.js.map

package/dist/core/scene/notifier.js

@@ -1,6 +1,6 @@
 import { createEmitter } from "@weasel-js/registry";
 
-//#region src/core/scene/notifier.ts
+// src/core/scene/notifier.ts
 function createNotifier() {
 	const changed = createEmitter();
 	let version = 0;
@@ -43,6 +43,5 @@ function createNotifier() {
 	};
 }
 
-//#endregion
 export { createNotifier };
 //# sourceMappingURL=notifier.js.map

package/dist/core/scene/opTable.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/opTable.ts
+// src/core/scene/opTable.ts
 function createOpTable(env) {
 	const handlers = /* @__PURE__ */ new Map();
 	function handlerFor(kind) {
@@ -51,6 +51,5 @@ function createOpTable(env) {
 	};
 }
 
-//#endregion
 export { createOpTable };
 //# sourceMappingURL=opTable.js.map

package/dist/core/scene/outerOps.js

@@ -1,7 +1,7 @@
 import { rebuildOp } from "../ops/registry.js";
 import { bindOpToAdapter, bindOpToHistoryAdapter } from "./boundOps.js";
 
-//#region src/core/scene/outerOps.ts
+// src/core/scene/outerOps.ts
 /** A kit op under the key of the outer op that caused it, so two edits merge
 *  when their outer ops would have. */
 function keyed(kit, outerKey) {
@@ -68,6 +68,5 @@ function createOuterOps(env) {
 	};
 }
 
-//#endregion
 export { createOuterOps };
 //# sourceMappingURL=outerOps.js.map

package/dist/core/scene/pathEffects/blend.js

@@ -1,7 +1,7 @@
-import { boundsOfPath, measurePath, multiply, prepareBlend, rotate, rotatePathAround, transformPath, translate } from "@weasel-js/geom";
+import { boundsOfPath, measurePath, multiply, prepareBlend, rotate, rotatePathAround, transformPath, translate, wrapAngle } from "@weasel-js/geom";
 import { lerpFill, lerpStroke } from "@weasel-js/paint";
 
-//#region src/core/scene/pathEffects/blend.ts
+// src/core/scene/pathEffects/blend.ts
 /**
 * A blend's steps: where each sits between its two sources — evenly by
 * count, or a fixed distance apart — and, with a spine, laid along it.
@@ -48,7 +48,7 @@ function blendParts(effect, a, b, spine) {
 		b: b.framed
 	} : null;
 	const blend = turned ? prepareBlend(turned.a.path, turned.b.path, effect) : prepareBlend(a.world, b.world, effect);
-	const turn = turned ? Math.atan2(Math.sin(turned.b.rotation - turned.a.rotation), Math.cos(turned.b.rotation - turned.a.rotation)) : 0;
+	const turn = turned ? wrapAngle(turned.b.rotation - turned.a.rotation, "sign") : 0;
 	const chord = Math.atan2(to.y - from.y, to.x - from.x);
 	return stations.map((t) => {
 		let path = blend.at(t);
@@ -75,6 +75,5 @@ function blendParts(effect, a, b, spine) {
 	});
 }
 
-//#endregion
 export { blendParts, blendStations };
 //# sourceMappingURL=blend.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"blend.js","names":[],"sources":["../../../../src/core/scene/pathEffects/blend.ts"],"sourcesContent":["/**\n * A blend's steps: where each sits between its two sources — evenly by\n * count, or a fixed distance apart — and, with a spine, laid along it.\n */\nimport {\n  boundsOfPath, measurePath, multiply, prepareBlend, rotate, rotatePathAround, transformPath, translate,\n  type BlendPathsOptions, type Path, type PathMeasure,\n} from '@weasel-js/geom';\nimport { lerpFill, lerpStroke } from '@weasel-js/paint';\nimport type { DerivedPart } from '../derivedParts';\nimport type { EffectSource, PathEffectOptions } from './source';\n\n/** Steps between two shapes. Its sources are `[from, to]`, or\n *  `[from, to, spine]` to lay the steps along a third path. */\nexport interface BlendEffect extends BlendPathsOptions, PathEffectOptions {\n  kind: 'blend';\n  /** How many shapes stand between the two sources, spacing by count. */\n  steps: number;\n  /**\n   * How the steps are spaced. `'count'` puts `steps` of them evenly between\n   * the sources; `'distance'` puts one every `distance` along the run from\n   * the first source, as many as fit short of the second, so the last gap is\n   * whatever is left. Default `'count'`.\n   */\n  spaceBy?: 'count' | 'distance';\n  /** Distance from one shape's middle to the next, spacing by distance —\n   *  along the spine where there is one. Spacing by count when unset. */\n  distance?: number;\n  /**\n   * Interpolate each source's rotation as a turn about its middle, rather\n   * than moving every point in a straight line — so a shape turned 90° at\n   * one end turns through 45° halfway instead of shrinking there. Default\n   * `true`; it applies where both sources are turned boxes.\n   */\n  rotate?: boolean;\n  /** With a spine, turn each step by how far the spine's heading where it\n   *  sits differs from the straight run between the sources. Default\n   *  `false`, which only moves them. */\n  orient?: boolean;\n}\n\nconst EPS = 1e-9;\n\n/** The fractions of the way from the first source to the second that the\n *  steps sit at, over a run `length` long. */\nexport function blendStations(effect: BlendEffect, length: number): number[] {\n  const out: number[] = [];\n  const d = effect.distance;\n  if (effect.spaceBy === 'distance' && d !== undefined && d > 0) {\n    if (!(length > 0)) return out;\n    for (let s = d; s < length - EPS * Math.max(length, 1); s += d) out.push(s / length);\n    return out;\n  }\n  const steps = Math.max(Math.floor(effect.steps), 0);\n  for (let i = 1; i <= steps; i++) out.push(i / (steps + 1));\n  return out;\n}\n\n/** The middle a source's steps are interpolated about: its turn's center\n *  where it is a turned box, else its outline's bounds' middle. */\nfunction middleOf(source: EffectSource): { x: number; y: number } {\n  if (source.framed) return { x: source.framed.cx, y: source.framed.cy };\n  const b = boundsOfPath(source.world);\n  return { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n}\n\n/** The parts of `effect` between `a` and `b`, along `spine` when given.\n *  `null` when the spine has no length to measure. */\nexport function blendParts(effect: BlendEffect, a: EffectSource, b: EffectSource, spine?: Path): DerivedPart[] | null {\n  const from = middleOf(a);\n  const to = middleOf(b);\n  const along: PathMeasure | null = spine === undefined ? null : measurePath(spine);\n  if (spine !== undefined && along === null) return null;\n  const stations = blendStations(effect, along ? along.length : Math.hypot(to.x - from.x, to.y - from.y));\n  if (stations.length === 0) return [];\n\n  const turned = (effect.rotate ?? true) && a.framed !== undefined && b.framed !== undefined\n    ? { a: a.framed, b: b.framed }\n    : null;\n  const blend = turned\n    ? prepareBlend(turned.a.path, turned.b.path, effect)\n    : prepareBlend(a.world, b.world, effect);\n  // The shorter way round, so a turn of 350° reads as -10°.\n  const turn = turned\n    ? Math.atan2(Math.sin(turned.b.rotation - turned.a.rotation), Math.cos(turned.b.rotation - turned.a.rotation))\n    : 0;\n  const chord = Math.atan2(to.y - from.y, to.x - from.x);\n  return stations.map((t) => {\n    let path: Path = blend.at(t);\n    if (turned) {\n      const cx = turned.a.cx + (turned.b.cx - turned.a.cx) * t;\n      const cy = turned.a.cy + (turned.b.cy - turned.a.cy) * t;\n      const rotation = turned.a.rotation + turn * t;\n      if (rotation !== 0) path = rotatePathAround(path, cx, cy, rotation);\n    }\n    if (along) {\n      const { point, tangent } = along.at(t * along.length);\n      const angle = effect.orient ? Math.atan2(tangent.y, tangent.x) - chord : 0;\n      const middle = { x: from.x + (to.x - from.x) * t, y: from.y + (to.y - from.y) * t };\n      path = transformPath(path, multiply(translate(point.x, point.y), multiply(rotate(angle), translate(-middle.x, -middle.y))));\n    }\n    return { path, fill: lerpFill(a.fill, b.fill, t) ?? null, stroke: lerpStroke(a.stroke, b.stroke, t) ?? null };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"blend.js","names":[],"sources":["../../../../src/core/scene/pathEffects/blend.ts"],"sourcesContent":["/**\n * A blend's steps: where each sits between its two sources — evenly by\n * count, or a fixed distance apart — and, with a spine, laid along it.\n */\nimport {\n  boundsOfPath, measurePath, multiply, prepareBlend, rotate, rotatePathAround, transformPath, translate, wrapAngle,\n  type BlendPathsOptions, type Path, type PathMeasure,\n} from '@weasel-js/geom';\nimport { lerpFill, lerpStroke } from '@weasel-js/paint';\nimport type { DerivedPart } from '../derivedParts';\nimport type { EffectSource, PathEffectOptions } from './source';\n\n/** Steps between two shapes. Its sources are `[from, to]`, or\n *  `[from, to, spine]` to lay the steps along a third path. */\nexport interface BlendEffect extends BlendPathsOptions, PathEffectOptions {\n  kind: 'blend';\n  /** How many shapes stand between the two sources, spacing by count. */\n  steps: number;\n  /**\n   * How the steps are spaced. `'count'` puts `steps` of them evenly between\n   * the sources; `'distance'` puts one every `distance` along the run from\n   * the first source, as many as fit short of the second, so the last gap is\n   * whatever is left. Default `'count'`.\n   */\n  spaceBy?: 'count' | 'distance';\n  /** Distance from one shape's middle to the next, spacing by distance —\n   *  along the spine where there is one. Spacing by count when unset. */\n  distance?: number;\n  /**\n   * Interpolate each source's rotation as a turn about its middle, rather\n   * than moving every point in a straight line — so a shape turned 90° at\n   * one end turns through 45° halfway instead of shrinking there. Default\n   * `true`; it applies where both sources are turned boxes.\n   */\n  rotate?: boolean;\n  /** With a spine, turn each step by how far the spine's heading where it\n   *  sits differs from the straight run between the sources. Default\n   *  `false`, which only moves them. */\n  orient?: boolean;\n}\n\nconst EPS = 1e-9;\n\n/** The fractions of the way from the first source to the second that the\n *  steps sit at, over a run `length` long. */\nexport function blendStations(effect: BlendEffect, length: number): number[] {\n  const out: number[] = [];\n  const d = effect.distance;\n  if (effect.spaceBy === 'distance' && d !== undefined && d > 0) {\n    if (!(length > 0)) return out;\n    for (let s = d; s < length - EPS * Math.max(length, 1); s += d) out.push(s / length);\n    return out;\n  }\n  const steps = Math.max(Math.floor(effect.steps), 0);\n  for (let i = 1; i <= steps; i++) out.push(i / (steps + 1));\n  return out;\n}\n\n/** The middle a source's steps are interpolated about: its turn's center\n *  where it is a turned box, else its outline's bounds' middle. */\nfunction middleOf(source: EffectSource): { x: number; y: number } {\n  if (source.framed) return { x: source.framed.cx, y: source.framed.cy };\n  const b = boundsOfPath(source.world);\n  return { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n}\n\n/** The parts of `effect` between `a` and `b`, along `spine` when given.\n *  `null` when the spine has no length to measure. */\nexport function blendParts(effect: BlendEffect, a: EffectSource, b: EffectSource, spine?: Path): DerivedPart[] | null {\n  const from = middleOf(a);\n  const to = middleOf(b);\n  const along: PathMeasure | null = spine === undefined ? null : measurePath(spine);\n  if (spine !== undefined && along === null) return null;\n  const stations = blendStations(effect, along ? along.length : Math.hypot(to.x - from.x, to.y - from.y));\n  if (stations.length === 0) return [];\n\n  const turned = (effect.rotate ?? true) && a.framed !== undefined && b.framed !== undefined\n    ? { a: a.framed, b: b.framed }\n    : null;\n  const blend = turned\n    ? prepareBlend(turned.a.path, turned.b.path, effect)\n    : prepareBlend(a.world, b.world, effect);\n  // The shorter way round, so a turn of 350° reads as -10°.\n  const turn = turned ? wrapAngle(turned.b.rotation - turned.a.rotation, 'sign') : 0;\n  const chord = Math.atan2(to.y - from.y, to.x - from.x);\n  return stations.map((t) => {\n    let path: Path = blend.at(t);\n    if (turned) {\n      const cx = turned.a.cx + (turned.b.cx - turned.a.cx) * t;\n      const cy = turned.a.cy + (turned.b.cy - turned.a.cy) * t;\n      const rotation = turned.a.rotation + turn * t;\n      if (rotation !== 0) path = rotatePathAround(path, cx, cy, rotation);\n    }\n    if (along) {\n      const { point, tangent } = along.at(t * along.length);\n      const angle = effect.orient ? Math.atan2(tangent.y, tangent.x) - chord : 0;\n      const middle = { x: from.x + (to.x - from.x) * t, y: from.y + (to.y - from.y) * t };\n      path = transformPath(path, multiply(translate(point.x, point.y), multiply(rotate(angle), translate(-middle.x, -middle.y))));\n    }\n    return { path, fill: lerpFill(a.fill, b.fill, t) ?? null, stroke: lerpStroke(a.stroke, b.stroke, t) ?? null };\n  });\n}\n"],"mappings":"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"}

package/dist/core/scene/pathEffects/derive.js

@@ -1,10 +1,10 @@
+import { derivedPartsOf, pathFromParts } from "../derivedParts.js";
 import { fontGeneration, noteFontRead, withFontReads } from "../fontReads.js";
 import { samePoseValue, snapshotPose } from "../poseSnapshot.js";
-import { derivedPartsOf, pathFromParts } from "../derivedParts.js";
 import { effectParts } from "./effects.js";
 import { boundsOfPath } from "@weasel-js/geom";
 
-//#region src/core/scene/pathEffects/derive.ts
+// src/core/scene/pathEffects/derive.ts
 /**
 * A path effect as a scene node: a leaf whose `dependsOn` names its sources,
 * whose `data.pathEffect` says what to make of them, and whose path and pose
@@ -113,6 +113,5 @@ function registeredPathEffects(registry) {
 	} : null;
 }
 
-//#endregion
 export { PATH_EFFECT, createPathEffectDerivations, pathEffectNode, pathEffectOf, pathEffectParts, registeredPathEffects };
 //# sourceMappingURL=derive.js.map

package/dist/core/scene/pathEffects/effects.js

@@ -2,7 +2,7 @@ import { blendParts } from "./blend.js";
 import { textAlongParts, wholeItem } from "./textAlong.js";
 import { bendAlongPath, puckerBloatPath, repeatAlongPath, roughenPath, zigzagPath } from "@weasel-js/geom";
 
-//#region src/core/scene/pathEffects/effects.ts
+// src/core/scene/pathEffects/effects.ts
 /**
 * The path effects, each as the parts it paints from its sources: a blend's
 * steps between two shapes, a shape bent along a spine, copies of a shape
@@ -56,6 +56,5 @@ function effectParts(effect, sources) {
 	}
 }
 
-//#endregion
 export { effectParts };
 //# sourceMappingURL=effects.js.map

package/dist/core/scene/pathEffects/foundHidden.js

@@ -1,6 +1,6 @@
 import { pathEffectOf } from "./derive.js";
 
-//#region src/core/scene/pathEffects/foundHidden.ts
+// src/core/scene/pathEffects/foundHidden.ts
 /**
 * A path effect's `foundHidden` names its sources by position, so a retarget
 * of its `dependsOn` carries the record along: every writer of `dependsOn`
@@ -30,6 +30,5 @@ function foundHiddenRetargeted(data, from, to) {
 	};
 }
 
-//#endregion
 export { foundHiddenRetargeted };
 //# sourceMappingURL=foundHidden.js.map

package/dist/core/scene/pathEffects/textAlong.js

@@ -1,7 +1,7 @@
 import { bandParts } from "./textAlongBands.js";
-import { boundsOfPath, multiply, pathShape, placeAlongRun, rotate, runLength, trackRun, transformPath, translate } from "@weasel-js/geom";
+import { boundsOfPath, clamp01, multiply, pathShape, placeAlongRun, rotate, runLength, trackRun, transformPath, translate } from "@weasel-js/geom";
 
-//#region src/core/scene/pathEffects/textAlong.ts
+// src/core/scene/pathEffects/textAlong.ts
 /**
 * Text along a path: a source's items — a text node's grapheme clusters, or a
 * whole shape as one item — laid end to end along a path, each turned to it.
@@ -19,11 +19,11 @@ function textAlongParts(effect, items, path) {
 	const closed = shape.closed;
 	const lengths = items.map((it) => it.length);
 	const k = LEAD[effect.align ?? "start"];
-	const at = clamp01(effect.start ?? 0) * L;
+	const at = unit(effect.start ?? 0) * L;
 	const gap = effect.overflow === "fit" ? fitGap(lengths, roomAt(at, L, k, closed)) : 0;
 	const total = runLength(lengths, gap);
 	const c = at + (.5 - k) * total;
-	const about = closed ? (c / L % 1 + 1) % 1 : clamp01(c / L);
+	const about = closed ? (c / L % 1 + 1) % 1 : unit(c / L);
 	const run = trackRun(shape, 0, 1, {
 		side: effect.side ?? "auto",
 		about
@@ -100,9 +100,9 @@ function itemFrame(place, length, lift) {
 	const turn = multiply(rotate(place.angle * Math.PI / 180), translate(-length / 2, lift));
 	return multiply(translate(place.point.x, place.point.y), turn);
 }
-var clamp01 = (v) => v > 1 ? 1 : v > 0 ? v : 0;
+/** `clamp01`, with `NaN` read as 0. */
+var unit = (v) => clamp01(v) || 0;
 var finiteOr = (v, d) => v !== void 0 && Number.isFinite(v) ? v : d;
 
-//#endregion
 export { textAlongParts, wholeItem };
 //# sourceMappingURL=textAlong.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"textAlong.js","names":[],"sources":["../../../../src/core/scene/pathEffects/textAlong.ts"],"sourcesContent":["/**\n * Text along a path: a source's items — a text node's grapheme clusters, or a\n * whole shape as one item — laid end to end along a path, each turned to it.\n */\nimport {\n  boundsOfPath, multiply, pathShape, placeAlongRun, rotate, runLength, trackRun, transformPath, translate,\n  type Affine, type Path, type RunAlign, type RunPlace, type TrackSide,\n} from '@weasel-js/geom';\nimport type { DerivedPart } from '../derivedParts';\nimport type { EffectItem, EffectSource, PathEffectOptions } from './source';\nimport { bandParts, type LaidItem } from './textAlongBands';\n\n/**\n * Text (or any shape) laid along a path, item by item. Its sources are `[text, path]`. Only the text's first laid line\n * follows the path; a color glyph keeps its advance and paints nothing. An item's bands — underline, strikethrough and\n * overline — join their alike neighbors' and bend with the path as one ribbon, while the glyphs stay rigid.\n * On an open path an item whose middle falls past either end is not drawn; on a closed one the text wraps past the\n * seam, and an item a whole lap on from the first item's start is not drawn.\n */\nexport interface TextAlongEffect extends PathEffectOptions {\n  kind: 'textAlong';\n  /** Which part of the text sits at `start`. Default `'start'`. */\n  align?: RunAlign;\n  /** Where the text sits, as a fraction 0..1 of the path's length from its first point. Default 0. */\n  start?: number;\n  /** How far the anchor line sits off the path, toward the glyphs' up, in world units. Default 0. */\n  shift?: number;\n  /** What sits on the path: the glyphs' baseline, or (`'center'`) their x-height middle. Default `'baseline'`. */\n  anchor?: 'baseline' | 'center';\n  /** Text longer than its room is cut at the path's end (`'clip'`), or has the gaps between items squeezed until it\n   *  fits (`'fit'`). Default `'clip'`. */\n  overflow?: 'clip' | 'fit';\n  /** Which side of the path the glyphs stand on; see `TrackSide`. Default `'auto'`, whichever reads upright. Turned over,\n   *  the text keeps the stretch of path it had, and on an open path drops whichever letters fall off it. */\n  side?: TrackSide;\n}\n\nconst LEAD: Record<RunAlign, number> = { start: 0, center: 0.5, end: 1 };\n\n/** The parts `items` paint laid along `path` as `effect` says; `[]` when there is nothing to lay or nowhere to lay it. */\nexport function textAlongParts(effect: TextAlongEffect, items: readonly EffectItem[], path: Path): DerivedPart[] {\n  const shape = pathShape(path);\n  if (shape === null || !(shape.length > 0) || items.length === 0) return [];\n  const L = shape.length;\n  const closed = shape.closed;\n  const lengths = items.map((it) => it.length);\n  const k = LEAD[effect.align ?? 'start'];\n  const at = clamp01(effect.start ?? 0) * L;\n  const gap = effect.overflow === 'fit' ? fitGap(lengths, roomAt(at, L, k, closed)) : 0;\n  const total = runLength(lengths, gap);\n  const c = at + (0.5 - k) * total;\n  const about = closed ? ((c / L) % 1 + 1) % 1 : clamp01(c / L);\n  const run = trackRun(shape, 0, 1, { side: effect.side ?? 'auto', about });\n  const shift = finiteOr(effect.shift, 0);\n  const places = placeAlongRun(run, lengths, { gap, align: 'center', at: run.reversed ? L - c : c, shift, wrap: closed });\n  const center = effect.anchor === 'center';\n  const out: DerivedPart[] = [];\n  const laid: (LaidItem | null)[] = [];\n  const firstStart = places[0]!.center - lengths[0]! / 2;\n  places.forEach((place, i) => {\n    // By center (SVG textPath's rule), not by RunPlace.clipped, which judges by extent.\n    if (dropped(place, closed ? firstStart : null, L)) {\n      laid.push(null);\n      return;\n    }\n    const item = items[i]!;\n    const lift = center ? item.middle : 0;\n    const m = itemFrame(place, item.length, lift);\n    for (const part of item.parts) out.push({ ...part, path: transformPath(part.path, m) });\n    laid.push({ item, start: place.center - item.length / 2, lift });\n  });\n  if (items.some((it) => it.bands !== undefined && it.bands.length > 0)) out.push(...bandParts(laid, run, shift));\n  return out;\n}\n\n/** `source`'s whole outline as one item: its bounds' left at x = 0 and their vertical middle on the anchor line. */\nexport function wholeItem(source: EffectSource): EffectItem {\n  const b = boundsOfPath(source.world);\n  return {\n    length: b.width,\n    middle: 0,\n    parts: [{\n      path: transformPath(source.world, translate(-b.x, -(b.y + b.height / 2))),\n      fill: source.fill,\n      stroke: source.stroke,\n    }],\n  };\n}\n\n/** SVG `textPath`'s rule: an item is not drawn once its middle is past an open path's ends, or on a closed path a whole\n *  lap or more on from the first item's start. Judged within a hair of rounding. */\nfunction dropped(place: RunPlace, firstStart: number | null, L: number): boolean {\n  const hair = 1e-9 * Math.max(1, L);\n  if (firstStart !== null) return place.center - firstStart >= L - hair;\n  return place.center < -hair || place.center > L + hair;\n}\n\n/** How much path the text has before it runs off, from `at`, with `k` of it laid back behind `at`. */\nfunction roomAt(at: number, L: number, k: number, closed: boolean): number {\n  if (closed) return L;\n  return k === 0 ? L - at : k === 1 ? at : 2 * Math.min(at, L - at);\n}\n\n/** The gap that makes `lengths` fill `room`, or 0 when they fit already. Never so negative that an item's step back\n *  from the one before it (its length plus the gap) goes below zero, so items keep their order in too short a room. */\nfunction fitGap(lengths: readonly number[], room: number): number {\n  const total = runLength(lengths, 0);\n  if (!(total > room) || lengths.length < 2) return 0;\n  let floor = -Infinity;\n  for (let i = 1; i < lengths.length; i++) floor = Math.max(floor, -(lengths[i - 1]! + lengths[i]!) / 2);\n  return Math.max((room - total) / (lengths.length - 1), floor);\n}\n\n/** Item frame to world: its middle on `place`, turned to it, its anchor line `lift` above y = 0 brought onto the path. */\nfunction itemFrame(place: RunPlace, length: number, lift: number): Affine {\n  const turn = multiply(rotate((place.angle * Math.PI) / 180), translate(-length / 2, lift));\n  return multiply(translate(place.point.x, place.point.y), turn);\n}\n\nconst clamp01 = (v: number): number => (v > 1 ? 1 : v > 0 ? v : 0);\nconst finiteOr = (v: number | undefined, d: number): number => (v !== undefined && Number.isFinite(v) ? v : d);\n"],"mappings":"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"}
+{"version":3,"file":"textAlong.js","names":[],"sources":["../../../../src/core/scene/pathEffects/textAlong.ts"],"sourcesContent":["/**\n * Text along a path: a source's items — a text node's grapheme clusters, or a\n * whole shape as one item — laid end to end along a path, each turned to it.\n */\nimport {\n  boundsOfPath, clamp01, multiply, pathShape, placeAlongRun, rotate, runLength, trackRun, transformPath, translate,\n  type Affine, type Path, type RunAlign, type RunPlace, type TrackSide,\n} from '@weasel-js/geom';\nimport type { DerivedPart } from '../derivedParts';\nimport type { EffectItem, EffectSource, PathEffectOptions } from './source';\nimport { bandParts, type LaidItem } from './textAlongBands';\n\n/**\n * Text (or any shape) laid along a path, item by item. Its sources are `[text, path]`. Only the text's first laid line\n * follows the path; a color glyph keeps its advance and paints nothing. An item's bands — underline, strikethrough and\n * overline — join their alike neighbors' and bend with the path as one ribbon, while the glyphs stay rigid.\n * On an open path an item whose middle falls past either end is not drawn; on a closed one the text wraps past the\n * seam, and an item a whole lap on from the first item's start is not drawn.\n */\nexport interface TextAlongEffect extends PathEffectOptions {\n  kind: 'textAlong';\n  /** Which part of the text sits at `start`. Default `'start'`. */\n  align?: RunAlign;\n  /** Where the text sits, as a fraction 0..1 of the path's length from its first point. Default 0. */\n  start?: number;\n  /** How far the anchor line sits off the path, toward the glyphs' up, in world units. Default 0. */\n  shift?: number;\n  /** What sits on the path: the glyphs' baseline, or (`'center'`) their x-height middle. Default `'baseline'`. */\n  anchor?: 'baseline' | 'center';\n  /** Text longer than its room is cut at the path's end (`'clip'`), or has the gaps between items squeezed until it\n   *  fits (`'fit'`). Default `'clip'`. */\n  overflow?: 'clip' | 'fit';\n  /** Which side of the path the glyphs stand on; see `TrackSide`. Default `'auto'`, whichever reads upright. Turned over,\n   *  the text keeps the stretch of path it had, and on an open path drops whichever letters fall off it. */\n  side?: TrackSide;\n}\n\nconst LEAD: Record<RunAlign, number> = { start: 0, center: 0.5, end: 1 };\n\n/** The parts `items` paint laid along `path` as `effect` says; `[]` when there is nothing to lay or nowhere to lay it. */\nexport function textAlongParts(effect: TextAlongEffect, items: readonly EffectItem[], path: Path): DerivedPart[] {\n  const shape = pathShape(path);\n  if (shape === null || !(shape.length > 0) || items.length === 0) return [];\n  const L = shape.length;\n  const closed = shape.closed;\n  const lengths = items.map((it) => it.length);\n  const k = LEAD[effect.align ?? 'start'];\n  const at = unit(effect.start ?? 0) * L;\n  const gap = effect.overflow === 'fit' ? fitGap(lengths, roomAt(at, L, k, closed)) : 0;\n  const total = runLength(lengths, gap);\n  const c = at + (0.5 - k) * total;\n  const about = closed ? ((c / L) % 1 + 1) % 1 : unit(c / L);\n  const run = trackRun(shape, 0, 1, { side: effect.side ?? 'auto', about });\n  const shift = finiteOr(effect.shift, 0);\n  const places = placeAlongRun(run, lengths, { gap, align: 'center', at: run.reversed ? L - c : c, shift, wrap: closed });\n  const center = effect.anchor === 'center';\n  const out: DerivedPart[] = [];\n  const laid: (LaidItem | null)[] = [];\n  const firstStart = places[0]!.center - lengths[0]! / 2;\n  places.forEach((place, i) => {\n    // By center (SVG textPath's rule), not by RunPlace.clipped, which judges by extent.\n    if (dropped(place, closed ? firstStart : null, L)) {\n      laid.push(null);\n      return;\n    }\n    const item = items[i]!;\n    const lift = center ? item.middle : 0;\n    const m = itemFrame(place, item.length, lift);\n    for (const part of item.parts) out.push({ ...part, path: transformPath(part.path, m) });\n    laid.push({ item, start: place.center - item.length / 2, lift });\n  });\n  if (items.some((it) => it.bands !== undefined && it.bands.length > 0)) out.push(...bandParts(laid, run, shift));\n  return out;\n}\n\n/** `source`'s whole outline as one item: its bounds' left at x = 0 and their vertical middle on the anchor line. */\nexport function wholeItem(source: EffectSource): EffectItem {\n  const b = boundsOfPath(source.world);\n  return {\n    length: b.width,\n    middle: 0,\n    parts: [{\n      path: transformPath(source.world, translate(-b.x, -(b.y + b.height / 2))),\n      fill: source.fill,\n      stroke: source.stroke,\n    }],\n  };\n}\n\n/** SVG `textPath`'s rule: an item is not drawn once its middle is past an open path's ends, or on a closed path a whole\n *  lap or more on from the first item's start. Judged within a hair of rounding. */\nfunction dropped(place: RunPlace, firstStart: number | null, L: number): boolean {\n  const hair = 1e-9 * Math.max(1, L);\n  if (firstStart !== null) return place.center - firstStart >= L - hair;\n  return place.center < -hair || place.center > L + hair;\n}\n\n/** How much path the text has before it runs off, from `at`, with `k` of it laid back behind `at`. */\nfunction roomAt(at: number, L: number, k: number, closed: boolean): number {\n  if (closed) return L;\n  return k === 0 ? L - at : k === 1 ? at : 2 * Math.min(at, L - at);\n}\n\n/** The gap that makes `lengths` fill `room`, or 0 when they fit already. Never so negative that an item's step back\n *  from the one before it (its length plus the gap) goes below zero, so items keep their order in too short a room. */\nfunction fitGap(lengths: readonly number[], room: number): number {\n  const total = runLength(lengths, 0);\n  if (!(total > room) || lengths.length < 2) return 0;\n  let floor = -Infinity;\n  for (let i = 1; i < lengths.length; i++) floor = Math.max(floor, -(lengths[i - 1]! + lengths[i]!) / 2);\n  return Math.max((room - total) / (lengths.length - 1), floor);\n}\n\n/** Item frame to world: its middle on `place`, turned to it, its anchor line `lift` above y = 0 brought onto the path. */\nfunction itemFrame(place: RunPlace, length: number, lift: number): Affine {\n  const turn = multiply(rotate((place.angle * Math.PI) / 180), translate(-length / 2, lift));\n  return multiply(translate(place.point.x, place.point.y), turn);\n}\n\n/** `clamp01`, with `NaN` read as 0. */\nconst unit = (v: number): number => clamp01(v) || 0;\nconst finiteOr = (v: number | undefined, d: number): number => (v !== undefined && Number.isFinite(v) ? v : d);\n"],"mappings":"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"}

package/dist/core/scene/pathEffects/textAlongBands.js

@@ -1,6 +1,6 @@
 import { polygonFromPoints, runStationAt } from "@weasel-js/geom";
 
-//#region src/core/scene/pathEffects/textAlongBands.ts
+// src/core/scene/pathEffects/textAlongBands.ts
 /**
 * The bands text along a path carries — decoration rules cut into clusters — joined across neighboring items and drawn
 * as ribbons that bend with the path.
@@ -60,6 +60,5 @@ function ribbonPart(r, run, shift) {
 	};
 }
 
-//#endregion
 export { bandParts };
 //# sourceMappingURL=textAlongBands.js.map

package/dist/core/scene/plyStacks.js

@@ -1,6 +1,6 @@
 import { carryBoxPath } from "./depFrame.js";
 
-//#region src/core/scene/plyStacks.ts
+// src/core/scene/plyStacks.ts
 /** Empty stacks. */
 function createPlyStacks() {
 	const plies = /* @__PURE__ */ new Map();
@@ -84,6 +84,5 @@ function plyPath(stack, pose, held) {
 	}
 }
 
-//#endregion
 export { createPlyStacks, plyPath };
 //# sourceMappingURL=plyStacks.js.map

package/dist/core/scene/poseFeed.js

@@ -1,7 +1,7 @@
 import { effectivePose } from "./effectivePose.js";
 import { createEmitter } from "@weasel-js/registry";
 
-//#region src/core/scene/poseFeed.ts
+// src/core/scene/poseFeed.ts
 var EMPTY = Object.freeze([]);
 /** A {@link PoseFeed} over `scene`, reporting effective poses (committed pose
 *  under any override). The first `read()` is a reset listing every node. */
@@ -117,6 +117,5 @@ function createPoseFeed(scene) {
 	};
 }
 
-//#endregion
 export { createPoseFeed };
 //# sourceMappingURL=poseFeed.js.map

package/dist/core/scene/poseHold.js

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

package/dist/core/scene/poseOverrides.js

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

package/dist/core/scene/posePlies.js

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

package/dist/core/scene/poseRemovals.js

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

package/dist/core/scene/poseSnapshot.js

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

package/dist/core/scene/poseWrites.js

@@ -1,7 +1,7 @@
 import { createRemovalLog } from "./poseRemovals.js";
 import { createEmitter, deepEqual } from "@weasel-js/registry";
 
-//#region src/core/scene/poseWrites.ts
+// src/core/scene/poseWrites.ts
 /**
 * What a scene reports about the poses it writes: each change's net pose per
 * node, the nodes it removed as they were last shown, and where each came
@@ -147,6 +147,5 @@ function createPoseWriteLog(env) {
 	};
 }
 
-//#endregion
 export { createPoseWriteLog };
 //# sourceMappingURL=poseWrites.js.map

package/dist/core/scene/reconcileSpecs.js

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

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

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

package/dist/core/scene/recorder.js

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