@weasel-js/core 1.10.1 → 1.11.1

package/dist/canvas/derivedPath.js

@@ -1,96 +1,199 @@
-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 { isRectPose as s } from "../core/geometry/autoPoseDescriptor.js";
-import { asNodeId as c } from "../core/scene/types.js";
-import { boxToBox as l, transformPath as u } from "@weasel-js/geom";
+import { composeWorldPose, composesFrames } from "../core/scene/composeFrame.js";
+import { carryBoxPath, carryPathBy, pathAsPainted } from "../core/scene/depFrame.js";
+import { createNodeMemoScope } from "../core/scene/nodeMemo.js";
+import { resolveDerivedPath } from "../core/scene/derivedPath.js";
+import { definesFrame, derivedDepOf, effectivePose } from "../core/scene/effectivePose.js";
+import { asNodeId } from "../core/scene/types.js";
+import { multiply, poseFrameInverseOf, poseFrameOf } from "@weasel-js/geom";
+
 //#region src/canvas/derivedPath.ts
-function d(e, t) {
-	let n = o(e, t);
-	return n === t.pose ? t : {
-		...t,
-		pose: n
+/** `node` as the scene shows it, its `pose` an override's or a derived one: the stored node
+*  itself where the two agree. */
+function shownNode(scene, node) {
+	const pose = effectivePose(scene, node);
+	return pose === node.pose ? node : {
+		...node,
+		pose
 	};
 }
-function f(e, t) {
-	return (n) => t(d(e, n));
-}
-function p(e, t, n) {
-	return !s(t) || !s(n) || t.x === n.x && t.y === n.y && t.width === n.width && t.height === n.height ? e : u(e, l(t.x, t.y, t.width, t.height, n.x, n.y, n.width, n.height));
+/** A slot's `toPose`, handed each node as the scene shows it, so a view drawn through one
+*  shows a drag in flight and a rig's motion as every other view does. */
+function sceneShownToPose(scene, toPose) {
+	return (node) => toPose(shownNode(scene, node));
 }
-function m(e, t) {
-	return t === void 0 ? (t) => e.overrides.read(t.id)?.path : (n) => {
-		let r = e.overrides.read(n.id)?.path;
-		if (r === void 0) return;
-		let i = d(e, n);
-		return p(r, i.pose, t(i));
+/**
+* `(node) => the path its pose override shows it by`, in the frame the reader paints in: as
+* the override has it, or under a `toPose` carried from the box the scene shows the node at
+* to the box `toPose` answers.
+*/
+function sceneOverridePathOf(scene, toPose) {
+	if (toPose === void 0) return (node) => scene.overrides.read(node.id)?.path;
+	return (node) => {
+		const path = scene.overrides.read(node.id)?.path;
+		if (path === void 0) return void 0;
+		const shown = shownNode(scene, node);
+		return carryBoxPath(path, shown.pose, toPose(shown));
 	};
 }
-function h(n, r) {
-	let a = r ? f(n, r) : (e) => o(n, e);
-	if (!t(n.composition)) return a;
-	let s = {
-		getPose: (e) => {
-			let t = n.get(c(e));
-			return t ? a(t) : void 0;
+/**
+* `(node) => the pose it is painted at`: the slot's `toPose` of the node as the scene shows
+* it if it has one, else the scene's effective pose, folded through the parent chain when
+* the scene's composition makes a stored pose local to its container.
+*/
+function scenePaintedPoseOf(scene, toPose) {
+	const local = toPose ? sceneShownToPose(scene, toPose) : (node) => effectivePose(scene, node);
+	if (!composesFrames(scene.composition)) return local;
+	const chain = {
+		getPose: (id) => {
+			const n = scene.get(asNodeId(id));
+			return n ? local(n) : void 0;
 		},
-		getParent: (e) => n.get(c(e))?.parent ?? null,
-		definesFrame: (e) => {
-			let t = n.get(c(e));
-			return t === void 0 || i(t);
+		getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,
+		definesFrame: (id) => {
+			const n = scene.get(asNodeId(id));
+			return n === void 0 || definesFrame(n);
 		}
 	};
-	return (t) => e(s, t.id, n.composition.compose);
+	return (node) => composeWorldPose(chain, node.id, scene.composition.compose);
 }
-function g(e, n) {
-	let r = x(n, t(e.composition));
-	if (r === void 0) return (t) => a(e, t);
-	let i = {
-		at: h(e, n),
-		slot: r,
-		shown: m(e, n),
-		childrenOf: (t) => e.childrenOf(t),
-		lookup: (t) => {
-			let n = e.get(t);
-			return n === void 0 ? void 0 : new _(n, i);
+/**
+* `(id) => that node, the pose it is painted at, and the path it derives` —
+* resolved against the scene, so a dependency that is itself derived resolves
+* before it is read.
+*
+* A derived edge is drawn from these coordinates and must meet the nodes it
+* connects, so this reads the pose each one is painted at: see
+* {@link scenePaintedPoseOf}.
+*/
+function sceneDepLookup(scene, toPose) {
+	const slot = memoSlotFor(toPose, composesFrames(scene.composition));
+	if (slot === void 0) return (id) => derivedDepOf(scene, id);
+	const ctx = {
+		at: scenePaintedPoseOf(scene, toPose),
+		local: toPose ? sceneShownToPose(scene, toPose) : (node) => effectivePose(scene, node),
+		slot,
+		shown: sceneOverridePathOf(scene, toPose),
+		childrenOf: (id) => scene.childrenOf(id),
+		lookup: (id) => {
+			const node = scene.get(id);
+			return node === void 0 ? void 0 : new SlotDep(node, ctx);
 		}
 	};
-	return i.lookup;
+	return ctx.lookup;
 }
-var _ = class {
+/** A class, not an object literal with a `get path()` — see `SceneDep` in
+*  `core/scene/effectivePose.ts` for why. */
+var SlotDep = class {
 	ctx;
 	node;
 	pose;
-	constructor(e, t) {
-		this.ctx = t, this.node = e, this.pose = t.at(e);
+	constructor(posed, ctx) {
+		this.ctx = ctx;
+		this.node = posed;
+		this.pose = ctx.at(posed);
 	}
 	get path() {
-		return this.ctx.shown(this.node) ?? r(this.node, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot);
+		const shown = this.ctx.shown(this.node);
+		if (shown !== void 0) return pathAsPainted(shown, this.ctx.local(this.node), this.pose);
+		return resolveDerivedPath(this.node, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot);
 	}
 };
-function v(e, t) {
-	return t.dependsOn !== void 0 || e.overrides.read(t.id)?.path !== void 0;
+/** Whether something outside `node`'s data says what path it shows: it derives one, or a
+*  pose override carries one. The gate both scene walks check before resolving a path. */
+function showsComputedPath(scene, node) {
+	return node.dependsOn !== void 0 || scene.overrides.read(node.id)?.path !== void 0;
 }
-function y(e, n) {
-	let i = g(e, n), a = x(n, t(e.composition)), o = (t) => e.childrenOf(t), s = (e) => r(e, i, o, a), c = m(e, n);
-	return (e) => c(e) ?? s(e);
+/**
+* `(node) => the path it shows in place of its data's`: a pose override's `path`, else the
+* one it derives, read through {@link sceneDepLookup}. A reader painting through a `toPose`
+* is answered the override's path carried into the box its `toPose` answers.
+*/
+function sceneDerivedPathOf(scene, toPose) {
+	const depOf = sceneDepLookup(scene, toPose);
+	const slot = memoSlotFor(toPose, composesFrames(scene.composition));
+	const childrenOf = (id) => scene.childrenOf(id);
+	const derived = (node) => resolveDerivedPath(node, depOf, childrenOf, slot);
+	const overridePathOf = sceneOverridePathOf(scene, toPose);
+	return (node) => overridePathOf(node) ?? derived(node);
 }
-var b = /* @__PURE__ */ new WeakMap();
-function x(e, t) {
-	let r = t ? "world" : "local";
-	if (e === void 0) return r === "world" ? "kit:derivedPath:world" : void 0;
-	let i = b.get(e);
-	return i === void 0 && (i = {}, b.set(e, i)), i[r] ??= n();
+var toPoseScopes = /* @__PURE__ */ new WeakMap();
+/** Where one way of reading poses memoizes its paths, or `undefined` for the
+*  scene's own slot: two readers painting one scene at different poses must
+*  not serve each other's paths. Every reader composing stored poses shares a
+*  slot; a `toPose` gets a scope that is collected with the function. */
+function memoSlotFor(toPose, composes) {
+	const frame = composes ? "world" : "local";
+	if (toPose === void 0) return frame === "world" ? "kit:derivedPath:world" : void 0;
+	let scopes = toPoseScopes.get(toPose);
+	if (scopes === void 0) {
+		scopes = {};
+		toPoseScopes.set(toPose, scopes);
+	}
+	return scopes[frame] ??= createNodeMemoScope();
 }
-function S(e, t, n) {
-	let r = y(e, n);
-	return (n, i, a, o) => v(e, n) ? t(n, i, a, {
-		...o,
-		derivedPath: r(n)
-	}) : t(n, i, a, o);
+/**
+* Wrap a `drawOne` so a node that derives its geometry, or whose pose override
+* carries a path, arrives at the painter with the resolved path. The painter has no scene handle and so cannot read
+* the dependencies' poses itself; both scene walks wrap here instead.
+*
+* A node that derives nothing passes the caller's `ctx` through untouched —
+* this runs per node per frame, and an added `{ derivedPath: null }` would be
+* an allocation per node for a field no painter reads.
+*/
+function withDerivedPaths(scene, drawOne, toPose) {
+	const derivedPathOf = sceneDerivedPathOf(scene, toPose);
+	const ownPoseOf = composesFrames(scene.composition) ? toPose ? sceneShownToPose(scene, toPose) : (node) => effectivePose(scene, node) : null;
+	return (node, pose, view, ctx) => {
+		if (!showsComputedPath(scene, node)) return drawOne(node, pose, view, ctx);
+		let path = derivedPathOf(node);
+		if (path !== null && ownPoseOf !== null && scene.overrides.read(node.id)?.path === void 0) path = withoutInheritedFrame(path, pose, ownPoseOf(node));
+		return drawOne(node, pose, view, {
+			...ctx,
+			derivedPath: path
+		});
+	};
+}
+/**
+* A derived path is drawn from its dependencies' painted poses, so it is already where it
+* shows; but the pose rotation the walk wraps every node in is `painted`'s, which carries its
+* containers' turns as well as its own. Carried back through what the containers add, the
+* wrap turns it by its own frame alone, as it does a root's.
+*/
+function withoutInheritedFrame(path, painted, own) {
+	const undo = poseFrameInverseOf(painted);
+	if (undo === null) return path;
+	const box = painted;
+	const o = own;
+	const redo = poseFrameOf({
+		x: box.x,
+		y: box.y,
+		width: box.width,
+		height: box.height,
+		rotation: o?.rotation,
+		transform: o?.transform
+	});
+	return carryPathBy(path, redo === null ? undo : multiply(undo, redo));
+}
+var drawnScenes = /* @__PURE__ */ new WeakMap();
+/** `scene` read as `drawnBoundsOf` reads one, each node that shows a computed
+*  path answering it. One object per scene, so it can key a memo. */
+function drawnBoundsScene(scene) {
+	let held = drawnScenes.get(scene);
+	if (held === void 0) {
+		const pathOf = sceneDerivedPathOf(scene);
+		held = {
+			get: (id) => scene.get(id),
+			childrenOf: (id) => scene.childrenOf(id),
+			derivedPathOf: (id) => {
+				const node = scene.get(id);
+				return node !== void 0 && showsComputedPath(scene, node) ? pathOf(node) : null;
+			}
+		};
+		drawnScenes.set(scene, held);
+	}
+	return held;
 }
-//#endregion
-export { r as resolveDerivedPath, g as sceneDepLookup, y as sceneDerivedPathOf, h as scenePaintedPoseOf, f as sceneShownToPose, v as showsComputedPath, S as withDerivedPaths };
 
+//#endregion
+export { drawnBoundsScene, resolveDerivedPath, sceneDepLookup, sceneDerivedPathOf, scenePaintedPoseOf, sceneShownToPose, showsComputedPath, withDerivedPaths };
 //# sourceMappingURL=derivedPath.js.map

package/dist/canvas/derivedPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"derivedPath.js","names":["shownNode","pose","effectivePose","scene","node","sceneShownToPose","toPose","carryPath","isRectPose","from","to","path","transformPath","boxToBox","sceneOverridePathOf","shown","scenePaintedPoseOf","local","composesFrames","chain","n","asNodeId","id","definesFrame","composeWorldPose","sceneDepLookup","slot","memoSlotFor","derivedDepOf","ctx","SlotDep","posed","resolveDerivedPath","showsComputedPath","sceneDerivedPathOf","depOf","childrenOf","derived","overridePathOf","toPoseScopes","frame","composes","scopes","createNodeMemoScope","withDerivedPaths","derivedPathOf","drawOne","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 { boxToBox, transformPath, type Path } from '@weasel-js/geom';\nimport { asNodeId } from 'core/scene/types';\nimport { isRectPose } from 'core/geometry/autoPoseDescriptor';\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\ntype ToPose<TData, TLayer extends string, TPose> = (node: Node<TData, TLayer, TPose>) => TPose;\n\n/** `node` as the scene shows it, its `pose` an override's or a derived one: the stored node\n *  itself where the two agree. */\nfunction shownNode<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: Node<TData, TLayer, TPose>,\n): Node<TData, TLayer, TPose> {\n  const pose = effectivePose(scene, node);\n  return pose === node.pose ? node : { ...node, pose };\n}\n\n/** A slot's `toPose`, handed each node as the scene shows it, so a view drawn through one\n *  shows a drag in flight and a rig's motion as every other view does. */\nexport function sceneShownToPose<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose: ToPose<TData, TLayer, TPose>,\n): ToPose<TData, TLayer, TPose> {\n  return (node) => toPose(shownNode(scene, node));\n}\n\n/** `path`, drawn for a node boxed at `from`, as it is drawn for that node boxed at `to`. A\n *  pose that is not a box leaves the path where it is. */\nfunction carryPath(path: Path, from: unknown, to: unknown): Path {\n  if (!isRectPose(from) || !isRectPose(to)) return path;\n  if (from.x === to.x && from.y === to.y && from.width === to.width && from.height === to.height) return path;\n  return transformPath(path, boxToBox(from.x, from.y, from.width, from.height, to.x, to.y, to.width, to.height));\n}\n\n/**\n * `(node) => the path its pose override shows it by`, in the frame the reader paints in: as\n * the override has it, or under a `toPose` carried from the box the scene shows the node at\n * to the box `toPose` answers.\n */\nfunction sceneOverridePathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: ToPose<TData, TLayer, TPose>,\n): (node: Node<TData, TLayer, TPose>) => Path | undefined {\n  if (toPose === undefined) return (node) => scene.overrides.read(node.id)?.path;\n  return (node) => {\n    const path = scene.overrides.read(node.id)?.path;\n    if (path === undefined) return undefined;\n    const shown = shownNode(scene, node);\n    return carryPath(path, shown.pose, toPose(shown));\n  };\n}\n\n/**\n * `(node) => the pose it is painted at`: the slot's `toPose` of the node as the scene shows\n * it if it has one, 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\n    ? sceneShownToPose(scene, toPose)\n    : (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    shown: sceneOverridePathOf(scene, toPose) as (node: unknown) => Path | undefined,\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  /** The path a pose override shows a node by, where it has one. */\n  shown: (node: unknown) => Path | undefined;\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 this.ctx.shown(this.node) ?? 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}. A reader painting through a `toPose`\n * is answered the override's path carried into the box its `toPose` answers.\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  const overridePathOf = sceneOverridePathOf(scene, toPose);\n  return (node) => overridePathOf(node) ?? 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 (!showsComputedPath(scene, node)) return drawOne(node, pose, view, ctx);\n    return drawOne(node, pose, view, { ...ctx, derivedPath: derivedPathOf(node) });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"derivedPath.js","names":[],"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 { multiply, poseFrameInverseOf, poseFrameOf, 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 { carryBoxPath, carryPathBy, pathAsPainted } from 'core/scene/depFrame';\nimport type { SceneViewDrawOne } from './NodeShape';\nimport type { DrawnBoundsScene } from './drawnBounds';\n\nexport { resolveDerivedPath } from 'core/scene/derivedPath';\n\ntype ToPose<TData, TLayer extends string, TPose> = (node: Node<TData, TLayer, TPose>) => TPose;\n\n/** `node` as the scene shows it, its `pose` an override's or a derived one: the stored node\n *  itself where the two agree. */\nfunction shownNode<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: Node<TData, TLayer, TPose>,\n): Node<TData, TLayer, TPose> {\n  const pose = effectivePose(scene, node);\n  return pose === node.pose ? node : { ...node, pose };\n}\n\n/** A slot's `toPose`, handed each node as the scene shows it, so a view drawn through one\n *  shows a drag in flight and a rig's motion as every other view does. */\nexport function sceneShownToPose<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose: ToPose<TData, TLayer, TPose>,\n): ToPose<TData, TLayer, TPose> {\n  return (node) => toPose(shownNode(scene, node));\n}\n\n/**\n * `(node) => the path its pose override shows it by`, in the frame the reader paints in: as\n * the override has it, or under a `toPose` carried from the box the scene shows the node at\n * to the box `toPose` answers.\n */\nfunction sceneOverridePathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: ToPose<TData, TLayer, TPose>,\n): (node: Node<TData, TLayer, TPose>) => Path | undefined {\n  if (toPose === undefined) return (node) => scene.overrides.read(node.id)?.path;\n  return (node) => {\n    const path = scene.overrides.read(node.id)?.path;\n    if (path === undefined) return undefined;\n    const shown = shownNode(scene, node);\n    return carryBoxPath(path, shown.pose, toPose(shown));\n  };\n}\n\n/**\n * `(node) => the pose it is painted at`: the slot's `toPose` of the node as the scene shows\n * it if it has one, 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\n    ? sceneShownToPose(scene, toPose)\n    : (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    local: (toPose\n      ? sceneShownToPose(scene, toPose)\n      : (node: Node<TData, TLayer, TPose>) => effectivePose(scene, node)) as (node: unknown) => TPose,\n    slot,\n    shown: sceneOverridePathOf(scene, toPose) as (node: unknown) => Path | undefined,\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  /** The pose the node is shown at in its own frame: the box its override path is drawn in. */\n  local: (node: unknown) => TPose;\n  slot: string | NodeMemoScope;\n  /** The path a pose override shows a node by, where it has one. */\n  shown: (node: unknown) => Path | undefined;\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    const shown = this.ctx.shown(this.node);\n    if (shown !== undefined) return pathAsPainted(shown, this.ctx.local(this.node), this.pose);\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}. A reader painting through a `toPose`\n * is answered the override's path carried into the box its `toPose` answers.\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  const overridePathOf = sceneOverridePathOf(scene, toPose);\n  return (node) => overridePathOf(node) ?? 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  const ownPoseOf = composesFrames(scene.composition)\n    ? (toPose ? sceneShownToPose(scene, toPose) : (node: Node<TData, TLayer, TPose>) => effectivePose(scene, node))\n    : null;\n  return (node, pose, view, ctx) => {\n    if (!showsComputedPath(scene, node)) return drawOne(node, pose, view, ctx);\n    let path = derivedPathOf(node);\n    if (path !== null && ownPoseOf !== null && scene.overrides.read(node.id)?.path === undefined) {\n      path = withoutInheritedFrame(path, pose, ownPoseOf(node));\n    }\n    return drawOne(node, pose, view, { ...ctx, derivedPath: path });\n  };\n}\n\n/**\n * A derived path is drawn from its dependencies' painted poses, so it is already where it\n * shows; but the pose rotation the walk wraps every node in is `painted`'s, which carries its\n * containers' turns as well as its own. Carried back through what the containers add, the\n * wrap turns it by its own frame alone, as it does a root's.\n */\nfunction withoutInheritedFrame(path: Path, painted: unknown, own: unknown): Path {\n  const undo = poseFrameInverseOf(painted);\n  if (undo === null) return path;\n  const box = painted as { x: number; y: number; width: number; height: number };\n  const o = own as { rotation?: number; transform?: unknown } | null;\n  const redo = poseFrameOf({ x: box.x, y: box.y, width: box.width, height: box.height, rotation: o?.rotation, transform: o?.transform });\n  return carryPathBy(path, redo === null ? undo : multiply(undo, redo));\n}\n\nconst drawnScenes = new WeakMap<object, DrawnBoundsScene>();\n\n/** `scene` read as `drawnBoundsOf` reads one, each node that shows a computed\n *  path answering it. One object per scene, so it can key a memo. */\nexport function drawnBoundsScene<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>): DrawnBoundsScene {\n  let held = drawnScenes.get(scene);\n  if (held === undefined) {\n    const pathOf = sceneDerivedPathOf(scene);\n    held = {\n      get: (id) => scene.get(id) as never,\n      childrenOf: (id) => scene.childrenOf(id),\n      derivedPathOf: (id) => {\n        const node = scene.get(id);\n        return node !== undefined && showsComputedPath(scene, node) ? pathOf(node) : null;\n      },\n    };\n    drawnScenes.set(scene, held);\n  }\n  return held;\n}\n"],"mappings":"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"}

package/dist/canvas/doubleClickTarget.js

@@ -0,0 +1,20 @@
+//#region src/canvas/doubleClickTarget.ts
+/**
+* The node a double-click on `hitId` names: the outermost group on the way up from it, stopping
+* below `scope`, or `hitId` itself where no group stands between them. So a double-click on a
+* grouped member names the group, and each one inside an isolated group names the next group in.
+*/
+function doubleClickTarget(hitId, tree) {
+	const { parentOf, kindOf, scope } = tree;
+	let named = hitId;
+	let id = hitId;
+	for (let depth = 0; id !== null && id !== scope && depth < 1e4; depth++) {
+		if (kindOf(id) === "group") named = id;
+		id = parentOf(id);
+	}
+	return named;
+}
+
+//#endregion
+export { doubleClickTarget };
+//# sourceMappingURL=doubleClickTarget.js.map

package/dist/canvas/doubleClickTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleClickTarget.js","names":[],"sources":["../../src/canvas/doubleClickTarget.ts"],"sourcesContent":["/** How {@link doubleClickTarget} reads the tree. */\nexport interface DoubleClickTree {\n  parentOf: (id: string) => string | null;\n  /** A node's routing kind; a node routed `'group'` is one a double-click can name. */\n  kindOf: (id: string) => string | undefined;\n  /** The group isolation is working inside, or null at the scene root. */\n  scope: string | null;\n}\n\n/**\n * The node a double-click on `hitId` names: the outermost group on the way up from it, stopping\n * below `scope`, or `hitId` itself where no group stands between them. So a double-click on a\n * grouped member names the group, and each one inside an isolated group names the next group in.\n */\nexport function doubleClickTarget(hitId: string, tree: DoubleClickTree): string {\n  const { parentOf, kindOf, scope } = tree;\n  let named = hitId;\n  let id: string | null = hitId;\n  // Capped so a cyclic parent chain cannot hang the pick.\n  for (let depth = 0; id !== null && id !== scope && depth < 10_000; depth++) {\n    if (kindOf(id) === 'group') named = id;\n    id = parentOf(id);\n  }\n  return named;\n}\n"],"mappings":";;;;;;AAcA,SAAgB,kBAAkB,OAAe,MAA+B;CAC9E,MAAM,EAAE,UAAU,QAAQ,UAAU;CACpC,IAAI,QAAQ;CACZ,IAAI,KAAoB;CAExB,KAAK,IAAI,QAAQ,GAAG,OAAO,QAAQ,OAAO,SAAS,QAAQ,KAAQ,SAAS;EAC1E,IAAI,OAAO,EAAE,MAAM,SAAS,QAAQ;EACpC,KAAK,SAAS,EAAE;CAClB;CACA,OAAO;AACT"}

package/dist/canvas/drawEnvelope.js

@@ -1,26 +1,35 @@
 //#region src/canvas/drawEnvelope.ts
-function e(e, t) {
-	let n = e;
-	return typeof n?.[t] == "function" ? n[t] : void 0;
+function thunk(data, key) {
+	const maybe = data;
+	return typeof maybe?.[key] === "function" ? maybe[key] : void 0;
 }
-function t(t) {
-	return e(t, "getChromeState")?.() ?? null;
+/** This view's chrome state, or `null` when the caller passed plain data. */
+function chromeStateFrom(data) {
+	return thunk(data, "getChromeState")?.() ?? null;
 }
-function n(t) {
-	return e(t, "getIsVisible")?.() ?? null;
+/** This view's chrome-caps predicate, or `null` when the caller passed plain
+*  data — the layer then paints unconditionally. */
+function isVisibleFrom(data) {
+	return thunk(data, "getIsVisible")?.() ?? null;
 }
-function r(t) {
-	return e(t, "getPreviewSources")?.() ?? o;
+/** This view's in-flight preview surfaces, in resolution order. Empty when
+*  nothing is in flight and when the caller passed plain data. */
+function previewSourcesFrom(data) {
+	return thunk(data, "getPreviewSources")?.() ?? EMPTY_SOURCES;
 }
-function i(t) {
-	return e(t, "getGestureOverlays")?.() ?? s;
+/** The overlay shapes this view's in-flight handles publish. */
+function gestureOverlaysFrom(data) {
+	return thunk(data, "getGestureOverlays")?.() ?? EMPTY_OVERLAYS;
 }
-function a(e) {
-	let t = e?.getDebug;
-	return typeof t == "function" ? t() : null;
+/** The surface's debug sink, or `null` when debugging is off and when the
+*  caller passed plain data. */
+function debugSinkFrom(data) {
+	const getDebug = data?.getDebug;
+	return typeof getDebug === "function" ? getDebug() : null;
 }
-var o = [], s = [];
-//#endregion
-export { t as chromeStateFrom, a as debugSinkFrom, i as gestureOverlaysFrom, n as isVisibleFrom, r as previewSourcesFrom };
+var EMPTY_SOURCES = [];
+var EMPTY_OVERLAYS = [];
 
+//#endregion
+export { chromeStateFrom, debugSinkFrom, gestureOverlaysFrom, isVisibleFrom, 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","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"}
+{"version":3,"file":"drawEnvelope.js","names":[],"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,SAAS,MACP,MACA,KAC2C;CAC3C,MAAM,QAAQ;CACd,OAAO,OAAO,QAAQ,SAAS,aAAa,MAAM,OAAO;AAC3D;;AAGA,SAAgB,gBAAgB,MAAmC;CACjE,OAAO,MAAM,MAAM,gBAAgB,CAAC,GAAG,KAAK;AAC9C;;;AAIA,SAAgB,cAAc,MAAiD;CAC7E,OAAO,MAAM,MAAM,cAAc,CAAC,GAAG,KAAK;AAC5C;;;AAIA,SAAgB,mBAAmB,MAAgD;CACjF,OAAO,MAAM,MAAM,mBAAmB,CAAC,GAAG,KAAK;AACjD;;AAGA,SAAgB,oBAAoB,MAA0C;CAC5E,OAAO,MAAM,MAAM,oBAAoB,CAAC,GAAG,KAAK;AAClD;;;AAIA,SAAgB,cAAc,MAAiC;CAC7D,MAAM,WAAY,MAA2D;CAC7E,OAAO,OAAO,aAAa,aAAa,SAAS,IAAI;AACvD;AA0BA,IAAM,gBAAiD,CAAC;AACxD,IAAM,iBAA4C,CAAC"}

package/dist/canvas/drawnBounds.js

@@ -0,0 +1,142 @@
+import { axisAlignedBounds, unionBounds } from "../core/geometry/unionBounds.js";
+import { framedBounds, poseDescriptorForNode } from "../core/geometry/poseDescriptor.js";
+import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
+import { targetCorners, targetTransformOf, worldToLocal } from "../core/geometry/targetFrame.js";
+import { NO_INK_EXTENTS, inkExtentsBetween, outsetBox } from "../core/geometry/inkExtents.js";
+import { findNodeShape } from "./NodeShape.js";
+import { boundsOfPath, meanScale } from "@weasel-js/geom";
+
+//#region src/canvas/drawnBounds.ts
+/**
+* The box of a node as drawn — its pose box with the stroke included — which
+* is what selection chrome, resize, rotate, and alignment sit on. Places that
+* store geometry (a group's derived pose, booleans, export) keep reading the
+* pose box through `framedBounds`.
+*/
+/**
+* The box of `id` drawn at `pose`, stroke included, in the frame the pose is
+* drawn in: a turned node's box comes back turned with it. A node with no
+* stroke, a painter that declares no {@link NodeShapeEntry.drawnBounds}, or
+* `includeStroke: false` answers `framedBounds` unchanged. A container's box
+* reaches as far as its members' boxes do. A node showing a derived path is
+* boxed around that path, and its placeholder pose plays no part.
+*/
+function drawnBoundsOf(scene, id, pose, opts = {}) {
+	const derived = scene.derivedPathOf?.(id) ?? null;
+	if (derived !== null) return derivedBoundsOf(scene, id, pose, derived, opts);
+	return outsetBox(framedBounds(pose, descriptorFor(scene, id, opts)), inkExtentsOf(scene, id, pose, opts));
+}
+/** How far `id`'s ink at `pose` reaches past its pose box on each side, in
+*  the box's own frame: what {@link drawnBoundsOf} grows the pose box by. */
+function inkExtentsOf(scene, id, pose, opts = {}) {
+	if (opts.includeStroke === false) return NO_INK_EXTENTS;
+	const node = scene.get(id);
+	if (!node) return NO_INK_EXTENTS;
+	const own = framedBounds(pose, descriptorFor(scene, id, opts));
+	const unframed = {
+		x: own.x,
+		y: own.y,
+		width: own.width,
+		height: own.height
+	};
+	const members = node.kind === "container" ? scene.childrenOf?.(id) ?? [] : [];
+	if (members.length > 0) return membersExtents(scene, members, own, opts);
+	const drawn = findShapeDrawnBounds(node, pose, inkCtx(opts.scale, own));
+	return drawn === null ? NO_INK_EXTENTS : inkExtentsBetween(normalized(unframed), drawn);
+}
+/** The box of a node drawn along `path`: the path's own, grown by the stroke
+*  its painter reports. */
+function derivedBoundsOf(scene, id, pose, path, opts) {
+	const { x, y, width, height } = boundsOfPath(path);
+	const own = {
+		x,
+		y,
+		width,
+		height
+	};
+	const node = scene.get(id);
+	if (opts.includeStroke === false || !node) return own;
+	const drawn = findShapeDrawnBounds(node, pose, {
+		...inkCtx(opts.scale, {
+			x: 0,
+			y: 0,
+			width: 0,
+			height: 0
+		}),
+		derivedPath: path
+	});
+	return drawn === null ? own : unionBounds([own, drawn]) ?? own;
+}
+/** A container's extents: its members' drawn boxes, taken into its own frame,
+*  past its own box. */
+function membersExtents(scene, members, own, opts) {
+	const xf = targetTransformOf(own);
+	const worldPoseOf = opts.worldPoseOf ?? ((m) => scene.get(m)?.pose);
+	let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
+	for (const m of members) {
+		const box = drawnBoundsOf(scene, m, worldPoseOf(m), opts);
+		for (const c of targetCorners(box, targetTransformOf(box))) {
+			const p = worldToLocal(xf, c.x, c.y);
+			if (!p) continue;
+			x0 = Math.min(x0, p.x);
+			y0 = Math.min(y0, p.y);
+			x1 = Math.max(x1, p.x);
+			y1 = Math.max(y1, p.y);
+		}
+	}
+	if (x0 === Infinity) return NO_INK_EXTENTS;
+	return inkExtentsBetween(normalized(own), {
+		x: x0,
+		y: y0,
+		width: x1 - x0,
+		height: y1 - y0
+	});
+}
+/** {@link drawnBoundsOf} as an axis-aligned box: what a turned node covers. */
+function drawnAABBOf(scene, id, pose, opts = {}) {
+	return axisAlignedBounds(drawnBoundsOf(scene, id, pose, opts));
+}
+/** The painter's {@link NodeShapeEntry.drawnBounds} for `node`, or `null`
+*  when no painter matches or the one that does declares none. */
+function findShapeDrawnBounds(node, pose, ctx) {
+	return findNodeShape(node)?.drawnBounds?.(node, pose, ctx) ?? null;
+}
+function descriptorFor(scene, id, opts) {
+	const d = opts.descriptor ?? AUTO_POSE_DESCRIPTOR;
+	const node = scene.get(id);
+	return node ? poseDescriptorForNode(d, node) : d;
+}
+/** A per-axis view scale also carries the map from `own`'s frame to screen,
+*  so a `{ px }` stroke is measured there rather than at the mean. */
+function inkCtx(scale, own) {
+	if (scale === void 0) return void 0;
+	if (typeof scale === "number") return { scale };
+	const xf = targetTransformOf(own);
+	const [a, b, c, d] = xf.identity ? [
+		1,
+		0,
+		0,
+		1
+	] : xf.toWorld;
+	return {
+		scale: meanScale(scale),
+		screen: [
+			scale.x * a,
+			scale.y * b,
+			scale.x * c,
+			scale.y * d
+		]
+	};
+}
+function normalized(b) {
+	return {
+		x: Math.min(b.x, b.x + b.width),
+		y: Math.min(b.y, b.y + b.height),
+		width: Math.abs(b.width),
+		height: Math.abs(b.height)
+	};
+}
+
+//#endregion
+export { drawnAABBOf, drawnBoundsOf, findShapeDrawnBounds, inkExtentsOf };
+//# sourceMappingURL=drawnBounds.js.map

package/dist/canvas/drawnBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawnBounds.js","names":[],"sources":["../../src/canvas/drawnBounds.ts"],"sourcesContent":["/**\n * The box of a node as drawn — its pose box with the stroke included — which\n * is what selection chrome, resize, rotate, and alignment sit on. Places that\n * store geometry (a group's derived pose, booleans, export) keep reading the\n * pose box through `framedBounds`.\n */\nimport { framedBounds, poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport {\n  inkExtentsBetween,\n  NO_INK_EXTENTS,\n  outsetBox,\n  type InkExtents,\n} from 'core/geometry/inkExtents';\nimport { targetCorners, targetTransformOf, worldToLocal } from 'core/geometry/targetFrame';\nimport { axisAlignedBounds, unionBounds } from 'core/geometry/unionBounds';\nimport type { Node, NodeId } from 'core/scene/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport { boundsOfPath, meanScale, type Path, type Scale2 } from '@weasel-js/geom';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { findNodeShape, type NodeInkCtx } from './NodeShape';\n\n/** The scene reads {@link drawnBoundsOf} makes. `childrenOf` absent: every\n *  node is a leaf. `derivedPathOf` absent: every node is measured by its pose,\n *  a path-derived one included — `drawnBoundsScene` supplies it for a `Scene`. */\nexport interface DrawnBoundsScene {\n  get(id: NodeId): Node<unknown, string, unknown> | undefined;\n  childrenOf?(id: NodeId): readonly NodeId[];\n  /** The path a node shows in place of its pose's, or `null` for one that shows its own. */\n  derivedPathOf?(id: NodeId): Path | null;\n}\n\n/** How {@link drawnBoundsOf} reads a node. */\nexport interface DrawnBoundsOptions {\n  /** How poses are read. Default `AUTO_POSE_DESCRIPTOR`. */\n  descriptor?: PoseDescriptor<unknown>;\n  /** A member's world pose, for boxing a container around its members.\n   *  Default: its pose as stored, which is world unless containers compose. */\n  worldPoseOf?: (id: NodeId) => unknown;\n  /** `false` answers the pose box alone. Default `true`. */\n  includeStroke?: boolean;\n  /** View scale, which a screen-pixel stroke width is resolved at. Default 1. */\n  scale?: number | Scale2;\n}\n\n/**\n * The box of `id` drawn at `pose`, stroke included, in the frame the pose is\n * drawn in: a turned node's box comes back turned with it. A node with no\n * stroke, a painter that declares no {@link NodeShapeEntry.drawnBounds}, or\n * `includeStroke: false` answers `framedBounds` unchanged. A container's box\n * reaches as far as its members' boxes do. A node showing a derived path is\n * boxed around that path, and its placeholder pose plays no part.\n */\nexport function drawnBoundsOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): Bounds {\n  const derived = scene.derivedPathOf?.(id) ?? null;\n  if (derived !== null) return derivedBoundsOf(scene, id, pose, derived, opts);\n  return outsetBox(framedBounds(pose, descriptorFor(scene, id, opts)), inkExtentsOf(scene, id, pose, opts));\n}\n\n/** How far `id`'s ink at `pose` reaches past its pose box on each side, in\n *  the box's own frame: what {@link drawnBoundsOf} grows the pose box by. */\nexport function inkExtentsOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): InkExtents {\n  if (opts.includeStroke === false) return NO_INK_EXTENTS;\n  const node = scene.get(id);\n  if (!node) return NO_INK_EXTENTS;\n  const own = framedBounds(pose, descriptorFor(scene, id, opts));\n  const unframed = { x: own.x, y: own.y, width: own.width, height: own.height };\n  const members = node.kind === 'container' ? scene.childrenOf?.(id) ?? [] : [];\n  if (members.length > 0) return membersExtents(scene, members, own, opts);\n  const drawn = findShapeDrawnBounds(node, pose, inkCtx(opts.scale, own));\n  return drawn === null ? NO_INK_EXTENTS : inkExtentsBetween(normalized(unframed), drawn);\n}\n\n/** The box of a node drawn along `path`: the path's own, grown by the stroke\n *  its painter reports. */\nfunction derivedBoundsOf(scene: DrawnBoundsScene, id: NodeId, pose: unknown, path: Path, opts: DrawnBoundsOptions): Bounds {\n  const { x, y, width, height } = boundsOfPath(path);\n  const own = { x, y, width, height };\n  const node = scene.get(id);\n  if (opts.includeStroke === false || !node) return own;\n  const ctx = { ...inkCtx(opts.scale, { x: 0, y: 0, width: 0, height: 0 }), derivedPath: path };\n  const drawn = findShapeDrawnBounds(node, pose, ctx);\n  return drawn === null ? own : unionBounds([own, drawn]) ?? own;\n}\n\n/** A container's extents: its members' drawn boxes, taken into its own frame,\n *  past its own box. */\nfunction membersExtents(\n  scene: DrawnBoundsScene,\n  members: readonly NodeId[],\n  own: Bounds,\n  opts: DrawnBoundsOptions,\n): InkExtents {\n  const xf = targetTransformOf(own);\n  const worldPoseOf = opts.worldPoseOf ?? ((m: NodeId) => scene.get(m)?.pose);\n  let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;\n  for (const m of members) {\n    const box = drawnBoundsOf(scene, m, worldPoseOf(m), opts);\n    for (const c of targetCorners(box, targetTransformOf(box))) {\n      const p = worldToLocal(xf, c.x, c.y);\n      if (!p) continue;\n      x0 = Math.min(x0, p.x); y0 = Math.min(y0, p.y);\n      x1 = Math.max(x1, p.x); y1 = Math.max(y1, p.y);\n    }\n  }\n  if (x0 === Infinity) return NO_INK_EXTENTS;\n  return inkExtentsBetween(normalized(own), { x: x0, y: y0, width: x1 - x0, height: y1 - y0 });\n}\n\n/** {@link drawnBoundsOf} as an axis-aligned box: what a turned node covers. */\nexport function drawnAABBOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): Bounds {\n  return axisAlignedBounds(drawnBoundsOf(scene, id, pose, opts));\n}\n\n/** The painter's {@link NodeShapeEntry.drawnBounds} for `node`, or `null`\n *  when no painter matches or the one that does declares none. */\nexport function findShapeDrawnBounds<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): Bounds | null {\n  return findNodeShape(node)?.drawnBounds?.(node, pose, ctx) ?? null;\n}\n\nfunction descriptorFor(scene: DrawnBoundsScene, id: NodeId, opts: DrawnBoundsOptions): PoseDescriptor<unknown> {\n  const d = opts.descriptor ?? AUTO_POSE_DESCRIPTOR;\n  const node = scene.get(id);\n  return node ? poseDescriptorForNode(d, node) : d;\n}\n\n/** A per-axis view scale also carries the map from `own`'s frame to screen,\n *  so a `{ px }` stroke is measured there rather than at the mean. */\nfunction inkCtx(scale: number | Scale2 | undefined, own: Bounds): NodeInkCtx | undefined {\n  if (scale === undefined) return undefined;\n  if (typeof scale === 'number') return { scale };\n  const xf = targetTransformOf(own);\n  const [a, b, c, d] = xf.identity ? [1, 0, 0, 1] : xf.toWorld;\n  return { scale: meanScale(scale), screen: [scale.x * a, scale.y * b, scale.x * c, scale.y * d] };\n}\n\nfunction normalized(b: Bounds): Bounds {\n  return {\n    x: Math.min(b.x, b.x + b.width),\n    y: Math.min(b.y, b.y + b.height),\n    width: Math.abs(b.width),\n    height: Math.abs(b.height),\n  };\n}\n"],"mappings":"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"}