@greypan/web-ui 11.2.0 → 12.0.1

package/dist/shared/gesture/drag-gesture.js

@@ -1,158 +1,298 @@
-function e(e, t) {
-	let n = typeof PointerEvent < "u" && e instanceof PointerEvent, r = n ? e.currentTarget || e.target : e, { axis: i = "both", threshold: a = 0, calibrateOnFirstMove: o = !1, onStart: s, onMove: c, onEnd: l, onTap: u, onCancel: d } = t, f = null, p = 0, m = 0, h = 0, g = a <= 0, _ = !1, v = [], y = null, b = null;
-	function x(e) {
-		e.cancelable && e.preventDefault();
-	}
-	function S(e) {
-		let t = /* @__PURE__ */ new Set(), n = typeof e.composedPath == "function" ? e.composedPath() : [];
-		for (let e of n) {
-			let n = e.nodeType;
-			(n === Node.ELEMENT_NODE || n === Node.DOCUMENT_FRAGMENT_NODE) && (e.addEventListener("touchmove", x, {
-				capture: !0,
-				passive: !1
-			}), t.add(e));
-		}
-		b = t;
+// src/shared/gesture/drag-gesture.ts
+/**
+* 跨平台/跨浏览器 Pointer 拖拽手势生命周期管理器
+*
+* 封装：
+* 1. setPointerCapture 安全捕获与 window 兜底监听（防 pointer 丢失/离开视口悬挂）
+* 2. 多点触控副指针与未聚焦指针过滤
+* 3. 意图死区（threshold）与滑动轴向判定
+* 4. 可选的零点校准（calibrateOnFirstMove：首个有效 move 重置零点与判定时钟）
+* 5. 100ms 滑动窗口平滑速度估算（Velocity px/s）
+* 6. Window / Handle 跨层事件去重（防重复采样）
+*/
+const VELOCITY_WINDOW_MS = 100;
+/**
+* 为指定元素挂载统一的 Pointer 拖拽手势，或在已有的 pointerdown 事件中启动手势
+*/
+function attachDragGesture(targetOrEvent, options) {
+	const isEvent = typeof PointerEvent !== "undefined" && targetOrEvent instanceof PointerEvent;
+	const target = isEvent ? targetOrEvent.currentTarget || targetOrEvent.target : targetOrEvent;
+	const { axis = "both", threshold = 0, calibrateOnFirstMove = false, onStart, onMove, onEnd, onTap, onCancel } = options;
+	let activePointerId = null;
+	let startX = 0;
+	let startY = 0;
+	let startTimeStamp = 0;
+	let isThresholdPassed = threshold <= 0;
+	let isCalibrated = false;
+	let samples = [];
+	let handledMoveEvent = null;
+	let touchGuardTargets = null;
+	/**
+	* iOS Safari 滚动接管兜底：
+	* WebKit 对 shadow DOM 内 touch-action 的交集计算存在怪癖，触摸落在深层子元素
+	* （如 slider thumb、segmented-trigger 的 shadow 内容）时，声明在手势元素上的
+	* touch-action: none 可能不生效，iOS 会把触摸判为滚动意图并在越过阈值前触发
+	* pointercancel，拖拽因此中断。非被动 touchmove + preventDefault 是 WebKit 也
+	* 尊重的最后手段：页面显式处理触摸移动后，滚动识别器不会获胜，也就不会接管。
+	*/
+	function handleTouchMove(e) {
+		if (e.cancelable) e.preventDefault();
 	}
-	function C() {
-		if (b) {
-			for (let e of b) e.removeEventListener("touchmove", x, !0);
-			b = null;
+	/**
+	* 沿 pointerdown 的 composedPath 在每个 Element/ShadowRoot 挂非被动 touchmove
+	* 监听。TouchEvent 不像 PointerEvent 那样可组合：非 composed 的 touchmove 只在
+	* 落点所在的 shadow tree 内传播（连 host 都不经过），所以单一手势元素上的监听
+	* 对 segmented-trigger 这类深层 shadow 内容完全失效。composedPath 覆盖落点的
+	* 全部 shadow tree 链，无论 touchmove 在哪一层传播，路径上必有我们挂载的节点
+	* 能收到事件并 preventDefault。document/window 不在挂载范围：touchmove 到不了
+	* 它们，挂上也只是死代码。
+	*/
+	function attachTouchGuards(e) {
+		const targets = /* @__PURE__ */ new Set();
+		const path = typeof e.composedPath === "function" ? e.composedPath() : [];
+		for (const node of path) {
+			const type = node.nodeType;
+			if (type === Node.ELEMENT_NODE || type === Node.DOCUMENT_FRAGMENT_NODE) {
+				node.addEventListener("touchmove", handleTouchMove, {
+					capture: true,
+					passive: false
+				});
+				targets.add(node);
+			}
 		}
+		touchGuardTargets = targets;
 	}
-	function w() {
-		if (v.length < 2) return {
+	function detachTouchGuards() {
+		if (!touchGuardTargets) return;
+		for (const node of touchGuardTargets) node.removeEventListener("touchmove", handleTouchMove, true);
+		touchGuardTargets = null;
+	}
+	function estimateVelocity() {
+		if (samples.length < 2) return {
 			vx: 0,
 			vy: 0,
 			v: 0
 		};
-		let e = v[0], t = v[v.length - 1], n = t.t - e.t;
-		if (n < 2) return {
+		const first = samples[0];
+		const last = samples[samples.length - 1];
+		const dt = last.t - first.t;
+		if (dt < 2) return {
 			vx: 0,
 			vy: 0,
 			v: 0
 		};
-		let r = (t.x - e.x) / n * 1e3, a = (t.y - e.y) / n * 1e3, o = 0;
-		return o = i === "x" ? r : i === "y" ? a : Math.hypot(r, a), {
-			vx: r,
-			vy: a,
-			v: o
+		const vx = (last.x - first.x) / dt * 1e3;
+		const vy = (last.y - first.y) / dt * 1e3;
+		let v = 0;
+		if (axis === "x") v = vx;
+		else if (axis === "y") v = vy;
+		else v = Math.hypot(vx, vy);
+		return {
+			vx,
+			vy,
+			v
 		};
 	}
-	function T() {
-		window.removeEventListener("pointermove", j, !0), window.removeEventListener("pointerup", M, !0), window.removeEventListener("pointercancel", N, !0), window.removeEventListener("lostpointercapture", P, !0);
+	function detachWindowListeners() {
+		window.removeEventListener("pointermove", handlePointerMove, true);
+		window.removeEventListener("pointerup", handlePointerUp, true);
+		window.removeEventListener("pointercancel", handlePointerCancel, true);
+		window.removeEventListener("lostpointercapture", handleLostPointerCapture, true);
 	}
-	function E() {
-		window.addEventListener("pointermove", j, !0), window.addEventListener("pointerup", M, !0), window.addEventListener("pointercancel", N, !0), window.addEventListener("lostpointercapture", P, !0);
+	function attachWindowListeners() {
+		window.addEventListener("pointermove", handlePointerMove, true);
+		window.addEventListener("pointerup", handlePointerUp, true);
+		window.addEventListener("pointercancel", handlePointerCancel, true);
+		window.addEventListener("lostpointercapture", handleLostPointerCapture, true);
 	}
-	function D() {
-		r && (r.removeEventListener("pointermove", j), r.removeEventListener("pointerup", M), r.removeEventListener("pointercancel", N), r.removeEventListener("lostpointercapture", P));
+	function detachTargetListeners() {
+		if (!target) return;
+		target.removeEventListener("pointermove", handlePointerMove);
+		target.removeEventListener("pointerup", handlePointerUp);
+		target.removeEventListener("pointercancel", handlePointerCancel);
+		target.removeEventListener("lostpointercapture", handleLostPointerCapture);
 	}
-	function O() {
-		r && (r.addEventListener("pointermove", j), r.addEventListener("pointerup", M), r.addEventListener("pointercancel", N), r.addEventListener("lostpointercapture", P));
+	function attachTargetListeners() {
+		if (!target) return;
+		target.addEventListener("pointermove", handlePointerMove);
+		target.addEventListener("pointerup", handlePointerUp);
+		target.addEventListener("pointercancel", handlePointerCancel);
+		target.addEventListener("lostpointercapture", handleLostPointerCapture);
 	}
-	function k() {
-		if (f !== null && r && typeof r.hasPointerCapture == "function") try {
-			r.hasPointerCapture(f) && r.releasePointerCapture(f);
+	function resetState() {
+		if (activePointerId !== null && target && typeof target.hasPointerCapture === "function") try {
+			if (target.hasPointerCapture(activePointerId)) target.releasePointerCapture(activePointerId);
 		} catch {}
-		f = null, g = a <= 0, _ = !1, v = [], y = null, T(), D(), C();
+		activePointerId = null;
+		isThresholdPassed = threshold <= 0;
+		isCalibrated = false;
+		samples = [];
+		handledMoveEvent = null;
+		detachWindowListeners();
+		detachTargetListeners();
+		detachTouchGuards();
 	}
-	function A(e) {
-		if (f !== null || e.pointerType === "touch" && e.isPrimary === !1) return;
-		let t = {
+	function handlePointerDown(e) {
+		if (activePointerId !== null) return;
+		if (e.pointerType === "touch" && e.isPrimary === false) return;
+		const startInfo = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
 			timeStamp: e.timeStamp
 		};
-		if (s?.(t, e) !== !1 && (f = e.pointerId, p = e.clientX, m = e.clientY, h = e.timeStamp, g = a <= 0, _ = !1, v = [{
+		if (onStart?.(startInfo, e) === false) return;
+		activePointerId = e.pointerId;
+		startX = e.clientX;
+		startY = e.clientY;
+		startTimeStamp = e.timeStamp;
+		isThresholdPassed = threshold <= 0;
+		isCalibrated = false;
+		samples = [{
 			t: e.timeStamp,
 			x: e.clientX,
 			y: e.clientY
-		}], y = null, E(), O(), S(e), g)) try {
-			r?.setPointerCapture?.(e.pointerId);
+		}];
+		handledMoveEvent = null;
+		attachWindowListeners();
+		attachTargetListeners();
+		attachTouchGuards(e);
+		if (isThresholdPassed) try {
+			target?.setPointerCapture?.(e.pointerId);
 		} catch {}
 	}
-	function j(e) {
-		if (f !== e.pointerId || y === e) return;
-		if (y = e, !g) {
-			let t = e.clientX - p, n = e.clientY - m, o = i === "x" ? Math.abs(t) : i === "y" ? Math.abs(n) : Math.hypot(t, n);
-			if (i === "x" && Math.abs(n) >= a && Math.abs(n) > Math.abs(t)) {
-				F();
+	function handlePointerMove(e) {
+		if (activePointerId !== e.pointerId) return;
+		if (handledMoveEvent === e) return;
+		handledMoveEvent = e;
+		if (!isThresholdPassed) {
+			const rawDeltaX = e.clientX - startX;
+			const rawDeltaY = e.clientY - startY;
+			const distance = axis === "x" ? Math.abs(rawDeltaX) : axis === "y" ? Math.abs(rawDeltaY) : Math.hypot(rawDeltaX, rawDeltaY);
+			if (axis === "x" && Math.abs(rawDeltaY) >= threshold && Math.abs(rawDeltaY) > Math.abs(rawDeltaX)) {
+				cancel();
 				return;
 			}
-			if (i === "y" && Math.abs(t) >= a && Math.abs(t) > Math.abs(n)) {
-				F();
+			if (axis === "y" && Math.abs(rawDeltaX) >= threshold && Math.abs(rawDeltaX) > Math.abs(rawDeltaY)) {
+				cancel();
 				return;
 			}
-			if (o < a) return;
-			g = !0, h = e.timeStamp;
+			if (distance < threshold) return;
+			isThresholdPassed = true;
+			startTimeStamp = e.timeStamp;
 			try {
-				r?.setPointerCapture?.(e.pointerId);
+				target?.setPointerCapture?.(e.pointerId);
 			} catch {}
 		}
-		o && !_ && (_ = !0, p = e.clientX, m = e.clientY, h = e.timeStamp);
-		let t = e.clientX - p, n = e.clientY - m;
-		e.cancelable && e.preventDefault();
-		let s = e.timeStamp;
-		for (v.push({
-			t: s,
+		if (calibrateOnFirstMove && !isCalibrated) {
+			isCalibrated = true;
+			startX = e.clientX;
+			startY = e.clientY;
+			startTimeStamp = e.timeStamp;
+		}
+		const deltaX = e.clientX - startX;
+		const deltaY = e.clientY - startY;
+		if (e.cancelable) e.preventDefault();
+		const now = e.timeStamp;
+		samples.push({
+			t: now,
 			x: e.clientX,
 			y: e.clientY
-		}); v.length > 2 && s - v[0].t > 100;) v.shift();
-		let { vx: l, vy: u, v: d } = w(), b = {
+		});
+		while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) samples.shift();
+		const { vx, vy, v } = estimateVelocity();
+		const moveInfo = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
-			deltaX: t,
-			deltaY: n,
-			velocityX: l,
-			velocityY: u,
-			velocity: d,
-			timeStamp: s
+			deltaX,
+			deltaY,
+			velocityX: vx,
+			velocityY: vy,
+			velocity: v,
+			timeStamp: now
 		};
-		c?.(b, e);
+		onMove?.(moveInfo, e);
 	}
-	function M(e) {
-		if (f !== e.pointerId) return;
-		let t = e.timeStamp;
-		for (v.push({
-			t,
+	function handlePointerUp(e) {
+		if (activePointerId !== e.pointerId) return;
+		const now = e.timeStamp;
+		samples.push({
+			t: now,
 			x: e.clientX,
 			y: e.clientY
-		}); v.length > 2 && t - v[0].t > 100;) v.shift();
-		let n = e.clientX - p, r = e.clientY - m, { vx: i, vy: a, v: o } = w(), s = {
+		});
+		while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) samples.shift();
+		const deltaX = e.clientX - startX;
+		const deltaY = e.clientY - startY;
+		const { vx, vy, v } = estimateVelocity();
+		const endInfo = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
-			deltaX: n,
-			deltaY: r,
-			velocityX: i,
-			velocityY: a,
-			velocity: o,
+			deltaX,
+			deltaY,
+			velocityX: vx,
+			velocityY: vy,
+			velocity: v,
 			timeStamp: e.timeStamp,
-			duration: Math.max(0, e.timeStamp - h)
-		}, c = g;
-		k(), c ? l?.(s, e) : (u?.(s, e), d?.(e));
+			duration: Math.max(0, e.timeStamp - startTimeStamp)
+		};
+		const hadPassedThreshold = isThresholdPassed;
+		resetState();
+		if (hadPassedThreshold) onEnd?.(endInfo, e);
+		else {
+			onTap?.(endInfo, e);
+			onCancel?.(e);
+		}
 	}
-	function N(e) {
-		f === e.pointerId && (k(), d?.(e));
+	function handlePointerCancel(e) {
+		if (activePointerId !== e.pointerId) return;
+		resetState();
+		onCancel?.(e);
 	}
-	function P(e) {
-		f === e.pointerId && e.target === r && (k(), d?.(e));
+	/**
+	* lostpointercapture 不能当作 pointercancel：touch 指针在 pointerdown 时会被浏览器
+	* 隐式捕获到命中元素（如 slider thumb、segmented-trigger 内容），组件随后
+	* setPointerCapture(target) 把捕获转手到手势元素，命中元素先收到 lostpointercapture——
+	* 这是正常转手而非取消，若直接走 cancel 会把刚启动的拖拽杀死（值只走一步即冻结）。
+	* 只有手势元素自身意外丢失捕获（如元素被移出文档）才应取消。
+	*
+	* resetState 内 releasePointerCapture 产生的 lostpointercapture 会在 activePointerId
+	* 置空之后异步到达，被 pointerId 守卫挡住，不会误伤。
+	*/
+	function handleLostPointerCapture(e) {
+		if (activePointerId !== e.pointerId) return;
+		if (e.target !== target) return;
+		resetState();
+		onCancel?.(e);
 	}
-	function F() {
-		f !== null && (k(), d?.());
+	function cancel() {
+		if (activePointerId === null) return;
+		resetState();
+		onCancel?.();
 	}
-	return n ? A(e) : r && (r.addEventListener("pointerdown", A), r.addEventListener("pointermove", j), r.addEventListener("pointerup", M), r.addEventListener("pointercancel", N)), {
-		isDragging: () => f !== null,
-		cancel: F,
+	if (isEvent) handlePointerDown(targetOrEvent);
+	else if (target) {
+		target.addEventListener("pointerdown", handlePointerDown);
+		target.addEventListener("pointermove", handlePointerMove);
+		target.addEventListener("pointerup", handlePointerUp);
+		target.addEventListener("pointercancel", handlePointerCancel);
+	}
+	return {
+		isDragging: () => activePointerId !== null,
+		cancel,
 		destroy: () => {
-			F(), !n && r && (r.removeEventListener("pointerdown", A), r.removeEventListener("pointermove", j), r.removeEventListener("pointerup", M), r.removeEventListener("pointercancel", N));
+			cancel();
+			if (!isEvent && target) {
+				target.removeEventListener("pointerdown", handlePointerDown);
+				target.removeEventListener("pointermove", handlePointerMove);
+				target.removeEventListener("pointerup", handlePointerUp);
+				target.removeEventListener("pointercancel", handlePointerCancel);
+			}
 		}
 	};
 }
-//#endregion
-export { e as attachDragGesture };
+export { attachDragGesture };
 
 //# sourceMappingURL=drag-gesture.js.map

package/dist/shared/gesture/drag-gesture.js.map

@@ -1 +1 @@
-{"version":3,"file":"drag-gesture.js","names":[],"sources":["../../../src/shared/gesture/drag-gesture.ts"],"sourcesContent":["/**\n * 跨平台/跨浏览器 Pointer 拖拽手势生命周期管理器\n *\n * 封装：\n * 1. setPointerCapture 安全捕获与 window 兜底监听（防 pointer 丢失/离开视口悬挂）\n * 2. 多点触控副指针与未聚焦指针过滤\n * 3. 意图死区（threshold）与滑动轴向判定\n * 4. 可选的零点校准（calibrateOnFirstMove：首个有效 move 重置零点与判定时钟）\n * 5. 100ms 滑动窗口平滑速度估算（Velocity px/s）\n * 6. Window / Handle 跨层事件去重（防重复采样）\n */\n\nconst VELOCITY_WINDOW_MS = 100\n\nexport interface DragSample {\n  t: number\n  x: number\n  y: number\n}\n\nexport interface DragStartInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  timeStamp: number\n}\n\nexport interface DragMoveInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  deltaX: number\n  deltaY: number\n  velocityX: number\n  velocityY: number\n  velocity: number // 沿配置主轴（若为 both 则为欧氏速度）\n  timeStamp: number\n}\n\nexport interface DragEndInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  deltaX: number\n  deltaY: number\n  velocityX: number\n  velocityY: number\n  velocity: number\n  timeStamp: number\n  /**\n   * 手势从**被识别**（越过意图死区；无死区时为 pointerdown）到本次释放的总时长（ms）。\n   * `velocity*` 是滑动窗口内的瞬时速度，只描述最后一小段轨迹；需要「整段手势的平均速度」\n   * （如判定甩动意图）时用它做分母。\n   */\n  duration: number\n}\n\nexport interface DragGestureOptions {\n  /** 允许拖拽的轴向，默认 'both' */\n  axis?: 'x' | 'y' | 'both'\n  /** 拖拽启动的意图死区阈值（像素）。默认 0（即时跟手） */\n  threshold?: number\n  /**\n   * 首个有效 pointermove 时把拖拽零点与判定时钟一起重置到该点，默认 false。\n   * 吸收「按下 → 首个 move」之间的空隙（触摸输入的首个 move 常已相对按下点偏移），\n   * 否则这段位移会在首个 move 一次性兑现而让元素跳。开启后 `DragMoveInfo/DragEndInfo`\n   * 的 `delta*` 与 `duration` 都以该点为零点与起点，代价是这段位移被丢弃。\n   * 有意图死区时校准落在**越过死区的那次 move**（此时 `startTimeStamp` 的既有重置与之同值）。\n   */\n  calibrateOnFirstMove?: boolean\n  /** 手势启动回调。返回 false 可取消本次拖拽 */\n  onStart?: (info: DragStartInfo, event: PointerEvent) => boolean | void\n  /** 拖拽移动回调 */\n  onMove?: (info: DragMoveInfo, event: PointerEvent) => void\n  /** 正常松手回调 */\n  onEnd?: (info: DragEndInfo, event: PointerEvent) => void\n  /** 未通过意图阈值的 pointerup 回调，供点击定位类控件提交一次 tap */\n  onTap?: (info: DragEndInfo, event: PointerEvent) => void\n  /** 手势取消/被打断回调（如 pointercancel、外部强行 cancel） */\n  onCancel?: (event?: PointerEvent) => void\n}\n\nexport interface DragGestureHandle {\n  /** 当前是否有正在进行的拖拽手势 */\n  isDragging: () => boolean\n  /** 外部强制取消当前拖拽（恢复初态并触发 onCancel） */\n  cancel: () => void\n  /** 彻底销毁手势监听器与解绑 DOM */\n  destroy: () => void\n}\n\n/**\n * 为指定元素挂载统一的 Pointer 拖拽手势，或在已有的 pointerdown 事件中启动手势\n */\nexport function attachDragGesture(\n  targetOrEvent: HTMLElement | PointerEvent,\n  options: DragGestureOptions\n): DragGestureHandle {\n  const isEvent = typeof PointerEvent !== 'undefined' && targetOrEvent instanceof PointerEvent\n  const target: HTMLElement | null = isEvent\n    ? (targetOrEvent.currentTarget as HTMLElement | null) || (targetOrEvent.target as HTMLElement | null)\n    : (targetOrEvent as HTMLElement)\n\n  const {\n    axis = 'both',\n    threshold = 0,\n    calibrateOnFirstMove = false,\n    onStart,\n    onMove,\n    onEnd,\n    onTap,\n    onCancel\n  } = options\n\n  let activePointerId: number | null = null\n  let startX = 0\n  let startY = 0\n  let startTimeStamp = 0\n  let isThresholdPassed = threshold <= 0\n  let isCalibrated = false\n  let samples: DragSample[] = []\n  let handledMoveEvent: PointerEvent | null = null\n  let touchGuardTargets: Set<EventTarget> | null = null\n\n  /**\n   * iOS Safari 滚动接管兜底：\n   * WebKit 对 shadow DOM 内 touch-action 的交集计算存在怪癖，触摸落在深层子元素\n   * （如 slider thumb、segmented-trigger 的 shadow 内容）时，声明在手势元素上的\n   * touch-action: none 可能不生效，iOS 会把触摸判为滚动意图并在越过阈值前触发\n   * pointercancel，拖拽因此中断。非被动 touchmove + preventDefault 是 WebKit 也\n   * 尊重的最后手段：页面显式处理触摸移动后，滚动识别器不会获胜，也就不会接管。\n   */\n  function handleTouchMove(e: Event) {\n    if (e.cancelable) e.preventDefault()\n  }\n\n  /**\n   * 沿 pointerdown 的 composedPath 在每个 Element/ShadowRoot 挂非被动 touchmove\n   * 监听。TouchEvent 不像 PointerEvent 那样可组合：非 composed 的 touchmove 只在\n   * 落点所在的 shadow tree 内传播（连 host 都不经过），所以单一手势元素上的监听\n   * 对 segmented-trigger 这类深层 shadow 内容完全失效。composedPath 覆盖落点的\n   * 全部 shadow tree 链，无论 touchmove 在哪一层传播，路径上必有我们挂载的节点\n   * 能收到事件并 preventDefault。document/window 不在挂载范围：touchmove 到不了\n   * 它们，挂上也只是死代码。\n   */\n  function attachTouchGuards(e: PointerEvent) {\n    const targets = new Set<EventTarget>()\n    const path = typeof e.composedPath === 'function' ? e.composedPath() : []\n    for (const node of path) {\n      const type = (node as Node).nodeType\n      if (type === Node.ELEMENT_NODE || type === Node.DOCUMENT_FRAGMENT_NODE) {\n        node.addEventListener('touchmove', handleTouchMove, { capture: true, passive: false })\n        targets.add(node)\n      }\n    }\n    touchGuardTargets = targets\n  }\n\n  function detachTouchGuards() {\n    if (!touchGuardTargets) return\n    for (const node of touchGuardTargets) {\n      node.removeEventListener('touchmove', handleTouchMove, true)\n    }\n    touchGuardTargets = null\n  }\n\n  function estimateVelocity(): { vx: number; vy: number; v: number } {\n    if (samples.length < 2) return { vx: 0, vy: 0, v: 0 }\n    const first = samples[0]\n    const last = samples[samples.length - 1]\n    const dt = last.t - first.t\n    // 采样跨度不足 2ms（同帧/同毫秒的合成或极端快速事件）时不可信，置 0；\n    // 2-8ms 的超短轻扫仍按真实跨度上报速度，避免「快速轻扫」被误判为无速度\n    // 而回弹（旧守卫 <8ms 会把真实超短轻扫的速度清零）。\n    if (dt < 2) return { vx: 0, vy: 0, v: 0 }\n    const vx = ((last.x - first.x) / dt) * 1000\n    const vy = ((last.y - first.y) / dt) * 1000\n    let v = 0\n    if (axis === 'x') v = vx\n    else if (axis === 'y') v = vy\n    else v = Math.hypot(vx, vy)\n    return { vx, vy, v }\n  }\n\n  function detachWindowListeners() {\n    window.removeEventListener('pointermove', handlePointerMove, true)\n    window.removeEventListener('pointerup', handlePointerUp, true)\n    window.removeEventListener('pointercancel', handlePointerCancel, true)\n    window.removeEventListener('lostpointercapture', handleLostPointerCapture, true)\n  }\n\n  function attachWindowListeners() {\n    window.addEventListener('pointermove', handlePointerMove, true)\n    window.addEventListener('pointerup', handlePointerUp, true)\n    window.addEventListener('pointercancel', handlePointerCancel, true)\n    window.addEventListener('lostpointercapture', handleLostPointerCapture, true)\n  }\n\n  function detachTargetListeners() {\n    if (!target) return\n    target.removeEventListener('pointermove', handlePointerMove)\n    target.removeEventListener('pointerup', handlePointerUp)\n    target.removeEventListener('pointercancel', handlePointerCancel)\n    target.removeEventListener('lostpointercapture', handleLostPointerCapture)\n  }\n\n  function attachTargetListeners() {\n    if (!target) return\n    target.addEventListener('pointermove', handlePointerMove)\n    target.addEventListener('pointerup', handlePointerUp)\n    target.addEventListener('pointercancel', handlePointerCancel)\n    target.addEventListener('lostpointercapture', handleLostPointerCapture)\n  }\n\n  function resetState() {\n    if (activePointerId !== null && target && typeof target.hasPointerCapture === 'function') {\n      try {\n        if (target.hasPointerCapture(activePointerId)) {\n          target.releasePointerCapture(activePointerId)\n        }\n      } catch {\n        // ignore\n      }\n    }\n    activePointerId = null\n    isThresholdPassed = threshold <= 0\n    isCalibrated = false\n    samples = []\n    handledMoveEvent = null\n    detachWindowListeners()\n    detachTargetListeners()\n    detachTouchGuards()\n  }\n\n  function handlePointerDown(e: PointerEvent) {\n    if (activePointerId !== null) return\n    // 真实触控环境下的多点触控副指针不启动手势（合成事件或鼠标环境缺省时不拦截）\n    if (e.pointerType === 'touch' && e.isPrimary === false) return\n\n    const startInfo: DragStartInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      timeStamp: e.timeStamp\n    }\n\n    if (onStart?.(startInfo, e) === false) return\n\n    activePointerId = e.pointerId\n    startX = e.clientX\n    startY = e.clientY\n    startTimeStamp = e.timeStamp\n    isThresholdPassed = threshold <= 0\n    isCalibrated = false\n    samples = [{ t: e.timeStamp, x: e.clientX, y: e.clientY }]\n    handledMoveEvent = null\n\n    attachWindowListeners()\n    attachTargetListeners()\n    attachTouchGuards(e)\n\n    // 仅在无意图死区时立即捕获指针；若存在死区，延迟至确认拖拽后捕获，避免干扰子元素原生点击\n    if (isThresholdPassed) {\n      try {\n        target?.setPointerCapture?.(e.pointerId)\n      } catch {\n        // 忽略合成指针或不可捕获上下文（如测试环境）\n      }\n    }\n  }\n\n  function handlePointerMove(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    if (handledMoveEvent === e) return\n    handledMoveEvent = e\n\n    if (!isThresholdPassed) {\n      const rawDeltaX = e.clientX - startX\n      const rawDeltaY = e.clientY - startY\n      const distance =\n        axis === 'x' ? Math.abs(rawDeltaX) : axis === 'y' ? Math.abs(rawDeltaY) : Math.hypot(rawDeltaX, rawDeltaY)\n\n      // 交叉轴位移达到阈值且占主导时，立即让给滚动意图；不能等主轴也越过阈值，\n      // 否则这类手势会一直处于 tap 候选态，并在松手时被点击定位控件提交。\n      if (axis === 'x' && Math.abs(rawDeltaY) >= threshold && Math.abs(rawDeltaY) > Math.abs(rawDeltaX)) {\n        cancel()\n        return\n      }\n      if (axis === 'y' && Math.abs(rawDeltaX) >= threshold && Math.abs(rawDeltaX) > Math.abs(rawDeltaY)) {\n        cancel()\n        return\n      }\n      if (distance < threshold) return\n\n      isThresholdPassed = true\n      // 手势从「被识别」这一刻起算：有意图死区时，pointerdown 之后到越过死区之前的\n      // 悬停不属于拖拽轨迹，计进 duration 会稀释整段手势的平均速度。\n      startTimeStamp = e.timeStamp\n      try {\n        target?.setPointerCapture?.(e.pointerId)\n      } catch {\n        // 忽略合成指针\n      }\n    }\n\n    // 首个有效 move 的基准校准：零点与时钟一起重置到当前位置。位移与时长都必须在这之后\n    // 重新求（校准改写了零点），否则首个 move 会拿到校准前的旧位移。\n    if (calibrateOnFirstMove && !isCalibrated) {\n      isCalibrated = true\n      startX = e.clientX\n      startY = e.clientY\n      startTimeStamp = e.timeStamp\n    }\n\n    const deltaX = e.clientX - startX\n    const deltaY = e.clientY - startY\n\n    // 确认拖拽后阻止默认滚动/文字选中\n    if (e.cancelable) e.preventDefault()\n\n    const now = e.timeStamp\n    samples.push({ t: now, x: e.clientX, y: e.clientY })\n    while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) {\n      samples.shift()\n    }\n\n    const { vx, vy, v } = estimateVelocity()\n\n    const moveInfo: DragMoveInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      deltaX,\n      deltaY,\n      velocityX: vx,\n      velocityY: vy,\n      velocity: v,\n      timeStamp: now\n    }\n\n    onMove?.(moveInfo, e)\n  }\n\n  function handlePointerUp(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n\n    const now = e.timeStamp\n    samples.push({ t: now, x: e.clientX, y: e.clientY })\n    while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) {\n      samples.shift()\n    }\n\n    const deltaX = e.clientX - startX\n    const deltaY = e.clientY - startY\n    const { vx, vy, v } = estimateVelocity()\n\n    const endInfo: DragEndInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      deltaX,\n      deltaY,\n      velocityX: vx,\n      velocityY: vy,\n      velocity: v,\n      timeStamp: e.timeStamp,\n      // 时间戳同源（都是事件 timeStamp），合成事件序列可能倒退或为 0，钳到非负。\n      duration: Math.max(0, e.timeStamp - startTimeStamp)\n    }\n\n    const hadPassedThreshold = isThresholdPassed\n    resetState()\n\n    if (hadPassedThreshold) {\n      onEnd?.(endInfo, e)\n    } else {\n      onTap?.(endInfo, e)\n      onCancel?.(e)\n    }\n  }\n\n  function handlePointerCancel(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    resetState()\n    onCancel?.(e)\n  }\n\n  /**\n   * lostpointercapture 不能当作 pointercancel：touch 指针在 pointerdown 时会被浏览器\n   * 隐式捕获到命中元素（如 slider thumb、segmented-trigger 内容），组件随后\n   * setPointerCapture(target) 把捕获转手到手势元素，命中元素先收到 lostpointercapture——\n   * 这是正常转手而非取消，若直接走 cancel 会把刚启动的拖拽杀死（值只走一步即冻结）。\n   * 只有手势元素自身意外丢失捕获（如元素被移出文档）才应取消。\n   *\n   * resetState 内 releasePointerCapture 产生的 lostpointercapture 会在 activePointerId\n   * 置空之后异步到达，被 pointerId 守卫挡住，不会误伤。\n   */\n  function handleLostPointerCapture(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    if (e.target !== target) return\n    resetState()\n    onCancel?.(e)\n  }\n\n  function cancel() {\n    if (activePointerId === null) return\n    resetState()\n    onCancel?.()\n  }\n\n  if (isEvent) {\n    handlePointerDown(targetOrEvent)\n  } else if (target) {\n    target.addEventListener('pointerdown', handlePointerDown)\n    target.addEventListener('pointermove', handlePointerMove)\n    target.addEventListener('pointerup', handlePointerUp)\n    target.addEventListener('pointercancel', handlePointerCancel)\n  }\n\n  return {\n    isDragging: () => activePointerId !== null,\n    cancel,\n    destroy: () => {\n      cancel()\n      if (!isEvent && target) {\n        target.removeEventListener('pointerdown', handlePointerDown)\n        target.removeEventListener('pointermove', handlePointerMove)\n        target.removeEventListener('pointerup', handlePointerUp)\n        target.removeEventListener('pointercancel', handlePointerCancel)\n      }\n    }\n  }\n}\n"],"mappings":"AA8FA,SAAgB,EACd,GACA,GACmB;CACnB,IAAM,IAAU,OAAO,eAAiB,OAAe,aAAyB,cAC1E,IAA6B,IAC9B,EAAc,iBAAyC,EAAc,SACrE,GAEC,EACJ,UAAO,QACP,eAAY,GACZ,0BAAuB,IACvB,YACA,WACA,UACA,UACA,gBACE,GAEA,IAAiC,MACjC,IAAS,GACT,IAAS,GACT,IAAiB,GACjB,IAAoB,KAAa,GACjC,IAAe,IACf,IAAwB,CAAC,GACzB,IAAwC,MACxC,IAA6C;CAUjD,SAAS,EAAgB,GAAU;EACjC,AAAI,EAAE,cAAY,EAAE,eAAe;CACrC;CAWA,SAAS,EAAkB,GAAiB;EAC1C,IAAM,oBAAU,IAAI,IAAiB,GAC/B,IAAO,OAAO,EAAE,gBAAiB,aAAa,EAAE,aAAa,IAAI,CAAC;EACxE,KAAK,IAAM,KAAQ,GAAM;GACvB,IAAM,IAAQ,EAAc;GAC5B,CAAI,MAAS,KAAK,gBAAgB,MAAS,KAAK,4BAC9C,EAAK,iBAAiB,aAAa,GAAiB;IAAE,SAAS;IAAM,SAAS;GAAM,CAAC,GACrF,EAAQ,IAAI,CAAI;EAEpB;EACA,IAAoB;CACtB;CAEA,SAAS,IAAoB;EACtB,OACL;QAAK,IAAM,KAAQ,GACjB,EAAK,oBAAoB,aAAa,GAAiB,EAAI;GAE7D,IAAoB;EAFyC;CAG/D;CAEA,SAAS,IAA0D;EACjE,IAAI,EAAQ,SAAS,GAAG,OAAO;GAAE,IAAI;GAAG,IAAI;GAAG,GAAG;EAAE;EACpD,IAAM,IAAQ,EAAQ,IAChB,IAAO,EAAQ,EAAQ,SAAS,IAChC,IAAK,EAAK,IAAI,EAAM;EAI1B,IAAI,IAAK,GAAG,OAAO;GAAE,IAAI;GAAG,IAAI;GAAG,GAAG;EAAE;EACxC,IAAM,KAAO,EAAK,IAAI,EAAM,KAAK,IAAM,KACjC,KAAO,EAAK,IAAI,EAAM,KAAK,IAAM,KACnC,IAAI;EAIR,OAHA,AAEK,IAFD,MAAS,MAAS,IACb,MAAS,MAAS,IAClB,KAAK,MAAM,GAAI,CAAE,GACnB;GAAE;GAAI;GAAI;EAAE;CACrB;CAEA,SAAS,IAAwB;EAI/B,AAHA,OAAO,oBAAoB,eAAe,GAAmB,EAAI,GACjE,OAAO,oBAAoB,aAAa,GAAiB,EAAI,GAC7D,OAAO,oBAAoB,iBAAiB,GAAqB,EAAI,GACrE,OAAO,oBAAoB,sBAAsB,GAA0B,EAAI;CACjF;CAEA,SAAS,IAAwB;EAI/B,AAHA,OAAO,iBAAiB,eAAe,GAAmB,EAAI,GAC9D,OAAO,iBAAiB,aAAa,GAAiB,EAAI,GAC1D,OAAO,iBAAiB,iBAAiB,GAAqB,EAAI,GAClE,OAAO,iBAAiB,sBAAsB,GAA0B,EAAI;CAC9E;CAEA,SAAS,IAAwB;EAC1B,MACL,EAAO,oBAAoB,eAAe,CAAiB,GAC3D,EAAO,oBAAoB,aAAa,CAAe,GACvD,EAAO,oBAAoB,iBAAiB,CAAmB,GAC/D,EAAO,oBAAoB,sBAAsB,CAAwB;CAC3E;CAEA,SAAS,IAAwB;EAC1B,MACL,EAAO,iBAAiB,eAAe,CAAiB,GACxD,EAAO,iBAAiB,aAAa,CAAe,GACpD,EAAO,iBAAiB,iBAAiB,CAAmB,GAC5D,EAAO,iBAAiB,sBAAsB,CAAwB;CACxE;CAEA,SAAS,IAAa;EACpB,IAAI,MAAoB,QAAQ,KAAU,OAAO,EAAO,qBAAsB,YAC5E,IAAI;GACF,AAAI,EAAO,kBAAkB,CAAe,KAC1C,EAAO,sBAAsB,CAAe;EAEhD,QAAQ,CAER;EASF,AAPA,IAAkB,MAClB,IAAoB,KAAa,GACjC,IAAe,IACf,IAAU,CAAC,GACX,IAAmB,MACnB,EAAsB,GACtB,EAAsB,GACtB,EAAkB;CACpB;CAEA,SAAS,EAAkB,GAAiB;EAG1C,IAFI,MAAoB,QAEpB,EAAE,gBAAgB,WAAW,EAAE,cAAc,IAAO;EAExD,IAAM,IAA2B;GAC/B,WAAW,EAAE;GACb,SAAS,EAAE;GACX,SAAS,EAAE;GACX,WAAW,EAAE;EACf;EAEI,QAAU,GAAW,CAAC,MAAM,OAEhC,IAAkB,EAAE,WACpB,IAAS,EAAE,SACX,IAAS,EAAE,SACX,IAAiB,EAAE,WACnB,IAAoB,KAAa,GACjC,IAAe,IACf,IAAU,CAAC;GAAE,GAAG,EAAE;GAAW,GAAG,EAAE;GAAS,GAAG,EAAE;EAAQ,CAAC,GACzD,IAAmB,MAEnB,EAAsB,GACtB,EAAsB,GACtB,EAAkB,CAAC,GAGf,IACF,IAAI;GACF,GAAQ,oBAAoB,EAAE,SAAS;EACzC,QAAQ,CAER;CAEJ;CAEA,SAAS,EAAkB,GAAiB;EAE1C,IADI,MAAoB,EAAE,aACtB,MAAqB,GAAG;EAG5B,IAFA,IAAmB,GAEf,CAAC,GAAmB;GACtB,IAAM,IAAY,EAAE,UAAU,GACxB,IAAY,EAAE,UAAU,GACxB,IACJ,MAAS,MAAM,KAAK,IAAI,CAAS,IAAI,MAAS,MAAM,KAAK,IAAI,CAAS,IAAI,KAAK,MAAM,GAAW,CAAS;GAI3G,IAAI,MAAS,OAAO,KAAK,IAAI,CAAS,KAAK,KAAa,KAAK,IAAI,CAAS,IAAI,KAAK,IAAI,CAAS,GAAG;IACjG,EAAO;IACP;GACF;GACA,IAAI,MAAS,OAAO,KAAK,IAAI,CAAS,KAAK,KAAa,KAAK,IAAI,CAAS,IAAI,KAAK,IAAI,CAAS,GAAG;IACjG,EAAO;IACP;GACF;GACA,IAAI,IAAW,GAAW;GAK1B,AAHA,IAAoB,IAGpB,IAAiB,EAAE;GACnB,IAAI;IACF,GAAQ,oBAAoB,EAAE,SAAS;GACzC,QAAQ,CAER;EACF;EAIA,AAAI,KAAwB,CAAC,MAC3B,IAAe,IACf,IAAS,EAAE,SACX,IAAS,EAAE,SACX,IAAiB,EAAE;EAGrB,IAAM,IAAS,EAAE,UAAU,GACrB,IAAS,EAAE,UAAU;EAG3B,AAAI,EAAE,cAAY,EAAE,eAAe;EAEnC,IAAM,IAAM,EAAE;EAEd,KADA,EAAQ,KAAK;GAAE,GAAG;GAAK,GAAG,EAAE;GAAS,GAAG,EAAE;EAAQ,CAAC,GAC5C,EAAQ,SAAS,KAAK,IAAM,EAAQ,EAAE,CAAC,IAAI,MAChD,EAAQ,MAAM;EAGhB,IAAM,EAAE,OAAI,OAAI,SAAM,EAAiB,GAEjC,IAAyB;GAC7B,WAAW,EAAE;GACb,SAAS,EAAE;GACX,SAAS,EAAE;GACX;GACA;GACA,WAAW;GACX,WAAW;GACX,UAAU;GACV,WAAW;EACb;EAEA,IAAS,GAAU,CAAC;CACtB;CAEA,SAAS,EAAgB,GAAiB;EACxC,IAAI,MAAoB,EAAE,WAAW;EAErC,IAAM,IAAM,EAAE;EAEd,KADA,EAAQ,KAAK;GAAK;GAAK,GAAG,EAAE;GAAS,GAAG,EAAE;EAAQ,CAAC,GAC5C,EAAQ,SAAS,KAAK,IAAM,EAAQ,EAAE,CAAC,IAAI,MAChD,EAAQ,MAAM;EAGhB,IAAM,IAAS,EAAE,UAAU,GACrB,IAAS,EAAE,UAAU,GACrB,EAAE,OAAI,OAAI,SAAM,EAAiB,GAEjC,IAAuB;GAC3B,WAAW,EAAE;GACb,SAAS,EAAE;GACX,SAAS,EAAE;GACX;GACA;GACA,WAAW;GACX,WAAW;GACX,UAAU;GACV,WAAW,EAAE;GAEb,UAAU,KAAK,IAAI,GAAG,EAAE,YAAY,CAAc;EACpD,GAEM,IAAqB;EAG3B,AAFA,EAAW,GAEP,IACF,IAAQ,GAAS,CAAC,KAElB,IAAQ,GAAS,CAAC,GAClB,IAAW,CAAC;CAEhB;CAEA,SAAS,EAAoB,GAAiB;EACxC,MAAoB,EAAE,cAC1B,EAAW,GACX,IAAW,CAAC;CACd;CAYA,SAAS,EAAyB,GAAiB;EAC7C,MAAoB,EAAE,aACtB,EAAE,WAAW,MACjB,EAAW,GACX,IAAW,CAAC;CACd;CAEA,SAAS,IAAS;EACZ,MAAoB,SACxB,EAAW,GACX,IAAW;CACb;CAWA,OATI,IACF,EAAkB,CAAa,IACtB,MACT,EAAO,iBAAiB,eAAe,CAAiB,GACxD,EAAO,iBAAiB,eAAe,CAAiB,GACxD,EAAO,iBAAiB,aAAa,CAAe,GACpD,EAAO,iBAAiB,iBAAiB,CAAmB,IAGvD;EACL,kBAAkB,MAAoB;EACtC;EACA,eAAe;GAEb,AADA,EAAO,GACH,CAAC,KAAW,MACd,EAAO,oBAAoB,eAAe,CAAiB,GAC3D,EAAO,oBAAoB,eAAe,CAAiB,GAC3D,EAAO,oBAAoB,aAAa,CAAe,GACvD,EAAO,oBAAoB,iBAAiB,CAAmB;EAEnE;CACF;AACF"}
+{"version":3,"file":"drag-gesture.js","names":[],"sources":["../../../src/shared/gesture/drag-gesture.ts"],"sourcesContent":["/**\n * 跨平台/跨浏览器 Pointer 拖拽手势生命周期管理器\n *\n * 封装：\n * 1. setPointerCapture 安全捕获与 window 兜底监听（防 pointer 丢失/离开视口悬挂）\n * 2. 多点触控副指针与未聚焦指针过滤\n * 3. 意图死区（threshold）与滑动轴向判定\n * 4. 可选的零点校准（calibrateOnFirstMove：首个有效 move 重置零点与判定时钟）\n * 5. 100ms 滑动窗口平滑速度估算（Velocity px/s）\n * 6. Window / Handle 跨层事件去重（防重复采样）\n */\n\nconst VELOCITY_WINDOW_MS = 100\n\nexport interface DragSample {\n  t: number\n  x: number\n  y: number\n}\n\nexport interface DragStartInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  timeStamp: number\n}\n\nexport interface DragMoveInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  deltaX: number\n  deltaY: number\n  velocityX: number\n  velocityY: number\n  velocity: number // 沿配置主轴（若为 both 则为欧氏速度）\n  timeStamp: number\n}\n\nexport interface DragEndInfo {\n  pointerId: number\n  clientX: number\n  clientY: number\n  deltaX: number\n  deltaY: number\n  velocityX: number\n  velocityY: number\n  velocity: number\n  timeStamp: number\n  /**\n   * 手势从**被识别**（越过意图死区；无死区时为 pointerdown）到本次释放的总时长（ms）。\n   * `velocity*` 是滑动窗口内的瞬时速度，只描述最后一小段轨迹；需要「整段手势的平均速度」\n   * （如判定甩动意图）时用它做分母。\n   */\n  duration: number\n}\n\nexport interface DragGestureOptions {\n  /** 允许拖拽的轴向，默认 'both' */\n  axis?: 'x' | 'y' | 'both'\n  /** 拖拽启动的意图死区阈值（像素）。默认 0（即时跟手） */\n  threshold?: number\n  /**\n   * 首个有效 pointermove 时把拖拽零点与判定时钟一起重置到该点，默认 false。\n   * 吸收「按下 → 首个 move」之间的空隙（触摸输入的首个 move 常已相对按下点偏移），\n   * 否则这段位移会在首个 move 一次性兑现而让元素跳。开启后 `DragMoveInfo/DragEndInfo`\n   * 的 `delta*` 与 `duration` 都以该点为零点与起点，代价是这段位移被丢弃。\n   * 有意图死区时校准落在**越过死区的那次 move**（此时 `startTimeStamp` 的既有重置与之同值）。\n   */\n  calibrateOnFirstMove?: boolean\n  /** 手势启动回调。返回 false 可取消本次拖拽 */\n  onStart?: (info: DragStartInfo, event: PointerEvent) => boolean | void\n  /** 拖拽移动回调 */\n  onMove?: (info: DragMoveInfo, event: PointerEvent) => void\n  /** 正常松手回调 */\n  onEnd?: (info: DragEndInfo, event: PointerEvent) => void\n  /** 未通过意图阈值的 pointerup 回调，供点击定位类控件提交一次 tap */\n  onTap?: (info: DragEndInfo, event: PointerEvent) => void\n  /** 手势取消/被打断回调（如 pointercancel、外部强行 cancel） */\n  onCancel?: (event?: PointerEvent) => void\n}\n\nexport interface DragGestureHandle {\n  /** 当前是否有正在进行的拖拽手势 */\n  isDragging: () => boolean\n  /** 外部强制取消当前拖拽（恢复初态并触发 onCancel） */\n  cancel: () => void\n  /** 彻底销毁手势监听器与解绑 DOM */\n  destroy: () => void\n}\n\n/**\n * 为指定元素挂载统一的 Pointer 拖拽手势，或在已有的 pointerdown 事件中启动手势\n */\nexport function attachDragGesture(\n  targetOrEvent: HTMLElement | PointerEvent,\n  options: DragGestureOptions\n): DragGestureHandle {\n  const isEvent = typeof PointerEvent !== 'undefined' && targetOrEvent instanceof PointerEvent\n  const target: HTMLElement | null = isEvent\n    ? (targetOrEvent.currentTarget as HTMLElement | null) || (targetOrEvent.target as HTMLElement | null)\n    : (targetOrEvent as HTMLElement)\n\n  const {\n    axis = 'both',\n    threshold = 0,\n    calibrateOnFirstMove = false,\n    onStart,\n    onMove,\n    onEnd,\n    onTap,\n    onCancel\n  } = options\n\n  let activePointerId: number | null = null\n  let startX = 0\n  let startY = 0\n  let startTimeStamp = 0\n  let isThresholdPassed = threshold <= 0\n  let isCalibrated = false\n  let samples: DragSample[] = []\n  let handledMoveEvent: PointerEvent | null = null\n  let touchGuardTargets: Set<EventTarget> | null = null\n\n  /**\n   * iOS Safari 滚动接管兜底：\n   * WebKit 对 shadow DOM 内 touch-action 的交集计算存在怪癖，触摸落在深层子元素\n   * （如 slider thumb、segmented-trigger 的 shadow 内容）时，声明在手势元素上的\n   * touch-action: none 可能不生效，iOS 会把触摸判为滚动意图并在越过阈值前触发\n   * pointercancel，拖拽因此中断。非被动 touchmove + preventDefault 是 WebKit 也\n   * 尊重的最后手段：页面显式处理触摸移动后，滚动识别器不会获胜，也就不会接管。\n   */\n  function handleTouchMove(e: Event) {\n    if (e.cancelable) e.preventDefault()\n  }\n\n  /**\n   * 沿 pointerdown 的 composedPath 在每个 Element/ShadowRoot 挂非被动 touchmove\n   * 监听。TouchEvent 不像 PointerEvent 那样可组合：非 composed 的 touchmove 只在\n   * 落点所在的 shadow tree 内传播（连 host 都不经过），所以单一手势元素上的监听\n   * 对 segmented-trigger 这类深层 shadow 内容完全失效。composedPath 覆盖落点的\n   * 全部 shadow tree 链，无论 touchmove 在哪一层传播，路径上必有我们挂载的节点\n   * 能收到事件并 preventDefault。document/window 不在挂载范围：touchmove 到不了\n   * 它们，挂上也只是死代码。\n   */\n  function attachTouchGuards(e: PointerEvent) {\n    const targets = new Set<EventTarget>()\n    const path = typeof e.composedPath === 'function' ? e.composedPath() : []\n    for (const node of path) {\n      const type = (node as Node).nodeType\n      if (type === Node.ELEMENT_NODE || type === Node.DOCUMENT_FRAGMENT_NODE) {\n        node.addEventListener('touchmove', handleTouchMove, { capture: true, passive: false })\n        targets.add(node)\n      }\n    }\n    touchGuardTargets = targets\n  }\n\n  function detachTouchGuards() {\n    if (!touchGuardTargets) return\n    for (const node of touchGuardTargets) {\n      node.removeEventListener('touchmove', handleTouchMove, true)\n    }\n    touchGuardTargets = null\n  }\n\n  function estimateVelocity(): { vx: number; vy: number; v: number } {\n    if (samples.length < 2) return { vx: 0, vy: 0, v: 0 }\n    const first = samples[0]\n    const last = samples[samples.length - 1]\n    const dt = last.t - first.t\n    // 采样跨度不足 2ms（同帧/同毫秒的合成或极端快速事件）时不可信，置 0；\n    // 2-8ms 的超短轻扫仍按真实跨度上报速度，避免「快速轻扫」被误判为无速度\n    // 而回弹（旧守卫 <8ms 会把真实超短轻扫的速度清零）。\n    if (dt < 2) return { vx: 0, vy: 0, v: 0 }\n    const vx = ((last.x - first.x) / dt) * 1000\n    const vy = ((last.y - first.y) / dt) * 1000\n    let v = 0\n    if (axis === 'x') v = vx\n    else if (axis === 'y') v = vy\n    else v = Math.hypot(vx, vy)\n    return { vx, vy, v }\n  }\n\n  function detachWindowListeners() {\n    window.removeEventListener('pointermove', handlePointerMove, true)\n    window.removeEventListener('pointerup', handlePointerUp, true)\n    window.removeEventListener('pointercancel', handlePointerCancel, true)\n    window.removeEventListener('lostpointercapture', handleLostPointerCapture, true)\n  }\n\n  function attachWindowListeners() {\n    window.addEventListener('pointermove', handlePointerMove, true)\n    window.addEventListener('pointerup', handlePointerUp, true)\n    window.addEventListener('pointercancel', handlePointerCancel, true)\n    window.addEventListener('lostpointercapture', handleLostPointerCapture, true)\n  }\n\n  function detachTargetListeners() {\n    if (!target) return\n    target.removeEventListener('pointermove', handlePointerMove)\n    target.removeEventListener('pointerup', handlePointerUp)\n    target.removeEventListener('pointercancel', handlePointerCancel)\n    target.removeEventListener('lostpointercapture', handleLostPointerCapture)\n  }\n\n  function attachTargetListeners() {\n    if (!target) return\n    target.addEventListener('pointermove', handlePointerMove)\n    target.addEventListener('pointerup', handlePointerUp)\n    target.addEventListener('pointercancel', handlePointerCancel)\n    target.addEventListener('lostpointercapture', handleLostPointerCapture)\n  }\n\n  function resetState() {\n    if (activePointerId !== null && target && typeof target.hasPointerCapture === 'function') {\n      try {\n        if (target.hasPointerCapture(activePointerId)) {\n          target.releasePointerCapture(activePointerId)\n        }\n      } catch {\n        // ignore\n      }\n    }\n    activePointerId = null\n    isThresholdPassed = threshold <= 0\n    isCalibrated = false\n    samples = []\n    handledMoveEvent = null\n    detachWindowListeners()\n    detachTargetListeners()\n    detachTouchGuards()\n  }\n\n  function handlePointerDown(e: PointerEvent) {\n    if (activePointerId !== null) return\n    // 真实触控环境下的多点触控副指针不启动手势（合成事件或鼠标环境缺省时不拦截）\n    if (e.pointerType === 'touch' && e.isPrimary === false) return\n\n    const startInfo: DragStartInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      timeStamp: e.timeStamp\n    }\n\n    if (onStart?.(startInfo, e) === false) return\n\n    activePointerId = e.pointerId\n    startX = e.clientX\n    startY = e.clientY\n    startTimeStamp = e.timeStamp\n    isThresholdPassed = threshold <= 0\n    isCalibrated = false\n    samples = [{ t: e.timeStamp, x: e.clientX, y: e.clientY }]\n    handledMoveEvent = null\n\n    attachWindowListeners()\n    attachTargetListeners()\n    attachTouchGuards(e)\n\n    // 仅在无意图死区时立即捕获指针；若存在死区，延迟至确认拖拽后捕获，避免干扰子元素原生点击\n    if (isThresholdPassed) {\n      try {\n        target?.setPointerCapture?.(e.pointerId)\n      } catch {\n        // 忽略合成指针或不可捕获上下文（如测试环境）\n      }\n    }\n  }\n\n  function handlePointerMove(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    if (handledMoveEvent === e) return\n    handledMoveEvent = e\n\n    if (!isThresholdPassed) {\n      const rawDeltaX = e.clientX - startX\n      const rawDeltaY = e.clientY - startY\n      const distance =\n        axis === 'x' ? Math.abs(rawDeltaX) : axis === 'y' ? Math.abs(rawDeltaY) : Math.hypot(rawDeltaX, rawDeltaY)\n\n      // 交叉轴位移达到阈值且占主导时，立即让给滚动意图；不能等主轴也越过阈值，\n      // 否则这类手势会一直处于 tap 候选态，并在松手时被点击定位控件提交。\n      if (axis === 'x' && Math.abs(rawDeltaY) >= threshold && Math.abs(rawDeltaY) > Math.abs(rawDeltaX)) {\n        cancel()\n        return\n      }\n      if (axis === 'y' && Math.abs(rawDeltaX) >= threshold && Math.abs(rawDeltaX) > Math.abs(rawDeltaY)) {\n        cancel()\n        return\n      }\n      if (distance < threshold) return\n\n      isThresholdPassed = true\n      // 手势从「被识别」这一刻起算：有意图死区时，pointerdown 之后到越过死区之前的\n      // 悬停不属于拖拽轨迹，计进 duration 会稀释整段手势的平均速度。\n      startTimeStamp = e.timeStamp\n      try {\n        target?.setPointerCapture?.(e.pointerId)\n      } catch {\n        // 忽略合成指针\n      }\n    }\n\n    // 首个有效 move 的基准校准：零点与时钟一起重置到当前位置。位移与时长都必须在这之后\n    // 重新求（校准改写了零点），否则首个 move 会拿到校准前的旧位移。\n    if (calibrateOnFirstMove && !isCalibrated) {\n      isCalibrated = true\n      startX = e.clientX\n      startY = e.clientY\n      startTimeStamp = e.timeStamp\n    }\n\n    const deltaX = e.clientX - startX\n    const deltaY = e.clientY - startY\n\n    // 确认拖拽后阻止默认滚动/文字选中\n    if (e.cancelable) e.preventDefault()\n\n    const now = e.timeStamp\n    samples.push({ t: now, x: e.clientX, y: e.clientY })\n    while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) {\n      samples.shift()\n    }\n\n    const { vx, vy, v } = estimateVelocity()\n\n    const moveInfo: DragMoveInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      deltaX,\n      deltaY,\n      velocityX: vx,\n      velocityY: vy,\n      velocity: v,\n      timeStamp: now\n    }\n\n    onMove?.(moveInfo, e)\n  }\n\n  function handlePointerUp(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n\n    const now = e.timeStamp\n    samples.push({ t: now, x: e.clientX, y: e.clientY })\n    while (samples.length > 2 && now - samples[0].t > VELOCITY_WINDOW_MS) {\n      samples.shift()\n    }\n\n    const deltaX = e.clientX - startX\n    const deltaY = e.clientY - startY\n    const { vx, vy, v } = estimateVelocity()\n\n    const endInfo: DragEndInfo = {\n      pointerId: e.pointerId,\n      clientX: e.clientX,\n      clientY: e.clientY,\n      deltaX,\n      deltaY,\n      velocityX: vx,\n      velocityY: vy,\n      velocity: v,\n      timeStamp: e.timeStamp,\n      // 时间戳同源（都是事件 timeStamp），合成事件序列可能倒退或为 0，钳到非负。\n      duration: Math.max(0, e.timeStamp - startTimeStamp)\n    }\n\n    const hadPassedThreshold = isThresholdPassed\n    resetState()\n\n    if (hadPassedThreshold) {\n      onEnd?.(endInfo, e)\n    } else {\n      onTap?.(endInfo, e)\n      onCancel?.(e)\n    }\n  }\n\n  function handlePointerCancel(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    resetState()\n    onCancel?.(e)\n  }\n\n  /**\n   * lostpointercapture 不能当作 pointercancel：touch 指针在 pointerdown 时会被浏览器\n   * 隐式捕获到命中元素（如 slider thumb、segmented-trigger 内容），组件随后\n   * setPointerCapture(target) 把捕获转手到手势元素，命中元素先收到 lostpointercapture——\n   * 这是正常转手而非取消，若直接走 cancel 会把刚启动的拖拽杀死（值只走一步即冻结）。\n   * 只有手势元素自身意外丢失捕获（如元素被移出文档）才应取消。\n   *\n   * resetState 内 releasePointerCapture 产生的 lostpointercapture 会在 activePointerId\n   * 置空之后异步到达，被 pointerId 守卫挡住，不会误伤。\n   */\n  function handleLostPointerCapture(e: PointerEvent) {\n    if (activePointerId !== e.pointerId) return\n    if (e.target !== target) return\n    resetState()\n    onCancel?.(e)\n  }\n\n  function cancel() {\n    if (activePointerId === null) return\n    resetState()\n    onCancel?.()\n  }\n\n  if (isEvent) {\n    handlePointerDown(targetOrEvent)\n  } else if (target) {\n    target.addEventListener('pointerdown', handlePointerDown)\n    target.addEventListener('pointermove', handlePointerMove)\n    target.addEventListener('pointerup', handlePointerUp)\n    target.addEventListener('pointercancel', handlePointerCancel)\n  }\n\n  return {\n    isDragging: () => activePointerId !== null,\n    cancel,\n    destroy: () => {\n      cancel()\n      if (!isEvent && target) {\n        target.removeEventListener('pointerdown', handlePointerDown)\n        target.removeEventListener('pointermove', handlePointerMove)\n        target.removeEventListener('pointerup', handlePointerUp)\n        target.removeEventListener('pointercancel', handlePointerCancel)\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/shared/gesture/physics.js

@@ -1,23 +1,56 @@
-//#region src/shared/gesture/physics.ts
-function e(e, t, n) {
-	return Math.min(n, Math.max(t, e));
+// src/shared/gesture/physics.ts
+/**
+* 物理运动与数学辅助函数（阻尼、钳制与归一化）
+*/
+/**
+* 钳制数值在 [min, max] 范围内
+*/
+function clamp(value, min, max) {
+	return Math.min(max, Math.max(min, value));
 }
-function t(e, t) {
-	if (t.length === 0) return -1;
-	let n = Infinity, r = 0;
-	for (let i = 0; i < t.length; i++) {
-		let a = Math.abs(e - t[i]);
-		a < n && (n = a, r = i);
+/**
+* 寻找与目标值距离最近的采样点索引。
+* @param value 目标数值
+* @param points 采样点数组
+* @returns 最近采样点的下标（空数组返回 -1）
+*/
+function snapToNearest(value, points) {
+	if (points.length === 0) return -1;
+	let minDistance = Infinity;
+	let nearestIndex = 0;
+	for (let i = 0; i < points.length; i++) {
+		const dist = Math.abs(value - points[i]);
+		if (dist < minDistance) {
+			minDistance = dist;
+			nearestIndex = i;
+		}
 	}
-	return r;
+	return nearestIndex;
 }
-function n(t, n, r) {
-	return r <= n ? 0 : (e(t, n, r) - n) / (r - n);
+/**
+* 将数值钳制并归一化到 [0, 1] 区间（0 对应 min，1 对应 max）。
+* @param value 输入值
+* @param min 最小值
+* @param max 最大值
+*/
+function normalizeProgress(value, min, max) {
+	if (max <= min) return 0;
+	return (clamp(value, min, max) - min) / (max - min);
 }
-function r(e) {
-	return e >= 0 ? e : Math.sign(e) * Math.abs(e) ** .5;
+/**
+* 「不允许方向」的过冲阻尼。
+*
+* 允许方向原样 1:1 通过（由调用方保证传入的符号空间正确）；反向按平方根压缩，压缩比
+* 随位移增大而下降、天然自限幅（400px 过冲只剩 20px），因此不需要额外的位移上限。
+*
+* 它阻尼的是**本次手势自零点起的增量**，调用方再把它叠加到抓取瞬间的基准位移上
+* （`base + damp(delta)`）；直接阻尼总位移会把基准位移也一起压缩。
+* @param delta 自手势零点起、沿拖拽主轴的增量；正值 = 允许方向
+*/
+function dampOverscroll(delta) {
+	if (delta >= 0) return delta;
+	return Math.sign(delta) * Math.abs(delta) ** .5;
 }
-//#endregion
-export { e as clamp, r as dampOverscroll, n as normalizeProgress, t as snapToNearest };
+export { clamp, dampOverscroll, normalizeProgress, snapToNearest };
 
 //# sourceMappingURL=physics.js.map

package/dist/shared/gesture/physics.js.map

@@ -1 +1 @@
-{"version":3,"file":"physics.js","names":[],"sources":["../../../src/shared/gesture/physics.ts"],"sourcesContent":["/**\n * 物理运动与数学辅助函数（阻尼、钳制与归一化）\n */\n\n/**\n * 钳制数值在 [min, max] 范围内\n */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n\n/**\n * 寻找与目标值距离最近的采样点索引。\n * @param value 目标数值\n * @param points 采样点数组\n * @returns 最近采样点的下标（空数组返回 -1）\n */\nexport function snapToNearest(value: number, points: number[]): number {\n  if (points.length === 0) return -1\n  let minDistance = Infinity\n  let nearestIndex = 0\n  for (let i = 0; i < points.length; i++) {\n    const dist = Math.abs(value - points[i])\n    if (dist < minDistance) {\n      minDistance = dist\n      nearestIndex = i\n    }\n  }\n  return nearestIndex\n}\n\n/**\n * 将数值钳制并归一化到 [0, 1] 区间（0 对应 min，1 对应 max）。\n * @param value 输入值\n * @param min 最小值\n * @param max 最大值\n */\nexport function normalizeProgress(value: number, min: number, max: number): number {\n  if (max <= min) return 0\n  const clamped = clamp(value, min, max)\n  return (clamped - min) / (max - min)\n}\n\n/**\n * 「不允许方向」的过冲阻尼。\n *\n * 允许方向原样 1:1 通过（由调用方保证传入的符号空间正确）；反向按平方根压缩，压缩比\n * 随位移增大而下降、天然自限幅（400px 过冲只剩 20px），因此不需要额外的位移上限。\n *\n * 它阻尼的是**本次手势自零点起的增量**，调用方再把它叠加到抓取瞬间的基准位移上\n * （`base + damp(delta)`）；直接阻尼总位移会把基准位移也一起压缩。\n * @param delta 自手势零点起、沿拖拽主轴的增量；正值 = 允许方向\n */\nexport function dampOverscroll(delta: number): number {\n  if (delta >= 0) return delta\n  return Math.sign(delta) * Math.abs(delta) ** 0.5\n}\n"],"mappings":";AAOA,SAAgB,EAAM,GAAe,GAAa,GAAqB;CACrE,OAAO,KAAK,IAAI,GAAK,KAAK,IAAI,GAAK,CAAK,CAAC;AAC3C;AAQA,SAAgB,EAAc,GAAe,GAA0B;CACrE,IAAI,EAAO,WAAW,GAAG,OAAO;CAChC,IAAI,IAAc,UACd,IAAe;CACnB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAO,QAAQ,KAAK;EACtC,IAAM,IAAO,KAAK,IAAI,IAAQ,EAAO,EAAE;EACvC,AAAI,IAAO,MACT,IAAc,GACd,IAAe;CAEnB;CACA,OAAO;AACT;AAQA,SAAgB,EAAkB,GAAe,GAAa,GAAqB;CAGjF,OAFI,KAAO,IAAY,KACP,EAAM,GAAO,GAAK,CAC1B,IAAU,MAAQ,IAAM;AAClC;AAYA,SAAgB,EAAe,GAAuB;CAEpD,OADI,KAAS,IAAU,IAChB,KAAK,KAAK,CAAK,IAAI,KAAK,IAAI,CAAK,KAAK;AAC/C"}
+{"version":3,"file":"physics.js","names":[],"sources":["../../../src/shared/gesture/physics.ts"],"sourcesContent":["/**\n * 物理运动与数学辅助函数（阻尼、钳制与归一化）\n */\n\n/**\n * 钳制数值在 [min, max] 范围内\n */\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n\n/**\n * 寻找与目标值距离最近的采样点索引。\n * @param value 目标数值\n * @param points 采样点数组\n * @returns 最近采样点的下标（空数组返回 -1）\n */\nexport function snapToNearest(value: number, points: number[]): number {\n  if (points.length === 0) return -1\n  let minDistance = Infinity\n  let nearestIndex = 0\n  for (let i = 0; i < points.length; i++) {\n    const dist = Math.abs(value - points[i])\n    if (dist < minDistance) {\n      minDistance = dist\n      nearestIndex = i\n    }\n  }\n  return nearestIndex\n}\n\n/**\n * 将数值钳制并归一化到 [0, 1] 区间（0 对应 min，1 对应 max）。\n * @param value 输入值\n * @param min 最小值\n * @param max 最大值\n */\nexport function normalizeProgress(value: number, min: number, max: number): number {\n  if (max <= min) return 0\n  const clamped = clamp(value, min, max)\n  return (clamped - min) / (max - min)\n}\n\n/**\n * 「不允许方向」的过冲阻尼。\n *\n * 允许方向原样 1:1 通过（由调用方保证传入的符号空间正确）；反向按平方根压缩，压缩比\n * 随位移增大而下降、天然自限幅（400px 过冲只剩 20px），因此不需要额外的位移上限。\n *\n * 它阻尼的是**本次手势自零点起的增量**，调用方再把它叠加到抓取瞬间的基准位移上\n * （`base + damp(delta)`）；直接阻尼总位移会把基准位移也一起压缩。\n * @param delta 自手势零点起、沿拖拽主轴的增量；正值 = 允许方向\n */\nexport function dampOverscroll(delta: number): number {\n  if (delta >= 0) return delta\n  return Math.sign(delta) * Math.abs(delta) ** 0.5\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,MAAM,OAAe,KAAa,KAAqB;CACrE,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C;;;;;;;AAQA,SAAgB,cAAc,OAAe,QAA0B;CACrE,IAAI,OAAO,WAAW,GAAG,OAAO;CAChC,IAAI,cAAc;CAClB,IAAI,eAAe;CACnB,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EACtC,MAAM,OAAO,KAAK,IAAI,QAAQ,OAAO,EAAE;EACvC,IAAI,OAAO,aAAa;GACtB,cAAc;GACd,eAAe;EACjB;CACF;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAAe,KAAa,KAAqB;CACjF,IAAI,OAAO,KAAK,OAAO;CAEvB,QADgB,MAAM,OAAO,KAAK,GACpB,IAAI,QAAQ,MAAM;AAClC;;;;;;;;;;;AAYA,SAAgB,eAAe,OAAuB;CACpD,IAAI,SAAS,GAAG,OAAO;CACvB,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,IAAI,KAAK,KAAK;AAC/C"}