@weasel-js/core 1.15.0 → 1.15.1

package/dist/tools/builtin/image/useImageTool.js

@@ -2,7 +2,7 @@ import { defineTool } from "../../overlayBinding.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useMemo } from "react";
 
-//#region src/tools/builtin/image/useImageTool.tsx
+// src/tools/builtin/image/useImageTool.tsx
 /**
 * Drag-to-insert image tool. A drag-rect commits a leaf node with
 * `data: { image: { src } }` through the dispatcher's `insertAction` + the
@@ -46,6 +46,5 @@ function useImageTool(options) {
 	]);
 }
 
-//#endregion
 export { useImageTool };
 //# sourceMappingURL=useImageTool.js.map

package/dist/tools/builtin/lasso/useLassoTool.js

@@ -2,7 +2,7 @@ import { defineTool } from "../../overlayBinding.js";
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/tools/builtin/lasso/useLassoTool.ts
+// src/tools/builtin/lasso/useLassoTool.ts
 /** Free-form polygon select Tool. Drag is handled entirely by the gesture
 *  dispatcher via the `lassoSelect` action binding below; the dispatcher
 *  overlay layer (`useDispatcherOverlayLayer`) paints the live polyline +
@@ -50,6 +50,5 @@ function useLassoTool(options = {}) {
 	]);
 }
 
-//#endregion
 export { useLassoTool };
 //# sourceMappingURL=useLassoTool.js.map

package/dist/tools/builtin/line/useLineTool.js

@@ -1,10 +1,10 @@
-import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { defineTool } from "../../overlayBinding.js";
+import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useMemo } from "react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/line/useLineTool.tsx
+// src/tools/builtin/line/useLineTool.tsx
 /**
 * Drag-to-draw line tool. The `drag` binding routes to `insertAction`, which
 * commits through the `insert` dep with `{ kind: 'line', a, b }` endpoints
@@ -38,6 +38,5 @@ function useLineTool(options = {}) {
 	}), [behaviors]);
 }
 
-//#endregion
 export { useLineTool };
 //# sourceMappingURL=useLineTool.js.map

package/dist/tools/builtin/measure/useMeasureTool.js

@@ -1,10 +1,10 @@
 import { defineTool } from "../../overlayBinding.js";
-import { MEASURE_ACTION_IDS } from "../../../domains/measure/actionIds.js";
 import { measureCreateAction, measurePickAtAction } from "../../../domains/measure/measureGestures.js";
+import { MEASURE_ACTION_IDS } from "../../../domains/measure/actionIds.js";
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/tools/builtin/measure/useMeasureTool.ts
+// src/tools/builtin/measure/useMeasureTool.ts
 /**
 * Measure tool. A drag adds a measurement from press to release in world
 * units — both ends through the `snap` dep, Shift holding the angle to
@@ -86,6 +86,5 @@ function useMeasureTool(options) {
 	]);
 }
 
-//#endregion
 export { useMeasureTool };
 //# sourceMappingURL=useMeasureTool.js.map

package/dist/tools/builtin/pen/penHandle.js

@@ -2,7 +2,7 @@ import { SNAP_AXIS_STEP, SNAP_ROLES, snapMods } from "../../../domains/snap/role
 import { inputSession } from "../../../domains/snap/session2d.js";
 import { roleReader } from "@weasel-js/routing";
 
-//#region src/tools/builtin/pen/penHandle.ts
+// src/tools/builtin/pen/penHandle.ts
 /** The pen's handle drag: the modifiers it reads, and where it puts the handle. */
 /** The modifiers the pen's handle drag reads on the press, every move, and
 *  the release: Alt breaks the new anchor's mirror, Shift holds the handle to
@@ -53,6 +53,5 @@ function pullHandle(s, ctx, linked) {
 	};
 }
 
-//#endregion
 export { PEN_HANDLE_ROLES, pullHandle };
 //# sourceMappingURL=penHandle.js.map

package/dist/tools/builtin/pen/usePenTool.js

@@ -1,12 +1,12 @@
-import { asNodeId } from "../../../core/scene/types.js";
-import { defaultCommitAdapter } from "../../../interactions/actions/defaultCommitAdapter.js";
-import { snapMods } from "../../../domains/snap/roles.js";
-import { createDeleteOp } from "../../../core/ops/delete.js";
-import { resolveEditablePathOf } from "../../../domains/paths/editablePath.js";
 import { defineTool } from "../../overlayBinding.js";
+import { asNodeId } from "../../../core/scene/types.js";
 import { createPenPreviewLayer, penReachOf } from "../../../domains/paths/penPreviewLayer.js";
+import { resolveEditablePathOf } from "../../../domains/paths/editablePath.js";
+import { createDeleteOp } from "../../../core/ops/delete.js";
+import { defaultCommitAdapter } from "../../../interactions/actions/defaultCommitAdapter.js";
 import { PEN_HANDLE_ROLES, pullHandle } from "./penHandle.js";
 import { pointSnap } from "../../../domains/snap/pointSnap.js";
+import { snapMods } from "../../../domains/snap/roles.js";
 import { createPointerFollower } from "../shared/pointerFollower.js";
 import { anchorsToPath, boundsOfPath, editAnchorSetTracked, nearestPathAnchor, pathToAnchors, pxExtent, reverseAnchors, withinPxRadius, worldCoords } from "@weasel-js/geom";
 import { useCallback, useMemo, useReducer, useRef, useState } from "react";
@@ -14,7 +14,7 @@ import { useKitSettings, useLatest } from "@weasel-js/react";
 import { ActionDisabledReason } from "@weasel-js/routing";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/pen/usePenTool.ts
+// src/tools/builtin/pen/usePenTool.ts
 function freshScratch() {
 	return {
 		finishedSubpaths: [],
@@ -617,6 +617,5 @@ function samePath(a, b) {
 	return ac.every((v, i) => v === bc[i]);
 }
 
-//#endregion
 export { usePenTool };
 //# sourceMappingURL=usePenTool.js.map

package/dist/tools/builtin/pencil/usePencilTool.js

@@ -3,7 +3,7 @@ import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useMemo } from "react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/pencil/usePencilTool.tsx
+// src/tools/builtin/pencil/usePencilTool.tsx
 /**
 * Freehand pencil tool. The `drag` binding routes to `insertAction`,
 * which accumulates the pointer trail and commits it as
@@ -38,6 +38,5 @@ function usePencilTool(options = {}) {
 	}), [behaviors]);
 }
 
-//#endregion
 export { usePencilTool };
 //# sourceMappingURL=usePencilTool.js.map

package/dist/tools/builtin/pickTopMostHit.js

@@ -1,4 +1,4 @@
-//#region src/tools/builtin/pickTopMostHit.ts
+// src/tools/builtin/pickTopMostHit.ts
 /** Reduce a set of hit ids to the single one a click should act on: drop any
 *  id that is an ancestor of another in the set, then take the topmost of what
 *  remains. A child beats its own ancestor regardless of what z the two report.
@@ -57,6 +57,5 @@ function zOf(getZIndex, id) {
 	return typeof z === "number" && Number.isFinite(z) ? z : -Infinity;
 }
 
-//#endregion
 export { pickTopMostHit };
 //# sourceMappingURL=pickTopMostHit.js.map

package/dist/tools/builtin/polygon/usePolygonTool.js

@@ -1,11 +1,11 @@
-import { SHAPE_COUNT_RANGE } from "../../../domains/paths/shapeGenerator.js";
-import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { defineTool } from "../../overlayBinding.js";
+import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
+import { SHAPE_COUNT_RANGE } from "../../../domains/paths/shapeGenerator.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/polygon/usePolygonTool.tsx
+// src/tools/builtin/polygon/usePolygonTool.tsx
 /**
 * Drag-from-center polygon tool. Pointerdown sets center; drag
 * determines radius + rotation; release commits via `insertAction` (the
@@ -109,6 +109,5 @@ function usePolygonTool(options = {}) {
 	]);
 }
 
-//#endregion
 export { usePolygonTool };
 //# sourceMappingURL=usePolygonTool.js.map

package/dist/tools/builtin/pressTarget.js

@@ -1,4 +1,4 @@
-//#region src/tools/builtin/pressTarget.ts
+// src/tools/builtin/pressTarget.ts
 /**
 * The node a press on `hitId` selects: the outermost group above it that is
 * below `entered`, or `hitId` itself when there is none. With nothing entered
@@ -17,6 +17,5 @@ function pressTarget(tree, hitId, entered) {
 	return target;
 }
 
-//#endregion
 export { pressTarget };
 //# sourceMappingURL=pressTarget.js.map

package/dist/tools/builtin/rect/useRectTool.js

@@ -1,10 +1,10 @@
-import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { defineTool } from "../../overlayBinding.js";
+import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useMemo } from "react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/rect/useRectTool.ts
+// src/tools/builtin/rect/useRectTool.ts
 /**
 * Drag-to-draw rectangle tool.
 *
@@ -38,6 +38,5 @@ function useRectTool(options = {}) {
 	}), [behaviors]);
 }
 
-//#endregion
 export { useRectTool };
 //# sourceMappingURL=useRectTool.js.map

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

@@ -1,10 +1,10 @@
-import { toPlane } from "../../../core/viewport/parallax.js";
-import { poseDescriptorForNode } from "../../../core/geometry/poseDescriptor.js";
 import { shapeCoversPoint } from "../../../canvas/NodeShape.js";
 import { ownClipOf } from "../../../canvas/ownClip.js";
+import { poseDescriptorForNode } from "../../../core/geometry/poseDescriptor.js";
+import { toPlane } from "../../../core/viewport/parallax.js";
 import { applyToPoint, boundsOfPath, meanScale, pathContainsPoint } from "@weasel-js/geom";
 
-//#region src/tools/builtin/select/adapterPointQuery.ts
+// src/tools/builtin/select/adapterPointQuery.ts
 /**
 * The point query `useSelectTool`'s default `pickEvery` asks of a bare adapter:
 * a point at (px, py) with `t` world units of slop. AABB first (cheap), then
@@ -53,6 +53,5 @@ function adapterPointQuery(d, preciseLeaves) {
 	return pointQuery;
 }
 
-//#endregion
 export { adapterPointQuery };
 //# sourceMappingURL=adapterPointQuery.js.map

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

@@ -1,6 +1,6 @@
 import { ActionDisabledReason } from "@weasel-js/routing";
 
-//#region src/tools/builtin/select/collapseDeferred.ts
+// src/tools/builtin/select/collapseDeferred.ts
 /**
 * `select.collapseDeferred` — the release half of the deferred multi-click.
 *
@@ -35,6 +35,5 @@ function createCollapseDeferredAction(pressRef) {
 	};
 }
 
-//#endregion
 export { createCollapseDeferredAction };
 //# sourceMappingURL=collapseDeferred.js.map

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

@@ -1,9 +1,9 @@
-import { onBody, onEmptyCanvas } from "./selectionContributions.js";
 import { createEnterGroupAction, createLeaveGroupAction } from "../../../interactions/actions/defaults/enterGroup.js";
+import { onBody, onEmptyCanvas } from "./selectionContributions.js";
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/tools/builtin/select/groupEntry.ts
+// src/tools/builtin/select/groupEntry.ts
 /** Id of the entry {@link createGroupEntryContribution} builds. */
 var GROUP_ENTRY_ID = "group.entry";
 var INITIAL = [{
@@ -77,6 +77,5 @@ var GROUP_LEAVE_PRESS_BINDING = {
 	opts: { id: "group.leave.press" }
 };
 
-//#endregion
 export { GROUP_ENTRY_ID, GROUP_LEAVE_PRESS_BINDING, createGroupEntryContribution, useGroupEntryContribution };
 //# sourceMappingURL=groupEntry.js.map

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

@@ -1,7 +1,7 @@
 import { isEnvelope } from "../../../core/scene/effectivePose.js";
-import { selectedAncestor } from "../../../interactions/actions/selectionSubtree.js";
+import { holderOf } from "@weasel-js/select";
 
-//#region src/tools/builtin/select/pressDecision.ts
+// src/tools/builtin/select/pressDecision.ts
 /**
 * Decide a press with no extend modifier on `top`, and one with it.
 *
@@ -22,11 +22,10 @@ function pressDecision(top, sel, mods, extendLocked, tree) {
 }
 function insideSelectedGroup(top, sel, tree) {
 	if (sel.includes(top)) return false;
-	const ancestor = selectedAncestor((id) => tree.getParent(id), top, new Set(sel));
+	const ancestor = holderOf(new Set(sel), top, (id) => tree.getParent(id));
 	const node = ancestor === null ? void 0 : tree.getNode(ancestor);
 	return node !== void 0 && isEnvelope(node);
 }
 
-//#endregion
 export { pressDecision };
 //# sourceMappingURL=pressDecision.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"pressDecision.js","names":[],"sources":["../../../../src/tools/builtin/select/pressDecision.ts"],"sourcesContent":["import { isEnvelope } from 'core/scene/effectivePose';\nimport { selectedAncestor } from '../../../interactions/actions/selectionSubtree';\n\n/** The tree a press reads: who a node's parent is, and the node itself. */\nexport interface PressTree {\n  getParent(id: string): string | null;\n  getNode(id: string): unknown;\n}\n\n/** What a press on `top` does to the selection. */\nexport interface PressDecision {\n  /** Apply the click to the selection on the press. */\n  applyNow: boolean;\n  /** The id the click is held back for until release, so the press can drag\n   *  what is already selected instead; `null` when nothing is held back. */\n  deferred: string | null;\n}\n\n/**\n * Decide a press with no extend modifier on `top`, and one with it.\n *\n * Pressing a member of a multi-selection, or a node inside a selected group,\n * leaves the selection alone: the press may be the start of a drag of the\n * set, or of the group. A group here is a container whose pose derives from\n * its children; one with its own pose is a place its members sit, and a press\n * picks the member out of it.\n */\nexport function pressDecision(\n  top: string,\n  sel: readonly string[],\n  mods: { shift: boolean; meta: boolean },\n  extendLocked: () => boolean,\n  tree: PressTree,\n): PressDecision {\n  const isExtend = mods.shift;\n  const inMultiSelection = sel.includes(top) && sel.length > 1;\n  const defer = !isExtend && (inMultiSelection || insideSelectedGroup(top, sel, tree));\n  return { applyNow: !defer && !(isExtend && extendLocked()), deferred: defer ? top : null };\n}\n\nfunction insideSelectedGroup(top: string, sel: readonly string[], tree: PressTree): boolean {\n  if (sel.includes(top)) return false;\n  const ancestor = selectedAncestor((id) => tree.getParent(id), top, new Set(sel));\n  const node = ancestor === null ? undefined : tree.getNode(ancestor) as { dependsOn?: unknown; derivePose?: unknown } | undefined;\n  return node !== undefined && isEnvelope(node);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,cACd,KACA,KACA,MACA,cACA,MACe;CACf,MAAM,WAAW,KAAK;CACtB,MAAM,mBAAmB,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS;CAC3D,MAAM,QAAQ,CAAC,aAAa,oBAAoB,oBAAoB,KAAK,KAAK,IAAI;CAClF,OAAO;EAAE,UAAU,CAAC,SAAS,EAAE,YAAY,aAAa;EAAI,UAAU,QAAQ,MAAM;CAAK;AAC3F;AAEA,SAAS,oBAAoB,KAAa,KAAwB,MAA0B;CAC1F,IAAI,IAAI,SAAS,GAAG,GAAG,OAAO;CAC9B,MAAM,WAAW,kBAAkB,OAAO,KAAK,UAAU,EAAE,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC;CAC/E,MAAM,OAAO,aAAa,OAAO,SAAY,KAAK,QAAQ,QAAQ;CAClE,OAAO,SAAS,UAAa,WAAW,IAAI;AAC9C"}
+{"version":3,"file":"pressDecision.js","names":[],"sources":["../../../../src/tools/builtin/select/pressDecision.ts"],"sourcesContent":["import { isEnvelope } from 'core/scene/effectivePose';\nimport { holderOf } from '@weasel-js/select';\n\n/** The tree a press reads: who a node's parent is, and the node itself. */\nexport interface PressTree {\n  getParent(id: string): string | null;\n  getNode(id: string): unknown;\n}\n\n/** What a press on `top` does to the selection. */\nexport interface PressDecision {\n  /** Apply the click to the selection on the press. */\n  applyNow: boolean;\n  /** The id the click is held back for until release, so the press can drag\n   *  what is already selected instead; `null` when nothing is held back. */\n  deferred: string | null;\n}\n\n/**\n * Decide a press with no extend modifier on `top`, and one with it.\n *\n * Pressing a member of a multi-selection, or a node inside a selected group,\n * leaves the selection alone: the press may be the start of a drag of the\n * set, or of the group. A group here is a container whose pose derives from\n * its children; one with its own pose is a place its members sit, and a press\n * picks the member out of it.\n */\nexport function pressDecision(\n  top: string,\n  sel: readonly string[],\n  mods: { shift: boolean; meta: boolean },\n  extendLocked: () => boolean,\n  tree: PressTree,\n): PressDecision {\n  const isExtend = mods.shift;\n  const inMultiSelection = sel.includes(top) && sel.length > 1;\n  const defer = !isExtend && (inMultiSelection || insideSelectedGroup(top, sel, tree));\n  return { applyNow: !defer && !(isExtend && extendLocked()), deferred: defer ? top : null };\n}\n\nfunction insideSelectedGroup(top: string, sel: readonly string[], tree: PressTree): boolean {\n  if (sel.includes(top)) return false;\n  const ancestor = holderOf(new Set(sel), top, (id) => tree.getParent(id));\n  const node = ancestor === null ? undefined : tree.getNode(ancestor) as { dependsOn?: unknown; derivePose?: unknown } | undefined;\n  return node !== undefined && isEnvelope(node);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,cACd,KACA,KACA,MACA,cACA,MACe;CACf,MAAM,WAAW,KAAK;CACtB,MAAM,mBAAmB,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS;CAC3D,MAAM,QAAQ,CAAC,aAAa,oBAAoB,oBAAoB,KAAK,KAAK,IAAI;CAClF,OAAO;EAAE,UAAU,CAAC,SAAS,EAAE,YAAY,aAAa;EAAI,UAAU,QAAQ,MAAM;CAAK;AAC3F;AAEA,SAAS,oBAAoB,KAAa,KAAwB,MAA0B;CAC1F,IAAI,IAAI,SAAS,GAAG,GAAG,OAAO;CAC9B,MAAM,WAAW,SAAS,IAAI,IAAI,GAAG,GAAG,MAAM,OAAO,KAAK,UAAU,EAAE,CAAC;CACvE,MAAM,OAAO,aAAa,OAAO,SAAY,KAAK,QAAQ,QAAQ;CAClE,OAAO,SAAS,UAAa,WAAW,IAAI;AAC9C"}

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

@@ -2,7 +2,7 @@ import { gestureLifecycleParams } from "../../../interactions/actions/gestureLif
 import { isPathEditPart, isResizeHandle, isRotateHandle } from "@weasel-js/routing";
 import { hitPredicate } from "@weasel-js/gestures";
 
-//#region src/tools/builtin/select/selectionContributions.ts
+// src/tools/builtin/select/selectionContributions.ts
 /** Id of the entry {@link selectionMoveContribution} builds. */
 var SELECTION_MOVE_ID = "selection.move";
 /** Id of the entry {@link selectionTransformContribution} builds. */
@@ -172,6 +172,5 @@ function areaSelectContribution() {
 	};
 }
 
-//#endregion
 export { AREA_SELECT_ID, SELECTION_MOVE_ID, SELECTION_RESIZE_ID, SELECTION_ROTATE_ID, SELECTION_TRANSFORM_ID, areaSelectContribution, onBody, onEmptyCanvas, selectionMoveBindings, selectionMoveContribution, selectionResizeBindings, selectionResizeContribution, selectionRotateBindings, selectionRotateContribution, selectionTransformBindings, selectionTransformContribution };
 //# sourceMappingURL=selectionContributions.js.map

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

@@ -1,21 +1,21 @@
-import { AUTO_POSE_DESCRIPTOR } from "../../../core/geometry/autoPoseDescriptor.js";
+import { pickWalk } from "../../../canvas/pickWalk.js";
 import { MULTI_RESIZE_TARGET_ID } from "../../../core/selection/selectionTarget.js";
 import { scenePlaneOf } from "../../../canvas/scenePickSource.js";
 import { adapterPickSource } from "../../../canvas/adapterPickSource.js";
-import { pickWalk } from "../../../canvas/pickWalk.js";
-import { pressTarget } from "../pressTarget.js";
-import { onBody, onEmptyCanvas } from "./selectionContributions.js";
 import { defineTool } from "../../overlayBinding.js";
 import { pickTopMostHit } from "../pickTopMostHit.js";
+import { pressTarget } from "../pressTarget.js";
 import { pressDecision } from "./pressDecision.js";
 import { createCollapseDeferredAction } from "./collapseDeferred.js";
 import { GROUP_LEAVE_PRESS_BINDING } from "./groupEntry.js";
 import { createSelectDeepAction } from "../../../interactions/actions/defaults/selectDeep.js";
 import { adapterPointQuery } from "./adapterPointQuery.js";
+import { onBody, onEmptyCanvas } from "./selectionContributions.js";
+import { AUTO_POSE_DESCRIPTOR } from "../../../core/geometry/autoPoseDescriptor.js";
 import { useCallback, useMemo, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/tools/builtin/select/useSelectTool.ts
+// src/tools/builtin/select/useSelectTool.ts
 /** Active-slot Tool:
 *  - `select.pick` classifies the press (pointerDown) — it runs the tool's own
 *    pickBest/pickEvery so click semantics (selection replace, extend,
@@ -199,6 +199,5 @@ function useSelectTool(adapter, options) {
 	]);
 }
 
-//#endregion
 export { useSelectTool };
 //# sourceMappingURL=useSelectTool.js.map

package/dist/tools/builtin/shared/insertToolOptions.js

@@ -1,9 +1,8 @@
-//#region src/tools/builtin/shared/insertToolOptions.ts
+// src/tools/builtin/shared/insertToolOptions.ts
 /** The insert binding's `opts.behaviors` entry, left out when there are none. */
 function insertBindingBehaviors(behaviors) {
 	return behaviors?.length ? { behaviors: [...behaviors] } : {};
 }
 
-//#endregion
 export { insertBindingBehaviors };
 //# sourceMappingURL=insertToolOptions.js.map

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

@@ -1,4 +1,4 @@
-//#region src/tools/builtin/shared/pointerFollower.ts
+// src/tools/builtin/shared/pointerFollower.ts
 /** `onMove` runs after every change of the followed pointer. */
 function createPointerFollower(onMove) {
 	let pointer = null;
@@ -19,6 +19,5 @@ function createPointerFollower(onMove) {
 	};
 }
 
-//#endregion
 export { createPointerFollower };
 //# sourceMappingURL=pointerFollower.js.map

package/dist/tools/builtin/slice/useSliceTool.js

@@ -1,16 +1,16 @@
-import { viewToTransform } from "../../../core/viewport/view.js";
-import { worldToScreen } from "../../../core/viewport/viewTransform.js";
-import { OVERLAY_ROLE_STROKES } from "../../../canvas/overlayRoleStrokes.js";
-import { sliceAction } from "../../../interactions/actions/defaults/slice.js";
 import { defineTool } from "../../overlayBinding.js";
 import { createPointerFollower } from "../shared/pointerFollower.js";
+import { sliceAction } from "../../../interactions/actions/defaults/slice.js";
+import { worldToScreen } from "../../../core/viewport/viewTransform.js";
+import { viewToTransform } from "../../../core/viewport/view.js";
+import { OVERLAY_ROLE_STROKES } from "../../../canvas/overlayRoleStrokes.js";
 import { ellipsePath, polylineFromPoints, withinPxRadius } from "@weasel-js/geom";
 import { createEmitter } from "@weasel-js/registry";
 import { useMemo, useRef } from "react";
 import { useKitSettings, useLatest } from "@weasel-js/react";
 import { ActionDisabledReason } from "@weasel-js/routing";
 
-//#region src/tools/builtin/slice/useSliceTool.ts
+// src/tools/builtin/slice/useSliceTool.ts
 var VERTEX_RADIUS_PX = 3;
 /** How near the first point, in screen px, a click closes the cut. */
 var SLICE_CLOSE_HIT_PX = 8;
@@ -308,6 +308,5 @@ function useSliceTool(options = {}) {
 	]);
 }
 
-//#endregion
 export { SLICE_CLOSE_HIT_PX, VERTEX_RADIUS_PX, useSliceTool };
 //# sourceMappingURL=useSliceTool.js.map

package/dist/tools/builtin/star/useStarTool.js

@@ -1,12 +1,12 @@
-import { SHAPE_COUNT_RANGE } from "../../../domains/paths/shapeGenerator.js";
-import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { defineTool } from "../../overlayBinding.js";
+import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
+import { SHAPE_COUNT_RANGE } from "../../../domains/paths/shapeGenerator.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/star/useStarTool.tsx
+// src/tools/builtin/star/useStarTool.tsx
 /**
 * Drag-from-center star tool. Pointerdown sets center; drag determines
 * outer radius + rotation; release commits via `insertAction`. Inner
@@ -111,6 +111,5 @@ function useStarTool(options = {}) {
 	]);
 }
 
-//#endregion
 export { useStarTool };
 //# sourceMappingURL=useStarTool.js.map

package/dist/tools/builtin/sticky/stickyNode.js

@@ -1,6 +1,6 @@
 import { DEFAULT_TEXT_FILL } from "@weasel-js/text";
 
-//#region src/tools/builtin/sticky/stickyNode.ts
+// src/tools/builtin/sticky/stickyNode.ts
 /** The look a sticky note takes for any field its tool leaves out. */
 var STICKY_DEFAULTS = {
 	background: { paint: {
@@ -47,6 +47,5 @@ function stickyData(look) {
 *  wraps it — to tag the data with a `kind`, say — under `insertNodeFactories`. */
 var stickyNodeFactory = (_bounds, extras) => ({ data: stickyData(extras) });
 
-//#endregion
 export { STICKY_DEFAULTS, stickyData, stickyNodeFactory };
 //# sourceMappingURL=stickyNode.js.map

package/dist/tools/builtin/sticky/useStickyTool.js

@@ -1,11 +1,11 @@
-import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { defineTool } from "../../overlayBinding.js";
+import { INSERT_REPOSITION_BINDING } from "../../../interactions/actions/insert/repositionAction.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { STICKY_DEFAULTS } from "./stickyNode.js";
 import { useMemo } from "react";
 import { cursorFor } from "@weasel-js/cursor";
 
-//#region src/tools/builtin/sticky/useStickyTool.ts
+// src/tools/builtin/sticky/useStickyTool.ts
 /**
 * Sticky-note tool. A drag draws a note through `insertAction`, a click
 * places one of `size` through `placeAction`, and either drops into the new
@@ -86,6 +86,5 @@ function useStickyTool(options = {}) {
 	]);
 }
 
-//#endregion
 export { useStickyTool };
 //# sourceMappingURL=useStickyTool.js.map

package/dist/tools/builtin/text/useTextTool.js

@@ -2,7 +2,7 @@ import { defineTool } from "../../overlayBinding.js";
 import { insertBindingBehaviors } from "../shared/insertToolOptions.js";
 import { useMemo } from "react";
 
-//#region src/tools/builtin/text/useTextTool.ts
+// src/tools/builtin/text/useTextTool.ts
 var PRESENTATION = {
 	label: "Text",
 	icon: /* @icon */ "core:text",
@@ -218,6 +218,5 @@ useTextTool.options = {
 	}
 };
 
-//#endregion
 export { useTextTool };
 //# sourceMappingURL=useTextTool.js.map

package/dist/tools/index.js

@@ -24,6 +24,6 @@ import { useStarTool } from "./builtin/star/useStarTool.js";
 import { usePencilTool } from "./builtin/pencil/usePencilTool.js";
 import { useSliceTool } from "./builtin/slice/useSliceTool.js";
 import { useMeasureTool } from "./builtin/measure/useMeasureTool.js";
-import { createToolOptionValues, isToolSet, steppedOption, toolIdsOf as toolIdsOf$1, toolOptionParams, toolOptionSteps, toolSet as toolSet$1, toolSetHas, withoutTools } from "@weasel-js/routing";
+import { createToolOptionValues, isToolSet, steppedOption, toolIdsOf as toolIdsOf$1, toolOptionParams as toolOptionParams$1, toolOptionSteps, toolSet as toolSet$1, toolSetHas, withoutTools } from "@weasel-js/routing";
 
-export { ANCHORS_TOOL_ID, AREA_SELECT_ID, DRAG_PAN_ID, GROUP_ENTRY_ID, SELECTION_MOVE_ID, SELECTION_RESIZE_ID, SELECTION_ROTATE_ID, SELECTION_TRANSFORM_ID, STICKY_DEFAULTS, anchorsTool, areaSelectContribution, createGroupEntryContribution, createPointerFollower, createToolOptionValues, defineTool, dragPanContribution, isToolSet, onEmptyCanvas, pickTopMostHit, selectionMoveBindings, selectionMoveContribution, selectionResizeBindings, selectionResizeContribution, selectionRotateBindings, selectionRotateContribution, selectionTransformBindings, selectionTransformContribution, steppedOption, stickyData, stickyNodeFactory, toolIdsOf$1 as toolIdsOf, toolOptionParams, toolOptionSteps, toolSet$1 as toolSet, toolSetHas, useEllipseTool, useEyedropperTool, useGroupEntryContribution, useHandTool, useImageTool, useKeybindings, useLassoTool, useLineTool, useMeasureTool, usePenTool, usePencilTool, usePolygonTool, useRectTool, useSelectTool, useSliceTool, useStarTool, useStickyTool, useTextTool, useToolOptionTunings, useToolOptionValues, useTools, withoutTools };
+export { ANCHORS_TOOL_ID, AREA_SELECT_ID, DRAG_PAN_ID, GROUP_ENTRY_ID, SELECTION_MOVE_ID, SELECTION_RESIZE_ID, SELECTION_ROTATE_ID, SELECTION_TRANSFORM_ID, STICKY_DEFAULTS, anchorsTool, areaSelectContribution, createGroupEntryContribution, createPointerFollower, createToolOptionValues, defineTool, dragPanContribution, isToolSet, onEmptyCanvas, pickTopMostHit, selectionMoveBindings, selectionMoveContribution, selectionResizeBindings, selectionResizeContribution, selectionRotateBindings, selectionRotateContribution, selectionTransformBindings, selectionTransformContribution, steppedOption, stickyData, stickyNodeFactory, toolIdsOf$1 as toolIdsOf, toolOptionParams$1 as toolOptionParams, toolOptionSteps, toolSet$1 as toolSet, toolSetHas, useEllipseTool, useEyedropperTool, useGroupEntryContribution, useHandTool, useImageTool, useKeybindings, useLassoTool, useLineTool, useMeasureTool, usePenTool, usePencilTool, usePolygonTool, useRectTool, useSelectTool, useSliceTool, useStarTool, useStickyTool, useTextTool, useToolOptionTunings, useToolOptionValues, useTools, withoutTools };

package/dist/tools/overlayBinding.js

@@ -1,10 +1,9 @@
 import { defineTool } from "@weasel-js/routing";
 import { useTools } from "@weasel-js/routing/react";
 
-//#region src/tools/overlayBinding.ts
+// src/tools/overlayBinding.ts
 /** Routing's `useTools`, typed for `RenderLayer` overlays. */
 var useTools$1 = useTools;
 
-//#endregion
 export { defineTool, useTools$1 as useTools };
 //# sourceMappingURL=overlayBinding.js.map

package/dist/tools/toolOptions.js

@@ -1,7 +1,8 @@
 import { useEffect } from "react";
+import { toolOptionParams } from "@weasel-js/routing";
 import { useDepSource, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/tools/toolOptions.ts
+// src/tools/toolOptions.ts
 /**
 * The canvas side of tool options (`ToolDef.options`): publishing where their
 * values live, and tuning each tool's action from them.
@@ -17,16 +18,29 @@ function heldOptions(toolId, options, values) {
 	for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === "number") out[key] = held[key];
 	return out;
 }
+/** Write each of `toolId`'s options that `params` sets to a new value into `values`. */
+function keepOptions(toolId, options, values, params) {
+	if (!values) return;
+	const now = toolOptionParams(toolId, options, values);
+	for (const key of Object.keys(options.prefs.children)) {
+		const v = params[key];
+		if (typeof v === "number" && Number.isFinite(v) && v !== now[key]) values.set(toolId, key, v);
+	}
+}
 /** Tune each tool's options action with the values the `toolOptionValues` dep
 *  holds, read on every invocation: only those it holds, so an option it does
 *  not leaves the action's own default, or another tuning's value, in place.
-*  Returns a release. */
+*  The options and the action's last-operation panel are one setting: a value
+*  the panel sets is written back to the dep. Returns a release. */
 function tuneToolOptions(registry, deps, tools) {
 	const releases = [];
 	for (const tool of tools) {
 		const options = tool.options;
 		if (!options) continue;
-		releases.push(registry.tune(options.actionId, { params: () => heldOptions(tool.id, options, deps?.get("toolOptionValues")) }));
+		releases.push(registry.tune(options.actionId, {
+			params: () => heldOptions(tool.id, options, deps?.get("toolOptionValues")),
+			keep: (params) => keepOptions(tool.id, options, deps?.get("toolOptionValues"), params)
+		}));
 	}
 	return () => {
 		for (const r of releases) r();
@@ -42,6 +56,5 @@ function useToolOptionTunings(registry, tools) {
 	]);
 }
 
-//#endregion
 export { tuneToolOptions, useToolOptionTunings, useToolOptionValues };
 //# sourceMappingURL=toolOptions.js.map

package/dist/tools/toolOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolOptions.js","names":[],"sources":["../../src/tools/toolOptions.ts"],"sourcesContent":["/**\n * The canvas side of tool options (`ToolDef.options`): publishing where their\n * values live, and tuning each tool's action from them.\n */\nimport { useEffect } from 'react';\nimport type { ToolOptions, ToolOptionValues } from '@weasel-js/routing';\nimport { useDepSource, useOptionalDepRegistry, type DepRegistry } from '@weasel-js/routing/react';\nimport type { ActionsRegistry } from '@weasel-js/routing';\nimport type { Tool } from './overlayBinding';\n\n/** Publish where the host keeps its tools' option values, as the `toolOptionValues`\n *  dep. Silently does nothing outside a `<DepRegistryProvider>`. */\nexport function useToolOptionValues(values: ToolOptionValues): void {\n  useDepSource('toolOptionValues', () => values);\n}\n\nfunction heldOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined): Record<string, number> {\n  const held = values?.get(toolId) ?? {};\n  const out: Record<string, number> = {};\n  for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === 'number') out[key] = held[key];\n  return out;\n}\n\n/** Tune each tool's options action with the values the `toolOptionValues` dep\n *  holds, read on every invocation: only those it holds, so an option it does\n *  not leaves the action's own default, or another tuning's value, in place.\n *  Returns a release. */\nexport function tuneToolOptions(\n  registry: Pick<ActionsRegistry, 'tune'>,\n  deps: Pick<DepRegistry, 'get'> | null,\n  tools: Iterable<Tool>,\n): () => void {\n  const releases: Array<() => void> = [];\n  for (const tool of tools) {\n    const options = tool.options;\n    if (!options) continue;\n    releases.push(registry.tune(options.actionId, {\n      params: () => heldOptions(tool.id, options, deps?.get('toolOptionValues')),\n    }));\n  }\n  return () => { for (const r of releases) r(); };\n}\n\n/** {@link tuneToolOptions} for as long as the component is mounted. */\nexport function useToolOptionTunings(registry: Pick<ActionsRegistry, 'tune'> | null, tools: Readonly<Record<string, Tool>>): void {\n  const deps = useOptionalDepRegistry();\n  useEffect(() => (registry ? tuneToolOptions(registry, deps, Object.values(tools)) : undefined), [registry, deps, tools]);\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,oBAAoB,QAAgC;CAClE,aAAa,0BAA0B,MAAM;AAC/C;AAEA,SAAS,YAAY,QAAgB,SAAsB,QAA8D;CACvH,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,CAAC;CACrC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG,IAAI,OAAO,KAAK,SAAS,UAAU,IAAI,OAAO,KAAK;CAC1G,OAAO;AACT;;;;;AAMA,SAAgB,gBACd,UACA,MACA,OACY;CACZ,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;EACd,SAAS,KAAK,SAAS,KAAK,QAAQ,UAAU,EAC5C,cAAc,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,CAAC,EAC3E,CAAC,CAAC;CACJ;CACA,aAAa;EAAE,KAAK,MAAM,KAAK,UAAU,EAAE;CAAG;AAChD;;AAGA,SAAgB,qBAAqB,UAAgD,OAA6C;CAChI,MAAM,OAAO,uBAAuB;CACpC,gBAAiB,WAAW,gBAAgB,UAAU,MAAM,OAAO,OAAO,KAAK,CAAC,IAAI,QAAY;EAAC;EAAU;EAAM;CAAK,CAAC;AACzH"}
+{"version":3,"file":"toolOptions.js","names":[],"sources":["../../src/tools/toolOptions.ts"],"sourcesContent":["/**\n * The canvas side of tool options (`ToolDef.options`): publishing where their\n * values live, and tuning each tool's action from them.\n */\nimport { useEffect } from 'react';\nimport { toolOptionParams, type ToolOptions, type ToolOptionValues } from '@weasel-js/routing';\nimport { useDepSource, useOptionalDepRegistry, type DepRegistry } from '@weasel-js/routing/react';\nimport type { ActionsRegistry } from '@weasel-js/routing';\nimport type { Tool } from './overlayBinding';\n\n/** Publish where the host keeps its tools' option values, as the `toolOptionValues`\n *  dep. Silently does nothing outside a `<DepRegistryProvider>`. */\nexport function useToolOptionValues(values: ToolOptionValues): void {\n  useDepSource('toolOptionValues', () => values);\n}\n\nfunction heldOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined): Record<string, number> {\n  const held = values?.get(toolId) ?? {};\n  const out: Record<string, number> = {};\n  for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === 'number') out[key] = held[key];\n  return out;\n}\n\n/** Write each of `toolId`'s options that `params` sets to a new value into `values`. */\nfunction keepOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined, params: Readonly<Record<string, unknown>>): void {\n  if (!values) return;\n  const now = toolOptionParams(toolId, options, values);\n  for (const key of Object.keys(options.prefs.children)) {\n    const v = params[key];\n    if (typeof v === 'number' && Number.isFinite(v) && v !== now[key]) values.set(toolId, key, v);\n  }\n}\n\n/** Tune each tool's options action with the values the `toolOptionValues` dep\n *  holds, read on every invocation: only those it holds, so an option it does\n *  not leaves the action's own default, or another tuning's value, in place.\n *  The options and the action's last-operation panel are one setting: a value\n *  the panel sets is written back to the dep. Returns a release. */\nexport function tuneToolOptions(\n  registry: Pick<ActionsRegistry, 'tune'>,\n  deps: Pick<DepRegistry, 'get'> | null,\n  tools: Iterable<Tool>,\n): () => void {\n  const releases: Array<() => void> = [];\n  for (const tool of tools) {\n    const options = tool.options;\n    if (!options) continue;\n    releases.push(registry.tune(options.actionId, {\n      params: () => heldOptions(tool.id, options, deps?.get('toolOptionValues')),\n      keep: (params) => keepOptions(tool.id, options, deps?.get('toolOptionValues'), params),\n    }));\n  }\n  return () => { for (const r of releases) r(); };\n}\n\n/** {@link tuneToolOptions} for as long as the component is mounted. */\nexport function useToolOptionTunings(registry: Pick<ActionsRegistry, 'tune'> | null, tools: Readonly<Record<string, Tool>>): void {\n  const deps = useOptionalDepRegistry();\n  useEffect(() => (registry ? tuneToolOptions(registry, deps, Object.values(tools)) : undefined), [registry, deps, tools]);\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,oBAAoB,QAAgC;CAClE,aAAa,0BAA0B,MAAM;AAC/C;AAEA,SAAS,YAAY,QAAgB,SAAsB,QAA8D;CACvH,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,CAAC;CACrC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG,IAAI,OAAO,KAAK,SAAS,UAAU,IAAI,OAAO,KAAK;CAC1G,OAAO;AACT;;AAGA,SAAS,YAAY,QAAgB,SAAsB,QAAsC,QAAiD;CAChJ,IAAI,CAAC,QAAQ;CACb,MAAM,MAAM,iBAAiB,QAAQ,SAAS,MAAM;CACpD,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG;EACrD,MAAM,IAAI,OAAO;EACjB,IAAI,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,KAAK,MAAM,IAAI,MAAM,OAAO,IAAI,QAAQ,KAAK,CAAC;CAC9F;AACF;;;;;;AAOA,SAAgB,gBACd,UACA,MACA,OACY;CACZ,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;EACd,SAAS,KAAK,SAAS,KAAK,QAAQ,UAAU;GAC5C,cAAc,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,CAAC;GACzE,OAAO,WAAW,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,GAAG,MAAM;EACvF,CAAC,CAAC;CACJ;CACA,aAAa;EAAE,KAAK,MAAM,KAAK,UAAU,EAAE;CAAG;AAChD;;AAGA,SAAgB,qBAAqB,UAAgD,OAA6C;CAChI,MAAM,OAAO,uBAAuB;CACpC,gBAAiB,WAAW,gBAAgB,UAAU,MAAM,OAAO,OAAO,KAAK,CAAC,IAAI,QAAY;EAAC;EAAU;EAAM;CAAK,CAAC;AACzH"}

package/dist/tools/useKeybindings.js

@@ -5,7 +5,7 @@ import { useLatest } from "@weasel-js/react";
 import { useActionsRegistry } from "@weasel-js/routing/react";
 import { eligibleForMode } from "@weasel-js/modes";
 
-//#region src/tools/useKeybindings.ts
+// src/tools/useKeybindings.ts
 /** Wire the single-key tool-activation shortcuts (V, P, T, …) and Escape to
 *  return to the default tool. Activation is gated on what the active mode
 *  allows, so a key cannot reach a tool the palette greys out. */
@@ -67,6 +67,5 @@ function useKeybindings(tools, options = {}) {
 	]);
 }
 
-//#endregion
 export { useKeybindings };
 //# sourceMappingURL=useKeybindings.js.map

package/dist/{types-DW14eu9B.d.ts → types-BUvUXZe5.d.ts}

@@ -861,9 +861,9 @@ interface NodeBase<TData, TLayer extends string, TPose> {
      *  undo entry as the change. A drag reads it too: it is the layout `move`
      *  reflows and drops against. */
     layout?: LayoutStrategy<TPose>;
-    /** The units its children are shown, typed and snapped in (their poses stay
-     *  in world units), and what one base unit is worth in the enclosing scope's.
-     *  It covers the children, not the node; `sceneUnitScopes` reads the chain. */
+    /** The units its children are shown, typed and snapped in (poses stay in the root's base units), their
+     *  worth in the enclosing scope's, and the magnification they are drawn at (`drawnAt`). It covers the
+     *  children, not the node; `sceneUnitScopes` reads the chain. */
     units?: UnitScope;
 }
 /** A node that is drawn and picked as one thing — a shape, a label, an image.