@weasel-js/core 1.9.3 → 1.9.4

package/dist/canvas/deps/slice.js.map

@@ -1 +1 @@
-{"version":3,"file":"slice.js","names":["useSliceDep","depRef","useLatest","dep","useSliceDepSource","sceneRef","scene","selectionRef","selection","adapterRef","adapter","compositionRef","poseComposition","descriptorRef","poseDescriptor","sc","frame","scenePoseFrame","descriptor","AUTO_POSE_DESCRIPTOR","leaves","drawnAt","node","path","sliceablePath","drawn","drawnPose","poseDescriptorForNode","siblingIndex","pathInWorld","sel","computeSliceOps","freshNodeId","stored","storePiece","leaf","piece","ops","nextSelection","b","g","world","rotation","keepsRotation","box","baked","worldEditToStorage","dst","pose"],"sources":["../../../src/canvas/deps/slice.ts"],"sourcesContent":["/**\n * The `slice` dep `sliceAction` and `useSliceTool` commit their cuts through.\n *\n * `<SceneCanvas>` publishes `useSliceDepSource` over its own scene. A consumer\n * replaces it with `useSliceDep` (or `useDepSource('slice', …)`) from under\n * the canvas; the newest registration wins, and a canvas child registers\n * after the canvas's own.\n */\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { SliceDep } from 'interactions/actions/depSchema';\nimport type { Scene, NodeId, Node } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { Op } from 'core/ops/types';\nimport type { Path } from '@weasel-js/geom';\nimport { AUTO_POSE_DESCRIPTOR } from 'interactions/actions/resize/autoPoseDescriptor';\nimport { poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport { pathInWorld, worldEditToStorage, type PathInWorldPose } from 'features/paths/pathInWorld';\nimport { scenePoseFrame } from 'interactions/actions/poseFrame';\nimport { freshNodeId } from 'interactions/actions/defaults/freshNodeId';\nimport { computeSliceOps, type SliceLeaf } from 'interactions/actions/defaults/sliceOps';\nimport type { PoseComposition } from 'features/groups/composePose';\n\n/** Publish how a slice (knife cut) is performed, so the `slice` action can\n *  run against the consumer's geometry. */\nexport function useSliceDep(dep: SliceDep): void {\n  const depRef = useLatest(dep);\n\n  useDepSource('slice', (): SliceDep => depRef.current);\n}\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/**\n * The kit `slice` dep: cut every leaf the cut crosses and swap it for its\n * pieces in one undoable batch.\n *\n * A leaf is cut when its `data.path` is a `Path` and `poseDescriptor` can read\n * its world pose as a box and a rotation; a leaf on a locked layer, or one\n * whose geometry derives from other nodes, is passed over. Each path is drawn\n * into world space the way the renderer draws it, so a child is cut where it\n * appears, and each piece is mapped back into the source's frame: it keeps the\n * source's rotation in its pose when the descriptor can write one\n * (`withRotation`), and has the rotation baked into its path otherwise. The\n * piece's pose is then stored in its parent's frame through `poseComposition`.\n * The pieces of a selected leaf take its place in the selection.\n */\nexport function useSliceDepSource(\n  scene: Scene<unknown, string, unknown>,\n  selection: SelectionApi,\n  adapter: OpsApplier,\n  poseComposition?: PoseComposition<unknown>,\n  poseDescriptor?: PoseDescriptor<unknown>,\n): void {\n  const sceneRef = useLatest(scene);\n  const selectionRef = useLatest(selection);\n  const adapterRef = useLatest(adapter);\n  const compositionRef = useLatest(poseComposition);\n  const descriptorRef = useLatest(poseDescriptor);\n\n  useDepSource('slice', (): SliceDep => ({\n    commit(cut) {\n      const sc = sceneRef.current;\n      const frame = scenePoseFrame(sc, compositionRef.current);\n      const descriptor = descriptorRef.current ?? AUTO_POSE_DESCRIPTOR;\n      const leaves: SliceLeaf<Node<unknown, string, unknown>>[] = [];\n      const drawnAt = new Map<string, DrawnPose>();\n      for (const node of sc.renderOrderNodes()) {\n        const path = sliceablePath(sc, node);\n        if (!path) continue;\n        const drawn = drawnPose(poseDescriptorForNode(descriptor, node), frame.world(node.id));\n        if (!drawn) continue;\n        drawnAt.set(node.id, drawn);\n        leaves.push({ node, index: siblingIndex(sc, node), worldPath: pathInWorld(path, drawn.box) });\n      }\n\n      const sel = selectionRef.current;\n      const { ops, nextSelection } = computeSliceOps({\n        leaves,\n        cut,\n        nextId: freshNodeId,\n        selection: sel.get(),\n        placePiece: (leaf, piece) => {\n          const stored = storePiece(drawnAt.get(leaf.node.id)!, piece);\n          return { pose: frame.local(leaf.node.id, stored.pose), path: stored.path };\n        },\n      });\n      if (ops.length === 0) return;\n      adapterRef.current.applyOps(ops, 'Slice');\n      if (nextSelection) sel.set(nextSelection as NodeId[]);\n    },\n  }));\n}\n\n/** A leaf's world pose, and the box and rotation its path is drawn through. */\ninterface DrawnPose {\n  world: unknown;\n  g: PoseDescriptor<unknown>;\n  box: PathInWorldPose;\n}\n\nfunction drawnPose(g: PoseDescriptor<unknown>, world: unknown): DrawnPose | null {\n  const b = g.getBounds(world);\n  if (!b || ![b.x, b.y, b.width, b.height].every(Number.isFinite)) return null;\n  const rotation = g.getRotation?.(world) ?? 0;\n  return { world, g, box: { x: b.x, y: b.y, width: b.width, height: b.height, rotation } };\n}\n\n/** A world-space piece as a world pose of the source's kind plus the path it draws. */\nfunction storePiece({ world, g, box }: DrawnPose, piece: Path): { pose: unknown; path: Path } {\n  const keepsRotation = !!g.withRotation && g.supportsRotation?.(world) !== false;\n  const rotation = box.rotation ?? 0;\n  if (rotation !== 0 && !keepsRotation) {\n    const baked = worldEditToStorage({ ...box, rotation: 0 }, piece);\n    return { pose: g.fromBounds(baked.pose, world), path: baked.path };\n  }\n  const { pose: b, path } = worldEditToStorage(box, piece);\n  const dst = { x: b.x, y: b.y, width: b.width, height: b.height };\n  const pose = g.remapBounds(world, g.getBounds(world), dst);\n  return { pose: rotation !== 0 ? g.withRotation!(pose, rotation) : pose, path };\n}\n\nfunction sliceablePath(scene: Scene<unknown, string, unknown>, node: Node<unknown, string, unknown>): Path | null {\n  if (node.kind !== 'leaf' || node.derivePath || node.derivePose) return null;\n  if (scene.isLocked(node.id)) return null;\n  const path = (node.data as { path?: unknown } | null)?.path as Path | undefined;\n  return path && (path.kind === 'rect' || path.kind === 'polygon') ? path : null;\n}\n\nfunction siblingIndex(scene: Scene<unknown, string, unknown>, node: Node<unknown, string, unknown>): number {\n  const siblings = node.parent == null ? scene.roots : scene.childrenOf(node.parent);\n  return siblings.indexOf(node.id);\n}\n"],"mappings":"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"}
+{"version":3,"file":"slice.js","names":["useSliceDep","depRef","useLatest","dep","useSliceDepSource","sceneRef","scene","selectionRef","selection","adapterRef","adapter","compositionRef","poseComposition","descriptorRef","poseDescriptor","sc","frame","scenePoseFrame","descriptor","AUTO_POSE_DESCRIPTOR","leaves","drawnAt","node","path","sliceablePath","drawn","drawnPose","poseDescriptorForNode","siblingIndex","pathInWorld","sel","computeSliceOps","stored","storePiece","leaf","piece","ops","nextSelection","b","g","world","rotation","transform","poseLinearOf","keepsRotation","box","baked","worldEditToStorage","dst","pose"],"sources":["../../../src/canvas/deps/slice.ts"],"sourcesContent":["/**\n * The `slice` dep `sliceAction` and `useSliceTool` commit their cuts through.\n *\n * `<SceneCanvas>` publishes `useSliceDepSource` over its own scene. A consumer\n * replaces it with `useSliceDep` (or `useDepSource('slice', …)`) from under\n * the canvas; the newest registration wins, and a canvas child registers\n * after the canvas's own.\n */\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { SliceDep } from 'interactions/actions/depSchema';\nimport type { Scene, NodeId, Node } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { Op } from 'core/ops/types';\nimport type { Path } from '@weasel-js/geom';\nimport { AUTO_POSE_DESCRIPTOR } from 'interactions/actions/resize/autoPoseDescriptor';\nimport { poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport { pathInWorld, worldEditToStorage, type PathInWorldPose } from 'features/paths/pathInWorld';\nimport { poseLinearOf } from 'core/geometry/poseFrame';\nimport { scenePoseFrame } from 'interactions/actions/poseFrame';\nimport { computeSliceOps, type SliceLeaf } from 'interactions/actions/defaults/sliceOps';\nimport type { PoseComposition } from 'features/groups/composePose';\n\n/** Publish how a slice (knife cut) is performed, so the `slice` action can\n *  run against the consumer's geometry. */\nexport function useSliceDep(dep: SliceDep): void {\n  const depRef = useLatest(dep);\n\n  useDepSource('slice', (): SliceDep => depRef.current);\n}\n\ninterface OpsApplier {\n  applyOps(ops: Op[], label?: string): void;\n}\n\n/**\n * The kit `slice` dep: cut every leaf the cut crosses and swap it for its\n * pieces in one undoable batch.\n *\n * A leaf is cut when its `data.path` is a `Path` and `poseDescriptor` can read\n * its world pose as a box and a rotation; a leaf on a locked layer, or one\n * whose geometry derives from other nodes, is passed over. Each path is drawn\n * into world space the way the renderer draws it, so a child is cut where it\n * appears, and each piece is mapped back into the source's frame: it keeps the\n * source's rotation in its pose when the descriptor can write one\n * (`withRotation`), and has the rotation baked into its path otherwise. The\n * piece's pose is then stored in its parent's frame through `poseComposition`.\n * The pieces of a selected leaf take its place in the selection.\n */\nexport function useSliceDepSource(\n  scene: Scene<unknown, string, unknown>,\n  selection: SelectionApi,\n  adapter: OpsApplier,\n  poseComposition?: PoseComposition<unknown>,\n  poseDescriptor?: PoseDescriptor<unknown>,\n): void {\n  const sceneRef = useLatest(scene);\n  const selectionRef = useLatest(selection);\n  const adapterRef = useLatest(adapter);\n  const compositionRef = useLatest(poseComposition);\n  const descriptorRef = useLatest(poseDescriptor);\n\n  useDepSource('slice', (): SliceDep => ({\n    commit(cut) {\n      const sc = sceneRef.current;\n      const frame = scenePoseFrame(sc, compositionRef.current);\n      const descriptor = descriptorRef.current ?? AUTO_POSE_DESCRIPTOR;\n      const leaves: SliceLeaf<Node<unknown, string, unknown>>[] = [];\n      const drawnAt = new Map<string, DrawnPose>();\n      for (const node of sc.renderOrderNodes()) {\n        const path = sliceablePath(sc, node);\n        if (!path) continue;\n        const drawn = drawnPose(poseDescriptorForNode(descriptor, node), frame.world(node.id));\n        if (!drawn) continue;\n        drawnAt.set(node.id, drawn);\n        leaves.push({ node, index: siblingIndex(sc, node), worldPath: pathInWorld(path, drawn.box) });\n      }\n\n      const sel = selectionRef.current;\n      const { ops, nextSelection } = computeSliceOps({\n        leaves,\n        cut,\n        nextId: () => sc.mintId(),\n        selection: sel.get(),\n        placePiece: (leaf, piece) => {\n          const stored = storePiece(drawnAt.get(leaf.node.id)!, piece);\n          return { pose: frame.local(leaf.node.id, stored.pose), path: stored.path };\n        },\n      });\n      if (ops.length === 0) return;\n      adapterRef.current.applyOps(ops, 'Slice');\n      if (nextSelection) sel.set(nextSelection as NodeId[]);\n    },\n  }));\n}\n\n/** A leaf's world pose, and the box, rotation, and transform its path is drawn through. */\ninterface DrawnPose {\n  world: unknown;\n  g: PoseDescriptor<unknown>;\n  box: PathInWorldPose;\n}\n\nfunction drawnPose(g: PoseDescriptor<unknown>, world: unknown): DrawnPose | null {\n  const b = g.getBounds(world);\n  if (!b || ![b.x, b.y, b.width, b.height].every(Number.isFinite)) return null;\n  const rotation = g.getRotation?.(world) ?? 0;\n  const transform = poseLinearOf(world) ?? undefined;\n  return { world, g, box: { x: b.x, y: b.y, width: b.width, height: b.height, rotation, transform } };\n}\n\n/** A world-space piece as a world pose of the source's kind plus the path it draws. */\nfunction storePiece({ world, g, box }: DrawnPose, piece: Path): { pose: unknown; path: Path } {\n  const keepsRotation = !!g.withRotation && g.supportsRotation?.(world) !== false;\n  const rotation = box.rotation ?? 0;\n  if (rotation !== 0 && !keepsRotation) {\n    const baked = worldEditToStorage({ ...box, rotation: 0 }, piece);\n    return { pose: g.fromBounds(baked.pose, world), path: baked.path };\n  }\n  const { pose: b, path } = worldEditToStorage(box, piece);\n  const dst = { x: b.x, y: b.y, width: b.width, height: b.height };\n  const pose = g.remapBounds(world, g.getBounds(world), dst);\n  return { pose: rotation !== 0 ? g.withRotation!(pose, rotation) : pose, path };\n}\n\nfunction sliceablePath(scene: Scene<unknown, string, unknown>, node: Node<unknown, string, unknown>): Path | null {\n  if (node.kind !== 'leaf' || node.derivePath || node.derivePose) return null;\n  if (scene.isLocked(node.id)) return null;\n  const path = (node.data as { path?: unknown } | null)?.path as Path | undefined;\n  return path && (path.kind === 'rect' || path.kind === 'polygon') ? path : null;\n}\n\nfunction siblingIndex(scene: Scene<unknown, string, unknown>, node: Node<unknown, string, unknown>): number {\n  const siblings = node.parent == null ? scene.roots : scene.childrenOf(node.parent);\n  return siblings.indexOf(node.id);\n}\n"],"mappings":"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"}

package/dist/canvas/deps/textEdit.js

@@ -1,21 +1,22 @@
-import { useLatest as e } from "@weasel-js/react";
-import { useDepSource as t } from "@weasel-js/routing/react";
+import { isTextData as e } from "../../features/text/isTextData.js";
+import { useLatest as t } from "@weasel-js/react";
+import { useDepSource as n } from "@weasel-js/routing/react";
 //#region src/canvas/deps/textEdit.ts
-function n(n) {
-	let r = e(n);
-	t("textEdit", () => {
-		let e = r.current;
+function r(r) {
+	let i = t(r);
+	n("textEdit", () => {
+		let t = i.current;
 		return {
 			startEdit(e, t) {
 				process.env.NODE_ENV !== "production" && console.warn("weasel textEditDep: startEdit called but no useTextEdit hook is mounted in SceneCanvas. Override the \"textEdit\" dep via useDepSource(\"textEdit\", ...) to enable in-place text editing.");
 			},
-			isTextNode(t) {
-				return e.get(t)?.data?.kind === "text";
+			isTextNode(n) {
+				return e(t.get(n)?.data);
 			}
 		};
 	});
 }
 //#endregion
-export { n as useTextEditDepSource };
+export { r as useTextEditDepSource };
 
 //# sourceMappingURL=textEdit.js.map

package/dist/canvas/deps/textEdit.js.map

@@ -1 +1 @@
-{"version":3,"file":"textEdit.js","names":["useTextEditDepSource","sceneRef","useLatest","scene","sc","id"],"sources":["../../../src/canvas/deps/textEdit.ts"],"sourcesContent":["/**\n * `useTextEditDepSource` — wires the `textEdit` dep consumed by\n * `enterTextEditAction`. Kit-default implementation is a no-op stub for\n * `startEdit` plus a convention-based `isTextNode` predicate\n * (`data.kind === 'text'`). Consumers wanting real text editing override the\n * dep via their own `useDepSource('textEdit', ...)` sourced from a\n * `useSceneTextEdit` instance.\n */\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { TextEditDep } from 'interactions/actions/depSchema';\nimport type { Scene, NodeId } from 'core/scene/types';\n\nexport function useTextEditDepSource(\n  scene: Scene<unknown, string, unknown>,\n): void {\n  const sceneRef = useLatest(scene);\n\n  useDepSource('textEdit', (): TextEditDep => {\n    const sc = sceneRef.current;\n    return {\n      startEdit(_id: string, _opts?: { caret?: number | 'all' }) {\n        if (process.env.NODE_ENV !== 'production') {\n          console.warn(\n            'weasel textEditDep: startEdit called but no useTextEdit hook is mounted in SceneCanvas. ' +\n            'Override the \"textEdit\" dep via useDepSource(\"textEdit\", ...) to enable in-place text editing.',\n          );\n        }\n      },\n      isTextNode(id: string) {\n        const node = sc.get(id as NodeId);\n        return (node?.data as { kind?: string } | null | undefined)?.kind === 'text';\n      },\n    };\n  });\n}\n"],"mappings":";;;AAaA,SAAgBA,EACd,GACM;CACN,IAAMC,IAAWC,EAAUC,CAAK;CAEhC,EAAa,kBAA+B;EAC1C,IAAMC,IAAKH,EAAS;EACpB,OAAO;GACL,UAAU,GAAa,GAAoC;IACzD,AAAA,QAAA,IAAA,aAA6B,gBAC3B,QAAQ,KACN,4LAEF;GAEJ;GACA,WAAW,GAAY;IAErB,OADaG,EAAG,IAAIC,CACZ,CAAA,EAAM,MAA+C,SAAS;GACxE;EACF;CACF,CAAC;AACH"}
+{"version":3,"file":"textEdit.js","names":["useTextEditDepSource","sceneRef","useLatest","scene","sc","isTextData","id"],"sources":["../../../src/canvas/deps/textEdit.ts"],"sourcesContent":["/**\n * `useTextEditDepSource` — wires the `textEdit` dep consumed by\n * `enterTextEditAction`. Kit-default implementation is a no-op stub for\n * `startEdit` plus an `isTextNode` that asks `isTextData`. Consumers wanting real text editing override the\n * dep via their own `useDepSource('textEdit', ...)` sourced from a\n * `useSceneTextEdit` instance.\n */\nimport { useDepSource } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport type { TextEditDep } from 'interactions/actions/depSchema';\nimport type { Scene, NodeId } from 'core/scene/types';\nimport { isTextData } from 'features/text/isTextData';\n\nexport function useTextEditDepSource(\n  scene: Scene<unknown, string, unknown>,\n): void {\n  const sceneRef = useLatest(scene);\n\n  useDepSource('textEdit', (): TextEditDep => {\n    const sc = sceneRef.current;\n    return {\n      startEdit(_id: string, _opts?: { caret?: number | 'all' }) {\n        if (process.env.NODE_ENV !== 'production') {\n          console.warn(\n            'weasel textEditDep: startEdit called but no useTextEdit hook is mounted in SceneCanvas. ' +\n            'Override the \"textEdit\" dep via useDepSource(\"textEdit\", ...) to enable in-place text editing.',\n          );\n        }\n      },\n      isTextNode(id: string) {\n        return isTextData(sc.get(id as NodeId)?.data);\n      },\n    };\n  });\n}\n"],"mappings":";;;;AAaA,SAAgBA,EACd,GACM;CACN,IAAMC,IAAWC,EAAUC,CAAK;CAEhC,EAAa,kBAA+B;EAC1C,IAAMC,IAAKH,EAAS;EACpB,OAAO;GACL,UAAU,GAAa,GAAoC;IACzD,AAAA,QAAA,IAAA,aAA6B,gBAC3B,QAAQ,KACN,4LAEF;GAEJ;GACA,WAAW,GAAY;IACrB,OAAOI,EAAWD,EAAG,IAAIE,CAAY,CAAC,EAAE,IAAI;GAC9C;EACF;CACF,CAAC;AACH"}

package/dist/canvas/derivedPath.js

@@ -1,20 +1,41 @@
-import { resolveDerivedPath as e } from "../core/scene/derivedPath.js";
-import { derivedDepOf as t } from "../core/scene/effectivePose.js";
+import { createNodeMemoScope as e } from "../core/scene/nodeMemo.js";
+import { composeWorldPose as t } from "../core/scene/composeFrame.js";
+import { resolveDerivedPath as n } from "../core/scene/derivedPath.js";
+import { definesFrame as r, derivedDepOf as i, effectivePose as a } from "../core/scene/effectivePose.js";
+import { asNodeId as o } from "../core/scene/types.js";
 //#region src/canvas/derivedPath.ts
-function n(e, n) {
-	if (n === void 0) return (n) => t(e, n);
-	let i = {
-		at: n,
-		slot: s(n),
+var s = (e) => e !== void 0 && e.closure !== "identity";
+function c(e, n, i) {
+	let c = n ?? ((t) => a(e, t));
+	if (!s(i)) return c;
+	let l = {
+		getPose: (t) => {
+			let n = e.get(o(t));
+			return n ? c(n) : void 0;
+		},
+		getParent: (t) => e.get(o(t))?.parent ?? null,
+		definesFrame: (t) => {
+			let n = e.get(o(t));
+			return n === void 0 || r(n);
+		}
+	};
+	return (e) => t(l, e.id, i.compose);
+}
+function l(e, t, n) {
+	let r = p(t, n);
+	if (r === void 0) return (t) => i(e, t);
+	let a = {
+		at: c(e, t, n),
+		slot: r,
 		childrenOf: (t) => e.childrenOf(t),
 		lookup: (t) => {
 			let n = e.get(t);
-			return n === void 0 ? void 0 : new r(n, i);
+			return n === void 0 ? void 0 : new u(n, a);
 		}
 	};
-	return i.lookup;
+	return a.lookup;
 }
-var r = class {
+var u = class {
 	ctx;
 	node;
 	pose;
@@ -22,26 +43,28 @@ var r = class {
 		this.ctx = t, this.node = e, this.pose = t.at(e);
 	}
 	get path() {
-		return e(this.node, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot);
+		return n(this.node, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot);
 	}
 };
-function i(t, r) {
-	let i = n(t, r), a = r === void 0 ? void 0 : s(r), o = (e) => t.childrenOf(e);
-	return (t) => e(t, i, o, a);
+function d(e, t, r) {
+	let i = l(e, t, r), a = p(t, r), o = (t) => e.childrenOf(t);
+	return (e) => n(e, i, o, a);
 }
-var a = /* @__PURE__ */ new WeakMap(), o = 0;
-function s(e) {
-	let t = a.get(e);
-	return t === void 0 && (t = `kit:derivedPath:toPose:${o++}`, a.set(e, t)), t;
+var f = /* @__PURE__ */ new WeakMap();
+function p(t, n) {
+	let r = s(n) ? "world" : "local";
+	if (t === void 0) return r === "world" ? "kit:derivedPath:world" : void 0;
+	let i = f.get(t);
+	return i === void 0 && (i = {}, f.set(t, i)), i[r] ??= e();
 }
-function c(e, t, n) {
-	let r = i(e, n);
-	return (e, n, i, a) => e.dependsOn === void 0 ? t(e, n, i, a) : t(e, n, i, {
+function m(e, t, n, r) {
+	let i = d(e, n, r);
+	return (e, n, r, a) => e.dependsOn === void 0 ? t(e, n, r, a) : t(e, n, r, {
 		...a,
-		derivedPath: r(e)
+		derivedPath: i(e)
 	});
 }
 //#endregion
-export { e as resolveDerivedPath, n as sceneDepLookup, i as sceneDerivedPathOf, c as withDerivedPaths };
+export { n as resolveDerivedPath, l as sceneDepLookup, d as sceneDerivedPathOf, c as scenePaintedPoseOf, m as withDerivedPaths };
 
 //# sourceMappingURL=derivedPath.js.map

package/dist/canvas/derivedPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"derivedPath.js","names":["sceneDepLookup","toPose","derivedDepOf","scene","id","ctx","memoSlotFor","node","SlotDep","posed","resolveDerivedPath","sceneDerivedPathOf","depOf","slot","childrenOf","toPoseSlots","nextToPoseSlot","withDerivedPaths","derivedPathOf","drawOne","pose","view"],"sources":["../../src/canvas/derivedPath.ts"],"sourcesContent":["/**\n * The render walk's half of derived paths: resolving one against a scene, and\n * handing it to the painter.\n *\n * The resolver itself lives in `core/scene/derivedPath.ts`, beside\n * `derivedPose` — a *pose* can derive from a dependency's path, so\n * `effectivePose` has to be able to reach it.\n */\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport type { Path } from '@weasel-js/geom';\nimport { derivedDepOf } from 'core/scene/effectivePose';\nimport { resolveDerivedPath } from 'core/scene/derivedPath';\nimport type { SceneViewDrawOne } from './NodeShape';\n\nexport { resolveDerivedPath } from 'core/scene/derivedPath';\n\n/**\n * `(id) => that node, the pose it is painted at, and the path it derives` —\n * resolved against the scene, so a dependency that is itself derived resolves\n * before it is read.\n *\n * `Scene` stores absolute poses and the render walks hand `getPose` straight to\n * `drawOne`, composing nothing, so this has to read exactly what the render\n * adapters read: a derived edge is drawn from these coordinates and must meet\n * the nodes it connects. A slot's `toPose` replaces that read, so `toPose`\n * replaces it here too.\n */\nexport function sceneDepLookup<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (id: NodeId) => DerivedDep<TPose> | undefined {\n  if (toPose === undefined) return (id) => derivedDepOf(scene, id);\n  const ctx: SlotLookup<TPose> = {\n    at: toPose as (node: unknown) => TPose,\n    slot: memoSlotFor(toPose),\n    childrenOf: (id: NodeId) => scene.childrenOf(id),\n    lookup: (id: NodeId) => {\n      const node = scene.get(id);\n      return node === undefined ? undefined : new SlotDep(node, ctx);\n    },\n  };\n  return ctx.lookup;\n}\n\ninterface SlotLookup<TPose> {\n  at: (node: unknown) => TPose;\n  slot: string;\n  childrenOf: (id: NodeId) => readonly NodeId[];\n  lookup: (id: NodeId) => DerivedDep<TPose> | undefined;\n}\n\n/** A class, not an object literal with a `get path()` — see `SceneDep` in\n *  `core/scene/effectivePose.ts` for why. */\nclass SlotDep<TPose> implements DerivedDep<TPose> {\n  readonly node: Node<unknown, string, TPose>;\n  readonly pose: TPose;\n\n  constructor(posed: unknown, private readonly ctx: SlotLookup<TPose>) {\n    this.node = posed as Node<unknown, string, TPose>;\n    this.pose = ctx.at(posed);\n  }\n\n  get path(): Path | null {\n    return resolveDerivedPath(\n      this.node as never, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot,\n    );\n  }\n}\n\n/** `(node) => the path it derives`, read through {@link sceneDepLookup}. */\nexport function sceneDerivedPathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (node: Node<TData, TLayer, TPose>) => Path | null {\n  const depOf = sceneDepLookup(scene, toPose);\n  const slot = toPose === undefined ? undefined : memoSlotFor(toPose);\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  return (node) => resolveDerivedPath(node, depOf, childrenOf, slot);\n}\n\nconst toPoseSlots = new WeakMap<object, string>();\nlet nextToPoseSlot = 0;\n\n/** One memo slot per `toPose`: two slots painting one scene at different\n *  poses must not serve each other's paths. */\nfunction memoSlotFor(toPose: object): string {\n  let slot = toPoseSlots.get(toPose);\n  if (slot === undefined) {\n    slot = `kit:derivedPath:toPose:${nextToPoseSlot++}`;\n    toPoseSlots.set(toPose, slot);\n  }\n  return slot;\n}\n\n/**\n * Wrap a `drawOne` so a node that derives its geometry arrives at the painter\n * with the resolved path. The painter has no scene handle and so cannot read\n * the dependencies' poses itself; both scene walks wrap here instead.\n *\n * A node that derives nothing passes the caller's `ctx` through untouched —\n * this runs per node per frame, and an added `{ derivedPath: null }` would be\n * an allocation per node for a field no painter reads.\n */\nexport function withDerivedPaths<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): SceneViewDrawOne<TData, TLayer, TPose> {\n  const derivedPathOf = sceneDerivedPathOf(scene, toPose);\n  return (node, pose, view, ctx) => {\n    if (node.dependsOn === undefined) return drawOne(node, pose, view, ctx);\n    return drawOne(node, pose, view, { ...ctx, derivedPath: derivedPathOf(node) });\n  };\n}\n"],"mappings":";;;AA2BA,SAAgBA,EACd,GACA,GAC+C;CAC/C,IAAIC,MAAW,KAAA,GAAW,QAAQ,MAAOC,EAAaC,GAAOC,CAAE;CAC/D,IAAMC,IAAyB;EAC7B,IAAIJ;EACJ,MAAMK,EAAYL,CAAM;EACxB,aAAa,MAAeE,EAAM,WAAWC,CAAE;EAC/C,SAAS,MAAe;GACtB,IAAMG,IAAOJ,EAAM,IAAIC,CAAE;GACzB,OAAOG,MAAS,KAAA,IAAY,KAAA,IAAY,IAAIC,EAAQD,GAAMF,CAAG;EAC/D;CACF;CACA,OAAOA,EAAI;AACb;AAWA,IAAMG,IAAN,MAAkD;CAIH;CAH7C;CACA;CAEA,YAAY,GAAgB,GAAyC;EAEnE,AAF2C,KAAA,MAAAH,GAC3C,KAAK,OAAOI,GACZ,KAAK,OAAOJ,EAAI,GAAGI,CAAK;CAC1B;CAEA,IAAI,OAAoB;EACtB,OAAOC,EACL,KAAK,MAAe,KAAK,IAAI,QAAQ,KAAK,IAAI,YAAY,KAAK,IAAI,IACrE;CACF;AACF;AAGA,SAAgBC,EACd,GACA,GACmD;CACnD,IAAMC,IAAQZ,EAAeG,GAAOF,CAAM,GACpCY,IAAOZ,MAAW,KAAA,IAAY,KAAA,IAAYK,EAAYL,CAAM,GAC5Da,KAAc,MAAkCX,EAAM,WAAWC,CAAE;CACzE,QAAQ,MAASM,EAAmBH,GAAMK,GAAOE,GAAYD,CAAI;AACnE;AAEA,IAAME,oBAAc,IAAI,QAAwB,GAC5CC,IAAiB;AAIrB,SAASV,EAAY,GAAwB;CAC3C,IAAIO,IAAOE,EAAY,IAAId,CAAM;CAKjC,OAJIY,MAAS,KAAA,MACX,IAAO,0BAA0B,OACjCE,EAAY,IAAId,GAAQY,CAAI,IAEvBA;AACT;AAWA,SAAgBI,EACd,GACA,GACA,GACwC;CACxC,IAAMC,IAAgBP,EAAmBR,GAAOF,CAAM;CACtD,QAAQ,GAAM,GAAM,GAAM,MACpBM,EAAK,cAAc,KAAA,IAAkBY,EAAQZ,GAAMa,GAAMC,GAAMhB,CAAG,IAC/Dc,EAAQZ,GAAMa,GAAMC,GAAM;EAAE,GAAGhB;EAAK,aAAaa,EAAcX,CAAI;CAAE,CAAC;AAEjF"}
+{"version":3,"file":"derivedPath.js","names":["composes","composition","scenePaintedPoseOf","local","toPose","effectivePose","scene","node","poseComposition","chain","asNodeId","id","definesFrame","composeWorldPose","sceneDepLookup","slot","memoSlotFor","derivedDepOf","ctx","SlotDep","posed","resolveDerivedPath","sceneDerivedPathOf","depOf","childrenOf","toPoseScopes","frame","scopes","createNodeMemoScope","withDerivedPaths","derivedPathOf","drawOne","pose","view"],"sources":["../../src/canvas/derivedPath.ts"],"sourcesContent":["/**\n * The render walk's half of derived paths: resolving one against a scene, and\n * handing it to the painter.\n *\n * The resolver itself lives in `core/scene/derivedPath.ts`, beside\n * `derivedPose` — a *pose* can derive from a dependency's path, so\n * `effectivePose` has to be able to reach it.\n */\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport type { Path } from '@weasel-js/geom';\nimport { asNodeId } from 'core/scene/types';\nimport { definesFrame, derivedDepOf, effectivePose } from 'core/scene/effectivePose';\nimport { composeWorldPose, type PoseAdapter, type PoseComposition } from 'core/scene/composeFrame';\nimport { resolveDerivedPath } from 'core/scene/derivedPath';\nimport { createNodeMemoScope, type NodeMemoScope } from 'core/scene/nodeMemo';\nimport type { SceneViewDrawOne } from './NodeShape';\n\nexport { resolveDerivedPath } from 'core/scene/derivedPath';\n\nconst composes = <TPose>(composition: PoseComposition<TPose> | undefined): composition is PoseComposition<TPose> =>\n  composition !== undefined && composition.closure !== 'identity';\n\n/**\n * `(node) => the pose it is painted at`: the slot's `toPose` if it has one,\n * else the scene's effective pose, folded through the parent chain when\n * `poseComposition` makes a stored pose local to its container.\n */\nexport function scenePaintedPoseOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n  poseComposition?: PoseComposition<TPose>,\n): (node: Node<TData, TLayer, TPose>) => TPose {\n  const local = toPose ?? ((node: Node<TData, TLayer, TPose>) => effectivePose(scene, node));\n  if (!composes(poseComposition)) return local;\n  const chain: PoseAdapter<TPose> = {\n    getPose: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n ? local(n) : (undefined as unknown as TPose);\n    },\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    definesFrame: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n === undefined || definesFrame(n);\n    },\n  };\n  return (node) => composeWorldPose(chain, node.id, poseComposition.compose);\n}\n\n/**\n * `(id) => that node, the pose it is painted at, and the path it derives` —\n * resolved against the scene, so a dependency that is itself derived resolves\n * before it is read.\n *\n * A derived edge is drawn from these coordinates and must meet the nodes it\n * connects, so this reads the pose each one is painted at: see\n * {@link scenePaintedPoseOf}.\n */\nexport function sceneDepLookup<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n  poseComposition?: PoseComposition<TPose>,\n): (id: NodeId) => DerivedDep<TPose> | undefined {\n  const slot = memoSlotFor(toPose, poseComposition);\n  if (slot === undefined) return (id) => derivedDepOf(scene, id);\n  const ctx: SlotLookup<TPose> = {\n    at: scenePaintedPoseOf(scene, toPose, poseComposition) as (node: unknown) => TPose,\n    slot,\n    childrenOf: (id: NodeId) => scene.childrenOf(id),\n    lookup: (id: NodeId) => {\n      const node = scene.get(id);\n      return node === undefined ? undefined : new SlotDep(node, ctx);\n    },\n  };\n  return ctx.lookup;\n}\n\ninterface SlotLookup<TPose> {\n  at: (node: unknown) => TPose;\n  slot: string | NodeMemoScope;\n  childrenOf: (id: NodeId) => readonly NodeId[];\n  lookup: (id: NodeId) => DerivedDep<TPose> | undefined;\n}\n\n/** A class, not an object literal with a `get path()` — see `SceneDep` in\n *  `core/scene/effectivePose.ts` for why. */\nclass SlotDep<TPose> implements DerivedDep<TPose> {\n  readonly node: Node<unknown, string, TPose>;\n  readonly pose: TPose;\n\n  constructor(posed: unknown, private readonly ctx: SlotLookup<TPose>) {\n    this.node = posed as Node<unknown, string, TPose>;\n    this.pose = ctx.at(posed);\n  }\n\n  get path(): Path | null {\n    return resolveDerivedPath(\n      this.node as never, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot,\n    );\n  }\n}\n\n/** `(node) => the path it derives`, read through {@link sceneDepLookup}. */\nexport function sceneDerivedPathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n  poseComposition?: PoseComposition<TPose>,\n): (node: Node<TData, TLayer, TPose>) => Path | null {\n  const depOf = sceneDepLookup(scene, toPose, poseComposition);\n  const slot = memoSlotFor(toPose, poseComposition);\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  return (node) => resolveDerivedPath(node, depOf, childrenOf, slot);\n}\n\nconst toPoseScopes = new WeakMap<object, { local?: NodeMemoScope; world?: NodeMemoScope }>();\n\n/** Where one way of reading poses memoizes its paths, or `undefined` for the\n *  scene's own slot: two readers painting one scene at different poses must\n *  not serve each other's paths. Every reader composing stored poses shares a\n *  slot; a `toPose` gets a scope that is collected with the function. */\nfunction memoSlotFor<TPose>(\n  toPose: object | undefined,\n  poseComposition: PoseComposition<TPose> | undefined,\n): string | NodeMemoScope | undefined {\n  const frame = composes(poseComposition) ? 'world' : 'local';\n  if (toPose === undefined) return frame === 'world' ? 'kit:derivedPath:world' : undefined;\n  let scopes = toPoseScopes.get(toPose);\n  if (scopes === undefined) {\n    scopes = {};\n    toPoseScopes.set(toPose, scopes);\n  }\n  return (scopes[frame] ??= createNodeMemoScope());\n}\n\n/**\n * Wrap a `drawOne` so a node that derives its geometry arrives at the painter\n * with the resolved path. The painter has no scene handle and so cannot read\n * the dependencies' poses itself; both scene walks wrap here instead.\n *\n * A node that derives nothing passes the caller's `ctx` through untouched —\n * this runs per node per frame, and an added `{ derivedPath: null }` would be\n * an allocation per node for a field no painter reads.\n */\nexport function withDerivedPaths<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n  poseComposition?: PoseComposition<TPose>,\n): SceneViewDrawOne<TData, TLayer, TPose> {\n  const derivedPathOf = sceneDerivedPathOf(scene, toPose, poseComposition);\n  return (node, pose, view, ctx) => {\n    if (node.dependsOn === undefined) return drawOne(node, pose, view, ctx);\n    return drawOne(node, pose, view, { ...ctx, derivedPath: derivedPathOf(node) });\n  };\n}\n"],"mappings":";;;;;;AAmBA,IAAMA,KAAmB,MACvBC,MAAgB,KAAA,KAAaA,EAAY,YAAY;AAOvD,SAAgBC,EACd,GACA,GACA,GAC6C;CAC7C,IAAMC,IAAQC,OAAY,MAAqCC,EAAcC,GAAOC,CAAI;CACxF,IAAI,CAACP,EAASQ,CAAe,GAAG,OAAOL;CACvC,IAAMM,IAA4B;EAChC,UAAU,MAAO;GACf,IAAM,IAAIH,EAAM,IAAII,EAASC,CAAE,CAAC;GAChC,OAAO,IAAIR,EAAM,CAAC,IAAK,KAAA;EACzB;EACA,YAAY,MAAOG,EAAM,IAAII,EAASC,CAAE,CAAC,CAAC,EAAE,UAAU;EACtD,eAAe,MAAO;GACpB,IAAM,IAAIL,EAAM,IAAII,EAASC,CAAE,CAAC;GAChC,OAAO,MAAM,KAAA,KAAaC,EAAa,CAAC;EAC1C;CACF;CACA,QAAQ,MAASC,EAAiBJ,GAAOF,EAAK,IAAIC,EAAgB,OAAO;AAC3E;AAWA,SAAgBM,EACd,GACA,GACA,GAC+C;CAC/C,IAAMC,IAAOC,EAAYZ,GAAQI,CAAe;CAChD,IAAIO,MAAS,KAAA,GAAW,QAAQ,MAAOE,EAAaX,GAAOK,CAAE;CAC7D,IAAMO,IAAyB;EAC7B,IAAIhB,EAAmBI,GAAOF,GAAQI,CAAe;EACrD;EACA,aAAa,MAAeF,EAAM,WAAWK,CAAE;EAC/C,SAAS,MAAe;GACtB,IAAMJ,IAAOD,EAAM,IAAIK,CAAE;GACzB,OAAOJ,MAAS,KAAA,IAAY,KAAA,IAAY,IAAIY,EAAQZ,GAAMW,CAAG;EAC/D;CACF;CACA,OAAOA,EAAI;AACb;AAWA,IAAMC,IAAN,MAAkD;CAIH;CAH7C;CACA;CAEA,YAAY,GAAgB,GAAyC;EAEnE,AAF2C,KAAA,MAAAD,GAC3C,KAAK,OAAOE,GACZ,KAAK,OAAOF,EAAI,GAAGE,CAAK;CAC1B;CAEA,IAAI,OAAoB;EACtB,OAAOC,EACL,KAAK,MAAe,KAAK,IAAI,QAAQ,KAAK,IAAI,YAAY,KAAK,IAAI,IACrE;CACF;AACF;AAGA,SAAgBC,EACd,GACA,GACA,GACmD;CACnD,IAAMC,IAAQT,EAAeR,GAAOF,GAAQI,CAAe,GACrDO,IAAOC,EAAYZ,GAAQI,CAAe,GAC1CgB,KAAc,MAAkClB,EAAM,WAAWK,CAAE;CACzE,QAAQ,MAASU,EAAmBd,GAAMgB,GAAOC,GAAYT,CAAI;AACnE;AAEA,IAAMU,oBAAe,IAAI,QAAkE;AAM3F,SAAST,EACP,GACA,GACoC;CACpC,IAAMU,IAAQ1B,EAASQ,CAAe,IAAI,UAAU;CACpD,IAAIJ,MAAW,KAAA,GAAW,OAAOsB,MAAU,UAAU,0BAA0B,KAAA;CAC/E,IAAIC,IAASF,EAAa,IAAIrB,CAAM;CAKpC,OAJIuB,MAAW,KAAA,MACb,IAAS,CAAC,GACVF,EAAa,IAAIrB,GAAQuB,CAAM,IAEzB,EAAOD,OAAWE,EAAoB;AAChD;AAWA,SAAgBC,EACd,GACA,GACA,GACA,GACwC;CACxC,IAAMC,IAAgBR,EAAmBhB,GAAOF,GAAQI,CAAe;CACvE,QAAQ,GAAM,GAAM,GAAM,MACpBD,EAAK,cAAc,KAAA,IAAkBwB,EAAQxB,GAAMyB,GAAMC,GAAMf,CAAG,IAC/Da,EAAQxB,GAAMyB,GAAMC,GAAM;EAAE,GAAGf;EAAK,aAAaY,EAAcvB,CAAI;CAAE,CAAC;AAEjF"}

package/dist/canvas/getNodeAtPoint.js

@@ -1,14 +1,14 @@
 //#region src/canvas/getNodeAtPoint.ts
 function e(e, t) {
 	return (n, r, i) => {
-		let a = e(n, r, i), o = Array.isArray(a) ? a[0] ?? null : a;
-		if (o == null) return null;
-		let s = t?.(o) ?? null;
+		let a = e(n, r, i);
+		if (a == null) return null;
+		let o = t?.(a) ?? null;
 		return {
-			id: o,
-			kind: s?.kind ?? "unknown",
-			pose: s?.pose,
-			data: s?.data ?? { id: o }
+			id: a,
+			kind: o?.kind ?? "unknown",
+			pose: o?.pose,
+			data: o?.data ?? { id: a }
 		};
 	};
 }

package/dist/canvas/getNodeAtPoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"getNodeAtPoint.js","names":["makeGetNodeAtPoint","raw","pickEvery","wx","wy","view","id","resolved","nodeResolver"],"sources":["../../src/canvas/getNodeAtPoint.ts"],"sourcesContent":["/**\n * Stable helper for synthesizing the dispatcher's `getNodeAtPoint` callback\n * from a `pickEvery` function and an optional per-id node resolver.\n *\n * Extracted from `Canvas.tsx`'s inline `__setGetNodeAtPoint` synthesizer so\n * that `SceneCanvas` (and any other scene-aware wrapper) can build the\n * function externally and hand it to `<Canvas>` as a prop. The caller supplies\n * a `nodeResolver` that derives each hit's kind/pose/data (SceneCanvas\n * classifies the node's `data` via its routing registry).\n */\n\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/** The hit record returned by a `getNodeAtPoint` function.  Matches the\n *  shape expected by `ToolsDispatcher.__setGetNodeAtPoint`. */\nexport interface NodeAtPointHit {\n  id: string;\n  kind: string;\n  pose: unknown;\n  data: unknown;\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Resolves per-id metadata for a node (kind, pose, data). When absent,\n * kind falls back to `'unknown'` and pose/data fall back to trivial values.\n */\nexport type NodeResolver = (id: string) => { kind: string; pose: unknown; data: unknown } | null;\n\n/**\n * Build a stable `getNodeAtPoint(wx, wy)` function suitable for passing to\n * the tool dispatcher via `Canvas`'s `getNodeAtPoint` prop.\n *\n * Algorithm matches the inline synthesizer in Canvas.tsx exactly:\n * - `pickEvery` returns `string | string[] | null`\n * - When an array, the **first** element is the topmost id (front-to-back order)\n * - `nodeResolver` is called for the topmost id to get kind/pose/data\n * - When `nodeResolver` is absent or returns null, kind defaults to `'unknown'`,\n *   pose to `undefined`, data to `{ id }`\n *\n * @param pickEvery  Raw hit-test function. Same signature as the Canvas prop.\n * @param nodeResolver  Optional per-id resolver. SceneCanvas builds this from its adapter.\n */\nexport function makeGetNodeAtPoint(\n  pickEvery: (wx: number, wy: number, view?: PickView | null) => string | string[] | null,\n  nodeResolver?: NodeResolver,\n): (wx: number, wy: number, view?: PickView | null) => NodeAtPointHit | null {\n  return (wx: number, wy: number, view?: PickView | null): NodeAtPointHit | null => {\n    const raw = pickEvery(wx, wy, view);\n    // Normalize `string | string[] | null` to topmost id (first entry).\n    const id = Array.isArray(raw) ? raw[0] ?? null : raw;\n    if (id == null) return null;\n\n    const resolved = nodeResolver?.(id) ?? null;\n    const kind = resolved?.kind ?? 'unknown';\n    const pose = resolved?.pose;\n    const data = resolved?.data ?? { id };\n\n    return { id, kind, pose, data };\n  };\n}\n"],"mappings":";AA2CA,SAAgBA,EACd,GACA,GAC2E;CAC3E,QAAQ,GAAY,GAAY,MAAkD;EAChF,IAAMC,IAAMC,EAAUC,GAAIC,GAAIC,CAAI,GAE5BC,IAAK,MAAM,QAAQL,CAAG,IAAIA,EAAI,MAAM,OAAOA;EACjD,IAAIK,KAAM,MAAM,OAAO;EAEvB,IAAMC,IAAWC,IAAeF,CAAE,KAAK;EAKvC,OAAO;GAAE;GAAI,MAJAC,GAAU,QAAQ;GAIZ,MAHNA,GAAU;GAGE,MAFZA,GAAU,QAAQ,EAAE,MAAG;EAEN;CAChC;AACF"}
+{"version":3,"file":"getNodeAtPoint.js","names":["makeGetNodeAtPoint","id","pickBest","wx","wy","view","resolved","nodeResolver"],"sources":["../../src/canvas/getNodeAtPoint.ts"],"sourcesContent":["/**\n * Synthesizes the dispatcher's `getNodeAtPoint` callback from a single-hit\n * picker and an optional per-id node resolver, so `SceneCanvas` can build the\n * function and hand it to `<Canvas>` as a prop.\n */\n\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/** The hit record returned by a `getNodeAtPoint` function.  Matches the\n *  shape expected by `ToolsDispatcher.__setGetNodeAtPoint`. */\nexport interface NodeAtPointHit {\n  id: string;\n  kind: string;\n  pose: unknown;\n  data: unknown;\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Resolves per-id metadata for a node (kind, pose, data). When absent,\n * kind falls back to `'unknown'` and pose/data fall back to trivial values.\n */\nexport type NodeResolver = (id: string) => { kind: string; pose: unknown; data: unknown } | null;\n\n/**\n * Build a stable `getNodeAtPoint(wx, wy)` function suitable for passing to\n * the tool dispatcher via `Canvas`'s `getNodeAtPoint` prop.\n *\n * `nodeResolver` supplies the hit's kind/pose/data. When it is absent or\n * returns null, kind defaults to `'unknown'`, pose to `undefined`, and data to\n * `{ id }`.\n *\n * @param pickBest  Answers the one id under a world point. SceneCanvas passes\n *   the select tool's own resolution, so a click reports the node it selects.\n * @param nodeResolver  Optional per-id resolver. SceneCanvas builds this from its adapter.\n */\nexport function makeGetNodeAtPoint(\n  pickBest: (wx: number, wy: number, view?: PickView | null) => string | null,\n  nodeResolver?: NodeResolver,\n): (wx: number, wy: number, view?: PickView | null) => NodeAtPointHit | null {\n  return (wx: number, wy: number, view?: PickView | null): NodeAtPointHit | null => {\n    const id = pickBest(wx, wy, view);\n    if (id == null) return null;\n\n    const resolved = nodeResolver?.(id) ?? null;\n    const kind = resolved?.kind ?? 'unknown';\n    const pose = resolved?.pose;\n    const data = resolved?.data ?? { id };\n\n    return { id, kind, pose, data };\n  };\n}\n"],"mappings":";AAoCA,SAAgBA,EACd,GACA,GAC2E;CAC3E,QAAQ,GAAY,GAAY,MAAkD;EAChF,IAAMC,IAAKC,EAASC,GAAIC,GAAIC,CAAI;EAChC,IAAIJ,KAAM,MAAM,OAAO;EAEvB,IAAMK,IAAWC,IAAeN,CAAE,KAAK;EAKvC,OAAO;GAAE;GAAI,MAJAK,GAAU,QAAQ;GAIZ,MAHNA,GAAU;GAGE,MAFZA,GAAU,QAAQ,EAAE,MAAG;EAEN;CAChC;AACF"}

package/dist/canvas/hud.module.js

@@ -1,5 +1,5 @@
 //#region src/canvas/hud.module.css
-var e = "_hud_1hv8c_3", t = "_sized_1hv8c_17", n = "_readings_1hv8c_22 _numeric_zns9n_4", r = "_muted_1hv8c_39", i = "_absent_1hv8c_44", a = "_header_1hv8c_49", o = "_list_1hv8c_53", s = "_item_1hv8c_62", c = "_itemBest_1hv8c_68", l = "_row_1hv8c_72", u = "_stack_1hv8c_79", d = {
+var e = "_hud_4467cb", t = "_sized_4467cb", n = "_readings_4467cb _numeric_25fd0b", r = "_muted_4467cb", i = "_absent_4467cb", a = "_header_4467cb", o = "_list_4467cb", s = "_item_4467cb", c = "_itemBest_4467cb", l = "_row_4467cb", u = "_stack_4467cb", d = {
 	hud: e,
 	sized: t,
 	readings: n,

package/dist/canvas/hud.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"hud.module.js","names":["hud","sized","readings","muted","absent","header","list","item","itemBest","row","stack","hud_module_default"],"sources":["../../src/canvas/hud.module.css"],"sourcesContent":["/* The debug HUDs <Canvas> can draw: CursorCoordsHud, PickHud, ModalityHud. The\n   mono face is for the ids the pick and modality HUDs list; figures take the\n   numeric face, on a child so `.hud`'s own font cannot override it. */\n.hud {\n  position: fixed;\n  z-index: 10000;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: 6px 8px;\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n}\n\n.sized {\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.readings {\n  composes: numeric from '@weasel-js/theme/numeric.module.css';\n  display: grid;\n  grid-template-columns: auto auto;\n  column-gap: 8px;\n  margin: 0;\n}\n\n.readings dt {\n  text-align: left;\n}\n\n.readings dd {\n  margin: 0;\n  white-space: nowrap;\n}\n\n.muted {\n  color: #888;\n}\n\n/* A value that is not there: an em dash, \"off-canvas\". */\n.absent {\n  color: #888;\n  font-style: italic;\n}\n\n.header {\n  margin-bottom: 2px;\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n\n.row {\n  display: flex;\n  gap: 8px;\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n}\n"],"mappings":""}
+{"version":3,"file":"hud.module.js","names":["hud","sized","readings","muted","absent","header","list","item","itemBest","row","stack","hud_module_default"],"sources":["../../src/canvas/hud.module.css"],"sourcesContent":["/* The debug HUDs <Canvas> can draw: CursorCoordsHud, PickHud, ModalityHud. The\n   mono face is for the ids the pick and modality HUDs list; figures take the\n   numeric face, on a child so `.hud`'s own font cannot override it. */\n.hud {\n  position: fixed;\n  z-index: 900;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: 6px 8px;\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n}\n\n.sized {\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.readings {\n  composes: numeric from '@weasel-js/theme/numeric.module.css';\n  display: grid;\n  grid-template-columns: auto auto;\n  column-gap: 8px;\n  margin: 0;\n}\n\n.readings dt {\n  text-align: left;\n}\n\n.readings dd {\n  margin: 0;\n  white-space: nowrap;\n}\n\n.muted {\n  color: #888;\n}\n\n/* A value that is not there: an em dash, \"off-canvas\". */\n.absent {\n  color: #888;\n  font-style: italic;\n}\n\n.header {\n  margin-bottom: 2px;\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n\n.row {\n  display: flex;\n  gap: 8px;\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n}\n"],"mappings":""}

package/dist/canvas/kitRequirements.js

@@ -122,7 +122,7 @@ function u(e, t) {
 		case ">=": return n >= 0;
 		case ">": return n > 0;
 		case "<=": return n <= 0;
-		case "<": return n < 0;
+		case "<": return t.v.pre.length > 0 ? n < 0 : s(c(...e.triple), t.v) < 0;
 	}
 }
 function d(e, t) {
@@ -132,7 +132,7 @@ function d(e, t) {
 	for (let e of r) {
 		if (e === "") return null;
 		let t = [];
-		for (let n of e.split(/\s+/)) {
+		for (let n of e.replace(/(\^|~|>=|<=|>|<|=)\s+/g, "$1").split(/\s+/)) {
 			let e = l(n);
 			if (!e) return null;
 			t.push(...e);

package/dist/canvas/kitRequirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"kitRequirements.js","names":["KIT_VERSIONS","VERSION","UNKNOWN_SUFFIX","VERSION_RE","PARTIAL_RE","preOf","s","id","parseVersion","m","compare","i","d","a","b","x","y","v","c","parseComparator","token","op","p","nums","part","pre","M","mi","pa","lower","upper","top","holds","version","satisfiesRange","parsed","alternatives","range","alt","any","set","cs","checkRequirements","out","pkg","requires","have","running","ok"],"sources":["../../src/canvas/kitRequirements.ts"],"sourcesContent":["/**\n * Version negotiation for contributions: a `requires` map of semver ranges,\n * matched against the versions the running kit packages report.\n *\n * The range grammar is npm's everyday subset — `^`, `~`, `>=`, `>`, `<=`, `<`,\n * `=`, bare and partial versions (`1.7`, `1.x`, `*`), space for AND and `||`\n * for OR. Hyphen ranges are not read. A prerelease orders below its release,\n * without npm's rule that a range must opt into prereleases by naming one.\n */\nimport { VERSION } from '../version';\n\n/**\n * The versions a contribution can require, keyed by package without its\n * `@weasel-js/` scope. Only core reports its version today.\n */\nexport interface KitVersions {\n  core: string;\n}\n\n/** A contribution's `requires`: a semver range per package it was written against. */\nexport type KitRequirements = { readonly [K in keyof KitVersions]?: string };\n\n/** The running kit's versions. */\nexport const KIT_VERSIONS: Readonly<KitVersions> = { core: VERSION };\n\n/** One requirement the running kit does not meet. */\nexport interface RequirementMismatch {\n  package: string;\n  range: string;\n  /** The running version, or `undefined` when that package reports none. */\n  running: string | undefined;\n  reason: 'unsatisfied' | 'invalid-range' | 'unknown-package';\n}\n\ntype Triple = readonly [number, number, number];\ninterface Version { triple: Triple; pre: readonly (string | number)[] }\ninterface Comparator { op: '>=' | '<' | '>' | '<='; v: Version }\n\nconst UNKNOWN_SUFFIX = '-unknown';\nconst VERSION_RE = /^v?(\\d+)\\.(\\d+)\\.(\\d+)(?:-([0-9A-Za-z.-]+))?(?:\\+[0-9A-Za-z.-]+)?$/;\nconst PARTIAL_RE = /^v?(\\d+|[xX*])(?:\\.(\\d+|[xX*]))?(?:\\.(\\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nfunction preOf(s: string | undefined): (string | number)[] {\n  return s ? s.split('.').map((id) => (/^\\d+$/.test(id) ? Number(id) : id)) : [];\n}\n\nfunction parseVersion(s: string): Version | null {\n  const m = VERSION_RE.exec(s.trim());\n  return m ? { triple: [Number(m[1]), Number(m[2]), Number(m[3])], pre: preOf(m[4]) } : null;\n}\n\nfunction compare(a: Version, b: Version): number {\n  for (let i = 0; i < 3; i++) {\n    const d = a.triple[i]! - b.triple[i]!;\n    if (d !== 0) return d;\n  }\n  if (a.pre.length === 0 || b.pre.length === 0) return b.pre.length - a.pre.length;\n  for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {\n    const x = a.pre[i];\n    const y = b.pre[i];\n    if (x === undefined) return -1;\n    if (y === undefined) return 1;\n    if (x === y) continue;\n    if (typeof x === 'number' && typeof y === 'number') return x - y;\n    if (typeof x === 'number') return -1;\n    if (typeof y === 'number') return 1;\n    return x < y ? -1 : 1;\n  }\n  return 0;\n}\n\nconst v = (a: number, b: number, c: number, pre: readonly (string | number)[] = []): Version =>\n  ({ triple: [a, b, c], pre });\n\n/** One comparator token as the interval it names. `null` when unreadable. */\nfunction parseComparator(token: string): Comparator[] | null {\n  const m = /^(\\^|~|>=|<=|>|<|=)?(.*)$/.exec(token)!;\n  const op = m[1] ?? '';\n  const p = PARTIAL_RE.exec(m[2]!);\n  if (!p) return null;\n  const nums: number[] = [];\n  for (const part of [p[1], p[2], p[3]]) {\n    if (part === undefined || /^[xX*]$/.test(part)) break;\n    nums.push(Number(part));\n  }\n  const pre = preOf(p[4]);\n  if (pre.length > 0 && nums.length < 3) return null;\n  const [M = 0, mi = 0, pa = 0] = nums;\n  const lower = v(M, mi, pa, pre);\n  // The first version past everything the partial names: `1.7` → `1.8.0`.\n  const upper = nums.length === 0 ? null\n    : nums.length === 1 ? v(M + 1, 0, 0)\n    : nums.length === 2 ? v(M, mi + 1, 0)\n    : v(M, mi, pa + 1);\n\n  switch (op) {\n    case '>=': return [{ op: '>=', v: lower }];\n    case '<': return nums.length === 0 ? [{ op: '<', v: v(0, 0, 0) }] : [{ op: '<', v: lower }];\n    case '>': return nums.length === 3 ? [{ op: '>', v: lower }] : upper ? [{ op: '>=', v: upper }] : [{ op: '<', v: v(0, 0, 0) }];\n    case '<=': return nums.length === 3 ? [{ op: '<=', v: lower }] : upper ? [{ op: '<', v: upper }] : [];\n    case '~': {\n      const top = nums.length <= 1 ? v(M + 1, 0, 0) : v(M, mi + 1, 0);\n      return [{ op: '>=', v: lower }, { op: '<', v: top }];\n    }\n    case '^': {\n      const top = M > 0 || nums.length === 1 ? v(M + 1, 0, 0)\n        : mi > 0 || nums.length === 2 ? v(0, mi + 1, 0)\n        : v(0, 0, pa + 1);\n      return nums.length === 0 ? [] : [{ op: '>=', v: lower }, { op: '<', v: top }];\n    }\n    default:\n      if (nums.length === 3) return [{ op: '>=', v: lower }, { op: '<=', v: lower }];\n      return upper ? [{ op: '>=', v: lower }, { op: '<', v: upper }] : [];\n  }\n}\n\nfunction holds(version: Version, c: Comparator): boolean {\n  const d = compare(version, c.v);\n  switch (c.op) {\n    case '>=': return d >= 0;\n    case '>': return d > 0;\n    case '<=': return d <= 0;\n    case '<': return d < 0;\n  }\n}\n\n/**\n * Whether `version` falls in `range`. `null` when either cannot be read, so a\n * caller can tell a mismatch from a requirement it could not check.\n */\nexport function satisfiesRange(version: string, range: string): boolean | null {\n  const parsed = parseVersion(version);\n  if (!parsed) return null;\n  const alternatives = range.split('||').map((alt) => alt.trim());\n  let any = false;\n  for (const alt of alternatives) {\n    if (alt === '') return null;\n    const set: Comparator[] = [];\n    for (const token of alt.split(/\\s+/)) {\n      const cs = parseComparator(token);\n      if (!cs) return null;\n      set.push(...cs);\n    }\n    if (set.every((c) => holds(parsed, c))) any = true;\n  }\n  return any;\n}\n\n/**\n * Every requirement in `requires` the running kit does not meet. A package\n * whose build does not know its own version (`0.0.0-unknown`, core's source\n * bundled without its define) is skipped: nothing can be said about it.\n */\nexport function checkRequirements(\n  requires: KitRequirements,\n  running: Readonly<Partial<Record<string, string>>> = KIT_VERSIONS,\n): RequirementMismatch[] {\n  const out: RequirementMismatch[] = [];\n  for (const [pkg, range] of Object.entries(requires)) {\n    if (range === undefined) continue;\n    const have = running[pkg];\n    if (have === undefined) {\n      out.push({ package: pkg, range, running: undefined, reason: 'unknown-package' });\n      continue;\n    }\n    if (have.endsWith(UNKNOWN_SUFFIX)) continue;\n    const ok = satisfiesRange(have, range);\n    if (ok === null) out.push({ package: pkg, range, running: have, reason: 'invalid-range' });\n    else if (!ok) out.push({ package: pkg, range, running: have, reason: 'unsatisfied' });\n  }\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"kitRequirements.js","names":["KIT_VERSIONS","VERSION","UNKNOWN_SUFFIX","VERSION_RE","PARTIAL_RE","preOf","s","id","parseVersion","m","compare","i","d","a","b","x","y","v","c","parseComparator","token","op","p","nums","part","pre","M","mi","pa","lower","upper","top","holds","version","satisfiesRange","parsed","alternatives","range","alt","any","set","cs","checkRequirements","out","pkg","requires","have","running","ok"],"sources":["../../src/canvas/kitRequirements.ts"],"sourcesContent":["/**\n * Version negotiation for contributions: a `requires` map of semver ranges,\n * matched against the versions the running kit packages report.\n *\n * The range grammar is npm's everyday subset — `^`, `~`, `>=`, `>`, `<=`, `<`,\n * `=`, bare and partial versions (`1.7`, `1.x`, `*`), space for AND and `||`\n * for OR. Hyphen ranges are not read. A prerelease orders below its release,\n * without npm's rule that a range must opt into prereleases by naming one —\n * except at an exclusive upper bound, which also excludes that version's own\n * prereleases, so `^1.4` does not admit `2.0.0-rc.1`.\n */\nimport { VERSION } from '../version';\n\n/**\n * The versions a contribution can require, keyed by package without its\n * `@weasel-js/` scope. Only core reports its version today.\n */\nexport interface KitVersions {\n  core: string;\n}\n\n/** A contribution's `requires`: a semver range per package it was written against. */\nexport type KitRequirements = { readonly [K in keyof KitVersions]?: string };\n\n/** The running kit's versions. */\nexport const KIT_VERSIONS: Readonly<KitVersions> = { core: VERSION };\n\n/** One requirement the running kit does not meet. */\nexport interface RequirementMismatch {\n  package: string;\n  range: string;\n  /** The running version, or `undefined` when that package reports none. */\n  running: string | undefined;\n  reason: 'unsatisfied' | 'invalid-range' | 'unknown-package';\n}\n\ntype Triple = readonly [number, number, number];\ninterface Version { triple: Triple; pre: readonly (string | number)[] }\ninterface Comparator { op: '>=' | '<' | '>' | '<='; v: Version }\n\nconst UNKNOWN_SUFFIX = '-unknown';\nconst VERSION_RE = /^v?(\\d+)\\.(\\d+)\\.(\\d+)(?:-([0-9A-Za-z.-]+))?(?:\\+[0-9A-Za-z.-]+)?$/;\nconst PARTIAL_RE = /^v?(\\d+|[xX*])(?:\\.(\\d+|[xX*]))?(?:\\.(\\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nfunction preOf(s: string | undefined): (string | number)[] {\n  return s ? s.split('.').map((id) => (/^\\d+$/.test(id) ? Number(id) : id)) : [];\n}\n\nfunction parseVersion(s: string): Version | null {\n  const m = VERSION_RE.exec(s.trim());\n  return m ? { triple: [Number(m[1]), Number(m[2]), Number(m[3])], pre: preOf(m[4]) } : null;\n}\n\nfunction compare(a: Version, b: Version): number {\n  for (let i = 0; i < 3; i++) {\n    const d = a.triple[i]! - b.triple[i]!;\n    if (d !== 0) return d;\n  }\n  if (a.pre.length === 0 || b.pre.length === 0) return b.pre.length - a.pre.length;\n  for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {\n    const x = a.pre[i];\n    const y = b.pre[i];\n    if (x === undefined) return -1;\n    if (y === undefined) return 1;\n    if (x === y) continue;\n    if (typeof x === 'number' && typeof y === 'number') return x - y;\n    if (typeof x === 'number') return -1;\n    if (typeof y === 'number') return 1;\n    return x < y ? -1 : 1;\n  }\n  return 0;\n}\n\nconst v = (a: number, b: number, c: number, pre: readonly (string | number)[] = []): Version =>\n  ({ triple: [a, b, c], pre });\n\n/** One comparator token as the interval it names. `null` when unreadable. */\nfunction parseComparator(token: string): Comparator[] | null {\n  const m = /^(\\^|~|>=|<=|>|<|=)?(.*)$/.exec(token)!;\n  const op = m[1] ?? '';\n  const p = PARTIAL_RE.exec(m[2]!);\n  if (!p) return null;\n  const nums: number[] = [];\n  for (const part of [p[1], p[2], p[3]]) {\n    if (part === undefined || /^[xX*]$/.test(part)) break;\n    nums.push(Number(part));\n  }\n  const pre = preOf(p[4]);\n  if (pre.length > 0 && nums.length < 3) return null;\n  const [M = 0, mi = 0, pa = 0] = nums;\n  const lower = v(M, mi, pa, pre);\n  // The first version past everything the partial names: `1.7` → `1.8.0`.\n  const upper = nums.length === 0 ? null\n    : nums.length === 1 ? v(M + 1, 0, 0)\n    : nums.length === 2 ? v(M, mi + 1, 0)\n    : v(M, mi, pa + 1);\n\n  switch (op) {\n    case '>=': return [{ op: '>=', v: lower }];\n    case '<': return nums.length === 0 ? [{ op: '<', v: v(0, 0, 0) }] : [{ op: '<', v: lower }];\n    case '>': return nums.length === 3 ? [{ op: '>', v: lower }] : upper ? [{ op: '>=', v: upper }] : [{ op: '<', v: v(0, 0, 0) }];\n    case '<=': return nums.length === 3 ? [{ op: '<=', v: lower }] : upper ? [{ op: '<', v: upper }] : [];\n    case '~': {\n      const top = nums.length <= 1 ? v(M + 1, 0, 0) : v(M, mi + 1, 0);\n      return [{ op: '>=', v: lower }, { op: '<', v: top }];\n    }\n    case '^': {\n      const top = M > 0 || nums.length === 1 ? v(M + 1, 0, 0)\n        : mi > 0 || nums.length === 2 ? v(0, mi + 1, 0)\n        : v(0, 0, pa + 1);\n      return nums.length === 0 ? [] : [{ op: '>=', v: lower }, { op: '<', v: top }];\n    }\n    default:\n      if (nums.length === 3) return [{ op: '>=', v: lower }, { op: '<=', v: lower }];\n      return upper ? [{ op: '>=', v: lower }, { op: '<', v: upper }] : [];\n  }\n}\n\nfunction holds(version: Version, c: Comparator): boolean {\n  const d = compare(version, c.v);\n  switch (c.op) {\n    case '>=': return d >= 0;\n    case '>': return d > 0;\n    case '<=': return d <= 0;\n    case '<': return c.v.pre.length > 0 ? d < 0 : compare(v(...version.triple), c.v) < 0;\n  }\n}\n\n/**\n * Whether `version` falls in `range`. `null` when either cannot be read, so a\n * caller can tell a mismatch from a requirement it could not check.\n */\nexport function satisfiesRange(version: string, range: string): boolean | null {\n  const parsed = parseVersion(version);\n  if (!parsed) return null;\n  const alternatives = range.split('||').map((alt) => alt.trim());\n  let any = false;\n  for (const alt of alternatives) {\n    if (alt === '') return null;\n    const set: Comparator[] = [];\n    for (const token of alt.replace(/(\\^|~|>=|<=|>|<|=)\\s+/g, '$1').split(/\\s+/)) {\n      const cs = parseComparator(token);\n      if (!cs) return null;\n      set.push(...cs);\n    }\n    if (set.every((c) => holds(parsed, c))) any = true;\n  }\n  return any;\n}\n\n/**\n * Every requirement in `requires` the running kit does not meet. A package\n * whose build does not know its own version (`0.0.0-unknown`, core's source\n * bundled without its define) is skipped: nothing can be said about it.\n */\nexport function checkRequirements(\n  requires: KitRequirements,\n  running: Readonly<Partial<Record<string, string>>> = KIT_VERSIONS,\n): RequirementMismatch[] {\n  const out: RequirementMismatch[] = [];\n  for (const [pkg, range] of Object.entries(requires)) {\n    if (range === undefined) continue;\n    const have = running[pkg];\n    if (have === undefined) {\n      out.push({ package: pkg, range, running: undefined, reason: 'unknown-package' });\n      continue;\n    }\n    if (have.endsWith(UNKNOWN_SUFFIX)) continue;\n    const ok = satisfiesRange(have, range);\n    if (ok === null) out.push({ package: pkg, range, running: have, reason: 'invalid-range' });\n    else if (!ok) out.push({ package: pkg, range, running: have, reason: 'unsatisfied' });\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/canvas/layerOrder.js

@@ -23,11 +23,7 @@ function r(r, i, a, o) {
 	}
 	let d = /* @__PURE__ */ new Set(), f = o ? [o] : [];
 	function p(e) {
-		if (d.has(e.key)) {
-			console.warn(`composeOrderedLayers: cycle detected involving custom layer "${e.key}"`);
-			return;
-		}
-		d.add(e.key), h(e.key), f.push(e.layer), m(e.key);
+		d.has(e.key) || (d.add(e.key), h(e.key), f.push(e.layer), m(e.key));
 	}
 	function m(e) {
 		for (let t of s.get(e) ?? []) p(t);
@@ -47,12 +43,23 @@ function r(r, i, a, o) {
 		e && f.push(e), m(t);
 	}
 	for (let e of l) d.has(e.key) || (d.add(e.key), f.push(e.layer));
+	let g = (e) => {
+		let n = r[e];
+		return t(n) ? n.after ?? n.before : void 0;
+	}, _ = (e) => {
+		let t = g(e);
+		for (let n = 0; t !== void 0 && n < u.size; n++) {
+			if (t === e) return !0;
+			t = g(t);
+		}
+		return !1;
+	};
 	for (let e of u) {
 		if (d.has(e)) continue;
 		let n = r[e];
 		if (!t(n)) continue;
 		let i = n.after ?? n.before;
-		console.warn(`composeOrderedLayers: dangling reference "${i}" from custom layer "${e}" — falling back to tail`), d.add(e), f.push(n.layer);
+		console.warn(_(e) ? `composeOrderedLayers: cycle detected involving custom layer "${e}" — falling back to tail` : `composeOrderedLayers: dangling reference "${i}" from custom layer "${e}" — falling back to tail`), d.add(e), f.push(n.layer);
 	}
 	return f;
 }

package/dist/canvas/layerOrder.js.map

@@ -1 +1 @@
-{"version":3,"file":"layerOrder.js","names":["STANDARD_SLOT_SET","STANDARD_SLOTS","composeOrderedLayers","afterByParent","beforeByParent","tail","allCustomKeys","key","value","layersMap","isCustomEntry","arr","emitted","out","background","emitChild","child","emitBefore","emitAfter","parentKey","slot","sceneLayers","sl","layer","standardLayers","t","ref","placeToolOverlays","before","overlays","after","at","selectionOverlay","ordered"],"sources":["../../src/canvas/layerOrder.ts"],"sourcesContent":["import type { RenderLayer } from '../core/layers/render';\nimport type { LayerSlotValue } from './Canvas';\nimport { STANDARD_SLOTS, isCustomEntry } from './layerSlots';\nimport type { OverlayPosition } from '@weasel-js/routing';\n\nconst STANDARD_SLOT_SET = new Set<string>(STANDARD_SLOTS);\n\n/**\n * Compose the final ordered layer list from a layersMap and the resolved\n * standard-slot layers.\n *\n * Semantics:\n * - Standard slots are emitted in `STANDARD_SLOTS` order.\n * - Each standard-slot layer is preceded by its `before` chain (deepest first)\n *   and followed by its `after` chain (ancestors first).\n * - `after: 'X'` / `before: 'X'` accept standard slot names OR other\n *   custom-layer keys, and chains may mix the two — a custom anchored\n *   `before` a slot can itself carry an `after` chain, and vice versa.\n * - Customs with neither `after` nor `before` go to a tail bucket emitted\n *   after all standard slots.\n * - Dangling references (target unresolvable) go to the tail with a\n *   `console.warn`. Cycles are detected and broken with a warning.\n *\n * Pure function — no side effects beyond `console.warn` on malformed input.\n */\nexport function composeOrderedLayers<TNode extends { id: string }, TPose>(\n  layersMap: Record<string, LayerSlotValue<TNode, TPose> | null | undefined>,\n  standardLayers: Partial<Record<(typeof STANDARD_SLOTS)[number], RenderLayer<unknown>>>,\n  /** When the `scene` slot is split into per-scene-layer canvas layers (keyed\n   *  `scene:<layerId>`), pass them here in render order. Each key becomes an\n   *  anchor point, so customs can target `before/after: 'scene:<layerId>'`.\n   *  `before/after: 'scene'` still works (before the first / after the last).\n   *  When omitted, the `scene` slot uses `standardLayers.scene` as before. */\n  sceneLayers?: ReadonlyArray<{ key: string; layer: RenderLayer<unknown> }>,\n  /** Drawn beneath everything else, grid and customs anchored before the\n   *  scene included — a fill that must never cover what is laid over it. */\n  background?: RenderLayer<unknown>,\n): RenderLayer<unknown>[] {\n  // Map<parent key, [{ key, layer }, ...]> — children grouped by their declared anchor.\n  const afterByParent = new Map<string, Array<{ key: string; layer: RenderLayer<unknown> }>>();\n  const beforeByParent = new Map<string, Array<{ key: string; layer: RenderLayer<unknown> }>>();\n  const tail: Array<{ key: string; layer: RenderLayer<unknown> }> = [];\n  const allCustomKeys = new Set<string>();\n\n  for (const [key, value] of Object.entries(layersMap)) {\n    if (STANDARD_SLOT_SET.has(key)) continue;\n    if (!isCustomEntry(value)) continue;\n    allCustomKeys.add(key);\n    if (value.after) {\n      const arr = afterByParent.get(value.after) ?? [];\n      arr.push({ key, layer: value.layer });\n      afterByParent.set(value.after, arr);\n    } else if (value.before) {\n      const arr = beforeByParent.get(value.before) ?? [];\n      arr.push({ key, layer: value.layer });\n      beforeByParent.set(value.before, arr);\n    } else {\n      tail.push({ key, layer: value.layer });\n    }\n  }\n\n  const emitted = new Set<string>();\n  const out: RenderLayer<unknown>[] = background ? [background] : [];\n\n  function emitChild(child: { key: string; layer: RenderLayer<unknown> }) {\n    if (emitted.has(child.key)) {\n      // Cycle — already emitted via another path. Warn once.\n      console.warn(`composeOrderedLayers: cycle detected involving custom layer \"${child.key}\"`);\n      return;\n    }\n    emitted.add(child.key);\n    emitBefore(child.key);\n    out.push(child.layer);\n    emitAfter(child.key);\n  }\n\n  function emitAfter(parentKey: string) {\n    for (const child of afterByParent.get(parentKey) ?? []) emitChild(child);\n  }\n\n  function emitBefore(parentKey: string) {\n    for (const child of beforeByParent.get(parentKey) ?? []) emitChild(child);\n  }\n\n  for (const slot of STANDARD_SLOTS) {\n    if (slot === 'scene' && sceneLayers) {\n      // Split scene slot: emit each per-scene-layer canvas layer in order, with\n      // its own anchor point. `before/after: 'scene'` brackets the whole group.\n      emitBefore('scene');\n      for (const sl of sceneLayers) {\n        emitBefore(sl.key);\n        out.push(sl.layer);\n        emitAfter(sl.key);\n      }\n      emitAfter('scene');\n      continue;\n    }\n    emitBefore(slot);\n    const layer = standardLayers[slot];\n    if (layer) out.push(layer);\n    emitAfter(slot);\n  }\n\n  // Tail customs (neither after nor before).\n  for (const t of tail) {\n    if (emitted.has(t.key)) continue;\n    emitted.add(t.key);\n    out.push(t.layer);\n  }\n\n  // Orphans: customs that declared an `after`/`before` but never got emitted\n  // (target didn't resolve through any chain to a known standard slot or custom).\n  for (const key of allCustomKeys) {\n    if (emitted.has(key)) continue;\n    const value = layersMap[key];\n    if (!isCustomEntry(value)) continue;\n    const ref = value.after ?? value.before;\n    console.warn(`composeOrderedLayers: dangling reference \"${ref}\" from custom layer \"${key}\" — falling back to tail`);\n    emitted.add(key);\n    out.push(value.layer);\n  }\n\n  return out;\n}\n\n/**\n * Splice a tool's positioned overlays into an already-composed layer list.\n *\n * `'top'` appends; the other two anchor on the selection-chrome layer's index\n * in `ordered`. With no selection chrome present the anchored overlays fall\n * back to the tail, keeping their relative order. Mutates and returns\n * `ordered`.\n */\nexport function placeToolOverlays(\n  ordered: RenderLayer<unknown>[],\n  selectionOverlay: RenderLayer<unknown> | undefined,\n  overlays: (position: OverlayPosition) => RenderLayer<unknown>[],\n): RenderLayer<unknown>[] {\n  const before = overlays('before-selection');\n  const after = overlays('after-selection');\n  const at = selectionOverlay ? ordered.indexOf(selectionOverlay) : -1;\n  if (at >= 0) {\n    ordered.splice(at + 1, 0, ...after);\n    ordered.splice(at, 0, ...before);\n  } else {\n    ordered.push(...before, ...after);\n  }\n  ordered.push(...overlays('top'));\n  return ordered;\n}\n"],"mappings":"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"}
+{"version":3,"file":"layerOrder.js","names":["STANDARD_SLOT_SET","STANDARD_SLOTS","composeOrderedLayers","afterByParent","beforeByParent","tail","allCustomKeys","key","value","layersMap","isCustomEntry","arr","emitted","out","background","emitChild","child","emitBefore","emitAfter","parentKey","slot","sceneLayers","sl","layer","standardLayers","t","anchorOf","inCycle","at","hops","ref","placeToolOverlays","before","overlays","after","selectionOverlay","ordered"],"sources":["../../src/canvas/layerOrder.ts"],"sourcesContent":["import type { RenderLayer } from '../core/layers/render';\nimport type { LayerSlotValue } from './Canvas';\nimport { STANDARD_SLOTS, isCustomEntry } from './layerSlots';\nimport type { OverlayPosition } from '@weasel-js/routing';\n\nconst STANDARD_SLOT_SET = new Set<string>(STANDARD_SLOTS);\n\n/**\n * Compose the final ordered layer list from a layersMap and the resolved\n * standard-slot layers.\n *\n * Semantics:\n * - Standard slots are emitted in `STANDARD_SLOTS` order.\n * - Each standard-slot layer is preceded by its `before` chain (deepest first)\n *   and followed by its `after` chain (ancestors first).\n * - `after: 'X'` / `before: 'X'` accept standard slot names OR other\n *   custom-layer keys, and chains may mix the two — a custom anchored\n *   `before` a slot can itself carry an `after` chain, and vice versa.\n * - Customs with neither `after` nor `before` go to a tail bucket emitted\n *   after all standard slots.\n * - Dangling references (target unresolvable) and cycles go to the tail\n *   with a `console.warn`.\n * - An entry with both `after` and `before` is placed by `after`.\n *\n * Pure function — no side effects beyond `console.warn` on malformed input.\n */\nexport function composeOrderedLayers<TNode extends { id: string }, TPose>(\n  layersMap: Record<string, LayerSlotValue<TNode, TPose> | null | undefined>,\n  standardLayers: Partial<Record<(typeof STANDARD_SLOTS)[number], RenderLayer<unknown>>>,\n  /** When the `scene` slot is split into per-scene-layer canvas layers (keyed\n   *  `scene:<layerId>`), pass them here in render order. Each key becomes an\n   *  anchor point, so customs can target `before/after: 'scene:<layerId>'`.\n   *  `before/after: 'scene'` still works (before the first / after the last).\n   *  When omitted, the `scene` slot uses `standardLayers.scene` as before. */\n  sceneLayers?: ReadonlyArray<{ key: string; layer: RenderLayer<unknown> }>,\n  /** Drawn beneath everything else, grid and customs anchored before the\n   *  scene included — a fill that must never cover what is laid over it. */\n  background?: RenderLayer<unknown>,\n): RenderLayer<unknown>[] {\n  // Map<parent key, [{ key, layer }, ...]> — children grouped by their declared anchor.\n  const afterByParent = new Map<string, Array<{ key: string; layer: RenderLayer<unknown> }>>();\n  const beforeByParent = new Map<string, Array<{ key: string; layer: RenderLayer<unknown> }>>();\n  const tail: Array<{ key: string; layer: RenderLayer<unknown> }> = [];\n  const allCustomKeys = new Set<string>();\n\n  for (const [key, value] of Object.entries(layersMap)) {\n    if (STANDARD_SLOT_SET.has(key)) continue;\n    if (!isCustomEntry(value)) continue;\n    allCustomKeys.add(key);\n    if (value.after) {\n      const arr = afterByParent.get(value.after) ?? [];\n      arr.push({ key, layer: value.layer });\n      afterByParent.set(value.after, arr);\n    } else if (value.before) {\n      const arr = beforeByParent.get(value.before) ?? [];\n      arr.push({ key, layer: value.layer });\n      beforeByParent.set(value.before, arr);\n    } else {\n      tail.push({ key, layer: value.layer });\n    }\n  }\n\n  const emitted = new Set<string>();\n  const out: RenderLayer<unknown>[] = background ? [background] : [];\n\n  function emitChild(child: { key: string; layer: RenderLayer<unknown> }) {\n    // A custom has one anchor, so it is reached twice only when `sceneLayers`\n    // repeats a key.\n    if (emitted.has(child.key)) return;\n    emitted.add(child.key);\n    emitBefore(child.key);\n    out.push(child.layer);\n    emitAfter(child.key);\n  }\n\n  function emitAfter(parentKey: string) {\n    for (const child of afterByParent.get(parentKey) ?? []) emitChild(child);\n  }\n\n  function emitBefore(parentKey: string) {\n    for (const child of beforeByParent.get(parentKey) ?? []) emitChild(child);\n  }\n\n  for (const slot of STANDARD_SLOTS) {\n    if (slot === 'scene' && sceneLayers) {\n      // Split scene slot: emit each per-scene-layer canvas layer in order, with\n      // its own anchor point. `before/after: 'scene'` brackets the whole group.\n      emitBefore('scene');\n      for (const sl of sceneLayers) {\n        emitBefore(sl.key);\n        out.push(sl.layer);\n        emitAfter(sl.key);\n      }\n      emitAfter('scene');\n      continue;\n    }\n    emitBefore(slot);\n    const layer = standardLayers[slot];\n    if (layer) out.push(layer);\n    emitAfter(slot);\n  }\n\n  // Tail customs (neither after nor before).\n  for (const t of tail) {\n    if (emitted.has(t.key)) continue;\n    emitted.add(t.key);\n    out.push(t.layer);\n  }\n\n  const anchorOf = (key: string): string | undefined => {\n    const value = layersMap[key];\n    return isCustomEntry(value) ? value.after ?? value.before : undefined;\n  };\n  const inCycle = (key: string): boolean => {\n    let at = anchorOf(key);\n    for (let hops = 0; at !== undefined && hops < allCustomKeys.size; hops++) {\n      if (at === key) return true;\n      at = anchorOf(at);\n    }\n    return false;\n  };\n\n  // Orphans: customs that declared an `after`/`before` but never got emitted,\n  // because the chain of anchors loops or ends on a key nothing defines.\n  for (const key of allCustomKeys) {\n    if (emitted.has(key)) continue;\n    const value = layersMap[key];\n    if (!isCustomEntry(value)) continue;\n    const ref = value.after ?? value.before;\n    console.warn(inCycle(key)\n      ? `composeOrderedLayers: cycle detected involving custom layer \"${key}\" — falling back to tail`\n      : `composeOrderedLayers: dangling reference \"${ref}\" from custom layer \"${key}\" — falling back to tail`);\n    emitted.add(key);\n    out.push(value.layer);\n  }\n\n  return out;\n}\n\n/**\n * Splice a tool's positioned overlays into an already-composed layer list.\n *\n * `'top'` appends; the other two anchor on the selection-chrome layer's index\n * in `ordered`. With no selection chrome present the anchored overlays fall\n * back to the tail, keeping their relative order. Mutates and returns\n * `ordered`.\n */\nexport function placeToolOverlays(\n  ordered: RenderLayer<unknown>[],\n  selectionOverlay: RenderLayer<unknown> | undefined,\n  overlays: (position: OverlayPosition) => RenderLayer<unknown>[],\n): RenderLayer<unknown>[] {\n  const before = overlays('before-selection');\n  const after = overlays('after-selection');\n  const at = selectionOverlay ? ordered.indexOf(selectionOverlay) : -1;\n  if (at >= 0) {\n    ordered.splice(at + 1, 0, ...after);\n    ordered.splice(at, 0, ...before);\n  } else {\n    ordered.push(...before, ...after);\n  }\n  ordered.push(...overlays('top'));\n  return ordered;\n}\n"],"mappings":"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"}

package/dist/canvas/minimapMath.js

@@ -10,8 +10,8 @@ var n = 8, r = {
 	}
 }, i = "#ffffff", a = 1, o = [2, 3];
 function s(e, t, n) {
-	let r = Math.max(1, t.width - n * 2), i = Math.max(1, t.height - n * 2);
-	if (e.width <= 0 || e.height <= 0) return {
+	let r = Math.max(1, t.width - n * 2), i = Math.max(1, t.height - n * 2), a = e.width > 0, o = e.height > 0;
+	if (!a && !o) return {
 		x: e.x - t.width / 2,
 		y: e.y - t.height / 2,
 		scale: {
@@ -19,7 +19,7 @@ function s(e, t, n) {
 			y: 1
 		}
 	};
-	let a = r / e.width, o = i / e.height, s = Math.min(a, o), c = e.x + e.width / 2, l = e.y + e.height / 2;
+	let s = Math.min(a ? r / e.width : Infinity, o ? i / e.height : Infinity), c = e.x + Math.max(0, e.width) / 2, l = e.y + Math.max(0, e.height) / 2;
 	return {
 		x: c - t.width / (2 * s),
 		y: l - t.height / (2 * s),
@@ -34,6 +34,7 @@ function c(n, r) {
 	for (let l of n.nodes.values()) {
 		if (l.kind !== "leaf") continue;
 		let u = t(r, l).getBounds(e(n, l));
+		if (!Number.isFinite(u.x + u.y + u.width + u.height)) continue;
 		u.x < i && (i = u.x), u.y < a && (a = u.y);
 		let d = u.x + u.width, f = u.y + u.height;
 		d > o && (o = d), f > s && (s = f), c = !0;
@@ -54,23 +55,24 @@ function l(e, t, i, a, o = {}) {
 	}
 	return s(i.rect, t, l);
 }
-function u(e, t, n = {}) {
+function u(e, t, n = {}, r) {
+	let s = e.x, c = e.y, l = t.width / e.scale.x, u = t.height / e.scale.y, d = r ? 1 / Math.abs(r.scale.x) : 1;
 	return {
 		kind: "path",
 		path: {
 			kind: "rect",
-			x: e.x,
-			y: e.y,
-			width: t.width / e.scale.x,
-			height: t.height / e.scale.y
+			x: s,
+			y: c,
+			width: l,
+			height: u
 		},
 		stroke: {
 			paint: {
 				fill: "solid",
 				color: n.stroke ?? i
 			},
-			width: n.width ?? a,
-			dash: n.dash ?? [...o]
+			width: (n.width ?? a) * d,
+			dash: (n.dash ?? o).map((e) => e * d)
 		}
 	};
 }

package/dist/canvas/minimapMath.js.map

@@ -1 +1 @@
-{"version":3,"file":"minimapMath.js","names":["DEFAULT_FIT_PADDING","FALLBACK_FIT_VIEW","DEFAULT_INDICATOR_STROKE","DEFAULT_INDICATOR_WIDTH","DEFAULT_INDICATOR_DASH","fitRectInto","availW","dims","padding","availH","rect","sx","sy","worldCx","worldCy","sceneLeafBounds","minX","minY","maxX","maxY","any","node","scene","b","poseDescriptorForNode","descriptor","documentPose","right","bottom","computeFitView","opts","fit","computeIndicatorCommand","mainView","mainViewDims","style"],"sources":["../../src/canvas/minimapMath.ts"],"sourcesContent":["/**\n * Pure math helpers for `<MinimapCanvas>`.\n *\n * `computeFitView` derives a `View` that fits a chosen world rect into a\n * minimap canvas of given pixel dims. `computeIndicatorCommand` builds the\n * dashed \"visible window\" rect — the main canvas's screen window projected\n * into the minimap's own screen coordinates.\n *\n * Neither helper touches GL, the DOM, or the renderer; they're pure\n * functions, unit-testable with `expect`.\n */\nimport { documentPose } from '../core/scene';\nimport type { Scene } from '../core/scene';\nimport type { View } from '../core/viewport/view';\nimport type { Bounds, ViewportDims } from '../core/viewport/fitViewToBounds';\nimport { poseDescriptorForNode, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport type { PathDrawCommand } from '../renderer/DrawCommand';\n\n/** Inset (CSS px) around the fit rect on each side. Matches the spec note. */\nconst DEFAULT_FIT_PADDING = 8;\n\n/**\n * Fallback view returned when there is nothing to fit (empty scene, etc.).\n * Identity view at the origin — produces a 1:1 mapping centered on (0, 0).\n */\nexport const FALLBACK_FIT_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * Fit policy for `<MinimapCanvas>` / `computeFitView`.\n *\n * - `\"scene\"` — union of leaf-node pose AABBs (via the pose descriptor).\n * - `{ kind: \"world\", rect }` — caller-supplied world rect.\n * - `(scene, dims) => View` — caller derives the view directly.\n */\nexport type MinimapFit<TData, TLayer extends string, TPose> =\n  | 'scene'\n  | { kind: 'world'; rect: Bounds }\n  | ((scene: Scene<TData, TLayer, TPose>, dims: ViewportDims) => View);\n\n/** Style for the visible-window indicator rect drawn over the minimap. */\nexport interface IndicatorStyle {\n  /** Stroke color (any CSS color). Defaults to `'#ffffff'`. */\n  stroke?: string;\n  /** Stroke width in CSS px. Defaults to `1`. */\n  width?: number;\n  /** Dash pattern in CSS px. Defaults to `[2, 3]`. */\n  dash?: number[];\n}\n\nconst DEFAULT_INDICATOR_STROKE = '#ffffff';\nconst DEFAULT_INDICATOR_WIDTH = 1;\nconst DEFAULT_INDICATOR_DASH: readonly number[] = [2, 3];\n\n/** Internal: fit a world rect uniformly into dims with padding. */\nfunction fitRectInto(rect: Bounds, dims: ViewportDims, padding: number): View {\n  const availW = Math.max(1, dims.width - padding * 2);\n  const availH = Math.max(1, dims.height - padding * 2);\n  // Degenerate rect (zero / negative area): fall back to identity at the\n  // rect's top-left so we at least center *something* sensible.\n  if (rect.width <= 0 || rect.height <= 0) {\n    return {\n      x: rect.x - dims.width / 2,\n      y: rect.y - dims.height / 2,\n      scale: { x: 1, y: 1 },\n    };\n  }\n  const sx = availW / rect.width;\n  const sy = availH / rect.height;\n  const s = Math.min(sx, sy);\n  const worldCx = rect.x + rect.width / 2;\n  const worldCy = rect.y + rect.height / 2;\n  return {\n    x: worldCx - dims.width / (2 * s),\n    y: worldCy - dims.height / (2 * s),\n    scale: { x: s, y: s },\n  };\n}\n\n/**\n * Compute the AABB union of all leaf-node poses in the scene, via\n * `descriptor`. Container nodes are skipped — their effective bounds come\n * from their descendant leaves. Returns `null` when the scene has no\n * leaves.\n */\nfunction sceneLeafBounds<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  descriptor: PoseDescriptor<TPose>,\n): Bounds | null {\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n  let any = false;\n  for (const node of scene.nodes.values()) {\n    if (node.kind !== 'leaf') continue;\n    const b = poseDescriptorForNode(descriptor, node).getBounds(documentPose(scene, node));\n    if (b.x < minX) minX = b.x;\n    if (b.y < minY) minY = b.y;\n    const right = b.x + b.width;\n    const bottom = b.y + b.height;\n    if (right > maxX) maxX = right;\n    if (bottom > maxY) maxY = bottom;\n    any = true;\n  }\n  if (!any) return null;\n  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n\n/** Options for {@link computeFitView}. */\nexport interface ComputeFitViewOptions {\n  /** Inset (CSS px) around the fit rect on each side. Defaults to `8`. */\n  padding?: number;\n}\n\n/**\n * Derive a `View` that fits the chosen world rect into a minimap of\n * `dims.width × dims.height` CSS px. Uniform scale on both axes; the rect\n * is centered with `padding` (default 8) on each side. The smaller-axis\n * fit ratio wins, so the whole rect is visible.\n *\n * - `fit === \"scene\"`: union AABB of leaf-node poses via `descriptor`.\n *   Empty scene → {@link FALLBACK_FIT_VIEW}.\n * - `fit` is `{ kind: \"world\", rect }`: fit `rect`. A degenerate rect\n *   (zero or negative area) falls back to identity scale centered on the\n *   rect's top-left — we don't divide by zero.\n * - `fit` is a function: called with `(scene, dims)`; its return is\n *   passed through unchanged.\n */\nexport function computeFitView<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  dims: ViewportDims,\n  fit: MinimapFit<TData, TLayer, TPose>,\n  descriptor: PoseDescriptor<TPose>,\n  opts: ComputeFitViewOptions = {},\n): View {\n  const padding = opts.padding ?? DEFAULT_FIT_PADDING;\n\n  if (typeof fit === 'function') {\n    return fit(scene, dims);\n  }\n  if (fit === 'scene') {\n    const rect = sceneLeafBounds(scene, descriptor);\n    if (rect === null) return FALLBACK_FIT_VIEW;\n    return fitRectInto(rect, dims, padding);\n  }\n  // { kind: 'world', rect }\n  return fitRectInto(fit.rect, dims, padding);\n}\n\n/**\n * Build the visible-window indicator `DrawCommand` for the minimap.\n *\n * The main canvas's visible world rect is:\n * ```\n * worldX = mainView.x\n * worldY = mainView.y\n * worldW = mainViewDims.width  / mainView.scale.x\n * worldH = mainViewDims.height / mainView.scale.y\n * ```\n * That world rect is then transformed into the minimap's screen\n * coordinates through `minimapView`.\n *\n * The returned command is a dashed-stroke `path` rect with no fill.\n */\nexport function computeIndicatorCommand(\n  mainView: View,\n  mainViewDims: ViewportDims,\n  style: IndicatorStyle = {},\n): PathDrawCommand {\n  // World-space rect: returned as-is. The caller wraps the command list\n  // (scene + extras) in a group transformed by the minimap's view, so the\n  // indicator lands in screen coords automatically. Returning screen coords\n  // here would get the view transform applied a second time — a bug that\n  // manifested as the indicator drifting at non-identity minimap scale.\n  const x = mainView.x;\n  const y = mainView.y;\n  const width = mainViewDims.width / mainView.scale.x;\n  const height = mainViewDims.height / mainView.scale.y;\n  return {\n    kind: 'path',\n    path: { kind: 'rect', x, y, width, height },\n    stroke: {\n      paint: { fill: 'solid', color: style.stroke ?? DEFAULT_INDICATOR_STROKE },\n      width: style.width ?? DEFAULT_INDICATOR_WIDTH,\n      dash: style.dash ?? [...DEFAULT_INDICATOR_DASH],\n    },\n  };\n}\n"],"mappings":";;;AAmBA,IAAMA,IAAsB,GAMfC,IAA0B;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE,GAwBrEC,IAA2B,WAC3BC,IAA0B,GAC1BC,IAA4C,CAAC,GAAG,CAAC;AAGvD,SAASC,EAAY,GAAc,GAAoB,GAAuB;CAC5E,IAAMC,IAAS,KAAK,IAAI,GAAGC,EAAK,QAAQC,IAAU,CAAC,GAC7CC,IAAS,KAAK,IAAI,GAAGF,EAAK,SAASC,IAAU,CAAC;CAGpD,IAAIE,EAAK,SAAS,KAAKA,EAAK,UAAU,GACpC,OAAO;EACL,GAAGA,EAAK,IAAIH,EAAK,QAAQ;EACzB,GAAGG,EAAK,IAAIH,EAAK,SAAS;EAC1B,OAAO;GAAE,GAAG;GAAG,GAAG;EAAE;CACtB;CAEF,IAAMI,IAAKL,IAASI,EAAK,OACnBE,IAAKH,IAASC,EAAK,QACnB,IAAI,KAAK,IAAIC,GAAIC,CAAE,GACnBC,IAAUH,EAAK,IAAIA,EAAK,QAAQ,GAChCI,IAAUJ,EAAK,IAAIA,EAAK,SAAS;CACvC,OAAO;EACL,GAAGG,IAAUN,EAAK,SAAS,IAAI;EAC/B,GAAGO,IAAUP,EAAK,UAAU,IAAI;EAChC,OAAO;GAAE,GAAG;GAAG,GAAG;EAAE;CACtB;AACF;AAQA,SAASQ,EACP,GACA,GACe;CACf,IAAIC,IAAO,UACPC,IAAO,UACPC,IAAO,WACPC,IAAO,WACPC,IAAM;CACV,KAAK,IAAMC,KAAQC,EAAM,MAAM,OAAO,GAAG;EACvC,IAAID,EAAK,SAAS,QAAQ;EAC1B,IAAME,IAAIC,EAAsBC,GAAYJ,CAAI,CAAC,CAAC,UAAUK,EAAaJ,GAAOD,CAAI,CAAC;EAErF,AADIE,EAAE,IAAIP,MAAM,IAAOO,EAAE,IACrBA,EAAE,IAAIN,MAAM,IAAOM,EAAE;EACzB,IAAMI,IAAQJ,EAAE,IAAIA,EAAE,OAChBK,IAASL,EAAE,IAAIA,EAAE;EAGvB,AAFII,IAAQT,MAAM,IAAOS,IACrBC,IAAST,MAAM,IAAOS,IAC1B,IAAM;CACR;CAEA,OADKR,IACE;EAAE,GAAGJ;EAAM,GAAGC;EAAM,OAAOC,IAAOF;EAAM,QAAQG,IAAOF;CAAK,IADlD;AAEnB;AAsBA,SAAgBY,EACd,GACA,GACA,GACA,GACA,IAA8B,CAAC,GACzB;CACN,IAAMrB,IAAUsB,EAAK,WAAW9B;CAEhC,IAAI,OAAO+B,KAAQ,YACjB,OAAOA,EAAIT,GAAOf,CAAI;CAExB,IAAIwB,MAAQ,SAAS;EACnB,IAAMrB,IAAOK,EAAgBO,GAAOG,CAAU;EAE9C,OADIf,MAAS,OAAaT,IACnBI,EAAYK,GAAMH,GAAMC,CAAO;CACxC;CAEA,OAAOH,EAAY0B,EAAI,MAAMxB,GAAMC,CAAO;AAC5C;AAiBA,SAAgBwB,EACd,GACA,GACA,IAAwB,CAAC,GACR;CAUjB,OAAO;EACL,MAAM;EACN,MAAM;GAAE,MAAM;GAAQ,GANdC,EAAS;GAMQ,GALjBA,EAAS;GAKW,OAJhBC,EAAa,QAAQD,EAAS,MAAM;GAIb,QAHtBC,EAAa,SAASD,EAAS,MAAM;EAGR;EAC1C,QAAQ;GACN,OAAO;IAAE,MAAM;IAAS,OAAOE,EAAM,UAAUjC;GAAyB;GACxE,OAAOiC,EAAM,SAAShC;GACtB,MAAMgC,EAAM,QAAQ,CAAC,GAAG/B,CAAsB;EAChD;CACF;AACF"}
+{"version":3,"file":"minimapMath.js","names":["DEFAULT_FIT_PADDING","FALLBACK_FIT_VIEW","DEFAULT_INDICATOR_STROKE","DEFAULT_INDICATOR_WIDTH","DEFAULT_INDICATOR_DASH","fitRectInto","availW","dims","padding","availH","hasW","rect","hasH","worldCx","worldCy","sceneLeafBounds","minX","minY","maxX","maxY","any","node","scene","b","poseDescriptorForNode","descriptor","documentPose","right","bottom","computeFitView","opts","fit","computeIndicatorCommand","x","mainView","y","width","mainViewDims","height","px","minimapView","style","d"],"sources":["../../src/canvas/minimapMath.ts"],"sourcesContent":["/**\n * Pure math helpers for `<MinimapCanvas>`.\n *\n * `computeFitView` derives a `View` that fits a chosen world rect into a\n * minimap canvas of given pixel dims. `computeIndicatorCommand` builds the\n * dashed \"visible window\" rect — the main canvas's screen window projected\n * into the minimap's own screen coordinates.\n *\n * Neither helper touches GL, the DOM, or the renderer; they're pure\n * functions, unit-testable with `expect`.\n */\nimport { documentPose } from '../core/scene';\nimport type { Scene } from '../core/scene';\nimport type { View } from '../core/viewport/view';\nimport type { Bounds, ViewportDims } from '../core/viewport/fitViewToBounds';\nimport { poseDescriptorForNode, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport type { PathDrawCommand } from '../renderer/DrawCommand';\n\n/** Inset (CSS px) around the fit rect on each side. Matches the spec note. */\nconst DEFAULT_FIT_PADDING = 8;\n\n/**\n * Fallback view returned when there is nothing to fit (empty scene, etc.).\n * Identity view at the origin — produces a 1:1 mapping centered on (0, 0).\n */\nexport const FALLBACK_FIT_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * Fit policy for `<MinimapCanvas>` / `computeFitView`.\n *\n * - `\"scene\"` — union of leaf-node pose AABBs (via the pose descriptor).\n * - `{ kind: \"world\", rect }` — caller-supplied world rect.\n * - `(scene, dims) => View` — caller derives the view directly.\n */\nexport type MinimapFit<TData, TLayer extends string, TPose> =\n  | 'scene'\n  | { kind: 'world'; rect: Bounds }\n  | ((scene: Scene<TData, TLayer, TPose>, dims: ViewportDims) => View);\n\n/** Style for the visible-window indicator rect drawn over the minimap. */\nexport interface IndicatorStyle {\n  /** Stroke color (any CSS color). Defaults to `'#ffffff'`. */\n  stroke?: string;\n  /** Stroke width in CSS px. Defaults to `1`. */\n  width?: number;\n  /** Dash pattern in CSS px. Defaults to `[2, 3]`. */\n  dash?: number[];\n}\n\nconst DEFAULT_INDICATOR_STROKE = '#ffffff';\nconst DEFAULT_INDICATOR_WIDTH = 1;\nconst DEFAULT_INDICATOR_DASH: readonly number[] = [2, 3];\n\n/** Internal: fit a world rect uniformly into dims with padding. */\nfunction fitRectInto(rect: Bounds, dims: ViewportDims, padding: number): View {\n  const availW = Math.max(1, dims.width - padding * 2);\n  const availH = Math.max(1, dims.height - padding * 2);\n  const hasW = rect.width > 0;\n  const hasH = rect.height > 0;\n  if (!hasW && !hasH) {\n    return {\n      x: rect.x - dims.width / 2,\n      y: rect.y - dims.height / 2,\n      scale: { x: 1, y: 1 },\n    };\n  }\n  const s = Math.min(\n    hasW ? availW / rect.width : Infinity,\n    hasH ? availH / rect.height : Infinity,\n  );\n  const worldCx = rect.x + Math.max(0, rect.width) / 2;\n  const worldCy = rect.y + Math.max(0, rect.height) / 2;\n  return {\n    x: worldCx - dims.width / (2 * s),\n    y: worldCy - dims.height / (2 * s),\n    scale: { x: s, y: s },\n  };\n}\n\n/**\n * Compute the AABB union of all leaf-node poses in the scene, via\n * `descriptor`. Container nodes are skipped — their effective bounds come\n * from their descendant leaves, and so is a leaf whose bounds are not finite,\n * which would otherwise make the whole union non-finite. Returns `null` when\n * the scene has no leaf with bounds.\n */\nfunction sceneLeafBounds<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  descriptor: PoseDescriptor<TPose>,\n): Bounds | null {\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n  let any = false;\n  for (const node of scene.nodes.values()) {\n    if (node.kind !== 'leaf') continue;\n    const b = poseDescriptorForNode(descriptor, node).getBounds(documentPose(scene, node));\n    if (!Number.isFinite(b.x + b.y + b.width + b.height)) continue;\n    if (b.x < minX) minX = b.x;\n    if (b.y < minY) minY = b.y;\n    const right = b.x + b.width;\n    const bottom = b.y + b.height;\n    if (right > maxX) maxX = right;\n    if (bottom > maxY) maxY = bottom;\n    any = true;\n  }\n  if (!any) return null;\n  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n\n/** Options for {@link computeFitView}. */\nexport interface ComputeFitViewOptions {\n  /** Inset (CSS px) around the fit rect on each side. Defaults to `8`. */\n  padding?: number;\n}\n\n/**\n * Derive a `View` that fits the chosen world rect into a minimap of\n * `dims.width × dims.height` CSS px. Uniform scale on both axes; the rect\n * is centered with `padding` (default 8) on each side. The smaller-axis\n * fit ratio wins, so the whole rect is visible.\n *\n * - `fit === \"scene\"`: union AABB of leaf-node poses via `descriptor`.\n *   Empty scene → {@link FALLBACK_FIT_VIEW}.\n * - `fit` is `{ kind: \"world\", rect }`: fit `rect`.\n * - `fit` is a function: called with `(scene, dims)`; its return is\n *   passed through unchanged.\n *\n * A rect with one zero axis (a line) is fitted along the other. One with no\n * positive axis falls back to identity scale centered on its top-left.\n */\nexport function computeFitView<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  dims: ViewportDims,\n  fit: MinimapFit<TData, TLayer, TPose>,\n  descriptor: PoseDescriptor<TPose>,\n  opts: ComputeFitViewOptions = {},\n): View {\n  const padding = opts.padding ?? DEFAULT_FIT_PADDING;\n\n  if (typeof fit === 'function') {\n    return fit(scene, dims);\n  }\n  if (fit === 'scene') {\n    const rect = sceneLeafBounds(scene, descriptor);\n    if (rect === null) return FALLBACK_FIT_VIEW;\n    return fitRectInto(rect, dims, padding);\n  }\n  // { kind: 'world', rect }\n  return fitRectInto(fit.rect, dims, padding);\n}\n\n/**\n * Build the visible-window indicator `DrawCommand` for the minimap.\n *\n * The main canvas's visible world rect is:\n * ```\n * worldX = mainView.x\n * worldY = mainView.y\n * worldW = mainViewDims.width  / mainView.scale.x\n * worldH = mainViewDims.height / mainView.scale.y\n * ```\n * That world rect is then transformed into the minimap's screen\n * coordinates through `minimapView`.\n *\n * The returned command is a dashed-stroke `path` rect with no fill. Pass the\n * `minimapView` it will be drawn through, so the stroke width and dash come\n * out in CSS px at any fit scale; without it they are in world units.\n */\nexport function computeIndicatorCommand(\n  mainView: View,\n  mainViewDims: ViewportDims,\n  style: IndicatorStyle = {},\n  minimapView?: View,\n): PathDrawCommand {\n  // World-space rect: returned as-is. The caller wraps the command list\n  // (scene + extras) in a group transformed by the minimap's view, so the\n  // indicator lands in screen coords automatically. Returning screen coords\n  // here would get the view transform applied a second time — a bug that\n  // manifested as the indicator drifting at non-identity minimap scale.\n  const x = mainView.x;\n  const y = mainView.y;\n  const width = mainViewDims.width / mainView.scale.x;\n  const height = mainViewDims.height / mainView.scale.y;\n  const px = minimapView ? 1 / Math.abs(minimapView.scale.x) : 1;\n  return {\n    kind: 'path',\n    path: { kind: 'rect', x, y, width, height },\n    stroke: {\n      paint: { fill: 'solid', color: style.stroke ?? DEFAULT_INDICATOR_STROKE },\n      width: (style.width ?? DEFAULT_INDICATOR_WIDTH) * px,\n      dash: (style.dash ?? DEFAULT_INDICATOR_DASH).map((d) => d * px),\n    },\n  };\n}\n"],"mappings":"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"}