@linxin666/dsh-ssh 0.3.9 → 0.3.11

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

@@ -1,6 +1,7 @@
 import type { SshApi } from './api.ts';
 import type { PanelController } from './panel/controller.ts';
 import type { TerminalFontSource } from './panel/helpers.ts';
+import type { LocaleRefreshSource } from './sidebar-entry.ts';
 /** The injected panel container (kept in the DOM, hidden when inactive). */
 export declare const PANEL_VIEW_SELECTOR = "[data-dsh-ssh-view]";
 /**
@@ -9,6 +10,8 @@ export declare const PANEL_VIEW_SELECTOR = "[data-dsh-ssh-view]";
  * @param controller - the panel controller driving the view.
  * @param api - the SSH API client the tabs operate through.
  * @param terminalFont - live terminal-font setting source (issue #577).
+ * @param locale - locale-change source; when given, re-renders an open panel
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export declare function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource): () => void;
+export declare function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource, locale?: LocaleRefreshSource): () => void;

package/lib/types/client/panel/helpers.d.ts

@@ -8,6 +8,8 @@ import { type SshKey } from '../locales.ts';
 export type TranslateValues = Record<string, string | number>;
 /** Active dictionary, picked by the document language at call time. */
 export declare function dictionary(): Record<string, string>;
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export declare function setRuntimeTranslate(t: ((key: SshKey, values?: TranslateValues) => string) | undefined): void;
 /** 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. */

package/lib/types/client/sidebar-entry-core.d.ts

@@ -34,6 +34,16 @@ export interface SidebarEntryOptions {
     label(): string;
     /** Optional localized tooltip (title attribute). */
     tooltip?(): string;
+    /**
+     * Optional locale-change subscription: re-applies label / aria-label /
+     * tooltip whenever the active locale changes. Plain-DOM rows would
+     * otherwise keep the label captured at mount; pass the SDK locale runtime
+     * subscription (ctx.locale.subscribe) so the row follows the language
+     * switch without a reload.
+     */
+    refresh?: {
+        subscribe(listener: () => void): () => void;
+    };
     /** Click action (open/toggle the owning panel). */
     onToggle(): void;
     /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */

package/lib/types/client/sidebar-entry.d.ts

@@ -11,10 +11,16 @@
 import type { PanelController } from './panel/controller.ts';
 /** Stable data attribute identifying the injected entry row. */
 export declare const ENTRY_SELECTOR = "[data-dsh-ssh-entry]";
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource {
+    subscribe(listener: () => void): () => void;
+}
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the panel controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export declare function mountSidebarEntry(controller: PanelController): () => void;
+export declare function mountSidebarEntry(controller: PanelController, locale?: LocaleRefreshSource): () => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-ssh",
   "description": "Remote SSH operations for the dsh web GUI: host config store (~/.dsh/dsh-ssh.json, import from ~/.ssh/config), a persistent ssh2 connection pool with jump-host support, exec / PTY web terminal / SFTP transfer / local port-forward tunnels / cluster execution, plus agent tools (ssh_list, ssh_exec, ssh_upload, ssh_download, ssh_tunnel, ssh_cluster). Hot-pluggable — mounted via ~/.dsh/cordis.patch.yml + a profile node_modules symlink, no dsh source changes.",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -26,7 +26,7 @@
   },
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.2-alpha.1"
+      "dsh": ">=0.1.2-alpha.3"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -52,18 +52,18 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-timeout": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.3",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",

package/src/client/index.ts

@@ -25,6 +25,7 @@ import { en, zh, type SshKey } from './locales.ts'
 import { mountPanel } from './mount.tsx'
 import { PanelController } from './panel/controller.ts'
 import type { TerminalFontSource } from './panel/helpers.ts'
+import { setRuntimeTranslate } from './panel/helpers.ts'
 import { mountSidebarEntry } from './sidebar-entry.ts'
 import { reportDailyHeartbeat } from './telemetry.ts'
 
@@ -89,6 +90,11 @@ export function apply(ctx: ClientContext): void {
     }
   }, 'dsh-ssh: dictionaries')
 
+  // Wire the SDK translate seat into the module-level tt (sidebar row and
+  // other plain-DOM callers): reads the active locale at call time, so they
+  // follow the Language setting without a reload.
+  try { setRuntimeTranslate(ctx.locale.bind(NS)) } catch { /* locale missing: document-language fallback stays */ }
+
   const controller = new PanelController()
   const api = new SshApi()
   // Live terminal-font preference (issue #577): the settings namespace is
@@ -105,8 +111,8 @@ export function apply(ctx: ClientContext): void {
   }
   const disposers: Array<() => void> = []
   try {
-    disposers.push(mountSidebarEntry(controller))
-    disposers.push(mountPanel(controller, api, terminalFont))
+    disposers.push(mountSidebarEntry(controller, ctx.locale))
+    disposers.push(mountPanel(controller, api, terminalFont, ctx.locale))
   } catch (error) {
     // DOM failures degrade the panel, never the GUI.
     console.warn('[dsh-ssh] mount failed:', error)

package/src/client/mount.tsx

@@ -16,6 +16,7 @@ import type { SshApi } from './api.ts'
 import type { PanelController } from './panel/controller.ts'
 import type { TerminalFontSource } from './panel/helpers.ts'
 import { SshPanel } from './panel/SshPanel.tsx'
+import type { LocaleRefreshSource } from './sidebar-entry.ts'
 import css from './panel/panel.module.css'
 
 /** The injected panel container (kept in the DOM, hidden when inactive). */
@@ -40,11 +41,19 @@ function conversationColumn(): HTMLElement | undefined {
  * @param controller - the panel controller driving the view.
  * @param api - the SSH API client the tabs operate through.
  * @param terminalFont - live terminal-font setting source (issue #577).
+ * @param locale - locale-change source; when given, re-renders an open panel
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource): () => void {
+export function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource, locale?: LocaleRefreshSource): () => void {
   let root: Root | undefined
   let container: HTMLDivElement | undefined
+  let unsubscribeLocale: (() => void) | undefined
+  try {
+    unsubscribeLocale = locale?.subscribe(() => {
+      if (root !== undefined) root.render(<SshPanel controller={controller} api={api} terminalFont={terminalFont} />)
+    })
+  } catch { /* locale service absent: the panel follows its next natural re-render */ }
 
   const ensure = (): void => {
     if (container !== undefined) {
@@ -110,6 +119,7 @@ export function mountPanel(controller: PanelController, api: SshApi, terminalFon
     document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
     waitObserver.disconnect()
     unsubscribe()
+    unsubscribeLocale?.()
     document.documentElement.removeAttribute(ACTIVE_ATTR)
     root?.unmount()
     root = undefined

package/src/client/panel/helpers.ts

@@ -14,8 +14,22 @@ export function dictionary(): Record<string, string> {
   return lang.toLowerCase().startsWith('en') ? { ...en } : { ...zh }
 }
 
+/**
+ * SDK translate seat wired by the browser apply() once ctx.locale is bound
+ * (setRuntimeTranslate): reads the ACTIVE locale at call time, so plain-DOM
+ * surfaces follow a runtime language switch. The document-language pick stays
+ * as the unwired fallback (locale service absent, module-scope early callers).
+ */
+let runtimeT: ((key: SshKey, values?: TranslateValues) => string) | undefined
+
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export function setRuntimeTranslate(t: ((key: SshKey, values?: TranslateValues) => string) | undefined): void {
+  runtimeT = t
+}
+
 /** Translate a key with optional {name} template params (current language). */
 export function tt(key: SshKey, values?: TranslateValues): string {
+  if (runtimeT !== undefined) return runtimeT(key, values)
   return t(dictionary(), key, values)
 }
 

package/src/client/panel/panel.module.css

@@ -97,7 +97,8 @@ html[data-dsh-ssh-active]:not([data-dsh-taskboard-active]) [class*='centerCol']
 }
 
 /* Collapsed rail: icon-only, centered, matching the shell's 56px rail. */
-[data-dsh-frame][data-sidebar-collapsed] .entry {
+:global([data-dsh-frame][data-sidebar-collapsed]) .entry,
+:global([data-sidebar-collapsed]) .entry {
   justify-content: center;
   padding: 0;
   width: 36px;
@@ -106,7 +107,8 @@ html[data-dsh-ssh-active]:not([data-dsh-taskboard-active]) [class*='centerCol']
   border-radius: 50%;
 }
 
-[data-dsh-frame][data-sidebar-collapsed] .entryLabel {
+:global([data-dsh-frame][data-sidebar-collapsed]) .entryLabel,
+:global([data-sidebar-collapsed]) .entryLabel {
   display: none;
 }
 

package/src/client/sidebar-entry-core.ts

@@ -36,6 +36,14 @@ export interface SidebarEntryOptions {
   label(): string
   /** Optional localized tooltip (title attribute). */
   tooltip?(): string
+  /**
+   * Optional locale-change subscription: re-applies label / aria-label /
+   * tooltip whenever the active locale changes. Plain-DOM rows would
+   * otherwise keep the label captured at mount; pass the SDK locale runtime
+   * subscription (ctx.locale.subscribe) so the row follows the language
+   * switch without a reload.
+   */
+  refresh?: { subscribe(listener: () => void): () => void }
   /** Click action (open/toggle the owning panel). */
   onToggle(): void
   /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
@@ -76,7 +84,7 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
 }
 
 /** Build the entry row (a detached button; insert once the shell is up). */
-function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
+function createEntry(options: SidebarEntryOptions): { entry: HTMLButtonElement; applyLabel: () => void } {
   const entry = document.createElement('button')
   entry.type = 'button'
   entry.setAttribute(options.rowAttribute, '')
@@ -85,12 +93,20 @@ function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
     entry.setAttribute('data-dsh-part', 'sidebar-entry')
   }
   entry.className = options.css['entry'] ?? ''
-  entry.setAttribute('aria-label', options.label())
-  if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
-  entry.innerHTML = '<span class="' + (options.css['entryIcon'] ?? '') + '">' + options.icon
-    + '</span><span class="' + (options.css['entryLabel'] ?? '') + '">' + options.label() + '</span>'
+  const labelSpan = document.createElement('span')
+  labelSpan.className = options.css['entryLabel'] ?? ''
+  const iconSpan = document.createElement('span')
+  iconSpan.className = options.css['entryIcon'] ?? ''
+  iconSpan.innerHTML = options.icon
+  entry.append(iconSpan, labelSpan)
+  const applyLabel = (): void => {
+    entry.setAttribute('aria-label', options.label())
+    if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
+    labelSpan.textContent = options.label()
+  }
+  applyLabel()
   entry.addEventListener('click', options.onToggle)
-  return entry
+  return { entry, applyLabel }
 }
 
 /** Re-insert the entry after the New Session row (before the browser region). */
@@ -132,9 +148,18 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   if (typeof document !== 'undefined' && document.querySelector(options.rowSelector) !== null) {
     return () => {}
   }
-  const entry = createEntry(options)
+  const { entry, applyLabel } = createEntry(options)
   let root: HTMLElement | undefined
   let placed = false
+  let unsubscribeRefresh: (() => void) | undefined
+  if (options.refresh !== undefined) {
+    try {
+      unsubscribeRefresh = options.refresh.subscribe(applyLabel)
+    } catch {
+      // A throwing subscription must not break the mount; the label stays at
+      // its initial value and the next reload resolves it again.
+    }
+  }
 
   const tryPlace = (): void => {
     if (root !== undefined && !root.isConnected) {
@@ -202,6 +227,7 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   return () => {
     waitObserver.disconnect()
     rootObserver.disconnect()
+    unsubscribeRefresh?.()
     unsubscribeActive?.()
     entry.remove()
   }

package/src/client/sidebar-entry.ts

@@ -19,13 +19,18 @@ export const ENTRY_SELECTOR = '[data-dsh-ssh-entry]'
 /** Inline terminal glyph sized to the shell's current sidebar navigation icons. */
 const ICON = '<svg viewBox="0 0 16 16" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="1.75" y="2.25" width="12.5" height="11.5" rx="1.75"/><path d="M4.25 5.25l2.75 2.75-2.75 2.75"/><path d="M8.5 10.75h3.25"/></svg>'
 
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource { subscribe(listener: () => void): () => void }
+
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the panel controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export function mountSidebarEntry(controller: PanelController): () => void {
+export function mountSidebarEntry(controller: PanelController, locale?: LocaleRefreshSource): () => void {
   return mountSharedSidebarEntry({
     rowAttribute: 'data-dsh-ssh-entry',
     rowSelector: ENTRY_SELECTOR,
@@ -34,6 +39,7 @@ export function mountSidebarEntry(controller: PanelController): () => void {
     css,
     label: () => tt('entry.label'),
     tooltip: () => tt('entry.tooltip'),
+    refresh: locale === undefined ? undefined : { subscribe: (listener) => locale.subscribe(listener) },
     onToggle: () => { controller.toggle() },
     position: 'after',
     familySelectors: ['[data-dsh-taskboard-entry]', '[data-dsh-ssh-entry]'],