@greypan/web-ui 6.4.0 → 7.0.0

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

@@ -1,32 +1,32 @@
 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, onStart: o, onMove: s, onEnd: c, onTap: l, onCancel: u } = t, d = null, f = 0, p = 0, m = a <= 0, h = [], g = null, _ = null;
-	function v(e) {
+	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 y(e) {
+	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", v, {
+			(n === Node.ELEMENT_NODE || n === Node.DOCUMENT_FRAGMENT_NODE) && (e.addEventListener("touchmove", x, {
 				capture: !0,
 				passive: !1
 			}), t.add(e));
 		}
-		_ = t;
+		b = t;
 	}
-	function b() {
-		if (_) {
-			for (let e of _) e.removeEventListener("touchmove", v, !0);
-			_ = null;
+	function C() {
+		if (b) {
+			for (let e of b) e.removeEventListener("touchmove", x, !0);
+			b = null;
 		}
 	}
-	function x() {
-		if (h.length < 2) return {
+	function w() {
+		if (v.length < 2) return {
 			vx: 0,
 			vy: 0,
 			v: 0
 		};
-		let e = h[0], t = h[h.length - 1], n = t.t - e.t;
+		let e = v[0], t = v[v.length - 1], n = t.t - e.t;
 		if (n < 2) return {
 			vx: 0,
 			vy: 0,
@@ -39,88 +39,89 @@ function e(e, t) {
 			v: o
 		};
 	}
-	function S() {
-		window.removeEventListener("pointermove", O, !0), window.removeEventListener("pointerup", k, !0), window.removeEventListener("pointercancel", A, !0), window.removeEventListener("lostpointercapture", j, !0);
+	function T() {
+		window.removeEventListener("pointermove", j, !0), window.removeEventListener("pointerup", M, !0), window.removeEventListener("pointercancel", N, !0), window.removeEventListener("lostpointercapture", P, !0);
 	}
-	function C() {
-		window.addEventListener("pointermove", O, !0), window.addEventListener("pointerup", k, !0), window.addEventListener("pointercancel", A, !0), window.addEventListener("lostpointercapture", j, !0);
+	function E() {
+		window.addEventListener("pointermove", j, !0), window.addEventListener("pointerup", M, !0), window.addEventListener("pointercancel", N, !0), window.addEventListener("lostpointercapture", P, !0);
 	}
-	function w() {
-		r && (r.removeEventListener("pointermove", O), r.removeEventListener("pointerup", k), r.removeEventListener("pointercancel", A), r.removeEventListener("lostpointercapture", j));
+	function D() {
+		r && (r.removeEventListener("pointermove", j), r.removeEventListener("pointerup", M), r.removeEventListener("pointercancel", N), r.removeEventListener("lostpointercapture", P));
 	}
-	function T() {
-		r && (r.addEventListener("pointermove", O), r.addEventListener("pointerup", k), r.addEventListener("pointercancel", A), r.addEventListener("lostpointercapture", j));
+	function O() {
+		r && (r.addEventListener("pointermove", j), r.addEventListener("pointerup", M), r.addEventListener("pointercancel", N), r.addEventListener("lostpointercapture", P));
 	}
-	function E() {
-		if (d !== null && r && typeof r.hasPointerCapture == "function") try {
-			r.hasPointerCapture(d) && r.releasePointerCapture(d);
+	function k() {
+		if (f !== null && r && typeof r.hasPointerCapture == "function") try {
+			r.hasPointerCapture(f) && r.releasePointerCapture(f);
 		} catch {}
-		d = null, m = a <= 0, h = [], g = null, S(), w(), b();
+		f = null, g = a <= 0, _ = !1, v = [], y = null, T(), D(), C();
 	}
-	function D(e) {
-		if (d !== null || e.pointerType === "touch" && e.isPrimary === !1) return;
+	function A(e) {
+		if (f !== null || e.pointerType === "touch" && e.isPrimary === !1) return;
 		let t = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
 			timeStamp: e.timeStamp
 		};
-		if (o?.(t, e) !== !1 && (d = e.pointerId, f = e.clientX, p = e.clientY, m = a <= 0, h = [{
+		if (s?.(t, e) !== !1 && (f = e.pointerId, p = e.clientX, m = e.clientY, h = e.timeStamp, g = a <= 0, _ = !1, v = [{
 			t: e.timeStamp,
 			x: e.clientX,
 			y: e.clientY
-		}], g = null, C(), T(), y(e), m)) try {
+		}], y = null, E(), O(), S(e), g)) try {
 			r?.setPointerCapture?.(e.pointerId);
 		} catch {}
 	}
-	function O(e) {
-		if (d !== e.pointerId || g === e) return;
-		g = e;
-		let t = e.clientX - f, n = e.clientY - p;
-		if (!m) {
+	function j(e) {
+		if (f !== e.pointerId || y === e) return;
+		if (y = e, !g) {
+			let t = e.clientX - p, n = e.clientY - m;
 			if ((i === "x" ? Math.abs(t) : i === "y" ? Math.abs(n) : Math.hypot(t, n)) < a) return;
 			if (i === "x" && Math.abs(n) > Math.abs(t)) {
-				M();
+				F();
 				return;
 			}
 			if (i === "y" && Math.abs(t) > Math.abs(n)) {
-				M();
+				F();
 				return;
 			}
-			m = !0;
+			g = !0, h = e.timeStamp;
 			try {
 				r?.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 o = e.timeStamp;
-		for (h.push({
-			t: o,
+		let s = e.timeStamp;
+		for (v.push({
+			t: s,
 			x: e.clientX,
 			y: e.clientY
-		}); h.length > 2 && o - h[0].t > 100;) h.shift();
-		let { vx: c, vy: l, v: u } = x(), _ = {
+		}); v.length > 2 && s - v[0].t > 100;) v.shift();
+		let { vx: l, vy: u, v: d } = w(), b = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
 			deltaX: t,
 			deltaY: n,
-			velocityX: c,
-			velocityY: l,
-			velocity: u,
-			timeStamp: o
+			velocityX: l,
+			velocityY: u,
+			velocity: d,
+			timeStamp: s
 		};
-		s?.(_, e);
+		c?.(b, e);
 	}
-	function k(e) {
-		if (d !== e.pointerId) return;
+	function M(e) {
+		if (f !== e.pointerId) return;
 		let t = e.timeStamp;
-		for (h.push({
+		for (v.push({
 			t,
 			x: e.clientX,
 			y: e.clientY
-		}); h.length > 2 && t - h[0].t > 100;) h.shift();
-		let n = e.clientX - f, r = e.clientY - p, { vx: i, vy: a, v: o } = x(), s = {
+		}); 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 = {
 			pointerId: e.pointerId,
 			clientX: e.clientX,
 			clientY: e.clientY,
@@ -129,24 +130,25 @@ function e(e, t) {
 			velocityX: i,
 			velocityY: a,
 			velocity: o,
-			timeStamp: e.timeStamp
-		}, g = m;
-		E(), g ? c?.(s, e) : (l?.(s, e), u?.(e));
+			timeStamp: e.timeStamp,
+			duration: Math.max(0, e.timeStamp - h)
+		}, c = g;
+		k(), c ? l?.(s, e) : (u?.(s, e), d?.(e));
 	}
-	function A(e) {
-		d === e.pointerId && (E(), u?.(e));
+	function N(e) {
+		f === e.pointerId && (k(), d?.(e));
 	}
-	function j(e) {
-		d === e.pointerId && e.target === r && (E(), u?.(e));
+	function P(e) {
+		f === e.pointerId && e.target === r && (k(), d?.(e));
 	}
-	function M() {
-		d !== null && (E(), u?.());
+	function F() {
+		f !== null && (k(), d?.());
 	}
-	return n ? D(e) : r && (r.addEventListener("pointerdown", D), r.addEventListener("pointermove", O), r.addEventListener("pointerup", k), r.addEventListener("pointercancel", A)), {
-		isDragging: () => d !== null,
-		cancel: M,
+	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,
 		destroy: () => {
-			M(), !n && r && (r.removeEventListener("pointerdown", D), r.removeEventListener("pointermove", O), r.removeEventListener("pointerup", k), r.removeEventListener("pointercancel", A));
+			F(), !n && r && (r.removeEventListener("pointerdown", A), r.removeEventListener("pointermove", j), r.removeEventListener("pointerup", M), r.removeEventListener("pointercancel", N));
 		}
 	};
 }

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. 100ms 滑动窗口平滑速度估算（Velocity px/s）\n * 5. 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\nexport interface DragGestureOptions {\n  /** 允许拖拽的轴向，默认 'both' */\n  axis?: 'x' | 'y' | 'both'\n  /** 拖拽启动的意图死区阈值（像素）。默认 0（即时跟手） */\n  threshold?: number\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 { axis = 'both', threshold = 0, onStart, onMove, onEnd, onTap, onCancel } = options\n\n  let activePointerId: number | null = null\n  let startX = 0\n  let startY = 0\n  let isThresholdPassed = threshold <= 0\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    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    isThresholdPassed = threshold <= 0\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    const deltaX = e.clientX - startX\n    const deltaY = e.clientY - startY\n\n    if (!isThresholdPassed) {\n      const distance = axis === 'x' ? Math.abs(deltaX) : axis === 'y' ? Math.abs(deltaY) : Math.hypot(deltaX, deltaY)\n      if (distance < threshold) return\n\n      // 若限定了 X 轴且 Y 轴位移明显更大，视为滚动意图而非拖拽\n      if (axis === 'x' && Math.abs(deltaY) > Math.abs(deltaX)) {\n        cancel()\n        return\n      }\n      // 若限定了 Y 轴且 X 轴位移明显更大，放弃拖拽\n      if (axis === 'y' && Math.abs(deltaX) > Math.abs(deltaY)) {\n        cancel()\n        return\n      }\n      isThresholdPassed = true\n      try {\n        target?.setPointerCapture?.(e.pointerId)\n      } catch {\n        // 忽略合成指针\n      }\n    }\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    }\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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"}
+{"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      if (distance < threshold) return\n\n      // 若限定了 X 轴且 Y 轴位移明显更大，视为滚动意图而非拖拽\n      if (axis === 'x' && Math.abs(rawDeltaY) > Math.abs(rawDeltaX)) {\n        cancel()\n        return\n      }\n      if (axis === 'y' && Math.abs(rawDeltaX) > Math.abs(rawDeltaY)) {\n        cancel()\n        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,20 +1,8 @@
 //#region src/shared/gesture/physics.ts
-var e = {
-	close: {
-		stiffness: 260,
-		damping: 34,
-		maxSamples: 19
-	},
-	rebound: {
-		stiffness: 220,
-		damping: 22,
-		maxSamples: 29
-	}
-};
-function t(e, t, n) {
+function e(e, t, n) {
 	return Math.min(n, Math.max(t, e));
 }
-function n(e, t) {
+function t(e, t) {
 	if (t.length === 0) return -1;
 	let n = Infinity, r = 0;
 	for (let i = 0; i < t.length; i++) {
@@ -23,23 +11,13 @@ function n(e, t) {
 	}
 	return r;
 }
-function r(e, n, r) {
-	return r <= n ? 0 : (t(e, n, r) - n) / (r - n);
-}
-function i(e, t, n = .15) {
-	if (e >= 0) return e;
-	let r = e * n;
-	return Math.max(r, -t);
+function n(t, n, r) {
+	return r <= n ? 0 : (e(t, n, r) - n) / (r - n);
 }
-function a(e, t, n, r, i = 16) {
-	let a = i / 2e3, o = e, s = n, c = [o];
-	for (let e = 0; e < r.maxSamples * 2; e++) {
-		let n = -r.stiffness * (o - t) - r.damping * s;
-		if (s += n * a, o += s * a, e % 2 == 1 && c.push(o), Math.abs(o - t) < .5 && Math.abs(s) < 40) break;
-	}
-	return c.push(t), c;
+function r(e) {
+	return e >= 0 ? e : Math.sign(e) * Math.abs(e) ** .5;
 }
 //#endregion
-export { e as SPRING_PRESETS, t as clamp, r as normalizeProgress, i as rubberband, n as snapToNearest, a as springOffsets };
+export { e as clamp, r as dampOverscroll, n as normalizeProgress, t as 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\nexport interface SpringParams {\n  stiffness: number\n  damping: number\n  maxSamples: number\n}\n\nexport const SPRING_PRESETS = {\n  close: { stiffness: 260, damping: 34, maxSamples: 19 },\n  rebound: { stiffness: 220, damping: 22, maxSamples: 29 }\n} as const satisfies Record<string, SpringParams>\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 * @param offset 当前位移（正数正常，负数为拉伸超出边界）\n * @param maxDistance 最大拉伸上限（绝对值）\n * @param factor 线性衰减因子，默认 0.15\n */\nexport function rubberband(offset: number, maxDistance: number, factor = 0.15): number {\n  if (offset >= 0) return offset\n  const resisted = offset * factor\n  return Math.max(resisted, -maxDistance)\n}\n\n/**\n * 半隐式欧拉积分弹簧轨迹，返回均匀时间间隔的位置采样（末尾附加精确终点）。\n * @param from 起始位置\n * @param to 目标位置\n * @param velocity 初始速度（px/s）\n * @param spring 弹簧刚度与阻尼参数\n * @param sampleMs 采样时间间隔（毫秒，默认 16ms 对应 60fps）\n */\nexport function springOffsets(\n  from: number,\n  to: number,\n  velocity: number,\n  spring: SpringParams,\n  sampleMs = 16\n): number[] {\n  const dt = sampleMs / 2000\n  let x = from\n  let v = velocity\n  const samples = [x]\n  for (let i = 0; i < spring.maxSamples * 2; i++) {\n    const acceleration = -spring.stiffness * (x - to) - spring.damping * v\n    v += acceleration * dt\n    x += v * dt\n    if (i % 2 === 1) samples.push(x)\n    if (Math.abs(x - to) < 0.5 && Math.abs(v) < 40) break\n  }\n  samples.push(to)\n  return samples\n}\n"],"mappings":";AAUA,IAAa,IAAiB;CAC5B,OAAO;EAAE,WAAW;EAAK,SAAS;EAAI,YAAY;CAAG;CACrD,SAAS;EAAE,WAAW;EAAK,SAAS;EAAI,YAAY;CAAG;AACzD;AAKA,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;AAQA,SAAgB,EAAW,GAAgB,GAAqB,IAAS,KAAc;CACrF,IAAI,KAAU,GAAG,OAAO;CACxB,IAAM,IAAW,IAAS;CAC1B,OAAO,KAAK,IAAI,GAAU,CAAC,CAAW;AACxC;AAUA,SAAgB,EACd,GACA,GACA,GACA,GACA,IAAW,IACD;CACV,IAAM,IAAK,IAAW,KAClB,IAAI,GACJ,IAAI,GACF,IAAU,CAAC,CAAC;CAClB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAO,aAAa,GAAG,KAAK;EAC9C,IAAM,IAAe,CAAC,EAAO,aAAa,IAAI,KAAM,EAAO,UAAU;EAIrE,IAHA,KAAK,IAAe,GACpB,KAAK,IAAI,GACL,IAAI,KAAM,KAAG,EAAQ,KAAK,CAAC,GAC3B,KAAK,IAAI,IAAI,CAAE,IAAI,MAAO,KAAK,IAAI,CAAC,IAAI,IAAI;CAClD;CAEA,OADA,EAAQ,KAAK,CAAE,GACR;AACT"}
+{"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"}

package/dist/shared/menu-behavior/index.js

@@ -44,10 +44,6 @@ function o(e, t) {
 	};
 }
 function s(e, t) {
-	if (t.key === "Escape") {
-		e.closeDeepestOrAll(), t.preventDefault();
-		return;
-	}
 	let r = e.getFocusedItem(t), i = r ? e.getLevelOf(r) : void 0;
 	if (i === void 0) return;
 	let a = e.getEnabledItems(i), o = r ? a.indexOf(r) : -1;
@@ -103,6 +99,9 @@ function u(t) {
 		},
 		disposeAll() {
 			n.forEach((e) => t.dispose(e)), n.clear();
+		},
+		closing() {
+			return [...n.values()];
 		}
 	};
 }

package/dist/shared/menu-behavior/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/menu-behavior/index.ts"],"sourcesContent":["/**\n * 菜单行为层：dropdown 与 context-menu 共用的交互行为。\n *\n * 结构层（面板构建、迁移、定位）由 menu-portal/menu-tree 与各组件自己承载；\n * 这里只收口四种在两个组件中逐行复制的行为：\n * 1. outside-click 守卫（同帧吞掉打开点击 + composedPath 内含判定）\n * 2. 层级 hover 绑定（200ms 打开计时、touch 守卫、hover 收起更深层级）\n * 3. roving 键盘导航（Arrow/Home/End/Enter/Space/Escape）\n * 4. 关闭中的 submenu presence 收尾栈（动画结束后归还子项并销毁面板）\n *\n * 组件是 adapter：提供层级容器/项的查询与打开/关闭原语，行为由此驱动。\n */\nimport { findFocusedMenuItem, focusMenuItem, getEnabledMenuItems } from '@/shared/menu-portal/menu-tree'\nimport { hideOverlayPresence as hidePanelPresence } from '@/shared/overlay/presence'\n\n/** 菜单层级面板的最小视图：行为层只需要面板（presence/contains）与内容容器（项查询）。 */\nexport interface MenuLevelSurface {\n  panel: HTMLElement\n  content: HTMLElement\n}\n\n/* ------------------------------------------------------------------ *\n * Outside-click 守卫\n * ------------------------------------------------------------------ */\n\nexport interface MenuOutsideClickGuard {\n  /** 打开动作后调用：吞掉同一帧内随后冒泡到 document 的本次 click。 */\n  arm(): void\n  isArmed(): boolean\n  /** 事件是否发生在宿主 shadow root 或任何已打开面板内部。 */\n  isInside(event: MouseEvent): boolean\n  dispose(): void\n}\n\nexport function createMenuOutsideClickGuard(\n  host: HTMLElement,\n  isInsideOverlayPanel: (node: Node) => boolean\n): MenuOutsideClickGuard {\n  let armed = false\n  let disarmTimer: ReturnType<typeof setTimeout> | undefined\n\n  const isInside = (event: MouseEvent): boolean => {\n    for (const node of event.composedPath()) {\n      if (node === host || node === host.shadowRoot) return true\n      if (node instanceof Node && node.getRootNode() === host.shadowRoot) return true\n      if (node instanceof Node && isInsideOverlayPanel(node)) return true\n    }\n    return false\n  }\n\n  return {\n    arm() {\n      armed = true\n      clearTimeout(disarmTimer)\n      disarmTimer = setTimeout(() => {\n        armed = false\n      })\n    },\n    isArmed: () => armed,\n    isInside,\n    dispose() {\n      clearTimeout(disarmTimer)\n      armed = false\n    }\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * 层级 hover 绑定\n * ------------------------------------------------------------------ */\n\nexport interface MenuHoverDelegate {\n  /** 当前展开的 submenu 深度；行为层会绑定 0..depth+1 每一层。 */\n  getOpenDepth(): number\n  getLevelItems(level: number): HTMLElement[]\n  /** 该层当前激活（子面板已展开）的项；用于避免重复打开。 */\n  getActiveItem(level: number): HTMLElement | undefined\n  isSubmenuItem(item: HTMLElement): boolean\n  /** hover 到 submenu 项且它不是当前激活项。 */\n  openSubmenu(item: HTMLElement): void\n  /** hover 到叶子项且存在更深层级：关闭比它深的子面板（内部自行重新 bind）。 */\n  closeFrom(level: number): void\n}\n\nexport interface MenuHoverBinder {\n  bind(): void\n  dispose(): void\n}\n\nconst SUBMENU_HOVER_DELAY = 200\n\nexport function createMenuHoverBinder(delegate: MenuHoverDelegate, itemSelector: string): MenuHoverBinder {\n  let openTimer: ReturnType<typeof setTimeout> | undefined\n  let cleanupFns: (() => void)[] = []\n\n  function bind() {\n    cleanupFns.forEach(fn => fn())\n    cleanupFns = []\n\n    const depth = delegate.getOpenDepth()\n    for (let level = 0; level <= depth + 1; level++) {\n      const items = delegate.getLevelItems(level)\n      if (!items.length) continue\n      items.forEach(item => {\n        if (!item.matches(itemSelector) || item.hasAttribute('disabled')) return\n        const handler = (event: PointerEvent) => {\n          if (event.pointerType === 'touch') return\n          clearTimeout(openTimer)\n          if (delegate.isSubmenuItem(item)) {\n            if (delegate.getActiveItem(level) !== item) {\n              openTimer = setTimeout(() => delegate.openSubmenu(item), SUBMENU_HOVER_DELAY)\n            }\n          } else if (delegate.getOpenDepth() > level) {\n            delegate.closeFrom(level)\n          }\n        }\n        item.addEventListener('pointerenter', handler, { passive: true })\n        cleanupFns.push(() => item.removeEventListener('pointerenter', handler))\n      })\n    }\n  }\n\n  return {\n    bind,\n    dispose() {\n      clearTimeout(openTimer)\n      cleanupFns.forEach(fn => fn())\n      cleanupFns = []\n    }\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * roving 键盘导航\n * ------------------------------------------------------------------ */\n\nexport interface MenuKeyboardDelegate {\n  getFocusedItem(event?: KeyboardEvent): HTMLElement | undefined\n  /** 焦点项所在层级；不在任何面板内时返回 undefined。 */\n  getLevelOf(item: HTMLElement): number | undefined\n  getEnabledItems(level: number): HTMLElement[]\n  isSubmenuItem(item: HTMLElement): boolean\n  /** 键盘 ArrowRight：以 instant 语义打开该项的子面板。 */\n  openSubmenuInstant(item: HTMLElement): void\n  /** 键盘 ArrowLeft：关闭 level 层子面板并返回其父项。 */\n  closeToParent(level: number): HTMLElement | undefined\n  /** Escape：关闭最深一层子面板；没有子面板时关闭整个菜单。 */\n  closeDeepestOrAll(): void\n}\n\n/**\n * 处理菜单键盘事件；未命中的键原样返回，调用方不做 preventDefault。\n * 事件监听的挂载位置（宿主 / 面板 / document）由组件自己决定。\n */\nexport function handleMenuKeyboard(delegate: MenuKeyboardDelegate, e: KeyboardEvent): void {\n  if (e.key === 'Escape') {\n    delegate.closeDeepestOrAll()\n    e.preventDefault()\n    return\n  }\n\n  const focused = delegate.getFocusedItem(e)\n  const level = focused ? delegate.getLevelOf(focused) : undefined\n  if (level === undefined) return\n  const items = delegate.getEnabledItems(level)\n  const currentIndex = focused ? items.indexOf(focused) : -1\n\n  switch (e.key) {\n    case 'ArrowDown':\n      focusMenuItem(items[(currentIndex + 1 + items.length) % items.length])\n      break\n    case 'ArrowUp':\n      focusMenuItem(items[(currentIndex - 1 + items.length) % items.length])\n      break\n    case 'Home':\n      focusMenuItem(items[0])\n      break\n    case 'End':\n      focusMenuItem(items.at(-1))\n      break\n    case 'ArrowRight':\n      if (focused?.hasAttribute('submenu')) {\n        delegate.openSubmenuInstant(focused)\n        // 双 rAF：等子面板构建/迁移完成后再聚焦其第一个可用项\n        requestAnimationFrame(() => requestAnimationFrame(() => focusMenuItem(delegate.getEnabledItems(level + 1)[0])))\n      }\n      break\n    case 'ArrowLeft':\n      if (level > 0) {\n        focusMenuItem(delegate.closeToParent(level))\n      }\n      break\n    case 'Enter':\n    case ' ':\n      focused?.click()\n      break\n    default:\n      return\n  }\n  e.preventDefault()\n  e.stopPropagation()\n}\n\n/** 供 getFocusedItem 实现：优先取事件 composedPath 上的菜单项，其次查找面板内已聚焦项。 */\nexport function getFocusedMenuItemFromPanels(\n  event: KeyboardEvent | undefined,\n  panels: Iterable<HTMLElement | undefined>,\n  itemSelector: string\n): HTMLElement | undefined {\n  const eventItem = event\n    ?.composedPath()\n    .find((node): node is HTMLElement => node instanceof HTMLElement && node.matches(itemSelector))\n  if (eventItem) return eventItem\n\n  return findFocusedMenuItem(panels)\n}\n\n/** 供 getEnabledItems 实现：从层级 content 查询可用项。 */\nexport function getEnabledMenuLevelItems(content: HTMLElement | undefined): HTMLElement[] {\n  return content ? getEnabledMenuItems(content) : []\n}\n\n/* ------------------------------------------------------------------ *\n * 关闭中的 submenu presence 收尾栈\n * ------------------------------------------------------------------ */\n\nexport interface ClosingSubmenuStack<C> {\n  /** 取出正在关闭的容器以复用（同帧关闭→重开同一父项）。 */\n  take(parentItem: HTMLElement): C | undefined\n  /** 挂起关闭：等出场动画结束后归还子项并销毁面板。 */\n  closeAsync(parentItem: HTMLElement, container: C): void\n  /** 立即归还并销毁全部关闭中的容器（整菜单关闭 / 重开路径）。 */\n  restoreAll(): void\n  /** 全部强制销毁（断开连接时），不再归还子项。 */\n  disposeAll(): void\n}\n\nexport interface ClosingSubmenuStackAdapter<C> {\n  getPanel(container: C): HTMLElement\n  /** 归子项回父项（moveMenuChildren 与隐藏补丁由 adapter 决定）。 */\n  restoreItems(container: C, parentItem: HTMLElement): void\n  /** 销毁面板（remove + overlay api.dispose 等）。 */\n  dispose(container: C): void\n}\n\nexport function createClosingSubmenuStack<C>(adapter: ClosingSubmenuStackAdapter<C>): ClosingSubmenuStack<C> {\n  const closing = new Map<HTMLElement, C>()\n\n  return {\n    take(parentItem) {\n      const container = closing.get(parentItem)\n      if (container) closing.delete(parentItem)\n      return container\n    },\n    closeAsync(parentItem, container) {\n      // 先登记再等出场动画：同帧关闭→重开时 take() 会从这里取走复用\n      closing.set(parentItem, container)\n      void (async () => {\n        if (!(await hidePanelPresence(adapter.getPanel(container)))) return\n        if (closing.get(parentItem) !== container) return\n\n        closing.delete(parentItem)\n        adapter.restoreItems(container, parentItem)\n        adapter.dispose(container)\n      })()\n    },\n    restoreAll() {\n      closing.forEach((container, parentItem) => {\n        adapter.restoreItems(container, parentItem)\n        adapter.dispose(container)\n      })\n      closing.clear()\n    },\n    disposeAll() {\n      closing.forEach(container => adapter.dispose(container))\n      closing.clear()\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/menu-behavior/index.ts"],"sourcesContent":["/**\n * 菜单行为层：dropdown 与 context-menu 共用的交互行为。\n *\n * 结构层（面板构建、迁移、定位）由 menu-portal/menu-tree 与各组件自己承载；\n * 这里只收口四种在两个组件中逐行复制的行为：\n * 1. outside-click 守卫（同帧吞掉打开点击 + composedPath 内含判定）\n * 2. 层级 hover 绑定（200ms 打开计时、touch 守卫、hover 收起更深层级）\n * 3. roving 键盘导航（Arrow/Home/End/Enter/Space/Escape）\n * 4. 关闭中的 submenu presence 收尾栈（动画结束后归还子项并销毁面板）\n *\n * 组件是 adapter：提供层级容器/项的查询与打开/关闭原语，行为由此驱动。\n */\nimport { findFocusedMenuItem, focusMenuItem, getEnabledMenuItems } from '@/shared/menu-portal/menu-tree'\nimport { hideOverlayPresence as hidePanelPresence } from '@/shared/overlay/presence'\n\n/** 菜单层级面板的最小视图：行为层只需要面板（presence/contains）与内容容器（项查询）。 */\nexport interface MenuLevelSurface {\n  panel: HTMLElement\n  content: HTMLElement\n}\n\nexport interface MenuOutsideClickGuard {\n  /** 打开动作后调用：吞掉同一帧内随后冒泡到 document 的本次 click。 */\n  arm(): void\n  isArmed(): boolean\n  /** 事件是否发生在宿主 shadow root 或任何已打开面板内部。 */\n  isInside(event: MouseEvent): boolean\n  dispose(): void\n}\n\nexport function createMenuOutsideClickGuard(\n  host: HTMLElement,\n  isInsideOverlayPanel: (node: Node) => boolean\n): MenuOutsideClickGuard {\n  let armed = false\n  let disarmTimer: ReturnType<typeof setTimeout> | undefined\n\n  const isInside = (event: MouseEvent): boolean => {\n    for (const node of event.composedPath()) {\n      if (node === host || node === host.shadowRoot) return true\n      if (node instanceof Node && node.getRootNode() === host.shadowRoot) return true\n      if (node instanceof Node && isInsideOverlayPanel(node)) return true\n    }\n    return false\n  }\n\n  return {\n    arm() {\n      armed = true\n      clearTimeout(disarmTimer)\n      disarmTimer = setTimeout(() => {\n        armed = false\n      })\n    },\n    isArmed: () => armed,\n    isInside,\n    dispose() {\n      clearTimeout(disarmTimer)\n      armed = false\n    }\n  }\n}\n\nexport interface MenuHoverDelegate {\n  /** 当前展开的 submenu 深度；行为层会绑定 0..depth+1 每一层。 */\n  getOpenDepth(): number\n  getLevelItems(level: number): HTMLElement[]\n  /** 该层当前激活（子面板已展开）的项；用于避免重复打开。 */\n  getActiveItem(level: number): HTMLElement | undefined\n  isSubmenuItem(item: HTMLElement): boolean\n  /** hover 到 submenu 项且它不是当前激活项。 */\n  openSubmenu(item: HTMLElement): void\n  /** hover 到叶子项且存在更深层级：关闭比它深的子面板（内部自行重新 bind）。 */\n  closeFrom(level: number): void\n}\n\nexport interface MenuHoverBinder {\n  bind(): void\n  dispose(): void\n}\n\nconst SUBMENU_HOVER_DELAY = 200\n\nexport function createMenuHoverBinder(delegate: MenuHoverDelegate, itemSelector: string): MenuHoverBinder {\n  let openTimer: ReturnType<typeof setTimeout> | undefined\n  let cleanupFns: (() => void)[] = []\n\n  function bind() {\n    cleanupFns.forEach(fn => fn())\n    cleanupFns = []\n\n    const depth = delegate.getOpenDepth()\n    for (let level = 0; level <= depth + 1; level++) {\n      const items = delegate.getLevelItems(level)\n      if (!items.length) continue\n      items.forEach(item => {\n        if (!item.matches(itemSelector) || item.hasAttribute('disabled')) return\n        const handler = (event: PointerEvent) => {\n          if (event.pointerType === 'touch') return\n          clearTimeout(openTimer)\n          if (delegate.isSubmenuItem(item)) {\n            if (delegate.getActiveItem(level) !== item) {\n              openTimer = setTimeout(() => delegate.openSubmenu(item), SUBMENU_HOVER_DELAY)\n            }\n          } else if (delegate.getOpenDepth() > level) {\n            delegate.closeFrom(level)\n          }\n        }\n        item.addEventListener('pointerenter', handler, { passive: true })\n        cleanupFns.push(() => item.removeEventListener('pointerenter', handler))\n      })\n    }\n  }\n\n  return {\n    bind,\n    dispose() {\n      clearTimeout(openTimer)\n      cleanupFns.forEach(fn => fn())\n      cleanupFns = []\n    }\n  }\n}\n\nexport interface MenuKeyboardDelegate {\n  getFocusedItem(event?: KeyboardEvent): HTMLElement | undefined\n  /** 焦点项所在层级；不在任何面板内时返回 undefined。 */\n  getLevelOf(item: HTMLElement): number | undefined\n  getEnabledItems(level: number): HTMLElement[]\n  isSubmenuItem(item: HTMLElement): boolean\n  /** 键盘 ArrowRight：以 instant 语义打开该项的子面板。 */\n  openSubmenuInstant(item: HTMLElement): void\n  /** 键盘 ArrowLeft：关闭 level 层子面板并返回其父项。 */\n  closeToParent(level: number): HTMLElement | undefined\n  /** Escape：关闭最深一层子面板；没有子面板时关闭整个菜单。 */\n  closeDeepestOrAll(): void\n}\n\n/**\n * 处理菜单键盘事件；未命中的键原样返回，调用方不做 preventDefault。\n * 事件监听的挂载位置（宿主 / 面板 / document）由组件自己决定。\n */\nexport function handleMenuKeyboard(delegate: MenuKeyboardDelegate, e: KeyboardEvent): void {\n  /*\n   * Escape 不在本函数处理：它必须跨组件归属（issue #120 Block 1），由共享仲裁者在\n   * document 捕获阶段判定最内层后调用 `closeDeepestOrAll()`。留在各组件自己的\n   * keydown 里会让一次 Escape 同时命中内外两层。\n   */\n  const focused = delegate.getFocusedItem(e)\n  const level = focused ? delegate.getLevelOf(focused) : undefined\n  if (level === undefined) return\n  const items = delegate.getEnabledItems(level)\n  const currentIndex = focused ? items.indexOf(focused) : -1\n\n  switch (e.key) {\n    case 'ArrowDown':\n      focusMenuItem(items[(currentIndex + 1 + items.length) % items.length])\n      break\n    case 'ArrowUp':\n      focusMenuItem(items[(currentIndex - 1 + items.length) % items.length])\n      break\n    case 'Home':\n      focusMenuItem(items[0])\n      break\n    case 'End':\n      focusMenuItem(items.at(-1))\n      break\n    case 'ArrowRight':\n      if (focused?.hasAttribute('submenu')) {\n        delegate.openSubmenuInstant(focused)\n        // 双 rAF：等子面板构建/迁移完成后再聚焦其第一个可用项\n        requestAnimationFrame(() => requestAnimationFrame(() => focusMenuItem(delegate.getEnabledItems(level + 1)[0])))\n      }\n      break\n    case 'ArrowLeft':\n      if (level > 0) {\n        focusMenuItem(delegate.closeToParent(level))\n      }\n      break\n    case 'Enter':\n    case ' ':\n      focused?.click()\n      break\n    default:\n      return\n  }\n  e.preventDefault()\n  e.stopPropagation()\n}\n\n/** 供 getFocusedItem 实现：优先取事件 composedPath 上的菜单项，其次查找面板内已聚焦项。 */\nexport function getFocusedMenuItemFromPanels(\n  event: KeyboardEvent | undefined,\n  panels: Iterable<HTMLElement | undefined>,\n  itemSelector: string\n): HTMLElement | undefined {\n  const eventItem = event\n    ?.composedPath()\n    .find((node): node is HTMLElement => node instanceof HTMLElement && node.matches(itemSelector))\n  if (eventItem) return eventItem\n\n  return findFocusedMenuItem(panels)\n}\n\n/** 供 getEnabledItems 实现：从层级 content 查询可用项。 */\nexport function getEnabledMenuLevelItems(content: HTMLElement | undefined): HTMLElement[] {\n  return content ? getEnabledMenuItems(content) : []\n}\n\nexport interface ClosingSubmenuStack<C> {\n  /** 取出正在关闭的容器以复用（同帧关闭→重开同一父项）。 */\n  take(parentItem: HTMLElement): C | undefined\n  /** 挂起关闭：等出场动画结束后归还子项并销毁面板。 */\n  closeAsync(parentItem: HTMLElement, container: C): void\n  /** 立即归还并销毁全部关闭中的容器（整菜单关闭 / 重开路径）。 */\n  restoreAll(): void\n  /** 全部强制销毁（断开连接时），不再归还子项。 */\n  disposeAll(): void\n  /**\n   * 正在关闭、尚未销毁的容器快照（只读）。\n   * 这些面板仍在 DOM 里、可能仍然可见，但已经离开调用方的活跃集合（`_overlays` /\n   * `_activeSubmenus`）—— 根层重新 claim 时必须把它们一并重新挂回新会话的子树，\n   * 否则它们会被判成「面板外」。\n   */\n  closing(): C[]\n}\n\nexport interface ClosingSubmenuStackAdapter<C> {\n  getPanel(container: C): HTMLElement\n  /** 归子项回父项（moveMenuChildren 与隐藏补丁由 adapter 决定）。 */\n  restoreItems(container: C, parentItem: HTMLElement): void\n  /** 销毁面板（remove + overlay api.dispose 等）。 */\n  dispose(container: C): void\n}\n\nexport function createClosingSubmenuStack<C>(adapter: ClosingSubmenuStackAdapter<C>): ClosingSubmenuStack<C> {\n  const closing = new Map<HTMLElement, C>()\n\n  return {\n    take(parentItem) {\n      const container = closing.get(parentItem)\n      if (container) closing.delete(parentItem)\n      return container\n    },\n    closeAsync(parentItem, container) {\n      // 先登记再等出场动画：同帧关闭→重开时 take() 会从这里取走复用\n      closing.set(parentItem, container)\n      void (async () => {\n        if (!(await hidePanelPresence(adapter.getPanel(container)))) return\n        if (closing.get(parentItem) !== container) return\n\n        closing.delete(parentItem)\n        adapter.restoreItems(container, parentItem)\n        adapter.dispose(container)\n      })()\n    },\n    restoreAll() {\n      closing.forEach((container, parentItem) => {\n        adapter.restoreItems(container, parentItem)\n        adapter.dispose(container)\n      })\n      closing.clear()\n    },\n    disposeAll() {\n      closing.forEach(container => adapter.dispose(container))\n      closing.clear()\n    },\n    closing() {\n      return [...closing.values()]\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/shared/option-portal/combobox-shell.js

@@ -1,6 +1,5 @@
-import { overlayComposition as e } from "../overlay/composition.js";
 //#region src/shared/option-portal/combobox-shell.ts
-function t(e) {
+function e(e) {
 	function t(t = !1) {
 		e.canOpen() === !1 || e.getIsOpen() || (e.setIsOpen(!0), e.dispatchOpenChange(), e.onOpen?.(t), e.syncScrollLock(!0), e.isPortal() ? requestAnimationFrame(() => {
 			e.getIsOpen() && e.openOverlay(t);
@@ -14,7 +13,7 @@ function t(e) {
 		close: n
 	};
 }
-function n(e) {
+function t(e) {
 	function t(t) {
 		t.addEventListener("click", e.onClick), t.addEventListener("pointerover", e.onPointerOver), t.addEventListener("pointerdown", e.onPointerDown), t.addEventListener("option-update", e.onUpdate);
 	}
@@ -26,18 +25,18 @@ function n(e) {
 		unbind: n
 	};
 }
-function r(t, n, r, i) {
+function n(e, t, n, r) {
 	requestAnimationFrame(() => {
-		let a = n();
-		r() && !t.matches(":focus-within") && !(a && e.hasFocusWithin(a)) && i();
+		let i = t();
+		n() && !e.matches(":focus-within") && !i?.hasFocusWithin() && r();
 	});
 }
-function i(e, t, n) {
+function r(e, t, n) {
 	if (e === 0) return -1;
 	let r = t + n;
 	return r < 0 && (r = e - 1), r >= e && (r = 0), r;
 }
 //#endregion
-export { t as createComboboxOpenController, n as createOptionListenerBinding, r as handleComboboxFocusOut, i as nextWrappingIndex };
+export { e as createComboboxOpenController, t as createOptionListenerBinding, n as handleComboboxFocusOut, r as nextWrappingIndex };
 
 //# sourceMappingURL=combobox-shell.js.map

package/dist/shared/option-portal/combobox-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"combobox-shell.js","names":[],"sources":["../../../src/shared/option-portal/combobox-shell.ts"],"sourcesContent":["import type { WebUiOption } from '@/components/option'\nimport { overlayComposition } from '@/shared/overlay/composition'\n\n/**\n * combobox 开合与 option 交互的共享骨架（select / autocomplete）。\n *\n * 与 option-portal 的边界约定一致：交互语义的\"差异点\"经回调注入，\n * 这里收口两组件逐行复制的生命周期不变量——\n * - open/close 状态迁移顺序：guard → 状态翻转 → open-change 派发 →\n *   激活钩子 → scroll-lock 配对 → portal 模式的 rAF 延迟 openOverlay\n * - close 路径：before-close 钩子（portal 内容先收敛）→ 激活清理 →\n *   scroll-lock 释放 → closeOverlay（关闭后使 portal 引用失效）\n * - option 四事件监听对的绑定/解绑\n * - focusout 的 rAF :focus-within 复核\n * - 键盘导航的环绕游标算法\n */\n\nexport interface ComboboxOpenHooks {\n  /** 是否允许打开（disabled / readonly 等由组件判断）。 */\n  canOpen(): boolean\n  getIsOpen(): boolean\n  setIsOpen(open: boolean): void\n  dispatchOpenChange(): void\n  syncScrollLock(open: boolean): void\n  /** 是否 portal 模式（决定 openOverlay 是否延迟到下一帧）。 */\n  isPortal(): boolean\n  openOverlay(isKeyboardNavigation: boolean): void\n  closeOverlay(): void\n  /** 打开时的激活项初始化（键盘导航取选中/首项，指针打开保留现状）。 */\n  onOpen?(isKeyboardNavigation: boolean): void\n  /** 关闭前钩子：autocomplete 需先把 light DOM 新增节点收敛进当前 portal content。 */\n  onBeforeClose?(): void\n  /** 关闭时清理激活状态（清 _activeIndex 与 active 属性）。 */\n  onAfterClose?(): void\n}\n\nexport interface ComboboxOpenController {\n  open(isKeyboardNavigation?: boolean): void\n  close(): void\n}\n\nexport function createComboboxOpenController(hooks: ComboboxOpenHooks): ComboboxOpenController {\n  function open(isKeyboardNavigation = false) {\n    if (hooks.canOpen() === false || hooks.getIsOpen()) return\n    hooks.setIsOpen(true)\n    hooks.dispatchOpenChange()\n    hooks.onOpen?.(isKeyboardNavigation)\n    hooks.syncScrollLock(true)\n    if (hooks.isPortal()) {\n      requestAnimationFrame(() => {\n        if (hooks.getIsOpen()) hooks.openOverlay(isKeyboardNavigation)\n      })\n    } else {\n      hooks.openOverlay(isKeyboardNavigation)\n    }\n  }\n\n  function close() {\n    if (!hooks.getIsOpen()) return\n    hooks.onBeforeClose?.()\n    hooks.setIsOpen(false)\n    hooks.dispatchOpenChange()\n    hooks.onAfterClose?.()\n    hooks.syncScrollLock(false)\n    hooks.closeOverlay()\n  }\n\n  return { open, close }\n}\n\nexport interface OptionListenerHandlers {\n  onClick: (event: Event) => void\n  onPointerOver: (event: PointerEvent) => void\n  onPointerDown: (event: PointerEvent) => void\n  onUpdate: () => void\n}\n\n/** option 四事件监听对的绑定/解绑；两组件的 handler 签名一致，仅实现不同。 */\nexport function createOptionListenerBinding(handlers: OptionListenerHandlers) {\n  function bind(option: WebUiOption) {\n    option.addEventListener('click', handlers.onClick)\n    option.addEventListener('pointerover', handlers.onPointerOver)\n    option.addEventListener('pointerdown', handlers.onPointerDown)\n    option.addEventListener('option-update', handlers.onUpdate)\n  }\n  function unbind(option: WebUiOption) {\n    option.removeEventListener('click', handlers.onClick)\n    option.removeEventListener('pointerover', handlers.onPointerOver)\n    option.removeEventListener('pointerdown', handlers.onPointerDown)\n    option.removeEventListener('option-update', handlers.onUpdate)\n  }\n  return { bind, unbind }\n}\n\n/**\n * focusout 关闭复核：焦点是否真的离开了宿主与面板。\n * rAF 等待 click/pointerdown 相关的焦点迁移完成后再判定。\n */\nexport function handleComboboxFocusOut(\n  host: HTMLElement,\n  getPanel: () => HTMLElement | null | undefined,\n  getIsOpen: () => boolean,\n  close: () => void\n): void {\n  requestAnimationFrame(() => {\n    const panel = getPanel()\n    if (getIsOpen() && !host.matches(':focus-within') && !(panel && overlayComposition.hasFocusWithin(panel))) {\n      close()\n    }\n  })\n}\n\n/**\n * 环绕游标：在 enabled 列表内按 delta 移动；从 -1（无激活）向下取首项、向上取末项。\n * 返回在 enabled 中的下一索引；调用方负责换算回全量 options 索引。\n */\nexport function nextWrappingIndex(enabledCount: number, currentIdx: number, delta: number): number {\n  if (enabledCount === 0) return -1\n  let nextIdx = currentIdx + delta\n  if (nextIdx < 0) nextIdx = enabledCount - 1\n  if (nextIdx >= enabledCount) nextIdx = 0\n  return nextIdx\n}\n"],"mappings":";;AAyCA,SAAgB,EAA6B,GAAkD;CAC7F,SAAS,EAAK,IAAuB,IAAO;EACtC,EAAM,QAAQ,MAAM,MAAS,EAAM,UAAU,MACjD,EAAM,UAAU,EAAI,GACpB,EAAM,mBAAmB,GACzB,EAAM,SAAS,CAAoB,GACnC,EAAM,eAAe,EAAI,GACrB,EAAM,SAAS,IACjB,4BAA4B;GAC1B,AAAI,EAAM,UAAU,KAAG,EAAM,YAAY,CAAoB;EAC/D,CAAC,IAED,EAAM,YAAY,CAAoB;CAE1C;CAEA,SAAS,IAAQ;EACV,EAAM,UAAU,MACrB,EAAM,gBAAgB,GACtB,EAAM,UAAU,EAAK,GACrB,EAAM,mBAAmB,GACzB,EAAM,eAAe,GACrB,EAAM,eAAe,EAAK,GAC1B,EAAM,aAAa;CACrB;CAEA,OAAO;EAAE;EAAM;CAAM;AACvB;AAUA,SAAgB,EAA4B,GAAkC;CAC5E,SAAS,EAAK,GAAqB;EAIjC,AAHA,EAAO,iBAAiB,SAAS,EAAS,OAAO,GACjD,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,iBAAiB,EAAS,QAAQ;CAC5D;CACA,SAAS,EAAO,GAAqB;EAInC,AAHA,EAAO,oBAAoB,SAAS,EAAS,OAAO,GACpD,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,iBAAiB,EAAS,QAAQ;CAC/D;CACA,OAAO;EAAE;EAAM;CAAO;AACxB;AAMA,SAAgB,EACd,GACA,GACA,GACA,GACM;CACN,4BAA4B;EAC1B,IAAM,IAAQ,EAAS;EACvB,AAAI,EAAU,KAAK,CAAC,EAAK,QAAQ,eAAe,KAAK,EAAE,KAAS,EAAmB,eAAe,CAAK,MACrG,EAAM;CAEV,CAAC;AACH;AAMA,SAAgB,EAAkB,GAAsB,GAAoB,GAAuB;CACjG,IAAI,MAAiB,GAAG,OAAO;CAC/B,IAAI,IAAU,IAAa;CAG3B,OAFI,IAAU,MAAG,IAAU,IAAe,IACtC,KAAW,MAAc,IAAU,IAChC;AACT"}
+{"version":3,"file":"combobox-shell.js","names":[],"sources":["../../../src/shared/option-portal/combobox-shell.ts"],"sourcesContent":["import type { WebUiOption } from '@/components/option'\nimport type { OpenOverlayHandle } from '@/shared/overlay/open-overlay'\n\n/**\n * combobox 开合与 option 交互的共享骨架（select / autocomplete）。\n *\n * 与 option-portal 的边界约定一致：交互语义的\"差异点\"经回调注入，\n * 这里收口两组件逐行复制的生命周期不变量——\n * - open/close 状态迁移顺序：guard → 状态翻转 → open-change 派发 →\n *   激活钩子 → scroll-lock 配对 → portal 模式的 rAF 延迟 openOverlay\n * - close 路径：before-close 钩子（portal 内容先收敛）→ 激活清理 →\n *   scroll-lock 释放 → closeOverlay（关闭后使 portal 引用失效）\n * - option 四事件监听对的绑定/解绑\n * - focusout 的 rAF :focus-within 复核\n * - 键盘导航的环绕游标算法\n */\n\nexport interface ComboboxOpenHooks {\n  /** 是否允许打开（disabled / readonly 等由组件判断）。 */\n  canOpen(): boolean\n  getIsOpen(): boolean\n  setIsOpen(open: boolean): void\n  dispatchOpenChange(): void\n  syncScrollLock(open: boolean): void\n  /** 是否 portal 模式（决定 openOverlay 是否延迟到下一帧）。 */\n  isPortal(): boolean\n  openOverlay(isKeyboardNavigation: boolean): void\n  closeOverlay(): void\n  /** 打开时的激活项初始化（键盘导航取选中/首项，指针打开保留现状）。 */\n  onOpen?(isKeyboardNavigation: boolean): void\n  /** 关闭前钩子：autocomplete 需先把 light DOM 新增节点收敛进当前 portal content。 */\n  onBeforeClose?(): void\n  /** 关闭时清理激活状态（清 _activeIndex 与 active 属性）。 */\n  onAfterClose?(): void\n}\n\nexport interface ComboboxOpenController {\n  open(isKeyboardNavigation?: boolean): void\n  close(): void\n}\n\nexport function createComboboxOpenController(hooks: ComboboxOpenHooks): ComboboxOpenController {\n  function open(isKeyboardNavigation = false) {\n    if (hooks.canOpen() === false || hooks.getIsOpen()) return\n    hooks.setIsOpen(true)\n    hooks.dispatchOpenChange()\n    hooks.onOpen?.(isKeyboardNavigation)\n    hooks.syncScrollLock(true)\n    if (hooks.isPortal()) {\n      requestAnimationFrame(() => {\n        if (hooks.getIsOpen()) hooks.openOverlay(isKeyboardNavigation)\n      })\n    } else {\n      hooks.openOverlay(isKeyboardNavigation)\n    }\n  }\n\n  function close() {\n    if (!hooks.getIsOpen()) return\n    hooks.onBeforeClose?.()\n    hooks.setIsOpen(false)\n    hooks.dispatchOpenChange()\n    hooks.onAfterClose?.()\n    hooks.syncScrollLock(false)\n    hooks.closeOverlay()\n  }\n\n  return { open, close }\n}\n\nexport interface OptionListenerHandlers {\n  onClick: (event: Event) => void\n  onPointerOver: (event: PointerEvent) => void\n  onPointerDown: (event: PointerEvent) => void\n  onUpdate: () => void\n}\n\n/** option 四事件监听对的绑定/解绑；两组件的 handler 签名一致，仅实现不同。 */\nexport function createOptionListenerBinding(handlers: OptionListenerHandlers) {\n  function bind(option: WebUiOption) {\n    option.addEventListener('click', handlers.onClick)\n    option.addEventListener('pointerover', handlers.onPointerOver)\n    option.addEventListener('pointerdown', handlers.onPointerDown)\n    option.addEventListener('option-update', handlers.onUpdate)\n  }\n  function unbind(option: WebUiOption) {\n    option.removeEventListener('click', handlers.onClick)\n    option.removeEventListener('pointerover', handlers.onPointerOver)\n    option.removeEventListener('pointerdown', handlers.onPointerDown)\n    option.removeEventListener('option-update', handlers.onUpdate)\n  }\n  return { bind, unbind }\n}\n\n/**\n * focusout 关闭复核：焦点是否真的离开了宿主与面板。\n * rAF 等待 click/pointerdown 相关的焦点迁移完成后再判定。\n */\nexport function handleComboboxFocusOut(\n  host: HTMLElement,\n  getHandle: () => OpenOverlayHandle | null | undefined,\n  getIsOpen: () => boolean,\n  close: () => void\n): void {\n  requestAnimationFrame(() => {\n    const handle = getHandle()\n    if (getIsOpen() && !host.matches(':focus-within') && !handle?.hasFocusWithin()) {\n      close()\n    }\n  })\n}\n\n/**\n * 环绕游标：在 enabled 列表内按 delta 移动；从 -1（无激活）向下取首项、向上取末项。\n * 返回在 enabled 中的下一索引；调用方负责换算回全量 options 索引。\n */\nexport function nextWrappingIndex(enabledCount: number, currentIdx: number, delta: number): number {\n  if (enabledCount === 0) return -1\n  let nextIdx = currentIdx + delta\n  if (nextIdx < 0) nextIdx = enabledCount - 1\n  if (nextIdx >= enabledCount) nextIdx = 0\n  return nextIdx\n}\n"],"mappings":";AAyCA,SAAgB,EAA6B,GAAkD;CAC7F,SAAS,EAAK,IAAuB,IAAO;EACtC,EAAM,QAAQ,MAAM,MAAS,EAAM,UAAU,MACjD,EAAM,UAAU,EAAI,GACpB,EAAM,mBAAmB,GACzB,EAAM,SAAS,CAAoB,GACnC,EAAM,eAAe,EAAI,GACrB,EAAM,SAAS,IACjB,4BAA4B;GAC1B,AAAI,EAAM,UAAU,KAAG,EAAM,YAAY,CAAoB;EAC/D,CAAC,IAED,EAAM,YAAY,CAAoB;CAE1C;CAEA,SAAS,IAAQ;EACV,EAAM,UAAU,MACrB,EAAM,gBAAgB,GACtB,EAAM,UAAU,EAAK,GACrB,EAAM,mBAAmB,GACzB,EAAM,eAAe,GACrB,EAAM,eAAe,EAAK,GAC1B,EAAM,aAAa;CACrB;CAEA,OAAO;EAAE;EAAM;CAAM;AACvB;AAUA,SAAgB,EAA4B,GAAkC;CAC5E,SAAS,EAAK,GAAqB;EAIjC,AAHA,EAAO,iBAAiB,SAAS,EAAS,OAAO,GACjD,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,iBAAiB,EAAS,QAAQ;CAC5D;CACA,SAAS,EAAO,GAAqB;EAInC,AAHA,EAAO,oBAAoB,SAAS,EAAS,OAAO,GACpD,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,iBAAiB,EAAS,QAAQ;CAC/D;CACA,OAAO;EAAE;EAAM;CAAO;AACxB;AAMA,SAAgB,EACd,GACA,GACA,GACA,GACM;CACN,4BAA4B;EAC1B,IAAM,IAAS,EAAU;EACzB,AAAI,EAAU,KAAK,CAAC,EAAK,QAAQ,eAAe,KAAK,CAAC,GAAQ,eAAe,KAC3E,EAAM;CAEV,CAAC;AACH;AAMA,SAAgB,EAAkB,GAAsB,GAAoB,GAAuB;CACjG,IAAI,MAAiB,GAAG,OAAO;CAC/B,IAAI,IAAU,IAAa;CAG3B,OAFI,IAAU,MAAG,IAAU,IAAe,IACtC,KAAW,MAAc,IAAU,IAChC;AACT"}