@weasel-js/core 1.13.0 → 1.14.0

package/dist/barrel/viewport.js

@@ -1,12 +1,12 @@
 import { VERSION } from "../version.js";
 import { DEFAULT_MAX_ZOOM, DEFAULT_MIN_ZOOM, ZOOM_FLOOR, normalizeZoom as normalizeZoom$1 } from "../core/viewport/zoomBounds.js";
 import { normalizeView, viewToTransform, viewZoom } from "../core/viewport/view.js";
-import { createViewportLayer } from "../features/viewports/viewportLayer.js";
-import { createViewResolver } from "../features/viewports/viewResolver.js";
+import { createViewportLayer } from "../domains/viewports/viewportLayer.js";
+import { createViewResolver } from "../domains/viewports/viewResolver.js";
 import { fitViewToBounds } from "../core/viewport/fitViewToBounds.js";
-import { aimSpace2d, isRectAim, rectAim, viewForAim } from "../features/viewports/aim.js";
+import { aimSpace2d, isRectAim, rectAim, viewForAim } from "../domains/viewports/aim.js";
 import { deriveParallaxView, fromPlane, planeMap, planeMatrix, planeToPlane, rectFromPlane, rectToPlane, toPlane } from "../core/viewport/parallax.js";
-import { usePoseRun } from "../features/poseRun/usePoseRun.js";
+import { usePoseRun } from "../domains/poseRun/usePoseRun.js";
 import { watchDevicePixelRatio } from "../core/device/watchDevicePixelRatio.js";
 import { DeviceProfileProvider, useDeviceProfile } from "../core/device/useDeviceProfile.js";
 import { useCanvasSize, useElementSize } from "../core/viewport/useCanvasSize.js";
@@ -35,10 +35,10 @@ import { useVelocityTracker } from "../core/viewport/useVelocityTracker.js";
 import { useDecayLoop } from "../core/viewport/useDecayLoop.js";
 import { interpolateView } from "../core/viewport/interpolateView.js";
 import { VIEW_ANIMATION_KEY, useViewAnimation, useViewAnimationOn, viewAxes } from "../core/viewport/useViewAnimation.js";
-import { VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_HIT_SLOP_PX, createViewMarkerLayer, grabViewMarker } from "../features/viewports/viewMarker.js";
+import { VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_HIT_SLOP_PX, createViewMarkerLayer, grabViewMarker } from "../domains/viewports/viewMarker.js";
 import { CanvasView } from "../canvas/CanvasView.js";
 import { ViewMarker } from "../canvas/ViewMarker.js";
-import { VIEW_MARKER_DRAG, createViewMarkerContribution, viewMarkerDragAction } from "../features/viewports/viewMarkerDrag.js";
+import { VIEW_MARKER_DRAG, createViewMarkerContribution, viewMarkerDragAction } from "../domains/viewports/viewMarkerDrag.js";
 import { SceneViewCanvas } from "../canvas/SceneViewCanvas.js";
 import { DrawCanvas } from "../canvas/DrawCanvas.js";
 import { FALLBACK_ACCENT, accentColorOf } from "../canvas/accentColor.js";
@@ -46,7 +46,7 @@ import { gateLayer } from "../core/layers/gateLayer.js";
 import { meanScale as meanScale$1, pxExtent as pxExtent$1, scaleDelta as scaleDelta$1, screenAngleOf as screenAngleOf$1, standoff as standoff$1, withinPxBox, withinPxRadius as withinPxRadius$1 } from "@weasel-js/geom";
 import { DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_VELOCITY_DECAY, createSimulation } from "@weasel-js/simulation";
 import { useSimulation } from "@weasel-js/simulation/react";
-import { useCanvasFocus, useFrameClock, useVisibleRaf as useVisibleRaf$1 } from "@weasel-js/react";
+import { useCanvasFocus, useVisibleRaf as useVisibleRaf$1 } from "@weasel-js/react";
 import { clientToCanvas as clientToCanvas$1 } from "@weasel-js/routing";
 
-export { ANCHOR_HIT_BASE_PX, COARSE_TARGET_SCALE, CanvasView, DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_DEVICE_PROFILE$1 as DEFAULT_DEVICE_PROFILE, DEFAULT_MAX_ZOOM, DEFAULT_MIN_ZOOM, DEFAULT_VELOCITY_DECAY, DeviceProfileProvider, DrawCanvas, FALLBACK_ACCENT, HANDLE_BASE_PX, PAGES_DOC_KEY, ROTATION_HANDLE_BASE_PX, SceneViewCanvas, VERSION, VIEW_ANIMATION_KEY, VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_DRAG, VIEW_MARKER_HIT_SLOP_PX, ViewMarker, WHEEL_ZOOM_STEP, ZOOM_FLOOR, accentColorOf, addPage, adjacentPage, aimSpace2d, axisZoomFactor, clampView, clientToCanvas$1 as clientToCanvas, computeFitViewport, computeWheelAction, createSimulation, createVelocityTracker, createViewMarkerContribution, createViewMarkerLayer, createViewResolver, createViewportLayer, deriveParallaxView, fitToBounds, fitViewToBounds, fitViewToPage, fitZoom, fromPlane, gateLayer, grabViewMarker, interpolateView, isPlainObject, isRectAim, layoutPages, meanScale$1 as meanScale, movePage, nextPageId, normalizeView, normalizeZoom$1 as normalizeZoom, pageAt, pageHolding, pageInView, pageMembers, pageName, pageOfBounds, pagesBounds, pagesLayer, pagesOf, placedPagesOf, planeMap, planeMatrix, planeToPlane, pxExtent$1 as pxExtent, rectAim, rectFromPlane, rectToPlane, removePage, renamePage, resizePage, resolveDeviceProfile$1 as resolveDeviceProfile, scaleDelta$1 as scaleDelta, sceneNodeClientRect, screenAngleOf$1 as screenAngleOf, screenToWorld, setPages, stableStringify, standoff$1 as standoff, startThresholdDrag, toPlane, useAutoCenter, useCanvasFocus, useCanvasSize, useDecayLoop, useDeviceProfile, useDragHandle, useDropZone, useElementSize, useFrameClock, useHandleDrag, useNodeOverlayFrame, usePoseRun, useSimulation, useVelocityTracker, useViewAnimation, useViewAnimationOn, useVisibleRaf$1 as useVisibleRaf, viewAxes, viewForAim, viewMarkerDragAction, viewToTransform, viewZoom, viewportWorldRect, watchDevicePixelRatio, wheelPan, wheelZoom, wheelZoomFactor, withinPxBox, withinPxRadius$1 as withinPxRadius, worldToScreen, zoomAt };
+export { ANCHOR_HIT_BASE_PX, COARSE_TARGET_SCALE, CanvasView, DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_DEVICE_PROFILE$1 as DEFAULT_DEVICE_PROFILE, DEFAULT_MAX_ZOOM, DEFAULT_MIN_ZOOM, DEFAULT_VELOCITY_DECAY, DeviceProfileProvider, DrawCanvas, FALLBACK_ACCENT, HANDLE_BASE_PX, PAGES_DOC_KEY, ROTATION_HANDLE_BASE_PX, SceneViewCanvas, VERSION, VIEW_ANIMATION_KEY, VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_DRAG, VIEW_MARKER_HIT_SLOP_PX, ViewMarker, WHEEL_ZOOM_STEP, ZOOM_FLOOR, accentColorOf, addPage, adjacentPage, aimSpace2d, axisZoomFactor, clampView, clientToCanvas$1 as clientToCanvas, computeFitViewport, computeWheelAction, createSimulation, createVelocityTracker, createViewMarkerContribution, createViewMarkerLayer, createViewResolver, createViewportLayer, deriveParallaxView, fitToBounds, fitViewToBounds, fitViewToPage, fitZoom, fromPlane, gateLayer, grabViewMarker, interpolateView, isPlainObject, isRectAim, layoutPages, meanScale$1 as meanScale, movePage, nextPageId, normalizeView, normalizeZoom$1 as normalizeZoom, pageAt, pageHolding, pageInView, pageMembers, pageName, pageOfBounds, pagesBounds, pagesLayer, pagesOf, placedPagesOf, planeMap, planeMatrix, planeToPlane, pxExtent$1 as pxExtent, rectAim, rectFromPlane, rectToPlane, removePage, renamePage, resizePage, resolveDeviceProfile$1 as resolveDeviceProfile, scaleDelta$1 as scaleDelta, sceneNodeClientRect, screenAngleOf$1 as screenAngleOf, screenToWorld, setPages, stableStringify, standoff$1 as standoff, startThresholdDrag, toPlane, useAutoCenter, useCanvasFocus, useCanvasSize, useDecayLoop, useDeviceProfile, useDragHandle, useDropZone, useElementSize, useHandleDrag, useNodeOverlayFrame, usePoseRun, useSimulation, useVelocityTracker, useViewAnimation, useViewAnimationOn, useVisibleRaf$1 as useVisibleRaf, viewAxes, viewForAim, viewMarkerDragAction, viewToTransform, viewZoom, viewportWorldRect, watchDevicePixelRatio, wheelPan, wheelZoom, wheelZoomFactor, withinPxBox, withinPxRadius$1 as withinPxRadius, worldToScreen, zoomAt };

package/dist/canvas/Canvas.js

@@ -118,7 +118,7 @@ function CanvasInner(props, ref) {
 		gestureSource: props.gestureSource,
 		previewPoseExtra: props.previewPoseExtra,
 		getScale: () => viewRef.current.scale,
-		selection: props.selection?.current ?? NO_SELECTION,
+		selection: () => props.selection?.current ?? NO_SELECTION,
 		getIsVisible: () => gateRef.current.getIsVisible?.() ?? alwaysVisible,
 		layerIsPainted: useViewLayerGate(layerVisibility, layerOrder, () => layers)
 	});
@@ -166,7 +166,7 @@ function CanvasInner(props, ref) {
 		...frame,
 		inputsRef: paintInputsRef,
 		gateRef
-	}, markPainted);
+	}, markPainted, requestRedraw);
 	useEffect(() => clearSubscribers, [clearSubscribers]);
 	useToolCursor(cursorSink, tools, detached ? inputElement : null, style?.cursor);
 	useSurfaceInput(canvasRef, {

package/dist/canvas/Canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"Canvas.js","names":[],"sources":["../../src/canvas/Canvas.tsx"],"sourcesContent":["/**\n * Low-level WebGL surface + viewport primitive. Composes layers into a single GL render pass,\n * applies a view transform, and delivers hover to the layers that ask for it. It routes no\n * gesture: `<SceneCanvas>` mounts the gesture dispatcher on this same element. Canvas owns NO\n * scene-shaped state — selection, picking, kind registry, scene-aware overlays all live in\n * `<SceneCanvas>`, which wraps it.\n *\n * The `layers` prop is a map keyed by slot name, every slot already a layer. Standard slots\n * render at a canonical position; custom entries (any other key, value carrying `.layer`) insert\n * at `after`/`before` an existing slot, defaulting to the top.\n *\n * @internal\n * @deprecated Bare `<Canvas>` is not a supported consumer surface.\n *   Use `<SceneCanvas>` instead.\n */\n\nimport { forwardRef, useCallback, useEffect, useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport type React from 'react';\nimport type { CanvasExtensionApi } from './canvasExtension';\nimport { registerMountedCanvas } from './mountedCanvases';\nimport { useViewHelpers } from './useViewHelpers';\nimport { useViewLayerGate } from './useViewLayerGate';\nimport { useSurfaceInput } from './useSurfaceInput';\nimport { useOptionalViewRegistry } from './viewRegistry';\nimport { useCanvasSurface } from './useCanvasSurface';\nimport type { CanvasHelpers } from './useViewHelpers';\nimport type { CanvasProps } from './canvasProps';\nimport { useLatest } from '@weasel-js/react';\nimport { SurfaceCanvas } from './SurfaceCanvas';\nimport { useSurfaceSize } from './useSurfaceSize';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useDebugSink } from '../debug/useDebugSink';\nimport { useToolCursor } from './useToolCursor';\nimport { useCanvasElements } from './useCanvasElements';\nimport { alwaysVisible, useExtraLayers } from './useExtraLayers';\nimport { usePaintedCursor } from './usePaintedCursor';\nimport { useCanvasHandle } from './useCanvasHandle';\nimport { useComposedLayers, useSlotLayers } from './useLayerStack';\nimport { useViewRegistrySurface } from './useViewRegistrySurface';\nimport { useCanvasPaint, usePaintedVersion } from './useCanvasPaint';\nimport { layerHover } from './layerHover';\nimport { useClientToWorld } from './useClientToWorld';\n\nexport type { CanvasProps, CanvasRetainOptions } from './canvasProps';\n\nconst NO_SELECTION: SelectionApi['current'] = [];\n\nfunction CanvasInner<TPose>(\n  props: CanvasProps<TPose>,\n  ref: React.ForwardedRef<CanvasExtensionApi>,\n) {\n  const {\n    paintInto, inputElement, tools, viewState, style, getIsVisible, layerVisibility, layerOrder,\n    helpersRef, debugSinkRef,\n    poseDescriptor: geometry = AUTO_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>,\n  } = props;\n\n  const { sink: debugSink, overlay: debugOverlay, frameStats, getDebug } = useDebugSink(props.debug);\n  const elements = useCanvasElements(paintInto, inputElement);\n  const { canvasRef, ownCanvasRef, detached } = elements;\n  const { width, height } = useSurfaceSize(props, ownCanvasRef);\n\n  // Read by `hitTestExtras`, which is built once and must see live values.\n  const helpersForLayersRef = useRef<CanvasHelpers<TPose> | null>(null);\n  const dimsRef = useLatest({ width, height });\n  // Which layers reach the screen, and which chrome within them: asked by the\n  // paint and by every hit-test.\n  const gateRef = useLatest({ getIsVisible, layerVisibility, layerOrder });\n\n  // The frame loop paints; a committed render only marks the surface dirty, so\n  // no prop can reach the paint without repainting it. The thunk defers to\n  // `useCanvasPaint` below, which needs inputs this render has not computed yet.\n  const paintRef = useRef<() => boolean>(() => false);\n  const { lease, requestRedraw, subscribeFrame, subscribeBeforePaint, subscribeResume } = useCanvasSurface(\n    useCallback(() => paintRef.current(), []),\n    { syncPaint: props.syncPaint ?? false, target: canvasRef, dpr: props.dpr, redrawOn: props.redrawOn, shaders: props.shaders, onCommit: 'redraw' },\n  );\n  const { getPaintedVersion, markPainted } = usePaintedVersion(props.contentVersion);\n  const { extrasRef, extrasVersion, registerLayer, hitTestExtrasIn } = useExtraLayers(gateRef);\n\n  const {\n    viewRef, setView, getView, subscribeView,\n    adoptControlled, announceControlled, clearSubscribers,\n  } = viewState;\n\n  const toWorld = useClientToWorld(canvasRef, props.clientToWorld, viewRef);\n\n  useLayoutEffect(() => {\n    const element = canvasRef.current;\n    if (!element) return;\n    return registerMountedCanvas({ element, getView });\n  }, [canvasRef, detached, inputElement, getView]);\n\n  const { paintedCursor, paintedCursorLayer, cursorSink } = usePaintedCursor(canvasRef, requestRedraw);\n\n  const frame = { viewRef, dimsRef, helpersRef: helpersForLayersRef };\n  useCanvasHandle(ref, { ...elements, inputElement, paintCanvas: paintInto?.canvas }, frame, {\n    hitTestExtrasIn, clientToWorld: toWorld, requestRedraw, subscribeFrame, subscribeBeforePaint,\n    subscribeResume, registerLayer, getView, setView, subscribeView,\n    getPaintedVersion, paintedCursor, cursorSink, getDebug,\n  });\n\n  const viewRegistry = useOptionalViewRegistry();\n\n  // One view's overlay-aware state. A hook, so N views are N components each\n  // calling it once — not a loop in this body.\n  const layers = useSlotLayers(props.layers, tools, props.backgroundFill, props.decorationLayer);\n  const { helpers: viewHelpers } = useViewHelpers<TPose>({\n    adapter: props.adapter, geometry, boundsOf: props.boundsOf, boundsOfPose: props.boundsOfPose,\n    nodes: props.nodes, gestureSource: props.gestureSource, previewPoseExtra: props.previewPoseExtra,\n    getScale: () => viewRef.current.scale,\n    selection: props.selection?.current ?? NO_SELECTION,\n    getIsVisible: () => gateRef.current.getIsVisible?.() ?? alwaysVisible,\n    layerIsPainted: useViewLayerGate(layerVisibility, layerOrder, () => layers),\n  });\n  const helpersForLayers: CanvasHelpers<TPose> = { ...viewHelpers, getDebug: () => debugSink, viewId: null };\n\n  useViewRegistrySurface(viewRegistry, layers, frame, { requestRedraw, hitTestExtrasIn, clientToWorld: toWorld, setView: viewState.setViewFromInput });\n  const layersWithDebug = useComposedLayers(layers, {\n    viewRegistry, debugOverlay, extrasRef, extrasVersion, cursorLayer: paintedCursorLayer,\n  }, requestRedraw);\n\n  // Everything the paint, hit-testing and the view registry read that a React\n  // render owns. `useLatest` and the insertion effect below publish committed\n  // renders only, ahead of every layout effect in the commit, any of which may\n  // ask for a sync paint.\n  const paintInputsRef = useLatest({\n    layers: layersWithDebug, width, height, debugSink, frameStats,\n    dpr: props.dpr, layerGroups: props.layerGroups, shaders: props.shaders,\n    flattenTolerance: props.flattenTolerance, retain: props.retain, imageMinification: props.imageMinification,\n  });\n  useInsertionEffect(() => {\n    adoptControlled();\n    helpersForLayersRef.current = helpersForLayers;\n    if (helpersRef) helpersRef.current = helpersForLayers;\n    if (debugSinkRef) debugSinkRef.current = debugSink;\n  });\n  useLayoutEffect(() => {\n    announceControlled();\n  });\n\n  useCanvasPaint(paintRef, lease, elements, { ...frame, inputsRef: paintInputsRef, gateRef }, markPainted);\n  useEffect(() => clearSubscribers, [clearSubscribers]);\n\n  useToolCursor(cursorSink, tools, detached ? inputElement : null, style?.cursor);\n\n  useSurfaceInput(canvasRef, {\n    focusOnPress: props.autoFocusOnPointerDown ?? true,\n    onFocus: props.onFocus,\n    onBlur: props.onBlur,\n    ...layerHover(layersWithDebug, {\n      viewRef, toWorld, layerVisibility, layerOrder, dims: { width, height },\n    }),\n  });\n\n  if (detached) return null;\n\n  return (\n    <SurfaceCanvas\n      ref={elements.setOwnCanvas}\n      width={props.width}\n      height={props.height}\n      tabIndex={props.tabIndex ?? 0} aria-label={props['aria-label']}\n      className={props.className} style={style}\n    />\n  );\n}\n\n/** Forward-ref'd `<canvas>` wrapper. Generic over the pose type, inferred from the\n *  `adapter` prop. */\nexport const Canvas = forwardRef(CanvasInner) as <TPose = unknown>(\n  props: CanvasProps<TPose> & { ref?: React.ForwardedRef<CanvasExtensionApi> },\n) => ReturnType<typeof CanvasInner>;\n\n"],"mappings":"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"}
+{"version":3,"file":"Canvas.js","names":[],"sources":["../../src/canvas/Canvas.tsx"],"sourcesContent":["/**\n * Low-level WebGL surface + viewport primitive. Composes layers into a single GL render pass,\n * applies a view transform, and delivers hover to the layers that ask for it. It routes no\n * gesture: `<SceneCanvas>` mounts the gesture dispatcher on this same element. Canvas owns NO\n * scene-shaped state — selection, picking, kind registry, scene-aware overlays all live in\n * `<SceneCanvas>`, which wraps it.\n *\n * The `layers` prop is a map keyed by slot name, every slot already a layer. Standard slots\n * render at a canonical position; custom entries (any other key, value carrying `.layer`) insert\n * at `after`/`before` an existing slot, defaulting to the top.\n *\n * @internal\n * @deprecated Bare `<Canvas>` is not a supported consumer surface.\n *   Use `<SceneCanvas>` instead.\n */\n\nimport { forwardRef, useCallback, useEffect, useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport type React from 'react';\nimport type { CanvasExtensionApi } from './canvasExtension';\nimport { registerMountedCanvas } from './mountedCanvases';\nimport { useViewHelpers } from './useViewHelpers';\nimport { useViewLayerGate } from './useViewLayerGate';\nimport { useSurfaceInput } from './useSurfaceInput';\nimport { useOptionalViewRegistry } from './viewRegistry';\nimport { useCanvasSurface } from './useCanvasSurface';\nimport type { CanvasHelpers } from './useViewHelpers';\nimport type { CanvasProps } from './canvasProps';\nimport { useLatest } from '@weasel-js/react';\nimport { SurfaceCanvas } from './SurfaceCanvas';\nimport { useSurfaceSize } from './useSurfaceSize';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useDebugSink } from '../debug/useDebugSink';\nimport { useToolCursor } from './useToolCursor';\nimport { useCanvasElements } from './useCanvasElements';\nimport { alwaysVisible, useExtraLayers } from './useExtraLayers';\nimport { usePaintedCursor } from './usePaintedCursor';\nimport { useCanvasHandle } from './useCanvasHandle';\nimport { useComposedLayers, useSlotLayers } from './useLayerStack';\nimport { useViewRegistrySurface } from './useViewRegistrySurface';\nimport { useCanvasPaint, usePaintedVersion } from './useCanvasPaint';\nimport { layerHover } from './layerHover';\nimport { useClientToWorld } from './useClientToWorld';\n\nexport type { CanvasProps, CanvasRetainOptions } from './canvasProps';\n\nconst NO_SELECTION: SelectionApi['current'] = [];\n\nfunction CanvasInner<TPose>(\n  props: CanvasProps<TPose>,\n  ref: React.ForwardedRef<CanvasExtensionApi>,\n) {\n  const {\n    paintInto, inputElement, tools, viewState, style, getIsVisible, layerVisibility, layerOrder,\n    helpersRef, debugSinkRef,\n    poseDescriptor: geometry = AUTO_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>,\n  } = props;\n\n  const { sink: debugSink, overlay: debugOverlay, frameStats, getDebug } = useDebugSink(props.debug);\n  const elements = useCanvasElements(paintInto, inputElement);\n  const { canvasRef, ownCanvasRef, detached } = elements;\n  const { width, height } = useSurfaceSize(props, ownCanvasRef);\n\n  // Read by `hitTestExtras`, which is built once and must see live values.\n  const helpersForLayersRef = useRef<CanvasHelpers<TPose> | null>(null);\n  const dimsRef = useLatest({ width, height });\n  // Which layers reach the screen, and which chrome within them: asked by the\n  // paint and by every hit-test.\n  const gateRef = useLatest({ getIsVisible, layerVisibility, layerOrder });\n\n  // The frame loop paints; a committed render only marks the surface dirty, so\n  // no prop can reach the paint without repainting it. The thunk defers to\n  // `useCanvasPaint` below, which needs inputs this render has not computed yet.\n  const paintRef = useRef<() => boolean>(() => false);\n  const { lease, requestRedraw, subscribeFrame, subscribeBeforePaint, subscribeResume } = useCanvasSurface(\n    useCallback(() => paintRef.current(), []),\n    { syncPaint: props.syncPaint ?? false, target: canvasRef, dpr: props.dpr, redrawOn: props.redrawOn, shaders: props.shaders, onCommit: 'redraw' },\n  );\n  const { getPaintedVersion, markPainted } = usePaintedVersion(props.contentVersion);\n  const { extrasRef, extrasVersion, registerLayer, hitTestExtrasIn } = useExtraLayers(gateRef);\n\n  const {\n    viewRef, setView, getView, subscribeView,\n    adoptControlled, announceControlled, clearSubscribers,\n  } = viewState;\n\n  const toWorld = useClientToWorld(canvasRef, props.clientToWorld, viewRef);\n\n  useLayoutEffect(() => {\n    const element = canvasRef.current;\n    if (!element) return;\n    return registerMountedCanvas({ element, getView });\n  }, [canvasRef, detached, inputElement, getView]);\n\n  const { paintedCursor, paintedCursorLayer, cursorSink } = usePaintedCursor(canvasRef, requestRedraw);\n\n  const frame = { viewRef, dimsRef, helpersRef: helpersForLayersRef };\n  useCanvasHandle(ref, { ...elements, inputElement, paintCanvas: paintInto?.canvas }, frame, {\n    hitTestExtrasIn, clientToWorld: toWorld, requestRedraw, subscribeFrame, subscribeBeforePaint,\n    subscribeResume, registerLayer, getView, setView, subscribeView,\n    getPaintedVersion, paintedCursor, cursorSink, getDebug,\n  });\n\n  const viewRegistry = useOptionalViewRegistry();\n\n  // One view's overlay-aware state. A hook, so N views are N components each\n  // calling it once — not a loop in this body.\n  const layers = useSlotLayers(props.layers, tools, props.backgroundFill, props.decorationLayer);\n  const { helpers: viewHelpers } = useViewHelpers<TPose>({\n    adapter: props.adapter, geometry, boundsOf: props.boundsOf, boundsOfPose: props.boundsOfPose,\n    nodes: props.nodes, gestureSource: props.gestureSource, previewPoseExtra: props.previewPoseExtra,\n    getScale: () => viewRef.current.scale,\n    selection: () => props.selection?.current ?? NO_SELECTION,\n    getIsVisible: () => gateRef.current.getIsVisible?.() ?? alwaysVisible,\n    layerIsPainted: useViewLayerGate(layerVisibility, layerOrder, () => layers),\n  });\n  const helpersForLayers: CanvasHelpers<TPose> = { ...viewHelpers, getDebug: () => debugSink, viewId: null };\n\n  useViewRegistrySurface(viewRegistry, layers, frame, { requestRedraw, hitTestExtrasIn, clientToWorld: toWorld, setView: viewState.setViewFromInput });\n  const layersWithDebug = useComposedLayers(layers, {\n    viewRegistry, debugOverlay, extrasRef, extrasVersion, cursorLayer: paintedCursorLayer,\n  }, requestRedraw);\n\n  // Everything the paint, hit-testing and the view registry read that a React\n  // render owns. `useLatest` and the insertion effect below publish committed\n  // renders only, ahead of every layout effect in the commit, any of which may\n  // ask for a sync paint.\n  const paintInputsRef = useLatest({\n    layers: layersWithDebug, width, height, debugSink, frameStats,\n    dpr: props.dpr, layerGroups: props.layerGroups, shaders: props.shaders,\n    flattenTolerance: props.flattenTolerance, retain: props.retain, imageMinification: props.imageMinification,\n  });\n  useInsertionEffect(() => {\n    adoptControlled();\n    helpersForLayersRef.current = helpersForLayers;\n    if (helpersRef) helpersRef.current = helpersForLayers;\n    if (debugSinkRef) debugSinkRef.current = debugSink;\n  });\n  useLayoutEffect(() => {\n    announceControlled();\n  });\n\n  useCanvasPaint(paintRef, lease, elements, { ...frame, inputsRef: paintInputsRef, gateRef }, markPainted, requestRedraw);\n  useEffect(() => clearSubscribers, [clearSubscribers]);\n\n  useToolCursor(cursorSink, tools, detached ? inputElement : null, style?.cursor);\n\n  useSurfaceInput(canvasRef, {\n    focusOnPress: props.autoFocusOnPointerDown ?? true,\n    onFocus: props.onFocus,\n    onBlur: props.onBlur,\n    ...layerHover(layersWithDebug, {\n      viewRef, toWorld, layerVisibility, layerOrder, dims: { width, height },\n    }),\n  });\n\n  if (detached) return null;\n\n  return (\n    <SurfaceCanvas\n      ref={elements.setOwnCanvas}\n      width={props.width}\n      height={props.height}\n      tabIndex={props.tabIndex ?? 0} aria-label={props['aria-label']}\n      className={props.className} style={style}\n    />\n  );\n}\n\n/** Forward-ref'd `<canvas>` wrapper. Generic over the pose type, inferred from the\n *  `adapter` prop. */\nexport const Canvas = forwardRef(CanvasInner) as <TPose = unknown>(\n  props: CanvasProps<TPose> & { ref?: React.ForwardedRef<CanvasExtensionApi> },\n) => ReturnType<typeof CanvasInner>;\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,IAAM,eAAwC,CAAC;AAE/C,SAAS,YACP,OACA,KACA;CACA,MAAM,EACJ,WAAW,cAAc,OAAO,WAAW,OAAO,cAAc,iBAAiB,YACjF,YAAY,cACZ,gBAAgB,WAAW,yBACzB;CAEJ,MAAM,EAAE,MAAM,WAAW,SAAS,cAAc,YAAY,aAAa,aAAa,MAAM,KAAK;CACjG,MAAM,WAAW,kBAAkB,WAAW,YAAY;CAC1D,MAAM,EAAE,WAAW,cAAc,aAAa;CAC9C,MAAM,EAAE,OAAO,WAAW,eAAe,OAAO,YAAY;CAG5D,MAAM,sBAAsB,OAAoC,IAAI;CACpE,MAAM,UAAU,UAAU;EAAE;EAAO;CAAO,CAAC;CAG3C,MAAM,UAAU,UAAU;EAAE;EAAc;EAAiB;CAAW,CAAC;CAKvE,MAAM,WAAW,aAA4B,KAAK;CAClD,MAAM,EAAE,OAAO,eAAe,gBAAgB,sBAAsB,oBAAoB,iBACtF,kBAAkB,SAAS,QAAQ,GAAG,CAAC,CAAC,GACxC;EAAE,WAAW,MAAM,aAAa;EAAO,QAAQ;EAAW,KAAK,MAAM;EAAK,UAAU,MAAM;EAAU,SAAS,MAAM;EAAS,UAAU;CAAS,CACjJ;CACA,MAAM,EAAE,mBAAmB,gBAAgB,kBAAkB,MAAM,cAAc;CACjF,MAAM,EAAE,WAAW,eAAe,eAAe,oBAAoB,eAAe,OAAO;CAE3F,MAAM,EACJ,SAAS,SAAS,SAAS,eAC3B,iBAAiB,oBAAoB,qBACnC;CAEJ,MAAM,UAAU,iBAAiB,WAAW,MAAM,eAAe,OAAO;CAExE,sBAAsB;EACpB,MAAM,UAAU,UAAU;EAC1B,IAAI,CAAC,SAAS;EACd,OAAO,sBAAsB;GAAE;GAAS;EAAQ,CAAC;CACnD,GAAG;EAAC;EAAW;EAAU;EAAc;CAAO,CAAC;CAE/C,MAAM,EAAE,eAAe,oBAAoB,eAAe,iBAAiB,WAAW,aAAa;CAEnG,MAAM,QAAQ;EAAE;EAAS;EAAS,YAAY;CAAoB;CAClE,gBAAgB,KAAK;EAAE,GAAG;EAAU;EAAc,aAAa,WAAW;CAAO,GAAG,OAAO;EACzF;EAAiB,eAAe;EAAS;EAAe;EAAgB;EACxE;EAAiB;EAAe;EAAS;EAAS;EAClD;EAAmB;EAAe;EAAY;CAChD,CAAC;CAED,MAAM,eAAe,wBAAwB;CAI7C,MAAM,SAAS,cAAc,MAAM,QAAQ,OAAO,MAAM,gBAAgB,MAAM,eAAe;CAC7F,MAAM,EAAE,SAAS,gBAAgB,eAAsB;EACrD,SAAS,MAAM;EAAS;EAAU,UAAU,MAAM;EAAU,cAAc,MAAM;EAChF,OAAO,MAAM;EAAO,eAAe,MAAM;EAAe,kBAAkB,MAAM;EAChF,gBAAgB,QAAQ,QAAQ;EAChC,iBAAiB,MAAM,WAAW,WAAW;EAC7C,oBAAoB,QAAQ,QAAQ,eAAe,KAAK;EACxD,gBAAgB,iBAAiB,iBAAiB,kBAAkB,MAAM;CAC5E,CAAC;CACD,MAAM,mBAAyC;EAAE,GAAG;EAAa,gBAAgB;EAAW,QAAQ;CAAK;CAEzG,uBAAuB,cAAc,QAAQ,OAAO;EAAE;EAAe;EAAiB,eAAe;EAAS,SAAS,UAAU;CAAiB,CAAC;CACnJ,MAAM,kBAAkB,kBAAkB,QAAQ;EAChD;EAAc;EAAc;EAAW;EAAe,aAAa;CACrE,GAAG,aAAa;CAMhB,MAAM,iBAAiB,UAAU;EAC/B,QAAQ;EAAiB;EAAO;EAAQ;EAAW;EACnD,KAAK,MAAM;EAAK,aAAa,MAAM;EAAa,SAAS,MAAM;EAC/D,kBAAkB,MAAM;EAAkB,QAAQ,MAAM;EAAQ,mBAAmB,MAAM;CAC3F,CAAC;CACD,yBAAyB;EACvB,gBAAgB;EAChB,oBAAoB,UAAU;EAC9B,IAAI,YAAY,WAAW,UAAU;EACrC,IAAI,cAAc,aAAa,UAAU;CAC3C,CAAC;CACD,sBAAsB;EACpB,mBAAmB;CACrB,CAAC;CAED,eAAe,UAAU,OAAO,UAAU;EAAE,GAAG;EAAO,WAAW;EAAgB;CAAQ,GAAG,aAAa,aAAa;CACtH,gBAAgB,kBAAkB,CAAC,gBAAgB,CAAC;CAEpD,cAAc,YAAY,OAAO,WAAW,eAAe,MAAM,OAAO,MAAM;CAE9E,gBAAgB,WAAW;EACzB,cAAc,MAAM,0BAA0B;EAC9C,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,GAAG,WAAW,iBAAiB;GAC7B;GAAS;GAAS;GAAiB;GAAY,MAAM;IAAE;IAAO;GAAO;EACvE,CAAC;CACH,CAAC;CAED,IAAI,UAAU,OAAO;CAErB,OACE,oBAAC,eAAD;EACE,KAAK,SAAS;EACd,OAAO,MAAM;EACb,QAAQ,MAAM;EACd,UAAU,MAAM,YAAY;EAAG,cAAY,MAAM;EACjD,WAAW,MAAM;EAAkB;CACpC,CAAA;AAEL;;;AAIA,IAAa,SAAS,WAAW,WAAW"}

package/dist/canvas/CanvasView.js

@@ -1,4 +1,4 @@
-import { createViewportLayer } from "../features/viewports/viewportLayer.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";
@@ -34,6 +34,7 @@ var NO_INPUTS = {
 	boundsOf: void 0
 };
 var ALWAYS_VISIBLE = () => true;
+var selectionOverlay = (selection) => selection ? { selection } : {};
 var ALL_LAYERS = (s) => s;
 /**
 * One view on a shared canvas. Owns a camera, contributes the viewport node
@@ -44,24 +45,25 @@ var ALL_LAYERS = (s) => s;
 * drawing. Outside a surface that mounts a view registry it is inert.
 */
 function CanvasView(props) {
-	const { id, parent, bounds, layers = ALL_LAYERS, layerVisibility, layerOrder, background, order = Infinity, label, cameraRef, selection: selectionProp, selectionOptions, interactive = true, paint = true } = props;
+	const { id, parent, follows, bounds, layers = ALL_LAYERS, layerVisibility, layerOrder, background, order = Infinity, label, cameraRef, selection: selectionProp, selectionOptions, interactive = true, paint = true } = props;
 	const registry = useOptionalViewRegistry();
 	const depRegistry = useOptionalDepRegistry();
 	const depRegistryRef = useLatest(depRegistry);
 	const ownSelection = useSelection(selectionOptions);
 	const viewSelection = selectionProp ?? (selectionOptions ? ownSelection : void 0);
 	const inputs = useOptionalViewInputs();
-	const selection = viewSelection ?? inputs?.selectionApi ?? ownSelection;
+	const shared = inputs?.selectionApi ?? ownSelection;
 	const live = useLatest({
 		parent,
+		follows,
 		bounds,
 		layers,
 		layerVisibility,
 		layerOrder,
 		viewSelection,
-		selection
+		shared
 	});
-	const { frameIn, rectAt, derivedAt, drawnLayers, layerIsPainted } = useViewNesting(registry, live);
+	const { frameIn, rectAt, derivedAt, drawnLayers, layerIsPainted, ownedSelection, selectionNow } = useViewNesting(registry, live);
 	/** The rect for the surface's current frame — what a client point and a
 	*  clamp are measured against outside a draw call. */
 	const rectNow = useCallback(() => {
@@ -111,6 +113,9 @@ function CanvasView(props) {
 			},
 			get clipboard() {
 				return base()?.clipboard;
+			},
+			get handlers() {
+				return base()?.handlers;
 			}
 		};
 	}, [
@@ -129,10 +134,10 @@ function CanvasView(props) {
 	/** The chrome-caps context this view answers for: its selection, its camera,
 	*  its dispatcher's in-flight action. */
 	const ruleInputs = useCallback(() => ({
-		selection: live.current.selection.get(),
+		selection: selectionNow().get(),
 		view: camera(),
 		action: dispatcherRef.current.getActiveAction()
-	}), [camera, live]);
+	}), [camera, selectionNow]);
 	const surfaceBoundsOf = inputs?.boundsOf;
 	const boundsOf = useMemo(() => surfaceBoundsOf ? (id) => surfaceBoundsOf(id, camera()) : void 0, [surfaceBoundsOf, camera]);
 	const surfaceBoundsOfPose = inputs?.boundsOfPose;
@@ -142,7 +147,7 @@ function CanvasView(props) {
 		boundsOf,
 		boundsOfPose,
 		...own,
-		selection: selection.current,
+		selection: () => selectionNow().current,
 		layerIsPainted,
 		getIsVisible: () => inputsRef.current?.chromeCaps?.isVisible(ruleInputs()) ?? ALWAYS_VISIBLE
 	});
@@ -198,19 +203,19 @@ function CanvasView(props) {
 		inputs?.resizeHandles,
 		helpersRef
 	]);
-	const classifyTarget = useMemo(() => buildClassifyTarget(() => live.current.selection.get(), (wx, wy) => {
+	const classifyTarget = useMemo(() => buildClassifyTarget(() => selectionNow().get(), (world) => {
 		const i = inputsRef.current;
 		const frame = {
 			...camera(),
 			layerIsPainted
 		};
-		if (i?.pickBest) return i.pickBest(wx, wy, frame);
-		const ids = i?.pickEvery?.(wx, wy, frame) ?? [];
+		if (i?.pickBest) return i.pickBest(world, frame);
+		const ids = i?.pickEvery?.(world, frame) ?? [];
 		return ids.length > 0 ? ids[ids.length - 1] : null;
 	}, (id) => inputsRef.current?.kindOfNode?.(id), (id) => inputsRef.current?.doubleClickNames?.(id) ?? id), [
 		camera,
 		layerIsPainted,
-		live,
+		selectionNow,
 		inputsRef
 	]);
 	const registration = useMemo(() => ({
@@ -238,6 +243,7 @@ function CanvasView(props) {
 		}),
 		layerIsPainted,
 		drawnLayers,
+		selection: ownedSelection,
 		target: {
 			dispatcher: dispatcherRef.current,
 			affordanceAt,
@@ -248,7 +254,7 @@ function CanvasView(props) {
 				ingestion: ingestionApi,
 				hitAt: hitAtOf(classifyTarget),
 				dispatcher: { cancelAll: (reason) => dispatcherRef.current.cancelAll(reason) },
-				...live.current.viewSelection ? { selection: live.current.viewSelection } : {}
+				...selectionOverlay(ownedSelection())
 			}),
 			getRuleCtx: () => inputsRef.current?.chromeCaps?.ruleCtx(ruleInputs())
 		}
@@ -273,7 +279,7 @@ function CanvasView(props) {
 		ingestionApi,
 		drawnLayers,
 		layerIsPainted,
-		live,
+		ownedSelection,
 		inputsRef,
 		helpersRef,
 		frameIn,

package/dist/canvas/CanvasView.js.map

@@ -1 +1 @@
-{"version":3,"file":"CanvasView.js","names":[],"sources":["../../src/canvas/CanvasView.tsx"],"sourcesContent":["/**\n * `<CanvasView>` — a second view on an existing canvas: its own camera over a\n * rect of the surface, with input routed to it.\n *\n * Mount one inside `<SceneCanvas>`, or declare the same thing through the\n * surface's `views` prop, which renders one of these per descriptor.\n */\nimport {\n  useCallback, useEffect, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useRef,\n} from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { View } from 'core/viewport/view';\nimport { clientToWorld } from 'core/viewport/clientToWorld';\nimport { createViewportLayer } from 'features/viewports/viewportLayer';\nimport { createDispatcher } from '@weasel-js/routing';\nimport type { IngestionDep, ViewApi } from 'interactions/actions/depSchema';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport { useSelection } from 'core/selection/useSelection';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useViewHelpers } from './useViewHelpers';\nimport { useViewAim } from './useViewAim';\nimport { hitAtOf } from './deps/dispatchSources';\nimport { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from './affordanceAt';\nimport { pathFromPlane } from './planeClips';\nimport { useOptionalDepRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { useDeviceProfile } from 'core/device/useDeviceProfile';\nimport {\n  createGestureSource,\n  createDispatcherPreviewSources,\n} from './SceneCanvas/dispatcherGestureBounds';\nimport { useOptionalViewInputs, type SurfaceViewInputs, type ViewRuleInputs } from './viewInputs';\nimport type { CanvasViewProps, ViewRect } from './canvasViewProps';\nexport type { CanvasViewProps, ViewRect } from './canvasViewProps';\nimport { NO_RECT, sizeOf, useViewNesting } from './useViewNesting';\nimport {\n  useOptionalViewRegistry,\n  surfaceLocal,\n  IDENTITY_VIEW,\n  UNMEASURED_DIMS,\n  type ViewRegistration,\n} from './viewRegistry';\n\n/** What a view builds its helpers from outside a surface: nothing but the\n *  default geometry, which answers `null` for every lookup. */\n// A view outside a surface has no inputs to inherit — including a selection,\n// so it falls back to owning one.\nconst NO_INPUTS: Omit<SurfaceViewInputs, 'selectionApi'> = {\n  adapter: undefined,\n  geometry: AUTO_POSE_DESCRIPTOR as unknown as PoseDescriptor<unknown>,\n  boundsOf: undefined,\n};\n\nconst ALWAYS_VISIBLE = (): boolean => true;\n\nconst ALL_LAYERS = (s: readonly RenderLayer<unknown>[]): readonly RenderLayer<unknown>[] => s;\n\n\n/**\n * One view on a shared canvas. Owns a camera, contributes the viewport node\n * that paints it, and registers the dispatch record that sends gestures inside\n * its rect to that camera rather than to the canvas's.\n *\n * Renders nothing itself — it is a declaration, and the surface does the\n * drawing. Outside a surface that mounts a view registry it is inert.\n */\nexport function CanvasView(props: CanvasViewProps): null {\n  const {\n    id, parent, bounds,\n    layers = ALL_LAYERS, layerVisibility, layerOrder, background, order = Infinity, label, cameraRef,\n    selection: selectionProp, selectionOptions, interactive = true, paint = true,\n  } = props;\n\n  const registry = useOptionalViewRegistry();\n  const depRegistry = useOptionalDepRegistry();\n  const depRegistryRef = useLatest(depRegistry);\n\n  // Hooks run unconditionally; the owned selection goes unused unless this\n  // view asked for one.\n  const ownSelection = useSelection(selectionOptions);\n  const viewSelection = selectionProp ?? (selectionOptions ? ownSelection : undefined);\n\n  const inputs = useOptionalViewInputs();\n  // The selection this view acts on: its own when it has one, the surface's\n  // otherwise.\n  const selection = viewSelection ?? inputs?.selectionApi ?? ownSelection;\n\n  // Everything the registration reads is behind a ref: the registration object\n  // is registered once and must not churn, but what it answers with has to be\n  // the last committed render's.\n  const live = useLatest({\n    parent, bounds, layers, layerVisibility, layerOrder, viewSelection, selection,\n  });\n\n  const { frameIn, rectAt, derivedAt, drawnLayers, layerIsPainted } = useViewNesting(registry, live);\n\n  /** The rect for the surface's current frame — what a client point and a\n   *  clamp are measured against outside a draw call. */\n  const rectNow = useCallback((): ViewRect => {\n    const surface = registry?.surface();\n    return rectAt(surface?.view() ?? IDENTITY_VIEW, surface?.dims() ?? UNMEASURED_DIMS);\n  }, [registry, rectAt]);\n\n  const {\n    getView: camera, setView, setViewFromInput, subscribeView,\n    adoptControlled, announceControlled, clearSubscribers, held, aim, setAim, cameraAt,\n  } = useViewAim({ props, id, registry, derivedAt, rectAt, rectNow });\n  useInsertionEffect(adoptControlled);\n  useLayoutEffect(announceControlled);\n  useEffect(() => clearSubscribers, [clearSubscribers]);\n  useImperativeHandle(cameraRef, () => ({ getView: camera, setView, subscribeView }), [camera, setView, subscribeView]);\n\n  const viewApi = useMemo<ViewApi>(() => ({\n    get: camera,\n    set: setViewFromInput,\n    hostSize: () => sizeOf(rectNow()),\n    layerIsPainted,\n  }), [camera, rectNow, setViewFromInput, layerIsPainted]);\n\n  // Paste placement is a camera question, so it is this view's when the paste\n  // routed here. The rest of the dep — `resolveSrc`, `svg`, `clipboard` — is\n  // the surface's one wiring, read live off the canvas registry.\n  const ingestionApi = useMemo<IngestionDep>(() => {\n    const base = (): IngestionDep | undefined => depRegistryRef.current?.get('ingestion');\n    return {\n      viewportWorldRect: () => viewportWorldRect(camera(), sizeOf(rectNow())),\n      get resolveSrc() { return base()?.resolveSrc; },\n      get svg() { return base()?.svg; },\n      get clipboard() { return base()?.clipboard; },\n    };\n  }, [camera, rectNow, depRegistryRef]);\n\n  // One dispatcher per view: in-flight handles are per-view state, and two\n  // views must not be able to see each other's.\n  const dispatcherRef = useRef<ReturnType<typeof createDispatcher> | null>(null);\n  if (!dispatcherRef.current) dispatcherRef.current = createDispatcher();\n\n  // This view's overlay-aware state. The scene half comes from the surface —\n  // same adapter, same tools — but everything gesture-shaped is read off this\n  // view's own dispatcher, which is where a gesture inside this view lands.\n  const rotationBadge = inputs?.rotationBadge ?? null;\n  const own = useMemo(() => ({\n    gestureSource: createGestureSource(() => dispatcherRef.current),\n    ...createDispatcherPreviewSources(() => dispatcherRef.current),\n  }), []);\n\n  const inputsRef = useLatest(inputs);\n\n  /** The chrome-caps context this view answers for: its selection, its camera,\n   *  its dispatcher's in-flight action. */\n  const ruleInputs = useCallback((): ViewRuleInputs => ({\n    selection: live.current.selection.get(),\n    view: camera(),\n    action: dispatcherRef.current!.getActiveAction(),\n  }), [camera, live]);\n\n  // The surface's resolver, asked for this view's camera.\n  const surfaceBoundsOf = inputs?.boundsOf;\n  const boundsOf = useMemo(\n    () => (surfaceBoundsOf ? (id: string) => surfaceBoundsOf(id, camera()) : undefined),\n    [surfaceBoundsOf, camera],\n  );\n  const surfaceBoundsOfPose = inputs?.boundsOfPose;\n  const boundsOfPose = useMemo(\n    () => (surfaceBoundsOfPose\n      ? (id: string, pose: unknown) => surfaceBoundsOfPose(id, pose, camera())\n      : undefined),\n    [surfaceBoundsOfPose, camera],\n  );\n\n  const { helpers } = useViewHelpers<unknown>({\n    ...(inputs ?? NO_INPUTS),\n    boundsOf,\n    boundsOfPose,\n    ...own,\n    selection: selection.current,\n    layerIsPainted,\n    getIsVisible: () => inputsRef.current?.chromeCaps?.isVisible(ruleInputs()) ?? ALWAYS_VISIBLE,\n  });\n  const helpersRef = useLatest(helpers);\n\n  /** A client point in this view's world. The rect moves with the outer\n   *  camera, so it is read per call rather than closed over. */\n  const clientToWorldHere = useCallback((cx: number, cy: number): { x: number; y: number } => {\n    const local = surfaceLocal(registry?.surface() ?? null, cx, cy);\n    const rect = rectNow();\n    const [x, y] = clientToWorld(local.x, local.y, { left: rect.x, top: rect.y }, camera());\n    return { x, y };\n  }, [registry, rectNow, camera]);\n\n  // Anchors are hit in this view's camera world, where its plane draws them.\n  const getAnchorState = useMemo(() => anchorStateFrom(\n    () => depRegistryRef.current,\n    (id, path) => pathFromPlane(path, inputsRef.current?.planeOfNode?.(id, camera()) ?? null),\n  ), [camera, depRegistryRef, inputsRef]);\n\n  const { targetScale } = useDeviceProfile();\n\n  // Selection chrome hit-testing for this view: same construction the surface\n  // does for its own, against this view's chrome and camera.\n  const affordanceAt = useMemo(() => {\n    const inner = buildAffordanceAt({\n      getChromeState: () => helpersRef.current.getChromeState(),\n      getView: camera,\n      targetScale,\n      rotationBadge, handleHitRadius: inputs?.resizeHandles?.hitRadiusPx, edgeHandles: inputs?.resizeHandles?.edges,\n      getAnchorState,\n      getIsVisible: () => helpersRef.current.getIsVisible(),\n    });\n    return (world: { x: number; y: number }) => {\n      // A registered layer this view paints gets first refusal, on this\n      // view's frame and envelope. One painted over the surface already had\n      // its chance: it occludes the view before routing reaches here.\n      const extra = registry?.surface()?.hitTestExtras(\n        world.x, world.y, camera(), sizeOf(rectNow()), helpersRef.current, drawnLayers(),\n      );\n      return extra ? layerAffordance(extra.layerId, extra.hit) : registry?.markerAt(id, world) ?? inner(world);\n    };\n  }, [id, getAnchorState, rectNow, registry, targetScale, camera, drawnLayers, rotationBadge, inputs?.resizeHandles, helpersRef]);\n\n  const classifyTarget = useMemo(() => buildClassifyTarget(\n    () => live.current.selection.get(),\n    (wx, wy) => {\n      const i = inputsRef.current;\n      // This view's camera: the dispatcher converted with `clientToWorldHere`,\n      // and a screen-pixel tolerance needs the scale that produced it. The\n      // layer gate is this view's too, never the surface's.\n      const frame = { ...camera(), layerIsPainted };\n      if (i?.pickBest) return i.pickBest(wx, wy, frame);\n      const ids = i?.pickEvery?.(wx, wy, frame) ?? [];\n      return ids.length > 0 ? ids[ids.length - 1]! : null;\n    },\n    (id) => inputsRef.current?.kindOfNode?.(id),\n    (id) => inputsRef.current?.doubleClickNames?.(id) ?? id,\n  ), [camera, layerIsPainted, live, inputsRef]);\n\n  const registration = useMemo<ViewRegistration>(() => ({\n    id,\n    ...(parent !== undefined ? { parent } : {}),\n    order,\n    interactive,\n    paint,\n    held,\n    aim,\n    setAim,\n    layer: createViewportLayer<unknown, unknown>({\n      id,\n      label: label ?? id,\n      source: () => [...drawnLayers(), ...(registry?.markerLayers(id) ?? [])],\n      view: cameraAt,\n      bounds: (outer, dims) => rectAt(outer, dims),\n      ...(parent !== undefined ? { clip: (outer: View, dims: Dims) => frameIn(outer, dims)?.clip ?? NO_RECT } : {}),\n      // The surface half of the envelope passes through; the view half is\n      // this view's, so its layers paint its chrome rather than the\n      // surface's.\n      data: (outer) => ({ ...(outer as object), ...helpersRef.current, viewId: id }),\n      ...(background !== undefined ? { background } : {}),\n    }),\n    layerIsPainted,\n    drawnLayers,\n    target: {\n      dispatcher: dispatcherRef.current!,\n      affordanceAt,\n      classifyTarget,\n      clientToWorld: clientToWorldHere,\n      deps: () => ({\n        view: viewApi, ingestion: ingestionApi, hitAt: hitAtOf(classifyTarget),\n        // An Escape here cancels what is in flight here.\n        dispatcher: { cancelAll: (reason) => dispatcherRef.current!.cancelAll(reason) },\n        // Only a view with its own selection overlays that one; otherwise the\n        // surface's answer stands, wrappers (`selectable`) included.\n        ...(live.current.viewSelection ? { selection: live.current.viewSelection } : {}),\n      }),\n      // Action eligibility is chrome-caps evaluated against this view, so a\n      // rule that hides an action in one panel cannot decline a gesture in\n      // another.\n      getRuleCtx: () => inputsRef.current?.chromeCaps?.ruleCtx(ruleInputs()),\n    },\n  }), [id, parent, order, interactive, paint, held, aim, setAim, label, background, rectAt, cameraAt, viewApi,\n       affordanceAt, classifyTarget, clientToWorldHere, ruleInputs, ingestionApi, drawnLayers,\n       layerIsPainted, live, inputsRef, helpersRef, frameIn, registry]);\n\n  useEffect(() => {\n    if (!registry) return;\n    return registry.register(registration);\n  }, [registry, registration]);\n\n  // Apart from the registration, which is replaced whenever a prop it reads\n  // changes: only the view going away ends what is in flight over it.\n  useEffect(() => () => dispatcherRef.current?.cancelAll('cancel'), []);\n\n  // The surface paints this view from `live`, so any committed render of it —\n  // a controlled camera, its bounds, its layer gate — needs a frame.\n  useEffect(() => {\n    registry?.surface()?.requestRedraw();\n  });\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,IAAM,YAAqD;CACzD,SAAS;CACT,UAAU;CACV,UAAU;AACZ;AAEA,IAAM,uBAAgC;AAEtC,IAAM,cAAc,MAAwE;;;;;;;;;AAW5F,SAAgB,WAAW,OAA8B;CACvD,MAAM,EACJ,IAAI,QAAQ,QACZ,SAAS,YAAY,iBAAiB,YAAY,YAAY,QAAQ,UAAU,OAAO,WACvF,WAAW,eAAe,kBAAkB,cAAc,MAAM,QAAQ,SACtE;CAEJ,MAAM,WAAW,wBAAwB;CACzC,MAAM,cAAc,uBAAuB;CAC3C,MAAM,iBAAiB,UAAU,WAAW;CAI5C,MAAM,eAAe,aAAa,gBAAgB;CAClD,MAAM,gBAAgB,kBAAkB,mBAAmB,eAAe;CAE1E,MAAM,SAAS,sBAAsB;CAGrC,MAAM,YAAY,iBAAiB,QAAQ,gBAAgB;CAK3D,MAAM,OAAO,UAAU;EACrB;EAAQ;EAAQ;EAAQ;EAAiB;EAAY;EAAe;CACtE,CAAC;CAED,MAAM,EAAE,SAAS,QAAQ,WAAW,aAAa,mBAAmB,eAAe,UAAU,IAAI;;;CAIjG,MAAM,UAAU,kBAA4B;EAC1C,MAAM,UAAU,UAAU,QAAQ;EAClC,OAAO,OAAO,SAAS,KAAK,KAAK,eAAe,SAAS,KAAK,KAAK,eAAe;CACpF,GAAG,CAAC,UAAU,MAAM,CAAC;CAErB,MAAM,EACJ,SAAS,QAAQ,SAAS,kBAAkB,eAC5C,iBAAiB,oBAAoB,kBAAkB,MAAM,KAAK,QAAQ,aACxE,WAAW;EAAE;EAAO;EAAI;EAAU;EAAW;EAAQ;CAAQ,CAAC;CAClE,mBAAmB,eAAe;CAClC,gBAAgB,kBAAkB;CAClC,gBAAgB,kBAAkB,CAAC,gBAAgB,CAAC;CACpD,oBAAoB,kBAAkB;EAAE,SAAS;EAAQ;EAAS;CAAc,IAAI;EAAC;EAAQ;EAAS;CAAa,CAAC;CAEpH,MAAM,UAAU,eAAwB;EACtC,KAAK;EACL,KAAK;EACL,gBAAgB,OAAO,QAAQ,CAAC;EAChC;CACF,IAAI;EAAC;EAAQ;EAAS;EAAkB;CAAc,CAAC;CAKvD,MAAM,eAAe,cAA4B;EAC/C,MAAM,aAAuC,eAAe,SAAS,IAAI,WAAW;EACpF,OAAO;GACL,yBAAyB,kBAAkB,OAAO,GAAG,OAAO,QAAQ,CAAC,CAAC;GACtE,IAAI,aAAa;IAAE,OAAO,KAAK,CAAC,EAAE;GAAY;GAC9C,IAAI,MAAM;IAAE,OAAO,KAAK,CAAC,EAAE;GAAK;GAChC,IAAI,YAAY;IAAE,OAAO,KAAK,CAAC,EAAE;GAAW;EAC9C;CACF,GAAG;EAAC;EAAQ;EAAS;CAAc,CAAC;CAIpC,MAAM,gBAAgB,OAAmD,IAAI;CAC7E,IAAI,CAAC,cAAc,SAAS,cAAc,UAAU,iBAAiB;CAKrE,MAAM,gBAAgB,QAAQ,iBAAiB;CAC/C,MAAM,MAAM,eAAe;EACzB,eAAe,0BAA0B,cAAc,OAAO;EAC9D,GAAG,qCAAqC,cAAc,OAAO;CAC/D,IAAI,CAAC,CAAC;CAEN,MAAM,YAAY,UAAU,MAAM;;;CAIlC,MAAM,aAAa,mBAAmC;EACpD,WAAW,KAAK,QAAQ,UAAU,IAAI;EACtC,MAAM,OAAO;EACb,QAAQ,cAAc,QAAS,gBAAgB;CACjD,IAAI,CAAC,QAAQ,IAAI,CAAC;CAGlB,MAAM,kBAAkB,QAAQ;CAChC,MAAM,WAAW,cACR,mBAAmB,OAAe,gBAAgB,IAAI,OAAO,CAAC,IAAI,QACzE,CAAC,iBAAiB,MAAM,CAC1B;CACA,MAAM,sBAAsB,QAAQ;CACpC,MAAM,eAAe,cACZ,uBACF,IAAY,SAAkB,oBAAoB,IAAI,MAAM,OAAO,CAAC,IACrE,QACJ,CAAC,qBAAqB,MAAM,CAC9B;CAEA,MAAM,EAAE,YAAY,eAAwB;EAC1C,GAAI,UAAU;EACd;EACA;EACA,GAAG;EACH,WAAW,UAAU;EACrB;EACA,oBAAoB,UAAU,SAAS,YAAY,UAAU,WAAW,CAAC,KAAK;CAChF,CAAC;CACD,MAAM,aAAa,UAAU,OAAO;;;CAIpC,MAAM,oBAAoB,aAAa,IAAY,OAAyC;EAC1F,MAAM,QAAQ,aAAa,UAAU,QAAQ,KAAK,MAAM,IAAI,EAAE;EAC9D,MAAM,OAAO,QAAQ;EACrB,MAAM,CAAC,GAAG,KAAK,cAAc,MAAM,GAAG,MAAM,GAAG;GAAE,MAAM,KAAK;GAAG,KAAK,KAAK;EAAE,GAAG,OAAO,CAAC;EACtF,OAAO;GAAE;GAAG;EAAE;CAChB,GAAG;EAAC;EAAU;EAAS;CAAM,CAAC;CAG9B,MAAM,iBAAiB,cAAc,sBAC7B,eAAe,UACpB,IAAI,SAAS,cAAc,MAAM,UAAU,SAAS,cAAc,IAAI,OAAO,CAAC,KAAK,IAAI,CAC1F,GAAG;EAAC;EAAQ;EAAgB;CAAS,CAAC;CAEtC,MAAM,EAAE,gBAAgB,iBAAiB;CAIzC,MAAM,eAAe,cAAc;EACjC,MAAM,QAAQ,kBAAkB;GAC9B,sBAAsB,WAAW,QAAQ,eAAe;GACxD,SAAS;GACT;GACA;GAAe,iBAAiB,QAAQ,eAAe;GAAa,aAAa,QAAQ,eAAe;GACxG;GACA,oBAAoB,WAAW,QAAQ,aAAa;EACtD,CAAC;EACD,QAAQ,UAAoC;GAI1C,MAAM,QAAQ,UAAU,QAAQ,CAAC,EAAE,cACjC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,QAAQ,CAAC,GAAG,WAAW,SAAS,YAAY,CACjF;GACA,OAAO,QAAQ,gBAAgB,MAAM,SAAS,MAAM,GAAG,IAAI,UAAU,SAAS,IAAI,KAAK,KAAK,MAAM,KAAK;EACzG;CACF,GAAG;EAAC;EAAI;EAAgB;EAAS;EAAU;EAAa;EAAQ;EAAa;EAAe,QAAQ;EAAe;CAAU,CAAC;CAE9H,MAAM,iBAAiB,cAAc,0BAC7B,KAAK,QAAQ,UAAU,IAAI,IAChC,IAAI,OAAO;EACV,MAAM,IAAI,UAAU;EAIpB,MAAM,QAAQ;GAAE,GAAG,OAAO;GAAG;EAAe;EAC5C,IAAI,GAAG,UAAU,OAAO,EAAE,SAAS,IAAI,IAAI,KAAK;EAChD,MAAM,MAAM,GAAG,YAAY,IAAI,IAAI,KAAK,KAAK,CAAC;EAC9C,OAAO,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,KAAM;CACjD,IACC,OAAO,UAAU,SAAS,aAAa,EAAE,IACzC,OAAO,UAAU,SAAS,mBAAmB,EAAE,KAAK,EACvD,GAAG;EAAC;EAAQ;EAAgB;EAAM;CAAS,CAAC;CAE5C,MAAM,eAAe,eAAiC;EACpD;EACA,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;EACzC;EACA;EACA;EACA;EACA;EACA;EACA,OAAO,oBAAsC;GAC3C;GACA,OAAO,SAAS;GAChB,cAAc,CAAC,GAAG,YAAY,GAAG,GAAI,UAAU,aAAa,EAAE,KAAK,CAAC,CAAE;GACtE,MAAM;GACN,SAAS,OAAO,SAAS,OAAO,OAAO,IAAI;GAC3C,GAAI,WAAW,SAAY,EAAE,OAAO,OAAa,SAAe,QAAQ,OAAO,IAAI,CAAC,EAAE,QAAQ,QAAQ,IAAI,CAAC;GAI3G,OAAO,WAAW;IAAE,GAAI;IAAkB,GAAG,WAAW;IAAS,QAAQ;GAAG;GAC5E,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;EACnD,CAAC;EACD;EACA;EACA,QAAQ;GACN,YAAY,cAAc;GAC1B;GACA;GACA,eAAe;GACf,aAAa;IACX,MAAM;IAAS,WAAW;IAAc,OAAO,QAAQ,cAAc;IAErE,YAAY,EAAE,YAAY,WAAW,cAAc,QAAS,UAAU,MAAM,EAAE;IAG9E,GAAI,KAAK,QAAQ,gBAAgB,EAAE,WAAW,KAAK,QAAQ,cAAc,IAAI,CAAC;GAChF;GAIA,kBAAkB,UAAU,SAAS,YAAY,QAAQ,WAAW,CAAC;EACvE;CACF,IAAI;EAAC;EAAI;EAAQ;EAAO;EAAa;EAAO;EAAM;EAAK;EAAQ;EAAO;EAAY;EAAQ;EAAU;EAC/F;EAAc;EAAgB;EAAmB;EAAY;EAAc;EAC3E;EAAgB;EAAM;EAAW;EAAY;EAAS;CAAQ,CAAC;CAEpE,gBAAgB;EACd,IAAI,CAAC,UAAU;EACf,OAAO,SAAS,SAAS,YAAY;CACvC,GAAG,CAAC,UAAU,YAAY,CAAC;CAI3B,sBAAsB,cAAc,SAAS,UAAU,QAAQ,GAAG,CAAC,CAAC;CAIpE,gBAAgB;EACd,UAAU,QAAQ,CAAC,EAAE,cAAc;CACrC,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"CanvasView.js","names":[],"sources":["../../src/canvas/CanvasView.tsx"],"sourcesContent":["/**\n * `<CanvasView>` — a second view on an existing canvas: its own camera over a\n * rect of the surface, with input routed to it.\n *\n * Mount one inside `<SceneCanvas>`, or declare the same thing through the\n * surface's `views` prop, which renders one of these per descriptor.\n */\nimport {\n  useCallback, useEffect, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useRef,\n} from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { View } from 'core/viewport/view';\nimport { clientToWorld } from 'core/viewport/clientToWorld';\nimport { createViewportLayer } from 'domains/viewports/viewportLayer';\nimport { createDispatcher } from '@weasel-js/routing';\nimport type { IngestionDep, ViewApi } from 'interactions/actions/depSchema';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport { useSelection, type SelectionApi } from 'core/selection/useSelection';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useViewHelpers } from './useViewHelpers';\nimport { useViewAim } from './useViewAim';\nimport { hitAtOf } from './deps/dispatchSources';\nimport { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from './affordanceAt';\nimport { pathFromPlane } from './planeClips';\nimport { useOptionalDepRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { useDeviceProfile } from 'core/device/useDeviceProfile';\nimport {\n  createGestureSource,\n  createDispatcherPreviewSources,\n} from './SceneCanvas/dispatcherGestureBounds';\nimport { useOptionalViewInputs, type SurfaceViewInputs, type ViewRuleInputs } from './viewInputs';\nimport type { CanvasViewProps, ViewRect } from './canvasViewProps';\nexport type { CanvasViewProps, ViewRect } from './canvasViewProps';\nimport { NO_RECT, sizeOf, useViewNesting } from './useViewNesting';\nimport {\n  useOptionalViewRegistry,\n  surfaceLocal,\n  IDENTITY_VIEW,\n  UNMEASURED_DIMS,\n  type ViewRegistration,\n} from './viewRegistry';\n\n/** What a view builds its helpers from outside a surface: nothing but the\n *  default geometry, which answers `null` for every lookup. */\n// A view outside a surface has no inputs to inherit — including a selection,\n// so it falls back to owning one.\nconst NO_INPUTS: Omit<SurfaceViewInputs, 'selectionApi'> = {\n  adapter: undefined,\n  geometry: AUTO_POSE_DESCRIPTOR as unknown as PoseDescriptor<unknown>,\n  boundsOf: undefined,\n};\n\nconst ALWAYS_VISIBLE = (): boolean => true;\n\n// Only a view that owns a selection, or follows one that does, overlays it; otherwise the surface's answer\n// stands, wrappers (`selectable`) included.\nconst selectionOverlay = (selection: SelectionApi | undefined) => (selection ? { selection } : {});\n\nconst ALL_LAYERS = (s: readonly RenderLayer<unknown>[]): readonly RenderLayer<unknown>[] => s;\n\n\n/**\n * One view on a shared canvas. Owns a camera, contributes the viewport node\n * that paints it, and registers the dispatch record that sends gestures inside\n * its rect to that camera rather than to the canvas's.\n *\n * Renders nothing itself — it is a declaration, and the surface does the\n * drawing. Outside a surface that mounts a view registry it is inert.\n */\nexport function CanvasView(props: CanvasViewProps): null {\n  const {\n    id, parent, follows, bounds,\n    layers = ALL_LAYERS, layerVisibility, layerOrder, background, order = Infinity, label, cameraRef,\n    selection: selectionProp, selectionOptions, interactive = true, paint = true,\n  } = props;\n\n  const registry = useOptionalViewRegistry();\n  const depRegistry = useOptionalDepRegistry();\n  const depRegistryRef = useLatest(depRegistry);\n\n  // Hooks run unconditionally; the owned selection goes unused unless this\n  // view asked for one.\n  const ownSelection = useSelection(selectionOptions);\n  const viewSelection = selectionProp ?? (selectionOptions ? ownSelection : undefined);\n\n  const inputs = useOptionalViewInputs();\n  const shared = inputs?.selectionApi ?? ownSelection;\n\n  // Everything the registration reads is behind a ref: the registration object\n  // is registered once and must not churn, but what it answers with has to be\n  // the last committed render's.\n  const live = useLatest({\n    parent, follows, bounds, layers, layerVisibility, layerOrder, viewSelection, shared,\n  });\n\n  const {\n    frameIn, rectAt, derivedAt, drawnLayers, layerIsPainted, ownedSelection, selectionNow,\n  } = useViewNesting(registry, live);\n\n  /** The rect for the surface's current frame — what a client point and a\n   *  clamp are measured against outside a draw call. */\n  const rectNow = useCallback((): ViewRect => {\n    const surface = registry?.surface();\n    return rectAt(surface?.view() ?? IDENTITY_VIEW, surface?.dims() ?? UNMEASURED_DIMS);\n  }, [registry, rectAt]);\n\n  const {\n    getView: camera, setView, setViewFromInput, subscribeView,\n    adoptControlled, announceControlled, clearSubscribers, held, aim, setAim, cameraAt,\n  } = useViewAim({ props, id, registry, derivedAt, rectAt, rectNow });\n  useInsertionEffect(adoptControlled);\n  useLayoutEffect(announceControlled);\n  useEffect(() => clearSubscribers, [clearSubscribers]);\n  useImperativeHandle(cameraRef, () => ({ getView: camera, setView, subscribeView }), [camera, setView, subscribeView]);\n\n  const viewApi = useMemo<ViewApi>(() => ({\n    get: camera,\n    set: setViewFromInput,\n    hostSize: () => sizeOf(rectNow()),\n    layerIsPainted,\n  }), [camera, rectNow, setViewFromInput, layerIsPainted]);\n\n  // Paste placement is a camera question, so it is this view's when the paste\n  // routed here. The rest of the dep — `resolveSrc`, `svg`, `clipboard`, `handlers` — is\n  // the surface's one wiring, read live off the canvas registry.\n  const ingestionApi = useMemo<IngestionDep>(() => {\n    const base = (): IngestionDep | undefined => depRegistryRef.current?.get('ingestion');\n    return {\n      viewportWorldRect: () => viewportWorldRect(camera(), sizeOf(rectNow())),\n      get resolveSrc() { return base()?.resolveSrc; },\n      get svg() { return base()?.svg; },\n      get clipboard() { return base()?.clipboard; }, get handlers() { return base()?.handlers; },\n    };\n  }, [camera, rectNow, depRegistryRef]);\n\n  // One dispatcher per view: in-flight handles are per-view state, and two\n  // views must not be able to see each other's.\n  const dispatcherRef = useRef<ReturnType<typeof createDispatcher> | null>(null);\n  if (!dispatcherRef.current) dispatcherRef.current = createDispatcher();\n\n  // This view's overlay-aware state. The scene half comes from the surface —\n  // same adapter, same tools — but everything gesture-shaped is read off this\n  // view's own dispatcher, which is where a gesture inside this view lands.\n  const rotationBadge = inputs?.rotationBadge ?? null;\n  const own = useMemo(() => ({\n    gestureSource: createGestureSource(() => dispatcherRef.current),\n    ...createDispatcherPreviewSources(() => dispatcherRef.current),\n  }), []);\n\n  const inputsRef = useLatest(inputs);\n\n  /** The chrome-caps context this view answers for: its selection, its camera,\n   *  its dispatcher's in-flight action. */\n  const ruleInputs = useCallback((): ViewRuleInputs => ({\n    selection: selectionNow().get(),\n    view: camera(),\n    action: dispatcherRef.current!.getActiveAction(),\n  }), [camera, selectionNow]);\n\n  // The surface's resolver, asked for this view's camera.\n  const surfaceBoundsOf = inputs?.boundsOf;\n  const boundsOf = useMemo(\n    () => (surfaceBoundsOf ? (id: string) => surfaceBoundsOf(id, camera()) : undefined),\n    [surfaceBoundsOf, camera],\n  );\n  const surfaceBoundsOfPose = inputs?.boundsOfPose;\n  const boundsOfPose = useMemo(\n    () => (surfaceBoundsOfPose\n      ? (id: string, pose: unknown) => surfaceBoundsOfPose(id, pose, camera())\n      : undefined),\n    [surfaceBoundsOfPose, camera],\n  );\n\n  const { helpers } = useViewHelpers<unknown>({\n    ...(inputs ?? NO_INPUTS),\n    boundsOf,\n    boundsOfPose,\n    ...own,\n    selection: () => selectionNow().current,\n    layerIsPainted,\n    getIsVisible: () => inputsRef.current?.chromeCaps?.isVisible(ruleInputs()) ?? ALWAYS_VISIBLE,\n  });\n  const helpersRef = useLatest(helpers);\n\n  /** A client point in this view's world. The rect moves with the outer\n   *  camera, so it is read per call rather than closed over. */\n  const clientToWorldHere = useCallback((cx: number, cy: number): { x: number; y: number } => {\n    const local = surfaceLocal(registry?.surface() ?? null, cx, cy);\n    const rect = rectNow();\n    const [x, y] = clientToWorld(local.x, local.y, { left: rect.x, top: rect.y }, camera());\n    return { x, y };\n  }, [registry, rectNow, camera]);\n\n  // Anchors are hit in this view's camera world, where its plane draws them.\n  const getAnchorState = useMemo(() => anchorStateFrom(\n    () => depRegistryRef.current,\n    (id, path) => pathFromPlane(path, inputsRef.current?.planeOfNode?.(id, camera()) ?? null),\n  ), [camera, depRegistryRef, inputsRef]);\n\n  const { targetScale } = useDeviceProfile();\n\n  // Selection chrome hit-testing for this view: same construction the surface\n  // does for its own, against this view's chrome and camera.\n  const affordanceAt = useMemo(() => {\n    const inner = buildAffordanceAt({\n      getChromeState: () => helpersRef.current.getChromeState(),\n      getView: camera,\n      targetScale,\n      rotationBadge, handleHitRadius: inputs?.resizeHandles?.hitRadiusPx, edgeHandles: inputs?.resizeHandles?.edges,\n      getAnchorState,\n      getIsVisible: () => helpersRef.current.getIsVisible(),\n    });\n    return (world: { x: number; y: number }) => {\n      // A registered layer this view paints gets first refusal, on this\n      // view's frame and envelope. One painted over the surface already had\n      // its chance: it occludes the view before routing reaches here.\n      const extra = registry?.surface()?.hitTestExtras(\n        world.x, world.y, camera(), sizeOf(rectNow()), helpersRef.current, drawnLayers(),\n      );\n      return extra ? layerAffordance(extra.layerId, extra.hit) : registry?.markerAt(id, world) ?? inner(world);\n    };\n  }, [id, getAnchorState, rectNow, registry, targetScale, camera, drawnLayers, rotationBadge, inputs?.resizeHandles, helpersRef]);\n\n  const classifyTarget = useMemo(() => buildClassifyTarget(\n    () => selectionNow().get(),\n    (world) => {\n      const i = inputsRef.current;\n      // This view's camera: the dispatcher converted with `clientToWorldHere`,\n      // and a screen-pixel tolerance needs the scale that produced it. The\n      // layer gate is this view's too, never the surface's.\n      const frame = { ...camera(), layerIsPainted };\n      if (i?.pickBest) return i.pickBest(world, frame);\n      const ids = i?.pickEvery?.(world, frame) ?? [];\n      return ids.length > 0 ? ids[ids.length - 1]! : null;\n    },\n    (id) => inputsRef.current?.kindOfNode?.(id),\n    (id) => inputsRef.current?.doubleClickNames?.(id) ?? id,\n  ), [camera, layerIsPainted, selectionNow, inputsRef]);\n\n  const registration = useMemo<ViewRegistration>(() => ({\n    id,\n    ...(parent !== undefined ? { parent } : {}),\n    order,\n    interactive,\n    paint,\n    held,\n    aim,\n    setAim,\n    layer: createViewportLayer<unknown, unknown>({\n      id,\n      label: label ?? id,\n      source: () => [...drawnLayers(), ...(registry?.markerLayers(id) ?? [])],\n      view: cameraAt,\n      bounds: (outer, dims) => rectAt(outer, dims),\n      ...(parent !== undefined ? { clip: (outer: View, dims: Dims) => frameIn(outer, dims)?.clip ?? NO_RECT } : {}),\n      // The surface half of the envelope passes through; the view half is\n      // this view's, so its layers paint its chrome rather than the\n      // surface's.\n      data: (outer) => ({ ...(outer as object), ...helpersRef.current, viewId: id }),\n      ...(background !== undefined ? { background } : {}),\n    }),\n    layerIsPainted,\n    drawnLayers,\n    selection: ownedSelection,\n    target: {\n      dispatcher: dispatcherRef.current!,\n      affordanceAt,\n      classifyTarget,\n      clientToWorld: clientToWorldHere,\n      deps: () => ({\n        view: viewApi, ingestion: ingestionApi, hitAt: hitAtOf(classifyTarget),\n        // An Escape here cancels what is in flight here.\n        dispatcher: { cancelAll: (reason) => dispatcherRef.current!.cancelAll(reason) },\n        ...selectionOverlay(ownedSelection()),\n      }),\n      // Action eligibility is chrome-caps evaluated against this view, so a\n      // rule that hides an action in one panel cannot decline a gesture in\n      // another.\n      getRuleCtx: () => inputsRef.current?.chromeCaps?.ruleCtx(ruleInputs()),\n    },\n  }), [id, parent, order, interactive, paint, held, aim, setAim, label, background, rectAt, cameraAt, viewApi,\n       affordanceAt, classifyTarget, clientToWorldHere, ruleInputs, ingestionApi, drawnLayers,\n       layerIsPainted, ownedSelection, inputsRef, helpersRef, frameIn, registry]);\n\n  useEffect(() => {\n    if (!registry) return;\n    return registry.register(registration);\n  }, [registry, registration]);\n\n  // Apart from the registration, which is replaced whenever a prop it reads\n  // changes: only the view going away ends what is in flight over it.\n  useEffect(() => () => dispatcherRef.current?.cancelAll('cancel'), []);\n\n  // The surface paints this view from `live`, so any committed render of it —\n  // a controlled camera, its bounds, its layer gate — needs a frame.\n  useEffect(() => {\n    registry?.surface()?.requestRedraw();\n  });\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/canvas/GestureReason.js

@@ -0,0 +1,64 @@
+import { viewToTransform } from "../core/viewport/view.js";
+import { worldToScreen } from "../core/viewport/viewTransform.js";
+import { resolveOverlays } from "../interactions/actions/resolveOverlays.js";
+import GestureReason_module_default from "./GestureReason.module.js";
+import { useEffect, useState } from "react";
+import { overlaysOf } from "@weasel-js/routing";
+import { jsx } from "react/jsx-runtime";
+
+//#region 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
+* as text.
+*/
+/** How far below and right of the pointer the reason sits, in CSS pixels. */
+var OFFSET = 14;
+/** The first `reason` overlay of the dispatcher's in-flight gestures, shown beside the pointer. */
+function GestureReason({ dispatcher, canvasRef, viewRef }) {
+	const [shown, setShown] = useState(null);
+	useEffect(() => {
+		if (!dispatcher) return;
+		const read = () => {
+			const all = [...dispatcher.getInFlightHandles()].flatMap((h) => [...overlaysOf(h)]);
+			const reason = resolveOverlays(all).find((o) => o.kind === "reason");
+			const canvas = canvasRef.current;
+			const view = viewRef.current;
+			if (reason?.kind !== "reason" || !canvas || !view) {
+				setShown(null);
+				return;
+			}
+			const r = canvas.getBoundingClientRect();
+			const [sx, sy] = worldToScreen(reason.at.x, reason.at.y, viewToTransform(view));
+			setShown({
+				left: r.left + sx + OFFSET,
+				top: r.top + sy + OFFSET,
+				text: reason.text
+			});
+		};
+		read();
+		const off = dispatcher.subscribe(read);
+		return () => {
+			off();
+			setShown(null);
+		};
+	}, [
+		dispatcher,
+		canvasRef,
+		viewRef
+	]);
+	if (shown === null) return null;
+	return /* @__PURE__ */ jsx("div", {
+		role: "status",
+		className: GestureReason_module_default.reason,
+		style: {
+			left: shown.left,
+			top: shown.top
+		},
+		children: shown.text
+	});
+}
+
+//#endregion
+export { GestureReason };
+//# sourceMappingURL=GestureReason.js.map

package/dist/canvas/GestureReason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureReason.js","names":["s"],"sources":["../../src/canvas/GestureReason.tsx"],"sourcesContent":["/// <reference path=\"../css-modules.d.ts\" />\n/**\n * The reason an in-flight gesture cannot land where it is, beside the pointer:\n * the DOM half of the `reason` overlay, which the canvas layers cannot paint\n * as text.\n */\nimport { useEffect, useState, type RefObject } from 'react';\nimport { overlaysOf, type Dispatcher } from '@weasel-js/routing';\nimport { viewToTransform, type View } from 'core/viewport/view';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport { resolveOverlays } from 'interactions/actions/resolveOverlays';\nimport s from './GestureReason.module.css';\n\n/** How far below and right of the pointer the reason sits, in CSS pixels. */\nconst OFFSET = 14;\n\nexport interface GestureReasonProps {\n  dispatcher: Dispatcher | null | undefined;\n  canvasRef: RefObject<HTMLElement | null>;\n  viewRef: RefObject<View>;\n}\n\ninterface Shown { left: number; top: number; text: string }\n\n/** The first `reason` overlay of the dispatcher's in-flight gestures, shown beside the pointer. */\nexport function GestureReason({ dispatcher, canvasRef, viewRef }: GestureReasonProps) {\n  const [shown, setShown] = useState<Shown | null>(null);\n  useEffect(() => {\n    if (!dispatcher) return;\n    const read = () => {\n      const all = [...dispatcher.getInFlightHandles()].flatMap((h) => [...overlaysOf(h)]);\n      const reason = resolveOverlays(all).find((o) => o.kind === 'reason');\n      const canvas = canvasRef.current;\n      const view = viewRef.current;\n      if (reason?.kind !== 'reason' || !canvas || !view) {\n        setShown(null);\n        return;\n      }\n      const r = canvas.getBoundingClientRect();\n      const [sx, sy] = worldToScreen(reason.at.x, reason.at.y, viewToTransform(view));\n      setShown({ left: r.left + sx + OFFSET, top: r.top + sy + OFFSET, text: reason.text });\n    };\n    read();\n    const off = dispatcher.subscribe(read);\n    return () => {\n      off();\n      setShown(null);\n    };\n  }, [dispatcher, canvasRef, viewRef]);\n  if (shown === null) return null;\n  // The pointer moves it every frame; nothing but an inline position can follow it.\n  return <div role=\"status\" className={s.reason} style={{ left: shown.left, top: shown.top }}>{shown.text}</div>;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,IAAM,SAAS;;AAWf,SAAgB,cAAc,EAAE,YAAY,WAAW,WAA+B;CACpF,MAAM,CAAC,OAAO,YAAY,SAAuB,IAAI;CACrD,gBAAgB;EACd,IAAI,CAAC,YAAY;EACjB,MAAM,aAAa;GACjB,MAAM,MAAM,CAAC,GAAG,WAAW,mBAAmB,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;GAClF,MAAM,SAAS,gBAAgB,GAAG,CAAC,CAAC,MAAM,MAAM,EAAE,SAAS,QAAQ;GACnE,MAAM,SAAS,UAAU;GACzB,MAAM,OAAO,QAAQ;GACrB,IAAI,QAAQ,SAAS,YAAY,CAAC,UAAU,CAAC,MAAM;IACjD,SAAS,IAAI;IACb;GACF;GACA,MAAM,IAAI,OAAO,sBAAsB;GACvC,MAAM,CAAC,IAAI,MAAM,cAAc,OAAO,GAAG,GAAG,OAAO,GAAG,GAAG,gBAAgB,IAAI,CAAC;GAC9E,SAAS;IAAE,MAAM,EAAE,OAAO,KAAK;IAAQ,KAAK,EAAE,MAAM,KAAK;IAAQ,MAAM,OAAO;GAAK,CAAC;EACtF;EACA,KAAK;EACL,MAAM,MAAM,WAAW,UAAU,IAAI;EACrC,aAAa;GACX,IAAI;GACJ,SAAS,IAAI;EACf;CACF,GAAG;EAAC;EAAY;EAAW;CAAO,CAAC;CACnC,IAAI,UAAU,MAAM,OAAO;CAE3B,OAAO,oBAAC,OAAD;EAAK,MAAK;EAAS,WAAWA,6BAAE;EAAQ,OAAO;GAAE,MAAM,MAAM;GAAM,KAAK,MAAM;EAAI;EAAI,UAAA,MAAM;CAAU,CAAA;AAC/G"}

package/dist/canvas/GestureReason.module.js

@@ -0,0 +1,7 @@
+//#region 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/GestureReason.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureReason.module.js","names":[],"sources":["../../src/canvas/GestureReason.module.css"],"sourcesContent":["/* A refusal's reason, held beside the pointer while a drag is over what refuses it. */\n.reason {\n  position: fixed;\n  z-index: var(--wzl-z-hud, 900);\n  max-width: 280px;\n  padding: var(--wzl-space-2, 4px) var(--wzl-space-3, 6px);\n  border-left: 3px solid var(--wzl-danger, #d93636);\n  border-radius: var(--wzl-radius-sm, 3px);\n  background: var(--wzl-surface-popover, #fff);\n  color: var(--wzl-fg, #1a1a1a);\n  box-shadow: var(--wzl-shadow, 0 1px 4px rgba(0, 0, 0, 0.25));\n  font: var(--wzl-font-size-sm, 12px) / 1.35 system-ui, sans-serif;\n  pointer-events: none;\n}\n"],"mappings":""}

package/dist/canvas/LeanSceneCanvas.js

@@ -1,11 +1,13 @@
 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
 var LEAN_SOURCE = {
 	named: null,
-	pool: toolDrivenActions
+	pool: toolDrivenActions,
+	baseline: BASELINE_ACTIONS
 };
 function LeanSceneCanvasWrapper(props, ref) {
 	return renderSceneCanvas(LEAN_SOURCE, props, ref);

package/dist/canvas/LeanSceneCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"LeanSceneCanvas.js","names":[],"sources":["../../src/canvas/LeanSceneCanvas.tsx"],"sourcesContent":["import type React from 'react';\nimport { forwardRef } from 'react';\nimport type { SceneCanvasApi } from './canvasExtension';\nimport { renderSceneCanvas } from './SceneCanvas';\nimport type { FeaturePreset, PresetSource } from './SceneCanvas/features';\nimport type { SceneCanvasProps } from './SceneCanvas/props';\nimport { toolDrivenActions } from './SceneCanvas/presets/toolDriven';\n\nconst LEAN_SOURCE: PresetSource = { named: null, pool: toolDrivenActions };\n\n/** Props for {@link LeanSceneCanvas}: `<SceneCanvas>`'s, with `features`\n *  taking preset objects only. */\nexport type LeanSceneCanvasProps<TData, TLayer extends string, TPose> =\n  Omit<SceneCanvasProps<TData, TLayer, TPose>, 'features'> & { features?: readonly FeaturePreset[] };\n\nfunction LeanSceneCanvasWrapper<TData, TLayer extends string, TPose>(\n  props: LeanSceneCanvasProps<TData, TLayer, TPose>,\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return renderSceneCanvas(LEAN_SOURCE, props, ref);\n}\n\n/**\n * `<SceneCanvas>` without core's preset names: `features` takes preset\n * objects (`selectPreset`, `editPreset`, a package's own), and a preset the\n * app does not import is not in its bundle. `viewport` does not imply\n * `viewPreset` here; pass it.\n */\nexport const LeanSceneCanvas = forwardRef(LeanSceneCanvasWrapper) as <\n  TData, TLayer extends string, TPose,\n>(\n  props: LeanSceneCanvasProps<TData, TLayer, TPose> & { ref?: React.Ref<SceneCanvasApi> },\n) => React.ReactElement;\n"],"mappings":";;;;;AAQA,IAAM,cAA4B;CAAE,OAAO;CAAM,MAAM;AAAkB;AAOzE,SAAS,uBACP,OACA,KACA;CACA,OAAO,kBAAkB,aAAa,OAAO,GAAG;AAClD;;;;;;;AAQA,IAAa,kBAAkB,WAAW,sBAAsB"}
+{"version":3,"file":"LeanSceneCanvas.js","names":[],"sources":["../../src/canvas/LeanSceneCanvas.tsx"],"sourcesContent":["import type React from 'react';\nimport { forwardRef } from 'react';\nimport type { SceneCanvasApi } from './canvasExtension';\nimport { renderSceneCanvas } from './SceneCanvas';\nimport type { FeaturePreset, PresetSource } from './SceneCanvas/features';\nimport type { SceneCanvasProps } from './SceneCanvas/props';\nimport { toolDrivenActions } from './SceneCanvas/presets/toolDriven';\nimport { BASELINE_ACTIONS } from './SceneCanvas/presets/baseline';\n\nconst LEAN_SOURCE: PresetSource = { named: null, pool: toolDrivenActions, baseline: BASELINE_ACTIONS };\n\n/** Props for {@link LeanSceneCanvas}: `<SceneCanvas>`'s, with `features`\n *  taking preset objects only. */\nexport type LeanSceneCanvasProps<TData, TLayer extends string, TPose> =\n  Omit<SceneCanvasProps<TData, TLayer, TPose>, 'features'> & { features?: readonly FeaturePreset[] };\n\nfunction LeanSceneCanvasWrapper<TData, TLayer extends string, TPose>(\n  props: LeanSceneCanvasProps<TData, TLayer, TPose>,\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return renderSceneCanvas(LEAN_SOURCE, props, ref);\n}\n\n/**\n * `<SceneCanvas>` without core's preset names: `features` takes preset\n * objects (`selectPreset`, `editPreset`, a package's own), and a preset the\n * app does not import is not in its bundle. `viewport` does not imply\n * `viewPreset` here; pass it.\n */\nexport const LeanSceneCanvas = forwardRef(LeanSceneCanvasWrapper) as <\n  TData, TLayer extends string, TPose,\n>(\n  props: LeanSceneCanvasProps<TData, TLayer, TPose> & { ref?: React.Ref<SceneCanvasApi> },\n) => React.ReactElement;\n"],"mappings":";;;;;;AASA,IAAM,cAA4B;CAAE,OAAO;CAAM,MAAM;CAAmB,UAAU;AAAiB;AAOrG,SAAS,uBACP,OACA,KACA;CACA,OAAO,kBAAkB,aAAa,OAAO,GAAG;AAClD;;;;;;;AAQA,IAAa,kBAAkB,WAAW,sBAAsB"}

package/dist/canvas/NodeShape.js

@@ -1,4 +1,5 @@
 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";
@@ -104,6 +105,7 @@ function findShapeSilhouette(node, pose, ctx) {
 	}
 	return nodeMemo(node, SILHOUETTE_SLOT, pose, build);
 }
+setDepOutlineReader((dep) => findShapeSilhouette(dep.node, dep.pose, { derivedPath: dep.path }));
 /** Find the painter for `node` and ask how it inks its silhouette. Returns
 *  the painter's declared {@link NodeInk}, or `null` when no painter matches
 *  or it declares none — callers substitute {@link DEFAULT_INK}. */

package/dist/canvas/NodeShape.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeShape.js","names":[],"sources":["../../src/canvas/NodeShape.ts"],"sourcesContent":["/**\n * NodeShape — the **shape trait's** registry: the per-kind `paint` + `silhouette` used by\n * `defaultDrawOne`, clipping, non-rect hit-testing, and lasso/area-select. Teaching the kit\n * about a new kind of shape goes through this registry rather than by overriding `drawOne`.\n *\n * The first entry whose `matches` predicate returns true paints the node: `'high'` entries\n * first, then the built-ins, then `'normal'` ones, in registration order within a tier. Every\n * built-in but `kit:derived` additionally requires a rect-shaped pose — a scene whose poses are\n * some other shape matches none of them, and paints through a consumer painter or not at all.\n */\nimport { glyphGeneration } from '@weasel-js/font';\nimport {\n  pathContainsPoint,\n  strokeHitTest,\n  type Path\n} from '@weasel-js/geom';\nimport { pathThroughPoseFrame } from '@weasel-js/geom';\nimport { bumpNodeMemoGeneration, nodeMemo } from 'core/scene/nodeMemo';\nimport type { Node } from 'core/scene/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport { hasSlop, slopForStrokeHit, widenSlop, type PickSlop } from 'core/viewport/screenSlop';\nimport { DERIVED_PAINTER } from './nodeShapes/derivedPainter';\nimport { IMAGE_PAINTER } from './nodeShapes/imagePainter';\nimport { MEASURE_PAINTER } from './nodeShapes/measurePainter';\nimport { derivesPath } from './nodeShapes/memo';\nimport { PATH_PAINTER } from './nodeShapes/pathPainter';\nimport { paintsPose } from './nodeShapes/poseBox';\nimport { RECT_FALLBACK_PAINTER } from './nodeShapes/rectFallbackPainter';\nimport { SHAPE_PAINTER } from './nodeShapes/shapePainter';\nimport { TEXT_PAINTER } from './nodeShapes/textPainter';\nimport type { NodeShapeEntry, NodeInk, NodeSilhouetteCtx, NodeInkCtx } from './nodeShapeTypes';\nexport type { NodePaintCtx, SceneViewDrawOne, NodeShapeEntry, NodeInk, NodeSilhouetteCtx, NodeInkCtx } from './nodeShapeTypes';\nexport type { InheritedPaint } from 'core/scene/inheritedPaint';\n\n/** What a painter that declares no `ink` is assumed to do. */\nexport const DEFAULT_INK: Readonly<NodeInk> = Object.freeze({ filled: true, outset: 0, inset: 0 });\n\n/** Options for `registerNodeShape`. */\nexport interface RegisterNodeShapeOptions {\n  /** `'high'` puts the painter ahead of all normally-registered ones (so\n   *  it can win over a kit built-in). `'normal'` appends at the end. */\n  priority?: 'high' | 'normal';\n}\n\nconst PAINTERS: { high: NodeShapeEntry[]; normal: NodeShapeEntry[] } = {\n  high: [],\n  normal: [],\n};\n\n// The built-ins go in on first use, not at module load: a bundler may drop an\n// import kept only for its side effect, and the registry would come up empty.\nlet builtInsRegistered = false;\nfunction ensureBuiltIns(): void {\n  if (builtInsRegistered) return;\n  builtInsRegistered = true;\n  registerBuiltInShapePainters();\n}\n\n/** Register a shape painter. Returns a disposer that removes it. */\nexport function registerNodeShape<TData, TPose>(\n  painter: NodeShapeEntry<TData, TPose>,\n  opts: RegisterNodeShapeOptions = {},\n): () => void {\n  ensureBuiltIns();\n  const list = opts.priority === 'high' ? PAINTERS.high : PAINTERS.normal;\n  list.push(painter as NodeShapeEntry);\n  // The painter set is exactly the ambient state `findNodeShape` reads, and a\n  // memo keyed on the node alone cannot see it change. See `nodeMemo`.\n  bumpNodeMemoGeneration();\n  return () => {\n    const i = list.indexOf(painter as NodeShapeEntry);\n    if (i >= 0) list.splice(i, 1);\n    bumpNodeMemoGeneration();\n  };\n}\n\n/**\n * Slot names for what picking asks per node per pointer move: which painter matches, and that\n * painter's silhouette path. Both go through {@link nodeMemo}, so they invalidate on `data`\n * (and, for the silhouette, `pose`) reference changes and on a painter registration.\n *\n * Separate slots rather than one entry: they mostly invalidate together, but not always, and a\n * shared entry would force the stricter key on both.\n */\nconst PAINTER_SLOT = 'shape:painter';\nconst PAINTER_SLOT_NONRECT = 'shape:painter:nonrect';\nconst PAINTER_SLOT_DERIVED = 'shape:painter:derived';\nconst PAINTER_SLOT_DERIVED_NONRECT = 'shape:painter:derived:nonrect';\nconst SILHOUETTE_SLOT = 'shape:silhouette';\nconst TEXT_SILHOUETTE_SLOT = 'shape:silhouette:text';\n\n/** The painter that will render `node` — first match in priority order — or undefined if\n *  none accepts it. */\nexport function findNodeShape<TData, TPose>(\n  node: Node<TData, string, TPose>,\n): NodeShapeEntry<TData, TPose> | undefined {\n  // Built-in painters also gate on pose shape and on whether the node derives\n  // its path, neither of which shows in `data`, so the key carries both.\n  const rect = paintsPose(node.pose);\n  const slot = derivesPath(node)\n    ? (rect ? PAINTER_SLOT_DERIVED : PAINTER_SLOT_DERIVED_NONRECT)\n    : (rect ? PAINTER_SLOT : PAINTER_SLOT_NONRECT);\n  return nodeMemo(node as { data?: unknown }, slot, undefined, () =>\n    matchNodeShape(node),\n  );\n}\n\nfunction matchNodeShape<TData, TPose>(\n  node: Node<TData, string, TPose>,\n): NodeShapeEntry<TData, TPose> | undefined {\n  ensureBuiltIns();\n  for (const p of PAINTERS.high) {\n    if (p.matches(node as Node<unknown, string, unknown>)) {\n      return p as NodeShapeEntry<TData, TPose>;\n    }\n  }\n  for (const p of PAINTERS.normal) {\n    if (p.matches(node as Node<unknown, string, unknown>)) {\n      return p as NodeShapeEntry<TData, TPose>;\n    }\n  }\n  return undefined;\n}\n\n/** The silhouette path of `node`, in **world** coords, or null if no painter matches or the\n *  matching painter has none.\n *\n *  Painters return their silhouette in the pose's local (unrotated) frame;\n *  this bakes the pose's frame (`poseFrameOf`: its rotation and `transform`)\n *  on top, so clips/area-select of a turned or skewed node use the boundary\n *  the renderer draws. */\nexport function findShapeSilhouette<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeSilhouetteCtx,\n): Path | null {\n  const build = (): Path | null => {\n    const sil = findNodeShape(node)?.silhouette?.(node, pose, ctx) ?? null;\n    return sil && pathThroughPoseFrame(sil, pose);\n  };\n  // `SILHOUETTE_SLOT`'s key is (node, pose, data) and cannot see\n  // `ctx.derivedPath` — the same reason `kit:derived` skips `PAINT_SLOT`.\n  // Memoizing here would serve one caller's silhouette to a caller that\n  // passed a different path. Only an actual path skips it: a scene-backed\n  // source answers `null` for every ordinary node, and treating that as a\n  // reason to bypass would retire the memo for the whole scene.\n  if (ctx?.derivedPath != null) return build();\n  // Line boxes follow font metrics, and a face landing changes those with no\n  // change to the node, so the text entry is checked against the glyph epoch.\n  if (findNodeShape(node) === (TEXT_PAINTER as NodeShapeEntry<unknown, unknown>)) {\n    const epoch = glyphGeneration();\n    const held = nodeMemo(node as { data?: unknown }, TEXT_SILHOUETTE_SLOT, pose,\n      (): { epoch: number; path: Path | null } => ({ epoch, path: build() }));\n    if (held.epoch !== epoch) {\n      held.epoch = epoch;\n      held.path = build();\n    }\n    return held.path;\n  }\n  return nodeMemo(node as { data?: unknown }, SILHOUETTE_SLOT, pose, build);\n}\n\n/** Find the painter for `node` and ask how it inks its silhouette. Returns\n *  the painter's declared {@link NodeInk}, or `null` when no painter matches\n *  or it declares none — callers substitute {@link DEFAULT_INK}. */\nexport function findShapeInk<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): NodeInk | null {\n  return findNodeShape(node)?.ink?.(node, pose, ctx) ?? null;\n}\n\n/** Find the painter for `node` and ask for the box its paint fits in. `null`\n *  when no painter matches, or the one that does cannot say — see\n *  {@link NodeShapeEntry.bounds}. */\nexport function findShapeBounds<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): Bounds | null {\n  return findNodeShape(node)?.bounds?.(node, pose, ctx) ?? null;\n}\n\n/** Options for {@link shapeCoversPoint}. */\nexport interface ShapeCoversPointOptions {\n  /** Extra grab distance around the outline: **world** units as a number,\n   *  or screen pixels under a view scale (`{ px, scale }`), which is measured\n   *  on screen and so stays exact under non-uniform zoom. Defaults to `0`,\n   *  where a hairline is too thin a target to hit. */\n  tolerance?: PickSlop;\n  /** View scale, passed to the painter's `ink`, and what a screen reach is\n   *  read at under a world `tolerance`. Defaults to 1. */\n  scale?: number;\n  /** The node's derived path — see {@link NodeSilhouetteCtx.derivedPath}.\n   *  Without it a derived node reports no silhouette and this answers `true`\n   *  everywhere, which degrades picking to the caller's AABB: for an edge,\n   *  a zero-sized pose. */\n  derivedPath?: Path | null;\n  /** See {@link NodeInkCtx.inherited}. Without it an `'inherit'` field is\n   *  read as none. */\n  inherited?: NodeInkCtx['inherited'];\n}\n\n/**\n * Does the shape `node` actually paints cover the world point? Asks the painter's silhouette,\n * the same boundary used for clipping and area-select, rather than the pose rect.\n *\n * The ink counts too: a shape whose interior isn't filled is grabbable along its outline and\n * not through its empty middle. The outline's grab width is the stroke's half-width plus\n * `tolerance`.\n *\n * A painter with no `silhouette`, or one that returns `null` for this node, reports `true` —\n * \"no opinion\" — so callers should keep their own AABB test as a pre-filter.\n */\nexport function shapeCoversPoint<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  x: number,\n  y: number,\n  opts: ShapeCoversPointOptions = {},\n): boolean {\n  // A group paints nothing, so its interior is its box, which the caller's pre-filter tested.\n  if (node.kind === 'group') return true;\n  const sil = findShapeSilhouette(node, pose, { derivedPath: opts.derivedPath });\n  if (sil === null) return true;\n  const ink = findShapeInk(node, pose, { scale: opts.scale, inherited: opts.inherited }) ?? DEFAULT_INK;\n  const inside = pathContainsPoint(sil, x, y);\n  if (ink.filled && inside) return true;\n  // The stroke reaches a different distance on each side, so which side the point is on\n  // picks the reach. `tolerance` also makes a filled shape grabbable a few pixels outside\n  // its edge.\n  const slop = widenSlop(opts.tolerance, (inside ? ink.insetPx : ink.outsetPx) ?? 0, opts.scale);\n  const { extra, opts: hit } = slopForStrokeHit(slop);\n  const reach = (inside ? ink.inset : ink.outset) + extra;\n  return (reach > 0 || hasSlop(slop)) && strokeHitTest(sil, x, y, reach, hit);\n}\n\n/** The current painters in evaluation order — `'high'` tier first, then `'normal'`. */\nexport function getNodeShapes(): readonly NodeShapeEntry[] {\n  ensureBuiltIns();\n  return [...PAINTERS.high, ...PAINTERS.normal];\n}\n\n/** Test-only: clear the registry and re-register the built-ins. */\nexport function _resetShapePaintersForTests(): void {\n  PAINTERS.high.length = 0;\n  PAINTERS.normal.length = 0;\n  builtInsRegistered = false;\n  ensureBuiltIns();\n  // `registerNodeShape` already bumps, but the clearing above happens without one.\n  bumpNodeMemoGeneration();\n}\n\nfunction registerBuiltInShapePainters(): void {\n  registerNodeShape(TEXT_PAINTER);\n  registerNodeShape(MEASURE_PAINTER);\n  // Ahead of path/shape/image: a derived node whose `data` also carries a\n  // `path`, `shape` or `image` means the derived path, and those three match\n  // on the presence of the field alone.\n  registerNodeShape(DERIVED_PAINTER);\n  registerNodeShape(PATH_PAINTER);\n  registerNodeShape(SHAPE_PAINTER);\n  registerNodeShape(IMAGE_PAINTER);\n  registerNodeShape(RECT_FALLBACK_PAINTER);\n}\n"],"mappings":"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"}
+{"version":3,"file":"NodeShape.js","names":[],"sources":["../../src/canvas/NodeShape.ts"],"sourcesContent":["/**\n * NodeShape — the **shape trait's** registry: the per-kind `paint` + `silhouette` used by\n * `defaultDrawOne`, clipping, non-rect hit-testing, and lasso/area-select. Teaching the kit\n * about a new kind of shape goes through this registry rather than by overriding `drawOne`.\n *\n * The first entry whose `matches` predicate returns true paints the node: `'high'` entries\n * first, then the built-ins, then `'normal'` ones, in registration order within a tier. Every\n * built-in but `kit:derived` additionally requires a rect-shaped pose — a scene whose poses are\n * some other shape matches none of them, and paints through a consumer painter or not at all.\n */\nimport { glyphGeneration } from '@weasel-js/font';\nimport {\n  pathContainsPoint,\n  strokeHitTest,\n  type Path\n} from '@weasel-js/geom';\nimport { pathThroughPoseFrame } from '@weasel-js/geom';\nimport { bumpNodeMemoGeneration, nodeMemo } from 'core/scene/nodeMemo';\nimport { setDepOutlineReader } from 'core/scene/booleanOfChildren';\nimport type { Node } from 'core/scene/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport { hasSlop, slopForStrokeHit, widenSlop, type PickSlop } from 'core/viewport/screenSlop';\nimport { DERIVED_PAINTER } from './nodeShapes/derivedPainter';\nimport { IMAGE_PAINTER } from './nodeShapes/imagePainter';\nimport { MEASURE_PAINTER } from './nodeShapes/measurePainter';\nimport { derivesPath } from './nodeShapes/memo';\nimport { PATH_PAINTER } from './nodeShapes/pathPainter';\nimport { paintsPose } from './nodeShapes/poseBox';\nimport { RECT_FALLBACK_PAINTER } from './nodeShapes/rectFallbackPainter';\nimport { SHAPE_PAINTER } from './nodeShapes/shapePainter';\nimport { TEXT_PAINTER } from './nodeShapes/textPainter';\nimport type { NodeShapeEntry, NodeInk, NodeSilhouetteCtx, NodeInkCtx } from './nodeShapeTypes';\nexport type { NodePaintCtx, SceneViewDrawOne, NodeShapeEntry, NodeInk, NodeSilhouetteCtx, NodeInkCtx } from './nodeShapeTypes';\nexport type { InheritedPaint } from 'core/scene/inheritedPaint';\n\n/** What a painter that declares no `ink` is assumed to do. */\nexport const DEFAULT_INK: Readonly<NodeInk> = Object.freeze({ filled: true, outset: 0, inset: 0 });\n\n/** Options for `registerNodeShape`. */\nexport interface RegisterNodeShapeOptions {\n  /** `'high'` puts the painter ahead of all normally-registered ones (so\n   *  it can win over a kit built-in). `'normal'` appends at the end. */\n  priority?: 'high' | 'normal';\n}\n\nconst PAINTERS: { high: NodeShapeEntry[]; normal: NodeShapeEntry[] } = {\n  high: [],\n  normal: [],\n};\n\n// The built-ins go in on first use, not at module load: a bundler may drop an\n// import kept only for its side effect, and the registry would come up empty.\nlet builtInsRegistered = false;\nfunction ensureBuiltIns(): void {\n  if (builtInsRegistered) return;\n  builtInsRegistered = true;\n  registerBuiltInShapePainters();\n}\n\n/** Register a shape painter. Returns a disposer that removes it. */\nexport function registerNodeShape<TData, TPose>(\n  painter: NodeShapeEntry<TData, TPose>,\n  opts: RegisterNodeShapeOptions = {},\n): () => void {\n  ensureBuiltIns();\n  const list = opts.priority === 'high' ? PAINTERS.high : PAINTERS.normal;\n  list.push(painter as NodeShapeEntry);\n  // The painter set is exactly the ambient state `findNodeShape` reads, and a\n  // memo keyed on the node alone cannot see it change. See `nodeMemo`.\n  bumpNodeMemoGeneration();\n  return () => {\n    const i = list.indexOf(painter as NodeShapeEntry);\n    if (i >= 0) list.splice(i, 1);\n    bumpNodeMemoGeneration();\n  };\n}\n\n/**\n * Slot names for what picking asks per node per pointer move: which painter matches, and that\n * painter's silhouette path. Both go through {@link nodeMemo}, so they invalidate on `data`\n * (and, for the silhouette, `pose`) reference changes and on a painter registration.\n *\n * Separate slots rather than one entry: they mostly invalidate together, but not always, and a\n * shared entry would force the stricter key on both.\n */\nconst PAINTER_SLOT = 'shape:painter';\nconst PAINTER_SLOT_NONRECT = 'shape:painter:nonrect';\nconst PAINTER_SLOT_DERIVED = 'shape:painter:derived';\nconst PAINTER_SLOT_DERIVED_NONRECT = 'shape:painter:derived:nonrect';\nconst SILHOUETTE_SLOT = 'shape:silhouette';\nconst TEXT_SILHOUETTE_SLOT = 'shape:silhouette:text';\n\n/** The painter that will render `node` — first match in priority order — or undefined if\n *  none accepts it. */\nexport function findNodeShape<TData, TPose>(\n  node: Node<TData, string, TPose>,\n): NodeShapeEntry<TData, TPose> | undefined {\n  // Built-in painters also gate on pose shape and on whether the node derives\n  // its path, neither of which shows in `data`, so the key carries both.\n  const rect = paintsPose(node.pose);\n  const slot = derivesPath(node)\n    ? (rect ? PAINTER_SLOT_DERIVED : PAINTER_SLOT_DERIVED_NONRECT)\n    : (rect ? PAINTER_SLOT : PAINTER_SLOT_NONRECT);\n  return nodeMemo(node as { data?: unknown }, slot, undefined, () =>\n    matchNodeShape(node),\n  );\n}\n\nfunction matchNodeShape<TData, TPose>(\n  node: Node<TData, string, TPose>,\n): NodeShapeEntry<TData, TPose> | undefined {\n  ensureBuiltIns();\n  for (const p of PAINTERS.high) {\n    if (p.matches(node as Node<unknown, string, unknown>)) {\n      return p as NodeShapeEntry<TData, TPose>;\n    }\n  }\n  for (const p of PAINTERS.normal) {\n    if (p.matches(node as Node<unknown, string, unknown>)) {\n      return p as NodeShapeEntry<TData, TPose>;\n    }\n  }\n  return undefined;\n}\n\n/** The silhouette path of `node`, in **world** coords, or null if no painter matches or the\n *  matching painter has none.\n *\n *  Painters return their silhouette in the pose's local (unrotated) frame;\n *  this bakes the pose's frame (`poseFrameOf`: its rotation and `transform`)\n *  on top, so clips/area-select of a turned or skewed node use the boundary\n *  the renderer draws. */\nexport function findShapeSilhouette<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeSilhouetteCtx,\n): Path | null {\n  const build = (): Path | null => {\n    const sil = findNodeShape(node)?.silhouette?.(node, pose, ctx) ?? null;\n    return sil && pathThroughPoseFrame(sil, pose);\n  };\n  // `SILHOUETTE_SLOT`'s key is (node, pose, data) and cannot see\n  // `ctx.derivedPath` — the same reason `kit:derived` skips `PAINT_SLOT`.\n  // Memoizing here would serve one caller's silhouette to a caller that\n  // passed a different path. Only an actual path skips it: a scene-backed\n  // source answers `null` for every ordinary node, and treating that as a\n  // reason to bypass would retire the memo for the whole scene.\n  if (ctx?.derivedPath != null) return build();\n  // Line boxes follow font metrics, and a face landing changes those with no\n  // change to the node, so the text entry is checked against the glyph epoch.\n  if (findNodeShape(node) === (TEXT_PAINTER as NodeShapeEntry<unknown, unknown>)) {\n    const epoch = glyphGeneration();\n    const held = nodeMemo(node as { data?: unknown }, TEXT_SILHOUETTE_SLOT, pose,\n      (): { epoch: number; path: Path | null } => ({ epoch, path: build() }));\n    if (held.epoch !== epoch) {\n      held.epoch = epoch;\n      held.path = build();\n    }\n    return held.path;\n  }\n  return nodeMemo(node as { data?: unknown }, SILHOUETTE_SLOT, pose, build);\n}\n\n// A boolean group's operands are its children's outlines.\nsetDepOutlineReader((dep) => findShapeSilhouette(dep.node, dep.pose, { derivedPath: dep.path }));\n\n/** Find the painter for `node` and ask how it inks its silhouette. Returns\n *  the painter's declared {@link NodeInk}, or `null` when no painter matches\n *  or it declares none — callers substitute {@link DEFAULT_INK}. */\nexport function findShapeInk<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): NodeInk | null {\n  return findNodeShape(node)?.ink?.(node, pose, ctx) ?? null;\n}\n\n/** Find the painter for `node` and ask for the box its paint fits in. `null`\n *  when no painter matches, or the one that does cannot say — see\n *  {@link NodeShapeEntry.bounds}. */\nexport function findShapeBounds<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): Bounds | null {\n  return findNodeShape(node)?.bounds?.(node, pose, ctx) ?? null;\n}\n\n/** Options for {@link shapeCoversPoint}. */\nexport interface ShapeCoversPointOptions {\n  /** Extra grab distance around the outline: **world** units as a number,\n   *  or screen pixels under a view scale (`{ px, scale }`), which is measured\n   *  on screen and so stays exact under non-uniform zoom. Defaults to `0`,\n   *  where a hairline is too thin a target to hit. */\n  tolerance?: PickSlop;\n  /** View scale, passed to the painter's `ink`, and what a screen reach is\n   *  read at under a world `tolerance`. Defaults to 1. */\n  scale?: number;\n  /** The node's derived path — see {@link NodeSilhouetteCtx.derivedPath}.\n   *  Without it a derived node reports no silhouette and this answers `true`\n   *  everywhere, which degrades picking to the caller's AABB: for an edge,\n   *  a zero-sized pose. */\n  derivedPath?: Path | null;\n  /** See {@link NodeInkCtx.inherited}. Without it an `'inherit'` field is\n   *  read as none. */\n  inherited?: NodeInkCtx['inherited'];\n}\n\n/**\n * Does the shape `node` actually paints cover the world point? Asks the painter's silhouette,\n * the same boundary used for clipping and area-select, rather than the pose rect.\n *\n * The ink counts too: a shape whose interior isn't filled is grabbable along its outline and\n * not through its empty middle. The outline's grab width is the stroke's half-width plus\n * `tolerance`.\n *\n * A painter with no `silhouette`, or one that returns `null` for this node, reports `true` —\n * \"no opinion\" — so callers should keep their own AABB test as a pre-filter.\n */\nexport function shapeCoversPoint<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  x: number,\n  y: number,\n  opts: ShapeCoversPointOptions = {},\n): boolean {\n  // A group paints nothing, so its interior is its box, which the caller's pre-filter tested.\n  if (node.kind === 'group') return true;\n  const sil = findShapeSilhouette(node, pose, { derivedPath: opts.derivedPath });\n  if (sil === null) return true;\n  const ink = findShapeInk(node, pose, { scale: opts.scale, inherited: opts.inherited }) ?? DEFAULT_INK;\n  const inside = pathContainsPoint(sil, x, y);\n  if (ink.filled && inside) return true;\n  // The stroke reaches a different distance on each side, so which side the point is on\n  // picks the reach. `tolerance` also makes a filled shape grabbable a few pixels outside\n  // its edge.\n  const slop = widenSlop(opts.tolerance, (inside ? ink.insetPx : ink.outsetPx) ?? 0, opts.scale);\n  const { extra, opts: hit } = slopForStrokeHit(slop);\n  const reach = (inside ? ink.inset : ink.outset) + extra;\n  return (reach > 0 || hasSlop(slop)) && strokeHitTest(sil, x, y, reach, hit);\n}\n\n/** The current painters in evaluation order — `'high'` tier first, then `'normal'`. */\nexport function getNodeShapes(): readonly NodeShapeEntry[] {\n  ensureBuiltIns();\n  return [...PAINTERS.high, ...PAINTERS.normal];\n}\n\n/** Test-only: clear the registry and re-register the built-ins. */\nexport function _resetShapePaintersForTests(): void {\n  PAINTERS.high.length = 0;\n  PAINTERS.normal.length = 0;\n  builtInsRegistered = false;\n  ensureBuiltIns();\n  // `registerNodeShape` already bumps, but the clearing above happens without one.\n  bumpNodeMemoGeneration();\n}\n\nfunction registerBuiltInShapePainters(): void {\n  registerNodeShape(TEXT_PAINTER);\n  registerNodeShape(MEASURE_PAINTER);\n  // Ahead of path/shape/image: a derived node whose `data` also carries a\n  // `path`, `shape` or `image` means the derived path, and those three match\n  // on the presence of the field alone.\n  registerNodeShape(DERIVED_PAINTER);\n  registerNodeShape(PATH_PAINTER);\n  registerNodeShape(SHAPE_PAINTER);\n  registerNodeShape(IMAGE_PAINTER);\n  registerNodeShape(RECT_FALLBACK_PAINTER);\n}\n"],"mappings":"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"}

package/dist/canvas/PickHud.js

@@ -54,16 +54,20 @@ function PickHud({ canvasRef, anchorRef, viewRef, toWorld, pickEvery, pickBest,
 				});
 				return;
 			}
-			const [worldX, worldY] = toWorldRef.current?.(e.clientX, e.clientY) ?? clientToWorld(e.clientX, e.clientY, rect, view);
+			const [x, y] = toWorldRef.current?.(e.clientX, e.clientY) ?? clientToWorld(e.clientX, e.clientY, rect, view);
+			const world = {
+				x,
+				y
+			};
 			let ids = [];
 			try {
-				ids = pickEvery(worldX, worldY);
+				ids = pickEvery(world);
 			} catch {
 				ids = [];
 			}
 			let best = null;
 			if (pickBest) try {
-				best = pickBest(worldX, worldY);
+				best = pickBest(world);
 			} catch {
 				best = null;
 			}

package/dist/canvas/PickHud.js.map

@@ -1 +1 @@
-{"version":3,"file":"PickHud.js","names":["s"],"sources":["../../src/canvas/PickHud.tsx"],"sourcesContent":["/// <reference path=\"../css-modules.d.ts\" />\n/**\n * Dev HUD listing the ids returned by `pickEvery(world)` under the cursor.\n *\n * Anchors to the canvas's top-right corner like `CursorCoordsHud`, offset\n * downward so it sits just below that HUD. Updates on `document`\n * pointermove. Refreshes its position on scroll / resize so it tracks the\n * canvas through layout changes.\n */\nimport { useEffect, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { View } from 'core/viewport/view';\nimport { clientToWorld } from 'core/viewport/clientToWorld';\nimport { useHostAnchor } from './useHostAnchor';\nimport s from './hud.module.css';\n\n/** Props for `<PickHud>`. */\nexport interface PickHudProps {\n  canvasRef: React.RefObject<HTMLElement | null>;\n  /** Element the HUD pins its corner to. Defaults to the canvas's parent — the\n   *  wrapper a bare `<canvas>` sits in. A detached canvas passes its own input\n   *  box, whose parent is the shared surface every pane sits in. */\n  anchorRef?: React.RefObject<HTMLElement | null>;\n  viewRef: React.RefObject<View>;\n  /** Client coords to world. Defaults to the canvas's rect and `viewRef`. A\n   *  canvas whose routing converts some other way (a CSS transform, a 3D host)\n   *  passes that conversion, so the readout agrees with the picks. */\n  toWorld?: (clientX: number, clientY: number) => [number, number];\n  /** World-space hit-test. Same shape as `useSelectTool`'s `pickEvery`. */\n  pickEvery: (worldX: number, worldY: number) => readonly string[];\n  /** Optional single-best resolver — the id this point would select on a\n   *  bare click. When supplied, that id is rendered bold in the list. */\n  pickBest?: (worldX: number, worldY: number) => string | null;\n  /** Inset from the canvas's top-right corner. Default `{ top: 76, right: 8 }`\n   *  so the HUD clears `CursorCoordsHud` (~64 px tall in its 3-line form). */\n  offset?: { top?: number; right?: number };\n}\n\ninterface HudState {\n  ids: readonly string[];\n  best: string | null;\n  inCanvas: boolean;\n}\n\n/** Debug overlay listing every node under the pointer, with the one a click\n *  would actually select shown in bold. */\nexport function PickHud({ canvasRef, anchorRef, viewRef, toWorld, pickEvery, pickBest, offset }: PickHudProps) {\n  const toWorldRef = useLatest(toWorld);\n  const [state, setState] = useState<HudState>({\n    ids: [], best: null, inCanvas: false,\n  });\n  const { ref, style } = useHostAnchor(\n    () => anchorRef?.current ?? canvasRef.current?.parentElement ?? canvasRef.current,\n    {\n      align: { x: 'end', y: 'start' },\n      offset: { x: offset?.right ?? 8, y: offset?.top ?? 76 },\n    },\n  );\n\n  useEffect(() => {\n    const onMove = (e: PointerEvent) => {\n      const canvas = canvasRef.current;\n      const view = viewRef.current;\n      if (!canvas || !view) {\n        setState({ ids: [], best: null, inCanvas: false });\n        return;\n      }\n      const rect = canvas.getBoundingClientRect();\n      const inCanvas =\n        e.clientX >= rect.left && e.clientX <= rect.right &&\n        e.clientY >= rect.top  && e.clientY <= rect.bottom;\n      if (!inCanvas) {\n        setState({ ids: [], best: null, inCanvas: false });\n        return;\n      }\n      const [worldX, worldY] = toWorldRef.current?.(e.clientX, e.clientY)\n        ?? clientToWorld(e.clientX, e.clientY, rect, view);\n      let ids: readonly string[] = [];\n      try {\n        ids = pickEvery(worldX, worldY);\n      } catch {\n        ids = [];\n      }\n      let best: string | null = null;\n      if (pickBest) {\n        try { best = pickBest(worldX, worldY); } catch { best = null; }\n      }\n      setState({ ids, best, inCanvas: true });\n    };\n\n    document.addEventListener('pointermove', onMove);\n\n    return () => {\n      document.removeEventListener('pointermove', onMove);\n    };\n  }, [canvasRef, viewRef, pickEvery, pickBest, toWorldRef]);\n\n  if (!style) return null;\n\n  return (\n    <div ref={ref} className={`${s.hud} ${s.sized}`} style={style}>\n      <div className={`${s.header} ${s.muted}`}>pickEvery ({state.ids.length})</div>\n      {state.ids.length === 0 ? (\n        <div className={s.absent}>{state.inCanvas ? '—' : 'off-canvas'}</div>\n      ) : (\n        <ul className={s.list}>\n          {/* pickEvery returns back-to-front (topmost last). Display top-first. */}\n          {state.ids.slice().reverse().map((id) => (\n            <li\n              key={id}\n              className={id === state.best ? `${s.item} ${s.itemBest}` : s.item}\n            >\n              {id}\n            </li>\n          ))}\n        </ul>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA8CA,SAAgB,QAAQ,EAAE,WAAW,WAAW,SAAS,SAAS,WAAW,UAAU,UAAwB;CAC7G,MAAM,aAAa,UAAU,OAAO;CACpC,MAAM,CAAC,OAAO,YAAY,SAAmB;EAC3C,KAAK,CAAC;EAAG,MAAM;EAAM,UAAU;CACjC,CAAC;CACD,MAAM,EAAE,KAAK,UAAU,oBACf,WAAW,WAAW,UAAU,SAAS,iBAAiB,UAAU,SAC1E;EACE,OAAO;GAAE,GAAG;GAAO,GAAG;EAAQ;EAC9B,QAAQ;GAAE,GAAG,QAAQ,SAAS;GAAG,GAAG,QAAQ,OAAO;EAAG;CACxD,CACF;CAEA,gBAAgB;EACd,MAAM,UAAU,MAAoB;GAClC,MAAM,SAAS,UAAU;GACzB,MAAM,OAAO,QAAQ;GACrB,IAAI,CAAC,UAAU,CAAC,MAAM;IACpB,SAAS;KAAE,KAAK,CAAC;KAAG,MAAM;KAAM,UAAU;IAAM,CAAC;IACjD;GACF;GACA,MAAM,OAAO,OAAO,sBAAsB;GAI1C,IAAI,EAFF,EAAE,WAAW,KAAK,QAAQ,EAAE,WAAW,KAAK,SAC5C,EAAE,WAAW,KAAK,OAAQ,EAAE,WAAW,KAAK,SAC/B;IACb,SAAS;KAAE,KAAK,CAAC;KAAG,MAAM;KAAM,UAAU;IAAM,CAAC;IACjD;GACF;GACA,MAAM,CAAC,QAAQ,UAAU,WAAW,UAAU,EAAE,SAAS,EAAE,OAAO,KAC7D,cAAc,EAAE,SAAS,EAAE,SAAS,MAAM,IAAI;GACnD,IAAI,MAAyB,CAAC;GAC9B,IAAI;IACF,MAAM,UAAU,QAAQ,MAAM;GAChC,QAAQ;IACN,MAAM,CAAC;GACT;GACA,IAAI,OAAsB;GAC1B,IAAI,UACF,IAAI;IAAE,OAAO,SAAS,QAAQ,MAAM;GAAG,QAAQ;IAAE,OAAO;GAAM;GAEhE,SAAS;IAAE;IAAK;IAAM,UAAU;GAAK,CAAC;EACxC;EAEA,SAAS,iBAAiB,eAAe,MAAM;EAE/C,aAAa;GACX,SAAS,oBAAoB,eAAe,MAAM;EACpD;CACF,GAAG;EAAC;EAAW;EAAS;EAAW;EAAU;CAAU,CAAC;CAExD,IAAI,CAAC,OAAO,OAAO;CAEnB,OACE,qBAAC,OAAD;EAAU;EAAK,WAAW,GAAGA,mBAAE,IAAI,GAAGA,mBAAE;EAAgB;EAAxD,UAAA,CACE,qBAAC,OAAD;GAAK,WAAW,GAAGA,mBAAE,OAAO,GAAGA,mBAAE;GAAjC,UAAA;IAA0C;IAAY,MAAM,IAAI;IAAO;GAAM;EAC5E,CAAA,GAAA,MAAM,IAAI,WAAW,IACpB,oBAAC,OAAD;GAAK,WAAWA,mBAAE;GAAS,UAAA,MAAM,WAAW,MAAM;EAAkB,CAAA,IAEpE,oBAAC,MAAD;GAAI,WAAWA,mBAAE;GAEd,UAAA,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,OAChC,oBAAC,MAAD;IAEE,WAAW,OAAO,MAAM,OAAO,GAAGA,mBAAE,KAAK,GAAGA,mBAAE,aAAaA,mBAAE;IAE5D,UAAA;GACC,GAJG,EAIH,CACL;EACC,CAAA,CAEH;;AAET"}
+{"version":3,"file":"PickHud.js","names":["s"],"sources":["../../src/canvas/PickHud.tsx"],"sourcesContent":["/// <reference path=\"../css-modules.d.ts\" />\n/**\n * Dev HUD listing the ids returned by `pickEvery(world)` under the cursor.\n *\n * Anchors to the canvas's top-right corner like `CursorCoordsHud`, offset\n * downward so it sits just below that HUD. Updates on `document`\n * pointermove. Refreshes its position on scroll / resize so it tracks the\n * canvas through layout changes.\n */\nimport { useEffect, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { View } from 'core/viewport/view';\nimport type { WorldPoint } from '@weasel-js/routing';\nimport { clientToWorld } from 'core/viewport/clientToWorld';\nimport { useHostAnchor } from './useHostAnchor';\nimport s from './hud.module.css';\n\n/** Props for `<PickHud>`. */\nexport interface PickHudProps {\n  canvasRef: React.RefObject<HTMLElement | null>;\n  /** Element the HUD pins its corner to. Defaults to the canvas's parent — the\n   *  wrapper a bare `<canvas>` sits in. A detached canvas passes its own input\n   *  box, whose parent is the shared surface every pane sits in. */\n  anchorRef?: React.RefObject<HTMLElement | null>;\n  viewRef: React.RefObject<View>;\n  /** Client coords to world. Defaults to the canvas's rect and `viewRef`. A\n   *  canvas whose routing converts some other way (a CSS transform, a 3D host)\n   *  passes that conversion, so the readout agrees with the picks. */\n  toWorld?: (clientX: number, clientY: number) => [number, number];\n  /** World-space hit-test. Same shape as `useSelectTool`'s `pickEvery`. */\n  pickEvery: (world: WorldPoint) => readonly string[];\n  /** Optional single-best resolver — the id this point would select on a\n   *  bare click. When supplied, that id is rendered bold in the list. */\n  pickBest?: (world: WorldPoint) => string | null;\n  /** Inset from the canvas's top-right corner. Default `{ top: 76, right: 8 }`\n   *  so the HUD clears `CursorCoordsHud` (~64 px tall in its 3-line form). */\n  offset?: { top?: number; right?: number };\n}\n\ninterface HudState {\n  ids: readonly string[];\n  best: string | null;\n  inCanvas: boolean;\n}\n\n/** Debug overlay listing every node under the pointer, with the one a click\n *  would actually select shown in bold. */\nexport function PickHud({ canvasRef, anchorRef, viewRef, toWorld, pickEvery, pickBest, offset }: PickHudProps) {\n  const toWorldRef = useLatest(toWorld);\n  const [state, setState] = useState<HudState>({\n    ids: [], best: null, inCanvas: false,\n  });\n  const { ref, style } = useHostAnchor(\n    () => anchorRef?.current ?? canvasRef.current?.parentElement ?? canvasRef.current,\n    {\n      align: { x: 'end', y: 'start' },\n      offset: { x: offset?.right ?? 8, y: offset?.top ?? 76 },\n    },\n  );\n\n  useEffect(() => {\n    const onMove = (e: PointerEvent) => {\n      const canvas = canvasRef.current;\n      const view = viewRef.current;\n      if (!canvas || !view) {\n        setState({ ids: [], best: null, inCanvas: false });\n        return;\n      }\n      const rect = canvas.getBoundingClientRect();\n      const inCanvas =\n        e.clientX >= rect.left && e.clientX <= rect.right &&\n        e.clientY >= rect.top  && e.clientY <= rect.bottom;\n      if (!inCanvas) {\n        setState({ ids: [], best: null, inCanvas: false });\n        return;\n      }\n      const [x, y] = toWorldRef.current?.(e.clientX, e.clientY)\n        ?? clientToWorld(e.clientX, e.clientY, rect, view);\n      const world = { x, y };\n      let ids: readonly string[] = [];\n      try {\n        ids = pickEvery(world);\n      } catch {\n        ids = [];\n      }\n      let best: string | null = null;\n      if (pickBest) {\n        try { best = pickBest(world); } catch { best = null; }\n      }\n      setState({ ids, best, inCanvas: true });\n    };\n\n    document.addEventListener('pointermove', onMove);\n\n    return () => {\n      document.removeEventListener('pointermove', onMove);\n    };\n  }, [canvasRef, viewRef, pickEvery, pickBest, toWorldRef]);\n\n  if (!style) return null;\n\n  return (\n    <div ref={ref} className={`${s.hud} ${s.sized}`} style={style}>\n      <div className={`${s.header} ${s.muted}`}>pickEvery ({state.ids.length})</div>\n      {state.ids.length === 0 ? (\n        <div className={s.absent}>{state.inCanvas ? '—' : 'off-canvas'}</div>\n      ) : (\n        <ul className={s.list}>\n          {/* pickEvery returns back-to-front (topmost last). Display top-first. */}\n          {state.ids.slice().reverse().map((id) => (\n            <li\n              key={id}\n              className={id === state.best ? `${s.item} ${s.itemBest}` : s.item}\n            >\n              {id}\n            </li>\n          ))}\n        </ul>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA+CA,SAAgB,QAAQ,EAAE,WAAW,WAAW,SAAS,SAAS,WAAW,UAAU,UAAwB;CAC7G,MAAM,aAAa,UAAU,OAAO;CACpC,MAAM,CAAC,OAAO,YAAY,SAAmB;EAC3C,KAAK,CAAC;EAAG,MAAM;EAAM,UAAU;CACjC,CAAC;CACD,MAAM,EAAE,KAAK,UAAU,oBACf,WAAW,WAAW,UAAU,SAAS,iBAAiB,UAAU,SAC1E;EACE,OAAO;GAAE,GAAG;GAAO,GAAG;EAAQ;EAC9B,QAAQ;GAAE,GAAG,QAAQ,SAAS;GAAG,GAAG,QAAQ,OAAO;EAAG;CACxD,CACF;CAEA,gBAAgB;EACd,MAAM,UAAU,MAAoB;GAClC,MAAM,SAAS,UAAU;GACzB,MAAM,OAAO,QAAQ;GACrB,IAAI,CAAC,UAAU,CAAC,MAAM;IACpB,SAAS;KAAE,KAAK,CAAC;KAAG,MAAM;KAAM,UAAU;IAAM,CAAC;IACjD;GACF;GACA,MAAM,OAAO,OAAO,sBAAsB;GAI1C,IAAI,EAFF,EAAE,WAAW,KAAK,QAAQ,EAAE,WAAW,KAAK,SAC5C,EAAE,WAAW,KAAK,OAAQ,EAAE,WAAW,KAAK,SAC/B;IACb,SAAS;KAAE,KAAK,CAAC;KAAG,MAAM;KAAM,UAAU;IAAM,CAAC;IACjD;GACF;GACA,MAAM,CAAC,GAAG,KAAK,WAAW,UAAU,EAAE,SAAS,EAAE,OAAO,KACnD,cAAc,EAAE,SAAS,EAAE,SAAS,MAAM,IAAI;GACnD,MAAM,QAAQ;IAAE;IAAG;GAAE;GACrB,IAAI,MAAyB,CAAC;GAC9B,IAAI;IACF,MAAM,UAAU,KAAK;GACvB,QAAQ;IACN,MAAM,CAAC;GACT;GACA,IAAI,OAAsB;GAC1B,IAAI,UACF,IAAI;IAAE,OAAO,SAAS,KAAK;GAAG,QAAQ;IAAE,OAAO;GAAM;GAEvD,SAAS;IAAE;IAAK;IAAM,UAAU;GAAK,CAAC;EACxC;EAEA,SAAS,iBAAiB,eAAe,MAAM;EAE/C,aAAa;GACX,SAAS,oBAAoB,eAAe,MAAM;EACpD;CACF,GAAG;EAAC;EAAW;EAAS;EAAW;EAAU;CAAU,CAAC;CAExD,IAAI,CAAC,OAAO,OAAO;CAEnB,OACE,qBAAC,OAAD;EAAU;EAAK,WAAW,GAAGA,mBAAE,IAAI,GAAGA,mBAAE;EAAgB;EAAxD,UAAA,CACE,qBAAC,OAAD;GAAK,WAAW,GAAGA,mBAAE,OAAO,GAAGA,mBAAE;GAAjC,UAAA;IAA0C;IAAY,MAAM,IAAI;IAAO;GAAM;EAC5E,CAAA,GAAA,MAAM,IAAI,WAAW,IACpB,oBAAC,OAAD;GAAK,WAAWA,mBAAE;GAAS,UAAA,MAAM,WAAW,MAAM;EAAkB,CAAA,IAEpE,oBAAC,MAAD;GAAI,WAAWA,mBAAE;GAEd,UAAA,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,OAChC,oBAAC,MAAD;IAEE,WAAW,OAAO,MAAM,OAAO,GAAGA,mBAAE,KAAK,GAAGA,mBAAE,aAAaA,mBAAE;IAE5D,UAAA;GACC,GAJG,EAIH,CACL;EACC,CAAA,CAEH;;AAET"}