@jingyi0605/codingns4dsh 0.2.0-beta.1 → 0.2.0-rc.2

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

@@ -0,0 +1,316 @@
+/**
+ * 移动端侧栏手势控制器。
+ *
+ * 判定逻辑抽成纯函数 `detectSidebarGesture`，控制器只负责采样与调用服务：
+ * 左栏走 `ctx.layout.toggleSidebar()`，右栏走 `ctx.sidebarRight.toggleExpanded()`。
+ * 这里不修改任何 DOM class 或 DSH store，因此侧栏宽度、动画与持久化仍由 DSH 自己维护。
+ *
+ * 与系统手势的关系：屏幕边缘热区默认让给系统返回手势（`avoid` 模式），手势在
+ * 方向锁定失败时立即释放，不 intercept 滚动。
+ */
+import { vibrateMobile } from './mobile-vibration.js';
+export const DEFAULT_GESTURE_EDGE_ZONE_PX = 24;
+export const DEFAULT_GESTURE_DIRECTION_RATIO = 1.5;
+/** 与 DSH 窄屏断点保持一致；超过该宽度不安装全局触摸监听。 */
+export const DEFAULT_MOBILE_GESTURE_VIEWPORT_MAX_PX = 1024;
+/** 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。 */
+export function detectSidebarGesture(samples, config) {
+    const thresholdPx = Number.isFinite(config.thresholdPx) ? config.thresholdPx : Number.NaN;
+    const viewportWidth = Number.isFinite(config.viewportWidth) ? config.viewportWidth : 0;
+    if (!Number.isFinite(thresholdPx) || thresholdPx <= 0 || viewportWidth <= 0)
+        return { action: 'ignore', reason: 'config' };
+    if (samples.length < 2)
+        return { action: 'ignore', 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' };
+    }
+    const dx = last.x - first.x;
+    const dy = last.y - first.y;
+    if (Math.abs(dx) < thresholdPx)
+        return { action: 'ignore', reason: 'threshold' };
+    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' };
+}
+export const GESTURE_DIAGNOSTIC_CAPABILITY_MISSING = 'CODINGNS_GESTURE_CAPABILITY_MISSING';
+export const GESTURE_DIAGNOSTIC_NOT_MOBILE = 'CODINGNS_GESTURE_NOT_MOBILE';
+/** 启动手势控制器；未启用或没有任何可用端口时不注册任何监听。 */
+export function startMobileSidebarGestures(options) {
+    const hostWindow = options.window ?? globalThis.window;
+    const hostDocument = options.document ?? globalThis.document;
+    let active = false;
+    let samples = [];
+    let tracking = false;
+    let claimed = false;
+    let rightbarHistoryPushed = false;
+    // 只有宿主没有提供左栏 DOM 状态时才使用这个乐观状态，保证测试环境和
+    // 尚未完成 DOM 挂载的 WebView 仍能连续完成“打开后左滑关闭”。
+    let leftCollapsedFallback;
+    const onResize = () => { refresh(); };
+    const onTouchStart = (event) => {
+        const touch = firstTouch(event);
+        if (touch === null)
+            return;
+        if (isEditableTarget(touch.target))
+            return;
+        tracking = true;
+        claimed = false;
+        samples = [{ x: touch.x, y: touch.y, t: now() }];
+    };
+    const onTouchMove = (event) => {
+        if (!tracking)
+            return;
+        const touch = firstTouch(event);
+        if (touch === null)
+            return;
+        samples.push({ x: touch.x, y: touch.y, t: now() });
+        if (!claimed && samples.length <= 24) {
+            const decision = detectSidebarGesture(samples, resolveConfig(options));
+            if (decision.reason === 'ok') {
+                claimed = true;
+                applyAction(decision.action);
+                preventDefault(event);
+                return;
+            }
+            if (decision.reason === 'direction') {
+                // 纵向意图明确：立刻释放，避免影响列表滚动。
+                tracking = false;
+                samples = [];
+                return;
+            }
+        }
+        if (claimed)
+            preventDefault(event);
+    };
+    const onTouchEnd = () => {
+        tracking = false;
+        claimed = false;
+        samples = [];
+    };
+    const onPopState = () => {
+        if (!rightbarHistoryPushed)
+            return;
+        rightbarHistoryPushed = false;
+        if (options.ports.sidebarRight?.isExpanded() === true)
+            options.ports.sidebarRight.toggleExpanded();
+    };
+    const applyAction = (action) => {
+        if (action === 'ignore')
+            return;
+        // 仅在手势真正触发开合后反馈，避免滚动和方向锁定失败时误振动。
+        triggerVibration(10);
+        const sidebarRight = options.ports.sidebarRight;
+        if (action === 'left') {
+            // 与左栏保持对称：右栏由左滑呼出后，下一次反向右滑应先收回右栏，
+            // 不能把同一次操作解释成呼出左栏。右栏状态由端口提供，是唯一事实来源。
+            if (sidebarRight?.isExpanded() === true) {
+                sidebarRight.toggleExpanded();
+                // 该历史记录只服务于“返回键关闭右栏”；手势已经主动关闭时不应再
+                // 在后续 popstate 中重复尝试关闭。
+                rightbarHistoryPushed = false;
+                return;
+            }
+            toggleLeftSidebar();
+            return;
+        }
+        // 默认映射下物理左滑会得到 `right` 动作。左栏已经展开时，用户的意图
+        // 是收回刚刚呼出的左栏，而不是再打开右栏；优先关闭左栏才能保持手势
+        // 的方向直觉。`swap` 映射下物理左滑本身已经映射为 `left`，同样由上方
+        // 分支处理。
+        if (readLeftCollapsed() === false && options.ports.layout !== undefined) {
+            toggleLeftSidebar();
+            return;
+        }
+        if (sidebarRight === undefined)
+            return;
+        const wasExpanded = sidebarRight.isExpanded() === true;
+        sidebarRight.toggleExpanded();
+        if (wasExpanded) {
+            // 同方向再次触发也可能关闭右栏，保持历史状态与实际面板一致。
+            rightbarHistoryPushed = false;
+            return;
+        }
+        if (!wasExpanded && sidebarRight.isExpanded() === true && hostWindow?.history !== undefined) {
+            // 全屏右栏压入一条历史记录：Android 返回手势与 iOS 边缘返回先关右栏。
+            try {
+                hostWindow.history.pushState({ codingnsRightbar: true }, '');
+                rightbarHistoryPushed = true;
+            }
+            catch {
+                rightbarHistoryPushed = false;
+            }
+        }
+    };
+    const readLeftCollapsed = () => {
+        const reported = options.readLeftCollapsed?.();
+        return reported ?? leftCollapsedFallback;
+    };
+    /**
+     * 将振动调用绑定到实际接收触摸事件的 Window。
+     *
+     * DSH 的客户端代码由模块加载器注入执行，模块里的 `globalThis` 在部分
+     * Android WebView 中不一定就是承载触摸事件的页面 Window。直接使用它会
+     * 让 `navigator.vibrate()` 静默降级；优先从 hostWindow 读取 navigator，
+     * 才能保证手势和振动属于同一个浏览器上下文。
+     */
+    const triggerVibration = (pattern) => {
+        if (options.vibrate !== undefined) {
+            try {
+                options.vibrate(pattern);
+            }
+            catch {
+                // 可选触感能力失败时不能影响侧栏开合。
+            }
+            return;
+        }
+        const pageGlobal = hostWindow;
+        if (typeof pageGlobal?.navigator?.vibrate === 'function') {
+            vibrateMobile(pattern, pageGlobal);
+            return;
+        }
+        // 测试环境或宿主窗口没有 navigator 时仍保留全局环境的兼容回退。
+        vibrateMobile(pattern);
+    };
+    const toggleLeftSidebar = () => {
+        const reported = options.readLeftCollapsed?.();
+        const before = reported ?? leftCollapsedFallback;
+        options.ports.layout?.toggleSidebar();
+        // DOM 状态是宿主的唯一事实来源；只有它缺失时才更新本地兜底值。首次
+        // 触发左栏切换按“由收起态呼出”处理，后续手势即可得到稳定的开合语义。
+        if (reported === undefined)
+            leftCollapsedFallback = before === undefined ? false : !before;
+    };
+    const attach = () => {
+        if (active)
+            return;
+        active = true;
+        hostWindow?.addEventListener('touchstart', onTouchStart, { passive: true });
+        hostWindow?.addEventListener('touchmove', onTouchMove, { passive: false });
+        hostWindow?.addEventListener('touchend', onTouchEnd, { passive: true });
+        hostWindow?.addEventListener('touchcancel', onTouchEnd, { passive: true });
+        hostWindow?.addEventListener('popstate', onPopState);
+    };
+    const detach = () => {
+        if (!active)
+            return;
+        active = false;
+        hostWindow?.removeEventListener('touchstart', onTouchStart);
+        hostWindow?.removeEventListener('touchmove', onTouchMove);
+        hostWindow?.removeEventListener('touchend', onTouchEnd);
+        hostWindow?.removeEventListener('touchcancel', onTouchEnd);
+        hostWindow?.removeEventListener('popstate', onPopState);
+        onTouchEnd();
+    };
+    const refresh = () => {
+        const settings = options.settings();
+        const hasLayout = options.ports.layout !== undefined;
+        const hasRight = options.ports.sidebarRight !== undefined;
+        const hasAnyPort = hasLayout || hasRight;
+        const wanted = settings.sidebarGestures && hasAnyPort && isMobileTouchViewport(hostWindow, options.viewportMaxPx ?? DEFAULT_MOBILE_GESTURE_VIEWPORT_MAX_PX);
+        if (settings.sidebarGestures && hasAnyPort && !wanted) {
+            options.onDiagnostic?.(GESTURE_DIAGNOSTIC_NOT_MOBILE);
+        }
+        if (settings.sidebarGestures && !hasAnyPort) {
+            // 用户打开了手势但布局服务整体不可用：不挂监听，并留下可解释诊断。
+            options.onDiagnostic?.(GESTURE_DIAGNOSTIC_CAPABILITY_MISSING);
+        }
+        if (wanted && !active) {
+            if (!hasLayout || !hasRight)
+                options.onDiagnostic?.(GESTURE_DIAGNOSTIC_CAPABILITY_MISSING);
+            attach();
+        }
+        else if (!wanted && active)
+            detach();
+        return active;
+    };
+    if (hostDocument === undefined && hostWindow === undefined)
+        options.onDiagnostic?.(GESTURE_DIAGNOSTIC_CAPABILITY_MISSING);
+    hostWindow?.addEventListener('resize', onResize);
+    refresh();
+    return {
+        dispose() {
+            detach();
+            hostWindow?.removeEventListener('resize', onResize);
+        },
+        refresh,
+    };
+}
+/** 只在窄屏或明确存在触摸点的设备上启用，避免桌面触摸屏误抢滚动。 */
+function isMobileTouchViewport(windowLike, maxPx) {
+    const width = windowLike?.innerWidth
+        ?? globalThis.innerWidth;
+    if (typeof width !== 'number' || !Number.isFinite(width) || width <= 0)
+        return false;
+    if (!Number.isFinite(maxPx) || maxPx <= 0 || width > maxPx)
+        return false;
+    const maxTouchPoints = windowLike?.navigator?.maxTouchPoints;
+    if (typeof maxTouchPoints === 'number' && Number.isFinite(maxTouchPoints))
+        return maxTouchPoints > 0;
+    // 某些 WebView 不暴露 maxTouchPoints；窄屏 fallback 保证 Android WebView 能工作。
+    return true;
+}
+function resolveConfig(options) {
+    const settings = options.settings();
+    const viewportWidth = typeof options.window?.innerWidth === 'number' && options.window.innerWidth > 0
+        ? options.window.innerWidth
+        : typeof globalThis.innerWidth === 'number'
+            ? globalThis.innerWidth
+            : 0;
+    return {
+        thresholdPx: settings.sidebarGestureThresholdPx,
+        edgeMode: settings.sidebarGestureEdge,
+        mapping: settings.sidebarGestureMapping,
+        viewportWidth,
+    };
+}
+function firstTouch(event) {
+    if (typeof event !== 'object' || event === null)
+        return null;
+    const list = event.touches;
+    if (typeof list !== 'object' || list === null)
+        return null;
+    const first = list[0];
+    if (typeof first !== 'object' || first === null)
+        return null;
+    const x = first.clientX;
+    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 };
+}
+function preventDefault(event) {
+    try {
+        const cancelable = event.cancelable;
+        const method = event.preventDefault;
+        if (cancelable !== false && typeof method === 'function')
+            method.call(event);
+    }
+    catch {
+        // 事件可能已被浏览器标记为不可取消；忽略即可，不影响手势结果。
+    }
+}
+/** 输入框、可选文本与终端内部的触摸不参与手势。 */
+function isEditableTarget(target) {
+    if (typeof target !== 'object' || target === null)
+        return false;
+    const closest = target.closest;
+    if (typeof closest !== 'function')
+        return false;
+    try {
+        return closest.call(target, 'input, textarea, select, [contenteditable="true"], .xterm, .cm-editor') !== null;
+    }
+    catch {
+        return false;
+    }
+}
+function now() {
+    const performanceLike = globalThis.performance;
+    return typeof performanceLike?.now === 'function' ? performanceLike.now() : Date.now();
+}
+//# sourceMappingURL=mobile-sidebar-gestures.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * DSH 官方品牌鲸鱼图形的几何数据。
+ *
+ * 取值自 `@deepseek-ai/dsh-client-ui-primitives` 的 `FISH_LOGO_PATH` /
+ * `FISH_LOGO_VIEWBOX`（DSH 0.2.0-rc.1）。折叠态侧栏轨道里的 mark 用的就是同一个
+ * 图形，这里内联同一份路径以保证插件浮起的入口与原生外观完全一致。
+ *
+ * 之所以不 import primitives：本模块是纯 DOM 控制器，要在没有 React 与浏览器
+ * 依赖的 Node 测试里直接运行；同时功能模块不应直接依赖 DSH 版本专属类型。
+ */
+/** 鲸鱼轮廓的 SVG path 数据（与上游 `FISH_LOGO_PATH` 相同）。 */
+export declare const FISH_LOGO_PATH = "M22.9168 1.43018C22.6713 1.31018 22.5658 1.53918 22.4223 1.65519C22.3733 1.69269 22.3318 1.74169 22.2903 1.78669C21.9317 2.1697 21.5127 2.42121 20.9657 2.39121C20.1657 2.34621 19.4827 2.59771 18.8787 3.20973C18.7502 2.45521 18.3236 2.0047 17.6746 1.71569C17.3351 1.56568 16.9916 1.41518 16.7536 1.08867C16.5876 0.856163 16.5421 0.597155 16.4591 0.341647C16.4061 0.187643 16.3536 0.0301382 16.1761 0.00363739C15.9836 -0.0263635 15.9081 0.135141 15.8326 0.270145C15.5306 0.822162 15.4136 1.43018 15.4251 2.0462C15.4516 3.43174 16.0366 4.53527 17.1991 5.3203C17.3311 5.4103 17.3651 5.5003 17.3236 5.63181C17.2441 5.90231 17.1501 6.16482 17.0671 6.43533C17.0141 6.60784 16.9351 6.64584 16.7501 6.57033C16.1121 6.30383 15.5611 5.90931 15.074 5.4328C14.2475 4.63328 13.5 3.75075 12.568 3.05973C12.349 2.89822 12.13 2.74822 11.9034 2.60522C10.9524 1.68169 12.028 0.923165 12.277 0.833162C12.5375 0.739159 12.3675 0.41615 11.5259 0.42015C10.6844 0.42365 9.91439 0.705658 8.93286 1.08117C8.78935 1.13767 8.63835 1.17867 8.48384 1.21267C7.59332 1.04367 6.66829 1.00617 5.70226 1.11517C3.88321 1.31768 2.43016 2.1777 1.36213 3.64575C0.0790928 5.4103 -0.222916 7.41536 0.146595 9.50642C0.535106 11.7105 1.66014 13.535 3.38869 14.9616C5.18125 16.4406 7.24581 17.1657 9.60138 17.0266C11.0319 16.9441 12.6245 16.7526 14.421 15.2321C14.874 15.4576 15.3496 15.5476 16.1381 15.6151C16.7456 15.6716 17.3306 15.5851 17.7836 15.4911C18.4931 15.3411 18.4441 14.6841 18.1876 14.5636C16.1081 13.595 16.5646 13.9891 16.1496 13.67C17.2061 12.42 18.8202 10.1979 19.3182 7.17235C19.3672 6.83834 19.4297 6.36783 19.4222 6.09732C19.4182 5.93231 19.4562 5.86831 19.6447 5.84931C20.1657 5.78931 20.6712 5.64681 21.1357 5.3913C22.4833 4.65528 23.0268 3.44624 23.1548 1.9972C23.1738 1.77569 23.1508 1.54668 22.9168 1.43018ZM11.1749 14.4736C9.15936 12.889 8.18184 12.3675 7.77832 12.39C7.40081 12.4125 7.46881 12.8445 7.55182 13.126C7.63882 13.404 7.75182 13.5955 7.91033 13.8396C8.01983 14.0011 8.09533 14.2411 7.80083 14.4216C7.15181 14.8231 6.02327 14.2866 5.97027 14.2601C4.65673 13.4865 3.5587 12.4655 2.78467 11.069C2.03715 9.72493 1.60314 8.28289 1.53164 6.74384C1.51264 6.37233 1.62214 6.24082 1.99215 6.17332C2.47916 6.08332 2.98118 6.06432 3.46769 6.13582C5.52476 6.43633 7.27581 7.35586 8.74385 8.8129C9.58188 9.64243 10.2159 10.634 10.8689 11.6025C11.5634 12.631 12.3105 13.611 13.262 14.4146C13.598 14.6961 13.866 14.9101 14.1225 15.0681C13.349 15.1546 12.058 15.1731 11.1749 14.4746L11.1749 14.4736ZM12.141 8.25988C12.141 8.09488 12.273 7.96338 12.439 7.96338C12.4765 7.96338 12.5105 7.97088 12.541 7.98188C12.5825 7.99688 12.6205 8.01938 12.6505 8.05338C12.7035 8.10588 12.7335 8.18088 12.7335 8.25988C12.7335 8.42489 12.6015 8.55639 12.4355 8.55639C12.2695 8.55639 12.141 8.42489 12.141 8.25988ZM15.1415 9.79893C14.949 9.87793 14.7565 9.94544 14.5715 9.95294C14.2845 9.96794 13.9715 9.85143 13.8015 9.70893C13.5375 9.48742 13.3485 9.36342 13.2695 8.97691C13.2355 8.8119 13.2545 8.55639 13.2845 8.40989C13.3525 8.09438 13.277 7.89187 13.0545 7.70787C12.8735 7.55786 12.643 7.51636 12.39 7.51636C12.2955 7.51636 12.209 7.47486 12.1445 7.44136C12.039 7.38886 11.9519 7.25735 12.035 7.09585C12.0615 7.04335 12.19 6.91584 12.22 6.89334C12.5635 6.69784 12.9595 6.76184 13.326 6.90834C13.6655 7.04735 13.9225 7.30236 14.292 7.66287C14.6695 8.09838 14.7375 8.21838 14.9525 8.54539C15.1225 8.8009 15.277 9.06341 15.3831 9.36392C15.4471 9.55142 15.3641 9.70493 15.1415 9.79893Z";
+/** `FISH_LOGO_PATH` 的原生 viewBox 尺寸。 */
+export declare const FISH_LOGO_VIEWBOX: {
+    readonly width: 23.16;
+    readonly height: 17.04;
+};
+//# sourceMappingURL=mobile-sidebar-logo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-sidebar-logo.d.ts","sourceRoot":"","sources":["../../../../src/client/mobile-sidebar-logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,cAAc,63GAA63G,CAAA;AAEx5G,uCAAuC;AACvC,eAAO,MAAM,iBAAiB;;;CAA2C,CAAA"}

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

@@ -0,0 +1,15 @@
+/**
+ * DSH 官方品牌鲸鱼图形的几何数据。
+ *
+ * 取值自 `@deepseek-ai/dsh-client-ui-primitives` 的 `FISH_LOGO_PATH` /
+ * `FISH_LOGO_VIEWBOX`（DSH 0.2.0-rc.1）。折叠态侧栏轨道里的 mark 用的就是同一个
+ * 图形，这里内联同一份路径以保证插件浮起的入口与原生外观完全一致。
+ *
+ * 之所以不 import primitives：本模块是纯 DOM 控制器，要在没有 React 与浏览器
+ * 依赖的 Node 测试里直接运行；同时功能模块不应直接依赖 DSH 版本专属类型。
+ */
+/** 鲸鱼轮廓的 SVG path 数据（与上游 `FISH_LOGO_PATH` 相同）。 */
+export const FISH_LOGO_PATH = 'M22.9168 1.43018C22.6713 1.31018 22.5658 1.53918 22.4223 1.65519C22.3733 1.69269 22.3318 1.74169 22.2903 1.78669C21.9317 2.1697 21.5127 2.42121 20.9657 2.39121C20.1657 2.34621 19.4827 2.59771 18.8787 3.20973C18.7502 2.45521 18.3236 2.0047 17.6746 1.71569C17.3351 1.56568 16.9916 1.41518 16.7536 1.08867C16.5876 0.856163 16.5421 0.597155 16.4591 0.341647C16.4061 0.187643 16.3536 0.0301382 16.1761 0.00363739C15.9836 -0.0263635 15.9081 0.135141 15.8326 0.270145C15.5306 0.822162 15.4136 1.43018 15.4251 2.0462C15.4516 3.43174 16.0366 4.53527 17.1991 5.3203C17.3311 5.4103 17.3651 5.5003 17.3236 5.63181C17.2441 5.90231 17.1501 6.16482 17.0671 6.43533C17.0141 6.60784 16.9351 6.64584 16.7501 6.57033C16.1121 6.30383 15.5611 5.90931 15.074 5.4328C14.2475 4.63328 13.5 3.75075 12.568 3.05973C12.349 2.89822 12.13 2.74822 11.9034 2.60522C10.9524 1.68169 12.028 0.923165 12.277 0.833162C12.5375 0.739159 12.3675 0.41615 11.5259 0.42015C10.6844 0.42365 9.91439 0.705658 8.93286 1.08117C8.78935 1.13767 8.63835 1.17867 8.48384 1.21267C7.59332 1.04367 6.66829 1.00617 5.70226 1.11517C3.88321 1.31768 2.43016 2.1777 1.36213 3.64575C0.0790928 5.4103 -0.222916 7.41536 0.146595 9.50642C0.535106 11.7105 1.66014 13.535 3.38869 14.9616C5.18125 16.4406 7.24581 17.1657 9.60138 17.0266C11.0319 16.9441 12.6245 16.7526 14.421 15.2321C14.874 15.4576 15.3496 15.5476 16.1381 15.6151C16.7456 15.6716 17.3306 15.5851 17.7836 15.4911C18.4931 15.3411 18.4441 14.6841 18.1876 14.5636C16.1081 13.595 16.5646 13.9891 16.1496 13.67C17.2061 12.42 18.8202 10.1979 19.3182 7.17235C19.3672 6.83834 19.4297 6.36783 19.4222 6.09732C19.4182 5.93231 19.4562 5.86831 19.6447 5.84931C20.1657 5.78931 20.6712 5.64681 21.1357 5.3913C22.4833 4.65528 23.0268 3.44624 23.1548 1.9972C23.1738 1.77569 23.1508 1.54668 22.9168 1.43018ZM11.1749 14.4736C9.15936 12.889 8.18184 12.3675 7.77832 12.39C7.40081 12.4125 7.46881 12.8445 7.55182 13.126C7.63882 13.404 7.75182 13.5955 7.91033 13.8396C8.01983 14.0011 8.09533 14.2411 7.80083 14.4216C7.15181 14.8231 6.02327 14.2866 5.97027 14.2601C4.65673 13.4865 3.5587 12.4655 2.78467 11.069C2.03715 9.72493 1.60314 8.28289 1.53164 6.74384C1.51264 6.37233 1.62214 6.24082 1.99215 6.17332C2.47916 6.08332 2.98118 6.06432 3.46769 6.13582C5.52476 6.43633 7.27581 7.35586 8.74385 8.8129C9.58188 9.64243 10.2159 10.634 10.8689 11.6025C11.5634 12.631 12.3105 13.611 13.262 14.4146C13.598 14.6961 13.866 14.9101 14.1225 15.0681C13.349 15.1546 12.058 15.1731 11.1749 14.4746L11.1749 14.4736ZM12.141 8.25988C12.141 8.09488 12.273 7.96338 12.439 7.96338C12.4765 7.96338 12.5105 7.97088 12.541 7.98188C12.5825 7.99688 12.6205 8.01938 12.6505 8.05338C12.7035 8.10588 12.7335 8.18088 12.7335 8.25988C12.7335 8.42489 12.6015 8.55639 12.4355 8.55639C12.2695 8.55639 12.141 8.42489 12.141 8.25988ZM15.1415 9.79893C14.949 9.87793 14.7565 9.94544 14.5715 9.95294C14.2845 9.96794 13.9715 9.85143 13.8015 9.70893C13.5375 9.48742 13.3485 9.36342 13.2695 8.97691C13.2355 8.8119 13.2545 8.55639 13.2845 8.40989C13.3525 8.09438 13.277 7.89187 13.0545 7.70787C12.8735 7.55786 12.643 7.51636 12.39 7.51636C12.2955 7.51636 12.209 7.47486 12.1445 7.44136C12.039 7.38886 11.9519 7.25735 12.035 7.09585C12.0615 7.04335 12.19 6.91584 12.22 6.89334C12.5635 6.69784 12.9595 6.76184 13.326 6.90834C13.6655 7.04735 13.9225 7.30236 14.292 7.66287C14.6695 8.09838 14.7375 8.21838 14.9525 8.54539C15.1225 8.8009 15.277 9.06341 15.3831 9.36392C15.4471 9.55142 15.3641 9.70493 15.1415 9.79893Z';
+/** `FISH_LOGO_PATH` 的原生 viewBox 尺寸。 */
+export const FISH_LOGO_VIEWBOX = { width: 23.16, height: 17.04 };
+//# sourceMappingURL=mobile-sidebar-logo.js.map

package/data/build/dist/client/mobile-sidebar-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-sidebar-logo.js","sourceRoot":"","sources":["../../../../src/client/mobile-sidebar-logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,03GAA03G,CAAA;AAEx5G,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAW,CAAA"}

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

@@ -0,0 +1,114 @@
+/**
+ * 移动端左侧边栏彻底隐藏器。
+ *
+ * DSH 在窄屏（< 1024px）下把左侧边栏收起成 56px 的图标轨道，而不是 0 宽：
+ * 轨道本身始终占用横向空间，手机上等于白扔一条竖直区域。DSH 没有公开“折叠宽度”
+ * 配置（`collapsedWidth` 只在 macOS 桌面与 Windows 标题栏两种形态下为 0），因此这里
+ * 在浏览器侧做三件事，且只改界面、不改 DSH 状态：
+ *
+ * 1. 把应用框架（`AppFrame`）内联的 `grid-template-columns` 第一条轨道改写成 `0px`，
+ *    其余轨道原样保留；React 重绘后由 MutationObserver 立即补写，恢复时写回基线值。
+ * 2. 把左侧栏列整列隐藏，避免它作为 0 宽列仍渲染子树。
+ * 3. 在 `document.body` 上挂一个**插件自有**的固定定位 logo 按钮作为再次唤起入口，
+ *    点击调用 DSH 官方 `ctx.layout.toggleSidebar()`。
+ *
+ * 第 3 点是踩坑后的结论。最初的实现复用 DSH 折叠态侧栏里那一行原生 logo 行，
+ * 把它 `position:fixed` 浮起来；但那一行位于**已被收成 0 宽、且带
+ * `overflow:hidden`** 的侧栏列内部，只要任意祖先形成固定定位包含块（transform /
+ * filter / contain / will-change），`position:fixed` 就会被改写成相对该祖先定位，
+ * 随即被裁掉——表现为“侧栏确实收起了，但看不到 logo”。自建按钮挂在 body 上，
+ * 不再受侧栏列的裁剪与包含块影响；图形仍使用与上游完全相同的鲸鱼路径，外观一致。
+ *
+ * 依赖的 DSH 0.2.0-rc.1 DOM 契约（任何一条不成立都只是不生效，不会误改宿主界面）：
+ * - 应用框架是文档里包含 `[data-shell-overlay]` 且带内联 `grid-template-columns` 的元素；
+ * - 框架的第一个非遮罩层子元素是左侧栏列；
+ * - 折叠状态由框架上的 `data-sidebar-collapsed` 表达。
+ */
+import { type CodingNsLocale } from './locale.js';
+/** 加在 `documentElement` 上的开关：`on` 表示移动端隐藏模式正在生效。 */
+export declare const MOBILE_SIDEBAR_MODE_ATTRIBUTE = "data-codingns-mobile-sidebar";
+/** 加在应用框架元素上的标记。 */
+export declare const MOBILE_SIDEBAR_FRAME_ATTRIBUTE = "data-codingns-mobile-sidebar-frame";
+/** 加在左侧栏列上的标记。 */
+export declare const MOBILE_SIDEBAR_COLUMN_ATTRIBUTE = "data-codingns-mobile-sidebar-column";
+/** 加在插件自有唤起按钮上的标记。 */
+export declare const MOBILE_SIDEBAR_BUTTON_ATTRIBUTE = "data-codingns-mobile-sidebar-toggle";
+/** 插件样式标签的幂等键。 */
+export declare const MOBILE_SIDEBAR_STYLE_ID = "codingns4dsh-mobile-sidebar-style";
+/** 浮起的 logo 让给对话标题的预留宽度（像素）。 */
+export declare const MOBILE_SIDEBAR_LEADING_CLEARANCE_PX = 72;
+/** 框架上承载“已应用隐藏”的标记，供样式与诊断读取。 */
+export declare const MOBILE_SIDEBAR_GRID_STATE_ATTRIBUTE = "data-codingns-mobile-sidebar-grid";
+/**
+ * 唤起按钮的无障碍名称；与 DSH 原生折叠按钮的 `toggle.open` 文案一致。
+ *
+ * 保留导出以兼容既有测试与调用方；运行时的按钮文案由注入的 locale 决定，
+ * 这里的内置中文只作为未接 locale 时的兜底。
+ */
+export declare const MOBILE_SIDEBAR_TOGGLE_LABEL: string;
+export interface MobileSidebarRailSettings {
+    readonly hideSidebarOnMobile: boolean;
+    readonly mobileViewportMaxPx: number;
+}
+/** 控制器只用到视口宽度与 resize 监听，便于在 Node 测试里替换。 */
+export interface MobileSidebarRailWindowLike {
+    readonly innerWidth?: number | undefined;
+    addEventListener?(type: string, listener: () => void): void;
+    removeEventListener?(type: string, listener: () => void): void;
+}
+export interface MobileSidebarRailDomController {
+    /** 重新读取设置与视口并同步 DOM；返回当前是否处于隐藏模式。 */
+    refresh(): boolean;
+    /** 移除全部标记、样式与自建按钮，并把网格恢复为插件改写前的值。 */
+    dispose(): void;
+}
+export interface MobileSidebarRailDomOptions {
+    readonly document?: Document | undefined;
+    readonly window?: MobileSidebarRailWindowLike | undefined;
+    readonly MutationObserver?: typeof MutationObserver | undefined;
+    readonly settings: () => MobileSidebarRailSettings;
+    /** DSH 布局服务：唤起按钮点击时调用，与手势模块走同一个官方入口。 */
+    readonly toggleSidebar?: (() => void) | undefined;
+    /** 结构不符合预期时给出稳定诊断码，便于排查“为什么不生效”。 */
+    readonly onDiagnostic?: ((code: string) => void) | undefined;
+    /** DSH 语言运行时；只影响自建唤起按钮的无障碍名称。 */
+    readonly locale?: CodingNsLocale | undefined;
+}
+/** 结构不匹配：找不到应用框架或左侧栏列。 */
+export declare const MOBILE_SIDEBAR_DIAGNOSTIC_STRUCTURE_MISSING = "CODINGNS_MOBILE_SIDEBAR_STRUCTURE_MISSING";
+/** 找不到布局服务：按钮仍会出现，但点击无法开合。 */
+export declare const MOBILE_SIDEBAR_DIAGNOSTIC_TOGGLE_MISSING = "CODINGNS_MOBILE_SIDEBAR_TOGGLE_MISSING";
+/**
+ * 纯函数：视口宽度是否按“移动端/窄屏”处理。
+ */
+export declare function isMobileSidebarViewport(width: number, maxPx: number): boolean;
+/**
+ * 纯函数：宿主是否已经在框架的 `shell.leading` 座位里提供了自己的开合按钮。
+ *
+ * DSH 只在两种形态下把折叠宽度做成 0 并在 `[data-shell-leading]` 座位补上按钮：
+ * macOS 桌面与 Windows 标题栏。此时插件不该再放一个重复入口。这里做**结构探测**
+ * 而不是按平台判断：只要宿主已经渲染了那个座位且里面有按钮，就认为入口已存在。
+ */
+export declare function hasHostLeadingToggle(container: ParentNode & {
+    querySelector(selector: string): Element | null;
+}): boolean;
+/**
+ * 纯函数：右栏当前是否占用了界面空间（普通停靠或全屏）。
+ *
+ * DSH 在框架上写 `data-rightbar-collapsed`（右栏不占轨道时存在）与
+ * `data-rightbar-fullscreen`。右栏打开时它自己的标签栏就在左上角，插件再叠一个
+ * logo 会把标签盖住，因此这两种情况都必须让位。
+ */
+export declare function isRightbarOccupied(frame: Pick<HTMLElement, 'hasAttribute'> | undefined): boolean;
+/**
+ * 纯函数：把 `grid-template-columns` 的第一条轨道改写为 `0px`，其余原样保留。
+ *
+ * 只接受以显式 px 轨道开头的值（DSH 的框架写法）；其它形式返回 `undefined`，
+ * 调用方保持原样，避免把不认识的网格改坏。
+ */
+export declare function hideLeadingGridTrack(value: string): string | undefined;
+/**
+ * 启动移动端侧栏隐藏器；未启用或不在窄屏时保证零副作用（不写任何属性、不加样式、不建按钮）。
+ */
+export declare function startMobileSidebarRailDom(options: MobileSidebarRailDomOptions): MobileSidebarRailDomController;
+//# sourceMappingURL=mobile-sidebar-rail-dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-sidebar-rail-dom.d.ts","sourceRoot":"","sources":["../../../../src/client/mobile-sidebar-rail-dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAA6B,KAAK,cAAc,EAA2B,MAAM,aAAa,CAAA;AAErG,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,iCAAiC,CAAA;AAC3E,oBAAoB;AACpB,eAAO,MAAM,8BAA8B,uCAAuC,CAAA;AAClF,kBAAkB;AAClB,eAAO,MAAM,+BAA+B,wCAAwC,CAAA;AACpF,sBAAsB;AACtB,eAAO,MAAM,+BAA+B,wCAAwC,CAAA;AACpF,kBAAkB;AAClB,eAAO,MAAM,uBAAuB,sCAAsC,CAAA;AAC1E,gCAAgC;AAChC,eAAO,MAAM,mCAAmC,KAAK,CAAA;AAErD,gCAAgC;AAChC,eAAO,MAAM,mCAAmC,sCAAsC,CAAA;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAwD,CAAA;AAEhG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CACrC;AAED,4CAA4C;AAC5C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC3D,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;CAC/D;AAED,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,OAAO,IAAI,OAAO,CAAA;IAClB,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAA;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,GAAG,SAAS,CAAA;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,yBAAyB,CAAA;IAClD,wCAAwC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IACjD,oCAAoC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC5D,iCAAiC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAC7C;AAED,0BAA0B;AAC1B,eAAO,MAAM,2CAA2C,8CAA8C,CAAA;AACtG,8BAA8B;AAC9B,eAAO,MAAM,wCAAwC,2CAA2C,CAAA;AAEhG;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG;IAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAIzH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,SAAS,GAAG,OAAO,CAIhG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,2BAA2B,GACnC,8BAA8B,CAsPhC"}