@jingyi0605/codingns4dsh 0.2.0-rc.2 → 0.2.0-rc.3

package/data/build/dist/client/mobile-sidebar-gestures.d.ts

@@ -15,35 +15,75 @@ export interface TouchSample {
     readonly t: number;
 }
 export interface SidebarGestureConfig {
-    /** 触发阈值（像素）。 */
-    readonly thresholdPx: number;
+    /**
+     * 触发手势所需的水平位移占视口宽度的比例（0–1，默认 0.25）。
+     *
+     * 用比例而不是像素：同一个像素值在 360px 手机与 1024px 平板上的手势占比相差
+     * 近三倍，只有比例才能让「灵敏度」设置在各类设备上表达同一件事。
+     */
+    readonly distanceRatio: number;
     /** 起手区域：`avoid` 避开系统边缘热区。 */
     readonly edgeMode: 'avoid' | 'edge';
     /** 方向映射：`swipe-inward` 为右滑开合左栏、左滑开合右栏；`swap` 互换。 */
     readonly mapping: 'swipe-inward' | 'swap';
     /** 当前视口宽度；用于判断右侧热区。 */
     readonly viewportWidth: number;
-    /** 边缘热区宽度，默认 24px。 */
+    /** 边缘热区宽度，默认 12px。 */
     readonly edgeZonePx?: number;
     /** 方向锁定比（水平位移至少是垂直位移的多少倍），默认 1.5。 */
     readonly directionRatio?: number;
+    /** 甩动通道的最低整段平均速度（像素/毫秒），默认 0.5，即约 500 像素/秒。 */
+    readonly flickMinVelocityPxPerMs?: number;
+    /** 甩动通道需要的最小水平位移（像素），默认 48。 */
+    readonly flickMinDistancePx?: number;
 }
 export interface SidebarGestureDecision {
     readonly action: SidebarGestureAction;
     /** 稳定原因码，用于诊断与测试断言。 */
-    readonly reason: 'ok' | 'samples' | 'config' | 'edge' | 'threshold' | 'direction';
+    readonly reason: 'ok' | 'samples' | 'config' | 'edge' | 'threshold' | 'direction' | 'flick';
 }
-export declare const DEFAULT_GESTURE_EDGE_ZONE_PX = 24;
+/** 边缘热区只避让最窄的一条，给系统返回手势留空间又不至于让单手起手失效。 */
+export declare const DEFAULT_GESTURE_EDGE_ZONE_PX = 12;
 export declare const DEFAULT_GESTURE_DIRECTION_RATIO = 1.5;
+/**
+ * 距离通道门槛：跨过视口宽度的 25% 即触发。
+ *
+ * 该通道不再做速度二次否决。旧实现要求「距离与末端速度同时达标」，而人手松手前
+ * 必然减速，导致正常滑动被速度门槛系统性误杀，用户需要重复滑动。
+ */
+export declare const DEFAULT_GESTURE_DISTANCE_RATIO = 0.25;
+/** 比例设置的合法区间；与共享契约的 15–80 百分比一一对应。 */
+export declare const MIN_GESTURE_DISTANCE_RATIO = 0.15;
+export declare const MAX_GESTURE_DISTANCE_RATIO = 0.8;
+/**
+ * 甩动通道：距离不足时的快速甩动逃生通道，任一达标即可触发。
+ *
+ * 这是 iOS `UISwipeGestureRecognizer`、Android `ViewConfiguration` 与主流手势库
+ * （react-swipeable、use-gesture）的通行做法：明确的快速甩动即使位移较短也应当响应。
+ */
+export declare const DEFAULT_GESTURE_FLICK_MIN_VELOCITY_PX_PER_MS = 0.5;
+export declare const DEFAULT_GESTURE_FLICK_MIN_DISTANCE_PX = 48;
 /** 与 DSH 窄屏断点保持一致；超过该宽度不安装全局触摸监听。 */
 export declare const DEFAULT_MOBILE_GESTURE_VIEWPORT_MAX_PX = 1024;
-/** 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。 */
+/**
+ * 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。
+ *
+ * 判定采用「距离 OR 甩动」双通道：
+ * 1. 方向锁先排除纵向滚动意图；
+ * 2. 水平位移达到 `视口宽度 × distanceRatio` 直接触发；
+ * 3. 位移不足时，若达到 `flickMinDistancePx` 且整段平均速度达到 `flickMinVelocityPxPerMs`，
+ *    按快速甩动触发。
+ *
+ * 速度使用**整段平均速度**而不是末端窗口速度：自然滑动在松手前会减速，用末端速度
+ * 判「是否快速甩动」会误杀正常滑动。
+ */
 export declare function detectSidebarGesture(samples: readonly TouchSample[], config: SidebarGestureConfig): SidebarGestureDecision;
 export interface SidebarGestureSettings {
     readonly sidebarGestures: boolean;
     readonly sidebarGestureMapping: 'swipe-inward' | 'swap';
     readonly sidebarGestureEdge: 'avoid' | 'edge';
-    readonly sidebarGestureThresholdPx: number;
+    /** 触发手势所需的水平位移占视口宽度的百分比（15–80）。 */
+    readonly sidebarGestureDistancePercent: number;
 }
 export interface SidebarGesturePorts {
     /** `ctx.layout`：只用到左栏开合。 */
@@ -94,4 +134,12 @@ export declare const GESTURE_DIAGNOSTIC_CAPABILITY_MISSING = "CODINGNS_GESTURE_C
 export declare const GESTURE_DIAGNOSTIC_NOT_MOBILE = "CODINGNS_GESTURE_NOT_MOBILE";
 /** 启动手势控制器；未启用或没有任何可用端口时不注册任何监听。 */
 export declare function startMobileSidebarGestures(options: MobileSidebarGestureOptions): MobileSidebarGestureController;
+/**
+ * 判断触摸点是否位于可横向滚动的元素或其后代中。消息里的表格、代码块和长文本
+ * 包装器都依赖这个判断获得全局侧栏手势让位。
+ *
+ * 必须同时具备横向滚动样式和实际的 `scrollWidth > clientWidth`。只设置
+ * `overflow: auto` 的聊天纵向列表不能因此抢走左右侧栏唤起手势。
+ */
+export declare function isHorizontalScrollableTarget(target: unknown): boolean;
 //# sourceMappingURL=mobile-sidebar-gestures.d.ts.map

package/data/build/dist/client/mobile-sidebar-gestures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile-sidebar-gestures.d.ts","sourceRoot":"","sources":["../../../../src/client/mobile-sidebar-gestures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mobile-sidebar-gestures.d.ts","sourceRoot":"","sources":["../../../../src/client/mobile-sidebar-gestures.ts"],"names":[],"mappings":"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"}

package/data/build/dist/client/mobile-sidebar-gestures.js

@@ -9,34 +9,106 @@
  * 方向锁定失败时立即释放，不 intercept 滚动。
  */
 import { vibrateMobile } from './mobile-vibration.js';
-export const DEFAULT_GESTURE_EDGE_ZONE_PX = 24;
+/** 边缘热区只避让最窄的一条，给系统返回手势留空间又不至于让单手起手失效。 */
+export const DEFAULT_GESTURE_EDGE_ZONE_PX = 12;
 export const DEFAULT_GESTURE_DIRECTION_RATIO = 1.5;
+/**
+ * 距离通道门槛：跨过视口宽度的 25% 即触发。
+ *
+ * 该通道不再做速度二次否决。旧实现要求「距离与末端速度同时达标」，而人手松手前
+ * 必然减速，导致正常滑动被速度门槛系统性误杀，用户需要重复滑动。
+ */
+export const DEFAULT_GESTURE_DISTANCE_RATIO = 0.25;
+/** 比例设置的合法区间；与共享契约的 15–80 百分比一一对应。 */
+export const MIN_GESTURE_DISTANCE_RATIO = 0.15;
+export const MAX_GESTURE_DISTANCE_RATIO = 0.8;
+/**
+ * 甩动通道：距离不足时的快速甩动逃生通道，任一达标即可触发。
+ *
+ * 这是 iOS `UISwipeGestureRecognizer`、Android `ViewConfiguration` 与主流手势库
+ * （react-swipeable、use-gesture）的通行做法：明确的快速甩动即使位移较短也应当响应。
+ */
+export const DEFAULT_GESTURE_FLICK_MIN_VELOCITY_PX_PER_MS = 0.5;
+export const DEFAULT_GESTURE_FLICK_MIN_DISTANCE_PX = 48;
 /** 与 DSH 窄屏断点保持一致；超过该宽度不安装全局触摸监听。 */
 export const DEFAULT_MOBILE_GESTURE_VIEWPORT_MAX_PX = 1024;
-/** 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。 */
+/**
+ * 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。
+ *
+ * 判定采用「距离 OR 甩动」双通道：
+ * 1. 方向锁先排除纵向滚动意图；
+ * 2. 水平位移达到 `视口宽度 × distanceRatio` 直接触发；
+ * 3. 位移不足时，若达到 `flickMinDistancePx` 且整段平均速度达到 `flickMinVelocityPxPerMs`，
+ *    按快速甩动触发。
+ *
+ * 速度使用**整段平均速度**而不是末端窗口速度：自然滑动在松手前会减速，用末端速度
+ * 判「是否快速甩动」会误杀正常滑动。
+ */
 export function detectSidebarGesture(samples, config) {
-    const thresholdPx = Number.isFinite(config.thresholdPx) ? config.thresholdPx : Number.NaN;
+    const evaluated = evaluateHorizontalGesture(samples, config);
+    if (evaluated.direction === null)
+        return { action: 'ignore', reason: evaluated.reason };
+    const inward = evaluated.direction > 0 ? 'left' : 'right';
+    const action = config.mapping === 'swap' ? (inward === 'left' ? 'right' : 'left') : inward;
+    return { action, reason: 'ok' };
+}
+/**
+ * 手势判定的唯一实现：返回有效方向或忽略原因。
+ *
+ * `detectSidebarGesture` 与控制器内的方向探测共用它，保证「能触发」和「能识别物理
+ * 方向」永远是同一套条件——否则甩动通道触发的手势会拿不到方向，右栏收起等依赖物理
+ * 方向的动作就会静默失效。
+ */
+function evaluateHorizontalGesture(samples, config) {
+    const distanceRatio = Number.isFinite(config.distanceRatio) ? config.distanceRatio : Number.NaN;
     const viewportWidth = Number.isFinite(config.viewportWidth) ? config.viewportWidth : 0;
-    if (!Number.isFinite(thresholdPx) || thresholdPx <= 0 || viewportWidth <= 0)
-        return { action: 'ignore', reason: 'config' };
+    // 比例必须落在合法区间：0 会让任何抖动都触发，超过 1 则永远无法跨过。
+    if (!Number.isFinite(distanceRatio) || distanceRatio <= 0 || distanceRatio > 1 || viewportWidth <= 0) {
+        return { direction: null, reason: 'config' };
+    }
     if (samples.length < 2)
-        return { action: 'ignore', reason: 'samples' };
+        return { direction: null, reason: 'samples' };
     const first = samples[0];
     const last = samples[samples.length - 1];
     const edgeZone = config.edgeZonePx ?? DEFAULT_GESTURE_EDGE_ZONE_PX;
     if (config.edgeMode === 'avoid' && (first.x <= edgeZone || first.x >= viewportWidth - edgeZone)) {
-        return { action: 'ignore', reason: 'edge' };
+        return { direction: null, reason: 'edge' };
     }
     const dx = last.x - first.x;
     const dy = last.y - first.y;
-    if (Math.abs(dx) < thresholdPx)
-        return { action: 'ignore', reason: 'threshold' };
+    const distance = Math.abs(dx);
+    const vertical = Math.abs(dy);
     const ratio = config.directionRatio ?? DEFAULT_GESTURE_DIRECTION_RATIO;
-    if (Math.abs(dx) < Math.abs(dy) * ratio)
-        return { action: 'ignore', reason: 'direction' };
-    const inward = dx > 0 ? 'left' : 'right';
-    const action = config.mapping === 'swap' ? (inward === 'left' ? 'right' : 'left') : inward;
-    return { action, reason: 'ok' };
+    const flickMinDistance = config.flickMinDistancePx ?? DEFAULT_GESTURE_FLICK_MIN_DISTANCE_PX;
+    if (!Number.isFinite(flickMinDistance) || flickMinDistance < 0)
+        return { direction: null, reason: 'config' };
+    const distanceThresholdPx = resolveDistanceThresholdPx(distanceRatio, viewportWidth);
+    const verticalDominant = distance < vertical * ratio;
+    // 距离通道：横向位移达标即触发，不再做速度二次否决。
+    if (distance >= distanceThresholdPx) {
+        if (verticalDominant)
+            return { direction: null, reason: 'direction' };
+        return { direction: dx > 0 ? 1 : -1, reason: 'ok' };
+    }
+    // 横向未达标。纵向占优时是否放弃，取决于运动量是否足够做出可靠判断。
+    // 起手阶段位移很小，轻微纵向漂移不代表滚动意图；此时必须保持跟踪，
+    // 否则一次正常横滑会被提前判死，用户就得再滑一次。
+    if (verticalDominant) {
+        const movement = Math.max(distance, vertical);
+        if (movement < flickMinDistance)
+            return { direction: null, reason: 'threshold' };
+        return { direction: null, reason: 'direction' };
+    }
+    // 甩动通道：横向意图明确但位移不足，快速甩动同样应当响应。
+    const flickMinVelocity = config.flickMinVelocityPxPerMs ?? DEFAULT_GESTURE_FLICK_MIN_VELOCITY_PX_PER_MS;
+    if (!Number.isFinite(flickMinVelocity) || flickMinVelocity <= 0)
+        return { direction: null, reason: 'config' };
+    if (distance < flickMinDistance)
+        return { direction: null, reason: 'threshold' };
+    const velocity = averageHorizontalVelocity(samples);
+    if (velocity === undefined || velocity < flickMinVelocity)
+        return { direction: null, reason: 'flick' };
+    return { direction: dx > 0 ? 1 : -1, reason: 'ok' };
 }
 export const GESTURE_DIAGNOSTIC_CAPABILITY_MISSING = 'CODINGNS_GESTURE_CAPABILITY_MISSING';
 export const GESTURE_DIAGNOSTIC_NOT_MOBILE = 'CODINGNS_GESTURE_NOT_MOBILE';
@@ -48,33 +120,92 @@ export function startMobileSidebarGestures(options) {
     let samples = [];
     let tracking = false;
     let claimed = false;
+    let rightbarTouch = false;
+    let scrollableTouch = false;
     let rightbarHistoryPushed = false;
     // 只有宿主没有提供左栏 DOM 状态时才使用这个乐观状态，保证测试环境和
     // 尚未完成 DOM 挂载的 WebView 仍能连续完成“打开后左滑关闭”。
     let leftCollapsedFallback;
     const onResize = () => { refresh(); };
     const onTouchStart = (event) => {
+        if (touchCount(event) !== 1) {
+            resetTracking();
+            return;
+        }
         const touch = firstTouch(event);
         if (touch === null)
             return;
-        if (isEditableTarget(touch.target))
+        // 横向滚动容器优先接收触摸。右栏里的代码块、长文本和表格经常需要
+        // 左右拖动；如果这里继续记录样本，window 的全局监听会把右滑误判为
+        // “收起右栏”，浏览器也会因为后续 preventDefault 而丢掉原生滚动。
+        if (isEditableTouch(touch)) {
+            tracking = false;
+            claimed = false;
+            rightbarTouch = false;
+            scrollableTouch = false;
+            samples = [];
             return;
+        }
         tracking = true;
         claimed = false;
-        samples = [{ x: touch.x, y: touch.y, t: now() }];
+        scrollableTouch = hasHorizontalScrollableTarget(touch);
+        // 横向滚动能力是内容优先级的稳定信号；消息中的表格、代码块和长文本都应
+        // 保留左右拖动，不应因为右栏当前未展开就被全局侧栏手势抢走。
+        rightbarTouch = isExpandedRightbar() && (isRightbarTarget(touch) || scrollableTouch);
+        samples = [{ x: touch.x, y: touch.y, t: eventTime(event) }];
     };
     const onTouchMove = (event) => {
         if (!tracking)
             return;
+        if (touchCount(event) > 1) {
+            resetTracking();
+            return;
+        }
         const touch = firstTouch(event);
         if (touch === null)
             return;
-        samples.push({ x: touch.x, y: touch.y, t: now() });
-        if (!claimed && samples.length <= 24) {
+        // 某些 WebView 在 touchstart 时只暴露宿主节点，直到 touchmove 才能从
+        // composedPath() 看到真正的滚动节点；这里再次检查，避免已经开始采样后
+        // 仍被全局侧栏手势抢走。
+        if (isEditableTouch(touch)) {
+            tracking = false;
+            claimed = false;
+            rightbarTouch = false;
+            scrollableTouch = false;
+            samples = [];
+            return;
+        }
+        samples.push({ x: touch.x, y: touch.y, t: eventTime(event) });
+        // 事件目标在部分 WebView 中会在 touchmove 才暴露真实宿主；右栏归属和横向
+        // 滚动祖先都要同步补探测，避免 Shadow DOM 或消息表格漏掉让位判断。
+        rightbarTouch ||= isExpandedRightbar() && isRightbarTarget(touch);
+        scrollableTouch ||= hasHorizontalScrollableTarget(touch);
+        const config = resolveConfig(options);
+        const horizontalDirection = detectHorizontalDirection(samples, config);
+        const shouldYieldToContent = horizontalDirection !== null
+            && (scrollableTouch || (rightbarTouch && horizontalDirection < 0));
+        if (shouldYieldToContent) {
+            // 可横向滚动内容无论当前是否处于滚动边界都优先接收手势，避免消息表格、
+            // 代码块在边界处的拖动被误判为侧栏开合；右栏非滚动面板的左滑仍交给面板。
+            tracking = false;
+            claimed = false;
+            rightbarTouch = false;
+            scrollableTouch = false;
+            samples = [];
+            return;
+        }
+        if (!claimed) {
             const decision = detectSidebarGesture(samples, resolveConfig(options));
             if (decision.reason === 'ok') {
+                const handled = applyAction(decision.action, horizontalDirection ?? undefined);
+                if (!handled) {
+                    // 右栏展开时的物理左滑没有侧栏动作，释放本次触摸，避免既阻止
+                    // 原生内容交互又在后续 move 中重复判定。
+                    tracking = false;
+                    samples = [];
+                    return;
+                }
                 claimed = true;
-                applyAction(decision.action);
                 preventDefault(event);
                 return;
             }
@@ -89,9 +220,7 @@ export function startMobileSidebarGestures(options) {
             preventDefault(event);
     };
     const onTouchEnd = () => {
-        tracking = false;
-        claimed = false;
-        samples = [];
+        resetTracking();
     };
     const onPopState = () => {
         if (!rightbarHistoryPushed)
@@ -100,24 +229,25 @@ export function startMobileSidebarGestures(options) {
         if (options.ports.sidebarRight?.isExpanded() === true)
             options.ports.sidebarRight.toggleExpanded();
     };
-    const applyAction = (action) => {
+    const applyAction = (action, physicalDirection) => {
         if (action === 'ignore')
-            return;
-        // 仅在手势真正触发开合后反馈，避免滚动和方向锁定失败时误振动。
-        triggerVibration(10);
+            return false;
         const sidebarRight = options.ports.sidebarRight;
-        if (action === 'left') {
-            // 与左栏保持对称：右栏由左滑呼出后，下一次反向右滑应先收回右栏，
-            // 不能把同一次操作解释成呼出左栏。右栏状态由端口提供，是唯一事实来源。
-            if (sidebarRight?.isExpanded() === true) {
+        if (sidebarRight?.isExpanded() === true) {
+            if (physicalDirection === 1) {
+                triggerVibration(10);
                 sidebarRight.toggleExpanded();
-                // 该历史记录只服务于“返回键关闭右栏”；手势已经主动关闭时不应再
-                // 在后续 popstate 中重复尝试关闭。
                 rightbarHistoryPushed = false;
-                return;
+                return true;
             }
+            // 右栏打开时，物理左滑只交给内部内容，不再触发任何收起动作。
+            return false;
+        }
+        // 仅在手势真正触发开合后反馈，避免滚动和方向锁定失败时误振动。
+        triggerVibration(10);
+        if (action === 'left') {
             toggleLeftSidebar();
-            return;
+            return true;
         }
         // 默认映射下物理左滑会得到 `right` 动作。左栏已经展开时，用户的意图
         // 是收回刚刚呼出的左栏，而不是再打开右栏；优先关闭左栏才能保持手势
@@ -125,16 +255,16 @@ export function startMobileSidebarGestures(options) {
         // 分支处理。
         if (readLeftCollapsed() === false && options.ports.layout !== undefined) {
             toggleLeftSidebar();
-            return;
+            return true;
         }
         if (sidebarRight === undefined)
-            return;
+            return false;
         const wasExpanded = sidebarRight.isExpanded() === true;
         sidebarRight.toggleExpanded();
         if (wasExpanded) {
             // 同方向再次触发也可能关闭右栏，保持历史状态与实际面板一致。
             rightbarHistoryPushed = false;
-            return;
+            return true;
         }
         if (!wasExpanded && sidebarRight.isExpanded() === true && hostWindow?.history !== undefined) {
             // 全屏右栏压入一条历史记录：Android 返回手势与 iOS 边缘返回先关右栏。
@@ -146,11 +276,20 @@ export function startMobileSidebarGestures(options) {
                 rightbarHistoryPushed = false;
             }
         }
+        return true;
     };
     const readLeftCollapsed = () => {
         const reported = options.readLeftCollapsed?.();
         return reported ?? leftCollapsedFallback;
     };
+    const isExpandedRightbar = () => {
+        try {
+            return options.ports.sidebarRight?.isExpanded() === true;
+        }
+        catch {
+            return false;
+        }
+    };
     /**
      * 将振动调用绑定到实际接收触摸事件的 Window。
      *
@@ -186,6 +325,13 @@ export function startMobileSidebarGestures(options) {
         if (reported === undefined)
             leftCollapsedFallback = before === undefined ? false : !before;
     };
+    const resetTracking = () => {
+        tracking = false;
+        claimed = false;
+        rightbarTouch = false;
+        scrollableTouch = false;
+        samples = [];
+    };
     const attach = () => {
         if (active)
             return;
@@ -263,12 +409,16 @@ function resolveConfig(options) {
             ? globalThis.innerWidth
             : 0;
     return {
-        thresholdPx: settings.sidebarGestureThresholdPx,
+        distanceRatio: settings.sidebarGestureDistancePercent / 100,
         edgeMode: settings.sidebarGestureEdge,
         mapping: settings.sidebarGestureMapping,
         viewportWidth,
     };
 }
+/** 把视口比例换算成像素门槛；这是判定距离的唯一入口。 */
+function resolveDistanceThresholdPx(distanceRatio, viewportWidth) {
+    return viewportWidth * distanceRatio;
+}
 function firstTouch(event) {
     if (typeof event !== 'object' || event === null)
         return null;
@@ -282,7 +432,77 @@ function firstTouch(event) {
     const y = first.clientY;
     if (typeof x !== 'number' || typeof y !== 'number' || !Number.isFinite(x) || !Number.isFinite(y))
         return null;
-    return { x, y, target: event.target };
+    return { x, y, target: event.target, path: composedPathOf(event) };
+}
+function touchCount(event) {
+    if (typeof event !== 'object' || event === null)
+        return 0;
+    const list = event.touches;
+    if (typeof list !== 'object' || list === null)
+        return 0;
+    const length = list.length;
+    return typeof length === 'number' && Number.isFinite(length) ? length : 0;
+}
+function isEditableTouch(touch) {
+    const targets = [touch.target, ...touch.path];
+    return targets.some((target) => isEditableTarget(target));
+}
+function hasHorizontalScrollableTarget(touch) {
+    const targets = [touch.target, ...touch.path];
+    return targets.some((target) => isHorizontalScrollableTarget(target));
+}
+function isRightbarTarget(touch) {
+    const visited = new Set();
+    for (const target of [touch.target, ...touch.path]) {
+        let current = target;
+        for (let depth = 0; depth < 64 && isObjectLike(current); depth += 1) {
+            if (visited.has(current))
+                break;
+            visited.add(current);
+            const closest = current.closest;
+            if (typeof closest === 'function') {
+                try {
+                    if (closest.call(current, '[data-sidebar-right-session]') !== null)
+                        return true;
+                }
+                catch {
+                    // 事件路径中的 Window、Document 或 ShadowRoot 可能没有可用的 closest。
+                }
+            }
+            current = parentElementOf(current);
+        }
+    }
+    return false;
+}
+function detectHorizontalDirection(samples, config) {
+    const evaluated = evaluateHorizontalGesture(samples, config);
+    return evaluated.direction;
+}
+/** 整段平均水平速度（像素/毫秒）；反向回滑按 0 处理，避免折返被当成甩动。 */
+function averageHorizontalVelocity(samples) {
+    if (samples.length < 2)
+        return undefined;
+    const first = samples[0];
+    const last = samples[samples.length - 1];
+    const elapsed = last.t - first.t;
+    if (!(elapsed > 0))
+        return undefined;
+    const dx = last.x - first.x;
+    if (dx === 0)
+        return 0;
+    return Math.abs(dx) / elapsed;
+}
+function composedPathOf(event) {
+    const method = event.composedPath;
+    if (typeof method !== 'function')
+        return [];
+    try {
+        const path = method.call(event);
+        return Array.isArray(path) ? path : [];
+    }
+    catch {
+        return [];
+    }
 }
 function preventDefault(event) {
     try {
@@ -303,14 +523,93 @@ function isEditableTarget(target) {
     if (typeof closest !== 'function')
         return false;
     try {
-        return closest.call(target, 'input, textarea, select, [contenteditable="true"], .xterm, .cm-editor') !== null;
+        return closest.call(target, 'input, textarea, select, [contenteditable="true"], [data-sidebar-terminal], .xterm, .cm-editor') !== null;
     }
     catch {
         return false;
     }
 }
+/**
+ * 判断触摸点是否位于可横向滚动的元素或其后代中。消息里的表格、代码块和长文本
+ * 包装器都依赖这个判断获得全局侧栏手势让位。
+ *
+ * 必须同时具备横向滚动样式和实际的 `scrollWidth > clientWidth`。只设置
+ * `overflow: auto` 的聊天纵向列表不能因此抢走左右侧栏唤起手势。
+ */
+export function isHorizontalScrollableTarget(target) {
+    let current = target;
+    const visited = new Set();
+    for (let depth = 0; depth < 32 && isObjectLike(current); depth += 1) {
+        if (visited.has(current))
+            return false;
+        visited.add(current);
+        if (isHorizontalScrollableElement(current))
+            return true;
+        current = parentElementOf(current);
+    }
+    return false;
+}
+function isHorizontalScrollableElement(element) {
+    const scrollWidth = finiteNumber(element.scrollWidth);
+    const clientWidth = finiteNumber(element.clientWidth);
+    const overflowX = readOverflowX(element);
+    const canScrollX = overflowX === 'auto' || overflowX === 'scroll' || overflowX === 'overlay';
+    if (!canScrollX)
+        return false;
+    return scrollWidth !== undefined && clientWidth !== undefined && scrollWidth > clientWidth + 1;
+}
+function readOverflowX(element) {
+    const style = element.style;
+    const inline = typeof style?.overflowX === 'string' && style.overflowX.trim() !== ''
+        ? style.overflowX
+        : typeof style?.overflow === 'string' && style.overflow.trim() !== ''
+            ? style.overflow
+            : undefined;
+    if (inline !== undefined)
+        return normalizeOverflowValue(inline);
+    const ownerDocument = element.ownerDocument;
+    const view = isObjectLike(ownerDocument)
+        ? ownerDocument.defaultView
+        : undefined;
+    const getComputedStyle = isObjectLike(view)
+        ? view.getComputedStyle
+        : undefined;
+    if (typeof getComputedStyle !== 'function')
+        return undefined;
+    try {
+        const computed = getComputedStyle.call(view, element);
+        return typeof computed?.overflowX === 'string' ? normalizeOverflowValue(computed.overflowX) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeOverflowValue(value) {
+    return value.trim().toLowerCase().split(/\s+/u)[0] ?? '';
+}
+function parentElementOf(value) {
+    const parentElement = value.parentElement;
+    if (isObjectLike(parentElement))
+        return parentElement;
+    const parentNode = value.parentNode;
+    return isObjectLike(parentNode) ? parentNode : undefined;
+}
+function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
 function now() {
     const performanceLike = globalThis.performance;
     return typeof performanceLike?.now === 'function' ? performanceLike.now() : Date.now();
 }
+function eventTime(event) {
+    if (typeof event === 'object' && event !== null) {
+        const timeStamp = event.timeStamp;
+        if (typeof timeStamp === 'number' && Number.isFinite(timeStamp))
+            return timeStamp;
+    }
+    return now();
+}
 //# sourceMappingURL=mobile-sidebar-gestures.js.map