@weasel-js/core 1.10.1 → 1.11.1

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

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

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

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

@@ -1,41 +1,63 @@
-import { useCallback as e, useEffect as t, useRef as n } from "react";
-import { useLatest as r } from "@weasel-js/react";
-import { clientToCanvasRect as i, openPointerSession as a } from "@weasel-js/routing";
+import { useCallback, useEffect, useRef } from "react";
+import { useLatest } from "@weasel-js/react";
+import { clientToCanvasRect, openPointerSession } from "@weasel-js/routing";
+
 //#region src/interactions/gestures/handleDrag/handleDrag.ts
-function o(e) {
-	return e instanceof SVGElement && e.ownerSVGElement ? e.ownerSVGElement : e;
+function defaultRectEl(target) {
+	if (target instanceof SVGElement && target.ownerSVGElement) return target.ownerSVGElement;
+	return target;
 }
-function s(s) {
-	let c = r(s), l = n(null);
-	return t(() => () => {
-		l.current?.cancel();
-	}, []), { onPointerDown: e((e) => {
-		e.preventDefault(), l.current?.cancel();
-		let t = e.currentTarget, { getRect: n, onStart: r } = c.current, s = (n ? n(t) : o(t)).getBoundingClientRect(), u = (e, t) => {
-			let [n, r] = i(s, e, t);
+/**
+* Pointer drag for SVG/HTML handles. On `pointerdown` opens a
+* {@link openPointerSession | pointer session} on the handle, then forwards
+* every move to `onMove` with coordinates local to the rect-providing element
+* (defaulting to the handle's owning `<svg>`).
+*
+* The rect is measured once, at the press: a handle that moves under its own
+* drag must not shift the space its coordinates are reported in.
+*/
+function useHandleDrag(opts) {
+	const optsRef = useLatest(opts);
+	const live = useRef(null);
+	useEffect(() => () => {
+		live.current?.cancel();
+	}, []);
+	return { onPointerDown: useCallback((e) => {
+		e.preventDefault();
+		live.current?.cancel();
+		const target = e.currentTarget;
+		const { getRect, onStart } = optsRef.current;
+		const rect = (getRect ? getRect(target) : defaultRectEl(target)).getBoundingClientRect();
+		const localOf = (clientX, clientY) => {
+			const [x, y] = clientToCanvasRect(rect, clientX, clientY);
 			return {
-				x: n,
-				y: r
+				x,
+				y
 			};
-		}, d = !1;
-		l.current = a(t, e, {
-			onMove: (e) => {
-				d = !0, c.current.onMove(u(e.clientX, e.clientY), e);
+		};
+		let moved = false;
+		live.current = openPointerSession(target, e, {
+			onMove: (ev) => {
+				moved = true;
+				optsRef.current.onMove(localOf(ev.clientX, ev.clientY), ev);
 			},
-			onEnd: (e) => {
-				l.current = null, c.current.onEnd?.({
-					point: u(e.clientX, e.clientY),
-					moved: d,
-					event: e
+			onEnd: (ev) => {
+				live.current = null;
+				optsRef.current.onEnd?.({
+					point: localOf(ev.clientX, ev.clientY),
+					moved,
+					event: ev
 				});
 			},
-			onCancel: (e) => {
-				l.current = null, c.current.onCancel?.(e);
+			onCancel: (reason) => {
+				live.current = null;
+				optsRef.current.onCancel?.(reason);
 			}
-		}), r?.(u(e.clientX, e.clientY), e);
-	}, [c]) };
+		});
+		onStart?.(localOf(e.clientX, e.clientY), e);
+	}, [optsRef]) };
 }
-//#endregion
-export { s as useHandleDrag };
 
+//#endregion
+export { useHandleDrag };
 //# sourceMappingURL=handleDrag.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"handleDrag.js","names":["defaultRectEl","target","useHandleDrag","optsRef","useLatest","opts","live","useRef","useEffect","useCallback","rect","getRect","localOf","x","y","clientToCanvasRect","clientX","clientY","moved","openPointerSession","ev","reason","onStart"],"sources":["../../../../src/interactions/gestures/handleDrag/handleDrag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { useLatest } from '@weasel-js/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  // A drag outlives the render that saw its press, and its callbacks have to\n  // be the current ones: `onEnd` commonly closes over state `onMove` set.\n  const optsRef = useLatest(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 { getRect, onStart } = optsRef.current;\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          optsRef.current.onMove(localOf(ev.clientX, ev.clientY), ev);\n        },\n        onEnd: (ev) => {\n          live.current = null;\n          optsRef.current.onEnd?.({ point: localOf(ev.clientX, ev.clientY), moved, event: ev });\n        },\n        onCancel: (reason) => {\n          live.current = null;\n          optsRef.current.onCancel?.(reason);\n        },\n      });\n\n      onStart?.(localOf(e.clientX, e.clientY), e);\n    },\n    [optsRef],\n  );\n\n  return { onPointerDown };\n}\n"],"mappings":";;;;AA+CA,SAASA,EAAc,GAA2C;CAIhE,OAHIC,aAAkB,cAAcA,EAAO,kBAClCA,EAAO,kBAETA;AACT;AAWA,SAAgBC,EACd,GACwB;CAGxB,IAAMC,IAAUC,EAAUC,CAAI,GACxBC,IAAOC,EAA8B,IAAI;CAuC/C,OArCAC,cAAsB;EAAE,EAAK,SAAS,OAAO;CAAG,GAAG,CAAC,CAAC,GAqC9C,EAAE,eAnCaC,GACnB,MAA6B;EAE5B,AADA,EAAE,eAAe,GACjBH,EAAK,SAAS,OAAO;EAErB,IAAML,IAAS,EAAE,eACX,EAAE,YAAS,eAAYE,EAAQ,SAE/BO,KADSC,IAAUA,EAAQV,CAAM,IAAID,EAAcC,CAAM,EAAA,CAC3C,sBAAsB,GACpCW,KAAW,GAAiB,MAAqC;GACrE,IAAM,CAACC,GAAGC,KAAKC,EAAmBL,GAAMM,GAASC,CAAO;GACxD,OAAO;IAAE;IAAG;GAAE;EAChB,GAEIC,IAAQ;EAgBZ,AAfA,EAAK,UAAUC,EAAmBlB,GAAQ,GAAG;GAC3C,SAAS,MAAO;IAEd,AADA,IAAQ,IACRE,EAAQ,QAAQ,OAAOS,EAAQQ,EAAG,SAASA,EAAG,OAAO,GAAGA,CAAE;GAC5D;GACA,QAAQ,MAAO;IAEb,AADA,EAAK,UAAU,MACfjB,EAAQ,QAAQ,QAAQ;KAAE,OAAOS,EAAQQ,EAAG,SAASA,EAAG,OAAO;KAAG;KAAO,OAAOA;IAAG,CAAC;GACtF;GACA,WAAW,MAAW;IAEpB,AADA,EAAK,UAAU,MACfjB,EAAQ,QAAQ,WAAWkB,CAAM;GACnC;EACF,CAAC,GAEDC,IAAUV,EAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC;CAC5C,GACA,CAACT,CAAO,CAGD,EAAc;AACzB"}
+{"version":3,"file":"handleDrag.js","names":[],"sources":["../../../../src/interactions/gestures/handleDrag/handleDrag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { useLatest } from '@weasel-js/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  // A drag outlives the render that saw its press, and its callbacks have to\n  // be the current ones: `onEnd` commonly closes over state `onMove` set.\n  const optsRef = useLatest(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 { getRect, onStart } = optsRef.current;\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          optsRef.current.onMove(localOf(ev.clientX, ev.clientY), ev);\n        },\n        onEnd: (ev) => {\n          live.current = null;\n          optsRef.current.onEnd?.({ point: localOf(ev.clientX, ev.clientY), moved, event: ev });\n        },\n        onCancel: (reason) => {\n          live.current = null;\n          optsRef.current.onCancel?.(reason);\n        },\n      });\n\n      onStart?.(localOf(e.clientX, e.clientY), e);\n    },\n    [optsRef],\n  );\n\n  return { onPointerDown };\n}\n"],"mappings":";;;;;AA+CA,SAAS,cAAc,QAA2C;CAChE,IAAI,kBAAkB,cAAc,OAAO,iBACzC,OAAO,OAAO;CAEhB,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,cACd,MACwB;CAGxB,MAAM,UAAU,UAAU,IAAI;CAC9B,MAAM,OAAO,OAA8B,IAAI;CAE/C,sBAAsB;EAAE,KAAK,SAAS,OAAO;CAAG,GAAG,CAAC,CAAC;CAqCrD,OAAO,EAAE,eAnCa,aACnB,MAA6B;EAC5B,EAAE,eAAe;EACjB,KAAK,SAAS,OAAO;EAErB,MAAM,SAAS,EAAE;EACjB,MAAM,EAAE,SAAS,YAAY,QAAQ;EAErC,MAAM,QADS,UAAU,QAAQ,MAAM,IAAI,cAAc,MAAM,EAClD,CAAO,sBAAsB;EAC1C,MAAM,WAAW,SAAiB,YAAqC;GACrE,MAAM,CAAC,GAAG,KAAK,mBAAmB,MAAM,SAAS,OAAO;GACxD,OAAO;IAAE;IAAG;GAAE;EAChB;EAEA,IAAI,QAAQ;EACZ,KAAK,UAAU,mBAAmB,QAAQ,GAAG;GAC3C,SAAS,OAAO;IACd,QAAQ;IACR,QAAQ,QAAQ,OAAO,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,EAAE;GAC5D;GACA,QAAQ,OAAO;IACb,KAAK,UAAU;IACf,QAAQ,QAAQ,QAAQ;KAAE,OAAO,QAAQ,GAAG,SAAS,GAAG,OAAO;KAAG;KAAO,OAAO;IAAG,CAAC;GACtF;GACA,WAAW,WAAW;IACpB,KAAK,UAAU;IACf,QAAQ,QAAQ,WAAW,MAAM;GACnC;EACF,CAAC;EAED,UAAU,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC;CAC5C,GACA,CAAC,OAAO,CAGD,EAAc;AACzB"}