@weasel-js/core 1.15.0 → 1.15.1

package/dist/canvas/useClientToWorld.js

@@ -2,7 +2,7 @@ import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import { useCallback } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useClientToWorld.ts
+// src/canvas/useClientToWorld.ts
 /**
 * The canvas's one client→world conversion: hover, the view registry and both handles answer
 * with it, so a `clientToWorld` override reaches all of them or none.
@@ -22,6 +22,5 @@ function useClientToWorld(elementRef, clientToWorld$1, viewRef) {
 	]);
 }
 
-//#endregion
 export { useClientToWorld };
 //# sourceMappingURL=useClientToWorld.js.map

package/dist/canvas/useExtraLayers.js

@@ -1,7 +1,7 @@
 import { isLayerPainted } from "../core/layers/render.js";
 import { useCallback, useRef, useState } from "react";
 
-//#region src/canvas/useExtraLayers.ts
+// src/canvas/useExtraLayers.ts
 var alwaysVisible = (_id) => true;
 var NO_LAYER_VISIBILITY = {};
 /** Layers attached from outside the `layers` prop (a HUD, a loupe), and hit-testing over them. */
@@ -40,6 +40,5 @@ function useExtraLayers(gateRef) {
 	};
 }
 
-//#endregion
 export { NO_LAYER_VISIBILITY, alwaysVisible, useExtraLayers };
 //# sourceMappingURL=useExtraLayers.js.map

package/dist/canvas/useFrameLoop.js

@@ -1,7 +1,7 @@
 import { useCallback, useInsertionEffect, useLayoutEffect, useRef } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 
-//#region src/canvas/useFrameLoop.ts
+// src/canvas/useFrameLoop.ts
 /**
 * The frame loop behind `<Canvas>`: a dirty flag, one frame in flight at a
 * time, and a subscriber set notified after a paint lands. When frames may run
@@ -122,6 +122,5 @@ function useFrameLoop(paint, options = {}) {
 	};
 }
 
-//#endregion
 export { useFrameLoop };
 //# sourceMappingURL=useFrameLoop.js.map

package/dist/canvas/useHitObserver.js

@@ -1,7 +1,7 @@
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useHitObserver.ts
+// src/canvas/useHitObserver.ts
 /** Turns a consumer's hit callback into the world-point observer the gesture
 *  dispatcher takes, resolving the hit with the canvas's own picker. Identity
 *  changes only between wired and not, so the dispatcher isn't rebuilt per
@@ -25,6 +25,5 @@ function useHitObserver(cb, pickerRef) {
 	]);
 }
 
-//#endregion
 export { useHitObserver };
 //# sourceMappingURL=useHitObserver.js.map

package/dist/canvas/useHostAnchor.js

@@ -3,7 +3,7 @@ import { watchElementMove } from "./watchElementMove.js";
 import { useCallback, useEffect, useState } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 
-//#region src/canvas/useHostAnchor.ts
+// src/canvas/useHostAnchor.ts
 /**
 * Hold a fixed-position panel against a host element's corner, kept inside the
 * viewport, following it through scrolls, resizes, and reflows, a host moved by
@@ -98,6 +98,5 @@ function useHostAnchor(resolveHost, options) {
 	};
 }
 
-//#endregion
 export { useHostAnchor };
 //# sourceMappingURL=useHostAnchor.js.map

package/dist/canvas/useInFlightBounds.js

@@ -1,20 +1,21 @@
 import { useCallback, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useInFlightBounds.ts
+// src/canvas/useInFlightBounds.ts
 /**
 * Where a view boxes the nodes an in-flight gesture names: at the pose a
-* source previews, else at the node's effective pose — a transform's poses
+* source previews, carried to world, else at the node's effective pose — a transform's poses
 * live in the scene's overrides, not on its handle. Boxed through `boxOf`
 * either way, since a consumer `boundsOf` answers for the document pose only.
 */
 function useInFlightBounds(args) {
-	const { gestureSource, boxOf, committedPoseOf } = args;
+	const { gestureSource, boxOf, committedPoseOf, worldOfStored } = args;
 	const previewPoseExtraRef = useLatest(args.previewPoseExtra);
 	const previewPoseOf = useCallback((id) => {
 		const p = previewPoseExtraRef.current?.(id);
-		return p != null ? p : null;
-	}, [previewPoseExtraRef]);
+		if (p == null) return null;
+		return worldOfStored ? worldOfStored(id, p) : p;
+	}, [previewPoseExtraRef, worldOfStored]);
 	const inFlight = useRef(null);
 	const isInFlight = useCallback((id) => {
 		if (!gestureSource) return false;
@@ -47,6 +48,5 @@ function useInFlightBounds(args) {
 	};
 }
 
-//#endregion
 export { useInFlightBounds };
 //# sourceMappingURL=useInFlightBounds.js.map

package/dist/canvas/useInFlightBounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInFlightBounds.js","names":[],"sources":["../../src/canvas/useInFlightBounds.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource } from './gestureBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * Where a view boxes the nodes an in-flight gesture names: at the pose a\n * source previews, else at the node's effective pose — a transform's poses\n * live in the scene's overrides, not on its handle. Boxed through `boxOf`\n * either way, since a consumer `boundsOf` answers for the document pose only.\n */\nexport function useInFlightBounds<TPose>(args: {\n  gestureSource: GestureSource | undefined;\n  /** Read through a ref, so a change mid-gesture rebuilds nothing. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  boxOf: (id: string, pose: TPose) => Bounds | null;\n  /** The node's effective world pose. */\n  committedPoseOf: (id: string) => TPose | null;\n}): {\n  previewPoseOf: (id: string) => TPose | null;\n  previewBoundsOf: (id: string) => Bounds | null;\n} {\n  const { gestureSource, boxOf, committedPoseOf } = args;\n  const previewPoseExtraRef = useLatest(args.previewPoseExtra);\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\n  // The source's ids, re-read only when its version moves.\n  const inFlight = useRef<{ source: GestureSource; version: number; ids: ReadonlySet<string> } | null>(null);\n  const isInFlight = useCallback((id: string): boolean => {\n    if (!gestureSource) return false;\n    const version = gestureSource.getVersion();\n    let entry = inFlight.current;\n    if (entry === null || entry.source !== gestureSource || entry.version !== version) {\n      entry = { source: gestureSource, version, ids: new Set(gestureSource.ids() ?? []) };\n      inFlight.current = entry;\n    }\n    return entry.ids.has(id);\n  }, [gestureSource]);\n\n  const previewBoundsOf = useCallback((id: string): Bounds | null => {\n    const p = previewPoseOf(id);\n    if (p != null) return boxOf(id, p);\n    if (!isInFlight(id)) return null;\n    const shown = committedPoseOf(id);\n    return shown != null ? boxOf(id, shown) : null;\n  }, [previewPoseOf, boxOf, isInFlight, committedPoseOf]);\n\n  return { previewPoseOf, previewBoundsOf };\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBAAyB,MAUvC;CACA,MAAM,EAAE,eAAe,OAAO,oBAAoB;CAClD,MAAM,sBAAsB,UAAU,KAAK,gBAAgB;CAC3D,MAAM,gBAAgB,aAAa,OAA6B;EAC9D,MAAM,IAAI,oBAAoB,UAAU,EAAE;EAC1C,OAAO,KAAK,OAAQ,IAAc;CACpC,GAAG,CAAC,mBAAmB,CAAC;CAGxB,MAAM,WAAW,OAAoF,IAAI;CACzG,MAAM,aAAa,aAAa,OAAwB;EACtD,IAAI,CAAC,eAAe,OAAO;EAC3B,MAAM,UAAU,cAAc,WAAW;EACzC,IAAI,QAAQ,SAAS;EACrB,IAAI,UAAU,QAAQ,MAAM,WAAW,iBAAiB,MAAM,YAAY,SAAS;GACjF,QAAQ;IAAE,QAAQ;IAAe;IAAS,KAAK,IAAI,IAAI,cAAc,IAAI,KAAK,CAAC,CAAC;GAAE;GAClF,SAAS,UAAU;EACrB;EACA,OAAO,MAAM,IAAI,IAAI,EAAE;CACzB,GAAG,CAAC,aAAa,CAAC;CAUlB,OAAO;EAAE;EAAe,iBARA,aAAa,OAA8B;GACjE,MAAM,IAAI,cAAc,EAAE;GAC1B,IAAI,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC;GACjC,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO;GAC5B,MAAM,QAAQ,gBAAgB,EAAE;GAChC,OAAO,SAAS,OAAO,MAAM,IAAI,KAAK,IAAI;EAC5C,GAAG;GAAC;GAAe;GAAO;GAAY;EAAe,CAE7B;CAAgB;AAC1C"}
+{"version":3,"file":"useInFlightBounds.js","names":[],"sources":["../../src/canvas/useInFlightBounds.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource } from './gestureBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * Where a view boxes the nodes an in-flight gesture names: at the pose a\n * source previews, carried to world, else at the node's effective pose — a transform's poses\n * live in the scene's overrides, not on its handle. Boxed through `boxOf`\n * either way, since a consumer `boundsOf` answers for the document pose only.\n */\nexport function useInFlightBounds<TPose>(args: {\n  gestureSource: GestureSource | undefined;\n  /** Read through a ref, so a change mid-gesture rebuilds nothing. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  boxOf: (id: string, pose: TPose) => Bounds | null;\n  /** The node's effective world pose. */\n  committedPoseOf: (id: string) => TPose | null;\n  /** Where `id` is drawn if it stores `stored`: a previewed pose is in the\n   *  frame the node is stored in, as a published override is. Absent means\n   *  stored poses are world. */\n  worldOfStored?: ((id: string, stored: TPose) => TPose) | undefined;\n}): {\n  previewPoseOf: (id: string) => TPose | null;\n  previewBoundsOf: (id: string) => Bounds | null;\n} {\n  const { gestureSource, boxOf, committedPoseOf, worldOfStored } = args;\n  const previewPoseExtraRef = useLatest(args.previewPoseExtra);\n  const previewPoseOf = useCallback((id: string): TPose | null => {\n    const p = previewPoseExtraRef.current?.(id);\n    if (p == null) return null;\n    return worldOfStored ? worldOfStored(id, p as TPose) : (p as TPose);\n  }, [previewPoseExtraRef, worldOfStored]);\n\n  // The source's ids, re-read only when its version moves.\n  const inFlight = useRef<{ source: GestureSource; version: number; ids: ReadonlySet<string> } | null>(null);\n  const isInFlight = useCallback((id: string): boolean => {\n    if (!gestureSource) return false;\n    const version = gestureSource.getVersion();\n    let entry = inFlight.current;\n    if (entry === null || entry.source !== gestureSource || entry.version !== version) {\n      entry = { source: gestureSource, version, ids: new Set(gestureSource.ids() ?? []) };\n      inFlight.current = entry;\n    }\n    return entry.ids.has(id);\n  }, [gestureSource]);\n\n  const previewBoundsOf = useCallback((id: string): Bounds | null => {\n    const p = previewPoseOf(id);\n    if (p != null) return boxOf(id, p);\n    if (!isInFlight(id)) return null;\n    const shown = committedPoseOf(id);\n    return shown != null ? boxOf(id, shown) : null;\n  }, [previewPoseOf, boxOf, isInFlight, committedPoseOf]);\n\n  return { previewPoseOf, previewBoundsOf };\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBAAyB,MAcvC;CACA,MAAM,EAAE,eAAe,OAAO,iBAAiB,kBAAkB;CACjE,MAAM,sBAAsB,UAAU,KAAK,gBAAgB;CAC3D,MAAM,gBAAgB,aAAa,OAA6B;EAC9D,MAAM,IAAI,oBAAoB,UAAU,EAAE;EAC1C,IAAI,KAAK,MAAM,OAAO;EACtB,OAAO,gBAAgB,cAAc,IAAI,CAAU,IAAK;CAC1D,GAAG,CAAC,qBAAqB,aAAa,CAAC;CAGvC,MAAM,WAAW,OAAoF,IAAI;CACzG,MAAM,aAAa,aAAa,OAAwB;EACtD,IAAI,CAAC,eAAe,OAAO;EAC3B,MAAM,UAAU,cAAc,WAAW;EACzC,IAAI,QAAQ,SAAS;EACrB,IAAI,UAAU,QAAQ,MAAM,WAAW,iBAAiB,MAAM,YAAY,SAAS;GACjF,QAAQ;IAAE,QAAQ;IAAe;IAAS,KAAK,IAAI,IAAI,cAAc,IAAI,KAAK,CAAC,CAAC;GAAE;GAClF,SAAS,UAAU;EACrB;EACA,OAAO,MAAM,IAAI,IAAI,EAAE;CACzB,GAAG,CAAC,aAAa,CAAC;CAUlB,OAAO;EAAE;EAAe,iBARA,aAAa,OAA8B;GACjE,MAAM,IAAI,cAAc,EAAE;GAC1B,IAAI,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC;GACjC,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO;GAC5B,MAAM,QAAQ,gBAAgB,EAAE;GAChC,OAAO,SAAS,OAAO,MAAM,IAAI,KAAK,IAAI;EAC5C,GAAG;GAAC;GAAe;GAAO;GAAY;EAAe,CAE7B;CAAgB;AAC1C"}

package/dist/canvas/useLateContentRedraw.js

@@ -3,7 +3,7 @@ import { subscribeImageReady } from "@weasel-js/renderer";
 import { useEffect } from "react";
 import { subscribeGlyphReady } from "@weasel-js/font";
 
-//#region src/canvas/useLateContentRedraw.ts
+// src/canvas/useLateContentRedraw.ts
 /**
 * Repaint whenever something a frame could not draw becomes drawable: an image
 * finishes decoding, a deferred glyph bake or font load lands, or a paint kind
@@ -23,6 +23,5 @@ function useLateContentRedraw(requestRedraw) {
 	}, [requestRedraw]);
 }
 
-//#endregion
 export { useLateContentRedraw };
 //# sourceMappingURL=useLateContentRedraw.js.map

package/dist/canvas/useLayerStack.js

@@ -1,9 +1,9 @@
 import { createBackgroundFillLayer } from "../core/layers/backgroundFill.js";
-import { isCustomEntry } from "./layerSlots.js";
 import { composeOrderedLayers, placeToolOverlays } from "./layerOrder.js";
+import { isCustomEntry } from "./layerSlots.js";
 import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
 
-//#region src/canvas/useLayerStack.ts
+// src/canvas/useLayerStack.ts
 /** The `layers` prop's slots and custom entries in draw order, with the background fill beneath,
 *  the decoration layer above, and the active tool's overlays placed among them. */
 function useSlotLayers(layersMap, tools, backgroundFill, decorationLayer) {
@@ -71,6 +71,5 @@ function useComposedLayers(layers, above, requestRedraw) {
 	return composed;
 }
 
-//#endregion
 export { useComposedLayers, useSlotLayers };
 //# sourceMappingURL=useLayerStack.js.map

package/dist/canvas/usePaintedCursor.js

@@ -2,7 +2,7 @@ import { createPaintedCursorLayer } from "./paintedCursorLayer.js";
 import { useEffect, useMemo } from "react";
 import { createCursorSink, createPaintedCursorState } from "@weasel-js/cursor";
 
-//#region src/canvas/usePaintedCursor.ts
+// src/canvas/usePaintedCursor.ts
 /**
 * The painted cursor tier's channel. The canvas owns it because it owns both ends: the tool
 * cursor that feeds it and the frame loop that has to repaint when it changes.
@@ -23,6 +23,5 @@ function usePaintedCursor(canvasRef, requestRedraw) {
 	};
 }
 
-//#endregion
 export { usePaintedCursor };
 //# sourceMappingURL=usePaintedCursor.js.map

package/dist/canvas/useRedrawOn.js

@@ -1,6 +1,6 @@
 import { useEffect, useState } from "react";
 
-//#region src/canvas/useRedrawOn.ts
+// src/canvas/useRedrawOn.ts
 /** Subscribe `requestRedraw` to each source while mounted. An inline array
 *  holding the same sources does not resubscribe. */
 function useRedrawOn(sources, requestRedraw) {
@@ -26,6 +26,5 @@ function useSameElements(list) {
 	return kept;
 }
 
-//#endregion
 export { useRedrawOn };
 //# sourceMappingURL=useRedrawOn.js.map

package/dist/canvas/useSceneAdapter.js

@@ -1,7 +1,7 @@
 import { sceneToAdapter } from "./sceneAdapter.js";
 import { useMemo } from "react";
 
-//#region src/canvas/useSceneAdapter.ts
+// src/canvas/useSceneAdapter.ts
 /**
 * React-hook wrapper around `sceneToAdapter`. Memoizes on every option, so
 * the adapter keeps its identity across renders unless one of them changes.
@@ -24,6 +24,5 @@ function useSceneAdapter(scene, options = {}) {
 	]);
 }
 
-//#endregion
 export { useSceneAdapter };
 //# sourceMappingURL=useSceneAdapter.js.map

package/dist/canvas/useSceneLayerList.js

@@ -1,6 +1,6 @@
 import { useCallback, useSyncExternalStore } from "react";
 
-//#region src/canvas/useSceneLayerList.ts
+// src/canvas/useSceneLayerList.ts
 var UNSUBSCRIBED = () => {};
 var read = (adapter) => typeof adapter?.getLayers === "function" ? adapter.getLayers().map((l) => l.id).join("\n") : "";
 /**
@@ -14,6 +14,5 @@ function useSceneLayerList(adapter) {
 	return useSyncExternalStore(subscribe, snapshot, snapshot);
 }
 
-//#endregion
 export { useSceneLayerList };
 //# sourceMappingURL=useSceneLayerList.js.map

package/dist/canvas/useSurfaceInput.js

@@ -2,7 +2,7 @@ import { useLayoutEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 import { heldPointers } from "@weasel-js/gestures";
 
-//#region src/canvas/useSurfaceInput.ts
+// src/canvas/useSurfaceInput.ts
 /**
 * Listen on whichever element `elementRef` holds, moving the listeners when
 * it holds another. Handlers are read at event time, so a new set never
@@ -53,6 +53,5 @@ function listen(element, live) {
 	};
 }
 
-//#endregion
 export { useSurfaceInput };
 //# sourceMappingURL=useSurfaceInput.js.map

package/dist/canvas/useSurfaceSize.js

@@ -2,7 +2,7 @@ import { useElementSize } from "../core/viewport/useCanvasSize.js";
 import { useEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useSurfaceSize.ts
+// src/canvas/useSurfaceSize.ts
 var NO_ELEMENT = { current: null };
 var FILL = { beforePaint: true };
 /**
@@ -39,6 +39,5 @@ function useSurfaceSize(props, element) {
 	};
 }
 
-//#endregion
 export { useSurfaceSize };
 //# sourceMappingURL=useSurfaceSize.js.map

package/dist/canvas/useToolCursor.js

@@ -1,7 +1,7 @@
 import { useLayoutEffect } from "react";
 import { resolveCursorTier } from "@weasel-js/cursor";
 
-//#region src/canvas/useToolCursor.ts
+// src/canvas/useToolCursor.ts
 function resolveToolsCursor(tools) {
 	const id = tools.hotkeyEngaged ?? tools.active;
 	const tool = id === null ? void 0 : tools.registry[id];
@@ -33,6 +33,5 @@ function useToolCursor(sink, tools, element, rest) {
 	]);
 }
 
-//#endregion
 export { useToolCursor };
 //# sourceMappingURL=useToolCursor.js.map

package/dist/canvas/useViewAim.js

@@ -1,13 +1,13 @@
 import { normalizeView } from "../core/viewport/view.js";
-import { isRectAim, rectAim, viewForAim } from "../domains/viewports/aim.js";
 import { viewportWorldRect } from "../core/viewport/viewportWorldRect.js";
+import { isRectAim, rectAim, viewForAim } from "../domains/viewports/aim.js";
 import { useCanvasView } from "./useCanvasView.js";
 import { sizeOf } from "./useViewNesting.js";
 import { IDENTITY_VIEW, UNMEASURED_DIMS } from "./viewRegistry.js";
 import { useCallback } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewAim.ts
+// src/canvas/useViewAim.ts
 /**
 * A `<CanvasView>`'s camera and its aim, whichever of the two the view holds.
 * A camera-held view answers its aim from its camera; an aim-held one derives
@@ -116,6 +116,5 @@ function useViewAim(args) {
 	};
 }
 
-//#endregion
 export { useViewAim };
 //# sourceMappingURL=useViewAim.js.map

package/dist/canvas/useViewHelpers.js

@@ -1,12 +1,12 @@
-import { unionAABB } from "../core/geometry/unionBounds.js";
 import { framedBounds } from "../core/geometry/poseDescriptor.js";
 import { useInFlightBounds } from "./useInFlightBounds.js";
+import { unionAABB } from "../core/geometry/unionBounds.js";
 import { buildChromeState } from "../core/selection/chromeState.js";
 import { drawnBoundsOf } from "./drawnBounds.js";
 import { useCallback, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewHelpers.ts
+// src/canvas/useViewHelpers.ts
 var noOpUnsubscribe = () => {};
 var alwaysVisible = () => true;
 function worldPoseOf(adapter, id) {
@@ -60,11 +60,13 @@ function useViewHelpers(opts) {
 	}, [adapter]);
 	const selectionRef = useLatest(selection);
 	const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);
+	const worldOfStored = useMemo(() => adapter?.worldOfStored ? (id, stored) => adapter.worldOfStored(id, stored) : void 0, [adapter]);
 	const { previewPoseOf, previewBoundsOf } = useInFlightBounds({
 		gestureSource,
 		previewPoseExtra,
 		boxOf,
-		committedPoseOf
+		committedPoseOf,
+		worldOfStored
 	});
 	/**
 	* Bounds for `id` with any in-flight gesture folded in — what the user can
@@ -128,6 +130,5 @@ function useViewHelpers(opts) {
 	} };
 }
 
-//#endregion
 export { useViewHelpers };
 //# sourceMappingURL=useViewHelpers.js.map

package/dist/canvas/useViewHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"useViewHelpers.js","names":[],"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 { useInFlightBounds } from './useInFlightBounds';\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';\nimport type { Scale2 } from '@weasel-js/geom';\nimport { drawnBoundsOf, type DrawnBoundsScene } from './drawnBounds';\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  /** The node an id names, whose `layer` decides whether a view that hides\n   *  that layer shows its selection chrome. */\n  getNode?(id: string): { layer?: string } | undefined;\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  /** The nodes the adapter's ids name: with them, the fallbacks box each as\n   *  drawn, stroke included, rather than by its pose. */\n  nodes?: DrawnBoundsScene | undefined;\n  /** The view's scale, which a screen-pixel stroke is resolved at. Default 1. */\n  getScale?: (() => Scale2) | undefined;\n  /** The ids selected, read whenever chrome asks: a view following another\n   *  reads that view's, which changes without this one rendering. */\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  /** Whether a scene layer reaches the screen in this view. Absent means\n   *  every layer the scene shows does. */\n  layerIsPainted?: ((layerId: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\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, nodes, getScale, selection, gestureSource,\n    previewPoseExtra, getIsVisible, layerIsPainted,\n  } = opts;\n  const getScaleRef = useLatest(getScale);\n  const poseBoxOf = useCallback((id: string, pose: TPose): Bounds => {\n    if (!nodes) return framedBounds(pose, geometry);\n    const scale = getScaleRef.current?.();\n    return drawnBoundsOf(nodes, id as NodeId, pose, {\n      descriptor: geometry as PoseDescriptor<unknown>,\n      ...(adapter ? { worldPoseOf: (m: NodeId) => worldPoseOf(adapter, m) } : {}),\n      ...(scale ? { scale } : {}),\n    });\n  }, [nodes, geometry, adapter, getScaleRef]);\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : poseBoxOf(id, pose)),\n    [boundsOfPose, poseBoxOf],\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 poseBoxOf(id, worldPoseOf(adapter, id));\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, poseBoxOf]);\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 selectionRef = useLatest(selection);\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n  const { previewPoseOf, previewBoundsOf } = useInFlightBounds({ gestureSource, previewPoseExtra, boxOf, committedPoseOf });\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      get selection() { return selectionRef.current(); },\n      get multiActive() { return selectionRef.current().length > 1; },\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      ...(layerIsPainted ? { layerIsPainted } : {}),\n      ...(adapter?.getNode ? { layerOf: (id: string) => adapter.getNode?.(id)?.layer } : {}),\n    }),\n    [selectionRef, boundsWithPreview, geometry, committedPoseOf, layerIsPainted, adapter],\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 };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useViewHelpers.js","names":[],"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 { useInFlightBounds } from './useInFlightBounds';\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';\nimport type { Scale2 } from '@weasel-js/geom';\nimport { drawnBoundsOf, type DrawnBoundsScene } from './drawnBounds';\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  /** Where `id` is drawn if it stores `stored`. An adapter without it stores\n   *  absolute poses. */\n  worldOfStored?(id: string, stored: TPose): TPose;\n  /** The node an id names, whose `layer` decides whether a view that hides\n   *  that layer shows its selection chrome. */\n  getNode?(id: string): { layer?: string } | undefined;\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  /** The nodes the adapter's ids name: with them, the fallbacks box each as\n   *  drawn, stroke included, rather than by its pose. */\n  nodes?: DrawnBoundsScene | undefined;\n  /** The view's scale, which a screen-pixel stroke is resolved at. Default 1. */\n  getScale?: (() => Scale2) | undefined;\n  /** The ids selected, read whenever chrome asks: a view following another\n   *  reads that view's, which changes without this one rendering. */\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  /** Whether a scene layer reaches the screen in this view. Absent means\n   *  every layer the scene shows does. */\n  layerIsPainted?: ((layerId: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\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, nodes, getScale, selection, gestureSource,\n    previewPoseExtra, getIsVisible, layerIsPainted,\n  } = opts;\n  const getScaleRef = useLatest(getScale);\n  const poseBoxOf = useCallback((id: string, pose: TPose): Bounds => {\n    if (!nodes) return framedBounds(pose, geometry);\n    const scale = getScaleRef.current?.();\n    return drawnBoundsOf(nodes, id as NodeId, pose, {\n      descriptor: geometry as PoseDescriptor<unknown>,\n      ...(adapter ? { worldPoseOf: (m: NodeId) => worldPoseOf(adapter, m) } : {}),\n      ...(scale ? { scale } : {}),\n    });\n  }, [nodes, geometry, adapter, getScaleRef]);\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : poseBoxOf(id, pose)),\n    [boundsOfPose, poseBoxOf],\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 poseBoxOf(id, worldPoseOf(adapter, id));\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, poseBoxOf]);\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 selectionRef = useLatest(selection);\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n  const worldOfStored = useMemo(\n    () => (adapter?.worldOfStored ? (id: string, stored: TPose) => adapter.worldOfStored!(id, stored) : undefined),\n    [adapter],\n  );\n  const { previewPoseOf, previewBoundsOf } = useInFlightBounds({\n    gestureSource, previewPoseExtra, boxOf, committedPoseOf, worldOfStored,\n  });\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      get selection() { return selectionRef.current(); },\n      get multiActive() { return selectionRef.current().length > 1; },\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      ...(layerIsPainted ? { layerIsPainted } : {}),\n      ...(adapter?.getNode ? { layerOf: (id: string) => adapter.getNode?.(id)?.layer } : {}),\n    }),\n    [selectionRef, boundsWithPreview, geometry, committedPoseOf, layerIsPainted, adapter],\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 };\n}\n"],"mappings":"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"}

package/dist/canvas/useViewLayerGate.js

@@ -2,7 +2,7 @@ import { createSceneLayerGate } from "./sceneLayerPaint.js";
 import { useCallback, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewLayerGate.ts
+// src/canvas/useViewLayerGate.ts
 /**
 * Whether a surface's own view paints a scene layer, judged against the stack
 * `surfaceLayers` returns, read at ask time, so a consumer slot anchored
@@ -24,6 +24,5 @@ function useViewLayerGate(layerVisibility, layerOrder, surfaceLayers) {
 	return layerVisibility !== void 0 || layerOrder !== void 0 ? layerIsPainted : void 0;
 }
 
-//#endregion
 export { useViewLayerGate };
 //# sourceMappingURL=useViewLayerGate.js.map

package/dist/canvas/useViewNesting.js

@@ -1,7 +1,7 @@
 import { createSceneLayerGate, viewPaintedLayers } from "./sceneLayerPaint.js";
 import { useCallback, useRef, useState } from "react";
 
-//#region src/canvas/useViewNesting.ts
+// src/canvas/useViewNesting.ts
 /**
 * How a `<CanvasView>` sits in the view it is nested in: the frame its
 * `bounds` and derived camera are measured against, and the layers it may
@@ -127,6 +127,5 @@ function useViewNesting(registry, live) {
 	};
 }
 
-//#endregion
 export { NO_RECT, sizeOf, useViewNesting };
 //# sourceMappingURL=useViewNesting.js.map

package/dist/canvas/useViewRegistrySurface.js

@@ -1,7 +1,7 @@
 import { useEffect } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewRegistrySurface.ts
+// src/canvas/useViewRegistrySurface.ts
 /**
 * Attach this canvas to the view registry as its surface. The stack a view paints through its
 * own camera is this canvas's `layers`, before the views themselves are folded in — otherwise
@@ -41,6 +41,5 @@ function useViewRegistrySurface(viewRegistry, layers, frame, services) {
 	]);
 }
 
-//#endregion
 export { useViewRegistrySurface };
 //# sourceMappingURL=useViewRegistrySurface.js.map

package/dist/canvas/viewInputs.js

@@ -1,7 +1,7 @@
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/viewInputs.tsx
+// src/canvas/viewInputs.tsx
 var ViewInputsContext = createContext(null);
 /** @internal */
 function ViewInputsProvider({ value, children }) {
@@ -15,6 +15,5 @@ function useOptionalViewInputs() {
 	return useContext(ViewInputsContext);
 }
 
-//#endregion
 export { ViewInputsProvider, useOptionalViewInputs };
 //# sourceMappingURL=viewInputs.js.map

package/dist/canvas/viewMarkers.js

@@ -2,7 +2,7 @@ import { aimSpace2d } from "../domains/viewports/aim.js";
 import { createViewMarkerLayer, grabViewMarker } from "../domains/viewports/viewMarker.js";
 import { layerAffordance } from "./affordanceAt.js";
 
-//#region src/canvas/viewMarkers.ts
+// src/canvas/viewMarkers.ts
 /** @internal */
 function createViewMarkerRegistry(markers, deps) {
 	let gate = null;
@@ -58,6 +58,5 @@ function createViewMarkerRegistry(markers, deps) {
 	};
 }
 
-//#endregion
 export { createViewMarkerRegistry };
 //# sourceMappingURL=viewMarkers.js.map

package/dist/canvas/viewRegistry.js

@@ -6,7 +6,7 @@ import { createEmitter } from "@weasel-js/registry";
 import { createContext, useContext, useMemo, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/viewRegistry.tsx
+// src/canvas/viewRegistry.tsx
 /**
 * The seam between a canvas surface and the views drawn on it.
 *
@@ -186,6 +186,5 @@ var IDENTITY_VIEW = {
 	}
 };
 
-//#endregion
 export { IDENTITY_VIEW, UNMEASURED_DIMS, ViewRegistryProvider, surfaceLocal, useOptionalViewRegistry };
 //# sourceMappingURL=viewRegistry.js.map

package/dist/canvas/viewSnap.js

@@ -1,6 +1,6 @@
 import { sameView } from "../core/viewport/view.js";
 
-//#region src/canvas/viewSnap.ts
+// src/canvas/viewSnap.ts
 /** A move within this of a whole device pixel is one: the renderer's own slack. */
 var SLACK = 1e-4;
 /**
@@ -62,6 +62,5 @@ function whole(n) {
 	return Math.abs(n - Math.round(n)) <= SLACK;
 }
 
-//#endregion
 export { ViewSnap };
 //# sourceMappingURL=viewSnap.js.map

package/dist/canvas/watchElementMove.js

@@ -1,4 +1,4 @@
-//#region src/canvas/watchElementMove.ts
+// src/canvas/watchElementMove.ts
 /**
 * Call `onMove` when `element`'s box moves in the viewport for a reason no
 * event reports: a sibling collapsing, content loading above it. A scroll or a
@@ -76,6 +76,5 @@ function watchElementMove(element, onMove) {
 	return stop;
 }
 
-//#endregion
 export { watchElementMove };
 //# sourceMappingURL=watchElementMove.js.map

package/dist/canvas/wrapNodeOutput.js

@@ -1,7 +1,7 @@
 import { wrapWithPoseRotation } from "./poseRotation.js";
 import { overChildren, splitOverChildren } from "./overChildren.js";
 
-//#region src/canvas/wrapNodeOutput.ts
+// src/canvas/wrapNodeOutput.ts
 /** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.
 *  Both wraps are skipped when they would be no-ops (zero/absent rotation,
 *  alpha exactly 1, empty command list), so an upright opaque node emits the
@@ -21,6 +21,5 @@ function wrapPart(cmds, pose, alpha) {
 	return rotated;
 }
 
-//#endregion
 export { wrapNodeOutput };
 //# sourceMappingURL=wrapNodeOutput.js.map

package/dist/core/adapters/testing/rootsTree.js

@@ -1,4 +1,4 @@
-//#region src/core/adapters/testing/rootsTree.ts
+// src/core/adapters/testing/rootsTree.ts
 /** The tree of a fake adapter whose nodes never nest: every id in `order` is a root, bottom
 *  first. `setChildOrder` rewrites `order` in place. */
 function rootsTree(order = [], nodeOf = () => void 0) {
@@ -12,6 +12,5 @@ function rootsTree(order = [], nodeOf = () => void 0) {
 	};
 }
 
-//#endregion
 export { rootsTree };
 //# sourceMappingURL=rootsTree.js.map

package/dist/core/applyOps.js

@@ -1,4 +1,4 @@
-//#region src/core/applyOps.ts
+// src/core/applyOps.ts
 /**
 * Default `applyOps` implementation: apply each op in order against
 * `adapter`. Used by hooks when an adapter omits `applyOps`. Apps that
@@ -23,6 +23,5 @@ function dispatchApplyBatch(adapter, ops, label) {
 	else applyOpsTo(adapter, ops, label);
 }
 
-//#endregion
 export { applyOpsTo, dispatchApplyBatch };
 //# sourceMappingURL=applyOps.js.map

package/dist/core/device/targets.js

@@ -1,4 +1,4 @@
-//#region src/core/device/targets.ts
+// src/core/device/targets.ts
 /**
 * Base sizes for grabbable chrome, in CSS pixels at `targetScale = 1`, and the
 * one accessor that resolves them for a live pointer type.
@@ -33,6 +33,5 @@ function targetSizesPx(targetScale = 1, base = {}) {
 	};
 }
 
-//#endregion
 export { ANCHOR_HIT_BASE_PX, HANDLE_BASE_PX, ROTATION_HANDLE_BASE_PX, targetSizesPx };
 //# sourceMappingURL=targets.js.map

package/dist/core/device/useDeviceProfile.js

@@ -2,7 +2,7 @@ import { watchDevicePixelRatio } from "./watchDevicePixelRatio.js";
 import { createContext, createElement, useContext, useEffect, useMemo, useState } from "react";
 import { DEFAULT_DEVICE_PROFILE, resolveDeviceProfile } from "@weasel-js/routing";
 
-//#region src/core/device/useDeviceProfile.ts
+// src/core/device/useDeviceProfile.ts
 var COARSE_QUERY = "(pointer: coarse)";
 var HOVER_QUERY = "(hover: hover)";
 function hasMatchMedia() {
@@ -98,6 +98,5 @@ function DeviceProfileProvider({ value, children }) {
 	return createElement(DeviceProfileContext.Provider, { value: profile }, children);
 }
 
-//#endregion
 export { DeviceProfileProvider, useDeviceProfile };
 //# sourceMappingURL=useDeviceProfile.js.map