@weasel-js/core 1.13.0-rc.0 → 1.14.0

package/dist/canvas/SceneCanvas/useSceneStandardActions.js

@@ -35,7 +35,7 @@ import { useActionsRegistry, useDepSource } from "@weasel-js/routing/react";
 * parent's effects run after its children's, so a child's override would lose.
 */
 function useSceneStandardActions(inputs) {
-	const { props, viewOn, selection, enteredGroup, scene, adapter, standardActions, currentViewRef, onViewChange, poseDescriptor, dispatcher, pickEvery, layerIsPainted, alphaOf, reachable, viewAnimation, editAnchorsExternalState, snap, canvasRef, canvasApiRef, ingestionClipboard } = inputs;
+	const { props, viewOn, selection, enteredGroup, scene, adapter, standardActions, currentViewRef, onViewChange, poseDescriptor, dispatcher, pickEvery, layerIsPainted, alphaOf, reachable, viewAnimation, editAnchorsExternalState, snap, canvasRef, canvasApiRef, ingestionClipboard, ingestionHandlers } = inputs;
 	const { tune, viewport, ingestion } = props;
 	const boundsIncludeStroke = props.geometry?.boundsIncludeStroke ?? true;
 	const reflowTransition = props.reflowTransition;
@@ -93,7 +93,7 @@ function useSceneStandardActions(inputs) {
 	useDebugDepSource(canvasApiRef);
 	usePreviewPathsDepSource(canvasApiRef);
 	useDepChangeNotices(scene, selection.current, editAnchorsExternalState);
-	useIngestionDepSource(canvasRef, () => currentViewRef.current, ingestion?.resolveSrc, ingestion?.svg, ingestionClipboard);
+	useIngestionDepSource(canvasRef, () => currentViewRef.current, ingestion?.resolveSrc, ingestion?.svg, ingestionClipboard, ingestionHandlers);
 	useLassoSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);
 	useTextEditDepSource(scene);
 	useEditAnchorsDepSource(scene, selection, adapter, editAnchorsExternalState, tune);

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

@@ -1 +1 @@
-{"version":3,"file":"useSceneStandardActions.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSceneStandardActions.ts"],"sourcesContent":["import type { Action } from '@weasel-js/routing';\nimport type { Dispatcher } from '@weasel-js/routing';\nimport { useActionsRegistry, useDepSource } from '@weasel-js/routing/react';\nimport type { Scene } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport { useDecayLoop } from 'core/viewport/useDecayLoop';\nimport type { ViewAnimationApi } from 'core/viewport/useViewAnimation';\nimport type { View } from 'core/viewport/view';\nimport type { ClipboardIngestCtx } from 'interactions/actions/depSchema';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useActionSet, useStandardDeps } from 'interactions/actions/useActionSet';\nimport { drawnBoxes } from 'interactions/actions/drawnBoxes';\nimport type React from 'react';\nimport { useEffect, useMemo } from 'react';\nimport type { ReflowTransition } from '../../layout/types';\nimport type { SnapOutcomeStore } from 'features/snap/outcomeStore';\nimport type { SnapSourceRegistry } from 'features/snap/registry';\nimport type { SnapSource } from 'features/snap/types';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport {\n  useAreaSelectDepSource,\n  useDebugDepSource,\n  usePreviewPathsDepSource,\n  useDepChangeNotices,\n  useDispatcherDepSource,\n  useEditAnchorsDepSource,\n  useEnteredGroupApiSource,\n  useIngestionDepSource,\n  useInsertDepSource,\n  useLassoSelectDepSource,\n  useLayoutDepSource,\n  useNodeAtPointDepSource,\n  usePoseDescriptorDepSource,\n  usePathLeafDepSources,\n  useSnapDepSource,\n  useSurfaceDepSources,\n  useTextEditDepSource,\n  useViewDepSource,\n} from '../deps';\nimport type { EnteredGroupApi } from '../deps/enteredGroup';\nimport type { BridgeAdapter, SceneCanvasProps } from './props';\nimport { useActionsPropResolver } from './useActionsPropResolver';\nimport { useActionTunings, useBindingOverrides } from './useActionTunings';\nimport { useViewportActions, viewportZoomOption } from './useViewportActions';\n\n/** The `<SceneCanvas>` props the standard actions and their deps read. */\nexport type StandardActionsProps = Pick<\n  SceneCanvasProps<unknown, string, unknown>,\n  | 'actions' | 'tune' | 'bindingOverrides' | 'geometry' | 'viewport' | 'layoutDropTarget'\n  | 'reflowTransition' | 'insertNodeFactories' | 'insertPaint' | 'ingestion' | 'snap'\n>;\n\n/** What `<SceneCanvas>` hands {@link useSceneStandardActions}. */\nexport interface SceneStandardActionsInputs {\n  props: StandardActionsProps;\n  /** Whether the `view` preset is on; without it the viewport actions are off. */\n  viewOn: boolean;\n  selection: SelectionApi;\n  /** The group a press resolves inside of, shared with the picking that names double-clicks. */\n  enteredGroup: EnteredGroupApi;\n  scene: Scene<unknown, string, unknown>;\n  adapter: BridgeAdapter;\n  /** The standard actions this canvas registers: its presets' and the ones\n   *  its tools bind, in registration order. */\n  standardActions: readonly Action[];\n  currentViewRef: React.RefObject<View>;\n  onViewChange: (v: View) => void;\n  /** Wires the `poseDescriptor` dep every built-in pose-touching action reads. */\n  poseDescriptor: PoseDescriptor<unknown>;\n  /** Forwarded so `cancelGestureAction` and other actions that need to\n   *  abort in-flight handles can read the dispatcher's control surface. */\n  dispatcher: Dispatcher;\n  /** World-space picker forwarded so the `nodeAtPoint` dep source can\n   *  reuse the same hit-test plumbing the tool dispatcher uses. */\n  pickEvery: (worldX: number, worldY: number) => string[];\n  /** This canvas's own view gate for scene layers, published on the `view`\n   *  dep and read by the selecting actions. Absent when it hides nothing. */\n  layerIsPainted?: (layerId: string) => boolean;\n  /** The composed paint alpha, when the consumer fades anything, so a region\n   *  select passes over what is painted at zero. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node takes hits: what a region select may take, as a press may. */\n  reachable?: (id: string) => boolean;\n  /** The canvas's camera runner, published on the `view` dep so\n   *  `viewport.zoom`'s discrete branches can animate. */\n  viewAnimation: ViewAnimationApi;\n  /** Lifted edit-mode state so the `pathEditingOverlay` chrome (rendered\n   *  outside this subtree) can read the same `editingId` the dep does. */\n  editAnchorsExternalState: import('../deps/editAnchors').EditAnchorsStateSource;\n  /** The snap sources a session asks: the prop's and the presets', then the registry's. */\n  snap: { sources: readonly SnapSource[]; registry: SnapSourceRegistry | null; store: SnapOutcomeStore };\n  /** The canvas element ref, so `useIngestionDepSource` can compute the\n   *  visible world rect from the client rect + current view. */\n  canvasRef: React.RefObject<HTMLElement | null>;\n  /** The canvas handle, whose debug sink backs the `debug` dep. */\n  canvasApiRef: React.RefObject<CanvasExtensionApi | null>;\n  /** Clipboard-paste ctx (this canvas's adapter + the consumer's reviver)\n   *  for the kit weasel-JSON handler, from `useCanvasIngestion`; absent\n   *  when disabled. */\n  ingestionClipboard?: ClipboardIngestCtx;\n}\n\n/**\n * Registers this canvas's standard actions, and the deps they read, into its\n * input scope, then applies the `actions` prop and `tune` over them.\n *\n * Called from a component ahead of `<SceneCanvas>`'s children, never from the\n * canvas's own body: registrations stack newest-live in effect order, and a\n * parent's effects run after its children's, so a child's override would lose.\n */\nexport function useSceneStandardActions(inputs: SceneStandardActionsInputs): void {\n  const {\n    props, viewOn, selection, enteredGroup, scene, adapter, standardActions, currentViewRef,\n    onViewChange, poseDescriptor, dispatcher, pickEvery, layerIsPainted, alphaOf, reachable, viewAnimation,\n    editAnchorsExternalState, snap, canvasRef, canvasApiRef, ingestionClipboard,\n  } = inputs;\n  const { tune, viewport, ingestion } = props;\n  const boundsIncludeStroke = props.geometry?.boundsIncludeStroke ?? true;\n  const reflowTransition = props.reflowTransition as ReflowTransition<unknown> | null | undefined;\n  const viewportZoom = useMemo(\n    () => viewportZoomOption(viewport?.zoom, viewport?.animatedZoom),\n    [viewport?.zoom, viewport?.animatedZoom],\n  );\n  const registry = useActionsRegistry();\n\n  // Wire the dispatcher into the registry so registry.begin() can delegate\n  // to dispatcher.beginUiOngoing() for UI-driven ongoing actions (color,\n  // opacity).\n  useEffect(() => {\n    if (!registry) return;\n    return registry.setDispatcher(dispatcher);\n  }, [registry, dispatcher]);\n\n  // Momentum for `viewport.dragPan`. The loop must be a hook (it owns a\n  // `useVisibleRaf`), so it is built here and republished on the view dep.\n  const decayLoop = useDecayLoop();\n\n  // Build the ViewApi (stable identity, refreshed closures) and hand it to\n  // useStandardDeps (which publishes the `view` dep along with selection,\n  // scene, history, activeTool). `hostSize` reads the live canvas\n  // element so keyboard zoom (Cmd+=/-) can anchor at the visible center.\n  const view = useViewDepSource(\n    currentViewRef,\n    onViewChange,\n    viewport?.recenter,\n    () => {\n      const el = canvasRef.current;\n      return el ? { width: el.clientWidth, height: el.clientHeight } : null;\n    },\n    viewAnimation,\n    decayLoop,\n    layerIsPainted,\n  );\n  useStandardDeps({ selection, scene, view, history: scene.history });\n  useActionSet(standardActions);\n  // A view overlays `view` with its own camera; this name it leaves alone.\n  useDepSource('rootView', () => view);\n  useSurfaceDepSources(canvasRef, currentViewRef);\n  useDepSource('actionParams', () => registry?.paramsOf);\n\n  // viewport.pan / viewport.zoom are SceneCanvas-coupled (need the `view` dep\n  // published just above), so they're registered here rather than in\n  // KIT_STANDARD_DESCRIPTORS. Both default ON; consumer opts out via\n  // `viewport={{ pan: false }}` / `viewport={{ zoom: false }}`.\n  useViewportActions({\n    pan: viewOn ? (viewport?.pan ?? true) : false,\n    zoom: viewOn ? viewportZoom : false,\n    pinchZoom: viewOn ? (viewport?.pinchZoom ?? true) : false,\n  });\n\n  // Per-dep wiring modules under `src/canvas/deps/`. See each file for the\n  // dep's contract and trade-offs.\n  useAreaSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);\n  useNodeAtPointDepSource(pickEvery);\n  useLayoutDepSource(scene, props.layoutDropTarget, reflowTransition);\n  useEnteredGroupApiSource(enteredGroup);\n  useInsertDepSource(scene, adapter, props.insertNodeFactories, props.insertPaint);\n  usePathLeafDepSources(scene, selection, adapter, poseDescriptor);\n  useSnapDepSource(\n    currentViewRef,\n    {\n      scene, boxes: () => drawnBoxes({ scene, poseDescriptor, view, boundsIncludeStroke }), sources: snap.sources,\n      ...(snap.registry ? { registry: snap.registry } : {}),\n      ...(props.snap?.reachPx !== undefined ? { reachPx: props.snap.reachPx } : {}),\n      ...(props.snap?.omit ? { omit: props.snap.omit } : {}),\n      ...(props.snap?.originProjection ? { originProjection: props.snap.originProjection } : {}),\n      poseDescriptor,\n      debug: () => canvasApiRef.current?.getDebug(),\n    },\n    snap.store,\n  );\n  useDebugDepSource(canvasApiRef);\n  usePreviewPathsDepSource(canvasApiRef);\n  useDepChangeNotices(scene, selection.current, editAnchorsExternalState);\n  useIngestionDepSource(canvasRef, () => currentViewRef.current, ingestion?.resolveSrc, ingestion?.svg, ingestionClipboard);\n  useLassoSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);\n  useTextEditDepSource(scene);\n  useEditAnchorsDepSource(scene, selection, adapter, editAnchorsExternalState, tune);\n  useDispatcherDepSource(dispatcher);\n  usePoseDescriptorDepSource(poseDescriptor);\n  useDepSource('boundsIncludeStroke', () => boundsIncludeStroke);\n\n  // Keyed on the set too: a re-registration of it would otherwise land over\n  // the overrides applied on top of it.\n  useActionsPropResolver(props.actions, standardActions.map((a) => a.id).join('|'));\n  useActionTunings(tune);\n  useBindingOverrides(props.bindingOverrides);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8GA,SAAgB,wBAAwB,QAA0C;CAChF,MAAM,EACJ,OAAO,QAAQ,WAAW,cAAc,OAAO,SAAS,iBAAiB,gBACzE,cAAc,gBAAgB,YAAY,WAAW,gBAAgB,SAAS,WAAW,eACzF,0BAA0B,MAAM,WAAW,cAAc,uBACvD;CACJ,MAAM,EAAE,MAAM,UAAU,cAAc;CACtC,MAAM,sBAAsB,MAAM,UAAU,uBAAuB;CACnE,MAAM,mBAAmB,MAAM;CAC/B,MAAM,eAAe,cACb,mBAAmB,UAAU,MAAM,UAAU,YAAY,GAC/D,CAAC,UAAU,MAAM,UAAU,YAAY,CACzC;CACA,MAAM,WAAW,mBAAmB;CAKpC,gBAAgB;EACd,IAAI,CAAC,UAAU;EACf,OAAO,SAAS,cAAc,UAAU;CAC1C,GAAG,CAAC,UAAU,UAAU,CAAC;CAIzB,MAAM,YAAY,aAAa;CAM/B,MAAM,OAAO,iBACX,gBACA,cACA,UAAU,gBACJ;EACJ,MAAM,KAAK,UAAU;EACrB,OAAO,KAAK;GAAE,OAAO,GAAG;GAAa,QAAQ,GAAG;EAAa,IAAI;CACnE,GACA,eACA,WACA,cACF;CACA,gBAAgB;EAAE;EAAW;EAAO;EAAM,SAAS,MAAM;CAAQ,CAAC;CAClE,aAAa,eAAe;CAE5B,aAAa,kBAAkB,IAAI;CACnC,qBAAqB,WAAW,cAAc;CAC9C,aAAa,sBAAsB,UAAU,QAAQ;CAMrD,mBAAmB;EACjB,KAAK,SAAU,UAAU,OAAO,OAAQ;EACxC,MAAM,SAAS,eAAe;EAC9B,WAAW,SAAU,UAAU,aAAa,OAAQ;CACtD,CAAC;CAID,uBAAuB,OAAO,WAAW,gBAAgB,SAAS,SAAS;CAC3E,wBAAwB,SAAS;CACjC,mBAAmB,OAAO,MAAM,kBAAkB,gBAAgB;CAClE,yBAAyB,YAAY;CACrC,mBAAmB,OAAO,SAAS,MAAM,qBAAqB,MAAM,WAAW;CAC/E,sBAAsB,OAAO,WAAW,SAAS,cAAc;CAC/D,iBACE,gBACA;EACE;EAAO,aAAa,WAAW;GAAE;GAAO;GAAgB;GAAM;EAAoB,CAAC;EAAG,SAAS,KAAK;EACpG,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACnD,GAAI,MAAM,MAAM,YAAY,SAAY,EAAE,SAAS,MAAM,KAAK,QAAQ,IAAI,CAAC;EAC3E,GAAI,MAAM,MAAM,OAAO,EAAE,MAAM,MAAM,KAAK,KAAK,IAAI,CAAC;EACpD,GAAI,MAAM,MAAM,mBAAmB,EAAE,kBAAkB,MAAM,KAAK,iBAAiB,IAAI,CAAC;EACxF;EACA,aAAa,aAAa,SAAS,SAAS;CAC9C,GACA,KAAK,KACP;CACA,kBAAkB,YAAY;CAC9B,yBAAyB,YAAY;CACrC,oBAAoB,OAAO,UAAU,SAAS,wBAAwB;CACtE,sBAAsB,iBAAiB,eAAe,SAAS,WAAW,YAAY,WAAW,KAAK,kBAAkB;CACxH,wBAAwB,OAAO,WAAW,gBAAgB,SAAS,SAAS;CAC5E,qBAAqB,KAAK;CAC1B,wBAAwB,OAAO,WAAW,SAAS,0BAA0B,IAAI;CACjF,uBAAuB,UAAU;CACjC,2BAA2B,cAAc;CACzC,aAAa,6BAA6B,mBAAmB;CAI7D,uBAAuB,MAAM,SAAS,gBAAgB,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;CAChF,iBAAiB,IAAI;CACrB,oBAAoB,MAAM,gBAAgB;AAC5C"}
+{"version":3,"file":"useSceneStandardActions.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSceneStandardActions.ts"],"sourcesContent":["import type { Action } from '@weasel-js/routing';\nimport type { Dispatcher, WorldPoint } from '@weasel-js/routing';\nimport { useActionsRegistry, useDepSource } from '@weasel-js/routing/react';\nimport type { Scene } from 'core/scene/types';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport { useDecayLoop } from 'core/viewport/useDecayLoop';\nimport type { ViewAnimationApi } from 'core/viewport/useViewAnimation';\nimport type { View } from 'core/viewport/view';\nimport type { ClipboardIngestCtx } from 'interactions/actions/depSchema';\nimport type { ContentHandlerEntry } from 'domains/ingestion/contentHandlers';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { useActionSet, useStandardDeps } from 'interactions/actions/useActionSet';\nimport { drawnBoxes } from 'interactions/actions/drawnBoxes';\nimport type React from 'react';\nimport { useEffect, useMemo } from 'react';\nimport type { ReflowTransition } from '../../layout/types';\nimport type { SnapOutcomeStore } from 'domains/snap/outcomeStore';\nimport type { SnapSourceRegistry } from 'domains/snap/registry';\nimport type { SnapSource } from 'domains/snap/types';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport {\n  useAreaSelectDepSource,\n  useDebugDepSource,\n  usePreviewPathsDepSource,\n  useDepChangeNotices,\n  useDispatcherDepSource,\n  useEditAnchorsDepSource,\n  useEnteredGroupApiSource,\n  useIngestionDepSource,\n  useInsertDepSource,\n  useLassoSelectDepSource,\n  useLayoutDepSource,\n  useNodeAtPointDepSource,\n  usePoseDescriptorDepSource,\n  usePathLeafDepSources,\n  useSnapDepSource,\n  useSurfaceDepSources,\n  useTextEditDepSource,\n  useViewDepSource,\n} from '../deps';\nimport type { EnteredGroupApi } from '../deps/enteredGroup';\nimport type { BridgeAdapter, SceneCanvasProps } from './props';\nimport { useActionsPropResolver } from './useActionsPropResolver';\nimport { useActionTunings, useBindingOverrides } from './useActionTunings';\nimport { useViewportActions, viewportZoomOption } from './useViewportActions';\n\n/** The `<SceneCanvas>` props the standard actions and their deps read. */\nexport type StandardActionsProps = Pick<\n  SceneCanvasProps<unknown, string, unknown>,\n  | 'actions' | 'tune' | 'bindingOverrides' | 'geometry' | 'viewport' | 'layoutDropTarget'\n  | 'reflowTransition' | 'insertNodeFactories' | 'insertPaint' | 'ingestion' | 'snap'\n>;\n\n/** What `<SceneCanvas>` hands {@link useSceneStandardActions}. */\nexport interface SceneStandardActionsInputs {\n  props: StandardActionsProps;\n  /** Whether the `view` preset is on; without it the viewport actions are off. */\n  viewOn: boolean;\n  selection: SelectionApi;\n  /** The group a press resolves inside of, shared with the picking that names double-clicks. */\n  enteredGroup: EnteredGroupApi;\n  scene: Scene<unknown, string, unknown>;\n  adapter: BridgeAdapter;\n  /** The standard actions this canvas registers: its presets' and the ones\n   *  its tools bind, in registration order. */\n  standardActions: readonly Action[];\n  currentViewRef: React.RefObject<View>;\n  onViewChange: (v: View) => void;\n  /** Wires the `poseDescriptor` dep every built-in pose-touching action reads. */\n  poseDescriptor: PoseDescriptor<unknown>;\n  /** Forwarded so `cancelGestureAction` and other actions that need to\n   *  abort in-flight handles can read the dispatcher's control surface. */\n  dispatcher: Dispatcher;\n  /** World-space picker forwarded so the `nodeAtPoint` dep source can\n   *  reuse the same hit-test plumbing the tool dispatcher uses. */\n  pickEvery: (world: WorldPoint) => string[];\n  /** This canvas's own view gate for scene layers, published on the `view`\n   *  dep and read by the selecting actions. Absent when it hides nothing. */\n  layerIsPainted?: (layerId: string) => boolean;\n  /** The composed paint alpha, when the consumer fades anything, so a region\n   *  select passes over what is painted at zero. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node takes hits: what a region select may take, as a press may. */\n  reachable?: (id: string) => boolean;\n  /** The canvas's camera runner, published on the `view` dep so\n   *  `viewport.zoom`'s discrete branches can animate. */\n  viewAnimation: ViewAnimationApi;\n  /** Lifted edit-mode state so the `pathEditingOverlay` chrome (rendered\n   *  outside this subtree) can read the same `editingId` the dep does. */\n  editAnchorsExternalState: import('../deps/editAnchors').EditAnchorsStateSource;\n  /** The snap sources a session asks: the prop's and the presets', then the registry's. */\n  snap: { sources: readonly SnapSource[]; registry: SnapSourceRegistry | null; store: SnapOutcomeStore };\n  /** The canvas element ref, so `useIngestionDepSource` can compute the\n   *  visible world rect from the client rect + current view. */\n  canvasRef: React.RefObject<HTMLElement | null>;\n  /** The canvas handle, whose debug sink backs the `debug` dep. */\n  canvasApiRef: React.RefObject<CanvasExtensionApi | null>;\n  /** Clipboard-paste ctx (this canvas's adapter + the consumer's reviver)\n   *  for the kit weasel-JSON handler, from `useCanvasIngestion`; absent\n   *  when disabled. */\n  ingestionClipboard?: ClipboardIngestCtx;\n  /** The canvas's own content handlers and the kit's it keeps, from `useCanvasIngestion`. */\n  ingestionHandlers?: readonly ContentHandlerEntry[];\n}\n\n/**\n * Registers this canvas's standard actions, and the deps they read, into its\n * input scope, then applies the `actions` prop and `tune` over them.\n *\n * Called from a component ahead of `<SceneCanvas>`'s children, never from the\n * canvas's own body: registrations stack newest-live in effect order, and a\n * parent's effects run after its children's, so a child's override would lose.\n */\nexport function useSceneStandardActions(inputs: SceneStandardActionsInputs): void {\n  const {\n    props, viewOn, selection, enteredGroup, scene, adapter, standardActions, currentViewRef,\n    onViewChange, poseDescriptor, dispatcher, pickEvery, layerIsPainted, alphaOf, reachable, viewAnimation,\n    editAnchorsExternalState, snap, canvasRef, canvasApiRef, ingestionClipboard,\n    ingestionHandlers,\n  } = inputs;\n  const { tune, viewport, ingestion } = props;\n  const boundsIncludeStroke = props.geometry?.boundsIncludeStroke ?? true;\n  const reflowTransition = props.reflowTransition as ReflowTransition<unknown> | null | undefined;\n  const viewportZoom = useMemo(\n    () => viewportZoomOption(viewport?.zoom, viewport?.animatedZoom),\n    [viewport?.zoom, viewport?.animatedZoom],\n  );\n  const registry = useActionsRegistry();\n\n  // Wire the dispatcher into the registry so registry.begin() can delegate\n  // to dispatcher.beginUiOngoing() for UI-driven ongoing actions (color,\n  // opacity).\n  useEffect(() => {\n    if (!registry) return;\n    return registry.setDispatcher(dispatcher);\n  }, [registry, dispatcher]);\n\n  // Momentum for `viewport.dragPan`. The loop must be a hook (it owns a\n  // `useVisibleRaf`), so it is built here and republished on the view dep.\n  const decayLoop = useDecayLoop();\n\n  // Build the ViewApi (stable identity, refreshed closures) and hand it to\n  // useStandardDeps (which publishes the `view` dep along with selection,\n  // scene, history, activeTool). `hostSize` reads the live canvas\n  // element so keyboard zoom (Cmd+=/-) can anchor at the visible center.\n  const view = useViewDepSource(\n    currentViewRef,\n    onViewChange,\n    viewport?.recenter,\n    () => {\n      const el = canvasRef.current;\n      return el ? { width: el.clientWidth, height: el.clientHeight } : null;\n    },\n    viewAnimation,\n    decayLoop,\n    layerIsPainted,\n  );\n  useStandardDeps({ selection, scene, view, history: scene.history });\n  useActionSet(standardActions);\n  // A view overlays `view` with its own camera; this name it leaves alone.\n  useDepSource('rootView', () => view);\n  useSurfaceDepSources(canvasRef, currentViewRef);\n  useDepSource('actionParams', () => registry?.paramsOf);\n\n  // viewport.pan / viewport.zoom are SceneCanvas-coupled (need the `view` dep\n  // published just above), so they're registered here rather than in\n  // KIT_STANDARD_DESCRIPTORS. Both default ON; consumer opts out via\n  // `viewport={{ pan: false }}` / `viewport={{ zoom: false }}`.\n  useViewportActions({\n    pan: viewOn ? (viewport?.pan ?? true) : false,\n    zoom: viewOn ? viewportZoom : false,\n    pinchZoom: viewOn ? (viewport?.pinchZoom ?? true) : false,\n  });\n\n  // Per-dep wiring modules under `src/canvas/deps/`. See each file for the\n  // dep's contract and trade-offs.\n  useAreaSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);\n  useNodeAtPointDepSource(pickEvery);\n  useLayoutDepSource(scene, props.layoutDropTarget, reflowTransition);\n  useEnteredGroupApiSource(enteredGroup);\n  useInsertDepSource(scene, adapter, props.insertNodeFactories, props.insertPaint);\n  usePathLeafDepSources(scene, selection, adapter, poseDescriptor);\n  useSnapDepSource(\n    currentViewRef,\n    {\n      scene, boxes: () => drawnBoxes({ scene, poseDescriptor, view, boundsIncludeStroke }), sources: snap.sources,\n      ...(snap.registry ? { registry: snap.registry } : {}),\n      ...(props.snap?.reachPx !== undefined ? { reachPx: props.snap.reachPx } : {}),\n      ...(props.snap?.omit ? { omit: props.snap.omit } : {}),\n      ...(props.snap?.originProjection ? { originProjection: props.snap.originProjection } : {}),\n      poseDescriptor,\n      debug: () => canvasApiRef.current?.getDebug(),\n    },\n    snap.store,\n  );\n  useDebugDepSource(canvasApiRef);\n  usePreviewPathsDepSource(canvasApiRef);\n  useDepChangeNotices(scene, selection.current, editAnchorsExternalState);\n  useIngestionDepSource(canvasRef, () => currentViewRef.current, ingestion?.resolveSrc, ingestion?.svg, ingestionClipboard, ingestionHandlers);\n  useLassoSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);\n  useTextEditDepSource(scene);\n  useEditAnchorsDepSource(scene, selection, adapter, editAnchorsExternalState, tune);\n  useDispatcherDepSource(dispatcher);\n  usePoseDescriptorDepSource(poseDescriptor);\n  useDepSource('boundsIncludeStroke', () => boundsIncludeStroke);\n\n  // Keyed on the set too: a re-registration of it would otherwise land over\n  // the overrides applied on top of it.\n  useActionsPropResolver(props.actions, standardActions.map((a) => a.id).join('|'));\n  useActionTunings(tune);\n  useBindingOverrides(props.bindingOverrides);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiHA,SAAgB,wBAAwB,QAA0C;CAChF,MAAM,EACJ,OAAO,QAAQ,WAAW,cAAc,OAAO,SAAS,iBAAiB,gBACzE,cAAc,gBAAgB,YAAY,WAAW,gBAAgB,SAAS,WAAW,eACzF,0BAA0B,MAAM,WAAW,cAAc,oBACzD,sBACE;CACJ,MAAM,EAAE,MAAM,UAAU,cAAc;CACtC,MAAM,sBAAsB,MAAM,UAAU,uBAAuB;CACnE,MAAM,mBAAmB,MAAM;CAC/B,MAAM,eAAe,cACb,mBAAmB,UAAU,MAAM,UAAU,YAAY,GAC/D,CAAC,UAAU,MAAM,UAAU,YAAY,CACzC;CACA,MAAM,WAAW,mBAAmB;CAKpC,gBAAgB;EACd,IAAI,CAAC,UAAU;EACf,OAAO,SAAS,cAAc,UAAU;CAC1C,GAAG,CAAC,UAAU,UAAU,CAAC;CAIzB,MAAM,YAAY,aAAa;CAM/B,MAAM,OAAO,iBACX,gBACA,cACA,UAAU,gBACJ;EACJ,MAAM,KAAK,UAAU;EACrB,OAAO,KAAK;GAAE,OAAO,GAAG;GAAa,QAAQ,GAAG;EAAa,IAAI;CACnE,GACA,eACA,WACA,cACF;CACA,gBAAgB;EAAE;EAAW;EAAO;EAAM,SAAS,MAAM;CAAQ,CAAC;CAClE,aAAa,eAAe;CAE5B,aAAa,kBAAkB,IAAI;CACnC,qBAAqB,WAAW,cAAc;CAC9C,aAAa,sBAAsB,UAAU,QAAQ;CAMrD,mBAAmB;EACjB,KAAK,SAAU,UAAU,OAAO,OAAQ;EACxC,MAAM,SAAS,eAAe;EAC9B,WAAW,SAAU,UAAU,aAAa,OAAQ;CACtD,CAAC;CAID,uBAAuB,OAAO,WAAW,gBAAgB,SAAS,SAAS;CAC3E,wBAAwB,SAAS;CACjC,mBAAmB,OAAO,MAAM,kBAAkB,gBAAgB;CAClE,yBAAyB,YAAY;CACrC,mBAAmB,OAAO,SAAS,MAAM,qBAAqB,MAAM,WAAW;CAC/E,sBAAsB,OAAO,WAAW,SAAS,cAAc;CAC/D,iBACE,gBACA;EACE;EAAO,aAAa,WAAW;GAAE;GAAO;GAAgB;GAAM;EAAoB,CAAC;EAAG,SAAS,KAAK;EACpG,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACnD,GAAI,MAAM,MAAM,YAAY,SAAY,EAAE,SAAS,MAAM,KAAK,QAAQ,IAAI,CAAC;EAC3E,GAAI,MAAM,MAAM,OAAO,EAAE,MAAM,MAAM,KAAK,KAAK,IAAI,CAAC;EACpD,GAAI,MAAM,MAAM,mBAAmB,EAAE,kBAAkB,MAAM,KAAK,iBAAiB,IAAI,CAAC;EACxF;EACA,aAAa,aAAa,SAAS,SAAS;CAC9C,GACA,KAAK,KACP;CACA,kBAAkB,YAAY;CAC9B,yBAAyB,YAAY;CACrC,oBAAoB,OAAO,UAAU,SAAS,wBAAwB;CACtE,sBAAsB,iBAAiB,eAAe,SAAS,WAAW,YAAY,WAAW,KAAK,oBAAoB,iBAAiB;CAC3I,wBAAwB,OAAO,WAAW,gBAAgB,SAAS,SAAS;CAC5E,qBAAqB,KAAK;CAC1B,wBAAwB,OAAO,WAAW,SAAS,0BAA0B,IAAI;CACjF,uBAAuB,UAAU;CACjC,2BAA2B,cAAc;CACzC,aAAa,6BAA6B,mBAAmB;CAI7D,uBAAuB,MAAM,SAAS,gBAAgB,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;CAChF,iBAAiB,IAAI;CACrB,oBAAoB,MAAM,gBAAgB;AAC5C"}

package/dist/canvas/SceneCanvas/useSelectionOverlayLayer.js

@@ -1,5 +1,5 @@
 import { isCustomEntry } from "../layerSlots.js";
-import { createSelectionOverlayLayer, rotationBadgeOf } from "../../features/selection/overlay.js";
+import { createSelectionOverlayLayer, rotationBadgeOf } from "../../domains/selection/overlay.js";
 import { useMemo } from "react";
 
 //#region src/canvas/SceneCanvas/useSelectionOverlayLayer.ts

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

@@ -1 +1 @@
-{"version":3,"file":"useSelectionOverlayLayer.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSelectionOverlayLayer.ts"],"sourcesContent":["/**\n * The selection-overlay slot, built, and where it paints its rotate badge.\n * Both are `null` when the slot is switched off, and a pre-built layer has no badge.\n */\nimport { useMemo } from 'react';\nimport type { ResizeHandleLayout } from 'interactions/actions/resize/cornerHandles';\nimport type { RenderLayer } from 'core/layers/render';\nimport { createSelectionOverlayLayer, rotationBadgeOf } from 'features/selection/overlay';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { DrawnBoundsScene } from '../drawnBounds';\nimport { isCustomEntry, type CustomLayerEntry, type SelectionOverlaySlotConfig } from '../layerSlots';\n\nexport function useSelectionOverlayLayer<TPose>(\n  /** The slot after `mergeLayersWithDefaults`. */\n  slot: SelectionOverlaySlotConfig<TPose> | CustomLayerEntry | null | undefined,\n  /** Ids whose outline and handles other chrome replaces, on top of the\n   *  slot's own `getSuppressedIds`: the node whose anchors are being edited. */\n  getOwnSuppressedIds: () => ReadonlySet<string>,\n  /** What a slot's `poseById` is projected with when it names no descriptor. */\n  poseDescriptor: PoseDescriptor<TPose>,\n  /** The nodes a slot's `poseById` answers for, so their chrome sits on the\n   *  stroke. Omitted when the canvas measures pose boxes alone. */\n  scene?: DrawnBoundsScene,\n  /** The canvas's resize-handle layout, which its hit-test reads too. */\n  resizeHandles?: ResizeHandleLayout,\n): {\n  layer: RenderLayer<unknown> | null;\n  rotationBadge: ReturnType<typeof rotationBadgeOf>;\n} {\n  const badge = slot && !isCustomEntry(slot) ? rotationBadgeOf(slot) : null;\n  // Kept by value so the layers and hit-testers keyed on it don't rebuild\n  // every render.\n  const rotationBadge = useMemo(\n    () => badge,\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [badge?.distancePx, badge?.sizePx],\n  );\n  const layer = useMemo(() => {\n    if (slot === null) return null;\n    if (isCustomEntry(slot)) return slot.layer;\n    const cfg = slot ?? {};\n    const callerSuppress = cfg.getSuppressedIds;\n    const getSuppressedIds = (): ReadonlySet<string> => {\n      const own = getOwnSuppressedIds();\n      const caller = callerSuppress?.();\n      if (!caller || caller.size === 0) return own;\n      if (own.size === 0) return caller;\n      const merged = new Set<string>(caller);\n      for (const id of own) merged.add(id);\n      return merged;\n    };\n    return createSelectionOverlayLayer<TPose>({\n      ...cfg,\n      ...(resizeHandles ? { resizeHandles } : {}),\n      getSuppressedIds,\n      // A caller's pose lookup still needs a geometry to project with; without\n      // one the layer reads bounds off the chrome state and calls neither.\n      ...(cfg.poseById\n        ? {\n            getPose: cfg.poseById,\n            poseDescriptor: cfg.poseDescriptor ?? poseDescriptor,\n            ...(cfg.scene ?? scene ? { scene: cfg.scene ?? scene } : {}),\n          }\n        : {}),\n    });\n  }, [slot, getOwnSuppressedIds, poseDescriptor, scene, resizeHandles]);\n  return { layer, rotationBadge };\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,yBAEd,MAGA,qBAEA,gBAGA,OAEA,eAIA;CACA,MAAM,QAAQ,QAAQ,CAAC,cAAc,IAAI,IAAI,gBAAgB,IAAI,IAAI;CAGrE,MAAM,gBAAgB,cACd,OAEN,CAAC,OAAO,YAAY,OAAO,MAAM,CACnC;CA8BA,OAAO;EAAE,OA7BK,cAAc;GAC1B,IAAI,SAAS,MAAM,OAAO;GAC1B,IAAI,cAAc,IAAI,GAAG,OAAO,KAAK;GACrC,MAAM,MAAM,QAAQ,CAAC;GACrB,MAAM,iBAAiB,IAAI;GAC3B,MAAM,yBAA8C;IAClD,MAAM,MAAM,oBAAoB;IAChC,MAAM,SAAS,iBAAiB;IAChC,IAAI,CAAC,UAAU,OAAO,SAAS,GAAG,OAAO;IACzC,IAAI,IAAI,SAAS,GAAG,OAAO;IAC3B,MAAM,SAAS,IAAI,IAAY,MAAM;IACrC,KAAK,MAAM,MAAM,KAAK,OAAO,IAAI,EAAE;IACnC,OAAO;GACT;GACA,OAAO,4BAAmC;IACxC,GAAG;IACH,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;IACzC;IAGA,GAAI,IAAI,WACJ;KACE,SAAS,IAAI;KACb,gBAAgB,IAAI,kBAAkB;KACtC,GAAI,IAAI,SAAS,QAAQ,EAAE,OAAO,IAAI,SAAS,MAAM,IAAI,CAAC;IAC5D,IACA,CAAC;GACP,CAAC;EACH,GAAG;GAAC;GAAM;GAAqB;GAAgB;GAAO;EAAa,CAC1D;EAAO;CAAc;AAChC"}
+{"version":3,"file":"useSelectionOverlayLayer.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSelectionOverlayLayer.ts"],"sourcesContent":["/**\n * The selection-overlay slot, built, and where it paints its rotate badge.\n * Both are `null` when the slot is switched off, and a pre-built layer has no badge.\n */\nimport { useMemo } from 'react';\nimport type { ResizeHandleLayout } from 'interactions/actions/resize/cornerHandles';\nimport type { RenderLayer } from 'core/layers/render';\nimport { createSelectionOverlayLayer, rotationBadgeOf } from 'domains/selection/overlay';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { DrawnBoundsScene } from '../drawnBounds';\nimport { isCustomEntry, type CustomLayerEntry, type SelectionOverlaySlotConfig } from '../layerSlots';\n\nexport function useSelectionOverlayLayer<TPose>(\n  /** The slot after `mergeLayersWithDefaults`. */\n  slot: SelectionOverlaySlotConfig<TPose> | CustomLayerEntry | null | undefined,\n  /** Ids whose outline and handles other chrome replaces, on top of the\n   *  slot's own `getSuppressedIds`: the node whose anchors are being edited. */\n  getOwnSuppressedIds: () => ReadonlySet<string>,\n  /** What a slot's `poseById` is projected with when it names no descriptor. */\n  poseDescriptor: PoseDescriptor<TPose>,\n  /** The nodes a slot's `poseById` answers for, so their chrome sits on the\n   *  stroke. Omitted when the canvas measures pose boxes alone. */\n  scene?: DrawnBoundsScene,\n  /** The canvas's resize-handle layout, which its hit-test reads too. */\n  resizeHandles?: ResizeHandleLayout,\n): {\n  layer: RenderLayer<unknown> | null;\n  rotationBadge: ReturnType<typeof rotationBadgeOf>;\n} {\n  const badge = slot && !isCustomEntry(slot) ? rotationBadgeOf(slot) : null;\n  // Kept by value so the layers and hit-testers keyed on it don't rebuild\n  // every render.\n  const rotationBadge = useMemo(\n    () => badge,\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [badge?.distancePx, badge?.sizePx],\n  );\n  const layer = useMemo(() => {\n    if (slot === null) return null;\n    if (isCustomEntry(slot)) return slot.layer;\n    const cfg = slot ?? {};\n    const callerSuppress = cfg.getSuppressedIds;\n    const getSuppressedIds = (): ReadonlySet<string> => {\n      const own = getOwnSuppressedIds();\n      const caller = callerSuppress?.();\n      if (!caller || caller.size === 0) return own;\n      if (own.size === 0) return caller;\n      const merged = new Set<string>(caller);\n      for (const id of own) merged.add(id);\n      return merged;\n    };\n    return createSelectionOverlayLayer<TPose>({\n      ...cfg,\n      ...(resizeHandles ? { resizeHandles } : {}),\n      getSuppressedIds,\n      // A caller's pose lookup still needs a geometry to project with; without\n      // one the layer reads bounds off the chrome state and calls neither.\n      ...(cfg.poseById\n        ? {\n            getPose: cfg.poseById,\n            poseDescriptor: cfg.poseDescriptor ?? poseDescriptor,\n            ...(cfg.scene ?? scene ? { scene: cfg.scene ?? scene } : {}),\n          }\n        : {}),\n    });\n  }, [slot, getOwnSuppressedIds, poseDescriptor, scene, resizeHandles]);\n  return { layer, rotationBadge };\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,yBAEd,MAGA,qBAEA,gBAGA,OAEA,eAIA;CACA,MAAM,QAAQ,QAAQ,CAAC,cAAc,IAAI,IAAI,gBAAgB,IAAI,IAAI;CAGrE,MAAM,gBAAgB,cACd,OAEN,CAAC,OAAO,YAAY,OAAO,MAAM,CACnC;CA8BA,OAAO;EAAE,OA7BK,cAAc;GAC1B,IAAI,SAAS,MAAM,OAAO;GAC1B,IAAI,cAAc,IAAI,GAAG,OAAO,KAAK;GACrC,MAAM,MAAM,QAAQ,CAAC;GACrB,MAAM,iBAAiB,IAAI;GAC3B,MAAM,yBAA8C;IAClD,MAAM,MAAM,oBAAoB;IAChC,MAAM,SAAS,iBAAiB;IAChC,IAAI,CAAC,UAAU,OAAO,SAAS,GAAG,OAAO;IACzC,IAAI,IAAI,SAAS,GAAG,OAAO;IAC3B,MAAM,SAAS,IAAI,IAAY,MAAM;IACrC,KAAK,MAAM,MAAM,KAAK,OAAO,IAAI,EAAE;IACnC,OAAO;GACT;GACA,OAAO,4BAAmC;IACxC,GAAG;IACH,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;IACzC;IAGA,GAAI,IAAI,WACJ;KACE,SAAS,IAAI;KACb,gBAAgB,IAAI,kBAAkB;KACtC,GAAI,IAAI,SAAS,QAAQ,EAAE,OAAO,IAAI,SAAS,MAAM,IAAI,CAAC;IAC5D,IACA,CAAC;GACP,CAAC;EACH,GAAG;GAAC;GAAM;GAAqB;GAAgB;GAAO;EAAa,CAC1D;EAAO;CAAc;AAChC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useSurfaceViewInputs.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSurfaceViewInputs.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { ChromeCaps } from 'features/chrome-caps/useChromeCaps';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { SurfaceViewInputs } from '../viewInputs';\n\ntype Picking = Pick<SurfaceViewInputs, 'boundsOf' | 'planeOfNode' | 'pickEvery' | 'pickBest' | 'kindOfNode' | 'doubleClickNames'>\n  & { adapter: unknown; boundsOfPose: unknown };\n\n/**\n * What a view needs to build its own overlay-aware state. `descriptor` is the same one handed\n * to `<Canvas>`, so the two cannot diverge.\n */\nexport function useSurfaceViewInputs(args: {\n  picking: Picking;\n  descriptor: PoseDescriptor<unknown>;\n  chromeCaps: ChromeCaps;\n  selection: SelectionApi;\n  rotationBadge: SurfaceViewInputs['rotationBadge'];\n  resizeHandles: SurfaceViewInputs['resizeHandles'];\n}): SurfaceViewInputs {\n  const { picking, descriptor, chromeCaps, selection, rotationBadge, resizeHandles } = args;\n  const { adapter, boundsOf, boundsOfPose, planeOfNode, pickEvery, pickBest, kindOfNode, doubleClickNames } = picking;\n  return useMemo<SurfaceViewInputs>(() => ({\n    adapter: adapter as { getPose(id: string): unknown },\n    geometry: descriptor,\n    boundsOf,\n    boundsOfPose: boundsOfPose as SurfaceViewInputs['boundsOfPose'],\n    planeOfNode,\n    pickEvery,\n    pickBest,\n    kindOfNode,\n    doubleClickNames,\n    chromeCaps,\n    selectionApi: selection,\n    rotationBadge,\n    resizeHandles,\n  }), [adapter, descriptor, boundsOf, boundsOfPose, planeOfNode,\n       pickEvery, pickBest, kindOfNode, doubleClickNames, chromeCaps, selection, rotationBadge, resizeHandles]);\n}\n"],"mappings":";;;;;;;AAaA,SAAgB,qBAAqB,MAOf;CACpB,MAAM,EAAE,SAAS,YAAY,YAAY,WAAW,eAAe,kBAAkB;CACrF,MAAM,EAAE,SAAS,UAAU,cAAc,aAAa,WAAW,UAAU,YAAY,qBAAqB;CAC5G,OAAO,eAAkC;EAC9B;EACT,UAAU;EACV;EACc;EACd;EACA;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA;CACF,IAAI;EAAC;EAAS;EAAY;EAAU;EAAc;EAC7C;EAAW;EAAU;EAAY;EAAkB;EAAY;EAAW;EAAe;CAAa,CAAC;AAC9G"}
+{"version":3,"file":"useSurfaceViewInputs.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSurfaceViewInputs.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { ChromeCaps } from 'domains/chrome-caps/useChromeCaps';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { SurfaceViewInputs } from '../viewInputs';\n\ntype Picking = Pick<SurfaceViewInputs, 'boundsOf' | 'planeOfNode' | 'pickEvery' | 'pickBest' | 'kindOfNode' | 'doubleClickNames'>\n  & { adapter: unknown; boundsOfPose: unknown };\n\n/**\n * What a view needs to build its own overlay-aware state. `descriptor` is the same one handed\n * to `<Canvas>`, so the two cannot diverge.\n */\nexport function useSurfaceViewInputs(args: {\n  picking: Picking;\n  descriptor: PoseDescriptor<unknown>;\n  chromeCaps: ChromeCaps;\n  selection: SelectionApi;\n  rotationBadge: SurfaceViewInputs['rotationBadge'];\n  resizeHandles: SurfaceViewInputs['resizeHandles'];\n}): SurfaceViewInputs {\n  const { picking, descriptor, chromeCaps, selection, rotationBadge, resizeHandles } = args;\n  const { adapter, boundsOf, boundsOfPose, planeOfNode, pickEvery, pickBest, kindOfNode, doubleClickNames } = picking;\n  return useMemo<SurfaceViewInputs>(() => ({\n    adapter: adapter as { getPose(id: string): unknown },\n    geometry: descriptor,\n    boundsOf,\n    boundsOfPose: boundsOfPose as SurfaceViewInputs['boundsOfPose'],\n    planeOfNode,\n    pickEvery,\n    pickBest,\n    kindOfNode,\n    doubleClickNames,\n    chromeCaps,\n    selectionApi: selection,\n    rotationBadge,\n    resizeHandles,\n  }), [adapter, descriptor, boundsOf, boundsOfPose, planeOfNode,\n       pickEvery, pickBest, kindOfNode, doubleClickNames, chromeCaps, selection, rotationBadge, resizeHandles]);\n}\n"],"mappings":";;;;;;;AAaA,SAAgB,qBAAqB,MAOf;CACpB,MAAM,EAAE,SAAS,YAAY,YAAY,WAAW,eAAe,kBAAkB;CACrF,MAAM,EAAE,SAAS,UAAU,cAAc,aAAa,WAAW,UAAU,YAAY,qBAAqB;CAC5G,OAAO,eAAkC;EAC9B;EACT,UAAU;EACV;EACc;EACd;EACA;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA;CACF,IAAI;EAAC;EAAS;EAAY;EAAU;EAAc;EAC7C;EAAW;EAAU;EAAY;EAAkB;EAAY;EAAW;EAAe;CAAa,CAAC;AAC9G"}

package/dist/canvas/SceneCanvas/useToolKeybindings.js

@@ -11,7 +11,7 @@ import { useContributionRoles } from "./useContributionRoles.js";
 * each need their own instance and the hook count has to stay stable across
 * the takeover branch.
 */
-function useToolKeybindings({ internalTools, toolsTakeover, enableKeybindings, modes, canvasApi, versionCheck }) {
+function useToolKeybindings({ internalTools, toolsTakeover, surface, enableKeybindings, modes, canvasApi, versionCheck }) {
 	useKeybindings(internalTools, {
 		disable: !!toolsTakeover || !enableKeybindings,
 		modes
@@ -20,7 +20,7 @@ function useToolKeybindings({ internalTools, toolsTakeover, enableKeybindings, m
 		disable: !toolsTakeover || !enableKeybindings,
 		modes
 	});
-	useContributionRoles(toolsTakeover ?? internalTools, canvasApi, versionCheck);
+	useContributionRoles(toolsTakeover ?? internalTools, canvasApi, versionCheck, surface);
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useToolKeybindings.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useToolKeybindings.ts"],"sourcesContent":["import type { ModeRegistry } from '@weasel-js/modes';\nimport { useKeybindings } from 'tools/useKeybindings';\nimport type { ToolsApi } from '../../tools/overlayBinding';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport { useContributionRoles, type VersionCheck } from './useContributionRoles';\n\n/**\n * Runs `useKeybindings`, whose `tool.activate` / `tool.offhand` /\n * `tool.resetToDefault` registrations land in this canvas's scope.\n *\n * Two calls: the hook snapshots the initial active tool for\n * Escape-returns-to-default, so the internal and consumer-supplied `ToolsApi`\n * each need their own instance and the hook count has to stay stable across\n * the takeover branch.\n */\nexport function useToolKeybindings({\n  internalTools,\n  toolsTakeover,\n  enableKeybindings,\n  modes,\n  canvasApi,\n  versionCheck,\n}: {\n  internalTools: ToolsApi;\n  toolsTakeover?: ToolsApi;\n  enableKeybindings: boolean;\n  modes?: ModeRegistry;\n  canvasApi: CanvasExtensionApi | null;\n  versionCheck?: VersionCheck;\n}): void {\n  useKeybindings(internalTools, {\n    disable: !!toolsTakeover || !enableKeybindings,\n    modes,\n  });\n  useKeybindings(toolsTakeover ?? internalTools, {\n    disable: !toolsTakeover || !enableKeybindings,\n    modes,\n  });\n  // Entry-owned roles live here and not in the tool hooks because the hooks\n  // run above the provider. Not gated on `enableKeybindings` — these back\n  // wheel and pointer bindings too, not just keys.\n  useContributionRoles(toolsTakeover ?? internalTools, canvasApi, versionCheck);\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,mBAAmB,EACjC,eACA,eACA,mBACA,OACA,WACA,gBAQO;CACP,eAAe,eAAe;EAC5B,SAAS,CAAC,CAAC,iBAAiB,CAAC;EAC7B;CACF,CAAC;CACD,eAAe,iBAAiB,eAAe;EAC7C,SAAS,CAAC,iBAAiB,CAAC;EAC5B;CACF,CAAC;CAID,qBAAqB,iBAAiB,eAAe,WAAW,YAAY;AAC9E"}
+{"version":3,"file":"useToolKeybindings.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useToolKeybindings.ts"],"sourcesContent":["import type { ModeRegistry } from '@weasel-js/modes';\nimport { useKeybindings } from 'tools/useKeybindings';\nimport type { ToolsApi } from '../../tools/overlayBinding';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport type { SurfaceContribution } from '../surfaceContribution';\nimport { useContributionRoles, type VersionCheck } from './useContributionRoles';\n\n/**\n * Runs `useKeybindings`, whose `tool.activate` / `tool.offhand` /\n * `tool.resetToDefault` registrations land in this canvas's scope.\n *\n * Two calls: the hook snapshots the initial active tool for\n * Escape-returns-to-default, so the internal and consumer-supplied `ToolsApi`\n * each need their own instance and the hook count has to stay stable across\n * the takeover branch.\n */\nexport function useToolKeybindings({\n  internalTools,\n  toolsTakeover,\n  surface,\n  enableKeybindings,\n  modes,\n  canvasApi,\n  versionCheck,\n}: {\n  internalTools: ToolsApi;\n  toolsTakeover?: ToolsApi;\n  /** The surface's own entries installed beside a takeover. */\n  surface?: readonly SurfaceContribution[];\n  enableKeybindings: boolean;\n  modes?: ModeRegistry;\n  canvasApi: CanvasExtensionApi | null;\n  versionCheck?: VersionCheck;\n}): void {\n  useKeybindings(internalTools, {\n    disable: !!toolsTakeover || !enableKeybindings,\n    modes,\n  });\n  useKeybindings(toolsTakeover ?? internalTools, {\n    disable: !toolsTakeover || !enableKeybindings,\n    modes,\n  });\n  // Entry-owned roles live here and not in the tool hooks because the hooks\n  // run above the provider. Not gated on `enableKeybindings` — these back\n  // wheel and pointer bindings too, not just keys.\n  useContributionRoles(toolsTakeover ?? internalTools, canvasApi, versionCheck, surface);\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,SAAgB,mBAAmB,EACjC,eACA,eACA,SACA,mBACA,OACA,WACA,gBAUO;CACP,eAAe,eAAe;EAC5B,SAAS,CAAC,CAAC,iBAAiB,CAAC;EAC7B;CACF,CAAC;CACD,eAAe,iBAAiB,eAAe;EAC7C,SAAS,CAAC,iBAAiB,CAAC;EAC5B;CACF,CAAC;CAID,qBAAqB,iBAAiB,eAAe,WAAW,cAAc,OAAO;AACvF"}

package/dist/canvas/SceneCanvas/useViewportActions.js

@@ -1,5 +1,6 @@
 import { makeViewportZoomAction } from "../../interactions/actions/defaults/viewportZoom.js";
 import { makeViewportWheelPanAction } from "../../interactions/actions/defaults/viewportWheelPan.js";
+import { containerScrollAction } from "../../interactions/actions/defaults/containerScroll.js";
 import { makePinchZoomAction } from "../../interactions/actions/defaults/pinchZoom.js";
 import { useEffect } from "react";
 import { useLatest } from "@weasel-js/react";
@@ -8,7 +9,9 @@ import { useActionsRegistry } from "@weasel-js/routing/react";
 //#region src/canvas/SceneCanvas/useViewportActions.ts
 /**
 * Registers the wheel pan, zoom, and pinch zoom actions from SceneCanvas's
-* `viewport` prop.
+* `viewport` prop, and the wheel scroll of a container whose content runs
+* past its bounds — first, so it is asked before the pan and yields to it
+* anywhere else.
 *
 * Wheel pan and zoom are registered only here. `pinchZoom` is also a kit
 * standard action, so this hook re-registers a configured one over it, or
@@ -26,7 +29,7 @@ function useViewportActions(args) {
 	useEffect(() => {
 		const r = regRef.current;
 		if (!r) return;
-		const unregisters = [];
+		const unregisters = [r.register(containerScrollAction)];
 		if (pan) unregisters.push(r.register(makeViewportWheelPanAction(typeof pan === "object" ? pan : {})));
 		if (zoom) {
 			const zoomAction = typeof zoom === "object" ? makeViewportZoomAction(zoom) : makeViewportZoomAction();

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

@@ -1 +1 @@
-{"version":3,"file":"useViewportActions.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useViewportActions.ts"],"sourcesContent":["/**\n * Registers the wheel pan, zoom, and pinch zoom actions from SceneCanvas's\n * `viewport` prop.\n *\n * Wheel pan and zoom are registered only here. `pinchZoom` is also a kit\n * standard action, so this hook re-registers a configured one over it, or\n * mutes it — muting rather than unregistering, so a sibling canvas sharing the\n * registry keeps its own. That overlap is why this must run after\n * `useStandardActions`.\n */\nimport { useEffect } from 'react';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport {\n  makeViewportWheelPanAction,\n  type WheelPanOptions,\n} from 'interactions/actions/defaults/viewportWheelPan';\nimport {\n  makeViewportZoomAction,\n  type ViewportZoomOptions,\n} from 'interactions/actions/defaults/viewportZoom';\nimport {\n  makePinchZoomAction,\n  type PinchZoomOptions,\n} from 'interactions/actions/defaults/pinchZoom';\n\nexport function useViewportActions(args: {\n  /** `true`/`false` toggles wheel pan; an object locks its axis (see\n   *  {@link WheelPanOptions}). */\n  pan: boolean | WheelPanOptions;\n  /** `true`/`false` toggles the default Cmd+wheel zoom; an object tunes the\n   *  wheel trigger + scale clamp (see {@link ViewportZoomOptions}). */\n  zoom: boolean | ViewportZoomOptions;\n  /** `true`/`false` toggles two-finger pinch zoom; an object sets its scale\n   *  clamp (see {@link PinchZoomOptions}). */\n  pinchZoom: boolean | PinchZoomOptions;\n}): void {\n  const { pan, zoom, pinchZoom } = args;\n  const reg = useActionsRegistry();\n  const regRef = useLatest(reg);\n\n  // Serialized so the effect re-runs when a config's fields change, not its\n  // identity. JSON.stringify drops function-valued fields, so changing only\n  // `animate.easing` does not re-register — pass a stable easing.\n  const panKey = typeof pan === 'object' ? JSON.stringify(pan) : String(pan);\n  const zoomKey = typeof zoom === 'object' ? JSON.stringify(zoom) : String(zoom);\n  const pinchKey = typeof pinchZoom === 'object' ? JSON.stringify(pinchZoom) : String(pinchZoom);\n\n  useEffect(() => {\n    const r = regRef.current;\n    if (!r) return;\n    const unregisters: Array<() => void> = [];\n    if (pan) {\n      unregisters.push(\n        r.register(makeViewportWheelPanAction(typeof pan === 'object' ? pan : {})),\n      );\n    }\n    if (zoom) {\n      const zoomAction =\n        typeof zoom === 'object' ? makeViewportZoomAction(zoom) : makeViewportZoomAction();\n      unregisters.push(r.register(zoomAction));\n    }\n    if (pinchZoom) {\n      unregisters.push(\n        r.register(makePinchZoomAction(typeof pinchZoom === 'object' ? pinchZoom : {})),\n      );\n    } else {\n      unregisters.push(r.mute('viewport.pinchZoom'));\n    }\n    return () => { for (const u of unregisters) u(); };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- configs tracked via zoomKey / pinchKey\n  }, [panKey, zoomKey, pinchKey]);\n}\n\n/**\n * `viewport.zoom` with `viewport.animatedZoom` folded in as the zoom action's\n * `animate` option, the way `pinchZoom` carries the pinch tool's clamp.\n */\nexport function viewportZoomOption(\n  zoom: boolean | ViewportZoomOptions | undefined,\n  animatedZoom: ViewportZoomOptions['animate'] | undefined,\n): boolean | ViewportZoomOptions {\n  if (zoom === false) return false;\n  const base = typeof zoom === 'object' ? zoom : {};\n  if (!animatedZoom) return base;\n  return { ...base, animate: animatedZoom === true ? {} : animatedZoom };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0BA,SAAgB,mBAAmB,MAU1B;CACP,MAAM,EAAE,KAAK,MAAM,cAAc;CACjC,MAAM,MAAM,mBAAmB;CAC/B,MAAM,SAAS,UAAU,GAAG;CAK5B,MAAM,SAAS,OAAO,QAAQ,WAAW,KAAK,UAAU,GAAG,IAAI,OAAO,GAAG;CACzE,MAAM,UAAU,OAAO,SAAS,WAAW,KAAK,UAAU,IAAI,IAAI,OAAO,IAAI;CAC7E,MAAM,WAAW,OAAO,cAAc,WAAW,KAAK,UAAU,SAAS,IAAI,OAAO,SAAS;CAE7F,gBAAgB;EACd,MAAM,IAAI,OAAO;EACjB,IAAI,CAAC,GAAG;EACR,MAAM,cAAiC,CAAC;EACxC,IAAI,KACF,YAAY,KACV,EAAE,SAAS,2BAA2B,OAAO,QAAQ,WAAW,MAAM,CAAC,CAAC,CAAC,CAC3E;EAEF,IAAI,MAAM;GACR,MAAM,aACJ,OAAO,SAAS,WAAW,uBAAuB,IAAI,IAAI,uBAAuB;GACnF,YAAY,KAAK,EAAE,SAAS,UAAU,CAAC;EACzC;EACA,IAAI,WACF,YAAY,KACV,EAAE,SAAS,oBAAoB,OAAO,cAAc,WAAW,YAAY,CAAC,CAAC,CAAC,CAChF;OAEA,YAAY,KAAK,EAAE,KAAK,oBAAoB,CAAC;EAE/C,aAAa;GAAE,KAAK,MAAM,KAAK,aAAa,EAAE;EAAG;CAEnD,GAAG;EAAC;EAAQ;EAAS;CAAQ,CAAC;AAChC;;;;;AAMA,SAAgB,mBACd,MACA,cAC+B;CAC/B,IAAI,SAAS,OAAO,OAAO;CAC3B,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,CAAC;CAChD,IAAI,CAAC,cAAc,OAAO;CAC1B,OAAO;EAAE,GAAG;EAAM,SAAS,iBAAiB,OAAO,CAAC,IAAI;CAAa;AACvE"}
+{"version":3,"file":"useViewportActions.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useViewportActions.ts"],"sourcesContent":["/**\n * Registers the wheel pan, zoom, and pinch zoom actions from SceneCanvas's\n * `viewport` prop, and the wheel scroll of a container whose content runs\n * past its bounds — first, so it is asked before the pan and yields to it\n * anywhere else.\n *\n * Wheel pan and zoom are registered only here. `pinchZoom` is also a kit\n * standard action, so this hook re-registers a configured one over it, or\n * mutes it — muting rather than unregistering, so a sibling canvas sharing the\n * registry keeps its own. That overlap is why this must run after\n * `useStandardActions`.\n */\nimport { useEffect } from 'react';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { containerScrollAction } from 'interactions/actions/defaults/containerScroll';\nimport {\n  makeViewportWheelPanAction,\n  type WheelPanOptions,\n} from 'interactions/actions/defaults/viewportWheelPan';\nimport {\n  makeViewportZoomAction,\n  type ViewportZoomOptions,\n} from 'interactions/actions/defaults/viewportZoom';\nimport {\n  makePinchZoomAction,\n  type PinchZoomOptions,\n} from 'interactions/actions/defaults/pinchZoom';\n\nexport function useViewportActions(args: {\n  /** `true`/`false` toggles wheel pan; an object locks its axis (see\n   *  {@link WheelPanOptions}). */\n  pan: boolean | WheelPanOptions;\n  /** `true`/`false` toggles the default Cmd+wheel zoom; an object tunes the\n   *  wheel trigger + scale clamp (see {@link ViewportZoomOptions}). */\n  zoom: boolean | ViewportZoomOptions;\n  /** `true`/`false` toggles two-finger pinch zoom; an object sets its scale\n   *  clamp (see {@link PinchZoomOptions}). */\n  pinchZoom: boolean | PinchZoomOptions;\n}): void {\n  const { pan, zoom, pinchZoom } = args;\n  const reg = useActionsRegistry();\n  const regRef = useLatest(reg);\n\n  // Serialized so the effect re-runs when a config's fields change, not its\n  // identity. JSON.stringify drops function-valued fields, so changing only\n  // `animate.easing` does not re-register — pass a stable easing.\n  const panKey = typeof pan === 'object' ? JSON.stringify(pan) : String(pan);\n  const zoomKey = typeof zoom === 'object' ? JSON.stringify(zoom) : String(zoom);\n  const pinchKey = typeof pinchZoom === 'object' ? JSON.stringify(pinchZoom) : String(pinchZoom);\n\n  useEffect(() => {\n    const r = regRef.current;\n    if (!r) return;\n    const unregisters: Array<() => void> = [r.register(containerScrollAction)];\n    if (pan) {\n      unregisters.push(\n        r.register(makeViewportWheelPanAction(typeof pan === 'object' ? pan : {})),\n      );\n    }\n    if (zoom) {\n      const zoomAction =\n        typeof zoom === 'object' ? makeViewportZoomAction(zoom) : makeViewportZoomAction();\n      unregisters.push(r.register(zoomAction));\n    }\n    if (pinchZoom) {\n      unregisters.push(\n        r.register(makePinchZoomAction(typeof pinchZoom === 'object' ? pinchZoom : {})),\n      );\n    } else {\n      unregisters.push(r.mute('viewport.pinchZoom'));\n    }\n    return () => { for (const u of unregisters) u(); };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- configs tracked via zoomKey / pinchKey\n  }, [panKey, zoomKey, pinchKey]);\n}\n\n/**\n * `viewport.zoom` with `viewport.animatedZoom` folded in as the zoom action's\n * `animate` option, the way `pinchZoom` carries the pinch tool's clamp.\n */\nexport function viewportZoomOption(\n  zoom: boolean | ViewportZoomOptions | undefined,\n  animatedZoom: ViewportZoomOptions['animate'] | undefined,\n): boolean | ViewportZoomOptions {\n  if (zoom === false) return false;\n  const base = typeof zoom === 'object' ? zoom : {};\n  if (!animatedZoom) return base;\n  return { ...base, animate: animatedZoom === true ? {} : animatedZoom };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,mBAAmB,MAU1B;CACP,MAAM,EAAE,KAAK,MAAM,cAAc;CACjC,MAAM,MAAM,mBAAmB;CAC/B,MAAM,SAAS,UAAU,GAAG;CAK5B,MAAM,SAAS,OAAO,QAAQ,WAAW,KAAK,UAAU,GAAG,IAAI,OAAO,GAAG;CACzE,MAAM,UAAU,OAAO,SAAS,WAAW,KAAK,UAAU,IAAI,IAAI,OAAO,IAAI;CAC7E,MAAM,WAAW,OAAO,cAAc,WAAW,KAAK,UAAU,SAAS,IAAI,OAAO,SAAS;CAE7F,gBAAgB;EACd,MAAM,IAAI,OAAO;EACjB,IAAI,CAAC,GAAG;EACR,MAAM,cAAiC,CAAC,EAAE,SAAS,qBAAqB,CAAC;EACzE,IAAI,KACF,YAAY,KACV,EAAE,SAAS,2BAA2B,OAAO,QAAQ,WAAW,MAAM,CAAC,CAAC,CAAC,CAC3E;EAEF,IAAI,MAAM;GACR,MAAM,aACJ,OAAO,SAAS,WAAW,uBAAuB,IAAI,IAAI,uBAAuB;GACnF,YAAY,KAAK,EAAE,SAAS,UAAU,CAAC;EACzC;EACA,IAAI,WACF,YAAY,KACV,EAAE,SAAS,oBAAoB,OAAO,cAAc,WAAW,YAAY,CAAC,CAAC,CAAC,CAChF;OAEA,YAAY,KAAK,EAAE,KAAK,oBAAoB,CAAC;EAE/C,aAAa;GAAE,KAAK,MAAM,KAAK,aAAa,EAAE;EAAG;CAEnD,GAAG;EAAC;EAAQ;EAAS;CAAQ,CAAC;AAChC;;;;;AAMA,SAAgB,mBACd,MACA,cAC+B;CAC/B,IAAI,SAAS,OAAO,OAAO;CAC3B,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,CAAC;CAChD,IAAI,CAAC,cAAc,OAAO;CAC1B,OAAO;EAAE,GAAG;EAAM,SAAS,iBAAiB,OAAO,CAAC,IAAI;CAAa;AACvE"}

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

@@ -1 +1 @@
-{"version":3,"file":"worldPointAt.js","names":[],"sources":["../../../src/canvas/SceneCanvas/worldPointAt.ts"],"sourcesContent":["import type { ViewTarget } from 'features/viewports/viewResolver';\nimport type { CanvasExtensionApi } from '../canvasExtension';\n\n/**\n * A client point in the world of the view it resolved to. The canvas's own\n * view converts through the handle, and a declared view through the resolver,\n * which reads the canvas by the same conversion.\n */\nexport function worldPointAt(\n  api: Pick<CanvasExtensionApi, 'clientToWorld'>,\n  target: ViewTarget | undefined,\n  clientX: number,\n  clientY: number,\n): [number, number] {\n  if (!target || target.id === null) return api.clientToWorld(clientX, clientY);\n  return [target.world.x, target.world.y];\n}\n"],"mappings":";;;;;;AAQA,SAAgB,aACd,KACA,QACA,SACA,SACkB;CAClB,IAAI,CAAC,UAAU,OAAO,OAAO,MAAM,OAAO,IAAI,cAAc,SAAS,OAAO;CAC5E,OAAO,CAAC,OAAO,MAAM,GAAG,OAAO,MAAM,CAAC;AACxC"}
+{"version":3,"file":"worldPointAt.js","names":[],"sources":["../../../src/canvas/SceneCanvas/worldPointAt.ts"],"sourcesContent":["import type { ViewTarget } from 'domains/viewports/viewResolver';\nimport type { CanvasExtensionApi } from '../canvasExtension';\n\n/**\n * A client point in the world of the view it resolved to. The canvas's own\n * view converts through the handle, and a declared view through the resolver,\n * which reads the canvas by the same conversion.\n */\nexport function worldPointAt(\n  api: Pick<CanvasExtensionApi, 'clientToWorld'>,\n  target: ViewTarget | undefined,\n  clientX: number,\n  clientY: number,\n): [number, number] {\n  if (!target || target.id === null) return api.clientToWorld(clientX, clientY);\n  return [target.world.x, target.world.y];\n}\n"],"mappings":";;;;;;AAQA,SAAgB,aACd,KACA,QACA,SACA,SACkB;CAClB,IAAI,CAAC,UAAU,OAAO,OAAO,MAAM,OAAO,IAAI,cAAc,SAAS,OAAO;CAC5E,OAAO,CAAC,OAAO,MAAM,GAAG,OAAO,MAAM,CAAC;AACxC"}

package/dist/canvas/SceneCanvas.js

@@ -3,14 +3,16 @@ import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
 import { ViewRegistryProvider } from "./viewRegistry.js";
 import { rotateAroundAABBCenter } from "./poseRotation.js";
 import { defaultDrawOne } from "./defaultDrawOne.js";
-import { chromeColorOf, watchThemeOf } from "./accentColor.js";
+import { useChromeColor } from "./accentColor.js";
+import { BUILTIN_TOOLS, BUILTIN_TOOL_GROUPS, BUILTIN_TOOL_IDS, DRAW_TOOLS, PAGE_TOOLS, SELECT_TOOLS, SHAPE_TOOLS, TOOL_GROUP_ORDER, TYPE_TOOLS, VIEW_TOOLS } from "./SceneCanvas/builtinToolSets.js";
 import { CORE_PRESET_SOURCE } from "./SceneCanvas/namedPresets.js";
 import { useGroupEntryContribution } from "../tools/builtin/select/groupEntry.js";
 import { useCanvasCamera } from "./SceneCanvas/useCanvasCamera.js";
 import { useHeldModifiers } from "./SceneCanvas/useHeldModifiers.js";
-import { useCanvasIngestion } from "../features/ingestion/useCanvasIngestion.js";
+import { useCanvasIngestion } from "../domains/ingestion/useCanvasIngestion.js";
 import { Canvas } from "./Canvas.js";
 import { DevHuds, canvasDebug } from "./SceneCanvas/DevHuds.js";
+import { GestureReason } from "./GestureReason.js";
 import { CanvasKitProviders } from "./SceneCanvas/CanvasKitProviders.js";
 import { canvasPassThrough } from "./SceneCanvas/canvasPassThrough.js";
 import { useDevtoolsOverride } from "../devtools/useDevtoolsRoot.js";
@@ -21,13 +23,12 @@ import { useCanvasDispatcher } from "./SceneCanvas/useCanvasDispatcher.js";
 import { publishPreviews } from "./publishPreviews.js";
 import { useCanvasSelection } from "./SceneCanvas/useCanvasSelection.js";
 import { SCENE_CANVAS_FEATURES } from "./SceneCanvas/features.js";
-import { BUILTIN_TOOLS, BUILTIN_TOOL_IDS, DRAW_TOOLS, PAGE_TOOLS, SELECT_TOOLS, SHAPE_TOOLS, TYPE_TOOLS, VIEW_TOOLS } from "./SceneCanvas/builtinToolSets.js";
 import { DEFAULT_HANDLE_SIZE } from "./SceneCanvas/props.js";
 import { useEnabledFeatures } from "./SceneCanvas/useCanvasTools.js";
 import { SurfaceDeclarations } from "./SceneCanvas/SurfaceDeclarations.js";
 import { useAddedViews, useSceneCanvasHandle } from "./SceneCanvas/useSceneCanvasHandle.js";
 import { mergeLayersWithDefaults } from "./SceneCanvas/mergeLayers.js";
-import { ENTERED_FRAME_COLOR, ENTERED_FRAME_TOKEN } from "../features/selection/enteredGroupFrame.js";
+import { ENTERED_FRAME_COLOR, ENTERED_FRAME_TOKEN } from "../domains/selection/enteredGroupFrame.js";
 import { useSceneCanvasLayers } from "./SceneCanvas/useSceneCanvasLayers.js";
 import { useSceneCanvasPathEdit } from "./SceneCanvas/useSceneCanvasPathEdit.js";
 import { useSceneCanvasTools } from "./SceneCanvas/useSceneCanvasTools.js";
@@ -35,6 +36,7 @@ import { useSceneCanvasChrome } from "./SceneCanvas/useSceneChrome.js";
 import { useSceneRedrawSources } from "./SceneCanvas/useSceneRedrawSources.js";
 import { useScenePicking } from "./SceneCanvas/useScenePicking.js";
 import { useNodeKinds } from "./SceneCanvas/useNodeKinds.js";
+import { DefaultTextEditDep, useCanvasTextEditor } from "./SceneCanvas/defaultTextEditor.js";
 import { useSurfaceViewInputs } from "./SceneCanvas/useSurfaceViewInputs.js";
 import { forwardRef, useEffect, useMemo, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
@@ -120,12 +122,11 @@ function SceneCanvasInner(props, ref) {
 	const actionsRegistry = useActionsRegistry();
 	const { dispatcher, gestureSource, previewIdsExtra, previewPoseExtra } = useCanvasDispatcher(actionsRegistry);
 	useEffect(() => publishPreviews(scene, dispatcher), [scene, dispatcher]);
-	const frameColor = useMemo(() => ({
-		read: () => chromeColorOf(internalCanvasRef.current, ENTERED_FRAME_TOKEN, ENTERED_FRAME_COLOR),
-		changed: (fn) => watchThemeOf(() => internalCanvasRef.current, fn)
-	}), []);
+	const frameColor = useChromeColor(internalCanvasRef, ENTERED_FRAME_TOKEN, ENTERED_FRAME_COLOR);
+	const { editor: textEditor, layers } = useCanvasTextEditor(scene, internalCanvasRef, props);
 	const layered = useSceneCanvasLayers({
-		layers: props.layers,
+		layers,
+		presetLayers: enabled.layers,
 		targetScale: deviceProfile.targetScale,
 		scene,
 		adapter,
@@ -175,7 +176,7 @@ function SceneCanvasInner(props, ref) {
 		viewRef,
 		dispatcher
 	});
-	const { ingest, clipboard: ingestionClipboard } = useCanvasIngestion(adapter, () => actionsRegistry, props.ingestion);
+	const { ingest, clipboard: ingestionClipboard, handlers: ingestionHandlers } = useCanvasIngestion(adapter, () => actionsRegistry, props.ingestion);
 	const { views: addedViews, addView, viewAt, aimOf, setAim } = useAddedViews();
 	const { handleRef, ready: canvasReady } = useSceneCanvasHandle({
 		ref,
@@ -232,6 +233,11 @@ function SceneCanvasInner(props, ref) {
 				pickEvery: picking.pickEvery,
 				pickBest: picking.pickBest
 			}),
+			/* @__PURE__ */ jsx(GestureReason, {
+				dispatcher,
+				canvasRef: internalCanvasRef,
+				viewRef
+			}),
 			/* @__PURE__ */ jsx(SceneCanvasInput, {
 				props,
 				scene,
@@ -253,6 +259,7 @@ function SceneCanvasInner(props, ref) {
 				chrome,
 				overlay: layered,
 				ingestionClipboard,
+				ingestionHandlers,
 				devtools,
 				canvas: {
 					elementRef: internalCanvasRef,
@@ -267,6 +274,10 @@ function SceneCanvasInner(props, ref) {
 				entries: contributionEntries(tools.tools),
 				added: addedViews
 			}),
+			/* @__PURE__ */ jsx(DefaultTextEditDep, {
+				editor: textEditor,
+				onDoubleClick: enabled.has("edit")
+			}),
 			props.children
 		]
 	});
@@ -306,5 +317,5 @@ function SceneCanvasWrapper(props, ref) {
 var SceneCanvas = /* @__PURE__ */ forwardRef(SceneCanvasWrapper);
 
 //#endregion
-export { BUILTIN_TOOLS, BUILTIN_TOOL_IDS, DEFAULT_HANDLE_SIZE, DRAW_TOOLS, PAGE_TOOLS, SCENE_CANVAS_FEATURES, SELECT_TOOLS, SHAPE_TOOLS, SceneCanvas, TYPE_TOOLS, VIEW_TOOLS, renderSceneCanvas, rotateAroundAABBCenter };
+export { BUILTIN_TOOLS, BUILTIN_TOOL_GROUPS, BUILTIN_TOOL_IDS, DEFAULT_HANDLE_SIZE, DRAW_TOOLS, PAGE_TOOLS, SCENE_CANVAS_FEATURES, SELECT_TOOLS, SHAPE_TOOLS, SceneCanvas, TOOL_GROUP_ORDER, TYPE_TOOLS, VIEW_TOOLS, renderSceneCanvas, rotateAroundAABBCenter };
 //# sourceMappingURL=SceneCanvas.js.map

package/dist/canvas/SceneCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneCanvas.js","names":[],"sources":["../../src/canvas/SceneCanvas.tsx"],"sourcesContent":["/**\n * `<SceneCanvas>` — `<Canvas>` wired to a `Scene` primitive. Bare, it only renders: behavior\n * comes from the `features` presets (`canvas/SceneCanvas/features.ts`), each of which turns on\n * its own actions, tools, ambient bindings, and chrome.\n *\n * A consumer needing custom tools can pass `tools={useTools(...)}` and SceneCanvas forwards it\n * as-is — the internal tool registry is ignored in that case.\n */\nimport { getActiveModeFor } from '@weasel-js/modes';\nimport { useLatest } from '@weasel-js/react';\nimport { InputScope, useActionsRegistry } from '@weasel-js/routing/react';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { useCanvasCamera } from './SceneCanvas/useCanvasCamera';\nimport { useHeldModifiers } from './SceneCanvas/useHeldModifiers';\nimport { useCanvasIngestion } from 'features/ingestion/useCanvasIngestion';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type React from 'react';\nimport { forwardRef, useEffect, useMemo, useRef } from 'react';\nimport { DeviceProfileProvider, useDeviceProfile } from '../core/device/useDeviceProfile';\nimport { Canvas } from './Canvas';\nimport { canvasDebug, DevHuds } from './SceneCanvas/DevHuds';\nimport { CanvasKitProviders } from './SceneCanvas/CanvasKitProviders';\nimport { canvasPassThrough } from './SceneCanvas/canvasPassThrough';\nimport { SceneCanvasInput, type SceneCanvasInputOptions } from './SceneCanvas/SceneCanvasInput';\nimport type { PresetSource } from './SceneCanvas/features';\nimport { CORE_PRESET_SOURCE } from './SceneCanvas/namedPresets';\nimport type { BridgeAdapter, SceneCanvasProps } from './SceneCanvas/props';\nimport { useBakedScene } from './SceneCanvas/useBakedScene';\nimport { useCanvasDispatcher } from './SceneCanvas/useCanvasDispatcher';\nimport { publishPreviews } from './publishPreviews';\nimport { useCanvasSelection } from './SceneCanvas/useCanvasSelection';\nimport { useEnabledFeatures } from './SceneCanvas/useCanvasTools';\nimport { contributionEntries } from './SceneCanvas/useContributionRoles';\nimport { SurfaceDeclarations } from './SceneCanvas/SurfaceDeclarations';\nimport { useAddedViews, useSceneCanvasHandle } from './SceneCanvas/useSceneCanvasHandle';\nimport { useSceneCanvasLayers } from './SceneCanvas/useSceneCanvasLayers';\nimport { useSceneCanvasPathEdit } from './SceneCanvas/useSceneCanvasPathEdit';\nimport { useSceneCanvasTools, type SceneCanvasToolProps } from './SceneCanvas/useSceneCanvasTools';\nimport { useSceneCanvasChrome } from './SceneCanvas/useSceneChrome';\nimport { useDevtoolsOverride } from '../devtools/useDevtoolsRoot';\nimport { useSceneRedrawSources } from './SceneCanvas/useSceneRedrawSources';\nimport { useScenePicking } from './SceneCanvas/useScenePicking';\nimport { useGroupEntryContribution } from 'tools/builtin/select/groupEntry';\nimport { useNodeKinds } from './SceneCanvas/useNodeKinds';\nimport { useSurfaceViewInputs } from './SceneCanvas/useSurfaceViewInputs';\nimport type { CanvasExtensionApi, SceneCanvasApi } from './canvasExtension';\nimport { ViewRegistryProvider } from './viewRegistry';\nimport { chromeColorOf, watchThemeOf } from './accentColor';\nimport { ENTERED_FRAME_COLOR, ENTERED_FRAME_TOKEN } from 'features/selection/enteredGroupFrame';\nexport { SCENE_CANVAS_FEATURES, type Feature } from './SceneCanvas/features';\nexport type { BuiltinToolOptions } from './SceneCanvas/useBuiltinShapeTools';\nexport { defaultDrawOne } from './defaultDrawOne';\nexport { rotateAroundAABBCenter } from './poseRotation';\n\nfunction SceneCanvasInner<TData, TLayer extends string, TPose>(\n  props: SceneCanvasProps<TData, TLayer, TPose> & { presetSource: PresetSource },\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  const { selectTool: selectToolOpts, selectable = true, viewport, modes } = props;\n  const devtools = useDevtoolsOverride(props.debug), { debug } = devtools;\n  const descriptor = (props.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const deviceProfile = useDeviceProfile();\n  const scene = useBakedScene(props.scene);\n  const getActiveMode = useMemo(() => (modes ? getActiveModeFor(modes) : undefined), [modes]);\n  const heldModifiers = useHeldModifiers();\n\n  // Our own refs, so input listeners attach even when the consumer forwards its own ref.\n  const internalCanvasRef = useRef<HTMLElement | null>(null);\n  const canvasApiRef = useRef<CanvasExtensionApi | null>(null);\n  const declaredSize = useLatest({ width: props.width ?? 0, height: props.height ?? 0 });\n  const { viewState, viewAnimation, camera } = useCanvasCamera({\n    view: props.view, defaultView: props.defaultView, onViewChange: props.onViewChange, viewBounds: props.viewBounds,\n    dims: () => canvasApiRef.current?.getSurfaceRect() ?? declaredSize.current,\n    requestRedraw: () => { canvasApiRef.current?.requestRedraw(); },\n  });\n  const { viewRef } = viewState;\n  const kinds = useNodeKinds(scene, props.routing);\n  const selection = useCanvasSelection({ scene, props, selectable, kindOf: kinds.kindOf });\n  const enabled = useEnabledFeatures(\n    props.features, props.presetSource.named, viewport !== undefined, selectToolOpts?.rotate !== false,\n  );\n  const { pathEditState, selectToolWithDefaults } = useSceneCanvasPathEdit({\n    host: props.pathEdit, opening: props.defaultPathEdit, getActiveMode, scene, selection,\n    extensions: enabled.pathEdit, selectTool: selectToolOpts,\n  });\n  const picking = useScenePicking({ scene, selection, descriptor, props, viewRef, selectTool: selectToolWithDefaults, kinds });\n  const { adapter, boundsOf, planeOfNode } = picking;\n  const getNodeAtPointRef = useLatest(picking.getNodeAtPoint);\n  const groupEntry = useGroupEntryContribution({ pickHit: picking.pickBest, tree: adapter, boxOf: boundsOf });\n  const tools = useSceneCanvasTools({\n    props: props as SceneCanvasToolProps, select: picking.selectTool, move: picking.moveOptions,\n    enabled, presetSource: props.presetSource, groupEntry,\n  });\n\n  // The wrapper's `<InputScope>` provides it.\n  const actionsRegistry = useActionsRegistry();\n  const { dispatcher, gestureSource, previewIdsExtra, previewPoseExtra } = useCanvasDispatcher(actionsRegistry);\n  useEffect(() => publishPreviews(scene, dispatcher), [scene, dispatcher]);\n\n  const frameColor = useMemo(() => ({\n    read: () => chromeColorOf(internalCanvasRef.current, ENTERED_FRAME_TOKEN, ENTERED_FRAME_COLOR),\n    changed: (fn: () => void) => watchThemeOf(() => internalCanvasRef.current, fn),\n  }), []);\n  const layered = useSceneCanvasLayers({\n    layers: props.layers, targetScale: deviceProfile.targetScale, scene, adapter, poseDescriptor: descriptor,\n    enteredGroup: picking.enteredGroup, frameColor, alphaFor: props.alphaFor, colorOverrides: props.animator?.colorOverrides, boundsOf, planeOfNode,\n    poseTransition: props.poseTransition, previewIds: previewIdsExtra, dispatcher, snapReadout: props.snap?.readout !== false, snapReadoutStyle: props.snap?.readoutStyle, pathEditState,\n    slops: debug !== undefined && debug !== false && debug.slops === true,\n    boundsIncludeStroke: props.geometry?.boundsIncludeStroke ?? true, selectTool: selectToolOpts,\n  });\n  const redrawOn = useSceneRedrawSources({ props, scene, heldModifiers, departures: layered.departures });\n\n  const chrome = useSceneCanvasChrome({\n    source: {\n      getMode: getActiveMode, getFocused: props.getFocused, getModifiers: heldModifiers.get,\n      resizable: selectToolOpts?.resize?.resizable,\n      editingAnchors: () => pathEditState.getEditingId() !== '',\n      device: deviceProfile,\n    },\n    rules: { enabled, selectable, chromeVisibility: props.chromeVisibility },\n    hover: { canvasApiRef, nodeAtPointRef: getNodeAtPointRef, ...(props.onHover ? { onChange: props.onHover } : {}) },\n    selection: selection.current as readonly NodeId[], viewRef, dispatcher,\n  });\n\n  const { ingest, clipboard: ingestionClipboard } = useCanvasIngestion(adapter, () => actionsRegistry, props.ingestion);\n  const { views: addedViews, addView, viewAt, aimOf, setAim } = useAddedViews();\n  // The consumer's handle extends the primitive's with `ingest`, which needs the action stack.\n  const { handleRef, ready: canvasReady } = useSceneCanvasHandle({\n    ref, elementRef: internalCanvasRef, apiRef: canvasApiRef, onElement: chrome.trackHoverOn,\n    ingest, viewAnimation, camera, addView, viewAt, aimOf, setAim,\n  });\n  const viewInputs = useSurfaceViewInputs({ picking, selection, resizeHandles: layered.resizeHandles,\n    descriptor: descriptor as PoseDescriptor<unknown>, chromeCaps: chrome.chromeCaps, rotationBadge: layered.rotationBadge,\n  });\n\n  return (\n    <CanvasKitProviders viewInputs={viewInputs}>\n      <Canvas<TPose>\n        ref={handleRef} adapter={adapter} selection={selection} poseDescriptor={descriptor}\n        tools={tools.tools} layers={layered.layers}\n        // The chrome's bounds are the picker's: a node on a parallax plane is\n        // boxed where the plane draws it, and a `geometry.boundsOf` reaches both.\n        boundsOf={boundsOf} boundsOfPose={picking.boundsOfPose}\n        getIsVisible={chrome.getIsVisible}\n        // The gesture surface behind `helpersRef.getGestureBounds()` /\n        // `subscribeGestures()` — Canvas has no dispatcher of its own.\n        gestureSource={gestureSource}\n        previewPoseExtra={previewPoseExtra}\n        {...(debug !== undefined ? { debug: canvasDebug(debug) } : {})}\n        contentVersion={scene.getVersion} layerVisibility={props.layerVisibility} layerOrder={props.layerOrder}\n        viewState={viewState} redrawOn={redrawOn}\n        {...canvasPassThrough(props)}\n      />\n      <DevHuds\n        cursorCoords={props.cursorCoordsHud} pick={props.pickHud} modality={props.modalityHud}\n        canvasRef={internalCanvasRef} canvasApiRef={canvasApiRef}\n        detachedInput={props.paintInto ? props.inputElement ?? null : undefined}\n        viewRef={viewRef} pickEvery={picking.pickEvery} pickBest={picking.pickBest}\n      />\n      <SceneCanvasInput\n        props={props as SceneCanvasInputOptions} scene={scene as Scene<unknown, string, unknown>}\n        selection={selection} descriptor={descriptor as PoseDescriptor<unknown>}\n        picking={{ ...picking, adapter: adapter as unknown as BridgeAdapter }} nodeAtPointRef={getNodeAtPointRef}\n        tools={tools} viewOn={enabled.has('view')} camera={{ viewState, viewAnimation }}\n        dispatcher={dispatcher} pathEdit={{ state: pathEditState }}\n        chrome={chrome} overlay={layered} ingestionClipboard={ingestionClipboard} devtools={devtools}\n        canvas={{ elementRef: internalCanvasRef, apiRef: canvasApiRef, ready: canvasReady }} snapSources={enabled.snapSources} snapStore={layered.snapStore}\n      />\n      <SurfaceDeclarations views={props.views} entries={contributionEntries(tools.tools)} added={addedViews} />\n      {props.children}\n    </CanvasKitProviders>\n  );\n}\n\nconst SceneCanvasInnerForwardRef = forwardRef(SceneCanvasInner);\n\n// The canvas's input scope sits above `SceneCanvasInner`, whose own hooks\n// (`useTools` among them) must already read this canvas's tool and registries.\n// Its device profile too, so the canvas and everything under it share one.\n/** A scene canvas resolving its `features` through `source`. */\nexport function renderSceneCanvas<TData, TLayer extends string, TPose>(\n  source: PresetSource,\n  { device, ...props }: SceneCanvasProps<TData, TLayer, TPose>,\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return (\n    <InputScope yoke={props.yoke}>\n      <DeviceProfileProvider value={device}>\n        <ViewRegistryProvider>\n          <SceneCanvasInnerForwardRef {...(props as SceneCanvasProps<unknown, string, unknown>)} presetSource={source} ref={ref} />\n        </ViewRegistryProvider>\n      </DeviceProfileProvider>\n    </InputScope>\n  );\n}\n\nfunction SceneCanvasWrapper<TData, TLayer extends string, TPose>(\n  props: SceneCanvasProps<TData, TLayer, TPose>, ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return renderSceneCanvas(CORE_PRESET_SOURCE, props, ref);\n}\n\n// Marked pure so a bundle using only `LeanSceneCanvas` drops it, and core's named presets with it.\n/**\n * The canvas component: renders a `Scene` and wires the interaction stack\n * around it.\n *\n * Mounted bare it renders the scene, keeps a selection no input sets, and\n * runs a gesture dispatcher for whatever bindings the consumer adds. The\n * `features` presets turn the kit's behavior on — `features={['draw']}` is the\n * whole editor: tools, standard actions and their keys, selection chrome,\n * undo. This is the intended entry point; the lower-level primitives it\n * composes are not part of the public surface.\n *\n * Its ref exposes a `SceneCanvasApi` for the imperative operations that do not\n * fit a prop (view control, hit queries, redraw requests).\n */\nexport const SceneCanvas = /* @__PURE__ */ forwardRef(SceneCanvasWrapper) as <\n  TData, TLayer extends string, TPose,\n>(\n  props: SceneCanvasProps<TData, TLayer, TPose> & { ref?: React.Ref<SceneCanvasApi> },\n) => ReturnType<typeof SceneCanvasInner>;\n\nexport { DEFAULT_HANDLE_SIZE, BUILTIN_TOOL_IDS } from './SceneCanvas/props';\nexport {\n  BUILTIN_TOOLS, SELECT_TOOLS, VIEW_TOOLS, SHAPE_TOOLS, DRAW_TOOLS, TYPE_TOOLS, PAGE_TOOLS,\n} from './SceneCanvas/builtinToolSets';\nexport { mergeLayersWithDefaults } from './SceneCanvas/mergeLayers';\nexport type {\n  SceneCanvasProps, SceneCanvasHit, SceneCanvasLayers, SceneCanvasLongPress, BuiltinToolId,\n} from './SceneCanvas/props';\nexport type { CoordTraceEntry } from './SceneCanvas/coordTrace';\n"],"mappings":"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"}
+{"version":3,"file":"SceneCanvas.js","names":[],"sources":["../../src/canvas/SceneCanvas.tsx"],"sourcesContent":["/**\n * `<SceneCanvas>` — `<Canvas>` wired to a `Scene` primitive. Bare, it only renders: behavior\n * comes from the `features` presets (`canvas/SceneCanvas/features.ts`), each of which turns on\n * its own actions, tools, ambient bindings, and chrome.\n *\n * A consumer needing custom tools can pass `tools={useTools(...)}` and SceneCanvas forwards it\n * as-is — the internal tool registry is ignored in that case.\n */\nimport { getActiveModeFor } from '@weasel-js/modes';\nimport { useLatest } from '@weasel-js/react';\nimport { InputScope, useActionsRegistry } from '@weasel-js/routing/react';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { useCanvasCamera } from './SceneCanvas/useCanvasCamera';\nimport { useHeldModifiers } from './SceneCanvas/useHeldModifiers';\nimport { useCanvasIngestion } from 'domains/ingestion/useCanvasIngestion';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type React from 'react';\nimport { forwardRef, useEffect, useMemo, useRef } from 'react';\nimport { DeviceProfileProvider, useDeviceProfile } from '../core/device/useDeviceProfile';\nimport { Canvas } from './Canvas';\nimport { canvasDebug, DevHuds } from './SceneCanvas/DevHuds';\nimport { GestureReason } from './GestureReason';\nimport { CanvasKitProviders } from './SceneCanvas/CanvasKitProviders';\nimport { canvasPassThrough } from './SceneCanvas/canvasPassThrough';\nimport { SceneCanvasInput, type SceneCanvasInputOptions } from './SceneCanvas/SceneCanvasInput';\nimport type { PresetSource } from './SceneCanvas/features';\nimport { CORE_PRESET_SOURCE } from './SceneCanvas/namedPresets';\nimport type { BridgeAdapter, SceneCanvasProps } from './SceneCanvas/props';\nimport { useBakedScene } from './SceneCanvas/useBakedScene';\nimport { useCanvasDispatcher } from './SceneCanvas/useCanvasDispatcher';\nimport { publishPreviews } from './publishPreviews';\nimport { useCanvasSelection } from './SceneCanvas/useCanvasSelection';\nimport { useEnabledFeatures } from './SceneCanvas/useCanvasTools';\nimport { contributionEntries } from './SceneCanvas/useContributionRoles';\nimport { SurfaceDeclarations } from './SceneCanvas/SurfaceDeclarations';\nimport { useAddedViews, useSceneCanvasHandle } from './SceneCanvas/useSceneCanvasHandle';\nimport { useSceneCanvasLayers } from './SceneCanvas/useSceneCanvasLayers';\nimport { useSceneCanvasPathEdit } from './SceneCanvas/useSceneCanvasPathEdit';\nimport { useSceneCanvasTools, type SceneCanvasToolProps } from './SceneCanvas/useSceneCanvasTools';\nimport { useSceneCanvasChrome } from './SceneCanvas/useSceneChrome';\nimport { useDevtoolsOverride } from '../devtools/useDevtoolsRoot';\nimport { useSceneRedrawSources } from './SceneCanvas/useSceneRedrawSources';\nimport { useScenePicking } from './SceneCanvas/useScenePicking';\nimport { useGroupEntryContribution } from 'tools/builtin/select/groupEntry';\nimport { useNodeKinds } from './SceneCanvas/useNodeKinds';\nimport { DefaultTextEditDep, useCanvasTextEditor } from './SceneCanvas/defaultTextEditor';\nimport { useSurfaceViewInputs } from './SceneCanvas/useSurfaceViewInputs';\nimport type { CanvasExtensionApi, SceneCanvasApi } from './canvasExtension';\nimport { ViewRegistryProvider } from './viewRegistry';\nimport { useChromeColor } from './accentColor';\nimport { ENTERED_FRAME_COLOR, ENTERED_FRAME_TOKEN } from 'domains/selection/enteredGroupFrame';\nexport { SCENE_CANVAS_FEATURES, type Feature } from './SceneCanvas/features';\nexport type { BuiltinToolOptions } from './SceneCanvas/useBuiltinShapeTools';\nexport { defaultDrawOne } from './defaultDrawOne';\nexport { rotateAroundAABBCenter } from './poseRotation';\n\nfunction SceneCanvasInner<TData, TLayer extends string, TPose>(\n  props: SceneCanvasProps<TData, TLayer, TPose> & { presetSource: PresetSource },\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  const { selectTool: selectToolOpts, selectable = true, viewport, modes } = props;\n  const devtools = useDevtoolsOverride(props.debug), { debug } = devtools;\n  const descriptor = (props.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const deviceProfile = useDeviceProfile();\n  const scene = useBakedScene(props.scene);\n  const getActiveMode = useMemo(() => (modes ? getActiveModeFor(modes) : undefined), [modes]);\n  const heldModifiers = useHeldModifiers();\n\n  // Our own refs, so input listeners attach even when the consumer forwards its own ref.\n  const internalCanvasRef = useRef<HTMLElement | null>(null);\n  const canvasApiRef = useRef<CanvasExtensionApi | null>(null);\n  const declaredSize = useLatest({ width: props.width ?? 0, height: props.height ?? 0 });\n  const { viewState, viewAnimation, camera } = useCanvasCamera({\n    view: props.view, defaultView: props.defaultView, onViewChange: props.onViewChange, viewBounds: props.viewBounds,\n    dims: () => canvasApiRef.current?.getSurfaceRect() ?? declaredSize.current,\n    requestRedraw: () => { canvasApiRef.current?.requestRedraw(); },\n  });\n  const { viewRef } = viewState;\n  const kinds = useNodeKinds(scene, props.routing);\n  const selection = useCanvasSelection({ scene, props, selectable, kindOf: kinds.kindOf });\n  const enabled = useEnabledFeatures(\n    props.features, props.presetSource.named, viewport !== undefined, selectToolOpts?.rotate !== false,\n  );\n  const { pathEditState, selectToolWithDefaults } = useSceneCanvasPathEdit({\n    host: props.pathEdit, opening: props.defaultPathEdit, getActiveMode, scene, selection,\n    extensions: enabled.pathEdit, selectTool: selectToolOpts,\n  });\n  const picking = useScenePicking({ scene, selection, descriptor, props, viewRef, selectTool: selectToolWithDefaults, kinds });\n  const { adapter, boundsOf, planeOfNode } = picking;\n  const getNodeAtPointRef = useLatest(picking.getNodeAtPoint);\n  const groupEntry = useGroupEntryContribution({ pickHit: picking.pickBest, tree: adapter, boxOf: boundsOf });\n  const tools = useSceneCanvasTools({\n    props: props as SceneCanvasToolProps, select: picking.selectTool, move: picking.moveOptions,\n    enabled, presetSource: props.presetSource, groupEntry,\n  });\n\n  // The wrapper's `<InputScope>` provides it.\n  const actionsRegistry = useActionsRegistry();\n  const { dispatcher, gestureSource, previewIdsExtra, previewPoseExtra } = useCanvasDispatcher(actionsRegistry);\n  useEffect(() => publishPreviews(scene, dispatcher), [scene, dispatcher]);\n\n  const frameColor = useChromeColor(internalCanvasRef, ENTERED_FRAME_TOKEN, ENTERED_FRAME_COLOR);\n  const { editor: textEditor, layers } = useCanvasTextEditor(scene as Scene<TData, string, unknown>, internalCanvasRef, props);\n  const layered = useSceneCanvasLayers({\n    layers, presetLayers: enabled.layers, targetScale: deviceProfile.targetScale, scene, adapter, poseDescriptor: descriptor,\n    enteredGroup: picking.enteredGroup, frameColor, alphaFor: props.alphaFor, colorOverrides: props.animator?.colorOverrides, boundsOf, planeOfNode,\n    poseTransition: props.poseTransition, previewIds: previewIdsExtra, dispatcher, snapReadout: props.snap?.readout !== false, snapReadoutStyle: props.snap?.readoutStyle, pathEditState,\n    slops: debug !== undefined && debug !== false && debug.slops === true,\n    boundsIncludeStroke: props.geometry?.boundsIncludeStroke ?? true, selectTool: selectToolOpts,\n  });\n  const redrawOn = useSceneRedrawSources({ props, scene, heldModifiers, departures: layered.departures });\n\n  const chrome = useSceneCanvasChrome({\n    source: {\n      getMode: getActiveMode, getFocused: props.getFocused, getModifiers: heldModifiers.get,\n      resizable: selectToolOpts?.resize?.resizable,\n      editingAnchors: () => pathEditState.getEditingId() !== '',\n      device: deviceProfile,\n    },\n    rules: { enabled, selectable, chromeVisibility: props.chromeVisibility },\n    hover: { canvasApiRef, nodeAtPointRef: getNodeAtPointRef, ...(props.onHover ? { onChange: props.onHover } : {}) },\n    selection: selection.current as readonly NodeId[], viewRef, dispatcher,\n  });\n\n  const { ingest, clipboard: ingestionClipboard, handlers: ingestionHandlers } = useCanvasIngestion(adapter, () => actionsRegistry, props.ingestion);\n  const { views: addedViews, addView, viewAt, aimOf, setAim } = useAddedViews();\n  // The consumer's handle extends the primitive's with `ingest`, which needs the action stack.\n  const { handleRef, ready: canvasReady } = useSceneCanvasHandle({\n    ref, elementRef: internalCanvasRef, apiRef: canvasApiRef, onElement: chrome.trackHoverOn,\n    ingest, viewAnimation, camera, addView, viewAt, aimOf, setAim,\n  });\n  const viewInputs = useSurfaceViewInputs({ picking, selection, resizeHandles: layered.resizeHandles,\n    descriptor: descriptor as PoseDescriptor<unknown>, chromeCaps: chrome.chromeCaps, rotationBadge: layered.rotationBadge,\n  });\n\n  return (\n    <CanvasKitProviders viewInputs={viewInputs}>\n      <Canvas<TPose>\n        ref={handleRef} adapter={adapter} selection={selection} poseDescriptor={descriptor}\n        tools={tools.tools} layers={layered.layers}\n        // The chrome's bounds are the picker's: a node on a parallax plane is\n        // boxed where the plane draws it, and a `geometry.boundsOf` reaches both.\n        boundsOf={boundsOf} boundsOfPose={picking.boundsOfPose}\n        getIsVisible={chrome.getIsVisible}\n        // The gesture surface behind `helpersRef.getGestureBounds()` /\n        // `subscribeGestures()` — Canvas has no dispatcher of its own.\n        gestureSource={gestureSource}\n        previewPoseExtra={previewPoseExtra}\n        {...(debug !== undefined ? { debug: canvasDebug(debug) } : {})}\n        contentVersion={scene.getVersion} layerVisibility={props.layerVisibility} layerOrder={props.layerOrder}\n        viewState={viewState} redrawOn={redrawOn}\n        {...canvasPassThrough(props)}\n      />\n      <DevHuds\n        cursorCoords={props.cursorCoordsHud} pick={props.pickHud} modality={props.modalityHud}\n        canvasRef={internalCanvasRef} canvasApiRef={canvasApiRef}\n        detachedInput={props.paintInto ? props.inputElement ?? null : undefined}\n        viewRef={viewRef} pickEvery={picking.pickEvery} pickBest={picking.pickBest}\n      />\n      <GestureReason dispatcher={dispatcher} canvasRef={internalCanvasRef} viewRef={viewRef} />\n      <SceneCanvasInput\n        props={props as SceneCanvasInputOptions} scene={scene as Scene<unknown, string, unknown>}\n        selection={selection} descriptor={descriptor as PoseDescriptor<unknown>}\n        picking={{ ...picking, adapter: adapter as unknown as BridgeAdapter }} nodeAtPointRef={getNodeAtPointRef}\n        tools={tools} viewOn={enabled.has('view')} camera={{ viewState, viewAnimation }}\n        dispatcher={dispatcher} pathEdit={{ state: pathEditState }}\n        chrome={chrome} overlay={layered} ingestionClipboard={ingestionClipboard} ingestionHandlers={ingestionHandlers} devtools={devtools}\n        canvas={{ elementRef: internalCanvasRef, apiRef: canvasApiRef, ready: canvasReady }} snapSources={enabled.snapSources} snapStore={layered.snapStore}\n      />\n      <SurfaceDeclarations views={props.views} entries={contributionEntries(tools.tools)} added={addedViews} />\n      <DefaultTextEditDep editor={textEditor} onDoubleClick={enabled.has('edit')} />\n      {props.children}\n    </CanvasKitProviders>\n  );\n}\n\nconst SceneCanvasInnerForwardRef = forwardRef(SceneCanvasInner);\n\n// The canvas's input scope sits above `SceneCanvasInner`, whose own hooks\n// (`useTools` among them) must already read this canvas's tool and registries.\n// Its device profile too, so the canvas and everything under it share one.\n/** A scene canvas resolving its `features` through `source`. */\nexport function renderSceneCanvas<TData, TLayer extends string, TPose>(\n  source: PresetSource,\n  { device, ...props }: SceneCanvasProps<TData, TLayer, TPose>,\n  ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return (\n    <InputScope yoke={props.yoke}>\n      <DeviceProfileProvider value={device}>\n        <ViewRegistryProvider>\n          <SceneCanvasInnerForwardRef {...(props as SceneCanvasProps<unknown, string, unknown>)} presetSource={source} ref={ref} />\n        </ViewRegistryProvider>\n      </DeviceProfileProvider>\n    </InputScope>\n  );\n}\n\nfunction SceneCanvasWrapper<TData, TLayer extends string, TPose>(\n  props: SceneCanvasProps<TData, TLayer, TPose>, ref: React.ForwardedRef<SceneCanvasApi>,\n) {\n  return renderSceneCanvas(CORE_PRESET_SOURCE, props, ref);\n}\n\n// Marked pure so a bundle using only `LeanSceneCanvas` drops it, and core's named presets with it.\n/**\n * The canvas component: renders a `Scene` and wires the interaction stack\n * around it.\n *\n * Mounted bare it renders the scene, keeps a selection no input sets, and\n * runs a gesture dispatcher for whatever bindings the consumer adds. The\n * `features` presets turn the kit's behavior on — `features={['draw']}` is the\n * whole editor: tools, standard actions and their keys, selection chrome,\n * undo. This is the intended entry point; the lower-level primitives it\n * composes are not part of the public surface.\n *\n * Its ref exposes a `SceneCanvasApi` for the imperative operations that do not\n * fit a prop (view control, hit queries, redraw requests).\n */\nexport const SceneCanvas = /* @__PURE__ */ forwardRef(SceneCanvasWrapper) as <\n  TData, TLayer extends string, TPose,\n>(\n  props: SceneCanvasProps<TData, TLayer, TPose> & { ref?: React.Ref<SceneCanvasApi> },\n) => ReturnType<typeof SceneCanvasInner>;\n\nexport { DEFAULT_HANDLE_SIZE, BUILTIN_TOOL_IDS } from './SceneCanvas/props';\nexport {\n  BUILTIN_TOOLS, BUILTIN_TOOL_GROUPS, TOOL_GROUP_ORDER,\n  SELECT_TOOLS, VIEW_TOOLS, SHAPE_TOOLS, DRAW_TOOLS, TYPE_TOOLS, PAGE_TOOLS,\n} from './SceneCanvas/builtinToolSets';\nexport { mergeLayersWithDefaults } from './SceneCanvas/mergeLayers';\nexport type {\n  SceneCanvasProps, SceneCanvasHit, SceneCanvasLayers, SceneCanvasLongPress, BuiltinToolId,\n} from './SceneCanvas/props';\nexport type { CoordTraceEntry } from './SceneCanvas/coordTrace';\n"],"mappings":"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"}

package/dist/canvas/SceneViewCanvas.js

@@ -54,6 +54,7 @@ function SceneViewCanvasInner(props) {
 		onCommit: "paint"
 	});
 	useEffect(() => scene.overrides.subscribe(requestRedraw), [scene, requestRedraw]);
+	useEffect(() => scene.scroll?.subscribe(requestRedraw), [scene, requestRedraw]);
 	useEffect(() => animator?.onTick(requestRedraw), [animator, requestRedraw]);
 	return /* @__PURE__ */ jsx(SurfaceCanvas, {
 		ref: setCanvasRef,

package/dist/canvas/SceneViewCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneViewCanvas.js","names":[],"sources":["../../src/canvas/SceneViewCanvas.tsx"],"sourcesContent":["/**\n * `<SceneViewCanvas>` — pointer-inert, read-only render of a `Scene` at a\n * given `View` into its own `<canvas>` DOM element.\n *\n * It paints through `useFrameLoop` rather than from React: a render and an\n * override commit both just mark the surface dirty. The mount paint is\n * synchronous, so the first frame the user sees is the scene, and nothing\n * paints while the canvas is off screen or the tab is hidden.\n */\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\nimport type { Ref } from 'react';\nimport { assignRef } from '@weasel-js/react';\nimport { useCanvasSurface } from './useCanvasSurface';\nimport type { CanvasRendererLease } from './canvasRenderer';\nimport { SurfaceCanvas } from './SurfaceCanvas';\nimport { useSurfaceSize, type SurfaceSizeProps } from './useSurfaceSize';\nimport { sceneViewFrame } from './sceneViewRender';\nimport type { RenderSceneToCanvasArgs, SceneViewDrawOne, SceneViewLayers } from './sceneViewRender';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { normalizeView, type View } from '../core/viewport/view';\nimport type { Scene } from '../core/scene/types';\nimport type { Animator } from '@weasel-js/animator';\n\n/** Props for `<SceneViewCanvas>`. */\nexport interface SceneViewCanvasProps<TData, TLayer extends string, TPose> extends SurfaceSizeProps {\n  /** Scene to render. The component subscribes to it and repaints when it\n   *  changes. */\n  scene: Scene<TData, TLayer, TPose>;\n  /** Camera. Applied to scene + `extraCommands` via the renderer's group\n   *  transform. */\n  view: View;\n  /** Per-node draw callback. See `SceneViewDrawOne`. The consumer is\n   *  responsible for what gets painted — there is no AABB-fill default. */\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>;\n  /** Optional extra commands appended after scene commands, inside the same\n   *  view transform — a world-space annotation over the scene. */\n  extraCommands?: ReadonlyArray<DrawCommand>;\n  /** Optional per-id alpha multiplier, mirroring `<SceneCanvas>`'s scene-slot\n   *  `alphaFor`. Pass the same function the main canvas uses to keep a\n   *  scoping-dim treatment consistent across both. Defaults to `() => 1`. */\n  alphaFor?: (id: string) => number;\n  /** Hide scene layers in this view only, keyed `scene:<layerId>` as on\n   *  `<SceneCanvas>` — pass the main canvas's map to keep the two in step. */\n  layerVisibility?: SceneViewLayers['layerVisibility'];\n  /** Paint order for this view, keyed as `layerVisibility`. */\n  layerOrder?: SceneViewLayers['layerOrder'];\n  /** Skip nodes and commands that cannot reach this view — the scene slot's\n   *  `cull`. Off by default; worth it when the view shows a small part of a\n   *  large scene. */\n  cull?: boolean;\n  /** Where `drawOne`'s output for a node can reach — the scene slot's\n   *  `paintBounds`. Defaults to `defaultPaintBounds` when `drawOne` is\n   *  `defaultDrawOne`. */\n  paintBounds?: RenderSceneToCanvasArgs<TData, TLayer, TPose>['paintBounds'];\n  /** Optional animator, as on `<SceneCanvas>`: the view repaints on its ticks\n   *  and paints its `colorOverrides`. Pass the main canvas's animator so both\n   *  show the same colors. */\n  animator?: Animator;\n  /** Optional CSS class for the `<canvas>`. Its size is `width` × `height`\n   *  unless a rule on this class sizes it. */\n  className?: string;\n  /** Forwarded ref to the underlying `<canvas>`. Consumers attach their own\n   *  pointer listeners or call `toBlob` for snapshots through this. */\n  canvasRef?: Ref<HTMLCanvasElement>;\n}\n\nfunction SceneViewCanvasInner<TData, TLayer extends string, TPose>(\n  props: SceneViewCanvasProps<TData, TLayer, TPose>,\n) {\n  const {\n    scene, drawOne, extraCommands, alphaFor, layerVisibility, layerOrder,\n    animator, className, canvasRef, cull, paintBounds,\n  } = props;\n  const view = normalizeView(props.view);\n\n  // Subscribe to scene version. The snapshot value isn't used directly —\n  // we only need React to re-render the component when the scene mutates.\n  useSyncExternalStore(scene.subscribe, scene.getVersion, scene.getVersion);\n\n  const localRef = useRef<HTMLCanvasElement | null>(null);\n\n  const setCanvasRef = useCallback((el: HTMLCanvasElement | null): void => {\n    localRef.current = el;\n    assignRef(canvasRef, el);\n  }, [canvasRef]);\n  const { width, height } = useSurfaceSize(props, localRef);\n\n  const paint = (lease: CanvasRendererLease): boolean => {\n    const canvas = localRef.current;\n    if (!canvas || width === 0 || height === 0) return false;\n    const commands = sceneViewFrame({\n      scene,\n      view,\n      width,\n      height,\n      drawOne,\n      extraCommands: extraCommands as DrawCommand[] | undefined,\n      alphaFor,\n      layerVisibility,\n      layerOrder,\n      colorOverrides: animator?.colorOverrides,\n      cull,\n      paintBounds,\n    });\n    return lease.paint(canvas, commands, view, { width, height });\n  };\n  const { requestRedraw } = useCanvasSurface(paint, { target: localRef, onCommit: 'paint' });\n\n  // Override writes never bump the scene version, so the version subscription\n  // above cannot see them.\n  useEffect(() => scene.overrides.subscribe(requestRedraw), [scene, requestRedraw]);\n  useEffect(() => animator?.onTick(requestRedraw), [animator, requestRedraw]);\n\n  return (\n    <SurfaceCanvas\n      ref={setCanvasRef}\n      width={props.width}\n      height={props.height}\n      className={className}\n    />\n  );\n}\n\n/**\n * Pointer-inert read-only scene view. It attaches no event listeners;\n * consumers attach their own through `canvasRef`, a plain prop because\n * `forwardRef` erases the component's generics. `width` and `height` are CSS\n * pixels and size the drawing buffer; a `className` rule that sizes the\n * element stretches that buffer to fit. Given neither, it fills its parent.\n */\nexport const SceneViewCanvas = SceneViewCanvasInner;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuEA,SAAS,qBACP,OACA;CACA,MAAM,EACJ,OAAO,SAAS,eAAe,UAAU,iBAAiB,YAC1D,UAAU,WAAW,WAAW,MAAM,gBACpC;CACJ,MAAM,OAAO,cAAc,MAAM,IAAI;CAIrC,qBAAqB,MAAM,WAAW,MAAM,YAAY,MAAM,UAAU;CAExE,MAAM,WAAW,OAAiC,IAAI;CAEtD,MAAM,eAAe,aAAa,OAAuC;EACvE,SAAS,UAAU;EACnB,UAAU,WAAW,EAAE;CACzB,GAAG,CAAC,SAAS,CAAC;CACd,MAAM,EAAE,OAAO,WAAW,eAAe,OAAO,QAAQ;CAExD,MAAM,SAAS,UAAwC;EACrD,MAAM,SAAS,SAAS;EACxB,IAAI,CAAC,UAAU,UAAU,KAAK,WAAW,GAAG,OAAO;EACnD,MAAM,WAAW,eAAe;GAC9B;GACA;GACA;GACA;GACA;GACe;GACf;GACA;GACA;GACA,gBAAgB,UAAU;GAC1B;GACA;EACF,CAAC;EACD,OAAO,MAAM,MAAM,QAAQ,UAAU,MAAM;GAAE;GAAO;EAAO,CAAC;CAC9D;CACA,MAAM,EAAE,kBAAkB,iBAAiB,OAAO;EAAE,QAAQ;EAAU,UAAU;CAAQ,CAAC;CAIzF,gBAAgB,MAAM,UAAU,UAAU,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC;CAChF,gBAAgB,UAAU,OAAO,aAAa,GAAG,CAAC,UAAU,aAAa,CAAC;CAE1E,OACE,oBAAC,eAAD;EACE,KAAK;EACL,OAAO,MAAM;EACb,QAAQ,MAAM;EACH;CACZ,CAAA;AAEL;;;;;;;;AASA,IAAa,kBAAkB"}
+{"version":3,"file":"SceneViewCanvas.js","names":[],"sources":["../../src/canvas/SceneViewCanvas.tsx"],"sourcesContent":["/**\n * `<SceneViewCanvas>` — pointer-inert, read-only render of a `Scene` at a\n * given `View` into its own `<canvas>` DOM element.\n *\n * It paints through `useFrameLoop` rather than from React: a render and an\n * override commit both just mark the surface dirty. The mount paint is\n * synchronous, so the first frame the user sees is the scene, and nothing\n * paints while the canvas is off screen or the tab is hidden.\n */\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\nimport type { Ref } from 'react';\nimport { assignRef } from '@weasel-js/react';\nimport { useCanvasSurface } from './useCanvasSurface';\nimport type { CanvasRendererLease } from './canvasRenderer';\nimport { SurfaceCanvas } from './SurfaceCanvas';\nimport { useSurfaceSize, type SurfaceSizeProps } from './useSurfaceSize';\nimport { sceneViewFrame } from './sceneViewRender';\nimport type { RenderSceneToCanvasArgs, SceneViewDrawOne, SceneViewLayers } from './sceneViewRender';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport { normalizeView, type View } from '../core/viewport/view';\nimport type { Scene } from '../core/scene/types';\nimport type { Animator } from '@weasel-js/animator';\n\n/** Props for `<SceneViewCanvas>`. */\nexport interface SceneViewCanvasProps<TData, TLayer extends string, TPose> extends SurfaceSizeProps {\n  /** Scene to render. The component subscribes to it and repaints when it\n   *  changes. */\n  scene: Scene<TData, TLayer, TPose>;\n  /** Camera. Applied to scene + `extraCommands` via the renderer's group\n   *  transform. */\n  view: View;\n  /** Per-node draw callback. See `SceneViewDrawOne`. The consumer is\n   *  responsible for what gets painted — there is no AABB-fill default. */\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>;\n  /** Optional extra commands appended after scene commands, inside the same\n   *  view transform — a world-space annotation over the scene. */\n  extraCommands?: ReadonlyArray<DrawCommand>;\n  /** Optional per-id alpha multiplier, mirroring `<SceneCanvas>`'s scene-slot\n   *  `alphaFor`. Pass the same function the main canvas uses to keep a\n   *  scoping-dim treatment consistent across both. Defaults to `() => 1`. */\n  alphaFor?: (id: string) => number;\n  /** Hide scene layers in this view only, keyed `scene:<layerId>` as on\n   *  `<SceneCanvas>` — pass the main canvas's map to keep the two in step. */\n  layerVisibility?: SceneViewLayers['layerVisibility'];\n  /** Paint order for this view, keyed as `layerVisibility`. */\n  layerOrder?: SceneViewLayers['layerOrder'];\n  /** Skip nodes and commands that cannot reach this view — the scene slot's\n   *  `cull`. Off by default; worth it when the view shows a small part of a\n   *  large scene. */\n  cull?: boolean;\n  /** Where `drawOne`'s output for a node can reach — the scene slot's\n   *  `paintBounds`. Defaults to `defaultPaintBounds` when `drawOne` is\n   *  `defaultDrawOne`. */\n  paintBounds?: RenderSceneToCanvasArgs<TData, TLayer, TPose>['paintBounds'];\n  /** Optional animator, as on `<SceneCanvas>`: the view repaints on its ticks\n   *  and paints its `colorOverrides`. Pass the main canvas's animator so both\n   *  show the same colors. */\n  animator?: Animator;\n  /** Optional CSS class for the `<canvas>`. Its size is `width` × `height`\n   *  unless a rule on this class sizes it. */\n  className?: string;\n  /** Forwarded ref to the underlying `<canvas>`. Consumers attach their own\n   *  pointer listeners or call `toBlob` for snapshots through this. */\n  canvasRef?: Ref<HTMLCanvasElement>;\n}\n\nfunction SceneViewCanvasInner<TData, TLayer extends string, TPose>(\n  props: SceneViewCanvasProps<TData, TLayer, TPose>,\n) {\n  const {\n    scene, drawOne, extraCommands, alphaFor, layerVisibility, layerOrder,\n    animator, className, canvasRef, cull, paintBounds,\n  } = props;\n  const view = normalizeView(props.view);\n\n  // Subscribe to scene version. The snapshot value isn't used directly —\n  // we only need React to re-render the component when the scene mutates.\n  useSyncExternalStore(scene.subscribe, scene.getVersion, scene.getVersion);\n\n  const localRef = useRef<HTMLCanvasElement | null>(null);\n\n  const setCanvasRef = useCallback((el: HTMLCanvasElement | null): void => {\n    localRef.current = el;\n    assignRef(canvasRef, el);\n  }, [canvasRef]);\n  const { width, height } = useSurfaceSize(props, localRef);\n\n  const paint = (lease: CanvasRendererLease): boolean => {\n    const canvas = localRef.current;\n    if (!canvas || width === 0 || height === 0) return false;\n    const commands = sceneViewFrame({\n      scene,\n      view,\n      width,\n      height,\n      drawOne,\n      extraCommands: extraCommands as DrawCommand[] | undefined,\n      alphaFor,\n      layerVisibility,\n      layerOrder,\n      colorOverrides: animator?.colorOverrides,\n      cull,\n      paintBounds,\n    });\n    return lease.paint(canvas, commands, view, { width, height });\n  };\n  const { requestRedraw } = useCanvasSurface(paint, { target: localRef, onCommit: 'paint' });\n\n  // Override writes never bump the scene version, so the version subscription\n  // above cannot see them.\n  useEffect(() => scene.overrides.subscribe(requestRedraw), [scene, requestRedraw]);\n  useEffect(() => scene.scroll?.subscribe(requestRedraw), [scene, requestRedraw]);\n  useEffect(() => animator?.onTick(requestRedraw), [animator, requestRedraw]);\n\n  return (\n    <SurfaceCanvas\n      ref={setCanvasRef}\n      width={props.width}\n      height={props.height}\n      className={className}\n    />\n  );\n}\n\n/**\n * Pointer-inert read-only scene view. It attaches no event listeners;\n * consumers attach their own through `canvasRef`, a plain prop because\n * `forwardRef` erases the component's generics. `width` and `height` are CSS\n * pixels and size the drawing buffer; a `className` rule that sizes the\n * element stretches that buffer to fit. Given neither, it fills its parent.\n */\nexport const SceneViewCanvas = SceneViewCanvasInner;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuEA,SAAS,qBACP,OACA;CACA,MAAM,EACJ,OAAO,SAAS,eAAe,UAAU,iBAAiB,YAC1D,UAAU,WAAW,WAAW,MAAM,gBACpC;CACJ,MAAM,OAAO,cAAc,MAAM,IAAI;CAIrC,qBAAqB,MAAM,WAAW,MAAM,YAAY,MAAM,UAAU;CAExE,MAAM,WAAW,OAAiC,IAAI;CAEtD,MAAM,eAAe,aAAa,OAAuC;EACvE,SAAS,UAAU;EACnB,UAAU,WAAW,EAAE;CACzB,GAAG,CAAC,SAAS,CAAC;CACd,MAAM,EAAE,OAAO,WAAW,eAAe,OAAO,QAAQ;CAExD,MAAM,SAAS,UAAwC;EACrD,MAAM,SAAS,SAAS;EACxB,IAAI,CAAC,UAAU,UAAU,KAAK,WAAW,GAAG,OAAO;EACnD,MAAM,WAAW,eAAe;GAC9B;GACA;GACA;GACA;GACA;GACe;GACf;GACA;GACA;GACA,gBAAgB,UAAU;GAC1B;GACA;EACF,CAAC;EACD,OAAO,MAAM,MAAM,QAAQ,UAAU,MAAM;GAAE;GAAO;EAAO,CAAC;CAC9D;CACA,MAAM,EAAE,kBAAkB,iBAAiB,OAAO;EAAE,QAAQ;EAAU,UAAU;CAAQ,CAAC;CAIzF,gBAAgB,MAAM,UAAU,UAAU,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC;CAChF,gBAAgB,MAAM,QAAQ,UAAU,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC;CAC9E,gBAAgB,UAAU,OAAO,aAAa,GAAG,CAAC,UAAU,aAAa,CAAC;CAE1E,OACE,oBAAC,eAAD;EACE,KAAK;EACL,OAAO,MAAM;EACb,QAAQ,MAAM;EACH;CACZ,CAAA;AAEL;;;;;;;;AASA,IAAa,kBAAkB"}

package/dist/canvas/ViewMarker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewMarker.js","names":[],"sources":["../../src/canvas/ViewMarker.tsx"],"sourcesContent":["/**\n * `<ViewMarker>` — one view's aim, outlined inside another view's frame: a\n * minimap's indicator, a picture-in-picture's footprint on the main view.\n */\nimport { useCallback, useEffect } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ViewMarkerProps } from 'features/viewports/viewMarker';\nimport { useOptionalViewRegistry } from './viewRegistry';\n\n/**\n * Draws one view's aim inside another's frame, after that view's own layers.\n *\n * Renders nothing; outside a surface it is inert. Either view may mount after\n * the marker does: until both are there it draws nothing.\n */\nexport function ViewMarker(props: ViewMarkerProps): null {\n  const registry = useOptionalViewRegistry();\n  const live = useLatest(props);\n  const read = useCallback(() => live.current, [live]);\n  const { id, target } = props;\n\n  // Which stack the marker is listed in, and its layer's id, are fixed at\n  // registration; everything else is read off `live` at draw time.\n  useEffect(() => registry?.registerMarker(read), [registry, read, id, target]);\n\n  useEffect(() => {\n    registry?.surface()?.requestRedraw();\n  });\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,WAAW,OAA8B;CACvD,MAAM,WAAW,wBAAwB;CACzC,MAAM,OAAO,UAAU,KAAK;CAC5B,MAAM,OAAO,kBAAkB,KAAK,SAAS,CAAC,IAAI,CAAC;CACnD,MAAM,EAAE,IAAI,WAAW;CAIvB,gBAAgB,UAAU,eAAe,IAAI,GAAG;EAAC;EAAU;EAAM;EAAI;CAAM,CAAC;CAE5E,gBAAgB;EACd,UAAU,QAAQ,CAAC,EAAE,cAAc;CACrC,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"ViewMarker.js","names":[],"sources":["../../src/canvas/ViewMarker.tsx"],"sourcesContent":["/**\n * `<ViewMarker>` — one view's aim, outlined inside another view's frame: a\n * minimap's indicator, a picture-in-picture's footprint on the main view.\n */\nimport { useCallback, useEffect } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ViewMarkerProps } from 'domains/viewports/viewMarker';\nimport { useOptionalViewRegistry } from './viewRegistry';\n\n/**\n * Draws one view's aim inside another's frame, after that view's own layers.\n *\n * Renders nothing; outside a surface it is inert. Either view may mount after\n * the marker does: until both are there it draws nothing.\n */\nexport function ViewMarker(props: ViewMarkerProps): null {\n  const registry = useOptionalViewRegistry();\n  const live = useLatest(props);\n  const read = useCallback(() => live.current, [live]);\n  const { id, target } = props;\n\n  // Which stack the marker is listed in, and its layer's id, are fixed at\n  // registration; everything else is read off `live` at draw time.\n  useEffect(() => registry?.registerMarker(read), [registry, read, id, target]);\n\n  useEffect(() => {\n    registry?.surface()?.requestRedraw();\n  });\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,WAAW,OAA8B;CACvD,MAAM,WAAW,wBAAwB;CACzC,MAAM,OAAO,UAAU,KAAK;CAC5B,MAAM,OAAO,kBAAkB,KAAK,SAAS,CAAC,IAAI,CAAC;CACnD,MAAM,EAAE,IAAI,WAAW;CAIvB,gBAAgB,UAAU,eAAe,IAAI,GAAG;EAAC;EAAU;EAAM;EAAI;CAAM,CAAC;CAE5E,gBAAgB;EACd,UAAU,QAAQ,CAAC,EAAE,cAAc;CACrC,CAAC;CAED,OAAO;AACT"}

package/dist/canvas/accentColor.js

@@ -1,3 +1,5 @@
+import { useMemo } from "react";
+
 //#region src/canvas/accentColor.ts
 /** The accent canvas chrome paints in when the element sits under no theme. */
 var FALLBACK_ACCENT = "#4c8dff";
@@ -29,7 +31,18 @@ function watchThemeOf(el, fn) {
 		scheme?.removeEventListener?.("change", fn);
 	};
 }
+/** The color `name` on the element `ref` holds, read when asked, and how to hear it may have changed. */
+function useChromeColor(ref, name, fallback) {
+	return useMemo(() => ({
+		read: () => chromeColorOf(ref.current, name, fallback),
+		changed: (fn) => watchThemeOf(() => ref.current, fn)
+	}), [
+		ref,
+		name,
+		fallback
+	]);
+}
 
 //#endregion
-export { FALLBACK_ACCENT, accentColorOf, chromeColorOf, watchThemeOf };
+export { FALLBACK_ACCENT, accentColorOf, chromeColorOf, useChromeColor, watchThemeOf };
 //# sourceMappingURL=accentColor.js.map

package/dist/canvas/accentColor.js.map

@@ -1 +1 @@
-{"version":3,"file":"accentColor.js","names":[],"sources":["../../src/canvas/accentColor.ts"],"sourcesContent":["/** The accent canvas chrome paints in when the element sits under no theme. */\nexport const FALLBACK_ACCENT = '#4c8dff';\n\n/** Read the color custom property `name` off `el`, where the theme cascade lands on a canvas. */\nexport function chromeColorOf(el: Element | null | undefined, name: `--${string}`, fallback: string): string {\n  if (!el || typeof getComputedStyle !== 'function') return fallback;\n  return getComputedStyle(el).getPropertyValue(name).trim() || fallback;\n}\n\n/** Read `--wzl-accent` off `el`, where the theme cascade lands on a canvas. */\nexport function accentColorOf(el: Element | null | undefined): string {\n  return chromeColorOf(el, '--wzl-accent', FALLBACK_ACCENT);\n}\n\nconst THEME_ATTRIBUTE = /^(data-wzl-|class$)/;\n\n/**\n * Hear that the colors read off an element may have changed: a theme, mode or class attribute\n * changing on it or anything above it, or the system color scheme flipping. `el` is read when\n * this is called; with none yet, the document root is watched. Returns the stop.\n */\nexport function watchThemeOf(el: () => Element | null | undefined, fn: () => void): () => void {\n  if (typeof MutationObserver !== 'function' || typeof document === 'undefined') return () => {};\n  const observer = new MutationObserver((records) => {\n    if (records.some((r) => r.attributeName !== null && THEME_ATTRIBUTE.test(r.attributeName))) fn();\n  });\n  for (let node: Element | null = el() ?? document.documentElement; node; node = node.parentElement) {\n    observer.observe(node, { attributes: true });\n  }\n  const scheme = typeof matchMedia === 'function' ? matchMedia('(prefers-color-scheme: dark)') : null;\n  scheme?.addEventListener?.('change', fn);\n  return () => {\n    observer.disconnect();\n    scheme?.removeEventListener?.('change', fn);\n  };\n}\n"],"mappings":";;AACA,IAAa,kBAAkB;;AAG/B,SAAgB,cAAc,IAAgC,MAAqB,UAA0B;CAC3G,IAAI,CAAC,MAAM,OAAO,qBAAqB,YAAY,OAAO;CAC1D,OAAO,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,KAAK;AAC/D;;AAGA,SAAgB,cAAc,IAAwC;CACpE,OAAO,cAAc,IAAI,gBAAgB,eAAe;AAC1D;AAEA,IAAM,kBAAkB;;;;;;AAOxB,SAAgB,aAAa,IAAsC,IAA4B;CAC7F,IAAI,OAAO,qBAAqB,cAAc,OAAO,aAAa,aAAa,aAAa,CAAC;CAC7F,MAAM,WAAW,IAAI,kBAAkB,YAAY;EACjD,IAAI,QAAQ,MAAM,MAAM,EAAE,kBAAkB,QAAQ,gBAAgB,KAAK,EAAE,aAAa,CAAC,GAAG,GAAG;CACjG,CAAC;CACD,KAAK,IAAI,OAAuB,GAAG,KAAK,SAAS,iBAAiB,MAAM,OAAO,KAAK,eAClF,SAAS,QAAQ,MAAM,EAAE,YAAY,KAAK,CAAC;CAE7C,MAAM,SAAS,OAAO,eAAe,aAAa,WAAW,8BAA8B,IAAI;CAC/F,QAAQ,mBAAmB,UAAU,EAAE;CACvC,aAAa;EACX,SAAS,WAAW;EACpB,QAAQ,sBAAsB,UAAU,EAAE;CAC5C;AACF"}
+{"version":3,"file":"accentColor.js","names":[],"sources":["../../src/canvas/accentColor.ts"],"sourcesContent":["import { useMemo, type RefObject } from 'react';\n\n/** The accent canvas chrome paints in when the element sits under no theme. */\nexport const FALLBACK_ACCENT = '#4c8dff';\n\n/** Read the color custom property `name` off `el`, where the theme cascade lands on a canvas. */\nexport function chromeColorOf(el: Element | null | undefined, name: `--${string}`, fallback: string): string {\n  if (!el || typeof getComputedStyle !== 'function') return fallback;\n  return getComputedStyle(el).getPropertyValue(name).trim() || fallback;\n}\n\n/** Read `--wzl-accent` off `el`, where the theme cascade lands on a canvas. */\nexport function accentColorOf(el: Element | null | undefined): string {\n  return chromeColorOf(el, '--wzl-accent', FALLBACK_ACCENT);\n}\n\nconst THEME_ATTRIBUTE = /^(data-wzl-|class$)/;\n\n/**\n * Hear that the colors read off an element may have changed: a theme, mode or class attribute\n * changing on it or anything above it, or the system color scheme flipping. `el` is read when\n * this is called; with none yet, the document root is watched. Returns the stop.\n */\nexport function watchThemeOf(el: () => Element | null | undefined, fn: () => void): () => void {\n  if (typeof MutationObserver !== 'function' || typeof document === 'undefined') return () => {};\n  const observer = new MutationObserver((records) => {\n    if (records.some((r) => r.attributeName !== null && THEME_ATTRIBUTE.test(r.attributeName))) fn();\n  });\n  for (let node: Element | null = el() ?? document.documentElement; node; node = node.parentElement) {\n    observer.observe(node, { attributes: true });\n  }\n  const scheme = typeof matchMedia === 'function' ? matchMedia('(prefers-color-scheme: dark)') : null;\n  scheme?.addEventListener?.('change', fn);\n  return () => {\n    observer.disconnect();\n    scheme?.removeEventListener?.('change', fn);\n  };\n}\n\n/** The color `name` on the element `ref` holds, read when asked, and how to hear it may have changed. */\nexport function useChromeColor(\n  ref: RefObject<Element | null>, name: `--${string}`, fallback: string,\n): { read: () => string; changed: (fn: () => void) => () => void } {\n  return useMemo(() => ({\n    read: () => chromeColorOf(ref.current, name, fallback),\n    changed: (fn: () => void) => watchThemeOf(() => ref.current, fn),\n  }), [ref, name, fallback]);\n}\n"],"mappings":";;;;AAGA,IAAa,kBAAkB;;AAG/B,SAAgB,cAAc,IAAgC,MAAqB,UAA0B;CAC3G,IAAI,CAAC,MAAM,OAAO,qBAAqB,YAAY,OAAO;CAC1D,OAAO,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,KAAK;AAC/D;;AAGA,SAAgB,cAAc,IAAwC;CACpE,OAAO,cAAc,IAAI,gBAAgB,eAAe;AAC1D;AAEA,IAAM,kBAAkB;;;;;;AAOxB,SAAgB,aAAa,IAAsC,IAA4B;CAC7F,IAAI,OAAO,qBAAqB,cAAc,OAAO,aAAa,aAAa,aAAa,CAAC;CAC7F,MAAM,WAAW,IAAI,kBAAkB,YAAY;EACjD,IAAI,QAAQ,MAAM,MAAM,EAAE,kBAAkB,QAAQ,gBAAgB,KAAK,EAAE,aAAa,CAAC,GAAG,GAAG;CACjG,CAAC;CACD,KAAK,IAAI,OAAuB,GAAG,KAAK,SAAS,iBAAiB,MAAM,OAAO,KAAK,eAClF,SAAS,QAAQ,MAAM,EAAE,YAAY,KAAK,CAAC;CAE7C,MAAM,SAAS,OAAO,eAAe,aAAa,WAAW,8BAA8B,IAAI;CAC/F,QAAQ,mBAAmB,UAAU,EAAE;CACvC,aAAa;EACX,SAAS,WAAW;EACpB,QAAQ,sBAAsB,UAAU,EAAE;CAC5C;AACF;;AAGA,SAAgB,eACd,KAAgC,MAAqB,UACY;CACjE,OAAO,eAAe;EACpB,YAAY,cAAc,IAAI,SAAS,MAAM,QAAQ;EACrD,UAAU,OAAmB,mBAAmB,IAAI,SAAS,EAAE;CACjE,IAAI;EAAC;EAAK;EAAM;CAAQ,CAAC;AAC3B"}

package/dist/canvas/affordanceAt.js

@@ -94,8 +94,8 @@ function toAffordanceHit(hit) {
 *   `doubleClick`, classified the same way.
 */
 function buildClassifyTarget(getSelection, pickBest, kindOfNode, doubleClickNames) {
-	return function classifyTarget({ x: wx, y: wy }) {
-		const hitId = pickBest(wx, wy);
+	return function classifyTarget(world) {
+		const hitId = pickBest(world);
 		if (!hitId) return { body: "empty" };
 		const sel = getSelection();
 		const classify = (id) => ({