@weasel-js/core 1.10.0 → 1.11.0

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

@@ -1,108 +1,149 @@
-import { useCallback as e, useMemo as t, useRef as n, useState as r } from "react";
-import { useLatest as i } from "@weasel-js/react";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { useLatest } 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;
+/**
+* The base drag primitive: tracks a pointer from press to release, with an
+* optional threshold below which the gesture stays pending and commits
+* nothing.
+*
+* It is a gesture and only a gesture — it says where the pointer went, never
+* what that should do. `useDragRect` and `useDragRadial` build on it, and
+* actions decide what to make of the result.
+*/
+function useDragGesture(options = {}) {
+	const optsRef = useLatest(options);
+	const stateRef = useRef(null);
+	const [, setPhaseTick] = useState(0);
+	const phaseRef = useRef("idle");
+	const bumpPhase = useCallback((next) => {
+		phaseRef.current = next;
+		setPhaseTick((n) => n + 1);
+	}, []);
+	const buildCtx = useCallback(() => {
+		const s = stateRef.current;
 		return {
 			get start() {
-				return e.start;
+				return s.start;
 			},
 			get current() {
-				return e.current;
+				return s.current;
 			},
 			get modifiers() {
-				return e.modifiers;
+				return s.modifiers;
 			},
 			get scratch() {
-				return e.scratch;
+				return s.scratch;
 			},
 			get phase() {
-				return e.phase;
+				return s.phase;
 			}
 		};
-	}, []), f = e((e, t) => {
-		let n = o.current, r = n.initScratch ? n.initScratch() : {}, i = n.thresholdReached ? "pending" : "active", a = s.current !== null;
-		s.current = {
-			phase: i,
-			start: e,
-			current: e,
-			modifiers: t,
-			scratch: r
-		}, u(i), a || n.onGestureStart?.(), n.onStart?.(d());
+	}, []);
+	const start = useCallback((point, modifiers) => {
+		const opts = optsRef.current;
+		const scratch = opts.initScratch ? opts.initScratch() : {};
+		const initialPhase = opts.thresholdReached ? "pending" : "active";
+		const restart = stateRef.current !== null;
+		stateRef.current = {
+			phase: initialPhase,
+			start: point,
+			current: point,
+			modifiers,
+			scratch
+		};
+		bumpPhase(initialPhase);
+		if (!restart) opts.onGestureStart?.();
+		opts.onStart?.(buildCtx());
 	}, [
-		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()));
+		buildCtx,
+		bumpPhase,
+		optsRef
+	]);
+	const move = useCallback((point, modifiers) => {
+		const s = stateRef.current;
+		if (!s) return false;
+		s.current = point;
+		s.modifiers = modifiers;
+		const opts = optsRef.current;
+		if (s.phase === "pending" && opts.thresholdReached) {
+			const ctx = buildCtx();
+			if (opts.thresholdReached(ctx)) {
+				s.phase = "active";
+				bumpPhase("active");
+				opts.onActivate?.(buildCtx());
+			}
 		}
-		return r.onMove?.(d()), !0;
+		opts.onMove?.(buildCtx());
+		return true;
 	}, [
-		d,
-		u,
-		o
-	]), m = e(() => {
-		let e = s.current, t = o.current;
-		if (!e) return;
-		let n = {
+		buildCtx,
+		bumpPhase,
+		optsRef
+	]);
+	const end = useCallback(() => {
+		const s = stateRef.current;
+		const opts = optsRef.current;
+		if (!s) return;
+		const endCtx = {
 			get start() {
-				return e.start;
+				return s.start;
 			},
 			get current() {
-				return e.current;
+				return s.current;
 			},
 			get modifiers() {
-				return e.modifiers;
+				return s.modifiers;
 			},
 			get scratch() {
-				return e.scratch;
+				return s.scratch;
 			},
 			get phase() {
-				return e.phase;
+				return s.phase;
 			},
-			wasSubThreshold: e.phase === "pending"
-		}, r = !1;
+			wasSubThreshold: s.phase === "pending"
+		};
+		let committed = false;
 		try {
-			r = t.onEnd?.(n) !== !1;
+			committed = opts.onEnd?.(endCtx) !== false;
 		} finally {
-			s.current = null, u("idle"), t.onGestureEnd?.(r);
+			stateRef.current = null;
+			bumpPhase("idle");
+			opts.onGestureEnd?.(committed);
 		}
-	}, [u, o]), h = e(() => {
-		let e = s.current, t = o.current;
-		e && (t.onCancel?.(d()), s.current = null, u("idle"), t.onGestureEnd?.(!1));
+	}, [bumpPhase, optsRef]);
+	const cancel = useCallback(() => {
+		const s = stateRef.current;
+		const opts = optsRef.current;
+		if (!s) return;
+		opts.onCancel?.(buildCtx());
+		stateRef.current = null;
+		bumpPhase("idle");
+		opts.onGestureEnd?.(false);
 	}, [
-		d,
-		u,
-		o
+		buildCtx,
+		bumpPhase,
+		optsRef
 	]);
-	return t(() => ({
-		start: f,
-		move: p,
-		end: m,
-		cancel: h,
+	return useMemo(() => ({
+		start,
+		move,
+		end,
+		cancel,
 		get phase() {
-			return l.current;
+			return phaseRef.current;
 		},
 		get isActive() {
-			return l.current !== "idle";
+			return phaseRef.current !== "idle";
 		}
 	}), [
-		f,
-		p,
-		m,
-		h
+		start,
+		move,
+		end,
+		cancel
 	]);
 }
-//#endregion
-export { a as useDragGesture };
 
+//#endregion
+export { useDragGesture };
 //# sourceMappingURL=dragGesture.js.map

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

@@ -1 +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","restart","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  /** Fired when a gesture opens. A `start()` that replaces a live gesture\n   *  does not fire it again. */\n  onGestureStart?: () => void;\n  /** Fired once per `onGestureStart`, when that gesture ends or cancels. */\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    const restart = stateRef.current !== null;\n    stateRef.current = {\n      phase: initialPhase,\n      start: point,\n      current: point,\n      modifiers,\n      scratch,\n    };\n    bumpPhase(initialPhase);\n    if (!restart) 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) return;\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) return;\n    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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"}
+{"version":3,"file":"dragGesture.js","names":[],"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  /** Fired when a gesture opens. A `start()` that replaces a live gesture\n   *  does not fire it again. */\n  onGestureStart?: () => void;\n  /** Fired once per `onGestureStart`, when that gesture ends or cancels. */\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    const restart = stateRef.current !== null;\n    stateRef.current = {\n      phase: initialPhase,\n      start: point,\n      current: point,\n      modifiers,\n      scratch,\n    };\n    bumpPhase(initialPhase);\n    if (!restart) 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) return;\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) return;\n    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/dragGesture/dragPointOf.js

@@ -1,6 +1,7 @@
-import { clientToWorld as e } from "../../../core/viewport/clientToWorld.js";
+import { clientToWorld } from "../../../core/viewport/clientToWorld.js";
+
 //#region src/interactions/gestures/dragGesture/dragPointOf.ts
-var t = {
+var IDENTITY = {
 	x: 0,
 	y: 0,
 	scale: {
@@ -8,16 +9,22 @@ var t = {
 		y: 1
 	}
 };
-function n(n, r, i = t) {
-	let [a, o] = e(n.clientX, n.clientY, r.getBoundingClientRect(), i);
+/**
+* The {@link DragGesturePoint} a pointer event stands for, for feeding
+* `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer
+* handlers. `element` is the surface the gesture is measured on. With no
+* `view`, world coordinates are the position inside the element in CSS pixels.
+*/
+function dragPointOf(event, element, view = IDENTITY) {
+	const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);
 	return {
-		clientX: n.clientX,
-		clientY: n.clientY,
-		worldX: a,
-		worldY: o
+		clientX: event.clientX,
+		clientY: event.clientY,
+		worldX,
+		worldY
 	};
 }
-//#endregion
-export { n as dragPointOf };
 
+//#endregion
+export { dragPointOf };
 //# sourceMappingURL=dragPointOf.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"dragPointOf.js","names":["IDENTITY","dragPointOf","worldX","worldY","clientToWorld","event","element","view"],"sources":["../../../../src/interactions/gestures/dragGesture/dragPointOf.ts"],"sourcesContent":["import { clientToWorld, type ViewLike } from 'core/viewport/clientToWorld';\nimport type { DragGesturePoint } from './dragGesture';\n\nconst IDENTITY: ViewLike = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The {@link DragGesturePoint} a pointer event stands for, for feeding\n * `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer\n * handlers. `element` is the surface the gesture is measured on. With no\n * `view`, world coordinates are the position inside the element in CSS pixels.\n */\nexport function dragPointOf(\n  event: { clientX: number; clientY: number },\n  element: { getBoundingClientRect(): { left: number; top: number } },\n  view: ViewLike = IDENTITY,\n): DragGesturePoint {\n  const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);\n  return { clientX: event.clientX, clientY: event.clientY, worldX, worldY };\n}\n"],"mappings":";;AAGA,IAAMA,IAAqB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;AAQ/D,SAAgBC,EACd,GACA,GACA,IAAiBD,GACC;CAClB,IAAM,CAACE,GAAQC,KAAUC,EAAcC,EAAM,SAASA,EAAM,SAASC,EAAQ,sBAAsB,GAAGC,CAAI;CAC1G,OAAO;EAAE,SAASF,EAAM;EAAS,SAASA,EAAM;EAAS;EAAQ;CAAO;AAC1E"}
+{"version":3,"file":"dragPointOf.js","names":[],"sources":["../../../../src/interactions/gestures/dragGesture/dragPointOf.ts"],"sourcesContent":["import { clientToWorld, type ViewLike } from 'core/viewport/clientToWorld';\nimport type { DragGesturePoint } from './dragGesture';\n\nconst IDENTITY: ViewLike = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The {@link DragGesturePoint} a pointer event stands for, for feeding\n * `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer\n * handlers. `element` is the surface the gesture is measured on. With no\n * `view`, world coordinates are the position inside the element in CSS pixels.\n */\nexport function dragPointOf(\n  event: { clientX: number; clientY: number },\n  element: { getBoundingClientRect(): { left: number; top: number } },\n  view: ViewLike = IDENTITY,\n): DragGesturePoint {\n  const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);\n  return { clientX: event.clientX, clientY: event.clientY, worldX, worldY };\n}\n"],"mappings":";;;AAGA,IAAM,WAAqB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;;;;;;;AAQ/D,SAAgB,YACd,OACA,SACA,OAAiB,UACC;CAClB,MAAM,CAAC,QAAQ,UAAU,cAAc,MAAM,SAAS,MAAM,SAAS,QAAQ,sBAAsB,GAAG,IAAI;CAC1G,OAAO;EAAE,SAAS,MAAM;EAAS,SAAS,MAAM;EAAS;EAAQ;CAAO;AAC1E"}

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

@@ -1,117 +1,153 @@
-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";
+import { dlog } from "../../../debug/flag.js";
+import { useDragGesture } from "../dragGesture/dragGesture.js";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { useLatest } 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;
+function stateFrom(s) {
+	const dx = s.current.x - s.center.x;
+	const dy = s.current.y - s.center.y;
 	return {
-		center: { ...e.center },
-		radius: Math.hypot(t, n),
-		rotation: t === 0 && n === 0 ? 0 : Math.atan2(n, t)
+		center: { ...s.center },
+		radius: Math.hypot(dx, dy),
+		rotation: dx === 0 && dy === 0 ? 0 : Math.atan2(dy, dx)
 	};
 }
-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;
+/**
+* Radial gesture: pointerdown sets center, pointermove updates radius (Math.hypot
+* of delta) and rotation (Math.atan2 of delta), pointerup commits. Shared by polygon
+* and star tools. Modifier key state is read at end time from `ctx.modifiers`.
+*/
+function useDragRadial(options = {}) {
+	const optsRef = useLatest(options);
+	const [overlay, setOverlay] = useState(null);
+	const scratchRef = useRef(null);
+	const writeOverlay = useCallback(() => {
+		const s = scratchRef.current;
+		if (!s) return;
+		setOverlay(stateFrom(s));
+	}, []);
+	const buildCtx = useCallback(() => {
+		const s = scratchRef.current;
 		return {
-			...s(e),
-			modifiers: e.modifiers,
-			scratch: e.consumer
+			...stateFrom(s),
+			modifiers: s.modifiers,
+			scratch: s.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,
+	}, []);
+	const gesture = useDragGesture({
+		initScratch: () => {
+			return {
+				center: {
+					x: 0,
+					y: 0
+				},
+				current: {
+					x: 0,
+					y: 0
+				},
+				modifiers: {
+					shift: false,
+					alt: false,
+					meta: false,
+					ctrl: false
+				},
+				consumer: optsRef.current.initScratch ? optsRef.current.initScratch() : {}
+			};
+		},
+		onStart: (ctx) => {
+			const opts = optsRef.current;
+			const p = {
+				x: ctx.start.worldX,
+				y: ctx.start.worldY
+			};
+			ctx.scratch.center = p;
+			ctx.scratch.current = p;
+			ctx.scratch.modifiers = ctx.modifiers;
+			scratchRef.current = ctx.scratch;
+			setOverlay({
+				center: p,
 				radius: 0,
 				rotation: 0
-			}), e("drag-radial", "start", i), n.onStart?.(m());
+			});
+			dlog("drag-radial", "start", p);
+			opts.onStart?.(buildCtx());
 		},
-		onMove: (e) => {
-			let t = l.current, n = {
-				x: e.current.worldX,
-				y: e.current.worldY
+		onMove: (ctx) => {
+			const opts = optsRef.current;
+			ctx.scratch.current = {
+				x: ctx.current.worldX,
+				y: ctx.current.worldY
 			};
-			e.scratch.current = t.snapPoint ? t.snapPoint(n) : n, e.scratch.modifiers = e.modifiers, p(), t.onMove?.(m());
+			ctx.scratch.modifiers = ctx.modifiers;
+			writeOverlay();
+			opts.onMove?.(buildCtx());
 		},
-		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
+		onEnd: (ctx) => {
+			const opts = optsRef.current;
+			const state = stateFrom(ctx.scratch);
+			const min = opts.minRadius ?? 0;
+			const endCtx = {
+				...state,
+				modifiers: ctx.scratch.modifiers,
+				scratch: ctx.scratch.consumer,
+				isSubThreshold: state.radius <= min
 			};
-			e("drag-radial", "end", {
-				radius: r.radius,
-				rotation: r.rotation,
-				isSubThreshold: a.isSubThreshold
+			dlog("drag-radial", "end", {
+				radius: state.radius,
+				rotation: state.rotation,
+				isSubThreshold: endCtx.isSubThreshold
 			});
-			let o;
+			let r;
 			try {
-				o = n.onEnd?.(a);
+				r = opts.onEnd?.(endCtx);
 			} finally {
-				f.current = null, d(null);
+				scratchRef.current = null;
+				setOverlay(null);
 			}
-			return o;
+			return r;
 		},
 		onCancel: () => {
-			e("drag-radial", "cancel"), l.current.onCancel?.(m()), f.current = null, d(null);
+			dlog("drag-radial", "cancel");
+			optsRef.current.onCancel?.(buildCtx());
+			scratchRef.current = null;
+			setOverlay(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
+		onGestureStart: () => optsRef.current.onGestureStart?.(),
+		onGestureEnd: (committed) => optsRef.current.onGestureEnd?.(committed)
+	});
+	const start = useCallback((worldX, worldY, modifiers) => {
+		gesture.start({
+			worldX,
+			worldY,
+			clientX: worldX,
+			clientY: worldY
+		}, modifiers);
+	}, [gesture]);
+	const move = useCallback((worldX, worldY, modifiers) => {
+		return gesture.move({
+			worldX,
+			worldY,
+			clientX: worldX,
+			clientY: worldY
+		}, modifiers);
+	}, [gesture]);
+	return useMemo(() => ({
+		start,
+		move,
+		end: gesture.end,
+		cancel: gesture.cancel,
+		overlay,
+		isActive: overlay !== null
 	}), [
-		g,
-		_,
-		h.end,
-		h.cancel,
-		u
+		start,
+		move,
+		gesture.end,
+		gesture.cancel,
+		overlay
 	]);
 }
-//#endregion
-export { c as useDragRadial };
 
+//#endregion
+export { useDragRadial };
 //# sourceMappingURL=dragRadial.js.map

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

@@ -1 +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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"}
+{"version":3,"file":"dragRadial.js","names":[],"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}\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 p: DragRadialPoint = { x: ctx.start.worldX, y: ctx.start.worldY };\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      ctx.scratch.current = { x: ctx.current.worldX, y: ctx.current.worldY };\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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"}