@weasel-js/core 1.9.4 → 1.10.0

package/dist/canvas/derivedPath.js

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

package/dist/canvas/derivedPath.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"derivedPath.js","names":["scenePaintedPoseOf","local","toPose","effectivePose","scene","node","composesFrames","chain","n","asNodeId","id","definesFrame","composeWorldPose","sceneDepLookup","slot","memoSlotFor","derivedDepOf","ctx","SlotDep","posed","resolveDerivedPath","showsComputedPath","sceneDerivedPathOf","depOf","childrenOf","derived","toPoseScopes","frame","composes","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 { composesFrames, composeWorldPose, type PoseAdapter } 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\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 * the scene's composition 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): (node: Node<TData, TLayer, TPose>) => TPose {\n  const local = toPose ?? ((node: Node<TData, TLayer, TPose>) => effectivePose(scene, node));\n  if (!composesFrames(scene.composition)) 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, scene.composition.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): (id: NodeId) => DerivedDep<TPose> | undefined {\n  const slot = memoSlotFor(toPose, composesFrames(scene.composition));\n  if (slot === undefined) return (id) => derivedDepOf(scene, id);\n  const ctx: SlotLookup<TPose> = {\n    at: scenePaintedPoseOf(scene, toPose) 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/** Whether something outside `node`'s data says what path it shows: it derives one, or a\n *  pose override carries one. The gate both scene walks check before resolving a path. */\nexport function showsComputedPath<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: { id: NodeId; dependsOn?: readonly NodeId[] | 'children' },\n): boolean {\n  return node.dependsOn !== undefined || scene.overrides.read(node.id)?.path !== undefined;\n}\n\n/**\n * `(node) => the path it shows in place of its data's`: a pose override's `path`, else the\n * one it derives, read through {@link sceneDepLookup}.\n *\n * An override path is in the scene's own frame, so a reader painting through a `toPose` is\n * answered the derived path alone.\n */\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 = memoSlotFor(toPose, composesFrames(scene.composition));\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  const derived = (node: Node<TData, TLayer, TPose>): Path | null =>\n    resolveDerivedPath(node, depOf, childrenOf, slot);\n  if (toPose !== undefined) return derived;\n  return (node) => scene.overrides.read(node.id)?.path ?? derived(node);\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(\n  toPose: object | undefined,\n  composes: boolean,\n): string | NodeMemoScope | undefined {\n  const frame = composes ? '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, or whose pose override\n * carries a path, arrives at the painter 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 (toPose !== undefined ? node.dependsOn === undefined : !showsComputedPath(scene, node)) {\n      return drawOne(node, pose, view, ctx);\n    }\n    return drawOne(node, pose, view, { ...ctx, derivedPath: derivedPathOf(node) });\n  };\n}\n"],"mappings":"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"}

package/dist/canvas/drawEnvelope.js

@@ -10,13 +10,17 @@ function n(t) {
 	return e(t, "getIsVisible")?.() ?? null;
 }
 function r(t) {
-	return e(t, "getPreviewSources")?.() ?? a;
+	return e(t, "getPreviewSources")?.() ?? o;
 }
 function i(t) {
-	return e(t, "getGestureOverlays")?.() ?? o;
+	return e(t, "getGestureOverlays")?.() ?? s;
 }
-var a = [], o = [];
+function a(e) {
+	let t = e?.getDebug;
+	return typeof t == "function" ? t() : null;
+}
+var o = [], s = [];
 //#endregion
-export { t as chromeStateFrom, i as gestureOverlaysFrom, n as isVisibleFrom, r as previewSourcesFrom };
+export { t as chromeStateFrom, a as debugSinkFrom, i as gestureOverlaysFrom, n as isVisibleFrom, r as previewSourcesFrom };
 
 //# sourceMappingURL=drawEnvelope.js.map

package/dist/canvas/drawEnvelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"drawEnvelope.js","names":["thunk","maybe","data","key","chromeStateFrom","isVisibleFrom","previewSourcesFrom","EMPTY_SOURCES","gestureOverlaysFrom","EMPTY_OVERLAYS"],"sources":["../../src/canvas/drawEnvelope.ts"],"sourcesContent":["/**\n * Reading a layer's draw envelope.\n *\n * Every `RenderLayer.draw` receives the drawing view's {@link CanvasHelpers} as\n * its `data` argument, and `<CanvasView>` overlays its own half before handing\n * the stack to a second camera. A layer that answers from a construction\n * closure instead therefore answers for view zero in every view — so these\n * lookups exist to make the envelope the easy source.\n *\n * A layer drawn by a bare consumer may get plain data instead, which is why\n * each reader has an \"unwired\" answer rather than throwing.\n */\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport type { GesturePreviewSource } from './gestureBounds';\nimport type { CanvasViewHelpers } from './useViewHelpers';\n\ntype PartialEnvelope = Partial<CanvasViewHelpers<unknown>>;\n\nfunction thunk<K extends keyof CanvasViewHelpers<unknown>>(\n  data: unknown,\n  key: K,\n): CanvasViewHelpers<unknown>[K] | undefined {\n  const maybe = data as PartialEnvelope | null | undefined;\n  return typeof maybe?.[key] === 'function' ? maybe[key] : undefined;\n}\n\n/** This view's chrome state, or `null` when the caller passed plain data. */\nexport function chromeStateFrom(data: unknown): ChromeState | null {\n  return thunk(data, 'getChromeState')?.() ?? null;\n}\n\n/** This view's chrome-caps predicate, or `null` when the caller passed plain\n *  data — the layer then paints unconditionally. */\nexport function isVisibleFrom(data: unknown): ((id: string) => boolean) | null {\n  return thunk(data, 'getIsVisible')?.() ?? null;\n}\n\n/** This view's in-flight preview surfaces, in resolution order. Empty when\n *  nothing is in flight and when the caller passed plain data. */\nexport function previewSourcesFrom(data: unknown): readonly GesturePreviewSource[] {\n  return thunk(data, 'getPreviewSources')?.() ?? EMPTY_SOURCES;\n}\n\n/** The overlay shapes this view's in-flight handles publish. */\nexport function gestureOverlaysFrom(data: unknown): readonly OngoingOverlay[] {\n  return thunk(data, 'getGestureOverlays')?.() ?? EMPTY_OVERLAYS;\n}\n\n/** First non-null `previewPose(id)` across `sources`, or `null`. */\nexport function previewPoseIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const p = s.previewPose?.(id);\n    if (p != null) return p;\n  }\n  return null;\n}\n\n/** First non-null `previewData(id)` across `sources`, or `null`. */\nexport function previewDataIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const d = s.previewData?.(id);\n    if (d != null) return d;\n  }\n  return null;\n}\n\nconst EMPTY_SOURCES: readonly GesturePreviewSource[] = [];\nconst EMPTY_OVERLAYS: readonly OngoingOverlay[] = [];\n"],"mappings":";AAmBA,SAASA,EACP,GACA,GAC2C;CAC3C,IAAMC,IAAQC;CACd,OAAO,OAAOD,IAAQE,MAAS,aAAaF,EAAME,KAAO,KAAA;AAC3D;AAGA,SAAgBC,EAAgB,GAAmC;CACjE,OAAOJ,EAAME,GAAM,gBAAgB,CAAC,GAAG,KAAK;AAC9C;AAIA,SAAgBG,EAAc,GAAiD;CAC7E,OAAOL,EAAME,GAAM,cAAc,CAAC,GAAG,KAAK;AAC5C;AAIA,SAAgBI,EAAmB,GAAgD;CACjF,OAAON,EAAME,GAAM,mBAAmB,CAAC,GAAG,KAAKK;AACjD;AAGA,SAAgBC,EAAoB,GAA0C;CAC5E,OAAOR,EAAME,GAAM,oBAAoB,CAAC,GAAG,KAAKO;AAClD;AA0BA,IAAMF,IAAiD,CAAC,GAClDE,IAA4C,CAAC"}
+{"version":3,"file":"drawEnvelope.js","names":["thunk","maybe","data","key","chromeStateFrom","isVisibleFrom","previewSourcesFrom","EMPTY_SOURCES","gestureOverlaysFrom","EMPTY_OVERLAYS","debugSinkFrom","getDebug"],"sources":["../../src/canvas/drawEnvelope.ts"],"sourcesContent":["/**\n * Reading a layer's draw envelope.\n *\n * Every `RenderLayer.draw` receives the drawing view's `CanvasHelpers` as its\n * `data` argument. A layer that answers from a construction closure instead\n * answers for view zero in every view. A layer drawn by a bare consumer may\n * get plain data, so each reader has an \"unwired\" answer rather than throwing.\n */\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport type { GesturePreviewSource } from './gestureBounds';\nimport type { DebugSink } from '../debug/types';\nimport type { CanvasSurfaceHelpers, CanvasViewHelpers } from './useViewHelpers';\n\ntype PartialEnvelope = Partial<CanvasViewHelpers<unknown>>;\n\nfunction thunk<K extends keyof CanvasViewHelpers<unknown>>(\n  data: unknown,\n  key: K,\n): CanvasViewHelpers<unknown>[K] | undefined {\n  const maybe = data as PartialEnvelope | null | undefined;\n  return typeof maybe?.[key] === 'function' ? maybe[key] : undefined;\n}\n\n/** This view's chrome state, or `null` when the caller passed plain data. */\nexport function chromeStateFrom(data: unknown): ChromeState | null {\n  return thunk(data, 'getChromeState')?.() ?? null;\n}\n\n/** This view's chrome-caps predicate, or `null` when the caller passed plain\n *  data — the layer then paints unconditionally. */\nexport function isVisibleFrom(data: unknown): ((id: string) => boolean) | null {\n  return thunk(data, 'getIsVisible')?.() ?? null;\n}\n\n/** This view's in-flight preview surfaces, in resolution order. Empty when\n *  nothing is in flight and when the caller passed plain data. */\nexport function previewSourcesFrom(data: unknown): readonly GesturePreviewSource[] {\n  return thunk(data, 'getPreviewSources')?.() ?? EMPTY_SOURCES;\n}\n\n/** The overlay shapes this view's in-flight handles publish. */\nexport function gestureOverlaysFrom(data: unknown): readonly OngoingOverlay[] {\n  return thunk(data, 'getGestureOverlays')?.() ?? EMPTY_OVERLAYS;\n}\n\n/** The surface's debug sink, or `null` when debugging is off and when the\n *  caller passed plain data. */\nexport function debugSinkFrom(data: unknown): DebugSink | null {\n  const getDebug = (data as Partial<CanvasSurfaceHelpers> | null | undefined)?.getDebug;\n  return typeof getDebug === 'function' ? getDebug() : null;\n}\n\n/** First non-null `previewPose(id)` across `sources`, or `null`. */\nexport function previewPoseIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const p = s.previewPose?.(id);\n    if (p != null) return p;\n  }\n  return null;\n}\n\n/** First non-null `previewData(id)` across `sources`, or `null`. */\nexport function previewDataIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const d = s.previewData?.(id);\n    if (d != null) return d;\n  }\n  return null;\n}\n\nconst EMPTY_SOURCES: readonly GesturePreviewSource[] = [];\nconst EMPTY_OVERLAYS: readonly OngoingOverlay[] = [];\n"],"mappings":";AAgBA,SAASA,EACP,GACA,GAC2C;CAC3C,IAAMC,IAAQC;CACd,OAAO,OAAOD,IAAQE,MAAS,aAAaF,EAAME,KAAO,KAAA;AAC3D;AAGA,SAAgBC,EAAgB,GAAmC;CACjE,OAAOJ,EAAME,GAAM,gBAAgB,CAAC,GAAG,KAAK;AAC9C;AAIA,SAAgBG,EAAc,GAAiD;CAC7E,OAAOL,EAAME,GAAM,cAAc,CAAC,GAAG,KAAK;AAC5C;AAIA,SAAgBI,EAAmB,GAAgD;CACjF,OAAON,EAAME,GAAM,mBAAmB,CAAC,GAAG,KAAKK;AACjD;AAGA,SAAgBC,EAAoB,GAA0C;CAC5E,OAAOR,EAAME,GAAM,oBAAoB,CAAC,GAAG,KAAKO;AAClD;AAIA,SAAgBC,EAAc,GAAiC;CAC7D,IAAMC,IAAYT,GAA2D;CAC7E,OAAO,OAAOS,KAAa,aAAaA,EAAS,IAAI;AACvD;AA0BA,IAAMJ,IAAiD,CAAC,GAClDE,IAA4C,CAAC"}

package/dist/canvas/getNodeAtPoint.js

@@ -2,13 +2,9 @@
 function e(e, t) {
 	return (n, r, i) => {
 		let a = e(n, r, i);
-		if (a == null) return null;
-		let o = t?.(a) ?? null;
-		return {
+		return a == null ? null : {
 			id: a,
-			kind: o?.kind ?? "unknown",
-			pose: o?.pose,
-			data: o?.data ?? { id: a }
+			kind: t?.(a)?.kind ?? "unknown"
 		};
 	};
 }

package/dist/canvas/getNodeAtPoint.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"getNodeAtPoint.js","names":["makeGetNodeAtPoint","id","pickBest","wx","wy","view","nodeResolver"],"sources":["../../src/canvas/getNodeAtPoint.ts"],"sourcesContent":["import type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/** The hit record returned by a `getNodeAtPoint` function. */\nexport interface NodeAtPointHit {\n  id: string;\n  kind: string;\n}\n\n/** Resolves a node's routing kind. */\nexport type NodeResolver = (id: string) => { kind: string } | null;\n\n/** The node a single-hit picker names under a world point, with its kind:\n *  `'unknown'` when `nodeResolver` is absent or returns null. */\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    return { id, kind: nodeResolver?.(id)?.kind ?? 'unknown' };\n  };\n}\n"],"mappings":";AAaA,SAAgBA,EACd,GACA,GAC2E;CAC3E,QAAQ,GAAY,GAAY,MAAkD;EAChF,IAAMC,IAAKC,EAASC,GAAIC,GAAIC,CAAI;EAGhC,OAFIJ,KAAM,OAAa,OAEhB;GAAE;GAAI,MAAMK,IAAeL,CAAE,CAAC,EAAE,QAAQ;EAAU;CAC3D;AACF"}

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: 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":""}
+{"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: var(--wzl-z-hud, 900);\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: var(--wzl-space-3, 6px) var(--wzl-space-4, 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: var(--wzl-space-4, 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: var(--wzl-space-1, 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: var(--wzl-space-4, 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/insertPreviewExtent.js.map

@@ -1 +1 @@
-{"version":3,"file":"insertPreviewExtent.js","names":["insertPreviewExtent","b","ov","box","e","b2","aabbOf","center","radius","radialBox","outerRadius","samples","pts","minX","minY","maxX","maxY","p"],"sources":["../../src/canvas/insertPreviewExtent.ts"],"sourcesContent":["/**\n * The one answer to \"how big is the thing this in-flight insert is making\".\n *\n * A drag-to-insert has no scene node until commit, so three surfaces have to\n * size the nascent shape themselves: `useDispatcherOverlayLayer` (paints the\n * preview), `canvas/deps/insert` (poses the committed node) and\n * `dispatcherGestureBounds` (reports the gesture's world AABB to `<Canvas>`).\n * They all resolve it here.\n *\n * The drag AABB alone is NOT the answer. `insertAction` hands over an\n * `extras` payload that can carry richer geometry than the drag rect —\n * a polygon's center+radius, a pencil's sample trail, a line's endpoints —\n * and where it does, that geometry is the shape. A centered Alt-drag\n * produces a `d`-wide drag rect around a `d√2` circumradius; a pencil that\n * loops back to its start produces a zero-area drag rect around a trail that\n * swept the page.\n */\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\n\ntype Point = { x: number; y: number };\n\n/** The fields of an `insertPreview` overlay this needs. `canvas/deps/insert`\n *  passes the equivalent from its own `(bounds, extras)` commit arguments. */\nexport interface InsertPreviewLike {\n  shape: string;\n  bounds: { x: number; y: number; width: number; height: number };\n  extras: unknown;\n}\n\n/** Resolved preview geometry, in the terms the path builders take. */\nexport type InsertPreviewGeometry =\n  | { kind: 'box' }\n  | { kind: 'line'; a: Point; b: Point }\n  | { kind: 'polygon'; center: Point; radius: number; sides: number; rotation: number }\n  | {\n      kind: 'star';\n      center: Point;\n      outerRadius: number;\n      innerRadius: number;\n      points: number;\n      rotation: number;\n    }\n  | { kind: 'pencil'; samples: ReadonlyArray<Point> };\n\n/** An in-flight insert's shape, resolved from its drag rect and `extras`. */\nexport interface InsertPreviewExtent {\n  /** The insert kind, verbatim from the caller. */\n  shape: string;\n  /** World-space AABB of `geometry` — the extent. */\n  bounds: Bounds;\n  geometry: InsertPreviewGeometry;\n}\n\n/** The `insertPreview` member of `OngoingOverlay`, which `insertAction` publishes during a drag-to-insert. */\nexport type InsertPreviewOverlay = Extract<OngoingOverlay, { kind: 'insertPreview' }>;\n\n/** Resolve an in-flight insert's geometry and world AABB. Uses the geometry in\n *  `extras` where the shape carries it; an unknown shape falls back to its drag rect. */\nexport function insertPreviewExtent(ov: InsertPreviewLike): InsertPreviewExtent {\n  const b = ov.bounds;\n  const box = { x: b.x, y: b.y, width: b.width, height: b.height };\n\n  switch (ov.shape) {\n    case 'line': {\n      const e = ov.extras as Partial<{ a: Point; b: Point }>;\n      const a = e.a ?? { x: b.x, y: b.y };\n      const b2 = e.b ?? { x: b.x + b.width, y: b.y + b.height };\n      return { shape: ov.shape, bounds: aabbOf([a, b2]) ?? box, geometry: { kind: 'line', a, b: b2 } };\n    }\n    case 'polygon': {\n      const e = ov.extras as Partial<{\n        sides: number; rotation: number; center: Point; radius: number;\n      }>;\n      const center = e.center ?? { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n      const radius = e.radius ?? Math.min(b.width, b.height) / 2;\n      return {\n        shape: ov.shape,\n        bounds: radialBox(center, radius),\n        geometry: {\n          kind: 'polygon',\n          center,\n          radius,\n          sides: Math.max(3, Math.floor(e.sides ?? 6)),\n          rotation: e.rotation ?? 0,\n        },\n      };\n    }\n    case 'star': {\n      const e = ov.extras as Partial<{\n        points: number; innerRadiusRatio: number; rotation: number;\n        center: Point; outerRadius: number;\n      }>;\n      const center = e.center ?? { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n      const outerRadius = e.outerRadius ?? Math.min(b.width, b.height) / 2;\n      return {\n        shape: ov.shape,\n        bounds: radialBox(center, outerRadius),\n        geometry: {\n          kind: 'star',\n          center,\n          outerRadius,\n          innerRadius: outerRadius * (e.innerRadiusRatio ?? 0.5),\n          points: Math.max(3, Math.floor(e.points ?? 5)),\n          rotation: e.rotation ?? 0,\n        },\n      };\n    }\n    case 'pencil': {\n      const e = ov.extras as Partial<{ samples: ReadonlyArray<Point> }>;\n      const samples = e.samples ?? [];\n      return {\n        shape: ov.shape,\n        bounds: aabbOf(samples) ?? box,\n        geometry: { kind: 'pencil', samples },\n      };\n    }\n    default:\n      return { shape: ov.shape, bounds: box, geometry: { kind: 'box' } };\n  }\n}\n\n/** A radial shape's extent is its circumscribed square, not the drag rect. */\nfunction radialBox(center: Point, radius: number): Bounds {\n  return { x: center.x - radius, y: center.y - radius, width: radius * 2, height: radius * 2 };\n}\n\nfunction aabbOf(pts: ReadonlyArray<Point>): Bounds | null {\n  if (pts.length === 0) return null;\n  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;\n  for (const p of pts) {\n    if (p.x < minX) minX = p.x;\n    if (p.y < minY) minY = p.y;\n    if (p.x > maxX) maxX = p.x;\n    if (p.y > maxY) maxY = p.y;\n  }\n  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n"],"mappings":";AA2DA,SAAgBA,EAAoB,GAA4C;CAC9E,IAAMC,IAAIC,EAAG,QACPC,IAAM;EAAE,GAAGF,EAAE;EAAG,GAAGA,EAAE;EAAG,OAAOA,EAAE;EAAO,QAAQA,EAAE;CAAO;CAE/D,QAAQC,EAAG,OAAX;EACE,KAAK,QAAQ;GACX,IAAME,IAAIF,EAAG,QACP,IAAIE,EAAE,KAAK;IAAE,GAAGH,EAAE;IAAG,GAAGA,EAAE;GAAE,GAC5BI,IAAKD,EAAE,KAAK;IAAE,GAAGH,EAAE,IAAIA,EAAE;IAAO,GAAGA,EAAE,IAAIA,EAAE;GAAO;GACxD,OAAO;IAAE,OAAOC,EAAG;IAAO,QAAQI,EAAO,CAAC,GAAGD,CAAE,CAAC,KAAKF;IAAK,UAAU;KAAE,MAAM;KAAQ;KAAG,GAAGE;IAAG;GAAE;EACjG;EACA,KAAK,WAAW;GACd,IAAMD,IAAIF,EAAG,QAGPK,IAASH,EAAE,UAAU;IAAE,GAAGH,EAAE,IAAIA,EAAE,QAAQ;IAAG,GAAGA,EAAE,IAAIA,EAAE,SAAS;GAAE,GACnEO,IAASJ,EAAE,UAAU,KAAK,IAAIH,EAAE,OAAOA,EAAE,MAAM,IAAI;GACzD,OAAO;IACL,OAAOC,EAAG;IACV,QAAQO,EAAUF,GAAQC,CAAM;IAChC,UAAU;KACR,MAAM;KACN;KACA;KACA,OAAO,KAAK,IAAI,GAAG,KAAK,MAAMJ,EAAE,SAAS,CAAC,CAAC;KAC3C,UAAUA,EAAE,YAAY;IAC1B;GACF;EACF;EACA,KAAK,QAAQ;GACX,IAAMA,IAAIF,EAAG,QAIPK,IAASH,EAAE,UAAU;IAAE,GAAGH,EAAE,IAAIA,EAAE,QAAQ;IAAG,GAAGA,EAAE,IAAIA,EAAE,SAAS;GAAE,GACnES,IAAcN,EAAE,eAAe,KAAK,IAAIH,EAAE,OAAOA,EAAE,MAAM,IAAI;GACnE,OAAO;IACL,OAAOC,EAAG;IACV,QAAQO,EAAUF,GAAQG,CAAW;IACrC,UAAU;KACR,MAAM;KACN;KACA;KACA,aAAaA,KAAeN,EAAE,oBAAoB;KAClD,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAMA,EAAE,UAAU,CAAC,CAAC;KAC7C,UAAUA,EAAE,YAAY;IAC1B;GACF;EACF;EACA,KAAK,UAAU;GAEb,IAAMO,IADIT,EAAG,OACK,WAAW,CAAC;GAC9B,OAAO;IACL,OAAOA,EAAG;IACV,QAAQI,EAAOK,CAAO,KAAKR;IAC3B,UAAU;KAAE,MAAM;KAAU;IAAQ;GACtC;EACF;EACA,SACE,OAAO;GAAE,OAAOD,EAAG;GAAO,QAAQC;GAAK,UAAU,EAAE,MAAM,MAAM;EAAE;CACrE;AACF;AAGA,SAASM,EAAU,GAAe,GAAwB;CACxD,OAAO;EAAE,GAAGF,EAAO,IAAIC;EAAQ,GAAGD,EAAO,IAAIC;EAAQ,OAAOA,IAAS;EAAG,QAAQA,IAAS;CAAE;AAC7F;AAEA,SAASF,EAAO,GAA0C;CACxD,IAAIM,EAAI,WAAW,GAAG,OAAO;CAC7B,IAAIC,IAAO,UAAUC,IAAO,UAAUC,IAAO,WAAWC,IAAO;CAC/D,KAAK,IAAMC,KAAKL,GAId,AAHIK,EAAE,IAAIJ,MAAM,IAAOI,EAAE,IACrBA,EAAE,IAAIH,MAAM,IAAOG,EAAE,IACrBA,EAAE,IAAIF,MAAM,IAAOE,EAAE,IACrBA,EAAE,IAAID,MAAM,IAAOC,EAAE;CAE3B,OAAO;EAAE,GAAGJ;EAAM,GAAGC;EAAM,OAAOC,IAAOF;EAAM,QAAQG,IAAOF;CAAK;AACrE"}
+{"version":3,"file":"insertPreviewExtent.js","names":["insertPreviewExtent","b","ov","box","e","b2","aabbOf","center","radius","radialBox","outerRadius","samples","pts","minX","minY","maxX","maxY","p"],"sources":["../../src/canvas/insertPreviewExtent.ts"],"sourcesContent":["/**\n * The one answer to \"how big is the thing this in-flight insert is making\",\n * shared by the preview paint, the commit, and the gesture's reported bounds.\n *\n * The drag AABB alone is NOT the answer. `insertAction` hands over an\n * `extras` payload that can carry richer geometry than the drag rect, and\n * where it does, that geometry is the shape: a pencil that loops back to its\n * start produces a zero-area drag rect around a trail that swept the page.\n */\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\n\ntype Point = { x: number; y: number };\n\n/** The fields of an `insertPreview` overlay this needs. `canvas/deps/insert`\n *  passes the equivalent from its own `(bounds, extras)` commit arguments. */\nexport interface InsertPreviewLike {\n  shape: string;\n  bounds: { x: number; y: number; width: number; height: number };\n  extras: unknown;\n}\n\n/** Resolved preview geometry, in the terms the path builders take. */\nexport type InsertPreviewGeometry =\n  | { kind: 'box' }\n  | { kind: 'line'; a: Point; b: Point }\n  | { kind: 'polygon'; center: Point; radius: number; sides: number; rotation: number }\n  | {\n      kind: 'star';\n      center: Point;\n      outerRadius: number;\n      innerRadius: number;\n      points: number;\n      rotation: number;\n    }\n  | { kind: 'pencil'; samples: ReadonlyArray<Point> };\n\n/** An in-flight insert's shape, resolved from its drag rect and `extras`. */\nexport interface InsertPreviewExtent {\n  /** The insert kind, verbatim from the caller. */\n  shape: string;\n  /** World-space AABB of `geometry` — the extent. */\n  bounds: Bounds;\n  geometry: InsertPreviewGeometry;\n}\n\n/** The `insertPreview` member of `OngoingOverlay`, which `insertAction` publishes during a drag-to-insert. */\nexport type InsertPreviewOverlay = Extract<OngoingOverlay, { kind: 'insertPreview' }>;\n\n/** Resolve an in-flight insert's geometry and world AABB. Uses the geometry in\n *  `extras` where the shape carries it; an unknown shape falls back to its drag rect. */\nexport function insertPreviewExtent(ov: InsertPreviewLike): InsertPreviewExtent {\n  const b = ov.bounds;\n  const box = { x: b.x, y: b.y, width: b.width, height: b.height };\n\n  switch (ov.shape) {\n    case 'line': {\n      const e = ov.extras as Partial<{ a: Point; b: Point }>;\n      const a = e.a ?? { x: b.x, y: b.y };\n      const b2 = e.b ?? { x: b.x + b.width, y: b.y + b.height };\n      return { shape: ov.shape, bounds: aabbOf([a, b2]) ?? box, geometry: { kind: 'line', a, b: b2 } };\n    }\n    case 'polygon': {\n      const e = ov.extras as Partial<{\n        sides: number; rotation: number; center: Point; radius: number;\n      }>;\n      const center = e.center ?? { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n      const radius = e.radius ?? Math.min(b.width, b.height) / 2;\n      return {\n        shape: ov.shape,\n        bounds: radialBox(center, radius),\n        geometry: {\n          kind: 'polygon',\n          center,\n          radius,\n          sides: Math.max(3, Math.floor(e.sides ?? 6)),\n          rotation: e.rotation ?? 0,\n        },\n      };\n    }\n    case 'star': {\n      const e = ov.extras as Partial<{\n        points: number; innerRadiusRatio: number; rotation: number;\n        center: Point; outerRadius: number;\n      }>;\n      const center = e.center ?? { x: b.x + b.width / 2, y: b.y + b.height / 2 };\n      const outerRadius = e.outerRadius ?? Math.min(b.width, b.height) / 2;\n      return {\n        shape: ov.shape,\n        bounds: radialBox(center, outerRadius),\n        geometry: {\n          kind: 'star',\n          center,\n          outerRadius,\n          innerRadius: outerRadius * (e.innerRadiusRatio ?? 0.5),\n          points: Math.max(3, Math.floor(e.points ?? 5)),\n          rotation: e.rotation ?? 0,\n        },\n      };\n    }\n    case 'pencil': {\n      const e = ov.extras as Partial<{ samples: ReadonlyArray<Point> }>;\n      const samples = e.samples ?? [];\n      return {\n        shape: ov.shape,\n        bounds: aabbOf(samples) ?? box,\n        geometry: { kind: 'pencil', samples },\n      };\n    }\n    default:\n      return { shape: ov.shape, bounds: box, geometry: { kind: 'box' } };\n  }\n}\n\n/** A radial shape's extent is its circumscribed square, not the drag rect. */\nfunction radialBox(center: Point, radius: number): Bounds {\n  return { x: center.x - radius, y: center.y - radius, width: radius * 2, height: radius * 2 };\n}\n\nfunction aabbOf(pts: ReadonlyArray<Point>): Bounds | null {\n  if (pts.length === 0) return null;\n  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;\n  for (const p of pts) {\n    if (p.x < minX) minX = p.x;\n    if (p.y < minY) minY = p.y;\n    if (p.x > maxX) maxX = p.x;\n    if (p.y > maxY) maxY = p.y;\n  }\n  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n"],"mappings":";AAmDA,SAAgBA,EAAoB,GAA4C;CAC9E,IAAMC,IAAIC,EAAG,QACPC,IAAM;EAAE,GAAGF,EAAE;EAAG,GAAGA,EAAE;EAAG,OAAOA,EAAE;EAAO,QAAQA,EAAE;CAAO;CAE/D,QAAQC,EAAG,OAAX;EACE,KAAK,QAAQ;GACX,IAAME,IAAIF,EAAG,QACP,IAAIE,EAAE,KAAK;IAAE,GAAGH,EAAE;IAAG,GAAGA,EAAE;GAAE,GAC5BI,IAAKD,EAAE,KAAK;IAAE,GAAGH,EAAE,IAAIA,EAAE;IAAO,GAAGA,EAAE,IAAIA,EAAE;GAAO;GACxD,OAAO;IAAE,OAAOC,EAAG;IAAO,QAAQI,EAAO,CAAC,GAAGD,CAAE,CAAC,KAAKF;IAAK,UAAU;KAAE,MAAM;KAAQ;KAAG,GAAGE;IAAG;GAAE;EACjG;EACA,KAAK,WAAW;GACd,IAAMD,IAAIF,EAAG,QAGPK,IAASH,EAAE,UAAU;IAAE,GAAGH,EAAE,IAAIA,EAAE,QAAQ;IAAG,GAAGA,EAAE,IAAIA,EAAE,SAAS;GAAE,GACnEO,IAASJ,EAAE,UAAU,KAAK,IAAIH,EAAE,OAAOA,EAAE,MAAM,IAAI;GACzD,OAAO;IACL,OAAOC,EAAG;IACV,QAAQO,EAAUF,GAAQC,CAAM;IAChC,UAAU;KACR,MAAM;KACN;KACA;KACA,OAAO,KAAK,IAAI,GAAG,KAAK,MAAMJ,EAAE,SAAS,CAAC,CAAC;KAC3C,UAAUA,EAAE,YAAY;IAC1B;GACF;EACF;EACA,KAAK,QAAQ;GACX,IAAMA,IAAIF,EAAG,QAIPK,IAASH,EAAE,UAAU;IAAE,GAAGH,EAAE,IAAIA,EAAE,QAAQ;IAAG,GAAGA,EAAE,IAAIA,EAAE,SAAS;GAAE,GACnES,IAAcN,EAAE,eAAe,KAAK,IAAIH,EAAE,OAAOA,EAAE,MAAM,IAAI;GACnE,OAAO;IACL,OAAOC,EAAG;IACV,QAAQO,EAAUF,GAAQG,CAAW;IACrC,UAAU;KACR,MAAM;KACN;KACA;KACA,aAAaA,KAAeN,EAAE,oBAAoB;KAClD,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAMA,EAAE,UAAU,CAAC,CAAC;KAC7C,UAAUA,EAAE,YAAY;IAC1B;GACF;EACF;EACA,KAAK,UAAU;GAEb,IAAMO,IADIT,EAAG,OACK,WAAW,CAAC;GAC9B,OAAO;IACL,OAAOA,EAAG;IACV,QAAQI,EAAOK,CAAO,KAAKR;IAC3B,UAAU;KAAE,MAAM;KAAU;IAAQ;GACtC;EACF;EACA,SACE,OAAO;GAAE,OAAOD,EAAG;GAAO,QAAQC;GAAK,UAAU,EAAE,MAAM,MAAM;EAAE;CACrE;AACF;AAGA,SAASM,EAAU,GAAe,GAAwB;CACxD,OAAO;EAAE,GAAGF,EAAO,IAAIC;EAAQ,GAAGD,EAAO,IAAIC;EAAQ,OAAOA,IAAS;EAAG,QAAQA,IAAS;CAAE;AAC7F;AAEA,SAASF,EAAO,GAA0C;CACxD,IAAIM,EAAI,WAAW,GAAG,OAAO;CAC7B,IAAIC,IAAO,UAAUC,IAAO,UAAUC,IAAO,WAAWC,IAAO;CAC/D,KAAK,IAAMC,KAAKL,GAId,AAHIK,EAAE,IAAIJ,MAAM,IAAOI,EAAE,IACrBA,EAAE,IAAIH,MAAM,IAAOG,EAAE,IACrBA,EAAE,IAAIF,MAAM,IAAOE,EAAE,IACrBA,EAAE,IAAID,MAAM,IAAOC,EAAE;CAE3B,OAAO;EAAE,GAAGJ;EAAM,GAAGC;EAAM,OAAOC,IAAOF;EAAM,QAAQG,IAAOF;CAAK;AACrE"}

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","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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"}
+{"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 { 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 * - Standard slots are emitted in `STANDARD_SLOTS` order.\n * - `after: 'X'` / `before: 'X'` accept standard slot names OR other\n *   custom-layer keys, and chains may mix the two.\n * - Customs with neither `after` nor `before` are emitted after all standard\n *   slots.\n * - Dangling references and cycles go to the tail with a `console.warn`.\n * - An entry with both `after` and `before` is placed by `after`.\n */\nexport function composeOrderedLayers(\n  layersMap: Record<string, unknown>,\n  standardLayers: Partial<Record<(typeof STANDARD_SLOTS)[number], RenderLayer<unknown>>>,\n  /** The `scene` slot split into per-scene-layer canvas layers (keyed\n   *  `scene:<layerId>`), in render order. Each key becomes an anchor point;\n   *  `before/after: 'scene'` brackets the whole group. When omitted, the\n   *  `scene` slot uses `standardLayers.scene`. */\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      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  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 * With no selection chrome present the anchored overlays fall back to the\n * tail, keeping their relative order. Mutates and returns `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/layerSlots.js

@@ -8,7 +8,12 @@ var e = [
 function t(e) {
 	return !!e && typeof e == "object" && "layer" in e;
 }
+function n(e) {
+	let n = {};
+	for (let [r, i] of Object.entries(e)) (i === null || t(i)) && (n[r] = i);
+	return n;
+}
 //#endregion
-export { e as STANDARD_SLOTS, t as isCustomEntry };
+export { e as STANDARD_SLOTS, n as builtLayersOf, t as isCustomEntry };
 
 //# sourceMappingURL=layerSlots.js.map

package/dist/canvas/layerSlots.js.map

@@ -1 +1 @@
-{"version":3,"file":"layerSlots.js","names":["STANDARD_SLOTS","isCustomEntry","v"],"sources":["../../src/canvas/layerSlots.ts"],"sourcesContent":["import type { RenderLayer } from '../core/layers/render';\n\n/** Standard slot names — render in this canonical order.\n *  `cellHighlight` is not an anchor for custom layers: it sits between the\n *  grid and the scene, so anchor to one of those. */\n/** @internal */\nexport const STANDARD_SLOTS = [\n  'grid',\n  'cellHighlight',\n  'scene',\n  'selectionOverlay',\n] as const;\n\n/** Names of the slots `<Canvas>` supports out of the box (excluding the implicit cell-highlight overlay). */\nexport type StandardSlotName = Exclude<(typeof STANDARD_SLOTS)[number], 'cellHighlight'>;\n\n/** Custom layer entry — any key not in `STANDARD_SLOTS`. The presence of\n *  `.layer` discriminates this from a slot config. */\nexport interface CustomLayerEntry {\n  layer: RenderLayer<unknown>;\n  /** Insert immediately after the named standard slot or another custom-layer key. */\n  after?: StandardSlotName | (string & {});\n  /** Insert immediately before the named standard slot or another custom-layer key. */\n  before?: StandardSlotName | (string & {});\n}\n\nexport function isCustomEntry(v: unknown): v is CustomLayerEntry {\n  return !!v && typeof v === 'object' && 'layer' in (v as Record<string, unknown>);\n}\n"],"mappings":";AAMA,IAAaA,IAAiB;CAC5B;CACA;CACA;CACA;AACF;AAeA,SAAgBC,EAAc,GAAmC;CAC/D,OAAO,CAAC,CAACC,KAAK,OAAOA,KAAM,YAAY,WAAYA;AACrD"}
+{"version":3,"file":"layerSlots.js","names":["STANDARD_SLOTS","isCustomEntry","v","builtLayersOf","out","key","value","map"],"sources":["../../src/canvas/layerSlots.ts"],"sourcesContent":["import type { RenderLayer } from '../core/layers/render';\nimport type { SelectionOverlayLayerOpts } from 'features/selection/overlay';\nimport type { SceneSlotConfig } from './buildSceneLayer';\n\n/** Standard slot names — render in this canonical order.\n *  `cellHighlight` is not an anchor for custom layers: it sits between the\n *  grid and the scene, so anchor to one of those. */\n/** @internal */\nexport const STANDARD_SLOTS = [\n  'grid',\n  'cellHighlight',\n  'scene',\n  'selectionOverlay',\n] as const;\n\n/** Names of the slots `<Canvas>` supports out of the box (excluding the implicit cell-highlight overlay). */\nexport type StandardSlotName = Exclude<(typeof STANDARD_SLOTS)[number], 'cellHighlight'>;\n\n/** Custom layer entry — any key not in `STANDARD_SLOTS`. The presence of\n *  `.layer` discriminates this from a slot config. */\nexport interface CustomLayerEntry {\n  layer: RenderLayer<unknown>;\n  /** Insert immediately after the named standard slot or another custom-layer key. */\n  after?: StandardSlotName | (string & {});\n  /** Insert immediately before the named standard slot or another custom-layer key. */\n  before?: StandardSlotName | (string & {});\n}\n\nexport function isCustomEntry(v: unknown): v is CustomLayerEntry {\n  return !!v && typeof v === 'object' && 'layer' in (v as Record<string, unknown>);\n}\n\n/** Selection-overlay slot config — passed through to `createSelectionOverlayLayer`,\n *  minus the `getSelection`/`getPose` the canvas wires automatically. */\nexport type SelectionOverlaySlotConfig<TPose> = Omit<\n  SelectionOverlayLayerOpts<TPose>,\n  'getSelection' | 'getPose'\n> & {\n  /** Override the auto-wired pose lookup (overlay-aware → adapter fallback). */\n  poseById?: (id: string) => TPose | null;\n};\n\n/** Per-slot config union. The key narrows it in practice. */\nexport type StandardSlotConfig<TNode extends { id: string }, TPose> =\n  | SceneSlotConfig<TNode, TPose>\n  | SelectionOverlaySlotConfig<TPose>;\n\n/** What may fill one of the canvas's named layer slots: a config the canvas\n *  builds the layer from, a pre-built layer, or `null` to leave the slot\n *  empty. */\nexport type LayerSlotValue<TNode extends { id: string }, TPose> =\n  | StandardSlotConfig<TNode, TPose>\n  | CustomLayerEntry\n  | null;\n\n/** The canvas's render stack, as named slots. The standard slots (grid,\n *  scene, selection overlay, cell highlight) fix where a layer sits in the\n *  stack; scene and selection overlay can be configured, and every one can be\n *  given a layer of your own or switched off. Further keys add custom layers.\n *  `TSceneSlot` is what the scene slot accepts: `<SceneCanvas>` takes a\n *  partial config and fills the rest from its defaults. */\nexport type LayersMap<\n  TNode extends { id: string },\n  TPose,\n  TSceneSlot = SceneSlotConfig<TNode, TPose>,\n> = {\n  /** Grid slot, beneath the scene. Takes a pre-built layer (`{ layer }`) —\n   *  e.g. `createGridLayer` from `@weasel-js/guides` — or `null`. */\n  grid?: CustomLayerEntry | null;\n  /** Scene slot: the config `<SceneCanvas>` builds its layers from, a\n   *  pre-built layer that paints the scene in their place, or `null`. A\n   *  pre-built layer gets no ghost of a node in flight, which needs `drawOne`. */\n  scene?: TSceneSlot | CustomLayerEntry | null;\n  /** Selection-overlay slot: the config `<SceneCanvas>` builds the layer\n   *  from, a pre-built layer that paints in its place, or `null` for no\n   *  selection chrome. */\n  selectionOverlay?: SelectionOverlaySlotConfig<TPose> | CustomLayerEntry | null;\n  /** Cell-highlight overlay slot, drawn immediately after the grid. Takes a\n   *  pre-built layer (`{ layer }`) — e.g. `createCellHighlightLayer` from\n   *  `@weasel-js/guides` — or `null`. */\n  cellHighlight?: CustomLayerEntry | null;\n} & {\n  [customKey: string]: LayerSlotValue<TNode, TPose> | TSceneSlot | undefined;\n};\n\n/** The scene slot once built: its canvas layers, bottom first. Each `key` is\n *  an anchor a custom layer can name (`scene`, or `scene:<layerId>`). */\nexport interface SceneSlotLayers {\n  layers: ReadonlyArray<{ key: string; layer: RenderLayer<unknown> }>;\n}\n\n/** What `<Canvas>` composes: a {@link LayersMap} with every slot already a\n *  layer. `<SceneCanvas>` builds one from its `layers` prop. */\nexport type CanvasLayers = {\n  grid?: CustomLayerEntry | null;\n  cellHighlight?: CustomLayerEntry | null;\n  scene?: SceneSlotLayers | null;\n  selectionOverlay?: CustomLayerEntry | null;\n} & {\n  [customKey: string]: CustomLayerEntry | SceneSlotLayers | null | undefined;\n};\n\n/** The layers of `map` that are already built, in its key order: each\n *  `{ layer }` entry and each `null`. A slot config is left out, for whoever\n *  builds it to put back. */\nexport function builtLayersOf(map: Record<string, unknown>): Record<string, CustomLayerEntry | null> {\n  const out: Record<string, CustomLayerEntry | null> = {};\n  for (const [key, value] of Object.entries(map)) {\n    if (value === null || isCustomEntry(value)) out[key] = value;\n  }\n  return out;\n}\n"],"mappings":";AAQA,IAAaA,IAAiB;CAC5B;CACA;CACA;CACA;AACF;AAeA,SAAgBC,EAAc,GAAmC;CAC/D,OAAO,CAAC,CAACC,KAAK,OAAOA,KAAM,YAAY,WAAYA;AACrD;AA2EA,SAAgBC,EAAc,GAAuE;CACnG,IAAMC,IAA+C,CAAC;CACtD,KAAK,IAAM,CAACC,GAAKC,MAAU,OAAO,QAAQC,CAAG,GAC3C,CAAID,MAAU,QAAQL,EAAcK,CAAK,OAAG,EAAID,KAAOC;CAEzD,OAAOF;AACT"}

package/dist/canvas/nodeShapes/derivedPainter.js

@@ -1,30 +1,30 @@
-import { commandFill as e, commandStroke as t } from "../../features/patterns/commandPaint.js";
-import { DEFAULT_SHAPE_FILL as n } from "../../util/paint.js";
-import { derivesPath as r } from "./memo.js";
-import { inkReach as i, resolveNodeFill as a, resolveNodeStroke as o, withAnimatedVertexColors as s } from "./nodePaint.js";
+import { DEFAULT_SHAPE_FILL as e } from "../../util/paint.js";
+import { derivesPath as t } from "./memo.js";
+import { inkReach as n, resolveNodeFill as r, resolveNodeStroke as i, withAnimatedVertexColors as a } from "./nodePaint.js";
+import { commandFill as o, commandStroke as s } from "@weasel-js/renderer";
 import { boundsOfPath as c } from "@weasel-js/geom";
 //#region src/canvas/nodeShapes/derivedPainter.ts
 var l = {
 	id: "kit:derived",
-	matches: r,
-	paint: (r, i, l) => {
+	matches: t,
+	paint: (t, n, l) => {
 		let u = l?.derivedPath;
 		if (u == null) return [];
-		let d = c(u), f = r.data, p = o(f?.stroke), m = a(f?.fill, p === null ? n : null), h = m && e(m, d), g = p && t(p, d), _ = {
+		let d = c(u), f = t.data, p = i(f?.stroke), m = r(f?.fill, p === null ? e : null), h = m && o(m, d), g = p && s(p, d), _ = {
 			kind: "path",
 			path: u,
 			...h ? { fill: h } : {},
 			...h && f?.vertexColors ? { vertexColors: f.vertexColors } : {},
 			...g ? { stroke: g } : {}
 		};
-		return s([_], l);
+		return a([_], l);
 	},
 	silhouette: (e, t, n) => n?.derivedPath ?? null,
-	ink: (e, t, r) => {
-		let s = e.data, c = o(s?.stroke);
+	ink: (t, a, o) => {
+		let s = t.data, c = i(s?.stroke);
 		return {
-			filled: a(s?.fill, c === null ? n : null) !== null,
-			...i(c, r?.scale)
+			filled: r(s?.fill, c === null ? e : null) !== null,
+			...n(c, o?.scale)
 		};
 	}
 };

package/dist/canvas/nodeShapes/derivedPainter.js.map

@@ -1 +1 @@
-{"version":3,"file":"derivedPainter.js","names":["DERIVED_PAINTER","derivesPath","path","ctx","box","boundsOfPath","d","node","strokeSpec","resolveNodeStroke","declared","resolveNodeFill","DEFAULT_SHAPE_FILL","fill","commandFill","stroke","commandStroke","cmd","withAnimatedVertexColors","inkReach"],"sources":["../../../src/canvas/nodeShapes/derivedPainter.ts"],"sourcesContent":["import {\n  boundsOfPath\n} from '@weasel-js/geom';\nimport type { FillStyle, Stroke } from '@weasel-js/paint';\nimport type { NodeShapeEntry } from 'canvas/NodeShape';\nimport { commandFill, commandStroke } from '../../features/patterns/commandPaint';\nimport type { DrawCommand } from '../../renderer';\nimport { DEFAULT_SHAPE_FILL } from '../../util/paint';\nimport { derivesPath } from './memo';\nimport { inkReach, withAnimatedVertexColors, resolveNodeFill, resolveNodeStroke } from './nodePaint';\n\n// ─── Built-in painters ─────────────────────────────────────────────────\n/**\n * Built-in painter for nodes whose geometry is computed from other nodes'\n * poses. The path itself arrives on the paint context — see\n * {@link NodePaintCtx.derivedPath}.\n *\n * Fill and stroke resolve as `kit:path`'s do, but against the **derived path's\n * own bounds**, not the pose. `kit:path` projects its path into the pose frame\n * first, so there the two boxes are the same one; here the path is already\n * absolute and the pose is typically a zero-sized placeholder, which would\n * collapse a box-relative gradient onto a point.\n *\n * Not memoized on {@link PAINT_SLOT} on purpose: that key is `(node, pose,\n * data)` and cannot see `ctx.derivedPath`, so it would serve one caller's\n * commands to a caller that passed a different path.\n *\n * Rotation still comes from the pose — `wrapNodeOutput` turns the output about\n * the pose AABB's center, which for a zero-sized pose is its origin.\n */\nexport const DERIVED_PAINTER: NodeShapeEntry = {\n  id: 'kit:derived',\n  // `dependsOn` alone is not enough: the two fields are independent optionals,\n  // and `kit:add` restores a node with its `dependsOn` intact when its\n  // `derivePath` key is missing from the registry. Claiming that node would paint\n  // nothing where the authored appearance is what the warning promises.\n  matches: derivesPath,\n  paint: (node, _pose, ctx) => {\n    const path = ctx?.derivedPath;\n    if (path == null) return [];\n    const box = boundsOfPath(path);\n    const d = node.data as { fill?: FillStyle | null; stroke?: Stroke | null; vertexColors?: number[] } | null;\n    const strokeSpec = resolveNodeStroke(d?.stroke);\n    const declared = resolveNodeFill(d?.fill, strokeSpec === null ? DEFAULT_SHAPE_FILL : null);\n    const fill = declared && commandFill(declared, box);\n    const stroke = strokeSpec && commandStroke(strokeSpec, box);\n    const cmd: DrawCommand = {\n      kind: 'path',\n      path,\n      ...(fill ? { fill } : {}),\n      ...(fill && d?.vertexColors ? { vertexColors: d.vertexColors } : {}),\n      ...(stroke ? { stroke } : {}),\n    };\n    return withAnimatedVertexColors([cmd], ctx);\n  },\n  // The derived path *is* the silhouette, and it is already absolute — the\n  // pose is a placeholder, so nothing here can be recovered from it. Without\n  // a `ctx` this reports null, which `shapeCoversPoint` reads as \"no\n  // opinion\": picking then falls back to that zero-sized pose.\n  silhouette: (_node, _pose, ctx) => ctx?.derivedPath ?? null,\n  ink: (node, _pose, ctx) => {\n    const d = node.data as { fill?: FillStyle | null; stroke?: Stroke | null } | null;\n    const stroke = resolveNodeStroke(d?.stroke);\n    return {\n      filled: resolveNodeFill(d?.fill, stroke === null ? DEFAULT_SHAPE_FILL : null) !== null,\n      ...inkReach(stroke, ctx?.scale),\n    };\n  },\n};\n"],"mappings":";;;;;;AA8BA,IAAaA,IAAkC;CAC7C,IAAI;CAKJ,SAASC;CACT,QAAQ,GAAM,GAAO,MAAQ;EAC3B,IAAMC,IAAOC,GAAK;EAClB,IAAID,KAAQ,MAAM,OAAO,CAAC;EAC1B,IAAME,IAAMC,EAAaH,CAAI,GACvBI,IAAIC,EAAK,MACTC,IAAaC,EAAkBH,GAAG,MAAM,GACxCI,IAAWC,EAAgBL,GAAG,MAAME,MAAe,OAAOI,IAAqB,IAAI,GACnFC,IAAOH,KAAYI,EAAYJ,GAAUN,CAAG,GAC5CW,IAASP,KAAcQ,EAAcR,GAAYJ,CAAG,GACpDa,IAAmB;GACvB,MAAM;GACN;GACA,GAAIJ,IAAO,EAAE,QAAK,IAAI,CAAC;GACvB,GAAIA,KAAQP,GAAG,eAAe,EAAE,cAAcA,EAAE,aAAa,IAAI,CAAC;GAClE,GAAIS,IAAS,EAAE,UAAO,IAAI,CAAC;EAC7B;EACA,OAAOG,EAAyB,CAACD,CAAG,GAAGd,CAAG;CAC5C;CAKA,aAAa,GAAO,GAAO,MAAQA,GAAK,eAAe;CACvD,MAAM,GAAM,GAAO,MAAQ;EACzB,IAAMG,IAAIC,EAAK,MACTQ,IAASN,EAAkBH,GAAG,MAAM;EAC1C,OAAO;GACL,QAAQK,EAAgBL,GAAG,MAAMS,MAAW,OAAOH,IAAqB,IAAI,MAAM;GAClF,GAAGO,EAASJ,GAAQZ,GAAK,KAAK;EAChC;CACF;AACF"}
+{"version":3,"file":"derivedPainter.js","names":["DERIVED_PAINTER","derivesPath","path","ctx","box","boundsOfPath","d","node","strokeSpec","resolveNodeStroke","declared","resolveNodeFill","DEFAULT_SHAPE_FILL","fill","commandFill","stroke","commandStroke","cmd","withAnimatedVertexColors","inkReach"],"sources":["../../../src/canvas/nodeShapes/derivedPainter.ts"],"sourcesContent":["import {\n  boundsOfPath\n} from '@weasel-js/geom';\nimport type { Stroke, Fill } from '@weasel-js/paint';\nimport type { NodeShapeEntry } from 'canvas/NodeShape';\nimport { commandFill, commandStroke } from '@weasel-js/renderer';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { DEFAULT_SHAPE_FILL } from '../../util/paint';\nimport { derivesPath } from './memo';\nimport { inkReach, withAnimatedVertexColors, resolveNodeFill, resolveNodeStroke } from './nodePaint';\n\n/**\n * Built-in painter for nodes whose geometry is computed from other nodes'\n * poses. The path itself arrives on the paint context — see\n * {@link NodePaintCtx.derivedPath}.\n *\n * Fill and stroke resolve as `kit:path`'s do, but against the **derived path's\n * own bounds**, not the pose. `kit:path` projects its path into the pose frame\n * first, so there the two boxes are the same one; here the path is already\n * absolute and the pose is typically a zero-sized placeholder, which would\n * collapse a box-relative gradient onto a point.\n *\n * Not memoized on {@link PAINT_SLOT} on purpose: that key is `(node, pose,\n * data)` and cannot see `ctx.derivedPath`, so it would serve one caller's\n * commands to a caller that passed a different path.\n *\n * Rotation still comes from the pose — `wrapNodeOutput` turns the output about\n * the pose AABB's center, which for a zero-sized pose is its origin.\n */\nexport const DERIVED_PAINTER: NodeShapeEntry = {\n  id: 'kit:derived',\n  // `dependsOn` alone is not enough: the two fields are independent optionals,\n  // and `kit:add` restores a node with its `dependsOn` intact when its\n  // `derivePath` key is missing from the registry. Claiming that node would paint\n  // nothing where the authored appearance is what the warning promises.\n  matches: derivesPath,\n  paint: (node, _pose, ctx) => {\n    const path = ctx?.derivedPath;\n    if (path == null) return [];\n    const box = boundsOfPath(path);\n    const d = node.data as { fill?: Fill | null; stroke?: Stroke | null; vertexColors?: number[] } | null;\n    const strokeSpec = resolveNodeStroke(d?.stroke);\n    const declared = resolveNodeFill(d?.fill, strokeSpec === null ? DEFAULT_SHAPE_FILL : null);\n    const fill = declared && commandFill(declared, box);\n    const stroke = strokeSpec && commandStroke(strokeSpec, box);\n    const cmd: DrawCommand = {\n      kind: 'path',\n      path,\n      ...(fill ? { fill } : {}),\n      ...(fill && d?.vertexColors ? { vertexColors: d.vertexColors } : {}),\n      ...(stroke ? { stroke } : {}),\n    };\n    return withAnimatedVertexColors([cmd], ctx);\n  },\n  // The derived path *is* the silhouette, and it is already absolute — the\n  // pose is a placeholder, so nothing here can be recovered from it. Without\n  // a `ctx` this reports null, which `shapeCoversPoint` reads as \"no\n  // opinion\": picking then falls back to that zero-sized pose.\n  silhouette: (_node, _pose, ctx) => ctx?.derivedPath ?? null,\n  ink: (node, _pose, ctx) => {\n    const d = node.data as { fill?: Fill | null; stroke?: Stroke | null } | null;\n    const stroke = resolveNodeStroke(d?.stroke);\n    return {\n      filled: resolveNodeFill(d?.fill, stroke === null ? DEFAULT_SHAPE_FILL : null) !== null,\n      ...inkReach(stroke, ctx?.scale),\n    };\n  },\n};\n"],"mappings":";;;;;;AA6BA,IAAaA,IAAkC;CAC7C,IAAI;CAKJ,SAASC;CACT,QAAQ,GAAM,GAAO,MAAQ;EAC3B,IAAMC,IAAOC,GAAK;EAClB,IAAID,KAAQ,MAAM,OAAO,CAAC;EAC1B,IAAME,IAAMC,EAAaH,CAAI,GACvBI,IAAIC,EAAK,MACTC,IAAaC,EAAkBH,GAAG,MAAM,GACxCI,IAAWC,EAAgBL,GAAG,MAAME,MAAe,OAAOI,IAAqB,IAAI,GACnFC,IAAOH,KAAYI,EAAYJ,GAAUN,CAAG,GAC5CW,IAASP,KAAcQ,EAAcR,GAAYJ,CAAG,GACpDa,IAAmB;GACvB,MAAM;GACN;GACA,GAAIJ,IAAO,EAAE,QAAK,IAAI,CAAC;GACvB,GAAIA,KAAQP,GAAG,eAAe,EAAE,cAAcA,EAAE,aAAa,IAAI,CAAC;GAClE,GAAIS,IAAS,EAAE,UAAO,IAAI,CAAC;EAC7B;EACA,OAAOG,EAAyB,CAACD,CAAG,GAAGd,CAAG;CAC5C;CAKA,aAAa,GAAO,GAAO,MAAQA,GAAK,eAAe;CACvD,MAAM,GAAM,GAAO,MAAQ;EACzB,IAAMG,IAAIC,EAAK,MACTQ,IAASN,EAAkBH,GAAG,MAAM;EAC1C,OAAO;GACL,QAAQK,EAAgBL,GAAG,MAAMS,MAAW,OAAOH,IAAqB,IAAI,MAAM;GAClF,GAAGO,EAASJ,GAAQZ,GAAK,KAAK;EAChC;CACF;AACF"}

package/dist/canvas/nodeShapes/imagePainter.js

@@ -1,5 +1,5 @@
-import { getImageBitmap as e, imageStatus as t } from "../../features/images/imageCache.js";
-import { paintsPose as n, poseBoxBounds as r } from "./poseBox.js";
+import { paintsPose as e, poseBoxBounds as t } from "./poseBox.js";
+import { getImageBitmap as n, imageStatus as r } from "@weasel-js/renderer";
 import { linePath as i } from "@weasel-js/geom";
 //#region src/canvas/nodeShapes/imagePainter.ts
 function a(e, t) {
@@ -18,13 +18,13 @@ function o(e, t, n) {
 }
 var s = {
 	id: "kit:image",
-	matches: (e) => {
-		if (!n(e.pose)) return !1;
-		let t = e.data?.image?.src;
-		return typeof t == "string" && t.length > 0;
+	matches: (t) => {
+		if (!e(t.pose)) return !1;
+		let n = t.data?.image?.src;
+		return typeof n == "string" && n.length > 0;
 	},
-	paint: (n, r, s) => {
-		let c = n.data, l = r, u = s?.resolveImage ? s.resolveImage(n) : e(c.image.src, o(l, c.image.source, s?.pixelScale));
+	paint: (e, t, s) => {
+		let c = e.data, l = t, u = s?.resolveImage ? s.resolveImage(e) : n(c.image.src, o(l, c.image.source, s?.pixelScale));
 		if (u) return [{
 			kind: "image",
 			image: u,
@@ -37,7 +37,7 @@ var s = {
 			...c.image.flipX ? { flipX: !0 } : {},
 			...c.image.flipY ? { flipY: !0 } : {}
 		}];
-		let d = !s?.resolveImage && t(c.image.src) === "error", f = d ? "#d08a8a" : "#bbbbbb", p = [{
+		let d = !s?.resolveImage && r(c.image.src) === "error", f = d ? "#d08a8a" : "#bbbbbb", p = [{
 			kind: "path",
 			path: {
 				kind: "rect",
@@ -76,7 +76,7 @@ var s = {
 			height: n.height
 		};
 	},
-	bounds: (e, t, n) => r(t, c, n)
+	bounds: (e, n, r) => t(n, c, r)
 }, c = {
 	paint: { color: "#000" },
 	width: 1

package/dist/canvas/nodeShapes/imagePainter.js.map

@@ -1 +1 @@
-{"version":3,"file":"imagePainter.js","names":["sourceInPixels","s","bmp","drawnSize","pixelScale","pose","source","IMAGE_PAINTER","paintsPose","node","src","d","p","ctx","getImageBitmap","error","imageStatus","color","cmds","linePath","poseBoxBounds","IMAGE_PLACEHOLDER_STROKE"],"sources":["../../../src/canvas/nodeShapes/imagePainter.ts"],"sourcesContent":["import {\n  linePath\n} from '@weasel-js/geom';\nimport type { Stroke } from '@weasel-js/paint';\nimport type { NodeShapeEntry } from 'canvas/NodeShape';\nimport type { Node, RectPose } from 'core/scene/types';\nimport {\n  getImageBitmap, imageStatus, type ImageNodeData, type ImageRasterSize,\n} from 'features/images/imageCache';\nimport type { DrawCommand } from '../../renderer';\nimport { paintsPose, poseBoxBounds } from './poseBox';\n\n// ─── Built-in painters ─────────────────────────────────────────────────\n\nexport function sourceInPixels(\n  s: NonNullable<ImageNodeData['image']['source']>,\n  bmp: ImageBitmap,\n): { x: number; y: number; w: number; h: number } {\n  return {\n    x: s.x * bmp.width, y: s.y * bmp.height, w: s.width * bmp.width, h: s.height * bmp.height,\n  };\n}\n\n/** The whole bitmap's size in device pixels when `source` of it fills `pose`. */\nexport function drawnSize(\n  pose: RectPose,\n  source: ImageNodeData['image']['source'],\n  pixelScale: number | undefined,\n): ImageRasterSize | undefined {\n  if (!(pixelScale && pixelScale > 0)) return undefined;\n  return {\n    width: Math.abs(pose.width) * pixelScale / (source?.width || 1),\n    height: Math.abs(pose.height) * pixelScale / (source?.height || 1),\n  };\n}\n\n/** Raster-image painter. Renders `data.image.src` (URL / blob: / data-URI)\n *  via an `ImageDrawCommand` once the bitmap has decoded; until then it paints\n *  a faint placeholder outline so the node stays visible + selectable (a\n *  reddish outline + slash marks a failed load). The decoded bitmap is owned\n *  by `imageCache`, keyed on `src`; the node holds only the serializable `src`.\n *  Registered before `kit:rect-fallback` so image nodes don't fall through. */\nexport const IMAGE_PAINTER: NodeShapeEntry<unknown, RectPose> = {\n  id: 'kit:image',\n  matches: (node) => {\n    if (!paintsPose(node.pose)) return false;\n    const src = (node.data as { image?: { src?: unknown } } | null)?.image?.src;\n    return typeof src === 'string' && src.length > 0;\n  },\n  paint: (node, pose, ctx) => {\n    const d = node.data as ImageNodeData;\n    const p = pose;\n    const bmp = ctx?.resolveImage\n      ? ctx.resolveImage(node as unknown as Node<unknown, string, unknown>)\n      : getImageBitmap(d.image.src, drawnSize(p, d.image.source, ctx?.pixelScale));\n    if (bmp) {\n      return [{\n        kind: 'image',\n        image: bmp,\n        x: p.x, y: p.y, w: p.width, h: p.height,\n        ...(d.image.opacity !== undefined ? { opacity: d.image.opacity } : {}),\n        ...(d.image.source ? { source: sourceInPixels(d.image.source, bmp) } : {}),\n        ...(d.image.flipX ? { flipX: true } : {}),\n        ...(d.image.flipY ? { flipY: true } : {}),\n      }];\n    }\n    // Not ready — faint placeholder (grey while loading, reddish + slash on\n    // error). With a caller-supplied resolver the fallback is deterministic:\n    // always the plain grey outline, no ambient load-status read.\n    const error = ctx?.resolveImage ? false : imageStatus(d.image.src) === 'error';\n    const color = error ? '#d08a8a' : '#bbbbbb';\n    const cmds: DrawCommand[] = [{\n      kind: 'path',\n      path: { kind: 'rect', x: p.x, y: p.y, width: p.width, height: p.height },\n      stroke: { paint: { color }, width: 1 },\n    }];\n    if (error) {\n      cmds.push({\n        kind: 'path',\n        path: linePath({ x: p.x, y: p.y }, { x: p.x + p.width, y: p.y + p.height }),\n        stroke: { paint: { color }, width: 1 },\n      });\n    }\n    return cmds;\n  },\n  silhouette: (_node, pose) => {\n    const p = pose;\n    return { kind: 'rect', x: p.x, y: p.y, width: p.width, height: p.height };\n  },\n  // The placeholder's 1-unit outline is the only thing that leaves the box.\n  bounds: (_node, pose, ctx) => poseBoxBounds(pose, IMAGE_PLACEHOLDER_STROKE, ctx),\n};\n\nexport const IMAGE_PLACEHOLDER_STROKE: Stroke = { paint: { color: '#000' }, width: 1 };\n"],"mappings":";;;;AAcA,SAAgBA,EACd,GACA,GACgD;CAChD,OAAO;EACL,GAAGC,EAAE,IAAIC,EAAI;EAAO,GAAGD,EAAE,IAAIC,EAAI;EAAQ,GAAGD,EAAE,QAAQC,EAAI;EAAO,GAAGD,EAAE,SAASC,EAAI;CACrF;AACF;AAGA,SAAgBC,EACd,GACA,GACA,GAC6B;CAC7B,IAAMC,KAAcA,IAAa,GACjC,OAAO;EACL,OAAO,KAAK,IAAIC,EAAK,KAAK,IAAID,KAAcE,GAAQ,SAAS;EAC7D,QAAQ,KAAK,IAAID,EAAK,MAAM,IAAID,KAAcE,GAAQ,UAAU;CAClE;AACF;AAQA,IAAaC,IAAmD;CAC9D,IAAI;CACJ,UAAU,MAAS;EACjB,IAAI,CAACC,EAAWC,EAAK,IAAI,GAAG,OAAO;EACnC,IAAMC,IAAOD,EAAK,MAA+C,OAAO;EACxE,OAAO,OAAOC,KAAQ,YAAYA,EAAI,SAAS;CACjD;CACA,QAAQ,GAAM,GAAM,MAAQ;EAC1B,IAAMC,IAAIF,EAAK,MACTG,IAAIP,GACJH,IAAMW,GAAK,eACbA,EAAI,aAAaJ,CAAiD,IAClEK,EAAeH,EAAE,MAAM,KAAKR,EAAUS,GAAGD,EAAE,MAAM,QAAQE,GAAK,UAAU,CAAC;EAC7E,IAAIX,GACF,OAAO,CAAC;GACN,MAAM;GACN,OAAOA;GACP,GAAGU,EAAE;GAAG,GAAGA,EAAE;GAAG,GAAGA,EAAE;GAAO,GAAGA,EAAE;GACjC,GAAID,EAAE,MAAM,YAAY,KAAA,IAA2C,CAAC,IAAhC,EAAE,SAASA,EAAE,MAAM,QAAQ;GAC/D,GAAIA,EAAE,MAAM,SAAS,EAAE,QAAQX,EAAeW,EAAE,MAAM,QAAQT,CAAG,EAAE,IAAI,CAAC;GACxE,GAAIS,EAAE,MAAM,QAAQ,EAAE,OAAO,GAAK,IAAI,CAAC;GACvC,GAAIA,EAAE,MAAM,QAAQ,EAAE,OAAO,GAAK,IAAI,CAAC;EACzC,CAAC;EAKH,IAAMI,IAAQ,IAAK,gBAAuBC,EAAYL,EAAE,MAAM,GAAG,MAAM,SACjEM,IAAQF,IAAQ,YAAY,WAC5BG,IAAsB,CAAC;GAC3B,MAAM;GACN,MAAM;IAAE,MAAM;IAAQ,GAAGN,EAAE;IAAG,GAAGA,EAAE;IAAG,OAAOA,EAAE;IAAO,QAAQA,EAAE;GAAO;GACvE,QAAQ;IAAE,OAAO,EAAE,SAAM;IAAG,OAAO;GAAE;EACvC,CAAC;EAQD,OAPIG,KACFG,EAAK,KAAK;GACR,MAAM;GACN,MAAMC,EAAS;IAAE,GAAGP,EAAE;IAAG,GAAGA,EAAE;GAAE,GAAG;IAAE,GAAGA,EAAE,IAAIA,EAAE;IAAO,GAAGA,EAAE,IAAIA,EAAE;GAAO,CAAC;GAC1E,QAAQ;IAAE,OAAO,EAAE,SAAM;IAAG,OAAO;GAAE;EACvC,CAAC,GAEIM;CACT;CACA,aAAa,GAAO,MAAS;EAC3B,IAAMN,IAAIP;EACV,OAAO;GAAE,MAAM;GAAQ,GAAGO,EAAE;GAAG,GAAGA,EAAE;GAAG,OAAOA,EAAE;GAAO,QAAQA,EAAE;EAAO;CAC1E;CAEA,SAAS,GAAO,GAAM,MAAQQ,EAAcf,GAAMgB,GAA0BR,CAAG;AACjF,GAEaQ,IAAmC;CAAE,OAAO,EAAE,OAAO,OAAO;CAAG,OAAO;AAAE"}
+{"version":3,"file":"imagePainter.js","names":["sourceInPixels","s","bmp","drawnSize","pixelScale","pose","source","IMAGE_PAINTER","paintsPose","node","src","d","p","ctx","getImageBitmap","error","imageStatus","color","cmds","linePath","poseBoxBounds","IMAGE_PLACEHOLDER_STROKE"],"sources":["../../../src/canvas/nodeShapes/imagePainter.ts"],"sourcesContent":["import {\n  linePath\n} from '@weasel-js/geom';\nimport type { Stroke } from '@weasel-js/paint';\nimport type { NodeShapeEntry } from 'canvas/NodeShape';\nimport type { Node, RectPose } from 'core/scene/types';\nimport {\n  getImageBitmap, imageStatus, type ImageNodeData, type ImageRasterSize,\n} from '@weasel-js/renderer';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { paintsPose, poseBoxBounds } from './poseBox';\n\n// ─── Built-in painters ─────────────────────────────────────────────────\n\nexport function sourceInPixels(\n  s: NonNullable<ImageNodeData['image']['source']>,\n  bmp: ImageBitmap,\n): { x: number; y: number; w: number; h: number } {\n  return {\n    x: s.x * bmp.width, y: s.y * bmp.height, w: s.width * bmp.width, h: s.height * bmp.height,\n  };\n}\n\n/** The whole bitmap's size in device pixels when `source` of it fills `pose`. */\nexport function drawnSize(\n  pose: RectPose,\n  source: ImageNodeData['image']['source'],\n  pixelScale: number | undefined,\n): ImageRasterSize | undefined {\n  if (!(pixelScale && pixelScale > 0)) return undefined;\n  return {\n    width: Math.abs(pose.width) * pixelScale / (source?.width || 1),\n    height: Math.abs(pose.height) * pixelScale / (source?.height || 1),\n  };\n}\n\n/** Raster-image painter. Renders `data.image.src` (URL / blob: / data-URI)\n *  via an `ImageDrawCommand` once the bitmap has decoded; until then it paints\n *  a faint placeholder outline so the node stays visible + selectable (a\n *  reddish outline + slash marks a failed load). The decoded bitmap is owned\n *  by `imageCache`, keyed on `src`; the node holds only the serializable `src`.\n *  Registered before `kit:rect-fallback` so image nodes don't fall through. */\nexport const IMAGE_PAINTER: NodeShapeEntry<unknown, RectPose> = {\n  id: 'kit:image',\n  matches: (node) => {\n    if (!paintsPose(node.pose)) return false;\n    const src = (node.data as { image?: { src?: unknown } } | null)?.image?.src;\n    return typeof src === 'string' && src.length > 0;\n  },\n  paint: (node, pose, ctx) => {\n    const d = node.data as ImageNodeData;\n    const p = pose;\n    const bmp = ctx?.resolveImage\n      ? ctx.resolveImage(node as unknown as Node<unknown, string, unknown>)\n      : getImageBitmap(d.image.src, drawnSize(p, d.image.source, ctx?.pixelScale));\n    if (bmp) {\n      return [{\n        kind: 'image',\n        image: bmp,\n        x: p.x, y: p.y, w: p.width, h: p.height,\n        ...(d.image.opacity !== undefined ? { opacity: d.image.opacity } : {}),\n        ...(d.image.source ? { source: sourceInPixels(d.image.source, bmp) } : {}),\n        ...(d.image.flipX ? { flipX: true } : {}),\n        ...(d.image.flipY ? { flipY: true } : {}),\n      }];\n    }\n    // Not ready — faint placeholder (grey while loading, reddish + slash on\n    // error). With a caller-supplied resolver the fallback is deterministic:\n    // always the plain grey outline, no ambient load-status read.\n    const error = ctx?.resolveImage ? false : imageStatus(d.image.src) === 'error';\n    const color = error ? '#d08a8a' : '#bbbbbb';\n    const cmds: DrawCommand[] = [{\n      kind: 'path',\n      path: { kind: 'rect', x: p.x, y: p.y, width: p.width, height: p.height },\n      stroke: { paint: { color }, width: 1 },\n    }];\n    if (error) {\n      cmds.push({\n        kind: 'path',\n        path: linePath({ x: p.x, y: p.y }, { x: p.x + p.width, y: p.y + p.height }),\n        stroke: { paint: { color }, width: 1 },\n      });\n    }\n    return cmds;\n  },\n  silhouette: (_node, pose) => {\n    const p = pose;\n    return { kind: 'rect', x: p.x, y: p.y, width: p.width, height: p.height };\n  },\n  // The placeholder's 1-unit outline is the only thing that leaves the box.\n  bounds: (_node, pose, ctx) => poseBoxBounds(pose, IMAGE_PLACEHOLDER_STROKE, ctx),\n};\n\nexport const IMAGE_PLACEHOLDER_STROKE: Stroke = { paint: { color: '#000' }, width: 1 };\n"],"mappings":";;;;AAcA,SAAgBA,EACd,GACA,GACgD;CAChD,OAAO;EACL,GAAGC,EAAE,IAAIC,EAAI;EAAO,GAAGD,EAAE,IAAIC,EAAI;EAAQ,GAAGD,EAAE,QAAQC,EAAI;EAAO,GAAGD,EAAE,SAASC,EAAI;CACrF;AACF;AAGA,SAAgBC,EACd,GACA,GACA,GAC6B;CAC7B,IAAMC,KAAcA,IAAa,GACjC,OAAO;EACL,OAAO,KAAK,IAAIC,EAAK,KAAK,IAAID,KAAcE,GAAQ,SAAS;EAC7D,QAAQ,KAAK,IAAID,EAAK,MAAM,IAAID,KAAcE,GAAQ,UAAU;CAClE;AACF;AAQA,IAAaC,IAAmD;CAC9D,IAAI;CACJ,UAAU,MAAS;EACjB,IAAI,CAACC,EAAWC,EAAK,IAAI,GAAG,OAAO;EACnC,IAAMC,IAAOD,EAAK,MAA+C,OAAO;EACxE,OAAO,OAAOC,KAAQ,YAAYA,EAAI,SAAS;CACjD;CACA,QAAQ,GAAM,GAAM,MAAQ;EAC1B,IAAMC,IAAIF,EAAK,MACTG,IAAIP,GACJH,IAAMW,GAAK,eACbA,EAAI,aAAaJ,CAAiD,IAClEK,EAAeH,EAAE,MAAM,KAAKR,EAAUS,GAAGD,EAAE,MAAM,QAAQE,GAAK,UAAU,CAAC;EAC7E,IAAIX,GACF,OAAO,CAAC;GACN,MAAM;GACN,OAAOA;GACP,GAAGU,EAAE;GAAG,GAAGA,EAAE;GAAG,GAAGA,EAAE;GAAO,GAAGA,EAAE;GACjC,GAAID,EAAE,MAAM,YAAY,KAAA,IAA2C,CAAC,IAAhC,EAAE,SAASA,EAAE,MAAM,QAAQ;GAC/D,GAAIA,EAAE,MAAM,SAAS,EAAE,QAAQX,EAAeW,EAAE,MAAM,QAAQT,CAAG,EAAE,IAAI,CAAC;GACxE,GAAIS,EAAE,MAAM,QAAQ,EAAE,OAAO,GAAK,IAAI,CAAC;GACvC,GAAIA,EAAE,MAAM,QAAQ,EAAE,OAAO,GAAK,IAAI,CAAC;EACzC,CAAC;EAKH,IAAMI,IAAQ,IAAK,gBAAuBC,EAAYL,EAAE,MAAM,GAAG,MAAM,SACjEM,IAAQF,IAAQ,YAAY,WAC5BG,IAAsB,CAAC;GAC3B,MAAM;GACN,MAAM;IAAE,MAAM;IAAQ,GAAGN,EAAE;IAAG,GAAGA,EAAE;IAAG,OAAOA,EAAE;IAAO,QAAQA,EAAE;GAAO;GACvE,QAAQ;IAAE,OAAO,EAAE,SAAM;IAAG,OAAO;GAAE;EACvC,CAAC;EAQD,OAPIG,KACFG,EAAK,KAAK;GACR,MAAM;GACN,MAAMC,EAAS;IAAE,GAAGP,EAAE;IAAG,GAAGA,EAAE;GAAE,GAAG;IAAE,GAAGA,EAAE,IAAIA,EAAE;IAAO,GAAGA,EAAE,IAAIA,EAAE;GAAO,CAAC;GAC1E,QAAQ;IAAE,OAAO,EAAE,SAAM;IAAG,OAAO;GAAE;EACvC,CAAC,GAEIM;CACT;CACA,aAAa,GAAO,MAAS;EAC3B,IAAMN,IAAIP;EACV,OAAO;GAAE,MAAM;GAAQ,GAAGO,EAAE;GAAG,GAAGA,EAAE;GAAG,OAAOA,EAAE;GAAO,QAAQA,EAAE;EAAO;CAC1E;CAEA,SAAS,GAAO,GAAM,MAAQQ,EAAcf,GAAMgB,GAA0BR,CAAG;AACjF,GAEaQ,IAAmC;CAAE,OAAO,EAAE,OAAO,OAAO;CAAG,OAAO;AAAE"}

package/dist/canvas/nodeShapes/memo.js.map

@@ -1 +1 @@
-{"version":3,"file":"memo.js","names":["PAINT_SLOT","derivesPath","node"],"sources":["../../../src/canvas/nodeShapes/memo.ts"],"sourcesContent":["\n/**\n * Slot for a painter's memoized `paint` output.\n *\n * Distinct from {@link SILHOUETTE_SLOT} even though the two mostly invalidate\n * together: the silhouette bakes `pose.rotation` in (paint does not — the\n * render wrap applies it), and paint alone can depend on `NodePaintCtx` and on\n * ambient readiness. One entry keyed the same way for both would be wrong in\n * both directions.\n *\n * **Only for painters that are a pure function of `(node, pose, data)`.**\n * `kit:shape` and `kit:path` qualify and are also precisely the painters that\n * allocated a fresh `Path` per frame, defeating the tessellation cache in\n * `renderer/cache/cache.ts` (`WeakMap<Path, Mesh>`, keyed on Path identity).\n * `kit:text` and `kit:image` do not qualify — see the tests in\n * `NodeShape.cache.test.ts` that pin their opt-out.\n */\nexport const PAINT_SLOT = 'shape:paint';\n\nexport function derivesPath(node: { dependsOn?: readonly unknown[] | 'children'; derivePath?: unknown }): boolean {\n  return (node.dependsOn?.length ?? 0) > 0 && node.derivePath !== undefined;\n}\n"],"mappings":";AAiBA,IAAaA,IAAa;AAE1B,SAAgBC,EAAY,GAAsF;CAChH,QAAQC,EAAK,WAAW,UAAU,KAAK,KAAKA,EAAK,eAAe,KAAA;AAClE"}
+{"version":3,"file":"memo.js","names":["PAINT_SLOT","derivesPath","node"],"sources":["../../../src/canvas/nodeShapes/memo.ts"],"sourcesContent":["\n/**\n * Slot for a painter's memoized `paint` output.\n *\n * Distinct from the silhouette slot even though the two mostly invalidate\n * together: the silhouette bakes `pose.rotation` in (paint does not — the\n * render wrap applies it), and paint alone can depend on `NodePaintCtx` and on\n * ambient readiness.\n *\n * **Only for painters that are a pure function of `(node, pose, data)`.**\n * `kit:text` and `kit:image` do not qualify.\n */\nexport const PAINT_SLOT = 'shape:paint';\n\nexport function derivesPath(node: { dependsOn?: readonly unknown[] | 'children'; derivePath?: unknown }): boolean {\n  return (node.dependsOn?.length ?? 0) > 0 && node.derivePath !== undefined;\n}\n"],"mappings":";AAYA,IAAaA,IAAa;AAE1B,SAAgBC,EAAY,GAAsF;CAChH,QAAQC,EAAK,WAAW,UAAU,KAAK,KAAKA,EAAK,eAAe,KAAA;AAClE"}