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

package/data/build/dist/client/mobile-session-interaction.js

@@ -0,0 +1,291 @@
+/**
+ * 移动端会话交互修正。
+ *
+ * DSH 的会话行是带 `role="treeitem"` 的普通 div，桌面端依赖浏览器把触摸
+ * 转换成 click。iOS 独立窗口在这条链路上会额外触发双击与延迟 click，导致
+ * 会话标题的双击重命名被误触发。这里把短触摸明确转换为一次 click，并屏蔽
+ * 移动端的双击重命名；Composer 的焦点则只接受来自用户点按输入框的动作。
+ */
+const DEFAULT_MOBILE_VIEWPORT_MAX_PX = 1024;
+const TAP_MAX_DURATION_MS = 700;
+const TAP_MAX_DISTANCE_PX = 12;
+const FOCUS_ACTIVATION_WINDOW_MS = 700;
+const NATIVE_CLICK_SUPPRESSION_WINDOW_MS = 900;
+/** 纯函数：判断触摸是否足够像一次点按。 */
+export function isShortMobileTap(start, end) {
+    const dx = end.point.x - start.point.x;
+    const dy = end.point.y - start.point.y;
+    return end.at - start.at <= TAP_MAX_DURATION_MS
+        && Math.hypot(dx, dy) <= TAP_MAX_DISTANCE_PX;
+}
+/** 启动移动端会话交互修正；桌面视口不注册任何全局监听。 */
+export function startMobileSessionInteractionDom(options = {}) {
+    const hostWindow = options.window
+        ?? globalThis.window;
+    const hostDocument = options.document
+        ?? globalThis.document;
+    const viewportMaxPx = options.mobileViewportMaxPx ?? DEFAULT_MOBILE_VIEWPORT_MAX_PX;
+    let active = false;
+    let disposed = false;
+    let touchStart;
+    let userActivation;
+    let suppressedClick;
+    let dispatchingSyntheticClick = false;
+    const now = () => Date.now();
+    const blurComposer = () => {
+        const activeElement = hostDocument?.activeElement;
+        const element = asElement(activeElement);
+        if (element === null || !isComposerTarget(element))
+            return;
+        try {
+            element.blur?.();
+        }
+        catch { /* 浏览器焦点已被销毁时忽略。 */ }
+    };
+    const onPointerDown = (event) => {
+        const target = asElement(eventTarget(event));
+        if (target === null)
+            return;
+        userActivation = { target, at: now() };
+        if (!isComposerTarget(target))
+            blurComposer();
+    };
+    const onFocusIn = (event) => {
+        const target = asElement(eventTarget(event));
+        if (target === null || !isComposerTarget(target))
+            return;
+        const activation = userActivation;
+        const allowed = activation !== undefined
+            && now() - activation.at <= FOCUS_ACTIVATION_WINDOW_MS
+            && activationInsideComposer(activation.target, target);
+        if (allowed)
+            return;
+        // React/Lexical 可能在会话切换完成后的微任务中再次 focus；同步 blur 后再补
+        // 一次微任务，确保 Android WebView 和 iOS Web App 都不会留下软键盘。
+        blurElementLater(target);
+    };
+    const onTouchStart = (event) => {
+        const point = firstTouch(event);
+        if (point === null)
+            return;
+        const record = { point, at: now() };
+        touchStart = record;
+        const target = asElement(point.target);
+        userActivation = { target: target ?? emptyElement(), at: record.at };
+        if (target === null || !isComposerTarget(target))
+            blurComposer();
+    };
+    const onTouchEnd = (event) => {
+        const start = touchStart;
+        touchStart = undefined;
+        if (start === undefined)
+            return;
+        const point = endTouch(event, start.point);
+        if (point === null)
+            return;
+        const end = { point, at: now() };
+        if (!isShortMobileTap(start, end))
+            return;
+        const row = sessionRow(point.target);
+        if (row === null || isRowControl(point.target, row))
+            return;
+        // 阻止 iOS 在 touchend 后补发延迟 click；马上交给 React 的 onClick。
+        preventDefault(event);
+        suppressedClick = { row, at: end.at };
+        dispatchingSyntheticClick = true;
+        try {
+            row.click?.();
+        }
+        finally {
+            dispatchingSyntheticClick = false;
+        }
+    };
+    const onClickCapture = (event) => {
+        if (dispatchingSyntheticClick)
+            return;
+        const suppressed = suppressedClick;
+        if (suppressed === undefined || now() - suppressed.at > NATIVE_CLICK_SUPPRESSION_WINDOW_MS) {
+            suppressedClick = undefined;
+            return;
+        }
+        const row = sessionRow(eventTarget(event));
+        if (row !== null && row === suppressed.row) {
+            preventDefault(event);
+            stopPropagation(event);
+        }
+        suppressedClick = undefined;
+    };
+    const onDoubleClickCapture = (event) => {
+        const row = sessionRow(eventTarget(event));
+        if (row === null || isRowControl(eventTarget(event), row))
+            return;
+        // DSH 的标题双击就是重命名入口。移动端保留菜单中的重命名动作，
+        // 但不允许连续点按会话记录误开重命名对话框。
+        preventDefault(event);
+        stopPropagation(event);
+    };
+    const addListeners = () => {
+        if (active || hostDocument === undefined)
+            return;
+        active = true;
+        const capture = { capture: true, passive: false };
+        hostDocument.addEventListener('pointerdown', onPointerDown, capture);
+        hostDocument.addEventListener('mousedown', onPointerDown, capture);
+        hostDocument.addEventListener('touchstart', onTouchStart, capture);
+        hostDocument.addEventListener('touchend', onTouchEnd, capture);
+        hostDocument.addEventListener('focusin', onFocusIn, capture);
+        hostDocument.addEventListener('click', onClickCapture, capture);
+        hostDocument.addEventListener('dblclick', onDoubleClickCapture, capture);
+    };
+    const removeListeners = () => {
+        if (!active || hostDocument === undefined)
+            return;
+        active = false;
+        hostDocument.removeEventListener('pointerdown', onPointerDown, true);
+        hostDocument.removeEventListener('mousedown', onPointerDown, true);
+        hostDocument.removeEventListener('touchstart', onTouchStart, true);
+        hostDocument.removeEventListener('touchend', onTouchEnd, true);
+        hostDocument.removeEventListener('focusin', onFocusIn, true);
+        hostDocument.removeEventListener('click', onClickCapture, true);
+        hostDocument.removeEventListener('dblclick', onDoubleClickCapture, true);
+        touchStart = undefined;
+        userActivation = undefined;
+        suppressedClick = undefined;
+    };
+    const refresh = () => {
+        if (disposed)
+            return false;
+        const wanted = isMobileTouchViewport(hostWindow, viewportMaxPx);
+        if (wanted)
+            addListeners();
+        else
+            removeListeners();
+        return active;
+    };
+    const onResize = () => { refresh(); };
+    hostWindow?.addEventListener('resize', onResize);
+    refresh();
+    return {
+        refresh,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            removeListeners();
+            hostWindow?.removeEventListener('resize', onResize);
+        },
+    };
+}
+function isMobileTouchViewport(windowLike, maxPx) {
+    const width = windowLike?.innerWidth;
+    if (typeof width !== 'number' || !Number.isFinite(width) || width <= 0 || width > maxPx)
+        return false;
+    const touchPoints = windowLike?.navigator?.maxTouchPoints;
+    return typeof touchPoints !== 'number' || touchPoints > 0;
+}
+function sessionRow(target) {
+    const element = asElement(target);
+    if (element === null || typeof element.closest !== 'function')
+        return null;
+    try {
+        const row = element.closest('[role="treeitem"][aria-selected]');
+        const expanded = row?.getAttribute?.('aria-expanded');
+        if (row === null || (expanded !== null && expanded !== undefined))
+            return null;
+        return row;
+    }
+    catch {
+        return null;
+    }
+}
+function isRowControl(target, row) {
+    const element = asElement(target);
+    if (element === null || typeof element.closest !== 'function')
+        return false;
+    try {
+        const control = element.closest('button, a, input, textarea, select, [contenteditable="true"]');
+        return control !== null && control !== row;
+    }
+    catch {
+        return false;
+    }
+}
+function isComposerTarget(target) {
+    try {
+        return target.closest?.('[data-composer-input="true"]') !== null;
+    }
+    catch {
+        return false;
+    }
+}
+function activationInsideComposer(activation, target) {
+    if (activation === target)
+        return true;
+    try {
+        return target.contains?.(activation) === true || activation.closest?.('[data-composer-input="true"]') === target.closest?.('[data-composer-input="true"]');
+    }
+    catch {
+        return false;
+    }
+}
+function asElement(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function emptyElement() {
+    return { closest: () => null };
+}
+function eventTarget(event) {
+    return typeof event === 'object' && event !== null ? event.target : undefined;
+}
+function firstTouch(event) {
+    if (typeof event !== 'object' || event === null)
+        return null;
+    const list = event.touches;
+    const first = typeof list === 'object' && list !== null ? list[0] : undefined;
+    return readTouch(first, eventTarget(event));
+}
+function endTouch(event, fallbackTarget) {
+    if (typeof event !== 'object' || event === null)
+        return null;
+    const list = event.changedTouches;
+    const first = typeof list === 'object' && list !== null ? list[0] : undefined;
+    return readTouch(first, eventTarget(event) ?? fallbackTarget);
+}
+function readTouch(value, target) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const x = value.clientX;
+    const y = value.clientY;
+    return typeof x === 'number' && typeof y === 'number' && Number.isFinite(x) && Number.isFinite(y)
+        ? { x, y, target }
+        : null;
+}
+function blurElementLater(element) {
+    try {
+        element.blur?.();
+    }
+    catch { /* 忽略失效的焦点节点。 */ }
+    const schedule = typeof queueMicrotask === 'function' ? queueMicrotask : (callback) => { setTimeout(callback, 0); };
+    schedule(() => {
+        try {
+            if (isComposerTarget(element))
+                element.blur?.();
+        }
+        catch { /* 节点已卸载。 */ }
+    });
+}
+function preventDefault(event) {
+    const method = typeof event === 'object' && event !== null ? event.preventDefault : undefined;
+    if (typeof method === 'function')
+        method.call(event);
+}
+function stopPropagation(event) {
+    if (typeof event !== 'object' || event === null)
+        return;
+    const value = event;
+    if (typeof value.stopImmediatePropagation === 'function')
+        value.stopImmediatePropagation.call(event);
+    else if (typeof value.stopPropagation === 'function')
+        value.stopPropagation.call(event);
+}
+//# sourceMappingURL=mobile-session-interaction.js.map

package/data/build/dist/client/mobile-session-interaction.js.map

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

package/data/build/dist/client/mobile-settings-modal-dom.d.ts

@@ -0,0 +1,49 @@
+/**
+ * DSH 设置弹窗的移动端布局适配。
+ *
+ * 设置弹窗由 DSH 通过 portal 直接挂到 body，插件不能把样式写进自己的 React
+ * 树。这里依赖唯一稳定的 `[data-shortcut-modal="settings"]` 钩子，再按设置根节点
+ * 的稳定语义结构（`nav` 与内容列）注入一份可撤销的样式：窄屏时导航变成只显示
+ * 图标的窄轨道，弹窗内容占满整个视口。桌面端不写属性、不注入样式，避免影响
+ * DSH 原生布局。
+ */
+/** DSH 设置弹窗的稳定选择器。 */
+export declare const MOBILE_SETTINGS_MODAL_SELECTOR = "[data-shortcut-modal=\"settings\"]";
+/** 插件在设置弹窗上挂载的移动端标记。 */
+export declare const MOBILE_SETTINGS_MODAL_ATTRIBUTE = "data-codingns-mobile-settings";
+/** 插件样式标签的幂等键。 */
+export declare const MOBILE_SETTINGS_MODAL_STYLE_ID = "codingns4dsh-mobile-settings-style";
+/** 默认按移动端处理的最大视口宽度。 */
+export declare const MOBILE_SETTINGS_MODAL_DEFAULT_MAX_PX = 1024;
+/** 移动端设置适配所需的窗口最小接口，便于在 Node 测试中替换。 */
+export interface MobileSettingsModalWindowLike {
+    readonly innerWidth?: number | undefined;
+    addEventListener?(type: string, listener: () => void): void;
+    removeEventListener?(type: string, listener: () => void): void;
+}
+export interface MobileSettingsModalOptions {
+    readonly document?: Document | undefined;
+    readonly window?: MobileSettingsModalWindowLike | undefined;
+    readonly MutationObserver?: typeof MutationObserver | undefined;
+    /** 是否启用本轮适配；缺省为启用。 */
+    readonly enabled?: (() => boolean) | undefined;
+    /** 移动端视口上限；缺省为 1024px。 */
+    readonly mobileViewportMaxPx?: (() => number) | number | undefined;
+}
+export interface MobileSettingsModalController {
+    /** 重新读取视口并同步当前设置弹窗。 */
+    refresh(): void;
+    /** 断开观察器并撤销插件写入。 */
+    dispose(): void;
+}
+/** 纯函数：判断一个视口是否按移动端设置布局处理。 */
+export declare function isMobileSettingsViewport(width: number, maxPx?: number): boolean;
+/**
+ * 启动设置弹窗移动端适配。
+ *
+ * React 每次打开设置都会重新创建 portal，因此同时监听 documentElement 的子树变更
+ * 与窗口 resize。样式使用强制规则覆盖 DSH 的固定 800px/188px 布局，但只在插件
+ * 自己标记的弹窗上生效；dispose 后完全移除标记和 style 标签。
+ */
+export declare function startMobileSettingsModalDom(options?: MobileSettingsModalOptions): MobileSettingsModalController;
+//# sourceMappingURL=mobile-settings-modal-dom.d.ts.map

package/data/build/dist/client/mobile-settings-modal-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-settings-modal-dom.d.ts","sourceRoot":"","sources":["../../../../src/client/mobile-settings-modal-dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sBAAsB;AACtB,eAAO,MAAM,8BAA8B,uCAAqC,CAAA;AAChF,wBAAwB;AACxB,eAAO,MAAM,+BAA+B,kCAAkC,CAAA;AAC9E,kBAAkB;AAClB,eAAO,MAAM,8BAA8B,uCAAuC,CAAA;AAClF,uBAAuB;AACvB,eAAO,MAAM,oCAAoC,OAAO,CAAA;AAExD,uCAAuC;AACvC,MAAM,WAAW,6BAA6B;IAC5C,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,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,GAAG,SAAS,CAAA;IAC/D,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAA;IAC9C,0BAA0B;IAC1B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAAA;CACnE;AAED,MAAM,WAAW,6BAA6B;IAC5C,uBAAuB;IACvB,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB;IACpB,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,8BAA8B;AAC9B,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAuC,GAAG,OAAO,CAE7G;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,0BAA+B,GAAG,6BAA6B,CAsEnH"}

package/data/build/dist/client/mobile-settings-modal-dom.js

@@ -0,0 +1,152 @@
+/**
+ * DSH 设置弹窗的移动端布局适配。
+ *
+ * 设置弹窗由 DSH 通过 portal 直接挂到 body，插件不能把样式写进自己的 React
+ * 树。这里依赖唯一稳定的 `[data-shortcut-modal="settings"]` 钩子，再按设置根节点
+ * 的稳定语义结构（`nav` 与内容列）注入一份可撤销的样式：窄屏时导航变成只显示
+ * 图标的窄轨道，弹窗内容占满整个视口。桌面端不写属性、不注入样式，避免影响
+ * DSH 原生布局。
+ */
+/** DSH 设置弹窗的稳定选择器。 */
+export const MOBILE_SETTINGS_MODAL_SELECTOR = '[data-shortcut-modal="settings"]';
+/** 插件在设置弹窗上挂载的移动端标记。 */
+export const MOBILE_SETTINGS_MODAL_ATTRIBUTE = 'data-codingns-mobile-settings';
+/** 插件样式标签的幂等键。 */
+export const MOBILE_SETTINGS_MODAL_STYLE_ID = 'codingns4dsh-mobile-settings-style';
+/** 默认按移动端处理的最大视口宽度。 */
+export const MOBILE_SETTINGS_MODAL_DEFAULT_MAX_PX = 1024;
+/** 纯函数：判断一个视口是否按移动端设置布局处理。 */
+export function isMobileSettingsViewport(width, maxPx = MOBILE_SETTINGS_MODAL_DEFAULT_MAX_PX) {
+    return Number.isFinite(width) && width > 0 && Number.isFinite(maxPx) && maxPx > 0 && width <= maxPx;
+}
+/**
+ * 启动设置弹窗移动端适配。
+ *
+ * React 每次打开设置都会重新创建 portal，因此同时监听 documentElement 的子树变更
+ * 与窗口 resize。样式使用强制规则覆盖 DSH 的固定 800px/188px 布局，但只在插件
+ * 自己标记的弹窗上生效；dispose 后完全移除标记和 style 标签。
+ */
+export function startMobileSettingsModalDom(options = {}) {
+    const dom = options.document ?? (typeof document === 'undefined' ? undefined : document);
+    const win = options.window ?? (typeof window === 'undefined' ? undefined : window);
+    const Observer = options.MutationObserver
+        ?? (typeof MutationObserver === 'undefined' ? undefined : MutationObserver);
+    const enabled = options.enabled ?? (() => true);
+    const maxPx = () => {
+        const value = typeof options.mobileViewportMaxPx === 'function'
+            ? options.mobileViewportMaxPx()
+            : options.mobileViewportMaxPx;
+        return value ?? MOBILE_SETTINGS_MODAL_DEFAULT_MAX_PX;
+    };
+    let disposed = false;
+    let queued = false;
+    let marked = new Set();
+    const schedule = () => {
+        if (disposed || queued)
+            return;
+        queued = true;
+        queueMicrotask(() => {
+            queued = false;
+            sync();
+        });
+    };
+    const sync = () => {
+        if (disposed || dom === undefined)
+            return;
+        const active = enabled() && isMobileSettingsViewport(readViewportWidth(win), maxPx());
+        const panels = active ? findSettingsPanels(dom) : [];
+        const next = new Set(panels);
+        for (const panel of marked) {
+            if (!next.has(panel))
+                panel.removeAttribute(MOBILE_SETTINGS_MODAL_ATTRIBUTE);
+        }
+        if (active && panels.length > 0) {
+            installStyles(dom);
+            for (const panel of panels)
+                panel.setAttribute(MOBILE_SETTINGS_MODAL_ATTRIBUTE, 'on');
+        }
+        else {
+            removeStyles(dom);
+        }
+        marked = next;
+    };
+    const observer = dom === undefined || Observer === undefined || dom.documentElement === undefined
+        ? undefined
+        : new Observer(() => schedule());
+    if (observer !== undefined && dom?.documentElement !== undefined) {
+        observer.observe(dom.documentElement, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            // 只监听宿主弹窗的稳定钩子，避免观察插件自己的标记造成循环扫描。
+            attributeFilter: ['data-shortcut-modal'],
+        });
+    }
+    const onResize = () => schedule();
+    win?.addEventListener?.('resize', onResize);
+    sync();
+    return {
+        refresh: sync,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            observer?.disconnect();
+            win?.removeEventListener?.('resize', onResize);
+            for (const panel of marked)
+                panel.removeAttribute(MOBILE_SETTINGS_MODAL_ATTRIBUTE);
+            marked = new Set();
+            removeStyles(dom);
+        },
+    };
+}
+/** 读取窗口宽度；没有浏览器窗口时返回 0，确保适配默认不生效。 */
+function readViewportWidth(win) {
+    const width = win?.innerWidth;
+    if (typeof width === 'number' && Number.isFinite(width) && width > 0)
+        return width;
+    const fallback = globalThis.innerWidth;
+    return typeof fallback === 'number' && Number.isFinite(fallback) && fallback > 0 ? fallback : 0;
+}
+function findSettingsPanels(dom) {
+    return Array.from(dom.querySelectorAll(MOBILE_SETTINGS_MODAL_SELECTOR));
+}
+function installStyles(dom) {
+    if (dom.head === undefined || dom.head === null)
+        return;
+    const existing = Array.from(dom.head.children).some((child) => (child.tagName === 'STYLE' && child.dataset.pluginCss === MOBILE_SETTINGS_MODAL_STYLE_ID));
+    if (existing)
+        return;
+    const style = dom.createElement('style');
+    style.dataset.plugin = 'codingns4dsh';
+    style.dataset.pluginCss = MOBILE_SETTINGS_MODAL_STYLE_ID;
+    style.textContent = MOBILE_SETTINGS_MODAL_STYLE_TEXT;
+    dom.head.appendChild(style);
+}
+function removeStyles(dom) {
+    if (dom?.head === undefined || dom.head === null)
+        return;
+    for (const child of Array.from(dom.head.children)) {
+        if (child.tagName !== 'STYLE')
+            continue;
+        if (child.dataset.pluginCss !== MOBILE_SETTINGS_MODAL_STYLE_ID)
+            continue;
+        child.remove();
+    }
+}
+/**
+ * 只依赖设置根节点的语义结构，不依赖 DSH 的 CSS module 哈希类名。
+ * `nav` 第一列保留按钮和图标，文字使用视觉隐藏保留可访问名称；右侧内容列
+ * 继续由 DSH 自己的 flex 规则伸展到剩余空间。
+ */
+const MOBILE_SETTINGS_MODAL_STYLE_TEXT = [
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]{box-sizing:border-box!important;width:100vw!important;max-width:none!important;height:100%!important;max-height:none!important;border-radius:0!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>nav{box-sizing:border-box!important;flex:0 0 60px!important;width:60px!important;min-width:60px!important;gap:12px!important;padding:16px 8px 0!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>nav>:first-child{box-sizing:border-box!important;width:44px!important;height:24px!important;padding:0!important;overflow:hidden!important;font-size:0!important;line-height:0!important;text-indent:-9999px!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>nav>:last-child{box-sizing:border-box!important;align-items:center!important;gap:4px!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>nav>:last-child>button{box-sizing:border-box!important;justify-content:center!important;width:44px!important;height:44px!important;padding:9px!important;gap:0!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>nav>:last-child>button>span{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>div{box-sizing:border-box!important;min-width:0!important;flex:1 1 auto!important;width:auto!important}`,
+    `[${MOBILE_SETTINGS_MODAL_ATTRIBUTE}="on"]>div>div:last-child{box-sizing:border-box!important;min-width:0!important;width:100%!important;padding-left:8px!important;padding-right:8px!important}`,
+].join('');
+//# sourceMappingURL=mobile-settings-modal-dom.js.map

package/data/build/dist/client/mobile-settings-modal-dom.js.map

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

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

@@ -0,0 +1,97 @@
+/**
+ * 移动端侧栏手势控制器。
+ *
+ * 判定逻辑抽成纯函数 `detectSidebarGesture`，控制器只负责采样与调用服务：
+ * 左栏走 `ctx.layout.toggleSidebar()`，右栏走 `ctx.sidebarRight.toggleExpanded()`。
+ * 这里不修改任何 DOM class 或 DSH store，因此侧栏宽度、动画与持久化仍由 DSH 自己维护。
+ *
+ * 与系统手势的关系：屏幕边缘热区默认让给系统返回手势（`avoid` 模式），手势在
+ * 方向锁定失败时立即释放，不 intercept 滚动。
+ */
+export type SidebarGestureAction = 'left' | 'right' | 'ignore';
+export interface TouchSample {
+    readonly x: number;
+    readonly y: number;
+    readonly t: number;
+}
+export interface SidebarGestureConfig {
+    /** 触发阈值（像素）。 */
+    readonly thresholdPx: number;
+    /** 起手区域：`avoid` 避开系统边缘热区。 */
+    readonly edgeMode: 'avoid' | 'edge';
+    /** 方向映射：`swipe-inward` 为右滑开合左栏、左滑开合右栏；`swap` 互换。 */
+    readonly mapping: 'swipe-inward' | 'swap';
+    /** 当前视口宽度；用于判断右侧热区。 */
+    readonly viewportWidth: number;
+    /** 边缘热区宽度，默认 24px。 */
+    readonly edgeZonePx?: number;
+    /** 方向锁定比（水平位移至少是垂直位移的多少倍），默认 1.5。 */
+    readonly directionRatio?: number;
+}
+export interface SidebarGestureDecision {
+    readonly action: SidebarGestureAction;
+    /** 稳定原因码，用于诊断与测试断言。 */
+    readonly reason: 'ok' | 'samples' | 'config' | 'edge' | 'threshold' | 'direction';
+}
+export declare const DEFAULT_GESTURE_EDGE_ZONE_PX = 24;
+export declare const DEFAULT_GESTURE_DIRECTION_RATIO = 1.5;
+/** 与 DSH 窄屏断点保持一致；超过该宽度不安装全局触摸监听。 */
+export declare const DEFAULT_MOBILE_GESTURE_VIEWPORT_MAX_PX = 1024;
+/** 纯函数：只依据样本与配置给出动作，不读 DOM、不调服务。 */
+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;
+}
+export interface SidebarGesturePorts {
+    /** `ctx.layout`：只用到左栏开合。 */
+    readonly layout?: {
+        toggleSidebar(): void;
+    } | undefined;
+    /** `ctx.sidebarRight`：右栏开合与状态。 */
+    readonly sidebarRight?: {
+        isExpanded(): boolean;
+        toggleExpanded(): void;
+    } | undefined;
+}
+export interface SidebarGestureWindowLike {
+    addEventListener(type: string, listener: (event: never) => void, options?: unknown): void;
+    removeEventListener(type: string, listener: (event: never) => void, options?: unknown): void;
+    history?: {
+        pushState(data: unknown, title: string): void;
+    } | undefined;
+    innerWidth?: number | undefined;
+    navigator?: {
+        maxTouchPoints?: number | undefined;
+    } | undefined;
+    ontouchstart?: unknown;
+}
+export interface SidebarGestureDocumentLike {
+    addEventListener(type: string, listener: (event: never) => void, options?: unknown): void;
+    removeEventListener(type: string, listener: (event: never) => void, options?: unknown): void;
+}
+export interface MobileSidebarGestureOptions {
+    readonly ports: SidebarGesturePorts;
+    readonly settings: () => SidebarGestureSettings;
+    /** 读取左栏折叠状态（来自 `data-sidebar-collapsed` 等 DOM 钩子）；缺失时使用内部兜底状态。 */
+    readonly readLeftCollapsed?: (() => boolean | undefined) | undefined;
+    readonly onDiagnostic?: ((code: string) => void) | undefined;
+    /** 手势成功后的可选触感反馈；缺省使用浏览器 navigator.vibrate。 */
+    readonly vibrate?: ((pattern: number) => boolean | void) | undefined;
+    readonly window?: SidebarGestureWindowLike | undefined;
+    readonly document?: SidebarGestureDocumentLike | undefined;
+    /** 移动端视口上限；缺省与 DSH 窄屏断点一致。 */
+    readonly viewportMaxPx?: number | undefined;
+}
+export interface MobileSidebarGestureController {
+    dispose(): void;
+    /** 设置变化后重新评估是否需要监听；返回当前是否处于激活状态。 */
+    refresh(): boolean;
+}
+export declare const GESTURE_DIAGNOSTIC_CAPABILITY_MISSING = "CODINGNS_GESTURE_CAPABILITY_MISSING";
+export declare const GESTURE_DIAGNOSTIC_NOT_MOBILE = "CODINGNS_GESTURE_NOT_MOBILE";
+/** 启动手势控制器；未启用或没有任何可用端口时不注册任何监听。 */
+export declare function startMobileSidebarGestures(options: MobileSidebarGestureOptions): MobileSidebarGestureController;
+//# sourceMappingURL=mobile-sidebar-gestures.d.ts.map

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

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