@weasel-js/core 1.10.1 → 1.11.1

package/dist/core/scene/composeFrame.js

@@ -1,32 +1,62 @@
 //#region src/core/scene/composeFrame.ts
-var e = {
-	compose: (e, t) => t,
-	decompose: (e, t) => t,
+/** Default pose-composition strategy: IDENTITY, an absolute-pose scene. */
+var IDENTITY_POSE_COMPOSITION = {
+	compose: (_parent, child) => child,
+	decompose: (_parent, world) => world,
 	closure: "identity"
 };
-function t(e) {
-	return e.closure !== "identity";
+/** Whether `composition` makes a container's pose a frame, so a stored pose
+*  is local to it. False for the absolute-pose model. */
+function composesFrames(composition) {
+	return composition.closure !== "identity";
 }
-function n(e, t, n) {
-	let r = [t], i = /* @__PURE__ */ new Set([t]), a = e.getParent(t);
-	for (; a !== null && !i.has(a);) i.add(a), (e.definesFrame?.(a) ?? !0) && r.push(a), a = e.getParent(a);
-	let o = e.getPose(r[r.length - 1]);
-	for (let t = r.length - 2; t >= 0; t--) o = n(o, e.getPose(r[t]));
-	return o;
+/**
+* Walk `id`'s parent chain and fold local poses into a world pose via
+* `compose`. Cycle-safe.
+*
+* `compose(parent, child)` interprets `child` as expressed *in `parent`'s
+* local frame* and returns the equivalent pose in the next frame up.
+*/
+function composeWorldPose(adapter, id, compose) {
+	const chain = [id];
+	const seen = /* @__PURE__ */ new Set([id]);
+	let cursor = adapter.getParent(id);
+	while (cursor !== null) {
+		if (seen.has(cursor)) break;
+		seen.add(cursor);
+		if (adapter.definesFrame?.(cursor) ?? true) chain.push(cursor);
+		cursor = adapter.getParent(cursor);
+	}
+	let world = adapter.getPose(chain[chain.length - 1]);
+	for (let i = chain.length - 2; i >= 0; i--) world = compose(world, adapter.getPose(chain[i]));
+	return world;
 }
-function r(e, t, r, a, o) {
-	let s = i(e, r);
-	return s === null ? t : o(n(e, s, a), t);
+/**
+* Convert `worldPose` into a local pose expressed under `newParentId`'s
+* frame, so a reparented child keeps its visual world position.
+*
+* `decompose(parent, world)` returns the local pose `child` such that
+* `compose(parent, child) === world`. Pass `newParentId === null` for the
+* root frame; the function returns `worldPose` unchanged.
+*/
+function rebaseLocalPose(adapter, worldPose, newParentId, compose, decompose) {
+	const frame = frameAtOrAbove(adapter, newParentId);
+	if (frame === null) return worldPose;
+	return decompose(composeWorldPose(adapter, frame, compose), worldPose);
 }
-function i(e, t) {
-	let n = /* @__PURE__ */ new Set(), r = t;
-	for (; r !== null && !n.has(r);) {
-		if (e.definesFrame?.(r) ?? !0) return r;
-		n.add(r), r = e.getParent(r);
+/** The nearest node at or above `id` whose pose is a frame, or `null` for the
+*  root frame. Cycle-safe, like `composeWorldPose`. */
+function frameAtOrAbove(adapter, id) {
+	const seen = /* @__PURE__ */ new Set();
+	let cursor = id;
+	while (cursor !== null && !seen.has(cursor)) {
+		if (adapter.definesFrame?.(cursor) ?? true) return cursor;
+		seen.add(cursor);
+		cursor = adapter.getParent(cursor);
 	}
 	return null;
 }
-//#endregion
-export { e as IDENTITY_POSE_COMPOSITION, n as composeWorldPose, t as composesFrames, i as frameAtOrAbove, r as rebaseLocalPose };
 
+//#endregion
+export { IDENTITY_POSE_COMPOSITION, composeWorldPose, composesFrames, frameAtOrAbove, rebaseLocalPose };
 //# sourceMappingURL=composeFrame.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"composeFrame.js","names":["IDENTITY_POSE_COMPOSITION","child","world","composesFrames","composition","composeWorldPose","chain","id","seen","cursor","adapter","i","compose","rebaseLocalPose","frame","frameAtOrAbove","newParentId","worldPose","decompose"],"sources":["../../../src/core/scene/composeFrame.ts"],"sourcesContent":["/** Folding a node's pose up its parent chain to world, and back down. */\n\n/** Minimal adapter needed by `composeWorldPose` and friends — pose lookup plus parent walk. */\nexport interface PoseAdapter<TPose> {\n  getPose(id: string): TPose;\n  getParent(id: string): string | null;\n  /** Whether `id`'s pose is a frame its children are expressed in. Absent\n   *  means every node is one. A container whose pose derives from its children\n   *  is not: its children share its frame, so the fold passes over it. */\n  definesFrame?(id: string): boolean;\n}\n\n/**\n * What a container's pose does to its children under a `compose`: nothing,\n * an offset, or a whole frame. `'rigid'` is the frame: a container's rotation\n * and its `transform` both reach its children, and a child's `transform`\n * holds the skew or stretch its box and rotation cannot.\n */\nexport type PoseClosure = 'identity' | 'translation' | 'rigid';\n\n/** Consumer's pose-composition strategy for hierarchical scenes. `compose`\n *  folds a child's pose (in parent's frame) up to the next frame; `decompose`\n *  is its inverse. Default is IDENTITY — an absolute-pose scene where every\n *  node already stores world coords (parent is grouping-only, no transform). */\nexport interface PoseComposition<TPose> {\n  compose(parent: TPose, child: TPose): TPose;\n  decompose(parent: TPose, world: TPose): TPose;\n  closure: PoseClosure;\n}\n\n/** Default pose-composition strategy: IDENTITY, an absolute-pose scene. */\nexport const IDENTITY_POSE_COMPOSITION: PoseComposition<unknown> = {\n  compose: (_parent, child) => child,\n  decompose: (_parent, world) => world,\n  closure: 'identity',\n};\n\n/** Whether `composition` makes a container's pose a frame, so a stored pose\n *  is local to it. False for the absolute-pose model. */\nexport function composesFrames(composition: { closure: PoseClosure }): boolean {\n  return composition.closure !== 'identity';\n}\n\n/**\n * Walk `id`'s parent chain and fold local poses into a world pose via\n * `compose`. Cycle-safe.\n *\n * `compose(parent, child)` interprets `child` as expressed *in `parent`'s\n * local frame* and returns the equivalent pose in the next frame up.\n */\nexport function composeWorldPose<TPose>(\n  adapter: PoseAdapter<TPose>,\n  id: string,\n  compose: (parent: TPose, child: TPose) => TPose,\n): TPose {\n  const chain: string[] = [id];\n  const seen = new Set<string>([id]);\n  let cursor: string | null = adapter.getParent(id);\n  while (cursor !== null) {\n    if (seen.has(cursor)) break;\n    seen.add(cursor);\n    if (adapter.definesFrame?.(cursor) ?? true) chain.push(cursor);\n    cursor = adapter.getParent(cursor);\n  }\n  // chain is [id, parent, grandparent, ..., root]; fold from the root down.\n  let world = adapter.getPose(chain[chain.length - 1]);\n  for (let i = chain.length - 2; i >= 0; i--) {\n    world = compose(world, adapter.getPose(chain[i]));\n  }\n  return world;\n}\n\n/**\n * Convert `worldPose` into a local pose expressed under `newParentId`'s\n * frame, so a reparented child keeps its visual world position.\n *\n * `decompose(parent, world)` returns the local pose `child` such that\n * `compose(parent, child) === world`. Pass `newParentId === null` for the\n * root frame; the function returns `worldPose` unchanged.\n */\nexport function rebaseLocalPose<TPose>(\n  adapter: PoseAdapter<TPose>,\n  worldPose: TPose,\n  newParentId: string | null,\n  compose: (parent: TPose, child: TPose) => TPose,\n  decompose: (parent: TPose, world: TPose) => TPose,\n): TPose {\n  const frame = frameAtOrAbove(adapter, newParentId);\n  if (frame === null) return worldPose;\n  return decompose(composeWorldPose(adapter, frame, compose), worldPose);\n}\n\n/** The nearest node at or above `id` whose pose is a frame, or `null` for the\n *  root frame. Cycle-safe, like `composeWorldPose`. */\nexport function frameAtOrAbove<TPose>(\n  adapter: PoseAdapter<TPose>,\n  id: string | null,\n): string | null {\n  const seen = new Set<string>();\n  let cursor = id;\n  while (cursor !== null && !seen.has(cursor)) {\n    if (adapter.definesFrame?.(cursor) ?? true) return cursor;\n    seen.add(cursor);\n    cursor = adapter.getParent(cursor);\n  }\n  return null;\n}\n"],"mappings":";AA+BA,IAAaA,IAAsD;CACjE,UAAU,GAAS,MAAUC;CAC7B,YAAY,GAAS,MAAUC;CAC/B,SAAS;AACX;AAIA,SAAgBC,EAAe,GAAgD;CAC7E,OAAOC,EAAY,YAAY;AACjC;AASA,SAAgBC,EACd,GACA,GACA,GACO;CACP,IAAMC,IAAkB,CAACC,CAAE,GACrBC,oBAAO,IAAI,IAAY,CAACD,CAAE,CAAC,GAC7BE,IAAwBC,EAAQ,UAAUH,CAAE;CAChD,OAAOE,MAAW,QACZ,GAAK,IAAIA,CAAM,IAGnB,AAFAD,EAAK,IAAIC,CAAM,IACXC,EAAQ,eAAeD,CAAM,KAAK,OAAMH,EAAM,KAAKG,CAAM,GAC7D,IAASC,EAAQ,UAAUD,CAAM;CAGnC,IAAIP,IAAQQ,EAAQ,QAAQJ,EAAMA,EAAM,SAAS,EAAE;CACnD,KAAK,IAAIK,IAAIL,EAAM,SAAS,GAAGK,KAAK,GAAG,KACrC,IAAQC,EAAQV,GAAOQ,EAAQ,QAAQJ,EAAMK,EAAE,CAAC;CAElD,OAAOT;AACT;AAUA,SAAgBW,EACd,GACA,GACA,GACA,GACA,GACO;CACP,IAAMC,IAAQC,EAAeL,GAASM,CAAW;CAEjD,OADIF,MAAU,OAAaG,IACpBC,EAAUb,EAAiBK,GAASI,GAAOF,CAAO,GAAGK,CAAS;AACvE;AAIA,SAAgBF,EACd,GACA,GACe;CACf,IAAMP,oBAAO,IAAI,IAAY,GACzBC,IAASF;CACb,OAAOE,MAAW,QAAQ,CAACD,EAAK,IAAIC,CAAM,IAAG;EAC3C,IAAIC,EAAQ,eAAeD,CAAM,KAAK,IAAM,OAAOA;EAEnD,AADAD,EAAK,IAAIC,CAAM,GACf,IAASC,EAAQ,UAAUD,CAAM;CACnC;CACA,OAAO;AACT"}
+{"version":3,"file":"composeFrame.js","names":[],"sources":["../../../src/core/scene/composeFrame.ts"],"sourcesContent":["/** Folding a node's pose up its parent chain to world, and back down. */\n\n/** Minimal adapter needed by `composeWorldPose` and friends — pose lookup plus parent walk. */\nexport interface PoseAdapter<TPose> {\n  getPose(id: string): TPose;\n  getParent(id: string): string | null;\n  /** Whether `id`'s pose is a frame its children are expressed in. Absent\n   *  means every node is one. A container whose pose derives from its children\n   *  is not: its children share its frame, so the fold passes over it. */\n  definesFrame?(id: string): boolean;\n}\n\n/**\n * What a container's pose does to its children under a `compose`: nothing,\n * an offset, or a whole frame. `'rigid'` is the frame: a container's rotation\n * and its `transform` both reach its children, and a child's `transform`\n * holds the skew or stretch its box and rotation cannot.\n */\nexport type PoseClosure = 'identity' | 'translation' | 'rigid';\n\n/** Consumer's pose-composition strategy for hierarchical scenes. `compose`\n *  folds a child's pose (in parent's frame) up to the next frame; `decompose`\n *  is its inverse. Default is IDENTITY — an absolute-pose scene where every\n *  node already stores world coords (parent is grouping-only, no transform). */\nexport interface PoseComposition<TPose> {\n  compose(parent: TPose, child: TPose): TPose;\n  decompose(parent: TPose, world: TPose): TPose;\n  closure: PoseClosure;\n}\n\n/** Default pose-composition strategy: IDENTITY, an absolute-pose scene. */\nexport const IDENTITY_POSE_COMPOSITION: PoseComposition<unknown> = {\n  compose: (_parent, child) => child,\n  decompose: (_parent, world) => world,\n  closure: 'identity',\n};\n\n/** Whether `composition` makes a container's pose a frame, so a stored pose\n *  is local to it. False for the absolute-pose model. */\nexport function composesFrames(composition: { closure: PoseClosure }): boolean {\n  return composition.closure !== 'identity';\n}\n\n/**\n * Walk `id`'s parent chain and fold local poses into a world pose via\n * `compose`. Cycle-safe.\n *\n * `compose(parent, child)` interprets `child` as expressed *in `parent`'s\n * local frame* and returns the equivalent pose in the next frame up.\n */\nexport function composeWorldPose<TPose>(\n  adapter: PoseAdapter<TPose>,\n  id: string,\n  compose: (parent: TPose, child: TPose) => TPose,\n): TPose {\n  const chain: string[] = [id];\n  const seen = new Set<string>([id]);\n  let cursor: string | null = adapter.getParent(id);\n  while (cursor !== null) {\n    if (seen.has(cursor)) break;\n    seen.add(cursor);\n    if (adapter.definesFrame?.(cursor) ?? true) chain.push(cursor);\n    cursor = adapter.getParent(cursor);\n  }\n  // chain is [id, parent, grandparent, ..., root]; fold from the root down.\n  let world = adapter.getPose(chain[chain.length - 1]);\n  for (let i = chain.length - 2; i >= 0; i--) {\n    world = compose(world, adapter.getPose(chain[i]));\n  }\n  return world;\n}\n\n/**\n * Convert `worldPose` into a local pose expressed under `newParentId`'s\n * frame, so a reparented child keeps its visual world position.\n *\n * `decompose(parent, world)` returns the local pose `child` such that\n * `compose(parent, child) === world`. Pass `newParentId === null` for the\n * root frame; the function returns `worldPose` unchanged.\n */\nexport function rebaseLocalPose<TPose>(\n  adapter: PoseAdapter<TPose>,\n  worldPose: TPose,\n  newParentId: string | null,\n  compose: (parent: TPose, child: TPose) => TPose,\n  decompose: (parent: TPose, world: TPose) => TPose,\n): TPose {\n  const frame = frameAtOrAbove(adapter, newParentId);\n  if (frame === null) return worldPose;\n  return decompose(composeWorldPose(adapter, frame, compose), worldPose);\n}\n\n/** The nearest node at or above `id` whose pose is a frame, or `null` for the\n *  root frame. Cycle-safe, like `composeWorldPose`. */\nexport function frameAtOrAbove<TPose>(\n  adapter: PoseAdapter<TPose>,\n  id: string | null,\n): string | null {\n  const seen = new Set<string>();\n  let cursor = id;\n  while (cursor !== null && !seen.has(cursor)) {\n    if (adapter.definesFrame?.(cursor) ?? true) return cursor;\n    seen.add(cursor);\n    cursor = adapter.getParent(cursor);\n  }\n  return null;\n}\n"],"mappings":";;AA+BA,IAAa,4BAAsD;CACjE,UAAU,SAAS,UAAU;CAC7B,YAAY,SAAS,UAAU;CAC/B,SAAS;AACX;;;AAIA,SAAgB,eAAe,aAAgD;CAC7E,OAAO,YAAY,YAAY;AACjC;;;;;;;;AASA,SAAgB,iBACd,SACA,IACA,SACO;CACP,MAAM,QAAkB,CAAC,EAAE;CAC3B,MAAM,uBAAO,IAAI,IAAY,CAAC,EAAE,CAAC;CACjC,IAAI,SAAwB,QAAQ,UAAU,EAAE;CAChD,OAAO,WAAW,MAAM;EACtB,IAAI,KAAK,IAAI,MAAM,GAAG;EACtB,KAAK,IAAI,MAAM;EACf,IAAI,QAAQ,eAAe,MAAM,KAAK,MAAM,MAAM,KAAK,MAAM;EAC7D,SAAS,QAAQ,UAAU,MAAM;CACnC;CAEA,IAAI,QAAQ,QAAQ,QAAQ,MAAM,MAAM,SAAS,EAAE;CACnD,KAAK,IAAI,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KACrC,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,MAAM,EAAE,CAAC;CAElD,OAAO;AACT;;;;;;;;;AAUA,SAAgB,gBACd,SACA,WACA,aACA,SACA,WACO;CACP,MAAM,QAAQ,eAAe,SAAS,WAAW;CACjD,IAAI,UAAU,MAAM,OAAO;CAC3B,OAAO,UAAU,iBAAiB,SAAS,OAAO,OAAO,GAAG,SAAS;AACvE;;;AAIA,SAAgB,eACd,SACA,IACe;CACf,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI,SAAS;CACb,OAAO,WAAW,QAAQ,CAAC,KAAK,IAAI,MAAM,GAAG;EAC3C,IAAI,QAAQ,eAAe,MAAM,KAAK,MAAM,OAAO;EACnD,KAAK,IAAI,MAAM;EACf,SAAS,QAAQ,UAAU,MAAM;CACnC;CACA,OAAO;AACT"}

package/dist/core/scene/composePose.js

@@ -1,47 +1,69 @@
-import { IDENTITY_POSE_COMPOSITION as e, composeWorldPose as t, composesFrames as n, frameAtOrAbove as r, rebaseLocalPose as i } from "./composeFrame.js";
-import { applyToPoint as a, multiply as o, poseFrameInverseOf as s, poseFrameOf as c, poseLinearOf as l, rotate as u } from "@weasel-js/geom";
+import { IDENTITY_POSE_COMPOSITION, composeWorldPose, composesFrames, frameAtOrAbove, rebaseLocalPose } from "./composeFrame.js";
+import { applyToPoint, multiply, poseFrameInverseOf, poseFrameOf, poseLinearOf, rotate } from "@weasel-js/geom";
+
 //#region src/core/scene/composePose.ts
-function d(e, t) {
+/**
+* Pose composition for hierarchical scene graphs.
+*
+* `getPose(id)` on adapters returns the **local** pose — relative to the
+* object's direct parent. Anything in the kit that needs world coordinates
+* routes through `composeWorldPose`, which folds local poses together via a
+* consumer-supplied `compose`.
+*/
+/**
+* `compose` for axis-aligned rectangles under a translation-only hierarchy.
+* Adds translation; every other field is taken from the child unchanged.
+*/
+function composeRectPose(parent, child) {
 	return {
-		...t,
-		x: e.x + t.x,
-		y: e.y + t.y
+		...child,
+		x: parent.x + child.x,
+		y: parent.y + child.y
 	};
 }
-function f(e, t, n) {
+/** Translate a `RectPose`-shaped pose by `(dx, dy)`; other fields are preserved. */
+function translateRectPose(pose, dx, dy) {
 	return {
-		...e,
-		x: e.x + t,
-		y: e.y + n
+		...pose,
+		x: pose.x + dx,
+		y: pose.y + dy
 	};
 }
-function p(e, t) {
+/** Inverse of `composeRectPose` — subtracts parent translation. */
+function decomposeRectPose(parent, world) {
 	return {
-		...t,
-		x: t.x - e.x,
-		y: t.y - e.y
+		...world,
+		x: world.x - parent.x,
+		y: world.y - parent.y
 	};
 }
-function m(e, t, n) {
-	let [r, i, a, s] = o(u(-t), n), c = Math.abs(r - 1) < 1e-12 && Math.abs(i) < 1e-12 && Math.abs(a) < 1e-12 && Math.abs(s - 1) < 1e-12, l = {
-		...e,
-		rotation: t
+/** `pose` with the linear part `linear` held as `rotation` and whatever is
+*  left over as `transform`, which is dropped when nothing is. */
+function withLinear(pose, rotation, linear) {
+	const [a, b, c, d] = multiply(rotate(-rotation), linear);
+	const plain = Math.abs(a - 1) < 1e-12 && Math.abs(b) < 1e-12 && Math.abs(c) < 1e-12 && Math.abs(d - 1) < 1e-12;
+	const next = {
+		...pose,
+		rotation
 	};
-	return c ? delete l.transform : l.transform = [
-		r,
-		i,
+	if (plain) delete next.transform;
+	else next.transform = [
 		a,
-		s
-	], l;
+		b,
+		c,
+		d
+	];
+	return next;
 }
-function h(e, t, n) {
+/** `pose` moved so its box center is at `(cx, cy)`. */
+function centeredAt(pose, cx, cy) {
 	return {
-		...e,
-		x: t - e.width / 2,
-		y: n - e.height / 2
+		...pose,
+		x: cx - pose.width / 2,
+		y: cy - pose.height / 2
 	};
 }
-var g = [
+var NO_FRAME = [
 	1,
 	0,
 	0,
@@ -49,57 +71,87 @@ var g = [
 	0,
 	0
 ];
-function _(e, t, n, r, i) {
-	let a = Math.cos(n), o = Math.sin(n);
-	return [e + (r - e) * a - (i - t) * o, t + (r - e) * o + (i - t) * a];
+/** Turn `(x, y)` about `(cx, cy)` by `r` radians. */
+function turn(cx, cy, r, x, y) {
+	const c = Math.cos(r);
+	const s = Math.sin(r);
+	return [cx + (x - cx) * c - (y - cy) * s, cy + (x - cx) * s + (y - cy) * c];
 }
-function v(e, t) {
-	let n = e.rotation ?? 0, r = l(e) && c(e);
-	if (r) {
-		let [i, s] = a(r, e.x + t.x + t.width / 2, e.y + t.y + t.height / 2), l = o(r, c(t) ?? g);
-		return m(h(t, i, s), (t.rotation ?? 0) + n, l);
+/**
+* `compose` for a container whose pose defines a **frame**: the child's local
+* pose is offset into the parent's unrotated box, then the whole thing is
+* turned about the parent's center. Rotations add; the child keeps its size.
+*
+* Reduces to `composeRectPose` when the parent is upright. A parent's
+* `transform` composes too, and what the child's box and rotation cannot hold
+* of the result lands in the child's own `transform`.
+*/
+function composeRigidPose(parent, child) {
+	const pr = parent.rotation ?? 0;
+	const frame = poseLinearOf(parent) && poseFrameOf(parent);
+	if (frame) {
+		const [cx, cy] = applyToPoint(frame, parent.x + child.x + child.width / 2, parent.y + child.y + child.height / 2);
+		const linear = multiply(frame, poseFrameOf(child) ?? NO_FRAME);
+		return withLinear(centeredAt(child, cx, cy), (child.rotation ?? 0) + pr, linear);
 	}
-	let [i, s] = _(e.x + e.width / 2, e.y + e.height / 2, n, e.x + t.x + t.width / 2, e.y + t.y + t.height / 2);
+	const [wcx, wcy] = turn(parent.x + parent.width / 2, parent.y + parent.height / 2, pr, parent.x + child.x + child.width / 2, parent.y + child.y + child.height / 2);
 	return {
-		...t,
-		x: i - t.width / 2,
-		y: s - t.height / 2,
-		rotation: (t.rotation ?? 0) + n
+		...child,
+		x: wcx - child.width / 2,
+		y: wcy - child.height / 2,
+		rotation: (child.rotation ?? 0) + pr
 	};
 }
-function y(e, t) {
-	let n = e.rotation ?? 0, r = l(e) && s(e);
-	if (r) {
-		let [i, s] = a(r, t.x + t.width / 2, t.y + t.height / 2), l = o(r, c(t) ?? g);
-		return m(h(t, i - e.x, s - e.y), (t.rotation ?? 0) - n, l);
+/** Inverse of `composeRigidPose` — un-turns about the parent's center, then
+*  subtracts the parent's offset. */
+function decomposeRigidPose(parent, world) {
+	const pr = parent.rotation ?? 0;
+	const back = poseLinearOf(parent) && poseFrameInverseOf(parent);
+	if (back) {
+		const [ux, uy] = applyToPoint(back, world.x + world.width / 2, world.y + world.height / 2);
+		const linear = multiply(back, poseFrameOf(world) ?? NO_FRAME);
+		return withLinear(centeredAt(world, ux - parent.x, uy - parent.y), (world.rotation ?? 0) - pr, linear);
 	}
-	let [i, u] = _(e.x + e.width / 2, e.y + e.height / 2, -n, t.x + t.width / 2, t.y + t.height / 2);
+	const [ux, uy] = turn(parent.x + parent.width / 2, parent.y + parent.height / 2, -pr, world.x + world.width / 2, world.y + world.height / 2);
 	return {
-		...t,
-		x: i - e.x - t.width / 2,
-		y: u - e.y - t.height / 2,
-		rotation: (t.rotation ?? 0) - n
+		...world,
+		x: ux - parent.x - world.width / 2,
+		y: uy - parent.y - world.height / 2,
+		rotation: (world.rotation ?? 0) - pr
 	};
 }
-var b = {
-	compose: d,
-	decompose: p,
+/** Translation-only composition over `RectPose`. What a scene wants when a
+*  container groups its children but never turns them. */
+var RECT_POSE_COMPOSITION = {
+	compose: composeRectPose,
+	decompose: decomposeRectPose,
 	closure: "translation"
-}, x = {
-	compose: v,
-	decompose: y,
+};
+/** Composition over `RectPose` where a container's pose is a frame: rotating
+*  the container rotates its contents. */
+var RIGID_POSE_COMPOSITION = {
+	compose: composeRigidPose,
+	decompose: decomposeRigidPose,
 	closure: "rigid"
 };
-function S(e, n) {
-	return (r) => {
+/**
+* Build a `(id) => world pose | null` callback over a `PoseAdapter`, for
+* RenderLayers that take a `getPose` callback.
+*
+* Returns `null` when `adapter.getPose` or `adapter.getParent` throws — the
+* common case is an id removed mid-render between selection state and the
+* next paint. Layers should treat `null` as "skip this id."
+*/
+function worldPoseLookup(adapter, compose) {
+	return (id) => {
 		try {
-			return t(e, r, n);
+			return composeWorldPose(adapter, id, compose);
 		} catch {
 			return null;
 		}
 	};
 }
-//#endregion
-export { e as IDENTITY_POSE_COMPOSITION, b as RECT_POSE_COMPOSITION, x as RIGID_POSE_COMPOSITION, d as composeRectPose, v as composeRigidPose, t as composeWorldPose, n as composesFrames, p as decomposeRectPose, y as decomposeRigidPose, r as frameAtOrAbove, i as rebaseLocalPose, f as translateRectPose, S as worldPoseLookup };
 
+//#endregion
+export { IDENTITY_POSE_COMPOSITION, RECT_POSE_COMPOSITION, RIGID_POSE_COMPOSITION, composeRectPose, composeRigidPose, composeWorldPose, composesFrames, decomposeRectPose, decomposeRigidPose, frameAtOrAbove, rebaseLocalPose, translateRectPose, worldPoseLookup };
 //# sourceMappingURL=composePose.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"composePose.js","names":["composeRectPose","child","parent","translateRectPose","pose","dx","dy","decomposeRectPose","world","withLinear","a","b","c","d","multiply","rotate","rotation","linear","plain","next","centeredAt","cx","cy","NO_FRAME","turn","r","s","x","y","composeRigidPose","pr","frame","poseLinearOf","poseFrameOf","applyToPoint","wcx","wcy","decomposeRigidPose","back","poseFrameInverseOf","ux","uy","RECT_POSE_COMPOSITION","RIGID_POSE_COMPOSITION","worldPoseLookup","composeWorldPose","adapter","id","compose","IDENTITY_POSE_COMPOSITION","composesFrames","frameAtOrAbove","rebaseLocalPose"],"sources":["../../../src/core/scene/composePose.ts"],"sourcesContent":["/**\n * Pose composition for hierarchical scene graphs.\n *\n * `getPose(id)` on adapters returns the **local** pose — relative to the\n * object's direct parent. Anything in the kit that needs world coordinates\n * routes through `composeWorldPose`, which folds local poses together via a\n * consumer-supplied `compose`.\n */\n\nimport { applyToPoint, multiply, poseFrameInverseOf, poseFrameOf, poseLinearOf, rotate, type Affine } from '@weasel-js/geom';\nimport type { RectPose } from 'core/scene/types';\nexport type { RectPose };\n\nimport {\n  IDENTITY_POSE_COMPOSITION,\n  composesFrames,\n  composeWorldPose,\n  frameAtOrAbove,\n  rebaseLocalPose,\n  type PoseAdapter,\n  type PoseClosure,\n  type PoseComposition,\n} from 'core/scene/composeFrame';\nexport { IDENTITY_POSE_COMPOSITION, composesFrames, composeWorldPose, frameAtOrAbove, rebaseLocalPose };\nexport type { PoseAdapter, PoseClosure, PoseComposition };\n\n/**\n * `compose` for axis-aligned rectangles under a translation-only hierarchy.\n * Adds translation; every other field is taken from the child unchanged.\n */\nexport function composeRectPose<TPose extends RectPose>(parent: TPose, child: TPose): TPose {\n  return {\n    ...child,\n    x: parent.x + child.x,\n    y: parent.y + child.y,\n  };\n}\n\n/** Translate a `RectPose`-shaped pose by `(dx, dy)`; other fields are preserved. */\nexport function translateRectPose<TPose extends RectPose>(pose: TPose, dx: number, dy: number): TPose {\n  return { ...pose, x: pose.x + dx, y: pose.y + dy };\n}\n\n/** Inverse of `composeRectPose` — subtracts parent translation. */\nexport function decomposeRectPose<TPose extends RectPose>(parent: TPose, world: TPose): TPose {\n  return {\n    ...world,\n    x: world.x - parent.x,\n    y: world.y - parent.y,\n  };\n}\n\n/** `pose` with the linear part `linear` held as `rotation` and whatever is\n *  left over as `transform`, which is dropped when nothing is. */\nfunction withLinear<TPose extends RectPose>(pose: TPose, rotation: number, linear: Affine): TPose {\n  const [a, b, c, d] = multiply(rotate(-rotation), linear);\n  const plain = Math.abs(a - 1) < 1e-12 && Math.abs(b) < 1e-12 && Math.abs(c) < 1e-12 && Math.abs(d - 1) < 1e-12;\n  const next: RectPose = { ...pose, rotation };\n  if (plain) delete next.transform;\n  else next.transform = [a, b, c, d];\n  return next as TPose;\n}\n\n/** `pose` moved so its box center is at `(cx, cy)`. */\nfunction centeredAt<TPose extends RectPose>(pose: TPose, cx: number, cy: number): TPose {\n  return { ...pose, x: cx - pose.width / 2, y: cy - pose.height / 2 };\n}\n\nconst NO_FRAME: Affine = [1, 0, 0, 1, 0, 0];\n\n/** Turn `(x, y)` about `(cx, cy)` by `r` radians. */\nfunction turn(cx: number, cy: number, r: number, x: number, y: number): [number, number] {\n  const c = Math.cos(r);\n  const s = Math.sin(r);\n  return [cx + (x - cx) * c - (y - cy) * s, cy + (x - cx) * s + (y - cy) * c];\n}\n\n/**\n * `compose` for a container whose pose defines a **frame**: the child's local\n * pose is offset into the parent's unrotated box, then the whole thing is\n * turned about the parent's center. Rotations add; the child keeps its size.\n *\n * Reduces to `composeRectPose` when the parent is upright. A parent's\n * `transform` composes too, and what the child's box and rotation cannot hold\n * of the result lands in the child's own `transform`.\n */\nexport function composeRigidPose<TPose extends RectPose>(parent: TPose, child: TPose): TPose {\n  const pr = parent.rotation ?? 0;\n  const frame = poseLinearOf(parent) && poseFrameOf(parent);\n  if (frame) {\n    const [cx, cy] = applyToPoint(frame, parent.x + child.x + child.width / 2, parent.y + child.y + child.height / 2);\n    const linear = multiply(frame, poseFrameOf(child) ?? NO_FRAME);\n    return withLinear(centeredAt(child, cx, cy), (child.rotation ?? 0) + pr, linear);\n  }\n  const [wcx, wcy] = turn(\n    parent.x + parent.width / 2,\n    parent.y + parent.height / 2,\n    pr,\n    parent.x + child.x + child.width / 2,\n    parent.y + child.y + child.height / 2,\n  );\n  return {\n    ...child,\n    x: wcx - child.width / 2,\n    y: wcy - child.height / 2,\n    rotation: (child.rotation ?? 0) + pr,\n  };\n}\n\n/** Inverse of `composeRigidPose` — un-turns about the parent's center, then\n *  subtracts the parent's offset. */\nexport function decomposeRigidPose<TPose extends RectPose>(parent: TPose, world: TPose): TPose {\n  const pr = parent.rotation ?? 0;\n  // A singular transform has no inverse: the container draws nothing, and the turn alone is undone.\n  const back = poseLinearOf(parent) && poseFrameInverseOf(parent);\n  if (back) {\n    const [ux, uy] = applyToPoint(back, world.x + world.width / 2, world.y + world.height / 2);\n    const linear = multiply(back, poseFrameOf(world) ?? NO_FRAME);\n    return withLinear(centeredAt(world, ux - parent.x, uy - parent.y), (world.rotation ?? 0) - pr, linear);\n  }\n  const [ux, uy] = turn(\n    parent.x + parent.width / 2,\n    parent.y + parent.height / 2,\n    -pr,\n    world.x + world.width / 2,\n    world.y + world.height / 2,\n  );\n  return {\n    ...world,\n    x: ux - parent.x - world.width / 2,\n    y: uy - parent.y - world.height / 2,\n    rotation: (world.rotation ?? 0) - pr,\n  };\n}\n\n/** Translation-only composition over `RectPose`. What a scene wants when a\n *  container groups its children but never turns them. */\nexport const RECT_POSE_COMPOSITION: PoseComposition<RectPose> = {\n  compose: composeRectPose,\n  decompose: decomposeRectPose,\n  closure: 'translation',\n};\n\n/** Composition over `RectPose` where a container's pose is a frame: rotating\n *  the container rotates its contents. */\nexport const RIGID_POSE_COMPOSITION: PoseComposition<RectPose> = {\n  compose: composeRigidPose,\n  decompose: decomposeRigidPose,\n  closure: 'rigid',\n};\n\n/**\n * Build a `(id) => world pose | null` callback over a `PoseAdapter`, for\n * RenderLayers that take a `getPose` callback.\n *\n * Returns `null` when `adapter.getPose` or `adapter.getParent` throws — the\n * common case is an id removed mid-render between selection state and the\n * next paint. Layers should treat `null` as \"skip this id.\"\n */\nexport function worldPoseLookup<TPose>(\n  adapter: PoseAdapter<TPose>,\n  compose: (parent: TPose, child: TPose) => TPose,\n): (id: string) => TPose | null {\n  return (id: string) => {\n    try {\n      return composeWorldPose(adapter, id, compose);\n    } catch {\n      return null;\n    }\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"composePose.js","names":[],"sources":["../../../src/core/scene/composePose.ts"],"sourcesContent":["/**\n * Pose composition for hierarchical scene graphs.\n *\n * `getPose(id)` on adapters returns the **local** pose — relative to the\n * object's direct parent. Anything in the kit that needs world coordinates\n * routes through `composeWorldPose`, which folds local poses together via a\n * consumer-supplied `compose`.\n */\n\nimport { applyToPoint, multiply, poseFrameInverseOf, poseFrameOf, poseLinearOf, rotate, type Affine } from '@weasel-js/geom';\nimport type { RectPose } from 'core/scene/types';\nexport type { RectPose };\n\nimport {\n  IDENTITY_POSE_COMPOSITION,\n  composesFrames,\n  composeWorldPose,\n  frameAtOrAbove,\n  rebaseLocalPose,\n  type PoseAdapter,\n  type PoseClosure,\n  type PoseComposition,\n} from 'core/scene/composeFrame';\nexport { IDENTITY_POSE_COMPOSITION, composesFrames, composeWorldPose, frameAtOrAbove, rebaseLocalPose };\nexport type { PoseAdapter, PoseClosure, PoseComposition };\n\n/**\n * `compose` for axis-aligned rectangles under a translation-only hierarchy.\n * Adds translation; every other field is taken from the child unchanged.\n */\nexport function composeRectPose<TPose extends RectPose>(parent: TPose, child: TPose): TPose {\n  return {\n    ...child,\n    x: parent.x + child.x,\n    y: parent.y + child.y,\n  };\n}\n\n/** Translate a `RectPose`-shaped pose by `(dx, dy)`; other fields are preserved. */\nexport function translateRectPose<TPose extends RectPose>(pose: TPose, dx: number, dy: number): TPose {\n  return { ...pose, x: pose.x + dx, y: pose.y + dy };\n}\n\n/** Inverse of `composeRectPose` — subtracts parent translation. */\nexport function decomposeRectPose<TPose extends RectPose>(parent: TPose, world: TPose): TPose {\n  return {\n    ...world,\n    x: world.x - parent.x,\n    y: world.y - parent.y,\n  };\n}\n\n/** `pose` with the linear part `linear` held as `rotation` and whatever is\n *  left over as `transform`, which is dropped when nothing is. */\nfunction withLinear<TPose extends RectPose>(pose: TPose, rotation: number, linear: Affine): TPose {\n  const [a, b, c, d] = multiply(rotate(-rotation), linear);\n  const plain = Math.abs(a - 1) < 1e-12 && Math.abs(b) < 1e-12 && Math.abs(c) < 1e-12 && Math.abs(d - 1) < 1e-12;\n  const next: RectPose = { ...pose, rotation };\n  if (plain) delete next.transform;\n  else next.transform = [a, b, c, d];\n  return next as TPose;\n}\n\n/** `pose` moved so its box center is at `(cx, cy)`. */\nfunction centeredAt<TPose extends RectPose>(pose: TPose, cx: number, cy: number): TPose {\n  return { ...pose, x: cx - pose.width / 2, y: cy - pose.height / 2 };\n}\n\nconst NO_FRAME: Affine = [1, 0, 0, 1, 0, 0];\n\n/** Turn `(x, y)` about `(cx, cy)` by `r` radians. */\nfunction turn(cx: number, cy: number, r: number, x: number, y: number): [number, number] {\n  const c = Math.cos(r);\n  const s = Math.sin(r);\n  return [cx + (x - cx) * c - (y - cy) * s, cy + (x - cx) * s + (y - cy) * c];\n}\n\n/**\n * `compose` for a container whose pose defines a **frame**: the child's local\n * pose is offset into the parent's unrotated box, then the whole thing is\n * turned about the parent's center. Rotations add; the child keeps its size.\n *\n * Reduces to `composeRectPose` when the parent is upright. A parent's\n * `transform` composes too, and what the child's box and rotation cannot hold\n * of the result lands in the child's own `transform`.\n */\nexport function composeRigidPose<TPose extends RectPose>(parent: TPose, child: TPose): TPose {\n  const pr = parent.rotation ?? 0;\n  const frame = poseLinearOf(parent) && poseFrameOf(parent);\n  if (frame) {\n    const [cx, cy] = applyToPoint(frame, parent.x + child.x + child.width / 2, parent.y + child.y + child.height / 2);\n    const linear = multiply(frame, poseFrameOf(child) ?? NO_FRAME);\n    return withLinear(centeredAt(child, cx, cy), (child.rotation ?? 0) + pr, linear);\n  }\n  const [wcx, wcy] = turn(\n    parent.x + parent.width / 2,\n    parent.y + parent.height / 2,\n    pr,\n    parent.x + child.x + child.width / 2,\n    parent.y + child.y + child.height / 2,\n  );\n  return {\n    ...child,\n    x: wcx - child.width / 2,\n    y: wcy - child.height / 2,\n    rotation: (child.rotation ?? 0) + pr,\n  };\n}\n\n/** Inverse of `composeRigidPose` — un-turns about the parent's center, then\n *  subtracts the parent's offset. */\nexport function decomposeRigidPose<TPose extends RectPose>(parent: TPose, world: TPose): TPose {\n  const pr = parent.rotation ?? 0;\n  // A singular transform has no inverse: the container draws nothing, and the turn alone is undone.\n  const back = poseLinearOf(parent) && poseFrameInverseOf(parent);\n  if (back) {\n    const [ux, uy] = applyToPoint(back, world.x + world.width / 2, world.y + world.height / 2);\n    const linear = multiply(back, poseFrameOf(world) ?? NO_FRAME);\n    return withLinear(centeredAt(world, ux - parent.x, uy - parent.y), (world.rotation ?? 0) - pr, linear);\n  }\n  const [ux, uy] = turn(\n    parent.x + parent.width / 2,\n    parent.y + parent.height / 2,\n    -pr,\n    world.x + world.width / 2,\n    world.y + world.height / 2,\n  );\n  return {\n    ...world,\n    x: ux - parent.x - world.width / 2,\n    y: uy - parent.y - world.height / 2,\n    rotation: (world.rotation ?? 0) - pr,\n  };\n}\n\n/** Translation-only composition over `RectPose`. What a scene wants when a\n *  container groups its children but never turns them. */\nexport const RECT_POSE_COMPOSITION: PoseComposition<RectPose> = {\n  compose: composeRectPose,\n  decompose: decomposeRectPose,\n  closure: 'translation',\n};\n\n/** Composition over `RectPose` where a container's pose is a frame: rotating\n *  the container rotates its contents. */\nexport const RIGID_POSE_COMPOSITION: PoseComposition<RectPose> = {\n  compose: composeRigidPose,\n  decompose: decomposeRigidPose,\n  closure: 'rigid',\n};\n\n/**\n * Build a `(id) => world pose | null` callback over a `PoseAdapter`, for\n * RenderLayers that take a `getPose` callback.\n *\n * Returns `null` when `adapter.getPose` or `adapter.getParent` throws — the\n * common case is an id removed mid-render between selection state and the\n * next paint. Layers should treat `null` as \"skip this id.\"\n */\nexport function worldPoseLookup<TPose>(\n  adapter: PoseAdapter<TPose>,\n  compose: (parent: TPose, child: TPose) => TPose,\n): (id: string) => TPose | null {\n  return (id: string) => {\n    try {\n      return composeWorldPose(adapter, id, compose);\n    } catch {\n      return null;\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/core/scene/depFrame.js

@@ -0,0 +1,94 @@
+import { composeWorldPose, composesFrames, frameAtOrAbove } from "./composeFrame.js";
+import { derivedPartsOf, pathFromParts } from "./derivedParts.js";
+import { boxToBox, multiply, poseFrameInverseOf, poseFrameOf, transformPath } from "@weasel-js/geom";
+
+//#region src/core/scene/depFrame.ts
+/**
+* A dependency's pose in the frame of the node reading it. Under a composing
+* strategy a stored pose is local to its container, so a node deriving from
+* something in another container would otherwise read it in that
+* container's frame and place itself as though the two frames were one.
+*/
+/** `(depId, pose) => that pose in `reader`'s frame`, or `null` when every
+*  pose is already in one frame — the absolute-pose model. `poseOf` answers
+*  each node's own, local pose. */
+function depFrameRebase(composition, reader, get, poseOf, definesFrame) {
+	if (composition === void 0 || !composesFrames(composition)) return null;
+	const adapter = {
+		getPose: (id) => poseOf(id),
+		getParent: (id) => get(id)?.parent ?? null,
+		definesFrame: (id) => definesFrame(id)
+	};
+	const frame = frameAtOrAbove(adapter, reader.parent ?? null);
+	return (depId, pose) => {
+		const own = frameAtOrAbove(adapter, get(depId)?.parent ?? null);
+		if (own === frame) return pose;
+		const world = own === null ? pose : composition.compose(composeWorldPose(adapter, own, composition.compose), pose);
+		return frame === null ? world : composition.decompose(composeWorldPose(adapter, frame, composition.compose), world);
+	};
+}
+function isBox(pose) {
+	const p = pose;
+	return typeof p === "object" && p !== null && typeof p.x === "number" && typeof p.y === "number" && typeof p.width === "number" && typeof p.height === "number";
+}
+/**
+* `path`, drawn in the unturned box of a node posed at `from`, as it is drawn
+* in the box of `to`. Whatever turns the box is applied after, by whoever
+* paints it. A pose that is not a box leaves the path where it is.
+*/
+function carryBoxPath(path, from, to) {
+	if (!isBox(from) || !isBox(to)) return path;
+	if (from.x === to.x && from.y === to.y && from.width === to.width && from.height === to.height) return path;
+	return carryPathBy(path, boxToBox(from.x, from.y, from.width, from.height, to.x, to.y, to.width, to.height));
+}
+/**
+* A dependency's derived `path`, drawn in its own frame, carried into the
+* reader's — the frame change that took its pose `from` to `to`: out of
+* `from`'s turn, {@link carryBoxPath}'s box to box, into `to`'s turn.
+*/
+function carryDepPath(path, from, to) {
+	if (!isBox(from) || !isBox(to)) return path;
+	const back = poseFrameInverseOf(from);
+	const fwd = poseFrameOf(to);
+	let m = boxToBox(from.x, from.y, from.width, from.height, to.x, to.y, to.width, to.height);
+	if (back !== null) m = multiply(m, back);
+	if (fwd !== null) m = multiply(fwd, m);
+	return carryPathBy(path, m);
+}
+/**
+* `path`, drawn in the unturned box of a node posed at `box` — where a painter
+* draws, and where a pose override's path is given — as that node is painted
+* posed at `at`: carried box to box, then turned by `at`. Where a derivation
+* reads it, beside `at` as the dependency's pose.
+*/
+function pathAsPainted(path, box, at) {
+	if (!isBox(box) || !isBox(at)) return path;
+	const fwd = poseFrameOf(at);
+	const same = box.x === at.x && box.y === at.y && box.width === at.width && box.height === at.height;
+	if (fwd === null && same) return path;
+	const m = boxToBox(box.x, box.y, box.width, box.height, at.x, at.y, at.width, at.height);
+	return carryPathBy(path, fwd === null ? m : multiply(fwd, m));
+}
+/** `path` through `m`, keeping its parts. Painted and read every frame, and a
+*  derivation's memo compares the path it read by reference, so the copy is
+*  kept against it. */
+function carryPathBy(path, m) {
+	const key = m.join(",");
+	const held = carried.get(path);
+	if (held?.key === key) return held.path;
+	const parts = derivedPartsOf(path);
+	const out = parts === void 0 ? transformPath(path, m) : pathFromParts(parts.map((part) => ({
+		...part,
+		path: transformPath(part.path, m)
+	})));
+	carried.set(path, {
+		key,
+		path: out
+	});
+	return out;
+}
+var carried = /* @__PURE__ */ new WeakMap();
+
+//#endregion
+export { carryBoxPath, carryDepPath, carryPathBy, depFrameRebase, pathAsPainted };
+//# sourceMappingURL=depFrame.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depFrame.js","names":[],"sources":["../../../src/core/scene/depFrame.ts"],"sourcesContent":["/**\n * A dependency's pose in the frame of the node reading it. Under a composing\n * strategy a stored pose is local to its container, so a node deriving from\n * something in another container would otherwise read it in that\n * container's frame and place itself as though the two frames were one.\n */\nimport { boxToBox, multiply, poseFrameInverseOf, poseFrameOf, transformPath, type Affine, type Path } from '@weasel-js/geom';\nimport { composeWorldPose, composesFrames, frameAtOrAbove, type PoseAdapter, type PoseComposition } from './composeFrame';\nimport { derivedPartsOf, pathFromParts } from './derivedParts';\nimport type { NodeId } from './types';\n\n/** The parts of a node the rebase reads. */\ninterface FramedNode {\n  id: NodeId;\n  parent?: NodeId | null;\n}\n\n/** `(depId, pose) => that pose in `reader`'s frame`, or `null` when every\n *  pose is already in one frame — the absolute-pose model. `poseOf` answers\n *  each node's own, local pose. */\nexport function depFrameRebase<TPose>(\n  composition: PoseComposition<TPose> | undefined,\n  reader: FramedNode,\n  get: (id: NodeId) => FramedNode | undefined,\n  poseOf: (id: NodeId) => TPose,\n  definesFrame: (id: NodeId) => boolean,\n): ((depId: NodeId, pose: TPose) => TPose) | null {\n  if (composition === undefined || !composesFrames(composition)) return null;\n  const adapter: PoseAdapter<TPose> = {\n    getPose: (id) => poseOf(id as NodeId),\n    getParent: (id) => get(id as NodeId)?.parent ?? null,\n    definesFrame: (id) => definesFrame(id as NodeId),\n  };\n  const frame = frameAtOrAbove(adapter, reader.parent ?? null);\n  return (depId, pose) => {\n    const own = frameAtOrAbove(adapter, get(depId)?.parent ?? null);\n    if (own === frame) return pose;\n    const world = own === null ? pose : composition.compose(composeWorldPose(adapter, own, composition.compose), pose);\n    return frame === null ? world : composition.decompose(composeWorldPose(adapter, frame, composition.compose), world);\n  };\n}\n\ninterface Box {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nfunction isBox(pose: unknown): pose is Box {\n  const p = pose as Partial<Box> | null;\n  return typeof p === 'object' && p !== null\n    && typeof p.x === 'number' && typeof p.y === 'number'\n    && typeof p.width === 'number' && typeof p.height === 'number';\n}\n\n/**\n * `path`, drawn in the unturned box of a node posed at `from`, as it is drawn\n * in the box of `to`. Whatever turns the box is applied after, by whoever\n * paints it. A pose that is not a box leaves the path where it is.\n */\nexport function carryBoxPath(path: Path, from: unknown, to: unknown): Path {\n  if (!isBox(from) || !isBox(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 carryPathBy(path, boxToBox(from.x, from.y, from.width, from.height, to.x, to.y, to.width, to.height));\n}\n\n/**\n * A dependency's derived `path`, drawn in its own frame, carried into the\n * reader's — the frame change that took its pose `from` to `to`: out of\n * `from`'s turn, {@link carryBoxPath}'s box to box, into `to`'s turn.\n */\nexport function carryDepPath(path: Path, from: unknown, to: unknown): Path {\n  if (!isBox(from) || !isBox(to)) return path;\n  const back = poseFrameInverseOf(from);\n  const fwd = poseFrameOf(to);\n  let m: Affine = boxToBox(from.x, from.y, from.width, from.height, to.x, to.y, to.width, to.height);\n  if (back !== null) m = multiply(m, back);\n  if (fwd !== null) m = multiply(fwd, m);\n  return carryPathBy(path, m);\n}\n\n/**\n * `path`, drawn in the unturned box of a node posed at `box` — where a painter\n * draws, and where a pose override's path is given — as that node is painted\n * posed at `at`: carried box to box, then turned by `at`. Where a derivation\n * reads it, beside `at` as the dependency's pose.\n */\nexport function pathAsPainted(path: Path, box: unknown, at: unknown): Path {\n  if (!isBox(box) || !isBox(at)) return path;\n  const fwd = poseFrameOf(at);\n  const same = box.x === at.x && box.y === at.y && box.width === at.width && box.height === at.height;\n  if (fwd === null && same) return path;\n  const m = boxToBox(box.x, box.y, box.width, box.height, at.x, at.y, at.width, at.height);\n  return carryPathBy(path, fwd === null ? m : multiply(fwd, m));\n}\n\n/** `path` through `m`, keeping its parts. Painted and read every frame, and a\n *  derivation's memo compares the path it read by reference, so the copy is\n *  kept against it. */\nexport function carryPathBy(path: Path, m: Affine): Path {\n  const key = m.join(',');\n  const held = carried.get(path);\n  if (held?.key === key) return held.path;\n  const parts = derivedPartsOf(path);\n  const out = parts === undefined\n    ? transformPath(path, m)\n    : pathFromParts(parts.map((part) => ({ ...part, path: transformPath(part.path, m) })))!;\n  carried.set(path, { key, path: out });\n  return out;\n}\n\nconst carried = new WeakMap<Path, { key: string; path: Path }>();\n"],"mappings":"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"}

package/dist/core/scene/depMemo.js

@@ -1,6 +1,7 @@
-import { samePoseValue as e, snapshotPose as t } from "./poseSnapshot.js";
+import { samePoseValue, snapshotPose } from "./poseSnapshot.js";
+
 //#region src/core/scene/depMemo.ts
-function n() {
+function emptyDepRecord() {
 	return {
 		nodes: [],
 		poses: [],
@@ -9,35 +10,59 @@ function n() {
 		paths: []
 	};
 }
-var r = class {
+/** A dependency as the derivation is handed it, noting a read of its path. A
+*  class for the reason `SceneDep` is one: a prototype accessor is cheap. */
+var RecordedDep = class {
 	dep;
 	paths;
 	index;
 	node;
 	pose;
-	constructor(e, t, n) {
-		this.dep = e, this.paths = t, this.index = n, this.node = e.node, this.pose = e.pose;
+	constructor(dep, paths, index) {
+		this.dep = dep;
+		this.paths = paths;
+		this.index = index;
+		this.node = dep.node;
+		this.pose = dep.pose;
 	}
 	get path() {
 		return this.paths[this.index] = this.dep.path;
 	}
 };
-function i(e, n, i) {
-	return e.nodes.length = 0, e.poses.length = 0, e.data.length = 0, e.layers.length = 0, e.paths.length = 0, i(n.map((n, i) => (e.nodes.push(n?.node), e.poses.push(n === void 0 ? void 0 : t(n.pose)), e.data.push(n?.node.data), e.layers.push(n?.node.layer), e.paths.push(void 0), n === void 0 ? void 0 : new r(n, e.paths, i))));
+/** Run `derive` against `deps`, recording in place what it was run against.
+*  Mutating the record is what updates the memo slot, which holds this object. */
+function deriveRecorded(into, deps, derive) {
+	into.nodes.length = 0;
+	into.poses.length = 0;
+	into.data.length = 0;
+	into.layers.length = 0;
+	into.paths.length = 0;
+	return derive(deps.map((dep, i) => {
+		into.nodes.push(dep?.node);
+		into.poses.push(dep === void 0 ? void 0 : snapshotPose(dep.pose));
+		into.data.push(dep?.node.data);
+		into.layers.push(dep?.node.layer);
+		into.paths.push(void 0);
+		return dep === void 0 ? void 0 : new RecordedDep(dep, into.paths, i);
+	}));
 }
-function a(t, n, r) {
-	if (t.nodes.length !== n.length) return !1;
-	for (let i = 0; i < n.length; i++) {
-		let a = r(n[i]);
-		if (t.nodes[i] !== (a === void 0 ? void 0 : a.node)) return !1;
-		if (a === void 0) continue;
-		if (t.data[i] !== a.node.data || t.layers[i] !== a.node.layer || !e(t.poses[i], a.pose)) return !1;
-		let o = t.paths[i];
-		if (o !== void 0 && o !== a.path) return !1;
+/** Whether the dependencies still resolve to what the record was taken from.
+*  Resolves them one at a time rather than taking an array: this is the hit
+*  path, and it walks every derived node's every dependency on every frame. */
+function sameDeps(record, ids, depOf) {
+	if (record.nodes.length !== ids.length) return false;
+	for (let i = 0; i < ids.length; i++) {
+		const dep = depOf(ids[i]);
+		if (record.nodes[i] !== (dep === void 0 ? void 0 : dep.node)) return false;
+		if (dep === void 0) continue;
+		if (record.data[i] !== dep.node.data || record.layers[i] !== dep.node.layer) return false;
+		if (!samePoseValue(record.poses[i], dep.pose)) return false;
+		const path = record.paths[i];
+		if (path !== void 0 && path !== dep.path) return false;
 	}
-	return !0;
+	return true;
 }
-//#endregion
-export { i as deriveRecorded, n as emptyDepRecord, a as sameDeps };
 
+//#endregion
+export { deriveRecorded, emptyDepRecord, sameDeps };
 //# sourceMappingURL=depMemo.js.map