dsh-single-terminal 0.1.0

package/lib/types/client/styles.js

@@ -0,0 +1,103 @@
+/**
+ * dsh-single-terminal —— 抽屉全局样式 + 内嵌 xterm.css（构建期生成注入）。
+ */
+import { XTERM_CSS } from "./xterm-css.js";
+const DRAWER_CSS = `
+.dst-drawer {
+  position: absolute;
+  left: 0; right: 0; bottom: 0;
+  height: var(--dst-height, 360px);
+  min-height: 140px;
+  display: flex;
+  flex-direction: column;
+  background: #1f2126;
+  border-top: 1px solid #3a3d44;
+  box-shadow: 0 -8px 24px rgba(0, 0, 0, 0.25);
+  z-index: 5;
+}
+.dst-drag { height: 5px; flex: none; cursor: row-resize; touch-action: none; }
+.dst-drag:hover { background: #4a4d55; }
+.dst-head {
+  display: flex; align-items: center; gap: 4px;
+  height: 36px; flex: none; padding: 0 8px;
+  border-bottom: 1px solid #3a3d44;
+  color: #c9cdd4;
+}
+.dst-tabs { display: flex; align-items: center; gap: 2px; flex: 1; min-width: 0; overflow-x: auto; scrollbar-width: none; }
+.dst-tabs::-webkit-scrollbar { display: none; }
+.dst-tab {
+  display: inline-flex; align-items: center; gap: 6px;
+  padding: 4px 8px; border: none; border-radius: 6px;
+  background: transparent; color: #9aa0aa; font-size: 12px;
+  cursor: pointer; white-space: nowrap;
+}
+.dst-tab:hover { background: rgba(255, 255, 255, 0.06); }
+.dst-tab.active { background: rgba(255, 255, 255, 0.1); color: #eceef1; }
+.dst-dot { width: 6px; height: 6px; border-radius: 50%; background: #3fb950; flex: none; }
+.dst-dot.dead { background: #6e7278; }
+.dst-tabclose {
+  display: inline-flex; align-items: center; justify-content: center;
+  width: 16px; height: 16px; border: none; border-radius: 4px;
+  background: transparent; color: inherit; font-size: 12px; line-height: 1;
+  cursor: pointer; padding: 0;
+}
+.dst-tabclose:hover { background: rgba(255, 255, 255, 0.14); }
+.dst-actions { display: flex; align-items: center; gap: 2px; flex: none; }
+.dst-conn { width: 8px; height: 8px; border-radius: 50%; flex: none; margin: 0 4px; }
+.dst-conn.connected { background: #3fb950; }
+.dst-conn.connecting, .dst-conn.reconnecting { background: #d29922; }
+.dst-iconbtn {
+  display: inline-flex; align-items: center; justify-content: center;
+  width: 26px; height: 26px; border: none; border-radius: 6px;
+  background: transparent; color: inherit; cursor: pointer; padding: 0;
+}
+.dst-iconbtn:hover { background: rgba(255, 255, 255, 0.1); }
+.dst-modebtn {
+  display: inline-flex; align-items: center; gap: 4px;
+  height: 26px; padding: 0 8px; border: none; border-radius: 6px;
+  background: transparent; color: #9aa0aa; font-size: 12px; cursor: pointer;
+}
+.dst-modebtn:hover { background: rgba(255, 255, 255, 0.1); color: #eceef1; }
+.dst-menu {
+  position: absolute; right: 8px; bottom: 44px; min-width: 170px;
+  background: #26282e; border: 1px solid #3a3d44; border-radius: 8px;
+  padding: 4px; z-index: 10; box-shadow: 0 8px 24px rgba(0, 0, 0, 0.45);
+}
+.dst-menuitem {
+  display: flex; width: 100%; align-items: center; gap: 8px;
+  padding: 6px 10px; border: none; border-radius: 6px;
+  background: transparent; color: #d5d8dd; font-size: 13px;
+  cursor: pointer; text-align: left;
+}
+.dst-menuitem:hover { background: rgba(255, 255, 255, 0.08); }
+.dst-body { flex: 1; min-height: 0; position: relative; padding: 2px 6px 6px; background: #1a1c20; }
+.dst-term { width: 100%; height: 100%; }
+.dst-empty {
+  position: absolute; inset: 0; display: flex;
+  align-items: center; justify-content: center;
+  color: #6e7278; font-size: 13px;
+}
+.dst-notice {
+  position: absolute; left: 50%; transform: translateX(-50%); bottom: 12px;
+  max-width: 70%; padding: 6px 12px; border-radius: 8px; z-index: 8;
+  background: #4a2226; color: #ffb4b4; font-size: 12px;
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+.dst-headbtn {
+  display: inline-flex; align-items: center; justify-content: center;
+  width: 26px; height: 26px; padding: 0;
+  border: none; border-radius: 6px; background: transparent;
+  color: inherit; cursor: pointer;
+}
+.dst-headbtn:hover, .dst-headbtn.active { background: rgba(128, 128, 128, 0.18); }
+`;
+let injected = false;
+export function injectStyles() {
+    if (injected)
+        return;
+    injected = true;
+    const style = document.createElement('style');
+    style.setAttribute('data-plugin', 'dsh-single-terminal');
+    style.textContent = XTERM_CSS + DRAWER_CSS;
+    document.head.appendChild(style);
+}

package/lib/types/client/term.d.ts

@@ -0,0 +1,15 @@
+/**
+ * dsh-single-terminal —— 单标签终端视图（xterm.js）。
+ *
+ * - Webgl 渲染器加载失败时自动回退到默认渲染；
+ * - ResizeObserver → FitAddon.fit() → onResize 帧上报宿主 resize PTY；
+ * - 输出经 controller sink 通道写入（挂载前的字节积压在 controller.pending）。
+ */
+import { type TabState } from './controller.ts';
+export declare function TerminalView(props: {
+    tab: TabState;
+    active: boolean;
+    fontSize: number;
+    fontFamily: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=term.d.ts.map

package/lib/types/client/term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"term.d.ts","sourceRoot":"","sources":["../../../src/client/term.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AA0BzD,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,GAAG,EAAE,QAAQ,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB,+BAmDA"}

package/lib/types/client/term.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * dsh-single-terminal —— 单标签终端视图（xterm.js）。
+ *
+ * - Webgl 渲染器加载失败时自动回退到默认渲染；
+ * - ResizeObserver → FitAddon.fit() → onResize 帧上报宿主 resize PTY；
+ * - 输出经 controller sink 通道写入（挂载前的字节积压在 controller.pending）。
+ */
+import { useEffect, useRef } from 'react';
+import { Terminal } from '@xterm/xterm';
+import { FitAddon } from '@xterm/addon-fit';
+import { WebglAddon } from '@xterm/addon-webgl';
+import { terminal } from "./controller.js";
+const THEME = {
+    background: '#1a1c20',
+    foreground: '#d4d4d4',
+    cursor: '#aeafad',
+    cursorAccent: '#1a1c20',
+    selectionBackground: '#264f78',
+    black: '#000000',
+    red: '#cd3131',
+    green: '#0dbc79',
+    yellow: '#e5e510',
+    blue: '#2472c8',
+    magenta: '#bc3fbc',
+    cyan: '#11a8cd',
+    white: '#e5e5e5',
+    brightBlack: '#666666',
+    brightRed: '#f14c4c',
+    brightGreen: '#23d18b',
+    brightYellow: '#f5f543',
+    brightBlue: '#3b8eea',
+    brightMagenta: '#d670d6',
+    brightCyan: '#29b8db',
+    brightWhite: '#ffffff',
+};
+export function TerminalView(props) {
+    const containerRef = useRef(null);
+    useEffect(() => {
+        const container = containerRef.current;
+        if (container === null)
+            return;
+        const id = props.tab.id;
+        const instance = new Terminal({
+            fontSize: props.fontSize,
+            fontFamily: props.fontFamily,
+            cursorBlink: true,
+            scrollback: 2000,
+            theme: THEME,
+        });
+        const fit = new FitAddon();
+        instance.loadAddon(fit);
+        try {
+            instance.loadAddon(new WebglAddon());
+        }
+        catch { /* no webgl: default canvas renderer */ }
+        instance.open(container);
+        instance.onData((data) => { terminal.sendInput(id, data); });
+        instance.onResize(({ cols, rows }) => { terminal.sendResize(id, cols, rows); });
+        const unregister = terminal.registerSink(id, { write: (data) => { instance.write(data); } });
+        const observer = new ResizeObserver(() => {
+            if (container.clientWidth < 10 || container.clientHeight < 10)
+                return;
+            try {
+                fit.fit();
+            }
+            catch { /* not visible */ }
+        });
+        observer.observe(container);
+        requestAnimationFrame(() => {
+            if (container.clientWidth < 10 || container.clientHeight < 10)
+                return;
+            try {
+                fit.fit();
+            }
+            catch { /* not ready */ }
+        });
+        return () => {
+            observer.disconnect();
+            unregister();
+            instance.dispose();
+        };
+        // fontSize/fontFamily 变化不重建（配置改动后刷新页面生效）
+    }, [props.tab.id]);
+    return (_jsx("div", { ref: containerRef, className: "dst-term", style: { display: props.active ? 'block' : 'none' } }));
+}

package/lib/types/client/toggle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * dsh-single-terminal —— 会话头部开关按钮（conversation.session.header.utilities 插槽）。
+ *
+ * 图标为 panel-bottom（面板底部条填充）样式，几何取自宿主 IconPanelLeftOutline16
+ * 旋转 -90°，风格与宿主图标一致；hover 气泡用宿主 Tooltip（label 传 thunk，
+ * 气泡显示时求值，语言切换即生效）。
+ */
+export declare function TerminalToggle(): import("react").JSX.Element;
+//# sourceMappingURL=toggle.d.ts.map

package/lib/types/client/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../src/client/toggle.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,wBAAgB,cAAc,gCAc7B"}

package/lib/types/client/toggle.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * dsh-single-terminal —— 会话头部开关按钮（conversation.session.header.utilities 插槽）。
+ *
+ * 图标为 panel-bottom（面板底部条填充）样式，几何取自宿主 IconPanelLeftOutline16
+ * 旋转 -90°，风格与宿主图标一致；hover 气泡用宿主 Tooltip（label 传 thunk，
+ * 气泡显示时求值，语言切换即生效）。
+ */
+import { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives';
+import { terminal, useDrawerState } from "./controller.js";
+import { t } from "./i18n.js";
+const PANEL_LEFT_PATH = 'M9.67272 0.522841C10.8339 0.522841 11.76 0.522714 12.4963 0.602493C13.2453 0.683657 13.8789 0.854248 14.4264 1.25197C14.7504 1.48739 15.0355 1.77247 15.2709 2.0965C15.6686 2.64394 15.8392 3.27758 15.9204 4.02655C16.0002 4.7629 16 5.68895 16 6.85014V9.14986C16 10.3111 16.0002 11.2371 15.9204 11.9735C15.8392 12.7224 15.6686 13.3561 15.2709 13.9035C15.0355 14.2275 14.7504 14.5126 14.4264 14.748C13.8789 15.1458 13.2453 15.3163 12.4963 15.3975C11.76 15.4773 10.8339 15.4772 9.67272 15.4772H6.3273C5.16611 15.4772 4.24006 15.4773 3.50371 15.3975C2.75474 15.3163 2.1211 15.1458 1.57366 14.748C1.24963 14.5126 0.964549 14.2275 0.729131 13.9035C0.331407 13.3561 0.160817 12.7224 0.0796529 11.9735C-0.000126137 11.2371 1.25338e-09 10.3111 1.25338e-09 9.14986V6.85014C1.25329e-09 5.68895 -0.000126137 4.7629 0.0796529 4.02655C0.160817 3.27758 0.331407 2.64394 0.729131 2.0965C0.964549 1.77247 1.24963 1.48739 1.57366 1.25197C2.1211 0.854248 2.75474 0.683657 3.50371 0.602493C4.24006 0.522714 5.16611 0.522841 6.3273 0.522841H9.67272ZM5.54303 1.88715V14.1118C5.78636 14.1128 6.04709 14.1169 6.3273 14.1169H9.67272C10.8639 14.1169 11.7032 14.1164 12.3493 14.0465C12.9824 13.9779 13.3497 13.8494 13.6268 13.6482C13.8354 13.4966 14.0195 13.3125 14.1711 13.1039C14.3723 12.8268 14.5007 12.4595 14.5693 11.8264C14.6393 11.1803 14.6398 10.341 14.6398 9.14986V6.85014C14.6398 5.65896 14.6393 4.81967 14.5693 4.1736C14.5007 3.54048 14.3723 3.17318 14.1711 2.89609C14.0195 2.68747 13.8354 2.50337 13.6268 2.35179C13.3497 2.1506 12.9824 2.02212 12.3493 1.95353C11.7032 1.88358 10.8639 1.88307 9.67272 1.88307H6.3273C6.04709 1.88307 5.78636 1.8862 5.54303 1.88715ZM4.1828 1.91166C3.99125 1.9216 3.8148 1.93577 3.65076 1.95353C3.01764 2.02212 2.65034 2.1506 2.37325 2.35179C2.16463 2.50337 1.98052 2.68747 1.82895 2.89609C1.62776 3.17318 1.49928 3.54048 1.43069 4.1736C1.36074 4.81967 1.36023 5.65896 1.36023 6.85014V9.14986C1.36023 10.341 1.36074 11.1803 1.43069 11.8264C1.49928 12.4595 1.62776 12.8268 1.82895 13.1039C1.98052 13.3125 2.16463 13.4966 2.37325 13.6482C2.65034 13.8494 3.01764 13.9779 3.65076 14.0465C3.81478 14.0642 3.99127 14.0774 4.1828 14.0873V1.91166Z';
+function PanelBottomIcon(props) {
+    return (_jsx("svg", { width: props.size ?? 16, height: props.size ?? 16, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: PANEL_LEFT_PATH, transform: "rotate(-90 8 8)", fillRule: "evenodd", clipRule: "evenodd", fill: "currentColor" }) }));
+}
+export function TerminalToggle() {
+    const state = useDrawerState();
+    return (_jsx(Tooltip, { label: () => t('terminal.toggleTip'), side: "bottom", children: _jsx("button", { type: "button", className: `dst-headbtn${state.open ? ' active' : ''}`, "aria-label": t('terminal.toggleTip'), onClick: () => { terminal.toggle(); }, children: _jsx(PanelBottomIcon, { size: 16 }) }) }));
+}

package/lib/types/client/ws.d.ts

@@ -0,0 +1,25 @@
+/**
+ * dsh-single-terminal —— 同源 WebSocket 客户端（自动重连，指数退避）。
+ *
+ * URL 由 location.origin 推导（http→ws / https→wss），浏览器自动携带
+ * dsh-auth cookie（与宿主 /api/remote.mux 相同的鉴权路径）。
+ */
+import type { ClientFrame, HostFrame } from './protocol.ts';
+export type ConnectionState = 'connecting' | 'connected' | 'reconnecting';
+export interface TerminalSocketHandlers {
+    onFrame(frame: HostFrame): void;
+    onState(state: ConnectionState): void;
+}
+export declare class TerminalSocket {
+    private readonly handlers;
+    private socket;
+    private retry;
+    private timer;
+    private disposed;
+    constructor(handlers: TerminalSocketHandlers);
+    connect(): void;
+    send(frame: ClientFrame): void;
+    dispose(): void;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=ws.d.ts.map

package/lib/types/client/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../src/client/ws.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE3D,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAA;AAEzE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CACtC;AAED,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAQ;gBAEK,QAAQ,EAAE,sBAAsB;IAE7D,OAAO,IAAI,IAAI;IA+Bf,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAM9B,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,iBAAiB;CAS1B"}

package/lib/types/client/ws.js

@@ -0,0 +1,79 @@
+/**
+ * dsh-single-terminal —— 同源 WebSocket 客户端（自动重连，指数退避）。
+ *
+ * URL 由 location.origin 推导（http→ws / https→wss），浏览器自动携带
+ * dsh-auth cookie（与宿主 /api/remote.mux 相同的鉴权路径）。
+ */
+export class TerminalSocket {
+    handlers;
+    socket = null;
+    retry = 0;
+    timer = null;
+    disposed = false;
+    constructor(handlers) {
+        this.handlers = handlers;
+    }
+    connect() {
+        if (this.disposed || this.socket !== null)
+            return;
+        this.handlers.onState(this.retry === 0 ? 'connecting' : 'reconnecting');
+        const origin = globalThis.location?.origin;
+        const base = origin !== undefined && origin !== 'null' ? origin : 'http://localhost:3000';
+        const url = base.replace(/^http/, 'ws') + '/api/dsh-single-terminal.ws';
+        const socket = new WebSocket(url);
+        this.socket = socket;
+        socket.onopen = () => {
+            this.retry = 0;
+            this.handlers.onState('connected');
+        };
+        socket.onmessage = (event) => {
+            let frame;
+            try {
+                frame = JSON.parse(String(event.data));
+            }
+            catch {
+                return;
+            }
+            this.handlers.onFrame(frame);
+        };
+        socket.onclose = () => {
+            this.socket = null;
+            if (this.disposed)
+                return;
+            this.scheduleReconnect();
+        };
+        socket.onerror = () => {
+            try {
+                socket.close();
+            }
+            catch { /* closing */ }
+        };
+    }
+    send(frame) {
+        if (this.socket !== null && this.socket.readyState === WebSocket.OPEN) {
+            this.socket.send(JSON.stringify(frame));
+        }
+    }
+    dispose() {
+        this.disposed = true;
+        if (this.timer !== null)
+            clearTimeout(this.timer);
+        this.timer = null;
+        if (this.socket !== null) {
+            try {
+                this.socket.close();
+            }
+            catch { /* closing */ }
+            this.socket = null;
+        }
+    }
+    scheduleReconnect() {
+        this.retry += 1;
+        const delay = Math.min(1000 * 2 ** Math.min(this.retry - 1, 4), 15_000);
+        this.handlers.onState('reconnecting');
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.connect();
+        }, delay);
+    }
+}

package/lib/types/client/xterm-css.d.ts

@@ -0,0 +1,7 @@
+/**
+ * xterm.css（@xterm/xterm 5.x 自带样式）· 生成期内嵌。
+ * 来源：node_modules/@xterm/xterm/css/xterm.css（MIT，xterm.js authors）。
+ * 升级 @xterm/xterm 后重跑 scripts/gen-xterm-css.mjs 再生成本文件。
+ */
+export declare const XTERM_CSS = "/**\n * Copyright (c) 2014 The xterm.js authors. All rights reserved.\n * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)\n * https://github.com/chjj/term.js\n * @license MIT\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n *\n * Originally forked from (with the author's permission):\n *   Fabrice Bellard's javascript vt100 for jslinux:\n *   http://bellard.org/jslinux/\n *   Copyright (c) 2011 Fabrice Bellard\n *   The original design remains. The terminal itself\n *   has been extended to include xterm CSI codes, among\n *   other features.\n */\n\n/**\n *  Default styles for xterm.js\n */\n\n.xterm {\n    cursor: text;\n    position: relative;\n    user-select: none;\n    -ms-user-select: none;\n    -webkit-user-select: none;\n}\n\n.xterm.focus,\n.xterm:focus {\n    outline: none;\n}\n\n.xterm .xterm-helpers {\n    position: absolute;\n    top: 0;\n    /**\n     * The z-index of the helpers must be higher than the canvases in order for\n     * IMEs to appear on top.\n     */\n    z-index: 5;\n}\n\n.xterm .xterm-helper-textarea {\n    padding: 0;\n    border: 0;\n    margin: 0;\n    /* Move textarea out of the screen to the far left, so that the cursor is not visible */\n    position: absolute;\n    opacity: 0;\n    left: -9999em;\n    top: 0;\n    width: 0;\n    height: 0;\n    z-index: -5;\n    /** Prevent wrapping so the IME appears against the textarea at the correct position */\n    white-space: nowrap;\n    overflow: hidden;\n    resize: none;\n}\n\n.xterm .composition-view {\n    /* TODO: Composition position got messed up somewhere */\n    background: #000;\n    color: #FFF;\n    display: none;\n    position: absolute;\n    white-space: nowrap;\n    z-index: 1;\n}\n\n.xterm .composition-view.active {\n    display: block;\n}\n\n.xterm .xterm-viewport {\n    /* On OS X this is required in order for the scroll bar to appear fully opaque */\n    background-color: #000;\n    overflow-y: scroll;\n    cursor: default;\n    position: absolute;\n    right: 0;\n    left: 0;\n    top: 0;\n    bottom: 0;\n}\n\n.xterm .xterm-screen {\n    position: relative;\n}\n\n.xterm .xterm-screen canvas {\n    position: absolute;\n    left: 0;\n    top: 0;\n}\n\n.xterm .xterm-scroll-area {\n    visibility: hidden;\n}\n\n.xterm-char-measure-element {\n    display: inline-block;\n    visibility: hidden;\n    position: absolute;\n    top: 0;\n    left: -9999em;\n    line-height: normal;\n}\n\n.xterm.enable-mouse-events {\n    /* When mouse events are enabled (eg. tmux), revert to the standard pointer cursor */\n    cursor: default;\n}\n\n.xterm.xterm-cursor-pointer,\n.xterm .xterm-cursor-pointer {\n    cursor: pointer;\n}\n\n.xterm.column-select.focus {\n    /* Column selection mode */\n    cursor: crosshair;\n}\n\n.xterm .xterm-accessibility:not(.debug),\n.xterm .xterm-message {\n    position: absolute;\n    left: 0;\n    top: 0;\n    bottom: 0;\n    right: 0;\n    z-index: 10;\n    color: transparent;\n    pointer-events: none;\n}\n\n.xterm .xterm-accessibility-tree:not(.debug) *::selection {\n  color: transparent;\n}\n\n.xterm .xterm-accessibility-tree {\n  user-select: text;\n  white-space: pre;\n}\n\n.xterm .live-region {\n    position: absolute;\n    left: -9999px;\n    width: 1px;\n    height: 1px;\n    overflow: hidden;\n}\n\n.xterm-dim {\n    /* Dim should not apply to background, so the opacity of the foreground color is applied\n     * explicitly in the generated class and reset to 1 here */\n    opacity: 1 !important;\n}\n\n.xterm-underline-1 { text-decoration: underline; }\n.xterm-underline-2 { text-decoration: double underline; }\n.xterm-underline-3 { text-decoration: wavy underline; }\n.xterm-underline-4 { text-decoration: dotted underline; }\n.xterm-underline-5 { text-decoration: dashed underline; }\n\n.xterm-overline {\n    text-decoration: overline;\n}\n\n.xterm-overline.xterm-underline-1 { text-decoration: overline underline; }\n.xterm-overline.xterm-underline-2 { text-decoration: overline double underline; }\n.xterm-overline.xterm-underline-3 { text-decoration: overline wavy underline; }\n.xterm-overline.xterm-underline-4 { text-decoration: overline dotted underline; }\n.xterm-overline.xterm-underline-5 { text-decoration: overline dashed underline; }\n\n.xterm-strikethrough {\n    text-decoration: line-through;\n}\n\n.xterm-screen .xterm-decoration-container .xterm-decoration {\n\tz-index: 6;\n\tposition: absolute;\n}\n\n.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer {\n\tz-index: 7;\n}\n\n.xterm-decoration-overview-ruler {\n    z-index: 8;\n    position: absolute;\n    top: 0;\n    right: 0;\n    pointer-events: none;\n}\n\n.xterm-decoration-top {\n    z-index: 2;\n    position: relative;\n}\n";
+//# sourceMappingURL=xterm-css.d.ts.map

package/lib/types/client/xterm-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xterm-css.d.ts","sourceRoot":"","sources":["../../../src/client/xterm-css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,6pLA0NrB,CAAA"}

package/lib/types/client/xterm-css.js

@@ -0,0 +1,224 @@
+/**
+ * xterm.css（@xterm/xterm 5.x 自带样式）· 生成期内嵌。
+ * 来源：node_modules/@xterm/xterm/css/xterm.css（MIT，xterm.js authors）。
+ * 升级 @xterm/xterm 后重跑 scripts/gen-xterm-css.mjs 再生成本文件。
+ */
+export const XTERM_CSS = `/**
+ * Copyright (c) 2014 The xterm.js authors. All rights reserved.
+ * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
+ * https://github.com/chjj/term.js
+ * @license MIT
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * Originally forked from (with the author's permission):
+ *   Fabrice Bellard's javascript vt100 for jslinux:
+ *   http://bellard.org/jslinux/
+ *   Copyright (c) 2011 Fabrice Bellard
+ *   The original design remains. The terminal itself
+ *   has been extended to include xterm CSI codes, among
+ *   other features.
+ */
+
+/**
+ *  Default styles for xterm.js
+ */
+
+.xterm {
+    cursor: text;
+    position: relative;
+    user-select: none;
+    -ms-user-select: none;
+    -webkit-user-select: none;
+}
+
+.xterm.focus,
+.xterm:focus {
+    outline: none;
+}
+
+.xterm .xterm-helpers {
+    position: absolute;
+    top: 0;
+    /**
+     * The z-index of the helpers must be higher than the canvases in order for
+     * IMEs to appear on top.
+     */
+    z-index: 5;
+}
+
+.xterm .xterm-helper-textarea {
+    padding: 0;
+    border: 0;
+    margin: 0;
+    /* Move textarea out of the screen to the far left, so that the cursor is not visible */
+    position: absolute;
+    opacity: 0;
+    left: -9999em;
+    top: 0;
+    width: 0;
+    height: 0;
+    z-index: -5;
+    /** Prevent wrapping so the IME appears against the textarea at the correct position */
+    white-space: nowrap;
+    overflow: hidden;
+    resize: none;
+}
+
+.xterm .composition-view {
+    /* TODO: Composition position got messed up somewhere */
+    background: #000;
+    color: #FFF;
+    display: none;
+    position: absolute;
+    white-space: nowrap;
+    z-index: 1;
+}
+
+.xterm .composition-view.active {
+    display: block;
+}
+
+.xterm .xterm-viewport {
+    /* On OS X this is required in order for the scroll bar to appear fully opaque */
+    background-color: #000;
+    overflow-y: scroll;
+    cursor: default;
+    position: absolute;
+    right: 0;
+    left: 0;
+    top: 0;
+    bottom: 0;
+}
+
+.xterm .xterm-screen {
+    position: relative;
+}
+
+.xterm .xterm-screen canvas {
+    position: absolute;
+    left: 0;
+    top: 0;
+}
+
+.xterm .xterm-scroll-area {
+    visibility: hidden;
+}
+
+.xterm-char-measure-element {
+    display: inline-block;
+    visibility: hidden;
+    position: absolute;
+    top: 0;
+    left: -9999em;
+    line-height: normal;
+}
+
+.xterm.enable-mouse-events {
+    /* When mouse events are enabled (eg. tmux), revert to the standard pointer cursor */
+    cursor: default;
+}
+
+.xterm.xterm-cursor-pointer,
+.xterm .xterm-cursor-pointer {
+    cursor: pointer;
+}
+
+.xterm.column-select.focus {
+    /* Column selection mode */
+    cursor: crosshair;
+}
+
+.xterm .xterm-accessibility:not(.debug),
+.xterm .xterm-message {
+    position: absolute;
+    left: 0;
+    top: 0;
+    bottom: 0;
+    right: 0;
+    z-index: 10;
+    color: transparent;
+    pointer-events: none;
+}
+
+.xterm .xterm-accessibility-tree:not(.debug) *::selection {
+  color: transparent;
+}
+
+.xterm .xterm-accessibility-tree {
+  user-select: text;
+  white-space: pre;
+}
+
+.xterm .live-region {
+    position: absolute;
+    left: -9999px;
+    width: 1px;
+    height: 1px;
+    overflow: hidden;
+}
+
+.xterm-dim {
+    /* Dim should not apply to background, so the opacity of the foreground color is applied
+     * explicitly in the generated class and reset to 1 here */
+    opacity: 1 !important;
+}
+
+.xterm-underline-1 { text-decoration: underline; }
+.xterm-underline-2 { text-decoration: double underline; }
+.xterm-underline-3 { text-decoration: wavy underline; }
+.xterm-underline-4 { text-decoration: dotted underline; }
+.xterm-underline-5 { text-decoration: dashed underline; }
+
+.xterm-overline {
+    text-decoration: overline;
+}
+
+.xterm-overline.xterm-underline-1 { text-decoration: overline underline; }
+.xterm-overline.xterm-underline-2 { text-decoration: overline double underline; }
+.xterm-overline.xterm-underline-3 { text-decoration: overline wavy underline; }
+.xterm-overline.xterm-underline-4 { text-decoration: overline dotted underline; }
+.xterm-overline.xterm-underline-5 { text-decoration: overline dashed underline; }
+
+.xterm-strikethrough {
+    text-decoration: line-through;
+}
+
+.xterm-screen .xterm-decoration-container .xterm-decoration {
+	z-index: 6;
+	position: absolute;
+}
+
+.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer {
+	z-index: 7;
+}
+
+.xterm-decoration-overview-ruler {
+    z-index: 8;
+    position: absolute;
+    top: 0;
+    right: 0;
+    pointer-events: none;
+}
+
+.xterm-decoration-top {
+    z-index: 2;
+    position: relative;
+}
+`;

package/lib/types/host/hub.d.ts

@@ -0,0 +1,39 @@
+/**
+ * dsh-single-terminal —— 终端 Hub：PTY 会话管理 + WebSocket 帧协议。
+ *
+ * - PTY 经插件自身依赖 node-pty（原生模块，external）直连 ConPTY/POSIX pty，
+ *   获得完整 resize/kill/数据流控制（宿主 ctx.subprocess 的 TerminalHandle
+ *   接口不暴露 resize，无法满足抽屉尺寸跟随）；
+ * - 会话与 WebSocket 连接解耦：页面刷新/抽屉关闭后会话保活，重连后 attach
+ *   回放环形缓冲（容量 scrollbackLimit）；
+ * - 多浏览器标签页可同时 attach 同一会话：输出广播、输入合并。
+ */
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { ShellRegistry } from './shells.ts';
+import type { TerminalPluginConfig } from './types.ts';
+export declare class TerminalHub {
+    private readonly config;
+    private readonly registry;
+    private readonly wss;
+    private readonly sockets;
+    private readonly sessions;
+    private nextSocketId;
+    constructor(config: TerminalPluginConfig, registry: ShellRegistry);
+    /** webServer.registerUpgrade 的 handler 入口（鉴权由插件入口完成后调用）。 */
+    handleUpgrade(req: IncomingMessage, socket: Duplex, head: Buffer): void;
+    /** 插件卸载：终止全部会话并断开所有连接。 */
+    dispose(): void;
+    private handleConnection;
+    private dispatch;
+    private open;
+    private close;
+    private killSession;
+    private resolveCwd;
+    private appendBuffer;
+    private snapshotFrame;
+    private sessionInfo;
+    private send;
+    private broadcast;
+}
+//# sourceMappingURL=hub.d.ts.map

package/lib/types/host/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../../src/host/hub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAA;AAC/D,OAAO,KAAK,EAAuC,oBAAoB,EAAE,MAAM,YAAY,CAAA;AA2B3F,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0C;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,YAAY,CAAI;gBAGL,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,aAAa;IAK1C,4DAA4D;IAC5D,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvE,0BAA0B;IAC1B,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,QAAQ;IAsDhB,OAAO,CAAC,IAAI;IA2DZ,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,SAAS;CAKlB"}