@weasel-js/core 1.6.1 → 1.7.1

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

@@ -0,0 +1,263 @@
+import { viewToTransform as e } from "../../../core/viewport/view.js";
+import { worldToScreen as t } from "../../../core/viewport/viewTransform.js";
+import { withinPxRadius as n } from "../../../core/viewport/pxExtent.js";
+import { sliceAction as r } from "../../../interactions/actions/defaults/slice.js";
+import { defineTool as i } from "../../overlayBinding.js";
+import { OVERLAY_ROLE_STROKES as a } from "../../../canvas/overlayRoleStrokes.js";
+import { ellipsePath as o, polylineFromPoints as s } from "@weasel-js/geom";
+import { useMemo as c, useRef as l } from "react";
+import { useLatest as u } from "@weasel-js/react";
+import { ActionDisabledReason as d } from "@weasel-js/routing";
+//#region src/tools/builtin/slice/useSliceTool.ts
+var f = 3;
+function p(p = {}) {
+	let m = l({ points: [] }), h = u({ closeHitRadius: p.closeHitRadius ?? 8 }), g = c(() => {
+		let e = /* @__PURE__ */ new Set(), t = null, n = null, r = () => {
+			for (let t of [...e]) t();
+		};
+		return {
+			notify: r,
+			listen(t) {
+				return e.add(t), () => {
+					e.delete(t);
+				};
+			},
+			pointer: () => t,
+			follow(e) {
+				e && e !== t && (n?.(), t = e, n = e.subscribe(r));
+			},
+			unfollow() {
+				n?.(), n = null, t = null;
+			}
+		};
+	}, []), _ = c(() => {
+		let e = () => m.current.points, t = () => e().length > 0 || d.NotApplicable, i = () => {
+			m.current.points = [], g.unfollow(), g.notify();
+		}, a = (t) => {
+			let n = e().slice();
+			i(), n.length >= 2 && t.slice?.commit(n);
+		}, o = (t, r, i) => {
+			let o = e(), s = o[0], c = t.view?.get().scale ?? {
+				x: 1,
+				y: 1
+			};
+			if (o.length >= 3 && n(r - s.x, i - s.y, h.current.closeHitRadius, c)) {
+				o.push({
+					x: s.x,
+					y: s.y
+				}), a(t);
+				return;
+			}
+			o.push({
+				x: r,
+				y: i
+			}), g.follow(t.pointer), g.notify();
+		}, s = { capability: "edits-page" };
+		return [
+			r,
+			{
+				id: "slice.addPoint",
+				label: "Slice — place point",
+				eligible: s,
+				requires: [
+					"slice",
+					"view",
+					"pointer"
+				],
+				enabled: (e) => e?.slice ? !0 : d.NotApplicable,
+				invoker: {
+					timing: "immediate",
+					run: (e, t) => {
+						let n = t;
+						n?.pressX !== void 0 && n.pressY !== void 0 && o(e, n.pressX, n.pressY);
+					}
+				}
+			},
+			{
+				id: "slice.dragPoint",
+				label: "Slice — drag out a point",
+				eligible: s,
+				requires: [
+					"slice",
+					"view",
+					"pointer"
+				],
+				enabled: t,
+				invoker: {
+					timing: "ongoing",
+					start: () => ({
+						onMove: () => {},
+						onEnd: (t, n) => {
+							if (n === "cancel" || e().length === 0) return;
+							let r = t.drag?.current ?? t.world;
+							o(t.deps, r.x, r.y);
+						}
+					})
+				}
+			},
+			{
+				id: "slice.finish",
+				label: "Slice — cut along the points",
+				eligible: s,
+				requires: ["slice"],
+				enabled: t,
+				invoker: {
+					timing: "immediate",
+					run: (t, n) => {
+						n?.viaDoubleClick && e().pop(), a(t);
+					}
+				}
+			},
+			{
+				id: "slice.dropPoint",
+				label: "Slice — take back the last point",
+				eligible: s,
+				enabled: t,
+				invoker: {
+					timing: "immediate",
+					run: () => {
+						e().pop(), e().length === 0 ? i() : g.notify();
+					}
+				}
+			},
+			{
+				id: "slice.cancel",
+				label: "Slice — discard the points",
+				eligible: s,
+				enabled: t,
+				invoker: {
+					timing: "immediate",
+					run: () => i()
+				}
+			}
+		];
+	}, [g, h]), v = c(() => ({
+		id: "slice-pending-cut",
+		label: "Slice — pending cut",
+		space: "screen",
+		subscribe: g.listen,
+		draw: (n, r) => {
+			let i = m.current.points;
+			if (i.length === 0) return [];
+			let c = e(r), l = (e) => {
+				let [n, r] = t(e.x, e.y, c);
+				return {
+					x: n,
+					y: r
+				};
+			}, u = i.map(l), d = g.pointer()?.get();
+			d && u.push(l({
+				x: d.worldX,
+				y: d.worldY
+			}));
+			let p = a.cut, h = [];
+			u.length >= 2 && h.push({
+				kind: "path",
+				path: s(u),
+				stroke: p
+			});
+			for (let e of i.map(l)) h.push({
+				kind: "path",
+				path: o({
+					x: e.x - f,
+					y: e.y - f,
+					width: 6,
+					height: 6
+				}),
+				fill: p.paint
+			});
+			return h;
+		}
+	}), [g]), { keybinding: y } = p;
+	return c(() => i({
+		id: "slice",
+		capabilities: ["edits-page"],
+		hookName: "useSliceTool",
+		cursor: "crosshair",
+		presentation: {
+			label: "Slice",
+			group: "shape"
+		},
+		...y === null ? {} : { keybinding: y ?? { key: "K" } },
+		actions: _,
+		overlay: v,
+		onDeactivate: () => {
+			m.current.points = [], g.unfollow(), g.notify();
+		},
+		bindings: [
+			{
+				spec: {
+					kind: "click",
+					mods: {
+						shift: "optional",
+						alt: "optional"
+					}
+				},
+				actionId: "slice.addPoint"
+			},
+			{
+				spec: {
+					kind: "doubleClick",
+					mods: {
+						shift: "optional",
+						alt: "optional"
+					}
+				},
+				actionId: "slice.finish",
+				opts: { params: { viaDoubleClick: !0 } }
+			},
+			{
+				spec: {
+					kind: "drag",
+					mods: {
+						shift: "optional",
+						alt: "optional"
+					}
+				},
+				actionId: "slice.dragPoint"
+			},
+			{
+				spec: { kind: "drag" },
+				actionId: "slice"
+			},
+			{
+				spec: {
+					kind: "drag",
+					mods: { alt: !0 }
+				},
+				actionId: "slice",
+				opts: { params: { cut: "freehand" } }
+			},
+			{
+				spec: {
+					kind: "key",
+					key: "Enter"
+				},
+				actionId: "slice.finish"
+			},
+			{
+				spec: {
+					kind: "key",
+					key: "Escape"
+				},
+				actionId: "slice.cancel"
+			},
+			{
+				spec: {
+					kind: "key",
+					key: "Backspace"
+				},
+				actionId: "slice.dropPoint"
+			}
+		]
+	}), [
+		_,
+		v,
+		y,
+		g
+	]);
+}
+//#endregion
+export { p as useSliceTool };
+
+//# sourceMappingURL=useSliceTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSliceTool.js","names":["VERTEX_RADIUS_PX","useSliceTool","scratchRef","useRef","optsRef","useLatest","options","live","useMemo","listeners","pointer","offPointer","notify","fn","next","actions","points","pending","ActionDisabledReason","reset","commit","cut","deps","place","pts","first","scale","withinPxRadius","x","y","eligible","sliceAction","\"slice\"","p","params","reason","at","endCtx","overlay","t","viewToTransform","view","toScreen","worldToScreen","run","stroke","OVERLAY_ROLE_STROKES","\"cut\"","out","polylineFromPoints","ellipsePath","defineTool","keybinding"],"sources":["../../../../src/tools/builtin/slice/useSliceTool.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport type { RenderLayer } from 'core/layers/render';\nimport type { DrawCommand } from '../../../renderer';\nimport type { Action, ActionDeps, InvocationCtx, ToolKeybinding } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport type { SliceDep, ViewApi } from 'interactions/actions/depSchema';\nimport type { PointerContextValue } from 'features/pointer/PointerContext';\nimport { sliceAction } from 'interactions/actions/defaults/slice';\nimport { withinPxRadius } from 'core/viewport/pxExtent';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport { viewToTransform } from 'core/viewport/view';\nimport { ellipsePath, polylineFromPoints } from '@weasel-js/geom';\nimport { OVERLAY_ROLE_STROKES } from 'canvas/overlayRoleStrokes';\n\n/** Options for `useSliceTool`. */\nexport interface UseSliceToolOptions {\n  /** Override the default keybinding (`{ key: 'K' }`). Pass `null` to omit. */\n  keybinding?: ToolKeybinding | null;\n  /** Screen-px radius around the first point within which a click closes the\n   *  cut into a loop and commits it. Default `8`. */\n  closeHitRadius?: number;\n}\n\n/** The click-by-click cut in progress, in world coords. */\nexport interface SliceScratch {\n  points: { x: number; y: number }[];\n}\n\nconst VERTEX_RADIUS_PX = 3;\n\n/**\n * Knife tool. A drag cuts along a straight line, and an Alt-drag along its\n * freehand trail, through `sliceAction`. Clicks place a cut one point at a\n * time: Enter or a double-click commits it, Escape discards it, Backspace\n * takes back the last point, and a click on the first point closes it into a\n * loop and commits. While points are placed, a drag places one more where it\n * is released instead of cutting on its own.\n *\n * Every cut goes to the `slice` dep, which decides what it does to the scene.\n * `<SceneCanvas>` publishes one that cuts every path the cut crosses. The pending cut paints through\n * `Tool.overlay`, trailing to the pointer when the host publishes one.\n */\nexport function useSliceTool(options: UseSliceToolOptions = {}): Tool<null> {\n  const scratchRef = useRef<SliceScratch>({ points: [] });\n  const optsRef = useLatest({ closeHitRadius: options.closeHitRadius ?? 8 });\n\n  // What the overlay layer's `subscribe` hears: a change to the points, and,\n  // while any are placed, every move of the pointer the rubber band follows.\n  const live = useMemo(() => {\n    const listeners = new Set<() => void>();\n    let pointer: PointerContextValue | null = null;\n    let offPointer: (() => void) | null = null;\n    const notify = (): void => { for (const fn of [...listeners]) fn(); };\n    return {\n      notify,\n      listen(fn: () => void): () => void {\n        listeners.add(fn);\n        return () => { listeners.delete(fn); };\n      },\n      pointer: () => pointer,\n      follow(next: PointerContextValue | undefined): void {\n        if (!next || next === pointer) return;\n        offPointer?.();\n        pointer = next;\n        offPointer = next.subscribe(notify);\n      },\n      unfollow(): void {\n        offPointer?.();\n        offPointer = null;\n        pointer = null;\n      },\n    };\n  }, []);\n\n  const actions = useMemo<Action[]>(() => {\n    const points = () => scratchRef.current.points;\n    const pending = () => (points().length > 0 ? true : ActionDisabledReason.NotApplicable);\n\n    const reset = (): void => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    };\n    const commit = (deps: ActionDeps): void => {\n      const cut = points().slice();\n      reset();\n      if (cut.length >= 2) (deps.slice as SliceDep | undefined)?.commit(cut);\n    };\n    const place = (deps: ActionDeps, x: number, y: number): void => {\n      const pts = points();\n      const first = pts[0];\n      const scale = (deps.view as ViewApi | undefined)?.get().scale ?? { x: 1, y: 1 };\n      if (pts.length >= 3 && withinPxRadius(x - first.x, y - first.y, optsRef.current.closeHitRadius, scale)) {\n        pts.push({ x: first.x, y: first.y });\n        commit(deps);\n        return;\n      }\n      pts.push({ x, y });\n      live.follow(deps.pointer as PointerContextValue | undefined);\n      live.notify();\n    };\n\n    const eligible = { capability: 'edits-page' } as const;\n    return [\n      sliceAction,\n      {\n        id: 'slice.addPoint',\n        label: 'Slice — place point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: (deps) => (deps?.['slice'] ? true : ActionDisabledReason.NotApplicable),\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            const p = params as { pressX?: number; pressY?: number } | undefined;\n            if (p?.pressX === undefined || p.pressY === undefined) return;\n            place(deps, p.pressX, p.pressY);\n          },\n        },\n      },\n      {\n        id: 'slice.dragPoint',\n        label: 'Slice — drag out a point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: pending,\n        invoker: {\n          timing: 'ongoing',\n          start: () => ({\n            onMove: () => {},\n            onEnd: (endCtx: InvocationCtx, reason: 'commit' | 'cancel') => {\n              if (reason === 'cancel' || points().length === 0) return;\n              const at = endCtx.drag?.current ?? endCtx.world;\n              place(endCtx.deps, at.x, at.y);\n            },\n          }),\n        },\n      },\n      {\n        id: 'slice.finish',\n        label: 'Slice — cut along the points',\n        eligible,\n        requires: ['slice'],\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            // A double click arrives after both of its clicks, so the second\n            // has already placed a point on top of the first.\n            if ((params as { viaDoubleClick?: boolean } | undefined)?.viaDoubleClick) points().pop();\n            commit(deps);\n          },\n        },\n      },\n      {\n        id: 'slice.dropPoint',\n        label: 'Slice — take back the last point',\n        eligible,\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: () => {\n            points().pop();\n            if (points().length === 0) reset();\n            else live.notify();\n          },\n        },\n      },\n      {\n        id: 'slice.cancel',\n        label: 'Slice — discard the points',\n        eligible,\n        // Declining with nothing placed leaves Escape to the ambient `escape`.\n        enabled: pending,\n        invoker: { timing: 'immediate', run: () => reset() },\n      },\n    ];\n  }, [live, optsRef]);\n\n  const overlay = useMemo<RenderLayer<unknown>>(() => ({\n    id: 'slice-pending-cut',\n    label: 'Slice — pending cut',\n    space: 'screen',\n    subscribe: live.listen,\n    draw: (_data, view) => {\n      const pts = scratchRef.current.points;\n      if (pts.length === 0) return [];\n      const t = viewToTransform(view);\n      const toScreen = (p: { x: number; y: number }) => {\n        const [x, y] = worldToScreen(p.x, p.y, t);\n        return { x, y };\n      };\n      const run = pts.map(toScreen);\n      const at = live.pointer()?.get();\n      if (at) run.push(toScreen({ x: at.worldX, y: at.worldY }));\n      const stroke = OVERLAY_ROLE_STROKES['cut'];\n      const out: DrawCommand[] = [];\n      if (run.length >= 2) out.push({ kind: 'path', path: polylineFromPoints(run), stroke });\n      for (const p of pts.map(toScreen)) {\n        out.push({\n          kind: 'path',\n          path: ellipsePath({\n            x: p.x - VERTEX_RADIUS_PX,\n            y: p.y - VERTEX_RADIUS_PX,\n            width: VERTEX_RADIUS_PX * 2,\n            height: VERTEX_RADIUS_PX * 2,\n          }),\n          fill: stroke.paint,\n        });\n      }\n      return out;\n    },\n  }), [live]);\n\n  const { keybinding } = options;\n  return useMemo(() => defineTool<null>({\n    id: 'slice',\n    capabilities: ['edits-page'],\n    hookName: 'useSliceTool',\n    cursor: 'crosshair',\n    presentation: { label: 'Slice', group: 'shape' },\n    ...(keybinding === null ? {} : { keybinding: keybinding ?? { key: 'K' } }),\n    actions,\n    overlay,\n    onDeactivate: () => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    },\n    bindings: [\n      { spec: { kind: 'click', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.addPoint' },\n      {\n        spec: { kind: 'doubleClick', mods: { shift: 'optional', alt: 'optional' } },\n        actionId: 'slice.finish',\n        opts: { params: { viaDoubleClick: true } },\n      },\n      // Ahead of the cutting drags: it declines unless points are placed.\n      { spec: { kind: 'drag', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.dragPoint' },\n      { spec: { kind: 'drag' }, actionId: 'slice' },\n      { spec: { kind: 'drag', mods: { alt: true } }, actionId: 'slice', opts: { params: { cut: 'freehand' } } },\n      { spec: { kind: 'key', key: 'Enter' }, actionId: 'slice.finish' },\n      { spec: { kind: 'key', key: 'Escape' }, actionId: 'slice.cancel' },\n      { spec: { kind: 'key', key: 'Backspace' }, actionId: 'slice.dropPoint' },\n    ],\n  }), [actions, overlay, keybinding, live]);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,82 @@
+import { defineTool as e } from "../../overlayBinding.js";
+import t from "../../../icons/StarIcon.js";
+import { insertBindingBehaviors as n } from "../shared/insertToolOptions.js";
+import { useCallback as r, useMemo as i, useRef as a, useState as o } from "react";
+import { jsx as s } from "react/jsx-runtime";
+import { cursorFor as c } from "@weasel-js/cursor";
+//#region src/tools/builtin/star/useStarTool.tsx
+var l = 3, u = 32;
+function d(d = {}) {
+	let { points: f = 5, innerRatio: p = .5, behaviors: m } = d, h = a(f), g = a(p), [, _] = o(0), v = r(() => _((e) => e + 1), []), y = i(() => ({
+		id: "star.adjustPoints",
+		label: "Star — adjust points",
+		invoker: {
+			timing: "immediate",
+			run: (e, t) => {
+				let n = t, r = n?.delta ?? (n?.deltaY !== void 0 && n.deltaY !== 0 ? n.deltaY > 0 ? 1 : -1 : 0);
+				r !== 0 && (h.current = r > 0 ? Math.min(u, h.current + 1) : Math.max(l, h.current - 1), v());
+			}
+		}
+	}), [v]);
+	return i(() => e({
+		id: "star",
+		capabilities: ["creates-shapes"],
+		hookName: "useStarTool",
+		cursor: c("crosshairStar", { fallback: "crosshair" }),
+		actions: [y],
+		presentation: {
+			label: "Star",
+			group: "shape",
+			icon: /* @__PURE__ */ s(t, {})
+		},
+		bindings: [
+			{
+				spec: { kind: "drag" },
+				actionId: "insert",
+				opts: {
+					params: () => ({
+						kind: "star",
+						points: h.current,
+						innerRadiusRatio: g.current
+					}),
+					...n(m)
+				}
+			},
+			{
+				spec: {
+					kind: "wheel",
+					phase: "engaged"
+				},
+				actionId: "star.adjustPoints"
+			},
+			{
+				spec: {
+					kind: "wheel",
+					phase: "engaged",
+					mods: { shift: !0 }
+				},
+				actionId: "insert.adjustRotation"
+			},
+			{
+				spec: {
+					kind: "key",
+					key: "ArrowUp"
+				},
+				actionId: "star.adjustPoints",
+				opts: { params: { delta: 1 } }
+			},
+			{
+				spec: {
+					kind: "key",
+					key: "ArrowDown"
+				},
+				actionId: "star.adjustPoints",
+				opts: { params: { delta: -1 } }
+			}
+		]
+	}), [y, m]);
+}
+//#endregion
+export { d as useStarTool };
+
+//# sourceMappingURL=useStarTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStarTool.js","names":["StarIcon","MIN_POINTS","MAX_POINTS","useStarTool","initialPoints","initialInnerRatio","options","pointsRef","useRef","innerRatioRef","setPointsTick","useState","bumpPoints","useCallback","n","adjustPointsAction","useMemo","p","params","step","defineTool","cursorFor","insertBindingBehaviors","behaviors"],"sources":["../../../../src/tools/builtin/star/useStarTool.tsx"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { defineTool } from '../../overlayBinding';\nimport { StarIcon } from '../../../icons';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport type { Action } from '@weasel-js/routing';\nimport { cursorFor } from '@weasel-js/cursor';\n\n/** A point in world coordinates. */\nexport interface StarPoint { x: number; y: number }\n\n/** Options for `useStarTool`. */\nexport interface UseStarToolOptions extends InsertToolOptions {\n  label?: string;\n  /** Initial point count. Persists across gestures (Illustrator\n   *  convention), adjustable mid-drag via ArrowUp/Down or wheel\n   *  (range 3–32). */\n  points?: number;\n  /** Inner-radius / outer-radius ratio. Default 0.5. Fixed for now;\n   *  consumers wanting per-instance ratios should override the `insert`\n   *  dep. */\n  innerRatio?: number;\n}\n\nconst MIN_POINTS = 3;\nconst MAX_POINTS = 32;\n\n/**\n * Drag-from-center star tool. Pointerdown sets center; drag determines\n * outer radius + rotation; release commits via `insertAction`. Inner\n * radius = outer × `innerRatio` (default 0.5). Point count defaults to\n * 5, adjustable mid-gesture via ArrowUp/Down or wheel.\n *\n * Live preview painted by the dispatcher overlay layer reading\n * `insertAction.overlay()`. Consumers wanting custom star geometry\n * override the `insert` dep.\n */\nexport function useStarTool<TNode extends { id: string } = { id: string }>(\n  options: UseStarToolOptions = {},\n): Tool<null> {\n  const {\n    points: initialPoints = 5,\n    innerRatio: initialInnerRatio = 0.5,\n    behaviors,\n  } = options;\n  const pointsRef = useRef(initialPoints);\n  const innerRatioRef = useRef(initialInnerRatio);\n  const [, setPointsTick] = useState(0);\n  const bumpPoints = useCallback(() => setPointsTick((n) => n + 1), []);\n\n  // Wheel-to-adjust-points action. Phase-gated to `[engaged]` so it\n  // fires only mid-drag.\n  const adjustPointsAction = useMemo<Action>(\n    () => ({\n      id: 'star.adjustPoints',\n      label: 'Star — adjust points',\n      invoker: {\n        timing: 'immediate' as const,\n        run: (_deps, params) => {\n          const p = params as { deltaY?: number; delta?: number } | undefined;\n          // `delta` comes from the ArrowUp/ArrowDown key bindings; `deltaY`\n          // from the wheel. Wheel up (deltaY > 0 under natural scrolling)\n          // adds a point.\n          const step = p?.delta ?? (p?.deltaY !== undefined && p.deltaY !== 0\n            ? (p.deltaY > 0 ? 1 : -1)\n            : 0);\n          if (step === 0) return;\n          pointsRef.current = step > 0\n            ? Math.min(MAX_POINTS, pointsRef.current + 1)\n            : Math.max(MIN_POINTS, pointsRef.current - 1);\n          bumpPoints();\n        },\n      },\n    }),\n    [bumpPoints],\n  );\n\n  void ({} as TNode);\n\n  return useMemo(\n    () =>\n      defineTool<null>({\n        id: 'star',\n        capabilities: ['creates-shapes'],\n        hookName: 'useStarTool',\n        cursor: cursorFor('crosshairStar', { fallback: 'crosshair' }),\n        // Registered by <ToolActionsMounter>, inside the ActionsProvider —\n        // see `ToolDef.actions` for why the hook can't register it itself.\n        actions: [adjustPointsAction],\n        presentation: {\n          label: 'Star',\n          group: 'shape',\n          icon: <StarIcon />,\n        },\n        bindings: [\n          // Default = drag from corner; anchor dot in the overlay sells\n          // the click point. Alt flips to center mode (live toggle).\n          {\n            spec: { kind: 'drag' },\n            actionId: 'insert',\n            opts: {\n              params: () => ({\n                kind: 'star',\n                points: pointsRef.current,\n                innerRadiusRatio: innerRatioRef.current,\n              }),\n              ...insertBindingBehaviors(behaviors),\n            },\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged' },\n            actionId: 'star.adjustPoints',\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged', mods: { shift: true } },\n            actionId: 'insert.adjustRotation',\n          },\n          // ArrowUp/Down → adjust point count. Ported off the phase table for\n          // the same reason as polygon's: as an `initial.keyDown` route the\n          // key was claimed on the tool pipeline while `nudge.*` matched the\n          // same press on the interactions dispatcher, so both fired.\n          {\n            spec: { kind: 'key', key: 'ArrowUp' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: 1 } },\n          },\n          {\n            spec: { kind: 'key', key: 'ArrowDown' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: -1 } },\n          },\n        ],\n      }),\n    [adjustPointsAction, behaviors],\n  );\n}\n"],"mappings":";;;;;;;AAwBA,IAAMC,IAAa,GACbC,IAAa;AAYnB,SAAgBC,EACd,IAA8B,CAAC,GACnB;CACZ,IAAM,EACJ,QAAQC,IAAgB,GACxB,YAAYC,IAAoB,IAChC,iBACEC,GACEC,IAAYC,EAAOJ,CAAa,GAChCK,IAAgBD,EAAOH,CAAiB,GACxC,GAAGK,KAAiBC,EAAS,CAAC,GAC9BC,IAAaC,QAAkBH,GAAe,MAAMI,IAAI,CAAC,GAAG,CAAC,CAAC,GAI9DC,IAAqBC,SAClB;EACL,IAAI;EACJ,OAAO;EACP,SAAS;GACP,QAAQ;GACR,MAAM,GAAO,MAAW;IACtB,IAAMC,IAAIC,GAIJC,IAAOF,GAAG,UAAUA,GAAG,WAAW,KAAA,KAAaA,EAAE,WAAW,IAC7DA,EAAE,SAAS,IAAI,IAAI,KACpB;IACJ,AAAIE,MAAS,MACb,EAAU,UAAUA,IAAO,IACvB,KAAK,IAAIjB,GAAYK,EAAU,UAAU,CAAC,IAC1C,KAAK,IAAIN,GAAYM,EAAU,UAAU,CAAC,GAC9CK,EAAW;GACb;EACF;CACF,IACA,CAACA,CAAU,CACb;CAIA,OAAOI,QAEHI,EAAiB;EACf,IAAI;EACJ,cAAc,CAAC,gBAAgB;EAC/B,UAAU;EACV,QAAQC,EAAU,iBAAiB,EAAE,UAAU,YAAY,CAAC;EAG5D,SAAS,CAACN,CAAkB;EAC5B,cAAc;GACZ,OAAO;GACP,OAAO;GACP,MAAM,kBAACf,GAAD,CAAW,CAAA;EACnB;EACA,UAAU;GAGR;IACE,MAAM,EAAE,MAAM,OAAO;IACrB,UAAU;IACV,MAAM;KACJ,eAAe;MACb,MAAM;MACN,QAAQO,EAAU;MAClB,kBAAkBE,EAAc;KAClC;KACA,GAAGa,EAAuBC,CAAS;IACrC;GACF;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;IAAU;IACxC,UAAU;GACZ;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;KAAW,MAAM,EAAE,OAAO,GAAK;IAAE;IAC/D,UAAU;GACZ;GAKA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAU;IACpC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;GAC/B;GACA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAY;IACtC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE;GAChC;EACF;CACF,CAAC,GACH,CAACR,GAAoBQ,CAAS,CAChC;AACF"}

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

@@ -0,0 +1,177 @@
+import { defineTool as e } from "../../overlayBinding.js";
+import t from "../../../icons/TextIcon.js";
+import { insertBindingBehaviors as n } from "../shared/insertToolOptions.js";
+import { createElement as r, useMemo as i } from "react";
+//#region src/tools/builtin/text/useTextTool.ts
+var a = {
+	label: "Text",
+	icon: r(t),
+	group: "type"
+};
+function o(t = {}) {
+	let { behaviors: r } = t;
+	return i(() => e({
+		id: "text",
+		capabilities: ["creates-text"],
+		hookName: "useTextTool",
+		cursor: "text",
+		presentation: a,
+		bindings: [{
+			spec: { kind: "drag" },
+			actionId: "insert",
+			opts: {
+				params: { kind: "text" },
+				...n(r)
+			}
+		}, {
+			spec: {
+				kind: "click",
+				target: "selected-body"
+			},
+			actionId: "enterTextEdit"
+		}]
+	}), [r]);
+}
+var s = {
+	toDisplay: (e) => Math.round(e * 1e3) / 10,
+	fromDisplay: (e) => Math.round(e * 1e3) / 1e5,
+	suffix: "%"
+}, c = (e, t) => ({
+	kind: "boolean",
+	name: e,
+	description: `${e} for the characters in the range.`,
+	icon: t,
+	control: "toggle",
+	pair: "Character style",
+	default: !1
+});
+o.options = {
+	name: "Text",
+	description: "Character styling for the selected range.",
+	children: {
+		bold: c("Bold", "bold"),
+		italic: c("Italic", "italic"),
+		underline: c("Underline", "underline"),
+		strikethrough: c("Strikethrough", "strikethrough"),
+		overline: c("Overline", "overline"),
+		script: {
+			kind: "enum",
+			name: "Script",
+			description: "Raise or lower the range off the baseline, at a smaller size.",
+			control: "toggle",
+			clearable: !0,
+			default: void 0,
+			options: [{
+				value: "super",
+				label: "Superscript",
+				icon: "superscript"
+			}, {
+				value: "sub",
+				label: "Subscript",
+				icon: "subscript"
+			}]
+		},
+		textTransform: {
+			kind: "enum",
+			name: "Case",
+			description: "Draw the range in capitals, lowercase or title case. The text itself is unchanged.",
+			control: "toggle",
+			default: "none",
+			options: [
+				{
+					value: "none",
+					label: "None",
+					short: "–"
+				},
+				{
+					value: "uppercase",
+					label: "Uppercase",
+					short: "AA"
+				},
+				{
+					value: "lowercase",
+					label: "Lowercase",
+					short: "aa"
+				},
+				{
+					value: "capitalize",
+					label: "Capitalize",
+					short: "Aa"
+				}
+			]
+		},
+		fontVariantCaps: {
+			kind: "enum",
+			name: "Small caps",
+			description: "Draw lowercase letters in the range as smaller capitals. The text itself is unchanged.",
+			control: "toggle",
+			default: "normal",
+			options: [{
+				value: "normal",
+				label: "Normal",
+				short: "–"
+			}, {
+				value: "small-caps",
+				label: "Small caps",
+				short: "Sc"
+			}]
+		},
+		fontFamily: {
+			kind: "font-family",
+			name: "Font",
+			description: "Typeface for the range.",
+			default: void 0
+		},
+		fontWeight: {
+			kind: "font-weight",
+			name: "Weight",
+			description: "Weight of the range, from the faces its family has.",
+			default: void 0
+		},
+		fontSize: {
+			kind: "number",
+			name: "Size",
+			description: "Type size.",
+			min: 1,
+			step: 1,
+			default: 16
+		},
+		letterSpacing: {
+			kind: "number",
+			name: "Tracking",
+			short: "VA",
+			description: "Space added between characters.",
+			step: .1,
+			default: 0
+		},
+		baselineShift: {
+			kind: "number",
+			name: "Baseline shift",
+			short: "Shift",
+			description: "Raise or lower the range, in ems of the inherited size.",
+			step: .001,
+			unit: s,
+			default: 0
+		},
+		fontScale: {
+			kind: "number",
+			name: "Scale",
+			description: "Size of the range against the inherited size.",
+			min: .01,
+			step: .001,
+			unit: s,
+			default: 1
+		},
+		fill: {
+			kind: "color",
+			name: "Color",
+			description: "Ink for the range.",
+			alpha: !0,
+			default: "#000000"
+		}
+	}
+};
+//#endregion
+export { o as useTextTool };
+
+//# sourceMappingURL=useTextTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTextTool.js","names":["TextIcon","PRESENTATION","createElement","useTextTool","options","useMemo","defineTool","insertBindingBehaviors","behaviors","PERCENT","v","flag","name"],"sources":["../../../../src/tools/builtin/text/useTextTool.ts"],"sourcesContent":["import { useMemo, createElement } from 'react';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport type { ToolPrefGroup } from '../../prefs';\nimport { TextIcon } from '../../../icons';\n\nconst PRESENTATION = {\n  label: 'Text',\n  icon: createElement(TextIcon),\n  group: 'type',\n};\n\n/** Text tool. Drag-rect insertion is owned end-to-end by the dispatcher's\n *  `insertAction` (kind: `'text'`); click-on-selected-text-node enters edit\n *  mode via the `enterTextEdit` action.\n *\n *  Consumers must register both the `insert` dep (e.g. through\n *  `SceneCanvas`'s `useInsertDepSource`) and the `textEdit` dep\n *  (`enterTextEditAction`'s contract — see\n *  `src/interactions/actions/defaults/enterTextEdit.ts`). Custom node\n *  factories and hit gating belong on those deps, not on the tool. */\nexport function useTextTool(options: InsertToolOptions = {}): Tool<undefined> {\n  const { behaviors } = options;\n  return useMemo<Tool<undefined>>(\n    () =>\n      defineTool<undefined>({\n        id: 'text',\n        capabilities: ['creates-text'],\n        hookName: 'useTextTool',\n        cursor: 'text',\n        presentation: PRESENTATION,\n        bindings: [\n          { spec: { kind: 'drag' }, actionId: 'insert', opts: { params: { kind: 'text' }, ...insertBindingBehaviors(behaviors) } },\n          { spec: { kind: 'click', target: 'selected-body' }, actionId: 'enterTextEdit' },\n        ],\n      }),\n    [behaviors],\n  );\n}\n\n/** Both script primitives are fractions of the inherited size, so both read\n *  as percentages. The step is a tenth of a point because the field snaps the\n *  *displayed* value to it, and a coarser one would render a superscript's\n *  58.3% as 60% and commit that on the next edit. */\nconst PERCENT = {\n  toDisplay: (v: number) => Math.round(v * 1000) / 10,\n  // Rounded rather than divided: 33.3 / 100 is 0.33299999999999996, and that\n  // dust would be written into the document and shown back on the next read.\n  fromDisplay: (v: number) => Math.round(v * 1000) / 100_000,\n  suffix: '%',\n};\n\n/** A run flag: on or off per character, drawn as one segment of a bar. */\nconst flag = (name: string, icon: string) =>\n  ({\n    kind: 'boolean',\n    name,\n    description: `${name} for the characters in the range.`,\n    icon,\n    control: 'toggle',\n    pair: 'Character style',\n    default: false,\n  }) as const;\n\n/**\n * What the tool offers while a caret range is active — the character half of\n * text styling, against the node-level Character group a selection shows.\n *\n * Keyed by {@link StyledRun} field, so a host reads values out of a\n * `RangeStyle` and writes a `RunStylePatch` back with no name mapping of its\n * own. `script` is a preset over `baselineShift` and `fontScale`, so all three\n * are here and naming either primitive overrides that half.\n */\nuseTextTool.options = {\n  name: 'Text',\n  description: 'Character styling for the selected range.',\n  children: {\n    bold: flag('Bold', 'bold'),\n    italic: flag('Italic', 'italic'),\n    underline: flag('Underline', 'underline'),\n    strikethrough: flag('Strikethrough', 'strikethrough'),\n    overline: flag('Overline', 'overline'),\n    // Clearable: the two values are exclusive *and* absent is a third state,\n    // so clicking the lit segment turns the script off.\n    script: {\n      kind: 'enum',\n      name: 'Script',\n      description: 'Raise or lower the range off the baseline, at a smaller size.',\n      control: 'toggle',\n      clearable: true,\n      default: undefined,\n      options: [\n        { value: 'super', label: 'Superscript', icon: 'superscript' },\n        { value: 'sub', label: 'Subscript', icon: 'subscript' },\n      ],\n    },\n    textTransform: {\n      kind: 'enum',\n      name: 'Case',\n      description: 'Draw the range in capitals, lowercase or title case. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'none',\n      options: [{ value: 'none', label: 'None', short: '–' }, { value: 'uppercase', label: 'Uppercase', short: 'AA' }, { value: 'lowercase', label: 'Lowercase', short: 'aa' }, { value: 'capitalize', label: 'Capitalize', short: 'Aa' }],\n    },\n    fontVariantCaps: {\n      kind: 'enum',\n      name: 'Small caps',\n      description: 'Draw lowercase letters in the range as smaller capitals. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'normal',\n      options: [{ value: 'normal', label: 'Normal', short: '–' }, { value: 'small-caps', label: 'Small caps', short: 'Sc' }],\n    },\n    fontFamily: {\n      kind: 'font-family',\n      name: 'Font',\n      description: 'Typeface for the range.',\n      default: undefined,\n    },\n    // Listed from the weights the range's family has registered. Bold is a\n    // preset over it: toggling Bold clears it, picking one clears Bold.\n    fontWeight: {\n      kind: 'font-weight',\n      name: 'Weight',\n      description: 'Weight of the range, from the faces its family has.',\n      default: undefined,\n    },\n    fontSize: { kind: 'number', name: 'Size', description: 'Type size.', min: 1, step: 1, default: 16 },\n    letterSpacing: {\n      kind: 'number',\n      name: 'Tracking',\n      // The typographic term, short enough for a strip; `name` stays the\n      // accessible one.\n      short: 'VA',\n      description: 'Space added between characters.',\n      step: 0.1,\n      default: 0,\n    },\n    baselineShift: {\n      kind: 'number',\n      name: 'Baseline shift',\n      short: 'Shift',\n      description: 'Raise or lower the range, in ems of the inherited size.',\n      step: 0.001,\n      unit: PERCENT,\n      default: 0,\n    },\n    fontScale: {\n      kind: 'number',\n      name: 'Scale',\n      description: 'Size of the range against the inherited size.',\n      min: 0.01,\n      step: 0.001,\n      unit: PERCENT,\n      default: 1,\n    },\n    fill: {\n      kind: 'color',\n      name: 'Color',\n      description: 'Ink for the range.',\n      alpha: true,\n      default: '#000000',\n    },\n  },\n} satisfies ToolPrefGroup;\n"],"mappings":";;;;;AAOA,IAAMC,IAAe;CACnB,OAAO;CACP,MAAMC,EAAcF,CAAQ;CAC5B,OAAO;AACT;AAWA,SAAgBG,EAAY,IAA6B,CAAC,GAAoB;CAC5E,IAAM,EAAE,iBAAcC;CACtB,OAAOC,QAEHC,EAAsB;EACpB,IAAI;EACJ,cAAc,CAAC,cAAc;EAC7B,UAAU;EACV,QAAQ;EACR,cAAcL;EACd,UAAU,CACR;GAAE,MAAM,EAAE,MAAM,OAAO;GAAG,UAAU;GAAU,MAAM;IAAE,QAAQ,EAAE,MAAM,OAAO;IAAG,GAAGM,EAAuBC,CAAS;GAAE;EAAE,GACvH;GAAE,MAAM;IAAE,MAAM;IAAS,QAAQ;GAAgB;GAAG,UAAU;EAAgB,CAChF;CACF,CAAC,GACH,CAACA,CAAS,CACZ;AACF;AAMA,IAAMC,IAAU;CACd,YAAY,MAAc,KAAK,MAAMC,IAAI,GAAI,IAAI;CAGjD,cAAc,MAAc,KAAK,MAAMA,IAAI,GAAI,IAAI;CACnD,QAAQ;AACV,GAGMC,KAAQ,GAAc,OACzB;CACC,MAAM;CACN;CACA,aAAa,GAAGC,EAAK;CACrB;CACA,SAAS;CACT,MAAM;CACN,SAAS;AACX;AAWF,EAAY,UAAU;CACpB,MAAM;CACN,aAAa;CACb,UAAU;EACR,MAAMD,EAAK,QAAQ,MAAM;EACzB,QAAQA,EAAK,UAAU,QAAQ;EAC/B,WAAWA,EAAK,aAAa,WAAW;EACxC,eAAeA,EAAK,iBAAiB,eAAe;EACpD,UAAUA,EAAK,YAAY,UAAU;EAGrC,QAAQ;GACN,MAAM;GACN,MAAM;GACN,aAAa;GACb,SAAS;GACT,WAAW;GACX,SAAS,KAAA;GACT,SAAS,CACP;IAAE,OAAO;IAAS,OAAO;IAAe,MAAM;GAAc,GAC5D;IAAE,OAAO;IAAO,OAAO;IAAa,MAAM;GAAY,CACxD;EACF;EACA,eAAe;GACb,MAAM;GACN,MAAM;GACN,aAAa;GACb,SAAS;GACT,SAAS;GACT,SAAS;IAAC;KAAE,OAAO;KAAQ,OAAO;KAAQ,OAAO;IAAI;IAAG;KAAE,OAAO;KAAa,OAAO;KAAa,OAAO;IAAK;IAAG;KAAE,OAAO;KAAa,OAAO;KAAa,OAAO;IAAK;IAAG;KAAE,OAAO;KAAc,OAAO;KAAc,OAAO;IAAK;GAAC;EACrO;EACA,iBAAiB;GACf,MAAM;GACN,MAAM;GACN,aAAa;GACb,SAAS;GACT,SAAS;GACT,SAAS,CAAC;IAAE,OAAO;IAAU,OAAO;IAAU,OAAO;GAAI,GAAG;IAAE,OAAO;IAAc,OAAO;IAAc,OAAO;GAAK,CAAC;EACvH;EACA,YAAY;GACV,MAAM;GACN,MAAM;GACN,aAAa;GACb,SAAS,KAAA;EACX;EAGA,YAAY;GACV,MAAM;GACN,MAAM;GACN,aAAa;GACb,SAAS,KAAA;EACX;EACA,UAAU;GAAE,MAAM;GAAU,MAAM;GAAQ,aAAa;GAAc,KAAK;GAAG,MAAM;GAAG,SAAS;EAAG;EAClG,eAAe;GACb,MAAM;GACN,MAAM;GAGN,OAAO;GACP,aAAa;GACb,MAAM;GACN,SAAS;EACX;EACA,eAAe;GACb,MAAM;GACN,MAAM;GACN,OAAO;GACP,aAAa;GACb,MAAM;GACN,MAAMF;GACN,SAAS;EACX;EACA,WAAW;GACT,MAAM;GACN,MAAM;GACN,aAAa;GACb,KAAK;GACL,MAAM;GACN,MAAMA;GACN,SAAS;EACX;EACA,MAAM;GACJ,MAAM;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;CACF;AACF"}

package/dist/tools/overlayBinding.js

@@ -0,0 +1,8 @@
+import { defineTool as e } from "@weasel-js/routing";
+import { useTools as t } from "@weasel-js/routing/react";
+//#region src/tools/overlayBinding.ts
+var n = t;
+//#endregion
+export { e as defineTool, n as useTools };
+
+//# sourceMappingURL=overlayBinding.js.map

package/dist/tools/overlayBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayBinding.js","names":["useTools","routingUseTools","useTools$1","useTools","defineTool"],"sources":["../../src/tools/overlayBinding.ts"],"sourcesContent":["/**\n * The routing types that carry an overlay, bound to the kit's `RenderLayer`.\n *\n * `@weasel-js/routing` never reads an overlay — it collects the live ones and\n * hands them back in scope order — so it leaves the element type open. What a\n * weasel canvas draws is a `RenderLayer`, and every kit call site should see\n * that rather than `unknown`, so core binds the parameter once, here, and\n * re-exports these names under the ones they have always had.\n */\nimport type { RenderLayer } from 'core/layers/render';\nimport { useTools as routingUseTools, useContributions as routingUseContributions } from '@weasel-js/routing/react';\nimport type {\n  Contribution as RoutingContribution,\n  ContributionChrome as RoutingContributionChrome,\n  Tool as RoutingTool,\n  ToolDef as RoutingToolDef,\n  AnyToolOf,\n} from '@weasel-js/routing';\nimport type {\n  ToolsApi as RoutingToolsApi,\n  UseToolsOptions as RoutingUseToolsOptions,\n  ContributionsApi as RoutingContributionsApi,\n  UseContributionsOptions as RoutingUseContributionsOptions,\n} from '@weasel-js/routing/react';\n\n/** What a canvas overlay is, at this layer. */\nexport type Overlay = RenderLayer<unknown>;\n\ndeclare module '@weasel-js/routing' {\n  interface OverlaySchema { overlay: RenderLayer<unknown> }\n}\n\n/** Routing's `Contribution`, with overlays typed as `RenderLayer`. */\nexport type Contribution = RoutingContribution<Overlay>;\n/** Routing's `ContributionChrome`, with overlays typed as `RenderLayer`. */\nexport type ContributionChrome = RoutingContributionChrome<Overlay>;\n/** Routing's `Tool`, with overlays typed as `RenderLayer`. */\nexport type Tool<TScratch = unknown> = RoutingTool<TScratch, Overlay>;\n/** A `Tool` of any scratch type: the element type for a list of mixed tools. */\nexport type AnyTool = AnyToolOf<Overlay>;\n/** Routing's `ToolDef` (what `defineTool` takes), with overlays typed as `RenderLayer`. */\nexport type ToolDef<TScratch = void> = RoutingToolDef<TScratch, Overlay>;\n/** Routing's `ToolsApi`, with overlays typed as `RenderLayer`. */\nexport type ToolsApi = RoutingToolsApi<Overlay>;\n/** Routing's `UseToolsOptions`, with overlays typed as `RenderLayer`. */\nexport type UseToolsOptions = RoutingUseToolsOptions<Overlay>;\nexport type ContributionsApi = RoutingContributionsApi<Overlay>;\nexport type UseContributionsOptions = RoutingUseContributionsOptions<Overlay>;\n\n// Routing's own authoring functions: the `OverlaySchema` merge above makes\n// their overlay default `Overlay`, so there is one `defineTool`, not a wrapper.\nexport { defineTool } from '@weasel-js/routing';\n/** Routing's `useTools`, typed for `RenderLayer` overlays. */\nexport const useTools: (opts: UseToolsOptions) => ToolsApi = routingUseTools;\nexport const useContributions: (opts: UseContributionsOptions) => ContributionsApi =\n  routingUseContributions;\n"],"mappings":";;;AAqDA,IAAaA,IAAgDC"}

package/dist/tools/prefs.js

@@ -0,0 +1,47 @@
+import { formatUnit as e, unitScale as t } from "@weasel-js/quantity";
+//#region src/tools/prefs.ts
+function n(n, r, i) {
+	let a;
+	try {
+		a = t(n, r);
+	} catch (e) {
+		throw Error(`prefUnit: ${e instanceof Error ? e.message : String(e)}`);
+	}
+	let o = i?.precision === void 0 ? void 0 : 10 ** i.precision, s = i?.suffix ?? r, c = { [s]: 1 };
+	for (let e of Object.keys(n.units)) {
+		let r = t(n, e), i = r.factor / a.factor, o = (r.offset - a.offset) / a.factor;
+		c[e] = o === 0 ? i : {
+			factor: i,
+			offset: o
+		};
+	}
+	return {
+		toDisplay: (e) => {
+			let t = (e - a.offset) / a.factor;
+			return o === void 0 ? t : Math.round(t * o) / o;
+		},
+		fromDisplay: (e) => e * a.factor + a.offset,
+		suffix: s,
+		accepts: c,
+		format: (t) => `${e(t, r, n, {
+			precision: i?.precision ?? 2,
+			suffix: !1
+		})}${s}`
+	};
+}
+var r = {
+	number: !0,
+	boolean: !0,
+	string: !0,
+	enum: !0,
+	color: !0,
+	paint: !0,
+	object: !0
+};
+function i(e) {
+	return Object.hasOwn(r, e.kind);
+}
+//#endregion
+export { r as TOOL_PREF_KINDS, i as isBuiltinToolPref, n as prefUnit };
+
+//# sourceMappingURL=prefs.js.map