botmux 3.14.0 → 3.16.0

package/dist/dashboard/web/agent-workbench-appearance-menu.js

@@ -0,0 +1,195 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * 「外观」面板：4 套配色 + 明暗模式 + 终端渲染风格，桌面是 `⋯` 菜单里的下拉浮层，
+ * 移动端是同一块内容的底部 sheet。两处（以及终端标题栏那枚分段控件）共用
+ * `workbenchAppearance` 一个状态源，任一处改动其余立刻跟着变。
+ *
+ * `⋯` 菜单同时是 owner「自取常驻链接」的入口（{@link WorkbenchStandingLinkPanel}）：
+ * 同一个菜单、同一族浮层样式，移动端则挂在同一块底部 sheet 里，所以 owner 在手机
+ * 浏览器里也能把工作台收进书签。这一项**只对本机完整管理身份渲染**（调用方传
+ * `standingLink`，取自 Dashboard 既有的 `ui.authed`）——服务端那条端点对其它身份
+ * 一律 401/404，画出来只会是个点了必然失败的按钮。
+ */
+import { useCallback, useEffect, useRef, useState, useSyncExternalStore, } from 'react';
+import { t, ui } from './ui.js';
+import { copyText } from './clipboard.js';
+import { createWorkbenchApi } from './agent-workbench-api.js';
+import { WORKBENCH_SKIN_IDS, WORKBENCH_SKIN_PREVIEWS, selectWorkbenchMode, selectWorkbenchSkin, selectWorkbenchTermStyle, workbenchAppearance, } from './agent-workbench-appearance.js';
+const SKIN_LABEL_KEY = {
+    ink: 'workbench.appearance.skin.ink',
+    'slate-blue': 'workbench.appearance.skin.slateBlue',
+    'warm-graphite': 'workbench.appearance.skin.warmGraphite',
+    'light-frost': 'workbench.appearance.skin.lightFrost',
+};
+const MODE_OPTIONS = [
+    { value: 'system', labelKey: 'workbench.appearance.mode.system' },
+    { value: 'light', labelKey: 'workbench.appearance.mode.light' },
+    { value: 'dark', labelKey: 'workbench.appearance.mode.dark' },
+];
+const TERM_OPTIONS = [
+    { value: 'reader', labelKey: 'workbench.appearance.term.reader' },
+    { value: 'classic', labelKey: 'workbench.appearance.term.classic' },
+];
+/** 调用方没传 api 时的兜底客户端。只建一次：每次渲染新建会让面板的 useEffect
+ *  依赖每帧变化，进而每帧重取一次链接。 */
+let fallbackWorkbenchApi = null;
+function defaultWorkbenchApi() {
+    return (fallbackWorkbenchApi ??= createWorkbenchApi());
+}
+function subscribe(listener) {
+    return workbenchAppearance.subscribe(listener);
+}
+function snapshot() {
+    return workbenchAppearance.getSnapshot();
+}
+/** 读当前外观。store 缓存快照对象，未变化时引用不变，不会引起额外重渲染。 */
+export function useWorkbenchAppearance() {
+    return useSyncExternalStore(subscribe, snapshot, snapshot);
+}
+/**
+ * 工作台表面（完整工作台 / 会话坞）挂载期间把外观落到文档根上，离开时原样还回去 ——
+ * 这 4 套配色是工作台的局部调色板，不该在 Dashboard 其它页面继续生效。
+ */
+export function useWorkbenchAppearanceRoot() {
+    useEffect(() => workbenchAppearance.mount(), []);
+    // 全站明暗仲裁（ui.ts）改完 data-theme 就发一次事件，工作台在场时把自己的解析
+    // 结果盖回去。两套机制各自独立、互不订阅，只在这一个落点上分先后。
+    useEffect(() => ui.on(() => workbenchAppearance.reapply()), []);
+    return useWorkbenchAppearance();
+}
+export function setWorkbenchSkin(skin) {
+    workbenchAppearance.set(selectWorkbenchSkin(workbenchAppearance.getSnapshot().appearance, skin));
+}
+export function setWorkbenchMode(mode) {
+    workbenchAppearance.set(selectWorkbenchMode(workbenchAppearance.getSnapshot().appearance, mode));
+}
+export function setWorkbenchTermStyle(termStyle) {
+    workbenchAppearance.set(selectWorkbenchTermStyle(workbenchAppearance.getSnapshot().appearance, termStyle));
+}
+/** 单选组里的左右方向键：焦点在同组的按钮之间走一圈，选项跟着改。 */
+function moveRadioFocus(event, step) {
+    const group = event.currentTarget;
+    const items = [...group.querySelectorAll('button[role="radio"]')];
+    if (items.length === 0)
+        return;
+    const active = items.indexOf(event.target);
+    const next = items[((active < 0 ? 0 : active) + step + items.length) % items.length];
+    event.preventDefault();
+    next.focus();
+    next.click();
+}
+function radioGroupKeyDown(event) {
+    if (event.key === 'ArrowRight' || event.key === 'ArrowDown')
+        moveRadioFocus(event, 1);
+    else if (event.key === 'ArrowLeft' || event.key === 'ArrowUp')
+        moveRadioFocus(event, -1);
+}
+/** 「阅读｜经典」分段控件。终端标题栏右侧和外观面板里用的是同一个组件、同一状态源。 */
+export function WorkbenchTermStyleSegment(props) {
+    return (_jsx("span", { className: "wb-seg wb-term-style-seg", role: "radiogroup", "aria-label": t('workbench.appearance.termStyleLabel'), onKeyDown: radioGroupKeyDown, children: TERM_OPTIONS.map(option => (_jsx("button", { type: "button", role: "radio", className: `wb-seg-item${props.termStyle === option.value ? ' is-on' : ''}`, "aria-checked": props.termStyle === option.value, tabIndex: props.termStyle === option.value ? 0 : -1, onClick: () => setWorkbenchTermStyle(option.value), children: t(option.labelKey) }, option.value))) }));
+}
+/** 面板正文。桌面浮层和移动 sheet 共用，只有外层容器不同。 */
+export function WorkbenchAppearanceControls() {
+    const { appearance, skin } = useWorkbenchAppearance();
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "wb-appearance-group", children: [_jsx("span", { className: "wb-appearance-group-label", id: "wb-appearance-theme-label", children: t('workbench.appearance.themeGroup') }), _jsx("span", { className: "wb-skin-swatches", role: "radiogroup", "aria-labelledby": "wb-appearance-theme-label", onKeyDown: radioGroupKeyDown, children: WORKBENCH_SKIN_IDS.map(id => {
+                            const preview = WORKBENCH_SKIN_PREVIEWS[id];
+                            const active = skin === id;
+                            return (_jsxs("button", { type: "button", role: "radio", className: `wb-skin-swatch${active ? ' is-active' : ''}`, "aria-checked": active, tabIndex: active ? 0 : -1, title: t(SKIN_LABEL_KEY[id]), onClick: () => setWorkbenchSkin(id), children: [_jsx("span", { className: "wb-skin-swatch-chip", "aria-hidden": "true", style: {
+                                            '--sw-bg': preview.bg,
+                                            '--sw-raise': preview.raise,
+                                            '--sw-accent': preview.accent,
+                                        } }), _jsx("span", { className: "wb-skin-swatch-name", children: t(SKIN_LABEL_KEY[id]) })] }, id));
+                        }) }), _jsx("span", { className: "wb-seg wb-appearance-mode-seg", role: "radiogroup", "aria-label": t('workbench.appearance.modeLabel'), onKeyDown: radioGroupKeyDown, children: MODE_OPTIONS.map(option => (_jsx("button", { type: "button", role: "radio", className: `wb-seg-item${appearance.mode === option.value ? ' is-on' : ''}`, "aria-checked": appearance.mode === option.value, tabIndex: appearance.mode === option.value ? 0 : -1, onClick: () => setWorkbenchMode(option.value), children: t(option.labelKey) }, option.value))) })] }), _jsxs("div", { className: "wb-appearance-group", children: [_jsx("span", { className: "wb-appearance-group-label", children: t('workbench.appearance.termGroup') }), _jsx(WorkbenchTermStyleSegment, { termStyle: appearance.termStyle }), _jsx("p", { className: "wb-appearance-note", children: t('workbench.appearance.termNote') })] })] }));
+}
+/**
+ * 「常驻链接」面板正文：显示完整链接（只读、聚焦即全选）、一键复制、以及一句
+ * 说明它为什么安全可用（收藏进书签长期用；怀疑泄漏时 `botmux dashboard rotate`
+ * 立刻作废）。
+ *
+ * 链接**只在这里现取**（点开才请求），拿不到就只显示一行「暂时取不到」——绝不
+ * 显示半截链接，也不区分「无权」和「服务端还没有 token」：对前端来说都是没有
+ * 这个入口。
+ */
+export function WorkbenchStandingLinkPanel(props) {
+    const [link, setLink] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [copyState, setCopyState] = useState('idle');
+    const fieldRef = useRef(null);
+    const { api } = props;
+    useEffect(() => {
+        const controller = typeof AbortController === 'function' ? new AbortController() : null;
+        let alive = true;
+        void api.getStandingLink(controller?.signal).then(result => {
+            if (!alive)
+                return;
+            setLink(result?.url ?? null);
+            setLoading(false);
+        });
+        return () => { alive = false; controller?.abort(); };
+    }, [api]);
+    const copy = props.copy ?? copyText;
+    const onCopy = async () => {
+        if (!link)
+            return;
+        setCopyState(await copy(link) ? 'copied' : 'failed');
+    };
+    return (_jsxs(_Fragment, { children: [_jsxs("header", { className: "wb-appearance-head", children: [_jsx("strong", { children: t('workbench.standingLink.title') }), _jsx("button", { type: "button", "aria-label": t('workbench.appearance.close'), onClick: props.onClose, children: "\u2715" })] }), loading ? (_jsx("p", { className: "wb-standing-link-status", role: "status", children: t('workbench.standingLink.loading') })) : !link ? (_jsx("p", { className: "wb-standing-link-status", role: "status", children: t('workbench.standingLink.error') })) : (_jsxs("div", { className: "wb-standing-link-body", children: [_jsx("textarea", { ref: fieldRef, className: "wb-standing-link-url", readOnly: true, rows: 3, value: link, "aria-label": t('workbench.standingLink.fieldLabel'), onFocus: event => event.currentTarget.select(), onClick: event => event.currentTarget.select() }), _jsx("button", { type: "button", className: "wb-standing-link-copy", onClick: () => { void onCopy(); }, children: copyState === 'copied'
+                            ? t('workbench.standingLink.copied')
+                            : copyState === 'failed'
+                                ? t('workbench.standingLink.copyFailed')
+                                : t('workbench.standingLink.copy') })] })), _jsx("p", { className: "wb-standing-link-note wb-appearance-note", children: t('workbench.standingLink.note') })] }));
+}
+/** Esc 关闭 + 焦点离开/点击面板外关闭。浮层和 sheet 用同一套关闭语义。 */
+function useDismiss(open, onClose, ref) {
+    useEffect(() => {
+        if (!open || typeof document === 'undefined')
+            return undefined;
+        const onKeyDown = (event) => { if (event.key === 'Escape')
+            onClose(); };
+        const onPointerDown = (event) => {
+            const target = event.target;
+            if (target instanceof Node && ref.current && !ref.current.contains(target))
+                onClose();
+        };
+        document.addEventListener('keydown', onKeyDown);
+        document.addEventListener('mousedown', onPointerDown);
+        return () => {
+            document.removeEventListener('keydown', onKeyDown);
+            document.removeEventListener('mousedown', onPointerDown);
+        };
+    }, [onClose, open, ref]);
+}
+/** 移动端：同一块内容的底部 sheet（列表页顶栏 `◐` 直达）。owner 的常驻链接也挂在
+ *  这里——手机浏览器同样能把工作台收进书签，不必回到桌面端。 */
+export function WorkbenchAppearanceSheet(props) {
+    const ref = useRef(null);
+    const [standingOpen, setStandingOpen] = useState(false);
+    const api = props.api ?? defaultWorkbenchApi();
+    useDismiss(props.open, props.onClose, ref);
+    useEffect(() => { if (!props.open)
+        setStandingOpen(false); }, [props.open]);
+    if (!props.open)
+        return null;
+    return (_jsx("div", { className: "wb-appearance-backdrop", children: _jsx("div", { ref: ref, className: "wb-appearance-sheet", role: "dialog", "aria-label": t('workbench.appearance.title'), children: standingOpen ? (_jsx(WorkbenchStandingLinkPanel, { api: api, onClose: props.onClose })) : (_jsxs(_Fragment, { children: [_jsxs("header", { className: "wb-appearance-head", children: [_jsx("strong", { children: t('workbench.appearance.title') }), _jsx("button", { type: "button", "aria-label": t('workbench.appearance.close'), onClick: props.onClose, children: "\u2715" })] }), _jsx(WorkbenchAppearanceControls, {}), props.standingLink ? (_jsx("div", { className: "wb-appearance-group", children: _jsx("button", { type: "button", className: "wb-standing-link-open", onClick: () => setStandingOpen(true), children: t('workbench.standingLink.title') }) })) : null] })) }) }));
+}
+/**
+ * 桌面 / 会话坞头部的 `⋯` 菜单。第一项是「外观」，owner 还多一项「常驻链接」，
+ * 两项点开的都是同一族下拉浮层（`.wb-appearance-pop`）。
+ * 菜单和浮层都能用键盘走：Esc 关闭并把焦点还给 `⋯`，方向键在单选组里移动。
+ */
+export function WorkbenchAppearanceMenu(props = {}) {
+    const [open, setOpen] = useState(null);
+    const rootRef = useRef(null);
+    const buttonRef = useRef(null);
+    const api = props.api ?? defaultWorkbenchApi();
+    const close = useCallback(() => {
+        setOpen(current => {
+            if (current !== null)
+                buttonRef.current?.focus();
+            return null;
+        });
+    }, []);
+    useDismiss(open !== null, close, rootRef);
+    return (_jsxs("div", { className: "wb-more", ref: rootRef, children: [_jsx("button", { ref: buttonRef, type: "button", className: "wb-more-btn", "aria-haspopup": "menu", "aria-expanded": open !== null, "aria-label": t('workbench.appearance.more'), title: t('workbench.appearance.more'), onClick: () => setOpen(current => (current === null ? 'menu' : null)), children: "\u22EF" }), open === 'menu' ? (_jsxs("div", { className: "wb-more-menu", role: "menu", children: [_jsx("button", { type: "button", role: "menuitem", className: "wb-more-item", autoFocus: true, onClick: () => setOpen('panel'), children: t('workbench.appearance.title') }), props.standingLink ? (_jsx("button", { type: "button", role: "menuitem", className: "wb-more-item", onClick: () => setOpen('standing'), children: t('workbench.standingLink.title') })) : null] })) : null, open === 'panel' ? (_jsxs("div", { className: "wb-appearance-pop", role: "dialog", "aria-label": t('workbench.appearance.title'), children: [_jsxs("header", { className: "wb-appearance-head", children: [_jsx("strong", { children: t('workbench.appearance.title') }), _jsx("button", { type: "button", "aria-label": t('workbench.appearance.close'), onClick: close, children: "\u2715" })] }), _jsx(WorkbenchAppearanceControls, {})] })) : null, open === 'standing' ? (_jsx("div", { className: "wb-appearance-pop wb-standing-link-pop", role: "dialog", "aria-label": t('workbench.standingLink.title'), children: _jsx(WorkbenchStandingLinkPanel, { api: api, onClose: close }) })) : null] }));
+}
+//# sourceMappingURL=agent-workbench-appearance-menu.js.map

package/dist/dashboard/web/agent-workbench-appearance-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-appearance-menu.js","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-appearance-menu.tsx"],"names":[],"mappings":"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"}

package/dist/dashboard/web/agent-workbench-appearance.d.ts

@@ -0,0 +1,222 @@
+/**
+ * 工作台外观：4 套配色（skin）× 明暗模式（mode）× 终端渲染风格（termStyle）。
+ *
+ * 三件事永远一起读、一起写，所以共用一条 localStorage 记录
+ * （`botmux.agent-workbench.appearance.v1`），命名沿用工作台既有的
+ * `botmux.agent-workbench.<域>.v<n>` 家族（见 agent-workbench-storage.ts）。
+ *
+ * 与全站明暗机制的关系（preferences.ts / ui.ts）：
+ * - `mode` 与全站 `ThemeMode` 同形（system / light / dark），决定**明暗族**；
+ * - `skin` 决定**深色族里的哪一套**——浅色族只有 `light-frost` 一个候选，
+ *   所以色板上选的那一枚只是「夜里用哪套」，跟随系统时在它与 light-frost 之间切；
+ * - 首次进工作台没有本地记录时，`mode` 继承全站 `readStoredThemeMode()` 的值，
+ *   之后工作台存自己的一份，全站再改浅色/深色不覆盖工作台的显式选择。
+ */
+import { type ResolvedTheme, type ThemeMode } from './preferences.js';
+import type { WorkbenchStorage } from './agent-workbench-storage.js';
+export type WorkbenchSkinId = 'ink' | 'slate-blue' | 'warm-graphite' | 'light-frost';
+/** 终端画布的渲染取向：`reader` 低饱和大行距、跟随工作台配色，`classic` 保持终端本色
+ *  （现状渲染）。首版这两个值叫 `orca` / `orca-ink`，见下面的 LEGACY_* 迁移表。 */
+export type WorkbenchTermStyle = 'reader' | 'classic';
+export interface WorkbenchAppearance {
+    skin: WorkbenchSkinId;
+    mode: ThemeMode;
+    termStyle: WorkbenchTermStyle;
+}
+export declare const WORKBENCH_APPEARANCE_STORAGE_KEY = "botmux.agent-workbench.appearance.v1";
+export declare const WORKBENCH_SKIN_IDS: readonly WorkbenchSkinId[];
+export declare const WORKBENCH_TERM_STYLES: readonly WorkbenchTermStyle[];
+/** 认新值，也认旧值；都不认返回 null。类型守卫本身保持严格，只认新值。 */
+export declare function migrateWorkbenchSkin(value: unknown): WorkbenchSkinId | null;
+export declare function migrateWorkbenchTermStyle(value: unknown): WorkbenchTermStyle | null;
+/** 浅色族唯一的一套：`mode` 落到 light 时恒用它，不占色板的「深色代表」名额。 */
+export declare const WORKBENCH_LIGHT_SKIN: WorkbenchSkinId;
+/** 默认深色代表：与现有品牌观感最接近的一套，迁移成本最低。 */
+export declare const DEFAULT_WORKBENCH_SKIN: WorkbenchSkinId;
+/** 默认终端渲染：`classic` 即现状渲染，存量用户零变化。 */
+export declare const DEFAULT_WORKBENCH_TERM_STYLE: WorkbenchTermStyle;
+export declare function isWorkbenchSkin(value: unknown): value is WorkbenchSkinId;
+export declare function isWorkbenchTermStyle(value: unknown): value is WorkbenchTermStyle;
+/** 皮肤所属明暗族。`light-frost` 是浅色，其余三套都是深色。 */
+export declare function workbenchSkinFamily(skin: WorkbenchSkinId): ResolvedTheme;
+export declare function defaultWorkbenchAppearance(inheritedMode?: ThemeMode): WorkbenchAppearance;
+/** 未知 skin / mode / termStyle 一律逐字段回落默认，绝不整份丢弃、更不抛错——
+ *  手改过 localStorage 或旧版本残留只该丢掉那一个字段，不该让工作台白屏。
+ *  首版命名（`orca` / `orca-ink`）在这里被认成新值，不算「未知」。
+ *  这是**唯一**的入口：loadWorkbenchAppearance、saveWorkbenchAppearance 与跨 tab 的
+ *  storage 事件全部经过它，所以三条路径的迁移行为天然一致。 */
+export declare function normalizeWorkbenchAppearance(value: unknown, inheritedMode?: ThemeMode): WorkbenchAppearance;
+export declare function loadWorkbenchAppearance(storage: WorkbenchStorage | null | undefined, inheritedMode?: ThemeMode): WorkbenchAppearance;
+export declare function saveWorkbenchAppearance(storage: WorkbenchStorage | null | undefined, appearance: WorkbenchAppearance): boolean;
+/** 实际生效的那一套配色：先由 mode（+ 系统偏好）定明暗族，再在族内取色。 */
+export declare function resolveWorkbenchSkin(appearance: WorkbenchAppearance, systemPrefersDark: boolean): WorkbenchSkinId;
+/**
+ * 点色板。三条规则来自设计规范「五 5.2」，不写会出「点了没反应」的投诉：
+ * 1. 跟随系统 / 深色下点浅色那套 → 视为「我要一直浅色」，mode 切到 light；
+ * 2. 跟随系统下点任一深色 → 只换深色代表，mode 保持 system（说的是「夜里用这套」）；
+ * 3. 浅色下点任一深色 → mode 切到 dark（规则 1 的镜像）。
+ * 选浅色时 `skin` 保持原来的深色代表不动 —— 再切回深色/跟随系统时还是用户上次选的那套。
+ */
+export declare function selectWorkbenchSkin(current: WorkbenchAppearance, skin: WorkbenchSkinId): WorkbenchAppearance;
+export declare function selectWorkbenchMode(current: WorkbenchAppearance, mode: ThemeMode): WorkbenchAppearance;
+export declare function selectWorkbenchTermStyle(current: WorkbenchAppearance, termStyle: WorkbenchTermStyle): WorkbenchAppearance;
+/** 终端容器 class：几何（行距 / 内边距）差异全部由样式侧的这两个类承担。 */
+export declare function workbenchTermContainerClass(termStyle: WorkbenchTermStyle): string;
+export interface WorkbenchSkinPreview {
+    bg: string;
+    raise: string;
+    accent: string;
+}
+export declare const WORKBENCH_SKIN_PREVIEWS: Record<WorkbenchSkinId, WorkbenchSkinPreview>;
+/** xterm.js `ITheme` 的子集：只给两套预设真正用到的键，避免把 xterm 类型拖进来。 */
+export interface WorkbenchTermTheme {
+    background: string;
+    foreground: string;
+    cursor: string;
+    selectionBackground: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+}
+/**
+ * `classic` = 终端页现有配色**原样**（Tokyo Night，src/worker.ts 里那份字面量）。
+ * 存量用户切不切主题都看不出变化，这也是默认风格。
+ */
+export declare const WORKBENCH_CLASSIC_TERM_THEME: WorkbenchTermTheme;
+/**
+ * `reader`（「阅读」）= 低饱和 muted 版：直接映射该套配色的 token（--term-bg /
+ * --text-1 / --text-3 / --accent / --ok / --warn / --err），所以终端和工作台是同一套色。
+ * `light-frost` 的终端画布仍是深色（彩色 ANSI 放浅底上不可读，业界通行做法），
+ * 所以它这一行用的是规范里为它单列的那组亮色终端令牌。
+ */
+export declare const WORKBENCH_READER_TERM_THEMES: Record<WorkbenchSkinId, WorkbenchTermTheme>;
+export declare function workbenchTermTheme(termStyle: WorkbenchTermStyle, skin: WorkbenchSkinId): WorkbenchTermTheme;
+/**
+ * xterm 的 `lineHeight`。这是**唯一**的出处：终端页那段监听器（src/worker.ts 的模板
+ * 字符串，没法 import）必须照抄同样的数字，接缝测试按这张表比对它的字面量；
+ * `.wb-term-classic / .wb-term-reader` 的 `--term-line-height` 同样按这张表对齐。
+ *
+ * 阅读风从 1.55 降到 1.3：1.55 下单元格高 ≈24.5px，CLI 的底部 chrome（提示 + 输入框 +
+ * 状态条，固定占 8 个终端行）就要吃掉约 196px —— 900 高的窗口里四分之一屏全是 chrome。
+ * 1.3 仍比经典的 1.0 松三成，正文呼吸感在，chrome 收回约 16%、可视行数多出两成。
+ * `classic` 恒为 1 = xterm 默认，「经典 = 原样」的一部分。
+ */
+export declare const WORKBENCH_TERM_LINE_HEIGHTS: Record<WorkbenchTermStyle, number>;
+export declare function workbenchTermLineHeight(termStyle: WorkbenchTermStyle): number;
+/** 终端外壳（安全边距那圈）要刷的底色变量名。见 `workbenchTermCanvasStyle`。 */
+export declare const WORKBENCH_TERM_CANVAS_BG_VAR = "--term-canvas-bg";
+/**
+ * 终端面板外壳的底色 —— 跟着**实际生效的终端渲染风格**走，而不是跟着皮肤令牌走。
+ *
+ * 外壳（`.wb-pane-frame-shell`）给字形留了 8px 安全边距，这圈底色原本刷的是皮肤的
+ * `--term-bg`。阅读风时两者本来就同色（`WORKBENCH_READER_TERM_THEMES[skin].background`
+ * 逐套等于该皮肤的 `--term-bg`），可经典渲染的 xterm 底色是它自己的 Tokyo Night
+ * `#1a1b26`，和 `--term-bg`（如 slate-blue 的 `#030407`）差一大截，画布外就露出一圈
+ * 更黑的边框 —— 用户看到的「经典终端黑色边框」就是它。
+ *
+ * 取值直接来自 `workbenchTermTheme()`，也就是同一次下发给终端 iframe 的那份 theme：
+ * 外壳和画布永远同源同色，不存在第二份字面量。
+ */
+export declare function workbenchTermCanvasStyle(termStyle: WorkbenchTermStyle, skin: WorkbenchSkinId): Record<string, string>;
+/** 父页 → 终端 iframe 的一次外观下发。终端页只认这一个消息类型。 */
+export declare const WORKBENCH_TERM_APPEARANCE_MESSAGE = "botmux:wb-appearance";
+export interface WorkbenchTermAppearanceMessage {
+    type: typeof WORKBENCH_TERM_APPEARANCE_MESSAGE;
+    termStyle: WorkbenchTermStyle;
+    skin: WorkbenchSkinId;
+    theme: WorkbenchTermTheme;
+}
+export declare function workbenchTermAppearanceMessage(termStyle: WorkbenchTermStyle, skin: WorkbenchSkinId): WorkbenchTermAppearanceMessage;
+/**
+ * 把外观推给终端 iframe。终端画布住在跨文档的 `/s/<sessionId>` 里，父页换 class
+ * 它收不到，不推过去就会出现「工作台换了配色、终端还是旧色」的半截状态。
+ * 目标 origin 从 iframe 自己的 URL 推导（触屏走的 viewToken 链接可能是别的
+ * host/port），推导不出来就放弃这次下发——绝不用 `*` 广播。
+ */
+export declare function postWorkbenchTermAppearance(frame: {
+    contentWindow?: {
+        postMessage(data: unknown, targetOrigin: string): void;
+    } | null;
+} | null | undefined, frameUrl: string | null | undefined, termStyle: WorkbenchTermStyle, skin: WorkbenchSkinId, baseUrl?: string): boolean;
+/** 只用到 dataset 的最小结构，方便单测注入一个假根节点。 */
+export interface WorkbenchAppearanceRoot {
+    readonly dataset: Record<string, string | undefined>;
+}
+export interface WorkbenchRootAttributes {
+    /** 生效的配色，写进 `data-skin`。 */
+    skin: WorkbenchSkinId;
+    /** 生效的明暗族，写进 `data-theme`，让既有的明暗组件规则跟着走。 */
+    theme: ResolvedTheme;
+}
+/** 进工作台前文档根上原本挂着什么（全站 skin / 明暗），离开时原样放回去。 */
+export interface WorkbenchRootSnapshot {
+    skin?: string;
+    theme?: string;
+}
+export declare function applyWorkbenchRootAttributes(root: WorkbenchAppearanceRoot | null | undefined, attributes: WorkbenchRootAttributes): WorkbenchRootSnapshot;
+export declare function restoreWorkbenchRootAttributes(root: WorkbenchAppearanceRoot | null | undefined, snapshot: WorkbenchRootSnapshot): void;
+/**
+ * 外观只有一个状态源：桌面 `⋯ → 外观`、移动列表页 `◐`、终端标题栏的
+ * 「阅读｜经典」分段控件全部读写这一个 store，任一处改动另外两处立刻跟着变。
+ * 跨 tab 同步靠 `storage` 事件；跟随系统靠 `matchMedia` 的 change。
+ */
+export interface WorkbenchAppearanceSnapshot {
+    appearance: WorkbenchAppearance;
+    /** 实际生效的配色（已解析 mode + 系统偏好）。 */
+    skin: WorkbenchSkinId;
+    theme: ResolvedTheme;
+}
+export interface WorkbenchAppearanceEnvironment {
+    storage: WorkbenchStorage | null;
+    root: WorkbenchAppearanceRoot | null;
+    /** 首次进工作台、本地还没有记录时 mode 的初值（全站 ThemeMode）。 */
+    inheritedMode: ThemeMode;
+    prefersDark(): boolean;
+    /** 订阅系统明暗变化；返回退订函数。 */
+    onSystemThemeChange?(listener: () => void): () => void;
+    /** 订阅跨 tab 的 localStorage 变化；返回退订函数。 */
+    onStorageChange?(listener: (key: string | null, value: string | null) => void): () => void;
+}
+/** 浏览器环境。没有 window（组件测试跑在 node 上）时返回 null，一切走默认值。 */
+export declare function browserAppearanceEnvironment(): WorkbenchAppearanceEnvironment | null;
+export declare class WorkbenchAppearanceStore {
+    private env;
+    private envResolved;
+    private value;
+    private snapshot;
+    private readonly listeners;
+    private mounted;
+    private disposers;
+    private rootSnapshot;
+    /** 环境只认一次：测试注入假实现，浏览器里第一次取值时自己接上真的。 */
+    configure(env: WorkbenchAppearanceEnvironment | null): void;
+    getSnapshot(): WorkbenchAppearanceSnapshot;
+    subscribe(listener: () => void): () => void;
+    set(next: WorkbenchAppearance): void;
+    /**
+     * 把外观挂到文档根上，并接好系统明暗 / 跨 tab 两个监听。返回卸载函数：
+     * 离开工作台时把 `data-skin` / `data-theme` 原样还给全站机制（工作台的 4 套
+     * 配色是局部调色板，不该在别的页面继续生效）。
+     */
+    mount(): () => void;
+    /** 测试用：把 store 恢复到「还没接过环境」的状态。 */
+    reset(): void;
+    private ensureEnv;
+    private bind;
+    private unbind;
+    /**
+     * 重新解析并落地。全站那套明暗仲裁（ui.ts）也在写 `data-theme`，工作台在场时
+     * 由这里把自己的解析结果盖回去 —— 所以它必须幂等：没变化就不换快照对象、也不
+     * 通知订阅者，免得每来一次全站事件就把工作台整页重绘。
+     */
+    reapply(): void;
+    private refresh;
+    private buildSnapshot;
+}
+export declare const workbenchAppearance: WorkbenchAppearanceStore;
+//# sourceMappingURL=agent-workbench-appearance.d.ts.map

package/dist/dashboard/web/agent-workbench-appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-appearance.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-appearance.ts"],"names":[],"mappings":"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"}