@weasel-js/core 1.15.0 → 1.15.1

package/dist/canvas/SceneCanvas/useContributionRoles.js

@@ -5,7 +5,7 @@ import { useEffect, useRef } from "react";
 import { isDev } from "@weasel-js/react";
 import { useActionsRegistry, useMenuHost, useOffhandAction, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useContributionRoles.ts
+// src/canvas/SceneCanvas/useContributionRoles.ts
 /**
 * `useContributionRoles` — installs the roles of every entry in the tools
 * registry that a surface owns rather than the dispatcher: its actions into the
@@ -138,6 +138,5 @@ function registerDeps(depRegistry, deps) {
 	};
 }
 
-//#endregion
 export { contributionEntries, useContributionRoles };
 //# sourceMappingURL=useContributionRoles.js.map

package/dist/canvas/SceneCanvas/useDepartureGhostLayer.js

@@ -1,13 +1,13 @@
-import { deriveParallaxView } from "../../core/viewport/parallax.js";
 import { composeChildFrame, composesFrames } from "../../core/scene/composeFrame.js";
-import { definesFrame, effectivePose } from "../../core/scene/effectivePose.js";
 import { viewPoseAdapter } from "../../core/scene/scrollOffsets.js";
-import { wrapWithPoseRotation } from "../poseRotation.js";
+import { definesFrame, effectivePose } from "../../core/scene/effectivePose.js";
+import { deriveParallaxView } from "../../core/viewport/parallax.js";
 import { isCustomEntry } from "../layerSlots.js";
+import { wrapWithPoseRotation } from "../poseRotation.js";
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useDepartureGhostLayer.ts
+// src/canvas/SceneCanvas/useDepartureGhostLayer.ts
 /**
 * The layer `<SceneCanvas poseTransition exit>` draws removed nodes leaving
 * on: each ghost through the scene slot's `drawOne`, at the pose and opacity
@@ -60,6 +60,5 @@ function useDepartureGhostLayer(args) {
 	]);
 }
 
-//#endregion
 export { useDepartureGhostLayer };
 //# sourceMappingURL=useDepartureGhostLayer.js.map

package/dist/canvas/SceneCanvas/useDispatcherOverlayLayer.js

@@ -1,15 +1,15 @@
 import { viewToTransform } from "../../core/viewport/view.js";
 import { worldToScreen } from "../../core/viewport/viewTransform.js";
-import { OVERLAY_ROLE_STROKES } from "../overlayRoleStrokes.js";
 import { resolveOverlays } from "../../interactions/actions/resolveOverlays.js";
 import { gestureOverlaysFrom, isVisibleFrom } from "../drawEnvelope.js";
 import { insertPreviewCommands } from "./insertPreviewCommands.js";
+import { OVERLAY_ROLE_STROKES } from "../overlayRoleStrokes.js";
 import { brushOverlayCommands } from "./brushOverlay.js";
 import { polygonFromPoints, polylineFromPoints } from "@weasel-js/geom";
 import { useEffect, useMemo, useReducer } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useDispatcherOverlayLayer.ts
+// src/canvas/SceneCanvas/useDispatcherOverlayLayer.ts
 /**
 * Dispatcher overlay render layer for `<SceneCanvas>`.
 *
@@ -136,6 +136,5 @@ function useDispatcherOverlayLayer(args) {
 	}), [styleRef]);
 }
 
-//#endregion
 export { useDispatcherOverlayLayer };
 //# sourceMappingURL=useDispatcherOverlayLayer.js.map

package/dist/canvas/SceneCanvas/useHeldModifiers.js

@@ -1,7 +1,7 @@
 import { useKeyState } from "../../input/useKeyState.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useHeldModifiers.ts
+// src/canvas/SceneCanvas/useHeldModifiers.ts
 /** The modifier keys held, for a surface's rule context. */
 /** The modifiers held anywhere in the window, a text field included: a rule
 *  is asked about the keyboard, not about where focus is. `subscribe` reports
@@ -22,6 +22,5 @@ function useHeldModifiers() {
 	}), [keys]);
 }
 
-//#endregion
 export { useHeldModifiers };
 //# sourceMappingURL=useHeldModifiers.js.map

package/dist/canvas/SceneCanvas/useMagnificationCheck.js

@@ -0,0 +1,41 @@
+import { undeclaredMagnifications } from "../../interactions/actions/magnification.js";
+import { isDev } from "@weasel-js/registry";
+import { useEffect } from "react";
+
+// src/canvas/SceneCanvas/useMagnificationCheck.ts
+var SETTLE_MS = 250;
+var times = (n) => `${Number(n.toFixed(3))}×`;
+/**
+* In development, warns once per container and size when `scene` draws a
+* container's children at a magnification its unit scopes do not declare in
+* `drawnAt`: what silently turned a 20″ cabinet into 30″ of board. Checks
+* after edits settle rather than on every frame of a drag.
+*/
+function useMagnificationCheck(scene) {
+	useEffect(() => {
+		if (!isDev()) return;
+		const warned = /* @__PURE__ */ new Set();
+		let timer = null;
+		const check = () => {
+			timer = null;
+			for (const { id, drawn, declared } of undeclaredMagnifications(scene)) {
+				const size = drawn.x === drawn.y ? times(drawn.x) : `${times(drawn.x)} by ${times(drawn.y)}`;
+				const key = `${id}:${size}:${declared}`;
+				if (warned.has(key)) continue;
+				warned.add(key);
+				console.warn(`weasel: node "${id}" draws its children at ${size}, but its unit scopes declare ${times(declared)}. Set \`units.drawnAt\` on the node whose transform scales them, or correct the transform.`);
+			}
+		};
+		check();
+		const unsubscribe = scene.subscribe(() => {
+			timer ??= setTimeout(check, SETTLE_MS);
+		});
+		return () => {
+			unsubscribe();
+			if (timer !== null) clearTimeout(timer);
+		};
+	}, [scene]);
+}
+
+export { useMagnificationCheck };
+//# sourceMappingURL=useMagnificationCheck.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMagnificationCheck.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useMagnificationCheck.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { isDev } from '@weasel-js/registry';\nimport type { Scene } from 'core/scene/types';\nimport { undeclaredMagnifications } from 'interactions/actions/magnification';\n\nconst SETTLE_MS = 250;\nconst times = (n: number): string => `${Number(n.toFixed(3))}×`;\n\n/**\n * In development, warns once per container and size when `scene` draws a\n * container's children at a magnification its unit scopes do not declare in\n * `drawnAt`: what silently turned a 20″ cabinet into 30″ of board. Checks\n * after edits settle rather than on every frame of a drag.\n */\nexport function useMagnificationCheck(scene: Scene<unknown, string, unknown>): void {\n  useEffect(() => {\n    if (!isDev()) return;\n    const warned = new Set<string>();\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const check = (): void => {\n      timer = null;\n      for (const { id, drawn, declared } of undeclaredMagnifications(scene)) {\n        const size = drawn.x === drawn.y ? times(drawn.x) : `${times(drawn.x)} by ${times(drawn.y)}`;\n        const key = `${id}:${size}:${declared}`;\n        if (warned.has(key)) continue;\n        warned.add(key);\n        console.warn(\n          `weasel: node \"${id}\" draws its children at ${size}, but its unit scopes declare ${times(declared)}. `\n          + 'Set `units.drawnAt` on the node whose transform scales them, or correct the transform.',\n        );\n      }\n    };\n    check();\n    const unsubscribe = scene.subscribe(() => {\n      timer ??= setTimeout(check, SETTLE_MS);\n    });\n    return () => {\n      unsubscribe();\n      if (timer !== null) clearTimeout(timer);\n    };\n  }, [scene]);\n}\n"],"mappings":";;;;;AAKA,IAAM,YAAY;AAClB,IAAM,SAAS,MAAsB,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE;;;;;;;AAQ7D,SAAgB,sBAAsB,OAA8C;CAClF,gBAAgB;EACd,IAAI,CAAC,MAAM,GAAG;EACd,MAAM,yBAAS,IAAI,IAAY;EAC/B,IAAI,QAA8C;EAClD,MAAM,cAAoB;GACxB,QAAQ;GACR,KAAK,MAAM,EAAE,IAAI,OAAO,cAAc,yBAAyB,KAAK,GAAG;IACrE,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI,MAAM,MAAM,CAAC,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE,MAAM,MAAM,MAAM,CAAC;IACzF,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG;IAC7B,IAAI,OAAO,IAAI,GAAG,GAAG;IACrB,OAAO,IAAI,GAAG;IACd,QAAQ,KACN,iBAAiB,GAAG,0BAA0B,KAAK,gCAAgC,MAAM,QAAQ,EAAE,2FAErG;GACF;EACF;EACA,MAAM;EACN,MAAM,cAAc,MAAM,gBAAgB;GACxC,UAAU,WAAW,OAAO,SAAS;EACvC,CAAC;EACD,aAAa;GACX,YAAY;GACZ,IAAI,UAAU,MAAM,aAAa,KAAK;EACxC;CACF,GAAG,CAAC,KAAK,CAAC;AACZ"}

package/dist/canvas/SceneCanvas/useNodeAtPoint.js

@@ -1,7 +1,7 @@
 import { makeGetNodeAtPoint } from "../getNodeAtPoint.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useNodeAtPoint.ts
+// src/canvas/SceneCanvas/useNodeAtPoint.ts
 /**
 * The node under a world point with its routing kind, resolved through the
 * select tool's own single-hit picker, so `onClick`, `onDoubleClick`, hover,
@@ -23,6 +23,5 @@ function useNodeAtPoint(args) {
 	]);
 }
 
-//#endregion
 export { useNodeAtPoint };
 //# sourceMappingURL=useNodeAtPoint.js.map

package/dist/canvas/SceneCanvas/useNodeKinds.js

@@ -1,8 +1,8 @@
-import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { createNodeRouting } from "../../core/scene/NodeRouting.js";
+import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useNodeKinds.ts
+// src/canvas/SceneCanvas/useNodeKinds.ts
 /**
 * The canvas's routing-trait classifier, by node data and by node id, so
 * `target: 'kind:text'` on a binding speaks the vocabulary of `Hit.kind`.
@@ -30,6 +30,5 @@ function useNodeKinds(scene, routing) {
 	};
 }
 
-//#endregion
 export { useNodeKinds };
 //# sourceMappingURL=useNodeKinds.js.map

package/dist/canvas/SceneCanvas/usePreviewGhostLayer.js

@@ -1,21 +1,21 @@
-import { deriveParallaxView } from "../../core/viewport/parallax.js";
-import { inheritedPaintOf, inheritsPaint, sceneAncestors } from "../../core/scene/inheritedPaint.js";
-import { withShownData } from "../../core/scene/nodeAsShown.js";
-import { planeTransform } from "../planeClips.js";
-import { wrapWithPoseRotation } from "../poseRotation.js";
-import { ownClipOf } from "../ownClip.js";
-import { scenePaintedPoseOf } from "../derivedPath.js";
-import { scenePlaneOf } from "../scenePickSource.js";
-import { copiesAbove } from "../copiesAbove.js";
 import { isCustomEntry } from "../layerSlots.js";
+import { ownClipOf } from "../ownClip.js";
+import { wrapWithPoseRotation } from "../poseRotation.js";
 import { previewSourcesFrom } from "../drawEnvelope.js";
 import { flattenPreviews, resolvePreviews } from "../../interactions/actions/resolvePreviews.js";
+import { scenePlaneOf } from "../scenePickSource.js";
+import { planeTransform } from "../planeClips.js";
+import { deriveParallaxView } from "../../core/viewport/parallax.js";
+import { copiesAbove } from "../copiesAbove.js";
+import { scenePaintedPoseOf } from "../derivedPath.js";
+import { inheritedPaintOf, inheritsPaint, sceneAncestors } from "../../core/scene/inheritedPaint.js";
+import { withShownData } from "../../core/scene/nodeAsShown.js";
 import "@weasel-js/renderer";
 import { mat3 as mat3$1 } from "@weasel-js/geom";
 import { useEffect, useMemo, useReducer } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/usePreviewGhostLayer.ts
+// src/canvas/SceneCanvas/usePreviewGhostLayer.ts
 /**
 * Preview-ghost render layer for `<SceneCanvas>`. Renders in-flight gesture
 * poses on top of the committed scene by reusing the scene slot's `drawOne`.
@@ -110,6 +110,5 @@ function usePreviewGhostLayer(args) {
 	}), [sceneRef, sceneSlotRef]);
 }
 
-//#endregion
 export { usePreviewGhostLayer };
 //# sourceMappingURL=usePreviewGhostLayer.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasHandle.js

@@ -2,7 +2,7 @@ import { IDENTITY_VIEW, useOptionalViewRegistry } from "../viewRegistry.js";
 import { useCallback, useState } from "react";
 import { assignRef } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasHandle.ts
+// src/canvas/SceneCanvas/useSceneCanvasHandle.ts
 /** Views added through the handle rather than declared as props or children. */
 function useAddedViews() {
 	const surfaceViewRegistry = useOptionalViewRegistry();
@@ -75,6 +75,5 @@ function useSceneCanvasHandle(args) {
 	};
 }
 
-//#endregion
 export { useAddedViews, useSceneCanvasHandle };
 //# sourceMappingURL=useSceneCanvasHandle.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasLayers.js

@@ -1,10 +1,8 @@
-import { targetSizesPx } from "../../core/device/targets.js";
-import { drawnBoundsScene } from "../derivedPath.js";
-import { createSnapOutcomeStore } from "../../domains/snap/outcomeStore.js";
-import { builtLayersOf, isCustomEntry } from "../layerSlots.js";
-import { useTargetBasePx } from "../../core/device/useTargetBasePx.js";
 import { usePathEditOverlayLayer } from "../../domains/paths/usePathEdit.js";
+import { builtLayersOf, isCustomEntry } from "../layerSlots.js";
 import { createSlopsDebugLayer } from "../slopsDebugLayer.js";
+import { useTargetBasePx } from "../../core/device/useTargetBasePx.js";
+import { targetSizesPx } from "../../core/device/targets.js";
 import { layersOverPresets, mergeLayersWithDefaults } from "./mergeLayers.js";
 import { useDispatcherOverlayLayer } from "./useDispatcherOverlayLayer.js";
 import { usePreviewGhostLayer } from "./usePreviewGhostLayer.js";
@@ -13,11 +11,13 @@ import { useEffectSourcesLayer } from "../../domains/pathEffects/useEffectSource
 import { usePoseTransition } from "../../animation/poseTransition.js";
 import { useSceneSlotLayers } from "./useSceneSlotLayers.js";
 import { useSelectionOverlayLayer } from "./useSelectionOverlayLayer.js";
+import { drawnBoundsScene } from "../derivedPath.js";
 import { useEnteredGroupFrameLayer } from "../../domains/selection/enteredGroupFrame.js";
+import { createSnapOutcomeStore } from "../../domains/snap/outcomeStore.js";
 import { createSnapReadoutLayer } from "../../domains/snap/readoutLayer.js";
 import { useMemo, useRef, useState } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasLayers.ts
+// src/canvas/SceneCanvas/useSceneCanvasLayers.ts
 /**
 * The layer map `<SceneCanvas>` hands `<Canvas>`: the caller's `layers` over
 * the kit defaults, with the scene and selection-overlay slots built, and the
@@ -148,6 +148,5 @@ function useSceneCanvasLayers(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasLayers };
 //# sourceMappingURL=useSceneCanvasLayers.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasPathEdit.js

@@ -2,7 +2,7 @@ import { isSelectedNode } from "../../domains/paths/pathEditState.js";
 import { usePathEditState } from "../../domains/paths/usePathEdit.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasPathEdit.ts
+// src/canvas/SceneCanvas/useSceneCanvasPathEdit.ts
 /**
 * The canvas's path-edit state, and the select tool options that defer shift-click to it while
 * a path is being anchor-edited.
@@ -25,6 +25,5 @@ function useSceneCanvasPathEdit(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasPathEdit };
 //# sourceMappingURL=useSceneCanvasPathEdit.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasTools.js

@@ -1,6 +1,6 @@
 import { useCanvasTools, useFeatureBindings } from "./useCanvasTools.js";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasTools.ts
+// src/canvas/SceneCanvas/useSceneCanvasTools.ts
 /** The canvas's tools, and the contributions and standard actions its presets bring. */
 function useSceneCanvasTools(args) {
 	const { props, select, enabled } = args;
@@ -38,6 +38,5 @@ function useSceneCanvasTools(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasTools };
 //# sourceMappingURL=useSceneCanvasTools.js.map

package/dist/canvas/SceneCanvas/useSceneChrome.js

@@ -1,15 +1,15 @@
-import { useOptionalViewRegistry } from "../viewRegistry.js";
-import { worldPointAt } from "./worldPointAt.js";
-import { PRESET_OWNED_CHROME } from "./presets/chrome.js";
 import { never } from "../../domains/chrome-caps/conditions.js";
-import { presetChromeRules } from "./features.js";
 import { useHoverTracking } from "../../domains/chrome-caps/useHoverTracking.js";
 import { useChromeCaps } from "../../domains/chrome-caps/useChromeCaps.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
+import { presetChromeRules } from "./features.js";
+import { PRESET_OWNED_CHROME } from "./presets/chrome.js";
+import { worldPointAt } from "./worldPointAt.js";
 import { useChromeRulesDep } from "../deps/chromeRules.js";
 import { useCallback, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useSceneChrome.ts
+// src/canvas/SceneCanvas/useSceneChrome.ts
 /**
 * The node under the pointer, for `RuleCtx.hover`. One lookup, not a
 * client-to-world thunk beside a picker: the point and the camera its
@@ -124,6 +124,5 @@ function useSceneCanvasChrome(args) {
 	};
 }
 
-//#endregion
 export { hiddenChromeOf, useChromeRules, useSceneCanvasChrome, useSceneHover, useSurfaceChromeCaps };
 //# sourceMappingURL=useSceneChrome.js.map

package/dist/canvas/SceneCanvas/useSceneGestureDispatcher.js

@@ -1,19 +1,19 @@
 import { EMPTY_CHROME_STATE } from "../../core/selection/chromeState.js";
-import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "../affordanceAt.js";
-import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { useDispatchDepSources } from "../deps/dispatchSources.js";
-import { pathFromPlane } from "../planeClips.js";
-import { VIEW_MARKER_ENTRY_ID } from "../../domains/viewports/viewMarkerDrag.js";
-import { useKitSettingsDepSource } from "../deps/kitSettings.js";
+import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "../affordanceAt.js";
 import { useChromeAffordances } from "./useChromeAffordances.js";
+import { useKitSettingsDepSource } from "../deps/kitSettings.js";
+import { pathFromPlane } from "../planeClips.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { useSurfaceRouting } from "./useSurfaceRouting.js";
 import { traceConversion } from "./coordTrace.js";
+import { VIEW_MARKER_ENTRY_ID } from "../../domains/viewports/viewMarkerDrag.js";
 import { useCallback, useEffect, useInsertionEffect, useMemo, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { createLongPressStore } from "@weasel-js/routing";
 import { useActionsRegistry, useDepRegistry, useGestureDispatcher } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useSceneGestureDispatcher.ts
+// src/canvas/SceneCanvas/useSceneGestureDispatcher.ts
 /** What a press on the canvas grabs: a registered layer's widget, else a piece of the
 *  selection chrome. */
 function useAffordanceAt(inputs, depRegistry, viewRegistry) {
@@ -175,6 +175,5 @@ function useSceneGestureDispatcher(inputs) {
 	useKitSettingsDepSource();
 }
 
-//#endregion
 export { useSceneGestureDispatcher };
 //# sourceMappingURL=useSceneGestureDispatcher.js.map

package/dist/canvas/SceneCanvas/useScenePicking.js

@@ -1,18 +1,18 @@
-import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { asNodeId } from "../../core/scene/types.js";
-import { useEnteredGroup } from "../deps/enteredGroup.js";
-import { useViewLayerGate } from "../useViewLayerGate.js";
-import { composeAlphaFor } from "../sceneSlotWiring.js";
 import { doubleClickTarget } from "../doubleClickTarget.js";
+import { useEnteredGroup } from "../deps/enteredGroup.js";
 import { createEnteredGroupScope } from "../../domains/selection/enteredGroupScope.js";
+import { composeAlphaFor } from "../sceneSlotWiring.js";
 import { useSceneAdapter } from "../useSceneAdapter.js";
 import { useNodeAtPoint } from "./useNodeAtPoint.js";
 import { useSceneSelectTool } from "./useSceneSelectTool.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
+import { useViewLayerGate } from "../useViewLayerGate.js";
 import { useCallback, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 import { useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useScenePicking.ts
+// src/canvas/SceneCanvas/useScenePicking.ts
 /**
 * The canvas's adapter and everything that answers "what is under this point": the select
 * tool's pickers and bounds, the node kinds, and the paint gates picking shares with the painter.
@@ -85,6 +85,5 @@ function useScenePicking(args) {
 	};
 }
 
-//#endregion
 export { useScenePicking };
 //# sourceMappingURL=useScenePicking.js.map

package/dist/canvas/SceneCanvas/useSceneRedrawSources.js

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneRedrawSources.ts
+// src/canvas/SceneCanvas/useSceneRedrawSources.ts
 /**
 * What repaints a `<SceneCanvas>` besides its own render: the caller's
 * sources, then the canvas's. Neither a scene write nor an override write
@@ -30,6 +30,5 @@ function useSceneRedrawSources(args) {
 	]);
 }
 
-//#endregion
 export { useSceneRedrawSources };
 //# sourceMappingURL=useSceneRedrawSources.js.map

package/dist/canvas/SceneCanvas/useSceneSelectTool.js

@@ -1,17 +1,17 @@
-import { rectFromPlane } from "../../core/viewport/parallax.js";
-import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
-import { drawnBoundsOf } from "../drawnBounds.js";
-import { asNodeId } from "../../core/scene/types.js";
 import { drawnBoundsScene } from "../derivedPath.js";
-import { scenePickSource, scenePlaneOf } from "../scenePickSource.js";
 import { pickWalk } from "../pickWalk.js";
-import { pickTopMostHit } from "../../tools/builtin/pickTopMostHit.js";
+import { rectFromPlane } from "../../core/viewport/parallax.js";
 import { useSelectTool } from "../../tools/builtin/select/useSelectTool.js";
+import { pickTopMostHit } from "../../tools/builtin/pickTopMostHit.js";
+import { scenePickSource, scenePlaneOf } from "../scenePickSource.js";
+import { asNodeId } from "../../core/scene/types.js";
+import { drawnBoundsOf } from "../drawnBounds.js";
+import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
 import { scenePointQuery } from "./scenePointQuery.js";
 import { useMemo } from "react";
 import { useKitSetting, useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useSceneSelectTool.ts
+// src/canvas/SceneCanvas/useSceneSelectTool.ts
 /**
 * Scene-aware select-tool synthesis for `<SceneCanvas>`: a `useSelectTool`
 * over the caller's scene adapter, configured with kit-default pickEvery /
@@ -166,6 +166,5 @@ function usePointPick(args) {
 	}, [walk, isPointerInteractive]);
 }
 
-//#endregion
 export { DEFAULT_PICK_TOLERANCE_PX, useSceneSelectTool };
 //# sourceMappingURL=useSceneSelectTool.js.map

package/dist/canvas/SceneCanvas/useSceneSlotLayers.js

@@ -1,10 +1,10 @@
-import { isCustomEntry } from "../layerSlots.js";
 import { buildSceneLayers } from "../buildSceneLayer.js";
+import { isCustomEntry } from "../layerSlots.js";
 import { wireSceneSlotToScene } from "../sceneSlotWiring.js";
 import { useSceneLayerList } from "../useSceneLayerList.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneSlotLayers.ts
+// src/canvas/SceneCanvas/useSceneSlotLayers.ts
 /**
 * The scene slot, built: the caller's config wired to the scene, and the
 * canvas layers it paints as. A hierarchical scene gets one canvas layer per
@@ -44,6 +44,5 @@ function useSceneSlotLayers(args) {
 	};
 }
 
-//#endregion
 export { useSceneSlotLayers };
 //# sourceMappingURL=useSceneSlotLayers.js.map

package/dist/canvas/SceneCanvas/useSceneStandardActions.js

@@ -1,32 +1,34 @@
+import { asNodeId } from "../../core/scene/types.js";
 import { useDecayLoop } from "../../core/viewport/useDecayLoop.js";
-import { drawnBoxes } from "../../interactions/actions/drawnBoxes.js";
-import { useEnteredGroupApiSource } from "../deps/enteredGroup.js";
 import { useActionSet, useStandardDeps } from "../../interactions/actions/useActionSet.js";
-import { usePoseDescriptorDepSource } from "../deps/poseDescriptor.js";
-import { useViewDepSource } from "../deps/view.js";
+import { drawnBoxes } from "../../interactions/actions/drawnBoxes.js";
 import { useAreaSelectDepSource } from "../deps/areaSelect.js";
-import { useNodeAtPointDepSource } from "../deps/nodeAtPoint.js";
-import { useLassoSelectDepSource } from "../deps/lassoSelect.js";
-import { useTextEditDepSource } from "../deps/textEdit.js";
-import { useEditAnchorsDepSource } from "../deps/editAnchors.js";
-import { useSelectionSnapshotDepSource } from "../deps/selectionSnapshot.js";
-import { useInsertDepSource } from "../deps/insert.js";
-import { useSnapDepSource } from "../deps/snap.js";
-import { usePathLeafDepSources } from "../deps/pathLeafDeps.js";
 import { useDebugDepSource } from "../deps/debug.js";
 import { usePreviewPathsDepSource } from "../deps/previewPaths.js";
-import { useSurfaceDepSources } from "../deps/surface.js";
 import { useDepChangeNotices } from "../deps/changes.js";
 import { useDispatcherDepSource } from "../deps/dispatcher.js";
-import { useLayoutDepSource } from "../deps/layout.js";
+import { useEditAnchorsDepSource } from "../deps/editAnchors.js";
+import { useSelectionSnapshotDepSource } from "../deps/selectionSnapshot.js";
+import { useEnteredGroupApiSource } from "../deps/enteredGroup.js";
 import { useIngestionDepSource } from "../deps/ingestion.js";
+import { useInsertDepSource } from "../deps/insert.js";
+import { useLassoSelectDepSource } from "../deps/lassoSelect.js";
+import { useLayoutDepSource } from "../deps/layout.js";
+import { useNodeAtPointDepSource } from "../deps/nodeAtPoint.js";
+import { usePoseDescriptorDepSource } from "../deps/poseDescriptor.js";
+import { usePathLeafDepSources } from "../deps/pathLeafDeps.js";
+import { useSnapDepSource } from "../deps/snap.js";
+import { useSurfaceDepSources } from "../deps/surface.js";
+import { useTextEditDepSource } from "../deps/textEdit.js";
+import { useViewDepSource } from "../deps/view.js";
+import { pressTarget } from "../../tools/builtin/pressTarget.js";
 import { useActionsPropResolver } from "./useActionsPropResolver.js";
 import { useActionTunings, useBindingOverrides } from "./useActionTunings.js";
 import { useViewportActions, viewportZoomOption } from "./useViewportActions.js";
 import { useEffect, useMemo } from "react";
 import { useActionsRegistry, useDepSource } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useSceneStandardActions.ts
+// src/canvas/SceneCanvas/useSceneStandardActions.ts
 /**
 * Registers this canvas's standard actions, and the deps they read, into its
 * input scope, then applies the `actions` prop and `tune` over them.
@@ -69,7 +71,14 @@ function useSceneStandardActions(inputs) {
 		zoom: viewOn ? viewportZoom : false,
 		pinchZoom: viewOn ? viewport?.pinchZoom ?? true : false
 	});
-	useAreaSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);
+	const regionTargetOf = useMemo(() => {
+		const tree = {
+			getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,
+			getNode: (id) => scene.get(asNodeId(id))
+		};
+		return (id) => pressTarget(tree, id, enteredGroup.get());
+	}, [scene, enteredGroup]);
+	useAreaSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable, regionTargetOf);
 	useNodeAtPointDepSource(pickEvery);
 	useLayoutDepSource(scene, props.layoutDropTarget, reflowTransition);
 	useEnteredGroupApiSource(enteredGroup);
@@ -96,7 +105,7 @@ function useSceneStandardActions(inputs) {
 	usePreviewPathsDepSource(canvasApiRef);
 	useDepChangeNotices(scene, selection.current, editAnchorsExternalState);
 	useIngestionDepSource(canvasRef, () => currentViewRef.current, ingestion?.resolveSrc, ingestion?.svg, ingestionClipboard, ingestionHandlers);
-	useLassoSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable);
+	useLassoSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable, regionTargetOf);
 	useTextEditDepSource(scene);
 	useEditAnchorsDepSource(scene, selection, adapter, editAnchorsExternalState, tune);
 	useSelectionSnapshotDepSource();
@@ -108,6 +117,5 @@ function useSceneStandardActions(inputs) {
 	useBindingOverrides(props.bindingOverrides);
 }
 
-//#endregion
 export { useSceneStandardActions };
 //# sourceMappingURL=useSceneStandardActions.js.map

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, 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  useSelectionSnapshotDepSource,\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      ...(props.snap?.anchors ? { anchors: props.snap.anchors } : {}),\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  useSelectionSnapshotDepSource();\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkHA,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,GAAI,MAAM,MAAM,UAAU,EAAE,SAAS,MAAM,KAAK,QAAQ,IAAI,CAAC;EAC7D;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,8BAA8B;CAC9B,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 { asNodeId, 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  useSelectionSnapshotDepSource,\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 { pressTarget } from 'tools/builtin/pressTarget';\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  const regionTargetOf = useMemo(() => {\n    const tree = {\n      getParent: (id: string) => scene.get(asNodeId(id))?.parent ?? null,\n      getNode: (id: string) => scene.get(asNodeId(id)),\n    };\n    return (id: string) => pressTarget(tree, id, enteredGroup.get());\n  }, [scene, enteredGroup]);\n  useAreaSelectDepSource(scene, selection, poseDescriptor, alphaOf, reachable, regionTargetOf);\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      ...(props.snap?.anchors ? { anchors: props.snap.anchors } : {}),\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, regionTargetOf);\n  useTextEditDepSource(scene);\n  useEditAnchorsDepSource(scene, selection, adapter, editAnchorsExternalState, tune);\n  useSelectionSnapshotDepSource();\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmHA,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,MAAM,iBAAiB,cAAc;EACnC,MAAM,OAAO;GACX,YAAY,OAAe,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU;GAC9D,UAAU,OAAe,MAAM,IAAI,SAAS,EAAE,CAAC;EACjD;EACA,QAAQ,OAAe,YAAY,MAAM,IAAI,aAAa,IAAI,CAAC;CACjE,GAAG,CAAC,OAAO,YAAY,CAAC;CACxB,uBAAuB,OAAO,WAAW,gBAAgB,SAAS,WAAW,cAAc;CAC3F,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,GAAI,MAAM,MAAM,UAAU,EAAE,SAAS,MAAM,KAAK,QAAQ,IAAI,CAAC;EAC7D;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,WAAW,cAAc;CAC5F,qBAAqB,KAAK;CAC1B,wBAAwB,OAAO,WAAW,SAAS,0BAA0B,IAAI;CACjF,8BAA8B;CAC9B,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,8 +1,8 @@
-import { isCustomEntry } from "../layerSlots.js";
 import { createSelectionOverlayLayer, rotationBadgeOf } from "../../domains/selection/overlay.js";
+import { isCustomEntry } from "../layerSlots.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSelectionOverlayLayer.ts
+// src/canvas/SceneCanvas/useSelectionOverlayLayer.ts
 /**
 * The selection-overlay slot, built, and where it paints its rotate badge.
 * Both are `null` when the slot is switched off, and a pre-built layer has no badge.
@@ -46,6 +46,5 @@ function useSelectionOverlayLayer(slot, getOwnSuppressedIds, poseDescriptor, sce
 	};
 }
 
-//#endregion
 export { useSelectionOverlayLayer };
 //# sourceMappingURL=useSelectionOverlayLayer.js.map