@weasel-js/core 1.10.1 → 1.11.1

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 * 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"}
+{"version":3,"file":"shapeKinds.js","names":[],"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  /** The tool family a kind with a tool belongs to: which built-in tool set\n   *  names it, and so which palette group it sits in. */\n  readonly family?: 'shape' | 'draw' | 'select' | 'type';\n  /** A node of this kind is a text node: an insert drops into its caret, and\n   *  its properties carry the text groups. Absent, it is not. */\n  readonly text?: 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, family: 'shape' },\n  ellipse: { tool: true, insertPreview: true, family: 'shape' },\n  line: { tool: true, insertPreview: true, family: 'shape' },\n  polygon: { tool: true, insertPreview: true, family: 'shape' },\n  star: { tool: true, insertPreview: true, family: 'shape' },\n  pen: { tool: true, insertPreview: false, family: 'draw' },\n  pencil: { tool: true, insertPreview: true, family: 'draw' },\n  lasso: { tool: true, insertPreview: false, family: 'select' },\n  text: { tool: true, insertPreview: true, text: true, family: 'type' },\n  sticky: { tool: true, insertPreview: true, text: true, family: 'type' },\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\n/** The shape-tool ids of one family, in declaration order. */\nexport function kitShapeKindsOf(family: NonNullable<ShapeKindDescriptor['family']>): BuiltinShapeToolId[] {\n  return KIT_SHAPE_KINDS.filter((k) => (SHAPE_KINDS as Record<string, ShapeKindDescriptor>)[k]!.family === family);\n}\n"],"mappings":";;;;;;AA+BA,IAAa,cAAc;CACzB,MAAM;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAQ;CACzD,SAAS;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAQ;CAC5D,MAAM;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAQ;CACzD,SAAS;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAQ;CAC5D,MAAM;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAQ;CACzD,KAAK;EAAE,MAAM;EAAM,eAAe;EAAO,QAAQ;CAAO;CACxD,QAAQ;EAAE,MAAM;EAAM,eAAe;EAAM,QAAQ;CAAO;CAC1D,OAAO;EAAE,MAAM;EAAM,eAAe;EAAO,QAAQ;CAAS;CAC5D,MAAM;EAAE,MAAM;EAAM,eAAe;EAAM,MAAM;EAAM,QAAQ;CAAO;CACpE,QAAQ;EAAE,MAAM;EAAM,eAAe;EAAM,MAAM;EAAM,QAAQ;CAAO;CACtE,OAAO;EAAE,MAAM;EAAO,eAAe;CAAK;AAC5C;;AAkBA,SAAgB,gBACd,OACA,OACsB;CACtB,OAAQ,OAAO,KAAK,KAAK,CAAC,CAA0B,QAAQ,MAAM,MAAM,EAAE,CAAC,MAAM;AACnF;;;AAIA,SAAgB,cAAc,MAA+C;CAC3E,OAAQ,YAAoD;AAC9D;;AAGA,IAAa,kBACX,gBAAgB,aAAa,MAAM;;AAGrC,SAAgB,gBAAgB,QAA0E;CACxG,OAAO,gBAAgB,QAAQ,MAAO,YAAoD,EAAE,CAAE,WAAW,MAAM;AACjH"}

package/dist/core/stableStringify.js

@@ -1,8 +1,9 @@
 //#region src/core/stableStringify.ts
-function e(e) {
-	return JSON.stringify(e, (e, t) => t && typeof t == "object" && !Array.isArray(t) ? Object.fromEntries(Object.entries(t).sort(([e], [t]) => e < t ? -1 : 1)) : t);
+/** JSON with object keys sorted, so two equal values produce one string. */
+function stableStringify(value) {
+	return JSON.stringify(value, (_key, v) => v && typeof v === "object" && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => a < b ? -1 : 1)) : v);
 }
-//#endregion
-export { e as stableStringify };
 
+//#endregion
+export { stableStringify };
 //# sourceMappingURL=stableStringify.js.map

package/dist/core/stableStringify.js.map

@@ -1 +1 @@
-{"version":3,"file":"stableStringify.js","names":["stableStringify","value","v","a","b"],"sources":["../../src/core/stableStringify.ts"],"sourcesContent":["/** JSON with object keys sorted, so two equal values produce one string. */\nexport function stableStringify(value: unknown): string {\n  return JSON.stringify(value, (_key, v) =>\n    v && typeof v === 'object' && !Array.isArray(v)\n      ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : 1)))\n      : v,\n  );\n}\n"],"mappings":";AACA,SAAgBA,EAAgB,GAAwB;CACtD,OAAO,KAAK,UAAUC,IAAQ,GAAM,MAClCC,KAAK,OAAOA,KAAM,YAAY,CAAC,MAAM,QAAQA,CAAC,IAC1C,OAAO,YAAY,OAAO,QAAQA,CAAC,CAAC,CAAC,MAAM,CAACC,IAAI,CAACC,OAAQD,IAAIC,IAAI,KAAK,CAAE,CAAC,IACzEF,CACN;AACF"}
+{"version":3,"file":"stableStringify.js","names":[],"sources":["../../src/core/stableStringify.ts"],"sourcesContent":["/** JSON with object keys sorted, so two equal values produce one string. */\nexport function stableStringify(value: unknown): string {\n  return JSON.stringify(value, (_key, v) =>\n    v && typeof v === 'object' && !Array.isArray(v)\n      ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : 1)))\n      : v,\n  );\n}\n"],"mappings":";;AACA,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,KAAK,UAAU,QAAQ,MAAM,MAClC,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,CAAC,IAC1C,OAAO,YAAY,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAQ,IAAI,IAAI,KAAK,CAAE,CAAC,IACzE,CACN;AACF"}

package/dist/core/stylus/stylus.js

@@ -1,39 +1,63 @@
-import { clientToWorld as e } from "../viewport/clientToWorld.js";
+import { clientToWorld } from "../viewport/clientToWorld.js";
+
 //#region src/core/stylus/stylus.ts
-function t(e, t = {}) {
-	let n = t.minWidth ?? .5, r = t.maxWidth ?? 6, i = t.gamma ?? 1.6, a = Math.max(0, Math.min(1, e)) ** i;
-	return n + (r - n) * a;
+/**
+* Map a 0..1 pressure value to a stroke width.
+*
+* `width(p) = minWidth + (maxWidth - minWidth) × p^gamma`
+*
+* Mouse / non-stylus inputs report `pressure === 0` (no button) or `0.5`
+* (button held); gate on `pointerType === 'pen'` upstream to give them a
+* constant width instead.
+*/
+function pressureToWidth(pressure, options = {}) {
+	const minWidth = options.minWidth ?? .5;
+	const maxWidth = options.maxWidth ?? 6;
+	const gamma = options.gamma ?? 1.6;
+	const shaped = Math.max(0, Math.min(1, pressure)) ** gamma;
+	return minWidth + (maxWidth - minWidth) * shaped;
 }
-function n(e) {
-	let t = e, n = e.pointerType ?? "";
+/** Extract a normalized stylus snapshot from any PointerEvent. Pure. */
+function getStylusData(e) {
+	const ext = e;
+	const pointerType = e.pointerType ?? "";
 	return {
 		pressure: e.pressure,
 		tiltX: e.tiltX ?? 0,
 		tiltY: e.tiltY ?? 0,
-		altitudeAngle: typeof t.altitudeAngle == "number" ? t.altitudeAngle : void 0,
-		azimuthAngle: typeof t.azimuthAngle == "number" ? t.azimuthAngle : void 0,
+		altitudeAngle: typeof ext.altitudeAngle === "number" ? ext.altitudeAngle : void 0,
+		azimuthAngle: typeof ext.azimuthAngle === "number" ? ext.azimuthAngle : void 0,
 		twist: e.twist ?? 0,
-		pointerType: n,
-		isStylus: n === "pen"
+		pointerType,
+		isStylus: pointerType === "pen"
 	};
 }
-function r(t, r, i) {
-	let a = t.getCoalescedEvents, o = typeof a == "function" ? a.call(t) : [], s = o.length > 0 ? o : [t];
-	for (let t of s) {
-		let [a, o] = [t.clientX - r.canvasRect.left, t.clientY - r.canvasRect.top], [s, c] = e(t.clientX, t.clientY, r.canvasRect, r.view);
-		i({
-			clientX: t.clientX,
-			clientY: t.clientY,
-			screenX: a,
-			screenY: o,
-			worldX: s,
-			worldY: c,
-			stylus: n(t),
-			event: t
+/**
+* Iterate coalesced sub-events of a `pointermove`, yielding a
+* `PointerSample` per sub-event with world coords already derived. When
+* `getCoalescedEvents` is unavailable or returns an empty list, the parent
+* event itself is yielded once.
+*/
+function forEachCoalesced(event, ctx, cb) {
+	const get = event.getCoalescedEvents;
+	const sub = typeof get === "function" ? get.call(event) : [];
+	const list = sub.length > 0 ? sub : [event];
+	for (const e of list) {
+		const [screenX, screenY] = [e.clientX - ctx.canvasRect.left, e.clientY - ctx.canvasRect.top];
+		const [worldX, worldY] = clientToWorld(e.clientX, e.clientY, ctx.canvasRect, ctx.view);
+		cb({
+			clientX: e.clientX,
+			clientY: e.clientY,
+			screenX,
+			screenY,
+			worldX,
+			worldY,
+			stylus: getStylusData(e),
+			event: e
 		});
 	}
 }
-//#endregion
-export { r as forEachCoalesced, n as getStylusData, t as pressureToWidth };
 
+//#endregion
+export { forEachCoalesced, getStylusData, pressureToWidth };
 //# sourceMappingURL=stylus.js.map

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 * 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"}
+{"version":3,"file":"stylus.js","names":[],"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,SAAgB,gBACd,UACA,UAAkC,CAAC,GAC3B;CACR,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,QAAQ,QAAQ,SAAS;CAE/B,MAAM,SADI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,QAAQ,CAC3B,KAAK;CACpB,OAAO,YAAY,WAAW,YAAY;AAC5C;;AAGA,SAAgB,cAAc,GAA6B;CACzD,MAAM,MAAM;CAIZ,MAAM,cAAc,EAAE,eAAe;CACrC,OAAO;EACL,UAAU,EAAE;EACZ,OAAO,EAAE,SAAS;EAClB,OAAO,EAAE,SAAS;EAClB,eAAe,OAAO,IAAI,kBAAkB,WAAW,IAAI,gBAAgB;EAC3E,cAAc,OAAO,IAAI,iBAAiB,WAAW,IAAI,eAAe;EACxE,OAAO,EAAE,SAAS;EAClB;EACA,UAAU,gBAAgB;CAC5B;AACF;;;;;;;AAgCA,SAAgB,iBACd,OACA,KACA,IACM;CAGN,MAAM,MAAO,MACV;CACH,MAAM,MAAM,OAAO,QAAQ,aAAa,IAAI,KAAK,KAAK,IAAI,CAAC;CAC3D,MAAM,OAAO,IAAI,SAAS,IAAI,MAAM,CAAC,KAAK;CAC1C,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,CAAC,SAAS,WAAW,CAAC,EAAE,UAAU,IAAI,WAAW,MAAM,EAAE,UAAU,IAAI,WAAW,GAAG;EAC3F,MAAM,CAAC,QAAQ,UAAU,cAAc,EAAE,SAAS,EAAE,SAAS,IAAI,YAAY,IAAI,IAAI;EACrF,GAAG;GACD,SAAS,EAAE;GACX,SAAS,EAAE;GACX;GACA;GACA;GACA;GACA,QAAQ,cAAc,CAAC;GACvB,OAAO;EACT,CAAC;CACH;AACF"}

package/dist/core/stylus/usePointerStylus.js

@@ -1,8 +1,9 @@
-import { getStylusData as e } from "./stylus.js";
-import { useEffect as t, useRef as n, useState as r } from "react";
-import { useLatest as i } from "@weasel-js/react";
+import { getStylusData } from "./stylus.js";
+import { useEffect, useRef, useState } from "react";
+import { useLatest } from "@weasel-js/react";
+
 //#region src/core/stylus/usePointerStylus.ts
-var a = {
+var IDLE = {
 	pressure: 0,
 	tiltX: 0,
 	tiltY: 0,
@@ -10,42 +11,68 @@ var a = {
 	azimuthAngle: void 0,
 	twist: 0,
 	pointerType: "",
-	isStylus: !1,
-	hovering: !1
+	isStylus: false,
+	hovering: false
 };
-function o(o, s = {}) {
-	let { maxFps: c = 60, stylusOnly: l = !1 } = s, [u, d] = r(a), f = n(-Infinity), p = i({
-		maxFps: c,
-		stylusOnly: l
+/**
+* Subscribe to pointer events on a target element (defaults to `window`)
+* and expose the most recent stylus snapshot.
+*
+* The hook does NOT consume pointerdown / pointerup — leave gesture handling
+* to the dispatcher. Re-renders are throttled by default (`maxFps`); pass
+* `maxFps: Infinity` to get every sample.
+*/
+function usePointerStylus(target, options = {}) {
+	const { maxFps = 60, stylusOnly = false } = options;
+	const [state, setState] = useState(IDLE);
+	const lastCommit = useRef(-Infinity);
+	const optsRef = useLatest({
+		maxFps,
+		stylusOnly
 	});
-	return t(() => {
-		let t = o == null ? window : o instanceof HTMLElement ? o : o.current ?? window, n = (t) => {
-			let n = t, { maxFps: r, stylusOnly: i } = p.current;
-			if (i && n.pointerType !== "pen") return;
-			let a = performance.now(), o = r > 0 && Number.isFinite(r) ? 1e3 / r : 0;
-			o > 0 && a - f.current < o || (f.current = a, d((t) => ({
-				...e(n),
-				hovering: t.hovering
-			})));
-		}, r = (e) => {
-			let t = e;
-			p.current.stylusOnly && t.pointerType !== "pen" || d((e) => ({
-				...e,
-				hovering: !0
+	useEffect(() => {
+		const el = target == null ? window : target instanceof HTMLElement ? target : target.current ?? window;
+		const onMove = (raw) => {
+			const e = raw;
+			const { maxFps, stylusOnly } = optsRef.current;
+			if (stylusOnly && e.pointerType !== "pen") return;
+			const now = performance.now();
+			const minGap = maxFps > 0 && Number.isFinite(maxFps) ? 1e3 / maxFps : 0;
+			if (minGap > 0 && now - lastCommit.current < minGap) return;
+			lastCommit.current = now;
+			setState((prev) => ({
+				...getStylusData(e),
+				hovering: prev.hovering
+			}));
+		};
+		const onEnter = (raw) => {
+			const e = raw;
+			if (optsRef.current.stylusOnly && e.pointerType !== "pen") return;
+			setState((prev) => ({
+				...prev,
+				hovering: true
 			}));
-		}, i = (e) => {
-			let t = e;
-			p.current.stylusOnly && t.pointerType !== "pen" || d((e) => ({
-				...e,
-				hovering: !1
+		};
+		const onLeave = (raw) => {
+			const e = raw;
+			if (optsRef.current.stylusOnly && e.pointerType !== "pen") return;
+			setState((prev) => ({
+				...prev,
+				hovering: false
 			}));
 		};
-		return t.addEventListener("pointermove", n), t.addEventListener("pointerenter", r), t.addEventListener("pointerleave", i), () => {
-			t.removeEventListener("pointermove", n), t.removeEventListener("pointerenter", r), t.removeEventListener("pointerleave", i);
+		el.addEventListener("pointermove", onMove);
+		el.addEventListener("pointerenter", onEnter);
+		el.addEventListener("pointerleave", onLeave);
+		return () => {
+			el.removeEventListener("pointermove", onMove);
+			el.removeEventListener("pointerenter", onEnter);
+			el.removeEventListener("pointerleave", onLeave);
 		};
-	}, [o, p]), u;
+	}, [target, optsRef]);
+	return state;
 }
-//#endregion
-export { o as usePointerStylus };
 
+//#endregion
+export { usePointerStylus };
 //# sourceMappingURL=usePointerStylus.js.map

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. */\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"}
+{"version":3,"file":"usePointerStylus.js","names":[],"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,IAAM,OAA2B;CAC/B,UAAU;CACV,OAAO;CACP,OAAO;CACP,eAAe;CACf,cAAc;CACd,OAAO;CACP,aAAa;CACb,UAAU;CACV,UAAU;AACZ;;;;;;;;;AAqBA,SAAgB,iBACd,QACA,UAAmC,CAAC,GAChB;CACpB,MAAM,EAAE,SAAS,IAAI,aAAa,UAAU;CAC5C,MAAM,CAAC,OAAO,YAAY,SAA6B,IAAI;CAG3D,MAAM,aAAa,OAAO,SAAS;CACnC,MAAM,UAAU,UAAU;EAAE;EAAQ;CAAW,CAAC;CAEhD,gBAAgB;EACd,MAAM,KACJ,UAAU,OACN,SACA,kBAAkB,cAChB,SACA,OAAO,WAAW;EAE1B,MAAM,UAAU,QAAe;GAC7B,MAAM,IAAI;GACV,MAAM,EAAE,QAAQ,eAAe,QAAQ;GACvC,IAAI,cAAc,EAAE,gBAAgB,OAAO;GAC3C,MAAM,MAAM,YAAY,IAAI;GAC5B,MAAM,SAAS,SAAS,KAAK,OAAO,SAAS,MAAM,IAAI,MAAO,SAAS;GACvE,IAAI,SAAS,KAAK,MAAM,WAAW,UAAU,QAAQ;GACrD,WAAW,UAAU;GACrB,UAAU,UAAU;IAAE,GAAG,cAAc,CAAC;IAAG,UAAU,KAAK;GAAS,EAAE;EACvE;EACA,MAAM,WAAW,QAAe;GAC9B,MAAM,IAAI;GACV,IAAI,QAAQ,QAAQ,cAAc,EAAE,gBAAgB,OAAO;GAC3D,UAAU,UAAU;IAAE,GAAG;IAAM,UAAU;GAAK,EAAE;EAClD;EACA,MAAM,WAAW,QAAe;GAC9B,MAAM,IAAI;GACV,IAAI,QAAQ,QAAQ,cAAc,EAAE,gBAAgB,OAAO;GAC3D,UAAU,UAAU;IAAE,GAAG;IAAM,UAAU;GAAM,EAAE;EACnD;EAEA,GAAG,iBAAiB,eAAe,MAAM;EACzC,GAAG,iBAAiB,gBAAgB,OAAO;EAC3C,GAAG,iBAAiB,gBAAgB,OAAO;EAC3C,aAAa;GACX,GAAG,oBAAoB,eAAe,MAAM;GAC5C,GAAG,oBAAoB,gBAAgB,OAAO;GAC9C,GAAG,oBAAoB,gBAAgB,OAAO;EAChD;CACF,GAAG,CAAC,QAAQ,OAAO,CAAC;CAEpB,OAAO;AACT"}

package/dist/core/usePaintKinds.js

@@ -1,17 +1,27 @@
-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";
+import { getPaintKind, listGradientKinds, listPaintKinds, paintKindRegistry } from "./paint/paintKinds.js";
+import { useCallback, useSyncExternalStore } from "react";
+
 //#region src/core/usePaintKinds.ts
-function o() {
-	return a(r.subscribe, n, n);
+/** Every registered paint kind, as {@link listPaintKinds} returns it,
+*  re-rendering the caller whenever a kind is registered or removed. */
+function usePaintKinds() {
+	return useSyncExternalStore(paintKindRegistry.subscribe, listPaintKinds, listPaintKinds);
 }
-function s() {
-	return a(r.subscribe, t, t);
+/** Every registered gradient kind, as {@link listGradientKinds} returns it,
+*  re-rendering the caller whenever a kind is registered or removed. */
+function useGradientKinds() {
+	return useSyncExternalStore(paintKindRegistry.subscribe, listGradientKinds, listGradientKinds);
 }
-function c(t) {
-	let n = i(() => e(t), [t]);
-	return a(r.subscribe, n, n);
+/**
+* The entry for `kind`, as {@link getPaintKind} returns it — `undefined` until
+* it is registered, and the new entry once it is. A kind with a loader starts
+* loading on the first read.
+*/
+function usePaintKind(kind) {
+	const read = useCallback(() => getPaintKind(kind), [kind]);
+	return useSyncExternalStore(paintKindRegistry.subscribe, read, read);
 }
-//#endregion
-export { s as useGradientKinds, c as usePaintKind, o as usePaintKinds };
 
+//#endregion
+export { useGradientKinds, usePaintKind, usePaintKinds };
 //# sourceMappingURL=usePaintKinds.js.map

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,\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"}
+{"version":3,"file":"usePaintKinds.js","names":[],"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,SAAgB,gBAA2C;CACzD,OAAO,qBAAqB,kBAAkB,WAAW,gBAAgB,cAAc;AACzF;;;AAIA,SAAgB,mBAA8C;CAC5D,OAAO,qBAAqB,kBAAkB,WAAW,mBAAmB,iBAAiB;AAC/F;;;;;;AAOA,SAAgB,aAAa,MAAsD;CACjF,MAAM,OAAO,kBAAkB,aAAa,IAAI,GAAG,CAAC,IAAI,CAAC;CACzD,OAAO,qBAAqB,kBAAkB,WAAW,MAAM,IAAI;AACrE"}

package/dist/core/viewport/clampView.js

@@ -1,24 +1,40 @@
 //#region src/core/viewport/clampView.ts
-function e(e, t, n) {
-	let r = Math.abs(n.width / e.scale.x), i = Math.abs(n.height / e.scale.y), a = e.scale.x < 0, o = e.scale.y < 0, s;
-	if (r >= t.width) s = t.x + (t.width - r) / 2 + (a ? r : 0);
+/**
+* Clamp a `View` so the visible world rect stays within `bounds`.
+*
+* Visible world rect = `[view.x, view.x + canvas.width / view.scale.x]` ×
+* `[view.y, view.y + canvas.height / view.scale.y]`.
+*
+* If the visible rect is larger than `bounds` along an axis (zoomed out
+* past the bounds extent), the view is centered on that axis so bounds
+* sits in the middle of the canvas.
+*/
+function clampView(view, bounds, canvas) {
+	const visW = Math.abs(canvas.width / view.scale.x);
+	const visH = Math.abs(canvas.height / view.scale.y);
+	const flipX = view.scale.x < 0;
+	const flipY = view.scale.y < 0;
+	let x;
+	if (visW >= bounds.width) x = bounds.x + (bounds.width - visW) / 2 + (flipX ? visW : 0);
 	else {
-		let n = a ? t.x + r : t.x, i = a ? t.x + t.width : t.x + t.width - r;
-		s = e.x < n ? n : e.x > i ? i : e.x;
+		const minX = flipX ? bounds.x + visW : bounds.x;
+		const maxX = flipX ? bounds.x + bounds.width : bounds.x + bounds.width - visW;
+		x = view.x < minX ? minX : view.x > maxX ? maxX : view.x;
 	}
-	let c;
-	if (i >= t.height) c = t.y + (t.height - i) / 2 + (o ? i : 0);
+	let y;
+	if (visH >= bounds.height) y = bounds.y + (bounds.height - visH) / 2 + (flipY ? visH : 0);
 	else {
-		let n = o ? t.y + i : t.y, r = o ? t.y + t.height : t.y + t.height - i;
-		c = e.y < n ? n : e.y > r ? r : e.y;
+		const minY = flipY ? bounds.y + visH : bounds.y;
+		const maxY = flipY ? bounds.y + bounds.height : bounds.y + bounds.height - visH;
+		y = view.y < minY ? minY : view.y > maxY ? maxY : view.y;
 	}
-	return s === e.x && c === e.y ? e : {
-		x: s,
-		y: c,
-		scale: e.scale
+	return x === view.x && y === view.y ? view : {
+		x,
+		y,
+		scale: view.scale
 	};
 }
-//#endregion
-export { e as clampView };
 
+//#endregion
+export { clampView };
 //# sourceMappingURL=clampView.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"clampView.js","names":["clampView","visW","canvas","view","visH","flipX","flipY","x","bounds","minX","maxX","y","minY","maxY"],"sources":["../../../src/core/viewport/clampView.ts"],"sourcesContent":["import type { View } from './view';\n\n/** The world rect a view is not allowed to show outside of. */\nexport interface ClampBounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Canvas dimensions in CSS pixels — needed to know how much world a view\n *  actually shows. */\nexport interface CanvasSize {\n  width: number;\n  height: number;\n}\n\n/**\n * Clamp a `View` so the visible world rect stays within `bounds`.\n *\n * Visible world rect = `[view.x, view.x + canvas.width / view.scale.x]` ×\n * `[view.y, view.y + canvas.height / view.scale.y]`.\n *\n * If the visible rect is larger than `bounds` along an axis (zoomed out\n * past the bounds extent), the view is centered on that axis so bounds\n * sits in the middle of the canvas.\n */\nexport function clampView(view: View, bounds: ClampBounds, canvas: CanvasSize): View {\n  // A negative scale is a flipped axis, so the visible rect runs the other way\n  // from `view.x`/`view.y`: its extent is the magnitude, and the anchor is the\n  // rect's far edge rather than its near one.\n  const visW = Math.abs(canvas.width / view.scale.x);\n  const visH = Math.abs(canvas.height / view.scale.y);\n  const flipX = view.scale.x < 0;\n  const flipY = view.scale.y < 0;\n\n  let x: number;\n  if (visW >= bounds.width) {\n    x = bounds.x + (bounds.width - visW) / 2 + (flipX ? visW : 0);\n  } else {\n    const minX = flipX ? bounds.x + visW : bounds.x;\n    const maxX = flipX ? bounds.x + bounds.width : bounds.x + bounds.width - visW;\n    x = view.x < minX ? minX : view.x > maxX ? maxX : view.x;\n  }\n\n  let y: number;\n  if (visH >= bounds.height) {\n    y = bounds.y + (bounds.height - visH) / 2 + (flipY ? visH : 0);\n  } else {\n    const minY = flipY ? bounds.y + visH : bounds.y;\n    const maxY = flipY ? bounds.y + bounds.height : bounds.y + bounds.height - visH;\n    y = view.y < minY ? minY : view.y > maxY ? maxY : view.y;\n  }\n\n  return x === view.x && y === view.y ? view : { x, y, scale: view.scale };\n}\n"],"mappings":";AA2BA,SAAgBA,EAAU,GAAY,GAAqB,GAA0B;CAInF,IAAMC,IAAO,KAAK,IAAIC,EAAO,QAAQC,EAAK,MAAM,CAAC,GAC3CC,IAAO,KAAK,IAAIF,EAAO,SAASC,EAAK,MAAM,CAAC,GAC5CE,IAAQF,EAAK,MAAM,IAAI,GACvBG,IAAQH,EAAK,MAAM,IAAI,GAEzBI;CACJ,IAAIN,KAAQO,EAAO,OACjB,IAAIA,EAAO,KAAKA,EAAO,QAAQP,KAAQ,KAAKI,IAAQJ,IAAO;MACtD;EACL,IAAMQ,IAAOJ,IAAQG,EAAO,IAAIP,IAAOO,EAAO,GACxCE,IAAOL,IAAQG,EAAO,IAAIA,EAAO,QAAQA,EAAO,IAAIA,EAAO,QAAQP;EACzE,IAAIE,EAAK,IAAIM,IAAOA,IAAON,EAAK,IAAIO,IAAOA,IAAOP,EAAK;CACzD;CAEA,IAAIQ;CACJ,IAAIP,KAAQI,EAAO,QACjB,IAAIA,EAAO,KAAKA,EAAO,SAASJ,KAAQ,KAAKE,IAAQF,IAAO;MACvD;EACL,IAAMQ,IAAON,IAAQE,EAAO,IAAIJ,IAAOI,EAAO,GACxCK,IAAOP,IAAQE,EAAO,IAAIA,EAAO,SAASA,EAAO,IAAIA,EAAO,SAASJ;EAC3E,IAAID,EAAK,IAAIS,IAAOA,IAAOT,EAAK,IAAIU,IAAOA,IAAOV,EAAK;CACzD;CAEA,OAAOI,MAAMJ,EAAK,KAAKQ,MAAMR,EAAK,IAAIA,IAAO;EAAE;EAAG;EAAG,OAAOA,EAAK;CAAM;AACzE"}
+{"version":3,"file":"clampView.js","names":[],"sources":["../../../src/core/viewport/clampView.ts"],"sourcesContent":["import type { View } from './view';\n\n/** The world rect a view is not allowed to show outside of. */\nexport interface ClampBounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Canvas dimensions in CSS pixels — needed to know how much world a view\n *  actually shows. */\nexport interface CanvasSize {\n  width: number;\n  height: number;\n}\n\n/**\n * Clamp a `View` so the visible world rect stays within `bounds`.\n *\n * Visible world rect = `[view.x, view.x + canvas.width / view.scale.x]` ×\n * `[view.y, view.y + canvas.height / view.scale.y]`.\n *\n * If the visible rect is larger than `bounds` along an axis (zoomed out\n * past the bounds extent), the view is centered on that axis so bounds\n * sits in the middle of the canvas.\n */\nexport function clampView(view: View, bounds: ClampBounds, canvas: CanvasSize): View {\n  // A negative scale is a flipped axis, so the visible rect runs the other way\n  // from `view.x`/`view.y`: its extent is the magnitude, and the anchor is the\n  // rect's far edge rather than its near one.\n  const visW = Math.abs(canvas.width / view.scale.x);\n  const visH = Math.abs(canvas.height / view.scale.y);\n  const flipX = view.scale.x < 0;\n  const flipY = view.scale.y < 0;\n\n  let x: number;\n  if (visW >= bounds.width) {\n    x = bounds.x + (bounds.width - visW) / 2 + (flipX ? visW : 0);\n  } else {\n    const minX = flipX ? bounds.x + visW : bounds.x;\n    const maxX = flipX ? bounds.x + bounds.width : bounds.x + bounds.width - visW;\n    x = view.x < minX ? minX : view.x > maxX ? maxX : view.x;\n  }\n\n  let y: number;\n  if (visH >= bounds.height) {\n    y = bounds.y + (bounds.height - visH) / 2 + (flipY ? visH : 0);\n  } else {\n    const minY = flipY ? bounds.y + visH : bounds.y;\n    const maxY = flipY ? bounds.y + bounds.height : bounds.y + bounds.height - visH;\n    y = view.y < minY ? minY : view.y > maxY ? maxY : view.y;\n  }\n\n  return x === view.x && y === view.y ? view : { x, y, scale: view.scale };\n}\n"],"mappings":";;;;;;;;;;;AA2BA,SAAgB,UAAU,MAAY,QAAqB,QAA0B;CAInF,MAAM,OAAO,KAAK,IAAI,OAAO,QAAQ,KAAK,MAAM,CAAC;CACjD,MAAM,OAAO,KAAK,IAAI,OAAO,SAAS,KAAK,MAAM,CAAC;CAClD,MAAM,QAAQ,KAAK,MAAM,IAAI;CAC7B,MAAM,QAAQ,KAAK,MAAM,IAAI;CAE7B,IAAI;CACJ,IAAI,QAAQ,OAAO,OACjB,IAAI,OAAO,KAAK,OAAO,QAAQ,QAAQ,KAAK,QAAQ,OAAO;MACtD;EACL,MAAM,OAAO,QAAQ,OAAO,IAAI,OAAO,OAAO;EAC9C,MAAM,OAAO,QAAQ,OAAO,IAAI,OAAO,QAAQ,OAAO,IAAI,OAAO,QAAQ;EACzE,IAAI,KAAK,IAAI,OAAO,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK;CACzD;CAEA,IAAI;CACJ,IAAI,QAAQ,OAAO,QACjB,IAAI,OAAO,KAAK,OAAO,SAAS,QAAQ,KAAK,QAAQ,OAAO;MACvD;EACL,MAAM,OAAO,QAAQ,OAAO,IAAI,OAAO,OAAO;EAC9C,MAAM,OAAO,QAAQ,OAAO,IAAI,OAAO,SAAS,OAAO,IAAI,OAAO,SAAS;EAC3E,IAAI,KAAK,IAAI,OAAO,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK;CACzD;CAEA,OAAO,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI,OAAO;EAAE;EAAG;EAAG,OAAO,KAAK;CAAM;AACzE"}

package/dist/core/viewport/clientToWorld.js

@@ -1,8 +1,19 @@
 //#region src/core/viewport/clientToWorld.ts
-function e(e, t, n, r) {
-	return [(e - n.left) / r.scale.x + r.x, (t - n.top) / r.scale.y + r.y];
+/**
+* Map a browser client coord pair to world coords.
+*
+* @param clientX  - `event.clientX`
+* @param clientY  - `event.clientY`
+* @param origin   - client-space origin of the surface `view` is a camera on.
+*   For a whole canvas that is its bounding rect. For a viewport node it is
+*   the canvas rect offset by the viewport's own rect, so the same call maps
+*   into that viewport's inner world.
+* @param view     - current viewport transform
+*/
+function clientToWorld(clientX, clientY, origin, view) {
+	return [(clientX - origin.left) / view.scale.x + view.x, (clientY - origin.top) / view.scale.y + view.y];
 }
-//#endregion
-export { e as clientToWorld };
 
+//#endregion
+export { clientToWorld };
 //# sourceMappingURL=clientToWorld.js.map

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` (`{ 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":[],"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,SAAgB,cACd,SACA,SACA,QACA,MACkB;CAClB,OAAO,EACJ,UAAU,OAAO,QAAQ,KAAK,MAAM,IAAI,KAAK,IAC7C,UAAU,OAAO,OAAO,KAAK,MAAM,IAAI,KAAK,CAC/C;AACF"}

package/dist/core/viewport/createVelocityTracker.js

@@ -1,39 +1,43 @@
 //#region src/core/viewport/createVelocityTracker.ts
-function e() {
-	let e = [];
+/** Hook-free velocity tracker. `useVelocityTracker` wraps one of these; the
+*  action layer builds its own, because an Action descriptor is a static
+*  object and cannot call hooks. */
+function createVelocityTracker() {
+	let samples = [];
 	return {
-		record(t, n, r) {
-			e.push({
-				dx: t,
-				dy: n,
-				t: r
+		record(dx, dy, t) {
+			samples.push({
+				dx,
+				dy,
+				t
 			});
-			let i = r - 100;
-			e = e.filter((e) => e.t >= i);
+			const cutoff = t - 100;
+			samples = samples.filter((s) => s.t >= cutoff);
 		},
 		getVelocity() {
-			let t = e;
-			if (t.length < 2) return {
+			const s = samples;
+			if (s.length < 2) return {
 				vx: 0,
 				vy: 0
 			};
-			let n = t[t.length - 1].t - t[0].t;
-			if (n === 0) return {
+			const dt = s[s.length - 1].t - s[0].t;
+			if (dt === 0) return {
 				vx: 0,
 				vy: 0
 			};
-			let r = t.slice(1).reduce((e, t) => e + t.dx, 0), i = t.slice(1).reduce((e, t) => e + t.dy, 0);
+			const totalDx = s.slice(1).reduce((acc, p) => acc + p.dx, 0);
+			const totalDy = s.slice(1).reduce((acc, p) => acc + p.dy, 0);
 			return {
-				vx: r / n,
-				vy: i / n
+				vx: totalDx / dt,
+				vy: totalDy / dt
 			};
 		},
 		reset() {
-			e = [];
+			samples = [];
 		}
 	};
 }
-//#endregion
-export { e as createVelocityTracker };
 
+//#endregion
+export { createVelocityTracker };
 //# sourceMappingURL=createVelocityTracker.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"createVelocityTracker.js","names":["createVelocityTracker","samples","cutoff","t","s","dt","totalDx","acc","p","totalDy"],"sources":["../../../src/core/viewport/createVelocityTracker.ts"],"sourcesContent":["interface Sample { dx: number; dy: number; t: number }\n\n/** Records recent deltas and reports the current velocity, averaged over the\n *  last 100ms — the throw speed a momentum decay starts from. */\nexport interface VelocityTracker {\n  record(dx: number, dy: number, t: number): void;\n  getVelocity(): { vx: number; vy: number };\n  reset(): void;\n}\n\n/** Hook-free velocity tracker. `useVelocityTracker` wraps one of these; the\n *  action layer builds its own, because an Action descriptor is a static\n *  object and cannot call hooks. */\nexport function createVelocityTracker(): VelocityTracker {\n  let samples: Sample[] = [];\n  return {\n    record(dx, dy, t) {\n      samples.push({ dx, dy, t });\n      const cutoff = t - 100;\n      samples = samples.filter(s => s.t >= cutoff);\n    },\n    getVelocity() {\n      const s = samples;\n      if (s.length < 2) return { vx: 0, vy: 0 };\n      const dt = s[s.length - 1].t - s[0].t;\n      if (dt === 0) return { vx: 0, vy: 0 };\n      const totalDx = s.slice(1).reduce((acc, p) => acc + p.dx, 0);\n      const totalDy = s.slice(1).reduce((acc, p) => acc + p.dy, 0);\n      return { vx: totalDx / dt, vy: totalDy / dt };\n    },\n    reset() { samples = []; },\n  };\n}\n"],"mappings":";AAaA,SAAgBA,IAAyC;CACvD,IAAIC,IAAoB,CAAC;CACzB,OAAO;EACL,OAAO,GAAI,GAAI,GAAG;GAChB,EAAQ,KAAK;IAAE;IAAI;IAAI;GAAE,CAAC;GAC1B,IAAMC,IAASC,IAAI;GACnB,IAAUF,EAAQ,QAAO,MAAKG,EAAE,KAAKF,CAAM;EAC7C;EACA,cAAc;GACZ,IAAME,IAAIH;GACV,IAAIG,EAAE,SAAS,GAAG,OAAO;IAAE,IAAI;IAAG,IAAI;GAAE;GACxC,IAAMC,IAAKD,EAAEA,EAAE,SAAS,EAAE,CAAC,IAAIA,EAAE,EAAE,CAAC;GACpC,IAAIC,MAAO,GAAG,OAAO;IAAE,IAAI;IAAG,IAAI;GAAE;GACpC,IAAMC,IAAUF,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,GAAK,MAAMG,IAAMC,EAAE,IAAI,CAAC,GACrDC,IAAUL,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,GAAK,MAAMG,IAAMC,EAAE,IAAI,CAAC;GAC3D,OAAO;IAAE,IAAIF,IAAUD;IAAI,IAAII,IAAUJ;GAAG;EAC9C;EACA,QAAQ;GAAE,IAAU,CAAC;EAAG;CAC1B;AACF"}
+{"version":3,"file":"createVelocityTracker.js","names":[],"sources":["../../../src/core/viewport/createVelocityTracker.ts"],"sourcesContent":["interface Sample { dx: number; dy: number; t: number }\n\n/** Records recent deltas and reports the current velocity, averaged over the\n *  last 100ms — the throw speed a momentum decay starts from. */\nexport interface VelocityTracker {\n  record(dx: number, dy: number, t: number): void;\n  getVelocity(): { vx: number; vy: number };\n  reset(): void;\n}\n\n/** Hook-free velocity tracker. `useVelocityTracker` wraps one of these; the\n *  action layer builds its own, because an Action descriptor is a static\n *  object and cannot call hooks. */\nexport function createVelocityTracker(): VelocityTracker {\n  let samples: Sample[] = [];\n  return {\n    record(dx, dy, t) {\n      samples.push({ dx, dy, t });\n      const cutoff = t - 100;\n      samples = samples.filter(s => s.t >= cutoff);\n    },\n    getVelocity() {\n      const s = samples;\n      if (s.length < 2) return { vx: 0, vy: 0 };\n      const dt = s[s.length - 1].t - s[0].t;\n      if (dt === 0) return { vx: 0, vy: 0 };\n      const totalDx = s.slice(1).reduce((acc, p) => acc + p.dx, 0);\n      const totalDy = s.slice(1).reduce((acc, p) => acc + p.dy, 0);\n      return { vx: totalDx / dt, vy: totalDy / dt };\n    },\n    reset() { samples = []; },\n  };\n}\n"],"mappings":";;;;AAaA,SAAgB,wBAAyC;CACvD,IAAI,UAAoB,CAAC;CACzB,OAAO;EACL,OAAO,IAAI,IAAI,GAAG;GAChB,QAAQ,KAAK;IAAE;IAAI;IAAI;GAAE,CAAC;GAC1B,MAAM,SAAS,IAAI;GACnB,UAAU,QAAQ,QAAO,MAAK,EAAE,KAAK,MAAM;EAC7C;EACA,cAAc;GACZ,MAAM,IAAI;GACV,IAAI,EAAE,SAAS,GAAG,OAAO;IAAE,IAAI;IAAG,IAAI;GAAE;GACxC,MAAM,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;GACpC,IAAI,OAAO,GAAG,OAAO;IAAE,IAAI;IAAG,IAAI;GAAE;GACpC,MAAM,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,MAAM,EAAE,IAAI,CAAC;GAC3D,MAAM,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,MAAM,EAAE,IAAI,CAAC;GAC3D,OAAO;IAAE,IAAI,UAAU;IAAI,IAAI,UAAU;GAAG;EAC9C;EACA,QAAQ;GAAE,UAAU,CAAC;EAAG;CAC1B;AACF"}