@weasel-js/core 1.9.4 → 1.10.0

package/dist/core/selection/usePublishSceneSelection.js

@@ -0,0 +1,26 @@
+import { useMemo as e } from "react";
+import { usePublishSelection as t } from "@weasel-js/routing/react";
+//#region src/core/selection/usePublishSceneSelection.ts
+function n(e) {
+	if (e.kind === "container") return "group";
+	let t = e.pose;
+	if (t && typeof t == "object" && "kind" in t && typeof t.kind == "string") return "path";
+}
+function r(e, t, r) {
+	if (t.length !== 0) return t.map((t) => {
+		let i = e.get(t);
+		if (i) return r ? r(i) : n(i);
+	});
+}
+function i(n, i, a) {
+	let o = e(() => r(n, i, a), [
+		n,
+		i,
+		a
+	]);
+	t(i, o);
+}
+//#endregion
+export { r as selectionKindLabels, i as usePublishSceneSelection };
+
+//# sourceMappingURL=usePublishSceneSelection.js.map

package/dist/core/selection/usePublishSceneSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePublishSceneSelection.js","names":["defaultKindLabel","node","pose","selectionKindLabels","ids","scene","id","describeKind","usePublishSceneSelection","kinds","useMemo"],"sources":["../../../src/core/selection/usePublishSceneSelection.ts"],"sourcesContent":["import { usePublishSelection } from '@weasel-js/routing/react';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { useMemo } from 'react';\n\ntype KindLabel = string | undefined;\n\n// Not the routing kind: this reads the node and its pose where `NodeRouting.classify` reads\n// `data`, and the two disagree on most nodes (`SceneCanvas.selectionKinds.test.tsx`).\nfunction defaultKindLabel(node: Node<unknown, string, unknown>): KindLabel {\n  if (node.kind === 'container') return 'group';\n  const pose = node.pose as { kind?: unknown } | null;\n  if (pose && typeof pose === 'object' && 'kind' in pose && typeof pose.kind === 'string') return 'path';\n  return undefined;\n}\n\n/** The label published beside each selected id, parallel to `ids`; `undefined` when\n *  nothing is selected. `describeKind` replaces the default for every node. */\nexport function selectionKindLabels<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describeKind?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): readonly KindLabel[] | undefined {\n  if (ids.length === 0) return undefined;\n  return ids.map((id) => {\n    const node = scene.get(id);\n    if (!node) return undefined;\n    return describeKind ? describeKind(node) : defaultKindLabel(node as Node<unknown, string, unknown>);\n  });\n}\n\n/** Publishes a scene's selection, with a kind label per id, into any surrounding\n *  `<SelectionContextProvider>`. A no-op without one. */\nexport function usePublishSceneSelection<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describeKind?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): void {\n  const kinds = useMemo(() => selectionKindLabels(scene, ids, describeKind), [scene, ids, describeKind]);\n  usePublishSelection(ids, kinds);\n}\n"],"mappings":";;;AAQA,SAASA,EAAiB,GAAiD;CACzE,IAAIC,EAAK,SAAS,aAAa,OAAO;CACtC,IAAMC,IAAOD,EAAK;CAClB,IAAIC,KAAQ,OAAOA,KAAS,YAAY,UAAUA,KAAQ,OAAOA,EAAK,QAAS,UAAU,OAAO;AAElG;AAIA,SAAgBC,EACd,GACA,GACA,GACkC;CAClC,IAAIC,EAAI,WAAW,GACnB,OAAOA,EAAI,KAAK,MAAO;EACrB,IAAMH,IAAOI,EAAM,IAAIC,CAAE;EACzB,IAAKL,GACL,OAAOM,IAAeA,EAAaN,CAAI,IAAID,EAAiBC,CAAsC;CACpG,CAAC;AACH;AAIA,SAAgBO,EACd,GACA,GACA,GACM;CACN,IAAMC,IAAQC,QAAcP,EAAoBE,GAAOD,GAAKG,CAAY,GAAG;EAACF;EAAOD;EAAKG;CAAY,CAAC;CACrG,EAAoBH,GAAKK,CAAK;AAChC"}

package/dist/core/selection/useSelection.js

@@ -3,25 +3,31 @@ import { useLayoutEffect as t, useMemo as n, useRef as r, useState as i, useSync
 import { useLatest as o } from "@weasel-js/react";
 import { createSelectionStore as s, intentOf as c, select as l } from "@weasel-js/select";
 //#region src/core/selection/useSelection.ts
-function u(u = {}) {
-	let { mode: d = "single", extend: f = "shift", initial: p = [], lock: m = !1, scene: h } = u, [g] = i(() => s([...p])), _ = h ?? g, v = r(p);
-	a(_.subscribe, () => _.getSelection());
-	let y = r(!1);
+function u(e) {
+	let { renderOrder: t } = e;
+	return typeof t == "function" ? () => t.call(e) : void 0;
+}
+function d(d = {}) {
+	let { mode: f = "single", extend: p = "shift", initial: m = [], lock: h = !1, scene: g, range: _, order: v } = d, [y] = i(() => s([...m])), b = g ?? y, x = r(m);
+	a(b.subscribe, () => b.getSelection());
+	let S = r(!1);
 	t(() => {
-		h && !y.current && (y.current = !0, v.current.length > 0 && h.getSelection().length === 0 && h.setSelection([...v.current]));
-	}, [h]);
-	let b = o({
-		mode: d,
-		extend: f,
-		lock: m
-	});
+		g && !S.current && (S.current = !0, x.current.length > 0 && g.getSelection().length === 0 && g.setSelection([...x.current]));
+	}, [g]);
+	let C = o({
+		mode: f,
+		extend: p,
+		lock: h,
+		range: _,
+		order: v
+	}), w = r(null);
 	return n(() => {
-		let t = () => _.getSelection(), n = (n) => {
-			b.current.lock || (e("selection", "set", {
+		let t = () => b.getSelection(), n = (n) => {
+			C.current.lock || (e("selection", "set", {
 				from: t().length,
 				to: n.length,
 				ids: n
-			}), _.setSelection(n));
+			}), b.setSelection(n));
 		}, r = (e) => t().filter((t) => t !== e);
 		return {
 			get current() {
@@ -30,36 +36,39 @@ function u(u = {}) {
 			get: t,
 			set: n,
 			add(e) {
-				b.current.mode === "single" ? n([e]) : t().includes(e) || n([...t(), e]);
+				C.current.mode === "single" ? n([e]) : t().includes(e) || n([...t(), e]);
 			},
 			remove(e) {
 				t().includes(e) && n(r(e));
 			},
 			toggle(e) {
-				t().includes(e) ? n(r(e)) : n(b.current.mode === "single" ? [e] : [...t(), e]);
+				t().includes(e) ? n(r(e)) : n(C.current.mode === "single" ? [e] : [...t(), e]);
 			},
 			clear() {
 				n([]);
 			},
 			contains: (e) => t().includes(e),
 			applyClick(e, r) {
-				let { mode: i, extend: a } = b.current;
-				n([...l({
-					ids: t(),
-					anchor: null
-				}, e, c(r, {
+				let { mode: i, extend: a, range: o, order: s = u(b), lock: d } = C.current;
+				if (d) return;
+				let f = t(), p = w.current !== null && f.includes(w.current) ? w.current : f.at(-1) ?? null, m = c(r, {
 					mode: i,
-					toggle: a
-				})).ids]);
+					toggle: a,
+					range: o
+				}), h = l({
+					ids: f,
+					anchor: p
+				}, e, m, m === "range" && s ? { order: [...s()] } : {});
+				w.current = h.anchor, n([...h.ids]);
 			},
 			adapterMethods: {
 				getSelection: () => t(),
 				setSelection: (e) => n(e)
 			}
 		};
-	}, [_, b]);
+	}, [b, C]);
 }
 //#endregion
-export { u as useSelection };
+export { d as useSelection };
 
 //# sourceMappingURL=useSelection.js.map

package/dist/core/selection/useSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSelection.js","names":["useSelection","opts","local","useState","createSelectionStore","initial","store","scene","initialRef","useRef","seeded","optsRef","useLatest","useMemo","get","set","dlog","ids","without","x","id","m","key","select","intentOf","modifiers"],"sources":["../../../src/core/selection/useSelection.ts"],"sourcesContent":["import { useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { createSelectionStore, intentOf, select, type SelectionStore as Store } from '@weasel-js/select';\nimport type { NodeId } from 'core/scene/types';\nimport { dlog } from 'debug/flag';\n\n/**\n * `SelectionApi`, `SelectionMode` and `SelectionExtendKey` are declared in\n * `@weasel-js/routing` — the `selection` dep and half the kit's actions are\n * typed in them. Re-exported here, beside the hook that returns one.\n */\nimport type { SelectionApi, SelectionMode, SelectionExtendKey } from '@weasel-js/routing';\nexport type { SelectionApi, SelectionMode, SelectionExtendKey };\n\n/** Somewhere selection can live outside this hook. `Scene` satisfies it;\n *  so does any store with the same three methods. */\nexport type SelectionStore = Store<NodeId>;\n\n/** Options for {@link useSelection}. */\nexport interface UseSelectionOptions {\n  /** Default `'single'`. */\n  mode?: SelectionMode;\n  /** Default `'shift'`. Ignored in single-mode. */\n  extend?: SelectionExtendKey;\n  /** Default `[]`. */\n  initial?: readonly NodeId[];\n  /** Keep the selection on this store rather than in the hook, so every\n   *  consumer of the same scene shares one selection and undo / redo can\n   *  restore it. `initial` then only seeds a store that has none yet.\n   *  Omit it and the hook owns a selection nobody else sees. */\n  scene?: SelectionStore;\n  /** When `true`, every mutator (`set`/`add`/`remove`/`toggle`/`clear`/\n   *  `applyClick`) is a no-op — selection stays at whatever `initial`\n   *  pinned it to. Useful for demos that exist to showcase a single\n   *  pre-selected node and don't want a\n   *  stray click to deselect. */\n  lock?: boolean;\n}\n\n/**\n * Default implementation of the `getSelection` / `setSelection` adapter\n * contract every action hook (delete, duplicate, nudge, group, ...) requires.\n *\n * Owns selection state, exposes a click-policy helper (single vs multi with\n * an extend key), and pre-builds the two adapter methods consumers otherwise\n * hand-roll in every demo:\n *\n * ```tsx\n * const selection = useSelection({ mode: 'multi' });\n * const adapter = { ...arrayAdapter({...}), ...selection.adapterMethods };\n * ```\n *\n * Returns the same object for as long as `scene` is the same store, so it is\n * safe as a memo or effect dependency. The calling component re-renders when\n * the selection changes; key anything derived from the ids on\n * `selection.current`.\n */\nexport function useSelection(opts: UseSelectionOptions = {}): SelectionApi {\n  const { mode = 'single', extend = 'shift', initial = [], lock = false, scene } = opts;\n  // Without a `scene` the hook still keeps its ids in a store, so `get()` reads one store either\n  // way and a write is visible before the re-render it causes.\n  const [local] = useState(() => createSelectionStore<NodeId>([...initial]));\n  const store = scene ?? local;\n  const initialRef = useRef(initial);\n\n  useSyncExternalStore(store.subscribe, () => store.getSelection());\n\n  // A store that already holds a selection wins: the hook is joining it, not\n  // resetting it. In an effect, not during render — the store has other\n  // subscribers.\n  const seeded = useRef(false);\n  useLayoutEffect(() => {\n    if (!scene || seeded.current) return;\n    seeded.current = true;\n    if (initialRef.current.length > 0 && scene.getSelection().length === 0) {\n      scene.setSelection([...initialRef.current]);\n    }\n  }, [scene]);\n\n  const optsRef = useLatest({ mode, extend, lock });\n\n  return useMemo<SelectionApi>(() => {\n    const get = (): NodeId[] => store.getSelection() as NodeId[];\n    const set = (ids: NodeId[]): void => {\n      if (optsRef.current.lock) return;\n      dlog('selection', 'set', { from: get().length, to: ids.length, ids });\n      store.setSelection(ids);\n    };\n    const without = (id: NodeId) => get().filter((x) => x !== id);\n    return {\n      get current() { return get(); },\n      get,\n      set,\n      add(id) {\n        if (optsRef.current.mode === 'single') set([id]);\n        else if (!get().includes(id)) set([...get(), id]);\n      },\n      remove(id) {\n        if (get().includes(id)) set(without(id));\n      },\n      toggle(id) {\n        if (get().includes(id)) set(without(id));\n        else set(optsRef.current.mode === 'single' ? [id] : [...get(), id]);\n      },\n      clear() { set([]); },\n      contains: (id) => get().includes(id),\n      applyClick(id, modifiers) {\n        const { mode: m, extend: key } = optsRef.current;\n        set([...select({ ids: get(), anchor: null }, id, intentOf(modifiers, { mode: m, toggle: key })).ids]);\n      },\n      adapterMethods: {\n        getSelection: () => get(),\n        setSelection: (ids: NodeId[]) => set(ids),\n      },\n    };\n  }, [store, optsRef]);\n}\n"],"mappings":";;;;;AAyDA,SAAgBA,EAAa,IAA4B,CAAC,GAAiB;CACzE,IAAM,EAAE,UAAO,UAAU,YAAS,SAAS,aAAU,CAAC,GAAG,UAAO,IAAO,aAAUC,GAG3E,CAACC,KAASC,QAAeC,EAA6B,CAAC,GAAGC,CAAO,CAAC,CAAC,GACnEC,IAAQC,KAASL,GACjBM,IAAaC,EAAOJ,CAAO;CAEjC,EAAqBC,EAAM,iBAAiBA,EAAM,aAAa,CAAC;CAKhE,IAAMI,IAASD,EAAO,EAAK;CAC3B,QAAsB;EACpB,AAAKF,KAAS,GAAO,YACrB,EAAO,UAAU,IACbC,EAAW,QAAQ,SAAS,KAAKD,EAAM,aAAa,CAAC,CAAC,WAAW,KACnEA,EAAM,aAAa,CAAC,GAAGC,EAAW,OAAO,CAAC;CAE9C,GAAG,CAACD,CAAK,CAAC;CAEV,IAAMI,IAAUC,EAAU;EAAE;EAAM;EAAQ;CAAK,CAAC;CAEhD,OAAOC,QAA4B;EACjC,IAAMC,UAAsBR,EAAM,aAAa,GACzCS,KAAO,MAAwB;GACnC,AAAIJ,EAAQ,QAAQ,SACpBK,EAAK,aAAa,OAAO;IAAE,MAAMF,EAAI,CAAC,CAAC;IAAQ,IAAIG,EAAI;IAAQ;GAAI,CAAC,GACpEX,EAAM,aAAaW,CAAG;EACxB,GACMC,KAAW,MAAeJ,EAAI,CAAC,CAAC,QAAQ,MAAMK,MAAMC,CAAE;EAC5D,OAAO;GACL,IAAI,UAAU;IAAE,OAAON,EAAI;GAAG;GAC9B;GACA;GACA,IAAI,GAAI;IACN,AAAIH,EAAQ,QAAQ,SAAS,WAAUI,EAAI,CAACK,CAAE,CAAC,IACrCN,EAAI,CAAC,CAAC,SAASM,CAAE,KAAGL,EAAI,CAAC,GAAGD,EAAI,GAAGM,CAAE,CAAC;GAClD;GACA,OAAO,GAAI;IACT,AAAIN,EAAI,CAAC,CAAC,SAASM,CAAE,KAAGL,EAAIG,EAAQE,CAAE,CAAC;GACzC;GACA,OAAO,GAAI;IACT,AAAIN,EAAI,CAAC,CAAC,SAASM,CAAE,IAAGL,EAAIG,EAAQE,CAAE,CAAC,IAClCL,EAAIJ,EAAQ,QAAQ,SAAS,WAAW,CAACS,CAAE,IAAI,CAAC,GAAGN,EAAI,GAAGM,CAAE,CAAC;GACpE;GACA,QAAQ;IAAE,EAAI,CAAC,CAAC;GAAG;GACnB,WAAW,MAAON,EAAI,CAAC,CAAC,SAASM,CAAE;GACnC,WAAW,GAAI,GAAW;IACxB,IAAM,EAAE,MAAMC,GAAG,QAAQC,MAAQX,EAAQ;IACzC,EAAI,CAAC,GAAGY,EAAO;KAAE,KAAKT,EAAI;KAAG,QAAQ;IAAK,GAAGM,GAAII,EAASC,GAAW;KAAE,MAAMJ;KAAG,QAAQC;IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;GACtG;GACA,gBAAgB;IACd,oBAAoBR,EAAI;IACxB,eAAe,MAAkBC,EAAIE,CAAG;GAC1C;EACF;CACF,GAAG,CAACX,GAAOK,CAAO,CAAC;AACrB"}
+{"version":3,"file":"useSelection.js","names":["paintOrderOf","store","renderOrder","useSelection","opts","local","useState","createSelectionStore","initial","scene","initialRef","useRef","seeded","optsRef","useLatest","anchorRef","useMemo","get","set","dlog","ids","without","x","id","m","key","rangeKey","walk","locked","anchor","intent","intentOf","modifiers","next","select"],"sources":["../../../src/core/selection/useSelection.ts"],"sourcesContent":["import { useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { createSelectionStore, intentOf, select, type SelectionStore as Store } from '@weasel-js/select';\nimport type { NodeId } from 'core/scene/types';\nimport { dlog } from 'debug/flag';\n\n/** Declared in `@weasel-js/routing`; re-exported here, beside the hook that returns one. */\nimport type { SelectionApi, SelectionMode, SelectionExtendKey } from '@weasel-js/routing';\nexport type { SelectionApi, SelectionMode, SelectionExtendKey };\n\n/** Somewhere selection can live outside this hook. `Scene` satisfies it;\n *  so does any store with the same three methods. */\nexport type SelectionStore = Store<NodeId>;\n\n/** Options for {@link useSelection}. */\nexport interface UseSelectionOptions {\n  /** Default `'single'`. */\n  mode?: SelectionMode;\n  /** Default `'shift'`. Ignored in single-mode. */\n  extend?: SelectionExtendKey;\n  /** The key that selects everything from the last pressed id to this one,\n   *  along `order`. Absent, nothing ranges. It beats `extend` when both name\n   *  one key, so give them different keys. Ignored in single-mode. */\n  range?: SelectionExtendKey;\n  /** The sequence a range walks: a layer panel's rows, a timeline's tracks.\n   *  Default is the order the `scene` paints in, back to front; with neither,\n   *  the range key replaces. */\n  order?: () => Iterable<NodeId>;\n  /** Default `[]`. */\n  initial?: readonly NodeId[];\n  /** Keep the selection on this store rather than in the hook, so every\n   *  consumer of the same scene shares one selection and undo / redo can\n   *  restore it. `initial` then only seeds a store that has none yet.\n   *  Omit it and the hook owns a selection nobody else sees. */\n  scene?: SelectionStore;\n  /** When `true`, every mutator (`set`/`add`/`remove`/`toggle`/`clear`/\n   *  `applyClick`) is a no-op — selection stays at whatever `initial`\n   *  pinned it to. */\n  lock?: boolean;\n}\n\n/** The order a store paints its nodes in, when it is a scene and has one. */\nfunction paintOrderOf(store: SelectionStore): (() => Iterable<NodeId>) | undefined {\n  const { renderOrder } = store as { renderOrder?: () => Iterable<NodeId> };\n  return typeof renderOrder === 'function' ? () => renderOrder.call(store) : undefined;\n}\n\n/**\n * Owns selection state, exposes a click-policy helper (single vs multi with\n * an extend key), and pre-builds the `getSelection` / `setSelection` adapter\n * methods:\n *\n * ```tsx\n * const selection = useSelection({ mode: 'multi' });\n * const adapter = useSceneAdapter(scene, { selection: selection.adapterMethods });\n * ```\n *\n * Returns the same object for as long as `scene` is the same store, so it is\n * safe as a memo or effect dependency. The calling component re-renders when\n * the selection changes; key anything derived from the ids on\n * `selection.current`.\n */\nexport function useSelection(opts: UseSelectionOptions = {}): SelectionApi {\n  const { mode = 'single', extend = 'shift', initial = [], lock = false, scene, range, order } = opts;\n  // Without a `scene` the hook still keeps its ids in a store, so `get()` reads one store either\n  // way and a write is visible before the re-render it causes.\n  const [local] = useState(() => createSelectionStore<NodeId>([...initial]));\n  const store = scene ?? local;\n  const initialRef = useRef(initial);\n\n  useSyncExternalStore(store.subscribe, () => store.getSelection());\n\n  // A store that already holds a selection wins: the hook is joining it, not\n  // resetting it. In an effect, not during render — the store has other\n  // subscribers.\n  const seeded = useRef(false);\n  useLayoutEffect(() => {\n    if (!scene || seeded.current) return;\n    seeded.current = true;\n    if (initialRef.current.length > 0 && scene.getSelection().length === 0) {\n      scene.setSelection([...initialRef.current]);\n    }\n  }, [scene]);\n\n  const optsRef = useLatest({ mode, extend, lock, range, order });\n  const anchorRef = useRef<NodeId | null>(null);\n\n  return useMemo<SelectionApi>(() => {\n    const get = (): NodeId[] => store.getSelection() as NodeId[];\n    const set = (ids: NodeId[]): void => {\n      if (optsRef.current.lock) return;\n      dlog('selection', 'set', { from: get().length, to: ids.length, ids });\n      store.setSelection(ids);\n    };\n    const without = (id: NodeId) => get().filter((x) => x !== id);\n    return {\n      get current() { return get(); },\n      get,\n      set,\n      add(id) {\n        if (optsRef.current.mode === 'single') set([id]);\n        else if (!get().includes(id)) set([...get(), id]);\n      },\n      remove(id) {\n        if (get().includes(id)) set(without(id));\n      },\n      toggle(id) {\n        if (get().includes(id)) set(without(id));\n        else set(optsRef.current.mode === 'single' ? [id] : [...get(), id]);\n      },\n      clear() { set([]); },\n      contains: (id) => get().includes(id),\n      applyClick(id, modifiers) {\n        const { mode: m, extend: key, range: rangeKey, order: walk = paintOrderOf(store), lock: locked } = optsRef.current;\n        if (locked) return;\n        const ids = get();\n        // A selection something else set — a marquee, an undo — ranges from its last id.\n        const anchor = anchorRef.current !== null && ids.includes(anchorRef.current)\n          ? anchorRef.current\n          : (ids.at(-1) ?? null);\n        const intent = intentOf(modifiers, { mode: m, toggle: key, range: rangeKey });\n        const next = select({ ids, anchor }, id, intent, intent === 'range' && walk ? { order: [...walk()] } : {});\n        anchorRef.current = next.anchor;\n        set([...next.ids]);\n      },\n      adapterMethods: {\n        getSelection: () => get(),\n        setSelection: (ids: NodeId[]) => set(ids),\n      },\n    };\n  }, [store, optsRef]);\n}\n"],"mappings":"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"}

package/dist/core/shapeKinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"shapeKinds.js","names":["SHAPE_KINDS","shapeKindsWhere","table","k","field","shapeKindInfo","kind","KIT_SHAPE_KINDS"],"sources":["../../src/core/shapeKinds.ts"],"sourcesContent":["/**\n * The kit's built-in shape kinds — one table, every other spelling derived.\n *\n * Lives in `core/` rather than beside the shape tools because both layers ask\n * questions of the same set: the interactions layer decides whether\n * `insertAction` can paint a live preview for a kind, and the canvas layer\n * decides which shape tools `useBuiltinShapeTools` mounts and what\n * `BUILTIN_TOOL_IDS` / `defaultNodeRouting` / `defaultNodeProperties` enumerate.\n *\n * This module imports nothing on purpose: `useBuiltinShapeTools` imports the\n * package barrel, so anything barrel-reachable that needs these lists at\n * module-evaluation time must not route through it.\n */\n\n/** What the kit knows about one built-in shape kind. */\nexport interface ShapeKindDescriptor {\n  /** Mounted as a built-in shape tool by `useBuiltinShapeTools`, and so a\n   *  member of `BuiltinShapeToolId` / `KIT_SHAPE_KINDS`. `image` is false:\n   *  `useImageTool` needs a `src` and can't be auto-mounted. */\n  readonly tool: boolean;\n  /** `insertAction` emits an `insertPreview` overlay for this kind, and the\n   *  dispatcher overlay layer knows how to draw it. Kinds without one still\n   *  commit; they just have no live drag preview (`pen` and `lasso` don't\n   *  route through `insertAction` at all). */\n  readonly insertPreview: boolean;\n}\n\n/**\n * Declaration order is the enumeration order of every derived list —\n * `KIT_SHAPE_KINDS`, and through it `defaultNodeRouting` /\n * `defaultNodeProperties` / `BUILTIN_TOOL_IDS`.\n */\nexport const SHAPE_KINDS = {\n  rect: { tool: true, insertPreview: true },\n  ellipse: { tool: true, insertPreview: true },\n  line: { tool: true, insertPreview: true },\n  polygon: { tool: true, insertPreview: true },\n  star: { tool: true, insertPreview: true },\n  pen: { tool: true, insertPreview: false },\n  pencil: { tool: true, insertPreview: true },\n  lasso: { tool: true, insertPreview: false },\n  text: { tool: true, insertPreview: true },\n  image: { tool: false, insertPreview: true },\n} as const satisfies Record<string, ShapeKindDescriptor>;\n\n/** Every kind in the table, tool or not. */\nexport type ShapeKind = keyof typeof SHAPE_KINDS;\n\n/** The keys of a shape-kind table whose descriptor sets `F` to `true`. */\nexport type ShapeKindsWhere<T, F extends keyof ShapeKindDescriptor> = {\n  [K in keyof T]: T[K] extends Record<F, true> ? K : never;\n}[keyof T];\n\n/**\n * Built-in shape tool ids handled by `useBuiltinShapeTools`. Each maps to a\n * kit tool hook + a default `create` that produces a leaf node compatible\n * with `PATH_PAINTER`.\n */\nexport type BuiltinShapeToolId = ShapeKindsWhere<typeof SHAPE_KINDS, 'tool'>;\n\n/** The insert kinds the kit's dispatcher overlay layer knows how to render.\n *  Consumer-defined kinds fall outside it: no live preview, commit unaffected. */\nexport type KitInsertShape = ShapeKindsWhere<typeof SHAPE_KINDS, 'insertPreview'>;\n\n/** Kinds in `table` whose descriptor sets `field`, in declaration order. */\nexport function shapeKindsWhere<T extends Record<string, ShapeKindDescriptor>>(\n  table: T,\n  field: keyof ShapeKindDescriptor,\n): (keyof T & string)[] {\n  return (Object.keys(table) as (keyof T & string)[]).filter((k) => table[k][field]);\n}\n\n/** The descriptor for `kind`, or `undefined` for a kind the kit doesn't ship.\n *  The one accessor: ask it rather than testing membership of a derived list. */\nexport function shapeKindInfo(kind: string): ShapeKindDescriptor | undefined {\n  return (SHAPE_KINDS as Record<string, ShapeKindDescriptor>)[kind];\n}\n\n/** Runtime, iterable list of the shape-tool ids in `BuiltinShapeToolId`.\n *  Surfaced so consumers (e.g. the Bundle Inspector) can enumerate the\n *  builtin shape kinds without re-encoding the union. */\nexport const KIT_SHAPE_KINDS: readonly BuiltinShapeToolId[] =\n  shapeKindsWhere(SHAPE_KINDS, 'tool') as BuiltinShapeToolId[];\n"],"mappings":";AAgCA,IAAaA,IAAc;CACzB,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,SAAS;EAAE,MAAM;EAAM,eAAe;CAAK;CAC3C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,SAAS;EAAE,MAAM;EAAM,eAAe;CAAK;CAC3C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,KAAK;EAAE,MAAM;EAAM,eAAe;CAAM;CACxC,QAAQ;EAAE,MAAM;EAAM,eAAe;CAAK;CAC1C,OAAO;EAAE,MAAM;EAAM,eAAe;CAAM;CAC1C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,OAAO;EAAE,MAAM;EAAO,eAAe;CAAK;AAC5C;AAsBA,SAAgBC,EACd,GACA,GACsB;CACtB,OAAQ,OAAO,KAAKC,CAAK,CAAC,CAA0B,QAAQ,MAAMA,EAAMC,EAAE,CAACC,EAAM;AACnF;AAIA,SAAgBC,EAAc,GAA+C;CAC3E,OAAQL,EAAoDM;AAC9D;AAKA,IAAaC,IACXN,EAAgBD,GAAa,MAAM"}
+{"version":3,"file":"shapeKinds.js","names":["SHAPE_KINDS","shapeKindsWhere","table","k","field","shapeKindInfo","kind","KIT_SHAPE_KINDS"],"sources":["../../src/core/shapeKinds.ts"],"sourcesContent":["/**\n * The kit's built-in shape kinds — one table, every other spelling derived.\n *\n * This module imports nothing on purpose: `useBuiltinShapeTools` imports the\n * package barrel, so anything barrel-reachable that needs these lists at\n * module-evaluation time must not route through it.\n */\n\n/** What the kit knows about one built-in shape kind. */\nexport interface ShapeKindDescriptor {\n  /** Mounted as a built-in shape tool by `useBuiltinShapeTools`, and so a\n   *  member of `BuiltinShapeToolId` / `KIT_SHAPE_KINDS`. `image` is false:\n   *  `useImageTool` needs a `src` and can't be auto-mounted. */\n  readonly tool: boolean;\n  /** `insertAction` emits an `insertPreview` overlay for this kind, and the\n   *  dispatcher overlay layer knows how to draw it. Kinds without one still\n   *  commit; they just have no live drag preview. */\n  readonly insertPreview: boolean;\n}\n\n/**\n * Declaration order is the enumeration order of every derived list —\n * `KIT_SHAPE_KINDS`, and through it `defaultNodeRouting` /\n * `defaultNodeProperties` / `BUILTIN_TOOL_IDS`.\n */\nexport const SHAPE_KINDS = {\n  rect: { tool: true, insertPreview: true },\n  ellipse: { tool: true, insertPreview: true },\n  line: { tool: true, insertPreview: true },\n  polygon: { tool: true, insertPreview: true },\n  star: { tool: true, insertPreview: true },\n  pen: { tool: true, insertPreview: false },\n  pencil: { tool: true, insertPreview: true },\n  lasso: { tool: true, insertPreview: false },\n  text: { tool: true, insertPreview: true },\n  image: { tool: false, insertPreview: true },\n} as const satisfies Record<string, ShapeKindDescriptor>;\n\n/** Every kind in the table, tool or not. */\nexport type ShapeKind = keyof typeof SHAPE_KINDS;\n\n/** The keys of a shape-kind table whose descriptor sets `F` to `true`. */\nexport type ShapeKindsWhere<T, F extends keyof ShapeKindDescriptor> = {\n  [K in keyof T]: T[K] extends Record<F, true> ? K : never;\n}[keyof T];\n\n/** Built-in shape tool ids handled by `useBuiltinShapeTools`. */\nexport type BuiltinShapeToolId = ShapeKindsWhere<typeof SHAPE_KINDS, 'tool'>;\n\n/** The insert kinds the kit's dispatcher overlay layer knows how to render.\n *  Consumer-defined kinds fall outside it: no live preview, commit unaffected. */\nexport type KitInsertShape = ShapeKindsWhere<typeof SHAPE_KINDS, 'insertPreview'>;\n\n/** Kinds in `table` whose descriptor sets `field`, in declaration order. */\nexport function shapeKindsWhere<T extends Record<string, ShapeKindDescriptor>>(\n  table: T,\n  field: keyof ShapeKindDescriptor,\n): (keyof T & string)[] {\n  return (Object.keys(table) as (keyof T & string)[]).filter((k) => table[k][field]);\n}\n\n/** The descriptor for `kind`, or `undefined` for a kind the kit doesn't ship.\n *  The one accessor: ask it rather than testing membership of a derived list. */\nexport function shapeKindInfo(kind: string): ShapeKindDescriptor | undefined {\n  return (SHAPE_KINDS as Record<string, ShapeKindDescriptor>)[kind];\n}\n\n/** Runtime, iterable list of the shape-tool ids in `BuiltinShapeToolId`. */\nexport const KIT_SHAPE_KINDS: readonly BuiltinShapeToolId[] =\n  shapeKindsWhere(SHAPE_KINDS, 'tool') as BuiltinShapeToolId[];\n"],"mappings":";AAyBA,IAAaA,IAAc;CACzB,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,SAAS;EAAE,MAAM;EAAM,eAAe;CAAK;CAC3C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,SAAS;EAAE,MAAM;EAAM,eAAe;CAAK;CAC3C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,KAAK;EAAE,MAAM;EAAM,eAAe;CAAM;CACxC,QAAQ;EAAE,MAAM;EAAM,eAAe;CAAK;CAC1C,OAAO;EAAE,MAAM;EAAM,eAAe;CAAM;CAC1C,MAAM;EAAE,MAAM;EAAM,eAAe;CAAK;CACxC,OAAO;EAAE,MAAM;EAAO,eAAe;CAAK;AAC5C;AAkBA,SAAgBC,EACd,GACA,GACsB;CACtB,OAAQ,OAAO,KAAKC,CAAK,CAAC,CAA0B,QAAQ,MAAMA,EAAMC,EAAE,CAACC,EAAM;AACnF;AAIA,SAAgBC,EAAc,GAA+C;CAC3E,OAAQL,EAAoDM;AAC9D;AAGA,IAAaC,IACXN,EAAgBD,GAAa,MAAM"}

package/dist/core/stylus/stylus.js.map

@@ -1 +1 @@
-{"version":3,"file":"stylus.js","names":["pressureToWidth","minWidth","options","maxWidth","gamma","shaped","pressure","getStylusData","ext","pointerType","forEachCoalesced","get","event","sub","list","e","screenX","screenY","ctx","worldX","worldY","clientToWorld"],"sources":["../../../src/core/stylus/stylus.ts"],"sourcesContent":["import { clientToWorld } from 'core/viewport/clientToWorld';\n/**\n * Stylus / Pencil pointer-event helpers.\n *\n * Most stylus information (pressure, tilt, altitude/azimuth) is already on\n * the standard `PointerEvent`. These helpers normalize the surface across\n * browsers, fill in sensible defaults for non-stylus inputs, and provide\n * a coalesced-event iterator so tools can opt into high-frequency samples\n * (Apple Pencil reports up to ~240Hz; most browsers coalesce those samples\n * into per-frame `pointermove` events whose intermediate states are only\n * accessible via `getCoalescedEvents()`).\n *\n * Apple-specific note: `pointerType: 'pen'` covers Apple Pencil on iPad\n * Safari. The barrel-double-tap (Pencil 2) and barrel-squeeze (Pencil\n * Pro) gestures are NOT exposed to web pages — they remain\n * UIKit-only via `UIPencilInteraction`.\n */\n\n/** Normalized snapshot of stylus state at a single pointer sample. */\nexport interface StylusData {\n  /** 0..1. Mouse and ordinary touch report 0 when no button is held and 0.5\n   *  while a button is held (per the Pointer Events spec). Stylus inputs\n   *  report a true pressure curve. */\n  pressure: number;\n  /** Tilt of the pen in degrees from the surface normal, projected onto the\n   *  X axis. Range ±90. Zero for mouse/touch. */\n  tiltX: number;\n  /** Tilt projected onto the Y axis. Range ±90. Zero for mouse/touch. */\n  tiltY: number;\n  /** Newer (Pointer Events level 3) angle in radians between the surface\n   *  and the pen barrel. π/2 = perpendicular to the surface. Undefined on\n   *  browsers that haven't shipped the field yet. */\n  altitudeAngle: number | undefined;\n  /** Newer angle in radians around the Z axis. Undefined on browsers\n   *  without level-3 support. */\n  azimuthAngle: number | undefined;\n  /** Rotation of the pen barrel in degrees. Apple Pencil Pro reports this\n   *  natively but Safari does NOT yet surface it via PointerEvent.twist —\n   *  expect 0 there. Some Wacom stylus drivers do report it. */\n  twist: number;\n  /** Raw pointerType from the event ('mouse' | 'pen' | 'touch' | ''). */\n  pointerType: string;\n  /** Convenience: `pointerType === 'pen'`. */\n  isStylus: boolean;\n}\n\n/** Options for `pressureToWidth`. */\nexport interface PressureToWidthOptions {\n  /** Width returned at pressure 0. Default 0.5. */\n  minWidth?: number;\n  /** Width returned at pressure 1. Default 6. */\n  maxWidth?: number;\n  /** Response curve exponent applied to pressure before lerping\n   *  (`p ** gamma`). 1 = linear; >1 emphasizes light touches (sharper\n   *  thin → thick transition); <1 emphasizes heavy touches. Default 1.6,\n   *  a small bias toward heavy strokes that matches typical pencil feel\n   *  without crushing the dynamic range. */\n  gamma?: number;\n}\n\n/**\n * Map a 0..1 pressure value to a stroke width.\n *\n * `width(p) = minWidth + (maxWidth - minWidth) × p^gamma`\n *\n * Mouse / non-stylus inputs report `pressure === 0` (no button) or `0.5`\n * (button held); callers that don't want uniform 0.5-pressure widths on\n * mouse input should gate on `pointerType === 'pen'` upstream and feed a\n * constant width on the non-stylus path.\n */\nexport function pressureToWidth(\n  pressure: number,\n  options: PressureToWidthOptions = {},\n): number {\n  const minWidth = options.minWidth ?? 0.5;\n  const maxWidth = options.maxWidth ?? 6;\n  const gamma = options.gamma ?? 1.6;\n  const p = Math.max(0, Math.min(1, pressure));\n  const shaped = p ** gamma;\n  return minWidth + (maxWidth - minWidth) * shaped;\n}\n\n/** Extract a normalized stylus snapshot from any PointerEvent. Pure. */\nexport function getStylusData(e: PointerEvent): StylusData {\n  // `altitudeAngle` / `azimuthAngle` are Pointer Events level 3 — only\n  // present in newer browsers. Read defensively so the helper degrades\n  // gracefully on older runtimes.\n  const ext = e as PointerEvent & {\n    altitudeAngle?: number;\n    azimuthAngle?: number;\n  };\n  const pointerType = e.pointerType ?? '';\n  return {\n    pressure: e.pressure,\n    tiltX: e.tiltX ?? 0,\n    tiltY: e.tiltY ?? 0,\n    altitudeAngle: typeof ext.altitudeAngle === 'number' ? ext.altitudeAngle : undefined,\n    azimuthAngle: typeof ext.azimuthAngle === 'number' ? ext.azimuthAngle : undefined,\n    twist: e.twist ?? 0,\n    pointerType,\n    isStylus: pointerType === 'pen',\n  };\n}\n\n/** One enriched sample, ready for tools that want world coords + stylus\n *  data at every coalesced sub-frame. */\nexport interface PointerSample {\n  /** Client coords (relative to viewport). */\n  clientX: number;\n  clientY: number;\n  /** Canvas-relative CSS pixels. */\n  screenX: number;\n  screenY: number;\n  /** World coords, derived from `screenX/Y` via the supplied view. */\n  worldX: number;\n  worldY: number;\n  /** Stylus snapshot for this sample. */\n  stylus: StylusData;\n  /** Original event (may be the parent move or a coalesced sub-event). */\n  event: PointerEvent;\n}\n\n/** Context for `forEachCoalesced` — the kit's `ToolCtx` satisfies this. */\nexport interface CoalescedCtx {\n  canvasRect: { left: number; top: number };\n  view: { x: number; y: number; scale: { x: number; y: number } };\n}\n\n/**\n * Iterate coalesced sub-events of a `pointermove`, yielding a\n * `PointerSample` per sub-event with world coords already derived.\n *\n * Browsers that batch high-frequency samples (Apple Pencil, drawing\n * tablets) expose them through `event.getCoalescedEvents()`. Pen / pencil\n * tools should iterate them for smooth strokes; mouse tools usually only\n * need the parent event and can ignore this.\n *\n * Fallback: when `getCoalescedEvents` is unavailable or returns an empty\n * list, the parent event itself is yielded once so callers don't drop\n * samples on older browsers.\n */\nexport function forEachCoalesced(\n  event: PointerEvent,\n  ctx: CoalescedCtx,\n  cb: (sample: PointerSample) => void,\n): void {\n  // Cast through unknown — older lib.dom.d.ts in some toolchains omits the\n  // method even though every modern engine ships it.\n  const get = (event as unknown as { getCoalescedEvents?: () => PointerEvent[] })\n    .getCoalescedEvents;\n  const sub = typeof get === 'function' ? get.call(event) : [];\n  const list = sub.length > 0 ? sub : [event];\n  for (const e of list) {\n    const [screenX, screenY] = [e.clientX - ctx.canvasRect.left, e.clientY - ctx.canvasRect.top];\n    const [worldX, worldY] = clientToWorld(e.clientX, e.clientY, ctx.canvasRect, ctx.view);\n    cb({\n      clientX: e.clientX,\n      clientY: e.clientY,\n      screenX,\n      screenY,\n      worldX,\n      worldY,\n      stylus: getStylusData(e),\n      event: e,\n    });\n  }\n}\n"],"mappings":";;AAsEA,SAAgBA,EACd,GACA,IAAkC,CAAC,GAC3B;CACR,IAAMC,IAAWC,EAAQ,YAAY,IAC/BC,IAAWD,EAAQ,YAAY,GAC/BE,IAAQF,EAAQ,SAAS,KAEzBG,IADI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGC,CAAQ,CAC3B,KAAKF;CACpB,OAAOH,KAAYE,IAAWF,KAAYI;AAC5C;AAGA,SAAgBE,EAAc,GAA6B;CAIzD,IAAMC,IAAM,GAINC,IAAc,EAAE,eAAe;CACrC,OAAO;EACL,UAAU,EAAE;EACZ,OAAO,EAAE,SAAS;EAClB,OAAO,EAAE,SAAS;EAClB,eAAe,OAAOD,EAAI,iBAAkB,WAAWA,EAAI,gBAAgB,KAAA;EAC3E,cAAc,OAAOA,EAAI,gBAAiB,WAAWA,EAAI,eAAe,KAAA;EACxE,OAAO,EAAE,SAAS;EAClB;EACA,UAAUC,MAAgB;CAC5B;AACF;AAuCA,SAAgBC,EACd,GACA,GACA,GACM;CAGN,IAAMC,IAAOC,EACV,oBACGC,IAAM,OAAOF,KAAQ,aAAaA,EAAI,KAAKC,CAAK,IAAI,CAAC,GACrDE,IAAOD,EAAI,SAAS,IAAIA,IAAM,CAACD,CAAK;CAC1C,KAAK,IAAMG,KAAKD,GAAM;EACpB,IAAM,CAACE,GAASC,KAAW,CAACF,EAAE,UAAUG,EAAI,WAAW,MAAMH,EAAE,UAAUG,EAAI,WAAW,GAAG,GACrF,CAACC,GAAQC,KAAUC,EAAcN,EAAE,SAASA,EAAE,SAASG,EAAI,YAAYA,EAAI,IAAI;EACrF,EAAG;GACD,SAASH,EAAE;GACX,SAASA,EAAE;GACX;GACA;GACA;GACA;GACA,QAAQR,EAAcQ,CAAC;GACvB,OAAOA;EACT,CAAC;CACH;AACF"}
+{"version":3,"file":"stylus.js","names":["pressureToWidth","minWidth","options","maxWidth","gamma","shaped","pressure","getStylusData","ext","pointerType","forEachCoalesced","get","event","sub","list","e","screenX","screenY","ctx","worldX","worldY","clientToWorld"],"sources":["../../../src/core/stylus/stylus.ts"],"sourcesContent":["import { clientToWorld } from 'core/viewport/clientToWorld';\n/**\n * Stylus / Pencil pointer-event helpers.\n *\n * These normalize the standard `PointerEvent` stylus fields across browsers,\n * fill in defaults for non-stylus inputs, and provide a coalesced-event\n * iterator for high-frequency samples.\n *\n * `pointerType: 'pen'` covers Apple Pencil on iPad Safari. The\n * barrel-double-tap (Pencil 2) and barrel-squeeze (Pencil Pro) gestures are\n * NOT exposed to web pages.\n */\n\n/** Normalized snapshot of stylus state at a single pointer sample. */\nexport interface StylusData {\n  /** 0..1. Mouse and ordinary touch report 0 when no button is held and 0.5\n   *  while a button is held (per the Pointer Events spec). Stylus inputs\n   *  report a true pressure curve. */\n  pressure: number;\n  /** Tilt of the pen in degrees from the surface normal, projected onto the\n   *  X axis. Range ±90. Zero for mouse/touch. */\n  tiltX: number;\n  /** Tilt projected onto the Y axis. Range ±90. Zero for mouse/touch. */\n  tiltY: number;\n  /** Newer (Pointer Events level 3) angle in radians between the surface\n   *  and the pen barrel. π/2 = perpendicular to the surface. Undefined on\n   *  browsers that haven't shipped the field yet. */\n  altitudeAngle: number | undefined;\n  /** Newer angle in radians around the Z axis. Undefined on browsers\n   *  without level-3 support. */\n  azimuthAngle: number | undefined;\n  /** Rotation of the pen barrel in degrees. Apple Pencil Pro reports this\n   *  natively but Safari does NOT yet surface it via PointerEvent.twist —\n   *  expect 0 there. Some Wacom stylus drivers do report it. */\n  twist: number;\n  /** Raw pointerType from the event ('mouse' | 'pen' | 'touch' | ''). */\n  pointerType: string;\n  /** Convenience: `pointerType === 'pen'`. */\n  isStylus: boolean;\n}\n\n/** Options for `pressureToWidth`. */\nexport interface PressureToWidthOptions {\n  /** Width returned at pressure 0. Default 0.5. */\n  minWidth?: number;\n  /** Width returned at pressure 1. Default 6. */\n  maxWidth?: number;\n  /** Response curve exponent applied to pressure before lerping\n   *  (`p ** gamma`). 1 = linear. Default 1.6. */\n  gamma?: number;\n}\n\n/**\n * Map a 0..1 pressure value to a stroke width.\n *\n * `width(p) = minWidth + (maxWidth - minWidth) × p^gamma`\n *\n * Mouse / non-stylus inputs report `pressure === 0` (no button) or `0.5`\n * (button held); gate on `pointerType === 'pen'` upstream to give them a\n * constant width instead.\n */\nexport function pressureToWidth(\n  pressure: number,\n  options: PressureToWidthOptions = {},\n): number {\n  const minWidth = options.minWidth ?? 0.5;\n  const maxWidth = options.maxWidth ?? 6;\n  const gamma = options.gamma ?? 1.6;\n  const p = Math.max(0, Math.min(1, pressure));\n  const shaped = p ** gamma;\n  return minWidth + (maxWidth - minWidth) * shaped;\n}\n\n/** Extract a normalized stylus snapshot from any PointerEvent. Pure. */\nexport function getStylusData(e: PointerEvent): StylusData {\n  const ext = e as PointerEvent & {\n    altitudeAngle?: number;\n    azimuthAngle?: number;\n  };\n  const pointerType = e.pointerType ?? '';\n  return {\n    pressure: e.pressure,\n    tiltX: e.tiltX ?? 0,\n    tiltY: e.tiltY ?? 0,\n    altitudeAngle: typeof ext.altitudeAngle === 'number' ? ext.altitudeAngle : undefined,\n    azimuthAngle: typeof ext.azimuthAngle === 'number' ? ext.azimuthAngle : undefined,\n    twist: e.twist ?? 0,\n    pointerType,\n    isStylus: pointerType === 'pen',\n  };\n}\n\n/** One enriched sample, ready for tools that want world coords + stylus\n *  data at every coalesced sub-frame. */\nexport interface PointerSample {\n  /** Client coords (relative to viewport). */\n  clientX: number;\n  clientY: number;\n  /** Canvas-relative CSS pixels. */\n  screenX: number;\n  screenY: number;\n  /** World coords, derived from `screenX/Y` via the supplied view. */\n  worldX: number;\n  worldY: number;\n  /** Stylus snapshot for this sample. */\n  stylus: StylusData;\n  /** Original event (may be the parent move or a coalesced sub-event). */\n  event: PointerEvent;\n}\n\n/** Context for `forEachCoalesced`: the canvas's client rect and its view. */\nexport interface CoalescedCtx {\n  canvasRect: { left: number; top: number };\n  view: { x: number; y: number; scale: { x: number; y: number } };\n}\n\n/**\n * Iterate coalesced sub-events of a `pointermove`, yielding a\n * `PointerSample` per sub-event with world coords already derived. When\n * `getCoalescedEvents` is unavailable or returns an empty list, the parent\n * event itself is yielded once.\n */\nexport function forEachCoalesced(\n  event: PointerEvent,\n  ctx: CoalescedCtx,\n  cb: (sample: PointerSample) => void,\n): void {\n  // Cast through unknown — older lib.dom.d.ts in some toolchains omits the\n  // method even though every modern engine ships it.\n  const get = (event as unknown as { getCoalescedEvents?: () => PointerEvent[] })\n    .getCoalescedEvents;\n  const sub = typeof get === 'function' ? get.call(event) : [];\n  const list = sub.length > 0 ? sub : [event];\n  for (const e of list) {\n    const [screenX, screenY] = [e.clientX - ctx.canvasRect.left, e.clientY - ctx.canvasRect.top];\n    const [worldX, worldY] = clientToWorld(e.clientX, e.clientY, ctx.canvasRect, ctx.view);\n    cb({\n      clientX: e.clientX,\n      clientY: e.clientY,\n      screenX,\n      screenY,\n      worldX,\n      worldY,\n      stylus: getStylusData(e),\n      event: e,\n    });\n  }\n}\n"],"mappings":";;AA6DA,SAAgBA,EACd,GACA,IAAkC,CAAC,GAC3B;CACR,IAAMC,IAAWC,EAAQ,YAAY,IAC/BC,IAAWD,EAAQ,YAAY,GAC/BE,IAAQF,EAAQ,SAAS,KAEzBG,IADI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGC,CAAQ,CAC3B,KAAKF;CACpB,OAAOH,KAAYE,IAAWF,KAAYI;AAC5C;AAGA,SAAgBE,EAAc,GAA6B;CACzD,IAAMC,IAAM,GAINC,IAAc,EAAE,eAAe;CACrC,OAAO;EACL,UAAU,EAAE;EACZ,OAAO,EAAE,SAAS;EAClB,OAAO,EAAE,SAAS;EAClB,eAAe,OAAOD,EAAI,iBAAkB,WAAWA,EAAI,gBAAgB,KAAA;EAC3E,cAAc,OAAOA,EAAI,gBAAiB,WAAWA,EAAI,eAAe,KAAA;EACxE,OAAO,EAAE,SAAS;EAClB;EACA,UAAUC,MAAgB;CAC5B;AACF;AAgCA,SAAgBC,EACd,GACA,GACA,GACM;CAGN,IAAMC,IAAOC,EACV,oBACGC,IAAM,OAAOF,KAAQ,aAAaA,EAAI,KAAKC,CAAK,IAAI,CAAC,GACrDE,IAAOD,EAAI,SAAS,IAAIA,IAAM,CAACD,CAAK;CAC1C,KAAK,IAAMG,KAAKD,GAAM;EACpB,IAAM,CAACE,GAASC,KAAW,CAACF,EAAE,UAAUG,EAAI,WAAW,MAAMH,EAAE,UAAUG,EAAI,WAAW,GAAG,GACrF,CAACC,GAAQC,KAAUC,EAAcN,EAAE,SAASA,EAAE,SAASG,EAAI,YAAYA,EAAI,IAAI;EACrF,EAAG;GACD,SAASH,EAAE;GACX,SAASA,EAAE;GACX;GACA;GACA;GACA;GACA,QAAQR,EAAcQ,CAAC;GACvB,OAAOA;EACT,CAAC;CACH;AACF"}

package/dist/core/stylus/usePointerStylus.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePointerStylus.js","names":["IDLE","usePointerStylus","options","state","setState","useState","lastCommit","useRef","optsRef","useLatest","useEffect","el","target","onMove","e","raw","stylusOnly","now","minGap","maxFps","getStylusData","prev","onEnter","onLeave"],"sources":["../../../src/core/stylus/usePointerStylus.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { getStylusData, type StylusData } from './stylus';\n\n/** State exposed by `usePointerStylus` — the most recent stylus snapshot\n *  plus a `hovering` flag for the Pencil 2 / Pencil Pro \"near-surface but\n *  not touching\" event stream. */\nexport interface PointerStylusState extends StylusData {\n  /** True between `pointerenter` and `pointerleave` events on the target\n   *  element. iPad Safari fires these for Apple Pencil hover (on iPad Pro\n   *  / Pencil Pro), so this lights up when the pen is detected near the\n   *  glass without contact. */\n  hovering: boolean;\n}\n\nconst IDLE: PointerStylusState = {\n  pressure: 0,\n  tiltX: 0,\n  tiltY: 0,\n  altitudeAngle: undefined,\n  azimuthAngle: undefined,\n  twist: 0,\n  pointerType: '',\n  isStylus: false,\n  hovering: false,\n};\n\n/** Options for `usePointerStylus`. */\nexport interface UsePointerStylusOptions {\n  /** Throttle re-renders to ≈this many state updates per second. The latest\n   *  sample is always kept; intermediates are dropped. Default 60. Set to\n   *  `Infinity` (or 0) to emit every move. */\n  maxFps?: number;\n  /** When true, only emit updates while `pointerType === 'pen'`. Useful\n   *  for stylus-only UI that should freeze when the user reaches for a\n   *  mouse. Default false. */\n  stylusOnly?: boolean;\n}\n\n/**\n * Subscribe to pointer events on a target element (defaults to `window`)\n * and expose the most recent stylus snapshot.\n *\n * Reads pointer data via `pointermove` (button or no button) and tracks\n * `pointerenter` / `pointerleave` for the `hovering` flag. The hook does\n * NOT consume pointerdown / pointerup — leave gesture handling to the\n * Tool dispatcher.\n *\n * Re-renders are throttled by default to avoid storming the React scheduler\n * with 120–240Hz stylus updates. Consumers that need every sample (e.g.\n * recording for replay) should pass `maxFps: Infinity` and accept the\n * cost, or read a ref-backed snapshot in a `useFrame`-style loop instead.\n */\nexport function usePointerStylus(\n  target?: RefObject<HTMLElement | null> | HTMLElement | null,\n  options: UsePointerStylusOptions = {},\n): PointerStylusState {\n  const { maxFps = 60, stylusOnly = false } = options;\n  const [state, setState] = useState<PointerStylusState>(IDLE);\n  // Track the last commit time to throttle. A ref avoids re-creating the\n  // listener every render and avoids stale-closure read of an outer `let`.\n  const lastCommit = useRef(-Infinity);\n  const optsRef = useLatest({ maxFps, stylusOnly });\n\n  useEffect(() => {\n    const el: EventTarget =\n      target == null\n        ? window\n        : target instanceof HTMLElement\n          ? target\n          : target.current ?? window;\n\n    const onMove = (raw: Event) => {\n      const e = raw as PointerEvent;\n      const { maxFps, stylusOnly } = optsRef.current;\n      if (stylusOnly && e.pointerType !== 'pen') return;\n      const now = performance.now();\n      const minGap = maxFps > 0 && Number.isFinite(maxFps) ? 1000 / maxFps : 0;\n      if (minGap > 0 && now - lastCommit.current < minGap) return;\n      lastCommit.current = now;\n      setState((prev) => ({ ...getStylusData(e), hovering: prev.hovering }));\n    };\n    const onEnter = (raw: Event) => {\n      const e = raw as PointerEvent;\n      if (optsRef.current.stylusOnly && e.pointerType !== 'pen') return;\n      setState((prev) => ({ ...prev, hovering: true }));\n    };\n    const onLeave = (raw: Event) => {\n      const e = raw as PointerEvent;\n      if (optsRef.current.stylusOnly && e.pointerType !== 'pen') return;\n      setState((prev) => ({ ...prev, hovering: false }));\n    };\n\n    el.addEventListener('pointermove', onMove);\n    el.addEventListener('pointerenter', onEnter);\n    el.addEventListener('pointerleave', onLeave);\n    return () => {\n      el.removeEventListener('pointermove', onMove);\n      el.removeEventListener('pointerenter', onEnter);\n      el.removeEventListener('pointerleave', onLeave);\n    };\n  }, [target, optsRef]);\n\n  return state;\n}\n"],"mappings":";;;;AAeA,IAAMA,IAA2B;CAC/B,UAAU;CACV,OAAO;CACP,OAAO;CACP,eAAe,KAAA;CACf,cAAc,KAAA;CACd,OAAO;CACP,aAAa;CACb,UAAU;CACV,UAAU;AACZ;AA4BA,SAAgBC,EACd,GACA,IAAmC,CAAC,GAChB;CACpB,IAAM,EAAE,YAAS,IAAI,gBAAa,OAAUC,GACtC,CAACC,GAAOC,KAAYC,EAA6BL,CAAI,GAGrDM,IAAaC,EAAO,SAAS,GAC7BC,IAAUC,EAAU;EAAE;EAAQ;CAAW,CAAC;CAyChD,OAvCAC,QAAgB;EACd,IAAMC,IACJC,KAAU,OACN,SACAA,aAAkB,cAChBA,IACAA,EAAO,WAAW,QAEpBC,KAAU,MAAe;GAC7B,IAAMC,IAAIC,GACJ,EAAE,WAAQ,kBAAeP,EAAQ;GACvC,IAAIQ,KAAcF,EAAE,gBAAgB,OAAO;GAC3C,IAAMG,IAAM,YAAY,IAAI,GACtBC,IAASC,IAAS,KAAK,OAAO,SAASA,CAAM,IAAI,MAAOA,IAAS;GACvE,AAAID,IAAS,KAAKD,IAAMX,EAAW,UAAUY,MAC7C,EAAW,UAAUD,GACrBb,GAAU,OAAU;IAAE,GAAGgB,EAAcN,CAAC;IAAG,UAAUO,EAAK;GAAS,EAAE;EACvE,GACMC,KAAW,MAAe;GAC9B,IAAMR,IAAIC;GACV,AAAIP,EAAQ,QAAQ,cAAcM,EAAE,gBAAgB,SACpDV,GAAU,OAAU;IAAE,GAAGiB;IAAM,UAAU;GAAK,EAAE;EAClD,GACME,KAAW,MAAe;GAC9B,IAAMT,IAAIC;GACV,AAAIP,EAAQ,QAAQ,cAAcM,EAAE,gBAAgB,SACpDV,GAAU,OAAU;IAAE,GAAGiB;IAAM,UAAU;GAAM,EAAE;EACnD;EAKA,OAHAV,EAAG,iBAAiB,eAAeE,CAAM,GACzCF,EAAG,iBAAiB,gBAAgBW,CAAO,GAC3CX,EAAG,iBAAiB,gBAAgBY,CAAO,SAC9B;GAGX,AAFAZ,EAAG,oBAAoB,eAAeE,CAAM,GAC5CF,EAAG,oBAAoB,gBAAgBW,CAAO,GAC9CX,EAAG,oBAAoB,gBAAgBY,CAAO;EAChD;CACF,GAAG,CAACX,GAAQJ,CAAO,CAAC,GAEbL;AACT"}
+{"version":3,"file":"usePointerStylus.js","names":["IDLE","usePointerStylus","options","state","setState","useState","lastCommit","useRef","optsRef","useLatest","useEffect","el","target","onMove","e","raw","stylusOnly","now","minGap","maxFps","getStylusData","prev","onEnter","onLeave"],"sources":["../../../src/core/stylus/usePointerStylus.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { getStylusData, type StylusData } from './stylus';\n\n/** State exposed by `usePointerStylus` — the most recent stylus snapshot\n *  plus a `hovering` flag. */\nexport interface PointerStylusState extends StylusData {\n  /** True between `pointerenter` and `pointerleave` events on the target\n   *  element. iPad Safari fires these for Apple Pencil hover, so this is\n   *  true while the pen is near the glass without contact. */\n  hovering: boolean;\n}\n\nconst IDLE: PointerStylusState = {\n  pressure: 0,\n  tiltX: 0,\n  tiltY: 0,\n  altitudeAngle: undefined,\n  azimuthAngle: undefined,\n  twist: 0,\n  pointerType: '',\n  isStylus: false,\n  hovering: false,\n};\n\n/** Options for `usePointerStylus`. */\nexport interface UsePointerStylusOptions {\n  /** Throttle re-renders to ≈this many state updates per second. The latest\n   *  sample is always kept; intermediates are dropped. Default 60. Set to\n   *  `Infinity` (or 0) to emit every move. */\n  maxFps?: number;\n  /** When true, only emit updates while `pointerType === 'pen'`. Default\n   *  false. */\n  stylusOnly?: boolean;\n}\n\n/**\n * Subscribe to pointer events on a target element (defaults to `window`)\n * and expose the most recent stylus snapshot.\n *\n * The hook does NOT consume pointerdown / pointerup — leave gesture handling\n * to the dispatcher. Re-renders are throttled by default (`maxFps`); pass\n * `maxFps: Infinity` to get every sample.\n */\nexport function usePointerStylus(\n  target?: RefObject<HTMLElement | null> | HTMLElement | null,\n  options: UsePointerStylusOptions = {},\n): PointerStylusState {\n  const { maxFps = 60, stylusOnly = false } = options;\n  const [state, setState] = useState<PointerStylusState>(IDLE);\n  // Track the last commit time to throttle. A ref avoids re-creating the\n  // listener every render and avoids stale-closure read of an outer `let`.\n  const lastCommit = useRef(-Infinity);\n  const optsRef = useLatest({ maxFps, stylusOnly });\n\n  useEffect(() => {\n    const el: EventTarget =\n      target == null\n        ? window\n        : target instanceof HTMLElement\n          ? target\n          : target.current ?? window;\n\n    const onMove = (raw: Event) => {\n      const e = raw as PointerEvent;\n      const { maxFps, stylusOnly } = optsRef.current;\n      if (stylusOnly && e.pointerType !== 'pen') return;\n      const now = performance.now();\n      const minGap = maxFps > 0 && Number.isFinite(maxFps) ? 1000 / maxFps : 0;\n      if (minGap > 0 && now - lastCommit.current < minGap) return;\n      lastCommit.current = now;\n      setState((prev) => ({ ...getStylusData(e), hovering: prev.hovering }));\n    };\n    const onEnter = (raw: Event) => {\n      const e = raw as PointerEvent;\n      if (optsRef.current.stylusOnly && e.pointerType !== 'pen') return;\n      setState((prev) => ({ ...prev, hovering: true }));\n    };\n    const onLeave = (raw: Event) => {\n      const e = raw as PointerEvent;\n      if (optsRef.current.stylusOnly && e.pointerType !== 'pen') return;\n      setState((prev) => ({ ...prev, hovering: false }));\n    };\n\n    el.addEventListener('pointermove', onMove);\n    el.addEventListener('pointerenter', onEnter);\n    el.addEventListener('pointerleave', onLeave);\n    return () => {\n      el.removeEventListener('pointermove', onMove);\n      el.removeEventListener('pointerenter', onEnter);\n      el.removeEventListener('pointerleave', onLeave);\n    };\n  }, [target, optsRef]);\n\n  return state;\n}\n"],"mappings":";;;;AAaA,IAAMA,IAA2B;CAC/B,UAAU;CACV,OAAO;CACP,OAAO;CACP,eAAe,KAAA;CACf,cAAc,KAAA;CACd,OAAO;CACP,aAAa;CACb,UAAU;CACV,UAAU;AACZ;AAqBA,SAAgBC,EACd,GACA,IAAmC,CAAC,GAChB;CACpB,IAAM,EAAE,YAAS,IAAI,gBAAa,OAAUC,GACtC,CAACC,GAAOC,KAAYC,EAA6BL,CAAI,GAGrDM,IAAaC,EAAO,SAAS,GAC7BC,IAAUC,EAAU;EAAE;EAAQ;CAAW,CAAC;CAyChD,OAvCAC,QAAgB;EACd,IAAMC,IACJC,KAAU,OACN,SACAA,aAAkB,cAChBA,IACAA,EAAO,WAAW,QAEpBC,KAAU,MAAe;GAC7B,IAAMC,IAAIC,GACJ,EAAE,WAAQ,kBAAeP,EAAQ;GACvC,IAAIQ,KAAcF,EAAE,gBAAgB,OAAO;GAC3C,IAAMG,IAAM,YAAY,IAAI,GACtBC,IAASC,IAAS,KAAK,OAAO,SAASA,CAAM,IAAI,MAAOA,IAAS;GACvE,AAAID,IAAS,KAAKD,IAAMX,EAAW,UAAUY,MAC7C,EAAW,UAAUD,GACrBb,GAAU,OAAU;IAAE,GAAGgB,EAAcN,CAAC;IAAG,UAAUO,EAAK;GAAS,EAAE;EACvE,GACMC,KAAW,MAAe;GAC9B,IAAMR,IAAIC;GACV,AAAIP,EAAQ,QAAQ,cAAcM,EAAE,gBAAgB,SACpDV,GAAU,OAAU;IAAE,GAAGiB;IAAM,UAAU;GAAK,EAAE;EAClD,GACME,KAAW,MAAe;GAC9B,IAAMT,IAAIC;GACV,AAAIP,EAAQ,QAAQ,cAAcM,EAAE,gBAAgB,SACpDV,GAAU,OAAU;IAAE,GAAGiB;IAAM,UAAU;GAAM,EAAE;EACnD;EAKA,OAHAV,EAAG,iBAAiB,eAAeE,CAAM,GACzCF,EAAG,iBAAiB,gBAAgBW,CAAO,GAC3CX,EAAG,iBAAiB,gBAAgBY,CAAO,SAC9B;GAGX,AAFAZ,EAAG,oBAAoB,eAAeE,CAAM,GAC5CF,EAAG,oBAAoB,gBAAgBW,CAAO,GAC9CX,EAAG,oBAAoB,gBAAgBY,CAAO;EAChD;CACF,GAAG,CAACX,GAAQJ,CAAO,CAAC,GAEbL;AACT"}

package/dist/core/usePaintKinds.js

@@ -1,4 +1,4 @@
-import { getPaintKind as e, listGradientKinds as t, listPaintKinds as n, paintKindRegistry as r } from "./paintKinds.js";
+import { getPaintKind as e, listGradientKinds as t, listPaintKinds as n, paintKindRegistry as r } from "./paint/paintKinds.js";
 import { useCallback as i, useSyncExternalStore as a } from "react";
 //#region src/core/usePaintKinds.ts
 function o() {

package/dist/core/usePaintKinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePaintKinds.js","names":["usePaintKinds","useSyncExternalStore","paintKindRegistry","listPaintKinds","useGradientKinds","listGradientKinds","usePaintKind","read","useCallback","getPaintKind","kind"],"sources":["../../src/core/usePaintKinds.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport {\n  getPaintKind, listGradientKinds, listPaintKinds, paintKindRegistry, type PaintKindEntry,\n} from './paintKinds';\n\n/** Every registered paint kind, as {@link listPaintKinds} returns it,\n *  re-rendering the caller whenever a kind is registered or removed. */\nexport function usePaintKinds(): readonly PaintKindEntry[] {\n  return useSyncExternalStore(paintKindRegistry.subscribe, listPaintKinds, listPaintKinds);\n}\n\n/** Every registered gradient kind, as {@link listGradientKinds} returns it,\n *  re-rendering the caller whenever a kind is registered or removed. */\nexport function useGradientKinds(): readonly PaintKindEntry[] {\n  return useSyncExternalStore(paintKindRegistry.subscribe, listGradientKinds, listGradientKinds);\n}\n\n/**\n * The entry for `kind`, as {@link getPaintKind} returns it — `undefined` until\n * it is registered, and the new entry once it is. A kind with a loader starts\n * loading on the first read.\n */\nexport function usePaintKind(kind: string | undefined): PaintKindEntry | undefined {\n  const read = useCallback(() => getPaintKind(kind), [kind]);\n  return useSyncExternalStore(paintKindRegistry.subscribe, read, read);\n}\n"],"mappings":";;;AAOA,SAAgBA,IAA2C;CACzD,OAAOC,EAAqBC,EAAkB,WAAWC,GAAgBA,CAAc;AACzF;AAIA,SAAgBC,IAA8C;CAC5D,OAAOH,EAAqBC,EAAkB,WAAWG,GAAmBA,CAAiB;AAC/F;AAOA,SAAgBC,EAAa,GAAsD;CACjF,IAAMC,IAAOC,QAAkBC,EAAaC,CAAI,GAAG,CAACA,CAAI,CAAC;CACzD,OAAOT,EAAqBC,EAAkB,WAAWK,GAAMA,CAAI;AACrE"}
+{"version":3,"file":"usePaintKinds.js","names":["usePaintKinds","useSyncExternalStore","paintKindRegistry","listPaintKinds","useGradientKinds","listGradientKinds","usePaintKind","read","useCallback","getPaintKind","kind"],"sources":["../../src/core/usePaintKinds.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport {\n  getPaintKind, listGradientKinds, listPaintKinds, paintKindRegistry,\n} from 'core/paint/paintKinds';\nimport type { PaintKindEntry } from 'core/paint/paintKindEntry';\n\n/** Every registered paint kind, as {@link listPaintKinds} returns it,\n *  re-rendering the caller whenever a kind is registered or removed. */\nexport function usePaintKinds(): readonly PaintKindEntry[] {\n  return useSyncExternalStore(paintKindRegistry.subscribe, listPaintKinds, listPaintKinds);\n}\n\n/** Every registered gradient kind, as {@link listGradientKinds} returns it,\n *  re-rendering the caller whenever a kind is registered or removed. */\nexport function useGradientKinds(): readonly PaintKindEntry[] {\n  return useSyncExternalStore(paintKindRegistry.subscribe, listGradientKinds, listGradientKinds);\n}\n\n/**\n * The entry for `kind`, as {@link getPaintKind} returns it — `undefined` until\n * it is registered, and the new entry once it is. A kind with a loader starts\n * loading on the first read.\n */\nexport function usePaintKind(kind: string | undefined): PaintKindEntry | undefined {\n  const read = useCallback(() => getPaintKind(kind), [kind]);\n  return useSyncExternalStore(paintKindRegistry.subscribe, read, read);\n}\n"],"mappings":";;;AAQA,SAAgBA,IAA2C;CACzD,OAAOC,EAAqBC,EAAkB,WAAWC,GAAgBA,CAAc;AACzF;AAIA,SAAgBC,IAA8C;CAC5D,OAAOH,EAAqBC,EAAkB,WAAWG,GAAmBA,CAAiB;AAC/F;AAOA,SAAgBC,EAAa,GAAsD;CACjF,IAAMC,IAAOC,QAAkBC,EAAaC,CAAI,GAAG,CAACA,CAAI,CAAC;CACzD,OAAOT,EAAqBC,EAAkB,WAAWK,GAAMA,CAAI;AACrE"}

package/dist/core/viewport/clientToWorld.js.map

@@ -1 +1 @@
-{"version":3,"file":"clientToWorld.js","names":["clientToWorld","clientX","origin","view","clientY"],"sources":["../../../src/core/viewport/clientToWorld.ts"],"sourcesContent":["/**\n * Convert client coords directly to world coords by subtracting the canvas\n * rect origin and then applying the inverse view transform.\n *\n * This is the composition of `clientToCanvas` + the view-inverse half of\n * `screenToWorld`, but expressed against the `ViewLike` shape used by\n * `SceneCanvas` / `ToolCtx` (`{ scale: { x, y }, x, y }`) rather than the\n * `ViewTransform` shape used by `screenToWorld` (`{ panX, panY, zoom }`).\n */\nexport interface ViewLike {\n  scale: { x: number; y: number };\n  x: number;\n  y: number;\n}\n\n/**\n * Map a browser client coord pair to world coords.\n *\n * @param clientX  - `event.clientX`\n * @param clientY  - `event.clientY`\n * @param origin   - client-space origin of the surface `view` is a camera on.\n *   For a whole canvas that is its bounding rect. For a viewport node it is\n *   the canvas rect offset by the viewport's own rect, so the same call maps\n *   into that viewport's inner world.\n * @param view     - current viewport transform\n */\nexport function clientToWorld(\n  clientX: number,\n  clientY: number,\n  origin: { left: number; top: number },\n  view: ViewLike,\n): [number, number] {\n  return [\n    (clientX - origin.left) / view.scale.x + view.x,\n    (clientY - origin.top) / view.scale.y + view.y,\n  ];\n}\n"],"mappings":";AA0BA,SAAgBA,EACd,GACA,GACA,GACA,GACkB;CAClB,OAAO,EACJC,IAAUC,EAAO,QAAQC,EAAK,MAAM,IAAIA,EAAK,IAC7CC,IAAUF,EAAO,OAAOC,EAAK,MAAM,IAAIA,EAAK,CAC/C;AACF"}
+{"version":3,"file":"clientToWorld.js","names":["clientToWorld","clientX","origin","view","clientY"],"sources":["../../../src/core/viewport/clientToWorld.ts"],"sourcesContent":["/**\n * Convert client coords directly to world coords by subtracting the canvas\n * rect origin and then applying the inverse view transform.\n *\n * This is the composition of `clientToCanvas` + the view-inverse half of\n * `screenToWorld`, but expressed against the `ViewLike` shape used by\n * `SceneCanvas` (`{ scale: { x, y }, x, y }`) rather than the\n * `ViewTransform` shape used by `screenToWorld` (`{ panX, panY, zoom }`).\n */\nexport interface ViewLike {\n  scale: { x: number; y: number };\n  x: number;\n  y: number;\n}\n\n/**\n * Map a browser client coord pair to world coords.\n *\n * @param clientX  - `event.clientX`\n * @param clientY  - `event.clientY`\n * @param origin   - client-space origin of the surface `view` is a camera on.\n *   For a whole canvas that is its bounding rect. For a viewport node it is\n *   the canvas rect offset by the viewport's own rect, so the same call maps\n *   into that viewport's inner world.\n * @param view     - current viewport transform\n */\nexport function clientToWorld(\n  clientX: number,\n  clientY: number,\n  origin: { left: number; top: number },\n  view: ViewLike,\n): [number, number] {\n  return [\n    (clientX - origin.left) / view.scale.x + view.x,\n    (clientY - origin.top) / view.scale.y + view.y,\n  ];\n}\n"],"mappings":";AA0BA,SAAgBA,EACd,GACA,GACA,GACA,GACkB;CAClB,OAAO,EACJC,IAAUC,EAAO,QAAQC,EAAK,MAAM,IAAIA,EAAK,IAC7CC,IAAUF,EAAO,OAAOC,EAAK,MAAM,IAAIA,EAAK,CAC/C;AACF"}

package/dist/core/viewport/fitViewToBounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"fitViewToBounds.js","names":["fitViewToBounds","DEFAULT_MAX_ZOOM","DEFAULT_MIN_ZOOM","opts","bounds","currentView","viewportDims","availW","padding","availH","sx","sy","rawX","rawY","u","scaleX","normalizeZoom","maxScale","minScale","scaleY","place","size","scale","avail","start","viewport"],"sources":["../../../src/core/viewport/fitViewToBounds.ts"],"sourcesContent":["import type { View } from './view';\nimport { DEFAULT_MIN_ZOOM, DEFAULT_MAX_ZOOM, normalizeZoom } from './zoomBounds';\n\n/** `Bounds` is declared in `@weasel-js/routing`, which is typed in it\n *  throughout — every area-select, resize and preview surface names one.\n *  Re-exported here, where core's call sites have always looked. */\nimport type { Bounds } from '@weasel-js/routing';\nexport type { Bounds };\n\n/** Pixel dimensions of the canvas viewport. */\nexport interface ViewportDims {\n  width: number;\n  height: number;\n}\n\n/** Options for {@link fitViewToBounds}. */\nexport interface FitViewToBoundsOptions {\n  /** Inset (in CSS px) around the bounds. Default 16. */\n  padding?: number;\n  /**\n   * Override the kit's system max scale. Defaults to the kit-wide max zoom\n   * used by `computeWheelAction` (`DEFAULT_MAX_ZOOM`).\n   */\n  maxScale?: number;\n  /**\n   * Override the kit's system min scale. Defaults to the kit-wide min zoom\n   * used by `computeWheelAction` (`DEFAULT_MIN_ZOOM`).\n   */\n  minScale?: number;\n  /**\n   * Fit mode:\n   * - `'contain'` (default): uniform scale = `min(availW/w, availH/h)`. Bounds fit entirely; one axis has letterboxing.\n   * - `'fill'`: uniform scale = `max(...)`. Bounds overflow viewport on one axis.\n   * - `'stretch'`: per-axis scale. Bounds match viewport exactly; scale is non-uniform.\n   */\n  mode?: 'contain' | 'fill' | 'stretch';\n  /**\n   * Where bounds that overflow the viewport on an axis sit, which happens when\n   * `minScale` stops the fit or `mode` is `'fill'`. `'center'` (default) shows\n   * their middle; `'start'` shows their left or top edge, inset by `padding`.\n   * An axis that fits is centered either way.\n   */\n  anchor?: 'center' | 'start';\n}\n\n/**\n * Compute the target {@link View} that fits `bounds` (world space) inside\n * `viewportDims` (CSS px). The bounds are centered in the viewport with\n * uniform padding on all sides; the resulting scale is clamped to the\n * configured min/max.\n *\n * View semantics: `view.x` / `view.y` is the world point currently drawn at\n * the canvas top-left, and `view.scale.{x,y}` is pixels per world unit on\n * each axis (see `view.ts`). So:\n *   screenX = (worldX - view.x) * view.scale.x\n *   screenY = (worldY - view.y) * view.scale.y\n *\n * Empty / zero-sized bounds or viewports cannot be fit — in that case this\n * returns `currentView` unchanged and logs a `console.warn`. Callers that\n * want to no-op silently can detect zero area themselves before calling.\n */\nexport function fitViewToBounds(\n  bounds: Bounds,\n  viewportDims: ViewportDims,\n  currentView: View,\n  opts: FitViewToBoundsOptions = {},\n): View {\n  const { padding = 16, maxScale = DEFAULT_MAX_ZOOM, minScale = DEFAULT_MIN_ZOOM } = opts;\n\n  if (bounds.width <= 0 || bounds.height <= 0) {\n    console.warn('[weasel] fitViewToBounds: bounds has zero or negative area; returning currentView unchanged.', bounds);\n    return currentView;\n  }\n  if (viewportDims.width <= 0 || viewportDims.height <= 0) {\n    console.warn('[weasel] fitViewToBounds: viewport has zero or negative area; returning currentView unchanged.', viewportDims);\n    return currentView;\n  }\n\n  const availW = Math.max(1, viewportDims.width - padding * 2);\n  const availH = Math.max(1, viewportDims.height - padding * 2);\n  const sx = availW / bounds.width;\n  const sy = availH / bounds.height;\n\n  let rawX: number;\n  let rawY: number;\n  switch (opts.mode ?? 'contain') {\n    case 'fill': {\n      const u = Math.max(sx, sy);\n      rawX = u;\n      rawY = u;\n      break;\n    }\n    case 'stretch':\n      rawX = sx;\n      rawY = sy;\n      break;\n    case 'contain':\n    default: {\n      const u = Math.min(sx, sy);\n      rawX = u;\n      rawY = u;\n      break;\n    }\n  }\n  const scaleX = normalizeZoom(Math.min(maxScale, Math.max(minScale, rawX)));\n  const scaleY = normalizeZoom(Math.min(maxScale, Math.max(minScale, rawY)));\n\n  // Center bounds in the viewport. With view-as-camera semantics:\n  //   screenCenter = (worldCenter - view.x) * scale\n  //   view.x = worldCenter - viewportCenter / scale\n  const place = (start: number, size: number, avail: number, viewport: number, scale: number) =>\n    opts.anchor === 'start' && size * scale > avail + 1e-9\n      ? start - padding / scale\n      : start + size / 2 - viewport / (2 * scale);\n  return {\n    x: place(bounds.x, bounds.width, availW, viewportDims.width, scaleX),\n    y: place(bounds.y, bounds.height, availH, viewportDims.height, scaleY),\n    scale: { x: scaleX, y: scaleY },\n  };\n}\n"],"mappings":";;AA6DA,SAAgBA,EACd,GACA,GACA,GACA,IAA+B,CAAC,GAC1B;CACN,IAAM,EAAE,aAAU,IAAI,cAAWC,GAAkB,cAAWC,MAAqBC;CAEnF,IAAIC,EAAO,SAAS,KAAKA,EAAO,UAAU,GAExC,OADA,QAAQ,KAAK,gGAAgGA,CAAM,GAC5GC;CAET,IAAIC,EAAa,SAAS,KAAKA,EAAa,UAAU,GAEpD,OADA,QAAQ,KAAK,kGAAkGA,CAAY,GACpHD;CAGT,IAAME,IAAS,KAAK,IAAI,GAAGD,EAAa,QAAQE,IAAU,CAAC,GACrDC,IAAS,KAAK,IAAI,GAAGH,EAAa,SAASE,IAAU,CAAC,GACtDE,IAAKH,IAASH,EAAO,OACrBO,IAAKF,IAASL,EAAO,QAEvBQ,GACAC;CACJ,QAAQV,EAAK,QAAQ,WAArB;EACE,KAAK,QAAQ;GACX,IAAMW,IAAI,KAAK,IAAIJ,GAAIC,CAAE;GAEzB,AADA,IAAOG,GACP,IAAOA;GACP;EACF;EACA,KAAK;GAEH,AADA,IAAOJ,GACP,IAAOC;GACP;EAEF,SAAS;GACP,IAAMG,IAAI,KAAK,IAAIJ,GAAIC,CAAE;GAEzB,AADA,IAAOG,GACP,IAAOA;GACP;EACF;CACF;CACA,IAAMC,IAASC,EAAc,KAAK,IAAIC,GAAU,KAAK,IAAIC,GAAUN,CAAI,CAAC,CAAC,GACnEO,IAASH,EAAc,KAAK,IAAIC,GAAU,KAAK,IAAIC,GAAUL,CAAI,CAAC,CAAC,GAKnEO,KAAS,GAAe,GAAc,GAAe,GAAkB,MAC3EjB,EAAK,WAAW,WAAWkB,IAAOC,IAAQC,IAAQ,OAC9CC,IAAQhB,IAAUc,IAClBE,IAAQH,IAAO,IAAII,KAAY,IAAIH;CACzC,OAAO;EACL,GAAGF,EAAMhB,EAAO,GAAGA,EAAO,OAAOG,GAAQD,EAAa,OAAOS,CAAM;EACnE,GAAGK,EAAMhB,EAAO,GAAGA,EAAO,QAAQK,GAAQH,EAAa,QAAQa,CAAM;EACrE,OAAO;GAAE,GAAGJ;GAAQ,GAAGI;EAAO;CAChC;AACF"}
+{"version":3,"file":"fitViewToBounds.js","names":["fitViewToBounds","DEFAULT_MAX_ZOOM","DEFAULT_MIN_ZOOM","opts","bounds","currentView","viewportDims","availW","padding","availH","sx","sy","rawX","rawY","u","scaleX","normalizeZoom","maxScale","minScale","scaleY","place","size","scale","avail","start","viewport"],"sources":["../../../src/core/viewport/fitViewToBounds.ts"],"sourcesContent":["import type { View } from './view';\nimport { DEFAULT_MIN_ZOOM, DEFAULT_MAX_ZOOM, normalizeZoom } from './zoomBounds';\n\nimport type { Bounds } from '@weasel-js/routing';\nexport type { Bounds };\n\n/** Pixel dimensions of the canvas viewport. */\nexport interface ViewportDims {\n  width: number;\n  height: number;\n}\n\n/** Options for {@link fitViewToBounds}. */\nexport interface FitViewToBoundsOptions {\n  /** Inset (in CSS px) around the bounds. Default 16. */\n  padding?: number;\n  /** Defaults to the kit-wide max zoom (`DEFAULT_MAX_ZOOM`). */\n  maxScale?: number;\n  /** Defaults to the kit-wide min zoom (`DEFAULT_MIN_ZOOM`). */\n  minScale?: number;\n  /**\n   * Fit mode:\n   * - `'contain'` (default): uniform scale = `min(availW/w, availH/h)`. Bounds fit entirely; one axis has letterboxing.\n   * - `'fill'`: uniform scale = `max(...)`. Bounds overflow viewport on one axis.\n   * - `'stretch'`: per-axis scale. Bounds match viewport exactly; scale is non-uniform.\n   */\n  mode?: 'contain' | 'fill' | 'stretch';\n  /**\n   * Where bounds that overflow the viewport on an axis sit, which happens when\n   * `minScale` stops the fit or `mode` is `'fill'`. `'center'` (default) shows\n   * their middle; `'start'` shows their left or top edge, inset by `padding`.\n   * An axis that fits is centered either way.\n   */\n  anchor?: 'center' | 'start';\n}\n\n/**\n * Compute the target {@link View} that fits `bounds` (world space) inside\n * `viewportDims` (CSS px). The bounds are centered in the viewport with\n * uniform padding on all sides; the resulting scale is clamped to the\n * configured min/max.\n *\n * Empty / zero-sized bounds or viewports cannot be fit — in that case this\n * returns `currentView` unchanged and logs a `console.warn`.\n */\nexport function fitViewToBounds(\n  bounds: Bounds,\n  viewportDims: ViewportDims,\n  currentView: View,\n  opts: FitViewToBoundsOptions = {},\n): View {\n  const { padding = 16, maxScale = DEFAULT_MAX_ZOOM, minScale = DEFAULT_MIN_ZOOM } = opts;\n\n  if (bounds.width <= 0 || bounds.height <= 0) {\n    console.warn('[weasel] fitViewToBounds: bounds has zero or negative area; returning currentView unchanged.', bounds);\n    return currentView;\n  }\n  if (viewportDims.width <= 0 || viewportDims.height <= 0) {\n    console.warn('[weasel] fitViewToBounds: viewport has zero or negative area; returning currentView unchanged.', viewportDims);\n    return currentView;\n  }\n\n  const availW = Math.max(1, viewportDims.width - padding * 2);\n  const availH = Math.max(1, viewportDims.height - padding * 2);\n  const sx = availW / bounds.width;\n  const sy = availH / bounds.height;\n\n  let rawX: number;\n  let rawY: number;\n  switch (opts.mode ?? 'contain') {\n    case 'fill': {\n      const u = Math.max(sx, sy);\n      rawX = u;\n      rawY = u;\n      break;\n    }\n    case 'stretch':\n      rawX = sx;\n      rawY = sy;\n      break;\n    case 'contain':\n    default: {\n      const u = Math.min(sx, sy);\n      rawX = u;\n      rawY = u;\n      break;\n    }\n  }\n  const scaleX = normalizeZoom(Math.min(maxScale, Math.max(minScale, rawX)));\n  const scaleY = normalizeZoom(Math.min(maxScale, Math.max(minScale, rawY)));\n\n  // screenCenter = (worldCenter - view.x) * scale, solved for view.x.\n  const place = (start: number, size: number, avail: number, viewport: number, scale: number) =>\n    opts.anchor === 'start' && size * scale > avail + 1e-9\n      ? start - padding / scale\n      : start + size / 2 - viewport / (2 * scale);\n  return {\n    x: place(bounds.x, bounds.width, availW, viewportDims.width, scaleX),\n    y: place(bounds.y, bounds.height, availH, viewportDims.height, scaleY),\n    scale: { x: scaleX, y: scaleY },\n  };\n}\n"],"mappings":";;AA6CA,SAAgBA,EACd,GACA,GACA,GACA,IAA+B,CAAC,GAC1B;CACN,IAAM,EAAE,aAAU,IAAI,cAAWC,GAAkB,cAAWC,MAAqBC;CAEnF,IAAIC,EAAO,SAAS,KAAKA,EAAO,UAAU,GAExC,OADA,QAAQ,KAAK,gGAAgGA,CAAM,GAC5GC;CAET,IAAIC,EAAa,SAAS,KAAKA,EAAa,UAAU,GAEpD,OADA,QAAQ,KAAK,kGAAkGA,CAAY,GACpHD;CAGT,IAAME,IAAS,KAAK,IAAI,GAAGD,EAAa,QAAQE,IAAU,CAAC,GACrDC,IAAS,KAAK,IAAI,GAAGH,EAAa,SAASE,IAAU,CAAC,GACtDE,IAAKH,IAASH,EAAO,OACrBO,IAAKF,IAASL,EAAO,QAEvBQ,GACAC;CACJ,QAAQV,EAAK,QAAQ,WAArB;EACE,KAAK,QAAQ;GACX,IAAMW,IAAI,KAAK,IAAIJ,GAAIC,CAAE;GAEzB,AADA,IAAOG,GACP,IAAOA;GACP;EACF;EACA,KAAK;GAEH,AADA,IAAOJ,GACP,IAAOC;GACP;EAEF,SAAS;GACP,IAAMG,IAAI,KAAK,IAAIJ,GAAIC,CAAE;GAEzB,AADA,IAAOG,GACP,IAAOA;GACP;EACF;CACF;CACA,IAAMC,IAASC,EAAc,KAAK,IAAIC,GAAU,KAAK,IAAIC,GAAUN,CAAI,CAAC,CAAC,GACnEO,IAASH,EAAc,KAAK,IAAIC,GAAU,KAAK,IAAIC,GAAUL,CAAI,CAAC,CAAC,GAGnEO,KAAS,GAAe,GAAc,GAAe,GAAkB,MAC3EjB,EAAK,WAAW,WAAWkB,IAAOC,IAAQC,IAAQ,OAC9CC,IAAQhB,IAAUc,IAClBE,IAAQH,IAAO,IAAII,KAAY,IAAIH;CACzC,OAAO;EACL,GAAGF,EAAMhB,EAAO,GAAGA,EAAO,OAAOG,GAAQD,EAAa,OAAOS,CAAM;EACnE,GAAGK,EAAMhB,EAAO,GAAGA,EAAO,QAAQK,GAAQH,EAAa,QAAQa,CAAM;EACrE,OAAO;GAAE,GAAGJ;GAAQ,GAAGI;EAAO;CAChC;AACF"}

package/dist/core/viewport/parallax.js.map

@@ -1 +1 @@
-{"version":3,"file":"parallax.js","names":["asXY","v","deriveParallaxView","p","opts","z","outer","planeMap","inner","kx","ky","toPlane","m","fromPlane","mapRect","a","map","r","b","rectToPlane","rectFromPlane","planeToPlane","from","to","f","IDENTITY_MAP","t","sx","sy","planeMatrix"],"sources":["../../../src/core/viewport/parallax.ts"],"sourcesContent":["import type { View } from './view';\n\n/** One value for both axes, or a separate value per axis. */\nexport type ScalarOrXY = number | { x: number; y: number };\n\n/** How a parallax plane tracks the camera: `pan` is the fraction of the\n *  camera's translation it follows (1 = locked to the scene, 0 = fixed to the\n *  screen), `zoom` the same for scale, and `anchor` the camera position\n *  (`view.x` / `view.y`) the translation is measured from — every plane lines\n *  up when the camera sits there. */\nexport interface ParallaxOpts {\n  pan: ScalarOrXY;\n  zoom?: ScalarOrXY;\n  anchor?: { x: number; y: number };\n}\n\nfunction asXY(v: ScalarOrXY): { x: number; y: number } {\n  return typeof v === 'number' ? { x: v, y: v } : v;\n}\n\n/**\n * Pure derivation of a parallax plane's inner `View` from the camera view\n * plus per-plane factors.\n *\n * `pan` controls how much the plane translates with the camera (1 = normal,\n * 0 = locked to `anchor`, >1 = leads). `zoom` controls how much it scales\n * with camera zoom (1 = normal, 0 = fixed at identity scale). `anchor`\n * (default origin) is the camera position at which all planes agree.\n *\n * Identity holds: `pan=1, zoom=1` returns a view equal to `outer`.\n */\nexport function deriveParallaxView(outer: View, opts: ParallaxOpts): View {\n  const p = asXY(opts.pan);\n  const z = asXY(opts.zoom ?? 1);\n  const a = opts.anchor ?? { x: 0, y: 0 };\n  return {\n    x: a.x + (outer.x - a.x) * p.x,\n    y: a.y + (outer.y - a.y) * p.y,\n    scale: {\n      x: 1 + (outer.scale.x - 1) * z.x,\n      y: 1 + (outer.scale.y - 1) * z.y,\n    },\n  };\n}\n\n/** How a point of the camera's world lands in a plane's world, per axis:\n *  `plane = world * scale + offset`. A plane draws its content through its\n *  own view; this is what lets a pointer, a marquee or a selection box cross\n *  between that view and the camera's. */\nexport interface PlaneMap {\n  scale: { x: number; y: number };\n  offset: { x: number; y: number };\n}\n\n/** The map from `outer`'s world into the world of a plane drawn through\n *  `deriveParallaxView(outer, opts)` — the one that puts both points under the\n *  same pixel. */\nexport function planeMap(outer: View, opts: ParallaxOpts): PlaneMap {\n  const inner = deriveParallaxView(outer, opts);\n  const kx = outer.scale.x / inner.scale.x;\n  const ky = outer.scale.y / inner.scale.y;\n  return {\n    scale: { x: kx, y: ky },\n    offset: { x: inner.x - kx * outer.x, y: inner.y - ky * outer.y },\n  };\n}\n\n/** Map a point from the outer view's world into the plane's world. */\nexport function toPlane(m: PlaneMap, p: { x: number; y: number }): { x: number; y: number } {\n  return { x: p.x * m.scale.x + m.offset.x, y: p.y * m.scale.y + m.offset.y };\n}\n\n/** Map a point from the plane's world back into the outer view's world. */\nexport function fromPlane(m: PlaneMap, p: { x: number; y: number }): { x: number; y: number } {\n  return { x: (p.x - m.offset.x) / m.scale.x, y: (p.y - m.offset.y) / m.scale.y };\n}\n\ninterface Rect { x: number; y: number; width: number; height: number }\n\nfunction mapRect(r: Rect, map: (p: { x: number; y: number }) => { x: number; y: number }): Rect {\n  const a = map({ x: r.x, y: r.y });\n  const b = map({ x: r.x + r.width, y: r.y + r.height });\n  return {\n    x: Math.min(a.x, b.x),\n    y: Math.min(a.y, b.y),\n    width: Math.abs(b.x - a.x),\n    height: Math.abs(b.y - a.y),\n  };\n}\n\n/** A camera-world rect in the plane's world. The map is axis-aligned, so a\n *  rect stays a rect; a flipped axis is normalized back to a positive size. */\nexport function rectToPlane<R extends Rect>(m: PlaneMap, r: R): R {\n  return { ...r, ...mapRect(r, (p) => toPlane(m, p)) };\n}\n\n/** A plane-world rect in the camera's world — see {@link rectToPlane}. */\nexport function rectFromPlane<R extends Rect>(m: PlaneMap, r: R): R {\n  return { ...r, ...mapRect(r, (p) => fromPlane(m, p)) };\n}\n\n/** The map from one world into another, where `null` is the camera's own:\n *  `fromPlane(from)`, then `toPlane(to)`. Null when the two are the same\n *  world, so a caller can skip the work. */\nexport function planeToPlane(from: PlaneMap | null, to: PlaneMap | null): PlaneMap | null {\n  if (from === to) return null;\n  const f = from ?? IDENTITY_MAP;\n  const t = to ?? IDENTITY_MAP;\n  const sx = t.scale.x / f.scale.x;\n  const sy = t.scale.y / f.scale.y;\n  const m = {\n    scale: { x: sx, y: sy },\n    offset: { x: t.offset.x - f.offset.x * sx, y: t.offset.y - f.offset.y * sy },\n  };\n  return m.scale.x === 1 && m.scale.y === 1 && m.offset.x === 0 && m.offset.y === 0 ? null : m;\n}\n\nconst IDENTITY_MAP: PlaneMap = { scale: { x: 1, y: 1 }, offset: { x: 0, y: 0 } };\n\n/** The map as an affine matrix in `@weasel-js/geom`'s `[a, b, c, d, e, f]`\n *  order, for `transformPath` and friends. */\nexport function planeMatrix(m: PlaneMap): [number, number, number, number, number, number] {\n  return [m.scale.x, 0, 0, m.scale.y, m.offset.x, m.offset.y];\n}\n"],"mappings":"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"}
+{"version":3,"file":"parallax.js","names":["asXY","v","deriveParallaxView","p","opts","z","outer","planeMap","inner","kx","ky","toPlane","m","fromPlane","mapRect","a","map","r","b","rectToPlane","rectFromPlane","planeToPlane","from","to","f","IDENTITY_MAP","t","sx","sy","planeMatrix"],"sources":["../../../src/core/viewport/parallax.ts"],"sourcesContent":["import type { Rect } from '@weasel-js/geom';\nimport type { View } from './view';\n\n/** One value for both axes, or a separate value per axis. */\nexport type ScalarOrXY = number | { x: number; y: number };\n\n/** How a parallax plane tracks the camera: `pan` is the fraction of the\n *  camera's translation it follows (1 = locked to the scene, 0 = fixed to the\n *  screen), `zoom` the same for scale, and `anchor` the camera position\n *  (`view.x` / `view.y`) the translation is measured from — every plane lines\n *  up when the camera sits there. */\nexport interface ParallaxOpts {\n  pan: ScalarOrXY;\n  zoom?: ScalarOrXY;\n  anchor?: { x: number; y: number };\n}\n\nfunction asXY(v: ScalarOrXY): { x: number; y: number } {\n  return typeof v === 'number' ? { x: v, y: v } : v;\n}\n\n/**\n * Pure derivation of a parallax plane's inner `View` from the camera view\n * plus per-plane factors.\n *\n * `pan` controls how much the plane translates with the camera (1 = normal,\n * 0 = locked to `anchor`, >1 = leads). `zoom` controls how much it scales\n * with camera zoom (1 = normal, 0 = fixed at identity scale). `anchor`\n * (default origin) is the camera position at which all planes agree.\n *\n * Identity holds: `pan=1, zoom=1` returns a view equal to `outer`.\n */\nexport function deriveParallaxView(outer: View, opts: ParallaxOpts): View {\n  const p = asXY(opts.pan);\n  const z = asXY(opts.zoom ?? 1);\n  const a = opts.anchor ?? { x: 0, y: 0 };\n  return {\n    x: a.x + (outer.x - a.x) * p.x,\n    y: a.y + (outer.y - a.y) * p.y,\n    scale: {\n      x: 1 + (outer.scale.x - 1) * z.x,\n      y: 1 + (outer.scale.y - 1) * z.y,\n    },\n  };\n}\n\n/** How a point of the camera's world lands in a plane's world, per axis:\n *  `plane = world * scale + offset`. A plane draws its content through its\n *  own view; this is what lets a pointer, a marquee or a selection box cross\n *  between that view and the camera's. */\nexport interface PlaneMap {\n  scale: { x: number; y: number };\n  offset: { x: number; y: number };\n}\n\n/** The map from `outer`'s world into the world of a plane drawn through\n *  `deriveParallaxView(outer, opts)` — the one that puts both points under the\n *  same pixel. */\nexport function planeMap(outer: View, opts: ParallaxOpts): PlaneMap {\n  const inner = deriveParallaxView(outer, opts);\n  const kx = outer.scale.x / inner.scale.x;\n  const ky = outer.scale.y / inner.scale.y;\n  return {\n    scale: { x: kx, y: ky },\n    offset: { x: inner.x - kx * outer.x, y: inner.y - ky * outer.y },\n  };\n}\n\n/** Map a point from the outer view's world into the plane's world. */\nexport function toPlane(m: PlaneMap, p: { x: number; y: number }): { x: number; y: number } {\n  return { x: p.x * m.scale.x + m.offset.x, y: p.y * m.scale.y + m.offset.y };\n}\n\n/** Map a point from the plane's world back into the outer view's world. */\nexport function fromPlane(m: PlaneMap, p: { x: number; y: number }): { x: number; y: number } {\n  return { x: (p.x - m.offset.x) / m.scale.x, y: (p.y - m.offset.y) / m.scale.y };\n}\n\nfunction mapRect(r: Rect, map: (p: { x: number; y: number }) => { x: number; y: number }): Rect {\n  const a = map({ x: r.x, y: r.y });\n  const b = map({ x: r.x + r.width, y: r.y + r.height });\n  return {\n    x: Math.min(a.x, b.x),\n    y: Math.min(a.y, b.y),\n    width: Math.abs(b.x - a.x),\n    height: Math.abs(b.y - a.y),\n  };\n}\n\n/** A camera-world rect in the plane's world. The map is axis-aligned, so a\n *  rect stays a rect; a flipped axis is normalized back to a positive size. */\nexport function rectToPlane<R extends Rect>(m: PlaneMap, r: R): R {\n  return { ...r, ...mapRect(r, (p) => toPlane(m, p)) };\n}\n\n/** A plane-world rect in the camera's world — see {@link rectToPlane}. */\nexport function rectFromPlane<R extends Rect>(m: PlaneMap, r: R): R {\n  return { ...r, ...mapRect(r, (p) => fromPlane(m, p)) };\n}\n\n/** The map from one world into another, where `null` is the camera's own:\n *  `fromPlane(from)`, then `toPlane(to)`. Null when the two are the same\n *  world, so a caller can skip the work. */\nexport function planeToPlane(from: PlaneMap | null, to: PlaneMap | null): PlaneMap | null {\n  if (from === to) return null;\n  const f = from ?? IDENTITY_MAP;\n  const t = to ?? IDENTITY_MAP;\n  const sx = t.scale.x / f.scale.x;\n  const sy = t.scale.y / f.scale.y;\n  const m = {\n    scale: { x: sx, y: sy },\n    offset: { x: t.offset.x - f.offset.x * sx, y: t.offset.y - f.offset.y * sy },\n  };\n  return m.scale.x === 1 && m.scale.y === 1 && m.offset.x === 0 && m.offset.y === 0 ? null : m;\n}\n\nconst IDENTITY_MAP: PlaneMap = { scale: { x: 1, y: 1 }, offset: { x: 0, y: 0 } };\n\n/** The map as an affine matrix in `@weasel-js/geom`'s `[a, b, c, d, e, f]`\n *  order, for `transformPath` and friends. */\nexport function planeMatrix(m: PlaneMap): [number, number, number, number, number, number] {\n  return [m.scale.x, 0, 0, m.scale.y, m.offset.x, m.offset.y];\n}\n"],"mappings":"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"}

package/dist/core/viewport/screenSlop.js

@@ -1,33 +1,33 @@
-import { multiply as e, rotate as t, scale as n } from "@weasel-js/geom";
+import { multiply as e, scale as t } from "@weasel-js/geom";
 //#region src/core/viewport/screenSlop.ts
-function r(r, i = 0) {
-	if (r === void 0) return {
+function n(n, r) {
+	if (n === void 0) return {
 		extra: 0,
 		opts: {}
 	};
-	if (typeof r == "number") return {
-		extra: r,
+	if (typeof n == "number") return {
+		extra: n,
 		opts: {}
 	};
-	let a = n(r.scale.x, r.scale.y);
+	let i = t(n.scale.x, n.scale.y);
 	return {
 		extra: 0,
 		opts: { slop: {
-			px: r.px,
-			transform: i ? e(a, t(i)) : a
+			px: n.px,
+			transform: r ? e(i, r) : i
 		} }
 	};
 }
-function i(e, t, n = 1) {
+function r(e, t, n = 1) {
 	return t > 0 ? typeof e == "object" ? {
 		...e,
 		px: e.px + t
 	} : (e ?? 0) + t / (n > 0 ? n : 1) : e;
 }
-function a(e) {
+function i(e) {
 	return e === void 0 ? !1 : typeof e == "number" ? e > 0 : e.px > 0;
 }
 //#endregion
-export { a as hasSlop, r as slopForStrokeHit, i as widenSlop };
+export { i as hasSlop, n as slopForStrokeHit, r as widenSlop };
 
 //# sourceMappingURL=screenSlop.js.map

package/dist/core/viewport/screenSlop.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenSlop.js","names":["scaleMat","slopForStrokeHit","slop","s","scale","rotation","multiply","rotate","widenSlop","px","hasSlop"],"sources":["../../../src/core/viewport/screenSlop.ts"],"sourcesContent":["/**\n * Pointer forgiveness measured on screen.\n *\n * A pick slop is a screen distance: \"within 4px of the outline\". Converting it\n * to a world distance — per axis or as one scalar — is exact only when the\n * frame the geometry lives in reaches the screen by a similarity. A rotated\n * node under non-uniform zoom does not: a screen circle pulled back into its\n * frame is a tilted ellipse, so the test is run against the geometry's screen\n * image instead (`strokeHitTest`'s `slop`).\n */\nimport { multiply, rotate, scale as scaleMat, type Mat3 } from '@weasel-js/geom';\nimport type { Scale2 } from './pxExtent';\n\n/** `px` screen pixels under a view whose per-axis scale is `scale`. */\nexport interface ScreenSlop {\n  px: number;\n  scale: Scale2;\n}\n\n/** A slop in world units (a number, the view-less form) or on screen. */\nexport type PickSlop = number | ScreenSlop;\n\n/**\n * How `strokeHitTest` should apply a slop to geometry in a frame turned by\n * `rotation` from world: a world slop adds to the threshold, a screen slop is\n * handed over with the frame's map to the screen.\n */\nexport function slopForStrokeHit(\n  slop: PickSlop | undefined,\n  rotation = 0,\n): { extra: number; opts: { slop?: { px: number; transform: Mat3 } } } {\n  if (slop === undefined) return { extra: 0, opts: {} };\n  if (typeof slop === 'number') return { extra: slop, opts: {} };\n  const s = scaleMat(slop.scale.x, slop.scale.y);\n  return {\n    extra: 0,\n    opts: { slop: { px: slop.px, transform: rotation ? multiply(s, rotate(rotation)) : s } },\n  };\n}\n\n/** `slop` widened by `px` screen pixels — kept on screen when it is measured\n *  there, and read at `scale` when it is a world distance. */\nexport function widenSlop(slop: PickSlop | undefined, px: number, scale = 1): PickSlop | undefined {\n  if (!(px > 0)) return slop;\n  if (typeof slop === 'object') return { ...slop, px: slop.px + px };\n  return (slop ?? 0) + px / (scale > 0 ? scale : 1);\n}\n\n/** Is any slop set at all? A zero reach plus a zero slop hits nothing. */\nexport function hasSlop(slop: PickSlop | undefined): boolean {\n  if (slop === undefined) return false;\n  return typeof slop === 'number' ? slop > 0 : slop.px > 0;\n}\n"],"mappings":";;AA2BA,SAAgBC,EACd,GACA,IAAW,GAC0D;CACrE,IAAIC,MAAS,KAAA,GAAW,OAAO;EAAE,OAAO;EAAG,MAAM,CAAC;CAAE;CACpD,IAAI,OAAOA,KAAS,UAAU,OAAO;EAAE,OAAOA;EAAM,MAAM,CAAC;CAAE;CAC7D,IAAMC,IAAIH,EAASE,EAAK,MAAM,GAAGA,EAAK,MAAM,CAAC;CAC7C,OAAO;EACL,OAAO;EACP,MAAM,EAAE,MAAM;GAAE,IAAIA,EAAK;GAAI,WAAWG,IAAWC,EAASH,GAAGI,EAAOF,CAAQ,CAAC,IAAIF;EAAE,EAAE;CACzF;AACF;AAIA,SAAgBK,EAAU,GAA4B,GAAY,IAAQ,GAAyB;CAGjG,OAFMC,IAAK,IACP,OAAOP,KAAS,WAAiB;EAAE,GAAGA;EAAM,IAAIA,EAAK,KAAKO;CAAG,KACzDP,KAAQ,KAAKO,KAAML,IAAQ,IAAIA,IAAQ,KAFzBF;AAGxB;AAGA,SAAgBQ,EAAQ,GAAqC;CAE3D,OADIR,MAAS,KAAA,IAAkB,KACxB,OAAOA,KAAS,WAAWA,IAAO,IAAIA,EAAK,KAAK;AACzD"}
+{"version":3,"file":"screenSlop.js","names":["scaleMat","slopForStrokeHit","slop","s","scale","frame","multiply","widenSlop","px","hasSlop"],"sources":["../../../src/core/viewport/screenSlop.ts"],"sourcesContent":["/**\n * Pointer forgiveness measured on screen.\n *\n * A pick slop is a screen distance: \"within 4px of the outline\". Converting it\n * to a world distance — per axis or as one scalar — is exact only when the\n * frame the geometry lives in reaches the screen by a similarity. A rotated\n * node under non-uniform zoom does not: a screen circle pulled back into its\n * frame is a tilted ellipse, so the test is run against the geometry's screen\n * image instead (`strokeHitTest`'s `slop`).\n */\nimport { multiply, scale as scaleMat, type Mat3 } from '@weasel-js/geom';\nimport type { Scale2 } from '@weasel-js/geom';\n\n/** `px` screen pixels under a view whose per-axis scale is `scale`. */\nexport interface ScreenSlop {\n  px: number;\n  scale: Scale2;\n}\n\n/** A slop in world units (a number, the view-less form) or on screen. */\nexport type PickSlop = number | ScreenSlop;\n\n/**\n * How `strokeHitTest` should apply a slop to geometry in a frame that\n * reaches world by `frame` (`poseFrameOf`; only its linear part is read): a\n * world slop adds to the threshold, a screen slop is handed over with the\n * frame's map to the screen.\n */\nexport function slopForStrokeHit(\n  slop: PickSlop | undefined,\n  frame?: Mat3 | null,\n): { extra: number; opts: { slop?: { px: number; transform: Mat3 } } } {\n  if (slop === undefined) return { extra: 0, opts: {} };\n  if (typeof slop === 'number') return { extra: slop, opts: {} };\n  const s = scaleMat(slop.scale.x, slop.scale.y);\n  return {\n    extra: 0,\n    opts: { slop: { px: slop.px, transform: frame ? multiply(s, frame) : s } },\n  };\n}\n\n/** `slop` widened by `px` screen pixels — kept on screen when it is measured\n *  there, and read at `scale` when it is a world distance. */\nexport function widenSlop(slop: PickSlop | undefined, px: number, scale = 1): PickSlop | undefined {\n  if (!(px > 0)) return slop;\n  if (typeof slop === 'object') return { ...slop, px: slop.px + px };\n  return (slop ?? 0) + px / (scale > 0 ? scale : 1);\n}\n\n/** Is any slop set at all? A zero reach plus a zero slop hits nothing. */\nexport function hasSlop(slop: PickSlop | undefined): boolean {\n  if (slop === undefined) return false;\n  return typeof slop === 'number' ? slop > 0 : slop.px > 0;\n}\n"],"mappings":";;AA4BA,SAAgBC,EACd,GACA,GACqE;CACrE,IAAIC,MAAS,KAAA,GAAW,OAAO;EAAE,OAAO;EAAG,MAAM,CAAC;CAAE;CACpD,IAAI,OAAOA,KAAS,UAAU,OAAO;EAAE,OAAOA;EAAM,MAAM,CAAC;CAAE;CAC7D,IAAMC,IAAIH,EAASE,EAAK,MAAM,GAAGA,EAAK,MAAM,CAAC;CAC7C,OAAO;EACL,OAAO;EACP,MAAM,EAAE,MAAM;GAAE,IAAIA,EAAK;GAAI,WAAWG,IAAQC,EAASH,GAAGE,CAAK,IAAIF;EAAE,EAAE;CAC3E;AACF;AAIA,SAAgBI,EAAU,GAA4B,GAAY,IAAQ,GAAyB;CAGjG,OAFMC,IAAK,IACP,OAAON,KAAS,WAAiB;EAAE,GAAGA;EAAM,IAAIA,EAAK,KAAKM;CAAG,KACzDN,KAAQ,KAAKM,KAAMJ,IAAQ,IAAIA,IAAQ,KAFzBF;AAGxB;AAGA,SAAgBO,EAAQ,GAAqC;CAE3D,OADIP,MAAS,KAAA,IAAkB,KACxB,OAAOA,KAAS,WAAWA,IAAO,IAAIA,EAAK,KAAK;AACzD"}

package/dist/core/viewport/useCanvasSize.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCanvasSize.js","names":["useCanvasSize","useDeviceProfile","size","setSize","useState","measure","useCallback","containerRef","rect","prev","useEffect","observer"],"sources":["../../../src/core/viewport/useCanvasSize.ts"],"sourcesContent":["import { type RefObject, useCallback, useEffect, useState } from 'react';\nimport type { CanvasSize } from './clampView';\nimport { useDeviceProfile } from '../device/useDeviceProfile';\n\n/** Size snapshot returned by `useCanvasSize` — the kit-wide `CanvasSize`\n *  (width × height in CSS pixels) plus the current devicePixelRatio. */\nexport interface CanvasSizeSnapshot extends CanvasSize {\n  dpr: number;\n}\n\n/** Track a container's content-rect size via `ResizeObserver`, and density via\n *  the ambient `DeviceProfile`.\n *\n *  This hook is the screen path's designated ambient-density source —\n *  rendering code should take density as a parameter (cf.\n *  `renderSceneToPixels`, `renderSceneToCanvas`'s `dpr`) rather than reading\n *  `window.devicePixelRatio` inline.\n *\n *  Density deliberately does NOT come from a `window.devicePixelRatio` read\n *  inside the resize callback: that only refreshes when the element resizes,\n *  so dragging a window to a different-density display without resizing it\n *  left the snapshot stale. The profile watches a re-armed resolution media\n *  query instead. */\nexport function useCanvasSize(containerRef: RefObject<HTMLElement | null>): CanvasSizeSnapshot {\n  const { dpr } = useDeviceProfile();\n  const [size, setSize] = useState<CanvasSize>({ width: 0, height: 0 });\n\n  const measure = useCallback(() => {\n    if (!containerRef.current) return;\n    const rect = containerRef.current.getBoundingClientRect();\n    setSize((prev) =>\n      prev.width === rect.width && prev.height === rect.height\n        ? prev\n        : { width: rect.width, height: rect.height },\n    );\n  }, [containerRef]);\n\n  useEffect(() => {\n    measure();\n    const observer = new ResizeObserver(measure);\n    if (containerRef.current) {\n      observer.observe(containerRef.current);\n    }\n    return () => observer.disconnect();\n  }, [measure, containerRef]);\n\n  return { width: size.width, height: size.height, dpr };\n}\n"],"mappings":";;;AAuBA,SAAgBA,EAAc,GAAiE;CAC7F,IAAM,EAAE,WAAQC,EAAiB,GAC3B,CAACC,GAAMC,KAAWC,EAAqB;EAAE,OAAO;EAAG,QAAQ;CAAE,CAAC,GAE9DC,IAAUC,QAAkB;EAChC,IAAI,CAACC,EAAa,SAAS;EAC3B,IAAMC,IAAOD,EAAa,QAAQ,sBAAsB;EACxD,GAAS,MACPE,EAAK,UAAUD,EAAK,SAASC,EAAK,WAAWD,EAAK,SAC9CC,IACA;GAAE,OAAOD,EAAK;GAAO,QAAQA,EAAK;EAAO,CAC/C;CACF,GAAG,CAACD,CAAY,CAAC;CAWjB,OATAG,QAAgB;EACd,EAAQ;EACR,IAAMC,IAAW,IAAI,eAAeN,CAAO;EAI3C,OAHIE,EAAa,WACfI,EAAS,QAAQJ,EAAa,OAAO,SAE1BI,EAAS,WAAW;CACnC,GAAG,CAACN,GAASE,CAAY,CAAC,GAEnB;EAAE,OAAOL,EAAK;EAAO,QAAQA,EAAK;EAAQ;CAAI;AACvD"}
+{"version":3,"file":"useCanvasSize.js","names":["useCanvasSize","useDeviceProfile","size","setSize","useState","measure","useCallback","containerRef","rect","prev","useEffect","observer"],"sources":["../../../src/core/viewport/useCanvasSize.ts"],"sourcesContent":["import { type RefObject, useCallback, useEffect, useState } from 'react';\nimport type { CanvasSize } from './clampView';\nimport { useDeviceProfile } from '../device/useDeviceProfile';\n\n/** Size snapshot returned by `useCanvasSize` — the kit-wide `CanvasSize`\n *  (width × height in CSS pixels) plus the current devicePixelRatio. */\nexport interface CanvasSizeSnapshot extends CanvasSize {\n  dpr: number;\n}\n\n/** Track a container's content-rect size via `ResizeObserver`, and density via\n *  the ambient `DeviceProfile`.\n *\n *  Density deliberately does NOT come from a `window.devicePixelRatio` read\n *  inside the resize callback: that only refreshes when the element resizes,\n *  so dragging a window to a different-density display without resizing it\n *  leaves the snapshot stale. */\nexport function useCanvasSize(containerRef: RefObject<HTMLElement | null>): CanvasSizeSnapshot {\n  const { dpr } = useDeviceProfile();\n  const [size, setSize] = useState<CanvasSize>({ width: 0, height: 0 });\n\n  const measure = useCallback(() => {\n    if (!containerRef.current) return;\n    const rect = containerRef.current.getBoundingClientRect();\n    setSize((prev) =>\n      prev.width === rect.width && prev.height === rect.height\n        ? prev\n        : { width: rect.width, height: rect.height },\n    );\n  }, [containerRef]);\n\n  useEffect(() => {\n    measure();\n    const observer = new ResizeObserver(measure);\n    if (containerRef.current) {\n      observer.observe(containerRef.current);\n    }\n    return () => observer.disconnect();\n  }, [measure, containerRef]);\n\n  return { width: size.width, height: size.height, dpr };\n}\n"],"mappings":";;;AAiBA,SAAgBA,EAAc,GAAiE;CAC7F,IAAM,EAAE,WAAQC,EAAiB,GAC3B,CAACC,GAAMC,KAAWC,EAAqB;EAAE,OAAO;EAAG,QAAQ;CAAE,CAAC,GAE9DC,IAAUC,QAAkB;EAChC,IAAI,CAACC,EAAa,SAAS;EAC3B,IAAMC,IAAOD,EAAa,QAAQ,sBAAsB;EACxD,GAAS,MACPE,EAAK,UAAUD,EAAK,SAASC,EAAK,WAAWD,EAAK,SAC9CC,IACA;GAAE,OAAOD,EAAK;GAAO,QAAQA,EAAK;EAAO,CAC/C;CACF,GAAG,CAACD,CAAY,CAAC;CAWjB,OATAG,QAAgB;EACd,EAAQ;EACR,IAAMC,IAAW,IAAI,eAAeN,CAAO;EAI3C,OAHIE,EAAa,WACfI,EAAS,QAAQJ,EAAa,OAAO,SAE1BI,EAAS,WAAW;CACnC,GAAG,CAACN,GAASE,CAAY,CAAC,GAEnB;EAAE,OAAOL,EAAK;EAAO,QAAQA,EAAK;EAAQ;CAAI;AACvD"}

package/dist/core/viewport/useDecayLoop.js

@@ -1,15 +1,15 @@
-import { useVisibleRaf as e } from "../../scheduling/useVisibleRaf.js";
-import { useCallback as t, useEffect as n, useRef as r } from "react";
+import { useCallback as e, useEffect as t, useRef as n } from "react";
+import { useVisibleRaf as r } from "@weasel-js/react";
 //#region src/core/viewport/useDecayLoop.ts
 var i = .5;
 function a() {
-	let a = r(null), o = e((e) => {
+	let a = n(null), o = r((e) => {
 		c(e);
-	}, { onResume: t(() => {
+	}, { onResume: e(() => {
 		a.current && (a.current.lastTime = null);
-	}, []) }), s = t(() => {
+	}, []) }), s = e(() => {
 		o.cancel(), a.current = null;
-	}, [o]), c = t((e) => {
+	}, [o]), c = e((e) => {
 		let t = a.current;
 		if (!t) return;
 		if (t.lastTime === null) {
@@ -29,7 +29,7 @@ function a() {
 			t.boundary === "stop" ? (e !== void 0 && o < e ? (s = e - t.posX, t.vx = 0) : n !== void 0 && o > n && (s = n - t.posX, t.vx = 0), r !== void 0 && l < r ? (c = r - t.posY, t.vy = 0) : a !== void 0 && l > a && (c = a - t.posY, t.vy = 0)) : t.boundary === "spring" ? (e !== void 0 && o < e ? (s = e - t.posX, t.vx = Math.abs(t.vx) * i) : n !== void 0 && o > n && (s = n - t.posX, t.vx = -Math.abs(t.vx) * i), r !== void 0 && l < r ? (c = r - t.posY, t.vy = Math.abs(t.vy) * i) : a !== void 0 && l > a && (c = a - t.posY, t.vy = -Math.abs(t.vy) * i)) : (e !== void 0 && o < e ? (s = e - t.posX, t.vx = Math.abs(t.vx)) : n !== void 0 && o > n && (s = n - t.posX, t.vx = -Math.abs(t.vx)), r !== void 0 && l < r ? (c = r - t.posY, t.vy = Math.abs(t.vy)) : a !== void 0 && l > a && (c = a - t.posY, t.vy = -Math.abs(t.vy))), t.posX += s, t.posY += c;
 		}
 		t.onTick(s, c), o.request();
-	}, [o]), l = t((e) => {
+	}, [o]), l = e((e) => {
 		s();
 		let { velocity: t, friction: n = .92, minSpeed: r = .01, viewBounds: i, boundary: c, initialPosition: l, onTick: u, onEnd: d } = e;
 		if (Math.sqrt(t.vx ** 2 + t.vy ** 2) < r) {
@@ -50,7 +50,7 @@ function a() {
 			onEnd: d
 		}, o.request();
 	}, [s, o]);
-	return n(() => () => {
+	return t(() => () => {
 		s();
 	}, [s]), {
 		start: l,

package/dist/core/viewport/useDecayLoop.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDecayLoop.js","names":["SPRING_DAMPING","useDecayLoop","stateRef","useRef","frameLoop","useVisibleRaf","now","useCallback","cancel","tick","s","dt","f","dx","dy","newX","newY","minX","maxX","minY","maxY","start","config","velocity","minSpeed","initialPosition","useEffect"],"sources":["../../../src/core/viewport/useDecayLoop.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { useVisibleRaf } from '../../scheduling/useVisibleRaf';\n\n/** Per-axis limits on a view's position. Any side may be left open. */\nexport interface PanBounds {\n  minX?: number;\n  maxX?: number;\n  minY?: number;\n  maxY?: number;\n}\n\n/** Momentum settings for a pan: how quickly a flung view slows, when it stops,\n *  and what happens at the pan limits. The `DecayLoopConfig` fields a caller\n *  chooses up front, without the per-gesture `velocity` / `onTick`. */\nexport interface InertiaConfig {\n  friction?: number;\n  minSpeed?: number;\n  /** What to do when inertial pan reaches `bounds`. Default: no clamping. */\n  boundary?: 'stop' | 'bounce' | 'spring';\n  /** View-coordinate limits for boundary clamping. Requires `boundary` to take effect. */\n  bounds?: PanBounds;\n}\n\n/** How a decay should run: its starting velocity, how fast it slows, and what\n *  happens if it reaches the pan limits. */\nexport interface DecayLoopConfig {\n  velocity: { vx: number; vy: number };\n  friction?: number;\n  minSpeed?: number;\n  /** Bounds for boundary clamping. Requires `boundary` to take effect. */\n  viewBounds?: PanBounds;\n  /**\n   * What to do when the accumulated position hits `viewBounds`. Default: no clamping.\n   * - `'stop'`: clamp at boundary, kill velocity component.\n   * - `'bounce'`: linear reflection — flip velocity sign, magnitude preserved.\n   * - `'spring'`: damped reflection — flip velocity sign and shrink magnitude\n   *   by `SPRING_DAMPING` per bounce so the motion settles naturally.\n   */\n  boundary?: 'stop' | 'bounce' | 'spring';\n  /** Starting position for internal boundary tracking. Required when `viewBounds` is set. */\n  initialPosition?: { x: number; y: number };\n  onTick: (dx: number, dy: number) => void;\n  onEnd?: () => void;\n}\n\n/**\n * Fraction of velocity preserved per `'spring'` bounce. 0.5 means each bounce\n * loses half its energy, giving a quick visible settle (typically 2–4 bounces\n * before `minSpeed` cuts the loop). Fixed for v1; a future `bounceDamping`\n * config option could expose this if a consumer needs control.\n */\nconst SPRING_DAMPING = 0.5;\n\n/** A rAF loop that coasts a value to a stop under friction, reporting the\n *  per-frame delta. What turns a released pan drag into momentum scrolling. */\nexport function useDecayLoop() {\n  const stateRef = useRef<{\n    vx: number; vy: number;\n    friction: number; minSpeed: number;\n    lastTime: number | null;\n    posX: number; posY: number;\n    viewBounds: PanBounds | undefined;\n    boundary: 'stop' | 'bounce' | 'spring' | undefined;\n    onTick: (dx: number, dy: number) => void;\n    onEnd?: () => void;\n  } | null>(null);\n\n  const frameLoop = useVisibleRaf(\n    (now: number) => { tick(now); },\n    {\n      // Coasting does not continue while suspended: dropping `lastTime` makes\n      // the resuming frame seed a fresh interval instead of applying an hour of\n      // friction at once, which would end the decay before it was seen.\n      onResume: useCallback(() => {\n        if (stateRef.current) stateRef.current.lastTime = null;\n      }, []),\n    },\n  );\n\n  const cancel = useCallback(() => {\n    frameLoop.cancel();\n    stateRef.current = null;\n  }, [frameLoop]);\n\n  const tick = useCallback((now: number) => {\n    const s = stateRef.current;\n    if (!s) return;\n    if (s.lastTime === null) {\n      s.lastTime = now;\n      frameLoop.request();\n      return;\n    }\n    const dt = Math.min(now - s.lastTime, 64);  // cap at 64ms to avoid huge jumps\n    s.lastTime = now;\n    // Time-normalize friction to 60fps baseline\n    const f = Math.pow(s.friction, dt / 16.67);\n    s.vx *= f;\n    s.vy *= f;\n    const speed = Math.sqrt(s.vx * s.vx + s.vy * s.vy);\n    if (speed < s.minSpeed) {\n      stateRef.current = null;\n      frameLoop.cancel();\n      s.onEnd?.();\n      return;\n    }\n    let dx = s.vx * dt;\n    let dy = s.vy * dt;\n    if (s.viewBounds && s.boundary) {\n      const { minX, maxX, minY, maxY } = s.viewBounds;\n      const newX = s.posX + dx;\n      const newY = s.posY + dy;\n      if (s.boundary === 'stop') {\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = 0; }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = 0; }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = 0; }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = 0; }\n      } else if (s.boundary === 'spring') {\n        // Damped reflection: flip sign AND scale magnitude by SPRING_DAMPING so\n        // each bounce loses energy. Once |v| < minSpeed the outer loop ends.\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = Math.abs(s.vx) * SPRING_DAMPING; }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = -Math.abs(s.vx) * SPRING_DAMPING; }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = Math.abs(s.vy) * SPRING_DAMPING; }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = -Math.abs(s.vy) * SPRING_DAMPING; }\n      } else {\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = Math.abs(s.vx); }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = -Math.abs(s.vx); }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = Math.abs(s.vy); }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = -Math.abs(s.vy); }\n      }\n      s.posX += dx;\n      s.posY += dy;\n    }\n    s.onTick(dx, dy);\n    frameLoop.request();\n  }, [frameLoop]);\n\n  const start = useCallback((config: DecayLoopConfig) => {\n    cancel();\n    const { velocity, friction = 0.92, minSpeed = 0.01, viewBounds, boundary, initialPosition, onTick, onEnd } = config;\n    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);\n    if (speed < minSpeed) { onEnd?.(); return; }\n    stateRef.current = {\n      vx: velocity.vx, vy: velocity.vy, friction, minSpeed, lastTime: null,\n      posX: initialPosition?.x ?? 0, posY: initialPosition?.y ?? 0,\n      viewBounds, boundary,\n      onTick, onEnd,\n    };\n    frameLoop.request();\n  }, [cancel, frameLoop]);\n\n  useEffect(() => () => { cancel(); }, [cancel]);\n\n  return { start, cancel };\n}\n"],"mappings":";;;AAmDA,IAAMA,IAAiB;AAIvB,SAAgBC,IAAe;CAC7B,IAAMC,IAAWC,EASP,IAAI,GAERC,IAAYC,GACf,MAAgB;EAAE,EAAKC,CAAG;CAAG,GAC9B,EAIE,UAAUC,QAAkB;EAC1B,AAAIL,EAAS,YAAS,EAAS,QAAQ,WAAW;CACpD,GAAG,CAAC,CAAC,EACP,CACF,GAEMM,IAASD,QAAkB;EAE/B,AADAH,EAAU,OAAO,GACjB,EAAS,UAAU;CACrB,GAAG,CAACA,CAAS,CAAC,GAERK,IAAOF,GAAa,MAAgB;EACxC,IAAMG,IAAIR,EAAS;EACnB,IAAI,CAACQ,GAAG;EACR,IAAIA,EAAE,aAAa,MAAM;GAEvB,AADA,EAAE,WAAWJ,GACbF,EAAU,QAAQ;GAClB;EACF;EACA,IAAMO,IAAK,KAAK,IAAIL,IAAMI,EAAE,UAAU,EAAE;EACxC,EAAE,WAAWJ;EAEb,IAAMM,IAAaF,EAAE,aAAUC,IAAK;EAIpC,IAHA,EAAE,MAAMC,GACR,EAAE,MAAMA,GACM,KAAK,KAAKF,EAAE,KAAKA,EAAE,KAAKA,EAAE,KAAKA,EAAE,EAC3C,IAAQA,EAAE,UAAU;GAGtB,AAFA,EAAS,UAAU,MACnBN,EAAU,OAAO,GACjBM,EAAE,QAAQ;GACV;EACF;EACA,IAAIG,IAAKH,EAAE,KAAKC,GACZG,IAAKJ,EAAE,KAAKC;EAChB,IAAID,EAAE,cAAcA,EAAE,UAAU;GAC9B,IAAM,EAAE,SAAM,SAAM,SAAM,YAASA,EAAE,YAC/BK,IAAOL,EAAE,OAAOG,GAChBG,IAAON,EAAE,OAAOI;GAoBtB,AAnBIJ,EAAE,aAAa,UACbO,MAAS,KAAA,KAAaF,IAAOE,KAAQ,IAAKA,IAAOP,EAAE,MAAM,EAAE,KAAK,KAC3DQ,MAAS,KAAA,KAAaH,IAAOG,MAAQ,IAAKA,IAAOR,EAAE,MAAM,EAAE,KAAK,IACrES,MAAS,KAAA,KAAaH,IAAOG,KAAQ,IAAKA,IAAOT,EAAE,MAAM,EAAE,KAAK,KAC3DU,MAAS,KAAA,KAAaJ,IAAOI,MAAQ,IAAKA,IAAOV,EAAE,MAAM,EAAE,KAAK,MAChEA,EAAE,aAAa,YAGpBO,MAAS,KAAA,KAAaF,IAAOE,KAAQ,IAAKA,IAAOP,EAAE,MAAM,EAAE,KAAK,KAAK,IAAIA,EAAE,EAAE,IAAIV,KAC5EkB,MAAS,KAAA,KAAaH,IAAOG,MAAQ,IAAKA,IAAOR,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,IAAIA,EAAE,EAAE,IAAIV,IACvFmB,MAAS,KAAA,KAAaH,IAAOG,KAAQ,IAAKA,IAAOT,EAAE,MAAM,EAAE,KAAK,KAAK,IAAIA,EAAE,EAAE,IAAIV,KAC5EoB,MAAS,KAAA,KAAaJ,IAAOI,MAAQ,IAAKA,IAAOV,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,IAAIA,EAAE,EAAE,IAAIV,OAEvFiB,MAAS,KAAA,KAAaF,IAAOE,KAAQ,IAAKA,IAAOP,EAAE,MAAM,EAAE,KAAK,KAAK,IAAIA,EAAE,EAAE,KACxEQ,MAAS,KAAA,KAAaH,IAAOG,MAAQ,IAAKA,IAAOR,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,IAAIA,EAAE,EAAE,IACnFS,MAAS,KAAA,KAAaH,IAAOG,KAAQ,IAAKA,IAAOT,EAAE,MAAM,EAAE,KAAK,KAAK,IAAIA,EAAE,EAAE,KACxEU,MAAS,KAAA,KAAaJ,IAAOI,MAAQ,IAAKA,IAAOV,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,IAAIA,EAAE,EAAE,KAEzF,EAAE,QAAQG,GACV,EAAE,QAAQC;EACZ;EAEA,AADAJ,EAAE,OAAOG,GAAIC,CAAE,GACfV,EAAU,QAAQ;CACpB,GAAG,CAACA,CAAS,CAAC,GAERiB,IAAQd,GAAa,MAA4B;EACrD,EAAO;EACP,IAAM,EAAE,aAAU,cAAW,KAAM,cAAW,KAAM,eAAY,aAAU,oBAAiB,WAAQ,aAAUe;EAE7G,IADc,KAAK,KAAKC,EAAS,MAAM,IAAIA,EAAS,MAAM,CACtD,IAAQC,GAAU;GAAE,IAAQ;GAAG;EAAQ;EAO3C,AANA,EAAS,UAAU;GACjB,IAAID,EAAS;GAAI,IAAIA,EAAS;GAAI;GAAU;GAAU,UAAU;GAChE,MAAME,GAAiB,KAAK;GAAG,MAAMA,GAAiB,KAAK;GAC3D;GAAY;GACZ;GAAQ;EACV,GACArB,EAAU,QAAQ;CACpB,GAAG,CAACI,GAAQJ,CAAS,CAAC;CAItB,OAFAsB,cAAsB;EAAE,EAAO;CAAG,GAAG,CAAClB,CAAM,CAAC,GAEtC;EAAE;EAAO;CAAO;AACzB"}
+{"version":3,"file":"useDecayLoop.js","names":["SPRING_DAMPING","useDecayLoop","stateRef","useRef","frameLoop","useVisibleRaf","now","useCallback","cancel","tick","s","dt","f","dx","dy","newX","newY","minX","maxX","minY","maxY","start","config","velocity","minSpeed","initialPosition","useEffect"],"sources":["../../../src/core/viewport/useDecayLoop.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { useVisibleRaf } from '@weasel-js/react';\n\n/** Per-axis limits on a view's position. Any side may be left open. */\nexport interface PanBounds {\n  minX?: number;\n  maxX?: number;\n  minY?: number;\n  maxY?: number;\n}\n\n/** Momentum settings for a pan: how quickly a flung view slows, when it stops,\n *  and what happens at the pan limits. The `DecayLoopConfig` fields a caller\n *  chooses up front, without the per-gesture `velocity` / `onTick`. */\nexport interface InertiaConfig {\n  friction?: number;\n  minSpeed?: number;\n  /** What to do when inertial pan reaches `bounds`. Default: no clamping. */\n  boundary?: 'stop' | 'bounce' | 'spring';\n  /** View-coordinate limits for boundary clamping. Requires `boundary` to take effect. */\n  bounds?: PanBounds;\n}\n\n/** How a decay should run: its starting velocity, how fast it slows, and what\n *  happens if it reaches the pan limits. */\nexport interface DecayLoopConfig {\n  velocity: { vx: number; vy: number };\n  friction?: number;\n  minSpeed?: number;\n  /** Bounds for boundary clamping. Requires `boundary` to take effect. */\n  viewBounds?: PanBounds;\n  /**\n   * What to do when the accumulated position hits `viewBounds`. Default: no clamping.\n   * - `'stop'`: clamp at boundary, kill velocity component.\n   * - `'bounce'`: linear reflection — flip velocity sign, magnitude preserved.\n   * - `'spring'`: damped reflection — flip velocity sign and shrink magnitude\n   *   by `SPRING_DAMPING` per bounce so the motion settles naturally.\n   */\n  boundary?: 'stop' | 'bounce' | 'spring';\n  /** Starting position for internal boundary tracking. Required when `viewBounds` is set. */\n  initialPosition?: { x: number; y: number };\n  onTick: (dx: number, dy: number) => void;\n  onEnd?: () => void;\n}\n\n/**\n * Fraction of velocity preserved per `'spring'` bounce. 0.5 means each bounce\n * loses half its energy, giving a quick visible settle (typically 2–4 bounces\n * before `minSpeed` cuts the loop). Fixed for v1; a future `bounceDamping`\n * config option could expose this if a consumer needs control.\n */\nconst SPRING_DAMPING = 0.5;\n\n/** A rAF loop that coasts a value to a stop under friction, reporting the\n *  per-frame delta. What turns a released pan drag into momentum scrolling. */\nexport function useDecayLoop() {\n  const stateRef = useRef<{\n    vx: number; vy: number;\n    friction: number; minSpeed: number;\n    lastTime: number | null;\n    posX: number; posY: number;\n    viewBounds: PanBounds | undefined;\n    boundary: 'stop' | 'bounce' | 'spring' | undefined;\n    onTick: (dx: number, dy: number) => void;\n    onEnd?: () => void;\n  } | null>(null);\n\n  const frameLoop = useVisibleRaf(\n    (now: number) => { tick(now); },\n    {\n      // Coasting does not continue while suspended: dropping `lastTime` makes\n      // the resuming frame seed a fresh interval instead of applying an hour of\n      // friction at once, which would end the decay before it was seen.\n      onResume: useCallback(() => {\n        if (stateRef.current) stateRef.current.lastTime = null;\n      }, []),\n    },\n  );\n\n  const cancel = useCallback(() => {\n    frameLoop.cancel();\n    stateRef.current = null;\n  }, [frameLoop]);\n\n  const tick = useCallback((now: number) => {\n    const s = stateRef.current;\n    if (!s) return;\n    if (s.lastTime === null) {\n      s.lastTime = now;\n      frameLoop.request();\n      return;\n    }\n    const dt = Math.min(now - s.lastTime, 64);  // cap at 64ms to avoid huge jumps\n    s.lastTime = now;\n    // Time-normalize friction to 60fps baseline\n    const f = Math.pow(s.friction, dt / 16.67);\n    s.vx *= f;\n    s.vy *= f;\n    const speed = Math.sqrt(s.vx * s.vx + s.vy * s.vy);\n    if (speed < s.minSpeed) {\n      stateRef.current = null;\n      frameLoop.cancel();\n      s.onEnd?.();\n      return;\n    }\n    let dx = s.vx * dt;\n    let dy = s.vy * dt;\n    if (s.viewBounds && s.boundary) {\n      const { minX, maxX, minY, maxY } = s.viewBounds;\n      const newX = s.posX + dx;\n      const newY = s.posY + dy;\n      if (s.boundary === 'stop') {\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = 0; }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = 0; }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = 0; }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = 0; }\n      } else if (s.boundary === 'spring') {\n        // Damped reflection: flip sign AND scale magnitude by SPRING_DAMPING so\n        // each bounce loses energy. Once |v| < minSpeed the outer loop ends.\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = Math.abs(s.vx) * SPRING_DAMPING; }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = -Math.abs(s.vx) * SPRING_DAMPING; }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = Math.abs(s.vy) * SPRING_DAMPING; }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = -Math.abs(s.vy) * SPRING_DAMPING; }\n      } else {\n        if (minX !== undefined && newX < minX) { dx = minX - s.posX; s.vx = Math.abs(s.vx); }\n        else if (maxX !== undefined && newX > maxX) { dx = maxX - s.posX; s.vx = -Math.abs(s.vx); }\n        if (minY !== undefined && newY < minY) { dy = minY - s.posY; s.vy = Math.abs(s.vy); }\n        else if (maxY !== undefined && newY > maxY) { dy = maxY - s.posY; s.vy = -Math.abs(s.vy); }\n      }\n      s.posX += dx;\n      s.posY += dy;\n    }\n    s.onTick(dx, dy);\n    frameLoop.request();\n  }, [frameLoop]);\n\n  const start = useCallback((config: DecayLoopConfig) => {\n    cancel();\n    const { velocity, friction = 0.92, minSpeed = 0.01, viewBounds, boundary, initialPosition, onTick, onEnd } = config;\n    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);\n    if (speed < minSpeed) { onEnd?.(); return; }\n    stateRef.current = {\n      vx: velocity.vx, vy: velocity.vy, friction, minSpeed, lastTime: null,\n      posX: initialPosition?.x ?? 0, posY: initialPosition?.y ?? 0,\n      viewBounds, boundary,\n      onTick, onEnd,\n    };\n    frameLoop.request();\n  }, [cancel, frameLoop]);\n\n  useEffect(() => () => { cancel(); }, [cancel]);\n\n  return { start, cancel };\n}\n"],"mappings":"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"}