@weasel-js/core 1.10.1 → 1.11.0

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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"}

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

@@ -1,164 +1,208 @@
-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/dragRect/dragRect.ts
-function s(e, t) {
+function boundsFrom(start, current) {
 	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)
+		x: Math.min(start.x, current.x),
+		y: Math.min(start.y, current.y),
+		width: Math.abs(current.x - start.x),
+		height: Math.abs(current.y - start.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)
+/**
+* The gesture "the user drew a rectangle": press, drag, release, with the
+* resulting box reported live and at commit.
+*
+* It is a spatial input primitive, not an insert mechanism — what the box
+* means is entirely up to whoever consumes it. Marquee selection, cropping and
+* shape insertion all sit on top of the same gesture.
+*/
+function useDragRect(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({
+			start: s.start,
+			current: s.current,
+			bounds: boundsFrom(s.start, s.current)
 		});
-	}, []), m = n(() => {
-		let e = f.current;
+	}, []);
+	const buildConsumerCtx = useCallback(() => {
+		const s = scratchRef.current;
 		return {
 			get start() {
-				return e.start;
+				return s.start;
 			},
 			get current() {
-				return e.current;
+				return s.current;
 			},
 			get bounds() {
-				return s(e.start, e.current);
+				return boundsFrom(s.start, s.current);
 			},
 			get modifiers() {
-				return e.modifiers;
+				return s.modifiers;
 			},
 			get scratch() {
-				return e.consumer;
+				return s.consumer;
 			},
-			setStart(t) {
-				e.start = t, p();
+			setStart(p) {
+				s.start = p;
+				writeOverlay();
 			},
-			setCurrent(t) {
-				e.current = t, p();
+			setCurrent(p) {
+				s.current = p;
+				writeOverlay();
 			}
 		};
-	}, [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,
+	}, [writeOverlay]);
+	const gesture = useDragGesture({
+		initScratch: () => {
+			return {
+				start: {
+					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
+			};
+			dlog("drag-rect", "start", p);
+			ctx.scratch.start = p;
+			ctx.scratch.current = p;
+			scratchRef.current = ctx.scratch;
+			ctx.scratch.modifiers = ctx.modifiers;
+			setOverlay({
+				start: p,
+				current: p,
 				bounds: {
-					x: i.x,
-					y: i.y,
+					x: p.x,
+					y: p.y,
 					width: 0,
 					height: 0
 				}
-			}), n.onStart?.(m());
+			});
+			opts.onStart?.(buildConsumerCtx());
 		},
-		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?.(buildConsumerCtx());
 		},
-		onEnd: (t) => {
-			let n = l.current, r = n.minBounds ?? {
+		onEnd: (ctx) => {
+			const opts = optsRef.current;
+			const min = opts.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 = {
+			};
+			const b = boundsFrom(ctx.scratch.start, ctx.scratch.current);
+			const isSubThreshold = b.width <= min.width || b.height <= min.height;
+			const s = ctx.scratch;
+			const endCtx = {
 				get start() {
-					return o.start;
+					return s.start;
 				},
 				get current() {
-					return o.current;
+					return s.current;
 				},
 				get bounds() {
-					return s(o.start, o.current);
+					return boundsFrom(s.start, s.current);
 				},
 				get modifiers() {
-					return o.modifiers;
+					return s.modifiers;
 				},
 				get scratch() {
-					return o.consumer;
+					return s.consumer;
 				},
-				setStart(e) {
-					o.start = e, p();
+				setStart(p) {
+					s.start = p;
+					writeOverlay();
 				},
-				setCurrent(e) {
-					o.current = e, p();
+				setCurrent(p) {
+					s.current = p;
+					writeOverlay();
 				},
-				isSubThreshold: a
+				isSubThreshold
 			};
-			e("drag-rect", "end", {
-				bounds: i,
-				isSubThreshold: a
+			dlog("drag-rect", "end", {
+				bounds: b,
+				isSubThreshold
 			});
-			let u;
+			let r;
 			try {
-				u = n.onEnd?.(c);
+				r = opts.onEnd?.(endCtx);
 			} finally {
-				f.current = null, d(null);
+				scratchRef.current = null;
+				setOverlay(null);
 			}
-			return u;
+			return r;
 		},
 		onCancel: () => {
-			e("drag-rect", "cancel"), l.current.onCancel?.(m()), f.current = null, d(null);
+			dlog("drag-rect", "cancel");
+			optsRef.current.onCancel?.(buildConsumerCtx());
+			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 useDragRect };
 
+//#endregion
+export { useDragRect };
 //# sourceMappingURL=dragRect.js.map