@weasel-js/core 1.15.0 → 1.15.2

package/dist/canvas/CanvasView.js

@@ -1,24 +1,24 @@
+import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import { createViewportLayer } from "../domains/viewports/viewportLayer.js";
-import { useDeviceProfile } from "../core/device/useDeviceProfile.js";
 import { viewportWorldRect } from "../core/viewport/viewportWorldRect.js";
-import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import { useSelection } from "../core/selection/useSelection.js";
 import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
 import { useViewHelpers } from "./useViewHelpers.js";
-import { NO_RECT, sizeOf, useViewNesting } from "./useViewNesting.js";
-import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "./affordanceAt.js";
-import { IDENTITY_VIEW, UNMEASURED_DIMS, surfaceLocal, useOptionalViewRegistry } from "./viewRegistry.js";
 import { useViewAim } from "./useViewAim.js";
 import { hitAtOf } from "./deps/dispatchSources.js";
+import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "./affordanceAt.js";
 import { pathFromPlane } from "./planeClips.js";
+import { useDeviceProfile } from "../core/device/useDeviceProfile.js";
 import { createDispatcherPreviewSources, createGestureSource } from "./SceneCanvas/dispatcherGestureBounds.js";
 import { useOptionalViewInputs } from "./viewInputs.js";
+import { NO_RECT, sizeOf, useViewNesting } from "./useViewNesting.js";
+import { IDENTITY_VIEW, UNMEASURED_DIMS, surfaceLocal, useOptionalViewRegistry } from "./viewRegistry.js";
 import { useCallback, useEffect, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 import { createDispatcher } from "@weasel-js/routing";
 import { useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/CanvasView.tsx
+// src/canvas/CanvasView.tsx
 /**
 * `<CanvasView>` — a second view on an existing canvas: its own camera over a
 * rect of the surface, with input routed to it.
@@ -296,6 +296,5 @@ function CanvasView(props) {
 	return null;
 }
 
-//#endregion
 export { CanvasView };
 //# sourceMappingURL=CanvasView.js.map

package/dist/canvas/CursorCoordsHud.js

@@ -1,12 +1,12 @@
-import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import hud_module_default from "./hud.module.js";
 import { useHostAnchor } from "./useHostAnchor.js";
+import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import { useEffect, useRef, useState } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { decimal, qty } from "@weasel-js/quantity";
 
-//#region src/canvas/CursorCoordsHud.tsx
+// src/canvas/CursorCoordsHud.tsx
 /**
 * Fixed-position dev HUD that shows the cursor's current viewport
 * (client) coords next to the equivalent canvas (world) coords. Pins to the
@@ -140,6 +140,5 @@ function point({ x, y }, places) {
 	return `(${qty(x, at).text}, ${qty(y, at).text})`;
 }
 
-//#endregion
 export { CursorCoordsHud };
 //# sourceMappingURL=CursorCoordsHud.js.map

package/dist/canvas/DrawCanvas.js

@@ -1,14 +1,14 @@
-import { backgroundFillCommands } from "../core/layers/backgroundFill.js";
-import { normalizeView } from "../core/viewport/view.js";
 import { useCanvasSurface } from "./useCanvasSurface.js";
 import { SurfaceCanvas } from "./SurfaceCanvas.js";
 import { useSurfaceSize } from "./useSurfaceSize.js";
+import { backgroundFillCommands } from "../core/layers/backgroundFill.js";
+import { normalizeView } from "../core/viewport/view.js";
 import { viewToMat3 } from "@weasel-js/geom";
 import { useCallback, useRef } from "react";
 import { assignRef } from "@weasel-js/react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/DrawCanvas.tsx
+// src/canvas/DrawCanvas.tsx
 /**
 * `<DrawCanvas>` — a sized, DPR-correct WebGL2 surface that paints a list of
 * draw commands, with no scene, tools or dispatcher behind it.
@@ -82,6 +82,5 @@ function DrawCanvas(props) {
 	});
 }
 
-//#endregion
 export { DrawCanvas };
 //# sourceMappingURL=DrawCanvas.js.map

package/dist/canvas/GestureReason.js

@@ -6,7 +6,7 @@ import { useEffect, useState } from "react";
 import { overlaysOf } from "@weasel-js/routing";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/GestureReason.tsx
+// src/canvas/GestureReason.tsx
 /**
 * The reason an in-flight gesture cannot land where it is, beside the pointer:
 * the DOM half of the `reason` overlay, which the canvas layers cannot paint
@@ -59,6 +59,5 @@ function GestureReason({ dispatcher, canvasRef, viewRef }) {
 	});
 }
 
-//#endregion
 export { GestureReason };
 //# sourceMappingURL=GestureReason.js.map

package/dist/canvas/GestureReason.module.js

@@ -1,7 +1,6 @@
-//#region src/canvas/GestureReason.module.css
+// src/canvas/GestureReason.module.css
 var reason = "_reason_0cabc7";
 var GestureReason_module_default = { reason };
 
-//#endregion
 export { GestureReason_module_default as default, reason };
 //# sourceMappingURL=GestureReason.module.js.map

package/dist/canvas/LeanSceneCanvas.js

@@ -1,9 +1,9 @@
+import { renderSceneCanvas } from "./SceneCanvas.js";
 import { toolDrivenActions } from "./SceneCanvas/presets/toolDriven.js";
 import { BASELINE_ACTIONS } from "./SceneCanvas/presets/baseline.js";
-import { renderSceneCanvas } from "./SceneCanvas.js";
 import { forwardRef } from "react";
 
-//#region src/canvas/LeanSceneCanvas.tsx
+// src/canvas/LeanSceneCanvas.tsx
 var LEAN_SOURCE = {
 	named: null,
 	pool: toolDrivenActions,
@@ -20,6 +20,5 @@ function LeanSceneCanvasWrapper(props, ref) {
 */
 var LeanSceneCanvas = forwardRef(LeanSceneCanvasWrapper);
 
-//#endregion
 export { LeanSceneCanvas };
 //# sourceMappingURL=LeanSceneCanvas.js.map

package/dist/canvas/ModalityHud.js

@@ -1,9 +1,9 @@
-import hud_module_default from "./hud.module.js";
 import { useHostAnchor } from "./useHostAnchor.js";
+import hud_module_default from "./hud.module.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useOptionalActiveToolContext } from "@weasel-js/routing/react";
 
-//#region src/canvas/ModalityHud.tsx
+// src/canvas/ModalityHud.tsx
 /**
 * Dev HUD reporting the modality state: active mode, active-slot tool, and
 * the hotkey-engaged tool stack. Anchors below `PickHud` in the canvas's
@@ -76,6 +76,5 @@ function ModalityHud({ canvasRef, anchorRef, modeId, offset }) {
 	});
 }
 
-//#endregion
 export { ModalityHud };
 //# sourceMappingURL=ModalityHud.js.map

package/dist/canvas/NodeShape.js

@@ -1,19 +1,19 @@
 import { bumpNodeMemoGeneration, nodeMemo } from "../core/scene/nodeMemo.js";
 import { setDepOutlineReader } from "../core/scene/booleanOfChildren.js";
 import { hasSlop, slopForStrokeHit, widenSlop } from "../core/viewport/screenSlop.js";
-import { derivesPath } from "./nodeShapes/memo.js";
 import { DERIVED_PAINTER } from "./nodeShapes/derivedPainter.js";
-import { paintsPose } from "./nodeShapes/poseBox.js";
 import { IMAGE_PAINTER } from "./nodeShapes/imagePainter.js";
 import { MEASURE_PAINTER } from "./nodeShapes/measurePainter.js";
+import { derivesPath } from "./nodeShapes/memo.js";
 import { PATH_PAINTER } from "./nodeShapes/pathPainter.js";
+import { paintsPose } from "./nodeShapes/poseBox.js";
 import { RECT_FALLBACK_PAINTER } from "./nodeShapes/rectFallbackPainter.js";
 import { SHAPE_PAINTER } from "./nodeShapes/shapePainter.js";
 import { TEXT_PAINTER } from "./nodeShapes/textPainter.js";
 import { pathContainsPoint, pathThroughPoseFrame, strokeHitTest } from "@weasel-js/geom";
 import { glyphGeneration } from "@weasel-js/font";
 
-//#region src/canvas/NodeShape.ts
+// src/canvas/NodeShape.ts
 /**
 * NodeShape — the **shape trait's** registry: the per-kind `paint` + `silhouette` used by
 * `defaultDrawOne`, clipping, non-rect hit-testing, and lasso/area-select. Teaching the kit
@@ -159,6 +159,5 @@ function registerBuiltInShapePainters() {
 	registerNodeShape(RECT_FALLBACK_PAINTER);
 }
 
-//#endregion
 export { DEFAULT_INK, findNodeShape, findShapeBounds, findShapeInk, findShapeSilhouette, getNodeShapes, registerNodeShape, shapeCoversPoint };
 //# sourceMappingURL=NodeShape.js.map

package/dist/canvas/PickHud.js

@@ -1,11 +1,11 @@
 import { clientToWorld } from "../core/viewport/clientToWorld.js";
-import hud_module_default from "./hud.module.js";
 import { useHostAnchor } from "./useHostAnchor.js";
+import hud_module_default from "./hud.module.js";
 import { useEffect, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/canvas/PickHud.tsx
+// src/canvas/PickHud.tsx
 /**
 * Dev HUD listing the ids returned by `pickEvery(world)` under the cursor.
 *
@@ -113,6 +113,5 @@ function PickHud({ canvasRef, anchorRef, viewRef, toWorld, pickEvery, pickBest,
 	});
 }
 
-//#endregion
 export { PickHud };
 //# sourceMappingURL=PickHud.js.map

package/dist/canvas/SceneCanvas/ActionsProviderIfRoot.js

@@ -1,13 +1,12 @@
 import { Fragment, jsx } from "react/jsx-runtime";
 import { ActionsProvider, useActionsRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/ActionsProviderIfRoot.tsx
+// src/canvas/SceneCanvas/ActionsProviderIfRoot.tsx
 /** Mount an `<ActionsProvider>` only when none is already in scope. */
 function ActionsProviderIfRoot({ children }) {
 	if (useActionsRegistry()) return /* @__PURE__ */ jsx(Fragment, { children });
 	return /* @__PURE__ */ jsx(ActionsProvider, { children });
 }
 
-//#endregion
 export { ActionsProviderIfRoot };
 //# sourceMappingURL=ActionsProviderIfRoot.js.map

package/dist/canvas/SceneCanvas/CanvasKitProviders.js

@@ -1,11 +1,11 @@
-import { ViewInputsProvider } from "../viewInputs.js";
-import { PointerProviderIfRoot } from "./PointerProviderIfRoot.js";
 import { SnapSourceRegistryContext, createSnapSourceRegistry } from "../../domains/snap/registry.js";
 import { IconRegistryProviderIfRoot } from "../../iconRegistry/IconRegistryProvider.js";
+import { ViewInputsProvider } from "../viewInputs.js";
+import { PointerProviderIfRoot } from "./PointerProviderIfRoot.js";
 import { useState } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/SceneCanvas/CanvasKitProviders.tsx
+// src/canvas/SceneCanvas/CanvasKitProviders.tsx
 /** The kit providers a canvas mounts around its surface: view inputs and the
 *  snap source registry, then the icon registry and pointer context where none
 *  is already in scope. */
@@ -20,6 +20,5 @@ function CanvasKitProviders({ viewInputs, children }) {
 	});
 }
 
-//#endregion
 export { CanvasKitProviders };
 //# sourceMappingURL=CanvasKitProviders.js.map

package/dist/canvas/SceneCanvas/DepRegistryProviderIfRoot.js

@@ -1,7 +1,7 @@
 import { Fragment, jsx } from "react/jsx-runtime";
 import { DepRegistryProvider, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/DepRegistryProviderIfRoot.tsx
+// src/canvas/SceneCanvas/DepRegistryProviderIfRoot.tsx
 /** Mount a `<DepRegistryProvider>` only when none is already in scope, so a
 *  consumer's dep sources are not shadowed by a nested canvas. */
 function DepRegistryProviderIfRoot({ children }) {
@@ -9,6 +9,5 @@ function DepRegistryProviderIfRoot({ children }) {
 	return /* @__PURE__ */ jsx(DepRegistryProvider, { children });
 }
 
-//#endregion
 export { DepRegistryProviderIfRoot };
 //# sourceMappingURL=DepRegistryProviderIfRoot.js.map

package/dist/canvas/SceneCanvas/DevHuds.js

@@ -5,7 +5,7 @@ import { useCallback } from "react";
 import { useLatest } from "@weasel-js/react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/canvas/SceneCanvas/DevHuds.tsx
+// src/canvas/SceneCanvas/DevHuds.tsx
 /**
 * `<SceneCanvas>`'s dev HUDs: the cursor readout, the pick list, and the
 * modality panel, each a fixed-position widget pinned to the canvas.
@@ -50,6 +50,5 @@ function canvasDebug(debug) {
 	return rest;
 }
 
-//#endregion
 export { DevHuds, canvasDebug };
 //# sourceMappingURL=DevHuds.js.map

package/dist/canvas/SceneCanvas/PointerProviderIfRoot.js

@@ -1,85 +1,37 @@
 import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { worldPointAt } from "./worldPointAt.js";
-import { useEffect } from "react";
-import { heldPointers } from "@weasel-js/gestures";
+import { usePublishPointer } from "../../input/usePublishPointer.js";
 import { Fragment, jsx } from "react/jsx-runtime";
 import { PointerContextProvider, usePointerContext } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/PointerProviderIfRoot.tsx
-/**
-* Conditional `<PointerContextProvider>` wrapper. Mounts a provider only
-* when no parent provider is in scope — otherwise renders children unwrapped
-* so SceneCanvas defers to the host's existing scope.
-*
-* Pairs with `usePointerPublisher`, which attaches native pointermove/leave
-* listeners to the canvas element and writes world-space coords into the
-* surrounding context's `pointerRef`.
-*/
+// src/canvas/SceneCanvas/PointerProviderIfRoot.tsx
 /** Mount a `<PointerContextProvider>` only when none is already in scope. */
 function PointerProviderIfRoot({ children }) {
 	if (usePointerContext()) return /* @__PURE__ */ jsx(Fragment, { children });
 	return /* @__PURE__ */ jsx(PointerContextProvider, { children });
 }
 /**
-* Attaches native `pointermove` / `pointerleave` listeners to the supplied
-* canvas element and publishes the world-space pointer coordinates into the
-* surrounding `<PointerContextProvider>`. No-op when no provider is in scope
-* (matches "publish if anyone is listening").
-*
-* Called inside the provider scope so it sees both consumer-mounted providers
-* and SceneCanvas's auto-mounted one.
+* Publishes the canvas's pointer into the surrounding `<PointerContextProvider>`
+* through {@link usePublishPointer}, placing it with the surface's view
+* resolver so paste-at-pointer lands in the panel the cursor is over. With no
+* views declared it answers the canvas's own camera and rect.
 */
 function usePointerPublisher(canvasRef, canvasApiRef) {
-	const ctx = usePointerContext();
 	const registry = useOptionalViewRegistry();
-	useEffect(() => {
-		if (!ctx) return;
-		const el = canvasRef.current;
-		if (!el) return;
-		const publish = (pointerId, clientX, clientY) => {
-			const api = canvasApiRef.current;
-			if (!api) return;
-			const target = registry?.resolver.at(pointerId, clientX, clientY);
-			const [worldX, worldY] = worldPointAt(api, target, clientX, clientY);
-			ctx.set({
-				world: {
-					x: worldX,
-					y: worldY
-				},
-				viewId: target?.id ?? null
-			});
-		};
-		const onMove = (e) => publish(e.pointerId, e.clientX, e.clientY);
-		const held = heldPointers(el);
-		const onLeave = (e) => {
-			if (held.count() > 0) {
-				publish(e.pointerId, e.clientX, e.clientY);
-				return;
-			}
-			ctx.set(null);
-		};
-		const onDocMove = (e) => {
-			if (e.target === el) return;
-			if (held.count() === 0) return;
-			publish(e.pointerId, e.clientX, e.clientY);
-		};
-		el.addEventListener("pointermove", onMove);
-		el.addEventListener("pointerleave", onLeave);
-		document.addEventListener("pointermove", onDocMove);
-		return () => {
-			el.removeEventListener("pointermove", onMove);
-			el.removeEventListener("pointerleave", onLeave);
-			document.removeEventListener("pointermove", onDocMove);
-			held.release();
+	usePublishPointer(canvasRef, (pointerId, clientX, clientY) => {
+		const api = canvasApiRef.current;
+		if (!api) return null;
+		const target = registry?.resolver.at(pointerId, clientX, clientY);
+		const [x, y] = worldPointAt(api, target, clientX, clientY);
+		return {
+			world: {
+				x,
+				y
+			},
+			viewId: target?.id ?? null
 		};
-	}, [
-		ctx,
-		canvasRef,
-		canvasApiRef,
-		registry
-	]);
+	});
 }
 
-//#endregion
 export { PointerProviderIfRoot, usePointerPublisher };
 //# sourceMappingURL=PointerProviderIfRoot.js.map

package/dist/canvas/SceneCanvas/PointerProviderIfRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"PointerProviderIfRoot.js","names":["_Fragment"],"sources":["../../../src/canvas/SceneCanvas/PointerProviderIfRoot.tsx"],"sourcesContent":["/**\n * Conditional `<PointerContextProvider>` wrapper. Mounts a provider only\n * when no parent provider is in scope — otherwise renders children unwrapped\n * so SceneCanvas defers to the host's existing scope.\n *\n * Pairs with `usePointerPublisher`, which attaches native pointermove/leave\n * listeners to the canvas element and writes world-space coords into the\n * surrounding context's `pointerRef`.\n */\nimport { useEffect, type MutableRefObject, type ReactNode, type RefObject } from 'react';\nimport { heldPointers } from '@weasel-js/gestures';\nimport { PointerContextProvider, usePointerContext } from '@weasel-js/routing/react';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport { useOptionalViewRegistry } from '../viewRegistry';\nimport { worldPointAt } from './worldPointAt';\n\n/** Mount a `<PointerContextProvider>` only when none is already in scope. */\nexport function PointerProviderIfRoot({ children }: { children: ReactNode }) {\n  const parent = usePointerContext();\n  if (parent) return <>{children}</>;\n  return <PointerContextProvider>{children}</PointerContextProvider>;\n}\n\n/**\n * Attaches native `pointermove` / `pointerleave` listeners to the supplied\n * canvas element and publishes the world-space pointer coordinates into the\n * surrounding `<PointerContextProvider>`. No-op when no provider is in scope\n * (matches \"publish if anyone is listening\").\n *\n * Called inside the provider scope so it sees both consumer-mounted providers\n * and SceneCanvas's auto-mounted one.\n */\nexport function usePointerPublisher(\n  canvasRef: MutableRefObject<HTMLElement | null>,\n  canvasApiRef: RefObject<CanvasExtensionApi | null>,\n): void {\n  const ctx = usePointerContext();\n  const registry = useOptionalViewRegistry();\n  useEffect(() => {\n    if (!ctx) return;\n    const el = canvasRef.current;\n    if (!el) return;\n    // The surface's one resolver answers which camera a client point belongs\n    // to, so paste-at-pointer lands in the panel the cursor is over. With no\n    // views declared it answers the canvas's own camera and rect.\n    const publish = (pointerId: number | null, clientX: number, clientY: number): void => {\n      const api = canvasApiRef.current;\n      if (!api) return;\n      const target = registry?.resolver.at(pointerId, clientX, clientY);\n      const [worldX, worldY] = worldPointAt(api, target, clientX, clientY);\n      ctx.set({ world: { x: worldX, y: worldY }, viewId: target?.id ?? null });\n    };\n    const onMove = (e: PointerEvent): void => publish(e.pointerId, e.clientX, e.clientY);\n    const held = heldPointers(el);\n    const onLeave = (e: PointerEvent): void => {\n      // A pointer held on the canvas is still working it once it leaves the\n      // rect, and what it drives needs the latest world position.\n      if (held.count() > 0) {\n        publish(e.pointerId, e.clientX, e.clientY);\n        return;\n      }\n      ctx.set(null);\n    };\n    // A drag that began on the canvas keeps reporting once it is off it; the\n    // canvas's own listener has the moves that still target it.\n    const onDocMove = (e: PointerEvent): void => {\n      if (e.target === el) return;\n      if (held.count() === 0) return;\n      publish(e.pointerId, e.clientX, e.clientY);\n    };\n    el.addEventListener('pointermove', onMove);\n    el.addEventListener('pointerleave', onLeave);\n    document.addEventListener('pointermove', onDocMove);\n    return () => {\n      el.removeEventListener('pointermove', onMove);\n      el.removeEventListener('pointerleave', onLeave);\n      document.removeEventListener('pointermove', onDocMove);\n      held.release();\n    };\n    // canvasRef + registry + ctx identity are all stable across the lifetime\n    // of the surrounding provider; effect runs once per mount.\n  }, [ctx, canvasRef, canvasApiRef, registry]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAgB,sBAAsB,EAAE,YAAqC;CAE3E,IADe,kBACX,GAAQ,OAAO,oBAAAA,UAAA,EAAG,SAAW,CAAA;CACjC,OAAO,oBAAC,wBAAD,EAAyB,SAAiC,CAAA;AACnE;;;;;;;;;;AAWA,SAAgB,oBACd,WACA,cACM;CACN,MAAM,MAAM,kBAAkB;CAC9B,MAAM,WAAW,wBAAwB;CACzC,gBAAgB;EACd,IAAI,CAAC,KAAK;EACV,MAAM,KAAK,UAAU;EACrB,IAAI,CAAC,IAAI;EAIT,MAAM,WAAW,WAA0B,SAAiB,YAA0B;GACpF,MAAM,MAAM,aAAa;GACzB,IAAI,CAAC,KAAK;GACV,MAAM,SAAS,UAAU,SAAS,GAAG,WAAW,SAAS,OAAO;GAChE,MAAM,CAAC,QAAQ,UAAU,aAAa,KAAK,QAAQ,SAAS,OAAO;GACnE,IAAI,IAAI;IAAE,OAAO;KAAE,GAAG;KAAQ,GAAG;IAAO;IAAG,QAAQ,QAAQ,MAAM;GAAK,CAAC;EACzE;EACA,MAAM,UAAU,MAA0B,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO;EACnF,MAAM,OAAO,aAAa,EAAE;EAC5B,MAAM,WAAW,MAA0B;GAGzC,IAAI,KAAK,MAAM,IAAI,GAAG;IACpB,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO;IACzC;GACF;GACA,IAAI,IAAI,IAAI;EACd;EAGA,MAAM,aAAa,MAA0B;GAC3C,IAAI,EAAE,WAAW,IAAI;GACrB,IAAI,KAAK,MAAM,MAAM,GAAG;GACxB,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO;EAC3C;EACA,GAAG,iBAAiB,eAAe,MAAM;EACzC,GAAG,iBAAiB,gBAAgB,OAAO;EAC3C,SAAS,iBAAiB,eAAe,SAAS;EAClD,aAAa;GACX,GAAG,oBAAoB,eAAe,MAAM;GAC5C,GAAG,oBAAoB,gBAAgB,OAAO;GAC9C,SAAS,oBAAoB,eAAe,SAAS;GACrD,KAAK,QAAQ;EACf;CAGF,GAAG;EAAC;EAAK;EAAW;EAAc;CAAQ,CAAC;AAC7C"}
+{"version":3,"file":"PointerProviderIfRoot.js","names":["_Fragment"],"sources":["../../../src/canvas/SceneCanvas/PointerProviderIfRoot.tsx"],"sourcesContent":["/**\n * Conditional `<PointerContextProvider>` wrapper. Mounts a provider only\n * when no parent provider is in scope — otherwise renders children unwrapped\n * so SceneCanvas defers to the host's existing scope.\n *\n * Pairs with `usePointerPublisher`, which publishes the canvas's pointer\n * into the surrounding context.\n */\nimport type { MutableRefObject, ReactNode, RefObject } from 'react';\nimport { PointerContextProvider, usePointerContext } from '@weasel-js/routing/react';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport { useOptionalViewRegistry } from '../viewRegistry';\nimport { worldPointAt } from './worldPointAt';\nimport { usePublishPointer } from '../../input/usePublishPointer';\n\n/** Mount a `<PointerContextProvider>` only when none is already in scope. */\nexport function PointerProviderIfRoot({ children }: { children: ReactNode }) {\n  const parent = usePointerContext();\n  if (parent) return <>{children}</>;\n  return <PointerContextProvider>{children}</PointerContextProvider>;\n}\n\n/**\n * Publishes the canvas's pointer into the surrounding `<PointerContextProvider>`\n * through {@link usePublishPointer}, placing it with the surface's view\n * resolver so paste-at-pointer lands in the panel the cursor is over. With no\n * views declared it answers the canvas's own camera and rect.\n */\nexport function usePointerPublisher(\n  canvasRef: MutableRefObject<HTMLElement | null>,\n  canvasApiRef: RefObject<CanvasExtensionApi | null>,\n): void {\n  const registry = useOptionalViewRegistry();\n  usePublishPointer(canvasRef, (pointerId, clientX, clientY) => {\n    const api = canvasApiRef.current;\n    if (!api) return null;\n    const target = registry?.resolver.at(pointerId, clientX, clientY);\n    const [x, y] = worldPointAt(api, target, clientX, clientY);\n    return { world: { x, y }, viewId: target?.id ?? null };\n  });\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,sBAAsB,EAAE,YAAqC;CAE3E,IADe,kBACX,GAAQ,OAAO,oBAAAA,UAAA,EAAG,SAAW,CAAA;CACjC,OAAO,oBAAC,wBAAD,EAAyB,SAAiC,CAAA;AACnE;;;;;;;AAQA,SAAgB,oBACd,WACA,cACM;CACN,MAAM,WAAW,wBAAwB;CACzC,kBAAkB,YAAY,WAAW,SAAS,YAAY;EAC5D,MAAM,MAAM,aAAa;EACzB,IAAI,CAAC,KAAK,OAAO;EACjB,MAAM,SAAS,UAAU,SAAS,GAAG,WAAW,SAAS,OAAO;EAChE,MAAM,CAAC,GAAG,KAAK,aAAa,KAAK,QAAQ,SAAS,OAAO;EACzD,OAAO;GAAE,OAAO;IAAE;IAAG;GAAE;GAAG,QAAQ,QAAQ,MAAM;EAAK;CACvD,CAAC;AACH"}

package/dist/canvas/SceneCanvas/SceneCanvasInput.js

@@ -1,11 +1,11 @@
-import { useDeviceProfile } from "../../core/device/useDeviceProfile.js";
-import { dlog } from "../../debug/flag.js";
-import { usePointerPublisher } from "./PointerProviderIfRoot.js";
 import { SnapSourceRegistryContext } from "../../domains/snap/registry.js";
+import { dlog } from "../../debug/flag.js";
+import { useDeviceProfile } from "../../core/device/useDeviceProfile.js";
 import { useTestHook } from "../../test-hook/useTestHook.js";
 import { useModeDefaultToolDepSource } from "../deps/modeDefaultTool.js";
 import { useHitObserver } from "../useHitObserver.js";
 import { GeometryProjectionRegistrar, ResizePolicyRegistrar } from "./poseRegistrars.js";
+import { usePointerPublisher } from "./PointerProviderIfRoot.js";
 import { useSceneGestureDispatcher } from "./useSceneGestureDispatcher.js";
 import { useCanvasDevtoolsRoot } from "./useCanvasDevtoolsRoot.js";
 import { useSceneStandardActions } from "./useSceneStandardActions.js";
@@ -15,7 +15,7 @@ import { useLatest } from "@weasel-js/react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useDepSource } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/SceneCanvasInput.tsx
+// src/canvas/SceneCanvas/SceneCanvasInput.tsx
 /**
 * The canvas's input wiring: the pointer publisher, the standard actions and their deps, the
 * gesture dispatcher, and the tool keybindings, in that order, then the test hook.
@@ -127,6 +127,5 @@ function SceneCanvasInput(p) {
 	return /* @__PURE__ */ jsxs(Fragment, { children: [selectTool?.resize ? /* @__PURE__ */ jsx(ResizePolicyRegistrar, { options: selectTool.resize }) : null, props.geometryProjection ? /* @__PURE__ */ jsx(GeometryProjectionRegistrar, { projection: props.geometryProjection }) : null] });
 }
 
-//#endregion
 export { SceneCanvasInput };
 //# sourceMappingURL=SceneCanvasInput.js.map

package/dist/canvas/SceneCanvas/SurfaceDeclarations.js

@@ -2,7 +2,7 @@ import { CanvasView } from "../CanvasView.js";
 import { ViewMarker } from "../ViewMarker.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/canvas/SceneCanvas/SurfaceDeclarations.tsx
+// src/canvas/SceneCanvas/SurfaceDeclarations.tsx
 /** The views and markers a `<SceneCanvas>` declares on its surface: its
 *  `views` prop, its contributions' views, views added through the handle,
 *  then its contributions' markers. */
@@ -18,6 +18,5 @@ function SurfaceDeclarations({ views, entries, added }) {
 	] });
 }
 
-//#endregion
 export { SurfaceDeclarations };
 //# sourceMappingURL=SurfaceDeclarations.js.map

package/dist/canvas/SceneCanvas/brushOverlay.js

@@ -1,6 +1,6 @@
 import { circlePath, polylineFromPoints } from "@weasel-js/geom";
 
-//#region src/canvas/SceneCanvas/brushOverlay.ts
+// src/canvas/SceneCanvas/brushOverlay.ts
 /**
 * A `brush` overlay as screen-space commands: the area swept so far, and the
 * brush's rim where it is now. `points` are already on screen.
@@ -31,6 +31,5 @@ function brushOverlayCommands(points, radiusPx, style) {
 	}];
 }
 
-//#endregion
 export { brushOverlayCommands };
 //# sourceMappingURL=brushOverlay.js.map

package/dist/canvas/SceneCanvas/builtinToolSets.js

@@ -1,7 +1,7 @@
 import { KIT_SHAPE_KINDS, kitShapeKindsOf } from "../../core/shapeKinds.js";
 import { toolIdsOf, toolSet } from "@weasel-js/routing";
 
-//#region src/canvas/SceneCanvas/builtinToolSets.ts
+// src/canvas/SceneCanvas/builtinToolSets.ts
 /** The selection tools: click and marquee, and the lasso. */
 var SELECT_TOOLS = toolSet("select", ["select", ...kitShapeKindsOf("select")]);
 /** Path edit's anchor editing. Path-edit tools of other packages join this group. */
@@ -36,6 +36,5 @@ var BUILTIN_TOOLS = toolSet("builtin", [...BUILTIN_TOOL_GROUPS, ...KIT_SHAPE_KIN
 *  tools within each group by it. */
 var BUILTIN_TOOL_IDS = toolIdsOf([BUILTIN_TOOLS]);
 
-//#endregion
 export { ANCHOR_TOOLS, BUILTIN_TOOLS, BUILTIN_TOOL_GROUPS, BUILTIN_TOOL_IDS, DRAW_TOOLS, PAGE_TOOLS, SELECT_TOOLS, SHAPE_TOOLS, TOOL_GROUP_ORDER, TYPE_TOOLS, VIEW_TOOLS };
 //# sourceMappingURL=builtinToolSets.js.map

package/dist/canvas/SceneCanvas/canvasPassThrough.js

@@ -1,4 +1,4 @@
-//#region src/canvas/SceneCanvas/canvasPassThrough.ts
+// src/canvas/SceneCanvas/canvasPassThrough.ts
 /** Every prop `<SceneCanvas>` reads itself instead of handing to `<Canvas>`. */
 var OWN_PROPS = [
 	"scene",
@@ -70,6 +70,5 @@ function canvasPassThrough(props) {
 	return rest;
 }
 
-//#endregion
 export { canvasPassThrough };
 //# sourceMappingURL=canvasPassThrough.js.map

package/dist/canvas/SceneCanvas/contributionFrameHooks.js

@@ -1,7 +1,7 @@
 import { useEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/contributionFrameHooks.ts
+// src/canvas/SceneCanvas/contributionFrameHooks.ts
 /**
 * Runs contributions' `beforePaint` / `afterPaint` on the surface's own frame
 * loop. One subscription per phase serves every entry, and only while some
@@ -59,6 +59,5 @@ function useContributionFrameHooks(entries, api, deps) {
 	]);
 }
 
-//#endregion
 export { runContributionFrameHooks, useContributionFrameHooks };
 //# sourceMappingURL=contributionFrameHooks.js.map

package/dist/canvas/SceneCanvas/coordTrace.js

@@ -1,4 +1,4 @@
-//#region src/canvas/SceneCanvas/coordTrace.ts
+// src/canvas/SceneCanvas/coordTrace.ts
 /** Record one conversion against the rect and view it was made under. A null
 *  `canvas` or a missing `view` records the identity fallback. */
 function traceConversion(ring, clientX, clientY, canvas, view, world) {
@@ -37,6 +37,5 @@ function traceConversion(ring, clientX, clientY, canvas, view, world) {
 	});
 }
 
-//#endregion
 export { traceConversion };
 //# sourceMappingURL=coordTrace.js.map

package/dist/canvas/SceneCanvas/defaultNodeProperties.js

@@ -1,7 +1,7 @@
-import { minSizeOf } from "../../core/scene/minSize.js";
+import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { KIT_SHAPE_KINDS, shapeKindInfo } from "../../core/shapeKinds.js";
+import { minSizeOf } from "../../core/scene/minSize.js";
 import { settleShapeGenerator } from "../../domains/paths/shapeGenerator.js";
-import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { SHAPE_GENERATOR_SECTIONS } from "./shapeGeneratorProperties.js";
 import { poseLinearOf } from "@weasel-js/geom";
 import { dashForStrokeStyle, strokeDashStyleOf } from "@weasel-js/paint";
@@ -9,7 +9,7 @@ import { listMarkers, markerGeneration } from "@weasel-js/stroke";
 import { prefUnit } from "@weasel-js/prefs";
 import { ANGLE_RADIANS, decimal } from "@weasel-js/quantity";
 
-//#region src/canvas/SceneCanvas/defaultNodeProperties.ts
+// src/canvas/SceneCanvas/defaultNodeProperties.ts
 /** Radians-stored / degrees-shown conversion for `pose.rotation` leaves.
 *  Display rounds to 0.1° so a canonical radian value doesn't render as
 *  a 15-digit float. */
@@ -867,6 +867,5 @@ var defaultNodeProperties = KIT_SHAPE_KINDS.map(shapeEntry);
 */
 var inferredNodeProperties = inferredNodeRouting.map((e) => shapeEntry(e.name));
 
-//#endregion
 export { defaultNodeProperties, inferredNodeProperties, rotationDegreesUnit };
 //# sourceMappingURL=defaultNodeProperties.js.map

package/dist/canvas/SceneCanvas/defaultNodeRouting.js

@@ -1,7 +1,7 @@
 import { KIT_SHAPE_KINDS } from "../../core/shapeKinds.js";
 import { isTextData } from "@weasel-js/text";
 
-//#region src/canvas/SceneCanvas/defaultNodeRouting.ts
+// src/canvas/SceneCanvas/defaultNodeRouting.ts
 function isObj(d) {
 	return typeof d === "object" && d !== null;
 }
@@ -54,6 +54,5 @@ var inferredNodeRouting = [
 	}
 ];
 
-//#endregion
 export { booleanGroupRouting, defaultNodeRouting, groupNodeRouting, inferredNodeRouting };
 //# sourceMappingURL=defaultNodeRouting.js.map

package/dist/canvas/SceneCanvas/defaultTextEditor.js

@@ -1,13 +1,13 @@
+import { useSceneTextEditor } from "../../domains/text/useSceneTextEdit.js";
+import { hostTextEditorHolds } from "../../domains/text/hostTextEditors.js";
+import { drawOneEditing } from "../../domains/text/editingDrawOne.js";
 import { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from "../defaultDrawOne.js";
 import { isCustomEntry } from "../layerSlots.js";
-import { drawOneEditing } from "../../domains/text/editingDrawOne.js";
-import { hostTextEditorHolds } from "../../domains/text/hostTextEditors.js";
-import { useSceneTextEditor } from "../../domains/text/useSceneTextEdit.js";
 import { useEffect, useLayoutEffect, useMemo, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { useDepRegistry, useDepSource } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/defaultTextEditor.tsx
+// src/canvas/SceneCanvas/defaultTextEditor.tsx
 /**
 * `<SceneCanvas>`'s own text editor: the one a text or sticky tool's
 * `enterTextEdit` reaches, and a double-click on a text node opens, when the
@@ -103,6 +103,5 @@ function layersWhileEditing(layers, editingId) {
 	};
 }
 
-//#endregion
 export { DefaultTextEditDep, layersWhileEditing, useCanvasTextEditor, useDefaultTextEditor };
 //# sourceMappingURL=defaultTextEditor.js.map

package/dist/canvas/SceneCanvas/describePresets.js

@@ -1,6 +1,6 @@
 import { namesBuiltins, presetToolIds } from "./features.js";
 
-//#region src/canvas/SceneCanvas/describePresets.ts
+// src/canvas/SceneCanvas/describePresets.ts
 var ATOM_ROLES = [
 	"ambient",
 	"moveBehaviors",
@@ -42,6 +42,5 @@ function describePresets(sources) {
 	return out;
 }
 
-//#endregion
 export { describePresets, isAtom };
 //# sourceMappingURL=describePresets.js.map

package/dist/canvas/SceneCanvas/dispatcherGestureBounds.js

@@ -1,7 +1,7 @@
 import { insertPreviewExtent } from "../insertPreviewExtent.js";
 import { overlaysOf } from "@weasel-js/routing";
 
-//#region src/canvas/SceneCanvas/dispatcherGestureBounds.ts
+// src/canvas/SceneCanvas/dispatcherGestureBounds.ts
 /**
 * The dispatcher side of `<Canvas>`'s {@link GestureSource} seam: `<Canvas>`
 * knows nothing about the gesture dispatcher, so `<SceneCanvas>` wires its
@@ -100,6 +100,5 @@ function createDispatcherPreviewSources(getDispatcher) {
 	};
 }
 
-//#endregion
 export { createDispatcherPreviewSources, createGestureSource, dispatcherGestureIds, dispatcherInsertBounds };
 //# sourceMappingURL=dispatcherGestureBounds.js.map