@weasel-js/core 1.15.0 → 1.15.2

package/dist/interactions/actions/rotate/replay.js

@@ -1,9 +1,9 @@
 import { shapeSources } from "../selectionSubtree.js";
-import { storedPreviews } from "./frame.js";
 import { rotateOps } from "./commit.js";
+import { storedPreviews } from "./frame.js";
 import { captureTurn } from "./session.js";
 
-//#region src/interactions/actions/rotate/replay.ts
+// src/interactions/actions/rotate/replay.ts
 /** The ops that turn `selected` by `angle` radians the way a rotate drag
 *  would: about the selection's center, or each node about its own. */
 function rotateSelectionOps(scene, selected, deps, angle, pivot, label) {
@@ -21,6 +21,5 @@ function rotateSelectionOps(scene, selected, deps, angle, pivot, label) {
 	return rotateOps([...turn.origins.keys()], originPoses, previews, label);
 }
 
-//#endregion
 export { rotateSelectionOps };
 //# sourceMappingURL=replay.js.map

package/dist/interactions/actions/rotate/session.js

@@ -1,20 +1,20 @@
-import { unionAABB } from "../../../core/geometry/unionBounds.js";
-import { scenePoseFrame } from "../poseFrame.js";
-import { nodeDescriptors, poseDescriptorOf } from "../poseDescriptorDep.js";
+import { pointerStateOf } from "../pointerState.js";
 import { transformFinisher } from "../transformFinish.js";
+import { sceneGestureFrames } from "../gestureFrames.js";
+import { unionAABB } from "../../../core/geometry/unionBounds.js";
+import { gestureReaders } from "../../gestures/shared/screenTolerance.js";
 import { readGestureLifecycle } from "../gestureLifecycle.js";
+import { moveGestureAdapter } from "../move/gestureAdapter.js";
 import { carryPose, invertPlane, planeOf } from "../planeInput.js";
-import { gestureReaders } from "../../gestures/shared/screenTolerance.js";
-import { shapeSources } from "../selectionSubtree.js";
-import { pointerStateOf } from "../pointerState.js";
+import { nodeDescriptors, poseDescriptorOf } from "../poseDescriptorDep.js";
+import { scenePoseFrame } from "../poseFrame.js";
 import { drawnBoxes } from "../drawnBoxes.js";
-import { sceneGestureFrames } from "../gestureFrames.js";
-import { moveGestureAdapter } from "../move/gestureAdapter.js";
-import { SNAP_ANGLE_STEP } from "../../../domains/snap/roles.js";
+import { shapeSources } from "../selectionSubtree.js";
 import { inputSession } from "../../../domains/snap/session2d.js";
+import { SNAP_ANGLE_STEP } from "../../../domains/snap/roles.js";
 import { resolveParams } from "@weasel-js/routing";
 
-//#region src/interactions/actions/rotate/session.ts
+// src/interactions/actions/rotate/session.ts
 function captureOrigins(view, scene, ids, descriptorOf, poseFrame, boxes) {
 	const originPoses = /* @__PURE__ */ new Map();
 	const origins = /* @__PURE__ */ new Map();
@@ -138,6 +138,5 @@ function beginRotate(ctx, opts) {
 	};
 }
 
-//#endregion
 export { beginRotate, captureTurn };
 //# sourceMappingURL=session.js.map

package/dist/interactions/actions/selectionSubtree.js

@@ -1,28 +1,14 @@
-import { poseDescriptorForNode, translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { asNodeId } from "../../core/scene/types.js";
-import { sceneMutators } from "../../core/scene/sceneMutators.js";
 import { createTransformOp } from "../../core/ops/transform.js";
+import { sceneMutators } from "../../core/scene/sceneMutators.js";
+import { poseDescriptorForNode, translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
+import { outermost } from "@weasel-js/select";
 
-//#region src/interactions/actions/selectionSubtree.ts
-/** True when any ancestor of `id` is also in `set` — acting on that ancestor
-*  already reaches this node, so acting on it again would double it. */
-function hasSelectedAncestor(parentOf, id, set) {
-	return selectedAncestor(parentOf, id, set) !== null;
-}
-/** The nearest ancestor of `id` that is in `set`, or `null`. */
-function selectedAncestor(parentOf, id, set) {
-	let parent = parentOf(id);
-	while (parent != null) {
-		if (set.has(parent)) return parent;
-		parent = parentOf(parent);
-	}
-	return null;
-}
-/** The ids in `ids` that are in the scene and have no selected ancestor. */
+// src/interactions/actions/selectionSubtree.ts
+/** The ids in `ids` that are in the scene and that no ancestor in `ids` holds. */
 function selectedRoots(scene, ids) {
-	const set = new Set(ids);
 	const parentOf = (id) => scene.get(asNodeId(id))?.parent ?? null;
-	return ids.map((id) => asNodeId(id)).filter((id) => scene.get(id) !== void 0 && !hasSelectedAncestor(parentOf, id, set));
+	return outermost(ids, parentOf).map((id) => asNodeId(id)).filter((id) => scene.get(id) !== void 0);
 }
 /** Whether `id` draws a path derived from other nodes. Its pose is a
 *  placeholder: the path follows the nodes it derives from. */
@@ -149,6 +135,5 @@ function storedDelta(frame, descriptor, id, dx, dy) {
 	};
 }
 
-//#endregion
-export { hasSelectedAncestor, moveSources, selectedAncestor, selectedRoots, shapeSources, storedDelta, subtreeIds, translateEach, translateTargets };
+export { moveSources, selectedRoots, shapeSources, storedDelta, subtreeIds, translateEach, translateTargets };
 //# sourceMappingURL=selectionSubtree.js.map

package/dist/interactions/actions/selectionSubtree.js.map

@@ -1 +1 @@
-{"version":3,"file":"selectionSubtree.js","names":[],"sources":["../../../src/interactions/actions/selectionSubtree.ts"],"sourcesContent":["import type { NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport type { PoseFrame } from './poseFrame';\nimport type { TransformFinisher } from './transformFinish';\nimport { createTransformOp } from 'core/ops/transform';\nimport { sceneMutators } from 'core/scene/sceneMutators';\nimport { poseDescriptorForNode, translatePoseViaDescriptor, type PoseDescriptor } from 'core/geometry/poseDescriptor';\n\ntype AnyScene = Scene<unknown, string, unknown>;\n\n/** True when any ancestor of `id` is also in `set` — acting on that ancestor\n *  already reaches this node, so acting on it again would double it. */\nexport function hasSelectedAncestor(\n  parentOf: (id: string) => string | null,\n  id: string,\n  set: ReadonlySet<string>,\n): boolean {\n  return selectedAncestor(parentOf, id, set) !== null;\n}\n\n/** The nearest ancestor of `id` that is in `set`, or `null`. */\nexport function selectedAncestor(\n  parentOf: (id: string) => string | null,\n  id: string,\n  set: ReadonlySet<string>,\n): string | null {\n  let parent = parentOf(id);\n  while (parent != null) {\n    if (set.has(parent)) return parent;\n    parent = parentOf(parent);\n  }\n  return null;\n}\n\n/** The ids in `ids` that are in the scene and have no selected ancestor. */\nexport function selectedRoots(scene: AnyScene, ids: readonly string[]): NodeId[] {\n  const set = new Set<string>(ids);\n  const parentOf = (id: string) => scene.get(asNodeId(id))?.parent ?? null;\n  return ids\n    .map((id) => asNodeId(id))\n    .filter((id) => scene.get(id) !== undefined && !hasSelectedAncestor(parentOf, id, set));\n}\n\n/** Whether `id` draws a path derived from other nodes. Its pose is a\n *  placeholder: the path follows the nodes it derives from. */\nfunction derivesPathOnly(scene: AnyScene, id: string): boolean {\n  const node = scene.get(asNodeId(id));\n  return node?.derivePath !== undefined && node.derivePose === undefined\n    && Array.isArray(node.dependsOn) && node.dependsOn.length > 0;\n}\n\n/**\n * The nodes a translation of `ids` has to act on. A node whose pose is derived\n * from an id list cannot be moved itself, since a pose written to it is\n * overwritten on the next read, so the nodes it derives from stand in for it,\n * through however many derived nodes that takes. A node reached that way which\n * derives only its path — a wire under a label — follows its own dependencies\n * and is not written. Each id appears once, in the order it was first reached.\n */\nexport function moveSources(scene: AnyScene, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walked = new Set<string>();\n  const visit = (id: string, reached: boolean): void => {\n    if (walked.has(id)) return;\n    walked.add(id);\n    if (reached && derivesPathOnly(scene, id)) return;\n    const node = scene.get(asNodeId(id));\n    const deps = node?.derivePose !== undefined && Array.isArray(node.dependsOn) ? node.dependsOn : [];\n    if (deps.length === 0) out.add(id);\n    else for (const dep of deps) visit(dep, true);\n  };\n  for (const id of ids) visit(id, false);\n  return [...out];\n}\n\n/**\n * The nodes a resize, rotation, flip, or alignment of `ids` has to write. A\n * node whose pose is derived cannot be written itself, so what it derives\n * from stands in for it — a container's children, or the ids a node names —\n * through however many derived nodes that takes, leaving out one reached that\n * way which derives only its path, as {@link moveSources} does. Each id appears once, in the order it\n * was first reached.\n */\nexport function shapeSources(scene: AnyScene, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walked = new Set<string>();\n  const visit = (id: string, reached: boolean): void => {\n    if (walked.has(id)) return;\n    walked.add(id);\n    if (reached && derivesPathOnly(scene, id)) return;\n    const node = scene.get(asNodeId(id));\n    const deps = node?.derivePose === undefined\n      ? []\n      : node.dependsOn === 'children' ? scene.childrenOf(asNodeId(id)) : node.dependsOn ?? [];\n    if (deps.length === 0 && node?.dependsOn !== 'children') out.add(id);\n    else for (const dep of deps) visit(dep, true);\n  };\n  for (const id of ids) visit(id, false);\n  return [...out];\n}\n\n/** `id` and everything under it, a parent ahead of its children. */\nexport function subtreeIds(scene: AnyScene, id: NodeId): NodeId[] {\n  const out: NodeId[] = [];\n  const walk = (at: NodeId): void => {\n    out.push(at);\n    for (const child of scene.childrenOf(at)) walk(child);\n  };\n  walk(id);\n  return out;\n}\n\n/**\n * The nodes whose stored pose has to change for `ids` to move as a unit: each\n * selected node and its descendants, less any stored in the frame of another\n * node in the set, which that frame carries.\n */\nexport function translateTargets(\n  scene: AnyScene,\n  frame: PoseFrame<unknown>,\n  ids: readonly string[],\n): NodeId[] {\n  const moving = new Set<NodeId>();\n  for (const root of selectedRoots(scene, ids)) {\n    for (const id of subtreeIds(scene, root)) moving.add(id);\n  }\n  return [...moving].filter((id) => {\n    const storedIn = frame.frame(id);\n    return storedIn === null || !moving.has(storedIn);\n  });\n}\n\n/**\n * Move each of `moves` by its own delta, taking along whatever has to be\n * written for that node to move as a unit ({@link translateTargets}). Every\n * world pose is read before the first write, so one move cannot shift what a\n * later one reads. Call inside a `scene.batch`.\n */\nexport function translateEach(\n  scene: AnyScene,\n  frame: PoseFrame<unknown>,\n  descriptor: PoseDescriptor<unknown>,\n  moves: readonly { id: string; dx: number; dy: number }[],\n  finish?: TransformFinisher,\n  label = 'Translate',\n): void {\n  const writes: { id: NodeId; to: unknown }[] = [];\n  const seen = new Set<NodeId>();\n  for (const { id, dx, dy } of moves) {\n    if (dx === 0 && dy === 0) continue;\n    for (const target of translateTargets(scene, frame, [id])) {\n      if (seen.has(target)) continue;\n      seen.add(target);\n      const node = scene.get(target);\n      if (!node) continue;\n      const d = poseDescriptorForNode(descriptor, node);\n      writes.push({ id: target, to: frame.local(target, translatePoseViaDescriptor(frame.world(target), dx, dy, d)) });\n    }\n  }\n  const ops = writes.map(({ id, to }) => createTransformOp({ id, from: scene.get(id)!.pose, to, label }));\n  const all = finish && ops.length > 0 ? finish(ops, label) : ops;\n  if (!all) return;\n  const adapter = sceneMutators(scene);\n  for (const op of all) op.apply(adapter);\n}\n\n/** The world translation `(dx, dy)` as a translation of `id`'s stored pose,\n *  which under a turned frame points another way. */\nexport function storedDelta(\n  frame: PoseFrame<unknown>,\n  descriptor: PoseDescriptor<unknown>,\n  id: NodeId,\n  dx: number,\n  dy: number,\n): { dx: number; dy: number } {\n  if (frame.frame(id) === null) return { dx, dy };\n  const world = frame.world(id);\n  const from = descriptor.getBounds(frame.local(id, world));\n  const to = descriptor.getBounds(frame.local(id, translatePoseViaDescriptor(world, dx, dy, descriptor)));\n  return { dx: to.x - from.x, dy: to.y - from.y };\n}\n"],"mappings":"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"}
+{"version":3,"file":"selectionSubtree.js","names":[],"sources":["../../../src/interactions/actions/selectionSubtree.ts"],"sourcesContent":["import { outermost } from '@weasel-js/select';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport type { PoseFrame } from './poseFrame';\nimport type { TransformFinisher } from './transformFinish';\nimport { createTransformOp } from 'core/ops/transform';\nimport { sceneMutators } from 'core/scene/sceneMutators';\nimport { poseDescriptorForNode, translatePoseViaDescriptor, type PoseDescriptor } from 'core/geometry/poseDescriptor';\n\ntype AnyScene = Scene<unknown, string, unknown>;\n\n/** The ids in `ids` that are in the scene and that no ancestor in `ids` holds. */\nexport function selectedRoots(scene: AnyScene, ids: readonly string[]): NodeId[] {\n  const parentOf = (id: string) => scene.get(asNodeId(id))?.parent ?? null;\n  return outermost(ids, parentOf).map((id) => asNodeId(id)).filter((id) => scene.get(id) !== undefined);\n}\n\n/** Whether `id` draws a path derived from other nodes. Its pose is a\n *  placeholder: the path follows the nodes it derives from. */\nfunction derivesPathOnly(scene: AnyScene, id: string): boolean {\n  const node = scene.get(asNodeId(id));\n  return node?.derivePath !== undefined && node.derivePose === undefined\n    && Array.isArray(node.dependsOn) && node.dependsOn.length > 0;\n}\n\n/**\n * The nodes a translation of `ids` has to act on. A node whose pose is derived\n * from an id list cannot be moved itself, since a pose written to it is\n * overwritten on the next read, so the nodes it derives from stand in for it,\n * through however many derived nodes that takes. A node reached that way which\n * derives only its path — a wire under a label — follows its own dependencies\n * and is not written. Each id appears once, in the order it was first reached.\n */\nexport function moveSources(scene: AnyScene, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walked = new Set<string>();\n  const visit = (id: string, reached: boolean): void => {\n    if (walked.has(id)) return;\n    walked.add(id);\n    if (reached && derivesPathOnly(scene, id)) return;\n    const node = scene.get(asNodeId(id));\n    const deps = node?.derivePose !== undefined && Array.isArray(node.dependsOn) ? node.dependsOn : [];\n    if (deps.length === 0) out.add(id);\n    else for (const dep of deps) visit(dep, true);\n  };\n  for (const id of ids) visit(id, false);\n  return [...out];\n}\n\n/**\n * The nodes a resize, rotation, flip, or alignment of `ids` has to write. A\n * node whose pose is derived cannot be written itself, so what it derives\n * from stands in for it — a container's children, or the ids a node names —\n * through however many derived nodes that takes, leaving out one reached that\n * way which derives only its path, as {@link moveSources} does. Each id appears once, in the order it\n * was first reached.\n */\nexport function shapeSources(scene: AnyScene, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walked = new Set<string>();\n  const visit = (id: string, reached: boolean): void => {\n    if (walked.has(id)) return;\n    walked.add(id);\n    if (reached && derivesPathOnly(scene, id)) return;\n    const node = scene.get(asNodeId(id));\n    const deps = node?.derivePose === undefined\n      ? []\n      : node.dependsOn === 'children' ? scene.childrenOf(asNodeId(id)) : node.dependsOn ?? [];\n    if (deps.length === 0 && node?.dependsOn !== 'children') out.add(id);\n    else for (const dep of deps) visit(dep, true);\n  };\n  for (const id of ids) visit(id, false);\n  return [...out];\n}\n\n/** `id` and everything under it, a parent ahead of its children. */\nexport function subtreeIds(scene: AnyScene, id: NodeId): NodeId[] {\n  const out: NodeId[] = [];\n  const walk = (at: NodeId): void => {\n    out.push(at);\n    for (const child of scene.childrenOf(at)) walk(child);\n  };\n  walk(id);\n  return out;\n}\n\n/**\n * The nodes whose stored pose has to change for `ids` to move as a unit: each\n * selected node and its descendants, less any stored in the frame of another\n * node in the set, which that frame carries.\n */\nexport function translateTargets(\n  scene: AnyScene,\n  frame: PoseFrame<unknown>,\n  ids: readonly string[],\n): NodeId[] {\n  const moving = new Set<NodeId>();\n  for (const root of selectedRoots(scene, ids)) {\n    for (const id of subtreeIds(scene, root)) moving.add(id);\n  }\n  return [...moving].filter((id) => {\n    const storedIn = frame.frame(id);\n    return storedIn === null || !moving.has(storedIn);\n  });\n}\n\n/**\n * Move each of `moves` by its own delta, taking along whatever has to be\n * written for that node to move as a unit ({@link translateTargets}). Every\n * world pose is read before the first write, so one move cannot shift what a\n * later one reads. Call inside a `scene.batch`.\n */\nexport function translateEach(\n  scene: AnyScene,\n  frame: PoseFrame<unknown>,\n  descriptor: PoseDescriptor<unknown>,\n  moves: readonly { id: string; dx: number; dy: number }[],\n  finish?: TransformFinisher,\n  label = 'Translate',\n): void {\n  const writes: { id: NodeId; to: unknown }[] = [];\n  const seen = new Set<NodeId>();\n  for (const { id, dx, dy } of moves) {\n    if (dx === 0 && dy === 0) continue;\n    for (const target of translateTargets(scene, frame, [id])) {\n      if (seen.has(target)) continue;\n      seen.add(target);\n      const node = scene.get(target);\n      if (!node) continue;\n      const d = poseDescriptorForNode(descriptor, node);\n      writes.push({ id: target, to: frame.local(target, translatePoseViaDescriptor(frame.world(target), dx, dy, d)) });\n    }\n  }\n  const ops = writes.map(({ id, to }) => createTransformOp({ id, from: scene.get(id)!.pose, to, label }));\n  const all = finish && ops.length > 0 ? finish(ops, label) : ops;\n  if (!all) return;\n  const adapter = sceneMutators(scene);\n  for (const op of all) op.apply(adapter);\n}\n\n/** The world translation `(dx, dy)` as a translation of `id`'s stored pose,\n *  which under a turned frame points another way. */\nexport function storedDelta(\n  frame: PoseFrame<unknown>,\n  descriptor: PoseDescriptor<unknown>,\n  id: NodeId,\n  dx: number,\n  dy: number,\n): { dx: number; dy: number } {\n  if (frame.frame(id) === null) return { dx, dy };\n  const world = frame.world(id);\n  const from = descriptor.getBounds(frame.local(id, world));\n  const to = descriptor.getBounds(frame.local(id, translatePoseViaDescriptor(world, dx, dy, descriptor)));\n  return { dx: to.x - from.x, dy: to.y - from.y };\n}\n"],"mappings":"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"}

package/dist/interactions/actions/spatialReference.js

@@ -1,4 +1,4 @@
-//#region src/interactions/actions/spatialReference.ts
+// src/interactions/actions/spatialReference.ts
 /**
 * The world bounds `ref` names — a point comes back as a zero-size rect — or
 * `null` when it names nothing right now (no pointer, a missing node, a
@@ -39,6 +39,5 @@ function actionReferenceSources(params, pointer, scene, frame, boxes) {
 	};
 }
 
-//#endregion
 export { actionReferenceSources, resolveSpatialReference };
 //# sourceMappingURL=spatialReference.js.map

package/dist/interactions/actions/testUtils.js

@@ -1,4 +1,4 @@
-//#region src/interactions/actions/testUtils.ts
+// src/interactions/actions/testUtils.ts
 /**
 * Build an inert {@link EditAnchorsDep} for action unit tests. Every
 * member has a harmless default; override just the ones a test cares
@@ -41,6 +41,5 @@ function makeEditAnchorsDep(over = {}) {
 	}, Object.getOwnPropertyDescriptors(over));
 }
 
-//#endregion
 export { makeEditAnchorsDep };
 //# sourceMappingURL=testUtils.js.map

package/dist/interactions/actions/transform-again/action.js

@@ -1,13 +1,13 @@
-import { poseDescriptorOf } from "../poseDescriptorDep.js";
 import { commitTransformOps, transformApplyOps } from "../transformFinish.js";
-import { lastTransform, recordTransform } from "./memory.js";
-import { requiresSelection } from "../defaults/requiresSelection.js";
-import { resizeSelectionOps } from "../resize/replay.js";
 import { DUPLICATE_OFFSET, duplicateSelection } from "../defaults/duplicate.js";
 import { translateSelection } from "../defaults/nudge.js";
+import { requiresSelection } from "../defaults/requiresSelection.js";
+import { poseDescriptorOf } from "../poseDescriptorDep.js";
+import { resizeSelectionOps } from "../resize/replay.js";
 import { rotateSelectionOps } from "../rotate/replay.js";
+import { lastTransform, recordTransform } from "./memory.js";
 
-//#region src/interactions/actions/transform-again/action.ts
+// src/interactions/actions/transform-again/action.ts
 var LABEL = "Transform Again";
 /** With nothing recorded yet, a repeat is a plain duplicate. */
 var FIRST = {
@@ -75,6 +75,5 @@ var transformAgainAction = {
 	enabled: requiresSelection
 };
 
-//#endregion
 export { transformAgainAction };
 //# sourceMappingURL=action.js.map

package/dist/interactions/actions/transform-again/memory.js

@@ -1,6 +1,6 @@
-//#region src/interactions/actions/transform-again/memory.ts
+// src/interactions/actions/transform-again/memory.ts
 var LAST = /* @__PURE__ */ new WeakMap();
-function sameIds(a, b) {
+function sameMembers(a, b) {
 	if (a.length !== b.length) return false;
 	const set = new Set(a);
 	return b.every((id) => set.has(id));
@@ -20,7 +20,7 @@ function lastTransform(scene) {
 */
 function recordTransform(scene, transform, subject) {
 	const prev = LAST.get(scene);
-	if (transform.kind === "translate" && prev?.transform.kind === "duplicate" && sameIds(prev.subject, subject)) {
+	if (transform.kind === "translate" && prev?.transform.kind === "duplicate" && sameMembers(prev.subject, subject)) {
 		LAST.set(scene, {
 			transform: {
 				kind: "duplicate",
@@ -41,6 +41,5 @@ function forgetTransform(scene) {
 	LAST.delete(scene);
 }
 
-//#endregion
 export { forgetTransform, lastTransform, recordTransform };
 //# sourceMappingURL=memory.js.map

package/dist/interactions/actions/transform-again/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","names":[],"sources":["../../../../src/interactions/actions/transform-again/memory.ts"],"sourcesContent":["import type { ResizeAnchor } from '@weasel-js/routing';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * A transform the selection underwent, kept relative so it can be applied to\n * whatever is selected next.\n *\n * - `translate`: a world offset.\n * - `rotate`: radians about the selection's center, or about each node's own\n *   center (`pivot: 'each'`).\n * - `scale`: the box the selection was resized to, in units of the box it\n *   started as (`{ x: 0, y: 0, width: 1, height: 1 }` is no change), and the\n *   anchor the resize held fixed.\n * - `duplicate`: copy the selection, offset by the world offset `(dx, dy)`, and\n *   select the copies.\n *\n * Offsets are world, so a repeat inside a turned group steps the way the drag\n * or nudge it repeats did on screen.\n */\nexport type RepeatableTransform =\n  | { readonly kind: 'translate'; readonly dx: number; readonly dy: number }\n  | { readonly kind: 'rotate'; readonly angle: number; readonly pivot: 'union' | 'each' }\n  | { readonly kind: 'scale'; readonly to: Bounds; readonly anchor: ResizeAnchor }\n  | { readonly kind: 'duplicate'; readonly dx: number; readonly dy: number };\n\ninterface Entry {\n  readonly transform: RepeatableTransform;\n  /** The ids selected once it landed. */\n  readonly subject: readonly string[];\n}\n\nconst LAST = new WeakMap<object, Entry>();\n\nfunction sameIds(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  const set = new Set(a);\n  return b.every((id) => set.has(id));\n}\n\n/**\n * The last transform recorded against `scene`, which `transformAgain` repeats.\n */\nexport function lastTransform(scene: object): RepeatableTransform | undefined {\n  return LAST.get(scene)?.transform;\n}\n\n/**\n * Remember `transform` as the last one `scene` underwent, `subject` being the\n * ids selected once it landed. A translate of exactly the copies a\n * `duplicate` just made folds into it, so the copies' offset from their\n * sources is what repeats: duplicate, drag the copy, and each repeat steps\n * one more copy along.\n */\nexport function recordTransform(\n  scene: object,\n  transform: RepeatableTransform,\n  subject: readonly string[],\n): void {\n  const prev = LAST.get(scene);\n  if (\n    transform.kind === 'translate'\n    && prev?.transform.kind === 'duplicate'\n    && sameIds(prev.subject, subject)\n  ) {\n    LAST.set(scene, {\n      transform: { kind: 'duplicate', dx: prev.transform.dx + transform.dx, dy: prev.transform.dy + transform.dy },\n      subject: [...subject],\n    });\n    return;\n  }\n  LAST.set(scene, { transform, subject: [...subject] });\n}\n\n/** Drop what `scene` remembers, so `transformAgain` has nothing to repeat. */\nexport function forgetTransform(scene: object): void {\n  LAST.delete(scene);\n}\n"],"mappings":";AA+BA,IAAM,uBAAO,IAAI,QAAuB;AAExC,SAAS,QAAQ,GAAsB,GAA+B;CACpE,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;CAClC,MAAM,MAAM,IAAI,IAAI,CAAC;CACrB,OAAO,EAAE,OAAO,OAAO,IAAI,IAAI,EAAE,CAAC;AACpC;;;;AAKA,SAAgB,cAAc,OAAgD;CAC5E,OAAO,KAAK,IAAI,KAAK,CAAC,EAAE;AAC1B;;;;;;;;AASA,SAAgB,gBACd,OACA,WACA,SACM;CACN,MAAM,OAAO,KAAK,IAAI,KAAK;CAC3B,IACE,UAAU,SAAS,eAChB,MAAM,UAAU,SAAS,eACzB,QAAQ,KAAK,SAAS,OAAO,GAChC;EACA,KAAK,IAAI,OAAO;GACd,WAAW;IAAE,MAAM;IAAa,IAAI,KAAK,UAAU,KAAK,UAAU;IAAI,IAAI,KAAK,UAAU,KAAK,UAAU;GAAG;GAC3G,SAAS,CAAC,GAAG,OAAO;EACtB,CAAC;EACD;CACF;CACA,KAAK,IAAI,OAAO;EAAE;EAAW,SAAS,CAAC,GAAG,OAAO;CAAE,CAAC;AACtD;;AAGA,SAAgB,gBAAgB,OAAqB;CACnD,KAAK,OAAO,KAAK;AACnB"}
+{"version":3,"file":"memory.js","names":[],"sources":["../../../../src/interactions/actions/transform-again/memory.ts"],"sourcesContent":["import type { ResizeAnchor } from '@weasel-js/routing';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * A transform the selection underwent, kept relative so it can be applied to\n * whatever is selected next.\n *\n * - `translate`: a world offset.\n * - `rotate`: radians about the selection's center, or about each node's own\n *   center (`pivot: 'each'`).\n * - `scale`: the box the selection was resized to, in units of the box it\n *   started as (`{ x: 0, y: 0, width: 1, height: 1 }` is no change), and the\n *   anchor the resize held fixed.\n * - `duplicate`: copy the selection, offset by the world offset `(dx, dy)`, and\n *   select the copies.\n *\n * Offsets are world, so a repeat inside a turned group steps the way the drag\n * or nudge it repeats did on screen.\n */\nexport type RepeatableTransform =\n  | { readonly kind: 'translate'; readonly dx: number; readonly dy: number }\n  | { readonly kind: 'rotate'; readonly angle: number; readonly pivot: 'union' | 'each' }\n  | { readonly kind: 'scale'; readonly to: Bounds; readonly anchor: ResizeAnchor }\n  | { readonly kind: 'duplicate'; readonly dx: number; readonly dy: number };\n\ninterface Entry {\n  readonly transform: RepeatableTransform;\n  /** The ids selected once it landed. */\n  readonly subject: readonly string[];\n}\n\nconst LAST = new WeakMap<object, Entry>();\n\nfunction sameMembers(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  const set = new Set(a);\n  return b.every((id) => set.has(id));\n}\n\n/**\n * The last transform recorded against `scene`, which `transformAgain` repeats.\n */\nexport function lastTransform(scene: object): RepeatableTransform | undefined {\n  return LAST.get(scene)?.transform;\n}\n\n/**\n * Remember `transform` as the last one `scene` underwent, `subject` being the\n * ids selected once it landed. A translate of exactly the copies a\n * `duplicate` just made folds into it, so the copies' offset from their\n * sources is what repeats: duplicate, drag the copy, and each repeat steps\n * one more copy along.\n */\nexport function recordTransform(\n  scene: object,\n  transform: RepeatableTransform,\n  subject: readonly string[],\n): void {\n  const prev = LAST.get(scene);\n  if (\n    transform.kind === 'translate'\n    && prev?.transform.kind === 'duplicate'\n    && sameMembers(prev.subject, subject)\n  ) {\n    LAST.set(scene, {\n      transform: { kind: 'duplicate', dx: prev.transform.dx + transform.dx, dy: prev.transform.dy + transform.dy },\n      subject: [...subject],\n    });\n    return;\n  }\n  LAST.set(scene, { transform, subject: [...subject] });\n}\n\n/** Drop what `scene` remembers, so `transformAgain` has nothing to repeat. */\nexport function forgetTransform(scene: object): void {\n  LAST.delete(scene);\n}\n"],"mappings":";AA+BA,IAAM,uBAAO,IAAI,QAAuB;AAExC,SAAS,YAAY,GAAsB,GAA+B;CACxE,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;CAClC,MAAM,MAAM,IAAI,IAAI,CAAC;CACrB,OAAO,EAAE,OAAO,OAAO,IAAI,IAAI,EAAE,CAAC;AACpC;;;;AAKA,SAAgB,cAAc,OAAgD;CAC5E,OAAO,KAAK,IAAI,KAAK,CAAC,EAAE;AAC1B;;;;;;;;AASA,SAAgB,gBACd,OACA,WACA,SACM;CACN,MAAM,OAAO,KAAK,IAAI,KAAK;CAC3B,IACE,UAAU,SAAS,eAChB,MAAM,UAAU,SAAS,eACzB,YAAY,KAAK,SAAS,OAAO,GACpC;EACA,KAAK,IAAI,OAAO;GACd,WAAW;IAAE,MAAM;IAAa,IAAI,KAAK,UAAU,KAAK,UAAU;IAAI,IAAI,KAAK,UAAU,KAAK,UAAU;GAAG;GAC3G,SAAS,CAAC,GAAG,OAAO;EACtB,CAAC;EACD;CACF;CACA,KAAK,IAAI,OAAO;EAAE;EAAW,SAAS,CAAC,GAAG,OAAO;CAAE,CAAC;AACtD;;AAGA,SAAgB,gBAAgB,OAAqB;CACnD,KAAK,OAAO,KAAK;AACnB"}

package/dist/interactions/actions/transformFinish.js

@@ -1,6 +1,6 @@
 import { commitOps } from "./defaultCommitAdapter.js";
 
-//#region src/interactions/actions/transformFinish.ts
+// src/interactions/actions/transformFinish.ts
 /** Every follower in `deps.transformFollowers` finishing the batch in turn, as a {@link TransformFinisher}; undefined with none. */
 function transformFinisher(deps) {
 	const followers = deps?.transformFollowers;
@@ -101,6 +101,5 @@ function transformPreview(deps, scene, previews) {
 	};
 }
 
-//#endregion
 export { commitTransformOps, finishTransformOps, transformApplyOps, transformFinisher, transformPreview };
 //# sourceMappingURL=transformFinish.js.map

package/dist/interactions/actions/useActionSet.js

@@ -3,7 +3,7 @@ import { useLatest } from "@weasel-js/react";
 import "@weasel-js/routing";
 import { useActionsRegistry, useOptionalActiveToolContext, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/interactions/actions/useActionSet.ts
+// src/interactions/actions/useActionSet.ts
 /**
 * The two halves of `useStandardActions`, apart from the action list it
 * defaults to, so a canvas that names its own set never loads the kit's.
@@ -78,6 +78,5 @@ function useActionSet(actions, exclude) {
 	]);
 }
 
-//#endregion
 export { useActionSet, useStandardDeps };
 //# sourceMappingURL=useActionSet.js.map

package/dist/interactions/actions/useNotices.js

@@ -1,6 +1,6 @@
 import { useDepSource } from "@weasel-js/routing/react";
 
-//#region src/interactions/actions/useNotices.ts
+// src/interactions/actions/useNotices.ts
 /** Publish the host's notice surface as the `notices` dep, where actions tell
 *  the user something went wrong. Silently does nothing outside a
 *  `<DepRegistryProvider>`. */
@@ -8,6 +8,5 @@ function useNotices(notices) {
 	useDepSource("notices", () => notices);
 }
 
-//#endregion
 export { useNotices };
 //# sourceMappingURL=useNotices.js.map

package/dist/interactions/actions/useStandardActions.js

@@ -1,7 +1,7 @@
 import { KIT_STANDARD_ACTIONS } from "../../canvas/SceneCanvas/namedPresets.js";
 import { useActionSet, useStandardDeps } from "./useActionSet.js";
 
-//#region src/interactions/actions/useStandardActions.ts
+// src/interactions/actions/useStandardActions.ts
 /** Every id `useStandardActions` can register, each core preset's in turn and
 *  then the tool-driven ones. It holds `clipboard.pasteEvent` back while
 *  `ingest` is registered. */
@@ -22,6 +22,5 @@ function useStandardActions(opts) {
 	useActionSet(actions, exclude);
 }
 
-//#endregion
 export { KIT_STANDARD_ACTION_IDS, useStandardActions };
 //# sourceMappingURL=useStandardActions.js.map

package/dist/interactions/gestures/dragGesture/dragGesture.js

@@ -1,7 +1,7 @@
 import { useCallback, useMemo, useRef, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/interactions/gestures/dragGesture/dragGesture.ts
+// src/interactions/gestures/dragGesture/dragGesture.ts
 /**
 * The base drag primitive: tracks a pointer from press to release, with an
 * optional threshold below which the gesture stays pending and commits
@@ -144,6 +144,5 @@ function useDragGesture(options = {}) {
 	]);
 }
 
-//#endregion
 export { useDragGesture };
 //# sourceMappingURL=dragGesture.js.map

package/dist/interactions/gestures/dragGesture/dragPointOf.js

@@ -1,6 +1,6 @@
 import { clientToWorld } from "../../../core/viewport/clientToWorld.js";
 
-//#region src/interactions/gestures/dragGesture/dragPointOf.ts
+// src/interactions/gestures/dragGesture/dragPointOf.ts
 var IDENTITY = {
 	x: 0,
 	y: 0,
@@ -25,6 +25,5 @@ function dragPointOf(event, element, view = IDENTITY) {
 	};
 }
 
-//#endregion
 export { dragPointOf };
 //# sourceMappingURL=dragPointOf.js.map

package/dist/interactions/gestures/dragRadial/dragRadial.js

@@ -1,9 +1,9 @@
-import { dlog } from "../../../debug/flag.js";
 import { useDragGesture } from "../dragGesture/dragGesture.js";
+import { dlog } from "../../../debug/flag.js";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/interactions/gestures/dragRadial/dragRadial.ts
+// src/interactions/gestures/dragRadial/dragRadial.ts
 function stateFrom(s) {
 	const dx = s.current.x - s.center.x;
 	const dy = s.current.y - s.center.y;
@@ -148,6 +148,5 @@ function useDragRadial(options = {}) {
 	]);
 }
 
-//#endregion
 export { useDragRadial };
 //# sourceMappingURL=dragRadial.js.map

package/dist/interactions/gestures/dragRect/dragRect.js

@@ -1,9 +1,9 @@
-import { dlog } from "../../../debug/flag.js";
 import { useDragGesture } from "../dragGesture/dragGesture.js";
+import { dlog } from "../../../debug/flag.js";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/interactions/gestures/dragRect/dragRect.ts
+// src/interactions/gestures/dragRect/dragRect.ts
 function boundsFrom(start, current) {
 	return {
 		x: Math.min(start.x, current.x),
@@ -203,6 +203,5 @@ function useDragRect(options = {}) {
 	]);
 }
 
-//#endregion
 export { useDragRect };
 //# sourceMappingURL=dragRect.js.map

package/dist/interactions/gestures/handleDrag/handleDrag.js

@@ -2,7 +2,7 @@ import { useCallback, useEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 import { clientToCanvasRect, openPointerSession } from "@weasel-js/routing";
 
-//#region src/interactions/gestures/handleDrag/handleDrag.ts
+// src/interactions/gestures/handleDrag/handleDrag.ts
 function defaultRectEl(target) {
 	if (target instanceof SVGElement && target.ownerSVGElement) return target.ownerSVGElement;
 	return target;
@@ -58,6 +58,5 @@ function useHandleDrag(opts) {
 	}, [optsRef]) };
 }
 
-//#endregion
 export { useHandleDrag };
 //# sourceMappingURL=handleDrag.js.map

package/dist/interactions/gestures/pointerDrag/pointerDrag.js

@@ -3,7 +3,7 @@ import { useKitSettings, useLatest } from "@weasel-js/react";
 import { openPointerSession, pastDragThreshold } from "@weasel-js/routing";
 import { fixedSeat } from "@weasel-js/gestures";
 
-//#region src/interactions/gestures/pointerDrag/pointerDrag.ts
+// src/interactions/gestures/pointerDrag/pointerDrag.ts
 var dropZones = /* @__PURE__ */ new Set();
 var activeDrag = null;
 function registerDropZone(zone) {
@@ -205,6 +205,5 @@ function useDropZone(opts) {
 	}, [optsRef]);
 }
 
-//#endregion
 export { useDragHandle, useDropZone };
 //# sourceMappingURL=pointerDrag.js.map

package/dist/interactions/gestures/shared/originProjection.js

@@ -1,7 +1,7 @@
 import { isPathLike } from "../../../core/geometry/autoPoseDescriptor.js";
 import { boundsOfPath, translatePath } from "@weasel-js/geom";
 
-//#region src/interactions/gestures/shared/originProjection.ts
+// src/interactions/gestures/shared/originProjection.ts
 /** Identity projection for `TPose extends { x; y }`. */
 var RECT_ORIGIN_PROJECTION = {
 	getOrigin: (p) => ({
@@ -44,6 +44,5 @@ var AUTO_ORIGIN_PROJECTION = {
 	}
 };
 
-//#endregion
 export { AUTO_ORIGIN_PROJECTION, RECT_ORIGIN_PROJECTION };
 //# sourceMappingURL=originProjection.js.map

package/dist/interactions/gestures/shared/screenTolerance.js

@@ -1,6 +1,6 @@
 import { pxExtent } from "@weasel-js/geom";
 
-//#region src/interactions/gestures/shared/screenTolerance.ts
+// src/interactions/gestures/shared/screenTolerance.ts
 /** A screen-pixel tolerance in world units, per axis, through the camera of
 *  the view the gesture landed in. With no view, one pixel is one unit. */
 function screenTolerance(px, ctx) {
@@ -31,6 +31,5 @@ function gestureReaders(deps) {
 	};
 }
 
-//#endregion
 export { gesturePlaneReader, gestureReaders, gestureViewReader, screenTolerance };
 //# sourceMappingURL=screenTolerance.js.map

package/dist/interactions/gestures/thresholdDrag/thresholdDrag.js

@@ -1,6 +1,6 @@
 import { openPointerSession, pastDragThreshold } from "@weasel-js/routing";
 
-//#region src/interactions/gestures/thresholdDrag/thresholdDrag.ts
+// src/interactions/gestures/thresholdDrag/thresholdDrag.ts
 /** Begin a threshold-gated drag from a React PointerDown event; returns a handle exposing live state. */
 function startThresholdDrag(e, opts) {
 	const start = {
@@ -59,6 +59,5 @@ function startThresholdDrag(e, opts) {
 	};
 }
 
-//#endregion
 export { startThresholdDrag };
 //# sourceMappingURL=thresholdDrag.js.map

package/dist/kitSettingsSchema.js

@@ -1,15 +1,15 @@
 import { ANCHOR_HIT_BASE_PX, HANDLE_BASE_PX, ROTATION_HANDLE_BASE_PX } from "./core/device/targets.js";
 import { DEFAULT_VIEW_ANIMATION_MS } from "./core/viewport/useViewAnimation.js";
-import { DEFAULT_SNAP_PX } from "./domains/snap/session2d.js";
-import { ANCHOR_CLICK_PX } from "./interactions/actions/defaults/anchorEditing.js";
+import { DEFAULT_PICK_TOLERANCE_PX } from "./canvas/SceneCanvas/useSceneSelectTool.js";
 import { SEGMENT_HIT_PX } from "./interactions/actions/defaults/segmentUnder.js";
+import { ANCHOR_CLICK_PX } from "./interactions/actions/defaults/anchorEditing.js";
 import { ANCHOR_RADIUS_PX, CLOSE_HINT_RADIUS_PX, HANDLE_DOT_RADIUS_PX, PEN_CLOSE_HIT_PX } from "./domains/paths/penPreviewLayer.js";
+import { DEFAULT_SNAP_PX } from "./domains/snap/session2d.js";
 import { SLICE_CLOSE_HIT_PX, VERTEX_RADIUS_PX } from "./tools/builtin/slice/useSliceTool.js";
-import { DEFAULT_PICK_TOLERANCE_PX } from "./canvas/SceneCanvas/useSceneSelectTool.js";
 import { DOUBLE_CLICK_MAX_MS, DOUBLE_CLICK_MAX_PX, DRAG_THRESHOLD_PX, LONG_PRESS_MS, TAP_THRESHOLD_PX } from "@weasel-js/gestures";
 import { pref } from "@weasel-js/prefs";
 
-//#region src/kitSettingsSchema.ts
+// src/kitSettingsSchema.ts
 var ms = {
 	scale: 1,
 	suffix: "ms"
@@ -78,6 +78,5 @@ var coreKitSettingsSchema = pref.group("Canvas", {
 	view: pref.group("View", { animationMs: msLeaf("Camera animation", DEFAULT_VIEW_ANIMATION_MS, 0) })
 });
 
-//#endregion
 export { coreKitSettingsSchema };
 //# sourceMappingURL=kitSettingsSchema.js.map

package/dist/move.d.ts

@@ -2,10 +2,10 @@ export { U as UseMoveOptions } from './options-DAjkhbcs.js';
 import { S as SnapTarget } from './types-VCtfchp-.js';
 import { M as MoveBehavior } from './clone-Bz4iqGfE.js';
 import { O as OriginProjection } from './originProjection-gY0jb4Wb.js';
+import { FramedBox } from '@weasel-js/geom';
+import { P as PoseDescriptor } from './poseDescriptor-CvSxVhCd.js';
 import './types-A_sNJYRd.js';
-import '@weasel-js/geom';
 import '@weasel-js/history';
-import './poseDescriptor-CvSxVhCd.js';
 import '@weasel-js/animator';
 import '@weasel-js/routing';
 import '@weasel-js/react';
@@ -51,4 +51,19 @@ declare function snapBackOrDelete<TPose>(args: {
     origin: OriginProjection<TPose>;
 }): MoveBehavior<TPose>;
 
-export { snapBackOrDelete, snapToContainer };
+/** What {@link clampMove} takes. */
+interface ClampMoveOptions<TPose> {
+    /** The world rect the dragged nodes stay inside, or a function read each frame for one that changes. */
+    bounds: FramedBox | (() => FramedBox);
+    /** Reads each pose's box. Default `AUTO_POSE_DESCRIPTOR`. */
+    poseDescriptor?: PoseDescriptor<TPose>;
+}
+/**
+ * Move behavior that keeps the dragged nodes inside `bounds`: the drag's translation is
+ * clamped so the box around every dragged node's start pose, moved by it, stays in the rect.
+ * The clamp applies to the preview and the commit alike, so a node let go past an edge lands
+ * on it. Put it after behaviors that reshape the translation, so it has the last word.
+ */
+declare function clampMove<TPose>(opts: ClampMoveOptions<TPose>): MoveBehavior<TPose>;
+
+export { type ClampMoveOptions, clampMove, snapBackOrDelete, snapToContainer };

package/dist/move.js

@@ -1,4 +1,5 @@
 import { snapToContainer } from "./interactions/actions/move/behaviors/snapToContainer.js";
 import { snapBackOrDelete } from "./interactions/actions/move/behaviors/snapBackOrDelete.js";
+import { clampMove } from "./interactions/actions/move/behaviors/clampMove.js";
 
-export { snapBackOrDelete, snapToContainer };
+export { clampMove, snapBackOrDelete, snapToContainer };

package/dist/test-hook/createTestHook.js

@@ -1,4 +1,4 @@
-//#region src/test-hook/createTestHook.ts
+// src/test-hook/createTestHook.ts
 function createTestHook(refs) {
 	let resolveReady;
 	const ready = new Promise((r) => {
@@ -37,6 +37,5 @@ function createTestHook(refs) {
 	};
 }
 
-//#endregion
 export { createTestHook };
 //# sourceMappingURL=createTestHook.js.map

package/dist/test-hook/install.js

@@ -1,7 +1,7 @@
 import { createTestHook } from "./createTestHook.js";
 import { isDev } from "@weasel-js/react";
 
-//#region src/test-hook/install.ts
+// src/test-hook/install.ts
 /** Hooks of the canvases mounted now, oldest first. `window.__weaselTest` is the first. */
 var live = [];
 /** Make a hook for this canvas and return it iff
@@ -32,6 +32,5 @@ function releaseTestHook(hook) {
 	else delete window.__weaselTest;
 }
 
-//#endregion
 export { installTestHookIfRequested, releaseTestHook };
 //# sourceMappingURL=install.js.map

package/dist/test-hook/useTestHook.js

@@ -2,7 +2,7 @@ import { installTestHookIfRequested, releaseTestHook } from "./install.js";
 import { useEffect } from "react";
 import { isDev, useLatest } from "@weasel-js/react";
 
-//#region src/test-hook/useTestHook.ts
+// src/test-hook/useTestHook.ts
 /** The test hook for one canvas: opt-in via `?test=1`, never in a production
 *  build. `read` is called for the values of the last committed render. */
 function useTestHook(read) {
@@ -24,6 +24,5 @@ function useTestHook(read) {
 	}, [live]);
 }
 
-//#endregion
 export { useTestHook };
 //# sourceMappingURL=useTestHook.js.map

package/dist/test-seams.d.ts

@@ -1,7 +1,7 @@
-import { E as EditAnchorsDep, P as PathEditMark, a as PathEditExtension, H as HandleLocks, S as SnapSource, b as SnapGesture, c as SnapConstrain, d as SnapResizeBox, e as SnapGeometry, f as SnapOutcomeStore, g as SnapAnchors, h as SnapSession } from './depSchema-ChQPzEkW.js';
-export { _ as _resetPaintKindsForTests } from './depSchema-ChQPzEkW.js';
+import { E as EditAnchorsDep, P as PathEditMark, a as PathEditExtension, H as HandleLocks, S as SnapSource, b as SnapGesture, c as SnapConstrain, d as SnapResizeBox, e as SnapGeometry, f as SnapOutcomeStore, g as SnapAnchors, h as SnapSession } from './depSchema-C7a_OMt-.js';
+export { _ as _resetPaintKindsForTests } from './depSchema-C7a_OMt-.js';
 export { _resetMarkersForTests } from '@weasel-js/stroke/test-seams';
-import { S as Scene } from './types-DW14eu9B.js';
+import { S as Scene } from './types-BUvUXZe5.js';
 import { SelectionApi, ActionTunings, WorldPoint, ResizeAnchor } from '@weasel-js/routing';
 import { Op } from '@weasel-js/history';
 import { View } from '@weasel-js/geom';
@@ -19,8 +19,8 @@ import '@weasel-js/cursor';
 import '@weasel-js/gestures';
 import '@weasel-js/geom/nd';
 import '@weasel-js/animator';
-import './types-VCtfchp-.js';
 import './clone-Bz4iqGfE.js';
+import './types-VCtfchp-.js';
 import '@weasel-js/react';
 import '@weasel-js/quantity';
 

package/dist/test-seams.js

@@ -1,8 +1,8 @@
 import { _resetPaintKindsForTests } from "./core/paint/paintKinds.js";
-import { useEditAnchorsDepSource } from "./canvas/deps/editAnchors.js";
-import { createSnapSession2d } from "./domains/snap/sceneSession2d.js";
 import { makeEditAnchorsDep } from "./interactions/actions/testUtils.js";
+import { useEditAnchorsDepSource } from "./canvas/deps/editAnchors.js";
 import { rootsTree } from "./core/adapters/testing/rootsTree.js";
+import { createSnapSession2d } from "./domains/snap/sceneSession2d.js";
 import { _resetMarkersForTests } from "@weasel-js/stroke/test-seams";
 
 export { _resetMarkersForTests, _resetPaintKindsForTests, createSnapSession2d as createSnapSession2dForTests, makeEditAnchorsDep as makeEditAnchorsDepForTests, rootsTree as rootsTreeForTests, useEditAnchorsDepSource as useEditAnchorsDepSourceForTests };