@weasel-js/core 1.9.4 → 1.10.1

package/dist/canvas/useToolCursor.js

@@ -0,0 +1,29 @@
+import { useLayoutEffect as e } from "react";
+import { resolveCursorTier as t } from "@weasel-js/cursor";
+//#region src/canvas/useToolCursor.ts
+function n(e) {
+	let n = e.hotkeyEngaged ?? e.active, r = n === null ? void 0 : e.registry[n];
+	if (r?.cursor) {
+		if (typeof r.cursor != "function") return t(r.cursor);
+		try {
+			return t(r.cursor());
+		} catch {
+			return;
+		}
+	}
+}
+function r(t, r, i, a) {
+	let o = r ? n(r) : void 0, s = o === void 0 ? "" : o.kind === "css" ? `css|${o.css}` : `${o.glyph}|${o.angle}|${o.size}|${o.worldRadius}`;
+	e(() => {
+		t.setBase(o ?? null, a ?? "");
+	}, [
+		t,
+		s,
+		i,
+		a
+	]);
+}
+//#endregion
+export { r as useToolCursor };
+
+//# sourceMappingURL=useToolCursor.js.map

package/dist/canvas/useToolCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolCursor.js","names":["resolveToolsCursor","id","tools","tool","resolveCursorTier","useToolCursor","tier","key","rest","sink","element"],"sources":["../../src/canvas/useToolCursor.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\nimport { resolveCursorTier, type CursorSink, type ResolvedCursor } from '@weasel-js/cursor';\nimport type { ToolsApi } from '../tools/overlayBinding';\n\nfunction resolveToolsCursor(tools: ToolsApi): ResolvedCursor | undefined {\n  const id = tools.hotkeyEngaged ?? tools.active;\n  const tool = id === null ? undefined : tools.registry[id];\n  if (!tool?.cursor) return undefined;\n  if (typeof tool.cursor !== 'function') return resolveCursorTier(tool.cursor);\n  try {\n    return resolveCursorTier(tool.cursor());\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Writes the active tool's cursor to `sink` as its base, and `rest` (the\n * element's own cursor) for when the tool declares none.\n *\n * `element` is what the sink writes to, named so the base is written again\n * when a detached surface's input element arrives a render late.\n */\nexport function useToolCursor(\n  sink: CursorSink,\n  tools: ToolsApi | undefined,\n  element: HTMLElement | null | undefined,\n  rest: string | undefined,\n): void {\n  const tier = tools ? resolveToolsCursor(tools) : undefined;\n  // Keyed on the value, not the object: the tier is rebuilt every render.\n  const key = tier === undefined\n    ? ''\n    : tier.kind === 'css'\n      ? `css|${tier.css}`\n      : `${tier.glyph}|${tier.angle}|${tier.size}|${tier.worldRadius}`;\n  useLayoutEffect(() => {\n    sink.setBase(tier ?? null, rest ?? '');\n    // `tier` is a fresh object each render; the key is its identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [sink, key, element, rest]);\n}\n"],"mappings":";;;AAIA,SAASA,EAAmB,GAA6C;CACvE,IAAMC,IAAKC,EAAM,iBAAiBA,EAAM,QAClCC,IAAOF,MAAO,OAAO,KAAA,IAAYC,EAAM,SAASD;CACtD,IAAKE,GAAM,QACX;MAAI,OAAOA,EAAK,UAAW,YAAY,OAAOC,EAAkBD,EAAK,MAAM;EAC3E,IAAI;GACF,OAAOC,EAAkBD,EAAK,OAAO,CAAC;EACxC,QAAQ;GACN;EACF;CAL2E;AAM7E;AASA,SAAgBE,EACd,GACA,GACA,GACA,GACM;CACN,IAAMC,IAAOJ,IAAQF,EAAmBE,CAAK,IAAI,KAAA,GAE3CK,IAAMD,MAAS,KAAA,IACjB,KACAA,EAAK,SAAS,QACZ,OAAOA,EAAK,QACZ,GAAGA,EAAK,MAAM,GAAGA,EAAK,MAAM,GAAGA,EAAK,KAAK,GAAGA,EAAK;CACvD,QAAsB;EACpB,EAAK,QAAQA,KAAQ,MAAME,KAAQ,EAAE;CAGvC,GAAG;EAACC;EAAMF;EAAKG;EAASF;CAAI,CAAC;AAC/B"}

package/dist/canvas/useViewHelpers.js

@@ -1,73 +1,41 @@
 import { unionAABB as e } from "../core/geometry/unionBounds.js";
-import { aggregatePreviewIds as t, firstPreviewBounds as n, firstPreviewPose as r, toolPreviewSources as i } from "./toolPreview.js";
-import { buildChromeState as a } from "../core/selection/chromeState.js";
-import { useCallback as o, useMemo as s } from "react";
-import { useLatest as c } from "@weasel-js/react";
+import { framedBounds as t } from "../core/geometry/poseDescriptor.js";
+import { buildChromeState as n } from "../core/selection/chromeState.js";
+import { useCallback as r, useMemo as i } from "react";
+import { useLatest as a } from "@weasel-js/react";
 //#region src/canvas/useViewHelpers.ts
-var l = () => {}, u = () => !0;
-function d(e, t) {
+var o = () => {}, s = () => !0;
+function c(e, t) {
 	return typeof e.getWorldPose == "function" ? e.getWorldPose(t) : e.getPose(t);
 }
-function f(f) {
-	let { adapter: p, geometry: m, boundsOf: h, boundsOfPose: g, selection: _, tools: v, gestureSource: y, previewPoseExtra: b, previewIdsExtra: x, getIsVisible: S } = f, C = o((e, t) => g ? g(e, t) : m.getBounds(t), [g, m]), w = s(() => {
-		if (h) return h;
-		if (p) return (e) => {
+function l(l) {
+	let { adapter: u, geometry: d, boundsOf: f, boundsOfPose: p, selection: m, gestureSource: h, previewPoseExtra: g, getIsVisible: _ } = l, v = r((e, n) => p ? p(e, n) : t(n, d), [p, d]), y = i(() => {
+		if (f) return f;
+		if (u) return (e) => {
 			try {
-				let t = d(p, e), n = m.getBounds(t), r = m.getRotation?.(t);
-				return r ? {
-					...n,
-					rotation: r
-				} : n;
+				return t(c(u, e), d);
 			} catch {
 				return null;
 			}
 		};
 	}, [
-		h,
-		p,
-		m
-	]), T = o((e) => {
-		if (!p) return null;
+		f,
+		u,
+		d
+	]), b = r((e) => {
+		if (!u) return null;
 		try {
-			return d(p, e);
+			return c(u, e);
 		} catch {
 			return null;
 		}
-	}, [p]), E = _.length > 1, D = c({
-		previewPoseExtra: b,
-		previewIdsExtra: x
-	}), O = s(() => h ?? w, [h, w]), k = o((e) => {
-		if (v) {
-			let t = r(v, e);
-			if (t != null) return t;
-		}
-		let t = D.current.previewPoseExtra;
-		if (t) {
-			let n = t(e);
-			if (n != null) return n;
-		}
-		return null;
-	}, [v, D]), A = o((e) => {
-		if (v) {
-			let t = n(v, e);
-			if (t) return t;
-			let i = r(v, e);
-			if (i != null) return C(e, i);
-		}
-		let t = D.current.previewPoseExtra;
-		if (t) {
-			let n = t(e);
-			if (n != null) return C(e, n);
-		}
-		return null;
-	}, [
-		v,
-		C,
-		D
-	]), j = o((e) => A(e) || (O ? O(e) : null), [A, O]), M = s(() => a({
-		selection: _,
-		multiActive: E,
-		effectiveBoundsOf: j,
+	}, [u]), x = m.length > 1, S = a(g), C = i(() => f ?? y, [f, y]), w = r((e) => S.current?.(e) ?? null, [S]), T = r((e) => {
+		let t = w(e);
+		return t == null ? null : v(e, t);
+	}, [w, v]), E = r((e) => T(e) || (C ? C(e) : null), [T, C]), D = i(() => n({
+		selection: m,
+		multiActive: x,
+		effectiveBoundsOf: E,
 		modifiers: {
 			alt: !1,
 			shift: !1,
@@ -75,46 +43,39 @@ function f(f) {
 			ctrl: !1
 		},
 		canRotate: (e) => {
-			if (!m.supportsRotation) return !0;
-			let t = T(e);
-			return t == null || m.supportsRotation(t);
+			if (!d.supportsRotation) return !0;
+			let t = b(e);
+			return t == null || d.supportsRotation(t);
 		}
 	}), [
-		_,
-		E,
-		j,
 		m,
-		T
+		x,
+		E,
+		d,
+		b
 	]);
 	return {
 		helpers: {
-			getEffectivePose: (e) => k(e) ?? T(e),
-			getEffectiveBounds: j,
+			getEffectivePose: (e) => w(e) ?? b(e),
+			getEffectiveBounds: E,
 			getGestureBounds: () => {
-				let n = t(v), r = y?.ids();
-				if (r) for (let e of r) n.add(e);
-				let i = [];
-				for (let e of n) i.push(A(e));
-				let a = y?.bounds();
-				if (a) for (let e of a) i.push(e);
-				return e(i);
+				let t = [];
+				for (let e of new Set(h?.ids() ?? [])) t.push(T(e));
+				let n = h?.bounds();
+				if (n) for (let e of n) t.push(e);
+				return e(t);
 			},
-			subscribeGestures: (e) => y?.subscribe(e) ?? l,
-			getGestureVersion: () => y?.getVersion() ?? 0,
-			getChromeState: () => M,
-			getPreviewSources: () => [...i(v), ...y?.previewSources() ?? []],
-			getGestureOverlays: () => y?.overlays() ?? [],
-			getIsVisible: () => S?.() ?? u
+			subscribeGestures: (e) => h?.subscribe(e) ?? o,
+			getGestureVersion: () => h?.getVersion() ?? 0,
+			getChromeState: () => D,
+			getPreviewSources: () => h?.previewSources() ?? [],
+			getGestureOverlays: () => h?.overlays() ?? [],
+			getIsVisible: () => _?.() ?? s
 		},
-		chromeState: M,
-		committedPoseOf: T,
-		effectiveBoundsOf: O,
-		previewToolPose: k,
-		previewToolBounds: A,
-		previewExtraRef: D
+		chromeState: D
 	};
 }
 //#endregion
-export { f as useViewHelpers };
+export { l as useViewHelpers };
 
 //# sourceMappingURL=useViewHelpers.js.map

package/dist/canvas/useViewHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"useViewHelpers.js","names":["noOpUnsubscribe","alwaysVisible","worldPoseOf","adapter","id","useViewHelpers","opts","boxOf","useCallback","boundsOfPose","pose","geometry","baseBoundsOf","useMemo","boundsOf","b","rot","committedPoseOf","multiActive","selection","previewExtraRef","useLatest","effectiveBoundsOf","previewToolPose","tools","p","firstPreviewPose","extra","previewToolBounds","firstPreviewBounds","boundsWithPreview","chromeState","buildChromeState","ids","aggregatePreviewIds","extraIds","gestureSource","parts","extraBounds","unionAABB","fn","toolPreviewSources","getIsVisible"],"sources":["../../src/canvas/useViewHelpers.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { firstPreviewPose, firstPreviewBounds, aggregatePreviewIds, toolPreviewSources } from './toolPreview';\nimport type { GestureSource, GesturePreviewSource } from './gestureBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport { unionAABB } from 'core/geometry/unionBounds';\nimport { buildChromeState, type ChromeState } from 'core/selection/chromeState';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { NodeId } from 'core/scene/types';\nimport type { ToolsApi } from '../tools/overlayBinding';\nimport type { DebugSink } from '../debug/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\nconst noOpUnsubscribe = (): void => {};\n\nconst alwaysVisible = (): boolean => true;\n\n/**\n * The half of {@link CanvasHelpers} that belongs to one view — everything\n * answered by a camera's own tools, gestures and selection. A canvas hosting\n * several viewports needs one of these per view; the surface half is shared.\n */\nexport interface CanvasViewHelpers<TPose> {\n  /** Pose currently displayed for `id` — drag/resize/rotate overlay if active,\n   *  otherwise the committed pose from the adapter. Returns `null` if the id\n   *  isn't known. */\n  getEffectivePose(id: string): TPose | null;\n  /** Overlay-aware bounds for `id`. */\n  getEffectiveBounds(id: string): Bounds | null;\n  /**\n   * World-space AABB of everything the in-flight gesture proposes — the\n   * displaced poses of nodes being moved / resized / rotated / cloned, plus\n   * any nascent insert that has no scene node yet. `null` when no gesture is\n   * in flight.\n   *\n   * This reports the *gesture*, not the document: committed content the\n   * gesture isn't touching is excluded, so a consumer that wants the union\n   * with the rest of the scene still walks its own ids through\n   * `getEffectiveBounds`. It exists because every other lookup here is keyed\n   * by node id, which can't answer \"where is the shape the user is drawing\n   * right now\" — a drag-to-insert has no id until pointer-up.\n   *\n   * Select-only gestures are deliberately excluded: a marquee or lasso has\n   * geometry but proposes no content, and a consumer sizing itself to the\n   * gesture must not grow because the user swept a selection rectangle.\n   *\n   * The result is a plain AABB — never rotated. Rotated parts are folded in\n   * by their rotated extent (a union of several oriented boxes has no single\n   * orientation to report).\n   */\n  getGestureBounds(): Bounds | null;\n  /**\n   * Subscribe to the gesture layer's change signal — the other half of the\n   * `useSyncExternalStore` contract for everything on this object that moves\n   * during a drag (`getEffectivePose`, `getEffectiveBounds`,\n   * `getGestureBounds`). Returns an unsubscribe.\n   *\n   * Fires once per dispatcher pump: gesture start, every pointermove that\n   * reaches an in-flight handle, end, and cancel — plus UI-driven ongoing\n   * actions (a slider bound to an ongoing action pumps the same way). It\n   * fires on the pump, not on a diff: a pump that changed nothing observable\n   * still notifies, so don't hang expensive work directly off the callback.\n   *\n   * It does **not** cover committed scene edits (subscribe to the scene for\n   * those) or previews a consumer's own tool publishes from React state\n   * (that tool re-renders on its own).\n   *\n   * Without a gesture source wired — a bare `<Canvas>` — this is a no-op\n   * subscription that never fires.\n   */\n  subscribeGestures(fn: () => void): () => void;\n  /**\n   * Monotonic counter bumped on exactly the events `subscribeGestures` fires\n   * on. Pair the two for `useSyncExternalStore`:\n   *\n   * ```ts\n   * const gestureVersion = useSyncExternalStore(\n   *   useCallback((cb) => helpersRef.current?.subscribeGestures(cb) ?? (() => {}), []),\n   *   () => helpersRef.current?.getGestureVersion() ?? 0,\n   * );\n   * ```\n   *\n   * Starts at 0 and only increases. `0` is also what a bare `<Canvas>` with\n   * no gesture source reports, forever.\n   */\n  getGestureVersion(): number;\n  /** Returns the live ChromeState built once per render. Affordances and\n   *  custom layers that need overlay-aware selection state (selection ids,\n   *  bounds, multi-union AABB, modifier flags) read from this. */\n  getChromeState(): ChromeState;\n  /**\n   * Everything publishing an in-flight preview for this view, in resolution\n   * order: tool-side first (hotkey → active → registry → ambient), then the\n   * handles in flight on this view's dispatcher. Readers take the first\n   * non-null answer per id.\n   *\n   * A ghost layer must read this off its draw envelope rather than close over\n   * a dispatcher: one layer array paints every view, so a closure ghosts view\n   * zero's drag into every panel.\n   */\n  getPreviewSources(): readonly GesturePreviewSource[];\n  /** Overlay shapes this view's in-flight handles publish — marquee, lasso,\n   *  insert preview, raw commands. Same envelope rule as\n   *  {@link CanvasViewHelpers.getPreviewSources}. */\n  getGestureOverlays(): readonly OngoingOverlay[];\n  /**\n   * Chrome-caps visibility predicate, keyed by chrome id. Overlay layers and\n   * affordances call it per element to decide whether to draw / hit-test.\n   *\n   * The rule table is the surface's; the context it resolves against is this\n   * view's selection, camera and in-flight action — so the predicate belongs\n   * here rather than on {@link CanvasSurfaceHelpers}. Unwired, it is the\n   * universal `() => true`.\n   */\n  getIsVisible(): (id: string) => boolean;\n}\n\n/**\n * The half of {@link CanvasHelpers} that belongs to the surface — one GL\n * context, one debug sink, however many views are drawn on it.\n */\nexport interface CanvasSurfaceHelpers {\n  /** Active debug sink, when `<Canvas debug=...>` is enabled. Layers that\n   *  want to participate in `hitboxes`/`bounds`/etc. visualization can\n   *  call into this from their `draw` callback. Returns `null` when\n   *  debug is off — no-op for production renders. */\n  getDebug(): DebugSink | null;\n}\n\n/** Live overlay-aware lookups exposed to custom layers via `helpersRef`.\n *  What a layer receives as its `data` argument, unchanged: the two halves\n *  are split so a per-view set can be built independently of the surface's,\n *  not to make layers ask for one. */\nexport interface CanvasHelpers<TPose> extends CanvasViewHelpers<TPose>, CanvasSurfaceHelpers {\n  /**\n   * The view this draw is for: a `<CanvasView>` id, or `null` for the\n   * surface's own camera. One layer array paints every view, so a layer that\n   * belongs in some views and not others — a minimap's indicator — declines\n   * the rest by this id.\n   */\n  readonly viewId: string | null;\n}\n\nexport interface UseViewHelpersOpts<TPose> {\n  /** Only `getPose` is read here — the narrow slice keeps this hook off the\n   *  full adapter contract. */\n  adapter: { getPose(id: string): TPose } | undefined;\n  geometry: PoseDescriptor<TPose>;\n  /** Consumer-supplied bounds resolver. Falls back to the adapter's pose. */\n  boundsOf: ((id: string) => Bounds | null) | undefined;\n  /** Bounds of `id` drawn at an in-flight `pose`. Falls back to the\n   *  geometry's box of that pose, which is wrong wherever the surface draws a\n   *  node somewhere its pose does not say — a parallax plane. */\n  boundsOfPose?: ((id: string, pose: TPose) => Bounds | null) | undefined;\n  selection: readonly NodeId[];\n  tools: ToolsApi | undefined;\n  gestureSource: GestureSource | undefined;\n  /** Dispatcher-published preview overlays, read through a ref so a change\n   *  mid-gesture doesn't rebuild the memos that depend on them. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  previewIdsExtra: (() => Iterable<string> | null) | undefined;\n  /** Chrome-caps predicate for this view. Absent means everything is visible. */\n  getIsVisible?: (() => (id: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\n  chromeState: ChromeState;\n  /** Committed pose straight from the adapter, no overlay applied. */\n  committedPoseOf(id: string): TPose | null;\n  /** Bounds resolver after the `boundsOf` / adapter fallback, before previews. */\n  effectiveBoundsOf: ((id: string) => Bounds | null) | undefined;\n  previewToolPose(id: string): TPose | null;\n  previewToolBounds(id: string): Bounds | null;\n  /** Live dispatcher preview extras, for callers outside this bundle. */\n  previewExtraRef: React.MutableRefObject<{\n    previewPoseExtra: ((id: string) => unknown) | undefined;\n    previewIdsExtra: (() => Iterable<string> | null) | undefined;\n  }>;\n}\n\n/**\n * Build one view's overlay-aware state: its chrome and the lookups its layers\n * draw and hit-test against.\n *\n * This is a hook, so it runs once per component. That is the point — N views\n * cannot be a loop inside one component, but they can be N components each\n * calling this once.\n */\n/** The composed pose when the adapter resolves one, its stored pose otherwise.\n *  Adapters predating `getWorldPose` are absolute-pose, where the two agree. */\nfunction worldPoseOf<TPose>(\n  adapter: { getPose(id: string): TPose; getWorldPose?(id: string): TPose },\n  id: string,\n): TPose {\n  return typeof adapter.getWorldPose === 'function' ? adapter.getWorldPose(id) : adapter.getPose(id);\n}\n\nexport function useViewHelpers<TPose>(\n  opts: UseViewHelpersOpts<TPose>,\n): ViewHelpersBundle<TPose> {\n  const {\n    adapter, geometry, boundsOf, boundsOfPose, selection, tools, gestureSource,\n    previewPoseExtra, previewIdsExtra, getIsVisible,\n  } = opts;\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : geometry.getBounds(pose)),\n    [boundsOfPose, geometry],\n  );\n\n  const baseBoundsOf = useMemo(() => {\n    if (boundsOf) return boundsOf;\n    if (!adapter) return undefined;\n    return (id: string): Bounds | null => {\n      try {\n        // World: chrome is drawn over the picture, so it has to agree with\n        // where the renderer put the node, not with where its pose is stored.\n        const pose = worldPoseOf(adapter, id);\n        const b = geometry.getBounds(pose);\n        const rot = geometry.getRotation?.(pose);\n        return rot ? { ...b, rotation: rot } : b;\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, geometry]);\n\n  const committedPoseOf = useCallback((id: string): TPose | null => {\n    if (!adapter) return null;\n    try {\n      return worldPoseOf(adapter, id);\n    } catch {\n      return null;\n    }\n  }, [adapter]);\n\n  const multiActive = selection.length > 1;\n\n  const previewExtraRef = useLatest({ previewPoseExtra, previewIdsExtra });\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n\n  // The live overlay a gesture proposes for `id`: the active tool's published\n  // preview first, then the dispatcher's preview extras. `null` when nothing\n  // is mid-gesture — callers fall through to committed state.\n  const previewToolPose = useCallback((id: string): TPose | null => {\n    if (tools) {\n      const p = firstPreviewPose(tools, id);\n      if (p != null) return p as TPose;\n    }\n    const extra = previewExtraRef.current.previewPoseExtra;\n    if (extra) {\n      const p = extra(id);\n      if (p != null) return p as TPose;\n    }\n    return null;\n  }, [tools, previewExtraRef]);\n  const previewToolBounds = useCallback((id: string): Bounds | null => {\n    if (tools) {\n      const b = firstPreviewBounds(tools, id);\n      if (b) return b;\n      const p = firstPreviewPose(tools, id);\n      if (p != null) return boxOf(id, p as TPose);\n    }\n    const extra = previewExtraRef.current.previewPoseExtra;\n    if (extra) {\n      const p = extra(id);\n      if (p != null) return boxOf(id, p as TPose);\n    }\n    return null;\n  }, [tools, boxOf, previewExtraRef]);\n\n  /**\n   * Bounds for `id` with any in-flight gesture folded in — what the user can\n   * see, not what is committed. Both the chrome state and the layer helpers\n   * answer bounds questions with this, so resize handles cannot end up a frame\n   * away from the shape they belong to.\n   */\n  const boundsWithPreview = useCallback((id: string): Bounds | null => {\n    const previewed = previewToolBounds(id);\n    if (previewed) return previewed;\n    return effectiveBoundsOf ? effectiveBoundsOf(id) : null;\n  }, [previewToolBounds, effectiveBoundsOf]);\n\n  const chromeState: ChromeState = useMemo(\n    () => buildChromeState({\n      selection,\n      multiActive,\n      effectiveBoundsOf: boundsWithPreview,\n      modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n      // Rotation-capability predicate. Reads the committed pose (gestures\n      // don't change descriptor capability) and asks the geometry. Absent\n      // adapter / unknown ids fall back to `true` so the affordance stays\n      // visible — preserves pre-existing behavior for consumers that wire\n      // bounds without an adapter.\n      canRotate: (id) => {\n        if (!geometry.supportsRotation) return true;\n        const pose = committedPoseOf(id);\n        if (pose == null) return true;\n        return geometry.supportsRotation(pose);\n      },\n    }),\n    [selection, multiActive, boundsWithPreview, geometry, committedPoseOf],\n  );\n\n  const helpers: CanvasViewHelpers<TPose> = {\n    getEffectivePose: (id: string): TPose | null => {\n      const tp = previewToolPose(id);\n      if (tp != null) return tp;\n      return committedPoseOf(id);\n    },\n    getEffectiveBounds: boundsWithPreview,\n    getGestureBounds: (): Bounds | null => {\n      // In-flight ids come from both preview sources the ghost layer walks:\n      // tool-published `previewIds()` and the dispatcher's in-flight handles\n      // (via `gestureSource.ids()`). Using the same sets keeps this from\n      // disagreeing with what the user sees ghosted.\n      const ids = aggregatePreviewIds(tools);\n      const extraIds = gestureSource?.ids();\n      if (extraIds) for (const id of extraIds) ids.add(id);\n\n      const parts: (Bounds | null)[] = [];\n      for (const id of ids) parts.push(previewToolBounds(id));\n      // Nascent inserts have no id to look up — they arrive as ready-made\n      // world AABBs.\n      const extraBounds = gestureSource?.bounds();\n      if (extraBounds) for (const b of extraBounds) parts.push(b);\n      return unionAABB(parts);\n    },\n    subscribeGestures: (fn: () => void): (() => void) =>\n      gestureSource?.subscribe(fn) ?? noOpUnsubscribe,\n    getGestureVersion: (): number => gestureSource?.getVersion() ?? 0,\n    getChromeState: () => chromeState,\n    getPreviewSources: (): readonly GesturePreviewSource[] => [\n      ...toolPreviewSources(tools),\n      ...(gestureSource?.previewSources() ?? []),\n    ],\n    getGestureOverlays: (): readonly OngoingOverlay[] => gestureSource?.overlays() ?? [],\n    getIsVisible: (): ((id: string) => boolean) => getIsVisible?.() ?? alwaysVisible,\n  };\n\n  return {\n    helpers,\n    chromeState,\n    committedPoseOf,\n    effectiveBoundsOf,\n    previewToolPose,\n    previewToolBounds,\n    previewExtraRef,\n  };\n}\n"],"mappings":";;;;;;AAaA,IAAMA,UAA8B,CAAC,GAE/BC,UAA+B;AAgLrC,SAASC,EACP,GACA,GACO;CACP,OAAO,OAAOC,EAAQ,gBAAiB,aAAaA,EAAQ,aAAaC,CAAE,IAAID,EAAQ,QAAQC,CAAE;AACnG;AAEA,SAAgBC,EACd,GAC0B;CAC1B,IAAM,EACJ,YAAS,aAAU,aAAU,iBAAc,cAAW,UAAO,kBAC7D,qBAAkB,oBAAiB,oBACjCC,GACEC,IAAQC,GACX,GAAY,MACVC,IAAeA,EAAaL,GAAIM,CAAI,IAAIC,EAAS,UAAUD,CAAI,GAClE,CAACD,GAAcE,CAAQ,CACzB,GAEMC,IAAeC,QAAc;EACjC,IAAIC,GAAU,OAAOA;EACrB,IAAKX,GACL,QAAQ,MAA8B;GACpC,IAAI;IAGF,IAAMO,IAAOR,EAAYC,GAASC,CAAE,GAC9BW,IAAIJ,EAAS,UAAUD,CAAI,GAC3BM,IAAML,EAAS,cAAcD,CAAI;IACvC,OAAOM,IAAM;KAAE,GAAGD;KAAG,UAAUC;IAAI,IAAID;GACzC,QAAQ;IACN,OAAO;GACT;EACF;CACF,GAAG;EAACD;EAAUX;EAASQ;CAAQ,CAAC,GAE1BM,IAAkBT,GAAa,MAA6B;EAChE,IAAI,CAACL,GAAS,OAAO;EACrB,IAAI;GACF,OAAOD,EAAYC,GAASC,CAAE;EAChC,QAAQ;GACN,OAAO;EACT;CACF,GAAG,CAACD,CAAO,CAAC,GAENe,IAAcC,EAAU,SAAS,GAEjCC,IAAkBC,EAAU;EAAE;EAAkB;CAAgB,CAAC,GAEjEC,IAAoBT,QAAcC,KAAYF,GAAc,CAACE,GAAUF,CAAY,CAAC,GAKpFW,IAAkBf,GAAa,MAA6B;EAChE,IAAIgB,GAAO;GACT,IAAMC,IAAIC,EAAiBF,GAAOpB,CAAE;GACpC,IAAIqB,KAAK,MAAM,OAAOA;EACxB;EACA,IAAME,IAAQP,EAAgB,QAAQ;EACtC,IAAIO,GAAO;GACT,IAAMF,IAAIE,EAAMvB,CAAE;GAClB,IAAIqB,KAAK,MAAM,OAAOA;EACxB;EACA,OAAO;CACT,GAAG,CAACD,GAAOJ,CAAe,CAAC,GACrBQ,IAAoBpB,GAAa,MAA8B;EACnE,IAAIgB,GAAO;GACT,IAAMT,IAAIc,EAAmBL,GAAOpB,CAAE;GACtC,IAAIW,GAAG,OAAOA;GACd,IAAMU,IAAIC,EAAiBF,GAAOpB,CAAE;GACpC,IAAIqB,KAAK,MAAM,OAAOlB,EAAMH,GAAIqB,CAAU;EAC5C;EACA,IAAME,IAAQP,EAAgB,QAAQ;EACtC,IAAIO,GAAO;GACT,IAAMF,IAAIE,EAAMvB,CAAE;GAClB,IAAIqB,KAAK,MAAM,OAAOlB,EAAMH,GAAIqB,CAAU;EAC5C;EACA,OAAO;CACT,GAAG;EAACD;EAAOjB;EAAOa;CAAe,CAAC,GAQ5BU,IAAoBtB,GAAa,MACnBoB,EAAkBxB,CAChC,MACGkB,IAAoBA,EAAkBlB,CAAE,IAAI,OAClD,CAACwB,GAAmBN,CAAiB,CAAC,GAEnCS,IAA2BlB,QACzBmB,EAAiB;EACrB;EACA;EACA,mBAAmBF;EACnB,WAAW;GAAE,KAAK;GAAO,OAAO;GAAO,MAAM;GAAO,MAAM;EAAM;EAMhE,YAAY,MAAO;GACjB,IAAI,CAACnB,EAAS,kBAAkB,OAAO;GACvC,IAAMD,IAAOO,EAAgBb,CAAE;GAE/B,OADIM,KAAQ,QACLC,EAAS,iBAAiBD,CAAI;EACvC;CACF,CAAC,GACD;EAACS;EAAWD;EAAaY;EAAmBnB;EAAUM;CAAe,CACvE;CAsCA,OAAO;EACL,SAAA;GApCA,mBAAmB,MACNM,EAAgBnB,CACvB,KACGa,EAAgBb,CAAE;GAE3B,oBAAoB0B;GACpB,wBAAuC;IAKrC,IAAMG,IAAMC,EAAoBV,CAAK,GAC/BW,IAAWC,GAAe,IAAI;IACpC,IAAID,GAAU,KAAK,IAAM/B,KAAM+B,GAAU,EAAI,IAAI/B,CAAE;IAEnD,IAAMiC,IAA2B,CAAC;IAClC,KAAK,IAAMjC,KAAM6B,GAAK,EAAM,KAAKL,EAAkBxB,CAAE,CAAC;IAGtD,IAAMkC,IAAcF,GAAe,OAAO;IAC1C,IAAIE,GAAa,KAAK,IAAMvB,KAAKuB,GAAa,EAAM,KAAKvB,CAAC;IAC1D,OAAOwB,EAAUF,CAAK;GACxB;GACA,oBAAoB,MAClBD,GAAe,UAAUI,CAAE,KAAKxC;GAClC,yBAAiCoC,GAAe,WAAW,KAAK;GAChE,sBAAsBL;GACtB,yBAA0D,CACxD,GAAGU,EAAmBjB,CAAK,GAC3B,GAAIY,GAAe,eAAe,KAAK,CAAC,CAC1C;GACA,0BAAqDA,GAAe,SAAS,KAAK,CAAC;GACnF,oBAA+CM,IAAe,KAAKzC;EAInE;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"useViewHelpers.js","names":["noOpUnsubscribe","alwaysVisible","worldPoseOf","adapter","id","useViewHelpers","opts","boxOf","useCallback","boundsOfPose","pose","framedBounds","geometry","baseBoundsOf","useMemo","boundsOf","committedPoseOf","multiActive","selection","previewPoseExtraRef","useLatest","previewPoseExtra","effectiveBoundsOf","previewPoseOf","previewBoundsOf","p","boundsWithPreview","chromeState","buildChromeState","parts","gestureSource","extraBounds","b","unionAABB","fn","getIsVisible"],"sources":["../../src/canvas/useViewHelpers.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { framedBounds } from 'core/geometry/poseDescriptor';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource, GesturePreviewSource } from './gestureBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport { unionAABB } from 'core/geometry/unionBounds';\nimport { buildChromeState, type ChromeState } from 'core/selection/chromeState';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { NodeId } from 'core/scene/types';\nimport type { DebugSink } from '../debug/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\nconst noOpUnsubscribe = (): void => {};\n\nconst alwaysVisible = (): boolean => true;\n\n/**\n * The half of {@link CanvasHelpers} that belongs to one view — everything\n * answered by a camera's own tools, gestures and selection. A canvas hosting\n * several viewports needs one of these per view; the surface half is shared.\n */\nexport interface CanvasViewHelpers<TPose> {\n  /** Pose currently displayed for `id` — drag/resize/rotate overlay if active,\n   *  otherwise the committed pose from the adapter. Returns `null` if the id\n   *  isn't known. */\n  getEffectivePose(id: string): TPose | null;\n  /** Overlay-aware bounds for `id`. */\n  getEffectiveBounds(id: string): Bounds | null;\n  /**\n   * World-space AABB of everything the in-flight gesture proposes — the\n   * displaced poses of nodes being moved / resized / rotated / cloned, plus\n   * any nascent insert that has no scene node yet. `null` when no gesture is\n   * in flight.\n   *\n   * This reports the *gesture*, not the document: committed content the\n   * gesture isn't touching is excluded. Select-only gestures are excluded\n   * too: a marquee or lasso has geometry but proposes no content.\n   *\n   * The result is a plain AABB — never rotated. Rotated parts are folded in\n   * by their rotated extent.\n   */\n  getGestureBounds(): Bounds | null;\n  /**\n   * Subscribe to the gesture layer's change signal, for everything on this\n   * object that moves during a drag (`getEffectivePose`, `getEffectiveBounds`,\n   * `getGestureBounds`). Returns an unsubscribe.\n   *\n   * Fires once per dispatcher pump: gesture start, every pointermove that\n   * reaches an in-flight handle, end, and cancel — plus UI-driven ongoing\n   * actions. It fires on the pump, not on a diff: a pump that changed nothing\n   * observable still notifies, so don't hang expensive work directly off the\n   * callback.\n   *\n   * It does **not** cover committed scene edits (subscribe to the scene for\n   * those) or previews a consumer's own tool publishes from React state.\n   * Without a gesture source wired — a bare `<Canvas>` — it never fires.\n   */\n  subscribeGestures(fn: () => void): () => void;\n  /**\n   * Monotonic counter bumped on exactly the events `subscribeGestures` fires\n   * on. Pair the two for `useSyncExternalStore`:\n   *\n   * ```ts\n   * const gestureVersion = useSyncExternalStore(\n   *   useCallback((cb) => helpersRef.current?.subscribeGestures(cb) ?? (() => {}), []),\n   *   () => helpersRef.current?.getGestureVersion() ?? 0,\n   * );\n   * ```\n   *\n   * Starts at 0 and only increases. `0` is also what a bare `<Canvas>` with\n   * no gesture source reports, forever.\n   */\n  getGestureVersion(): number;\n  /** The live ChromeState built once per render: overlay-aware selection\n   *  state for affordances and custom layers. */\n  getChromeState(): ChromeState;\n  /**\n   * Everything publishing an in-flight preview for this view: the handles in\n   * flight on its dispatcher, in dispatch order. Readers take the first\n   * non-null answer per id.\n   *\n   * A ghost layer must read this off its draw envelope rather than close over\n   * a dispatcher: one layer array paints every view, so a closure ghosts view\n   * zero's drag into every panel.\n   */\n  getPreviewSources(): readonly GesturePreviewSource[];\n  /** Overlay shapes this view's in-flight handles publish — marquee, lasso,\n   *  insert preview, raw commands. Same envelope rule as\n   *  {@link CanvasViewHelpers.getPreviewSources}. */\n  getGestureOverlays(): readonly OngoingOverlay[];\n  /**\n   * Chrome-caps visibility predicate, keyed by chrome id. Overlay layers and\n   * affordances call it per element to decide whether to draw / hit-test.\n   * Unwired, it is the universal `() => true`.\n   */\n  getIsVisible(): (id: string) => boolean;\n}\n\n/**\n * The half of {@link CanvasHelpers} that belongs to the surface — one GL\n * context, one debug sink, however many views are drawn on it.\n */\nexport interface CanvasSurfaceHelpers {\n  /** Active debug sink, when `<Canvas debug=...>` is enabled, for layers to\n   *  call from their `draw` callback. `null` when debug is off. */\n  getDebug(): DebugSink | null;\n}\n\n/** Live overlay-aware lookups exposed to custom layers via `helpersRef`, and\n *  what a layer receives as its `data` argument. */\nexport interface CanvasHelpers<TPose> extends CanvasViewHelpers<TPose>, CanvasSurfaceHelpers {\n  /**\n   * The view this draw is for: a `<CanvasView>` id, or `null` for the\n   * surface's own camera. One layer array paints every view, so a layer that\n   * belongs in some views and not others — a minimap's indicator — declines\n   * the rest by this id.\n   */\n  readonly viewId: string | null;\n}\n\n/** What a view's pose and bounds lookups read of an adapter. */\nexport interface ViewPoseAdapter<TPose> {\n  getPose(id: string): TPose;\n  /** Where the node is drawn, when the adapter composes poses. An adapter\n   *  without it stores absolute poses, where the two agree. */\n  getWorldPose?(id: string): TPose;\n}\n\nexport interface UseViewHelpersOpts<TPose> {\n  adapter: ViewPoseAdapter<TPose> | undefined;\n  geometry: PoseDescriptor<TPose>;\n  /** Consumer-supplied bounds resolver. Falls back to the adapter's pose. */\n  boundsOf: ((id: string) => Bounds | null) | undefined;\n  /** Bounds of `id` drawn at an in-flight `pose`. Falls back to the\n   *  geometry's box of that pose, which is wrong wherever the surface draws a\n   *  node somewhere its pose does not say — a parallax plane. */\n  boundsOfPose?: ((id: string, pose: TPose) => Bounds | null) | undefined;\n  selection: readonly NodeId[];\n  gestureSource: GestureSource | undefined;\n  /** The dispatcher's preview pose for an id, read through a ref so a change\n   *  mid-gesture doesn't rebuild the memos that depend on it. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  /** Chrome-caps predicate for this view. Absent means everything is visible. */\n  getIsVisible?: (() => (id: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\n  chromeState: ChromeState;\n}\n\nfunction worldPoseOf<TPose>(adapter: ViewPoseAdapter<TPose>, id: string): TPose {\n  return typeof adapter.getWorldPose === 'function' ? adapter.getWorldPose(id) : adapter.getPose(id);\n}\n\n/**\n * Build one view's overlay-aware state: its chrome and the lookups its layers\n * draw and hit-test against. A canvas with N views mounts N components each\n * calling this once.\n */\nexport function useViewHelpers<TPose>(\n  opts: UseViewHelpersOpts<TPose>,\n): ViewHelpersBundle<TPose> {\n  const {\n    adapter, geometry, boundsOf, boundsOfPose, selection, gestureSource,\n    previewPoseExtra, getIsVisible,\n  } = opts;\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : framedBounds(pose, geometry)),\n    [boundsOfPose, geometry],\n  );\n\n  const baseBoundsOf = useMemo(() => {\n    if (boundsOf) return boundsOf;\n    if (!adapter) return undefined;\n    return (id: string): Bounds | null => {\n      try {\n        // World: chrome is drawn over the picture, so it has to agree with\n        // where the renderer put the node, not with where its pose is stored.\n        return framedBounds(worldPoseOf(adapter, id), geometry);\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, geometry]);\n\n  const committedPoseOf = useCallback((id: string): TPose | null => {\n    if (!adapter) return null;\n    try {\n      return worldPoseOf(adapter, id);\n    } catch {\n      return null;\n    }\n  }, [adapter]);\n\n  const multiActive = selection.length > 1;\n\n  const previewPoseExtraRef = useLatest(previewPoseExtra);\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n\n  const previewPoseOf = useCallback((id: string): TPose | null => {\n    const p = previewPoseExtraRef.current?.(id);\n    return p != null ? (p as TPose) : null;\n  }, [previewPoseExtraRef]);\n  const previewBoundsOf = useCallback((id: string): Bounds | null => {\n    const p = previewPoseOf(id);\n    return p != null ? boxOf(id, p) : null;\n  }, [previewPoseOf, boxOf]);\n\n  /**\n   * Bounds for `id` with any in-flight gesture folded in — what the user can\n   * see, not what is committed. Both the chrome state and the layer helpers\n   * answer bounds questions with this, so resize handles cannot end up a frame\n   * away from the shape they belong to.\n   */\n  const boundsWithPreview = useCallback((id: string): Bounds | null => {\n    const previewed = previewBoundsOf(id);\n    if (previewed) return previewed;\n    return effectiveBoundsOf ? effectiveBoundsOf(id) : null;\n  }, [previewBoundsOf, effectiveBoundsOf]);\n\n  const chromeState: ChromeState = useMemo(\n    () => buildChromeState({\n      selection,\n      multiActive,\n      effectiveBoundsOf: boundsWithPreview,\n      modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n      // Absent adapter / unknown ids fall back to `true` so the affordance\n      // stays visible for consumers that wire bounds without an adapter.\n      canRotate: (id) => {\n        if (!geometry.supportsRotation) return true;\n        const pose = committedPoseOf(id);\n        if (pose == null) return true;\n        return geometry.supportsRotation(pose);\n      },\n    }),\n    [selection, multiActive, boundsWithPreview, geometry, committedPoseOf],\n  );\n\n  const helpers: CanvasViewHelpers<TPose> = {\n    getEffectivePose: (id: string): TPose | null => {\n      return previewPoseOf(id) ?? committedPoseOf(id);\n    },\n    getEffectiveBounds: boundsWithPreview,\n    getGestureBounds: (): Bounds | null => {\n      // The same id sets the ghost layer walks, so this cannot disagree with\n      // what the user sees ghosted.\n      const parts: (Bounds | null)[] = [];\n      for (const id of new Set(gestureSource?.ids() ?? [])) parts.push(previewBoundsOf(id));\n      const extraBounds = gestureSource?.bounds();\n      if (extraBounds) for (const b of extraBounds) parts.push(b);\n      return unionAABB(parts);\n    },\n    subscribeGestures: (fn: () => void): (() => void) =>\n      gestureSource?.subscribe(fn) ?? noOpUnsubscribe,\n    getGestureVersion: (): number => gestureSource?.getVersion() ?? 0,\n    getChromeState: () => chromeState,\n    getPreviewSources: (): readonly GesturePreviewSource[] => gestureSource?.previewSources() ?? [],\n    getGestureOverlays: (): readonly OngoingOverlay[] => gestureSource?.overlays() ?? [],\n    getIsVisible: (): ((id: string) => boolean) => getIsVisible?.() ?? alwaysVisible,\n  };\n\n  return { helpers, chromeState };\n}\n"],"mappings":";;;;;;AAYA,IAAMA,UAA8B,CAAC,GAE/BC,UAA+B;AAyIrC,SAASC,EAAmB,GAAiC,GAAmB;CAC9E,OAAO,OAAOC,EAAQ,gBAAiB,aAAaA,EAAQ,aAAaC,CAAE,IAAID,EAAQ,QAAQC,CAAE;AACnG;AAOA,SAAgBC,EACd,GAC0B;CAC1B,IAAM,EACJ,YAAS,aAAU,aAAU,iBAAc,cAAW,kBACtD,qBAAkB,oBAChBC,GACEC,IAAQC,GACX,GAAY,MACVC,IAAeA,EAAaL,GAAIM,CAAI,IAAIC,EAAaD,GAAME,CAAQ,GACtE,CAACH,GAAcG,CAAQ,CACzB,GAEMC,IAAeC,QAAc;EACjC,IAAIC,GAAU,OAAOA;EACrB,IAAKZ,GACL,QAAQ,MAA8B;GACpC,IAAI;IAGF,OAAOQ,EAAaT,EAAYC,GAASC,CAAE,GAAGQ,CAAQ;GACxD,QAAQ;IACN,OAAO;GACT;EACF;CACF,GAAG;EAACG;EAAUZ;EAASS;CAAQ,CAAC,GAE1BI,IAAkBR,GAAa,MAA6B;EAChE,IAAI,CAACL,GAAS,OAAO;EACrB,IAAI;GACF,OAAOD,EAAYC,GAASC,CAAE;EAChC,QAAQ;GACN,OAAO;EACT;CACF,GAAG,CAACD,CAAO,CAAC,GAENc,IAAcC,EAAU,SAAS,GAEjCC,IAAsBC,EAAUC,CAAgB,GAEhDC,IAAoBR,QAAcC,KAAYF,GAAc,CAACE,GAAUF,CAAY,CAAC,GAEpFU,IAAgBf,GAAa,MACvBW,EAAoB,UAAUf,CAAE,KACR,MACjC,CAACe,CAAmB,CAAC,GAClBK,IAAkBhB,GAAa,MAA8B;EACjE,IAAMiB,IAAIF,EAAcnB,CAAE;EAC1B,OAAOqB,KAAK,OAAsB,OAAflB,EAAMH,GAAIqB,CAAC;CAChC,GAAG,CAACF,GAAehB,CAAK,CAAC,GAQnBmB,IAAoBlB,GAAa,MACnBgB,EAAgBpB,CAC9B,MACGkB,IAAoBA,EAAkBlB,CAAE,IAAI,OAClD,CAACoB,GAAiBF,CAAiB,CAAC,GAEjCK,IAA2Bb,QACzBc,EAAiB;EACrB;EACA;EACA,mBAAmBF;EACnB,WAAW;GAAE,KAAK;GAAO,OAAO;GAAO,MAAM;GAAO,MAAM;EAAM;EAGhE,YAAY,MAAO;GACjB,IAAI,CAACd,EAAS,kBAAkB,OAAO;GACvC,IAAMF,IAAOM,EAAgBZ,CAAE;GAE/B,OADIM,KAAQ,QACLE,EAAS,iBAAiBF,CAAI;EACvC;CACF,CAAC,GACD;EAACQ;EAAWD;EAAaS;EAAmBd;EAAUI;CAAe,CACvE;CAyBA,OAAO;EAAE,SAAA;GAtBP,mBAAmB,MACVO,EAAcnB,CAAE,KAAKY,EAAgBZ,CAAE;GAEhD,oBAAoBsB;GACpB,wBAAuC;IAGrC,IAAMG,IAA2B,CAAC;IAClC,KAAK,IAAMzB,KAAM,IAAI,IAAI0B,GAAe,IAAI,KAAK,CAAC,CAAC,GAAG,EAAM,KAAKN,EAAgBpB,CAAE,CAAC;IACpF,IAAM2B,IAAcD,GAAe,OAAO;IAC1C,IAAIC,GAAa,KAAK,IAAMC,KAAKD,GAAa,EAAM,KAAKC,CAAC;IAC1D,OAAOC,EAAUJ,CAAK;GACxB;GACA,oBAAoB,MAClBC,GAAe,UAAUI,CAAE,KAAKlC;GAClC,yBAAiC8B,GAAe,WAAW,KAAK;GAChE,sBAAsBH;GACtB,yBAA0DG,GAAe,eAAe,KAAK,CAAC;GAC9F,0BAAqDA,GAAe,SAAS,KAAK,CAAC;GACnF,oBAA+CK,IAAe,KAAKlC;EAG5D;EAAS;CAAY;AAChC"}

package/dist/canvas/viewInputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewInputs.js","names":["ViewInputsContext","createContext","ViewInputsProvider","useOptionalViewInputs","useContext"],"sources":["../../src/canvas/viewInputs.tsx"],"sourcesContent":["/**\n * What {@link useViewHelpers} needs that belongs to the surface rather than to\n * one view: the adapter, the geometry, the bounds resolver and the tools.\n *\n * These are read during a view's render, so they travel as context rather than\n * on the `SurfaceHandle`, which is not attached until an effect runs.\n */\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { UseViewHelpersOpts } from './useViewHelpers';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { NodeId } from 'core/scene/types';\nimport type { View } from 'core/viewport/view';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { RuleCtx } from 'features/chrome-caps';\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/**\n * The part of a chrome-caps rule context that belongs to one view. Everything\n * else a `RuleCtx` carries — mode, capabilities, device, focus — is the\n * surface's and the same for every view drawn on it.\n */\nexport interface ViewRuleInputs {\n  selection: readonly NodeId[];\n  view: View;\n  /** What that view's dispatcher currently has in flight. */\n  action: { kind: string | null; id: string | null };\n}\n\n/**\n * @internal Provided by the surface, consumed by `<CanvasView>`.\n *\n * The scene-shaped half only. What a gesture is doing right now is read from\n * the asking view's own dispatcher, not from here.\n */\nexport interface SurfaceViewInputs\n  extends Pick<UseViewHelpersOpts<unknown>, 'adapter' | 'geometry' | 'tools'> {\n  /** A node's box for chrome, drawn under `view` — the camera of the view\n   *  asking, since a node on a parallax plane lands somewhere else in each. */\n  boundsOf: ((id: string, view?: View | null) => Bounds | null) | undefined;\n  /** How `view`'s world maps into the parallax plane `id` is drawn through,\n   *  or null when its layer moves with the camera. */\n  planeOfNode?: ((id: string, view?: View | null) => PlaneMap | null) | undefined;\n  /** `boundsOf` for `id` drawn at an in-flight `pose`, under `view`. */\n  boundsOfPose?: ((id: string, pose: unknown, view?: View | null) => Bounds | null) | undefined;\n  /** Every id under a world point, bottom-first. `view` is the view the\n   *  point was produced under — a screen-pixel tolerance cannot be converted\n   *  without its scale, nor a layer judged without its paint, and the world\n   *  point carries neither. */\n  pickEvery?: (worldX: number, worldY: number, view?: PickView | null) => string[];\n  /** The one id a click resolves to, collapsing parent/child the way the\n   *  select tool does. Falls back to `pickEvery`'s last when absent. */\n  pickBest?: (worldX: number, worldY: number, view?: PickView | null) => string | null;\n  /** A hit node's routing-trait kind, so `target: 'kind:text'` bindings match. */\n  kindOfNode?: (id: string) => string | undefined;\n  /**\n   * The surface's chrome-caps rule table, evaluated against a view's own\n   * context. The rules are surface-wide on purpose — one consumer table, one\n   * set of kit defaults — but a rule keyed on selection, camera or the\n   * in-flight action answers differently per view, so the caller supplies the\n   * context and both the paint gate and the dispatcher's eligibility filter\n   * read the same one.\n   */\n  chromeCaps?: {\n    /** `undefined` when the surface gates nothing — no mode registry wired,\n     *  which is what `<SceneCanvas>` reports for its own view too. */\n    ruleCtx(inputs: ViewRuleInputs): RuleCtx | undefined;\n    isVisible(inputs: ViewRuleInputs): (id: string) => boolean;\n  };\n  /** The surface's selection, which a view shares unless it was given one of\n   *  its own. */\n  selectionApi: SelectionApi;\n  /** The rotate badge the surface's selection overlay paints, which every\n   *  view drawing that overlay has to make grabbable where it is drawn. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n}\n\nconst ViewInputsContext = createContext<SurfaceViewInputs | null>(null);\n\n/** @internal */\nexport function ViewInputsProvider(\n  { value, children }: { value: SurfaceViewInputs; children: ReactNode },\n) {\n  return <ViewInputsContext.Provider value={value}>{children}</ViewInputsContext.Provider>;\n}\n\n/** The hosting surface's view-helper inputs, or `null` outside one. */\nexport function useOptionalViewInputs(): SurfaceViewInputs | null {\n  return useContext(ViewInputsContext);\n}\n"],"mappings":";;;AA6EA,IAAMA,IAAoBC,EAAwC,IAAI;AAGtE,SAAgBC,EACd,EAAE,UAAO,eACT;CACA,OAAO,kBAACF,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF;AAGA,SAAgBG,IAAkD;CAChE,OAAOC,EAAWJ,CAAiB;AACrC"}
+{"version":3,"file":"viewInputs.js","names":["ViewInputsContext","createContext","ViewInputsProvider","useOptionalViewInputs","useContext"],"sources":["../../src/canvas/viewInputs.tsx"],"sourcesContent":["/**\n * What {@link useViewHelpers} needs that belongs to the surface rather than to\n * one view: the adapter, the geometry and the bounds resolver.\n *\n * These are read during a view's render, so they travel as context rather than\n * on the `SurfaceHandle`, which is not attached until an effect runs.\n */\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { UseViewHelpersOpts } from './useViewHelpers';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { View } from 'core/viewport/view';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { ChromeCaps } from 'features/chrome-caps/useChromeCaps';\nimport type { PickView } from './SceneCanvas/useSceneSelectTool';\n\nexport type { ViewRuleInputs } from 'features/chrome-caps/useChromeCaps';\n\n/**\n * @internal Provided by the surface, consumed by `<CanvasView>`.\n *\n * The scene-shaped half only. What a gesture is doing right now is read from\n * the asking view's own dispatcher, not from here.\n */\nexport interface SurfaceViewInputs\n  extends Pick<UseViewHelpersOpts<unknown>, 'adapter' | 'geometry'> {\n  /** A node's box for chrome, drawn under `view` — the camera of the view\n   *  asking, since a node on a parallax plane lands somewhere else in each. */\n  boundsOf: ((id: string, view?: View | null) => Bounds | null) | undefined;\n  /** How `view`'s world maps into the parallax plane `id` is drawn through,\n   *  or null when its layer moves with the camera. */\n  planeOfNode?: ((id: string, view?: View | null) => PlaneMap | null) | undefined;\n  /** `boundsOf` for `id` drawn at an in-flight `pose`, under `view`. */\n  boundsOfPose?: ((id: string, pose: unknown, view?: View | null) => Bounds | null) | undefined;\n  /** Every id under a world point, bottom-first. `view` is the view the\n   *  point was produced under — a screen-pixel tolerance cannot be converted\n   *  without its scale, nor a layer judged without its paint, and the world\n   *  point carries neither. */\n  pickEvery?: (worldX: number, worldY: number, view?: PickView | null) => string[];\n  /** The one id a click resolves to, collapsing parent/child the way the\n   *  select tool does. Falls back to `pickEvery`'s last when absent. */\n  pickBest?: (worldX: number, worldY: number, view?: PickView | null) => string | null;\n  /** A hit node's routing-trait kind, so `target: 'kind:text'` bindings match. */\n  kindOfNode?: (id: string) => string | undefined;\n  /** The surface's chrome-caps rule table, evaluated against a view's own\n   *  context. */\n  chromeCaps?: ChromeCaps;\n  /** The surface's selection, which a view shares unless it was given one of\n   *  its own. */\n  selectionApi: SelectionApi;\n  /** The rotate badge the surface's selection overlay paints, which every\n   *  view drawing that overlay has to make grabbable where it is drawn. */\n  rotationBadge?: { distancePx: number; sizePx: number } | null;\n}\n\nconst ViewInputsContext = createContext<SurfaceViewInputs | null>(null);\n\n/** @internal */\nexport function ViewInputsProvider(\n  { value, children }: { value: SurfaceViewInputs; children: ReactNode },\n) {\n  return <ViewInputsContext.Provider value={value}>{children}</ViewInputsContext.Provider>;\n}\n\n/** The hosting surface's view-helper inputs, or `null` outside one. */\nexport function useOptionalViewInputs(): SurfaceViewInputs | null {\n  return useContext(ViewInputsContext);\n}\n"],"mappings":";;;AAuDA,IAAMA,IAAoBC,EAAwC,IAAI;AAGtE,SAAgBC,EACd,EAAE,UAAO,eACT;CACA,OAAO,kBAACF,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF;AAGA,SAAgBG,IAAkD;CAChE,OAAOC,EAAWJ,CAAiB;AACrC"}

package/dist/canvas/viewRegistry.js

@@ -1,53 +1,59 @@
 import { createViewResolver as e } from "../features/viewports/viewResolver.js";
 import { createContext as t, useContext as n, useMemo as r, useRef as i } from "react";
-import { jsx as a } from "react/jsx-runtime";
+import { createEmitter as a } from "@weasel-js/registry";
+import { jsx as o } from "react/jsx-runtime";
 //#region src/canvas/viewRegistry.tsx
-var o = t(null);
-function s({ children: t }) {
-	let n = i(/* @__PURE__ */ new Map()), s = i(0), c = i(0), d = i(/* @__PURE__ */ new Set()), f = i(null), p = r(() => {
-		let t = () => {
-			c.current++;
-			for (let e of d.current) e();
-		}, r = () => [...n.current.keys()].sort((e, t) => e.order - t.order || n.current.get(e) - n.current.get(t));
+function s(e, t, n) {
+	if (!e) return {
+		x: t,
+		y: n
+	};
+	let [r, i] = e.clientToWorld(t, n), a = e.view();
+	return {
+		x: (r - a.x) * a.scale.x,
+		y: (i - a.y) * a.scale.y
+	};
+}
+var c = t(null);
+function l({ children: t }) {
+	let n = i(/* @__PURE__ */ new Map()), l = i(0), u = i(0), p = i(null), m = r(() => {
+		let t = a(), r = () => {
+			u.current++, t.emit();
+		}, i = () => [...n.current.keys()].sort((e, t) => e.order - t.order || n.current.get(e) - n.current.get(t));
 		return {
 			resolver: e({
 				views: () => {
-					let e = f.current, t = e?.view() ?? u, n = e?.dims() ?? l;
-					return r().filter((e) => e.interactive).map((e) => e.layer.resolvable(t, n));
-				},
-				root: () => f.current?.view() ?? u,
-				canvasOrigin: () => f.current?.origin() ?? {
-					left: 0,
-					top: 0
+					let e = p.current, t = e?.view() ?? f, n = e?.dims() ?? d;
+					return i().filter((e) => e.interactive).map((e) => e.layer.resolvable(t, n));
 				},
-				occluded: (e, t) => f.current?.claimsAbove(e, t) ?? !1
-			}),
-			register: (e) => (n.current.set(e, s.current++), t(), () => {
-				n.current.delete(e), t();
+				root: () => p.current?.view() ?? f,
+				toLocal: (e, t) => s(p.current, e, t),
+				occluded: (e, t) => p.current?.claimsAbove(e, t) ?? !1
 			}),
-			list: r,
-			getVersion: () => c.current,
-			subscribe: (e) => (d.current.add(e), () => {
-				d.current.delete(e);
+			register: (e) => (n.current.set(e, l.current++), r(), () => {
+				n.current.delete(e), r();
 			}),
-			surface: () => f.current,
-			attachSurface: (e) => {
-				f.current = e;
-			}
+			list: i,
+			getVersion: () => u.current,
+			subscribe: t.subscribe,
+			surface: () => p.current,
+			attachSurface: (e) => (p.current = e, () => {
+				p.current === e && (p.current = null);
+			})
 		};
 	}, []);
-	return /* @__PURE__ */ a(o.Provider, {
-		value: p,
+	return /* @__PURE__ */ o(c.Provider, {
+		value: m,
 		children: t
 	});
 }
-function c() {
-	return n(o);
+function u() {
+	return n(c);
 }
-var l = {
+var d = {
 	width: 0,
 	height: 0
-}, u = {
+}, f = {
 	x: 0,
 	y: 0,
 	scale: {
@@ -56,6 +62,6 @@ var l = {
 	}
 };
 //#endregion
-export { u as IDENTITY_VIEW, l as UNMEASURED_DIMS, s as ViewRegistryProvider, c as useOptionalViewRegistry };
+export { f as IDENTITY_VIEW, d as UNMEASURED_DIMS, l as ViewRegistryProvider, s as surfaceLocal, u as useOptionalViewRegistry };
 
 //# sourceMappingURL=viewRegistry.js.map

package/dist/canvas/viewRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewRegistry.js","names":["ViewRegistryContext","createContext","ViewRegistryProvider","entriesRef","useRef","seqRef","versionRef","listenersRef","surfaceRef","registry","useMemo","changed","fn","ordered","a","b","createViewResolver","surface","view","IDENTITY_VIEW","dims","UNMEASURED_DIMS","r","x","y","reg","handle","useOptionalViewRegistry","useContext"],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'features/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, type ViewResolver } from 'features/viewports/viewResolver';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** Client-space origin of the canvas element. */\n  origin(): { left: number; top: number };\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n}\n\n/** @internal */\nexport interface ViewRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order. */\n  list(): readonly ViewRegistration[];\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  attachSurface(handle: SurfaceHandle): void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const listenersRef = useRef(new Set<() => void>());\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const changed = (): void => {\n      versionRef.current++;\n      for (const fn of listenersRef.current) fn();\n    };\n    const ordered = (): ViewRegistration[] => [...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    ));\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      canvasOrigin: () => surfaceRef.current?.origin() ?? { left: 0, top: 0 },\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    return {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      getVersion: () => versionRef.current,\n      subscribe: (fn) => {\n        listenersRef.current.add(fn);\n        return () => { listenersRef.current.delete(fn); };\n      },\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => { surfaceRef.current = handle; },\n    };\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":";;;;AAwGA,IAAMA,IAAsBC,EAAmC,IAAI;AAInE,SAAgBC,EAAqB,EAAE,eAAqC;CAC1E,IAAMC,IAAaC,kBAAO,IAAI,IAA8B,CAAC,GACvDC,IAASD,EAAO,CAAC,GACjBE,IAAaF,EAAO,CAAC,GACrBG,IAAeH,kBAAO,IAAI,IAAgB,CAAC,GAC3CI,IAAaJ,EAA6B,IAAI,GAE9CK,IAAWC,QAA4B;EAC3C,IAAMC,UAAsB;GAC1B,EAAW;GACX,KAAK,IAAMC,KAAML,EAAa,SAAS,EAAG;EAC5C,GACMM,UAAoC,CAAC,GAAGV,EAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,MAChFW,EAAE,QAAQC,EAAE,SAASZ,EAAW,QAAQ,IAAIW,CAAC,IAAKX,EAAW,QAAQ,IAAIY,CAAC,CAC3E;EAYD,OAAO;GACL,UAZeC,EAAmB;IAClC,aAAa;KACX,IAAMC,IAAUT,EAAW,SACrBU,IAAOD,GAAS,KAAK,KAAKE,GAC1BC,IAAOH,GAAS,KAAK,KAAKI;KAChC,OAAOR,EAAQ,CAAC,CAAC,QAAQ,MAAMS,EAAE,WAAW,CAAC,CAAC,KAAK,MAAMA,EAAE,MAAM,WAAWJ,GAAME,CAAI,CAAC;IACzF;IACA,YAAYZ,EAAW,SAAS,KAAK,KAAKW;IAC1C,oBAAoBX,EAAW,SAAS,OAAO,KAAK;KAAE,MAAM;KAAG,KAAK;IAAE;IACtE,WAAW,GAAG,MAAMA,EAAW,SAAS,YAAYe,GAAGC,CAAC,KAAK;GAC/D,CAEE;GACA,WAAW,OACTrB,EAAW,QAAQ,IAAIsB,GAAK,EAAO,SAAS,GAC5Cd,EAAQ,SACK;IAAkC,AAAhCR,EAAW,QAAQ,OAAOsB,CAAG,GAAGd,EAAQ;GAAG;GAE5D,MAAME;GACN,kBAAkBP,EAAW;GAC7B,YAAY,OACVC,EAAa,QAAQ,IAAIK,CAAE,SACd;IAAE,EAAa,QAAQ,OAAOA,CAAE;GAAG;GAElD,eAAeJ,EAAW;GAC1B,gBAAgB,MAAW;IAAE,EAAW,UAAUkB;GAAQ;EAC5D;CACF,GAAG,CAAC,CAAC;CAEL,OAAO,kBAAC1B,EAAoB,UAArB;EAA8B,OAAOS;EAAW;CAAuC,CAAA;AAChG;AAGA,SAAgBkB,IAA+C;CAC7D,OAAOC,EAAW5B,CAAmB;AACvC;AAGA,IAAaqB,IAAwB;CAAE,OAAO;CAAG,QAAQ;AAAE,GAG9CF,IAAsB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE"}
+{"version":3,"file":"viewRegistry.js","names":["surfaceLocal","surface","clientX","clientY","worldX","worldY","view","ViewRegistryContext","createContext","ViewRegistryProvider","entriesRef","useRef","seqRef","versionRef","surfaceRef","registry","useMemo","listeners","createEmitter","changed","ordered","a","b","createViewResolver","IDENTITY_VIEW","dims","UNMEASURED_DIMS","r","x","y","reg","handle","useOptionalViewRegistry","useContext"],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'features/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, type ViewResolver } from 'features/viewports/viewResolver';\nimport { createEmitter } from '@weasel-js/registry';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** A client point in the surface's own world — the conversion the surface\n   *  itself makes, its `clientToWorld` override included. */\n  clientToWorld(clientX: number, clientY: number): [number, number];\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n}\n\n/**\n * A client point in the surface's CSS pixels, from its top-left: the surface's\n * own world point put back through its camera, so a `clientToWorld` override\n * reaches every view declared on it.\n *\n * @internal\n */\nexport function surfaceLocal(\n  surface: Pick<SurfaceHandle, 'clientToWorld' | 'view'> | null,\n  clientX: number,\n  clientY: number,\n): { x: number; y: number } {\n  if (!surface) return { x: clientX, y: clientY };\n  const [worldX, worldY] = surface.clientToWorld(clientX, clientY);\n  const view = surface.view();\n  return { x: (worldX - view.x) * view.scale.x, y: (worldY - view.y) * view.scale.y };\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n}\n\n/** @internal */\nexport interface ViewRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order. */\n  list(): readonly ViewRegistration[];\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  /** Returns a detach, which leaves a handle attached since alone. */\n  attachSurface(handle: SurfaceHandle): () => void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const listeners = createEmitter();\n    const changed = (): void => {\n      versionRef.current++;\n      listeners.emit();\n    };\n    const ordered = (): ViewRegistration[] => [...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    ));\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      toLocal: (clientX, clientY) => surfaceLocal(surfaceRef.current, clientX, clientY),\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    return {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      getVersion: () => versionRef.current,\n      subscribe: listeners.subscribe,\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => {\n        surfaceRef.current = handle;\n        return () => { if (surfaceRef.current === handle) surfaceRef.current = null; };\n      },\n    };\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":";;;;;AAgEA,SAAgBA,EACd,GACA,GACA,GAC0B;CAC1B,IAAI,CAACC,GAAS,OAAO;EAAE,GAAGC;EAAS,GAAGC;CAAQ;CAC9C,IAAM,CAACC,GAAQC,KAAUJ,EAAQ,cAAcC,GAASC,CAAO,GACzDG,IAAOL,EAAQ,KAAK;CAC1B,OAAO;EAAE,IAAIG,IAASE,EAAK,KAAKA,EAAK,MAAM;EAAG,IAAID,IAASC,EAAK,KAAKA,EAAK,MAAM;CAAE;AACpF;AAoDA,IAAMC,IAAsBC,EAAmC,IAAI;AAInE,SAAgBC,EAAqB,EAAE,eAAqC;CAC1E,IAAMC,IAAaC,kBAAO,IAAI,IAA8B,CAAC,GACvDC,IAASD,EAAO,CAAC,GACjBE,IAAaF,EAAO,CAAC,GACrBG,IAAaH,EAA6B,IAAI,GAE9CI,IAAWC,QAA4B;EAC3C,IAAMC,IAAYC,EAAc,GAC1BC,UAAsB;GAE1B,AADA,EAAW,WACXF,EAAU,KAAK;EACjB,GACMG,UAAoC,CAAC,GAAGV,EAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,MAChFW,EAAE,QAAQC,EAAE,SAASZ,EAAW,QAAQ,IAAIW,CAAC,IAAKX,EAAW,QAAQ,IAAIY,CAAC,CAC3E;EAYD,OAAO;GACL,UAZeC,EAAmB;IAClC,aAAa;KACX,IAAMtB,IAAUa,EAAW,SACrBR,IAAOL,GAAS,KAAK,KAAKuB,GAC1BC,IAAOxB,GAAS,KAAK,KAAKyB;KAChC,OAAON,EAAQ,CAAC,CAAC,QAAQ,MAAMO,EAAE,WAAW,CAAC,CAAC,KAAK,MAAMA,EAAE,MAAM,WAAWrB,GAAMmB,CAAI,CAAC;IACzF;IACA,YAAYX,EAAW,SAAS,KAAK,KAAKU;IAC1C,UAAU,GAAS,MAAYxB,EAAac,EAAW,SAASZ,GAASC,CAAO;IAChF,WAAW,GAAG,MAAMW,EAAW,SAAS,YAAYc,GAAGC,CAAC,KAAK;GAC/D,CAEE;GACA,WAAW,OACTnB,EAAW,QAAQ,IAAIoB,GAAK,EAAO,SAAS,GAC5CX,EAAQ,SACK;IAAkC,AAAhCT,EAAW,QAAQ,OAAOoB,CAAG,GAAGX,EAAQ;GAAG;GAE5D,MAAMC;GACN,kBAAkBP,EAAW;GAC7B,WAAWI,EAAU;GACrB,eAAeH,EAAW;GAC1B,gBAAgB,OACd,EAAW,UAAUiB,SACR;IAAE,AAAIjB,EAAW,YAAYiB,MAAQ,EAAW,UAAU;GAAM;EAEjF;CACF,GAAG,CAAC,CAAC;CAEL,OAAO,kBAACxB,EAAoB,UAArB;EAA8B,OAAOQ;EAAW;CAAuC,CAAA;AAChG;AAGA,SAAgBiB,IAA+C;CAC7D,OAAOC,EAAW1B,CAAmB;AACvC;AAGA,IAAamB,IAAwB;CAAE,OAAO;CAAG,QAAQ;AAAE,GAG9CF,IAAsB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE"}

package/dist/canvas/watchElementMove.js

@@ -0,0 +1,43 @@
+//#region src/canvas/watchElementMove.ts
+function e(e, t) {
+	if (typeof IntersectionObserver > "u") return () => {};
+	let n = e.ownerDocument.documentElement, r = null, i = null, a, o = () => {
+		clearTimeout(a), r?.disconnect(), r = null, i?.disconnect(), i = null;
+	}, s = () => {
+		typeof ResizeObserver < "u" && (i = new ResizeObserver(() => {
+			let n = e.getBoundingClientRect();
+			n.width !== 0 && n.height !== 0 && (t(), c(1));
+		}), i.observe(e));
+	}, c = (i) => {
+		o();
+		let l = e.getBoundingClientRect();
+		if (l.width === 0 || l.height === 0) {
+			s();
+			return;
+		}
+		let u = [
+			Math.floor(l.top),
+			Math.floor(n.clientWidth - l.right),
+			Math.floor(n.clientHeight - l.bottom),
+			Math.floor(l.left)
+		], d = (e) => Math.abs(e.left - l.left) > .5 || Math.abs(e.top - l.top) > .5 || Math.abs(e.width - l.width) > .5 || Math.abs(e.height - l.height) > .5, f = !0;
+		r = new IntersectionObserver((n) => {
+			let r = n[0].intersectionRatio;
+			if (f ? n.length > 1 || d(n[0].boundingClientRect) : r !== i) {
+				t(), c(1);
+				return;
+			}
+			f = !1, r !== i && (r === 0 ? a = setTimeout(() => {
+				d(e.getBoundingClientRect()) && t(), c(1e-7);
+			}, 1e3) : c(r));
+		}, {
+			rootMargin: u.map((e) => `${-e}px`).join(" "),
+			threshold: Math.max(0, Math.min(1, i)) || 1
+		}), r.observe(e);
+	};
+	return c(1), o;
+}
+//#endregion
+export { e as watchElementMove };
+
+//# sourceMappingURL=watchElementMove.js.map

package/dist/canvas/watchElementMove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchElementMove.js","names":["watchElementMove","root","element","observer","sized","retry","stop","awaitSize","box","onMove","frame","insets","movedTo","now","first","ratio","entries","threshold","inset"],"sources":["../../src/canvas/watchElementMove.ts"],"sourcesContent":["/**\n * Call `onMove` when `element`'s box moves in the viewport for a reason no\n * event reports: a sibling collapsing, content loading above it. A scroll or a\n * resize of the element may also call it; a caller already listening for those\n * hears a second, harmless report. Returns the function that stops watching.\n *\n * There is no observer for position, so this frames the element's current box\n * with an `IntersectionObserver` whose root margin is that box exactly. Any move\n * changes how much of the element the frame holds, which the observer reports,\n * and the frame is then rebuilt around the new box.\n *\n * A frame only watches from its first report on, so that report is checked\n * against the box the frame was built around: a move in between is reported too.\n */\nexport function watchElementMove(element: Element, onMove: () => void): () => void {\n  if (typeof IntersectionObserver === 'undefined') return () => {};\n  const root = element.ownerDocument.documentElement;\n  let observer: IntersectionObserver | null = null;\n  let sized: ResizeObserver | null = null;\n  let retry: ReturnType<typeof setTimeout> | undefined;\n\n  const stop = (): void => {\n    clearTimeout(retry);\n    observer?.disconnect();\n    observer = null;\n    sized?.disconnect();\n    sized = null;\n  };\n\n  /** A box with no area cannot be framed, so wait for it to have one. */\n  const awaitSize = (): void => {\n    if (typeof ResizeObserver === 'undefined') return;\n    sized = new ResizeObserver(() => {\n      const box = element.getBoundingClientRect();\n      if (box.width === 0 || box.height === 0) return;\n      onMove();\n      frame(1);\n    });\n    sized.observe(element);\n  };\n\n  const frame = (threshold: number): void => {\n    stop();\n    const box = element.getBoundingClientRect();\n    if (box.width === 0 || box.height === 0) {\n      awaitSize();\n      return;\n    }\n    const insets = [\n      Math.floor(box.top),\n      Math.floor(root.clientWidth - box.right),\n      Math.floor(root.clientHeight - box.bottom),\n      Math.floor(box.left),\n    ];\n    // Half a pixel of slack: two measurements that disagreed by rounding would report every\n    // frame, and the floored frame cannot see a move that small anyway.\n    const movedTo = (now: DOMRectReadOnly): boolean =>\n      Math.abs(now.left - box.left) > 0.5 || Math.abs(now.top - box.top) > 0.5\n      || Math.abs(now.width - box.width) > 0.5 || Math.abs(now.height - box.height) > 0.5;\n    let first = true;\n    observer = new IntersectionObserver(\n      (entries) => {\n        const ratio = entries[0].intersectionRatio;\n        const moved = first\n          ? entries.length > 1 || movedTo(entries[0].boundingClientRect)\n          : ratio !== threshold;\n        if (moved) {\n          onMove();\n          frame(1);\n          return;\n        }\n        first = false;\n        if (ratio === threshold) return;\n        // A box partly off the root never reaches the threshold asked for, so\n        // ask for what it does reach. One wholly off it reports zero for\n        // every frame, wherever it goes; look again once it may have come back.\n        if (ratio !== 0) frame(ratio);\n        else {\n          retry = setTimeout(() => {\n            if (movedTo(element.getBoundingClientRect())) onMove();\n            frame(1e-7);\n          }, 1000);\n        }\n      },\n      { rootMargin: insets.map((inset) => `${-inset}px`).join(' '), threshold: Math.max(0, Math.min(1, threshold)) || 1 },\n    );\n    observer.observe(element);\n  };\n\n  frame(1);\n  return stop;\n}\n"],"mappings":";AAcA,SAAgBA,EAAiB,GAAkB,GAAgC;CACjF,IAAI,OAAO,uBAAyB,KAAa,aAAa,CAAC;CAC/D,IAAMC,IAAOC,EAAQ,cAAc,iBAC/BC,IAAwC,MACxCC,IAA+B,MAC/BC,GAEEC,UAAmB;EAKvB,AAJA,aAAaD,CAAK,GAClBF,GAAU,WAAW,GACrB,IAAW,MACXC,GAAO,WAAW,GAClB,IAAQ;CACV,GAGMG,UAAwB;EAC5B,AAAI,OAAO,iBAAmB,QAC9B,IAAQ,IAAI,qBAAqB;GAC/B,IAAMC,IAAMN,EAAQ,sBAAsB;GAC1C,AAAIM,EAAI,UAAU,KAAKA,EAAI,WAAW,MACtCC,EAAO,GACPC,EAAM,CAAC;EACT,CAAC,GACDN,EAAM,QAAQF,CAAO;CACvB,GAEMQ,KAAS,MAA4B;EACzC,EAAK;EACL,IAAMF,IAAMN,EAAQ,sBAAsB;EAC1C,IAAIM,EAAI,UAAU,KAAKA,EAAI,WAAW,GAAG;GACvC,EAAU;GACV;EACF;EACA,IAAMG,IAAS;GACb,KAAK,MAAMH,EAAI,GAAG;GAClB,KAAK,MAAMP,EAAK,cAAcO,EAAI,KAAK;GACvC,KAAK,MAAMP,EAAK,eAAeO,EAAI,MAAM;GACzC,KAAK,MAAMA,EAAI,IAAI;EACrB,GAGMI,KAAW,MACf,KAAK,IAAIC,EAAI,OAAOL,EAAI,IAAI,IAAI,MAAO,KAAK,IAAIK,EAAI,MAAML,EAAI,GAAG,IAAI,MAClE,KAAK,IAAIK,EAAI,QAAQL,EAAI,KAAK,IAAI,MAAO,KAAK,IAAIK,EAAI,SAASL,EAAI,MAAM,IAAI,IAC9EM,IAAQ;EA2BZ,AA1BA,IAAW,IAAI,sBACZ,MAAY;GACX,IAAMC,IAAQC,EAAQ,EAAE,CAAC;GAIzB,IAHcF,IACVE,EAAQ,SAAS,KAAKJ,EAAQI,EAAQ,EAAE,CAAC,kBAAkB,IAC3DD,MAAUE,GACH;IAET,AADAR,EAAO,GACPC,EAAM,CAAC;IACP;GACF;GAEA,AADA,IAAQ,IACJK,MAAUE,MAIVF,MAAU,IAEZ,IAAQ,iBAAiB;IAEvB,AADIH,EAAQV,EAAQ,sBAAsB,CAAC,KAAGO,EAAO,GACrDC,EAAM,IAAI;GACZ,GAAG,GAAI,IALQA,EAAMK,CAAK;EAO9B,GACA;GAAE,YAAYJ,EAAO,KAAK,MAAU,GAAG,CAACO,EAAM,GAAG,CAAC,CAAC,KAAK,GAAG;GAAG,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGD,CAAS,CAAC,KAAK;EAAE,CACpH,GACAd,EAAS,QAAQD,CAAO;CAC1B;CAGA,OADAQ,EAAM,CAAC,GACAJ;AACT"}

package/dist/canvas/wrapNodeOutput.js

@@ -1,6 +1,11 @@
 import { wrapWithPoseRotation as e } from "./poseRotation.js";
+import { overChildren as t, splitOverChildren as n } from "./overChildren.js";
 //#region src/canvas/wrapNodeOutput.ts
-function t(t, n, r) {
+function r(e, r, a) {
+	let { under: o, over: s } = n(e), c = i(o, r, a);
+	return s.length > 0 ? [...c, t(i(s, r, a))] : c;
+}
+function i(t, n, r) {
 	let i = e(t, n);
 	return r !== 1 && i.length > 0 ? [{
 		kind: "group",
@@ -9,6 +14,6 @@ function t(t, n, r) {
 	}] : i;
 }
 //#endregion
-export { t as wrapNodeOutput };
+export { r as wrapNodeOutput };
 
 //# sourceMappingURL=wrapNodeOutput.js.map

package/dist/canvas/wrapNodeOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapNodeOutput.js","names":["wrapNodeOutput","rotated","wrapWithPoseRotation","cmds","pose","alpha"],"sources":["../../src/canvas/wrapNodeOutput.ts"],"sourcesContent":["/**\n * The per-node wraps a scene render applies on top of whatever `drawOne`\n * returned — pose rotation, then a per-id alpha multiplier. They sit outside\n * `drawOne` on purpose: consumer-supplied painters get rotation and dimming\n * without having to reimplement either.\n *\n * Shared by the main canvas (`buildSceneLayer`) and the detached renders\n * (`buildSceneViewCommands`) so a scene painted off-screen matches the same\n * scene painted on it.\n */\nimport type { DrawCommand } from '../renderer';\nimport { wrapWithPoseRotation } from './poseRotation';\n\n/** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.\n *  Both wraps are skipped when they would be no-ops (zero/absent rotation,\n *  alpha exactly 1, empty command list), so an upright opaque node emits the\n *  painter's commands untouched. Alpha nests OUTSIDE rotation. */\nexport function wrapNodeOutput(\n  cmds: DrawCommand[],\n  pose: unknown,\n  alpha: number,\n): DrawCommand[] {\n  const rotated = wrapWithPoseRotation(cmds, pose);\n  if (alpha !== 1 && rotated.length > 0) {\n    return [{ kind: 'group', alpha, children: rotated }];\n  }\n  return rotated;\n}\n"],"mappings":";;AAiBA,SAAgBA,EACd,GACA,GACA,GACe;CACf,IAAMC,IAAUC,EAAqBC,GAAMC,CAAI;CAI/C,OAHIC,MAAU,KAAKJ,EAAQ,SAAS,IAC3B,CAAC;EAAE,MAAM;EAAS;EAAO,UAAUA;CAAQ,CAAC,IAE9CA;AACT"}
+{"version":3,"file":"wrapNodeOutput.js","names":["wrapNodeOutput","splitOverChildren","cmds","wrapped","wrapPart","under","pose","alpha","over","overChildren","rotated","wrapWithPoseRotation"],"sources":["../../src/canvas/wrapNodeOutput.ts"],"sourcesContent":["/**\n * The per-node wraps a scene render applies on top of whatever `drawOne`\n * returned — pose rotation, then a per-id alpha multiplier. They sit outside\n * `drawOne` on purpose: consumer-supplied painters get rotation and dimming\n * without having to reimplement either.\n *\n * Shared by the main canvas (`buildSceneLayer`) and the detached renders\n * (`buildSceneViewCommands`) so a scene painted off-screen matches the same\n * scene painted on it.\n */\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { wrapWithPoseRotation } from './poseRotation';\nimport { overChildren, splitOverChildren } from './overChildren';\n\n/** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.\n *  Both wraps are skipped when they would be no-ops (zero/absent rotation,\n *  alpha exactly 1, empty command list), so an upright opaque node emits the\n *  painter's commands untouched. Alpha nests OUTSIDE rotation. */\nexport function wrapNodeOutput(\n  cmds: DrawCommand[],\n  pose: unknown,\n  alpha: number,\n): DrawCommand[] {\n  const { under, over } = splitOverChildren(cmds);\n  const wrapped = wrapPart(under, pose, alpha);\n  // What a painter asked to draw over the node's children is wrapped apart, so it is still over them.\n  return over.length > 0 ? [...wrapped, overChildren(wrapPart(over, pose, alpha))] : wrapped;\n}\n\nfunction wrapPart(cmds: DrawCommand[], pose: unknown, alpha: number): DrawCommand[] {\n  const rotated = wrapWithPoseRotation(cmds, pose);\n  if (alpha !== 1 && rotated.length > 0) {\n    return [{ kind: 'group', alpha, children: rotated }];\n  }\n  return rotated;\n}\n"],"mappings":";;;AAkBA,SAAgBA,EACd,GACA,GACA,GACe;CACf,IAAM,EAAE,UAAO,YAASC,EAAkBC,CAAI,GACxCC,IAAUC,EAASC,GAAOC,GAAMC,CAAK;CAE3C,OAAOC,EAAK,SAAS,IAAI,CAAC,GAAGL,GAASM,EAAaL,EAASI,GAAMF,GAAMC,CAAK,CAAC,CAAC,IAAIJ;AACrF;AAEA,SAASC,EAAS,GAAqB,GAAe,GAA8B;CAClF,IAAMM,IAAUC,EAAqBT,GAAMI,CAAI;CAI/C,OAHIC,MAAU,KAAKG,EAAQ,SAAS,IAC3B,CAAC;EAAE,MAAM;EAAS;EAAO,UAAUA;CAAQ,CAAC,IAE9CA;AACT"}

package/dist/clipboard.d.ts

@@ -1,7 +1,9 @@
 import { NodeId } from '@weasel-js/routing';
-import { e as PasteOmission, k as ClipboardSnapshot, I as InsertAdapter } from './types-k-5Oqh-U.js';
+import { d as PasteOmission, j as ClipboardSnapshot, I as InsertAdapter } from './types-DBbbCy0i.js';
 import '@weasel-js/history';
 import '@weasel-js/geom';
+import './poseDescriptor-Bqk-11Rl.js';
+import '@weasel-js/animator';
 
 type Replacer$1 = (key: string, value: unknown) => unknown;
 /** Options for `useClipboardOps`. */
@@ -74,12 +76,7 @@ declare function sniffWeaselClipboardText(text: string): boolean;
 /**
  * Embed a weasel clipboard payload in an SVG document as a `<metadata>`
  * child of the root — legal SVG 1.1, ignored by external tools — so one
- * `text/plain` flavor serves both audiences: external tools parse the SVG,
- * weasel extracts the JSON for full fidelity on draw→draw DOM paste.
- *
- * The payload rides in CDATA so JSON's `<` / `&` need no entity escaping; a
- * literal `]]>` inside the payload is split across CDATA sections
- * (`]]]]><![CDATA[>`), which {@link extractWeaselClipboardFromSvg} rejoins.
+ * `text/plain` flavor serves both audiences.
  *
  * Intended for OUR serializer's output only (`serializeSvg` — single
  * `<svg ...>` open tag, XML-escaped attributes). When no open tag is found
@@ -87,13 +84,9 @@ declare function sniffWeaselClipboardText(text: string): boolean;
  */
 declare function embedWeaselMetadataInSvg(svgText: string, payloadText: string): string;
 /**
- * Recover an embedded weasel clipboard payload from SVG text: read the first
- * `<metadata>` block, rejoin its CDATA sections (concatenation restores the
- * `]]>` split by {@link embedWeaselMetadataInSvg}; plain non-CDATA content
- * passes through as-is), and return the payload text iff it sniffs as the
- * weasel wire format — else null (external/non-weasel metadata declines).
- *
- * A text scan, not an XML parse — the payload is small and ours.
+ * The weasel clipboard payload embedded in SVG text by
+ * {@link embedWeaselMetadataInSvg}, or null when the first `<metadata>` block
+ * is absent or not the weasel wire format. A text scan, not an XML parse.
  */
 declare function extractWeaselClipboardFromSvg(svgText: string): string | null;
 /** Parse wire text to snapshot items, or null when malformed/mismatched