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

package/data/build/dist/client/peer-host-workspace-tag.js

@@ -0,0 +1,207 @@
+import { createVirtualWorkspaceId, parseVirtualWorkspaceId } from '../shared/contracts/peer-host.js';
+import { resolvePeerHostColor } from './peer-host-color.js';
+/**
+ * 在工作区名称后注入彩色 Host 标签。
+ *
+ * DSH 的工作区行（`ProjectRowItem`）内部没有任何插槽，标题是纯文本，因此只能走
+ * DOM 注入——这也是仓库里 `workspace-session-archive-dom` 已经在用的做法。注入点
+ * 必须是 `projectText` 容器内、`title` 之后的兄弟节点：`title` 带
+ * `overflow:hidden` + `text-overflow:ellipsis`，插进它内部会被直接裁掉。
+ *
+ * 标签是纯展示：`pointer-events:none` + `aria-hidden`，避免抢走行的点击，也避免
+ * 被移动端横滑手势的 `preventDefault` 吞掉。
+ */
+export const PEER_HOST_WORKSPACE_TAG_ATTRIBUTE = 'data-codingns-peer-host-tag';
+/** 工作区行：DSH 只给工作区行加 `aria-expanded`，会话行只有 `aria-selected`。 */
+const WORKSPACE_ROW_SELECTOR = '[role="treeitem"][aria-expanded]';
+/** 标签需要插入的标题容器；找不到时跳过该行，不做兜底猜测。 */
+const TITLE_CONTAINER_SELECTOR = '[class*="_projectText"]';
+/**
+ * Host 标签的最大宽度（像素）。
+ *
+ * Host 名与工作区名在同一行竞争空间：不给标签设上限时，长 Host 名会把工作区名压到
+ * 几乎不可读。超过上限的部分由 `text-overflow: ellipsis` 截断。
+ */
+export const PEER_HOST_TAG_MAX_WIDTH_PX = 50;
+/**
+ * 启动工作区 Host 标签注入。
+ *
+ * 只有远端（`targetHostId !== null`）工作区才加标签：本机工作区不需要用颜色区分
+ * 自己，给每个本地工作区都加一个标签只会制造噪音。
+ */
+export function startPeerHostWorkspaceTag(options = {}) {
+    const dom = options.document ?? (typeof document === 'undefined' ? undefined : document);
+    if (dom === undefined)
+        return { setAggregate() { }, dispose() { } };
+    const Observer = options.MutationObserver
+        ?? (typeof MutationObserver === 'undefined' ? undefined : MutationObserver);
+    let disposed = false;
+    let scanQueued = false;
+    /** 虚拟工作区 ID -> 标签样式；聚合变化时整体替换。 */
+    let tags = new Map();
+    const scan = () => {
+        if (disposed)
+            return;
+        for (const row of dom.querySelectorAll(WORKSPACE_ROW_SELECTOR)) {
+            const virtualWorkspaceId = resolveWorkspaceIdFromRow(row);
+            const tag = virtualWorkspaceId === undefined ? undefined : tags.get(virtualWorkspaceId);
+            if (tag === undefined || virtualWorkspaceId === undefined) {
+                row.querySelector(`[${PEER_HOST_WORKSPACE_TAG_ATTRIBUTE}]`)?.remove();
+                continue;
+            }
+            upsertTag(row, virtualWorkspaceId, tag, dom);
+        }
+        // 聚合里已经没有的工作区标签可能在折叠/重建过程中残留，统一清理一次。
+        for (const node of dom.querySelectorAll(`[${PEER_HOST_WORKSPACE_TAG_ATTRIBUTE}]`)) {
+            const workspaceId = node.dataset.codingnsPeerHostWorkspace;
+            if (workspaceId === undefined || !tags.has(workspaceId))
+                node.remove();
+        }
+    };
+    const scheduleScan = () => {
+        if (disposed || scanQueued)
+            return;
+        scanQueued = true;
+        queueMicrotask(() => {
+            scanQueued = false;
+            scan();
+        });
+    };
+    const observer = Observer === undefined ? undefined : new Observer(scheduleScan);
+    if (observer !== undefined && dom.documentElement !== null) {
+        observer.observe(dom.documentElement, { childList: true, subtree: true, attributes: true, attributeFilter: ['aria-expanded'] });
+    }
+    scan();
+    return {
+        setAggregate(results) {
+            if (disposed)
+                return;
+            const next = new Map();
+            for (const host of results) {
+                if (host.targetHostId === null)
+                    continue;
+                const color = resolvePeerHostColor(host.hostColor, host.hostLabel);
+                for (const workspace of host.workspaces) {
+                    // 键必须是原生列表真正持有的虚拟 ID，否则 data-row-key 反查永远落空。
+                    next.set(createVirtualWorkspaceId(host.targetHostId, workspace.workspaceId), { label: host.hostLabel, color });
+                }
+            }
+            tags = next;
+            scheduleScan();
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            observer?.disconnect();
+            dom.querySelectorAll(`[${PEER_HOST_WORKSPACE_TAG_ATTRIBUTE}]`).forEach((node) => node.remove());
+        },
+    };
+}
+/**
+ * 从工作区行反查虚拟工作区 ID。
+ *
+ * `data-row-key="workspace:<id>"` 是稳定且零成本的路径；React fiber 只作为兜底，
+ * 因为爬 fiber 在长列表下开销明显。
+ */
+export function resolveWorkspaceIdFromRow(row) {
+    const rowKey = row.getAttribute('data-row-key');
+    if (rowKey !== null && rowKey.startsWith('workspace:')) {
+        const value = rowKey.slice('workspace:'.length).trim();
+        if (value !== '')
+            return value;
+    }
+    return readWorkspaceIdFromFiber(row);
+}
+function readWorkspaceIdFromFiber(row) {
+    const fiberKey = Object.getOwnPropertyNames(row).find((key) => key.startsWith('__reactFiber$'));
+    if (fiberKey === undefined)
+        return undefined;
+    let current = row[fiberKey];
+    for (let depth = 0; depth < 24 && isRecord(current); depth += 1) {
+        for (const props of [current.memoizedProps, current.pendingProps]) {
+            const found = readWorkspaceIdFromProps(props);
+            if (found !== undefined)
+                return found;
+        }
+        current = current.return;
+    }
+    return undefined;
+}
+function readWorkspaceIdFromProps(value) {
+    if (!isRecord(value))
+        return undefined;
+    for (const key of ['workspaceId', 'workspaceID']) {
+        const candidate = value[key];
+        if (typeof candidate === 'string' && candidate.trim() !== '')
+            return candidate.trim();
+    }
+    for (const key of ['workspace', 'group', 'row', 'item', 'value', 'data']) {
+        const nested = value[key];
+        if (!isRecord(nested))
+            continue;
+        const candidate = nested.workspaceId ?? nested.id;
+        if (typeof candidate === 'string' && candidate.trim() !== '')
+            return candidate.trim();
+    }
+    return undefined;
+}
+/**
+ * 注入或更新标签；内容与配色都没变时不碰 DOM，避免触发无意义的 MutationObserver 回调。
+ *
+ * 标签必须作为 `projectText` 的**兄弟节点**插进行内：`projectText` 是
+ * `flex-direction: column` 的容器，把标签 append 进去会让它掉到工作区名称的第二行
+ * （用户实测到的"挤压"）。行本身是 `display:flex; align-items:center`，插成兄弟后
+ * 标签与名称同行；`projectText` 带 `flex:1`，标签又是 `flex:none`，因此标签稳定停在
+ * 列表最右侧，名称过长时由原生 `text-overflow:ellipsis` 截断，而不是把标签挤走。
+ */
+function upsertTag(row, virtualWorkspaceId, tag, dom) {
+    const existing = row.querySelector(`[${PEER_HOST_WORKSPACE_TAG_ATTRIBUTE}]`);
+    if (existing !== null
+        && existing.textContent === tag.label
+        && existing.dataset.codingnsPeerHostColor === tag.color
+        && existing.dataset.codingnsPeerHostWorkspace === virtualWorkspaceId)
+        return;
+    const container = row.querySelector(TITLE_CONTAINER_SELECTOR);
+    const host = container?.parentElement ?? null;
+    if (container === null || host === null)
+        return;
+    existing?.remove();
+    const element = dom.createElement('span');
+    element.setAttribute(PEER_HOST_WORKSPACE_TAG_ATTRIBUTE, '');
+    element.setAttribute('aria-hidden', 'true');
+    element.dataset.codingnsPeerHostColor = tag.color;
+    element.dataset.codingnsPeerHostWorkspace = virtualWorkspaceId;
+    element.textContent = tag.label;
+    Object.assign(element.style, {
+        // flex:none + margin-left:auto：标签不被压缩，并稳定贴住行尾。
+        flex: 'none',
+        marginLeft: 'auto',
+        alignSelf: 'center',
+        // Host 名与工作区名冲突时截断 Host 名；上限 50px（含内边距），超出显示省略号。
+        boxSizing: 'border-box',
+        maxWidth: `${PEER_HOST_TAG_MAX_WIDTH_PX}px`,
+        overflow: 'hidden',
+        textOverflow: 'ellipsis',
+        whiteSpace: 'nowrap',
+        padding: '1px 6px',
+        borderRadius: '999px',
+        fontSize: '10px',
+        lineHeight: '1.5',
+        pointerEvents: 'none',
+        color: tag.color,
+        background: `color-mix(in srgb, ${tag.color} 16%, transparent)`,
+    });
+    // 插为行的最后一个子节点：`rowActions` 只在 hover 时显示（`display:none` 不占位），
+    // 放在它之前会让标签在 hover 时被操作按钮向左顶开；放最后才能稳定贴住最右侧。
+    host.append(element);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** 判断某个虚拟工作区 ID 是否属于远端；供投影与测试复用。 */
+export function isRemoteVirtualWorkspace(virtualWorkspaceId) {
+    const parsed = parseVirtualWorkspaceId(virtualWorkspaceId);
+    return parsed !== null && parsed.targetHostId !== null;
+}
+//# sourceMappingURL=peer-host-workspace-tag.js.map

package/data/build/dist/client/peer-host-workspace-tag.js.map

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

package/data/build/dist/client/popup-dismiss.d.ts

@@ -0,0 +1,48 @@
+import type { RefObject } from 'react';
+/**
+ * 弹层关闭的统一入口。
+ *
+ * 此前插件里的菜单与浮层各自实现关闭逻辑：`<details>/<summary>` 原生折叠、
+ * React `useState` 菜单完全没有外部监听、DOM 菜单用捕获阶段 `click`，
+ * 结果就是「只有再次点击触发按钮才会关闭」。这里收敛成一套通用能力：
+ * 弹层打开期间监听 `pointerdown`，命中弹层根节点之外即关闭。
+ *
+ * 选择 `pointerdown` 而不是 `click`：与 DSH 原生
+ * `useDismissOnOutsidePointer` 保持一致，且在弹层内部按下并拖拽出去时不会误关。
+ */
+/** 弹层根节点：React ref 或已解析的 DOM 元素都支持。 */
+export type DismissRoot = RefObject<HTMLElement | null> | HTMLElement | null | undefined;
+export interface OutsideDismissOptions {
+    /** 通过 Portal 渲染到根节点之外的浮层，命中它同样算「内部」。 */
+    readonly portal?: DismissRoot;
+    /** 是否同时支持 Esc 关闭，默认 true。 */
+    readonly escape?: boolean;
+}
+export interface AttachOutsideDismissalOptions {
+    /** 是否同时支持 Esc 关闭，默认 true。 */
+    readonly escape?: boolean;
+    /** 是否在捕获阶段监听，默认 true，避免被弹层内部处理器 stopPropagation 吞掉。 */
+    readonly capture?: boolean;
+}
+/** 事件目标是否落在全部弹层根节点之外；非 DOM 目标一律按外部处理。 */
+export declare function isOutsideDismissRoots(target: unknown, roots: readonly DismissRoot[]): boolean;
+/**
+ * 命令式版本：给纯 DOM 代码（账户菜单、文件树右键菜单）挂载外部点击关闭。
+ * @returns 取消监听的清理函数。
+ */
+export declare function attachOutsideDismissal(doc: Document, roots: () => readonly DismissRoot[], close: () => void, options?: AttachOutsideDismissalOptions): () => void;
+/**
+ * React 版本：弹层打开期间，根节点之外的 `pointerdown` 触发 `close`。
+ * `close` 可以传 `setOpen(false)` 或 `onClose`，内部用 ref 保持引用稳定，
+ * 因此调用方可以直接写内联箭头函数而不必担心反复重订阅。
+ */
+export declare function useDismissOnOutsidePointer(root: DismissRoot, open: boolean, close: () => void, options?: OutsideDismissOptions): void;
+/**
+ * 遮罩层版本：只有点击遮罩自身（而不是遮罩内部的弹窗面板）才关闭。
+ * 供不便使用 hook 的场景（内联渲染函数、纯 DOM 模态框）复用。
+ */
+export declare function backdropPointerDownHandler(close: () => void): (event: {
+    readonly target: unknown;
+    readonly currentTarget: unknown;
+}) => void;
+//# sourceMappingURL=popup-dismiss.d.ts.map

package/data/build/dist/client/popup-dismiss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-dismiss.d.ts","sourceRoot":"","sources":["../../../../src/client/popup-dismiss.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;;;;;;;;GAUG;AAEH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;AAExF,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAoBD,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAO7F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,MAAM,SAAS,WAAW,EAAE,EACnC,KAAK,EAAE,MAAM,IAAI,EACjB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,IAAI,CAcZ;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,IAAI,EACjB,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,IAAI,GAChB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAEhF"}

package/data/build/dist/client/popup-dismiss.js

@@ -0,0 +1,93 @@
+import { useEffect, useRef } from 'react';
+/** 解析 ref 或裸元素；ref 尚未挂载时返回 null。 */
+function resolveRoot(root) {
+    if (root === null || root === undefined)
+        return null;
+    const current = root.current;
+    if (current !== undefined)
+        return current;
+    return root;
+}
+/**
+ * 事件目标是否像 DOM 节点。H5/测试环境可能没有全局 `Node`，
+ * 此时退化为结构判断，避免因为缺少构造器而全部当作外部点击。
+ */
+function isNodeLike(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (typeof Node !== 'undefined')
+        return value instanceof Node;
+    return typeof value.nodeType === 'number';
+}
+/** 事件目标是否落在全部弹层根节点之外；非 DOM 目标一律按外部处理。 */
+export function isOutsideDismissRoots(target, roots) {
+    if (!isNodeLike(target))
+        return true;
+    for (const root of roots) {
+        const element = resolveRoot(root);
+        if (element !== null && element.contains(target))
+            return false;
+    }
+    return true;
+}
+/**
+ * 命令式版本：给纯 DOM 代码（账户菜单、文件树右键菜单）挂载外部点击关闭。
+ * @returns 取消监听的清理函数。
+ */
+export function attachOutsideDismissal(doc, roots, close, options = {}) {
+    const capture = options.capture ?? true;
+    const onPointerDown = (event) => {
+        if (isOutsideDismissRoots(event.target, roots()))
+            close();
+    };
+    doc.addEventListener('pointerdown', onPointerDown, capture);
+    const onKeyDown = options.escape === false
+        ? undefined
+        : (event) => { if (event.key === 'Escape')
+            close(); };
+    if (onKeyDown !== undefined)
+        doc.addEventListener('keydown', onKeyDown, capture);
+    return () => {
+        doc.removeEventListener('pointerdown', onPointerDown, capture);
+        if (onKeyDown !== undefined)
+            doc.removeEventListener('keydown', onKeyDown, capture);
+    };
+}
+/**
+ * React 版本：弹层打开期间，根节点之外的 `pointerdown` 触发 `close`。
+ * `close` 可以传 `setOpen(false)` 或 `onClose`，内部用 ref 保持引用稳定，
+ * 因此调用方可以直接写内联箭头函数而不必担心反复重订阅。
+ */
+export function useDismissOnOutsidePointer(root, open, close, options = {}) {
+    const closeRef = useRef(close);
+    useEffect(() => { closeRef.current = close; }, [close]);
+    const portal = options.portal;
+    const escape = options.escape ?? true;
+    useEffect(() => {
+        if (!open || typeof document === 'undefined')
+            return;
+        const onPointerDown = (event) => {
+            if (isOutsideDismissRoots(event.target, [root, portal]))
+                closeRef.current();
+        };
+        document.addEventListener('pointerdown', onPointerDown);
+        return () => document.removeEventListener('pointerdown', onPointerDown);
+    }, [open, root, portal]);
+    useEffect(() => {
+        if (!open || !escape || typeof document === 'undefined')
+            return;
+        const onKeyDown = (event) => { if (event.key === 'Escape')
+            closeRef.current(); };
+        document.addEventListener('keydown', onKeyDown);
+        return () => document.removeEventListener('keydown', onKeyDown);
+    }, [open, escape]);
+}
+/**
+ * 遮罩层版本：只有点击遮罩自身（而不是遮罩内部的弹窗面板）才关闭。
+ * 供不便使用 hook 的场景（内联渲染函数、纯 DOM 模态框）复用。
+ */
+export function backdropPointerDownHandler(close) {
+    return (event) => { if (event.target === event.currentTarget)
+        close(); };
+}
+//# sourceMappingURL=popup-dismiss.js.map

package/data/build/dist/client/popup-dismiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-dismiss.js","sourceRoot":"","sources":["../../../../src/client/popup-dismiss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAgCzC,oCAAoC;AACpC,SAAS,WAAW,CAAC,IAAiB;IACpC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACpD,MAAM,OAAO,GAAI,IAAkC,CAAC,OAAO,CAAA;IAC3D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IACzC,OAAO,IAAe,CAAA;AACxB,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,IAAI,OAAO,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,YAAY,IAAI,CAAA;IAC7D,OAAO,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,CAAA;AACvE,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,KAA6B;IAClF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAA;IAChE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAa,EACb,KAAmC,EACnC,KAAiB,EACjB,UAAyC,EAAE;IAE3C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAA;IACvC,MAAM,aAAa,GAAG,CAAC,KAAY,EAAQ,EAAE;QAC3C,IAAI,qBAAqB,CAAE,KAA8B,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YAAE,KAAK,EAAE,CAAA;IACrF,CAAC,CAAA;IACD,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK;QACxC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,KAAoB,EAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;YAAE,KAAK,EAAE,CAAA,CAAC,CAAC,CAAA;IAC3E,IAAI,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAChF,OAAO,GAAG,EAAE;QACV,GAAG,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;QAC9D,IAAI,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IACrF,CAAC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAiB,EACjB,IAAa,EACb,KAAiB,EACjB,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,SAAS,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAA,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAA;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAM;QACpD,MAAM,aAAa,GAAG,CAAC,KAAY,EAAQ,EAAE;YAC3C,IAAI,qBAAqB,CAAE,KAA8B,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAAE,QAAQ,CAAC,OAAO,EAAE,CAAA;QACvG,CAAC,CAAA;QACD,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;QACvD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;IACzE,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAExB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAM;QAC/D,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;YAAE,QAAQ,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,CAAA;QACpG,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC/C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IACjE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAiB;IAEjB,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa;QAAE,KAAK,EAAE,CAAA,CAAC,CAAC,CAAA;AACzE,CAAC"}

package/data/build/dist/client/provider-icon-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-icon-assets.d.ts","sourceRoot":"","sources":["../../../../src/client/provider-icon-assets.ts"],"names":[],"mappings":""}

package/data/build/dist/client/provider-icon-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-icon-assets.js","sourceRoot":"","sources":["../../../../src/client/provider-icon-assets.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,6CAA6C,CAAA;AACxE,OAAO,SAAS,MAAM,uCAAuC,CAAA;AAC7D,OAAO,eAAe,MAAM,8CAA8C,CAAA;AAC1E,OAAO,mBAAmB,MAAM,kDAAkD,CAAA;AAClF,OAAO,UAAU,MAAM,wCAAwC,CAAA;AAC/D,OAAO,QAAQ,MAAM,sCAAsC,CAAA;AAC3D,OAAO,QAAQ,MAAM,sCAAsC,CAAA;AAC3D,OAAO,YAAY,MAAM,0CAA0C,CAAA;AACnE,OAAO,MAAM,MAAM,oCAAoC,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,4CAA4C;AAC5C,oBAAoB,CAAC;IACnB,GAAG,EAAE,mBAAmB;IACxB,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,UAAU;IAClB,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,QAAQ;CACf,CAAC,CAAA"}

package/data/build/dist/client/provider-icons.d.ts

@@ -2,12 +2,21 @@ export interface ProviderVisual {
     readonly adapterId: string | null;
     readonly displayName: string;
     readonly iconUrl: string | undefined;
+    readonly color: string;
 }
 interface ProviderDefinition {
     readonly adapterId: string;
     readonly displayName: string;
+    readonly color: string;
 }
-/** 外部 Agent 标识与显示名称的唯一映射。浏览器入口另行安装内联资产。 */
+/** 未绑定和未知 Agent 使用中性灰，绝不冒充任一已知品牌色。 */
+export declare const PROVIDER_NEUTRAL_COLOR = "#71717a";
+/**
+ * 外部 Agent 标识、显示名称与标签颜色的唯一映射。浏览器入口另行安装内联资产。
+ *
+ * 标签颜色用于会话行/归档列表的彩色标识：优先贴近本地图标或品牌色，
+ * 并保持在浅色与深色主题下都可读的中等明度区间。
+ */
 declare const PROVIDER_DEFINITIONS: Readonly<Record<string, ProviderDefinition>>;
 declare const PROVIDER_ICONS: Record<string, string>;
 /** 只由浏览器入口调用，使普通 Node 测试不需要加载 png/svg。 */

package/data/build/dist/client/provider-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-icons.d.ts","sourceRoot":"","sources":["../../../../src/client/provider-icons.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAUtE,CAAA;AAED,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAA;AAEjD,0CAA0C;AAC1C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAMlF;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAS5E;AAED,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAA"}

package/data/build/dist/client/provider-icons.js

@@ -1,14 +1,21 @@
-/** 外部 Agent 标识与显示名称的唯一映射。浏览器入口另行安装内联资产。 */
+/** 未绑定和未知 Agent 使用中性灰，绝不冒充任一已知品牌色。 */
+export const PROVIDER_NEUTRAL_COLOR = '#71717a';
+/**
+ * 外部 Agent 标识、显示名称与标签颜色的唯一映射。浏览器入口另行安装内联资产。
+ *
+ * 标签颜色用于会话行/归档列表的彩色标识：优先贴近本地图标或品牌色，
+ * 并保持在浅色与深色主题下都可读的中等明度区间。
+ */
 const PROVIDER_DEFINITIONS = {
-    dsh: { adapterId: 'dsh', displayName: 'DeepSeek Harness' },
-    'command-code': { adapterId: 'command-code', displayName: 'Command Code' },
-    'claude-code': { adapterId: 'claude-code', displayName: 'Claude Code' },
-    kimi: { adapterId: 'kimi', displayName: 'Kimi' },
-    gemini: { adapterId: 'gemini', displayName: 'Gemini CLI' },
-    pi: { adapterId: 'pi', displayName: 'Pi' },
-    codex: { adapterId: 'codex', displayName: 'Codex' },
-    opencode: { adapterId: 'opencode', displayName: 'OpenCode' },
-    grok: { adapterId: 'grok', displayName: 'Grok' },
+    dsh: { adapterId: 'dsh', displayName: 'DeepSeek Harness', color: '#2563eb' },
+    'command-code': { adapterId: 'command-code', displayName: 'Command Code', color: '#8b5cf6' },
+    'claude-code': { adapterId: 'claude-code', displayName: 'Claude Code', color: '#d97757' },
+    kimi: { adapterId: 'kimi', displayName: 'Kimi', color: '#0ea5e9' },
+    gemini: { adapterId: 'gemini', displayName: 'Gemini CLI', color: '#4285f4' },
+    pi: { adapterId: 'pi', displayName: 'Pi', color: '#f59e0b' },
+    codex: { adapterId: 'codex', displayName: 'Codex', color: '#10a37f' },
+    opencode: { adapterId: 'opencode', displayName: 'OpenCode', color: '#14b8a6' },
+    grok: { adapterId: 'grok', displayName: 'Grok', color: '#71717a' },
 };
 const PROVIDER_ICONS = {};
 /** 只由浏览器入口调用，使普通 Node 测试不需要加载 png/svg。 */
@@ -27,11 +34,11 @@ export function providerIconUrl(adapterId) {
 /** 未绑定和未知值都返回中性占位，绝不冒充任一已知品牌。 */
 export function providerVisual(adapterId) {
     if (adapterId === undefined || adapterId.trim() === '') {
-        return { adapterId: null, displayName: '未绑定 Agent', iconUrl: undefined };
+        return { adapterId: null, displayName: '未绑定 Agent', iconUrl: undefined, color: PROVIDER_NEUTRAL_COLOR };
     }
     const definition = PROVIDER_DEFINITIONS[adapterId];
     if (definition === undefined) {
-        return { adapterId, displayName: `未知 Agent（${adapterId}）`, iconUrl: undefined };
+        return { adapterId, displayName: `未知 Agent（${adapterId}）`, iconUrl: undefined, color: PROVIDER_NEUTRAL_COLOR };
     }
     return { ...definition, iconUrl: PROVIDER_ICONS[adapterId] };
 }

package/data/build/dist/client/provider-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-icons.js","sourceRoot":"","sources":["../../../../src/client/provider-icons.ts"],"names":[],"mappings":"AAaA,sCAAsC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,oBAAoB,GAAiD;IACzE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5E,cAAc,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5F,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE;IACzF,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;IAClE,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5E,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5D,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;IACrE,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9E,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;CACnE,CAAA;AAED,MAAM,cAAc,GAA2B,EAAE,CAAA;AAEjD,0CAA0C;AAC1C,MAAM,UAAU,oBAAoB,CAAC,KAAuC;IAC1E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;IACrF,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAA;QAChC,IAAI,OAAO,KAAK,SAAS;YAAE,cAAc,CAAC,SAAS,CAAC,GAAG,OAAO,CAAA;IAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,cAAc,CAAC,SAA6B;IAC1D,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAA;IACzG,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;IAClD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,SAAS,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAA;IAChH,CAAC;IACD,OAAO,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,CAAA;AAC9D,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAA"}

package/data/build/dist/client/pwa-install-prompt.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 安装引导条。
+ *
+ * 页面早期注入的脚本已经捕获了 `beforeinstallprompt`（并暂停默认横幅），这里只
+ * 负责展示与交互：
+ * - Android/Chromium：显示“安装”按钮，点击后调用捕获到的事件；
+ * - iOS：没有安装 API，展示“分享 → 添加到主屏幕”指引；
+ * - 已安装（standalone）、回环入口、或用户关闭过 → 不显示。
+ *
+ * 样式内联并带 `env(safe-area-inset-bottom)`，避免被 Home 指示条遮住。
+ */
+export interface PwaInstallSnapshot {
+    readonly loopback?: boolean;
+    readonly installed?: boolean;
+    readonly marker?: boolean;
+    readonly installPromptAvailable?: boolean;
+    readonly sw?: string;
+}
+export interface PwaInstallPromptWindowLike {
+    addEventListener(type: string, listener: (event: never) => void): void;
+    removeEventListener(type: string, listener: (event: never) => void): void;
+    matchMedia?: ((query: string) => {
+        matches: boolean;
+    }) | undefined;
+    localStorage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+    } | undefined;
+    navigator?: {
+        userAgent?: string;
+        platform?: string;
+        maxTouchPoints?: number;
+    } | undefined;
+    __CODINGNS_PWA__?: PwaInstallSnapshot | undefined;
+    __CODINGNS_PWA_PROMPT__?: (() => Promise<string>) | undefined;
+}
+export interface PwaInstallPromptDocumentLike {
+    body?: {
+        appendChild(node: unknown): void;
+        removeChild(node: unknown): void;
+    } | undefined;
+    createElement(tag: string): PwaInstallPromptElementLike;
+}
+export interface PwaInstallPromptElementLike {
+    style: Record<string, string>;
+    textContent?: string | null;
+    appendChild(node: unknown): void;
+    removeChild(node: unknown): void;
+    addEventListener(type: string, listener: () => void): void;
+    remove(): void;
+}
+export interface PwaInstallPromptOptions {
+    readonly window?: PwaInstallPromptWindowLike | undefined;
+    readonly document?: PwaInstallPromptDocumentLike | undefined;
+    /** 文案；缺省使用中文。 */
+    readonly text?: {
+        readonly install: string;
+        readonly hint: string;
+        readonly dismiss: string;
+        readonly iosHint: string;
+    } | undefined;
+    /** 用户点击“安装”后的回调（用于写入本地诊断/埋点）。 */
+    readonly onOutcome?: ((outcome: string) => void) | undefined;
+}
+export interface PwaInstallPromptController {
+    dispose(): void;
+    /** 重新评估是否展示；返回当前是否展示。 */
+    refresh(): boolean;
+}
+export declare const PWA_INSTALL_DISMISS_KEY = "codingns4dsh.pwa.installPromptDismissed";
+/** 启动安装引导条；不满足条件时不创建任何节点。 */
+export declare function startPwaInstallPrompt(options?: PwaInstallPromptOptions): PwaInstallPromptController;
+//# sourceMappingURL=pwa-install-prompt.d.ts.map

package/data/build/dist/client/pwa-install-prompt.d.ts.map

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