@weasel-js/core 1.7.0 → 1.7.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStandardActions.js","names":["KIT_STANDARD_DESCRIPTORS","escapeAction","cancelGestureAction","selectAllAction","duplicateAction","deleteAction","groupAction","ungroupAction","undoAction","redoAction","flipAction","nudgeUpAction","nudgeDownAction","nudgeLeftAction","nudgeRightAction","reorderForwardAction","reorderBackwardAction","alignLeftAction","alignCenterXAction","alignRightAction","alignTopAction","alignCenterYAction","alignBottomAction","distributeHorizontalAction","distributeVerticalAction","pathfinderUnionAction","pathfinderSubtractAction","pathfinderIntersectAction","pathfinderExcludeAction","pathfinderDivideAction","pathfinderCropAction","createOutlinesAction","moveAction","resizeAction","rotateAction","areaSelectAction","insertAction","insertRotateAction","cloneAction","editAnchorsAction","enterPathEditAction","exitPathEditAction","insertPathAnchorAction","nudgeAnchorsUpAction","nudgeAnchorsDownAction","nudgeAnchorsLeftAction","nudgeAnchorsRightAction","deleteAnchorsAction","cutPathAtAnchorAction","marqueeAnchorsAction","selectAnchorAction","lassoSelectAction","pinchZoomAction","viewportDragPanAction","clearSelectionAction","enterTextEditAction","setFillAction","setStrokeAction","setFillOpacityAction","setStrokeOpacityAction","ingestAction","clipboardCutAction","clipboardCopyAction","clipboardPasteAction","KIT_STANDARD_ACTION_IDS","a","useStandardActions","optsRef","useLatest","opts","activeToolCtx","useOptionalActiveToolContext","activeToolCtxRef","depReg","useOptionalDepRegistry","unregisters","key","u","reg","useActionsRegistry","excludeKey","excluded"],"sources":["../../../src/interactions/actions/useStandardActions.ts"],"sourcesContent":["/**\n * @experimental\n * `useStandardActions` — register the kit-standard action descriptors into the\n * nearest `<ActionsProvider>` and publish dep sources into the nearest\n * `<DepRegistryProvider>`.\n *\n * Instead of calling closure-style factories, this hook registers each dep as\n * a live source and each kit-standard descriptor's `invoker` directly.\n *\n * Falls back silently to a no-op when no `<ActionsProvider>` or\n * `<DepRegistryProvider>` is in scope.\n */\nimport { useEffect } from 'react';\nimport type { Action } from '@weasel-js/routing';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { type DepName, type DepSchema } from '@weasel-js/routing';\nimport { useOptionalDepRegistry } from '@weasel-js/routing/react';\n// Reaches depSchema.ts so tsup's per-entry dts compiler resolves `DepSchema['selection']`\n// here; `tsc --noEmit` happens to pick it up via test files, tsup does not. It MUST be\n// `import type` — a bare `import './depSchema'` makes esbuild emit a runtime import that it\n// then drops under the package's `sideEffects: false`, warning on every build.\nimport type {} from './depSchema';\nimport { useOptionalActiveToolContext } from '@weasel-js/routing/react';\n\nimport { escapeAction } from './defaults/escape';\nimport { cancelGestureAction } from './defaults/cancelGesture';\nimport { selectAllAction } from './defaults/selectAll';\nimport { deleteAction } from './defaults/delete';\nimport { duplicateAction } from './defaults/duplicate';\nimport { groupAction, ungroupAction } from './defaults/group';\nimport { undoAction, redoAction } from './defaults/undoRedo';\nimport { flipAction } from './defaults/flip';\nimport {\n  nudgeUpAction, nudgeDownAction, nudgeLeftAction, nudgeRightAction,\n} from './defaults/nudge';\nimport { reorderForwardAction, reorderBackwardAction } from './defaults/reorder';\nimport {\n  alignLeftAction, alignRightAction, alignTopAction, alignBottomAction,\n  alignCenterXAction, alignCenterYAction,\n} from './defaults/align';\nimport {\n  distributeHorizontalAction, distributeVerticalAction,\n} from './defaults/distribute';\nimport {\n  pathfinderUnionAction, pathfinderSubtractAction, pathfinderIntersectAction,\n  pathfinderExcludeAction, pathfinderDivideAction, pathfinderCropAction,\n} from './defaults/booleans';\nimport { createOutlinesAction } from './defaults/createOutlines';\nimport { moveAction } from './defaults/move';\nimport { resizeAction } from './defaults/resize';\nimport { rotateAction } from './defaults/rotate';\nimport { areaSelectAction } from './defaults/areaSelect';\nimport { insertAction, insertRotateAction } from './defaults/insert';\nimport { clearSelectionAction } from './defaults/clearSelection';\nimport { cloneAction } from './defaults/clone';\nimport { editAnchorsAction } from './defaults/editAnchors';\nimport { enterPathEditAction } from './defaults/enterPathEdit';\nimport { exitPathEditAction } from './defaults/exitPathEdit';\nimport { insertPathAnchorAction } from './defaults/insertPathAnchor';\nimport {\n  nudgeAnchorsUpAction,\n  nudgeAnchorsDownAction,\n  nudgeAnchorsLeftAction,\n  nudgeAnchorsRightAction,\n  deleteAnchorsAction,\n  cutPathAtAnchorAction,\n  marqueeAnchorsAction,\n  selectAnchorAction,\n} from './defaults/anchorEditing';\nimport { lassoSelectAction } from './defaults/lassoSelect';\nimport { pinchZoomAction } from './defaults/pinchZoom';\nimport { viewportDragPanAction } from './defaults/viewportDragPan';\nimport { enterTextEditAction } from './defaults/enterTextEdit';\nimport { setFillAction } from './defaults/setFill';\nimport { setStrokeAction } from './defaults/setStroke';\nimport { setFillOpacityAction } from './defaults/setFillOpacity';\nimport { setStrokeOpacityAction } from './defaults/setStrokeOpacity';\nimport { ingestAction } from './defaults/ingest';\nimport { clipboardCopyAction, clipboardCutAction, clipboardPasteAction } from './defaults/clipboard';\n\n// viewportWheelPanAction / viewportZoomAction are NOT in KIT_STANDARD_DESCRIPTORS.\n// They are wired conditionally by SceneCanvas via `useViewportActions`\n// based on the `viewport.pan` / `viewport.zoom` flags.\n\n/** @experimental */\nexport interface UseStandardActionsOptions {\n  /** Kit selection state — ids of currently selected nodes. */\n  selection?: DepSchema['selection'];\n  /** Current viewport — camera position + scale. */\n  view?: DepSchema['view'];\n  /** Scene tree — structural reads + undoable mutations. */\n  scene?: DepSchema['scene'];\n  /** Undo/redo history bound to the current scene. */\n  history?: DepSchema['history'];\n  /** Currently active tool id + hotkey-hold stack. */\n  activeTool?: DepSchema['activeTool'];\n  /**\n   * Ids of kit-standard actions to leave unregistered, so a consumer can bind\n   * its own. Ids that name no kit action are ignored;\n   * `KIT_STANDARD_ACTION_IDS` is the full list.\n   */\n  exclude?: Iterable<string>;\n}\n\n/**\n * The ordered list of all kit-standard action descriptors. Each descriptor\n * carries an `invoker` that reads from the dep registry at dispatch time.\n *\n * `viewport.pan` and `viewport.zoom` are NOT in this list — they're registered\n * conditionally by SceneCanvas's `useViewportActions` based on the\n * `viewport.pan` / `viewport.zoom` flags. See `src/canvas/SceneCanvas/useViewportActions.ts`.\n */\nconst KIT_STANDARD_DESCRIPTORS: Action[] = [\n  escapeAction,\n  cancelGestureAction,\n  selectAllAction,\n  duplicateAction,\n  deleteAction,\n  groupAction,\n  ungroupAction,\n  undoAction,\n  redoAction,\n  flipAction,\n  nudgeUpAction,\n  nudgeDownAction,\n  nudgeLeftAction,\n  nudgeRightAction,\n  reorderForwardAction,\n  reorderBackwardAction,\n  alignLeftAction,\n  alignCenterXAction,\n  alignRightAction,\n  alignTopAction,\n  alignCenterYAction,\n  alignBottomAction,\n  distributeHorizontalAction,\n  distributeVerticalAction,\n  pathfinderUnionAction,\n  pathfinderSubtractAction,\n  pathfinderIntersectAction,\n  pathfinderExcludeAction,\n  pathfinderDivideAction,\n  pathfinderCropAction,\n  createOutlinesAction,\n  moveAction,\n  resizeAction,\n  rotateAction,\n  areaSelectAction,\n  insertAction,\n  insertRotateAction,\n  cloneAction,\n  editAnchorsAction,\n  enterPathEditAction,\n  exitPathEditAction,\n  insertPathAnchorAction,\n  nudgeAnchorsUpAction,\n  nudgeAnchorsDownAction,\n  nudgeAnchorsLeftAction,\n  nudgeAnchorsRightAction,\n  deleteAnchorsAction,\n  cutPathAtAnchorAction,\n  marqueeAnchorsAction,\n  selectAnchorAction,\n  lassoSelectAction,\n  pinchZoomAction,\n  viewportDragPanAction,\n  clearSelectionAction,\n  enterTextEditAction,\n  setFillAction,\n  setStrokeAction,\n  setFillOpacityAction,\n  setStrokeOpacityAction,\n  ingestAction,\n  clipboardCutAction,\n  clipboardCopyAction,\n  clipboardPasteAction,\n];\n\n/** Every id `useStandardActions` registers, in registration order. */\nexport const KIT_STANDARD_ACTION_IDS: readonly string[] =\n  KIT_STANDARD_DESCRIPTORS.map((a) => a.id);\n\n/**\n * @experimental\n * Register each kit-standard dep source and action descriptor into the\n * surrounding providers.\n *\n * **Provider requirements:** both `<ActionsProvider>` and\n * `<DepRegistryProvider>` must be in scope (typically provided by\n * `<SceneCanvas>`). The hook falls back silently to a no-op when either\n * provider is absent.\n *\n * **Dep registration:** each non-undefined option is published as a live source\n * in the dep registry under its canonical name (`selection`, `scene`, …). The\n * source thunk reads the latest option value at invocation time via a ref, so\n * consumers don't have to memoize their dep objects.\n */\nexport function useStandardActions(opts: UseStandardActionsOptions): void {\n  // --- Stabilize opts via ref ---\n  const optsRef = useLatest(opts);\n\n  // --- activeTool fallback: read from context when not supplied in opts ---\n  // Falls back to null when no <ActiveToolContextProvider> is in scope\n  // (preserves silent-no-op contract for consumers that mount without SceneCanvas).\n  const activeToolCtx = useOptionalActiveToolContext();\n  const activeToolCtxRef = useLatest(activeToolCtx);\n\n  // --- Dep source registration ---\n  // Must be unconditional (rules of hooks). Each effect only registers when a\n  // provider is present (depReg !== null guard is inside the effect body).\n  const depReg = useOptionalDepRegistry();\n\n  useEffect(() => {\n    if (!depReg) return;\n    const unregisters: Array<() => void> = [];\n    const keys = ['selection', 'view', 'scene', 'history'] as const;\n    for (const key of keys) {\n      unregisters.push(\n        depReg.register(key as DepName, () => optsRef.current[key] as DepSchema[DepName]),\n      );\n    }\n    // activeTool: prefer the explicit opt; fall back to the context value so\n    // SceneCanvas doesn't need to thread it through StandardActionsRegistrar.\n    unregisters.push(\n      depReg.register('activeTool' as DepName, () =>\n        (optsRef.current.activeTool ?? activeToolCtxRef.current) as DepSchema[DepName],\n      ),\n    );\n    return () => { for (const u of unregisters) u(); };\n  }, [depReg, optsRef, activeToolCtxRef]);\n\n  // --- Action descriptor registration with legacy run bridge ---\n  const reg = useActionsRegistry();\n\n  // Joined so a fresh array of the same ids does not re-register every render.\n  const excludeKey = opts.exclude ? [...opts.exclude].join('\\u0000') : '';\n\n  useEffect(() => {\n    if (!reg || !depReg) return;\n    // `withLegacyRunBridge` is gone. Kit-standard descriptors\n    // register their `invoker` directly. `registry.trigger(id)` reads from the\n    // dep registry to build deps when calling `invoker.run` (so ActionBar /\n    // palette callers still work without a per-action `run` thunk).\n    const excluded = new Set(excludeKey ? excludeKey.split('\\u0000') : []);\n    const unregisters = KIT_STANDARD_DESCRIPTORS\n      .filter((a) => !excluded.has(a.id))\n      .map((a) => reg.register(a));\n    return () => { for (const u of unregisters) u(); };\n  }, [reg, depReg, excludeKey]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiHA,IAAMA,IAAqC;CACzCC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;AACF,GAGaC,KACXhE,EAAyB,KAAK,MAAMiE,EAAE,EAAE;AAiB1C,SAAgBC,GAAmB,GAAuC;CAExE,IAAMC,IAAUC,EAAUC,CAAI,GAKxBC,IAAgBC,GAA6B,GAC7CC,IAAmBJ,EAAUE,CAAa,GAK1CG,IAASC,GAAuB;CAEtC,QAAgB;EACd,IAAI,CAACD,GAAQ;EACb,IAAME,IAAiC,CAAC;EAExC,KAAK,IAAMC,KAAO;GADJ;GAAa;GAAQ;GAAS;EAC1B,GAChB,EAAY,KACVH,EAAO,SAASG,SAAsBT,EAAQ,QAAQS,EAA0B,CAClF;EASF,OALAD,EAAY,KACVF,EAAO,SAAS,oBACbN,EAAQ,QAAQ,cAAcK,EAAiB,OAClD,CACF,SACa;GAAE,KAAK,IAAMK,KAAKF,GAAa,EAAE;EAAG;CACnD,GAAG;EAACF;EAAQN;EAASK;CAAgB,CAAC;CAGtC,IAAMM,IAAMC,GAAmB,GAGzBC,IAAaX,EAAK,UAAU,CAAC,GAAGA,EAAK,OAAO,CAAC,CAAC,KAAK,IAAQ,IAAI;CAErE,QAAgB;EACd,IAAI,CAACS,KAAO,CAACL,GAAQ;EAKrB,IAAMQ,IAAW,IAAI,IAAID,IAAaA,EAAW,MAAM,IAAQ,IAAI,CAAC,CAAC,GAC/DL,IAAc3E,EACjB,QAAQ,MAAM,CAACiF,EAAS,IAAIhB,EAAE,EAAE,CAAC,CAAC,CAClC,KAAK,MAAMa,EAAI,SAASb,CAAC,CAAC;EAC7B,aAAa;GAAE,KAAK,IAAMY,KAAKF,GAAa,EAAE;EAAG;CACnD,GAAG;EAACG;EAAKL;EAAQO;CAAU,CAAC;AAC9B"}

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

@@ -0,0 +1,111 @@
+import { useCallback as e, useMemo as t, useRef as n, useState as r } from "react";
+import { useLatest as i } from "@weasel-js/react";
+//#region src/interactions/gestures/dragGesture/dragGesture.ts
+function a(a = {}) {
+	let o = i(a), s = n(null), [, c] = r(0), l = n("idle"), u = e((e) => {
+		l.current = e, c((e) => e + 1);
+	}, []), d = e(() => {
+		let e = s.current;
+		return {
+			get start() {
+				return e.start;
+			},
+			get current() {
+				return e.current;
+			},
+			get modifiers() {
+				return e.modifiers;
+			},
+			get scratch() {
+				return e.scratch;
+			},
+			get phase() {
+				return e.phase;
+			}
+		};
+	}, []), f = e((e, t) => {
+		let n = o.current, r = n.initScratch ? n.initScratch() : {}, i = n.thresholdReached ? "pending" : "active";
+		s.current = {
+			phase: i,
+			start: e,
+			current: e,
+			modifiers: t,
+			scratch: r
+		}, u(i), n.onGestureStart?.(), n.onStart?.(d());
+	}, [
+		d,
+		u,
+		o
+	]), p = e((e, t) => {
+		let n = s.current;
+		if (!n) return !1;
+		n.current = e, n.modifiers = t;
+		let r = o.current;
+		if (n.phase === "pending" && r.thresholdReached) {
+			let e = d();
+			r.thresholdReached(e) && (n.phase = "active", u("active"), r.onActivate?.(d()));
+		}
+		return r.onMove?.(d()), !0;
+	}, [
+		d,
+		u,
+		o
+	]), m = e(() => {
+		let e = s.current, t = o.current;
+		if (!e) {
+			t.onGestureEnd?.(!1);
+			return;
+		}
+		let n = {
+			get start() {
+				return e.start;
+			},
+			get current() {
+				return e.current;
+			},
+			get modifiers() {
+				return e.modifiers;
+			},
+			get scratch() {
+				return e.scratch;
+			},
+			get phase() {
+				return e.phase;
+			},
+			wasSubThreshold: e.phase === "pending"
+		}, r = !1;
+		try {
+			r = t.onEnd?.(n) !== !1;
+		} finally {
+			s.current = null, u("idle"), t.onGestureEnd?.(r);
+		}
+	}, [u, o]), h = e(() => {
+		let e = s.current, t = o.current;
+		e && t.onCancel?.(d()), s.current = null, u("idle"), t.onGestureEnd?.(!1);
+	}, [
+		d,
+		u,
+		o
+	]);
+	return t(() => ({
+		start: f,
+		move: p,
+		end: m,
+		cancel: h,
+		get phase() {
+			return l.current;
+		},
+		get isActive() {
+			return l.current !== "idle";
+		}
+	}), [
+		f,
+		p,
+		m,
+		h
+	]);
+}
+//#endregion
+export { a as useDragGesture };
+
+//# sourceMappingURL=dragGesture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dragGesture.js","names":["useDragGesture","optsRef","useLatest","options","stateRef","useRef","setPhaseTick","useState","phaseRef","bumpPhase","useCallback","next","n","buildCtx","s","start","opts","scratch","initialPhase","point","move","modifiers","ctx","end","endCtx","committed","cancel","useMemo"],"sources":["../../../../src/interactions/gestures/dragGesture/dragGesture.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ModifierState } from '../types';\n\n/** Pointer position in both world (gesture-coord) and client (CSS-px) space. */\nexport interface DragGesturePoint {\n  worldX: number;\n  worldY: number;\n  clientX: number;\n  clientY: number;\n}\n\n/** Phase exposed on the public controller and inside ctx for callbacks. */\nexport type DragGesturePhase = 'idle' | 'pending' | 'active';\n\n/** Live gesture context handed to lifecycle callbacks. Within callbacks, ctx\n *  reflects the moment the callback fires (e.g. ctx.phase is 'active' inside\n *  onActivate, even though the move that triggered it was during 'pending'). */\nexport interface DragGestureCtx<TScratch = unknown> {\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n  /** 'pending' or 'active'. Never 'idle' inside a callback. */\n  phase: 'pending' | 'active';\n}\n\n/** The context handed to `onEnd`, adding whether the gesture ever passed its\n *  activation threshold. */\nexport interface DragGestureEndCtx<TScratch = unknown>\n  extends DragGestureCtx<TScratch> {\n  /** True if phase never reached 'active'. Wrappers without thresholdReached\n   *  always see false here (their gesture activates at start()). */\n  wasSubThreshold: boolean;\n}\n\n/** Options for `useDragGesture`: when the gesture becomes active, and what to\n *  do at each point in its lifecycle. */\nexport interface UseDragGestureOptions<TScratch = unknown> {\n  initScratch?: () => TScratch;\n  /** Predicate consulted on each move while phase === 'pending'. Return true\n   *  to transition to 'active'. The transition fires onActivate before the\n   *  triggering move's onMove. When omitted, gesture activates at start(). */\n  thresholdReached?: (ctx: DragGestureCtx<TScratch>) => boolean;\n  onStart?: (ctx: DragGestureCtx<TScratch>) => void;\n  onActivate?: (ctx: DragGestureCtx<TScratch>) => void;\n  onMove?: (ctx: DragGestureCtx<TScratch>) => void;\n  onEnd?: (ctx: DragGestureEndCtx<TScratch>) => boolean | void;\n  onCancel?: (ctx: DragGestureCtx<TScratch>) => void;\n  onGestureStart?: () => void;\n  onGestureEnd?: (committed: boolean) => void;\n}\n\n/** Drives a drag gesture. The owner feeds it pointer positions; it decides\n *  when the drag has really begun and calls back accordingly. */\nexport interface DragGestureController {\n  start(point: DragGesturePoint, modifiers: ModifierState): void;\n  move(point: DragGesturePoint, modifiers: ModifierState): boolean;\n  end(): void;\n  cancel(): void;\n  readonly phase: DragGesturePhase;\n  readonly isActive: boolean;\n}\n\ninterface InternalState<TScratch> {\n  phase: 'pending' | 'active';\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n}\n\n/**\n * The base drag primitive: tracks a pointer from press to release, with an\n * optional threshold below which the gesture stays pending and commits\n * nothing.\n *\n * It is a gesture and only a gesture — it says where the pointer went, never\n * what that should do. `useDragRect` and `useDragRadial` build on it, and\n * actions decide what to make of the result.\n */\nexport function useDragGesture<TScratch = unknown>(\n  options: UseDragGestureOptions<TScratch> = {},\n): DragGestureController {\n  const optsRef = useLatest(options);\n  const stateRef = useRef<InternalState<TScratch> | null>(null);\n  const [, setPhaseTick] = useState(0);\n  const phaseRef = useRef<DragGesturePhase>('idle');\n  const bumpPhase = useCallback((next: DragGesturePhase) => {\n    phaseRef.current = next;\n    setPhaseTick((n) => n + 1);\n  }, []);\n\n  const buildCtx = useCallback((): DragGestureCtx<TScratch> => {\n    const s = stateRef.current!;\n    return {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n    };\n  }, []);\n\n  const start = useCallback((point: DragGesturePoint, modifiers: ModifierState) => {\n    const opts = optsRef.current;\n    const scratch = opts.initScratch ? opts.initScratch() : ({} as TScratch);\n    const initialPhase: 'pending' | 'active' = opts.thresholdReached ? 'pending' : 'active';\n    stateRef.current = {\n      phase: initialPhase,\n      start: point,\n      current: point,\n      modifiers,\n      scratch,\n    };\n    bumpPhase(initialPhase);\n    opts.onGestureStart?.();\n    opts.onStart?.(buildCtx());\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const move = useCallback((point: DragGesturePoint, modifiers: ModifierState): boolean => {\n    const s = stateRef.current;\n    if (!s) return false;\n    s.current = point;\n    s.modifiers = modifiers;\n    const opts = optsRef.current;\n    if (s.phase === 'pending' && opts.thresholdReached) {\n      const ctx = buildCtx();\n      if (opts.thresholdReached(ctx)) {\n        s.phase = 'active';\n        bumpPhase('active');\n        opts.onActivate?.(buildCtx());\n      }\n    }\n    opts.onMove?.(buildCtx());\n    return true;\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const end = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (!s) {\n      opts.onGestureEnd?.(false);\n      return;\n    }\n    const wasSubThreshold = s.phase === 'pending';\n    const endCtx: DragGestureEndCtx<TScratch> = {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n      wasSubThreshold,\n    };\n    let committed = false;\n    try {\n      const r = opts.onEnd?.(endCtx);\n      committed = r !== false;\n    } finally {\n      stateRef.current = null;\n      bumpPhase('idle');\n      opts.onGestureEnd?.(committed);\n    }\n  }, [bumpPhase, optsRef]);\n\n  const cancel = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (s) opts.onCancel?.(buildCtx());\n    stateRef.current = null;\n    bumpPhase('idle');\n    opts.onGestureEnd?.(false);\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  return useMemo<DragGestureController>(() => ({\n    start, move, end, cancel,\n    get phase() { return phaseRef.current; },\n    get isActive() { return phaseRef.current !== 'idle'; },\n  }), [start, move, end, cancel]);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,117 @@
+import { dlog as e } from "../../../debug/flag.js";
+import { useDragGesture as t } from "../dragGesture/dragGesture.js";
+import { useCallback as n, useMemo as r, useRef as i, useState as a } from "react";
+import { useLatest as o } from "@weasel-js/react";
+//#region src/interactions/gestures/dragRadial/dragRadial.ts
+function s(e) {
+	let t = e.current.x - e.center.x, n = e.current.y - e.center.y;
+	return {
+		center: { ...e.center },
+		radius: Math.hypot(t, n),
+		rotation: t === 0 && n === 0 ? 0 : Math.atan2(n, t)
+	};
+}
+function c(c = {}) {
+	let l = o(c), [u, d] = a(null), f = i(null), p = n(() => {
+		let e = f.current;
+		e && d(s(e));
+	}, []), m = n(() => {
+		let e = f.current;
+		return {
+			...s(e),
+			modifiers: e.modifiers,
+			scratch: e.consumer
+		};
+	}, []), h = t({
+		initScratch: () => ({
+			center: {
+				x: 0,
+				y: 0
+			},
+			current: {
+				x: 0,
+				y: 0
+			},
+			modifiers: {
+				shift: !1,
+				alt: !1,
+				meta: !1,
+				ctrl: !1
+			},
+			consumer: l.current.initScratch ? l.current.initScratch() : {}
+		}),
+		onStart: (t) => {
+			let n = l.current, r = {
+				x: t.start.worldX,
+				y: t.start.worldY
+			}, i = n.snapPoint ? n.snapPoint(r) : r;
+			t.scratch.center = i, t.scratch.current = i, t.scratch.modifiers = t.modifiers, f.current = t.scratch, d({
+				center: i,
+				radius: 0,
+				rotation: 0
+			}), e("drag-radial", "start", i), n.onStart?.(m());
+		},
+		onMove: (e) => {
+			let t = l.current, n = {
+				x: e.current.worldX,
+				y: e.current.worldY
+			};
+			e.scratch.current = t.snapPoint ? t.snapPoint(n) : n, e.scratch.modifiers = e.modifiers, p(), t.onMove?.(m());
+		},
+		onEnd: (t) => {
+			let n = l.current, r = s(t.scratch), i = n.minRadius ?? 0, a = {
+				...r,
+				modifiers: t.scratch.modifiers,
+				scratch: t.scratch.consumer,
+				isSubThreshold: r.radius <= i
+			};
+			e("drag-radial", "end", {
+				radius: r.radius,
+				rotation: r.rotation,
+				isSubThreshold: a.isSubThreshold
+			});
+			let o;
+			try {
+				o = n.onEnd?.(a);
+			} finally {
+				f.current = null, d(null);
+			}
+			return o;
+		},
+		onCancel: () => {
+			e("drag-radial", "cancel"), l.current.onCancel?.(m()), f.current = null, d(null);
+		},
+		onGestureStart: () => l.current.onGestureStart?.(),
+		onGestureEnd: (e) => l.current.onGestureEnd?.(e)
+	}), g = n((e, t, n) => {
+		h.start({
+			worldX: e,
+			worldY: t,
+			clientX: e,
+			clientY: t
+		}, n);
+	}, [h]), _ = n((e, t, n) => h.move({
+		worldX: e,
+		worldY: t,
+		clientX: e,
+		clientY: t
+	}, n), [h]);
+	return r(() => ({
+		start: g,
+		move: _,
+		end: h.end,
+		cancel: h.cancel,
+		overlay: u,
+		isActive: u !== null
+	}), [
+		g,
+		_,
+		h.end,
+		h.cancel,
+		u
+	]);
+}
+//#endregion
+export { c as useDragRadial };
+
+//# sourceMappingURL=dragRadial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dragRadial.js","names":["stateFrom","dx","s","dy","useDragRadial","optsRef","useLatest","options","overlay","setOverlay","useState","scratchRef","useRef","writeOverlay","useCallback","buildCtx","gesture","useDragGesture","opts","raw","ctx","p","dlog","state","min","endCtx","r","committed","start","worldX","worldY","modifiers","move","useMemo"],"sources":["../../../../src/interactions/gestures/dragRadial/dragRadial.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { useDragGesture } from '../dragGesture';\nimport type { ModifierState } from '../types';\nimport { dlog } from '../../../debug/flag';\n\n/** A point in world coordinates. */\nexport interface DragRadialPoint { x: number; y: number }\n\n/** A radial drag expressed as its center and the polar coordinates of the\n *  cursor relative to it. */\nexport interface DragRadialState {\n  center: DragRadialPoint;\n  radius: number;\n  rotation: number;\n}\n\n/** Live state of a radial drag, handed to each lifecycle callback. */\nexport interface DragRadialCtx<TScratch = unknown> extends DragRadialState {\n  modifiers: ModifierState;\n  scratch: TScratch;\n}\n\n/** The context handed to `onEnd`, adding whether the final radius is too\n *  small to be meaningful. */\nexport interface DragRadialEndCtx<TScratch = unknown> extends DragRadialCtx<TScratch> {\n  /** True at end time if the radius is at or below `minRadius`. */\n  isSubThreshold: boolean;\n}\n\n/** Options for `useDragRadial`. */\nexport interface UseDragRadialOptions<TScratch = unknown> {\n  minRadius?: number;\n  initScratch?: () => TScratch;\n  onStart?: (ctx: DragRadialCtx<TScratch>) => void;\n  onMove?: (ctx: DragRadialCtx<TScratch>) => void;\n  onEnd?: (ctx: DragRadialEndCtx<TScratch>) => boolean | void;\n  onCancel?: (ctx: DragRadialCtx<TScratch>) => void;\n  onGestureStart?: () => void;\n  onGestureEnd?: (committed: boolean) => void;\n  /** Optional: snap world-space points to the active grid (or any other\n   *  snap target). Applied to both the center (on `onStart`) and the\n   *  current cursor (on `onMove`), so the live overlay's radius/rotation\n   *  is computed from snapped points instead of raw cursor positions.\n   *  When omitted, behavior is identical to today (identity passthrough). */\n  snapPoint?: (p: DragRadialPoint) => DragRadialPoint;\n}\n\n/** Drives a radial drag and publishes the live center/radius/rotation for\n *  overlay drawing. */\nexport interface DragRadialController {\n  start(worldX: number, worldY: number, modifiers: ModifierState): void;\n  move(worldX: number, worldY: number, modifiers: ModifierState): boolean;\n  end(): void;\n  cancel(): void;\n  overlay: DragRadialState | null;\n  readonly isActive: boolean;\n}\n\ninterface DragRadialScratch<TConsumer> {\n  center: DragRadialPoint;\n  current: DragRadialPoint;\n  modifiers: ModifierState;\n  consumer: TConsumer;\n}\n\nfunction stateFrom(s: DragRadialScratch<unknown>): DragRadialState {\n  const dx = s.current.x - s.center.x;\n  const dy = s.current.y - s.center.y;\n  return {\n    center: { ...s.center },\n    radius: Math.hypot(dx, dy),\n    rotation: dx === 0 && dy === 0 ? 0 : Math.atan2(dy, dx),\n  };\n}\n\n/**\n * Radial gesture: pointerdown sets center, pointermove updates radius (Math.hypot\n * of delta) and rotation (Math.atan2 of delta), pointerup commits. Shared by polygon\n * and star tools. Modifier key state is read at end time from `ctx.modifiers`.\n */\nexport function useDragRadial<TScratch = unknown>(\n  options: UseDragRadialOptions<TScratch> = {},\n): DragRadialController {\n  const optsRef = useLatest(options);\n\n  const [overlay, setOverlay] = useState<DragRadialState | null>(null);\n\n  const scratchRef = useRef<DragRadialScratch<TScratch> | null>(null);\n\n  const writeOverlay = useCallback(() => {\n    const s = scratchRef.current;\n    if (!s) return;\n    setOverlay(stateFrom(s));\n  }, []);\n\n  const buildCtx = useCallback((): DragRadialCtx<TScratch> => {\n    const s = scratchRef.current!;\n    const state = stateFrom(s);\n    return {\n      ...state,\n      modifiers: s.modifiers,\n      scratch: s.consumer,\n    };\n  }, []);\n\n  const gesture = useDragGesture<DragRadialScratch<TScratch>>({\n    initScratch: () => {\n      const init = optsRef.current.initScratch\n        ? optsRef.current.initScratch()\n        : ({} as TScratch);\n      return {\n        center: { x: 0, y: 0 },\n        current: { x: 0, y: 0 },\n        modifiers: { shift: false, alt: false, meta: false, ctrl: false },\n        consumer: init,\n      };\n    },\n    onStart: (ctx) => {\n      const opts = optsRef.current;\n      const raw: DragRadialPoint = { x: ctx.start.worldX, y: ctx.start.worldY };\n      const p: DragRadialPoint = opts.snapPoint ? opts.snapPoint(raw) : raw;\n      ctx.scratch.center = p;\n      ctx.scratch.current = p;\n      ctx.scratch.modifiers = ctx.modifiers;\n      scratchRef.current = ctx.scratch;\n      setOverlay({ center: p, radius: 0, rotation: 0 });\n      dlog('drag-radial', 'start', p);\n      opts.onStart?.(buildCtx());\n    },\n    onMove: (ctx) => {\n      const opts = optsRef.current;\n      const raw: DragRadialPoint = { x: ctx.current.worldX, y: ctx.current.worldY };\n      ctx.scratch.current = opts.snapPoint ? opts.snapPoint(raw) : raw;\n      ctx.scratch.modifiers = ctx.modifiers;\n      writeOverlay();\n      opts.onMove?.(buildCtx());\n    },\n    onEnd: (ctx) => {\n      const opts = optsRef.current;\n      const state = stateFrom(ctx.scratch);\n      const min = opts.minRadius ?? 0;\n      const endCtx: DragRadialEndCtx<TScratch> = {\n        ...state,\n        modifiers: ctx.scratch.modifiers,\n        scratch: ctx.scratch.consumer,\n        isSubThreshold: state.radius <= min,\n      };\n      dlog('drag-radial', 'end', { radius: state.radius, rotation: state.rotation, isSubThreshold: endCtx.isSubThreshold });\n      let r: boolean | void;\n      try {\n        r = opts.onEnd?.(endCtx);\n      } finally {\n        scratchRef.current = null;\n        setOverlay(null);\n      }\n      return r;\n    },\n    onCancel: () => {\n      dlog('drag-radial', 'cancel');\n      optsRef.current.onCancel?.(buildCtx());\n      scratchRef.current = null;\n      setOverlay(null);\n    },\n    onGestureStart: () => optsRef.current.onGestureStart?.(),\n    onGestureEnd: (committed) => optsRef.current.onGestureEnd?.(committed),\n  });\n\n  const start = useCallback((worldX: number, worldY: number, modifiers: ModifierState) => {\n    gesture.start({ worldX, worldY, clientX: worldX, clientY: worldY }, modifiers);\n  }, [gesture]);\n\n  const move = useCallback((worldX: number, worldY: number, modifiers: ModifierState): boolean => {\n    return gesture.move({ worldX, worldY, clientX: worldX, clientY: worldY }, modifiers);\n  }, [gesture]);\n\n  return useMemo<DragRadialController>(() => ({\n    start,\n    move,\n    end: gesture.end,\n    cancel: gesture.cancel,\n    overlay,\n    isActive: overlay !== null,\n  }), [start, move, gesture.end, gesture.cancel, overlay]);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,164 @@
+import { dlog as e } from "../../../debug/flag.js";
+import { useDragGesture as t } from "../dragGesture/dragGesture.js";
+import { useCallback as n, useMemo as r, useRef as i, useState as a } from "react";
+import { useLatest as o } from "@weasel-js/react";
+//#region src/interactions/gestures/dragRect/dragRect.ts
+function s(e, t) {
+	return {
+		x: Math.min(e.x, t.x),
+		y: Math.min(e.y, t.y),
+		width: Math.abs(t.x - e.x),
+		height: Math.abs(t.y - e.y)
+	};
+}
+function c(c = {}) {
+	let l = o(c), [u, d] = a(null), f = i(null), p = n(() => {
+		let e = f.current;
+		e && d({
+			start: e.start,
+			current: e.current,
+			bounds: s(e.start, e.current)
+		});
+	}, []), m = n(() => {
+		let e = f.current;
+		return {
+			get start() {
+				return e.start;
+			},
+			get current() {
+				return e.current;
+			},
+			get bounds() {
+				return s(e.start, e.current);
+			},
+			get modifiers() {
+				return e.modifiers;
+			},
+			get scratch() {
+				return e.consumer;
+			},
+			setStart(t) {
+				e.start = t, p();
+			},
+			setCurrent(t) {
+				e.current = t, p();
+			}
+		};
+	}, [p]), h = t({
+		initScratch: () => ({
+			start: {
+				x: 0,
+				y: 0
+			},
+			current: {
+				x: 0,
+				y: 0
+			},
+			modifiers: {
+				shift: !1,
+				alt: !1,
+				meta: !1,
+				ctrl: !1
+			},
+			consumer: l.current.initScratch ? l.current.initScratch() : {}
+		}),
+		onStart: (t) => {
+			let n = l.current, r = {
+				x: t.start.worldX,
+				y: t.start.worldY
+			}, i = n.snapPoint ? n.snapPoint(r) : r;
+			e("drag-rect", "start", i), t.scratch.start = i, t.scratch.current = i, f.current = t.scratch, t.scratch.modifiers = t.modifiers, d({
+				start: i,
+				current: i,
+				bounds: {
+					x: i.x,
+					y: i.y,
+					width: 0,
+					height: 0
+				}
+			}), n.onStart?.(m());
+		},
+		onMove: (e) => {
+			let t = l.current, n = {
+				x: e.current.worldX,
+				y: e.current.worldY
+			};
+			e.scratch.current = t.snapPoint ? t.snapPoint(n) : n, e.scratch.modifiers = e.modifiers, p(), t.onMove?.(m());
+		},
+		onEnd: (t) => {
+			let n = l.current, r = n.minBounds ?? {
+				width: 0,
+				height: 0
+			}, i = s(t.scratch.start, t.scratch.current), a = i.width <= r.width || i.height <= r.height, o = t.scratch, c = {
+				get start() {
+					return o.start;
+				},
+				get current() {
+					return o.current;
+				},
+				get bounds() {
+					return s(o.start, o.current);
+				},
+				get modifiers() {
+					return o.modifiers;
+				},
+				get scratch() {
+					return o.consumer;
+				},
+				setStart(e) {
+					o.start = e, p();
+				},
+				setCurrent(e) {
+					o.current = e, p();
+				},
+				isSubThreshold: a
+			};
+			e("drag-rect", "end", {
+				bounds: i,
+				isSubThreshold: a
+			});
+			let u;
+			try {
+				u = n.onEnd?.(c);
+			} finally {
+				f.current = null, d(null);
+			}
+			return u;
+		},
+		onCancel: () => {
+			e("drag-rect", "cancel"), l.current.onCancel?.(m()), f.current = null, d(null);
+		},
+		onGestureStart: () => l.current.onGestureStart?.(),
+		onGestureEnd: (e) => l.current.onGestureEnd?.(e)
+	}), g = n((e, t, n) => {
+		h.start({
+			worldX: e,
+			worldY: t,
+			clientX: e,
+			clientY: t
+		}, n);
+	}, [h]), _ = n((e, t, n) => h.move({
+		worldX: e,
+		worldY: t,
+		clientX: e,
+		clientY: t
+	}, n), [h]);
+	return r(() => ({
+		start: g,
+		move: _,
+		end: h.end,
+		cancel: h.cancel,
+		overlay: u,
+		isActive: u !== null
+	}), [
+		g,
+		_,
+		h.end,
+		h.cancel,
+		u
+	]);
+}
+//#endregion
+export { c as useDragRect };
+
+//# sourceMappingURL=dragRect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dragRect.js","names":["boundsFrom","start","current","useDragRect","optsRef","useLatest","options","overlay","setOverlay","useState","scratchRef","useRef","writeOverlay","useCallback","s","buildConsumerCtx","p","gesture","useDragGesture","opts","raw","ctx","dlog","min","b","isSubThreshold","endCtx","r","committed","worldX","worldY","modifiers","move","useMemo"],"sources":["../../../../src/interactions/gestures/dragRect/dragRect.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { useDragGesture } from '../dragGesture';\nimport type { ModifierState } from '../types';\nimport { dlog } from '../../../debug/flag';\n\n/** A point in world coordinates. */\nexport interface DragRectPoint { x: number; y: number }\n/** The axis-aligned box between the drag's two corners, always with\n *  non-negative extents regardless of drag direction. */\nexport interface DragRectBounds { x: number; y: number; width: number; height: number }\n\n/** Live state of a rectangle drag, handed to each lifecycle callback. Either\n *  corner can be moved mid-gesture, which is how a tool re-anchors a drag\n *  without restarting it. */\nexport interface DragRectCtx<TScratch = unknown> {\n  start: DragRectPoint;\n  current: DragRectPoint;\n  bounds: DragRectBounds;\n  modifiers: ModifierState;\n  scratch: TScratch;\n  /** Override the start point mid-gesture. Recomputes bounds and updates the\n   *  live overlay so the next move (and the end ctx) reflect the new value. */\n  setStart(p: DragRectPoint): void;\n  /** Override the current point mid-gesture (between start and end). */\n  setCurrent(p: DragRectPoint): void;\n}\n\n/** The context handed to `onEnd`, adding whether the final box is too small\n *  to be meaningful. */\nexport interface DragRectEndCtx<TScratch = unknown> extends DragRectCtx<TScratch> {\n  /** True if the end-time bounds are at or below `minBounds` on either axis.\n   *  Present-tense state check — distinct from the base's retrospective\n   *  `wasSubThreshold`. Computed by this wrapper, not by `useDragGesture`. */\n  isSubThreshold: boolean;\n}\n\n/** Options for `useDragRect`. */\nexport interface UseDragRectOptions<TScratch = unknown> {\n  minBounds?: { width: number; height: number };\n  initScratch?: () => TScratch;\n  onStart?: (ctx: DragRectCtx<TScratch>) => void;\n  onMove?: (ctx: DragRectCtx<TScratch>) => void;\n  onEnd?: (ctx: DragRectEndCtx<TScratch>) => boolean | void;\n  onCancel?: (ctx: DragRectCtx<TScratch>) => void;\n  onGestureStart?: () => void;\n  onGestureEnd?: (committed: boolean) => void;\n  /** Optional: snap world-space points to the active grid (or any other\n   *  snap target). Applied to every coord the gesture ingests (start point\n   *  on `onStart`, current point on `onMove`), so both the live overlay\n   *  and the committed bounds track the snapped values. When omitted,\n   *  behavior is identical to today (identity passthrough). */\n  snapPoint?: (p: DragRectPoint) => DragRectPoint;\n}\n\n/** Drives a rectangle drag and publishes the live box for overlay drawing. */\nexport interface DragRectController {\n  start(worldX: number, worldY: number, modifiers: ModifierState): void;\n  move(worldX: number, worldY: number, modifiers: ModifierState): boolean;\n  end(): void;\n  cancel(): void;\n  overlay: { start: DragRectPoint; current: DragRectPoint; bounds: DragRectBounds } | null;\n  readonly isActive: boolean;\n}\n\nfunction boundsFrom(start: DragRectPoint, current: DragRectPoint): DragRectBounds {\n  return {\n    x: Math.min(start.x, current.x),\n    y: Math.min(start.y, current.y),\n    width: Math.abs(current.x - start.x),\n    height: Math.abs(current.y - start.y),\n  };\n}\n\ninterface DragRectScratch<TConsumer> {\n  start: DragRectPoint;\n  current: DragRectPoint;\n  modifiers: ModifierState;\n  consumer: TConsumer;\n}\n\n/**\n * The gesture \"the user drew a rectangle\": press, drag, release, with the\n * resulting box reported live and at commit.\n *\n * It is a spatial input primitive, not an insert mechanism — what the box\n * means is entirely up to whoever consumes it. Marquee selection, cropping and\n * shape insertion all sit on top of the same gesture.\n */\nexport function useDragRect<TScratch = unknown>(\n  options: UseDragRectOptions<TScratch> = {},\n): DragRectController {\n  const optsRef = useLatest(options);\n\n  const [overlay, setOverlay] = useState<DragRectController['overlay']>(null);\n\n  const scratchRef = useRef<DragRectScratch<TScratch> | null>(null);\n\n  const writeOverlay = useCallback(() => {\n    const s = scratchRef.current;\n    if (!s) return;\n    setOverlay({\n      start: s.start,\n      current: s.current,\n      bounds: boundsFrom(s.start, s.current),\n    });\n  }, []);\n\n  const buildConsumerCtx = useCallback((): DragRectCtx<TScratch> => {\n    const s = scratchRef.current!;\n    return {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get bounds() { return boundsFrom(s.start, s.current); },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.consumer; },\n      setStart(p) { s.start = p; writeOverlay(); },\n      setCurrent(p) { s.current = p; writeOverlay(); },\n    };\n  }, [writeOverlay]);\n\n  const gesture = useDragGesture<DragRectScratch<TScratch>>({\n    initScratch: () => {\n      const init = optsRef.current.initScratch\n        ? optsRef.current.initScratch()\n        : ({} as TScratch);\n      return {\n        start: { x: 0, y: 0 },\n        current: { x: 0, y: 0 },\n        modifiers: { shift: false, alt: false, meta: false, ctrl: false },\n        consumer: init,\n      };\n    },\n    onStart: (ctx) => {\n      const opts = optsRef.current;\n      const raw: DragRectPoint = { x: ctx.start.worldX, y: ctx.start.worldY };\n      const p: DragRectPoint = opts.snapPoint ? opts.snapPoint(raw) : raw;\n      dlog('drag-rect', 'start', p);\n      ctx.scratch.start = p;\n      ctx.scratch.current = p;\n      scratchRef.current = ctx.scratch;\n      ctx.scratch.modifiers = ctx.modifiers;\n      setOverlay({ start: p, current: p, bounds: { x: p.x, y: p.y, width: 0, height: 0 } });\n      opts.onStart?.(buildConsumerCtx());\n    },\n    onMove: (ctx) => {\n      const opts = optsRef.current;\n      const raw: DragRectPoint = { x: ctx.current.worldX, y: ctx.current.worldY };\n      ctx.scratch.current = opts.snapPoint ? opts.snapPoint(raw) : raw;\n      ctx.scratch.modifiers = ctx.modifiers;\n      writeOverlay();\n      opts.onMove?.(buildConsumerCtx());\n    },\n    onEnd: (ctx) => {\n      const opts = optsRef.current;\n      const min = opts.minBounds ?? { width: 0, height: 0 };\n      const b = boundsFrom(ctx.scratch.start, ctx.scratch.current);\n      const isSubThreshold = b.width <= min.width || b.height <= min.height;\n      const s = ctx.scratch;\n      const endCtx: DragRectEndCtx<TScratch> = {\n        get start() { return s.start; },\n        get current() { return s.current; },\n        get bounds() { return boundsFrom(s.start, s.current); },\n        get modifiers() { return s.modifiers; },\n        get scratch() { return s.consumer; },\n        setStart(p) { s.start = p; writeOverlay(); },\n        setCurrent(p) { s.current = p; writeOverlay(); },\n        isSubThreshold,\n      };\n      dlog('drag-rect', 'end', { bounds: b, isSubThreshold });\n      let r: boolean | void;\n      try {\n        r = opts.onEnd?.(endCtx);\n      } finally {\n        scratchRef.current = null;\n        setOverlay(null);\n      }\n      return r;\n    },\n    onCancel: () => {\n      dlog('drag-rect', 'cancel');\n      optsRef.current.onCancel?.(buildConsumerCtx());\n      scratchRef.current = null;\n      setOverlay(null);\n    },\n    onGestureStart: () => optsRef.current.onGestureStart?.(),\n    onGestureEnd: (committed) => optsRef.current.onGestureEnd?.(committed),\n  });\n\n  const start = useCallback((worldX: number, worldY: number, modifiers: ModifierState) => {\n    gesture.start({ worldX, worldY, clientX: worldX, clientY: worldY }, modifiers);\n  }, [gesture]);\n\n  const move = useCallback((worldX: number, worldY: number, modifiers: ModifierState): boolean => {\n    return gesture.move({ worldX, worldY, clientX: worldX, clientY: worldY }, modifiers);\n  }, [gesture]);\n\n  return useMemo<DragRectController>(() => ({\n    start,\n    move,\n    end: gesture.end,\n    cancel: gesture.cancel,\n    overlay,\n    isActive: overlay !== null,\n  }), [start, move, gesture.end, gesture.cancel, overlay]);\n}\n"],"mappings":";;;;;AAiEA,SAASA,EAAW,GAAsB,GAAwC;CAChF,OAAO;EACL,GAAG,KAAK,IAAIC,EAAM,GAAGC,EAAQ,CAAC;EAC9B,GAAG,KAAK,IAAID,EAAM,GAAGC,EAAQ,CAAC;EAC9B,OAAO,KAAK,IAAIA,EAAQ,IAAID,EAAM,CAAC;EACnC,QAAQ,KAAK,IAAIC,EAAQ,IAAID,EAAM,CAAC;CACtC;AACF;AAiBA,SAAgBE,EACd,IAAwC,CAAC,GACrB;CACpB,IAAMC,IAAUC,EAAUC,CAAO,GAE3B,CAACC,GAASC,KAAcC,EAAwC,IAAI,GAEpEC,IAAaC,EAAyC,IAAI,GAE1DC,IAAeC,QAAkB;EACrC,IAAMC,IAAIJ,EAAW;EACrB,AAAKI,KACLN,EAAW;GACT,OAAOM,EAAE;GACT,SAASA,EAAE;GACX,QAAQd,EAAWc,EAAE,OAAOA,EAAE,OAAO;EACvC,CAAC;CACH,GAAG,CAAC,CAAC,GAECC,IAAmBF,QAAyC;EAChE,IAAMC,IAAIJ,EAAW;EACrB,OAAO;GACL,IAAI,QAAQ;IAAE,OAAOI,EAAE;GAAO;GAC9B,IAAI,UAAU;IAAE,OAAOA,EAAE;GAAS;GAClC,IAAI,SAAS;IAAE,OAAOd,EAAWc,EAAE,OAAOA,EAAE,OAAO;GAAG;GACtD,IAAI,YAAY;IAAE,OAAOA,EAAE;GAAW;GACtC,IAAI,UAAU;IAAE,OAAOA,EAAE;GAAU;GACnC,SAAS,GAAG;IAAe,AAAb,EAAE,QAAQE,GAAGJ,EAAa;GAAG;GAC3C,WAAW,GAAG;IAAiB,AAAf,EAAE,UAAUI,GAAGJ,EAAa;GAAG;EACjD;CACF,GAAG,CAACA,CAAY,CAAC,GAEXK,IAAUC,EAA0C;EACxD,oBAIS;GACL,OAAO;IAAE,GAAG;IAAG,GAAG;GAAE;GACpB,SAAS;IAAE,GAAG;IAAG,GAAG;GAAE;GACtB,WAAW;IAAE,OAAO;IAAO,KAAK;IAAO,MAAM;IAAO,MAAM;GAAM;GAChE,UAPWd,EAAQ,QAAQ,cACzBA,EAAQ,QAAQ,YAAY,IAC3B,CAAC;EAMN;EAEF,UAAU,MAAQ;GAChB,IAAMe,IAAOf,EAAQ,SACfgB,IAAqB;IAAE,GAAGC,EAAI,MAAM;IAAQ,GAAGA,EAAI,MAAM;GAAO,GAChEL,IAAmBG,EAAK,YAAYA,EAAK,UAAUC,CAAG,IAAIA;GAOhE,AANAE,EAAK,aAAa,SAASN,CAAC,GAC5B,EAAI,QAAQ,QAAQA,GACpB,EAAI,QAAQ,UAAUA,GACtB,EAAW,UAAUK,EAAI,SACzB,EAAI,QAAQ,YAAYA,EAAI,WAC5Bb,EAAW;IAAE,OAAOQ;IAAG,SAASA;IAAG,QAAQ;KAAE,GAAGA,EAAE;KAAG,GAAGA,EAAE;KAAG,OAAO;KAAG,QAAQ;IAAE;GAAE,CAAC,GACpFG,EAAK,UAAUJ,EAAiB,CAAC;EACnC;EACA,SAAS,MAAQ;GACf,IAAMI,IAAOf,EAAQ,SACfgB,IAAqB;IAAE,GAAGC,EAAI,QAAQ;IAAQ,GAAGA,EAAI,QAAQ;GAAO;GAI1E,AAHA,EAAI,QAAQ,UAAUF,EAAK,YAAYA,EAAK,UAAUC,CAAG,IAAIA,GAC7D,EAAI,QAAQ,YAAYC,EAAI,WAC5BT,EAAa,GACbO,EAAK,SAASJ,EAAiB,CAAC;EAClC;EACA,QAAQ,MAAQ;GACd,IAAMI,IAAOf,EAAQ,SACfmB,IAAMJ,EAAK,aAAa;IAAE,OAAO;IAAG,QAAQ;GAAE,GAC9CK,IAAIxB,EAAWqB,EAAI,QAAQ,OAAOA,EAAI,QAAQ,OAAO,GACrDI,IAAiBD,EAAE,SAASD,EAAI,SAASC,EAAE,UAAUD,EAAI,QACzDT,IAAIO,EAAI,SACRK,IAAmC;IACvC,IAAI,QAAQ;KAAE,OAAOZ,EAAE;IAAO;IAC9B,IAAI,UAAU;KAAE,OAAOA,EAAE;IAAS;IAClC,IAAI,SAAS;KAAE,OAAOd,EAAWc,EAAE,OAAOA,EAAE,OAAO;IAAG;IACtD,IAAI,YAAY;KAAE,OAAOA,EAAE;IAAW;IACtC,IAAI,UAAU;KAAE,OAAOA,EAAE;IAAU;IACnC,SAAS,GAAG;KAAe,AAAb,EAAE,QAAQE,GAAGJ,EAAa;IAAG;IAC3C,WAAW,GAAG;KAAiB,AAAf,EAAE,UAAUI,GAAGJ,EAAa;IAAG;IAC/C;GACF;GACA,EAAK,aAAa,OAAO;IAAE,QAAQY;IAAG;GAAe,CAAC;GACtD,IAAIG;GACJ,IAAI;IACF,IAAIR,EAAK,QAAQO,CAAM;GACzB,UAAU;IAER,AADA,EAAW,UAAU,MACrBlB,EAAW,IAAI;GACjB;GACA,OAAOmB;EACT;EACA,gBAAgB;GAId,AAHAL,EAAK,aAAa,QAAQ,GAC1BlB,EAAQ,QAAQ,WAAWW,EAAiB,CAAC,GAC7C,EAAW,UAAU,MACrBP,EAAW,IAAI;EACjB;EACA,sBAAsBJ,EAAQ,QAAQ,iBAAiB;EACvD,eAAe,MAAcA,EAAQ,QAAQ,eAAewB,CAAS;CACvE,CAAC,GAEK3B,IAAQY,GAAa,GAAgB,GAAgB,MAA6B;EACtF,EAAQ,MAAM;GAAE;GAAQ;GAAQ,SAASgB;GAAQ,SAASC;EAAO,GAAGC,CAAS;CAC/E,GAAG,CAACd,CAAO,CAAC,GAENe,IAAOnB,GAAa,GAAgB,GAAgB,MACjDI,EAAQ,KAAK;EAAE;EAAQ;EAAQ,SAASY;EAAQ,SAASC;CAAO,GAAGC,CAAS,GAClF,CAACd,CAAO,CAAC;CAEZ,OAAOgB,SAAmC;EACxC;EACA;EACA,KAAKhB,EAAQ;EACb,QAAQA,EAAQ;EAChB;EACA,UAAUV,MAAY;CACxB,IAAI;EAACN;EAAO+B;EAAMf,EAAQ;EAAKA,EAAQ;EAAQV;CAAO,CAAC;AACzD"}

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

@@ -0,0 +1,46 @@
+import { useCallback as e, useEffect as t, useRef as n } from "react";
+import { clientToCanvasRect as r, openPointerSession as i } from "@weasel-js/routing";
+//#region src/interactions/gestures/handleDrag/handleDrag.ts
+function a(e) {
+	return e instanceof SVGElement && e.ownerSVGElement ? e.ownerSVGElement : e;
+}
+function o(o) {
+	let { onMove: s, onStart: c, onEnd: l, onCancel: u, getRect: d } = o, f = n(null);
+	return t(() => () => {
+		f.current?.cancel();
+	}, []), { onPointerDown: e((e) => {
+		e.preventDefault(), f.current?.cancel();
+		let t = e.currentTarget, n = (d ? d(t) : a(t)).getBoundingClientRect(), o = (e, t) => {
+			let [i, a] = r(n, e, t);
+			return {
+				x: i,
+				y: a
+			};
+		}, p = !1;
+		f.current = i(t, e, {
+			onMove: (e) => {
+				p = !0, s(o(e.clientX, e.clientY), e);
+			},
+			onEnd: (e) => {
+				f.current = null, l?.({
+					point: o(e.clientX, e.clientY),
+					moved: p,
+					event: e
+				});
+			},
+			onCancel: (e) => {
+				f.current = null, u?.(e);
+			}
+		}), c?.(o(e.clientX, e.clientY), e);
+	}, [
+		s,
+		c,
+		l,
+		u,
+		d
+	]) };
+}
+//#endregion
+export { o as useHandleDrag };
+
+//# sourceMappingURL=handleDrag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handleDrag.js","names":["defaultRectEl","target","useHandleDrag","opts","live","useRef","useEffect","useCallback","rect","getRect","localOf","x","y","clientToCanvasRect","clientX","clientY","moved","openPointerSession","onMove","ev","onEnd","onCancel","reason","onStart"],"sources":["../../../../src/interactions/gestures/handleDrag/handleDrag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { clientToCanvasRect } from '@weasel-js/routing';\nimport { openPointerSession, type PointerSession, type PointerSessionCancelReason } from '@weasel-js/routing';\n\n/** A 2D point in the rect element's local coordinate space. */\nexport interface HandleDragPoint {\n  x: number;\n  y: number;\n}\n\n/** What a released drag reports. */\nexport interface HandleDragEnd {\n  /** Where the pointer was let go, in the rect element's local space. */\n  point: HandleDragPoint;\n  /** False when the pointer never moved — a press, not a drag. Commit-on-end\n   *  consumers use this to tell an edit from a stray click. */\n  moved: boolean;\n  event: PointerEvent;\n}\n\n/** Options for {@link useHandleDrag}. */\nexport interface UseHandleDragOptions<T extends HTMLElement | SVGElement> {\n  /** Called on every `pointermove` with coords local to the rect element (see `getRect`). */\n  onMove: (p: HandleDragPoint, e: PointerEvent) => void;\n  /** Called on `pointerdown` with the same local coords passed to `onMove`. */\n  onStart?: (p: HandleDragPoint, e: React.PointerEvent<T>) => void;\n  /** The pointer was released. Not called when the drag is cancelled — a\n   *  cancelled gesture is not an edit, and conflating the two made every\n   *  commit-on-end consumer sniff the event type to tell them apart. */\n  onEnd?: (end: HandleDragEnd) => void;\n  /** The drag ended without a release: the pointer was cancelled, capture was\n   *  lost, or the component unmounted mid-gesture. */\n  onCancel?: (reason: PointerSessionCancelReason) => void;\n  /**\n   * Element whose `getBoundingClientRect()` defines the local coordinate\n   * space. Defaults to the handle target's owning `<svg>` if it has one,\n   * otherwise the target itself.\n   */\n  getRect?: (target: T) => Element;\n}\n\n/** Return shape of {@link useHandleDrag}. */\nexport interface UseHandleDragReturn<T extends HTMLElement | SVGElement> {\n  onPointerDown: (e: React.PointerEvent<T>) => void;\n}\n\nfunction defaultRectEl(target: HTMLElement | SVGElement): Element {\n  if (target instanceof SVGElement && target.ownerSVGElement) {\n    return target.ownerSVGElement;\n  }\n  return target;\n}\n\n/**\n * Pointer drag for SVG/HTML handles. On `pointerdown` opens a\n * {@link openPointerSession | pointer session} on the handle, then forwards\n * every move to `onMove` with coordinates local to the rect-providing element\n * (defaulting to the handle's owning `<svg>`).\n *\n * The rect is measured once, at the press: a handle that moves under its own\n * drag must not shift the space its coordinates are reported in.\n */\nexport function useHandleDrag<T extends HTMLElement | SVGElement>(\n  opts: UseHandleDragOptions<T>,\n): UseHandleDragReturn<T> {\n  const { onMove, onStart, onEnd, onCancel, getRect } = opts;\n  const live = useRef<PointerSession | null>(null);\n\n  useEffect(() => () => { live.current?.cancel(); }, []);\n\n  const onPointerDown = useCallback(\n    (e: React.PointerEvent<T>) => {\n      e.preventDefault();\n      live.current?.cancel();\n\n      const target = e.currentTarget;\n      const rectEl = getRect ? getRect(target) : defaultRectEl(target);\n      const rect = rectEl.getBoundingClientRect();\n      const localOf = (clientX: number, clientY: number): HandleDragPoint => {\n        const [x, y] = clientToCanvasRect(rect, clientX, clientY);\n        return { x, y };\n      };\n\n      let moved = false;\n      live.current = openPointerSession(target, e, {\n        onMove: (ev) => {\n          moved = true;\n          onMove(localOf(ev.clientX, ev.clientY), ev);\n        },\n        onEnd: (ev) => {\n          live.current = null;\n          onEnd?.({ point: localOf(ev.clientX, ev.clientY), moved, event: ev });\n        },\n        onCancel: (reason) => {\n          live.current = null;\n          onCancel?.(reason);\n        },\n      });\n\n      onStart?.(localOf(e.clientX, e.clientY), e);\n    },\n    [onMove, onStart, onEnd, onCancel, getRect],\n  );\n\n  return { onPointerDown };\n}\n"],"mappings":";;;AA8CA,SAASA,EAAc,GAA2C;CAIhE,OAHIC,aAAkB,cAAcA,EAAO,kBAClCA,EAAO,kBAETA;AACT;AAWA,SAAgBC,EACd,GACwB;CACxB,IAAM,EAAE,WAAQ,YAAS,UAAO,aAAU,eAAYC,GAChDC,IAAOC,EAA8B,IAAI;CAsC/C,OApCAC,cAAsB;EAAE,EAAK,SAAS,OAAO;CAAG,GAAG,CAAC,CAAC,GAoC9C,EAAE,eAlCaC,GACnB,MAA6B;EAE5B,AADA,EAAE,eAAe,GACjBH,EAAK,SAAS,OAAO;EAErB,IAAMH,IAAS,EAAE,eAEXO,KADSC,IAAUA,EAAQR,CAAM,IAAID,EAAcC,CAAM,EAAA,CAC3C,sBAAsB,GACpCS,KAAW,GAAiB,MAAqC;GACrE,IAAM,CAACC,GAAGC,KAAKC,EAAmBL,GAAMM,GAASC,CAAO;GACxD,OAAO;IAAE;IAAG;GAAE;EAChB,GAEIC,IAAQ;EAgBZ,AAfA,EAAK,UAAUC,EAAmBhB,GAAQ,GAAG;GAC3C,SAAS,MAAO;IAEd,AADA,IAAQ,IACRiB,EAAOR,EAAQS,EAAG,SAASA,EAAG,OAAO,GAAGA,CAAE;GAC5C;GACA,QAAQ,MAAO;IAEb,AADA,EAAK,UAAU,MACfC,IAAQ;KAAE,OAAOV,EAAQS,EAAG,SAASA,EAAG,OAAO;KAAG;KAAO,OAAOA;IAAG,CAAC;GACtE;GACA,WAAW,MAAW;IAEpB,AADA,EAAK,UAAU,MACfE,IAAWC,CAAM;GACnB;EACF,CAAC,GAEDC,IAAUb,EAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC;CAC5C,GACA;EAACQ;EAAQK;EAASH;EAAOC;EAAUZ;CAAO,CAGnC,EAAc;AACzB"}