@weasel-js/core 1.11.0 → 1.12.0

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 } 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 {\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,\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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"}

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

@@ -1,3 +1,4 @@
+import { fontGeneration, noteFontRead, withFontReads } from "../fontReads.js";
 import { samePoseValue, snapshotPose } from "../poseSnapshot.js";
 import { derivedPartsOf, pathFromParts } from "../derivedParts.js";
 import { effectParts } from "./effects.js";
@@ -33,14 +34,16 @@ function createPathEffectDerivations(read) {
 		const held = results.get(node);
 		if (held !== void 0 && current(held, node, deps)) return held;
 		const effect = pathEffectOf(node);
-		const parts = effect === null ? null : effectParts(effect, deps.map((d) => d === void 0 ? null : read(d)));
+		const generation = fontGeneration();
+		const { value: parts, fonts } = withFontReads(() => effect === null ? null : effectParts(effect, deps.map((d) => d === void 0 ? null : read(d))));
 		const result = {
 			data: node.data,
 			nodes: deps.map((d) => d?.node),
 			depData: deps.map((d) => d?.node.data),
 			poses: deps.map((d) => d === void 0 ? void 0 : snapshotPose(d.pose)),
 			paths: deps.map((d) => d?.path ?? null),
-			path: parts === null ? null : pathFromParts(parts)
+			path: parts === null ? null : pathFromParts(parts),
+			faces: fonts ? generation : null
 		};
 		results.set(node, result);
 		return result;
@@ -62,6 +65,7 @@ function createPathEffectDerivations(read) {
 }
 function current(held, node, deps) {
 	if (held.data !== node.data || held.nodes.length !== deps.length) return false;
+	if (held.faces !== null && held.faces !== fontGeneration()) return false;
 	for (let i = 0; i < deps.length; i++) {
 		const d = deps[i];
 		if (held.nodes[i] !== d?.node) return false;
@@ -69,6 +73,7 @@ function current(held, node, deps) {
 		if (held.depData[i] !== d.node.data || !samePoseValue(held.poses[i], d.pose)) return false;
 		if (held.paths[i] !== d.path) return false;
 	}
+	if (held.faces !== null) noteFontRead();
 	return true;
 }
 /** The parts a path-effect node paints, as its sources stand, or `null` when

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

@@ -1 +1 @@
-{"version":3,"file":"derive.js","names":[],"sources":["../../../../src/core/scene/pathEffects/derive.ts"],"sourcesContent":["/**\n * A path effect as a scene node: a leaf whose `dependsOn` names its sources,\n * whose `data.pathEffect` says what to make of them, and whose path and pose\n * are both derived — the path to paint and pick, the pose as that path's\n * bounds, so selection chrome and marquee see where it is.\n *\n * Reading a source's outline and paint is its painter's business, which sits\n * above the scene, so the derivations are made from a reader:\n * `createPathEffectDerivations(read)`. The canvas layer makes the kit's, and\n * a scene that holds path effects registers them under {@link PATH_EFFECT}.\n */\nimport { boundsOfPath, type Path } from '@weasel-js/geom';\nimport { derivedPartsOf, pathFromParts, type DerivedPart } from '../derivedParts';\nimport { samePoseValue, snapshotPose } from '../poseSnapshot';\nimport type { DerivedDep, NodeId } from '../types';\nimport { effectParts, type PathEffect } from './effects';\nimport type { EffectSourceReader } from './source';\n\n/** The registry key both derivations go by, for `derivePath` and `derivePose`. */\nexport const PATH_EFFECT = 'kit:pathEffect';\n\n/** A node's path effect, or `null` when its data holds none. */\nexport function pathEffectOf(node: { data?: unknown } | undefined): PathEffect | null {\n  const effect = (node?.data as { pathEffect?: PathEffect } | null | undefined)?.pathEffect;\n  return effect && typeof effect === 'object' && typeof effect.kind === 'string' ? effect : null;\n}\n\n/** A path-effect node's two derivations. */\nexport interface PathEffectDerivations {\n  /** What it paints and picks by. */\n  derivePath(node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): Path | null;\n  /** The bounds of what it paints, or `null` — its authored pose — while it\n   *  paints nothing. */\n  derivePose(node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): { x: number; y: number; width: number; height: number } | null;\n}\n\ninterface Derived {\n  data: unknown;\n  nodes: unknown[];\n  depData: unknown[];\n  poses: unknown[];\n  paths: (Path | null)[];\n  path: Path | null;\n}\n\n/** The derivations of a path effect whose sources `read` reads. */\nexport function createPathEffectDerivations(read: EffectSourceReader): PathEffectDerivations {\n  /** One result per effect node, shared by its two derivations: the pose is\n   *  the path's bounds, and working the effect out twice a frame would double\n   *  its cost. Checked against everything it read, by value for poses — a\n   *  drag's override mutates its pose in place. */\n  const results = new WeakMap<object, Derived>();\n  const derive = (node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): Derived => {\n    const held = results.get(node);\n    if (held !== undefined && current(held, node, deps)) return held;\n    const effect = pathEffectOf(node);\n    const parts = effect === null\n      ? null\n      : effectParts(effect, deps.map((d) => (d === undefined ? null : read(d))));\n    const result: Derived = {\n      data: node.data,\n      nodes: deps.map((d) => d?.node),\n      depData: deps.map((d) => d?.node.data),\n      poses: deps.map((d) => (d === undefined ? undefined : snapshotPose(d.pose))),\n      paths: deps.map((d) => d?.path ?? null),\n      path: parts === null ? null : pathFromParts(parts),\n    };\n    results.set(node, result);\n    return result;\n  };\n  return {\n    derivePath: (node, deps) => derive(node, deps).path,\n    derivePose: (node, deps) => {\n      const path = derive(node, deps).path;\n      if (path === null) return null;\n      const { x, y, width, height } = boundsOfPath(path);\n      return { x, y, width, height };\n    },\n  };\n}\n\nfunction current(held: Derived, node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): boolean {\n  if (held.data !== node.data || held.nodes.length !== deps.length) return false;\n  for (let i = 0; i < deps.length; i++) {\n    const d = deps[i];\n    if (held.nodes[i] !== d?.node) return false;\n    if (d === undefined) continue;\n    if (held.depData[i] !== d.node.data || !samePoseValue(held.poses[i], d.pose)) return false;\n    if (held.paths[i] !== d.path) return false;\n  }\n  return true;\n}\n\n/** The parts a path-effect node paints, as its sources stand, or `null` when\n *  it has no derivation or nothing to paint. */\nexport function pathEffectParts(\n  node: { data?: unknown; derivePath?: unknown },\n  deps: readonly (DerivedDep<unknown> | undefined)[],\n): readonly DerivedPart[] | null {\n  if (typeof node.derivePath !== 'function') return null;\n  return derivedPartsOf((node.derivePath as PathEffectDerivations['derivePath'])(node, deps)) ?? null;\n}\n\n/** What to hand `Scene.add` (or an insert op) for a path-effect node over\n *  `sources`, in the order its kind reads them, deriving through\n *  `derivations` — the ones the scene registers under {@link PATH_EFFECT}. */\nexport function pathEffectNode<TLayer extends string>(\n  effect: PathEffect,\n  sources: readonly NodeId[],\n  layer: TLayer,\n  derivations: PathEffectDerivations,\n): {\n  kind: 'leaf';\n  layer: TLayer;\n  pose: { x: number; y: number; width: number; height: number };\n  data: { pathEffect: PathEffect };\n  dependsOn: readonly NodeId[];\n  derivePath: PathEffectDerivations['derivePath'];\n  derivePose: PathEffectDerivations['derivePose'];\n} {\n  return {\n    kind: 'leaf',\n    layer,\n    pose: { x: 0, y: 0, width: 0, height: 0 },\n    data: { pathEffect: effect },\n    dependsOn: [...sources],\n    derivePath: derivations.derivePath,\n    derivePose: derivations.derivePose,\n  };\n}\n\n/** The path-effect derivations `registry` holds under {@link PATH_EFFECT},\n *  or `null` when it holds none. */\nexport function registeredPathEffects(registry: {\n  derivePath?: Readonly<Record<string, unknown>>;\n  derivePose?: Readonly<Record<string, unknown>>;\n}): PathEffectDerivations | null {\n  const derivePath = registry.derivePath?.[PATH_EFFECT];\n  const derivePose = registry.derivePose?.[PATH_EFFECT];\n  return typeof derivePath === 'function' && typeof derivePose === 'function'\n    ? { derivePath, derivePose } as PathEffectDerivations\n    : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,IAAa,cAAc;;AAG3B,SAAgB,aAAa,MAAyD;CACpF,MAAM,UAAU,MAAM,KAAA,EAAyD;CAC/E,OAAO,UAAU,OAAO,WAAW,YAAY,OAAO,OAAO,SAAS,WAAW,SAAS;AAC5F;;AAqBA,SAAgB,4BAA4B,MAAiD;;;;;CAK3F,MAAM,0BAAU,IAAI,QAAyB;CAC7C,MAAM,UAAU,MAA0B,SAAgE;EACxG,MAAM,OAAO,QAAQ,IAAI,IAAI;EAC7B,IAAI,SAAS,UAAa,QAAQ,MAAM,MAAM,IAAI,GAAG,OAAO;EAC5D,MAAM,SAAS,aAAa,IAAI;EAChC,MAAM,QAAQ,WAAW,OACrB,OACA,YAAY,QAAQ,KAAK,KAAK,MAAO,MAAM,SAAY,OAAO,KAAK,CAAC,CAAE,CAAC;EAC3E,MAAM,SAAkB;GACtB,MAAM,KAAK;GACX,OAAO,KAAK,KAAK,MAAM,GAAG,IAAI;GAC9B,SAAS,KAAK,KAAK,MAAM,GAAG,KAAK,IAAI;GACrC,OAAO,KAAK,KAAK,MAAO,MAAM,SAAY,SAAY,aAAa,EAAE,IAAI,CAAE;GAC3E,OAAO,KAAK,KAAK,MAAM,GAAG,QAAQ,IAAI;GACtC,MAAM,UAAU,OAAO,OAAO,cAAc,KAAK;EACnD;EACA,QAAQ,IAAI,MAAM,MAAM;EACxB,OAAO;CACT;CACA,OAAO;EACL,aAAa,MAAM,SAAS,OAAO,MAAM,IAAI,CAAC,CAAC;EAC/C,aAAa,MAAM,SAAS;GAC1B,MAAM,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC;GAChC,IAAI,SAAS,MAAM,OAAO;GAC1B,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW,aAAa,IAAI;GACjD,OAAO;IAAE;IAAG;IAAG;IAAO;GAAO;EAC/B;CACF;AACF;AAEA,SAAS,QAAQ,MAAe,MAA0B,MAA6D;CACrH,IAAI,KAAK,SAAS,KAAK,QAAQ,KAAK,MAAM,WAAW,KAAK,QAAQ,OAAO;CACzE,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,IAAI,KAAK;EACf,IAAI,KAAK,MAAM,OAAO,GAAG,MAAM,OAAO;EACtC,IAAI,MAAM,QAAW;EACrB,IAAI,KAAK,QAAQ,OAAO,EAAE,KAAK,QAAQ,CAAC,cAAc,KAAK,MAAM,IAAI,EAAE,IAAI,GAAG,OAAO;EACrF,IAAI,KAAK,MAAM,OAAO,EAAE,MAAM,OAAO;CACvC;CACA,OAAO;AACT;;;AAIA,SAAgB,gBACd,MACA,MAC+B;CAC/B,IAAI,OAAO,KAAK,eAAe,YAAY,OAAO;CAClD,OAAO,eAAgB,KAAK,WAAmD,MAAM,IAAI,CAAC,KAAK;AACjG;;;;AAKA,SAAgB,eACd,QACA,SACA,OACA,aASA;CACA,OAAO;EACL,MAAM;EACN;EACA,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,OAAO;GAAG,QAAQ;EAAE;EACxC,MAAM,EAAE,YAAY,OAAO;EAC3B,WAAW,CAAC,GAAG,OAAO;EACtB,YAAY,YAAY;EACxB,YAAY,YAAY;CAC1B;AACF;;;AAIA,SAAgB,sBAAsB,UAGL;CAC/B,MAAM,aAAa,SAAS,aAAa;CACzC,MAAM,aAAa,SAAS,aAAa;CACzC,OAAO,OAAO,eAAe,cAAc,OAAO,eAAe,aAC7D;EAAE;EAAY;CAAW,IACzB;AACN"}
+{"version":3,"file":"derive.js","names":[],"sources":["../../../../src/core/scene/pathEffects/derive.ts"],"sourcesContent":["/**\n * A path effect as a scene node: a leaf whose `dependsOn` names its sources,\n * whose `data.pathEffect` says what to make of them, and whose path and pose\n * are both derived — the path to paint and pick, the pose as that path's\n * bounds, so selection chrome and marquee see where it is.\n *\n * Reading a source's outline and paint is its painter's business, which sits\n * above the scene, so the derivations are made from a reader:\n * `createPathEffectDerivations(read)`. The canvas layer makes the kit's, and\n * a scene that holds path effects registers them under {@link PATH_EFFECT}.\n */\nimport { boundsOfPath, type Path } from '@weasel-js/geom';\nimport { derivedPartsOf, pathFromParts, type DerivedPart } from '../derivedParts';\nimport { fontGeneration, noteFontRead, withFontReads } from '../fontReads';\nimport { samePoseValue, snapshotPose } from '../poseSnapshot';\nimport type { DerivedDep, NodeId } from '../types';\nimport { effectParts, type PathEffect } from './effects';\nimport type { EffectSourceReader } from './source';\n\n/** The registry key both derivations go by, for `derivePath` and `derivePose`. */\nexport const PATH_EFFECT = 'kit:pathEffect';\n\n/** A node's path effect, or `null` when its data holds none. */\nexport function pathEffectOf(node: { data?: unknown } | undefined): PathEffect | null {\n  const effect = (node?.data as { pathEffect?: PathEffect } | null | undefined)?.pathEffect;\n  return effect && typeof effect === 'object' && typeof effect.kind === 'string' ? effect : null;\n}\n\n/** A path-effect node's two derivations. */\nexport interface PathEffectDerivations {\n  /** What it paints and picks by. */\n  derivePath(node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): Path | null;\n  /** The bounds of what it paints, or `null` — its authored pose — while it\n   *  paints nothing. */\n  derivePose(node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): { x: number; y: number; width: number; height: number } | null;\n}\n\ninterface Derived {\n  data: unknown;\n  nodes: unknown[];\n  depData: unknown[];\n  poses: unknown[];\n  paths: (Path | null)[];\n  path: Path | null;\n  /** The face generation it was worked out under, or `null` when it read no\n   *  glyph outlines. */\n  faces: number | null;\n}\n\n/** The derivations of a path effect whose sources `read` reads. */\nexport function createPathEffectDerivations(read: EffectSourceReader): PathEffectDerivations {\n  /** One result per effect node, shared by its two derivations: the pose is\n   *  the path's bounds, and working the effect out twice a frame would double\n   *  its cost. Checked against everything it read, by value for poses — a\n   *  drag's override mutates its pose in place. */\n  const results = new WeakMap<object, Derived>();\n  const derive = (node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): Derived => {\n    const held = results.get(node);\n    if (held !== undefined && current(held, node, deps)) return held;\n    const effect = pathEffectOf(node);\n    const generation = fontGeneration();\n    const { value: parts, fonts } = withFontReads(() => (effect === null\n      ? null\n      : effectParts(effect, deps.map((d) => (d === undefined ? null : read(d))))));\n    const result: Derived = {\n      data: node.data,\n      nodes: deps.map((d) => d?.node),\n      depData: deps.map((d) => d?.node.data),\n      poses: deps.map((d) => (d === undefined ? undefined : snapshotPose(d.pose))),\n      paths: deps.map((d) => d?.path ?? null),\n      path: parts === null ? null : pathFromParts(parts),\n      faces: fonts ? generation : null,\n    };\n    results.set(node, result);\n    return result;\n  };\n  return {\n    derivePath: (node, deps) => derive(node, deps).path,\n    derivePose: (node, deps) => {\n      const path = derive(node, deps).path;\n      if (path === null) return null;\n      const { x, y, width, height } = boundsOfPath(path);\n      return { x, y, width, height };\n    },\n  };\n}\n\nfunction current(held: Derived, node: { data?: unknown }, deps: readonly (DerivedDep<unknown> | undefined)[]): boolean {\n  if (held.data !== node.data || held.nodes.length !== deps.length) return false;\n  if (held.faces !== null && held.faces !== fontGeneration()) return false;\n  for (let i = 0; i < deps.length; i++) {\n    const d = deps[i];\n    if (held.nodes[i] !== d?.node) return false;\n    if (d === undefined) continue;\n    if (held.depData[i] !== d.node.data || !samePoseValue(held.poses[i], d.pose)) return false;\n    if (held.paths[i] !== d.path) return false;\n  }\n  // A hit is still a read, for the scene memo enclosing this one.\n  if (held.faces !== null) noteFontRead();\n  return true;\n}\n\n/** The parts a path-effect node paints, as its sources stand, or `null` when\n *  it has no derivation or nothing to paint. */\nexport function pathEffectParts(\n  node: { data?: unknown; derivePath?: unknown },\n  deps: readonly (DerivedDep<unknown> | undefined)[],\n): readonly DerivedPart[] | null {\n  if (typeof node.derivePath !== 'function') return null;\n  return derivedPartsOf((node.derivePath as PathEffectDerivations['derivePath'])(node, deps)) ?? null;\n}\n\n/** What to hand `Scene.add` (or an insert op) for a path-effect node over\n *  `sources`, in the order its kind reads them, deriving through\n *  `derivations` — the ones the scene registers under {@link PATH_EFFECT}. */\nexport function pathEffectNode<TLayer extends string>(\n  effect: PathEffect,\n  sources: readonly NodeId[],\n  layer: TLayer,\n  derivations: PathEffectDerivations,\n): {\n  kind: 'leaf';\n  layer: TLayer;\n  pose: { x: number; y: number; width: number; height: number };\n  data: { pathEffect: PathEffect };\n  dependsOn: readonly NodeId[];\n  derivePath: PathEffectDerivations['derivePath'];\n  derivePose: PathEffectDerivations['derivePose'];\n} {\n  return {\n    kind: 'leaf',\n    layer,\n    pose: { x: 0, y: 0, width: 0, height: 0 },\n    data: { pathEffect: effect },\n    dependsOn: [...sources],\n    derivePath: derivations.derivePath,\n    derivePose: derivations.derivePose,\n  };\n}\n\n/** The path-effect derivations `registry` holds under {@link PATH_EFFECT},\n *  or `null` when it holds none. */\nexport function registeredPathEffects(registry: {\n  derivePath?: Readonly<Record<string, unknown>>;\n  derivePose?: Readonly<Record<string, unknown>>;\n}): PathEffectDerivations | null {\n  const derivePath = registry.derivePath?.[PATH_EFFECT];\n  const derivePose = registry.derivePose?.[PATH_EFFECT];\n  return typeof derivePath === 'function' && typeof derivePose === 'function'\n    ? { derivePath, derivePose } as PathEffectDerivations\n    : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,IAAa,cAAc;;AAG3B,SAAgB,aAAa,MAAyD;CACpF,MAAM,UAAU,MAAM,KAAA,EAAyD;CAC/E,OAAO,UAAU,OAAO,WAAW,YAAY,OAAO,OAAO,SAAS,WAAW,SAAS;AAC5F;;AAwBA,SAAgB,4BAA4B,MAAiD;;;;;CAK3F,MAAM,0BAAU,IAAI,QAAyB;CAC7C,MAAM,UAAU,MAA0B,SAAgE;EACxG,MAAM,OAAO,QAAQ,IAAI,IAAI;EAC7B,IAAI,SAAS,UAAa,QAAQ,MAAM,MAAM,IAAI,GAAG,OAAO;EAC5D,MAAM,SAAS,aAAa,IAAI;EAChC,MAAM,aAAa,eAAe;EAClC,MAAM,EAAE,OAAO,OAAO,UAAU,oBAAqB,WAAW,OAC5D,OACA,YAAY,QAAQ,KAAK,KAAK,MAAO,MAAM,SAAY,OAAO,KAAK,CAAC,CAAE,CAAC,CAAE;EAC7E,MAAM,SAAkB;GACtB,MAAM,KAAK;GACX,OAAO,KAAK,KAAK,MAAM,GAAG,IAAI;GAC9B,SAAS,KAAK,KAAK,MAAM,GAAG,KAAK,IAAI;GACrC,OAAO,KAAK,KAAK,MAAO,MAAM,SAAY,SAAY,aAAa,EAAE,IAAI,CAAE;GAC3E,OAAO,KAAK,KAAK,MAAM,GAAG,QAAQ,IAAI;GACtC,MAAM,UAAU,OAAO,OAAO,cAAc,KAAK;GACjD,OAAO,QAAQ,aAAa;EAC9B;EACA,QAAQ,IAAI,MAAM,MAAM;EACxB,OAAO;CACT;CACA,OAAO;EACL,aAAa,MAAM,SAAS,OAAO,MAAM,IAAI,CAAC,CAAC;EAC/C,aAAa,MAAM,SAAS;GAC1B,MAAM,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC;GAChC,IAAI,SAAS,MAAM,OAAO;GAC1B,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW,aAAa,IAAI;GACjD,OAAO;IAAE;IAAG;IAAG;IAAO;GAAO;EAC/B;CACF;AACF;AAEA,SAAS,QAAQ,MAAe,MAA0B,MAA6D;CACrH,IAAI,KAAK,SAAS,KAAK,QAAQ,KAAK,MAAM,WAAW,KAAK,QAAQ,OAAO;CACzE,IAAI,KAAK,UAAU,QAAQ,KAAK,UAAU,eAAe,GAAG,OAAO;CACnE,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,IAAI,KAAK;EACf,IAAI,KAAK,MAAM,OAAO,GAAG,MAAM,OAAO;EACtC,IAAI,MAAM,QAAW;EACrB,IAAI,KAAK,QAAQ,OAAO,EAAE,KAAK,QAAQ,CAAC,cAAc,KAAK,MAAM,IAAI,EAAE,IAAI,GAAG,OAAO;EACrF,IAAI,KAAK,MAAM,OAAO,EAAE,MAAM,OAAO;CACvC;CAEA,IAAI,KAAK,UAAU,MAAM,aAAa;CACtC,OAAO;AACT;;;AAIA,SAAgB,gBACd,MACA,MAC+B;CAC/B,IAAI,OAAO,KAAK,eAAe,YAAY,OAAO;CAClD,OAAO,eAAgB,KAAK,WAAmD,MAAM,IAAI,CAAC,KAAK;AACjG;;;;AAKA,SAAgB,eACd,QACA,SACA,OACA,aASA;CACA,OAAO;EACL,MAAM;EACN;EACA,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG,OAAO;GAAG,QAAQ;EAAE;EACxC,MAAM,EAAE,YAAY,OAAO;EAC3B,WAAW,CAAC,GAAG,OAAO;EACtB,YAAY,YAAY;EACxB,YAAY,YAAY;CAC1B;AACF;;;AAIA,SAAgB,sBAAsB,UAGL;CAC/B,MAAM,aAAa,SAAS,aAAa;CACzC,MAAM,aAAa,SAAS,aAAa;CACzC,OAAO,OAAO,eAAe,cAAc,OAAO,eAAe,aAC7D;EAAE;EAAY;CAAW,IACzB;AACN"}

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

@@ -1,11 +1,12 @@
 import { blendParts } from "./blend.js";
+import { textAlongParts, wholeItem } from "./textAlong.js";
 import { bendAlongPath, repeatAlongPath } from "@weasel-js/geom";
 
 //#region 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
-* along a path.
+* along a path, text laid along a path.
 */
 /** The parts `effect` paints from `sources`, in its sources' order, or
 *  `null` when a source it needs is missing — a blend's spine among them,
@@ -32,6 +33,7 @@ function effectParts(effect, sources) {
 			fill: a.fill,
 			stroke: a.stroke
 		}));
+		case "textAlong": return textAlongParts(effect, a.items?.() ?? [wholeItem(a)], b.world);
 	}
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"effects.js","names":[],"sources":["../../../../src/core/scene/pathEffects/effects.ts"],"sourcesContent":["/**\n * The path effects, each as the parts it paints from its sources: a blend's\n * steps between two shapes, a shape bent along a spine, copies of a shape\n * along a path.\n */\nimport {\n  bendAlongPath, repeatAlongPath, type BendAlongPathOptions, type RepeatAlongPathOptions,\n} from '@weasel-js/geom';\nimport type { DerivedPart } from '../derivedParts';\nimport { blendParts, type BlendEffect } from './blend';\nimport type { EffectSource } from './source';\n\nexport type { BlendEffect };\n\n/** A shape bent along a spine. Its sources are `[shape, spine]`. */\nexport interface BendAlongEffect extends BendAlongPathOptions {\n  kind: 'bendAlong';\n}\n\n/** Copies of a shape along a path. Its sources are `[shape, path]`. */\nexport interface RepeatAlongEffect extends Omit<RepeatAlongPathOptions, 'flattenTolerance'> {\n  kind: 'repeatAlong';\n}\n\n/** A path effect, as a node's `data.pathEffect` holds it. */\nexport type PathEffect = BlendEffect | BendAlongEffect | RepeatAlongEffect;\n\n/** The parts `effect` paints from `sources`, in its sources' order, or\n *  `null` when a source it needs is missing — a blend's spine among them,\n *  where it names one. */\nexport function effectParts(effect: PathEffect, sources: readonly (EffectSource | null)[]): DerivedPart[] | null {\n  const [a, b] = sources;\n  if (!a || !b) return null;\n  switch (effect.kind) {\n    case 'blend': {\n      if (sources.length < 3) return blendParts(effect, a, b);\n      const spine = sources[2];\n      return spine ? blendParts(effect, a, b, spine.world) : null;\n    }\n    case 'bendAlong': {\n      const path = bendAlongPath(a.world, b.world, effect);\n      return path === null ? null : [{ path, fill: a.fill, stroke: a.stroke }];\n    }\n    case 'repeatAlong':\n      return repeatAlongPath(a.world, b.world, effect).map((path) => ({ path, fill: a.fill, stroke: a.stroke }));\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAgB,YAAY,QAAoB,SAAiE;CAC/G,MAAM,CAAC,GAAG,KAAK;CACf,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,QAAQ,OAAO,MAAf;EACE,KAAK,SAAS;GACZ,IAAI,QAAQ,SAAS,GAAG,OAAO,WAAW,QAAQ,GAAG,CAAC;GACtD,MAAM,QAAQ,QAAQ;GACtB,OAAO,QAAQ,WAAW,QAAQ,GAAG,GAAG,MAAM,KAAK,IAAI;EACzD;EACA,KAAK,aAAa;GAChB,MAAM,OAAO,cAAc,EAAE,OAAO,EAAE,OAAO,MAAM;GACnD,OAAO,SAAS,OAAO,OAAO,CAAC;IAAE;IAAM,MAAM,EAAE;IAAM,QAAQ,EAAE;GAAO,CAAC;EACzE;EACA,KAAK,eACH,OAAO,gBAAgB,EAAE,OAAO,EAAE,OAAO,MAAM,CAAC,CAAC,KAAK,UAAU;GAAE;GAAM,MAAM,EAAE;GAAM,QAAQ,EAAE;EAAO,EAAE;CAC7G;AACF"}
+{"version":3,"file":"effects.js","names":[],"sources":["../../../../src/core/scene/pathEffects/effects.ts"],"sourcesContent":["/**\n * The path effects, each as the parts it paints from its sources: a blend's\n * steps between two shapes, a shape bent along a spine, copies of a shape\n * along a path, text laid along a path.\n */\nimport {\n  bendAlongPath, repeatAlongPath, type BendAlongPathOptions, type RepeatAlongPathOptions,\n} from '@weasel-js/geom';\nimport type { DerivedPart } from '../derivedParts';\nimport { blendParts, type BlendEffect } from './blend';\nimport type { EffectSource, PathEffectOptions } from './source';\nimport { textAlongParts, wholeItem, type TextAlongEffect } from './textAlong';\n\nexport type { BlendEffect, PathEffectOptions, TextAlongEffect };\n\n/** A shape bent along a spine. Its sources are `[shape, spine]`. */\nexport interface BendAlongEffect extends BendAlongPathOptions, PathEffectOptions {\n  kind: 'bendAlong';\n}\n\n/** Copies of a shape along a path. Its sources are `[shape, path]`. */\nexport interface RepeatAlongEffect extends Omit<RepeatAlongPathOptions, 'flattenTolerance'>, PathEffectOptions {\n  kind: 'repeatAlong';\n}\n\n/** A path effect, as a node's `data.pathEffect` holds it. */\nexport type PathEffect = BlendEffect | BendAlongEffect | RepeatAlongEffect | TextAlongEffect;\n\n/** The parts `effect` paints from `sources`, in its sources' order, or\n *  `null` when a source it needs is missing — a blend's spine among them,\n *  where it names one. */\nexport function effectParts(effect: PathEffect, sources: readonly (EffectSource | null)[]): DerivedPart[] | null {\n  const [a, b] = sources;\n  if (!a || !b) return null;\n  switch (effect.kind) {\n    case 'blend': {\n      if (sources.length < 3) return blendParts(effect, a, b);\n      const spine = sources[2];\n      return spine ? blendParts(effect, a, b, spine.world) : null;\n    }\n    case 'bendAlong': {\n      const path = bendAlongPath(a.world, b.world, effect);\n      return path === null ? null : [{ path, fill: a.fill, stroke: a.stroke }];\n    }\n    case 'repeatAlong':\n      return repeatAlongPath(a.world, b.world, effect).map((path) => ({ path, fill: a.fill, stroke: a.stroke }));\n    case 'textAlong':\n      return textAlongParts(effect, a.items?.() ?? [wholeItem(a)], b.world);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,SAAgB,YAAY,QAAoB,SAAiE;CAC/G,MAAM,CAAC,GAAG,KAAK;CACf,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,QAAQ,OAAO,MAAf;EACE,KAAK,SAAS;GACZ,IAAI,QAAQ,SAAS,GAAG,OAAO,WAAW,QAAQ,GAAG,CAAC;GACtD,MAAM,QAAQ,QAAQ;GACtB,OAAO,QAAQ,WAAW,QAAQ,GAAG,GAAG,MAAM,KAAK,IAAI;EACzD;EACA,KAAK,aAAa;GAChB,MAAM,OAAO,cAAc,EAAE,OAAO,EAAE,OAAO,MAAM;GACnD,OAAO,SAAS,OAAO,OAAO,CAAC;IAAE;IAAM,MAAM,EAAE;IAAM,QAAQ,EAAE;GAAO,CAAC;EACzE;EACA,KAAK,eACH,OAAO,gBAAgB,EAAE,OAAO,EAAE,OAAO,MAAM,CAAC,CAAC,KAAK,UAAU;GAAE;GAAM,MAAM,EAAE;GAAM,QAAQ,EAAE;EAAO,EAAE;EAC3G,KAAK,aACH,OAAO,eAAe,QAAQ,EAAE,QAAQ,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,KAAK;CACxE;AACF"}

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

@@ -0,0 +1,95 @@
+import { boundsOfPath, multiply, pathShape, placeAlongRun, rotate, runLength, trackRun, transformPath, translate } from "@weasel-js/geom";
+
+//#region 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.
+*/
+var LEAD = {
+	start: 0,
+	center: .5,
+	end: 1
+};
+/** The parts `items` paint laid along `path` as `effect` says; `[]` when there is nothing to lay or nowhere to lay it. */
+function textAlongParts(effect, items, path) {
+	const shape = pathShape(path);
+	if (shape === null || !(shape.length > 0) || items.length === 0) return [];
+	const L = shape.length;
+	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 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 run = trackRun(shape, 0, 1, {
+		side: effect.side ?? "auto",
+		about
+	});
+	const places = placeAlongRun(run, lengths, {
+		gap,
+		align: "center",
+		at: run.reversed ? L - c : c,
+		shift: finiteOr(effect.shift, 0),
+		wrap: closed
+	});
+	const center = effect.anchor === "center";
+	const out = [];
+	const firstStart = places[0].center - lengths[0] / 2;
+	places.forEach((place, i) => {
+		if (dropped(place, closed ? firstStart : null, L)) return;
+		const item = items[i];
+		const m = itemFrame(place, item.length, center ? item.middle : 0);
+		for (const part of item.parts) out.push({
+			...part,
+			path: transformPath(part.path, m)
+		});
+	});
+	return out;
+}
+/** `source`'s whole outline as one item: its bounds' left at x = 0 and their vertical middle on the anchor line. */
+function wholeItem(source) {
+	const b = boundsOfPath(source.world);
+	return {
+		length: b.width,
+		middle: 0,
+		parts: [{
+			path: transformPath(source.world, translate(-b.x, -(b.y + b.height / 2))),
+			fill: source.fill,
+			stroke: source.stroke
+		}]
+	};
+}
+/** 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
+*  lap or more on from the first item's start. Judged within a hair of rounding. */
+function dropped(place, firstStart, L) {
+	const hair = 1e-9 * Math.max(1, L);
+	if (firstStart !== null) return place.center - firstStart >= L - hair;
+	return place.center < -hair || place.center > L + hair;
+}
+/** How much path the text has before it runs off, from `at`, with `k` of it laid back behind `at`. */
+function roomAt(at, L, k, closed) {
+	if (closed) return L;
+	return k === 0 ? L - at : k === 1 ? at : 2 * Math.min(at, L - at);
+}
+/** The gap that makes `lengths` fill `room`, or 0 when they fit already. Never so negative that an item's step back
+*  from the one before it (its length plus the gap) goes below zero, so items keep their order in too short a room. */
+function fitGap(lengths, room) {
+	const total = runLength(lengths, 0);
+	if (!(total > room) || lengths.length < 2) return 0;
+	let floor = -Infinity;
+	for (let i = 1; i < lengths.length; i++) floor = Math.max(floor, -(lengths[i - 1] + lengths[i]) / 2);
+	return Math.max((room - total) / (lengths.length - 1), floor);
+}
+/** Item frame to world: its middle on `place`, turned to it, its anchor line `lift` above y = 0 brought onto the path. */
+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;
+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

@@ -0,0 +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';\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; underlines and other decorations are not drawn.\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 places = placeAlongRun(run, lengths, {\n    gap, align: 'center', at: run.reversed ? L - c : c, shift: finiteOr(effect.shift, 0), wrap: closed,\n  });\n  const center = effect.anchor === 'center';\n  const out: DerivedPart[] = [];\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)) return;\n    const item = items[i]!;\n    const m = itemFrame(place, item.length, center ? item.middle : 0);\n    for (const part of item.parts) out.push({ ...part, path: transformPath(part.path, m) });\n  });\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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"}

package/dist/core/scene/recorder.js

@@ -9,30 +9,35 @@ function unwind(outer) {
 	} catch {}
 }
 function createRecorder(env) {
-	const { notifier, mode, engine, log, arrivals } = env;
+	const { notifier, mode, engine, log, arrivals, passes } = env;
 	/** The outermost open batch, while it is recording. */
 	let collecting = null;
 	/** The kit ops applied since the innermost `capturing` opened. */
 	let captured = null;
-	/** `fn`, then the poses its arrivals settle to when this edit owns them. */
-	function withArrivalsSettled(fn, owns) {
+	/** `fn`, then the poses its arrivals settle to and its passes' ops, for whichever this edit owns. */
+	function withArrivalsSettled(fn, owns, ownsPasses = false) {
 		const result = fn();
 		if (owns) for (const p of arrivals.settle()) env.writePose(p.id, p.to);
+		if (ownsPasses) passes.run();
 		return result;
 	}
-	function batch(label, fn) {
+	function batch(label, fn, options = {}) {
 		const outermost = !mode.open();
 		if (outermost) collecting = {
 			label,
 			ops: [],
 			outer: [],
-			selectionBefore: env.selection()
+			entry: {
+				selectionBefore: env.selection(),
+				...options
+			}
 		};
 		const ownsArrivals = outermost && arrivals.open(true);
+		const ownsPasses = outermost && passes.open();
 		return env.labeled(label, "call", () => notifier.deferred(() => mode.during("batch", () => {
 			if (!outermost) return fn();
 			try {
-				const result = log.atomically(() => withArrivalsSettled(fn, ownsArrivals), () => (collecting?.ops.length ?? 0) > 0);
+				const result = log.atomically(() => withArrivalsSettled(fn, ownsArrivals, ownsPasses), () => (collecting?.ops.length ?? 0) > 0);
 				if (ownsArrivals) arrivals.emitReflow();
 				return result;
 			} catch (err) {
@@ -42,25 +47,29 @@ function createRecorder(env) {
 			}
 		}), () => {
 			if (ownsArrivals) arrivals.abandon();
+			if (ownsPasses) passes.abandon();
 			if (!outermost || !collecting) return;
 			const finished = collecting;
 			collecting = null;
-			if (finished.ops.length > 0) engine.recordEntry(finished.ops, finished.label, { selectionBefore: finished.selectionBefore });
+			if (finished.ops.length > 0) engine.recordEntry(finished.ops, finished.label, finished.entry);
 		}));
 	}
+	function record(kind, payload, label) {
+		if (mode.records() && !collecting && passes.any()) return void batch(label, () => record(kind, payload, label));
+		passes.note(kind, payload);
+		env.labeled(label, "call", () => {
+			if (mode.records() && !collecting) mode.during("own", () => engine.applyOps([env.makeOp(kind, payload)], label));
+			else {
+				env.runOp(kind, payload);
+				log.logApplied(kind, payload);
+				if (mode.records()) collecting.ops.push(env.makeOp(kind, payload));
+				else if (!mode.untracked()) captured?.push(env.makeOp(kind, payload));
+			}
+		});
+		notifier.notify();
+	}
 	return {
-		record(kind, payload, label) {
-			env.labeled(label, "call", () => {
-				if (mode.records() && !collecting) mode.during("own", () => engine.applyOps([env.makeOp(kind, payload)], label));
-				else {
-					env.runOp(kind, payload);
-					log.logApplied(kind, payload);
-					if (mode.records()) collecting.ops.push(env.makeOp(kind, payload));
-					else if (!mode.untracked()) captured?.push(env.makeOp(kind, payload));
-				}
-			});
-			notifier.notify();
-		},
+		record,
 		edit: (label, touchesLayout, fn) => touchesLayout && arrivals.bareLayoutEdit() ? batch(label, fn) : fn(),
 		batch,
 		untracked(fn) {

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

@@ -1 +1 @@
-{"version":3,"file":"recorder.js","names":[],"sources":["../../../src/core/scene/recorder.ts"],"sourcesContent":["/**\n * How a scene mutation becomes an undo entry: recorded on its own, collected\n * into the batch it runs in, or left to the engine or the untracked run that\n * is driving it.\n */\nimport type { History } from '@weasel-js/history';\nimport type { Op } from 'core/ops/types';\nimport type { AppliedLog } from './appliedLog';\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { bindOpToAdapter } from './boundOps';\nimport type { EditMode } from './editMode';\nimport type { Notifier } from './notifier';\nimport type { NodeId } from './types';\n\n/** What the recorder needs from the scene it records for. */\nexport interface RecorderEnv {\n  notifier: Notifier;\n  mode: EditMode;\n  /** The scene's own undo/redo engine. */\n  engine: History;\n  /** Apply a registered op's forward half. */\n  runOp(kind: string, payload: unknown): void;\n  /** A registered op as the engine holds it. */\n  makeOp(kind: string, payload: unknown): Op;\n  log: AppliedLog;\n  arrivals: Pick<ArrivalWindow<unknown>, 'bareLayoutEdit' | 'open' | 'settle' | 'emitReflow' | 'abandon'>;\n  selection(): readonly NodeId[];\n  /** Write one pose an arrival settle decided. */\n  writePose(id: string, pose: unknown): void;\n  /** Run `fn` as an edit made by a scene call labeled `label`. */\n  labeled<T>(label: string, via: 'call', fn: () => T): T;\n}\n\nexport interface Recorder {\n  /** Apply a registered op as part of whatever edit is running. */\n  record(kind: string, payload: unknown, label: string): void;\n  /** Run the recording half of a mutation. One that touches a laid-out\n   *  container, called bare, runs as a batch of its own: that is what puts\n   *  the arrangement it triggers in the same undo step. */\n  edit<T>(label: string, touchesLayout: boolean, fn: () => T): T;\n  batch<T>(label: string, fn: () => T): T;\n  untracked<T>(fn: () => T): T;\n  /** Whether an edit made now would join an open `batch`'s entry. */\n  joins(): boolean;\n  /** Apply ops built outside the scene as part of the open `batch`, all or\n   *  none. Its entry holds the kit ops they cause, and beside them, bound to\n   *  `adapter`, any op that wrote no scene state. */\n  join(ops: Op[], adapter: unknown): void;\n  /** Run `step`, and answer with the kit ops applied during it. */\n  capturing<T>(step: () => T): { result: T; ops: Op[] };\n  /** Run `fn` as a history engine's step: the ops it applies may re-enter\n   *  scene mutation methods, which apply but do not record. The caller\n   *  notifies once after. */\n  engineDriven<T>(fn: () => T): T;\n}\n\n/** Take back ops that wrote outside the scene, newest first. The scene's own\n *  writes are reverted by the applied log. */\nfunction unwind(outer: readonly Op[]): void {\n  for (let i = outer.length - 1; i >= 0; i--) {\n    try {\n      outer[i].invert().apply(undefined);\n    } catch {\n      // The throw being unwound is the one the caller sees.\n    }\n  }\n}\n\nexport function createRecorder(env: RecorderEnv): Recorder {\n  const { notifier, mode, engine, log, arrivals } = env;\n  /** The outermost open batch, while it is recording. */\n  let collecting: { label: string; ops: Op[]; outer: Op[]; selectionBefore: readonly NodeId[] } | null = null;\n  /** The kit ops applied since the innermost `capturing` opened. */\n  let captured: Op[] | null = null;\n\n  /** `fn`, then the poses its arrivals settle to when this edit owns them. */\n  function withArrivalsSettled<T>(fn: () => T, owns: boolean): T {\n    const result = fn();\n    if (owns) for (const p of arrivals.settle()) env.writePose(p.id, p.to);\n    return result;\n  }\n\n  function batch<T>(label: string, fn: () => T): T {\n    const outermost = !mode.open();\n    // Captured at open, not at recordEntry: by the time the batch closes\n    // the selection has already moved to wherever the batch put it.\n    if (outermost) collecting = { label, ops: [], outer: [], selectionBefore: env.selection() };\n    const ownsArrivals = outermost && arrivals.open(true);\n    return env.labeled(label, 'call', () => notifier.deferred(() => mode.during('batch', () => {\n      if (!outermost) return fn();\n      try {\n        const result = log.atomically(\n          () => withArrivalsSettled(fn, ownsArrivals),\n          () => (collecting?.ops.length ?? 0) > 0,\n        );\n        if (ownsArrivals) arrivals.emitReflow();\n        return result;\n      } catch (err) {\n        // Reverted already; the half-built entry must not reach history.\n        unwind(collecting?.outer ?? []);\n        collecting = null;\n        throw err;\n      }\n    }), () => {\n      if (ownsArrivals) arrivals.abandon();\n      if (!outermost || !collecting) return;\n      const finished = collecting;\n      collecting = null;\n      // The ops were applied as they were issued, so the entry is pushed\n      // without re-applying.\n      if (finished.ops.length > 0) {\n        engine.recordEntry(finished.ops, finished.label, { selectionBefore: finished.selectionBefore });\n      }\n    }));\n  }\n\n  return {\n    record(kind, payload, label) {\n      env.labeled(label, 'call', () => {\n        if (mode.records() && !collecting) {\n          // The engine applies the op itself, which is what lets it coalesce.\n          mode.during('own', () => engine.applyOps([env.makeOp(kind, payload)], label));\n        } else {\n          env.runOp(kind, payload);\n          log.logApplied(kind, payload);\n          if (mode.records()) collecting!.ops.push(env.makeOp(kind, payload));\n          else if (!mode.untracked()) captured?.push(env.makeOp(kind, payload));\n        }\n      });\n      notifier.notify();\n    },\n    edit: (label, touchesLayout, fn) => (touchesLayout && arrivals.bareLayoutEdit() ? batch(label, fn) : fn()),\n    batch,\n    untracked(fn) {\n      const versionBefore = notifier.version();\n      const ownsArrivals = arrivals.open(true);\n      return notifier.deferred(() => mode.during('untracked', () => {\n        const result = log.atomically(() => withArrivalsSettled(fn, ownsArrivals), () => false);\n        if (ownsArrivals) arrivals.emitReflow();\n        return result;\n      }), () => {\n        if (ownsArrivals) arrivals.abandon();\n        if (notifier.version() !== versionBefore) engine.seal();\n      });\n    },\n    joins: () => mode.records() && collecting !== null,\n    join(ops, adapter) {\n      const into = collecting!;\n      const mark = into.ops.length;\n      const outer: Op[] = [];\n      try {\n        log.atomically(() => {\n          for (const op of ops) {\n            const before = into.ops.length;\n            const result = op.apply(adapter);\n            if (into.ops.length > before || result === false || result === 'noop') continue;\n            outer.push(bindOpToAdapter(op, adapter));\n            into.ops.push(outer[outer.length - 1]);\n          }\n        }, () => false);\n      } catch (err) {\n        unwind(outer);\n        into.ops.length = mark;\n        throw err;\n      }\n      into.outer.push(...outer);\n    },\n    capturing(step) {\n      const enclosing = captured;\n      const ops: Op[] = [];\n      captured = ops;\n      try {\n        return { result: step(), ops };\n      } finally {\n        captured = enclosing;\n      }\n    },\n    engineDriven: (fn) => mode.during('engine', () => notifier.muted(fn)),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"recorder.js","names":[],"sources":["../../../src/core/scene/recorder.ts"],"sourcesContent":["/**\n * How a scene mutation becomes an undo entry: recorded on its own, collected\n * into the batch it runs in, or left to the engine or the untracked run that\n * is driving it.\n */\nimport type { History, RecordEntryOptions } from '@weasel-js/history';\nimport type { Op } from 'core/ops/types';\nimport type { AppliedLog } from './appliedLog';\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { bindOpToAdapter } from './boundOps';\nimport type { EditMode } from './editMode';\nimport type { EditPasses } from './editPass';\nimport type { Notifier } from './notifier';\nimport type { NodeId } from './types';\n\n/** What the recorder needs from the scene it records for. */\nexport interface RecorderEnv {\n  notifier: Notifier;\n  mode: EditMode;\n  /** The scene's own undo/redo engine. */\n  engine: History;\n  /** Apply a registered op's forward half. */\n  runOp(kind: string, payload: unknown): void;\n  /** A registered op as the engine holds it. */\n  makeOp(kind: string, payload: unknown): Op;\n  log: AppliedLog;\n  arrivals: Pick<ArrivalWindow<unknown>, 'bareLayoutEdit' | 'open' | 'settle' | 'emitReflow' | 'abandon'>;\n  passes: Pick<EditPasses, 'any' | 'open' | 'note' | 'run' | 'abandon'>;\n  selection(): readonly NodeId[];\n  /** Write one pose an arrival settle decided. */\n  writePose(id: string, pose: unknown): void;\n  /** Run `fn` as an edit made by a scene call labeled `label`. */\n  labeled<T>(label: string, via: 'call', fn: () => T): T;\n}\n\n/** Options for `scene.batch`. */\nexport interface SceneBatchOptions {\n  /** Fold this batch's entry into the one before it when that one carries the same key and\n   *  nothing came between: one undo entry for a run of batches, such as a color dragged. */\n  coalesceKey?: string;\n}\n\nexport interface Recorder {\n  /** Apply a registered op as part of whatever edit is running. */\n  record(kind: string, payload: unknown, label: string): void;\n  /** Run the recording half of a mutation. One that touches a laid-out\n   *  container, called bare, runs as a batch of its own: that is what puts\n   *  the arrangement it triggers in the same undo step. */\n  edit<T>(label: string, touchesLayout: boolean, fn: () => T): T;\n  batch<T>(label: string, fn: () => T, options?: SceneBatchOptions): T;\n  untracked<T>(fn: () => T): T;\n  /** Whether an edit made now would join an open `batch`'s entry. */\n  joins(): boolean;\n  /** Apply ops built outside the scene as part of the open `batch`, all or\n   *  none. Its entry holds the kit ops they cause, and beside them, bound to\n   *  `adapter`, any op that wrote no scene state. */\n  join(ops: Op[], adapter: unknown): void;\n  /** Run `step`, and answer with the kit ops applied during it. */\n  capturing<T>(step: () => T): { result: T; ops: Op[] };\n  /** Run `fn` as a history engine's step: the ops it applies may re-enter\n   *  scene mutation methods, which apply but do not record. The caller\n   *  notifies once after. */\n  engineDriven<T>(fn: () => T): T;\n}\n\n/** Take back ops that wrote outside the scene, newest first. The scene's own\n *  writes are reverted by the applied log. */\nfunction unwind(outer: readonly Op[]): void {\n  for (let i = outer.length - 1; i >= 0; i--) {\n    try {\n      outer[i].invert().apply(undefined);\n    } catch {\n      // The throw being unwound is the one the caller sees.\n    }\n  }\n}\n\nexport function createRecorder(env: RecorderEnv): Recorder {\n  const { notifier, mode, engine, log, arrivals, passes } = env;\n  /** The outermost open batch, while it is recording. */\n  let collecting: { label: string; ops: Op[]; outer: Op[]; entry: RecordEntryOptions } | null = null;\n  /** The kit ops applied since the innermost `capturing` opened. */\n  let captured: Op[] | null = null;\n\n  /** `fn`, then the poses its arrivals settle to and its passes' ops, for whichever this edit owns. */\n  function withArrivalsSettled<T>(fn: () => T, owns: boolean, ownsPasses = false): T {\n    const result = fn();\n    if (owns) for (const p of arrivals.settle()) env.writePose(p.id, p.to);\n    if (ownsPasses) passes.run();\n    return result;\n  }\n\n  function batch<T>(label: string, fn: () => T, options: SceneBatchOptions = {}): T {\n    const outermost = !mode.open();\n    // Captured at open, not at recordEntry: by the time the batch closes\n    // the selection has already moved to wherever the batch put it.\n    if (outermost) collecting = { label, ops: [], outer: [], entry: { selectionBefore: env.selection(), ...options } };\n    const ownsArrivals = outermost && arrivals.open(true);\n    const ownsPasses = outermost && passes.open();\n    return env.labeled(label, 'call', () => notifier.deferred(() => mode.during('batch', () => {\n      if (!outermost) return fn();\n      try {\n        const result = log.atomically(\n          () => withArrivalsSettled(fn, ownsArrivals, ownsPasses),\n          () => (collecting?.ops.length ?? 0) > 0,\n        );\n        if (ownsArrivals) arrivals.emitReflow();\n        return result;\n      } catch (err) {\n        // Reverted already; the half-built entry must not reach history.\n        unwind(collecting?.outer ?? []);\n        collecting = null;\n        throw err;\n      }\n    }), () => {\n      if (ownsArrivals) arrivals.abandon();\n      if (ownsPasses) passes.abandon();\n      if (!outermost || !collecting) return;\n      const finished = collecting;\n      collecting = null;\n      // The ops were applied as they were issued, so the entry is pushed\n      // without re-applying.\n      if (finished.ops.length > 0) {\n        engine.recordEntry(finished.ops, finished.label, finished.entry);\n      }\n    }));\n  }\n\n  function record(kind: string, payload: unknown, label: string): void {\n    // While passes listen, a bare edit is a batch of its own, so their ops land in its entry.\n    if (mode.records() && !collecting && passes.any()) return void batch(label, () => record(kind, payload, label));\n    passes.note(kind, payload);\n    env.labeled(label, 'call', () => {\n      if (mode.records() && !collecting) {\n        // The engine applies the op itself, which is what lets it coalesce.\n        mode.during('own', () => engine.applyOps([env.makeOp(kind, payload)], label));\n      } else {\n        env.runOp(kind, payload);\n        log.logApplied(kind, payload);\n        if (mode.records()) collecting!.ops.push(env.makeOp(kind, payload));\n        else if (!mode.untracked()) captured?.push(env.makeOp(kind, payload));\n      }\n    });\n    notifier.notify();\n  }\n\n  return {\n    record,\n    edit: (label, touchesLayout, fn) => (touchesLayout && arrivals.bareLayoutEdit() ? batch(label, fn) : fn()),\n    batch,\n    untracked(fn) {\n      const versionBefore = notifier.version();\n      const ownsArrivals = arrivals.open(true);\n      return notifier.deferred(() => mode.during('untracked', () => {\n        const result = log.atomically(() => withArrivalsSettled(fn, ownsArrivals), () => false);\n        if (ownsArrivals) arrivals.emitReflow();\n        return result;\n      }), () => {\n        if (ownsArrivals) arrivals.abandon();\n        if (notifier.version() !== versionBefore) engine.seal();\n      });\n    },\n    joins: () => mode.records() && collecting !== null,\n    join(ops, adapter) {\n      const into = collecting!;\n      const mark = into.ops.length;\n      const outer: Op[] = [];\n      try {\n        log.atomically(() => {\n          for (const op of ops) {\n            const before = into.ops.length;\n            const result = op.apply(adapter);\n            if (into.ops.length > before || result === false || result === 'noop') continue;\n            outer.push(bindOpToAdapter(op, adapter));\n            into.ops.push(outer[outer.length - 1]);\n          }\n        }, () => false);\n      } catch (err) {\n        unwind(outer);\n        into.ops.length = mark;\n        throw err;\n      }\n      into.outer.push(...outer);\n    },\n    capturing(step) {\n      const enclosing = captured;\n      const ops: Op[] = [];\n      captured = ops;\n      try {\n        return { result: step(), ops };\n      } finally {\n        captured = enclosing;\n      }\n    },\n    engineDriven: (fn) => mode.during('engine', () => notifier.muted(fn)),\n  };\n}\n"],"mappings":"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"}

package/dist/core/scene/scene.js

@@ -1,10 +1,12 @@
 import { IDENTITY_POSE_COMPOSITION } from "./composeFrame.js";
 import { effectivePose } from "./effectivePose.js";
 import { asNodeId } from "./types.js";
+import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { withKitRegistry } from "./kitRegistry.js";
 import { createPoseOverrides } from "./poseOverrides.js";
 import { createArrivalWindow } from "./arrivalWindow.js";
 import { createNotifier } from "./notifier.js";
+import { sceneChanges } from "./sceneChanges.js";
 import { createPoseWriteLog } from "./poseWrites.js";
 import { createEditMode } from "./editMode.js";
 import { resolveLayoutFrame, runLayoutPass } from "./layoutPass.js";
@@ -30,14 +32,15 @@ var defaultGenerateId = () => asNodeId(`n${(defaultIdCounter++).toString(36)}-${
 *  this in tests, in headless rendering, or wherever a scene must outlive a
 *  component. Throws if no system layers are declared. */
 function createScene(options) {
-	return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial);
+	return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);
 }
-/** A scene holding `layers`, and the nodes `initialNodes` answers with once
-*  it is handed the registry their functions resolve against. */
-function buildScene(options, layers, initialNodes) {
+/** A scene holding `layers`, the document values `initialDoc`, and the nodes
+*  `initialNodes` answers with once it is handed the registry their functions
+*  resolve against. */
+function buildScene(options, layers, initialNodes, initialDoc) {
 	if (layers.length === 0) throw new Error("Scene: systemLayers must declare at least one layer");
 	const registry = withKitRegistry(options.registry ?? {});
-	const doc = createSceneState(registry, layers, () => arrivals.layoutDeclared());
+	const doc = createSceneState(registry, layers, () => arrivals.layoutDeclared(), initialDoc);
 	const { state, locks, reads } = doc;
 	const notifier = createNotifier();
 	const mode = createEditMode();
@@ -63,6 +66,10 @@ function buildScene(options, layers, initialNodes) {
 	const recording = createSceneRecording({
 		notifier,
 		mode,
+		passAdapter: () => ({
+			...sceneMutators(scene),
+			...documentReads(scene)
+		}),
 		stale: doc.stale,
 		lifted: locks.lifted,
 		selection,
@@ -117,14 +124,13 @@ function buildScene(options, layers, initialNodes) {
 			const specs = specsFromSerialized(json, registry);
 			if (mode.open()) throw new Error("Scene: cannot loadState inside another edit — it replaces the state that edit would revert to");
 			overrides.clearAll();
-			doc.reset(json.systemLayers.map(layerFromSerialized));
+			doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);
 			recording.clearHistory();
 			poseWrites.quiet(() => edits.construct(specs));
 			selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));
 			notifier.notify();
 		},
-		subscribe: notifier.subscribe,
-		getVersion: notifier.version
+		...sceneChanges(notifier, selection)
 	};
 	const initial = initialNodes(registry);
 	if (initial) {
@@ -139,7 +145,7 @@ function buildScene(options, layers, initialNodes) {
 *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).
 *  The scene starts with empty history. */
 function sceneFromJSON(json, options = {}) {
-	return buildScene(options, json.systemLayers.map(layerFromSerialized), (registry) => specsFromSerialized(json, registry));
+	return buildScene(options, json.systemLayers.map(layerFromSerialized), (registry) => specsFromSerialized(json, registry), json.doc);
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { createNotifier } from './notifier';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport { IDENTITY_POSE_COMPOSITION, type PoseComposition } from './composeFrame';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SerializedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<UseSceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial'>;\n\n/** A scene holding `layers`, and the nodes `initialNodes` answers with once\n *  it is handed the registry their functions resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot\n  // carrying a kit-attached function (a grouped container's derived pose)\n  // reloads in any scene, not only one whose consumer registered the key.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared());\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void =>\n    poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = options.generateId ?? defaultGenerateId;\n  const selection = createSceneSelection(locks.reachable);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral per-node overrides. Deliberately not part of `state`: not\n   *  document content, never reaches `toJSON`, and never touches history. */\n  const overrides = createPoseOverrides<TPose>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (IDENTITY_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json) {\n      // Validate + map up front (throws before we touch live state on a bad\n      // version or unknown registry key).\n      const specs = specsFromSerialized(json, registry);\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized));\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    subscribe: notifier.subscribe,\n    getVersion: notifier.version,\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SerializedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: UseSceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: UseSceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { documentReads, sceneMutators } from './sceneMutators';\nimport { createNotifier } from './notifier';\nimport type { SerializedDoc } from './docValues';\nimport { sceneChanges } from './sceneChanges';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport { IDENTITY_POSE_COMPOSITION, type PoseComposition } from './composeFrame';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SerializedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<UseSceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial' | 'doc'>;\n\n/** A scene holding `layers`, the document values `initialDoc`, and the nodes\n *  `initialNodes` answers with once it is handed the registry their functions\n *  resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n  initialDoc: SerializedDoc | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot\n  // carrying a kit-attached function (a grouped container's derived pose)\n  // reloads in any scene, not only one whose consumer registered the key.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared(), initialDoc);\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void => poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = options.generateId ?? defaultGenerateId;\n  const selection = createSceneSelection(locks.reachable);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral per-node overrides. Deliberately not part of `state`: not\n   *  document content, never reaches `toJSON`, and never touches history. */\n  const overrides = createPoseOverrides<TPose>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    passAdapter: () => ({ ...sceneMutators(scene), ...documentReads(scene) }),\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (IDENTITY_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json) {\n      // Validate + map up front (throws before we touch live state on a bad\n      // version or unknown registry key).\n      const specs = specsFromSerialized(json, registry);\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    ...sceneChanges(notifier, selection),\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SerializedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: UseSceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: UseSceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry),\n    json.doc,\n  );\n}\n"],"mappings":"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"}

package/dist/core/scene/sceneChanges.js

@@ -0,0 +1,13 @@
+//#region src/core/scene/sceneChanges.ts
+/** A scene's change members, over its notifier and its selection's own count of changes. */
+function sceneChanges(notifier, selection) {
+	return {
+		subscribe: notifier.subscribe,
+		getVersion: notifier.version,
+		getContentVersion: () => notifier.version() - selection.changes()
+	};
+}
+
+//#endregion
+export { sceneChanges };
+//# sourceMappingURL=sceneChanges.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sceneChanges.js","names":[],"sources":["../../../src/core/scene/sceneChanges.ts"],"sourcesContent":["/** How a scene tells its readers it changed. */\nimport type { Notifier } from './notifier';\n\nexport interface SceneChanges {\n  /** Hear every change, a change of selection included. Returns the unsubscribe. */\n  subscribe(listener: () => void): () => void;\n  /** Monotonically increasing version. Snapshot for `useSyncExternalStore`. */\n  getVersion(): number;\n  /** {@link SceneChanges.getVersion} less the changes that only moved the selection: unmoved\n   *  across a notice that changed nothing else. */\n  getContentVersion(): number;\n}\n\n/** A scene's change members, over its notifier and its selection's own count of changes. */\nexport function sceneChanges(notifier: Notifier, selection: { changes(): number }): SceneChanges {\n  return {\n    subscribe: notifier.subscribe,\n    getVersion: notifier.version,\n    getContentVersion: () => notifier.version() - selection.changes(),\n  };\n}\n"],"mappings":";;AAcA,SAAgB,aAAa,UAAoB,WAAgD;CAC/F,OAAO;EACL,WAAW,SAAS;EACpB,YAAY,SAAS;EACrB,yBAAyB,SAAS,QAAQ,IAAI,UAAU,QAAQ;CAClE;AACF"}

package/dist/core/scene/sceneEdits.js

@@ -1,3 +1,4 @@
+import { createSceneDoc } from "./docValues.js";
 import { createFieldEdits } from "./fieldEdits.js";
 import { registerKitOps } from "./kitOps.js";
 import { createNodeFlags } from "./nodeFlags.js";
@@ -55,13 +56,19 @@ function createSceneEdits(env) {
 		record: recorder.record,
 		narrowSelection: () => env.narrowSelection()
 	});
+	const doc = createSceneDoc({
+		values: state.docValues,
+		register: env.ops.register,
+		record: recorder.record
+	});
 	return {
 		construct,
 		methods: {
 			...treeEdits,
 			...fieldEdits,
 			...layerEdits,
-			...flagEdits
+			...flagEdits,
+			doc
 		}
 	};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"sceneEdits.js","names":[],"sources":["../../../src/core/scene/sceneEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its document — tree, node fields, and layers — with\n * the kit ops they record.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { createFieldEdits, type FieldEdits } from './fieldEdits';\nimport { registerKitOps } from './kitOps';\nimport { createNodeFlags } from './nodeFlags';\nimport { createLayerEdits, type LayerEdits, type createLayerStack } from './layerStack';\nimport type { ResolvedLayoutFrame } from './layoutPass';\nimport type { LockGuard } from './lockGuard';\nimport type { NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { OpTable } from './opTable';\nimport type { Recorder } from './recorder';\nimport { createTreeEdits, type TreeEdits } from './treeEdits';\nimport type { LayerRecord, Node, NodeId } from './types';\n\nexport interface SceneEditsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n    layerIndex: Map<TLayer, number>;\n  };\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<\n    ReturnType<typeof createLayerStack<TLayer>>,\n    'requireLayerIndex' | 'rebuildLayerIndex' | 'assertSubtreeLayer'\n  >;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  ops: Pick<OpTable, 'register' | 'run'>;\n  recorder: Pick<Recorder, 'record' | 'edit' | 'batch'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange' | 'layoutDeclared'>;\n  layoutFrame: ResolvedLayoutFrame<TPose>;\n  generateId(): NodeId;\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  clearOverride(id: NodeId): void;\n}\n\nexport interface SceneEdits<TData, TLayer extends string, TPose> {\n  construct: TreeEdits<TData, TLayer, TPose>['construct'];\n  methods: Omit<TreeEdits<TData, TLayer, TPose>, 'construct'>\n    & FieldEdits<TData, TLayer, TPose>\n    & LayerEdits<TData, TLayer, TPose>\n    & ReturnType<typeof createNodeFlags<TData, TLayer, TPose>>;\n}\n\nexport function createSceneEdits<TData, TLayer extends string, TPose>(\n  env: SceneEditsEnv<TData, TLayer, TPose>,\n): SceneEdits<TData, TLayer, TPose> {\n  const { state, store, locks, layers, fnFields, recorder, arrivals } = env;\n\n  const { layoutRefs } = registerKitOps<TData, TLayer, TPose>({\n    state,\n    register: env.ops.register,\n    store,\n    requireLayerIndex: layers.requireLayerIndex,\n    rebuildLayerIndex: layers.rebuildLayerIndex,\n    invalidateOrder: env.invalidateOrder,\n    fnFields,\n    narrowSelection: env.narrowSelection,\n    clearOverride: env.clearOverride,\n  });\n\n  const { construct, ...treeEdits } = createTreeEdits<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    generateId: env.generateId,\n    store,\n    locks,\n    layers,\n    fnFields,\n    runOp: env.ops.run,\n    recorder,\n    arrivals,\n  });\n\n  const fieldEdits = createFieldEdits<TData, TLayer, TPose>({\n    store,\n    locks,\n    layers,\n    recorder,\n    arrivals,\n    layoutFrame: env.layoutFrame,\n    layoutField: fnFields.find((f) => f.spec.field === 'layout')!,\n    layoutRefs,\n  });\n\n  const layerEdits = createLayerEdits<TData, TLayer, TPose>({\n    layers: state.layers,\n    layerIndex: state.layerIndex,\n    nodes: state.nodes,\n    requireLayerIndex: layers.requireLayerIndex,\n    record: recorder.record,\n    lifted: locks.lifted,\n    batch: recorder.batch,\n    removeMany: treeEdits.removeMany,\n  });\n\n  const flagEdits = createNodeFlags<TData, TLayer, TPose>({\n    register: env.ops.register,\n    requireNode: store.requireNode,\n    record: recorder.record,\n    narrowSelection: () => env.narrowSelection(),\n  });\n\n  return { construct, methods: { ...treeEdits, ...fieldEdits, ...layerEdits, ...flagEdits } };\n}\n"],"mappings":";;;;;;;AAiDA,SAAgB,iBACd,KACkC;CAClC,MAAM,EAAE,OAAO,OAAO,OAAO,QAAQ,UAAU,UAAU,aAAa;CAEtE,MAAM,EAAE,eAAe,eAAqC;EAC1D;EACA,UAAU,IAAI,IAAI;EAClB;EACA,mBAAmB,OAAO;EAC1B,mBAAmB,OAAO;EAC1B,iBAAiB,IAAI;EACrB;EACA,iBAAiB,IAAI;EACrB,eAAe,IAAI;CACrB,CAAC;CAED,MAAM,EAAE,WAAW,GAAG,cAAc,gBAAsC;EACxE,OAAO,MAAM;EACb,YAAY,IAAI;EAChB;EACA;EACA;EACA;EACA,OAAO,IAAI,IAAI;EACf;EACA;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD;EACA;EACA;EACA;EACA;EACA,aAAa,IAAI;EACjB,aAAa,SAAS,MAAM,MAAM,EAAE,KAAK,UAAU,QAAQ;EAC3D;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO,MAAM;EACb,mBAAmB,OAAO;EAC1B,QAAQ,SAAS;EACjB,QAAQ,MAAM;EACd,OAAO,SAAS;EAChB,YAAY,UAAU;CACxB,CAAC;CAED,MAAM,YAAY,gBAAsC;EACtD,UAAU,IAAI,IAAI;EAClB,aAAa,MAAM;EACnB,QAAQ,SAAS;EACjB,uBAAuB,IAAI,gBAAgB;CAC7C,CAAC;CAED,OAAO;EAAE;EAAW,SAAS;GAAE,GAAG;GAAW,GAAG;GAAY,GAAG;GAAY,GAAG;EAAU;CAAE;AAC5F"}
+{"version":3,"file":"sceneEdits.js","names":[],"sources":["../../../src/core/scene/sceneEdits.ts"],"sourcesContent":["/**\n * The scene's edits to its document — tree, node fields, layers, and document values — with\n * the kit ops they record.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { createSceneDoc, type SceneDocValues } from './docValues';\nimport { createFieldEdits, type FieldEdits } from './fieldEdits';\nimport { registerKitOps } from './kitOps';\nimport { createNodeFlags } from './nodeFlags';\nimport { createLayerEdits, type LayerEdits, type createLayerStack } from './layerStack';\nimport type { ResolvedLayoutFrame } from './layoutPass';\nimport type { LockGuard } from './lockGuard';\nimport type { NodeFnField } from './nodeFnFields';\nimport type { createNodeStore } from './nodeStore';\nimport type { OpTable } from './opTable';\nimport type { Recorder } from './recorder';\nimport { createTreeEdits, type TreeEdits } from './treeEdits';\nimport type { LayerRecord, Node, NodeId } from './types';\n\nexport interface SceneEditsEnv<TData, TLayer extends string, TPose> {\n  state: {\n    nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n    layers: LayerRecord<TLayer>[];\n    layerIndex: Map<TLayer, number>;\n    /** The scene's document values, which `doc` reads and records. */\n    docValues: Map<string, unknown>;\n  };\n  store: ReturnType<typeof createNodeStore<TData, TLayer, TPose>>;\n  locks: Pick<LockGuard<TLayer>, 'refuse' | 'refuseLayer' | 'lifted'>;\n  layers: Pick<\n    ReturnType<typeof createLayerStack<TLayer>>,\n    'requireLayerIndex' | 'rebuildLayerIndex' | 'assertSubtreeLayer'\n  >;\n  invalidateOrder(): void;\n  fnFields: readonly NodeFnField[];\n  ops: Pick<OpTable, 'register' | 'run'>;\n  recorder: Pick<Recorder, 'record' | 'edit' | 'batch'>;\n  arrivals: Pick<ArrivalWindow<TPose>, 'noteArrival' | 'noteDeparture' | 'noteChange' | 'layoutDeclared'>;\n  layoutFrame: ResolvedLayoutFrame<TPose>;\n  generateId(): NodeId;\n  narrowSelection(gone?: ReadonlySet<NodeId>): void;\n  clearOverride(id: NodeId): void;\n}\n\nexport interface SceneEdits<TData, TLayer extends string, TPose> {\n  construct: TreeEdits<TData, TLayer, TPose>['construct'];\n  methods: Omit<TreeEdits<TData, TLayer, TPose>, 'construct'>\n    & FieldEdits<TData, TLayer, TPose>\n    & LayerEdits<TData, TLayer, TPose>\n    & ReturnType<typeof createNodeFlags<TData, TLayer, TPose>>\n    & SceneDocValues;\n}\n\nexport function createSceneEdits<TData, TLayer extends string, TPose>(\n  env: SceneEditsEnv<TData, TLayer, TPose>,\n): SceneEdits<TData, TLayer, TPose> {\n  const { state, store, locks, layers, fnFields, recorder, arrivals } = env;\n\n  const { layoutRefs } = registerKitOps<TData, TLayer, TPose>({\n    state,\n    register: env.ops.register,\n    store,\n    requireLayerIndex: layers.requireLayerIndex,\n    rebuildLayerIndex: layers.rebuildLayerIndex,\n    invalidateOrder: env.invalidateOrder,\n    fnFields,\n    narrowSelection: env.narrowSelection,\n    clearOverride: env.clearOverride,\n  });\n\n  const { construct, ...treeEdits } = createTreeEdits<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    generateId: env.generateId,\n    store,\n    locks,\n    layers,\n    fnFields,\n    runOp: env.ops.run,\n    recorder,\n    arrivals,\n  });\n\n  const fieldEdits = createFieldEdits<TData, TLayer, TPose>({\n    store,\n    locks,\n    layers,\n    recorder,\n    arrivals,\n    layoutFrame: env.layoutFrame,\n    layoutField: fnFields.find((f) => f.spec.field === 'layout')!,\n    layoutRefs,\n  });\n\n  const layerEdits = createLayerEdits<TData, TLayer, TPose>({\n    layers: state.layers,\n    layerIndex: state.layerIndex,\n    nodes: state.nodes,\n    requireLayerIndex: layers.requireLayerIndex,\n    record: recorder.record,\n    lifted: locks.lifted,\n    batch: recorder.batch,\n    removeMany: treeEdits.removeMany,\n  });\n\n  const flagEdits = createNodeFlags<TData, TLayer, TPose>({\n    register: env.ops.register,\n    requireNode: store.requireNode,\n    record: recorder.record,\n    narrowSelection: () => env.narrowSelection(),\n  });\n\n  const doc = createSceneDoc({ values: state.docValues, register: env.ops.register, record: recorder.record });\n\n  return { construct, methods: { ...treeEdits, ...fieldEdits, ...layerEdits, ...flagEdits, doc } };\n}\n"],"mappings":";;;;;;;;AAqDA,SAAgB,iBACd,KACkC;CAClC,MAAM,EAAE,OAAO,OAAO,OAAO,QAAQ,UAAU,UAAU,aAAa;CAEtE,MAAM,EAAE,eAAe,eAAqC;EAC1D;EACA,UAAU,IAAI,IAAI;EAClB;EACA,mBAAmB,OAAO;EAC1B,mBAAmB,OAAO;EAC1B,iBAAiB,IAAI;EACrB;EACA,iBAAiB,IAAI;EACrB,eAAe,IAAI;CACrB,CAAC;CAED,MAAM,EAAE,WAAW,GAAG,cAAc,gBAAsC;EACxE,OAAO,MAAM;EACb,YAAY,IAAI;EAChB;EACA;EACA;EACA;EACA,OAAO,IAAI,IAAI;EACf;EACA;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD;EACA;EACA;EACA;EACA;EACA,aAAa,IAAI;EACjB,aAAa,SAAS,MAAM,MAAM,EAAE,KAAK,UAAU,QAAQ;EAC3D;CACF,CAAC;CAED,MAAM,aAAa,iBAAuC;EACxD,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO,MAAM;EACb,mBAAmB,OAAO;EAC1B,QAAQ,SAAS;EACjB,QAAQ,MAAM;EACd,OAAO,SAAS;EAChB,YAAY,UAAU;CACxB,CAAC;CAED,MAAM,YAAY,gBAAsC;EACtD,UAAU,IAAI,IAAI;EAClB,aAAa,MAAM;EACnB,QAAQ,SAAS;EACjB,uBAAuB,IAAI,gBAAgB;CAC7C,CAAC;CAED,MAAM,MAAM,eAAe;EAAE,QAAQ,MAAM;EAAW,UAAU,IAAI,IAAI;EAAU,QAAQ,SAAS;CAAO,CAAC;CAE3G,OAAO;EAAE;EAAW,SAAS;GAAE,GAAG;GAAW,GAAG;GAAY,GAAG;GAAY,GAAG;GAAW;EAAI;CAAE;AACjG"}