@weasel-js/core 1.11.0 → 1.11.1

package/dist/core/pages/fitViewToPage.js

@@ -1,4 +1,5 @@
 import { fitViewToBounds } from "../viewport/fitViewToBounds.js";
+import { pageOfBounds } from "./pages.js";
 
 //#region src/core/pages/fitViewToPage.ts
 /** The view that shows one placed page whole: `fitViewToBounds` on its rect. */
@@ -11,7 +12,17 @@ function fitViewToPage(page, viewportDims, currentView, options) {
 		height
 	}, viewportDims, currentView, options);
 }
+/** The page the view shows most of: the one overlapping the visible world rect most, or `null` when none shows. */
+function pageInView(pages, view, viewportDims) {
+	const visible = {
+		x: view.x,
+		y: view.y,
+		width: viewportDims.width / view.scale.x,
+		height: viewportDims.height / view.scale.y
+	};
+	return pageOfBounds(pages, visible);
+}
 
 //#endregion
-export { fitViewToPage };
+export { fitViewToPage, pageInView };
 //# sourceMappingURL=fitViewToPage.js.map

package/dist/core/pages/fitViewToPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"fitViewToPage.js","names":[],"sources":["../../../src/core/pages/fitViewToPage.ts"],"sourcesContent":["import {\n  fitViewToBounds,\n  type FitViewToBoundsOptions,\n  type ViewportDims,\n} from '../viewport/fitViewToBounds';\nimport type { View } from '../viewport/view';\nimport type { PlacedPage } from './pages';\n\n/** The view that shows one placed page whole: `fitViewToBounds` on its rect. */\nexport function fitViewToPage(\n  page: PlacedPage,\n  viewportDims: ViewportDims,\n  currentView: View,\n  options?: FitViewToBoundsOptions,\n): View {\n  const { x, y, width, height } = page;\n  return fitViewToBounds({ x, y, width, height }, viewportDims, currentView, options);\n}\n"],"mappings":";;;;AASA,SAAgB,cACd,MACA,cACA,aACA,SACM;CACN,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW;CAChC,OAAO,gBAAgB;EAAE;EAAG;EAAG;EAAO;CAAO,GAAG,cAAc,aAAa,OAAO;AACpF"}
+{"version":3,"file":"fitViewToPage.js","names":[],"sources":["../../../src/core/pages/fitViewToPage.ts"],"sourcesContent":["import {\n  fitViewToBounds,\n  type FitViewToBoundsOptions,\n  type ViewportDims,\n} from '../viewport/fitViewToBounds';\nimport type { View } from '../viewport/view';\nimport { pageOfBounds, type PlacedPage } from './pages';\n\n/** The view that shows one placed page whole: `fitViewToBounds` on its rect. */\nexport function fitViewToPage(\n  page: PlacedPage,\n  viewportDims: ViewportDims,\n  currentView: View,\n  options?: FitViewToBoundsOptions,\n): View {\n  const { x, y, width, height } = page;\n  return fitViewToBounds({ x, y, width, height }, viewportDims, currentView, options);\n}\n\n/** The page the view shows most of: the one overlapping the visible world rect most, or `null` when none shows. */\nexport function pageInView(\n  pages: readonly PlacedPage[],\n  view: View,\n  viewportDims: ViewportDims,\n): PlacedPage | null {\n  const visible = { x: view.x, y: view.y, width: viewportDims.width / view.scale.x, height: viewportDims.height / view.scale.y };\n  return pageOfBounds(pages, visible);\n}\n"],"mappings":";;;;;AASA,SAAgB,cACd,MACA,cACA,aACA,SACM;CACN,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW;CAChC,OAAO,gBAAgB;EAAE;EAAG;EAAG;EAAO;CAAO,GAAG,cAAc,aAAa,OAAO;AACpF;;AAGA,SAAgB,WACd,OACA,MACA,cACmB;CACnB,MAAM,UAAU;EAAE,GAAG,KAAK;EAAG,GAAG,KAAK;EAAG,OAAO,aAAa,QAAQ,KAAK,MAAM;EAAG,QAAQ,aAAa,SAAS,KAAK,MAAM;CAAE;CAC7H,OAAO,aAAa,OAAO,OAAO;AACpC"}

package/dist/core/pages/pageEdits.js

@@ -0,0 +1,164 @@
+import { effectivePose } from "../scene/effectivePose.js";
+import { layoutPages, pageOfBounds } from "./pages.js";
+import { RECT_POSE_DESCRIPTOR, poseDescriptorForNode, translatePoseViaDescriptor } from "../geometry/poseDescriptor.js";
+import { carriedDescendants, sceneCarrySource } from "../scene/carryDescendants.js";
+
+//#region src/core/pages/pageEdits.ts
+/**
+* A document's pages as a scene document value, and the edits that change
+* them. Each edit moves the nodes on a page by however far the page itself
+* moved, so what is on a page stays where it is on that page.
+*/
+/** The scene document value key a page list lives under (`scene.doc`). */
+var PAGES_DOC_KEY = "core:pages";
+var asAny = (scene) => scene;
+/** The scene's pages doc, or `null` when it has none. */
+function pagesOf(scene) {
+	return scene.doc.get(PAGES_DOC_KEY) ?? null;
+}
+/** The scene's pages, placed in world space; empty when it has no pages doc. */
+function placedPagesOf(scene) {
+	const doc = pagesOf(scene);
+	return doc ? layoutPages(doc.pages, doc.layout) : [];
+}
+/** An id none of `pages` has: `page-1`, `page-2`, and so on. */
+function nextPageId(pages) {
+	const taken = new Set(pages.map((p) => p.id));
+	let n = 1;
+	while (taken.has(`page-${n}`)) n++;
+	return `page-${n}`;
+}
+/** Whether `id` draws from other nodes and goes wherever they go. */
+function followsOthers(scene, id) {
+	const deps = scene.get(id)?.dependsOn;
+	return Array.isArray(deps) && deps.length > 0;
+}
+/**
+* The root nodes on each placed page, by page id: each root belongs to the
+* page its bounds overlap most (`pageOfBounds`). A root in the gaps belongs to
+* none, and one that derives from other nodes is left out, since it follows
+* them.
+*/
+function pageMembers(scene, placed, descriptor = RECT_POSE_DESCRIPTOR) {
+	const s = asAny(scene);
+	const out = new Map(placed.map((p) => [p.id, []]));
+	for (const id of s.roots) {
+		const node = s.get(id);
+		if (!node || followsOthers(s, id)) continue;
+		const bounds = poseDescriptorForNode(descriptor, node).getBounds(effectivePose(s, node));
+		const page = pageOfBounds(placed, bounds);
+		if (page) out.get(page.id).push(id);
+	}
+	return out;
+}
+/** Whether a node's pose derives from its children, so moving them moves it. */
+function derivesPose(scene, id) {
+	const node = scene.get(id);
+	return node?.dependsOn === "children" && node.derivePose !== void 0;
+}
+/** The stored poses that move root `id` and what it carries by `dx`, `dy`: the
+*  root, unless its pose derives from its children (then each child moves in
+*  its place), and the descendants it carries, less whatever derives its pose. */
+function pageMoveWrites(scene, id, dx, dy, descriptor, out) {
+	const node = scene.get(id);
+	if (!node || followsOthers(scene, id)) return;
+	if (derivesPose(scene, id)) {
+		for (const child of scene.childrenOf(id)) pageMoveWrites(scene, child, dx, dy, descriptor, out);
+		return;
+	}
+	const move = (pose, at) => translatePoseViaDescriptor(pose, dx, dy, poseDescriptorForNode(descriptor, scene.get(at)));
+	out.push({
+		id,
+		pose: move(node.pose, id)
+	});
+	const carried = carriedDescendants(sceneCarrySource(scene), id, (world, at) => followsOthers(scene, at) || derivesPose(scene, at) ? null : move(world, at));
+	for (const [at, pose] of carried) out.push({
+		id: at,
+		pose
+	});
+}
+/**
+* Replace the scene's pages doc with `next`, moving each page's members by
+* the change in their page's place, all as one undo entry labeled `label`.
+* Members of a page `next` drops are left where they are; `removePage` deletes
+* them first.
+*/
+function setPages(scene, next, label, options = {}) {
+	const s = asAny(scene);
+	const descriptor = options.descriptor ?? RECT_POSE_DESCRIPTOR;
+	const before = placedPagesOf(s);
+	const after = new Map(layoutPages(next.pages, next.layout).map((p) => [p.id, p]));
+	const members = pageMembers(s, before, descriptor);
+	const writes = [];
+	for (const page of before) {
+		const to = after.get(page.id);
+		if (!to) continue;
+		const dx = to.x - page.x;
+		const dy = to.y - page.y;
+		if (dx === 0 && dy === 0) continue;
+		for (const root of members.get(page.id) ?? []) pageMoveWrites(s, root, dx, dy, descriptor, writes);
+	}
+	s.batch(label, () => {
+		for (const { id, pose } of writes) s.setPose(id, pose);
+		s.doc.set(PAGES_DOC_KEY, next);
+	});
+}
+function edit(scene, fallback, options, change) {
+	const doc = pagesOf(scene) ?? { pages: [] };
+	setPages(scene, {
+		...doc,
+		pages: change([...doc.pages])
+	}, options.label ?? fallback, options);
+}
+/** Insert `page` at `index`, by default after the last page. */
+function addPage(scene, page, options = {}) {
+	edit(scene, "Add page", options, (pages) => {
+		pages.splice(options.index ?? pages.length, 0, page);
+		return pages;
+	});
+}
+/** Delete page `id`, what is on it, and every node that derives from that, as one entry. */
+function removePage(scene, id, options = {}) {
+	const label = options.label ?? "Delete page";
+	const members = pageMembers(scene, placedPagesOf(scene), options.descriptor).get(id) ?? [];
+	scene.batch(label, () => {
+		if (members.length > 0) scene.removeMany(members);
+		edit(scene, label, {
+			...options,
+			label
+		}, (pages) => pages.filter((p) => p.id !== id));
+	});
+}
+/** Move page `id` to `index` in the page order. */
+function movePage(scene, id, index, options = {}) {
+	edit(scene, "Move page", options, (pages) => {
+		const at = pages.findIndex((p) => p.id === id);
+		if (at < 0) return pages;
+		const [page] = pages.splice(at, 1);
+		pages.splice(Math.max(0, Math.min(index, pages.length)), 0, page);
+		return pages;
+	});
+}
+/** Give page `id` a new size. Its members keep their places on it; the pages after it shift. */
+function resizePage(scene, id, size, options = {}) {
+	edit(scene, "Resize page", options, (pages) => pages.map((p) => p.id === id ? {
+		...p,
+		width: size.width,
+		height: size.height
+	} : p));
+}
+/** Rename page `id`; an empty name removes it. */
+function renamePage(scene, id, name, options = {}) {
+	edit(scene, "Rename page", options, (pages) => pages.map((p) => {
+		if (p.id !== id) return p;
+		const { name: _old, ...rest } = p;
+		return name === "" ? rest : {
+			...rest,
+			name
+		};
+	}));
+}
+
+//#endregion
+export { PAGES_DOC_KEY, addPage, movePage, nextPageId, pageMembers, pagesOf, placedPagesOf, removePage, renamePage, resizePage, setPages };
+//# sourceMappingURL=pageEdits.js.map

package/dist/core/pages/pageEdits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageEdits.js","names":[],"sources":["../../../src/core/pages/pageEdits.ts"],"sourcesContent":["/**\n * A document's pages as a scene document value, and the edits that change\n * them. Each edit moves the nodes on a page by however far the page itself\n * moved, so what is on a page stays where it is on that page.\n */\nimport {\n  RECT_POSE_DESCRIPTOR, poseDescriptorForNode, translatePoseViaDescriptor, type PoseDescriptor,\n} from '../geometry/poseDescriptor';\nimport { carriedDescendants, sceneCarrySource } from '../scene/carryDescendants';\nimport { effectivePose } from '../scene/effectivePose';\nimport type { NodeId, Scene } from '../scene/types';\nimport { layoutPages, pageOfBounds, type Page, type PageLayoutOptions, type PlacedPage } from './pages';\n\n/** The document value under {@link PAGES_DOC_KEY}: the pages in order, and how they are laid out. */\nexport interface PagesDoc {\n  readonly pages: readonly Page[];\n  readonly layout?: PageLayoutOptions;\n}\n\n/** The scene document value key a page list lives under (`scene.doc`). */\nexport const PAGES_DOC_KEY = 'core:pages';\n\n/** Options every page edit takes. */\nexport interface PageEditOptions {\n  /** The undo entry's label. */\n  label?: string;\n  /** How node poses are measured and moved. Default: poses are rects. */\n  descriptor?: PoseDescriptor<unknown>;\n}\n\ntype AnyScene = Scene<unknown, string, unknown>;\nconst asAny = <TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>) =>\n  scene as unknown as AnyScene;\n\n/** The scene's pages doc, or `null` when it has none. */\nexport function pagesOf<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>): PagesDoc | null {\n  return scene.doc.get<PagesDoc>(PAGES_DOC_KEY) ?? null;\n}\n\n/** The scene's pages, placed in world space; empty when it has no pages doc. */\nexport function placedPagesOf<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>): PlacedPage[] {\n  const doc = pagesOf(scene);\n  return doc ? layoutPages(doc.pages, doc.layout) : [];\n}\n\n/** An id none of `pages` has: `page-1`, `page-2`, and so on. */\nexport function nextPageId(pages: readonly Page[]): string {\n  const taken = new Set(pages.map((p) => p.id));\n  let n = 1;\n  while (taken.has(`page-${n}`)) n++;\n  return `page-${n}`;\n}\n\n/** Whether `id` draws from other nodes and goes wherever they go. */\nfunction followsOthers(scene: AnyScene, id: NodeId): boolean {\n  const deps = scene.get(id)?.dependsOn;\n  return Array.isArray(deps) && deps.length > 0;\n}\n\n/**\n * The root nodes on each placed page, by page id: each root belongs to the\n * page its bounds overlap most (`pageOfBounds`). A root in the gaps belongs to\n * none, and one that derives from other nodes is left out, since it follows\n * them.\n */\nexport function pageMembers<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  placed: readonly PlacedPage[],\n  descriptor: PoseDescriptor<unknown> = RECT_POSE_DESCRIPTOR as PoseDescriptor<unknown>,\n): Map<string, NodeId[]> {\n  const s = asAny(scene);\n  const out = new Map<string, NodeId[]>(placed.map((p) => [p.id, []]));\n  for (const id of s.roots) {\n    const node = s.get(id);\n    if (!node || followsOthers(s, id)) continue;\n    const bounds = poseDescriptorForNode(descriptor, node).getBounds(effectivePose(s, node));\n    const page = pageOfBounds(placed, bounds);\n    if (page) out.get(page.id)!.push(id);\n  }\n  return out;\n}\n\n/** Whether a node's pose derives from its children, so moving them moves it. */\nfunction derivesPose(scene: AnyScene, id: NodeId): boolean {\n  const node = scene.get(id);\n  return node?.dependsOn === 'children' && node.derivePose !== undefined;\n}\n\n/** The stored poses that move root `id` and what it carries by `dx`, `dy`: the\n *  root, unless its pose derives from its children (then each child moves in\n *  its place), and the descendants it carries, less whatever derives its pose. */\nfunction pageMoveWrites(\n  scene: AnyScene,\n  id: NodeId,\n  dx: number,\n  dy: number,\n  descriptor: PoseDescriptor<unknown>,\n  out: { id: NodeId; pose: unknown }[],\n): void {\n  const node = scene.get(id);\n  if (!node || followsOthers(scene, id)) return;\n  if (derivesPose(scene, id)) {\n    for (const child of scene.childrenOf(id)) pageMoveWrites(scene, child, dx, dy, descriptor, out);\n    return;\n  }\n  const move = (pose: unknown, at: NodeId) => translatePoseViaDescriptor(pose, dx, dy, poseDescriptorForNode(descriptor, scene.get(at)!));\n  out.push({ id, pose: move(node.pose, id) });\n  const carried = carriedDescendants(sceneCarrySource(scene), id, (world, at) => (\n    followsOthers(scene, at) || derivesPose(scene, at) ? null : move(world, at)\n  ));\n  for (const [at, pose] of carried) out.push({ id: at, pose });\n}\n\n/**\n * Replace the scene's pages doc with `next`, moving each page's members by\n * the change in their page's place, all as one undo entry labeled `label`.\n * Members of a page `next` drops are left where they are; `removePage` deletes\n * them first.\n */\nexport function setPages<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  next: PagesDoc,\n  label: string,\n  options: Pick<PageEditOptions, 'descriptor'> = {},\n): void {\n  const s = asAny(scene);\n  const descriptor = options.descriptor ?? (RECT_POSE_DESCRIPTOR as PoseDescriptor<unknown>);\n  const before = placedPagesOf(s);\n  const after = new Map(layoutPages(next.pages, next.layout).map((p) => [p.id, p]));\n  const members = pageMembers(s, before, descriptor);\n  const writes: { id: NodeId; pose: unknown }[] = [];\n  for (const page of before) {\n    const to = after.get(page.id);\n    if (!to) continue;\n    const dx = to.x - page.x;\n    const dy = to.y - page.y;\n    if (dx === 0 && dy === 0) continue;\n    for (const root of members.get(page.id) ?? []) pageMoveWrites(s, root, dx, dy, descriptor, writes);\n  }\n  s.batch(label, () => {\n    for (const { id, pose } of writes) s.setPose(id, pose);\n    s.doc.set(PAGES_DOC_KEY, next);\n  });\n}\n\nfunction edit<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  fallback: string,\n  options: PageEditOptions,\n  change: (pages: Page[]) => Page[],\n): void {\n  const doc = pagesOf(scene) ?? { pages: [] };\n  setPages(scene, { ...doc, pages: change([...doc.pages]) }, options.label ?? fallback, options);\n}\n\n/** Insert `page` at `index`, by default after the last page. */\nexport function addPage<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  page: Page,\n  options: PageEditOptions & { index?: number } = {},\n): void {\n  edit(scene, 'Add page', options, (pages) => {\n    pages.splice(options.index ?? pages.length, 0, page);\n    return pages;\n  });\n}\n\n/** Delete page `id`, what is on it, and every node that derives from that, as one entry. */\nexport function removePage<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  id: string,\n  options: PageEditOptions = {},\n): void {\n  const label = options.label ?? 'Delete page';\n  const members = pageMembers(scene, placedPagesOf(scene), options.descriptor).get(id) ?? [];\n  scene.batch(label, () => {\n    if (members.length > 0) scene.removeMany(members);\n    edit(scene, label, { ...options, label }, (pages) => pages.filter((p) => p.id !== id));\n  });\n}\n\n/** Move page `id` to `index` in the page order. */\nexport function movePage<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  id: string,\n  index: number,\n  options: PageEditOptions = {},\n): void {\n  edit(scene, 'Move page', options, (pages) => {\n    const at = pages.findIndex((p) => p.id === id);\n    if (at < 0) return pages;\n    const [page] = pages.splice(at, 1);\n    pages.splice(Math.max(0, Math.min(index, pages.length)), 0, page!);\n    return pages;\n  });\n}\n\n/** Give page `id` a new size. Its members keep their places on it; the pages after it shift. */\nexport function resizePage<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  id: string,\n  size: { readonly width: number; readonly height: number },\n  options: PageEditOptions = {},\n): void {\n  edit(scene, 'Resize page', options, (pages) =>\n    pages.map((p) => (p.id === id ? { ...p, width: size.width, height: size.height } : p)));\n}\n\n/** Rename page `id`; an empty name removes it. */\nexport function renamePage<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  id: string,\n  name: string,\n  options: PageEditOptions = {},\n): void {\n  edit(scene, 'Rename page', options, (pages) => pages.map((p) => {\n    if (p.id !== id) return p;\n    const { name: _old, ...rest } = p;\n    return name === '' ? rest : { ...rest, name };\n  }));\n}\n"],"mappings":"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"}

package/dist/core/pages/pages.js

@@ -33,6 +33,10 @@ function layoutPages(pages, options = {}) {
 		return placed;
 	});
 }
+/** The name page `index` of the page order shows: its own, else "Page" and its place. */
+function pageName(page, index) {
+	return page.name ?? `Page ${index + 1}`;
+}
 /** The page under a world point, or `null` between and outside them. A point on an edge is on the page. */
 function pageAt(pages, point) {
 	return pageOfBounds(pages, {
@@ -64,6 +68,31 @@ function pageOfBounds(pages, bounds) {
 	}
 	return best;
 }
+function gap(page, b) {
+	const dx = Math.max(page.x - (b.x + b.width), b.x - (page.x + page.width), 0);
+	const dy = Math.max(page.y - (b.y + b.height), b.y - (page.y + page.height), 0);
+	return Math.hypot(dx, dy);
+}
+/**
+* The page a world-space box is held by: the one it is on (`pageOfBounds`),
+* else the one nearest it by the box-to-box gap, the earlier of two equally
+* near. `null` only with no pages. Used where every object must land on some
+* page, such as an export; `pageOfBounds` stays the rule for what is on one.
+*/
+function pageHolding(pages, bounds) {
+	const on = pageOfBounds(pages, bounds);
+	if (on !== null) return on;
+	let best = null;
+	let least = Infinity;
+	for (const page of pages) {
+		const d = gap(page, bounds);
+		if (d < least) {
+			best = page;
+			least = d;
+		}
+	}
+	return best;
+}
 /**
 * The page `step` places along the page order from the one with id `current`:
 * the next slide is `1`, the one before is `-1`. `null` past either end, unless
@@ -92,5 +121,5 @@ function pagesBounds(pages) {
 }
 
 //#endregion
-export { adjacentPage, layoutPages, pageAt, pageOfBounds, pagesBounds };
+export { adjacentPage, layoutPages, pageAt, pageHolding, pageName, pageOfBounds, pagesBounds };
 //# sourceMappingURL=pages.js.map

package/dist/core/pages/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","names":[],"sources":["../../../src/core/pages/pages.ts"],"sourcesContent":["import type { Bounds } from '@weasel-js/routing';\n\n/** One page of a document: a sheet of a fixed size, in world units. */\nexport interface Page {\n  readonly id: string;\n  readonly name?: string;\n  readonly width: number;\n  readonly height: number;\n}\n\n/** A page and where it sits in world space. */\nexport interface PlacedPage extends Page {\n  readonly x: number;\n  readonly y: number;\n  /** Its place in the document's page order. */\n  readonly index: number;\n}\n\n/** Options for {@link layoutPages}. */\nexport interface PageLayoutOptions {\n  /** Which way the pages run. Default `'row'`. */\n  direction?: 'row' | 'column';\n  /** World units between neighbors. Default 40. */\n  gap?: number;\n  /** Where a page sits across the run, against the largest page. Default `'start'`. */\n  align?: 'start' | 'center' | 'end';\n  /** Where the first page's run starts. Default the world origin. */\n  origin?: { readonly x: number; readonly y: number };\n}\n\nconst ALIGN = { start: 0, center: 0.5, end: 1 } as const;\n\n/**\n * Place a document's pages in one world space, in order, so a single scene,\n * view, and history serve all of them. With the defaults the first page's\n * top-left corner is the world origin, where a one-page document's page is.\n * Throws on two pages with one id.\n */\nexport function layoutPages(pages: readonly Page[], options: PageLayoutOptions = {}): PlacedPage[] {\n  const { direction = 'row', gap = 40, align = 'start', origin = { x: 0, y: 0 } } = options;\n  const row = direction === 'row';\n  const across = Math.max(0, ...pages.map((p) => (row ? p.height : p.width)));\n  const seen = new Set<string>();\n  let along = 0;\n  return pages.map((page, index) => {\n    if (seen.has(page.id)) throw new Error(`layoutPages: two pages have the id \"${page.id}\"`);\n    seen.add(page.id);\n    const offset = (across - (row ? page.height : page.width)) * ALIGN[align];\n    const placed = {\n      ...page,\n      x: origin.x + (row ? along : offset),\n      y: origin.y + (row ? offset : along),\n      index,\n    };\n    along += (row ? page.width : page.height) + gap;\n    return placed;\n  });\n}\n\n/** The page under a world point, or `null` between and outside them. A point on an edge is on the page. */\nexport function pageAt(\n  pages: readonly PlacedPage[],\n  point: { readonly x: number; readonly y: number },\n): PlacedPage | null {\n  return pageOfBounds(pages, { x: point.x, y: point.y, width: 0, height: 0 });\n}\n\nfunction overlap(page: PlacedPage, b: Bounds): number | null {\n  const w = Math.min(page.x + page.width, b.x + b.width) - Math.max(page.x, b.x);\n  const h = Math.min(page.y + page.height, b.y + b.height) - Math.max(page.y, b.y);\n  return w < 0 || h < 0 ? null : w * h;\n}\n\n/**\n * The page a world-space box belongs to: the one it overlaps most, the earlier\n * of two it overlaps equally, and `null` when it touches none. This is the\n * rule that says which page an object is on.\n */\nexport function pageOfBounds(pages: readonly PlacedPage[], bounds: Bounds): PlacedPage | null {\n  let best: PlacedPage | null = null;\n  let most = -1;\n  for (const page of pages) {\n    const area = overlap(page, bounds);\n    if (area !== null && area > most) {\n      best = page;\n      most = area;\n    }\n  }\n  return best;\n}\n\n/**\n * The page `step` places along the page order from the one with id `current`:\n * the next slide is `1`, the one before is `-1`. `null` past either end, unless\n * `wrap`. With no current page in the list, a step forward starts at the first\n * page and a step back at the last.\n */\nexport function adjacentPage(\n  pages: readonly PlacedPage[],\n  current: string | null,\n  step: number,\n  options: { wrap?: boolean } = {},\n): PlacedPage | null {\n  const n = pages.length;\n  if (n === 0) return null;\n  const at = pages.findIndex((p) => p.id === current);\n  if (at < 0) return pages[step < 0 ? n - 1 : 0] ?? null;\n  const to = at + step;\n  return pages[options.wrap ? ((to % n) + n) % n : to] ?? null;\n}\n\n/** The box around every page, or `null` for a document with none. */\nexport function pagesBounds(pages: readonly PlacedPage[]): Bounds | null {\n  if (pages.length === 0) return null;\n  const x = Math.min(...pages.map((p) => p.x));\n  const y = Math.min(...pages.map((p) => p.y));\n  return {\n    x,\n    y,\n    width: Math.max(...pages.map((p) => p.x + p.width)) - x,\n    height: Math.max(...pages.map((p) => p.y + p.height)) - y,\n  };\n}\n"],"mappings":";AA8BA,IAAM,QAAQ;CAAE,OAAO;CAAG,QAAQ;CAAK,KAAK;AAAE;;;;;;;AAQ9C,SAAgB,YAAY,OAAwB,UAA6B,CAAC,GAAiB;CACjG,MAAM,EAAE,YAAY,OAAO,MAAM,IAAI,QAAQ,SAAS,SAAS;EAAE,GAAG;EAAG,GAAG;CAAE,MAAM;CAClF,MAAM,MAAM,cAAc;CAC1B,MAAM,SAAS,KAAK,IAAI,GAAG,GAAG,MAAM,KAAK,MAAO,MAAM,EAAE,SAAS,EAAE,KAAM,CAAC;CAC1E,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI,QAAQ;CACZ,OAAO,MAAM,KAAK,MAAM,UAAU;EAChC,IAAI,KAAK,IAAI,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,uCAAuC,KAAK,GAAG,EAAE;EACxF,KAAK,IAAI,KAAK,EAAE;EAChB,MAAM,UAAU,UAAU,MAAM,KAAK,SAAS,KAAK,UAAU,MAAM;EACnE,MAAM,SAAS;GACb,GAAG;GACH,GAAG,OAAO,KAAK,MAAM,QAAQ;GAC7B,GAAG,OAAO,KAAK,MAAM,SAAS;GAC9B;EACF;EACA,UAAU,MAAM,KAAK,QAAQ,KAAK,UAAU;EAC5C,OAAO;CACT,CAAC;AACH;;AAGA,SAAgB,OACd,OACA,OACmB;CACnB,OAAO,aAAa,OAAO;EAAE,GAAG,MAAM;EAAG,GAAG,MAAM;EAAG,OAAO;EAAG,QAAQ;CAAE,CAAC;AAC5E;AAEA,SAAS,QAAQ,MAAkB,GAA0B;CAC3D,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,CAAC;CAC7E,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,CAAC;CAC/E,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI;AACrC;;;;;;AAOA,SAAgB,aAAa,OAA8B,QAAmC;CAC5F,IAAI,OAA0B;CAC9B,IAAI,OAAO;CACX,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,QAAQ,MAAM,MAAM;EACjC,IAAI,SAAS,QAAQ,OAAO,MAAM;GAChC,OAAO;GACP,OAAO;EACT;CACF;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,aACd,OACA,SACA,MACA,UAA8B,CAAC,GACZ;CACnB,MAAM,IAAI,MAAM;CAChB,IAAI,MAAM,GAAG,OAAO;CACpB,MAAM,KAAK,MAAM,WAAW,MAAM,EAAE,OAAO,OAAO;CAClD,IAAI,KAAK,GAAG,OAAO,MAAM,OAAO,IAAI,IAAI,IAAI,MAAM;CAClD,MAAM,KAAK,KAAK;CAChB,OAAO,MAAM,QAAQ,QAAS,KAAK,IAAK,KAAK,IAAI,OAAO;AAC1D;;AAGA,SAAgB,YAAY,OAA6C;CACvE,IAAI,MAAM,WAAW,GAAG,OAAO;CAC/B,MAAM,IAAI,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;CAC3C,MAAM,IAAI,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;CAC3C,OAAO;EACL;EACA;EACA,OAAO,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI;EACtD,QAAQ,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI;CAC1D;AACF"}
+{"version":3,"file":"pages.js","names":[],"sources":["../../../src/core/pages/pages.ts"],"sourcesContent":["import type { Bounds } from '@weasel-js/routing';\n\n/** One page of a document: a sheet of a fixed size, in world units. */\nexport interface Page {\n  readonly id: string;\n  readonly name?: string;\n  readonly width: number;\n  readonly height: number;\n}\n\n/** A page and where it sits in world space. */\nexport interface PlacedPage extends Page {\n  readonly x: number;\n  readonly y: number;\n  /** Its place in the document's page order. */\n  readonly index: number;\n}\n\n/** Options for {@link layoutPages}. */\nexport interface PageLayoutOptions {\n  /** Which way the pages run. Default `'row'`. */\n  direction?: 'row' | 'column';\n  /** World units between neighbors. Default 40. */\n  gap?: number;\n  /** Where a page sits across the run, against the largest page. Default `'start'`. */\n  align?: 'start' | 'center' | 'end';\n  /** Where the first page's run starts. Default the world origin. */\n  origin?: { readonly x: number; readonly y: number };\n}\n\nconst ALIGN = { start: 0, center: 0.5, end: 1 } as const;\n\n/**\n * Place a document's pages in one world space, in order, so a single scene,\n * view, and history serve all of them. With the defaults the first page's\n * top-left corner is the world origin, where a one-page document's page is.\n * Throws on two pages with one id.\n */\nexport function layoutPages(pages: readonly Page[], options: PageLayoutOptions = {}): PlacedPage[] {\n  const { direction = 'row', gap = 40, align = 'start', origin = { x: 0, y: 0 } } = options;\n  const row = direction === 'row';\n  const across = Math.max(0, ...pages.map((p) => (row ? p.height : p.width)));\n  const seen = new Set<string>();\n  let along = 0;\n  return pages.map((page, index) => {\n    if (seen.has(page.id)) throw new Error(`layoutPages: two pages have the id \"${page.id}\"`);\n    seen.add(page.id);\n    const offset = (across - (row ? page.height : page.width)) * ALIGN[align];\n    const placed = {\n      ...page,\n      x: origin.x + (row ? along : offset),\n      y: origin.y + (row ? offset : along),\n      index,\n    };\n    along += (row ? page.width : page.height) + gap;\n    return placed;\n  });\n}\n\n/** The name page `index` of the page order shows: its own, else \"Page\" and its place. */\nexport function pageName(page: { readonly name?: string | undefined }, index: number): string {\n  return page.name ?? `Page ${index + 1}`;\n}\n\n/** The page under a world point, or `null` between and outside them. A point on an edge is on the page. */\nexport function pageAt(\n  pages: readonly PlacedPage[],\n  point: { readonly x: number; readonly y: number },\n): PlacedPage | null {\n  return pageOfBounds(pages, { x: point.x, y: point.y, width: 0, height: 0 });\n}\n\nfunction overlap(page: PlacedPage, b: Bounds): number | null {\n  const w = Math.min(page.x + page.width, b.x + b.width) - Math.max(page.x, b.x);\n  const h = Math.min(page.y + page.height, b.y + b.height) - Math.max(page.y, b.y);\n  return w < 0 || h < 0 ? null : w * h;\n}\n\n/**\n * The page a world-space box belongs to: the one it overlaps most, the earlier\n * of two it overlaps equally, and `null` when it touches none. This is the\n * rule that says which page an object is on.\n */\nexport function pageOfBounds(pages: readonly PlacedPage[], bounds: Bounds): PlacedPage | null {\n  let best: PlacedPage | null = null;\n  let most = -1;\n  for (const page of pages) {\n    const area = overlap(page, bounds);\n    if (area !== null && area > most) {\n      best = page;\n      most = area;\n    }\n  }\n  return best;\n}\n\nfunction gap(page: PlacedPage, b: Bounds): number {\n  const dx = Math.max(page.x - (b.x + b.width), b.x - (page.x + page.width), 0);\n  const dy = Math.max(page.y - (b.y + b.height), b.y - (page.y + page.height), 0);\n  return Math.hypot(dx, dy);\n}\n\n/**\n * The page a world-space box is held by: the one it is on (`pageOfBounds`),\n * else the one nearest it by the box-to-box gap, the earlier of two equally\n * near. `null` only with no pages. Used where every object must land on some\n * page, such as an export; `pageOfBounds` stays the rule for what is on one.\n */\nexport function pageHolding(pages: readonly PlacedPage[], bounds: Bounds): PlacedPage | null {\n  const on = pageOfBounds(pages, bounds);\n  if (on !== null) return on;\n  let best: PlacedPage | null = null;\n  let least = Infinity;\n  for (const page of pages) {\n    const d = gap(page, bounds);\n    if (d < least) {\n      best = page;\n      least = d;\n    }\n  }\n  return best;\n}\n\n/**\n * The page `step` places along the page order from the one with id `current`:\n * the next slide is `1`, the one before is `-1`. `null` past either end, unless\n * `wrap`. With no current page in the list, a step forward starts at the first\n * page and a step back at the last.\n */\nexport function adjacentPage(\n  pages: readonly PlacedPage[],\n  current: string | null,\n  step: number,\n  options: { wrap?: boolean } = {},\n): PlacedPage | null {\n  const n = pages.length;\n  if (n === 0) return null;\n  const at = pages.findIndex((p) => p.id === current);\n  if (at < 0) return pages[step < 0 ? n - 1 : 0] ?? null;\n  const to = at + step;\n  return pages[options.wrap ? ((to % n) + n) % n : to] ?? null;\n}\n\n/** The box around every page, or `null` for a document with none. */\nexport function pagesBounds(pages: readonly PlacedPage[]): Bounds | null {\n  if (pages.length === 0) return null;\n  const x = Math.min(...pages.map((p) => p.x));\n  const y = Math.min(...pages.map((p) => p.y));\n  return {\n    x,\n    y,\n    width: Math.max(...pages.map((p) => p.x + p.width)) - x,\n    height: Math.max(...pages.map((p) => p.y + p.height)) - y,\n  };\n}\n"],"mappings":";AA8BA,IAAM,QAAQ;CAAE,OAAO;CAAG,QAAQ;CAAK,KAAK;AAAE;;;;;;;AAQ9C,SAAgB,YAAY,OAAwB,UAA6B,CAAC,GAAiB;CACjG,MAAM,EAAE,YAAY,OAAO,MAAM,IAAI,QAAQ,SAAS,SAAS;EAAE,GAAG;EAAG,GAAG;CAAE,MAAM;CAClF,MAAM,MAAM,cAAc;CAC1B,MAAM,SAAS,KAAK,IAAI,GAAG,GAAG,MAAM,KAAK,MAAO,MAAM,EAAE,SAAS,EAAE,KAAM,CAAC;CAC1E,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI,QAAQ;CACZ,OAAO,MAAM,KAAK,MAAM,UAAU;EAChC,IAAI,KAAK,IAAI,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,uCAAuC,KAAK,GAAG,EAAE;EACxF,KAAK,IAAI,KAAK,EAAE;EAChB,MAAM,UAAU,UAAU,MAAM,KAAK,SAAS,KAAK,UAAU,MAAM;EACnE,MAAM,SAAS;GACb,GAAG;GACH,GAAG,OAAO,KAAK,MAAM,QAAQ;GAC7B,GAAG,OAAO,KAAK,MAAM,SAAS;GAC9B;EACF;EACA,UAAU,MAAM,KAAK,QAAQ,KAAK,UAAU;EAC5C,OAAO;CACT,CAAC;AACH;;AAGA,SAAgB,SAAS,MAA8C,OAAuB;CAC5F,OAAO,KAAK,QAAQ,QAAQ,QAAQ;AACtC;;AAGA,SAAgB,OACd,OACA,OACmB;CACnB,OAAO,aAAa,OAAO;EAAE,GAAG,MAAM;EAAG,GAAG,MAAM;EAAG,OAAO;EAAG,QAAQ;CAAE,CAAC;AAC5E;AAEA,SAAS,QAAQ,MAAkB,GAA0B;CAC3D,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,CAAC;CAC7E,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,CAAC;CAC/E,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI;AACrC;;;;;;AAOA,SAAgB,aAAa,OAA8B,QAAmC;CAC5F,IAAI,OAA0B;CAC9B,IAAI,OAAO;CACX,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,QAAQ,MAAM,MAAM;EACjC,IAAI,SAAS,QAAQ,OAAO,MAAM;GAChC,OAAO;GACP,OAAO;EACT;CACF;CACA,OAAO;AACT;AAEA,SAAS,IAAI,MAAkB,GAAmB;CAChD,MAAM,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,KAAK,QAAQ,CAAC;CAC5E,MAAM,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,KAAK,IAAI,KAAK,SAAS,CAAC;CAC9E,OAAO,KAAK,MAAM,IAAI,EAAE;AAC1B;;;;;;;AAQA,SAAgB,YAAY,OAA8B,QAAmC;CAC3F,MAAM,KAAK,aAAa,OAAO,MAAM;CACrC,IAAI,OAAO,MAAM,OAAO;CACxB,IAAI,OAA0B;CAC9B,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,IAAI,MAAM,MAAM;EAC1B,IAAI,IAAI,OAAO;GACb,OAAO;GACP,QAAQ;EACV;CACF;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,aACd,OACA,SACA,MACA,UAA8B,CAAC,GACZ;CACnB,MAAM,IAAI,MAAM;CAChB,IAAI,MAAM,GAAG,OAAO;CACpB,MAAM,KAAK,MAAM,WAAW,MAAM,EAAE,OAAO,OAAO;CAClD,IAAI,KAAK,GAAG,OAAO,MAAM,OAAO,IAAI,IAAI,IAAI,MAAM;CAClD,MAAM,KAAK,KAAK;CAChB,OAAO,MAAM,QAAQ,QAAS,KAAK,IAAK,KAAK,IAAI,OAAO;AAC1D;;AAGA,SAAgB,YAAY,OAA6C;CACvE,IAAI,MAAM,WAAW,GAAG,OAAO;CAC/B,MAAM,IAAI,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;CAC3C,MAAM,IAAI,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;CAC3C,OAAO;EACL;EACA;EACA,OAAO,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI;EACtD,QAAQ,KAAK,IAAI,GAAG,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI;CAC1D;AACF"}

package/dist/core/scene/NodeRouting.js

@@ -1,4 +1,10 @@
 //#region src/core/scene/NodeRouting.ts
+/** The routing kind of a node: the name of the first entry whose `matches(data, node)` returns
+*  true, or `'unknown'`. What `NodeRouting.classify` answers, for a caller holding a plain list. */
+function routeKind(entries, data, node) {
+	for (const kind of entries) if (kind.matches(data, node)) return kind.name;
+	return "unknown";
+}
 /** Build a registry of per-node-kind routing entries. Registering a duplicate
 *  kind name throws. */
 function createNodeRouting() {
@@ -11,8 +17,7 @@ function createNodeRouting() {
 			entries.push(kind);
 		},
 		classify(data, node) {
-			for (const kind of entries) if (kind.matches(data, node)) return kind.name;
-			return "unknown";
+			return routeKind(entries, data, node);
 		},
 		get(name) {
 			return byName.get(name);
@@ -24,5 +29,5 @@ function createNodeRouting() {
 }
 
 //#endregion
-export { createNodeRouting };
+export { createNodeRouting, routeKind };
 //# sourceMappingURL=NodeRouting.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeRouting.js","names":[],"sources":["../../../src/core/scene/NodeRouting.ts"],"sourcesContent":["/**\n * A routing-trait classifier entry. Other traits (shape, label, icon, …)\n * are independent registries — fields like `label` or `icon` do NOT belong\n * on this interface.\n */\nexport interface NodeRoutingEntry {\n  /** Unique kind name. Routing tables key on this string. Consumer-defined;\n   *  the kit places no constraint beyond uniqueness within a registry. */\n  name: string;\n  /** Predicate over a node's `data` payload, and the node itself where the caller has one, for\n   *  a kind its data cannot show (`'container'`). First registered kind whose `matches` returns\n   *  true claims the node. */\n  matches: (data: unknown, node?: RoutedNode) => boolean;\n}\n\n/** What a routing entry may read of a node beside its data. */\nexport interface RoutedNode {\n  /** The node's structural kind: `'leaf'` or `'container'`. */\n  readonly kind?: string;\n}\n\n/**\n * The **routing trait's** registry: answers \"what routing-kind string does\n * this node's data map to?\" The result flows into declarative tool-routing\n * tables (`{ target: 'rect', actionId: 'move' }`).\n */\nexport interface NodeRouting {\n  /** Register a kind. Order matters: first match wins during `classify`.\n   *  Throws if a kind with this name is already registered. */\n  register(kind: NodeRoutingEntry): void;\n  /** Walk registered kinds in registration order; return the first kind\n   *  whose `matches(data, node)` returns true, or `'unknown'` if none match. */\n  classify(data: unknown, node?: RoutedNode): string;\n  /** Lookup a kind entry by name. */\n  get(name: string): NodeRoutingEntry | undefined;\n  /** Enumerate registered kinds in registration order. */\n  list(): readonly NodeRoutingEntry[];\n}\n\n/** Build a registry of per-node-kind routing entries. Registering a duplicate\n *  kind name throws. */\nexport function createNodeRouting(): NodeRouting {\n  const entries: NodeRoutingEntry[] = [];\n  const byName = new Map<string, NodeRoutingEntry>();\n  return {\n    register(kind) {\n      if (byName.has(kind.name)) {\n        throw new Error(\n          `createNodeRouting: duplicate kind name \"${kind.name}\"`,\n        );\n      }\n      byName.set(kind.name, kind);\n      entries.push(kind);\n    },\n    classify(data, node) {\n      for (const kind of entries) {\n        if (kind.matches(data, node)) return kind.name;\n      }\n      return 'unknown';\n    },\n    get(name) {\n      return byName.get(name);\n    },\n    list() {\n      return entries;\n    },\n  };\n}\n"],"mappings":";;;AAyCA,SAAgB,oBAAiC;CAC/C,MAAM,UAA8B,CAAC;CACrC,MAAM,yBAAS,IAAI,IAA8B;CACjD,OAAO;EACL,SAAS,MAAM;GACb,IAAI,OAAO,IAAI,KAAK,IAAI,GACtB,MAAM,IAAI,MACR,2CAA2C,KAAK,KAAK,EACvD;GAEF,OAAO,IAAI,KAAK,MAAM,IAAI;GAC1B,QAAQ,KAAK,IAAI;EACnB;EACA,SAAS,MAAM,MAAM;GACnB,KAAK,MAAM,QAAQ,SACjB,IAAI,KAAK,QAAQ,MAAM,IAAI,GAAG,OAAO,KAAK;GAE5C,OAAO;EACT;EACA,IAAI,MAAM;GACR,OAAO,OAAO,IAAI,IAAI;EACxB;EACA,OAAO;GACL,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"NodeRouting.js","names":[],"sources":["../../../src/core/scene/NodeRouting.ts"],"sourcesContent":["/**\n * A routing-trait classifier entry. Other traits (shape, label, icon, …)\n * are independent registries — fields like `label` or `icon` do NOT belong\n * on this interface.\n */\nexport interface NodeRoutingEntry {\n  /** Unique kind name. Routing tables key on this string. Consumer-defined;\n   *  the kit places no constraint beyond uniqueness within a registry. */\n  name: string;\n  /** Predicate over a node's `data` payload, and the node itself where the caller has one, for\n   *  a kind its data cannot show (`'container'`). First registered kind whose `matches` returns\n   *  true claims the node. */\n  matches: (data: unknown, node?: RoutedNode) => boolean;\n}\n\n/** What a routing entry may read of a node beside its data. */\nexport interface RoutedNode {\n  /** The node's structural kind: `'leaf'` or `'container'`. */\n  readonly kind?: string;\n}\n\n/**\n * The **routing trait's** registry: answers \"what routing-kind string does\n * this node's data map to?\" The result flows into declarative tool-routing\n * tables (`{ target: 'rect', actionId: 'move' }`).\n */\nexport interface NodeRouting {\n  /** Register a kind. Order matters: first match wins during `classify`.\n   *  Throws if a kind with this name is already registered. */\n  register(kind: NodeRoutingEntry): void;\n  /** Walk registered kinds in registration order; return the first kind\n   *  whose `matches(data, node)` returns true, or `'unknown'` if none match. */\n  classify(data: unknown, node?: RoutedNode): string;\n  /** Lookup a kind entry by name. */\n  get(name: string): NodeRoutingEntry | undefined;\n  /** Enumerate registered kinds in registration order. */\n  list(): readonly NodeRoutingEntry[];\n}\n\n/** The routing kind of a node: the name of the first entry whose `matches(data, node)` returns\n *  true, or `'unknown'`. What `NodeRouting.classify` answers, for a caller holding a plain list. */\nexport function routeKind(\n  entries: readonly NodeRoutingEntry[],\n  data: unknown,\n  node?: RoutedNode,\n): string {\n  for (const kind of entries) {\n    if (kind.matches(data, node)) return kind.name;\n  }\n  return 'unknown';\n}\n\n/** Build a registry of per-node-kind routing entries. Registering a duplicate\n *  kind name throws. */\nexport function createNodeRouting(): NodeRouting {\n  const entries: NodeRoutingEntry[] = [];\n  const byName = new Map<string, NodeRoutingEntry>();\n  return {\n    register(kind) {\n      if (byName.has(kind.name)) {\n        throw new Error(\n          `createNodeRouting: duplicate kind name \"${kind.name}\"`,\n        );\n      }\n      byName.set(kind.name, kind);\n      entries.push(kind);\n    },\n    classify(data, node) {\n      return routeKind(entries, data, node);\n    },\n    get(name) {\n      return byName.get(name);\n    },\n    list() {\n      return entries;\n    },\n  };\n}\n"],"mappings":";;;AAyCA,SAAgB,UACd,SACA,MACA,MACQ;CACR,KAAK,MAAM,QAAQ,SACjB,IAAI,KAAK,QAAQ,MAAM,IAAI,GAAG,OAAO,KAAK;CAE5C,OAAO;AACT;;;AAIA,SAAgB,oBAAiC;CAC/C,MAAM,UAA8B,CAAC;CACrC,MAAM,yBAAS,IAAI,IAA8B;CACjD,OAAO;EACL,SAAS,MAAM;GACb,IAAI,OAAO,IAAI,KAAK,IAAI,GACtB,MAAM,IAAI,MACR,2CAA2C,KAAK,KAAK,EACvD;GAEF,OAAO,IAAI,KAAK,MAAM,IAAI;GAC1B,QAAQ,KAAK,IAAI;EACnB;EACA,SAAS,MAAM,MAAM;GACnB,OAAO,UAAU,SAAS,MAAM,IAAI;EACtC;EACA,IAAI,MAAM;GACR,OAAO,OAAO,IAAI,IAAI;EACxB;EACA,OAAO;GACL,OAAO;EACT;CACF;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"arrivalWindow.js","names":[],"sources":["../../../src/core/scene/arrivalWindow.ts"],"sourcesContent":["/**\n * The scene's arrival window: what a live edit did to containers, collected\n * while it runs and handed to a layout handler before it closes.\n *\n * The window is open while a live edit is collecting the nodes that joined a\n * container, the ones that left one, and every container whose children or\n * size it changed; whoever opened the window settles it before the edit\n * closes. Undo, redo and journal replays never open it: they restore an\n * arrangement that was already decided.\n */\nimport { createEmitter } from '@weasel-js/registry';\nimport type { Op } from 'core/ops/types';\nimport { createArrangeOp, type ArrangedPose } from 'core/ops/arrange';\nimport { SceneArrivalRefused } from './arrivals';\nimport type { LayoutMove, Node, NodeId, SceneArrivalHandler } from './types';\n\n/** What the window needs from the scene it serves. */\nexport interface ArrivalWindowEnv<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  /** The pass over the scene's declared layouts, which settles arrivals once\n   *  a container has declared one. An installed handler takes its place. */\n  layoutPass: SceneArrivalHandler<TPose>;\n  /** Whether a bare scene call would record an edit of its own right now:\n   *  no batch is open and no history engine is driving. */\n  recordsBareEdits(): boolean;\n  /** Write one arranged pose. Bound into the arrange op, since not every\n   *  adapter an edit is applied through can write poses. */\n  writePose(id: string, pose: unknown): void;\n}\n\nexport interface ArrivalWindow<TPose> {\n  /** A container was given a layout: from here on the scene has arrivals to\n   *  settle even with no handler installed. */\n  layoutDeclared(): void;\n  /** Install the handler that settles arrivals. Returns its remover. */\n  setHandler(handler: SceneArrivalHandler<TPose>): () => void;\n  /** Hear the poses each live edit's settle wrote, after the edit lands. */\n  onReflow(listener: (moves: readonly LayoutMove<TPose>[]) => void): () => void;\n  noteArrival(id: NodeId, parent: NodeId | null, from: NodeId | null): void;\n  noteDeparture(id: NodeId, from: NodeId | null, to: NodeId | null): void;\n  /** A container's child set or order changed, or it changed size. */\n  noteChange(id: NodeId | null): void;\n  /** Whether a bare scene call has to run as a batch of its own, so the\n   *  layout pass it triggers lands in its undo step. */\n  bareLayoutEdit(): boolean;\n  /** Open the window when a handler wants one — or `always`, for an edit that\n   *  may give the scene its first layout partway through — and no enclosing\n   *  edit holds it already; true when this caller now owns it. */\n  open(always?: boolean): boolean;\n  /** Close the window and ask the handler what the arrivals get. Throws\n   *  `SceneArrivalRefused` when it refuses, which reverts the edit. */\n  settle(): ArrangedPose[];\n  /** Report what the settled edit wrote, now that it has landed. */\n  emitReflow(): void;\n  /** Close the window with nothing settled or reported: its owner's edit is\n   *  over, however it ended. */\n  abandon(): void;\n  /** Run an op-driven edit that may carry arrivals: a refusal reverts it and\n   *  is swallowed, the way a drop onto a full container is — nothing lands.\n   *  Returns whether the edit landed. */\n  runEdit(ops: Op[], run: (ops: Op[]) => void): boolean;\n}\n\n/** Of the ids noted per container, those the landed edit bears out: still\n *  under it when `joined`, gone from it otherwise. A container that is itself\n *  gone is left out. */\nfunction heldMoves(\n  nodes: ReadonlyMap<NodeId, { parent: NodeId | null }>,\n  noted: ReadonlyMap<NodeId, NodeId[]>,\n  joined: boolean,\n): Map<NodeId, NodeId[]> {\n  const out = new Map<NodeId, NodeId[]>();\n  for (const [parent, ids] of noted) {\n    const held = ids.filter((id) => (nodes.get(id)?.parent === parent) === joined);\n    if (held.length > 0 && nodes.has(parent)) out.set(parent, held);\n  }\n  return out;\n}\n\nexport function createArrivalWindow<TData, TLayer extends string, TPose>(\n  env: ArrivalWindowEnv<TData, TLayer, TPose>,\n): ArrivalWindow<TPose> {\n  const { nodes } = env;\n  let installed: SceneArrivalHandler<TPose> | null = null;\n  let hasLayouts = false;\n  let arrivals: Map<NodeId, NodeId[]> | null = null;\n  let departures = new Map<NodeId, NodeId[]>();\n  let changed = new Set<NodeId>();\n  /** What the last settle wrote, reported to `onReflow` once its edit lands. */\n  let reflowDue: LayoutMove<TPose>[] | null = null;\n  const reflowListeners = createEmitter<[moves: readonly LayoutMove<TPose>[]]>();\n\n  const activeHandler = (): SceneArrivalHandler<TPose> | null => installed ?? (hasLayouts ? env.layoutPass : null);\n\n  function open(always = false): boolean {\n    if (arrivals !== null || (!always && activeHandler() === null)) return false;\n    arrivals = new Map();\n    departures = new Map();\n    changed = new Set();\n    reflowDue = null;\n    return true;\n  }\n\n  function emitReflow(): void {\n    const moves = reflowDue;\n    reflowDue = null;\n    if (moves === null || moves.length === 0) return;\n    reflowListeners.emit(moves);\n  }\n\n  function settle(): ArrangedPose[] {\n    const pending = arrivals;\n    arrivals = null;\n    const handler = activeHandler();\n    if (pending === null || handler === null) return [];\n    // Only what is still there once the edit's other mutations have landed.\n    const landed = heldMoves(nodes, pending, true);\n    // Only what is gone from the container once the edit has landed: a child\n    // that left and came back did not depart.\n    const left = heldMoves(nodes, departures, false);\n    departures = new Map();\n    const touched = new Set([...changed].filter((id) => nodes.get(id)?.kind === 'container'));\n    if (landed.size === 0 && touched.size === 0) return [];\n    const poses = handler(landed, touched, left);\n    if (poses === null) throw new SceneArrivalRefused(landed);\n    const out: ArrangedPose[] = [];\n    for (const [id, to] of poses) {\n      const node = nodes.get(id);\n      if (node) out.push({ id, from: node.pose, to });\n    }\n    reflowDue = out as LayoutMove<TPose>[];\n    return out;\n  }\n\n  function abandon(): void {\n    arrivals = null;\n    reflowDue = null;\n  }\n\n  /** `ops` plus the op that settles their arrivals, when this call owns the\n   *  window; `ops` unchanged otherwise. Opened even on a scene with no layout\n   *  yet: an edit's op list is fixed before it runs, and any op in it may give\n   *  the scene its first. The arrange op that settles nothing elides itself. */\n  function withArrivalOps(ops: Op[]): { ops: Op[]; owned: boolean } {\n    if (!open(true)) return { ops, owned: false };\n    return { ops: [...ops, createArrangeOp({}, settle, env.writePose)], owned: true };\n  }\n\n  return {\n    layoutDeclared: () => { hasLayouts = true; },\n    setHandler(handler) {\n      installed = handler;\n      return () => {\n        if (installed === handler) installed = null;\n      };\n    },\n    onReflow: reflowListeners.subscribe,\n    noteArrival(id, parent, from) {\n      if (arrivals === null || parent === null || parent === from) return;\n      changed.add(parent);\n      const list = arrivals.get(parent);\n      if (list === undefined) arrivals.set(parent, [id]);\n      else if (!list.includes(id)) list.push(id);\n    },\n    noteDeparture(id, from, to) {\n      if (arrivals === null || from === null || from === to) return;\n      changed.add(from);\n      // One that joined earlier in this edit was never there to leave.\n      if (arrivals.get(from)?.includes(id)) return;\n      const list = departures.get(from);\n      if (list === undefined) departures.set(from, [id]);\n      else if (!list.includes(id)) list.push(id);\n    },\n    noteChange(id) {\n      if (arrivals !== null && id !== null) changed.add(id);\n    },\n    bareLayoutEdit: () => activeHandler() !== null && arrivals === null && env.recordsBareEdits(),\n    open,\n    settle,\n    emitReflow,\n    abandon,\n    runEdit(ops, run) {\n      const { ops: all, owned } = withArrivalOps(ops);\n      // An edit inside another's window leaves a refusal to the one that owns\n      // it, which reverts the whole edit and answers for it.\n      if (!owned) return run(all), true;\n      try {\n        run(all);\n        emitReflow();\n        return true;\n      } catch (err) {\n        if (!(err instanceof SceneArrivalRefused)) throw err;\n        return false;\n      } finally {\n        abandon();\n      }\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"arrivalWindow.js","names":[],"sources":["../../../src/core/scene/arrivalWindow.ts"],"sourcesContent":["/**\n * The scene's arrival window: what a live edit did to containers, collected\n * while it runs and handed to a layout handler before it closes.\n *\n * The window is open while a live edit is collecting the nodes that joined a\n * container, the ones that left one, and every container whose children or\n * size it changed; whoever opened the window settles it before the edit\n * closes. Undo, redo and journal replays never open it: they restore an\n * arrangement that was already decided.\n */\nimport { createEmitter } from '@weasel-js/registry';\nimport type { Op } from 'core/ops/types';\nimport { createArrangeOp, type ArrangedPose } from 'core/ops/arrange';\nimport { SceneArrivalRefused } from './arrivals';\nimport type { LayoutMove, Node, NodeId, SceneArrivalHandler } from './types';\n\n/** What the window needs from the scene it serves. */\nexport interface ArrivalWindowEnv<TData, TLayer extends string, TPose> {\n  nodes: Map<NodeId, Node<TData, TLayer, TPose>>;\n  /** The pass over the scene's declared layouts, which settles arrivals once\n   *  a container has declared one. An installed handler takes its place. */\n  layoutPass: SceneArrivalHandler<TPose>;\n  /** Whether a bare scene call would record an edit of its own right now:\n   *  no batch is open and no history engine is driving. */\n  recordsBareEdits(): boolean;\n  /** Write one arranged pose. Bound into the arrange op, since not every\n   *  adapter an edit is applied through can write poses. */\n  writePose(id: string, pose: unknown): void;\n}\n\nexport interface ArrivalWindow<TPose> {\n  /** A container was given a layout: from here on the scene has arrivals to\n   *  settle even with no handler installed. */\n  layoutDeclared(): void;\n  /** Install the handler that settles arrivals. Returns its remover. */\n  setHandler(handler: SceneArrivalHandler<TPose>): () => void;\n  /** Hear the poses each live edit's settle wrote, after the edit lands. */\n  onReflow(listener: (moves: readonly LayoutMove<TPose>[]) => void): () => void;\n  noteArrival(id: NodeId, parent: NodeId | null, from: NodeId | null): void;\n  noteDeparture(id: NodeId, from: NodeId | null, to: NodeId | null): void;\n  /** A container's child set or order changed, it changed size, or a child was posed. */\n  noteChange(id: NodeId | null): void;\n  /** Whether a bare scene call has to run as a batch of its own, so the\n   *  layout pass it triggers lands in its undo step. */\n  bareLayoutEdit(): boolean;\n  /** Open the window when a handler wants one — or `always`, for an edit that\n   *  may give the scene its first layout partway through — and no enclosing\n   *  edit holds it already; true when this caller now owns it. */\n  open(always?: boolean): boolean;\n  /** Close the window and ask the handler what the arrivals get. Throws\n   *  `SceneArrivalRefused` when it refuses, which reverts the edit. */\n  settle(): ArrangedPose[];\n  /** Report what the settled edit wrote, now that it has landed. */\n  emitReflow(): void;\n  /** Close the window with nothing settled or reported: its owner's edit is\n   *  over, however it ended. */\n  abandon(): void;\n  /** Run an op-driven edit that may carry arrivals: a refusal reverts it and\n   *  is swallowed, the way a drop onto a full container is — nothing lands.\n   *  Returns whether the edit landed. */\n  runEdit(ops: Op[], run: (ops: Op[]) => void): boolean;\n}\n\n/** Of the ids noted per container, those the landed edit bears out: still\n *  under it when `joined`, gone from it otherwise. A container that is itself\n *  gone is left out. */\nfunction heldMoves(\n  nodes: ReadonlyMap<NodeId, { parent: NodeId | null }>,\n  noted: ReadonlyMap<NodeId, NodeId[]>,\n  joined: boolean,\n): Map<NodeId, NodeId[]> {\n  const out = new Map<NodeId, NodeId[]>();\n  for (const [parent, ids] of noted) {\n    const held = ids.filter((id) => (nodes.get(id)?.parent === parent) === joined);\n    if (held.length > 0 && nodes.has(parent)) out.set(parent, held);\n  }\n  return out;\n}\n\nexport function createArrivalWindow<TData, TLayer extends string, TPose>(\n  env: ArrivalWindowEnv<TData, TLayer, TPose>,\n): ArrivalWindow<TPose> {\n  const { nodes } = env;\n  let installed: SceneArrivalHandler<TPose> | null = null;\n  let hasLayouts = false;\n  let arrivals: Map<NodeId, NodeId[]> | null = null;\n  let departures = new Map<NodeId, NodeId[]>();\n  let changed = new Set<NodeId>();\n  /** What the last settle wrote, reported to `onReflow` once its edit lands. */\n  let reflowDue: LayoutMove<TPose>[] | null = null;\n  const reflowListeners = createEmitter<[moves: readonly LayoutMove<TPose>[]]>();\n\n  const activeHandler = (): SceneArrivalHandler<TPose> | null => installed ?? (hasLayouts ? env.layoutPass : null);\n\n  function open(always = false): boolean {\n    if (arrivals !== null || (!always && activeHandler() === null)) return false;\n    arrivals = new Map();\n    departures = new Map();\n    changed = new Set();\n    reflowDue = null;\n    return true;\n  }\n\n  function emitReflow(): void {\n    const moves = reflowDue;\n    reflowDue = null;\n    if (moves === null || moves.length === 0) return;\n    reflowListeners.emit(moves);\n  }\n\n  function settle(): ArrangedPose[] {\n    const pending = arrivals;\n    arrivals = null;\n    const handler = activeHandler();\n    if (pending === null || handler === null) return [];\n    // Only what is still there once the edit's other mutations have landed.\n    const landed = heldMoves(nodes, pending, true);\n    // Only what is gone from the container once the edit has landed: a child\n    // that left and came back did not depart.\n    const left = heldMoves(nodes, departures, false);\n    departures = new Map();\n    const touched = new Set([...changed].filter((id) => nodes.get(id)?.kind === 'container'));\n    if (landed.size === 0 && touched.size === 0) return [];\n    const poses = handler(landed, touched, left);\n    if (poses === null) throw new SceneArrivalRefused(landed);\n    const out: ArrangedPose[] = [];\n    for (const [id, to] of poses) {\n      const node = nodes.get(id);\n      if (node) out.push({ id, from: node.pose, to });\n    }\n    reflowDue = out as LayoutMove<TPose>[];\n    return out;\n  }\n\n  function abandon(): void {\n    arrivals = null;\n    reflowDue = null;\n  }\n\n  /** `ops` plus the op that settles their arrivals, when this call owns the\n   *  window; `ops` unchanged otherwise. Opened even on a scene with no layout\n   *  yet: an edit's op list is fixed before it runs, and any op in it may give\n   *  the scene its first. The arrange op that settles nothing elides itself. */\n  function withArrivalOps(ops: Op[]): { ops: Op[]; owned: boolean } {\n    if (!open(true)) return { ops, owned: false };\n    return { ops: [...ops, createArrangeOp({}, settle, env.writePose)], owned: true };\n  }\n\n  return {\n    layoutDeclared: () => { hasLayouts = true; },\n    setHandler(handler) {\n      installed = handler;\n      return () => {\n        if (installed === handler) installed = null;\n      };\n    },\n    onReflow: reflowListeners.subscribe,\n    noteArrival(id, parent, from) {\n      if (arrivals === null || parent === null || parent === from) return;\n      changed.add(parent);\n      const list = arrivals.get(parent);\n      if (list === undefined) arrivals.set(parent, [id]);\n      else if (!list.includes(id)) list.push(id);\n    },\n    noteDeparture(id, from, to) {\n      if (arrivals === null || from === null || from === to) return;\n      changed.add(from);\n      // One that joined earlier in this edit was never there to leave.\n      if (arrivals.get(from)?.includes(id)) return;\n      const list = departures.get(from);\n      if (list === undefined) departures.set(from, [id]);\n      else if (!list.includes(id)) list.push(id);\n    },\n    noteChange(id) {\n      if (arrivals !== null && id !== null) changed.add(id);\n    },\n    bareLayoutEdit: () => activeHandler() !== null && arrivals === null && env.recordsBareEdits(),\n    open,\n    settle,\n    emitReflow,\n    abandon,\n    runEdit(ops, run) {\n      const { ops: all, owned } = withArrivalOps(ops);\n      // An edit inside another's window leaves a refusal to the one that owns\n      // it, which reverts the whole edit and answers for it.\n      if (!owned) return run(all), true;\n      try {\n        run(all);\n        emitReflow();\n        return true;\n      } catch (err) {\n        if (!(err instanceof SceneArrivalRefused)) throw err;\n        return false;\n      } finally {\n        abandon();\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/scene/carryDescendants.js

@@ -0,0 +1,51 @@
+import { composeWorldPose, composesFrames, frameAtOrAbove, rebaseLocalPose } from "./composeFrame.js";
+import { scenePoseAdapter } from "./scenePoseAdapter.js";
+
+//#region src/core/scene/carryDescendants.ts
+/**
+* Bringing a node's descendants along when something writes the node's pose
+* and nothing writes theirs: a layout restacking a container, a drop landing
+* one, a page move. Under absolute poses a descendant stores its own world
+* pose, so it stays behind unless it is written too.
+*/
+/** A {@link CarrySource} over a scene's document poses. */
+function sceneCarrySource(scene) {
+	return {
+		childrenOf: (id) => scene.childrenOf(id),
+		poses: scenePoseAdapter(scene),
+		composition: scene.composition
+	};
+}
+/**
+* The stored poses that bring `root`'s descendants along with it: each one's
+* world pose put through `translate`, rebased into the frame it is stored in.
+* A descendant stored in the frame of `root` or of a node under it is left
+* out, since that frame carries it, and so is one `translate` answers null
+* for. A descendant `moving` names is moving on its own: it and everything
+* under it are left to whoever moves it.
+*/
+function carriedDescendants(source, root, translate, moving = () => false) {
+	const { poses, composition } = source;
+	const framed = composesFrames(composition);
+	const under = /* @__PURE__ */ new Set([root]);
+	const out = /* @__PURE__ */ new Map();
+	const walk = (at) => {
+		for (const id of source.childrenOf(at)) {
+			if (moving(id)) continue;
+			under.add(id);
+			const parent = poses.getParent(id);
+			const frame = framed ? frameAtOrAbove(poses, parent) : null;
+			if (frame === null || !under.has(frame)) {
+				const world = translate(composeWorldPose(poses, id, composition.compose), id);
+				if (world !== null) out.set(id, rebaseLocalPose(poses, world, parent, composition.compose, composition.decompose));
+			}
+			walk(id);
+		}
+	};
+	walk(root);
+	return out;
+}
+
+//#endregion
+export { carriedDescendants, sceneCarrySource };
+//# sourceMappingURL=carryDescendants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carryDescendants.js","names":[],"sources":["../../../src/core/scene/carryDescendants.ts"],"sourcesContent":["/**\n * Bringing a node's descendants along when something writes the node's pose\n * and nothing writes theirs: a layout restacking a container, a drop landing\n * one, a page move. Under absolute poses a descendant stores its own world\n * pose, so it stays behind unless it is written too.\n */\nimport { composeWorldPose, composesFrames, frameAtOrAbove, rebaseLocalPose, type PoseAdapter, type PoseComposition } from './composeFrame';\nimport { scenePoseAdapter } from './scenePoseAdapter';\nimport type { NodeId, Scene } from './types';\n\n/** What carrying reads: the tree, every stored pose, and how poses compose. */\nexport interface CarrySource<TPose> {\n  childrenOf(id: NodeId): readonly NodeId[];\n  poses: PoseAdapter<TPose>;\n  composition: PoseComposition<TPose>;\n}\n\n/** A {@link CarrySource} over a scene's document poses. */\nexport function sceneCarrySource(scene: Scene<unknown, string, unknown>): CarrySource<unknown> {\n  return {\n    childrenOf: (id) => scene.childrenOf(id),\n    poses: scenePoseAdapter(scene),\n    composition: scene.composition,\n  };\n}\n\n/**\n * The stored poses that bring `root`'s descendants along with it: each one's\n * world pose put through `translate`, rebased into the frame it is stored in.\n * A descendant stored in the frame of `root` or of a node under it is left\n * out, since that frame carries it, and so is one `translate` answers null\n * for. A descendant `moving` names is moving on its own: it and everything\n * under it are left to whoever moves it.\n */\nexport function carriedDescendants<TPose>(\n  source: CarrySource<TPose>,\n  root: NodeId,\n  translate: (world: TPose, id: NodeId) => TPose | null,\n  moving: (id: NodeId) => boolean = () => false,\n): Map<NodeId, TPose> {\n  const { poses, composition } = source;\n  const framed = composesFrames(composition);\n  const under = new Set<NodeId>([root]);\n  const out = new Map<NodeId, TPose>();\n  const walk = (at: NodeId): void => {\n    for (const id of source.childrenOf(at)) {\n      if (moving(id)) continue;\n      under.add(id);\n      const parent = poses.getParent(id);\n      const frame = framed ? frameAtOrAbove(poses, parent) : null;\n      if (frame === null || !under.has(frame as NodeId)) {\n        const world = translate(composeWorldPose(poses, id, composition.compose), id);\n        if (world !== null) out.set(id, rebaseLocalPose(poses, world, parent, composition.compose, composition.decompose));\n      }\n      walk(id);\n    }\n  };\n  walk(root);\n  return out;\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,iBAAiB,OAA8D;CAC7F,OAAO;EACL,aAAa,OAAO,MAAM,WAAW,EAAE;EACvC,OAAO,iBAAiB,KAAK;EAC7B,aAAa,MAAM;CACrB;AACF;;;;;;;;;AAUA,SAAgB,mBACd,QACA,MACA,WACA,eAAwC,OACpB;CACpB,MAAM,EAAE,OAAO,gBAAgB;CAC/B,MAAM,SAAS,eAAe,WAAW;CACzC,MAAM,wBAAQ,IAAI,IAAY,CAAC,IAAI,CAAC;CACpC,MAAM,sBAAM,IAAI,IAAmB;CACnC,MAAM,QAAQ,OAAqB;EACjC,KAAK,MAAM,MAAM,OAAO,WAAW,EAAE,GAAG;GACtC,IAAI,OAAO,EAAE,GAAG;GAChB,MAAM,IAAI,EAAE;GACZ,MAAM,SAAS,MAAM,UAAU,EAAE;GACjC,MAAM,QAAQ,SAAS,eAAe,OAAO,MAAM,IAAI;GACvD,IAAI,UAAU,QAAQ,CAAC,MAAM,IAAI,KAAe,GAAG;IACjD,MAAM,QAAQ,UAAU,iBAAiB,OAAO,IAAI,YAAY,OAAO,GAAG,EAAE;IAC5E,IAAI,UAAU,MAAM,IAAI,IAAI,IAAI,gBAAgB,OAAO,OAAO,QAAQ,YAAY,SAAS,YAAY,SAAS,CAAC;GACnH;GACA,KAAK,EAAE;EACT;CACF;CACA,KAAK,IAAI;CACT,OAAO;AACT"}

package/dist/core/scene/docValues.js

@@ -0,0 +1,57 @@
+import { deepEqual } from "@weasel-js/registry";
+
+//#region src/core/scene/docValues.ts
+/**
+* Document state that is not a node — a document's pages, its theme — held as
+* named JSON values beside the tree, saved in its snapshot and undone with it.
+*/
+var SET_DOC = "kit:setDoc";
+function write(values, key, to) {
+	if (to === void 0) values.delete(key);
+	else values.set(key, to);
+}
+/** The snapshot side of a scene's document values, kept in `values`. */
+function createDocStore(values) {
+	return {
+		/** The values as a snapshot holds them, or `undefined` when there are none. */
+		toJSON() {
+			return values.size === 0 ? void 0 : Object.fromEntries(values);
+		},
+		/** Replace every value, outside history. */
+		reset(next) {
+			values.clear();
+			for (const [key, value] of Object.entries(next ?? {})) write(values, key, value);
+		}
+	};
+}
+/** Register `kit:setDoc` and answer with the `SceneDoc` that records it. */
+function createSceneDoc(env) {
+	const { values } = env;
+	env.register(SET_DOC, {
+		apply: (p) => {
+			const { key, to } = p;
+			write(values, key, to);
+		},
+		revert: (p) => {
+			const { key, from } = p;
+			write(values, key, from);
+		}
+	});
+	return {
+		get: (key) => values.get(key),
+		set(key, to) {
+			const from = values.get(key);
+			if (deepEqual(from, to)) return;
+			env.record(SET_DOC, {
+				key,
+				from,
+				to
+			}, "setDoc");
+		},
+		keys: () => [...values.keys()]
+	};
+}
+
+//#endregion
+export { createDocStore, createSceneDoc };
+//# sourceMappingURL=docValues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docValues.js","names":[],"sources":["../../../src/core/scene/docValues.ts"],"sourcesContent":["/**\n * Document state that is not a node — a document's pages, its theme — held as\n * named JSON values beside the tree, saved in its snapshot and undone with it.\n */\nimport { deepEqual } from '@weasel-js/registry';\nimport type { RegisteredOp } from './types';\n\n/**\n * A scene's document values. Keys are namespaced by their owner\n * (`core:pages`, `diagram:theme`); values are JSON, and are not to be mutated\n * once set. A `set` is a scene edit: undoable, part of an enclosing `batch`,\n * skipped when the value is deep-equal to the current one, and heard by\n * `subscribe`. Setting `undefined` removes the key.\n */\nexport interface SceneDoc {\n  get<T = unknown>(key: string): T | undefined;\n  set(key: string, value: unknown): void;\n  keys(): readonly string[];\n}\n\n/** The part of `Scene` that carries its document values. */\nexport interface SceneDocValues {\n  readonly doc: SceneDoc;\n}\n\n/** A snapshot's document values. */\nexport type SerializedDoc = Readonly<Record<string, unknown>>;\n\n/** `undefined` on either side means the key is absent there. */\ninterface SetDocPayload { key: string; from?: unknown; to?: unknown }\n\nconst SET_DOC = 'kit:setDoc';\n\nfunction write(values: Map<string, unknown>, key: string, to: unknown): void {\n  if (to === undefined) values.delete(key);\n  else values.set(key, to);\n}\n\n/** The snapshot side of a scene's document values, kept in `values`. */\nexport function createDocStore(values: Map<string, unknown>) {\n  return {\n    /** The values as a snapshot holds them, or `undefined` when there are none. */\n    toJSON(): SerializedDoc | undefined {\n      return values.size === 0 ? undefined : Object.fromEntries(values);\n    },\n    /** Replace every value, outside history. */\n    reset(next: SerializedDoc | undefined): void {\n      values.clear();\n      for (const [key, value] of Object.entries(next ?? {})) write(values, key, value);\n    },\n  };\n}\n\nexport interface SceneDocEnv {\n  values: Map<string, unknown>;\n  register(kind: string, handler: RegisteredOp<unknown>): void;\n  record(kind: string, payload: unknown, label: string): void;\n}\n\n/** Register `kit:setDoc` and answer with the `SceneDoc` that records it. */\nexport function createSceneDoc(env: SceneDocEnv): SceneDoc {\n  const { values } = env;\n  env.register(SET_DOC, {\n    apply: (p) => { const { key, to } = p as SetDocPayload; write(values, key, to); },\n    revert: (p) => { const { key, from } = p as SetDocPayload; write(values, key, from); },\n  });\n  return {\n    get: <T>(key: string) => values.get(key) as T | undefined,\n    set(key, to) {\n      const from = values.get(key);\n      if (deepEqual(from, to)) return;\n      env.record(SET_DOC, { key, from, to } satisfies SetDocPayload, 'setDoc');\n    },\n    keys: () => [...values.keys()],\n  };\n}\n"],"mappings":";;;;;;;AA+BA,IAAM,UAAU;AAEhB,SAAS,MAAM,QAA8B,KAAa,IAAmB;CAC3E,IAAI,OAAO,QAAW,OAAO,OAAO,GAAG;MAClC,OAAO,IAAI,KAAK,EAAE;AACzB;;AAGA,SAAgB,eAAe,QAA8B;CAC3D,OAAO;;EAEL,SAAoC;GAClC,OAAO,OAAO,SAAS,IAAI,SAAY,OAAO,YAAY,MAAM;EAClE;;EAEA,MAAM,MAAuC;GAC3C,OAAO,MAAM;GACb,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAAC,CAAC,GAAG,MAAM,QAAQ,KAAK,KAAK;EACjF;CACF;AACF;;AASA,SAAgB,eAAe,KAA4B;CACzD,MAAM,EAAE,WAAW;CACnB,IAAI,SAAS,SAAS;EACpB,QAAQ,MAAM;GAAE,MAAM,EAAE,KAAK,OAAO;GAAoB,MAAM,QAAQ,KAAK,EAAE;EAAG;EAChF,SAAS,MAAM;GAAE,MAAM,EAAE,KAAK,SAAS;GAAoB,MAAM,QAAQ,KAAK,IAAI;EAAG;CACvF,CAAC;CACD,OAAO;EACL,MAAS,QAAgB,OAAO,IAAI,GAAG;EACvC,IAAI,KAAK,IAAI;GACX,MAAM,OAAO,OAAO,IAAI,GAAG;GAC3B,IAAI,UAAU,MAAM,EAAE,GAAG;GACzB,IAAI,OAAO,SAAS;IAAE;IAAK;IAAM;GAAG,GAA2B,QAAQ;EACzE;EACA,YAAY,CAAC,GAAG,OAAO,KAAK,CAAC;CAC/B;AACF"}