@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/lib/types/client/sidebar/panels/ssh/api.d.ts.map

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

package/lib/types/client/sidebar/panels/ssh/api.js

@@ -0,0 +1,333 @@
+/**
+ * Browser-side API client for the /api/dsh-ssh route family. The only data
+ * access path the panel components use — plain fetch/WebSocket, same origin.
+ */
+import { SSH_API, } from "../../../../core/ssh/protocol.js";
+/** Error carrying the route's JSON error message. */
+export class SshApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SshApiError';
+    }
+}
+/** Extract the `.error` message from a JSON error body; undefined when absent. */
+function extractError(text) {
+    if (text === '')
+        return undefined;
+    try {
+        const parsed = JSON.parse(text);
+        return typeof parsed?.error === 'string' ? parsed.error : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Parse a JSON response or throw an SshApiError. */
+async function readJson(response) {
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        throw new SshApiError(`HTTP ${response.status}: invalid JSON response`);
+    }
+    if (!response.ok) {
+        const message = typeof body === 'object' && body !== null && typeof body.error === 'string'
+            ? body.error
+            : `HTTP ${response.status}`;
+        throw new SshApiError(message);
+    }
+    return body;
+}
+/** Query-string helper. */
+function query(params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== '')
+            search.set(key, String(value));
+    }
+    const text = search.toString();
+    return text === '' ? '' : '?' + text;
+}
+/** The browser half's only data entry point. */
+export class SshApi {
+    // -------------------------------------------------------------- hosts
+    async listHosts(queryText) {
+        const response = await fetch(SSH_API.hosts + query({ query: queryText }));
+        const body = await readJson(response);
+        return body.hosts;
+    }
+    async createHost(payload) {
+        const response = await fetch(SSH_API.hosts, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        const body = await readJson(response);
+        return body.host;
+    }
+    async updateHost(alias, patch) {
+        const response = await fetch(SSH_API.hosts + query({ alias }), {
+            method: 'PATCH',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(patch),
+        });
+        const body = await readJson(response);
+        return body.host;
+    }
+    async deleteHost(alias) {
+        const response = await fetch(SSH_API.hosts + query({ alias }), { method: 'DELETE' });
+        await readJson(response);
+    }
+    async importSshConfig() {
+        const response = await fetch(SSH_API.importSshConfig, { method: 'POST' });
+        const body = await readJson(response);
+        return body.result;
+    }
+    // ---------------------------------------------------------------- ops
+    async testHost(alias) {
+        const response = await fetch(SSH_API.test, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ alias }),
+        });
+        const body = await readJson(response);
+        return body.result;
+    }
+    async exec(alias, command, timeoutMs) {
+        const response = await fetch(SSH_API.exec, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ alias, command, timeoutMs }),
+        });
+        const body = await readJson(response);
+        return body.result;
+    }
+    async cluster(options) {
+        const response = await fetch(SSH_API.cluster, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(options),
+        });
+        const body = await readJson(response);
+        return body.results;
+    }
+    // ----------------------------------------------------------------- ls
+    async ls(alias, path) {
+        const response = await fetch(SSH_API.ls + query({ alias, path }));
+        const body = await readJson(response);
+        return body.entries;
+    }
+    // ------------------------------------------------------------- tunnel
+    async listTunnels() {
+        const response = await fetch(SSH_API.tunnel, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ action: 'list' }),
+        });
+        const body = await readJson(response);
+        return body.tunnels;
+    }
+    async startTunnel(options) {
+        const response = await fetch(SSH_API.tunnel, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ action: 'start', ...options }),
+        });
+        const body = await readJson(response);
+        return body.tunnel;
+    }
+    async stopTunnel(tunnelId) {
+        const response = await fetch(SSH_API.tunnel, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ action: 'stop', tunnelId }),
+        });
+        const body = await readJson(response);
+        return body.ok;
+    }
+    async stopAllTunnels(alias) {
+        const response = await fetch(SSH_API.tunnel, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ action: 'stop-all', alias }),
+        });
+        const body = await readJson(response);
+        return body.stopped;
+    }
+    // ------------------------------------------------------------ transfer
+    /**
+     * Upload one file (raw bytes) to a remote path. Progress arrives through
+     * the NDJSON response stream; resolves when the result frame lands.
+     */
+    async uploadFile(file, alias, remotePath, onProgress) {
+        const response = await fetch(SSH_API.upload + query({ alias, remotePath }), {
+            method: 'POST',
+            body: file,
+        });
+        if (!response.ok || response.body === null) {
+            const text = await response.text().catch(() => '');
+            const error = extractError(text);
+            throw new SshApiError(error ?? `upload failed: HTTP ${response.status}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let finalError;
+        let sawResult = false;
+        let transferredBytes = 0;
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                if (line.trim() === '')
+                    continue;
+                let parsed;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                if (parsed.type === 'progress') {
+                    onProgress?.(parsed.progress);
+                }
+                else if (parsed.type === 'result') {
+                    sawResult = true;
+                    if (parsed.ok)
+                        transferredBytes = parsed.transferredBytes ?? 0;
+                    finalError = parsed.ok ? undefined : parsed.error ?? 'upload failed';
+                }
+            }
+        }
+        if (finalError !== undefined)
+            throw new SshApiError(finalError);
+        if (!sawResult)
+            throw new SshApiError('upload ended without a result frame — the transfer did not complete');
+        return { transferredBytes };
+    }
+    /**
+     * Download a remote file with client-side progress. Streams straight to
+     * disk when the File System Access API is available (no full-file RAM
+     * copy); otherwise falls back to an in-memory Blob.
+     */
+    async downloadFile(alias, remotePath, onProgress) {
+        const response = await fetch(SSH_API.download + query({ alias, remotePath }));
+        if (!response.ok || response.body === null) {
+            const text = await response.text().catch(() => '');
+            const error = extractError(text);
+            throw new SshApiError(error ?? `download failed: HTTP ${response.status}`);
+        }
+        const total = Number(response.headers.get('content-length') ?? '0');
+        const disposition = response.headers.get('content-disposition') ?? '';
+        const match = /filename="([^"]+)"/.exec(disposition);
+        const filename = match?.[1] ?? remotePath.split('/').pop() ?? 'download';
+        const reader = response.body.getReader();
+        const picker = typeof window !== 'undefined'
+            ? window.showSaveFilePicker
+            : undefined;
+        let streamed = false;
+        let writable;
+        const chunks = [];
+        let received = 0;
+        const progress = () => {
+            onProgress?.({
+                phase: 'transferring',
+                file: remotePath,
+                transferred: received,
+                total,
+                percent: total > 0 ? Math.round((received / total) * 1000) / 10 : 0,
+            });
+        };
+        try {
+            if (picker !== undefined) {
+                const handle = await picker.call(window, { suggestedName: filename });
+                writable = await handle.createWritable();
+                streamed = true;
+            }
+        }
+        catch {
+            // User cancelled the save dialog or the API is unavailable: fall back.
+        }
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (writable !== undefined) {
+                await writable.write(value);
+            }
+            else {
+                chunks.push(value);
+            }
+            received += value.length;
+            progress();
+        }
+        if (writable !== undefined)
+            await writable.close();
+        onProgress?.({ phase: 'done', file: remotePath, transferred: received, total: received > 0 ? received : total, percent: 100 });
+        return {
+            blob: streamed ? undefined : new Blob(chunks),
+            filename,
+            streamed,
+            bytes: received,
+        };
+    }
+    // ------------------------------------------------------------ terminal
+    /** Open a WebSocket terminal session. */
+    openTerminal(alias, cols, rows) {
+        const scheme = window.location.protocol === 'https:' ? 'wss' : 'ws';
+        const url = scheme + '://' + window.location.host + SSH_API.terminal + query({ alias, cols, rows });
+        const socket = new WebSocket(url);
+        const connection = {
+            onReady: undefined,
+            onOutput: undefined,
+            onExit: undefined,
+            onAuthPrompt: undefined,
+            send: (data) => {
+                if (socket.readyState === WebSocket.OPEN) {
+                    socket.send(JSON.stringify({ type: 'input', data }));
+                }
+            },
+            resize: (cols, rows) => {
+                if (socket.readyState === WebSocket.OPEN) {
+                    socket.send(JSON.stringify({ type: 'resize', cols, rows }));
+                }
+            },
+            sendAuthResponse: (responses) => {
+                if (socket.readyState === WebSocket.OPEN) {
+                    socket.send(JSON.stringify({ type: 'auth_response', responses }));
+                }
+            },
+            close: () => {
+                try {
+                    socket.close();
+                }
+                catch { /* already closed */ }
+            },
+        };
+        socket.onmessage = (event) => {
+            let frame;
+            try {
+                frame = JSON.parse(event.data);
+            }
+            catch {
+                return;
+            }
+            if (frame.type === 'ready')
+                connection.onReady?.();
+            else if (frame.type === 'output')
+                connection.onOutput?.(frame.data);
+            else if (frame.type === 'exit')
+                connection.onExit?.(frame.code, frame.error);
+            else if (frame.type === 'auth_prompt')
+                connection.onAuthPrompt?.(frame.name, frame.instructions, frame.prompts);
+        };
+        socket.onclose = () => { connection.onExit?.(null, 'connection closed'); };
+        socket.onerror = () => { connection.onExit?.(null, 'connection error'); };
+        return connection;
+    }
+}

package/lib/types/client/sidebar/panels/ssh/controller.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SSH panel controller: the single owner of the panel's open/closed state.
+ *
+ * Framework-free (structural runtime faces, task-board core/controller.ts
+ * style) so the DOM mounts and the React panel share one tiny subscription
+ * surface. The state lives only for the browser session (no persistence).
+ */
+/** Immutable controller snapshot for UI subscriptions. */
+export interface PanelControllerSnapshot {
+    panelOpen: boolean;
+}
+/** The panel state owner the sidebar entry toggles and the view renders from. */
+export declare class PanelController {
+    private panelOpen;
+    private listeners;
+    getSnapshot(): PanelControllerSnapshot;
+    subscribe(fn: () => void): () => void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    private notify;
+}
+//# sourceMappingURL=controller.d.ts.map

package/lib/types/client/sidebar/panels/ssh/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/client/sidebar/panels/ssh/controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,iFAAiF;AACjF,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAwB;IAEzC,WAAW,IAAI,uBAAuB;IAItC,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKrC,IAAI,IAAI,IAAI;IAMZ,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAKd,OAAO,CAAC,MAAM;CAGf"}

package/lib/types/client/sidebar/panels/ssh/controller.js

@@ -0,0 +1,41 @@
+/**
+ * SSH panel controller: the single owner of the panel's open/closed state.
+ *
+ * Framework-free (structural runtime faces, task-board core/controller.ts
+ * style) so the DOM mounts and the React panel share one tiny subscription
+ * surface. The state lives only for the browser session (no persistence).
+ */
+/** The panel state owner the sidebar entry toggles and the view renders from. */
+export class PanelController {
+    panelOpen = false;
+    listeners = new Set();
+    getSnapshot() {
+        return { panelOpen: this.panelOpen };
+    }
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => { this.listeners.delete(fn); };
+    }
+    open() {
+        if (this.panelOpen)
+            return;
+        this.panelOpen = true;
+        this.notify();
+    }
+    close() {
+        if (!this.panelOpen)
+            return;
+        this.panelOpen = false;
+        this.notify();
+    }
+    toggle() {
+        if (this.panelOpen)
+            this.close();
+        else
+            this.open();
+    }
+    notify() {
+        for (const fn of [...this.listeners])
+            fn();
+    }
+}

package/lib/types/client/sidebar/panels/ssh/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared panel helpers: the active-dictionary pick (document-language based,
+ * task-board precedent) bound to the dsh-ssh interpolator in locales.ts, plus
+ * a small error-message extractor. All copy stays in the locale dictionaries.
+ */
+import { type SshKey } from './locales.ts';
+/** Template values accepted by the interpolator. */
+export type TranslateValues = Record<string, string | number>;
+/** Active dictionary, picked by the document language at call time. */
+export declare function dictionary(): Record<string, string>;
+/** Translate a key with optional {name} template params (current language). */
+export declare function tt(key: SshKey, values?: TranslateValues): string;
+/** Human-readable error text from an unknown thrown value. */
+export declare function errorMessage(error: unknown): string;
+/**
+ * The terminal font stack used before issue #577, kept as the last resort
+ * when neither the plugin setting nor a CSS custom property names a font.
+ */
+export declare const TERMINAL_FONT_FALLBACK = "Menlo, Consolas, \"Liberation Mono\", monospace";
+/**
+ * Live source of the user's configured terminal font family: the client
+ * entry binds the dsh-ssh settings namespace into one of these and hands it
+ * to the panel, so a settings change re-applies without a remount.
+ */
+export interface TerminalFontSource {
+    /** Current configured family, or undefined when unset / not yet loaded. */
+    get(): string | undefined;
+    /** Subscribe to changes; the returned function unsubscribes. */
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Resolve the xterm `fontFamily` (issue #577). xterm's DOM renderer takes
+ * the font only from constructor/options, so a plain stylesheet rule cannot
+ * retarget it — the value must be read back into the options. The chain,
+ * first non-empty value wins:
+ *   1. `override` — the `terminalFontFamily` plugin setting;
+ *   2. `--dsh-ssh-terminal-font` — dedicated hook for skins and user CSS
+ *      (e.g. a Nerd Font for powerline glyphs);
+ *   3. `--ds-font-family-code` — the official code-font token several skins
+ *      already remap;
+ *   4. {@link TERMINAL_FONT_FALLBACK}.
+ */
+export declare function resolveTerminalFontFamily(override?: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/types/client/sidebar/panels/ssh/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/client/sidebar/panels/ssh/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAErD,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAE7D,uEAAuE;AACvE,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnD;AAED,+EAA+E;AAC/E,wBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oDAAkD,CAAA;AAErF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,GAAG,IAAI,MAAM,GAAG,SAAS,CAAA;IACzB,gEAAgE;IAChE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYnE"}

package/lib/types/client/sidebar/panels/ssh/helpers.js

@@ -0,0 +1,53 @@
+/**
+ * Shared panel helpers: the active-dictionary pick (document-language based,
+ * task-board precedent) bound to the dsh-ssh interpolator in locales.ts, plus
+ * a small error-message extractor. All copy stays in the locale dictionaries.
+ */
+import { en, t, zh } from "./locales.js";
+/** Active dictionary, picked by the document language at call time. */
+export function dictionary() {
+    const lang = typeof document !== 'undefined' ? document.documentElement.lang : 'zh';
+    return lang.toLowerCase().startsWith('en') ? { ...en } : { ...zh };
+}
+/** Translate a key with optional {name} template params (current language). */
+export function tt(key, values) {
+    return t(dictionary(), key, values);
+}
+/** Human-readable error text from an unknown thrown value. */
+export function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/**
+ * The terminal font stack used before issue #577, kept as the last resort
+ * when neither the plugin setting nor a CSS custom property names a font.
+ */
+export const TERMINAL_FONT_FALLBACK = 'Menlo, Consolas, "Liberation Mono", monospace';
+/**
+ * Resolve the xterm `fontFamily` (issue #577). xterm's DOM renderer takes
+ * the font only from constructor/options, so a plain stylesheet rule cannot
+ * retarget it — the value must be read back into the options. The chain,
+ * first non-empty value wins:
+ *   1. `override` — the `terminalFontFamily` plugin setting;
+ *   2. `--dsh-ssh-terminal-font` — dedicated hook for skins and user CSS
+ *      (e.g. a Nerd Font for powerline glyphs);
+ *   3. `--ds-font-family-code` — the official code-font token several skins
+ *      already remap;
+ *   4. {@link TERMINAL_FONT_FALLBACK}.
+ */
+export function resolveTerminalFontFamily(override) {
+    const trimmed = override?.trim();
+    if (trimmed !== undefined && trimmed !== '')
+        return trimmed;
+    if (typeof getComputedStyle === 'function' && typeof document !== 'undefined') {
+        const target = document.body ?? document.documentElement;
+        const style = getComputedStyle(target);
+        for (const name of ['--dsh-ssh-terminal-font', '--ds-font-family-code']) {
+            const value = style.getPropertyValue(name).trim();
+            if (value !== '')
+                return value;
+        }
+    }
+    return TERMINAL_FONT_FALLBACK;
+}

package/lib/types/client/sidebar/panels/ssh/locales.d.ts

@@ -0,0 +1,155 @@
+/**
+ * dsh-ssh surface copy: zh is the key source, en mirrors every key.
+ */
+export declare const zh: {
+    readonly 'entry.label': "SSH";
+    readonly 'entry.tooltip': "远程 SSH 运维面板";
+    readonly 'panel.title': "远程 SSH";
+    readonly 'panel.intro': "主机、终端、文件传输、端口转发与集群巡检；每一项都在打开时各自取数。";
+    readonly 'tab.hosts': "主机";
+    readonly 'tab.terminal': "终端";
+    readonly 'tab.transfer': "传输";
+    readonly 'tab.tunnels': "隧道";
+    readonly 'tab.cluster': "集群";
+    readonly 'hosts.empty': "尚未配置主机。点击「新增主机」添加，或从 ~/.ssh/config 导入。";
+    readonly 'hosts.add': "新增主机";
+    readonly 'hosts.import': "导入 ~/.ssh/config";
+    readonly 'hosts.search': "搜索别名 / 描述 / 标签…";
+    readonly 'hosts.groupBy.label': "分组方式";
+    readonly 'hosts.groupBy.none': "不分组";
+    readonly 'hosts.groupBy.environment': "按环境分组";
+    readonly 'hosts.groupBy.tags': "按标签分组";
+    readonly 'hosts.group.ungrouped': "未设置环境";
+    readonly 'hosts.group.noTags': "无标签";
+    readonly 'hosts.group.count': "{count} 台";
+    readonly 'hosts.group.testAll': "测试全部";
+    readonly 'hosts.col.alias': "别名";
+    readonly 'hosts.col.host': "主机";
+    readonly 'hosts.col.user': "用户";
+    readonly 'hosts.col.auth': "认证";
+    readonly 'hosts.col.environment': "环境";
+    readonly 'hosts.col.tags': "标签";
+    readonly 'hosts.col.description': "备注";
+    readonly 'hosts.col.actions': "操作";
+    readonly 'hosts.test': "测试";
+    readonly 'hosts.edit': "编辑";
+    readonly 'hosts.delete': "删除";
+    readonly 'hosts.deleteConfirm': "确定删除主机「{alias}」？将同时停止其隧道。";
+    readonly 'hosts.imported': "解析 {parsed} 个配置块，新增 {added} 台主机，跳过 {skipped} 个。";
+    readonly 'hosts.testing': "连接测试中…";
+    readonly 'hosts.testOk': "连接成功（{latency} ms）";
+    readonly 'hosts.testFail': "连接失败：{error}";
+    readonly 'hosts.connected': "连接";
+    readonly 'hosts.notConnected': "未连接";
+    readonly 'form.title.create': "新增主机";
+    readonly 'form.title.edit': "编辑主机 {alias}";
+    readonly 'form.alias': "别名";
+    readonly 'form.aliasHint': "小写字母、数字与单连字符，操作时使用";
+    readonly 'form.host': "主机地址";
+    readonly 'form.port': "端口";
+    readonly 'form.user': "用户名";
+    readonly 'form.auth': "认证方式";
+    readonly 'form.auth.key': "密钥";
+    readonly 'form.auth.password': "密码";
+    readonly 'form.auth.agent': "SSH Agent";
+    readonly 'form.agentPath': "Agent 路径";
+    readonly 'form.agentPathHint': "留空自动检测（SSH_AUTH_SOCK / Windows Pageant）；也可填 socket 路径或 pageant";
+    readonly 'form.authKeepHint': "编辑时密钥/密码/Agent 留空将保留原认证方式与已存凭据；如需更换认证方式请填写新凭据。";
+    readonly 'form.keyPath': "私钥路径";
+    readonly 'form.keyPathHint': "如 ~/.ssh/id_ed25519";
+    readonly 'form.passphrase': "密钥口令";
+    readonly 'form.password': "密码";
+    readonly 'form.passwordHint': "明文保存在 $DSH_HOME/dsh-ssh.json（本机私有文件）";
+    readonly 'form.passwordRequired': "密码认证需要填写密码。";
+    readonly 'form.proxyJump': "跳板机别名";
+    readonly 'form.proxyJumpHint': "逗号分隔的本地主机别名，按顺序连接";
+    readonly 'form.description': "备注";
+    readonly 'form.environment': "环境";
+    readonly 'form.environmentHint': "如 development / production";
+    readonly 'form.tags': "标签";
+    readonly 'form.tagsHint': "逗号分隔";
+    readonly 'form.location': "位置";
+    readonly 'form.save': "保存";
+    readonly 'form.cancel': "取消";
+    readonly 'form.required': "请填写必填字段：别名、主机地址、用户名。";
+    readonly 'form.portInvalid': "端口必须是 1-65535 之间的整数。";
+    readonly 'terminal.selectHost': "选择主机";
+    readonly 'terminal.connect': "连接";
+    readonly 'terminal.disconnect': "断开";
+    readonly 'terminal.placeholder': "选择主机后点击「连接」打开远程终端。";
+    readonly 'terminal.connecting': "正在连接…";
+    readonly 'terminal.ready': "终端已连接（{alias}）";
+    readonly 'terminal.exited': "终端已退出（{alias}）";
+    readonly 'terminal.error': "终端错误：{error}";
+    readonly 'terminal.auth.title': "二次身份验证 (2FA / 交互式认证)";
+    readonly 'terminal.auth.submit': "提交验证码";
+    readonly 'terminal.auth.cancel': "取消";
+    readonly 'terminal.auth.placeholder': "请输入验证码或口令";
+    readonly 'terminal.auth.hint': "服务器请求进行交互式二次验证（输入仅本次生效，不落盘）：";
+    readonly 'transfer.selectHost': "选择主机";
+    readonly 'transfer.remotePath': "远程路径";
+    readonly 'transfer.remotePathHint': "如 /tmp/ 或 /home/user/app.tar.gz";
+    readonly 'transfer.upload': "上传";
+    readonly 'transfer.uploading': "正在上传 {file}…";
+    readonly 'transfer.download': "下载";
+    readonly 'transfer.downloading': "正在下载…";
+    readonly 'transfer.done': "完成：{bytes} 字节";
+    readonly 'transfer.failed': "传输失败：{error}";
+    readonly 'transfer.browseRemote': "浏览远程目录";
+    readonly 'transfer.refresh': "刷新";
+    readonly 'transfer.name': "名称";
+    readonly 'transfer.upLevel': "上级目录";
+    readonly 'transfer.size': "大小";
+    readonly 'transfer.modified': "修改时间";
+    readonly 'transfer.bytes': "{value} B";
+    readonly 'transfer.kib': "{value} KB";
+    readonly 'transfer.mib': "{value} MB";
+    readonly 'transfer.gib': "{value} GB";
+    readonly 'transfer.percent': "{value}%";
+    readonly 'transfer.speed': "{value}/s";
+    readonly 'transfer.dir': "目录";
+    readonly 'transfer.file': "文件";
+    readonly 'tunnel.empty': "没有活跃的隧道。";
+    readonly 'tunnel.start': "新建隧道";
+    readonly 'tunnel.alias': "主机别名";
+    readonly 'tunnel.remotePort': "远程端口";
+    readonly 'tunnel.remoteHost': "远程主机";
+    readonly 'tunnel.remoteHostHint': "默认 127.0.0.1（服务器自身）";
+    readonly 'tunnel.localPort': "本地端口";
+    readonly 'tunnel.localPortHint': "留空自动分配";
+    readonly 'tunnel.stop': "停止";
+    readonly 'tunnel.stopAll': "全部停止";
+    readonly 'tunnel.stopAllConfirm': "确定停止全部隧道吗？";
+    readonly 'tunnel.row': "{alias}: 127.0.0.1:{localPort} -> {remoteHost}:{remotePort}";
+    readonly 'tunnel.started': "隧道已建立：127.0.0.1:{localPort}";
+    readonly 'tunnel.failed': "隧道启动失败：{error}";
+    readonly 'cluster.command': "命令";
+    readonly 'cluster.run': "执行";
+    readonly 'cluster.confirm': "确定在匹配的主机上执行该命令吗？该操作会真实运行在远程服务器上。";
+    readonly 'cluster.aliases': "主机别名（逗号分隔，留空为全部）";
+    readonly 'cluster.environment': "环境过滤";
+    readonly 'cluster.tags': "标签过滤（逗号分隔）";
+    readonly 'cluster.results': "执行结果";
+    readonly 'cluster.empty': "输入命令后点击「执行」。";
+    readonly 'cluster.noMatch': "没有匹配的主机。";
+    readonly 'cluster.ok': "成功";
+    readonly 'cluster.fail': "失败";
+    readonly 'cluster.timeout': "超时";
+    readonly 'cluster.col.alias': "主机";
+    readonly 'cluster.col.status': "状态";
+    readonly 'cluster.col.exit': "退出码";
+    readonly 'cluster.col.stdout': "标准输出";
+    readonly 'cluster.col.stderr': "标准错误";
+    readonly 'cluster.col.error': "错误";
+    readonly 'cluster.col.duration': "耗时";
+    readonly 'common.loading': "加载中…";
+    readonly 'common.error': "出错：{error}";
+    readonly 'common.refresh': "刷新";
+    readonly 'common.confirm': "确定";
+};
+export declare const en: Record<keyof typeof zh, string>;
+/** Locale key union. */
+export type SshKey = keyof typeof zh;
+/** Tiny interpolation: {name} -> value. */
+export declare function t(dictionary: Record<string, string>, key: string, values?: Record<string, string | number>): string;
+//# sourceMappingURL=locales.d.ts.map