@weasel-js/core 1.9.4 → 1.10.1

package/dist/tools/builtin/select/selectionContributions.js.map

@@ -1 +1 @@
-{"version":3,"file":"selectionContributions.js","names":["SELECTION_MOVE_ID","SELECTION_TRANSFORM_ID","SELECTION_RESIZE_ID","SELECTION_ROTATE_ID","selectionMoveBindings","moveOpts","move","options","params","gestureLifecycleParams","withParams","behaviors","hitPredicate","body","isAnchorOrControl","afford","selectionResizeBindings","isResizeHandle","selectionRotateBindings","rotate","opts","isRotateHandle","selectionTransformBindings","selectionMoveContribution","selectionTransformContribution","selectionResizeContribution","selectionRotateContribution","AREA_SELECT_ID","onEmptyCanvas","hit","areaSelectContribution"],"sources":["../../../../src/tools/builtin/select/selectionContributions.ts"],"sourcesContent":["/**\n * The ambient bindings that act on the selection: moving it, cloning it, and\n * resizing or rotating it from its handles. They belong to the selection, not\n * to the select tool, so they run under any tool that does not claim the\n * gesture itself. `<SceneCanvas features>` installs them as the `move`,\n * `resize` and `rotate` presets.\n */\nimport type { BindingOpts, GestureBinding } from '@weasel-js/routing';\nimport { isResizeHandle, isRotateHandle, isAnchorOrControl } from '@weasel-js/routing';\nimport { hitPredicate } from '@weasel-js/gestures';\nimport type { Contribution } from '../../overlayBinding';\nimport type { UseMoveOptions } from '../../../interactions/actions/move/options';\nimport type { UseRotateOptions } from '../../../interactions/actions/rotate/options';\nimport { gestureLifecycleParams } from '../../../interactions/actions/gestureLifecycle';\n\n/** Options for {@link selectionMoveContribution}. */\nexport interface SelectionMoveOptions<TPose = unknown> {\n  /** Move-action options: `behaviors` become the move bindings'\n   *  `opts.behaviors`, everything else their `opts.params`. */\n  move?: UseMoveOptions<TPose>;\n  /** Reparent-on-drop behavior for drag-to-move. `'off'` (default) keeps\n   *  translate-only commits. `'top'` lands the moved nodes at the top of the\n   *  container under the drop point; `'above'` lands them immediately above the\n   *  hit sibling. Requires the `nodeAtPoint` dep (`<SceneCanvas>` sources it). */\n  reparentOnDrop?: 'off' | 'top' | 'above';\n}\n\n/** Id of the entry {@link selectionMoveContribution} builds. */\nexport const SELECTION_MOVE_ID = 'selection.move';\n/** Id of the entry {@link selectionTransformContribution} builds. */\nexport const SELECTION_TRANSFORM_ID = 'selection.transform';\n/** Id of the entry {@link selectionResizeContribution} builds. */\nexport const SELECTION_RESIZE_ID = 'selection.resize';\n/** Id of the entry {@link selectionRotateContribution} builds. */\nexport const SELECTION_ROTATE_ID = 'selection.rotate';\n\n/** Drag a body to move the selection; Alt-drag to clone it. */\nexport function selectionMoveBindings<TPose>(\n  options: SelectionMoveOptions<TPose> = {},\n): GestureBinding[] {\n  // Shared move-binding opts (params + behaviors). Applied to\n  // both the selected-body and unselected-body move bindings so a\n  // first-touch drag and a re-drag commit identically.\n  const moveOpts: { opts?: BindingOpts } = (() => {\n    const move = options.move ?? {};\n    const params: Record<string, unknown> = gestureLifecycleParams({ ...move, label: move.moveLabel });\n    if (options.reparentOnDrop && options.reparentOnDrop !== 'off') params.reparentOnDrop = options.reparentOnDrop;\n    if (move.dragThresholdPx !== undefined) params.dragThresholdPx = move.dragThresholdPx;\n    if (move.expandIds) params.expandIds = move.expandIds;\n    const withParams = Object.keys(params).length > 0 ? { params } : undefined;\n    const behaviors = options.move?.behaviors?.length\n      ? { behaviors: options.move.behaviors as BindingOpts['behaviors'] }\n      : undefined;\n    return withParams || behaviors\n      ? { opts: { ...withParams, ...behaviors } satisfies BindingOpts }\n      : {};\n  })();\n\n  return [\n    // Alt-drag on a body → clone (Illustrator convention).\n    // Listed BEFORE bare move so the strict-modifier dispatcher\n    // picks this when Alt is held; bare move matches no-mod drags.\n    // Both selected and unselected bodies are valid clone targets — the\n    // select tool's pointerDown classifier calls `selection.applyClick(top, mods)`\n    // on an unselected hit before the drag fires, so cloneAction's\n    // `start` sees the hit node in `selection.get()` either way.\n    { spec: { kind: 'drag' as const, target: 'selected-body' as const, mods: { alt: true } }, actionId: 'clone' },\n    { spec: { kind: 'drag' as const, target: 'unselected-body' as const, mods: { alt: true } }, actionId: 'clone' },\n    {\n      // Body-drag → move, BUT defer when the pointerdown hit a path\n      // anchor / control affordance. Anchors lie on the curve so the\n      // body classifier still reports 'selected-body'; without this\n      // opt-out, move's binding beats editAnchors's on every anchor drag.\n      //\n      // `isAnchorOrControl` is the SAME predicate `editAnchorsAction`\n      // matches on. That is load-bearing: the two must agree on what\n      // counts as an anchor hit or move steals the drag — which is\n      // exactly the bug this opt-out exists to prevent.\n      spec: {\n        kind: 'drag' as const,\n        target: {\n          kindOf: hitPredicate((afford, body) =>\n            body === 'selected-body' && !isAnchorOrControl(afford)),\n        },\n      },\n      actionId: 'move',\n      ...moveOpts,\n    },\n    // Body-drag on a NOT-yet-selected node → also move. The select tool's\n    // pointerDown classifier selects the hit node before the drag fires (same\n    // contract clone relies on), so by the time moveAction.start() runs the\n    // node is in `selection.get()`. Without this binding an unselected-body\n    // drag falls through to whatever ambient drag binding comes next — once\n    // the `rotate` catch-all, which made the first drag rotate and later ones\n    // move. Unselected nodes never carry anchor affordances (those gate on\n    // selection), so the plain string-form target is sufficient here.\n    {\n      spec: { kind: 'drag' as const, target: 'unselected-body' as const },\n      actionId: 'move',\n      ...moveOpts,\n    },\n  ];\n}\n\n/** Options for {@link selectionRotateContribution}. */\nexport interface SelectionRotateOptions<TPose = unknown> {\n  /** Rotate-action options: `behaviors` become the rotate binding's\n   *  `opts.behaviors`, everything else its `opts.params`. */\n  rotate?: UseRotateOptions<TPose>;\n}\n\n/** Options for {@link selectionTransformContribution}. Resize takes its\n *  options through the `resizePolicy` dep (`useResizePolicy`), not here. */\nexport type SelectionTransformOptions<TPose = unknown> = SelectionRotateOptions<TPose>;\n\n/** Drag a resize handle to resize the selection. Options come through the\n *  `resizePolicy` dep (`useResizePolicy`). */\nexport function selectionResizeBindings(): GestureBinding[] {\n  return [{ spec: { kind: 'drag' as const, target: { kindOf: isResizeHandle } }, actionId: 'resize' }];\n}\n\n/** Drag the rotation handle to rotate the selection. */\nexport function selectionRotateBindings<TPose>(\n  options: SelectionRotateOptions<TPose> = {},\n): GestureBinding[] {\n  const rotate = options.rotate ?? {};\n  const params: Record<string, unknown> = gestureLifecycleParams({ ...rotate, label: rotate.rotateLabel });\n  if (rotate.pivot) params.pivot = rotate.pivot;\n  const opts: BindingOpts = {\n    ...(Object.keys(params).length > 0 ? { params } : {}),\n    ...(rotate.behaviors?.length ? { behaviors: rotate.behaviors as BindingOpts['behaviors'] } : {}),\n  };\n  return [{\n    spec: { kind: 'drag' as const, target: { kindOf: isRotateHandle } },\n    actionId: 'rotate',\n    ...(Object.keys(opts).length > 0 ? { opts } : {}),\n  }];\n}\n\n/** Drag a resize handle to resize the selection, the rotation handle to rotate it. */\nexport function selectionTransformBindings<TPose>(\n  options: SelectionTransformOptions<TPose> = {},\n): GestureBinding[] {\n  return [...selectionResizeBindings(), ...selectionRotateBindings(options)];\n}\n\n/** An always-live entry carrying {@link selectionMoveBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['move']}>` does. */\nexport function selectionMoveContribution<TPose>(\n  options: SelectionMoveOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_MOVE_ID,\n    eligibility: { always: true },\n    bindings: selectionMoveBindings(options),\n  };\n}\n\n/** An always-live entry carrying {@link selectionTransformBindings}: resize\n *  and rotate in one entry, what `<SceneCanvas features={['transform']}>`\n *  turns on. */\nexport function selectionTransformContribution<TPose>(\n  options: SelectionTransformOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_TRANSFORM_ID,\n    eligibility: { always: true },\n    bindings: selectionTransformBindings(options),\n  };\n}\n\n/** An always-live entry carrying {@link selectionResizeBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['resize']}>` does. */\nexport function selectionResizeContribution(): Contribution {\n  return {\n    id: SELECTION_RESIZE_ID,\n    eligibility: { always: true },\n    bindings: selectionResizeBindings(),\n  };\n}\n\n/** An always-live entry carrying {@link selectionRotateBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['rotate']}>` does. */\nexport function selectionRotateContribution<TPose>(\n  options: SelectionRotateOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_ROTATE_ID,\n    eligibility: { always: true },\n    bindings: selectionRotateBindings(options),\n  };\n}\n\n/** Id of the entry {@link areaSelectContribution} builds. */\nexport const AREA_SELECT_ID = 'selection.areaSelect';\n\n/** A press on empty canvas: no hit, and not on chrome over it — the rotation\n *  handle and the outer half of a resize handle sit off the body. */\nexport const onEmptyCanvas = hitPredicate((hit, body) => hit == null && body === 'empty');\n\n/** An always-live entry that marquee-selects on a drag across empty canvas,\n *  under any tool that does not claim the drag itself. No preset installs it:\n *  the select tool already marquees, and a canvas that wants it under every\n *  tool adds this to its ambient list. */\nexport function areaSelectContribution(): Contribution {\n  return {\n    id: AREA_SELECT_ID,\n    eligibility: { always: true },\n    bindings: [{ spec: { kind: 'drag', target: { kindOf: onEmptyCanvas } }, actionId: 'areaSelect' }],\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"selectionContributions.js","names":["SELECTION_MOVE_ID","SELECTION_TRANSFORM_ID","SELECTION_RESIZE_ID","SELECTION_ROTATE_ID","selectionMoveBindings","moveOpts","move","options","params","gestureLifecycleParams","withParams","behaviors","hitPredicate","body","isPathEditPart","afford","selectionResizeBindings","isResizeHandle","selectionRotateBindings","rotate","opts","isRotateHandle","selectionTransformBindings","selectionMoveContribution","selectionTransformContribution","selectionResizeContribution","selectionRotateContribution","AREA_SELECT_ID","onEmptyCanvas","hit","onBody","areaSelectContribution"],"sources":["../../../../src/tools/builtin/select/selectionContributions.ts"],"sourcesContent":["/**\n * The ambient bindings that act on the selection: moving it, cloning it, and\n * resizing or rotating it from its handles. They belong to the selection, not\n * to the select tool, so they run under any tool that does not claim the\n * gesture itself. `<SceneCanvas features>` installs them as the `move`,\n * `resize` and `rotate` presets.\n */\nimport type { BindingOpts, GestureBinding } from '@weasel-js/routing';\nimport { isResizeHandle, isRotateHandle, isPathEditPart } from '@weasel-js/routing';\nimport { hitPredicate } from '@weasel-js/gestures';\nimport type { Contribution } from '../../overlayBinding';\nimport type { UseMoveOptions } from '../../../interactions/actions/move/options';\nimport type { UseRotateOptions } from '../../../interactions/actions/rotate/options';\nimport { gestureLifecycleParams } from '../../../interactions/actions/gestureLifecycle';\n\n/** Options for {@link selectionMoveContribution}. */\nexport interface SelectionMoveOptions<TPose = unknown> {\n  /** Move-action options: `behaviors` become the move bindings'\n   *  `opts.behaviors`, everything else their `opts.params`. */\n  move?: UseMoveOptions<TPose>;\n  /** Reparent-on-drop behavior for drag-to-move. `'off'` (default) keeps\n   *  translate-only commits. `'top'` lands the moved nodes at the top of the\n   *  container under the drop point; `'above'` lands them immediately above the\n   *  hit sibling. Requires the `nodeAtPoint` dep (`<SceneCanvas>` sources it). */\n  reparentOnDrop?: 'off' | 'top' | 'above';\n}\n\n/** Id of the entry {@link selectionMoveContribution} builds. */\nexport const SELECTION_MOVE_ID = 'selection.move';\n/** Id of the entry {@link selectionTransformContribution} builds. */\nexport const SELECTION_TRANSFORM_ID = 'selection.transform';\n/** Id of the entry {@link selectionResizeContribution} builds. */\nexport const SELECTION_RESIZE_ID = 'selection.resize';\n/** Id of the entry {@link selectionRotateContribution} builds. */\nexport const SELECTION_ROTATE_ID = 'selection.rotate';\n\n/** Drag a body to move the selection; Alt-drag to clone it. */\nexport function selectionMoveBindings<TPose>(\n  options: SelectionMoveOptions<TPose> = {},\n): GestureBinding[] {\n  // Shared move-binding opts (params + behaviors). Applied to\n  // both the selected-body and unselected-body move bindings so a\n  // first-touch drag and a re-drag commit identically.\n  const moveOpts: { opts?: BindingOpts } = (() => {\n    const move = options.move ?? {};\n    const params: Record<string, unknown> = gestureLifecycleParams({ ...move, label: move.moveLabel });\n    if (options.reparentOnDrop && options.reparentOnDrop !== 'off') params.reparentOnDrop = options.reparentOnDrop;\n    if (move.dragThresholdPx !== undefined) params.dragThresholdPx = move.dragThresholdPx;\n    if (move.expandIds) params.expandIds = move.expandIds;\n    const withParams = Object.keys(params).length > 0 ? { params } : undefined;\n    const behaviors = options.move?.behaviors?.length\n      ? { behaviors: options.move.behaviors as BindingOpts['behaviors'] }\n      : undefined;\n    return withParams || behaviors\n      ? { opts: { ...withParams, ...behaviors } satisfies BindingOpts }\n      : {};\n  })();\n\n  return [\n    // Alt-drag on a body → clone (Illustrator convention).\n    // Listed BEFORE bare move so the strict-modifier dispatcher\n    // picks this when Alt is held; bare move matches no-mod drags.\n    // Both selected and unselected bodies are valid clone targets — the\n    // select tool's pointerDown classifier calls `selection.applyClick(top, mods)`\n    // on an unselected hit before the drag fires, so cloneAction's\n    // `start` sees the hit node in `selection.get()` either way.\n    { spec: { kind: 'drag' as const, target: 'selected-body' as const, mods: { alt: true } }, actionId: 'clone' },\n    { spec: { kind: 'drag' as const, target: 'unselected-body' as const, mods: { alt: true } }, actionId: 'clone' },\n    {\n      // Body-drag → move, BUT defer when the pointerdown hit a path\n      // anchor, control, or segment affordance. Those lie on the curve so\n      // the body classifier still reports 'selected-body'; without this\n      // opt-out, move's binding beats editAnchors's on every anchor drag.\n      //\n      // `isPathEditPart` covers exactly what `editAnchorsAction` and\n      // `bendSegmentAction` match on. That is load-bearing: they must agree\n      // on what counts as an anchor or segment hit or move steals the\n      // drag — which is exactly the bug this opt-out exists to prevent.\n      spec: {\n        kind: 'drag' as const,\n        target: {\n          kindOf: hitPredicate((afford, body) =>\n            body === 'selected-body' && !isPathEditPart(afford)),\n        },\n      },\n      actionId: 'move',\n      ...moveOpts,\n    },\n    // Body-drag on a NOT-yet-selected node → also move. The select tool's\n    // pointerDown classifier selects the hit node before the drag fires (same\n    // contract clone relies on), so by the time moveAction.start() runs the\n    // node is in `selection.get()`. Without this binding an unselected-body\n    // drag falls through to whatever ambient drag binding comes next — once\n    // the `rotate` catch-all, which made the first drag rotate and later ones\n    // move. Unselected nodes never carry anchor affordances (those gate on\n    // selection), so the plain string-form target is sufficient here.\n    {\n      spec: { kind: 'drag' as const, target: 'unselected-body' as const },\n      actionId: 'move',\n      ...moveOpts,\n    },\n  ];\n}\n\n/** Options for {@link selectionRotateContribution}. */\nexport interface SelectionRotateOptions<TPose = unknown> {\n  /** Rotate-action options: `behaviors` become the rotate binding's\n   *  `opts.behaviors`, everything else its `opts.params`. */\n  rotate?: UseRotateOptions<TPose>;\n}\n\n/** Options for {@link selectionTransformContribution}. Resize takes its\n *  options through the `resizePolicy` dep (`useResizePolicy`), not here. */\nexport type SelectionTransformOptions<TPose = unknown> = SelectionRotateOptions<TPose>;\n\n/** Drag a resize handle to resize the selection. Options come through the\n *  `resizePolicy` dep (`useResizePolicy`). */\nexport function selectionResizeBindings(): GestureBinding[] {\n  return [{ spec: { kind: 'drag' as const, target: { kindOf: isResizeHandle } }, actionId: 'resize' }];\n}\n\n/** Drag the rotation handle to rotate the selection. */\nexport function selectionRotateBindings<TPose>(\n  options: SelectionRotateOptions<TPose> = {},\n): GestureBinding[] {\n  const rotate = options.rotate ?? {};\n  const params: Record<string, unknown> = gestureLifecycleParams({ ...rotate, label: rotate.rotateLabel });\n  if (rotate.pivot) params.pivot = rotate.pivot;\n  const opts: BindingOpts = {\n    ...(Object.keys(params).length > 0 ? { params } : {}),\n    ...(rotate.behaviors !== undefined ? { behaviors: rotate.behaviors as BindingOpts['behaviors'] } : {}),\n  };\n  return [{\n    spec: { kind: 'drag' as const, target: { kindOf: isRotateHandle } },\n    actionId: 'rotate',\n    ...(Object.keys(opts).length > 0 ? { opts } : {}),\n  }];\n}\n\n/** Drag a resize handle to resize the selection, the rotation handle to rotate it. */\nexport function selectionTransformBindings<TPose>(\n  options: SelectionTransformOptions<TPose> = {},\n): GestureBinding[] {\n  return [...selectionResizeBindings(), ...selectionRotateBindings(options)];\n}\n\n/** An always-live entry carrying {@link selectionMoveBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['move']}>` does. */\nexport function selectionMoveContribution<TPose>(\n  options: SelectionMoveOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_MOVE_ID,\n    eligibility: { always: true },\n    bindings: selectionMoveBindings(options),\n  };\n}\n\n/** An always-live entry carrying {@link selectionTransformBindings}: resize\n *  and rotate in one entry, what `<SceneCanvas features={['transform']}>`\n *  turns on. */\nexport function selectionTransformContribution<TPose>(\n  options: SelectionTransformOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_TRANSFORM_ID,\n    eligibility: { always: true },\n    bindings: selectionTransformBindings(options),\n  };\n}\n\n/** An always-live entry carrying {@link selectionResizeBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['resize']}>` does. */\nexport function selectionResizeContribution(): Contribution {\n  return {\n    id: SELECTION_RESIZE_ID,\n    eligibility: { always: true },\n    bindings: selectionResizeBindings(),\n  };\n}\n\n/** An always-live entry carrying {@link selectionRotateBindings}. Add it to a\n *  canvas's ambient list; `<SceneCanvas features={['rotate']}>` does. */\nexport function selectionRotateContribution<TPose>(\n  options: SelectionRotateOptions<TPose> = {},\n): Contribution {\n  return {\n    id: SELECTION_ROTATE_ID,\n    eligibility: { always: true },\n    bindings: selectionRotateBindings(options),\n  };\n}\n\n/** Id of the entry {@link areaSelectContribution} builds. */\nexport const AREA_SELECT_ID = 'selection.areaSelect';\n\n/** A press on empty canvas: no hit, and not on chrome over it — the rotation\n *  handle and the outer half of a resize handle sit off the body. */\nexport const onEmptyCanvas = hitPredicate((hit, body) => hit == null && body === 'empty');\n\n/** A press on a node, off chrome. With no `classifyTarget` wired there is no\n *  body class to read, and every press off chrome passes. */\nexport const onBody = hitPredicate((hit, body) => hit == null && body !== 'empty');\n\n/** An always-live entry that marquee-selects on a drag across empty canvas,\n *  under any tool that does not claim the drag itself. No preset installs it:\n *  the select tool already marquees, and a canvas that wants it under every\n *  tool adds this to its ambient list. */\nexport function areaSelectContribution(): Contribution {\n  return {\n    id: AREA_SELECT_ID,\n    eligibility: { always: true },\n    bindings: [{ spec: { kind: 'drag', target: { kindOf: onEmptyCanvas } }, actionId: 'areaSelect' }],\n  };\n}\n"],"mappings":"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"}

package/dist/tools/builtin/select/useSelectTool.js

@@ -1,52 +1,25 @@
-import { meanScale as e } from "../../../core/viewport/meanScale.js";
-import { toPlane as t } from "../../../core/viewport/parallax.js";
-import { poseDescriptorForNode as n } from "../../../core/geometry/poseDescriptor.js";
-import { AUTO_POSE_DESCRIPTOR as r } from "../../../interactions/actions/resize/autoPoseDescriptor.js";
+import { AUTO_POSE_DESCRIPTOR as e } from "../../../core/geometry/autoPoseDescriptor.js";
 import "../../../core/selection/selectionTarget.js";
-import { shapeCoversPoint as i } from "../../../canvas/NodeShape.js";
-import { adapterPickSource as a, ownClipOf as o, pickWalk as s, scenePlaneOf as c } from "../../../canvas/pickWalk.js";
-import { defineTool as l } from "../../overlayBinding.js";
-import u from "../../../icons/SelectIcon.js";
-import { pickTopMostHit as d } from "../pickTopMostHit.js";
-import { onEmptyCanvas as f } from "./selectionContributions.js";
-import { pathContainsPoint as p } from "@weasel-js/geom";
-import { createElement as m, useMemo as h, useRef as g } from "react";
-import { useLatest as _ } from "@weasel-js/react";
-import { ActionDisabledReason as v } from "@weasel-js/routing";
-import { hitPredicate as y } from "@weasel-js/gestures";
+import { adapterPickSource as t } from "../../../canvas/adapterPickSource.js";
+import { pickWalk as n, scenePlaneOf as r } from "../../../canvas/pickWalk.js";
+import { defineTool as i } from "../../overlayBinding.js";
+import a from "../../../icons/SelectIcon.js";
+import { pickTopMostHit as o } from "../pickTopMostHit.js";
+import { adapterPointQuery as s } from "./adapterPointQuery.js";
+import { onBody as c, onEmptyCanvas as l } from "./selectionContributions.js";
+import { createElement as u, useMemo as d, useRef as f } from "react";
+import { useLatest as p } from "@weasel-js/react";
+import { ActionDisabledReason as m } from "@weasel-js/routing";
 //#region src/tools/builtin/select/useSelectTool.ts
-var b = y((e) => e == null);
-function x(y, x) {
-	let S = x.poseDescriptor ?? r, C = x.leafPicking === "silhouette", w = x.pickTolerance ?? 0, T = x.pickEvery ?? ((r, l) => {
-		let u = (r, a, s) => {
-			let c = (e, t, n) => {
-				let o = C ? s : 0;
-				return r >= n.x - o && r <= n.x + n.width + o && a >= n.y - o && a <= n.y + n.height + o ? !C || i(e, t, r, a, { tolerance: s }) : !1;
-			};
-			return {
-				hits: (e, t) => {
-					let i = n(S, e).getBounds(t);
-					if (e.kind !== "container") return c(e, t, i);
-					if (!(r >= i.x && r <= i.x + i.width && a >= i.y && a <= i.y + i.height)) return !1;
-					let s = o(e, t);
-					return s === null || p(s, r, a);
-				},
-				clipAdmits: (e) => p(e, r, a),
-				inPlane: (n) => {
-					let i = t(n, {
-						x: r,
-						y: a
-					});
-					return u(i.x, i.y, s * e(n.scale));
-				}
-			};
-		}, d = x.getView?.() ?? null, f = d ? c(y.getLayers?.(), d) : null;
-		return s(a(y, {
-			...x.alphaOf ? { alphaOf: x.alphaOf } : {},
-			...x.layerIsPainted ? { layerIsPainted: x.layerIsPainted } : {},
-			...f ? { planeOf: f } : {}
-		}), u(r, l, w));
-	}), E = _(T), D = g({ deferredClickId: null }), O = _(x), k = _(y), A = h(() => ({
+function h(h, g) {
+	let _ = g.poseDescriptor ?? e, v = g.leafPicking === "silhouette", y = g.pickTolerance ?? 0, b = g.pickEvery ?? ((e, i) => {
+		let a = g.getView?.() ?? null, o = a ? r(h.getLayers?.(), a) : null;
+		return n(t(h, {
+			...g.alphaOf ? { alphaOf: g.alphaOf } : {},
+			...g.layerIsPainted ? { layerIsPainted: g.layerIsPainted } : {},
+			...o ? { planeOf: o } : {}
+		}), s(_, v)(e, i, y));
+	}), x = p(b), S = f({ deferredClickId: null }), C = p(g), w = p(h), T = d(() => ({
 		id: "select.pick",
 		label: "Select — pick under pointer",
 		eligible: { capability: "creates-selection" },
@@ -61,33 +34,33 @@ function x(y, x) {
 					ctrl: !1,
 					meta: !1,
 					shift: !1
-				}, a = O.current, o = r.get(), s = a.pickBest ? a.pickBest(n.worldX, n.worldY, i.alt, o) : (() => {
-					let e = E.current(n.worldX, n.worldY);
-					return e.length === 0 ? null : d(e, k.current) ?? e[0];
+				}, a = C.current, s = r.get(), c = a.pickBest ? a.pickBest(n.worldX, n.worldY, i.alt, s) : (() => {
+					let e = x.current(n.worldX, n.worldY);
+					return e.length === 0 ? null : o(e, w.current) ?? e[0];
 				})();
-				if (s === null) {
-					D.current = { deferredClickId: null };
+				if (c === null) {
+					S.current = { deferredClickId: null };
 					return;
 				}
-				let c = o.includes(s), l = i.shift || i.meta, u = l && a.extendClickLocked?.() === !0, f = c && o.length > 1 && !l;
-				!f && !u && r.applyClick(s, i), D.current = { deferredClickId: f ? s : null };
+				let l = s.includes(c), u = i.shift || i.meta, d = u && a.extendClickLocked?.() === !0, f = l && s.length > 1 && !u;
+				!f && !d && r.applyClick(c, i), S.current = { deferredClickId: f ? c : null };
 			}
 		}
 	}), [
-		O,
-		E,
-		k
-	]), j = h(() => ({
+		C,
+		x,
+		w
+	]), E = d(() => ({
 		id: "select.collapseDeferred",
 		label: "Select — collapse deferred click",
 		eligible: { capability: "creates-selection" },
 		requires: ["selection"],
-		enabled: () => D.current.deferredClickId !== null || v.NotApplicable,
+		enabled: () => S.current.deferredClickId !== null || m.NotApplicable,
 		invoker: {
 			timing: "immediate",
 			run: (e, t) => {
-				let n = D.current.deferredClickId;
-				if (D.current = { deferredClickId: null }, n === null) return;
+				let n = S.current.deferredClickId;
+				if (S.current = { deferredClickId: null }, n === null) return;
 				let r = e.selection;
 				if (!r) return;
 				let i = t;
@@ -100,8 +73,8 @@ function x(y, x) {
 			}
 		}
 	}), []);
-	return h(() => ({
-		...l({
+	return d(() => ({
+		...i({
 			id: "select",
 			keybinding: { key: "V" },
 			capabilities: ["creates-selection"],
@@ -109,16 +82,16 @@ function x(y, x) {
 			cursor: "default",
 			presentation: {
 				label: "Select",
-				icon: m(u),
+				icon: u(a),
 				group: "select"
 			},
-			actions: [A, j]
+			actions: [T, E]
 		}),
 		bindings: [
 			{
 				spec: {
 					kind: "pointerDown",
-					target: { kindOf: b },
+					target: { kindOf: c },
 					mods: {
 						shift: "optional",
 						alt: "optional",
@@ -131,7 +104,7 @@ function x(y, x) {
 			{
 				spec: {
 					kind: "click",
-					target: { kindOf: b },
+					target: { kindOf: c },
 					mods: {
 						shift: "optional",
 						alt: "optional",
@@ -144,22 +117,22 @@ function x(y, x) {
 			{
 				spec: {
 					kind: "drag",
-					target: { kindOf: f }
+					target: { kindOf: l }
 				},
 				actionId: "areaSelect"
 			},
 			{
 				spec: {
 					kind: "click",
-					target: { kindOf: f },
+					target: { kindOf: l },
 					mods: {}
 				},
 				actionId: "clearSelection"
 			}
 		]
-	}), [A, j]);
+	}), [T, E]);
 }
 //#endregion
-export { x as useSelectTool };
+export { h as useSelectTool };
 
 //# sourceMappingURL=useSelectTool.js.map

package/dist/tools/builtin/select/useSelectTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSelectTool.js","names":["SelectIcon","offChrome","hitPredicate","hit","useSelectTool","d","options","AUTO_POSE_DESCRIPTOR","preciseLeaves","tolerance","pickEveryFn","pointQuery","covers","slop","t","px","b","py","shapeCoversPoint","node","pose","poseDescriptorForNode","own","ownClipOf","pathContainsPoint","clip","p","toPlane","m","meanScale","camera","planeOf","scenePlaneOf","adapter","pickWalk","adapterPickSource","worldX","worldY","pickEveryRef","useLatest","pressRef","useRef","optionsRef","adapterRef","pickAction","useMemo","params","selection","deps","mods","opts","sel","top","ids","pickTopMostHit","hitAlreadySelected","isExtend","extendLocked","deferClick","collapseDeferredAction","ActionDisabledReason","deferred","defineTool","createElement","onEmptyCanvas"],"sources":["../../../../src/tools/builtin/select/useSelectTool.ts"],"sourcesContent":["import { useMemo, useRef, createElement } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { SelectIcon } from '../../../icons';\nimport { pathContainsPoint } from '@weasel-js/geom';\nimport { shapeCoversPoint } from 'canvas/NodeShape';\nimport { pickWalk, adapterPickSource, ownClipOf, scenePlaneOf, type PickQuery } from 'canvas/pickWalk';\nimport { toPlane } from 'core/viewport/parallax';\nimport { meanScale } from 'core/viewport/meanScale';\nimport type { View } from 'core/viewport/view';\nimport type { LayerEnumerableAdapter } from 'core/adapters/types';\nimport type { Node } from 'core/scene/types';\nimport type { MoveAdapter } from 'core/adapters/types';\nimport type { AreaSelectAdapter } from 'core/adapters/types';\nimport type { NodeId } from 'core/scene/types';\nimport { defineTool } from '../../overlayBinding';\nimport type { Action } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport type { Tool } from '../../overlayBinding';\nimport { pickTopMostHit } from '../pickTopMostHit';\nimport { onEmptyCanvas } from './selectionContributions';\nimport { hitPredicate } from '@weasel-js/gestures';\nimport { poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport { AUTO_POSE_DESCRIPTOR } from 'interactions/actions/resize/autoPoseDescriptor';\nimport { MULTI_RESIZE_TARGET_ID, type Bounds } from '../shared/selectionTarget';\nexport type { Bounds };\nexport { MULTI_RESIZE_TARGET_ID };\n\n/** Options for `useSelectTool`: how a point resolves to nodes, how a click\n *  chooses among them, and the appearance of the marquee. */\nexport interface UseSelectToolOptions<TPose> {\n  /** Return ids of all objects whose painted body covers (worldX, worldY).\n   *  Order doesn't matter — the tool collapses parent/child overlap via\n   *  `pickTopMostHit`. When omitted, defaults to an AABB-vs-point scan over\n   *  `adapter.getNodes()` using the pose descriptor. Override for tighter\n   *  shapes (path / polygon hit-tests). */\n  pickEvery?: (worldX: number, worldY: number) => string[];\n  /** Optional alt-aware selection-update hit returning the single id the\n   *  click should act on. */\n  pickBest?: (\n    worldX: number,\n    worldY: number,\n    alt: boolean,\n    selection: readonly string[],\n  ) => string | null;\n  /** How to read poses for the default `pickEvery`. Default\n   *  `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<TPose>;\n  /**\n   * How the default `pickEvery` decides a **leaf** node covers the pointer.\n   * Ignored when `pickEvery` is supplied.\n   *\n   * - `'aabb'` (default) — the pose rect. Cheap, and the historical behavior:\n   *   a click anywhere in the bounding box selects the node.\n   * - `'silhouette'` — the pose rect as a pre-test, then the ink the painter\n   *   lays down: `findShapeSilhouette` filled or not per the painter's `ink`,\n   *   plus its outline widened by the stroke half-width and `pickTolerance`.\n   *   A click inside the bounding box but outside the drawn shape misses —\n   *   the concave notch of a star, the corner outside an ellipse, the blank\n   *   half of a text box — while a click on the thin outline of an unfilled\n   *   shape hits.\n   *\n   * Container nodes already consult their silhouette unconditionally (it is\n   * how their clip is derived); this extends the same test to leaves. Not the\n   * default because it changes what a click selects for every existing\n   * consumer, and a painter with no `silhouette` is unaffected either way —\n   * it falls back to the AABB.\n   */\n  leafPicking?: 'aabb' | 'silhouette';\n  /**\n   * Grab slop around a shape's outline, in **world** units. Default 0.\n   *\n   * Only consulted under `leafPicking: 'silhouette'`. World units because\n   * this hook has no view; `<SceneCanvas>` takes a screen-pixel figure\n   * (`geometry.pickTolerancePx`) and divides by scale on its own pick path.\n   * Without some slop a hairline outline is an unhittable target.\n   */\n  pickTolerance?: number;\n  /** Painted alpha per node in the view this tool picks for. A node painted\n   *  at alpha 0 is not under the pointer. Ignored when `pickEvery` is\n   *  supplied. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node's `layer` reaches the screen in the view this tool picks\n   *  for. Ignored when `pickEvery` is supplied. */\n  layerIsPainted?: (layer: string) => boolean;\n  /** The camera of the view this tool picks for. With it, a node on an\n   *  adapter layer carrying `parallax` (`getLayers`) is picked where that\n   *  camera's plane paints it; without it, every layer is taken to move with\n   *  the camera. Ignored when `pickEvery` is supplied. */\n  getView?: () => View | null;\n  /**\n   * When this returns true, a Shift/Meta extend-click must NOT change the\n   * node selection.\n   *\n   * `<SceneCanvas>` wires it to \"a path is in anchor-edit mode\", where\n   * Shift-click means \"add this anchor to the anchor selection\". Without\n   * the lock the same click also toggles the edited node out of the node\n   * selection, and the `editAnchors` dep treats that as the edit target\n   * disappearing — so multi-selecting anchors silently exited edit mode.\n   *\n   * Only extend-clicks are locked. A plain click still re-selects, so\n   * clicking a different node exits edit mode as usual.\n   */\n  extendClickLocked?: () => boolean;\n}\n\n/** Intersection of the move + area-select adapter interfaces.\n *  Resize and rotate run through `resizeAction` / `rotateAction`. */\nexport type SelectAdapter<TNode extends { id: string }, TPose> =\n  MoveAdapter<TNode, TPose>\n  & AreaSelectAdapter\n  & LayerEnumerableAdapter;\n\n/**\n * What the press classified, carried from `select.pick` (pointerDown) to\n * `select.collapseDeferred` (click) and to the tool's cursor.\n *\n * This is tool-local bookkeeping between two dispatches of the same gesture,\n * so it lives in a ref the tool owns rather than in dispatcher state. It used\n * to be the tool's `SelectScratch`, held by the tool-routing dispatcher, and\n * carried an `ids` list that nothing ever read — `moveAction` computes its own\n * ids from the live selection.\n *\n * @internal\n */\ninterface PressClassification {\n  /**\n   * Set when the press hit an already-selected node inside a multi-selection\n   * with no extend modifier.\n   *\n   * The selection is deliberately NOT collapsed on the press: the user may be\n   * starting a drag of the whole set. If the gesture turns out to be a click,\n   * `select.collapseDeferred` collapses to this id on release.\n   */\n  deferredClickId: string | null;\n}\n\n\n/** A press that landed on the scene rather than on chrome over it. */\nconst offChrome = hitPredicate((hit) => hit == null);\n\n/** Active-slot Tool:\n *  - `select.pick` classifies the press (pointerDown) — it runs the tool's own\n *    pickBest/pickEvery so click semantics (selection replace, extend,\n *    deferred collapse) live in one place.\n *  - an empty drag marquees (`areaSelect`) and a click on empty clears the\n *    selection (`clearSelection`); the marquee renders via the dispatcher\n *    overlay layer, driven by areaSelectAction's `overlay()`.\n *  - moving and transforming the selection are not the tool's: they are the\n *    ambient bindings in `selectionContributions.ts`.\n */\nexport function useSelectTool<TNode extends { id: string }, TPose>(\n  adapter: SelectAdapter<TNode, TPose>,\n  options: UseSelectToolOptions<TPose>,\n): Tool<null> {\n\n  // pickEvery / boundsOf defaults — for any adapter the kit can derive both\n  // from `adapter.getNodes()` + `adapter.getPose(id)` + the descriptor.\n  const d = (options.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const preciseLeaves = options.leafPicking === 'silhouette';\n  // World units here, not screen: this hook has no view. `<SceneCanvas>`\n  // converts from screen px on its own pick path; a bare `useSelectTool`\n  // consumer that zooms should pass `pickTolerance` from its own scale.\n  const tolerance = options.pickTolerance ?? 0;\n  const pickEveryFn = options.pickEvery ?? ((worldX: number, worldY: number): string[] => {\n    /** A point query at (px, py) with `t` world units of slop. AABB first\n     *  (cheap), then the painter's ink when asked for and available. A painter\n     *  with no `silhouette` — or one that returns null, as `kit:text` does for\n     *  an empty node — keeps the AABB answer.\n     *\n     *  The AABB pre-filter is grown by the slop for the same reason\n     *  `<SceneCanvas>`'s is: a shape's outline, and the slop around it, reach\n     *  outside the shape's own bounds, and an un-grown pre-filter would\n     *  discard those hits before the refinement could claim them. */\n    const pointQuery = (px: number, py: number, t: number): PickQuery<TPose> => {\n      const covers = (node: unknown, pose: TPose, b: Bounds): boolean => {\n        const slop = preciseLeaves ? t : 0;\n        if (!(px >= b.x - slop && px <= b.x + b.width + slop\n              && py >= b.y - slop && py <= b.y + b.height + slop)) {\n          return false;\n        }\n        if (!preciseLeaves) return true;\n        return shapeCoversPoint(\n          node as Node<unknown, string, TPose>, pose, px, py, { tolerance: t },\n        );\n      };\n      return {\n        hits: (node, pose) => {\n          const b = poseDescriptorForNode(d, node).getBounds(pose);\n          if (node.kind !== 'container') return covers(node, pose, b);\n          // A container's own clip *is* its hit shape — it is picked where it\n          // paints, and it paints only inside its clip. Ancestor clips are the\n          // walk's business; this one is not.\n          const inAabb = px >= b.x && px <= b.x + b.width\n            && py >= b.y && py <= b.y + b.height;\n          if (!inAabb) return false;\n          const own = ownClipOf(node, pose);\n          return own === null || pathContainsPoint(own, px, py);\n        },\n        clipAdmits: (clip) => pathContainsPoint(clip, px, py),\n        inPlane: (m) => {\n          const p = toPlane(m, { x: px, y: py });\n          return pointQuery(p.x, p.y, t * meanScale(m.scale));\n        },\n      };\n    };\n\n    const camera = options.getView?.() ?? null;\n    const planeOf = camera ? scenePlaneOf(adapter.getLayers?.(), camera) : null;\n    return pickWalk<TPose>(adapterPickSource(adapter as never, {\n      ...(options.alphaOf ? { alphaOf: options.alphaOf } : {}),\n      ...(options.layerIsPainted ? { layerIsPainted: options.layerIsPainted } : {}),\n      ...(planeOf ? { planeOf } : {}),\n    }), pointQuery(worldX, worldY, tolerance));\n  });\n\n  const pickEveryRef = useLatest(pickEveryFn);\n\n  // What the last press classified. Written by `select.pick`, read by\n  // `select.collapseDeferred` and the cursor. See `PressClassification`.\n  const pressRef = useRef<PressClassification>({ deferredClickId: null });\n\n  // Options in a ref so the actions — built once — always see the live\n  // callbacks without rebuilding the Tool record.\n  const optionsRef = useLatest(options);\n  const adapterRef = useLatest(adapter);\n\n  /**\n   * `select.pick` — classifies the press and updates the node selection.\n   *\n   * Bound to `pointerDown` rather than `click` on purpose: pressing an\n   * unselected node must highlight it while the button is still down, and any\n   * drag that follows has to start from the updated selection (both\n   * `moveAction` and `cloneAction` read `selection.get()` in their `start`).\n   *\n   * Eligibility replaces the `selectionAllowed` option the audit added as an\n   * interim per-route patch: this action carries the same\n   * `creates-selection` capability rule the `clearSelection` binding declares,\n   * so a mode that forbids selection now gates both halves of the tool by one\n   * mechanism instead of by which dispatcher the route happened to live on.\n   */\n  const pickAction = useMemo<Action>(() => ({\n    id: 'select.pick',\n    label: 'Select — pick under pointer',\n    eligible: { capability: 'creates-selection' },\n    requires: ['selection'],\n    invoker: {\n      timing: 'immediate' as const,\n      run: (deps, params) => {\n        const p = params as {\n          worldX?: number; worldY?: number;\n          affordance?: unknown;\n          mods?: { alt: boolean; ctrl: boolean; meta: boolean; shift: boolean };\n        } | undefined;\n        const selection = deps.selection;\n        if (!selection || p?.worldX === undefined || p.worldY === undefined) return;\n        const mods = p.mods ?? { alt: false, ctrl: false, meta: false, shift: false };\n        const opts = optionsRef.current;\n\n        const sel = selection.get();\n        const top = opts.pickBest\n          ? opts.pickBest(p.worldX, p.worldY, mods.alt, sel)\n          : (() => {\n              const ids = pickEveryRef.current(p.worldX, p.worldY);\n              if (ids.length === 0) return null;\n              return pickTopMostHit(ids, adapterRef.current) ?? ids[0];\n            })();\n\n        if (top === null) {\n          pressRef.current = { deferredClickId: null };\n          return;\n        }\n\n        const hitAlreadySelected = sel.includes(top as NodeId);\n        const isExtend = mods.shift || mods.meta;\n        // While a path is in anchor-edit mode, an extend-click belongs to the\n        // anchor selection, not the node selection. Letting it through would\n        // toggle the edited node out of the node selection, which the\n        // `editAnchors` dep reads as \"the edit target is gone\" — so\n        // shift-clicking a second anchor silently tore down edit mode.\n        // Plain clicks still fall through: clicking a different node exits\n        // edit mode, which is what you'd expect.\n        //\n        // This stays an option rather than becoming `Action.enabled` because\n        // it only applies to *extend* presses, and `enabled` is evaluated\n        // without the event's modifiers.\n        const extendLocked = isExtend && opts.extendClickLocked?.() === true;\n        const deferClick = hitAlreadySelected && sel.length > 1 && !isExtend;\n        if (!deferClick && !extendLocked) {\n          selection.applyClick(top as NodeId, mods);\n        }\n        pressRef.current = { deferredClickId: deferClick ? top : null };\n      },\n    },\n  }), [optionsRef, pickEveryRef, adapterRef]);\n\n  /**\n   * `select.collapseDeferred` — the release half of the deferred multi-click.\n   *\n   * Pressing an already-selected node inside a multi-selection leaves the\n   * selection alone so the press can start a drag of the whole set. If the\n   * gesture ends without a drag, this collapses to the clicked node.\n   */\n  const collapseDeferredAction = useMemo<Action>(() => ({\n    id: 'select.collapseDeferred',\n    label: 'Select — collapse deferred click',\n    eligible: { capability: 'creates-selection' },\n    requires: ['selection'],\n    // Declining when there is nothing deferred is what keeps this binding\n    // from swallowing every click. It is bound with no target (any click can\n    // in principle be the release of a deferred press) at ACTIVE scope, so\n    // without the gate it would outrank ambient click bindings like\n    // `selectAnchor` and silently break anchor selection. Same fall-through\n    // contract `clearSelection.enabled` relies on.\n    enabled: () =>\n      pressRef.current.deferredClickId !== null\n        ? true\n        : ActionDisabledReason.NotApplicable,\n    invoker: {\n      timing: 'immediate' as const,\n      run: (deps, params) => {\n        const deferred = pressRef.current.deferredClickId;\n        pressRef.current = { deferredClickId: null };\n        if (deferred === null) return;\n        const selection = deps.selection;\n        if (!selection) return;\n        const p = params as {\n          mods?: { alt: boolean; ctrl: boolean; meta: boolean; shift: boolean };\n        } | undefined;\n        selection.applyClick(\n          deferred as NodeId,\n          p?.mods ?? { alt: false, ctrl: false, meta: false, shift: false },\n        );\n      },\n    },\n  }), []);\n\n  return useMemo(\n    () => {\n      const base = defineTool<null>({\n        id: 'select',\n        keybinding: { key: 'V' },\n        capabilities: ['creates-selection'],\n        hookName: 'useSelectTool',\n        // A plain string: the mid-gesture cursors this used to compute from\n        // gesture scratch now live on the actions that own those gestures\n        // (`moveAction.activeCursor`, `areaSelectAction.activeCursor`), so\n        // they apply to any consumer binding them, not just this tool.\n        cursor: 'default',\n        presentation: {\n          label: 'Select',\n          icon: createElement(SelectIcon),\n          group: 'select',\n        },\n        actions: [pickAction, collapseDeferredAction],\n      });\n\n      return {\n        ...base,\n        // Declarative bindings for the gesture dispatcher. The select tool\n        // only chooses: press → classify + select, release → collapse a\n        // deferred multi-click, empty drag → marquee, click on empty → clear.\n        // Moving, cloning, resizing and rotating the selection are ambient\n        // bindings owned by the selection (`selectionContributions.ts`), so\n        // they run under any tool that leaves the gesture unclaimed.\n        bindings: [\n          // Every press that landed on the scene rather than on chrome. This\n          // is the former `initial.pointerDown['*']` route: it classifies the\n          // press and applies the selection change, and it does not consume\n          // the gesture — the same press goes on to open a drag or synthesize\n          // a click.\n          //\n          // The no-affordance target is load-bearing twice over. A press on a\n          // resize handle, a rotate ring, a path anchor, or a registered\n          // layer's own chrome is not a body pick, and re-picking underneath\n          // it would change the selection the user was about to act on. And\n          // because it is expressed in the SPEC rather than as an early\n          // return in the action, the press falls through to whatever owns\n          // that chrome instead of being consumed here — which is how an\n          // ambient binding (`@weasel-js/hud`) gets to see it at all. The old\n          // pipeline got both properties by construction: affordance hits\n          // bypassed the active tool entirely.\n          //\n          // Modifiers are all `'optional'` because they are *data* here\n          // (forwarded to `SelectionApi.applyClick`, which resolves them\n          // against the host's configured extend key) rather than a route.\n          {\n            spec: {\n              kind: 'pointerDown' as const,\n              target: { kindOf: offChrome },\n              mods: { shift: 'optional' as const, alt: 'optional' as const, meta: 'optional' as const, ctrl: 'optional' as const },\n            },\n            actionId: 'select.pick',\n          },\n          // Release half of the deferred multi-click. Same `'optional'`\n          // modifiers, same reason.\n          {\n            spec: {\n              kind: 'click' as const,\n              target: { kindOf: offChrome },\n              mods: { shift: 'optional' as const, alt: 'optional' as const, meta: 'optional' as const, ctrl: 'optional' as const },\n            },\n            actionId: 'select.collapseDeferred',\n          },\n          // Empty drag → marquee. `onEmptyCanvas` rather than a bare `'empty'`\n          // target: the ambient bindings that own the handles rank below this\n          // active one, so `'empty'` took drags that start on them.\n          {\n            spec: { kind: 'drag' as const, target: { kindOf: onEmptyCanvas } },\n            actionId: 'areaSelect',\n          },\n          // resize/rotate bind only drag (no click), so a click on either handle\n          // (body genuinely empty) would hit target:'empty' and wrongly clear selection.\n          {\n            spec: {\n              kind: 'click' as const,\n              target: { kindOf: onEmptyCanvas },\n              mods: {},\n            },\n            actionId: 'clearSelection',\n          },\n        ],\n      };\n    },\n    [pickAction, collapseDeferredAction],\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"useSelectTool.js","names":["SelectIcon","useSelectTool","d","options","AUTO_POSE_DESCRIPTOR","preciseLeaves","tolerance","pickEveryFn","camera","planeOf","scenePlaneOf","adapter","pickWalk","adapterPickSource","adapterPointQuery","worldX","worldY","pickEveryRef","useLatest","pressRef","useRef","optionsRef","adapterRef","pickAction","useMemo","p","params","selection","deps","mods","opts","sel","top","ids","pickTopMostHit","hitAlreadySelected","isExtend","extendLocked","deferClick","collapseDeferredAction","ActionDisabledReason","deferred","defineTool","createElement","onBody","onEmptyCanvas"],"sources":["../../../../src/tools/builtin/select/useSelectTool.ts"],"sourcesContent":["import { useMemo, useRef, createElement } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { SelectIcon } from '../../../icons';\nimport { pickWalk, adapterPickSource, scenePlaneOf } from 'canvas/pickWalk';\nimport type { View } from 'core/viewport/view';\nimport type { LayerEnumerableAdapter } from 'core/adapters/types';\nimport type { MoveAdapter } from 'core/adapters/types';\nimport type { AreaSelectAdapter } from 'core/adapters/types';\nimport type { NodeId } from 'core/scene/types';\nimport { defineTool } from '../../overlayBinding';\nimport type { Action } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport type { Tool } from '../../overlayBinding';\nimport { pickTopMostHit } from '../pickTopMostHit';\nimport { adapterPointQuery } from './adapterPointQuery';\nimport { onBody, onEmptyCanvas } from './selectionContributions';\nimport type { PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { MULTI_RESIZE_TARGET_ID, type Bounds } from '../shared/selectionTarget';\nexport type { Bounds };\nexport { MULTI_RESIZE_TARGET_ID };\n\n/** Options for `useSelectTool`: how a point resolves to nodes, how a click\n *  chooses among them, and the appearance of the marquee. */\nexport interface UseSelectToolOptions<TPose> {\n  /** Return ids of all objects whose painted body covers (worldX, worldY).\n   *  Order doesn't matter — the tool collapses parent/child overlap via\n   *  `pickTopMostHit`. When omitted, defaults to an AABB-vs-point walk of\n   *  the adapter's tree using the pose descriptor. Override for tighter\n   *  shapes (path / polygon hit-tests). */\n  pickEvery?: (worldX: number, worldY: number) => string[];\n  /** Optional alt-aware selection-update hit returning the single id the\n   *  click should act on. */\n  pickBest?: (\n    worldX: number,\n    worldY: number,\n    alt: boolean,\n    selection: readonly string[],\n  ) => string | null;\n  /** How to read poses for the default `pickEvery`. Default\n   *  `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<TPose>;\n  /**\n   * How the default `pickEvery` decides a **leaf** node covers the pointer.\n   * Ignored when `pickEvery` is supplied.\n   *\n   * - `'aabb'` (default) — the pose rect: a click anywhere in the bounding\n   *   box selects the node.\n   * - `'silhouette'` — the pose rect as a pre-test, then the ink the painter\n   *   lays down: `findShapeSilhouette` filled or not per the painter's `ink`,\n   *   plus its outline widened by the stroke half-width and `pickTolerance`.\n   *   A click inside the bounding box but outside the drawn shape misses —\n   *   the concave notch of a star, the corner outside an ellipse, the blank\n   *   half of a text box — while a click on the thin outline of an unfilled\n   *   shape hits.\n   *\n   * Container nodes already consult their silhouette unconditionally (it is\n   * how their clip is derived). A painter with no `silhouette` falls back to\n   * the AABB.\n   */\n  leafPicking?: 'aabb' | 'silhouette';\n  /**\n   * Grab slop around a shape's outline, in **world** units. Default 0.\n   *\n   * Only consulted under `leafPicking: 'silhouette'`. World units because\n   * this hook has no view; `<SceneCanvas>` takes a screen-pixel figure\n   * (`geometry.pickTolerancePx`) and divides by scale on its own pick path.\n   * Without some slop a hairline outline is an unhittable target.\n   */\n  pickTolerance?: number;\n  /** Painted alpha per node in the view this tool picks for. A node painted\n   *  at alpha 0 is not under the pointer. Ignored when `pickEvery` is\n   *  supplied. */\n  alphaOf?: (id: string) => number;\n  /** Whether a node's `layer` reaches the screen in the view this tool picks\n   *  for. Ignored when `pickEvery` is supplied. */\n  layerIsPainted?: (layer: string) => boolean;\n  /** The camera of the view this tool picks for. With it, a node on an\n   *  adapter layer carrying `parallax` (`getLayers`) is picked where that\n   *  camera's plane paints it; without it, every layer is taken to move with\n   *  the camera. Ignored when `pickEvery` is supplied. */\n  getView?: () => View | null;\n  /**\n   * When this returns true, a Shift/Meta extend-click must NOT change the\n   * node selection.\n   *\n   * `<SceneCanvas>` wires it to \"a path is in anchor-edit mode\", where\n   * Shift-click means \"add this anchor to the anchor selection\". Without\n   * the lock the same click also toggles the edited node out of the node\n   * selection, and the `editAnchors` dep treats that as the edit target\n   * disappearing.\n   *\n   * Only extend-clicks are locked. A plain click still re-selects, so\n   * clicking a different node exits edit mode as usual.\n   */\n  extendClickLocked?: () => boolean;\n}\n\n/** Intersection of the move + area-select adapter interfaces.\n *  Resize and rotate run through `resizeAction` / `rotateAction`. */\nexport type SelectAdapter<TNode extends { id: string }, TPose> =\n  MoveAdapter<TNode, TPose>\n  & AreaSelectAdapter\n  & LayerEnumerableAdapter;\n\n/**\n * What the press classified, carried from `select.pick` (pointerDown) to\n * `select.collapseDeferred` (click) and to the tool's cursor.\n *\n * This is tool-local bookkeeping between two dispatches of the same gesture,\n * so it lives in a ref the tool owns rather than in dispatcher state.\n *\n * @internal\n */\ninterface PressClassification {\n  /**\n   * Set when the press hit an already-selected node inside a multi-selection\n   * with no extend modifier.\n   *\n   * The selection is deliberately NOT collapsed on the press: the user may be\n   * starting a drag of the whole set. If the gesture turns out to be a click,\n   * `select.collapseDeferred` collapses to this id on release.\n   */\n  deferredClickId: string | null;\n}\n\n\n\n/** Active-slot Tool:\n *  - `select.pick` classifies the press (pointerDown) — it runs the tool's own\n *    pickBest/pickEvery so click semantics (selection replace, extend,\n *    deferred collapse) live in one place.\n *  - an empty drag marquees (`areaSelect`) and a click on empty clears the\n *    selection (`clearSelection`); the marquee renders via the dispatcher\n *    overlay layer, driven by areaSelectAction's `overlay()`.\n *  - moving and transforming the selection are not the tool's: they are the\n *    ambient bindings in `selectionContributions.ts`.\n */\nexport function useSelectTool<TNode extends { id: string }, TPose>(\n  adapter: SelectAdapter<TNode, TPose>,\n  options: UseSelectToolOptions<TPose>,\n): Tool {\n\n  // pickEvery / boundsOf defaults — for any adapter the kit can derive both\n  // from the adapter's tree + `adapter.getPose(id)` + the descriptor.\n  const d = (options.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const preciseLeaves = options.leafPicking === 'silhouette';\n  const tolerance = options.pickTolerance ?? 0;\n  const pickEveryFn = options.pickEvery ?? ((worldX: number, worldY: number): string[] => {\n    const camera = options.getView?.() ?? null;\n    const planeOf = camera ? scenePlaneOf(adapter.getLayers?.(), camera) : null;\n    return pickWalk<TPose>(adapterPickSource(adapter, {\n      ...(options.alphaOf ? { alphaOf: options.alphaOf } : {}),\n      ...(options.layerIsPainted ? { layerIsPainted: options.layerIsPainted } : {}),\n      ...(planeOf ? { planeOf } : {}),\n    }), adapterPointQuery(d, preciseLeaves)(worldX, worldY, tolerance));\n  });\n\n  const pickEveryRef = useLatest(pickEveryFn);\n\n  // What the last press classified. Written by `select.pick`, read by\n  // `select.collapseDeferred` and the cursor. See `PressClassification`.\n  const pressRef = useRef<PressClassification>({ deferredClickId: null });\n\n  // Options in a ref so the actions — built once — always see the live\n  // callbacks without rebuilding the Tool record.\n  const optionsRef = useLatest(options);\n  const adapterRef = useLatest(adapter);\n\n  /**\n   * `select.pick` — classifies the press and updates the node selection.\n   *\n   * Bound to `pointerDown` rather than `click` on purpose: pressing an\n   * unselected node must highlight it while the button is still down, and any\n   * drag that follows has to start from the updated selection (both\n   * `moveAction` and `cloneAction` read `selection.get()` in their `start`).\n   */\n  const pickAction = useMemo<Action>(() => ({\n    id: 'select.pick',\n    label: 'Select — pick under pointer',\n    eligible: { capability: 'creates-selection' },\n    requires: ['selection'],\n    invoker: {\n      timing: 'immediate' as const,\n      run: (deps, params) => {\n        const p = params as {\n          worldX?: number; worldY?: number;\n          affordance?: unknown;\n          mods?: { alt: boolean; ctrl: boolean; meta: boolean; shift: boolean };\n        } | undefined;\n        const selection = deps.selection;\n        if (!selection || p?.worldX === undefined || p.worldY === undefined) return;\n        const mods = p.mods ?? { alt: false, ctrl: false, meta: false, shift: false };\n        const opts = optionsRef.current;\n\n        const sel = selection.get();\n        const top = opts.pickBest\n          ? opts.pickBest(p.worldX, p.worldY, mods.alt, sel)\n          : (() => {\n              const ids = pickEveryRef.current(p.worldX, p.worldY);\n              if (ids.length === 0) return null;\n              return pickTopMostHit(ids, adapterRef.current) ?? ids[0];\n            })();\n\n        if (top === null) {\n          pressRef.current = { deferredClickId: null };\n          return;\n        }\n\n        const hitAlreadySelected = sel.includes(top as NodeId);\n        const isExtend = mods.shift || mods.meta;\n        // See `extendClickLocked`. An option rather than `Action.enabled`\n        // because it only applies to *extend* presses, and `enabled` is\n        // evaluated without the event's modifiers.\n        const extendLocked = isExtend && opts.extendClickLocked?.() === true;\n        const deferClick = hitAlreadySelected && sel.length > 1 && !isExtend;\n        if (!deferClick && !extendLocked) {\n          selection.applyClick(top as NodeId, mods);\n        }\n        pressRef.current = { deferredClickId: deferClick ? top : null };\n      },\n    },\n  }), [optionsRef, pickEveryRef, adapterRef]);\n\n  /**\n   * `select.collapseDeferred` — the release half of the deferred multi-click.\n   *\n   * Pressing an already-selected node inside a multi-selection leaves the\n   * selection alone so the press can start a drag of the whole set. If the\n   * gesture ends without a drag, this collapses to the clicked node.\n   */\n  const collapseDeferredAction = useMemo<Action>(() => ({\n    id: 'select.collapseDeferred',\n    label: 'Select — collapse deferred click',\n    eligible: { capability: 'creates-selection' },\n    requires: ['selection'],\n    // Declining when there is nothing deferred is what keeps this binding\n    // from swallowing every click on a node. It is bound at ACTIVE scope, so\n    // without the gate it would outrank ambient click bindings like\n    // `selectAnchor` and silently break anchor selection.\n    enabled: () =>\n      pressRef.current.deferredClickId !== null\n        ? true\n        : ActionDisabledReason.NotApplicable,\n    invoker: {\n      timing: 'immediate' as const,\n      run: (deps, params) => {\n        const deferred = pressRef.current.deferredClickId;\n        pressRef.current = { deferredClickId: null };\n        if (deferred === null) return;\n        const selection = deps.selection;\n        if (!selection) return;\n        const p = params as {\n          mods?: { alt: boolean; ctrl: boolean; meta: boolean; shift: boolean };\n        } | undefined;\n        selection.applyClick(\n          deferred as NodeId,\n          p?.mods ?? { alt: false, ctrl: false, meta: false, shift: false },\n        );\n      },\n    },\n  }), []);\n\n  return useMemo(\n    () => {\n      const base = defineTool({\n        id: 'select',\n        keybinding: { key: 'V' },\n        capabilities: ['creates-selection'],\n        hookName: 'useSelectTool',\n        // The mid-gesture cursors live on the actions that own those gestures\n        // (`moveAction.activeCursor`, `areaSelectAction.activeCursor`).\n        cursor: 'default',\n        presentation: {\n          label: 'Select',\n          icon: createElement(SelectIcon),\n          group: 'select',\n        },\n        actions: [pickAction, collapseDeferredAction],\n      });\n\n      return {\n        ...base,\n        // Declarative bindings for the gesture dispatcher. The select tool\n        // only chooses: press → classify + select, release → collapse a\n        // deferred multi-click, empty drag → marquee, click on empty → clear.\n        // Moving, cloning, resizing and rotating the selection are ambient\n        // bindings owned by the selection (`selectionContributions.ts`), so\n        // they run under any tool that leaves the gesture unclaimed.\n        bindings: [\n          // Every press that landed on the scene rather than on chrome. It\n          // classifies the press and applies the selection change, and it does\n          // not consume the gesture — the same press goes on to open a drag or\n          // synthesize a click.\n          //\n          // The no-affordance target is load-bearing twice over. A press on a\n          // resize handle, a rotate ring, a path anchor, or a registered\n          // layer's own chrome is not a body pick, and re-picking underneath\n          // it would change the selection the user was about to act on. And\n          // because it is expressed in the SPEC rather than as an early\n          // return in the action, the press falls through to whatever owns\n          // that chrome instead of being consumed here — which is how an\n          // ambient binding (`@weasel-js/hud`) gets to see it at all.\n          //\n          // Modifiers are all `'optional'` because they are *data* here\n          // (forwarded to `SelectionApi.applyClick`) rather than a route.\n          {\n            spec: {\n              kind: 'pointerDown' as const,\n              target: { kindOf: onBody },\n              mods: { shift: 'optional' as const, alt: 'optional' as const, meta: 'optional' as const, ctrl: 'optional' as const },\n            },\n            actionId: 'select.pick',\n          },\n          // Release half of the deferred multi-click, modifiers as above. On a node\n          // only: a drag leaves a deferral unspent, and a click on empty must clear.\n          {\n            spec: {\n              kind: 'click' as const,\n              target: { kindOf: onBody },\n              mods: { shift: 'optional' as const, alt: 'optional' as const, meta: 'optional' as const, ctrl: 'optional' as const },\n            },\n            actionId: 'select.collapseDeferred',\n          },\n          // Empty drag → marquee. `onEmptyCanvas` rather than a bare `'empty'`\n          // target: the ambient bindings that own the handles rank below this\n          // active one, so `'empty'` took drags that start on them.\n          {\n            spec: { kind: 'drag' as const, target: { kindOf: onEmptyCanvas } },\n            actionId: 'areaSelect',\n          },\n          // resize/rotate bind only drag (no click), so a click on either handle\n          // (body genuinely empty) would hit target:'empty' and wrongly clear selection.\n          {\n            spec: {\n              kind: 'click' as const,\n              target: { kindOf: onEmptyCanvas },\n              mods: {},\n            },\n            actionId: 'clearSelection',\n          },\n        ],\n      };\n    },\n    [pickAction, collapseDeferredAction],\n  );\n}\n"],"mappings":"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"}

package/dist/tools/builtin/shared/pointerFollower.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointerFollower.js","names":["createPointerFollower","pointer","off","next","onMove"],"sources":["../../../../src/tools/builtin/shared/pointerFollower.ts"],"sourcesContent":["import type { PointerContextValue } from 'features/pointer/PointerContext';\n\n/** A tool's subscription to the `pointer` dep, held only while it has\n *  something trailing to the pointer. */\nexport interface PointerFollower {\n  /** The store being followed, or `null`. */\n  pointer(): PointerContextValue | null;\n  /** Start following `next`; a no-op for the store already followed. */\n  follow(next: PointerContextValue | undefined): void;\n  unfollow(): void;\n}\n\n/** `onMove` runs after every change of the followed pointer. */\nexport function createPointerFollower(onMove: () => void): PointerFollower {\n  let pointer: PointerContextValue | null = null;\n  let off: (() => void) | null = null;\n  return {\n    pointer: () => pointer,\n    follow(next) {\n      if (!next || next === pointer) return;\n      off?.();\n      pointer = next;\n      off = next.subscribe(onMove);\n    },\n    unfollow() {\n      off?.();\n      off = null;\n      pointer = null;\n    },\n  };\n}\n"],"mappings":";AAaA,SAAgBA,EAAsB,GAAqC;CACzE,IAAIC,IAAsC,MACtCC,IAA2B;CAC/B,OAAO;EACL,eAAeD;EACf,OAAO,GAAM;GACX,AAAKE,KAAQA,MAASF,MACtBC,IAAM,GACN,IAAUC,GACV,IAAMA,EAAK,UAAUC,CAAM;EAC7B;EACA,WAAW;GAGT,AAFAF,IAAM,GACN,IAAM,MACN,IAAU;EACZ;CACF;AACF"}
+{"version":3,"file":"pointerFollower.js","names":["createPointerFollower","pointer","off","next","onMove"],"sources":["../../../../src/tools/builtin/shared/pointerFollower.ts"],"sourcesContent":["import type { PointerContextValue } from '@weasel-js/routing/react';\n\n/** A tool's subscription to the `pointer` dep, held only while it has\n *  something trailing to the pointer. */\nexport interface PointerFollower {\n  /** The store being followed, or `null`. */\n  pointer(): PointerContextValue | null;\n  /** Start following `next`; a no-op for the store already followed. */\n  follow(next: PointerContextValue | undefined): void;\n  unfollow(): void;\n}\n\n/** `onMove` runs after every change of the followed pointer. */\nexport function createPointerFollower(onMove: () => void): PointerFollower {\n  let pointer: PointerContextValue | null = null;\n  let off: (() => void) | null = null;\n  return {\n    pointer: () => pointer,\n    follow(next) {\n      if (!next || next === pointer) return;\n      off?.();\n      pointer = next;\n      off = next.subscribe(onMove);\n    },\n    unfollow() {\n      off?.();\n      off = null;\n      pointer = null;\n    },\n  };\n}\n"],"mappings":";AAaA,SAAgBA,EAAsB,GAAqC;CACzE,IAAIC,IAAsC,MACtCC,IAA2B;CAC/B,OAAO;EACL,eAAeD;EACf,OAAO,GAAM;GACX,AAAKE,KAAQA,MAASF,MACtBC,IAAM,GACN,IAAUC,GACV,IAAMA,EAAK,UAAUC,CAAM;EAC7B;EACA,WAAW;GAGT,AAFAF,IAAM,GACN,IAAM,MACN,IAAU;EACZ;CACF;AACF"}