@weasel-js/core 1.15.0 → 1.15.2

package/dist/domains/paths/pathSnap/snapGeometry.js

@@ -1,10 +1,10 @@
 import { isRectPose } from "../../../core/geometry/autoPoseDescriptor.js";
-import { findNodeShape } from "../../../canvas/NodeShape.js";
 import { poseOutline } from "../../../core/geometry/regionHit.js";
+import { findNodeShape } from "../../../canvas/NodeShape.js";
 import { nodeOutline } from "../strokeOutline.js";
 import { worldCoords } from "@weasel-js/geom";
 
-//#region src/domains/paths/pathSnap/snapGeometry.ts
+// src/domains/paths/pathSnap/snapGeometry.ts
 /**
 * The geometry `node` snaps to. A painter that `snapsToBox` — text, an image
 * — gives its pose box through the pose's frame, and the box's center. Any
@@ -43,6 +43,5 @@ function boxCenter(path) {
 	};
 }
 
-//#endregion
 export { nodeSnapGeometry };
 //# sourceMappingURL=snapGeometry.js.map

package/dist/domains/paths/penPreviewLayer.js

@@ -1,6 +1,6 @@
-import { PATH_C, PATH_L, PATH_M, anchorsToPath, circlePath } from "@weasel-js/geom";
+import { PATH_C, PATH_L, PATH_M, anchorsToPath, circlePath, viewWorldToScreen } from "@weasel-js/geom";
 
-//#region src/domains/paths/penPreviewLayer.ts
+// src/domains/paths/penPreviewLayer.ts
 var DEFAULT_STYLE = {
 	anchorFill: "#d4c4a8",
 	anchorStroke: "#d4c4a8",
@@ -21,9 +21,6 @@ var radiiOf = (kit) => ({
 	handleDot: kit?.get("targets.penHandleDotRadiusPx") ?? HANDLE_DOT_RADIUS_PX,
 	closeHint: kit?.get("targets.penCloseHintRadiusPx") ?? CLOSE_HINT_RADIUS_PX
 });
-function w2s(wx, wy, view) {
-	return [(wx - view.x) * view.scale.x, (wy - view.y) * view.scale.y];
-}
 function approximateCircle(cx, cy, r) {
 	return circlePath(cx, cy, r);
 }
@@ -32,7 +29,7 @@ function approximateCircle(cx, cy, r) {
 function subpathToPath(sp, view) {
 	if (sp.anchors.length === 0) return null;
 	const pt = (p) => {
-		const [x, y] = w2s(p.x, p.y, view);
+		const { x, y } = viewWorldToScreen(view, p);
 		return {
 			x,
 			y
@@ -95,11 +92,11 @@ function createPenPreviewLayer(opts) {
 			if (cur && cur.anchors.length > 0 && s.cursor && s.draggingHandleAt === null) {
 				const last = cur.anchors[cur.anchors.length - 1];
 				const out2 = last.outHandle;
-				const [sx, sy] = w2s(last.x, last.y, view);
-				const [cx, cy] = w2s(s.cursor.x, s.cursor.y, view);
+				const { x: sx, y: sy } = viewWorldToScreen(view, last);
+				const { x: cx, y: cy } = viewWorldToScreen(view, s.cursor);
 				let path;
 				if (out2) {
-					const [c1x, c1y] = w2s(out2.x, out2.y, view);
+					const { x: c1x, y: c1y } = viewWorldToScreen(view, out2);
 					path = {
 						kind: "polygon",
 						commands: new Uint8Array([PATH_M, PATH_C]),
@@ -141,7 +138,7 @@ function createPenPreviewLayer(opts) {
 			if (cur) {
 				for (let i = 0; i < cur.anchors.length; i++) {
 					const a = cur.anchors[i];
-					const [ax, ay] = w2s(a.x, a.y, view);
+					const { x: ax, y: ay } = viewWorldToScreen(view, a);
 					out.push({
 						kind: "path",
 						path: approximateCircle(ax, ay, r.anchor),
@@ -158,7 +155,7 @@ function createPenPreviewLayer(opts) {
 						}
 					});
 					if (i === cur.anchors.length - 1 && a.outHandle) {
-						const [hx, hy] = w2s(a.outHandle.x, a.outHandle.y, view);
+						const { x: hx, y: hy } = viewWorldToScreen(view, a.outHandle);
 						const linePath = {
 							kind: "polygon",
 							commands: new Uint8Array([PATH_M, PATH_L]),
@@ -191,7 +188,7 @@ function createPenPreviewLayer(opts) {
 						});
 						const inSide = a.inHandle;
 						if (inSide) {
-							const [mx, my] = w2s(inSide.x, inSide.y, view);
+							const { x: mx, y: my } = viewWorldToScreen(view, inSide);
 							const inLine = {
 								kind: "polygon",
 								commands: new Uint8Array([PATH_M, PATH_L]),
@@ -227,7 +224,7 @@ function createPenPreviewLayer(opts) {
 				}
 				if (s.closeHintActive && cur.anchors.length >= 3) {
 					const first = cur.anchors[0];
-					const [fx, fy] = w2s(first.x, first.y, view);
+					const { x: fx, y: fy } = viewWorldToScreen(view, first);
 					out.push({
 						kind: "path",
 						path: approximateCircle(fx, fy, r.closeHint),
@@ -246,6 +243,5 @@ function createPenPreviewLayer(opts) {
 	};
 }
 
-//#endregion
 export { ANCHOR_RADIUS_PX, CLOSE_HINT_RADIUS_PX, HANDLE_DOT_RADIUS_PX, PEN_CLOSE_HIT_PX, createPenPreviewLayer, penReachOf };
 //# sourceMappingURL=penPreviewLayer.js.map

package/dist/domains/paths/penPreviewLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"penPreviewLayer.js","names":[],"sources":["../../../src/domains/paths/penPreviewLayer.ts"],"sourcesContent":["/**\n * Screen-space preview layer for `usePenTool`. Reads the pen's state each\n * frame and renders the in-progress path: finished\n * subpaths (faded), the current subpath (bright + anchor dots + handles),\n * a rubber-band segment from the latest anchor to the cursor, and a\n * close-hint ring on the first anchor when the tool flags it as hot.\n *\n * Runs in screen space so anchor/handle sizes stay constant under zoom.\n * All world-space coords go through `worldToScreen` via the layer's `view`\n * argument.\n */\n\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport type { KitSettingsStore } from '@weasel-js/react';\nimport type { PenScratch, PenAnchor, PenSubpath } from 'tools/builtin/pen';\nimport { PATH_C, PATH_L, PATH_M, type PolygonPath, anchorsToPath, circlePath } from '@weasel-js/geom';\n\n/** Appearance of the pen tool's in-progress path. */\nexport interface PenPreviewStyle {\n  anchorFill?: string;\n  anchorStroke?: string;\n  handleStroke?: string;\n  rubberBandStroke?: string;\n  closeHintFill?: string;\n  finishedSubpathStroke?: string;\n}\n\n/** Options for `createPenPreviewLayer`. */\nexport interface CreatePenPreviewLayerOptions {\n  /** The pen's state. One object for the pen's life, changed in place, so\n   *  the layer reads the same one on every frame. */\n  state: PenScratch;\n  style?: PenPreviewStyle;\n  /** The kit settings whose `targets.pen*RadiusPx` size the dots, read each frame. */\n  kitSettings?: () => KitSettingsStore;\n}\n\nconst DEFAULT_STYLE: Required<PenPreviewStyle> = {\n  anchorFill: '#d4c4a8',\n  anchorStroke: '#d4c4a8',\n  handleStroke: '#d4c4a8',\n  rubberBandStroke: '#d4c4a8',\n  closeHintFill: '#d4c4a8',\n  finishedSubpathStroke: '#8a7a5e',\n};\n\nexport const ANCHOR_RADIUS_PX = 4;\nexport const HANDLE_DOT_RADIUS_PX = 3;\nexport const CLOSE_HINT_RADIUS_PX = 8;\n\n/** How near the pen's first anchor, in screen px, a click closes the subpath. */\nexport const PEN_CLOSE_HIT_PX = 8;\n\n/** The pen's reach in screen px: its own option, else the kit setting, else the constant. */\nexport const penReachOf = (o: { closeHitRadius?: number; kitSettings?: KitSettingsStore }) => ({\n  close: o.closeHitRadius ?? o.kitSettings?.get('targets.penCloseHitPx') ?? PEN_CLOSE_HIT_PX,\n});\n\nconst radiiOf = (kit: KitSettingsStore | undefined) => ({\n  anchor: kit?.get('targets.penAnchorRadiusPx') ?? ANCHOR_RADIUS_PX,\n  handleDot: kit?.get('targets.penHandleDotRadiusPx') ?? HANDLE_DOT_RADIUS_PX,\n  closeHint: kit?.get('targets.penCloseHintRadiusPx') ?? CLOSE_HINT_RADIUS_PX,\n});\n\nfunction w2s(wx: number, wy: number, view: { x: number; y: number; scale: { x: number; y: number } }): [number, number] {\n  return [(wx - view.x) * view.scale.x, (wy - view.y) * view.scale.y];\n}\n\n// approximateCircle has moved to `./markers.ts` as `circlePath`. Re-exported\n// locally so we don't rename callers in this file.\nfunction approximateCircle(cx: number, cy: number, r: number): PolygonPath {\n  return circlePath(cx, cy, r);\n}\n\n/** A pen subpath as a screen-space `PolygonPath`, segmented by the same rule\n *  the pen commits with. */\nfunction subpathToPath(\n  sp: PenSubpath,\n  view: { x: number; y: number; scale: { x: number; y: number } },\n): PolygonPath | null {\n  if (sp.anchors.length === 0) return null;\n  const pt = (p: { x: number; y: number }) => {\n    const [x, y] = w2s(p.x, p.y, view);\n    return { x, y };\n  };\n  const anchors = sp.anchors.map((a: PenAnchor) => ({\n    ...pt(a),\n    ...(a.inHandle ? { inHandle: pt(a.inHandle) } : {}),\n    ...(a.outHandle ? { outHandle: pt(a.outHandle) } : {}),\n  }));\n  return anchorsToPath([anchors], [sp.closed]);\n}\n\n/** Render layer that draws the pen tool's path as it is being placed —\n *  committed anchors, the rubber band to the cursor, and the close hint. Draws\n *  nothing when the pen is idle. */\nexport function createPenPreviewLayer(\n  opts: CreatePenPreviewLayerOptions,\n): RenderLayer<unknown> {\n  const style = { ...DEFAULT_STYLE, ...(opts.style ?? {}) };\n  const s = opts.state;\n\n  return {\n    id: 'penPreview',\n    label: 'Pen preview',\n    space: 'screen',\n    draw: (_data, view) => {\n      const out: DrawCommand[] = [];\n      const r = radiiOf(opts.kitSettings?.());\n      // (1) Finished subpaths — faded outline.\n      for (const sp of s.finishedSubpaths) {\n        const path = subpathToPath(sp, view);\n        if (path === null) continue;\n        out.push({\n          kind: 'path',\n          path,\n          stroke: { paint: { kind: 'solid', color: style.finishedSubpathStroke }, width: 1 },\n        });\n      }\n\n      const cur = s.current;\n      if (!cur && s.cursor === null) return out;\n\n      // (2) Current subpath — bright outline.\n      if (cur) {\n        const path = subpathToPath(cur, view);\n        if (path !== null) {\n          out.push({\n            kind: 'path',\n            path,\n            stroke: { paint: { kind: 'solid', color: style.rubberBandStroke }, width: 1 },\n          });\n        }\n      }\n\n      // (3) Rubber-band from latest anchor to cursor.\n      if (cur && cur.anchors.length > 0 && s.cursor && s.draggingHandleAt === null) {\n        const last = cur.anchors[cur.anchors.length - 1];\n        const out2 = last.outHandle;\n        const [sx, sy] = w2s(last.x, last.y, view);\n        const [cx, cy] = w2s(s.cursor.x, s.cursor.y, view);\n        let path: PolygonPath;\n        if (out2) {\n          const [c1x, c1y] = w2s(out2.x, out2.y, view);\n          path = {\n            kind: 'polygon',\n            commands: new Uint8Array([PATH_M, PATH_C]),\n            coords: new Float32Array([sx, sy, c1x, c1y, cx, cy, cx, cy]),\n            fillRule: 'nonzero',\n          };\n        } else {\n          path = {\n            kind: 'polygon',\n            commands: new Uint8Array([PATH_M, PATH_L]),\n            coords: new Float32Array([sx, sy, cx, cy]),\n            fillRule: 'nonzero',\n          };\n        }\n        out.push({\n          kind: 'path',\n          path,\n          stroke: { paint: { kind: 'solid', color: style.rubberBandStroke }, width: 1 },\n        });\n      }\n\n      // (4) Anchor dots + handles.\n      if (cur) {\n        for (let i = 0; i < cur.anchors.length; i++) {\n          const a = cur.anchors[i];\n          const [ax, ay] = w2s(a.x, a.y, view);\n          out.push({\n            kind: 'path',\n            path: approximateCircle(ax, ay, r.anchor),\n            fill: { paint: { kind: 'solid', color: style.anchorFill } },\n            stroke: { paint: { kind: 'solid', color: style.anchorStroke }, width: 1 },\n          });\n          // Handle line + dot (only the latest anchor, per spec).\n          if (i === cur.anchors.length - 1 && a.outHandle) {\n            const [hx, hy] = w2s(a.outHandle.x, a.outHandle.y, view);\n            const linePath: PolygonPath = {\n              kind: 'polygon',\n              commands: new Uint8Array([PATH_M, PATH_L]),\n              coords: new Float32Array([ax, ay, hx, hy]),\n              fillRule: 'nonzero',\n            };\n            out.push({\n              kind: 'path',\n              path: linePath,\n              stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n            });\n            out.push({\n              kind: 'path',\n              path: approximateCircle(hx, hy, r.handleDot),\n              fill: { paint: { kind: 'solid', color: style.handleStroke } },\n            });\n            const inSide = a.inHandle;\n            if (inSide) {\n              const [mx, my] = w2s(inSide.x, inSide.y, view);\n              const inLine: PolygonPath = {\n                kind: 'polygon',\n                commands: new Uint8Array([PATH_M, PATH_L]),\n                coords: new Float32Array([ax, ay, mx, my]),\n                fillRule: 'nonzero',\n              };\n              out.push({\n                kind: 'path',\n                path: inLine,\n                stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n              });\n              out.push({\n                kind: 'path',\n                path: approximateCircle(mx, my, r.handleDot),\n                fill: { paint: { kind: 'solid', color: style.handleStroke } },\n              });\n            }\n          }\n        }\n\n        // (5) Close-hint ring on first anchor.\n        if (s.closeHintActive && cur.anchors.length >= 3) {\n          const first = cur.anchors[0];\n          const [fx, fy] = w2s(first.x, first.y, view);\n          out.push({\n            kind: 'path',\n            path: approximateCircle(fx, fy, r.closeHint),\n            stroke: { paint: { kind: 'solid', color: style.closeHintFill }, width: 1.5 },\n          });\n        }\n      }\n\n      return out;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"penPreviewLayer.js","names":[],"sources":["../../../src/domains/paths/penPreviewLayer.ts"],"sourcesContent":["/**\n * Screen-space preview layer for `usePenTool`. Reads the pen's state each\n * frame and renders the in-progress path: finished\n * subpaths (faded), the current subpath (bright + anchor dots + handles),\n * a rubber-band segment from the latest anchor to the cursor, and a\n * close-hint ring on the first anchor when the tool flags it as hot.\n *\n * Runs in screen space so anchor/handle sizes stay constant under zoom.\n * All world-space coords go through `viewWorldToScreen` with the layer's `view`\n * argument.\n */\n\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport type { KitSettingsStore } from '@weasel-js/react';\nimport type { PenScratch, PenAnchor, PenSubpath } from 'tools/builtin/pen';\nimport { PATH_C, PATH_L, PATH_M, type PolygonPath, anchorsToPath, circlePath, viewWorldToScreen } from '@weasel-js/geom';\n\n/** Appearance of the pen tool's in-progress path. */\nexport interface PenPreviewStyle {\n  anchorFill?: string;\n  anchorStroke?: string;\n  handleStroke?: string;\n  rubberBandStroke?: string;\n  closeHintFill?: string;\n  finishedSubpathStroke?: string;\n}\n\n/** Options for `createPenPreviewLayer`. */\nexport interface CreatePenPreviewLayerOptions {\n  /** The pen's state. One object for the pen's life, changed in place, so\n   *  the layer reads the same one on every frame. */\n  state: PenScratch;\n  style?: PenPreviewStyle;\n  /** The kit settings whose `targets.pen*RadiusPx` size the dots, read each frame. */\n  kitSettings?: () => KitSettingsStore;\n}\n\nconst DEFAULT_STYLE: Required<PenPreviewStyle> = {\n  anchorFill: '#d4c4a8',\n  anchorStroke: '#d4c4a8',\n  handleStroke: '#d4c4a8',\n  rubberBandStroke: '#d4c4a8',\n  closeHintFill: '#d4c4a8',\n  finishedSubpathStroke: '#8a7a5e',\n};\n\nexport const ANCHOR_RADIUS_PX = 4;\nexport const HANDLE_DOT_RADIUS_PX = 3;\nexport const CLOSE_HINT_RADIUS_PX = 8;\n\n/** How near the pen's first anchor, in screen px, a click closes the subpath. */\nexport const PEN_CLOSE_HIT_PX = 8;\n\n/** The pen's reach in screen px: its own option, else the kit setting, else the constant. */\nexport const penReachOf = (o: { closeHitRadius?: number; kitSettings?: KitSettingsStore }) => ({\n  close: o.closeHitRadius ?? o.kitSettings?.get('targets.penCloseHitPx') ?? PEN_CLOSE_HIT_PX,\n});\n\nconst radiiOf = (kit: KitSettingsStore | undefined) => ({\n  anchor: kit?.get('targets.penAnchorRadiusPx') ?? ANCHOR_RADIUS_PX,\n  handleDot: kit?.get('targets.penHandleDotRadiusPx') ?? HANDLE_DOT_RADIUS_PX,\n  closeHint: kit?.get('targets.penCloseHintRadiusPx') ?? CLOSE_HINT_RADIUS_PX,\n});\n\n// approximateCircle has moved to `./markers.ts` as `circlePath`. Re-exported\n// locally so we don't rename callers in this file.\nfunction approximateCircle(cx: number, cy: number, r: number): PolygonPath {\n  return circlePath(cx, cy, r);\n}\n\n/** A pen subpath as a screen-space `PolygonPath`, segmented by the same rule\n *  the pen commits with. */\nfunction subpathToPath(\n  sp: PenSubpath,\n  view: { x: number; y: number; scale: { x: number; y: number } },\n): PolygonPath | null {\n  if (sp.anchors.length === 0) return null;\n  const pt = (p: { x: number; y: number }) => {\n    const { x: x, y: y } = viewWorldToScreen(view, p);\n    return { x, y };\n  };\n  const anchors = sp.anchors.map((a: PenAnchor) => ({\n    ...pt(a),\n    ...(a.inHandle ? { inHandle: pt(a.inHandle) } : {}),\n    ...(a.outHandle ? { outHandle: pt(a.outHandle) } : {}),\n  }));\n  return anchorsToPath([anchors], [sp.closed]);\n}\n\n/** Render layer that draws the pen tool's path as it is being placed —\n *  committed anchors, the rubber band to the cursor, and the close hint. Draws\n *  nothing when the pen is idle. */\nexport function createPenPreviewLayer(\n  opts: CreatePenPreviewLayerOptions,\n): RenderLayer<unknown> {\n  const style = { ...DEFAULT_STYLE, ...(opts.style ?? {}) };\n  const s = opts.state;\n\n  return {\n    id: 'penPreview',\n    label: 'Pen preview',\n    space: 'screen',\n    draw: (_data, view) => {\n      const out: DrawCommand[] = [];\n      const r = radiiOf(opts.kitSettings?.());\n      // (1) Finished subpaths — faded outline.\n      for (const sp of s.finishedSubpaths) {\n        const path = subpathToPath(sp, view);\n        if (path === null) continue;\n        out.push({\n          kind: 'path',\n          path,\n          stroke: { paint: { kind: 'solid', color: style.finishedSubpathStroke }, width: 1 },\n        });\n      }\n\n      const cur = s.current;\n      if (!cur && s.cursor === null) return out;\n\n      // (2) Current subpath — bright outline.\n      if (cur) {\n        const path = subpathToPath(cur, view);\n        if (path !== null) {\n          out.push({\n            kind: 'path',\n            path,\n            stroke: { paint: { kind: 'solid', color: style.rubberBandStroke }, width: 1 },\n          });\n        }\n      }\n\n      // (3) Rubber-band from latest anchor to cursor.\n      if (cur && cur.anchors.length > 0 && s.cursor && s.draggingHandleAt === null) {\n        const last = cur.anchors[cur.anchors.length - 1];\n        const out2 = last.outHandle;\n        const { x: sx, y: sy } = viewWorldToScreen(view, last);\n        const { x: cx, y: cy } = viewWorldToScreen(view, s.cursor);\n        let path: PolygonPath;\n        if (out2) {\n          const { x: c1x, y: c1y } = viewWorldToScreen(view, out2);\n          path = {\n            kind: 'polygon',\n            commands: new Uint8Array([PATH_M, PATH_C]),\n            coords: new Float32Array([sx, sy, c1x, c1y, cx, cy, cx, cy]),\n            fillRule: 'nonzero',\n          };\n        } else {\n          path = {\n            kind: 'polygon',\n            commands: new Uint8Array([PATH_M, PATH_L]),\n            coords: new Float32Array([sx, sy, cx, cy]),\n            fillRule: 'nonzero',\n          };\n        }\n        out.push({\n          kind: 'path',\n          path,\n          stroke: { paint: { kind: 'solid', color: style.rubberBandStroke }, width: 1 },\n        });\n      }\n\n      // (4) Anchor dots + handles.\n      if (cur) {\n        for (let i = 0; i < cur.anchors.length; i++) {\n          const a = cur.anchors[i];\n          const { x: ax, y: ay } = viewWorldToScreen(view, a);\n          out.push({\n            kind: 'path',\n            path: approximateCircle(ax, ay, r.anchor),\n            fill: { paint: { kind: 'solid', color: style.anchorFill } },\n            stroke: { paint: { kind: 'solid', color: style.anchorStroke }, width: 1 },\n          });\n          // Handle line + dot (only the latest anchor, per spec).\n          if (i === cur.anchors.length - 1 && a.outHandle) {\n            const { x: hx, y: hy } = viewWorldToScreen(view, a.outHandle);\n            const linePath: PolygonPath = {\n              kind: 'polygon',\n              commands: new Uint8Array([PATH_M, PATH_L]),\n              coords: new Float32Array([ax, ay, hx, hy]),\n              fillRule: 'nonzero',\n            };\n            out.push({\n              kind: 'path',\n              path: linePath,\n              stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n            });\n            out.push({\n              kind: 'path',\n              path: approximateCircle(hx, hy, r.handleDot),\n              fill: { paint: { kind: 'solid', color: style.handleStroke } },\n            });\n            const inSide = a.inHandle;\n            if (inSide) {\n              const { x: mx, y: my } = viewWorldToScreen(view, inSide);\n              const inLine: PolygonPath = {\n                kind: 'polygon',\n                commands: new Uint8Array([PATH_M, PATH_L]),\n                coords: new Float32Array([ax, ay, mx, my]),\n                fillRule: 'nonzero',\n              };\n              out.push({\n                kind: 'path',\n                path: inLine,\n                stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n              });\n              out.push({\n                kind: 'path',\n                path: approximateCircle(mx, my, r.handleDot),\n                fill: { paint: { kind: 'solid', color: style.handleStroke } },\n              });\n            }\n          }\n        }\n\n        // (5) Close-hint ring on first anchor.\n        if (s.closeHintActive && cur.anchors.length >= 3) {\n          const first = cur.anchors[0];\n          const { x: fx, y: fy } = viewWorldToScreen(view, first);\n          out.push({\n            kind: 'path',\n            path: approximateCircle(fx, fy, r.closeHint),\n            stroke: { paint: { kind: 'solid', color: style.closeHintFill }, width: 1.5 },\n          });\n        }\n      }\n\n      return out;\n    },\n  };\n}\n"],"mappings":";;;AAsCA,IAAM,gBAA2C;CAC/C,YAAY;CACZ,cAAc;CACd,cAAc;CACd,kBAAkB;CAClB,eAAe;CACf,uBAAuB;AACzB;AAEA,IAAa,mBAAmB;AAChC,IAAa,uBAAuB;AACpC,IAAa,uBAAuB;;AAGpC,IAAa,mBAAmB;;AAGhC,IAAa,cAAc,OAAoE,EAC7F,OAAO,EAAE,kBAAkB,EAAE,aAAa,IAAI,uBAAuB,KAAK,iBAC5E;AAEA,IAAM,WAAW,SAAuC;CACtD,QAAQ,KAAK,IAAI,2BAA2B,KAAK;CACjD,WAAW,KAAK,IAAI,8BAA8B,KAAK;CACvD,WAAW,KAAK,IAAI,8BAA8B,KAAK;AACzD;AAIA,SAAS,kBAAkB,IAAY,IAAY,GAAwB;CACzE,OAAO,WAAW,IAAI,IAAI,CAAC;AAC7B;;;AAIA,SAAS,cACP,IACA,MACoB;CACpB,IAAI,GAAG,QAAQ,WAAW,GAAG,OAAO;CACpC,MAAM,MAAM,MAAgC;EAC1C,MAAM,EAAK,GAAM,MAAM,kBAAkB,MAAM,CAAC;EAChD,OAAO;GAAE;GAAG;EAAE;CAChB;CACA,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAkB;EAChD,GAAG,GAAG,CAAC;EACP,GAAI,EAAE,WAAW,EAAE,UAAU,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC;EACjD,GAAI,EAAE,YAAY,EAAE,WAAW,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC;CACtD,EAAE;CACF,OAAO,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC;AAC7C;;;;AAKA,SAAgB,sBACd,MACsB;CACtB,MAAM,QAAQ;EAAE,GAAG;EAAe,GAAI,KAAK,SAAS,CAAC;CAAG;CACxD,MAAM,IAAI,KAAK;CAEf,OAAO;EACL,IAAI;EACJ,OAAO;EACP,OAAO;EACP,OAAO,OAAO,SAAS;GACrB,MAAM,MAAqB,CAAC;GAC5B,MAAM,IAAI,QAAQ,KAAK,cAAc,CAAC;GAEtC,KAAK,MAAM,MAAM,EAAE,kBAAkB;IACnC,MAAM,OAAO,cAAc,IAAI,IAAI;IACnC,IAAI,SAAS,MAAM;IACnB,IAAI,KAAK;KACP,MAAM;KACN;KACA,QAAQ;MAAE,OAAO;OAAE,MAAM;OAAS,OAAO,MAAM;MAAsB;MAAG,OAAO;KAAE;IACnF,CAAC;GACH;GAEA,MAAM,MAAM,EAAE;GACd,IAAI,CAAC,OAAO,EAAE,WAAW,MAAM,OAAO;GAGtC,IAAI,KAAK;IACP,MAAM,OAAO,cAAc,KAAK,IAAI;IACpC,IAAI,SAAS,MACX,IAAI,KAAK;KACP,MAAM;KACN;KACA,QAAQ;MAAE,OAAO;OAAE,MAAM;OAAS,OAAO,MAAM;MAAiB;MAAG,OAAO;KAAE;IAC9E,CAAC;GAEL;GAGA,IAAI,OAAO,IAAI,QAAQ,SAAS,KAAK,EAAE,UAAU,EAAE,qBAAqB,MAAM;IAC5E,MAAM,OAAO,IAAI,QAAQ,IAAI,QAAQ,SAAS;IAC9C,MAAM,OAAO,KAAK;IAClB,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,IAAI;IACrD,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,EAAE,MAAM;IACzD,IAAI;IACJ,IAAI,MAAM;KACR,MAAM,EAAE,GAAG,KAAK,GAAG,QAAQ,kBAAkB,MAAM,IAAI;KACvD,OAAO;MACL,MAAM;MACN,UAAU,IAAI,WAAW,CAAC,QAAQ,MAAM,CAAC;MACzC,QAAQ,IAAI,aAAa;OAAC;OAAI;OAAI;OAAK;OAAK;OAAI;OAAI;OAAI;MAAE,CAAC;MAC3D,UAAU;KACZ;IACF,OACE,OAAO;KACL,MAAM;KACN,UAAU,IAAI,WAAW,CAAC,QAAQ,MAAM,CAAC;KACzC,QAAQ,IAAI,aAAa;MAAC;MAAI;MAAI;MAAI;KAAE,CAAC;KACzC,UAAU;IACZ;IAEF,IAAI,KAAK;KACP,MAAM;KACN;KACA,QAAQ;MAAE,OAAO;OAAE,MAAM;OAAS,OAAO,MAAM;MAAiB;MAAG,OAAO;KAAE;IAC9E,CAAC;GACH;GAGA,IAAI,KAAK;IACP,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,QAAQ,KAAK;KAC3C,MAAM,IAAI,IAAI,QAAQ;KACtB,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,CAAC;KAClD,IAAI,KAAK;MACP,MAAM;MACN,MAAM,kBAAkB,IAAI,IAAI,EAAE,MAAM;MACxC,MAAM,EAAE,OAAO;OAAE,MAAM;OAAS,OAAO,MAAM;MAAW,EAAE;MAC1D,QAAQ;OAAE,OAAO;QAAE,MAAM;QAAS,OAAO,MAAM;OAAa;OAAG,OAAO;MAAE;KAC1E,CAAC;KAED,IAAI,MAAM,IAAI,QAAQ,SAAS,KAAK,EAAE,WAAW;MAC/C,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,EAAE,SAAS;MAC5D,MAAM,WAAwB;OAC5B,MAAM;OACN,UAAU,IAAI,WAAW,CAAC,QAAQ,MAAM,CAAC;OACzC,QAAQ,IAAI,aAAa;QAAC;QAAI;QAAI;QAAI;OAAE,CAAC;OACzC,UAAU;MACZ;MACA,IAAI,KAAK;OACP,MAAM;OACN,MAAM;OACN,QAAQ;QAAE,OAAO;SAAE,MAAM;SAAS,OAAO,MAAM;QAAa;QAAG,OAAO;OAAE;MAC1E,CAAC;MACD,IAAI,KAAK;OACP,MAAM;OACN,MAAM,kBAAkB,IAAI,IAAI,EAAE,SAAS;OAC3C,MAAM,EAAE,OAAO;QAAE,MAAM;QAAS,OAAO,MAAM;OAAa,EAAE;MAC9D,CAAC;MACD,MAAM,SAAS,EAAE;MACjB,IAAI,QAAQ;OACV,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,MAAM;OACvD,MAAM,SAAsB;QAC1B,MAAM;QACN,UAAU,IAAI,WAAW,CAAC,QAAQ,MAAM,CAAC;QACzC,QAAQ,IAAI,aAAa;SAAC;SAAI;SAAI;SAAI;QAAE,CAAC;QACzC,UAAU;OACZ;OACA,IAAI,KAAK;QACP,MAAM;QACN,MAAM;QACN,QAAQ;SAAE,OAAO;UAAE,MAAM;UAAS,OAAO,MAAM;SAAa;SAAG,OAAO;QAAE;OAC1E,CAAC;OACD,IAAI,KAAK;QACP,MAAM;QACN,MAAM,kBAAkB,IAAI,IAAI,EAAE,SAAS;QAC3C,MAAM,EAAE,OAAO;SAAE,MAAM;SAAS,OAAO,MAAM;QAAa,EAAE;OAC9D,CAAC;MACH;KACF;IACF;IAGA,IAAI,EAAE,mBAAmB,IAAI,QAAQ,UAAU,GAAG;KAChD,MAAM,QAAQ,IAAI,QAAQ;KAC1B,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,kBAAkB,MAAM,KAAK;KACtD,IAAI,KAAK;MACP,MAAM;MACN,MAAM,kBAAkB,IAAI,IAAI,EAAE,SAAS;MAC3C,QAAQ;OAAE,OAAO;QAAE,MAAM;QAAS,OAAO,MAAM;OAAc;OAAG,OAAO;MAAI;KAC7E,CAAC;IACH;GACF;GAEA,OAAO;EACT;CACF;AACF"}

package/dist/domains/paths/shapeGenerator.js

@@ -1,6 +1,6 @@
-import { boundsOfPath, boxToBox, originOf, poseFrameOf, regularPolygonPath, starPath, transformPath, worldCoords, worldEditToStorage } from "@weasel-js/geom";
+import { boundsOfPath, boxToBox, clamp, originOf, poseFrameOf, regularPolygonPath, starPath, transformPath, worldCoords, worldEditToStorage } from "@weasel-js/geom";
 
-//#region src/domains/paths/shapeGenerator.ts
+// src/domains/paths/shapeGenerator.ts
 /**
 * The parameters a polygon or star was drawn with, kept on the node beside the
 * geometry they made (`data.generator` beside `data.path`), so the shape stays
@@ -37,7 +37,6 @@ function shapeGeneratorOf(data) {
 	const g = data?.generator;
 	return isShapeGenerator(g) ? g : null;
 }
-var clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
 var count = (v) => clamp(Math.round(v), SHAPE_COUNT_RANGE.min, SHAPE_COUNT_RANGE.max);
 /** `g` with its counts rounded and every field held in range. */
 function clampShapeGenerator(g) {
@@ -138,6 +137,5 @@ function settleShapeGenerator(next, prev) {
 	};
 }
 
-//#endregion
 export { SHAPE_COUNT_RANGE, STAR_RATIO_RANGE, clampShapeGenerator, isShapeGenerator, regenerateShape, settleShapeGenerator, shapeGeneratorOf, shapeGeneratorPath, withoutShapeGenerator };
 //# sourceMappingURL=shapeGenerator.js.map

package/dist/domains/paths/shapeGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"shapeGenerator.js","names":[],"sources":["../../../src/domains/paths/shapeGenerator.ts"],"sourcesContent":["/**\n * The parameters a polygon or star was drawn with, kept on the node beside the\n * geometry they made (`data.generator` beside `data.path`), so the shape stays\n * editable as a polygon or a star after it is drawn.\n *\n * `data.path` stays the geometry every reader uses; the generator only says how\n * to make it again. Editing the path itself turns the shape into plain\n * geometry: the generator is dropped, since it could no longer reproduce what\n * is drawn. A generator whose path no longer matches it (a writer that changed\n * the path without dropping it) is treated the same way.\n */\nimport {\n  boundsOfPath,\n  boxToBox,\n  poseFrameOf,\n  regularPolygonPath,\n  starPath,\n  transformPath,\n  originOf,\n  worldCoords,\n  worldEditToStorage,\n  type PathInWorldPose,\n  type PolygonPath,\n} from '@weasel-js/geom';\n\n/** A regular polygon's parameters. `rotation` is the angle of its first\n *  vertex, in radians, inside the pose's own rotation. */\nexport interface PolygonGenerator {\n  kind: 'polygon';\n  sides: number;\n  rotation: number;\n}\n\n/** A star's parameters. `innerRadiusRatio` is the inner radius over the outer\n *  one; `rotation` is the angle of its first point, in radians, inside the\n *  pose's own rotation. */\nexport interface StarGenerator {\n  kind: 'star';\n  points: number;\n  innerRadiusRatio: number;\n  rotation: number;\n}\n\n/** The parameters a node's `data.path` was generated from. */\nexport type ShapeGenerator = PolygonGenerator | StarGenerator;\n\n/** The range of a polygon's side count and a star's point count. */\nexport const SHAPE_COUNT_RANGE = { min: 3, max: 32 } as const;\n\n/** The range of a star's `innerRadiusRatio`. */\nexport const STAR_RATIO_RANGE = { min: 0.01, max: 1 } as const;\n\nconst finite = (v: unknown): v is number => typeof v === 'number' && Number.isFinite(v);\n\n/** Whether `v` is a well-formed {@link ShapeGenerator}. */\nexport function isShapeGenerator(v: unknown): v is ShapeGenerator {\n  if (v === null || typeof v !== 'object') return false;\n  const g = v as Record<string, unknown>;\n  if (!finite(g.rotation)) return false;\n  if (g.kind === 'polygon') return finite(g.sides);\n  if (g.kind === 'star') return finite(g.points) && finite(g.innerRadiusRatio);\n  return false;\n}\n\n/** The generator a node's `data` holds, or `null`. */\nexport function shapeGeneratorOf(data: unknown): ShapeGenerator | null {\n  const g = (data as { generator?: unknown } | null | undefined)?.generator;\n  return isShapeGenerator(g) ? g : null;\n}\n\nconst clamp = (v: number, lo: number, hi: number): number => Math.min(hi, Math.max(lo, v));\nconst count = (v: number): number => clamp(Math.round(v), SHAPE_COUNT_RANGE.min, SHAPE_COUNT_RANGE.max);\n\n/** `g` with its counts rounded and every field held in range. */\nexport function clampShapeGenerator(g: ShapeGenerator): ShapeGenerator {\n  if (g.kind === 'polygon') return { kind: 'polygon', sides: count(g.sides), rotation: g.rotation };\n  return {\n    kind: 'star',\n    points: count(g.points),\n    innerRadiusRatio: clamp(g.innerRadiusRatio, STAR_RATIO_RANGE.min, STAR_RATIO_RANGE.max),\n    rotation: g.rotation,\n  };\n}\n\n/** The shape `g` makes, on a circle of `radius` around `center`. */\nexport function shapeGeneratorPath(\n  g: ShapeGenerator,\n  center: { x: number; y: number } = { x: 0, y: 0 },\n  radius = 1,\n): PolygonPath {\n  const c = clampShapeGenerator(g);\n  return c.kind === 'polygon'\n    ? regularPolygonPath(center, radius, c.sides, c.rotation)\n    : starPath(center, radius, c.points, radius * c.innerRadiusRatio, c.rotation);\n}\n\n/** `data` without its generator: the shape as plain geometry. */\nexport function withoutShapeGenerator<T>(data: T): T {\n  if (data === null || typeof data !== 'object' || !('generator' in data)) return data;\n  const { generator: _dropped, ...rest } = data as Record<string, unknown>;\n  void _dropped;\n  return rest as T;\n}\n\n/** Whether `path` is what `g` makes, up to the box-to-box map storage applies. */\nfunction pathMatches(path: unknown, g: ShapeGenerator): boolean {\n  const p = path as PolygonPath | undefined;\n  if (p?.kind !== 'polygon') return false;\n  const unit = shapeGeneratorPath(g);\n  if (p.coords.length !== unit.coords.length) return false;\n  const u = boundsOfPath(unit);\n  const b = boundsOfPath(p);\n  const m = boxToBox(u.x, u.y, u.width, u.height, b.x, b.y, b.width, b.height);\n  // Paths store float32 coordinates, so the slack scales with how far they are from the point they are measured from.\n  const o = originOf(p);\n  const tol = 1e-4 * Math.max(1, Math.abs(b.x - o.x) + b.width, Math.abs(b.y - o.y) + b.height);\n  const at = worldCoords(p);\n  for (let i = 0; i + 1 < unit.coords.length; i += 2) {\n    const x = m[0] * unit.coords[i] + m[4];\n    const y = m[3] * unit.coords[i + 1] + m[5];\n    if (Math.abs(x - at[i]) > tol || Math.abs(y - at[i + 1]) > tol) return false;\n  }\n  return true;\n}\n\n/** A node's two halves, as a regeneration reads and writes them. */\nexport interface GeneratedShape<P extends PathInWorldPose = PathInWorldPose> {\n  pose: P;\n  data: unknown;\n}\n\n/**\n * `node` made again from `next`, in place: the new shape takes the box the old\n * one's circle had, under the same rotation and transform, so a star given\n * more points keeps its center and its size. Returns `null` when the node holds\n * no generator, or its path no longer matches the one it holds.\n */\nexport function regenerateShape<P extends PathInWorldPose>(\n  node: GeneratedShape<P>,\n  next: ShapeGenerator,\n): GeneratedShape<P> | null {\n  const held = shapeGeneratorOf(node.data);\n  if (!held || !pathMatches((node.data as { path?: unknown }).path, held)) return null;\n  const g = clampShapeGenerator(next);\n  const was = boundsOfPath(shapeGeneratorPath(held));\n  const { pose } = node;\n  // Where the unit circle of the held generator lands in the pose's local frame.\n  const toLocal = boxToBox(was.x, was.y, was.width, was.height, pose.x, pose.y, pose.width, pose.height);\n  const local = transformPath(shapeGeneratorPath(g), toLocal) as PolygonPath;\n  const frame = poseFrameOf(pose);\n  const world = frame ? (transformPath(local, frame) as PolygonPath) : local;\n  const stored = worldEditToStorage(pose, world);\n  return { pose: stored.pose, data: { ...(node.data as object), path: stored.path, generator: g } };\n}\n\n/**\n * What a write that left a node as `next`, from `prev`, stores: when the write\n * changed the generator, the shape made again from it. A generator written\n * onto a node that held none, or of another kind, or onto one whose path no\n * longer matches, is dropped, leaving the shape as plain geometry. Any other\n * write is stored as written. Fits `NodePropertiesEntry.settle`.\n */\nexport function settleShapeGenerator<N extends { pose: unknown; data: unknown }>(next: N, prev: N): N {\n  const data = next.data as Record<string, unknown> | null;\n  if (data === null || typeof data !== 'object' || !('generator' in data)) return next;\n  const raw = data.generator;\n  const held = shapeGeneratorOf(prev.data);\n  if (held !== null && JSON.stringify(raw) === JSON.stringify(held)) return next;\n  const regenerated = held !== null && isShapeGenerator(raw) && raw.kind === held.kind\n    ? regenerateShape({ pose: next.pose as PathInWorldPose, data: { ...data, generator: held } }, raw)\n    : null;\n  return { ...next, ...(regenerated ?? { data: withoutShapeGenerator(next.data) }) };\n}\n"],"mappings":"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"}
+{"version":3,"file":"shapeGenerator.js","names":[],"sources":["../../../src/domains/paths/shapeGenerator.ts"],"sourcesContent":["/**\n * The parameters a polygon or star was drawn with, kept on the node beside the\n * geometry they made (`data.generator` beside `data.path`), so the shape stays\n * editable as a polygon or a star after it is drawn.\n *\n * `data.path` stays the geometry every reader uses; the generator only says how\n * to make it again. Editing the path itself turns the shape into plain\n * geometry: the generator is dropped, since it could no longer reproduce what\n * is drawn. A generator whose path no longer matches it (a writer that changed\n * the path without dropping it) is treated the same way.\n */\nimport {\n  boundsOfPath,\n  boxToBox,\n  clamp,\n  poseFrameOf,\n  regularPolygonPath,\n  starPath,\n  transformPath,\n  originOf,\n  worldCoords,\n  worldEditToStorage,\n  type PathInWorldPose,\n  type PolygonPath,\n} from '@weasel-js/geom';\n\n/** A regular polygon's parameters. `rotation` is the angle of its first\n *  vertex, in radians, inside the pose's own rotation. */\nexport interface PolygonGenerator {\n  kind: 'polygon';\n  sides: number;\n  rotation: number;\n}\n\n/** A star's parameters. `innerRadiusRatio` is the inner radius over the outer\n *  one; `rotation` is the angle of its first point, in radians, inside the\n *  pose's own rotation. */\nexport interface StarGenerator {\n  kind: 'star';\n  points: number;\n  innerRadiusRatio: number;\n  rotation: number;\n}\n\n/** The parameters a node's `data.path` was generated from. */\nexport type ShapeGenerator = PolygonGenerator | StarGenerator;\n\n/** The range of a polygon's side count and a star's point count. */\nexport const SHAPE_COUNT_RANGE = { min: 3, max: 32 } as const;\n\n/** The range of a star's `innerRadiusRatio`. */\nexport const STAR_RATIO_RANGE = { min: 0.01, max: 1 } as const;\n\nconst finite = (v: unknown): v is number => typeof v === 'number' && Number.isFinite(v);\n\n/** Whether `v` is a well-formed {@link ShapeGenerator}. */\nexport function isShapeGenerator(v: unknown): v is ShapeGenerator {\n  if (v === null || typeof v !== 'object') return false;\n  const g = v as Record<string, unknown>;\n  if (!finite(g.rotation)) return false;\n  if (g.kind === 'polygon') return finite(g.sides);\n  if (g.kind === 'star') return finite(g.points) && finite(g.innerRadiusRatio);\n  return false;\n}\n\n/** The generator a node's `data` holds, or `null`. */\nexport function shapeGeneratorOf(data: unknown): ShapeGenerator | null {\n  const g = (data as { generator?: unknown } | null | undefined)?.generator;\n  return isShapeGenerator(g) ? g : null;\n}\n\nconst count = (v: number): number => clamp(Math.round(v), SHAPE_COUNT_RANGE.min, SHAPE_COUNT_RANGE.max);\n\n/** `g` with its counts rounded and every field held in range. */\nexport function clampShapeGenerator(g: ShapeGenerator): ShapeGenerator {\n  if (g.kind === 'polygon') return { kind: 'polygon', sides: count(g.sides), rotation: g.rotation };\n  return {\n    kind: 'star',\n    points: count(g.points),\n    innerRadiusRatio: clamp(g.innerRadiusRatio, STAR_RATIO_RANGE.min, STAR_RATIO_RANGE.max),\n    rotation: g.rotation,\n  };\n}\n\n/** The shape `g` makes, on a circle of `radius` around `center`. */\nexport function shapeGeneratorPath(\n  g: ShapeGenerator,\n  center: { x: number; y: number } = { x: 0, y: 0 },\n  radius = 1,\n): PolygonPath {\n  const c = clampShapeGenerator(g);\n  return c.kind === 'polygon'\n    ? regularPolygonPath(center, radius, c.sides, c.rotation)\n    : starPath(center, radius, c.points, radius * c.innerRadiusRatio, c.rotation);\n}\n\n/** `data` without its generator: the shape as plain geometry. */\nexport function withoutShapeGenerator<T>(data: T): T {\n  if (data === null || typeof data !== 'object' || !('generator' in data)) return data;\n  const { generator: _dropped, ...rest } = data as Record<string, unknown>;\n  void _dropped;\n  return rest as T;\n}\n\n/** Whether `path` is what `g` makes, up to the box-to-box map storage applies. */\nfunction pathMatches(path: unknown, g: ShapeGenerator): boolean {\n  const p = path as PolygonPath | undefined;\n  if (p?.kind !== 'polygon') return false;\n  const unit = shapeGeneratorPath(g);\n  if (p.coords.length !== unit.coords.length) return false;\n  const u = boundsOfPath(unit);\n  const b = boundsOfPath(p);\n  const m = boxToBox(u.x, u.y, u.width, u.height, b.x, b.y, b.width, b.height);\n  // Paths store float32 coordinates, so the slack scales with how far they are from the point they are measured from.\n  const o = originOf(p);\n  const tol = 1e-4 * Math.max(1, Math.abs(b.x - o.x) + b.width, Math.abs(b.y - o.y) + b.height);\n  const at = worldCoords(p);\n  for (let i = 0; i + 1 < unit.coords.length; i += 2) {\n    const x = m[0] * unit.coords[i] + m[4];\n    const y = m[3] * unit.coords[i + 1] + m[5];\n    if (Math.abs(x - at[i]) > tol || Math.abs(y - at[i + 1]) > tol) return false;\n  }\n  return true;\n}\n\n/** A node's two halves, as a regeneration reads and writes them. */\nexport interface GeneratedShape<P extends PathInWorldPose = PathInWorldPose> {\n  pose: P;\n  data: unknown;\n}\n\n/**\n * `node` made again from `next`, in place: the new shape takes the box the old\n * one's circle had, under the same rotation and transform, so a star given\n * more points keeps its center and its size. Returns `null` when the node holds\n * no generator, or its path no longer matches the one it holds.\n */\nexport function regenerateShape<P extends PathInWorldPose>(\n  node: GeneratedShape<P>,\n  next: ShapeGenerator,\n): GeneratedShape<P> | null {\n  const held = shapeGeneratorOf(node.data);\n  if (!held || !pathMatches((node.data as { path?: unknown }).path, held)) return null;\n  const g = clampShapeGenerator(next);\n  const was = boundsOfPath(shapeGeneratorPath(held));\n  const { pose } = node;\n  // Where the unit circle of the held generator lands in the pose's local frame.\n  const toLocal = boxToBox(was.x, was.y, was.width, was.height, pose.x, pose.y, pose.width, pose.height);\n  const local = transformPath(shapeGeneratorPath(g), toLocal) as PolygonPath;\n  const frame = poseFrameOf(pose);\n  const world = frame ? (transformPath(local, frame) as PolygonPath) : local;\n  const stored = worldEditToStorage(pose, world);\n  return { pose: stored.pose, data: { ...(node.data as object), path: stored.path, generator: g } };\n}\n\n/**\n * What a write that left a node as `next`, from `prev`, stores: when the write\n * changed the generator, the shape made again from it. A generator written\n * onto a node that held none, or of another kind, or onto one whose path no\n * longer matches, is dropped, leaving the shape as plain geometry. Any other\n * write is stored as written. Fits `NodePropertiesEntry.settle`.\n */\nexport function settleShapeGenerator<N extends { pose: unknown; data: unknown }>(next: N, prev: N): N {\n  const data = next.data as Record<string, unknown> | null;\n  if (data === null || typeof data !== 'object' || !('generator' in data)) return next;\n  const raw = data.generator;\n  const held = shapeGeneratorOf(prev.data);\n  if (held !== null && JSON.stringify(raw) === JSON.stringify(held)) return next;\n  const regenerated = held !== null && isShapeGenerator(raw) && raw.kind === held.kind\n    ? regenerateShape({ pose: next.pose as PathInWorldPose, data: { ...data, generator: held } }, raw)\n    : null;\n  return { ...next, ...(regenerated ?? { data: withoutShapeGenerator(next.data) }) };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgDA,IAAa,oBAAoB;CAAE,KAAK;CAAG,KAAK;AAAG;;AAGnD,IAAa,mBAAmB;CAAE,KAAK;CAAM,KAAK;AAAE;AAEpD,IAAM,UAAU,MAA4B,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC;;AAGtF,SAAgB,iBAAiB,GAAiC;CAChE,IAAI,MAAM,QAAQ,OAAO,MAAM,UAAU,OAAO;CAChD,MAAM,IAAI;CACV,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;CAChC,IAAI,EAAE,SAAS,WAAW,OAAO,OAAO,EAAE,KAAK;CAC/C,IAAI,EAAE,SAAS,QAAQ,OAAO,OAAO,EAAE,MAAM,KAAK,OAAO,EAAE,gBAAgB;CAC3E,OAAO;AACT;;AAGA,SAAgB,iBAAiB,MAAsC;CACrE,MAAM,IAAK,MAAqD;CAChE,OAAO,iBAAiB,CAAC,IAAI,IAAI;AACnC;AAEA,IAAM,SAAS,MAAsB,MAAM,KAAK,MAAM,CAAC,GAAG,kBAAkB,KAAK,kBAAkB,GAAG;;AAGtG,SAAgB,oBAAoB,GAAmC;CACrE,IAAI,EAAE,SAAS,WAAW,OAAO;EAAE,MAAM;EAAW,OAAO,MAAM,EAAE,KAAK;EAAG,UAAU,EAAE;CAAS;CAChG,OAAO;EACL,MAAM;EACN,QAAQ,MAAM,EAAE,MAAM;EACtB,kBAAkB,MAAM,EAAE,kBAAkB,iBAAiB,KAAK,iBAAiB,GAAG;EACtF,UAAU,EAAE;CACd;AACF;;AAGA,SAAgB,mBACd,GACA,SAAmC;CAAE,GAAG;CAAG,GAAG;AAAE,GAChD,SAAS,GACI;CACb,MAAM,IAAI,oBAAoB,CAAC;CAC/B,OAAO,EAAE,SAAS,YACd,mBAAmB,QAAQ,QAAQ,EAAE,OAAO,EAAE,QAAQ,IACtD,SAAS,QAAQ,QAAQ,EAAE,QAAQ,SAAS,EAAE,kBAAkB,EAAE,QAAQ;AAChF;;AAGA,SAAgB,sBAAyB,MAAY;CACnD,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,eAAe,OAAO,OAAO;CAChF,MAAM,EAAE,WAAW,UAAU,GAAG,SAAS;CAEzC,OAAO;AACT;;AAGA,SAAS,YAAY,MAAe,GAA4B;CAC9D,MAAM,IAAI;CACV,IAAI,GAAG,SAAS,WAAW,OAAO;CAClC,MAAM,OAAO,mBAAmB,CAAC;CACjC,IAAI,EAAE,OAAO,WAAW,KAAK,OAAO,QAAQ,OAAO;CACnD,MAAM,IAAI,aAAa,IAAI;CAC3B,MAAM,IAAI,aAAa,CAAC;CACxB,MAAM,IAAI,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;CAE3E,MAAM,IAAI,SAAS,CAAC;CACpB,MAAM,MAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM;CAC5F,MAAM,KAAK,YAAY,CAAC;CACxB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;EAClD,MAAM,IAAI,EAAE,KAAK,KAAK,OAAO,KAAK,EAAE;EACpC,MAAM,IAAI,EAAE,KAAK,KAAK,OAAO,IAAI,KAAK,EAAE;EACxC,IAAI,KAAK,IAAI,IAAI,GAAG,EAAE,IAAI,OAAO,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO;CACzE;CACA,OAAO;AACT;;;;;;;AAcA,SAAgB,gBACd,MACA,MAC0B;CAC1B,MAAM,OAAO,iBAAiB,KAAK,IAAI;CACvC,IAAI,CAAC,QAAQ,CAAC,YAAa,KAAK,KAA4B,MAAM,IAAI,GAAG,OAAO;CAChF,MAAM,IAAI,oBAAoB,IAAI;CAClC,MAAM,MAAM,aAAa,mBAAmB,IAAI,CAAC;CACjD,MAAM,EAAE,SAAS;CAEjB,MAAM,UAAU,SAAS,IAAI,GAAG,IAAI,GAAG,IAAI,OAAO,IAAI,QAAQ,KAAK,GAAG,KAAK,GAAG,KAAK,OAAO,KAAK,MAAM;CACrG,MAAM,QAAQ,cAAc,mBAAmB,CAAC,GAAG,OAAO;CAC1D,MAAM,QAAQ,YAAY,IAAI;CAC9B,MAAM,QAAQ,QAAS,cAAc,OAAO,KAAK,IAAoB;CACrE,MAAM,SAAS,mBAAmB,MAAM,KAAK;CAC7C,OAAO;EAAE,MAAM,OAAO;EAAM,MAAM;GAAE,GAAI,KAAK;GAAiB,MAAM,OAAO;GAAM,WAAW;EAAE;CAAE;AAClG;;;;;;;;AASA,SAAgB,qBAAiE,MAAS,MAAY;CACpG,MAAM,OAAO,KAAK;CAClB,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,eAAe,OAAO,OAAO;CAChF,MAAM,MAAM,KAAK;CACjB,MAAM,OAAO,iBAAiB,KAAK,IAAI;CACvC,IAAI,SAAS,QAAQ,KAAK,UAAU,GAAG,MAAM,KAAK,UAAU,IAAI,GAAG,OAAO;CAC1E,MAAM,cAAc,SAAS,QAAQ,iBAAiB,GAAG,KAAK,IAAI,SAAS,KAAK,OAC5E,gBAAgB;EAAE,MAAM,KAAK;EAAyB,MAAM;GAAE,GAAG;GAAM,WAAW;EAAK;CAAE,GAAG,GAAG,IAC/F;CACJ,OAAO;EAAE,GAAG;EAAM,GAAI,eAAe,EAAE,MAAM,sBAAsB,KAAK,IAAI,EAAE;CAAG;AACnF"}

package/dist/domains/paths/strokeOutline.js

@@ -1,7 +1,7 @@
-import { findShapeSilhouette } from "../../canvas/NodeShape.js";
 import { isSilhouettePose } from "../../core/geometry/regionHit.js";
+import { findShapeSilhouette } from "../../canvas/NodeShape.js";
 
-//#region src/domains/paths/strokeOutline.ts
+// src/domains/paths/strokeOutline.ts
 /** The outline `node` is drawn with, in world coords: its pose when the pose
 *  is a polygon, else its painter's silhouette. Null for a node with neither. */
 function nodeOutline(node) {
@@ -10,6 +10,5 @@ function nodeOutline(node) {
 	return findShapeSilhouette(node, pose);
 }
 
-//#endregion
 export { nodeOutline };
 //# sourceMappingURL=strokeOutline.js.map

package/dist/domains/paths/useAnchorFields.js

@@ -2,7 +2,7 @@ import { anchorFieldsOf } from "../../interactions/actions/defaults/anchorFields
 import { useMemo, useSyncExternalStore } from "react";
 import { useActionsRegistry, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/domains/paths/useAnchorFields.ts
+// src/domains/paths/useAnchorFields.ts
 /**
 * The anchor fields of the path being edited, for chrome beside the canvas:
 * a panel showing the selected anchors' numbers and writing typed ones back.
@@ -30,6 +30,5 @@ function useAnchorFields() {
 	}), [json, actions]);
 }
 
-//#endregion
 export { useAnchorFields };
 //# sourceMappingURL=useAnchorFields.js.map

package/dist/domains/paths/usePathEdit.js

@@ -1,11 +1,11 @@
 import { rectFromPlane } from "../../core/viewport/parallax.js";
 import { liveAnchorMarkers, liveEditablePath } from "./editablePath.js";
-import { createPathEditState } from "./pathEditState.js";
 import { createPathEditingOverlayLayer } from "./pathEditingOverlayLayer.js";
+import { createPathEditState } from "./pathEditState.js";
 import { useEffect, useMemo, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/domains/paths/usePathEdit.ts
+// src/domains/paths/usePathEdit.ts
 /**
 * The path-edit state and its anchor overlay for one canvas surface.
 */
@@ -59,6 +59,5 @@ function usePathEditOverlayLayer(state, inputs, config) {
 	]);
 }
 
-//#endregion
 export { usePathEditOverlayLayer, usePathEditState };
 //# sourceMappingURL=usePathEdit.js.map

package/dist/domains/poseRun/usePoseRun.js

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 
-//#region src/domains/poseRun/usePoseRun.ts
+// src/domains/poseRun/usePoseRun.ts
 /**
 * A pose run: poses published per frame, committed once.
 *
@@ -124,6 +124,5 @@ function usePoseRun(opts) {
 	}), [loop]);
 }
 
-//#endregion
 export { usePoseRun };
 //# sourceMappingURL=usePoseRun.js.map

package/dist/domains/selection/enteredGroupFrame.js

@@ -5,7 +5,7 @@ import { enteredOperandOutlines } from "./enteredOperands.js";
 import { transformPath } from "@weasel-js/geom";
 import { useMemo } from "react";
 
-//#region src/domains/selection/enteredGroupFrame.ts
+// src/domains/selection/enteredGroupFrame.ts
 /** The theme token the frame reads its color from, set on the canvas or any element above it. */
 var ENTERED_FRAME_TOKEN = "--wzl-entered-group";
 /** The frame's color where nothing sets {@link ENTERED_FRAME_TOKEN}. */
@@ -99,6 +99,5 @@ function useEnteredGroupFrameLayer(entered, boundsOf, color, scene) {
 	]);
 }
 
-//#endregion
 export { ENTERED_FRAME_COLOR, ENTERED_FRAME_TOKEN, createEnteredGroupFrameLayer, useEnteredGroupFrameLayer };
 //# sourceMappingURL=enteredGroupFrame.js.map

package/dist/domains/selection/enteredGroupScope.js

@@ -2,7 +2,7 @@ import { reachableInGroup } from "../../canvas/deps/enteredGroup.js";
 import { createEmitter } from "@weasel-js/registry";
 import { OUT_OF_SCOPE_ALPHA } from "@weasel-js/modes";
 
-//#region src/domains/selection/enteredGroupScope.ts
+// src/domains/selection/enteredGroupScope.ts
 /**
 * The entered group as a scope: everything outside its subtree dims and stops taking hits, and
 * so does the group itself, whose empty box is empty canvas while it is entered. With nothing
@@ -39,6 +39,5 @@ function createEnteredGroupScope(opts) {
 	};
 }
 
-//#endregion
 export { createEnteredGroupScope };
 //# sourceMappingURL=enteredGroupScope.js.map

package/dist/domains/selection/enteredOperands.js

@@ -1,7 +1,7 @@
 import { operandOf } from "../../core/scene/booleanOfChildren.js";
 import { sceneDepLookup } from "../../canvas/derivedPath.js";
 
-//#region src/domains/selection/enteredOperands.ts
+// src/domains/selection/enteredOperands.ts
 /** The world outline of each shown node under the outermost node at or above `entered` that
 *  consumes its children, a group's members each on their own; none when no such node is. */
 function enteredOperandOutlines(scene, entered) {
@@ -24,6 +24,5 @@ function enteredOperandOutlines(scene, entered) {
 	return out;
 }
 
-//#endregion
 export { enteredOperandOutlines };
 //# sourceMappingURL=enteredOperands.js.map

package/dist/domains/selection/handleCommands.js

@@ -1,13 +1,13 @@
+import { angleOf, localToWorld, targetTransformOf } from "../../core/geometry/targetFrame.js";
 import { viewToTransform } from "../../core/viewport/view.js";
 import { worldToScreen } from "../../core/viewport/viewTransform.js";
 import { HANDLE_BASE_PX } from "../../core/device/targets.js";
-import { angleOf, localToWorld, targetTransformOf } from "../../core/geometry/targetFrame.js";
 import { handlePoint, resizeHandlesFor } from "../../interactions/actions/resize/cornerHandles.js";
 import { screenAngleOf } from "@weasel-js/geom";
 import { alignedStrokeRect } from "@weasel-js/paint";
 import { resolveStrokeWidth } from "@weasel-js/stroke";
 
-//#region src/domains/selection/handleCommands.ts
+// src/domains/selection/handleCommands.ts
 var DEFAULT_HANDLE_FILL = { paint: {
 	kind: "solid",
 	color: "#d4c4a8"
@@ -111,6 +111,5 @@ function handleCommandsFor(ids, resolveBounds, handles, handlesOf, layoutOpts, v
 	return out;
 }
 
-//#endregion
 export { handleCommandsFor, rectPathFor, resolveHandles };
 //# sourceMappingURL=handleCommands.js.map

package/dist/domains/selection/overlay.js

@@ -1,17 +1,17 @@
-import { viewToTransform } from "../../core/viewport/view.js";
-import { worldToScreen } from "../../core/viewport/viewTransform.js";
-import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
-import { targetCorners, targetTransformOf } from "../../core/geometry/targetFrame.js";
-import { MULTI_RESIZE_TARGET_ID } from "../../core/selection/selectionTarget.js";
 import { composeSelectionPose, containerAwareBoundsResolver } from "./selectionPose.js";
+import { targetCorners, targetTransformOf } from "../../core/geometry/targetFrame.js";
+import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
 import { DEFAULT_ROTATION_HANDLE_DISTANCE, rotationHandle } from "../../interactions/actions/rotate/handle.js";
+import { MULTI_RESIZE_TARGET_ID } from "../../core/selection/selectionTarget.js";
+import { viewToTransform } from "../../core/viewport/view.js";
+import { worldToScreen } from "../../core/viewport/viewTransform.js";
 import { handleCommandsFor, rectPathFor, resolveHandles } from "./handleCommands.js";
 import { mat3 } from "@weasel-js/renderer";
 import { PATH_L, PATH_M, PATH_Z } from "@weasel-js/geom";
 import { alignedStrokeRect } from "@weasel-js/paint";
 import { resolveStrokeWidth } from "@weasel-js/stroke";
 
-//#region src/domains/selection/overlay.ts
+// src/domains/selection/overlay.ts
 /** Project world AABB into screen-space AABB using the active view. */
 function projectBounds(b, view) {
 	const t = viewToTransform(view);
@@ -389,6 +389,5 @@ function asChromeState(data) {
 	return null;
 }
 
-//#endregion
 export { composeSelectionPose, createSelectionHandlesLayer, createSelectionOutlineLayer, createSelectionOverlayLayer, rotationBadgeOf };
 //# sourceMappingURL=overlay.js.map

package/dist/domains/selection/selectionPose.js

@@ -1,9 +1,9 @@
+import { drawnAABBOf, drawnBoundsOf } from "../../canvas/drawnBounds.js";
 import { unionAABB } from "../../core/geometry/unionBounds.js";
 import { framedBounds, visualBoundsViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
-import { drawnAABBOf, drawnBoundsOf } from "../../canvas/drawnBounds.js";
 
-//#region src/domains/selection/selectionPose.ts
+// src/domains/selection/selectionPose.ts
 /**
 * Transitive leaf ids under `id`. A childless node is a leaf only if it is not
 * itself a container: an empty container contributes no bounds, and its own
@@ -107,6 +107,5 @@ function containerAwareBoundsResolver(getPose, d, getChildren, isContainer, scen
 	};
 }
 
-//#endregion
 export { composeSelectionPose, containerAwareBoundsResolver };
 //# sourceMappingURL=selectionPose.js.map

package/dist/domains/snap/angle2d.js

@@ -1,9 +1,10 @@
 import { distinct, markFromPlane } from "./marks.js";
 import { screenOf } from "./screen.js";
 import { stepAngles } from "./stepAngles.js";
+import { wrapPositive } from "@weasel-js/geom";
 import { resolveSnap } from "@weasel-js/geom/nd";
 
-//#region src/domains/snap/angle2d.ts
+// src/domains/snap/angle2d.ts
 /** A snap session's one-dimensional path: an angle about a pivot, snapped by
 *  the same resolver as a point, with reach carried through the radius. */
 var TURN = Math.PI * 2;
@@ -140,7 +141,7 @@ function rayMarks(inputs, theta) {
 		x: pivot.x + r * Math.cos(dir),
 		y: pivot.y + r * Math.sin(dir)
 	};
-	const deg = (Math.round(theta * 180 / Math.PI) % 360 + 360) % 360;
+	const deg = wrapPositive(Math.round(theta * 180 / Math.PI), 360);
 	return [{
 		kind: "line",
 		from: pivot,
@@ -153,6 +154,5 @@ function rayMarks(inputs, theta) {
 	}];
 }
 
-//#endregion
 export { angleAt };
 //# sourceMappingURL=angle2d.js.map

package/dist/domains/snap/angle2d.js.map

@@ -1 +1 @@
-{"version":3,"file":"angle2d.js","names":[],"sources":["../../../src/domains/snap/angle2d.ts"],"sourcesContent":["/** A snap session's one-dimensional path: an angle about a pivot, snapped by\n *  the same resolver as a point, with reach carried through the radius. */\nimport { resolveSnap, type SnapCandidate } from '@weasel-js/geom/nd';\nimport type { SnapMods } from 'interactions/actions/snapDep';\nimport { distinct, markFromPlane } from './marks';\nimport { screenOf } from './screen';\nimport { stepAngles } from './stepAngles';\nimport type { Session2dInputs } from './session2d';\nimport type { AngleCollect, SnapMark, SnapMarks, SnapSource } from './types';\n\nconst TURN = Math.PI * 2;\nconst PROBE = 'angle';\n/** A press near the pivot turns px reach into a wide angle; it reaches no\n *  further than this. */\nconst MAX_REACH_RAD = Math.PI / 6;\n\n/** Where `theta` lands, and what it met. Writes the marks to the store. */\nexport function angleAt(\n  inputs: Session2dInputs, sources: readonly SnapSource[], theta: number, mods: SnapMods,\n): { theta: number; marks: readonly SnapMark[] } {\n  const { req, store } = inputs;\n  // Screen px per radian, or 1 when the gesture gives its reach in radians.\n  const scale = req.reachRad !== undefined ? 1 : pressRadiusPx(inputs);\n  const reachOf = (s: SnapSource) => req.reachRad\n    ?? Math.min(s.reachPx ?? inputs.reachPx, MAX_REACH_RAD * scale);\n  const candidates = collectAngles(inputs, sources, theta, mods, reachOf);\n  if (candidates.length === 0) {\n    store.set([]);\n    return { theta, marks: [] };\n  }\n  const res = resolveSnap({\n    probes: [{ id: PROBE, at: [0], role: 'pointer' }],\n    input: { at: [0], dirs: [[1]] },\n    delta0: [theta],\n    candidates,\n    // No radius, no reach: only a required angle can win.\n    toScreen: ([t]) => [scale > 0 ? t * scale : NaN],\n  });\n  const out = res.delta[0];\n  const marks = distinct(res.satisfied.flatMap((c) => {\n    const m = c.mark ?? rayMarks(inputs, out);\n    return 'kind' in m ? [m] : m;\n  }));\n  const plane = req.plane?.() ?? null;\n  store.set(plane ? marks.map((m) => markFromPlane(m, plane)) : marks);\n  return { theta: out, marks };\n}\n\nfunction collectAngles(\n  inputs: Session2dInputs, sources: readonly SnapSource[], theta: number, mods: SnapMods,\n  reachOf: (s: SnapSource) => number,\n): SnapCandidate<SnapMarks>[] {\n  const { req } = inputs;\n  const out: SnapCandidate<SnapMarks>[] = [];\n  const c = req.constrain;\n  if (mods.constrain && typeof c === 'object' && c.step > 0) {\n    for (const at of stepAngles(theta, c.step)) {\n      out.push({ probe: PROBE, locus: { at: [at], dirs: [] }, source: 'constrain', order: -1, tier: 'target', reachPx: 0, required: true });\n    }\n  }\n  const theta0 = req.theta0 ?? 0;\n  if (mods.hold) {\n    const at = theta0 + TURN * Math.round((theta - theta0) / TURN);\n    out.push({ probe: PROBE, locus: { at: [at], dirs: [] }, source: 'hold', order: -1, tier: 'target', reachPx: 0, required: true, mark: [] });\n  }\n  if (mods.suspend) return out;\n  const q: AngleCollect = {\n    pivot: req.pivot ?? req.press,\n    press: req.press,\n    theta0,\n    theta,\n    ids: req.ids ?? [],\n    exclude: inputs.exclude ?? req.ids ?? [],\n    mods,\n    ...(req.also ? { also: req.also } : {}),\n    ...(inputs.scene ? { scene: inputs.scene } : {}),\n    ...(inputs.rotationOf ? { rotationOf: inputs.rotationOf } : {}),\n  };\n  // Runs across sources and their yields: an earlier source, then an earlier\n  // yield, wins a tie.\n  let order = 0;\n  sources.forEach((source) => {\n    if (!source.angles) return;\n    const reachPx = reachOf(source);\n    for (const a of source.angles(q)) {\n      // The whole turn of the angle nearest `theta`: 0 catches 359°.\n      const at = a.angle + TURN * Math.round((theta - a.angle) / TURN);\n      out.push({\n        probe: PROBE, locus: { at: [at], dirs: [] }, source: source.id, order: order++, tier: source.tier ?? 'target', reachPx,\n        ...(a.required ? { required: true } : {}),\n        ...(a.mark ? { mark: a.mark } : {}),\n      });\n    }\n  });\n  return out;\n}\n\n/** The screen distance from the pivot to the press: what turns reach in px\n *  into radians. */\nfunction pressRadiusPx(inputs: Session2dInputs): number {\n  const { req } = inputs;\n  const pivot = req.pivot ?? req.press;\n  const toScreen = screenOf(inputs.view(), req.plane?.() ?? null);\n  const [ax, ay] = toScreen([pivot.x, pivot.y]);\n  const [bx, by] = toScreen([req.press.x, req.press.y]);\n  return Math.hypot(bx - ax, by - ay);\n}\n\n/** A ray from the pivot out to the press radius, along where the pointer\n *  lands at `theta`, labeled with `theta` in degrees. */\nfunction rayMarks(inputs: Session2dInputs, theta: number): SnapMark[] {\n  const { req } = inputs;\n  const pivot = req.pivot ?? req.press;\n  const r = Math.hypot(req.press.x - pivot.x, req.press.y - pivot.y);\n  const dir = Math.atan2(req.press.y - pivot.y, req.press.x - pivot.x) + theta - (req.theta0 ?? 0);\n  const end = { x: pivot.x + r * Math.cos(dir), y: pivot.y + r * Math.sin(dir) };\n  const deg = ((Math.round(theta * 180 / Math.PI) % 360) + 360) % 360;\n  return [\n    { kind: 'line', from: pivot, to: end },\n    { kind: 'point', at: end, glyph: 'quadrant', label: `${deg}°` },\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"angle2d.js","names":[],"sources":["../../../src/domains/snap/angle2d.ts"],"sourcesContent":["/** A snap session's one-dimensional path: an angle about a pivot, snapped by\n *  the same resolver as a point, with reach carried through the radius. */\nimport { wrapPositive } from '@weasel-js/geom';\nimport { resolveSnap, type SnapCandidate } from '@weasel-js/geom/nd';\nimport type { SnapMods } from 'interactions/actions/snapDep';\nimport { distinct, markFromPlane } from './marks';\nimport { screenOf } from './screen';\nimport { stepAngles } from './stepAngles';\nimport type { Session2dInputs } from './session2d';\nimport type { AngleCollect, SnapMark, SnapMarks, SnapSource } from './types';\n\nconst TURN = Math.PI * 2;\nconst PROBE = 'angle';\n/** A press near the pivot turns px reach into a wide angle; it reaches no\n *  further than this. */\nconst MAX_REACH_RAD = Math.PI / 6;\n\n/** Where `theta` lands, and what it met. Writes the marks to the store. */\nexport function angleAt(\n  inputs: Session2dInputs, sources: readonly SnapSource[], theta: number, mods: SnapMods,\n): { theta: number; marks: readonly SnapMark[] } {\n  const { req, store } = inputs;\n  // Screen px per radian, or 1 when the gesture gives its reach in radians.\n  const scale = req.reachRad !== undefined ? 1 : pressRadiusPx(inputs);\n  const reachOf = (s: SnapSource) => req.reachRad\n    ?? Math.min(s.reachPx ?? inputs.reachPx, MAX_REACH_RAD * scale);\n  const candidates = collectAngles(inputs, sources, theta, mods, reachOf);\n  if (candidates.length === 0) {\n    store.set([]);\n    return { theta, marks: [] };\n  }\n  const res = resolveSnap({\n    probes: [{ id: PROBE, at: [0], role: 'pointer' }],\n    input: { at: [0], dirs: [[1]] },\n    delta0: [theta],\n    candidates,\n    // No radius, no reach: only a required angle can win.\n    toScreen: ([t]) => [scale > 0 ? t * scale : NaN],\n  });\n  const out = res.delta[0];\n  const marks = distinct(res.satisfied.flatMap((c) => {\n    const m = c.mark ?? rayMarks(inputs, out);\n    return 'kind' in m ? [m] : m;\n  }));\n  const plane = req.plane?.() ?? null;\n  store.set(plane ? marks.map((m) => markFromPlane(m, plane)) : marks);\n  return { theta: out, marks };\n}\n\nfunction collectAngles(\n  inputs: Session2dInputs, sources: readonly SnapSource[], theta: number, mods: SnapMods,\n  reachOf: (s: SnapSource) => number,\n): SnapCandidate<SnapMarks>[] {\n  const { req } = inputs;\n  const out: SnapCandidate<SnapMarks>[] = [];\n  const c = req.constrain;\n  if (mods.constrain && typeof c === 'object' && c.step > 0) {\n    for (const at of stepAngles(theta, c.step)) {\n      out.push({ probe: PROBE, locus: { at: [at], dirs: [] }, source: 'constrain', order: -1, tier: 'target', reachPx: 0, required: true });\n    }\n  }\n  const theta0 = req.theta0 ?? 0;\n  if (mods.hold) {\n    const at = theta0 + TURN * Math.round((theta - theta0) / TURN);\n    out.push({ probe: PROBE, locus: { at: [at], dirs: [] }, source: 'hold', order: -1, tier: 'target', reachPx: 0, required: true, mark: [] });\n  }\n  if (mods.suspend) return out;\n  const q: AngleCollect = {\n    pivot: req.pivot ?? req.press,\n    press: req.press,\n    theta0,\n    theta,\n    ids: req.ids ?? [],\n    exclude: inputs.exclude ?? req.ids ?? [],\n    mods,\n    ...(req.also ? { also: req.also } : {}),\n    ...(inputs.scene ? { scene: inputs.scene } : {}),\n    ...(inputs.rotationOf ? { rotationOf: inputs.rotationOf } : {}),\n  };\n  // Runs across sources and their yields: an earlier source, then an earlier\n  // yield, wins a tie.\n  let order = 0;\n  sources.forEach((source) => {\n    if (!source.angles) return;\n    const reachPx = reachOf(source);\n    for (const a of source.angles(q)) {\n      // The whole turn of the angle nearest `theta`: 0 catches 359°.\n      const at = a.angle + TURN * Math.round((theta - a.angle) / TURN);\n      out.push({\n        probe: PROBE, locus: { at: [at], dirs: [] }, source: source.id, order: order++, tier: source.tier ?? 'target', reachPx,\n        ...(a.required ? { required: true } : {}),\n        ...(a.mark ? { mark: a.mark } : {}),\n      });\n    }\n  });\n  return out;\n}\n\n/** The screen distance from the pivot to the press: what turns reach in px\n *  into radians. */\nfunction pressRadiusPx(inputs: Session2dInputs): number {\n  const { req } = inputs;\n  const pivot = req.pivot ?? req.press;\n  const toScreen = screenOf(inputs.view(), req.plane?.() ?? null);\n  const [ax, ay] = toScreen([pivot.x, pivot.y]);\n  const [bx, by] = toScreen([req.press.x, req.press.y]);\n  return Math.hypot(bx - ax, by - ay);\n}\n\n/** A ray from the pivot out to the press radius, along where the pointer\n *  lands at `theta`, labeled with `theta` in degrees. */\nfunction rayMarks(inputs: Session2dInputs, theta: number): SnapMark[] {\n  const { req } = inputs;\n  const pivot = req.pivot ?? req.press;\n  const r = Math.hypot(req.press.x - pivot.x, req.press.y - pivot.y);\n  const dir = Math.atan2(req.press.y - pivot.y, req.press.x - pivot.x) + theta - (req.theta0 ?? 0);\n  const end = { x: pivot.x + r * Math.cos(dir), y: pivot.y + r * Math.sin(dir) };\n  const deg = wrapPositive(Math.round(theta * 180 / Math.PI), 360);\n  return [\n    { kind: 'line', from: pivot, to: end },\n    { kind: 'point', at: end, glyph: 'quadrant', label: `${deg}°` },\n  ];\n}\n"],"mappings":"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"}

package/dist/domains/snap/debugCandidates.js

@@ -1,7 +1,7 @@
 import { fromPlane } from "../../core/viewport/parallax.js";
 import { closestOnFlat } from "@weasel-js/geom/nd";
 
-//#region src/domains/snap/debugCandidates.ts
+// src/domains/snap/debugCandidates.ts
 /** Replaces the sink's snap records with one frame's candidates: where each
 *  would put its probe, accepted when the result meets it. Camera world. */
 function recordSnapCandidates(debug, candidates, satisfied, probes, delta0, plane) {
@@ -22,6 +22,5 @@ function recordSnapCandidates(debug, candidates, satisfied, probes, delta0, plan
 	}
 }
 
-//#endregion
 export { recordSnapCandidates };
 //# sourceMappingURL=debugCandidates.js.map

package/dist/domains/snap/gather.js

@@ -1,6 +1,6 @@
 import { distinct } from "./marks.js";
 
-//#region src/domains/snap/gather.ts
+// src/domains/snap/gather.ts
 var DEFAULT_GESTURES = [
 	"point",
 	"move",
@@ -74,6 +74,5 @@ function marksOf(mark, delta) {
 	return "kind" in m ? [m] : m;
 }
 
-//#endregion
 export { assertSnapSourceIds, gatherSnapCandidates, resolvedSnapMarks, snapSourcesFor };
 //# sourceMappingURL=gather.js.map

package/dist/domains/snap/inputSubspace.js

@@ -1,8 +1,8 @@
-import { SNAP_AXIS_STEP } from "./roles.js";
 import { diagonal, edgeAxis } from "./resizeBox.js";
+import { SNAP_AXIS_STEP } from "./roles.js";
 import { stepLine } from "@weasel-js/geom/nd";
 
-//#region src/domains/snap/inputSubspace.ts
+// src/domains/snap/inputSubspace.ts
 var PLANE = {
 	at: [0, 0],
 	dirs: [[1, 0], [0, 1]]
@@ -41,6 +41,5 @@ function inputFlat(req, mods, delta0, resize) {
 	return stepLine([origin.x - req.press.x, origin.y - req.press.y], [delta0.x, delta0.y], AXES, c.step);
 }
 
-//#endregion
 export { inputFlat };
 //# sourceMappingURL=inputSubspace.js.map

package/dist/domains/snap/lazySession.js

@@ -1,4 +1,4 @@
-//#region src/domains/snap/lazySession.ts
+// src/domains/snap/lazySession.ts
 /** A session of `dep` that begins on its first `at` or `angle`, so a press
 *  that never moves reads nothing of the scene. Null without a dep. */
 function lazySnapSession(dep, req) {
@@ -12,6 +12,5 @@ function lazySnapSession(dep, req) {
 	};
 }
 
-//#endregion
 export { lazySnapSession };
 //# sourceMappingURL=lazySession.js.map

package/dist/domains/snap/marks.js

@@ -1,6 +1,6 @@
 import { fromPlane } from "../../core/viewport/parallax.js";
 
-//#region src/domains/snap/marks.ts
+// src/domains/snap/marks.ts
 /** `marks` with repeats dropped, so a target several probes meet is drawn once. */
 function distinct(marks) {
 	const seen = /* @__PURE__ */ new Set();
@@ -24,6 +24,5 @@ function markFromPlane(m, plane) {
 	};
 }
 
-//#endregion
 export { distinct, markFromPlane };
 //# sourceMappingURL=marks.js.map

package/dist/domains/snap/outcomeStore.js

@@ -1,25 +1,21 @@
-//#region src/domains/snap/outcomeStore.ts
+import { createEmitter } from "@weasel-js/registry";
+
+// src/domains/snap/outcomeStore.ts
 var NONE = [];
 /** An empty outcome store, which notifies only when the marks change. */
 function createSnapOutcomeStore() {
 	let marks = NONE;
-	const listeners = /* @__PURE__ */ new Set();
+	const changed = createEmitter();
 	return {
 		get: () => marks,
 		set(next) {
 			if (next.length === 0 && marks.length === 0) return;
 			marks = next.length === 0 ? NONE : next;
-			for (const l of [...listeners]) l();
+			changed.emit();
 		},
-		subscribe(listener) {
-			listeners.add(listener);
-			return () => {
-				listeners.delete(listener);
-			};
-		}
+		subscribe: changed.subscribe
 	};
 }
 
-//#endregion
 export { createSnapOutcomeStore };
 //# sourceMappingURL=outcomeStore.js.map