@weasel-js/core 1.13.0 → 1.14.1

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

@@ -0,0 +1,65 @@
+import { polygonFromPoints, runStationAt } from "@weasel-js/geom";
+
+//#region src/core/scene/pathEffects/textAlongBands.ts
+/**
+* The bands text along a path carries — decoration rules cut into clusters — joined across neighboring items and drawn
+* as ribbons that bend with the path.
+*/
+var PER_PATH = 512;
+var MAX_SAMPLES = 2048;
+/** Every ribbon `laid` carries, `shift` off the run. A `null` in `laid` is a dropped item, which no ribbon crosses. */
+function bandParts(laid, run, shift) {
+	const out = [];
+	let live = [];
+	const hair = 1e-9 * Math.max(1, run.length);
+	for (const at of laid) {
+		const next = [];
+		for (const band of at?.item.bands ?? []) {
+			if (!(band.x1 > band.x0)) continue;
+			const y0 = band.y0 + at.lift;
+			const y1 = band.y1 + at.lift;
+			const k = band.x0 <= hair ? live.findIndex((r) => r.open && alike(r, band, y0, y1)) : -1;
+			const ribbon = k < 0 ? {
+				band,
+				y0,
+				y1,
+				from: at.start + band.x0,
+				to: 0,
+				open: false
+			} : live.splice(k, 1)[0];
+			ribbon.to = at.start + band.x1;
+			ribbon.open = band.x1 >= at.item.length - hair;
+			next.push(ribbon);
+		}
+		for (const r of live) out.push(ribbonPart(r, run, shift));
+		live = next;
+	}
+	for (const r of live) out.push(ribbonPart(r, run, shift));
+	return out;
+}
+var alike = (r, band, y0, y1) => r.y0 === y0 && r.y1 === y1 && r.band.fill === band.fill && r.band.stroke === band.stroke;
+function ribbonPart(r, run, shift) {
+	const L = run.length;
+	const n = Math.min(MAX_SAMPLES, Math.max(1, Math.ceil((r.to - r.from) * PER_PATH / L)));
+	const top = [];
+	const bottom = [];
+	for (let i = 0; i <= n; i++) {
+		const d = r.from + (r.to - r.from) * i / n;
+		const { point, normal } = runStationAt(run, run.closed ? (d % L + L) % L : d);
+		const up = (y) => ({
+			x: point.x + (shift - y) * normal.x,
+			y: point.y + (shift - y) * normal.y
+		});
+		top.push(up(r.y0));
+		bottom.push(up(r.y1));
+	}
+	return {
+		path: polygonFromPoints([...top, ...bottom.reverse()]),
+		fill: r.band.fill,
+		stroke: r.band.stroke
+	};
+}
+
+//#endregion
+export { bandParts };
+//# sourceMappingURL=textAlongBands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textAlongBands.js","names":[],"sources":["../../../../src/core/scene/pathEffects/textAlongBands.ts"],"sourcesContent":["/**\n * The bands text along a path carries — decoration rules cut into clusters — joined across neighboring items and drawn\n * as ribbons that bend with the path.\n */\nimport { polygonFromPoints, runStationAt, type Point, type TrackRun } from '@weasel-js/geom';\nimport type { DerivedPart } from '../derivedParts';\nimport type { EffectBand, EffectItem } from './source';\n\n/** One kept item as the band walk reads it: where its leading edge falls along the run, and its anchor line's lift. */\nexport interface LaidItem {\n  item: EffectItem;\n  /** Its leading edge, along the run in reading order, unwrapped. */\n  start: number;\n  lift: number;\n}\n\ninterface Ribbon {\n  band: EffectBand;\n  /** Its edges against the path's anchor line, y down. */\n  y0: number;\n  y1: number;\n  from: number;\n  to: number;\n  /** Whether it reaches the end of the item it was last carried through. */\n  open: boolean;\n}\n\n// Samples per path length, so a ribbon's chords stay as close to the path as the path's own flattening.\nconst PER_PATH = 512;\nconst MAX_SAMPLES = 2048;\n\n/** Every ribbon `laid` carries, `shift` off the run. A `null` in `laid` is a dropped item, which no ribbon crosses. */\nexport function bandParts(laid: readonly (LaidItem | null)[], run: TrackRun, shift: number): DerivedPart[] {\n  const out: DerivedPart[] = [];\n  let live: Ribbon[] = [];\n  const hair = 1e-9 * Math.max(1, run.length);\n  for (const at of laid) {\n    const next: Ribbon[] = [];\n    for (const band of at?.item.bands ?? []) {\n      if (!(band.x1 > band.x0)) continue;\n      const y0 = band.y0 + at!.lift;\n      const y1 = band.y1 + at!.lift;\n      const k = band.x0 <= hair ? live.findIndex((r) => r.open && alike(r, band, y0, y1)) : -1;\n      const ribbon = k < 0 ? { band, y0, y1, from: at!.start + band.x0, to: 0, open: false } : live.splice(k, 1)[0]!;\n      ribbon.to = at!.start + band.x1;\n      ribbon.open = band.x1 >= at!.item.length - hair;\n      next.push(ribbon);\n    }\n    for (const r of live) out.push(ribbonPart(r, run, shift));\n    live = next;\n  }\n  for (const r of live) out.push(ribbonPart(r, run, shift));\n  return out;\n}\n\nconst alike = (r: Ribbon, band: EffectBand, y0: number, y1: number): boolean =>\n  r.y0 === y0 && r.y1 === y1 && r.band.fill === band.fill && r.band.stroke === band.stroke;\n\nfunction ribbonPart(r: Ribbon, run: TrackRun, shift: number): DerivedPart {\n  const L = run.length;\n  const n = Math.min(MAX_SAMPLES, Math.max(1, Math.ceil(((r.to - r.from) * PER_PATH) / L)));\n  const top: Point[] = [];\n  const bottom: Point[] = [];\n  for (let i = 0; i <= n; i++) {\n    const d = r.from + ((r.to - r.from) * i) / n;\n    const { point, normal } = runStationAt(run, run.closed ? ((d % L) + L) % L : d);\n    const up = (y: number): Point => ({ x: point.x + (shift - y) * normal.x, y: point.y + (shift - y) * normal.y });\n    top.push(up(r.y0));\n    bottom.push(up(r.y1));\n  }\n  return { path: polygonFromPoints([...top, ...bottom.reverse()]), fill: r.band.fill, stroke: r.band.stroke };\n}\n"],"mappings":";;;;;;;AA4BA,IAAM,WAAW;AACjB,IAAM,cAAc;;AAGpB,SAAgB,UAAU,MAAoC,KAAe,OAA8B;CACzG,MAAM,MAAqB,CAAC;CAC5B,IAAI,OAAiB,CAAC;CACtB,MAAM,OAAO,OAAO,KAAK,IAAI,GAAG,IAAI,MAAM;CAC1C,KAAK,MAAM,MAAM,MAAM;EACrB,MAAM,OAAiB,CAAC;EACxB,KAAK,MAAM,QAAQ,IAAI,KAAK,SAAS,CAAC,GAAG;GACvC,IAAI,EAAE,KAAK,KAAK,KAAK,KAAK;GAC1B,MAAM,KAAK,KAAK,KAAK,GAAI;GACzB,MAAM,KAAK,KAAK,KAAK,GAAI;GACzB,MAAM,IAAI,KAAK,MAAM,OAAO,KAAK,WAAW,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC,IAAI;GACtF,MAAM,SAAS,IAAI,IAAI;IAAE;IAAM;IAAI;IAAI,MAAM,GAAI,QAAQ,KAAK;IAAI,IAAI;IAAG,MAAM;GAAM,IAAI,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC;GAC3G,OAAO,KAAK,GAAI,QAAQ,KAAK;GAC7B,OAAO,OAAO,KAAK,MAAM,GAAI,KAAK,SAAS;GAC3C,KAAK,KAAK,MAAM;EAClB;EACA,KAAK,MAAM,KAAK,MAAM,IAAI,KAAK,WAAW,GAAG,KAAK,KAAK,CAAC;EACxD,OAAO;CACT;CACA,KAAK,MAAM,KAAK,MAAM,IAAI,KAAK,WAAW,GAAG,KAAK,KAAK,CAAC;CACxD,OAAO;AACT;AAEA,IAAM,SAAS,GAAW,MAAkB,IAAY,OACtD,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,SAAS,KAAK,QAAQ,EAAE,KAAK,WAAW,KAAK;AAEpF,SAAS,WAAW,GAAW,KAAe,OAA4B;CACxE,MAAM,IAAI,IAAI;CACd,MAAM,IAAI,KAAK,IAAI,aAAa,KAAK,IAAI,GAAG,KAAK,MAAO,EAAE,KAAK,EAAE,QAAQ,WAAY,CAAC,CAAC,CAAC;CACxF,MAAM,MAAe,CAAC;CACtB,MAAM,SAAkB,CAAC;CACzB,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;EAC3B,MAAM,IAAI,EAAE,QAAS,EAAE,KAAK,EAAE,QAAQ,IAAK;EAC3C,MAAM,EAAE,OAAO,WAAW,aAAa,KAAK,IAAI,UAAW,IAAI,IAAK,KAAK,IAAI,CAAC;EAC9E,MAAM,MAAM,OAAsB;GAAE,GAAG,MAAM,KAAK,QAAQ,KAAK,OAAO;GAAG,GAAG,MAAM,KAAK,QAAQ,KAAK,OAAO;EAAE;EAC7G,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;EACjB,OAAO,KAAK,GAAG,EAAE,EAAE,CAAC;CACtB;CACA,OAAO;EAAE,MAAM,kBAAkB,CAAC,GAAG,KAAK,GAAG,OAAO,QAAQ,CAAC,CAAC;EAAG,MAAM,EAAE,KAAK;EAAM,QAAQ,EAAE,KAAK;CAAO;AAC5G"}

package/dist/core/scene/reconcileSpecs.js

@@ -60,7 +60,7 @@ function byId(specs) {
 	return out;
 }
 function needsReplace(a, b) {
-	return a.kind !== b.kind || a.pickable !== b.pickable || a.derivePath !== b.derivePath || a.derivePose !== b.derivePose || a.clipFromPose !== b.clipFromPose || a.copiesFromPose !== b.copiesFromPose || a.layout !== b.layout;
+	return a.kind !== b.kind || a.pickable !== b.pickable || a.consumesChildren !== b.consumesChildren || a.derivePath !== b.derivePath || a.derivePose !== b.derivePose || a.clipFromPose !== b.clipFromPose || a.copiesFromPose !== b.copiesFromPose || a.layout !== b.layout;
 }
 
 //#endregion

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

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

package/dist/core/scene/scene.js

@@ -1,5 +1,6 @@
-import { IDENTITY_POSE_COMPOSITION } from "./composeFrame.js";
+import { RIGID_POSE_COMPOSITION } from "./composePose.js";
 import { effectivePose } from "./effectivePose.js";
+import { createScrollOffsets } from "./scrollOffsets.js";
 import { asNodeId } from "./types.js";
 import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { withKitRegistry } from "./kitRegistry.js";
@@ -60,9 +61,9 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 	const generateId = options.generateId ?? defaultGenerateId;
 	const selection = createSceneSelection(locks.reachable);
 	selection.subscribe(notifier.notify);
-	/** Ephemeral per-node overrides. Deliberately not part of `state`: not
-	*  document content, never reaches `toJSON`, and never touches history. */
+	/** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */
 	const overrides = createPoseOverrides((id) => state.nodes.get(id), doc.store.invalidateDependents);
+	const scroll = createScrollOffsets();
 	const recording = createSceneRecording({
 		notifier,
 		mode,
@@ -110,7 +111,7 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 		registry,
 		...reads,
 		mintId: generateId,
-		composition: options.composition ?? IDENTITY_POSE_COMPOSITION,
+		composition: options.composition ?? RIGID_POSE_COMPOSITION,
 		...edits.methods,
 		...recording.methods,
 		unlocked: (fn) => locks.lifted(fn),
@@ -118,12 +119,17 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 		onReflow: arrivals.onReflow,
 		onPoseWrite: poseWrites.subscribe,
 		overrides,
+		scroll,
 		getSelection: selection.get,
 		setSelection: (ids) => selection.set([...ids]),
 		loadState(json, opts) {
-			const specs = specsFromSerialized(json, registry, opts);
+			const specs = specsFromSerialized(json, registry, {
+				composition: scene.composition,
+				...opts
+			});
 			if (mode.open()) throw new Error("Scene: cannot loadState inside another edit — it replaces the state that edit would revert to");
 			overrides.clearAll();
+			scroll.clearAll();
 			doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);
 			recording.clearHistory();
 			poseWrites.quiet(() => edits.construct(specs));

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 { 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, type SpecsFromSerializedOptions } 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 SerializedSceneV1,\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, TData>((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, opts) {\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, opts);\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> | SerializedSceneV1<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  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\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 { createScrollOffsets } from './scrollOffsets';\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, type SpecsFromSerializedOptions } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport type { SceneOptions } from './useSceneOptions';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SavedScene,\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<SceneOptions<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 carrying a kit-attached\n  // function (a grouped container's derived pose) reloads in any scene, not only one that registered it.\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, deliberately not part of `state`: not document content, never in `toJSON` or history. */\n  const overrides = createPoseOverrides<TPose, TData>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n  const scroll = createScrollOffsets();\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 ?? (RIGID_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    scroll,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json, opts) {\n      // Validate + map up front: throws on a bad version or registry key before live state is touched.\n      const specs = specsFromSerialized(json, registry, { composition: scene.composition, ...opts });\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      scroll.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: SavedScene<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?: SceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: SceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAS,UAA+C,OAAoC,IAAY;CACtG,MAAM,OAAO,MAAM,IAAI,EAAE;CACzB,OAAO,QAAQ;EAAE;EAAM,MAAM,cAAc,OAAO,IAAI;CAAE;AAC1D;AAEA,IAAI,mBAAmB;AACvB,IAAM,0BACJ,SAAS,KAAK,mBAAA,CAAoB,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG;;;;AAK5F,SAAgB,YACd,SAC6B;CAC7B,OAAO,WAAW,UAAU,QAAQ,gBAAgB,CAAC,EAAA,CAAG,IAAI,iBAAiB,SAAS,QAAQ,SAAS,QAAQ,GAAG;AACpH;;;;AAQA,SAAS,WACP,SACA,QACA,cACA,YAC6B;CAC7B,IAAI,OAAO,WAAW,GAAG,MAAM,IAAI,MAAM,qDAAqD;CAI9F,MAAM,WAAW,gBAAgB,QAAQ,YAAY,CAAC,CAAC;CAEvD,MAAM,MAAM,iBAAuC,UAAU,cAAc,SAAS,eAAe,GAAG,UAAU;CAChH,MAAM,EAAE,OAAO,OAAO,UAAU;CAChC,MAAM,WAAW,eAAe;CAChC,MAAM,OAAO,eAAe;CAC5B,MAAM,aAAa,mBAAmB;EAAE,WAAW,KAAK;EAAW,SAAS;EAAU,QAAQ,OAAO,UAAU,OAAO,EAAE;CAAE,CAAC;CAC3H,MAAM,aAAa,IAAY,SAAwB,WAAW,aAAa,MAAM,QAAQ,SAAS,EAAE,GAAG,IAAa,CAAC;CAEzH,MAAM,cAAc,mBAAmB,QAAQ,WAAW;CAC1D,MAAM,WAAW,oBAA0C;EACzD,OAAO,MAAM;EACb,aAAa,SAAS,SAAS,aAC7B,cAAc,OAAO,MAAM,UAAU,SAAS,SAAS,aAAa,QAAQ;EAC9E,wBAAwB,CAAC,KAAK,KAAK;EACnC;CACF,CAAC;CAED,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,YAAY,qBAAqB,MAAM,SAAS;CAEtD,UAAU,UAAU,SAAS,MAAM;;CAGnC,MAAM,YAAY,qBAAmC,OAAO,MAAM,MAAM,IAAI,EAAE,GAAG,IAAI,MAAM,oBAAoB;CAC/G,MAAM,SAAS,oBAAoB;CAEnC,MAAM,YAAY,qBAAqB;EACrC;EACA;EACA,oBAAoB;GAAE,GAAG,cAAc,KAAK;GAAG,GAAG,cAAc,KAAK;EAAE;EACvE,OAAO,IAAI;EACX,QAAQ,MAAM;EACd;EACA;EACA;EACA;EACA,QAAQ;CACV,CAAC;CAED,MAAM,QAAQ,iBAAuC;EACnD;EACA,OAAO,IAAI;EACX;EACA,QAAQ,IAAI;EACZ,iBAAiB,IAAI,MAAM;EAC3B,UAAU,IAAI;EACd,KAAK;GAAE,GAAG,UAAU;GAAK,UAAU,WAAW,UAAU,UAAU,IAAI,QAAQ;EAAE;EAChF,UAAU,UAAU;EACpB;EACA;EACA;EACA,iBAAiB,UAAU;EAC3B,eAAe,UAAU;CAC3B,CAAC;CACD,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,QAAQ,OAAO,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,MAAM,OAAO;CAErG,MAAM,QAAqC;EACzC,IAAI,QAAQ;GAAE,OAAO,MAAM;EAAO;EAClC,IAAI,QAAQ;GAAE,OAAO,MAAM;EAAO;EAClC,IAAI,SAAS;GAAE,OAAO,MAAM;EAAQ;EACpC;EAEA,GAAG;EAEH,QAAQ;EACR,aAAa,QAAQ,eAAgB;EAErC,GAAG,MAAM;EACT,GAAG,UAAU;EAEb,WAAW,OAAO,MAAM,OAAO,EAAE;EAEjC,mBAAmB,SAAS;EAC5B,UAAU,SAAS;EACnB,aAAa,WAAW;EAExB;EACA;EAEA,cAAc,UAAU;EACxB,eAAe,QAAQ,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC;EAE7C,UAAU,MAAM,MAAM;GAEpB,MAAM,QAAQ,oBAAoB,MAAM,UAAU;IAAE,aAAa,MAAM;IAAa,GAAG;GAAK,CAAC;GAC7F,IAAI,KAAK,KAAK,GACZ,MAAM,IAAI,MAAM,+FAA+F;GAGjH,UAAU,SAAS;GACnB,OAAO,SAAS;GAChB,IAAI,MAAM,KAAK,aAAa,IAAI,mBAAmB,GAAG,KAAK,GAAG;GAC9D,UAAU,aAAa;GACvB,WAAW,YAAY,MAAM,UAAU,KAAK,CAAC;GAC7C,UAAU,QAAQ,MAAM,UAAU,UAAU,IAAI,CAAC,CAAC,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;GACtF,SAAS,OAAO;EAClB;EAEA,GAAG,aAAa,UAAU,SAAS;CACrC;CAEA,MAAM,UAAU,aAAa,QAAQ;CACrC,IAAI,SAAS;EACX,WAAW,YAAY,MAAM,UAAU,OAAO,CAAC;EAC/C,SAAS,OAAO;CAClB;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,cACd,MACA,UAQuD,CAAC,GAC3B;CAC7B,OAAO,WACL,SACA,KAAK,aAAa,IAAI,mBAAmB,IACxC,aAAa,oBAAoB,MAAM,UAAU,OAAO,GACzD,KAAK,GACP;AACF"}

package/dist/core/scene/sceneEdits.js

@@ -18,7 +18,8 @@ function createSceneEdits(env) {
 		invalidateOrder: env.invalidateOrder,
 		fnFields,
 		narrowSelection: env.narrowSelection,
-		clearOverride: env.clearOverride
+		clearOverride: env.clearOverride,
+		noteWritten: locks.noteWritten
 	});
 	const { construct, ...treeEdits } = createTreeEdits({
 		nodes: state.nodes,
@@ -55,7 +56,9 @@ function createSceneEdits(env) {
 		register: env.ops.register,
 		requireNode: store.requireNode,
 		record: recorder.record,
-		narrowSelection: () => env.narrowSelection()
+		narrowSelection: () => env.narrowSelection(),
+		invalidateDependents: store.invalidateDependents,
+		noteWritten: locks.noteWritten
 	});
 	const declaredEdits = createDeclaredFieldSetters({
 		register: env.ops.register,

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, layers, and document values — with\n * the kit ops they record.\n */\nimport type { ArrivalWindow } from './arrivalWindow';\nimport { createSceneDoc, type SceneDocValues } from './docValues';\nimport { createDeclaredFieldSetters, type SceneDeclaredFieldSetters } from './declaredFieldSetters';\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    & SceneDeclaredFieldSetters\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 declaredEdits = createDeclaredFieldSetters<TData, TLayer, TPose>({\n    register: env.ops.register,\n    requireNode: store.requireNode,\n    refuse: locks.refuse,\n    record: recorder.record,\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, ...declaredEdits, doc } };\n}\n"],"mappings":";;;;;;;;;AAuDA,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,gBAAgB,2BAAiD;EACrE,UAAU,IAAI,IAAI;EAClB,aAAa,MAAM;EACnB,QAAQ,MAAM;EACd,QAAQ,SAAS;CACnB,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,GAAG;GAAe;EAAI;CAAE;AACnH"}
+{"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 { createDeclaredFieldSetters, type SceneDeclaredFieldSetters } from './declaredFieldSetters';\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' | 'noteWritten'>;\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    & SceneDeclaredFieldSetters\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    noteWritten: locks.noteWritten,\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    invalidateDependents: store.invalidateDependents,\n    noteWritten: locks.noteWritten,\n  });\n\n  const declaredEdits = createDeclaredFieldSetters<TData, TLayer, TPose>({\n    register: env.ops.register,\n    requireNode: store.requireNode,\n    refuse: locks.refuse,\n    record: recorder.record,\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, ...declaredEdits, doc } };\n}\n"],"mappings":";;;;;;;;;AAuDA,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;EACnB,aAAa,MAAM;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;EAC3C,sBAAsB,MAAM;EAC5B,aAAa,MAAM;CACrB,CAAC;CAED,MAAM,gBAAgB,2BAAiD;EACrE,UAAU,IAAI,IAAI;EAClB,aAAa,MAAM;EACnB,QAAQ,MAAM;EACd,QAAQ,SAAS;CACnB,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,GAAG;GAAe;EAAI;CAAE;AACnH"}

package/dist/core/scene/scenePoseAdapter.js

@@ -1,4 +1,5 @@
 import { definesFrame, documentPose } from "./effectivePose.js";
+import { viewPoseAdapter } from "./scrollOffsets.js";
 
 //#region src/core/scene/scenePoseAdapter.ts
 /** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.
@@ -14,7 +15,15 @@ function scenePoseAdapter(scene) {
 		}
 	};
 }
+/** `scenePoseAdapter` read as the view shows it: each scrolled container's
+*  children moved by its offset. For a gesture, which reads the world it
+*  writes back through the same fold, so what it stores is the content
+*  position; the layout pass and other document writers use
+*  `scenePoseAdapter`. */
+function sceneViewPoseAdapter(scene) {
+	return viewPoseAdapter(scene, scenePoseAdapter(scene));
+}
 
 //#endregion
-export { scenePoseAdapter };
+export { scenePoseAdapter, sceneViewPoseAdapter };
 //# sourceMappingURL=scenePoseAdapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scenePoseAdapter.js","names":[],"sources":["../../../src/core/scene/scenePoseAdapter.ts"],"sourcesContent":["import { definesFrame, documentPose } from 'core/scene/effectivePose';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { PoseAdapter } from './composePose';\n\n/** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.\n *  `getParent` returns the live parent at call time so mid-batch\n *  parent updates compose correctly. */\nexport function scenePoseAdapter(\n  scene: Scene<unknown, string, unknown>,\n): PoseAdapter<unknown> {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(id as NodeId)!),\n    getParent: (id) => scene.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => {\n      const node = scene.get(id as NodeId);\n      return node === undefined || definesFrame(node);\n    },\n  };\n}\n"],"mappings":";;;;;;AAOA,SAAgB,iBACd,OACsB;CACtB,OAAO;EACL,UAAU,OAAO,aAAa,OAAO,MAAM,IAAI,EAAY,CAAE;EAC7D,YAAY,OAAO,MAAM,IAAI,EAAY,CAAC,EAAE,UAAU;EACtD,eAAe,OAAO;GACpB,MAAM,OAAO,MAAM,IAAI,EAAY;GACnC,OAAO,SAAS,UAAa,aAAa,IAAI;EAChD;CACF;AACF"}
+{"version":3,"file":"scenePoseAdapter.js","names":[],"sources":["../../../src/core/scene/scenePoseAdapter.ts"],"sourcesContent":["import { definesFrame, documentPose } from 'core/scene/effectivePose';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { PoseAdapter } from './composePose';\nimport { viewPoseAdapter } from './scrollOffsets';\n\n/** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.\n *  `getParent` returns the live parent at call time so mid-batch\n *  parent updates compose correctly. */\nexport function scenePoseAdapter(\n  scene: Scene<unknown, string, unknown>,\n): PoseAdapter<unknown> {\n  return {\n    getPose: (id) => documentPose(scene, scene.get(id as NodeId)!),\n    getParent: (id) => scene.get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => {\n      const node = scene.get(id as NodeId);\n      return node === undefined || definesFrame(node);\n    },\n  };\n}\n\n/** `scenePoseAdapter` read as the view shows it: each scrolled container's\n *  children moved by its offset. For a gesture, which reads the world it\n *  writes back through the same fold, so what it stores is the content\n *  position; the layout pass and other document writers use\n *  `scenePoseAdapter`. */\nexport function sceneViewPoseAdapter(\n  scene: Scene<unknown, string, unknown>,\n): PoseAdapter<unknown> {\n  return viewPoseAdapter(scene, scenePoseAdapter(scene));\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,iBACd,OACsB;CACtB,OAAO;EACL,UAAU,OAAO,aAAa,OAAO,MAAM,IAAI,EAAY,CAAE;EAC7D,YAAY,OAAO,MAAM,IAAI,EAAY,CAAC,EAAE,UAAU;EACtD,eAAe,OAAO;GACpB,MAAM,OAAO,MAAM,IAAI,EAAY;GACnC,OAAO,SAAS,UAAa,aAAa,IAAI;EAChD;CACF;AACF;;;;;;AAOA,SAAgB,qBACd,OACsB;CACtB,OAAO,gBAAgB,OAAO,iBAAiB,KAAK,CAAC;AACvD"}

package/dist/core/scene/scrollOffsets.js

@@ -0,0 +1,93 @@
+import { isDocument } from "./documentOf.js";
+import { createEmitter } from "@weasel-js/registry";
+
+//#region src/core/scene/scrollOffsets.ts
+/**
+* How far each container's content is scrolled: view state, never document.
+*
+* A scroll offset is part of the frame a container gives its children, so the
+* document never moves: a child keeps its stored pose and is shown moved by
+* minus the offset. Only the view-side fold reads it — painting, picking,
+* selection chrome, previews and gestures, through `scrolledFrames` — while
+* the layout pass and every writer that stores a pose fold through the
+* unscrolled frame.
+*/
+/** Build an empty {@link ScrollOffsets}. */
+function createScrollOffsets() {
+	const offsets = /* @__PURE__ */ new Map();
+	const listeners = createEmitter();
+	let generation = 0;
+	const changed = () => {
+		generation++;
+		listeners.emit();
+	};
+	return {
+		get: (id) => offsets.get(id),
+		set(id, offset) {
+			const held = offsets.get(id);
+			if (offset === null || offset.x === 0 && offset.y === 0 && !offset.z) {
+				if (held === void 0) return;
+				offsets.delete(id);
+			} else {
+				if (held !== void 0 && held.x === offset.x && held.y === offset.y && (held.z ?? 0) === (offset.z ?? 0)) return;
+				offsets.set(id, { ...offset });
+			}
+			changed();
+		},
+		ids: () => offsets.keys(),
+		clearAll() {
+			if (offsets.size === 0) return;
+			offsets.clear();
+			changed();
+		},
+		subscribe: listeners.subscribe,
+		getGeneration: () => generation
+	};
+}
+var memos = /* @__PURE__ */ new WeakMap();
+/** `scroll(frame, offset)`, answering the same object while the frame and the
+*  offset objects are the same: a paint memo keys on the pose a child is
+*  composed to, and an unchanged child in an unscrolled-since container must
+*  keep its key from one walk to the next. */
+function memoScroll(scroll, frame, offset) {
+	if (typeof frame !== "object" || frame === null) return scroll(frame, offset);
+	let byFrame = memos.get(scroll);
+	if (byFrame === void 0) memos.set(scroll, byFrame = /* @__PURE__ */ new WeakMap());
+	const held = byFrame.get(frame);
+	if (held !== void 0 && held.offset === offset) return held.out;
+	const out = scroll(frame, offset);
+	byFrame.set(frame, {
+		offset,
+		out
+	});
+	return out;
+}
+/**
+* The view-side fold's `PoseAdapter.childFrame` over `scene`: each scrolled
+* container's frame moved by its offset. `undefined` when the scene has no
+* scroll store, its composition cannot scroll, or it is a `documentOf` view,
+* which reads as the document holds it, so a reader skips the step.
+*/
+function scrolledFrames(scene) {
+	const store = scene.scroll;
+	const scroll = scene.composition?.scroll;
+	if (store === void 0 || scroll === void 0) return void 0;
+	if (scene.overrides !== void 0 && isDocument(scene)) return void 0;
+	return (id, world) => {
+		const offset = store.get(id);
+		return offset === void 0 ? world : memoScroll(scroll, world, offset);
+	};
+}
+/** `adapter` read as the view shows it: with `scene`'s scrolled frames as its
+*  `childFrame`. The same adapter when nothing can scroll. */
+function viewPoseAdapter(scene, adapter) {
+	const childFrame = scrolledFrames(scene);
+	return childFrame === void 0 ? adapter : {
+		...adapter,
+		childFrame
+	};
+}
+
+//#endregion
+export { createScrollOffsets, scrolledFrames, viewPoseAdapter };
+//# sourceMappingURL=scrollOffsets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollOffsets.js","names":[],"sources":["../../../src/core/scene/scrollOffsets.ts"],"sourcesContent":["/**\n * How far each container's content is scrolled: view state, never document.\n *\n * A scroll offset is part of the frame a container gives its children, so the\n * document never moves: a child keeps its stored pose and is shown moved by\n * minus the offset. Only the view-side fold reads it — painting, picking,\n * selection chrome, previews and gestures, through `scrolledFrames` — while\n * the layout pass and every writer that stores a pose fold through the\n * unscrolled frame.\n */\nimport { createEmitter } from '@weasel-js/registry';\nimport type { PoseAdapter, PoseComposition, ScrollOffset } from './composeFrame';\nimport { isDocument } from './documentOf';\nimport type { NodeId } from './types';\n\n/** The scene's scroll offsets, one per scrolled container. */\nexport interface ScrollOffsets {\n  /** How far `id`'s content is scrolled, or `undefined` when it is not. */\n  get(id: NodeId): ScrollOffset | undefined;\n  /** Scroll `id`'s content to `offset`. `null`, or an offset of zero on every\n   *  axis, unscrolls it. */\n  set(id: NodeId, offset: ScrollOffset | null): void;\n  /** The scrolled containers. */\n  ids(): IterableIterator<NodeId>;\n  /** Unscroll everything. */\n  clearAll(): void;\n  subscribe(listener: () => void): () => void;\n  /** Bumped by every change, for a cache keyed on what the view shows. */\n  getGeneration(): number;\n}\n\n/** The scroll store a `Scene` carries. */\nexport interface SceneScroll {\n  /** How far each container's content is scrolled. Like the selection, view\n   *  state shared by every view over the scene: never document content, never\n   *  recorded or serialized, and it does not bump the scene's version. */\n  readonly scroll: ScrollOffsets;\n}\n\n/** Build an empty {@link ScrollOffsets}. */\nexport function createScrollOffsets(): ScrollOffsets {\n  const offsets = new Map<NodeId, ScrollOffset>();\n  const listeners = createEmitter();\n  let generation = 0;\n  const changed = (): void => {\n    generation++;\n    listeners.emit();\n  };\n  return {\n    get: (id) => offsets.get(id),\n    set(id, offset) {\n      const held = offsets.get(id);\n      if (offset === null || (offset.x === 0 && offset.y === 0 && !offset.z)) {\n        if (held === undefined) return;\n        offsets.delete(id);\n      } else {\n        if (held !== undefined && held.x === offset.x && held.y === offset.y && (held.z ?? 0) === (offset.z ?? 0)) return;\n        offsets.set(id, { ...offset });\n      }\n      changed();\n    },\n    ids: () => offsets.keys(),\n    clearAll() {\n      if (offsets.size === 0) return;\n      offsets.clear();\n      changed();\n    },\n    subscribe: listeners.subscribe,\n    getGeneration: () => generation,\n  };\n}\n\ntype Scroll = (frame: never, offset: ScrollOffset) => unknown;\nconst memos = new WeakMap<Scroll, WeakMap<object, { offset: ScrollOffset; out: unknown }>>();\n\n/** `scroll(frame, offset)`, answering the same object while the frame and the\n *  offset objects are the same: a paint memo keys on the pose a child is\n *  composed to, and an unchanged child in an unscrolled-since container must\n *  keep its key from one walk to the next. */\nfunction memoScroll<TPose>(scroll: (frame: TPose, offset: ScrollOffset) => TPose, frame: TPose, offset: ScrollOffset): TPose {\n  if (typeof frame !== 'object' || frame === null) return scroll(frame, offset);\n  let byFrame = memos.get(scroll as Scroll);\n  if (byFrame === undefined) memos.set(scroll as Scroll, byFrame = new WeakMap());\n  const held = byFrame.get(frame);\n  if (held !== undefined && held.offset === offset) return held.out as TPose;\n  const out = scroll(frame, offset);\n  byFrame.set(frame, { offset, out });\n  return out;\n}\n\n/** What `scrolledFrames` reads of a scene. Partial stand-ins without a\n *  `scroll` store read as unscrolled. */\nexport interface ScrollSource<TPose> {\n  readonly overrides?: unknown;\n  readonly scroll?: ScrollOffsets;\n  readonly composition?: PoseComposition<TPose>;\n}\n\n/**\n * The view-side fold's `PoseAdapter.childFrame` over `scene`: each scrolled\n * container's frame moved by its offset. `undefined` when the scene has no\n * scroll store, its composition cannot scroll, or it is a `documentOf` view,\n * which reads as the document holds it, so a reader skips the step.\n */\nexport function scrolledFrames<TPose>(\n  scene: ScrollSource<TPose>,\n): ((id: string, world: TPose) => TPose) | undefined {\n  const store = scene.scroll;\n  const scroll = scene.composition?.scroll;\n  if (store === undefined || scroll === undefined) return undefined;\n  if (scene.overrides !== undefined && isDocument(scene as { overrides: unknown })) return undefined;\n  return (id, world) => {\n    const offset = store.get(id as NodeId);\n    return offset === undefined ? world : memoScroll(scroll, world, offset);\n  };\n}\n\n/** `adapter` read as the view shows it: with `scene`'s scrolled frames as its\n *  `childFrame`. The same adapter when nothing can scroll. */\nexport function viewPoseAdapter<TPose, A extends PoseAdapter<TPose>>(scene: ScrollSource<TPose>, adapter: A): A {\n  const childFrame = scrolledFrames(scene);\n  return childFrame === undefined ? adapter : { ...adapter, childFrame };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwCA,SAAgB,sBAAqC;CACnD,MAAM,0BAAU,IAAI,IAA0B;CAC9C,MAAM,YAAY,cAAc;CAChC,IAAI,aAAa;CACjB,MAAM,gBAAsB;EAC1B;EACA,UAAU,KAAK;CACjB;CACA,OAAO;EACL,MAAM,OAAO,QAAQ,IAAI,EAAE;EAC3B,IAAI,IAAI,QAAQ;GACd,MAAM,OAAO,QAAQ,IAAI,EAAE;GAC3B,IAAI,WAAW,QAAS,OAAO,MAAM,KAAK,OAAO,MAAM,KAAK,CAAC,OAAO,GAAI;IACtE,IAAI,SAAS,QAAW;IACxB,QAAQ,OAAO,EAAE;GACnB,OAAO;IACL,IAAI,SAAS,UAAa,KAAK,MAAM,OAAO,KAAK,KAAK,MAAM,OAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,KAAK,IAAI;IAC3G,QAAQ,IAAI,IAAI,EAAE,GAAG,OAAO,CAAC;GAC/B;GACA,QAAQ;EACV;EACA,WAAW,QAAQ,KAAK;EACxB,WAAW;GACT,IAAI,QAAQ,SAAS,GAAG;GACxB,QAAQ,MAAM;GACd,QAAQ;EACV;EACA,WAAW,UAAU;EACrB,qBAAqB;CACvB;AACF;AAGA,IAAM,wBAAQ,IAAI,QAAyE;;;;;AAM3F,SAAS,WAAkB,QAAuD,OAAc,QAA6B;CAC3H,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,OAAO,OAAO,MAAM;CAC5E,IAAI,UAAU,MAAM,IAAI,MAAgB;CACxC,IAAI,YAAY,QAAW,MAAM,IAAI,QAAkB,0BAAU,IAAI,QAAQ,CAAC;CAC9E,MAAM,OAAO,QAAQ,IAAI,KAAK;CAC9B,IAAI,SAAS,UAAa,KAAK,WAAW,QAAQ,OAAO,KAAK;CAC9D,MAAM,MAAM,OAAO,OAAO,MAAM;CAChC,QAAQ,IAAI,OAAO;EAAE;EAAQ;CAAI,CAAC;CAClC,OAAO;AACT;;;;;;;AAgBA,SAAgB,eACd,OACmD;CACnD,MAAM,QAAQ,MAAM;CACpB,MAAM,SAAS,MAAM,aAAa;CAClC,IAAI,UAAU,UAAa,WAAW,QAAW,OAAO;CACxD,IAAI,MAAM,cAAc,UAAa,WAAW,KAA+B,GAAG,OAAO;CACzF,QAAQ,IAAI,UAAU;EACpB,MAAM,SAAS,MAAM,IAAI,EAAY;EACrC,OAAO,WAAW,SAAY,QAAQ,WAAW,QAAQ,OAAO,MAAM;CACxE;AACF;;;AAIA,SAAgB,gBAAqD,OAA4B,SAAe;CAC9G,MAAM,aAAa,eAAe,KAAK;CACvC,OAAO,eAAe,SAAY,UAAU;EAAE,GAAG;EAAS;CAAW;AACvE"}

package/dist/core/scene/serialization.js

@@ -1,5 +1,7 @@
+import { RIGID_POSE_COMPOSITION } from "./composePose.js";
 import { NODE_FN_FIELDS, fnKeysOf } from "./nodeFnFields.js";
 import { treePreorder } from "./treeOrder.js";
+import { localizeWorldPoses } from "./worldSave.js";
 
 //#region src/core/scene/serialization.ts
 /**
@@ -9,7 +11,7 @@ import { treePreorder } from "./treeOrder.js";
 /** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */
 function isSerializedScene(value) {
 	const version = typeof value === "object" && value != null ? value.version : void 0;
-	return (version === 1 || version === 2) && Array.isArray(value.nodes);
+	return (version === 1 || version === 2 || version === 3) && Array.isArray(value.nodes);
 }
 /** One layer record from its snapshot form. A snapshot with no `kind` predates
 *  user layers, so everything in it was a system layer. */
@@ -52,13 +54,14 @@ function serializeScene(state, fnFields, doc) {
 		if (n.locked === true) out.locked = true;
 		if (n.units !== void 0) out.units = n.units;
 		if (n.clip !== void 0) out.clip = n.clip;
+		if (n.consumesChildren === true) out.consumesChildren = true;
 		Object.assign(out, fnKeysOf(fnFields, n, "jsonKey", (field) => {
 			throw new Error(`Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. The function must be registered via createScene's registry option to round-trip.`);
 		}));
 		nodes.push(out);
 	}
 	return {
-		version: 2,
+		version: 3,
 		systemLayers: state.layers.map((l) => {
 			const layer = { id: l.id };
 			if (l.visible === false) layer.visible = false;
@@ -81,16 +84,22 @@ function serializeScene(state, fnFields, doc) {
 *  throws on an unsupported version, and on an unknown registry key unless
 *  `opts.unknownKeys` is `'skip'`. */
 function specsFromSerialized(json, registry, opts = {}) {
+	const specs = currentSpecs(json, registry, opts);
+	if (json.version === 3) return specs;
+	return localizeWorldPoses(specs, opts.composition ?? RIGID_POSE_COMPOSITION);
+}
+/** `json`'s nodes as specs, with every pose as the save stored it. */
+function currentSpecs(json, registry, opts) {
 	let entries;
 	if (json.version === 1) entries = json.nodes.map((n) => ({
 		n,
 		kind: nodeKindOf(1, n, opts.classifyV1)
 	}));
-	else if (json.version === 2) entries = json.nodes.map((n) => ({
+	else if (json.version === 2 || json.version === 3) entries = json.nodes.map((n) => ({
 		n,
 		kind: nodeKindOf(2, n)
 	}));
-	else throw new Error(`Scene: unsupported version ${String(Reflect.get(json, "version"))}; versions 1 and 2 are supported`);
+	else throw new Error(`Scene: unsupported version ${String(Reflect.get(json, "version"))}; versions 1, 2 and 3 are supported`);
 	return entries.map(({ n, kind }) => {
 		const spec = {
 			id: n.id,
@@ -105,6 +114,7 @@ function specsFromSerialized(json, registry, opts = {}) {
 		if (n.locked === true) spec.locked = true;
 		if (n.units !== void 0) spec.units = n.units;
 		if (n.clip !== void 0) spec.clip = n.clip;
+		if (n.consumesChildren === true) spec.consumesChildren = true;
 		if (n.dependsOn !== void 0) spec.dependsOn = n.dependsOn === "children" ? "children" : n.dependsOn;
 		const serialized = n;
 		for (const field of NODE_FN_FIELDS) {
@@ -133,7 +143,7 @@ function specsFromSerialized(json, registry, opts = {}) {
 function clipsAsV1(version, spec) {
 	return version === 1 && spec.kind === "group" && spec.clipFromPose === void 0;
 }
-/** The kind a saved node loads as: its own on version 2; on version 1 a `leaf` is a
+/** The kind a saved node loads as: its own from version 2; on version 1 a `leaf` is a
 *  mark and a `container` goes to `classify`, or is a group without one. */
 function nodeKindOf(version, n, classify) {
 	if (version === 2) return n.kind;

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

@@ -1 +1 @@
-{"version":3,"file":"serialization.js","names":[],"sources":["../../../src/core/scene/serialization.ts"],"sourcesContent":["/**\n * A scene to and from its JSON snapshot: the walk that writes one, and the\n * two readers that turn one back into layer records and node specs.\n */\nimport {\n  NODE_FN_FIELDS, fnKeysOf, type FnBearingNode, type NodeFnField,\n} from './nodeFnFields';\nimport type { SerializedDoc } from './docValues';\nimport { treePreorder } from './treeOrder';\nimport type {\n  AddNodeSpec, LayerRecord, Node, NodeId, SceneRegistry, SerializedLayer, SerializedNode, SerializedNodeV1,\n  SerializedScene, SerializedSceneV1,\n} from './types';\n\n/** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */\nexport function isSerializedScene<TData, TLayer extends string, TPose>(\n  value: unknown,\n): value is SerializedScene<TData, TLayer, TPose> | SerializedSceneV1<TData, TLayer, TPose> {\n  const version = typeof value === 'object' && value != null\n    ? (value as { version?: unknown }).version : undefined;\n  return (version === 1 || version === 2)\n    && Array.isArray((value as { nodes?: unknown }).nodes);\n}\n\n/** What a snapshot is written from. */\nexport interface SerializableState<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  roots: NodeId[];\n  layers: LayerRecord<TLayer>[];\n}\n\n/** One layer record from its snapshot form. A snapshot with no `kind` predates\n *  user layers, so everything in it was a system layer. */\nexport function layerFromSerialized<TLayer extends string>(\n  spec: SerializedLayer<TLayer>,\n): LayerRecord<TLayer> {\n  const base = {\n    id: spec.id,\n    visible: spec.visible ?? true,\n    locked: spec.locked ?? false,\n    ...(spec.parallax ? { parallax: spec.parallax } : {}),\n    ...(spec.annotation ? { annotation: true } : {}),\n  };\n  return spec.kind === 'user'\n    ? { ...base, kind: 'user', name: spec.name ?? spec.id }\n    : { ...base, kind: 'system' };\n}\n\n/** The snapshot of `state`: layers in order, nodes in tree preorder, and the\n *  document values when there are any. Throws\n *  when a node carries a function the registry has no key for. */\nexport function serializeScene<TData, TLayer extends string, TPose>(\n  state: SerializableState<TData, TLayer, TPose>,\n  fnFields: readonly NodeFnField[],\n  doc?: SerializedDoc,\n): SerializedScene<TData, TLayer, TPose> {\n  const nodes: SerializedNode<TData, TLayer, TPose>[] = [];\n  for (const n of treePreorder(state.roots, state.nodes)) {\n    const id = n.id;\n    const out: SerializedNode<TData, TLayer, TPose> = {\n      id,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent != null) out.parent = n.parent;\n    if (n.dependsOn === 'children') out.dependsOn = 'children';\n    else if (n.dependsOn && n.dependsOn.length > 0) out.dependsOn = n.dependsOn;\n    if (n.pickable === false) out.pickable = false;\n    if (n.hidden === true) out.hidden = true;\n    if (n.locked === true) out.locked = true;\n    if (n.units !== undefined) out.units = n.units;\n    if (n.clip !== undefined) out.clip = n.clip;\n    Object.assign(\n      out,\n      fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey', (field) => {\n        throw new Error(\n          `Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. ` +\n          `The function must be registered via createScene's registry option to round-trip.`\n        );\n      }),\n    );\n    nodes.push(out);\n  }\n  const systemLayers = state.layers.map((l) => {\n    const layer: SerializedLayer<TLayer> = { id: l.id };\n    if (l.visible === false) layer.visible = false;\n    if (l.locked === true) layer.locked = true;\n    if (l.parallax) layer.parallax = l.parallax;\n    if (l.annotation) layer.annotation = true;\n    if (l.kind === 'user') {\n      layer.kind = 'user';\n      layer.name = l.name;\n    }\n    return layer;\n  });\n  return { version: 2, systemLayers, nodes, ...(doc ? { doc } : {}) };\n}\n\n/** Decides what a version 1 `container` becomes; `leaf` is always a mark. */\nexport type V1Classifier<TData, TLayer extends string, TPose> =\n  (node: SerializedNodeV1<TData, TLayer, TPose>) => 'mark' | 'group';\n\n/** Options for {@link specsFromSerialized}. */\nexport interface SpecsFromSerializedOptions<TData, TLayer extends string, TPose> {\n  /** What a version 1 `container` loads as; see {@link V1Classifier}. */\n  classifyV1?: V1Classifier<TData, TLayer, TPose>;\n  /** `'skip'` loads a node whose registry key is unknown without that\n   *  function, for a save that outlived the code that registered it.\n   *  Default `'throw'`. */\n  unknownKeys?: 'throw' | 'skip';\n  /** Hears each key `unknownKeys: 'skip'` leaves out, as it is left out. */\n  onSkip?: (skipped: SkippedKey) => void;\n}\n\n/** A registry key a load left out: the node, the function field it named,\n *  and the key. */\nexport interface SkippedKey {\n  id: NodeId;\n  field: keyof SceneRegistry<unknown>;\n  key: string;\n}\n\n/** Map a `SerializedScene` to construction specs. Shared by `sceneFromJSON`\n *  (new instance) and `Scene.loadState` (in-place). Validates version and\n *  resolves every `NODE_FN_FIELDS` key → function via the registry;\n *  throws on an unsupported version, and on an unknown registry key unless\n *  `opts.unknownKeys` is `'skip'`. */\nexport function specsFromSerialized<TData, TLayer extends string, TPose>(\n  json: SerializedScene<TData, TLayer, TPose> | SerializedSceneV1<TData, TLayer, TPose>,\n  registry: SceneRegistry<TPose, TData, TLayer>,\n  opts: SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): AddNodeSpec<TData, TLayer, TPose>[] {\n  type Entry = { n: Omit<SerializedNode<TData, TLayer, TPose>, 'kind'>; kind: 'mark' | 'group' };\n  let entries: Entry[];\n  if (json.version === 1) {\n    entries = json.nodes.map((n) => ({ n, kind: nodeKindOf(1, n, opts.classifyV1) }));\n  } else if (json.version === 2) {\n    entries = json.nodes.map((n) => ({ n, kind: nodeKindOf(2, n) }));\n  } else {\n    throw new Error(`Scene: unsupported version ${String(Reflect.get(json, 'version'))}; versions 1 and 2 are supported`);\n  }\n  return entries.map(({ n, kind }) => {\n    const spec: AddNodeSpec<TData, TLayer, TPose> = {\n      id: n.id as NodeId,\n      kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent !== undefined) spec.parent = n.parent as NodeId;\n    if (n.pickable !== undefined) spec.pickable = n.pickable;\n    if (n.hidden === true) spec.hidden = true;\n    if (n.locked === true) spec.locked = true;\n    if (n.units !== undefined) spec.units = n.units;\n    if (n.clip !== undefined) spec.clip = n.clip;\n    if (n.dependsOn !== undefined) {\n      spec.dependsOn = n.dependsOn === 'children'\n        ? 'children'\n        : (n.dependsOn as readonly NodeId[]);\n    }\n    const serialized = n as unknown as Record<string, string | undefined>;\n    for (const field of NODE_FN_FIELDS) {\n      const key = serialized[field.jsonKey];\n      if (key === undefined) continue;\n      const fn = (registry[field.field] as Record<string, unknown> | undefined)?.[key];\n      if (!fn && opts.unknownKeys === 'skip') {\n        opts.onSkip?.({ id: spec.id!, field: field.field, key });\n        continue;\n      }\n      if (!fn) {\n        throw new Error(\n          `Scene: unknown ${field.field} key '${key}'. ` +\n          `Register a function with this key in the registry option.`,\n        );\n      }\n      (spec as unknown as Record<string, unknown>)[field.field] = fn;\n    }\n    if (clipsAsV1(json.version, spec)) spec.clip = 'outline';\n    return spec;\n  });\n}\n\n/** Version 1 clipped a container with no clip function to its outline, which\n *  is what `clip: 'outline'` draws on a group. One a classifier makes a mark\n *  gets no clip, since which painter claims it is not known here; one whose\n *  clip key was skipped loads as it would have without it. */\nfunction clipsAsV1(version: 1 | 2, spec: { kind: string; clipFromPose?: unknown }): boolean {\n  return version === 1 && spec.kind === 'group' && spec.clipFromPose === undefined;\n}\n\n/** The kind a saved node loads as: its own on version 2; on version 1 a `leaf` is a\n *  mark and a `container` goes to `classify`, or is a group without one. */\nexport function nodeKindOf<TData, TLayer extends string, TPose>(\n  version: 1 | 2,\n  n: SerializedNode<TData, TLayer, TPose> | SerializedNodeV1<TData, TLayer, TPose>,\n  classify?: V1Classifier<TData, TLayer, TPose>,\n): 'mark' | 'group' {\n  if (version === 2) return (n as SerializedNode<TData, TLayer, TPose>).kind;\n  if (n.kind === 'leaf') return 'mark';\n  return classify ? classify(n as SerializedNodeV1<TData, TLayer, TPose>) : 'group';\n}\n"],"mappings":"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"}
+{"version":3,"file":"serialization.js","names":[],"sources":["../../../src/core/scene/serialization.ts"],"sourcesContent":["/**\n * A scene to and from its JSON snapshot: the walk that writes one, and the\n * two readers that turn one back into layer records and node specs.\n */\nimport {\n  NODE_FN_FIELDS, fnKeysOf, type FnBearingNode, type NodeFnField,\n} from './nodeFnFields';\nimport type { SerializedDoc } from './docValues';\nimport { treePreorder } from './treeOrder';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport { localizeWorldPoses } from './worldSave';\nimport type {\n  AddNodeSpec, LayerRecord, Node, NodeId, SavedScene, SceneRegistry, SerializedLayer, SerializedNode, SerializedNodeV1,\n  SerializedScene,\n} from './types';\n\n/** Whether `value` is a snapshot `specsFromSerialized` reads, as against a live scene. */\nexport function isSerializedScene<TData, TLayer extends string, TPose>(\n  value: unknown,\n): value is SavedScene<TData, TLayer, TPose> {\n  const version = typeof value === 'object' && value != null\n    ? (value as { version?: unknown }).version : undefined;\n  return (version === 1 || version === 2 || version === 3)\n    && Array.isArray((value as { nodes?: unknown }).nodes);\n}\n\n/** What a snapshot is written from. */\nexport interface SerializableState<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  roots: NodeId[];\n  layers: LayerRecord<TLayer>[];\n}\n\n/** One layer record from its snapshot form. A snapshot with no `kind` predates\n *  user layers, so everything in it was a system layer. */\nexport function layerFromSerialized<TLayer extends string>(\n  spec: SerializedLayer<TLayer>,\n): LayerRecord<TLayer> {\n  const base = {\n    id: spec.id,\n    visible: spec.visible ?? true,\n    locked: spec.locked ?? false,\n    ...(spec.parallax ? { parallax: spec.parallax } : {}),\n    ...(spec.annotation ? { annotation: true } : {}),\n  };\n  return spec.kind === 'user'\n    ? { ...base, kind: 'user', name: spec.name ?? spec.id }\n    : { ...base, kind: 'system' };\n}\n\n/** The snapshot of `state`: layers in order, nodes in tree preorder, and the\n *  document values when there are any. Throws\n *  when a node carries a function the registry has no key for. */\nexport function serializeScene<TData, TLayer extends string, TPose>(\n  state: SerializableState<TData, TLayer, TPose>,\n  fnFields: readonly NodeFnField[],\n  doc?: SerializedDoc,\n): SerializedScene<TData, TLayer, TPose> {\n  const nodes: SerializedNode<TData, TLayer, TPose>[] = [];\n  for (const n of treePreorder(state.roots, state.nodes)) {\n    const id = n.id;\n    const out: SerializedNode<TData, TLayer, TPose> = {\n      id,\n      kind: n.kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent != null) out.parent = n.parent;\n    if (n.dependsOn === 'children') out.dependsOn = 'children';\n    else if (n.dependsOn && n.dependsOn.length > 0) out.dependsOn = n.dependsOn;\n    if (n.pickable === false) out.pickable = false;\n    if (n.hidden === true) out.hidden = true;\n    if (n.locked === true) out.locked = true;\n    if (n.units !== undefined) out.units = n.units;\n    if (n.clip !== undefined) out.clip = n.clip;\n    if (n.consumesChildren === true) out.consumesChildren = true;\n    Object.assign(\n      out,\n      fnKeysOf(fnFields, n as unknown as FnBearingNode, 'jsonKey', (field) => {\n        throw new Error(\n          `Scene.toJSON: node '${id}' has ${field.spec.field} but no matching registry key. ` +\n          `The function must be registered via createScene's registry option to round-trip.`\n        );\n      }),\n    );\n    nodes.push(out);\n  }\n  const systemLayers = state.layers.map((l) => {\n    const layer: SerializedLayer<TLayer> = { id: l.id };\n    if (l.visible === false) layer.visible = false;\n    if (l.locked === true) layer.locked = true;\n    if (l.parallax) layer.parallax = l.parallax;\n    if (l.annotation) layer.annotation = true;\n    if (l.kind === 'user') {\n      layer.kind = 'user';\n      layer.name = l.name;\n    }\n    return layer;\n  });\n  return { version: 3, systemLayers, nodes, ...(doc ? { doc } : {}) };\n}\n\n/** Decides what a version 1 `container` becomes; `leaf` is always a mark. */\nexport type V1Classifier<TData, TLayer extends string, TPose> =\n  (node: SerializedNodeV1<TData, TLayer, TPose>) => 'mark' | 'group';\n\n/** Options for {@link specsFromSerialized}. */\nexport interface SpecsFromSerializedOptions<TData, TLayer extends string, TPose> {\n  /** What a version 1 `container` loads as; see {@link V1Classifier}. */\n  classifyV1?: V1Classifier<TData, TLayer, TPose>;\n  /** `'skip'` loads a node whose registry key is unknown without that\n   *  function, for a save that outlived the code that registered it.\n   *  Default `'throw'`. */\n  unknownKeys?: 'throw' | 'skip';\n  /** Hears each key `unknownKeys: 'skip'` leaves out, as it is left out. */\n  onSkip?: (skipped: SkippedKey) => void;\n  /** How a version 1 or 2 save's world poses are made local to their\n   *  containers' frames. Default `RIGID_POSE_COMPOSITION`; a scene passes its own. */\n  composition?: PoseComposition<TPose>;\n}\n\n/** A registry key a load left out: the node, the function field it named,\n *  and the key. */\nexport interface SkippedKey {\n  id: NodeId;\n  field: keyof SceneRegistry<unknown>;\n  key: string;\n}\n\n/** Map a `SerializedScene` to construction specs. Shared by `sceneFromJSON`\n *  (new instance) and `Scene.loadState` (in-place). Validates version and\n *  resolves every `NODE_FN_FIELDS` key → function via the registry;\n *  throws on an unsupported version, and on an unknown registry key unless\n *  `opts.unknownKeys` is `'skip'`. */\nexport function specsFromSerialized<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  registry: SceneRegistry<TPose, TData, TLayer>,\n  opts: SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): AddNodeSpec<TData, TLayer, TPose>[] {\n  const specs = currentSpecs(json, registry, opts);\n  if (json.version === 3) return specs;\n  return localizeWorldPoses(specs, opts.composition ?? (RIGID_POSE_COMPOSITION as PoseComposition<TPose>));\n}\n\n/** `json`'s nodes as specs, with every pose as the save stored it. */\nfunction currentSpecs<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  registry: SceneRegistry<TPose, TData, TLayer>,\n  opts: SpecsFromSerializedOptions<TData, TLayer, TPose>,\n): AddNodeSpec<TData, TLayer, TPose>[] {\n  type Entry = { n: Omit<SerializedNode<TData, TLayer, TPose>, 'kind'>; kind: 'mark' | 'group' };\n  let entries: Entry[];\n  if (json.version === 1) {\n    entries = json.nodes.map((n) => ({ n, kind: nodeKindOf(1, n, opts.classifyV1) }));\n  } else if (json.version === 2 || json.version === 3) {\n    entries = json.nodes.map((n) => ({ n, kind: nodeKindOf(2, n) }));\n  } else {\n    throw new Error(`Scene: unsupported version ${String(Reflect.get(json, 'version'))}; versions 1, 2 and 3 are supported`);\n  }\n  return entries.map(({ n, kind }) => {\n    const spec: AddNodeSpec<TData, TLayer, TPose> = {\n      id: n.id as NodeId,\n      kind,\n      layer: n.layer,\n      pose: n.pose,\n      data: n.data,\n    };\n    if (n.parent !== undefined) spec.parent = n.parent as NodeId;\n    if (n.pickable !== undefined) spec.pickable = n.pickable;\n    if (n.hidden === true) spec.hidden = true;\n    if (n.locked === true) spec.locked = true;\n    if (n.units !== undefined) spec.units = n.units;\n    if (n.clip !== undefined) spec.clip = n.clip;\n    if (n.consumesChildren === true) spec.consumesChildren = true;\n    if (n.dependsOn !== undefined) {\n      spec.dependsOn = n.dependsOn === 'children'\n        ? 'children'\n        : (n.dependsOn as readonly NodeId[]);\n    }\n    const serialized = n as unknown as Record<string, string | undefined>;\n    for (const field of NODE_FN_FIELDS) {\n      const key = serialized[field.jsonKey];\n      if (key === undefined) continue;\n      const fn = (registry[field.field] as Record<string, unknown> | undefined)?.[key];\n      if (!fn && opts.unknownKeys === 'skip') {\n        opts.onSkip?.({ id: spec.id!, field: field.field, key });\n        continue;\n      }\n      if (!fn) {\n        throw new Error(\n          `Scene: unknown ${field.field} key '${key}'. ` +\n          `Register a function with this key in the registry option.`,\n        );\n      }\n      (spec as unknown as Record<string, unknown>)[field.field] = fn;\n    }\n    if (clipsAsV1(json.version, spec)) spec.clip = 'outline';\n    return spec;\n  });\n}\n\n/** Version 1 clipped a container with no clip function to its outline, which\n *  is what `clip: 'outline'` draws on a group. One a classifier makes a mark\n *  gets no clip, since which painter claims it is not known here; one whose\n *  clip key was skipped loads as it would have without it. */\nfunction clipsAsV1(version: 1 | 2 | 3, spec: { kind: string; clipFromPose?: unknown }): boolean {\n  return version === 1 && spec.kind === 'group' && spec.clipFromPose === undefined;\n}\n\n/** The kind a saved node loads as: its own from version 2; on version 1 a `leaf` is a\n *  mark and a `container` goes to `classify`, or is a group without one. */\nexport function nodeKindOf<TData, TLayer extends string, TPose>(\n  version: 1 | 2,\n  n: SerializedNode<TData, TLayer, TPose> | SerializedNodeV1<TData, TLayer, TPose>,\n  classify?: V1Classifier<TData, TLayer, TPose>,\n): 'mark' | 'group' {\n  if (version === 2) return (n as SerializedNode<TData, TLayer, TPose>).kind;\n  if (n.kind === 'leaf') return 'mark';\n  return classify ? classify(n as SerializedNodeV1<TData, TLayer, TPose>) : 'group';\n}\n"],"mappings":"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"}

package/dist/core/scene/statedFields.js

@@ -8,7 +8,8 @@ var statedFields = (n) => ({
 	...n.hidden === true ? { hidden: true } : {},
 	...n.locked === true ? { locked: true } : {},
 	...n.units !== void 0 ? { units: n.units } : {},
-	...n.clip !== void 0 ? { clip: n.clip } : {}
+	...n.clip !== void 0 ? { clip: n.clip } : {},
+	...n.consumesChildren === true ? { consumesChildren: true } : {}
 });
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"statedFields.js","names":[],"sources":["../../../src/core/scene/statedFields.ts"],"sourcesContent":["import type { UnitScope } from '@weasel-js/quantity';\nimport type { NodeClip } from './types';\n\n/** The plain optional fields a node or an `AddNodeSpec` may state. */\nexport interface StatedNodeFields {\n  pickable?: boolean;\n  hidden?: boolean;\n  locked?: boolean;\n  units?: UnitScope;\n  clip?: NodeClip;\n}\n\n/** The plain optional fields of a node or spec as a spread for `scene.add`:\n *  each present only when stated, so an unstated one keeps the scene's\n *  default, and a flag states only `true`. What a copy of a node carries over\n *  besides its kind, layer, pose, data and functions. */\nexport const statedFields = (n: StatedNodeFields & { kind?: string }): StatedNodeFields => ({\n  ...(n.pickable !== undefined ? { pickable: n.pickable } : {}),\n  ...(n.hidden === true ? { hidden: true } : {}),\n  ...(n.locked === true ? { locked: true } : {}),\n  ...(n.units !== undefined ? { units: n.units } : {}),\n  ...(n.clip !== undefined ? { clip: n.clip } : {}),\n});\n"],"mappings":";;;;;AAgBA,IAAa,gBAAgB,OAA+D;CAC1F,GAAI,EAAE,aAAa,SAAY,EAAE,UAAU,EAAE,SAAS,IAAI,CAAC;CAC3D,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,UAAU,SAAY,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;CAClD,GAAI,EAAE,SAAS,SAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AACjD"}
+{"version":3,"file":"statedFields.js","names":[],"sources":["../../../src/core/scene/statedFields.ts"],"sourcesContent":["import type { UnitScope } from '@weasel-js/quantity';\nimport type { NodeClip } from './types';\n\n/** The plain optional fields a node or an `AddNodeSpec` may state. */\nexport interface StatedNodeFields {\n  pickable?: boolean;\n  hidden?: boolean;\n  locked?: boolean;\n  units?: UnitScope;\n  clip?: NodeClip;\n  consumesChildren?: boolean;\n}\n\n/** The plain optional fields of a node or spec as a spread for `scene.add`:\n *  each present only when stated, so an unstated one keeps the scene's\n *  default, and a flag states only `true`. What a copy of a node carries over\n *  besides its kind, layer, pose, data and functions. */\nexport const statedFields = (n: StatedNodeFields & { kind?: string }): StatedNodeFields => ({\n  ...(n.pickable !== undefined ? { pickable: n.pickable } : {}),\n  ...(n.hidden === true ? { hidden: true } : {}),\n  ...(n.locked === true ? { locked: true } : {}),\n  ...(n.units !== undefined ? { units: n.units } : {}),\n  ...(n.clip !== undefined ? { clip: n.clip } : {}),\n  ...(n.consumesChildren === true ? { consumesChildren: true } : {}),\n});\n"],"mappings":";;;;;AAiBA,IAAa,gBAAgB,OAA+D;CAC1F,GAAI,EAAE,aAAa,SAAY,EAAE,UAAU,EAAE,SAAS,IAAI,CAAC;CAC3D,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C,GAAI,EAAE,UAAU,SAAY,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;CAClD,GAAI,EAAE,SAAS,SAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC/C,GAAI,EAAE,qBAAqB,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAClE"}

package/dist/core/scene/strategyView.js

@@ -0,0 +1,35 @@
+import { samePoseValue } from "./poseSnapshot.js";
+
+//#region src/core/scene/strategyView.ts
+/**
+* How a strategy sees a container at world `pose`: upright, in its own frame,
+* moved so its box is centered on the box `measure` gives the world pose. A
+* turned container's children are then laid out along its axes; an upright
+* one is seen as it is. `place` moves a pose from one box to another of the
+* same size.
+*/
+function strategyView(pose, { compose, decompose }, measure, place) {
+	const own = decompose(pose, pose);
+	const from = measure(own);
+	const at = measure(pose);
+	if (from === null || at === null) return null;
+	const upright = place(own, from, {
+		...from,
+		x: at.x + (at.width - from.width) / 2,
+		y: at.y + (at.height - from.height) / 2
+	});
+	const bounds = measure(upright);
+	if (bounds === null) return null;
+	const turned = !samePoseValue(upright, pose);
+	return {
+		upright,
+		bounds,
+		turned,
+		toStrategy: (p) => turned ? compose(upright, decompose(pose, p)) : p,
+		toWorld: (p) => turned ? compose(pose, decompose(upright, p)) : p
+	};
+}
+
+//#endregion
+export { strategyView };
+//# sourceMappingURL=strategyView.js.map