@weasel-js/core 1.14.2 → 1.15.1

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

@@ -1,21 +1,22 @@
 import { useElementSize } from "../core/viewport/useCanvasSize.js";
-import { useLayoutEffect, useRef } from "react";
+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 };
 /**
 * The CSS-pixel size a canvas host paints at: its `width` and `height`, with
 * an axis left out measured off `element`, which fills its parent on it.
 */
 function useSurfaceSize(props, element) {
 	const fills = props.width === void 0 || props.height === void 0;
-	const measured = useElementSize(fills ? element : NO_ELEMENT);
+	const measured = useElementSize(fills ? element : NO_ELEMENT, FILL);
 	const width = props.width ?? measured.width;
 	const height = props.height ?? measured.height;
 	const onResize = useLatest(props.onResize);
 	const reported = useRef(null);
-	useLayoutEffect(() => {
+	useEffect(() => {
 		if (width === 0 || height === 0) return;
 		const was = reported.current;
 		if (was && was.width === width && was.height === height) return;
@@ -38,6 +39,5 @@ function useSurfaceSize(props, element) {
 	};
 }
 
-//#endregion
 export { useSurfaceSize };
 //# sourceMappingURL=useSurfaceSize.js.map

package/dist/canvas/useSurfaceSize.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSurfaceSize.js","names":[],"sources":["../../src/canvas/useSurfaceSize.ts"],"sourcesContent":["import { useLayoutEffect, useRef, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { CanvasSize } from 'core/viewport/clampView';\nimport { useElementSize } from 'core/viewport/useCanvasSize';\n\n/** The size props every canvas host takes. */\nexport interface SurfaceSizeProps {\n  /** CSS-pixel width. Omit it, or `height`, and the element fills its parent\n   *  on that axis and is measured: the parent's box decides the size, and the\n   *  canvas adds nothing to it, so the parent needs a size of its own. Nothing\n   *  paints until the measurement lands. */\n  width?: number;\n  /** CSS-pixel height. Omit it to fill, as `width`. */\n  height?: number;\n  /** Every size the surface takes, once at mount and again on each change —\n   *  the measured one for an axis left to fill. */\n  onResize?: (size: CanvasSize) => void;\n}\n\nconst NO_ELEMENT: RefObject<HTMLElement | null> = { current: null };\n\n/**\n * The CSS-pixel size a canvas host paints at: its `width` and `height`, with\n * an axis left out measured off `element`, which fills its parent on it.\n */\nexport function useSurfaceSize(props: SurfaceSizeProps, element: RefObject<HTMLElement | null>): CanvasSize {\n  const fills = props.width === undefined || props.height === undefined;\n  const measured = useElementSize(fills ? element : NO_ELEMENT);\n  const width = props.width ?? measured.width;\n  const height = props.height ?? measured.height;\n\n  const onResize = useLatest(props.onResize);\n  const reported = useRef<CanvasSize | null>(null);\n  useLayoutEffect(() => {\n    // A filling axis reads 0 until measured, and that is no size to report.\n    if (width === 0 || height === 0) return;\n    const was = reported.current;\n    if (was && was.width === width && was.height === height) return;\n    reported.current = { width, height };\n    onResize.current?.({ width, height });\n  }, [width, height, onResize]);\n\n  return { width, height };\n}\n"],"mappings":";;;;;AAmBA,IAAM,aAA4C,EAAE,SAAS,KAAK;;;;;AAMlE,SAAgB,eAAe,OAAyB,SAAoD;CAC1G,MAAM,QAAQ,MAAM,UAAU,UAAa,MAAM,WAAW;CAC5D,MAAM,WAAW,eAAe,QAAQ,UAAU,UAAU;CAC5D,MAAM,QAAQ,MAAM,SAAS,SAAS;CACtC,MAAM,SAAS,MAAM,UAAU,SAAS;CAExC,MAAM,WAAW,UAAU,MAAM,QAAQ;CACzC,MAAM,WAAW,OAA0B,IAAI;CAC/C,sBAAsB;EAEpB,IAAI,UAAU,KAAK,WAAW,GAAG;EACjC,MAAM,MAAM,SAAS;EACrB,IAAI,OAAO,IAAI,UAAU,SAAS,IAAI,WAAW,QAAQ;EACzD,SAAS,UAAU;GAAE;GAAO;EAAO;EACnC,SAAS,UAAU;GAAE;GAAO;EAAO,CAAC;CACtC,GAAG;EAAC;EAAO;EAAQ;CAAQ,CAAC;CAE5B,OAAO;EAAE;EAAO;CAAO;AACzB"}
+{"version":3,"file":"useSurfaceSize.js","names":[],"sources":["../../src/canvas/useSurfaceSize.ts"],"sourcesContent":["import { useEffect, useRef, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { CanvasSize } from 'core/viewport/clampView';\nimport { useElementSize } from 'core/viewport/useCanvasSize';\n\n/** The size props every canvas host takes. */\nexport interface SurfaceSizeProps {\n  /** CSS-pixel width. Omit it, or `height`, and the element fills its parent\n   *  on that axis and is measured: the parent's box decides the size, and the\n   *  canvas adds nothing to it, so the parent needs a size of its own. Nothing\n   *  paints until the measurement lands. */\n  width?: number;\n  /** CSS-pixel height. Omit it to fill, as `width`. */\n  height?: number;\n  /** Every size the surface takes, once at mount and again on each change —\n   *  the measured one for an axis left to fill. */\n  onResize?: (size: CanvasSize) => void;\n}\n\nconst NO_ELEMENT: RefObject<HTMLElement | null> = { current: null };\nconst FILL = { beforePaint: true };\n\n/**\n * The CSS-pixel size a canvas host paints at: its `width` and `height`, with\n * an axis left out measured off `element`, which fills its parent on it.\n */\nexport function useSurfaceSize(props: SurfaceSizeProps, element: RefObject<HTMLElement | null>): CanvasSize {\n  const fills = props.width === undefined || props.height === undefined;\n  // The canvas element is all a filling host lays out, so it can take its size inside the resize callback.\n  const measured = useElementSize(fills ? element : NO_ELEMENT, FILL);\n  const width = props.width ?? measured.width;\n  const height = props.height ?? measured.height;\n\n  const onResize = useLatest(props.onResize);\n  const reported = useRef<CanvasSize | null>(null);\n  // Passive, so a consumer's state set from it renders after the resize callback rather than inside it.\n  useEffect(() => {\n    // A filling axis reads 0 until measured, and that is no size to report.\n    if (width === 0 || height === 0) return;\n    const was = reported.current;\n    if (was && was.width === width && was.height === height) return;\n    reported.current = { width, height };\n    onResize.current?.({ width, height });\n  }, [width, height, onResize]);\n\n  return { width, height };\n}\n"],"mappings":";;;;;AAmBA,IAAM,aAA4C,EAAE,SAAS,KAAK;AAClE,IAAM,OAAO,EAAE,aAAa,KAAK;;;;;AAMjC,SAAgB,eAAe,OAAyB,SAAoD;CAC1G,MAAM,QAAQ,MAAM,UAAU,UAAa,MAAM,WAAW;CAE5D,MAAM,WAAW,eAAe,QAAQ,UAAU,YAAY,IAAI;CAClE,MAAM,QAAQ,MAAM,SAAS,SAAS;CACtC,MAAM,SAAS,MAAM,UAAU,SAAS;CAExC,MAAM,WAAW,UAAU,MAAM,QAAQ;CACzC,MAAM,WAAW,OAA0B,IAAI;CAE/C,gBAAgB;EAEd,IAAI,UAAU,KAAK,WAAW,GAAG;EACjC,MAAM,MAAM,SAAS;EACrB,IAAI,OAAO,IAAI,UAAU,SAAS,IAAI,WAAW,QAAQ;EACzD,SAAS,UAAU;GAAE;GAAO;EAAO;EACnC,SAAS,UAAU;GAAE;GAAO;EAAO,CAAC;CACtC,GAAG;EAAC;EAAO;EAAQ;CAAQ,CAAC;CAE5B,OAAO;EAAE;EAAO;CAAO;AACzB"}

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

package/dist/core/device/useTargetBasePx.js

@@ -1,7 +1,7 @@
 import { useMemo } from "react";
 import { useKitSetting } from "@weasel-js/react";
 
-//#region src/core/device/useTargetBasePx.ts
+// src/core/device/useTargetBasePx.ts
 /** The unscaled chrome sizes the `targets` kit settings give, for `targetSizesPx`'s `base`. */
 function useTargetBasePx() {
 	const handle = useKitSetting("targets.handlePx");
@@ -18,6 +18,5 @@ function useTargetBasePx() {
 	]);
 }
 
-//#endregion
 export { useTargetBasePx };
 //# sourceMappingURL=useTargetBasePx.js.map

package/dist/core/device/watchDevicePixelRatio.js

@@ -1,4 +1,4 @@
-//#region src/core/device/watchDevicePixelRatio.ts
+// src/core/device/watchDevicePixelRatio.ts
 /**
 * Call `onChange` each time `window.devicePixelRatio` changes: the window
 * moved to a display of another density, or the page zoomed. Returns the
@@ -29,6 +29,5 @@ function watchDevicePixelRatio(onChange) {
 	};
 }
 
-//#endregion
 export { watchDevicePixelRatio };
 //# sourceMappingURL=watchDevicePixelRatio.js.map

package/dist/core/geometry/autoPoseDescriptor.js

@@ -1,7 +1,7 @@
-import { RECT_POSE_DESCRIPTOR } from "./poseDescriptor.js";
 import { pathPoseDescriptor } from "./pathPoseDescriptor.js";
+import { RECT_POSE_DESCRIPTOR } from "./poseDescriptor.js";
 
-//#region src/core/geometry/autoPoseDescriptor.ts
+// src/core/geometry/autoPoseDescriptor.ts
 /** True for Path-shaped poses (`{kind: 'polygon' | 'rect'}`). Useful for
 *  callers that need to fork between `pathPoseDescriptor` and
 *  `RECT_POSE_DESCRIPTOR` without forcing the consumer to wire
@@ -41,6 +41,5 @@ var AUTO_POSE_DESCRIPTOR = {
 	}
 };
 
-//#endregion
 export { AUTO_POSE_DESCRIPTOR, isPathLike, isRectPose };
 //# sourceMappingURL=autoPoseDescriptor.js.map

package/dist/core/geometry/booleanOfPaths.js

@@ -1,6 +1,6 @@
 import { pathExclude, pathIntersect, pathSubtract, pathUnion } from "@weasel-js/geom/booleans";
 
-//#region src/core/geometry/booleanOfPaths.ts
+// src/core/geometry/booleanOfPaths.ts
 /**
 * `op` over `paths`, given back to front, as one path. Subtract is
 * Illustrator's "Minus Front": the backmost less everything in front of it.
@@ -18,6 +18,5 @@ function booleanOfPaths(op, paths) {
 	}
 }
 
-//#endregion
 export { booleanOfPaths };
 //# sourceMappingURL=booleanOfPaths.js.map

package/dist/core/geometry/inkExtents.js

@@ -1,6 +1,6 @@
 import { localToWorld, targetTransformOf } from "./targetFrame.js";
 
-//#region src/core/geometry/inkExtents.ts
+// src/core/geometry/inkExtents.ts
 var NO_INK_EXTENTS = Object.freeze({
 	left: 0,
 	top: 0,
@@ -55,6 +55,5 @@ function insetBox(box, e) {
 	});
 }
 
-//#endregion
 export { NO_INK_EXTENTS, inkExtentsBetween, insetBox, isNoInkExtents, outsetBox };
 //# sourceMappingURL=inkExtents.js.map

package/dist/core/geometry/pathPoseDescriptor.js

@@ -1,6 +1,6 @@
 import { boundsOfPath, boxToBox, coordsFrom, lerpCorners, transformPath, translatePath, worldCoords } from "@weasel-js/geom";
 
-//#region src/core/geometry/pathPoseDescriptor.ts
+// src/core/geometry/pathPoseDescriptor.ts
 /**
 * `PoseDescriptor` for `Path` poses — wires `useResize` to operate
 * on `Path` directly. `getBounds` defers to the same `boundsOfPath` kernel
@@ -111,6 +111,5 @@ var pathPoseDescriptor = {
 	supportsRotation: () => false
 };
 
-//#endregion
 export { pathPoseDescriptor };
 //# sourceMappingURL=pathPoseDescriptor.js.map

package/dist/core/geometry/poseDescriptor.js

@@ -1,7 +1,7 @@
 import { axisAlignedBounds } from "./unionBounds.js";
 import { multiply, poseLinearOf, rotate } from "@weasel-js/geom";
 
-//#region src/core/geometry/poseDescriptor.ts
+// src/core/geometry/poseDescriptor.ts
 /** A world `lead` expressed in the frame whose world pose is `frameWorld`, for a
 *  pose stored there; `null` is the root frame, where it is unchanged. */
 function leadUnder(pc, frameWorld, lead) {
@@ -235,6 +235,5 @@ function translatePoseViaDescriptor(pose, dx, dy, geometry, lead) {
 	return geometry.remapBounds(pose, src, dst);
 }
 
-//#endregion
 export { RECT_POSE_DESCRIPTOR, ROTATED_POSE_DESCRIPTOR, framedBounds, leadUnder, poseDescriptorForNode, remapRotatedLeaf, translatePoseViaDescriptor, visualBoundsViaDescriptor };
 //# sourceMappingURL=poseDescriptor.js.map