dsh-bash-terminal-ts 0.7.1 → 0.8.0

package/lib/locales.js

@@ -0,0 +1,422 @@
+// The client dictionary for the settings surface, all nine host languages.
+//
+// `zh` is the key source: every other language is typed `Record<keyof typeof zh,
+// string>`, so a missing or misspelled key is a compile error rather than a
+// runtime fallback. That choice is the whole reason the file is structured this
+// way - the previous inline dictionaries were seven loose `Record<string, string>`
+// maps, which let two languages go missing and let a renamed key ship silently.
+//
+// The other half of the discipline lives in `locale/<lang>.json`: the host reads
+// plugin *metadata* from those files (and `en.json` is the anchor its package-meta
+// scan requires). A key defined here but rendered nowhere is dead text - a
+// missing-look bug, not a spare string.
+/** The key set, defined by `zh` below. */
+const zh = {
+    "shell.title": "默认终端",
+    "shell.description": "shell 工具执行命令时使用的终端",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "设置面不可用：宿主配置桥未响应（检查宿主是否为 compat 版）",
+    "dock.title": "底部终端",
+    "dock.hint": "开关只影响底部工作台里的终端，不改变官方右栏终端，也不给模型新增能力。",
+    "dock.state.available": "可用",
+    "dock.state.notInstalled": "未探测到",
+    "dock.state.noDistro": "无已安装发行版",
+    "dock.state.launcherOnly": "只找到启动器，无法内嵌",
+    "dock.powershell.locked": "PowerShell 是保底后端，无法关闭。",
+    "dock.defaultChoice": "默认 shell（只能从已激活且可用的项中选择）",
+    "dock.wslDistro": "WSL 发行版（留空表示 WSL 默认发行版）",
+    "dock.fallback.notice": "原来选择的 {from} 当前不可用，本次已改用 {to}。",
+    "dock.floor.notice": "所有 shell 都已关闭或不可用，本次已用 {to} 兜底。",
+    "dock.unavailable.noPty": "本机没有可用的 PTY 后端：node-pty 未构建且宿主未提供终端能力缝（可执行 pnpm approve-builds）。",
+    "dock.unavailable.noSocket": "宿主未开放 WebSocket 升级通道，底部终端无法接收输出。",
+    "dock.unavailable.notInstalled": "宿主尚未挂载终端路由，暂时无法提供底部终端。",
+    "dock.hostProvided": "当前由宿主终端提供，本插件已让位。",
+    "dock.applying": "保存中…",
+    "dock.failed": "写入失败：{message}",
+    "dock.terminals": "当前有 {count} 个终端在运行",
+    "dock.refresh": "重新探测",
+    "dock.enabled.title": "启用底部终端",
+    "dock.enabled.description": "总开关。关闭后隐藏下方各 shell 子开关，且不再分配终端",
+    "dock.enabled.off": "已关闭。打开后才会按可用性列出各 shell 子开关",
+    "dock.shim.title": "接管官方终端行",
+    "dock.shim.description": "仅在宿主没有终端控制器时打开。同名服务重复注册会让对方启动失败，所以默认关闭。",
+    "dock.shim.published": "已接管：官方那行「终端」现在由本插件供电",
+    "dock.shim.hostProvides": "宿主已提供 webTerminals，未接管（官方那行本来就可用）",
+    "dock.state.floor": "保底",
+    "tab.title": "终端（多 shell）",
+    "tab.description": "在本插件的 PTY 后端上打开 Git Bash / MSYS2 / WSL / PowerShell，与官方终端并存",
+    "tab.new": "新建",
+    "tab.noShell": "无可用 shell（请在设置里激活）",
+    "tab.phase.allocating": "正在分配",
+    "tab.phase.connecting": "正在连接",
+    "tab.phase.running": "运行中",
+    "tab.phase.exited": "已退出",
+    "tab.phase.failed": "失败",
+};
+const en = {
+    "shell.title": "Default terminal",
+    "shell.description": "Terminal used by the shell tool",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Settings unavailable: the host config bridge did not respond (is the host a compat build?)",
+    "dock.title": "Bottom terminal",
+    "dock.hint": "These switches only affect the terminal in the bottom dock. The official right-hand terminal and the model's tools are untouched.",
+    "dock.state.available": "Available",
+    "dock.state.notInstalled": "Not found",
+    "dock.state.noDistro": "No distro installed",
+    "dock.state.launcherOnly": "Only a launcher was found; it cannot be embedded",
+    "dock.powershell.locked": "PowerShell is the fallback backend and cannot be turned off.",
+    "dock.defaultChoice": "Default shell (only activated and available choices are listed)",
+    "dock.wslDistro": "WSL distribution (empty uses the WSL default)",
+    "dock.fallback.notice": "{from} is not available right now, so this terminal started with {to}.",
+    "dock.floor.notice": "Every shell is off or unavailable, so this terminal fell back to {to}.",
+    "dock.unavailable.noPty": "No PTY backend on this machine: node-pty did not build and the host exposes no terminal seam (run pnpm approve-builds).",
+    "dock.unavailable.noSocket": "The host does not expose a WebSocket upgrade route, so the bottom terminal cannot receive output.",
+    "dock.unavailable.notInstalled": "The host has not mounted the terminal routes yet, so no bottom terminal is offered.",
+    "dock.hostProvided": "The host terminal is in charge; this plugin stood down.",
+    "dock.applying": "Saving…",
+    "dock.failed": "Write failed: {message}",
+    "dock.terminals": "{count} terminal(s) running",
+    "dock.refresh": "Re-detect",
+    "dock.enabled.title": "Enable bottom terminal",
+    "dock.enabled.description": "Master switch. Off hides the per-shell switches below and refuses allocations",
+    "dock.enabled.off": "Turned off. The per-shell switches appear once this is on",
+    "dock.shim.title": "Take over the official terminal row",
+    "dock.shim.description": "Turn on only where the host has no terminal controller. Publishing the same service name twice fails the other provider, so this is off by default.",
+    "dock.shim.published": "Taken over: the official “Terminal” row is now powered by this plugin",
+    "dock.shim.hostProvides": "The host already publishes webTerminals; nothing was taken over (the official row already works)",
+    "dock.state.floor": "floor",
+    "tab.title": "Terminal (multi-shell)",
+    "tab.description": "Opens Git Bash / MSYS2 / WSL / PowerShell over this plugin's PTY backend, alongside the official terminal",
+    "tab.new": "New",
+    "tab.noShell": "No shell available (enable one in settings)",
+    "tab.phase.allocating": "allocating",
+    "tab.phase.connecting": "connecting",
+    "tab.phase.running": "running",
+    "tab.phase.exited": "exited",
+    "tab.phase.failed": "failed",
+};
+const ja = {
+    "shell.title": "既定ターミナル",
+    "shell.description": "shell ツールがコマンド実行に使うターミナル",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "設定面を利用できません：ホストの設定ブリッジが応答しません（compat ビルドですか？）",
+    "dock.title": "下部ターミナル",
+    "dock.hint": "このスイッチは下部ドックのターミナルのみに影響します。公式の右側ターミナルやモデルのツールは変更されません。",
+    "dock.state.available": "利用可",
+    "dock.state.notInstalled": "見つかりません",
+    "dock.state.noDistro": "インストール済みディストリビューションなし",
+    "dock.state.launcherOnly": "ランチャーのみ検出、埋め込み不可",
+    "dock.powershell.locked": "PowerShell は最後の代替のため無効化できません。",
+    "dock.defaultChoice": "既定の shell（有効かつ利用可能な項目のみ表示）",
+    "dock.wslDistro": "WSL ディストリビューション（空なら WSL の既定）",
+    "dock.fallback.notice": "{from} は現在利用できないため、{to} で起動しました。",
+    "dock.floor.notice": "すべての shell が無効または利用不可のため、{to} に代替しました。",
+    "dock.unavailable.noPty": "このマシンに利用可能な PTY バックエンドがありません：node-pty がビルドされておらず、ホストにも terminal seam がありません（pnpm approve-builds を実行）。",
+    "dock.unavailable.noSocket": "ホストが WebSocket アップグレード経路を公開していないため、下部ターミナルは出力を受け取れません。",
+    "dock.unavailable.notInstalled": "ホストがターミナル経路をまだ読み込んでいないため、下部ターミナルは提供されません。",
+    "dock.hostProvided": "ホストのターミナルが担当しているため、本プラグインは譲りました。",
+    "dock.applying": "保存中…",
+    "dock.failed": "書き込み失敗：{message}",
+    "dock.terminals": "{count} 個のターミナルが実行中",
+    "dock.refresh": "再検出",
+    "dock.enabled.title": "下部ターミナルを有効化",
+    "dock.enabled.description": "親スイッチ。オフにすると下の各 shell の子スイッチは隠れ、割り当ても行われません",
+    "dock.enabled.off": "オフ中です。オンにすると利用可能な shell の子スイッチが一覧表示されます",
+    "dock.shim.title": "公式ターミナル行を引き継ぐ",
+    "dock.shim.description": "ホストにターミナルコントローラが無い環境でのみ有効にしてください。同名サービスの二重登録は相手側の起動を失敗させるため、既定は無効です。",
+    "dock.shim.published": "引き継ぎました：公式の「ターミナル」行は本プラグインが供給しています",
+    "dock.shim.hostProvides": "ホストがすでに webTerminals を提供しているため引き継ぎませんでした（公式行はそのまま使えます）",
+    "dock.state.floor": "代替",
+    "tab.title": "ターミナル（複数 shell）",
+    "tab.description": "本プラグインの PTY バックエンドで Git Bash / MSYS2 / WSL / PowerShell を開きます。公式ターミナルと併存します",
+    "tab.new": "新規",
+    "tab.noShell": "利用可能な shell がありません（設定で有効化）",
+    "tab.phase.allocating": "割り当て中",
+    "tab.phase.connecting": "接続中",
+    "tab.phase.running": "実行中",
+    "tab.phase.exited": "終了",
+    "tab.phase.failed": "失敗",
+};
+const ko = {
+    "shell.title": "기본 터미널",
+    "shell.description": "shell 도구가 명령을 실행할 때 사용하는 터미널",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "설정면을 사용할 수 없습니다: 호스트 설정 브리지가 응답하지 않습니다 (compat 빌드인가요?)",
+    "dock.title": "하단 터미널",
+    "dock.hint": "이 스위치는 하단 독의 터미널에만 영향을 줍니다. 공식 오른쪽 터미널과 모델 도구는 변경되지 않습니다.",
+    "dock.state.available": "사용 가능",
+    "dock.state.notInstalled": "탐지되지 않음",
+    "dock.state.noDistro": "설치된 배포판 없음",
+    "dock.state.launcherOnly": "런처만 발견되어 내장할 수 없음",
+    "dock.powershell.locked": "PowerShell은 최종 대체 항목이므로 끌 수 없습니다.",
+    "dock.defaultChoice": "기본 shell (활성화되고 사용 가능한 항목만 표시)",
+    "dock.wslDistro": "WSL 배포판 (비우면 WSL 기본값)",
+    "dock.fallback.notice": "{from}을(를) 지금 사용할 수 없어 {to}(으)로 시작했습니다.",
+    "dock.floor.notice": "모든 shell이 꺼졌거나 사용 불가하여 {to}(으)로 대체했습니다.",
+    "dock.unavailable.noPty": "이 컴퓨터에 사용 가능한 PTY 백엔드가 없습니다: node-pty가 빌드되지 않았고 호스트에 terminal seam도 없습니다 (pnpm approve-builds 실행).",
+    "dock.unavailable.noSocket": "호스트가 WebSocket 업그레이드 경로를 공개하지 않아 하단 터미널이 출력을 받을 수 없습니다.",
+    "dock.unavailable.notInstalled": "호스트가 터미널 경로를 아직 올려놓지 않아 하단 터미널을 제공하지 않습니다.",
+    "dock.hostProvided": "호스트 터미널이 담당하므로 이 플러그인은 양보했습니다.",
+    "dock.applying": "저장 중…",
+    "dock.failed": "쓰기 실패: {message}",
+    "dock.terminals": "{count}개 터미널 실행 중",
+    "dock.refresh": "다시 감지",
+    "dock.enabled.title": "하단 터미널 활성화",
+    "dock.enabled.description": "상위 스위치. 끄면 아래 shell별 하위 스위치가 숨겨지고 할당이 거부됩니다",
+    "dock.enabled.off": "꺼져 있습니다. 켜면 사용 가능한 shell의 하위 스위치가 표시됩니다",
+    "dock.shim.title": "공식 터미널 행 인수",
+    "dock.shim.description": "호스트에 터미널 컨트롤러가 없는 환경에서만 켜세요. 같은 이름의 서비스를 두 번 등록하면 상대 등록이 실패하므로 기본값은 꺼짐입니다.",
+    "dock.shim.published": "인수 완료: 공식 “터미널” 행을 이 플러그인이 제공합니다",
+    "dock.shim.hostProvides": "호스트가 이미 webTerminals를 제공하므로 인수하지 않았습니다 (공식 행은 그대로 사용 가능)",
+    "dock.state.floor": "대체",
+    "tab.title": "터미널(다중 shell)",
+    "tab.description": "이 플러그인의 PTY 백엔드로 Git Bash / MSYS2 / WSL / PowerShell 을 엽니다. 공식 터미널과 함께 존재합니다",
+    "tab.new": "새로 만들기",
+    "tab.noShell": "사용 가능한 shell 없음(설정에서 활성화)",
+    "tab.phase.allocating": "할당 중",
+    "tab.phase.connecting": "연결 중",
+    "tab.phase.running": "실행 중",
+    "tab.phase.exited": "종료됨",
+    "tab.phase.failed": "실패",
+};
+const fr = {
+    "shell.title": "Terminal par défaut",
+    "shell.description": "Terminal utilisé par l'outil shell",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Paramètres indisponibles: le pont de configuration de l'hôte n'a pas répondu",
+    "dock.title": "Terminal inférieur",
+    "dock.hint": "Ces interrupteurs ne concernent que le terminal du dock bas. Le terminal officiel de droite et les outils du modèle restent inchangés.",
+    "dock.state.available": "Disponible",
+    "dock.state.notInstalled": "Non détecté",
+    "dock.state.noDistro": "Aucune distribution installée",
+    "dock.state.launcherOnly": "Seuls des lanceurs ont été trouvés; intégration impossible",
+    "dock.powershell.locked": "PowerShell sert de repli final et ne peut pas être désactivé.",
+    "dock.defaultChoice": "Shell par défaut (seuls les choix activés et disponibles sont listés)",
+    "dock.wslDistro": "Distribution WSL (vide = distribution WSL par défaut)",
+    "dock.fallback.notice": "{from} n'est pas disponible actuellement, ce terminal a donc démarré avec {to}.",
+    "dock.floor.notice": "Tous les shells sont désactivés ou indisponibles, repli sur {to}.",
+    "dock.unavailable.noPty": "Aucun backend PTY disponible : node-pty n'est pas construit et l'hôte n'expose pas de seam terminal (exécutez pnpm approve-builds).",
+    "dock.unavailable.noSocket": "L'hôte n'expose pas de route d'amélioration WebSocket; le terminal inférieur ne peut pas recevoir de sortie.",
+    "dock.unavailable.notInstalled": "L'hôte n'a pas encore monté les routes du terminal; aucun terminal inférieur n'est proposé.",
+    "dock.hostProvided": "Le terminal de l'hôte prend la main; ce plugin s'est effacé.",
+    "dock.applying": "Enregistrement…",
+    "dock.failed": "Écriture échouée : {message}",
+    "dock.terminals": "{count} terminal(aux) en cours",
+    "dock.refresh": "Redétecter",
+    "dock.enabled.title": "Activer le terminal inférieur",
+    "dock.enabled.description": "Interrupteur principal. Désactivé, il masque les sous-interrupteurs shell et refuse les allocations",
+    "dock.enabled.off": "Désactivé. Les sous-interrupteurs des shells disponibles apparaissent une fois activé",
+    "dock.shim.title": "Reprendre la ligne de terminal officielle",
+    "dock.shim.description": "À activer seulement si l’hôte n’a pas de contrôleur de terminal. Publier deux fois le même nom de service fait échouer l’autre fournisseur ; désactivé par défaut.",
+    "dock.shim.published": "Reprise : la ligne « Terminal » officielle est désormais alimentée par ce plugin",
+    "dock.shim.hostProvides": "L’hôte publie déjà webTerminals ; aucune reprise (la ligne officielle fonctionne déjà)",
+    "dock.state.floor": "repli",
+    "tab.title": "Terminal (multi-shell)",
+    "tab.description": "Ouvre Git Bash / MSYS2 / WSL / PowerShell sur le backend PTY de ce plugin, à côté du terminal officiel",
+    "tab.new": "Nouveau",
+    "tab.noShell": "Aucun shell disponible (activez-en un dans les paramètres)",
+    "tab.phase.allocating": "allocation",
+    "tab.phase.connecting": "connexion",
+    "tab.phase.running": "en cours",
+    "tab.phase.exited": "terminé",
+    "tab.phase.failed": "échec",
+};
+const de = {
+    "shell.title": "Standardterminal",
+    "shell.description": "Terminal für den Shell-Befehl",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Einstellungen nicht verfügbar: Die Konfigurationsbrücke des Hosts hat nicht geantwortet",
+    "dock.title": "Unteres Terminal",
+    "dock.hint": "Diese Schalter betreffen nur das Terminal im unteren Dock. Das offizielle rechte Terminal und die Modellwerkzeuge bleiben unberührt.",
+    "dock.state.available": "Verfügbar",
+    "dock.state.notInstalled": "Nicht gefunden",
+    "dock.state.noDistro": "Keine Distribution installiert",
+    "dock.state.launcherOnly": "Nur Launcher gefunden; Einbettung nicht möglich",
+    "dock.powershell.locked": "PowerShell ist die letzte Rückfallmöglichkeit und kann nicht deaktiviert werden.",
+    "dock.defaultChoice": "Standard-Shell (nur aktivierte und verfügbare Auswahl wird angezeigt)",
+    "dock.wslDistro": "WSL-Distribution (leer = WSL-Standard)",
+    "dock.fallback.notice": "{from} ist derzeit nicht verfügbar, dieses Terminal wurde mit {to} gestartet.",
+    "dock.floor.notice": "Alle Shells sind deaktiviert oder unavailable, Rückfall auf {to}.",
+    "dock.unavailable.noPty": "Kein PTY-Backend verfügbar: node-pty ist nicht gebaut und der Host bietet keine Terminal-Naht (pnpm approve-builds ausführen).",
+    "dock.unavailable.noSocket": "Der Host stellt keinen WebSocket-Upgrade-Pfad bereit, das untere Terminal erhält keine Ausgabe.",
+    "dock.unavailable.notInstalled": "Der Host hat die Terminal-Routen noch nicht eingebunden; kein unteres Terminal verfügbar.",
+    "dock.hostProvided": "Das Host-Terminal übernimmt; dieses Plugin hat sich zurückgezogen.",
+    "dock.applying": "Speichern…",
+    "dock.failed": "Schreibvorgang fehlgeschlagen: {message}",
+    "dock.terminals": "{count} Terminal(s) laufen",
+    "dock.refresh": "Erneut prüfen",
+    "dock.enabled.title": "Unteres Terminal aktivieren",
+    "dock.enabled.description": "Hauptschalter. Aus blendet die Shell-Unterschalter aus und verhindert Zuteilungen",
+    "dock.enabled.off": "Aus. Die Unterschalter der verfügbaren Shells erscheinen beim Einschalten",
+    "dock.shim.title": "Offizielle Terminalzeile übernehmen",
+    "dock.shim.description": "Nur aktivieren, wenn der Host keinen Terminal-Controller hat. Doppelte Registrierung desselben Dienstes lässt den anderen Anbieter scheitern; daher standardmäßig aus.",
+    "dock.shim.published": "Übernommen: die offizielle Zeile „Terminal“ wird von diesem Plugin versorgt",
+    "dock.shim.hostProvides": "Der Host stellt bereits webTerminals bereit; keine Übernahme (die offizielle Zeile funktioniert bereits)",
+    "dock.state.floor": "Rückfall",
+    "tab.title": "Terminal (mehrere Shells)",
+    "tab.description": "Öffnet Git Bash / MSYS2 / WSL / PowerShell über das PTY-Backend dieses Plugins, neben dem offiziellen Terminal",
+    "tab.new": "Neu",
+    "tab.noShell": "Kein Shell verfügbar (bitte in den Einstellungen aktivieren)",
+    "tab.phase.allocating": "Zuteilung",
+    "tab.phase.connecting": "Verbindung",
+    "tab.phase.running": "läuft",
+    "tab.phase.exited": "beendet",
+    "tab.phase.failed": "fehlgeschlagen",
+};
+const it = {
+    "shell.title": "Terminale predefinito",
+    "shell.description": "Terminale usato dal comando shell",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Impostazioni non disponibili: il bridge di configurazione dell'host non ha risposto",
+    "dock.title": "Terminale inferiore",
+    "dock.hint": "Questi interruttori riguardano solo il terminale nella barra inferiore. Il terminale ufficiale a destra e gli strumenti del modello non cambiano.",
+    "dock.state.available": "Disponibile",
+    "dock.state.notInstalled": "Non trovato",
+    "dock.state.noDistro": "Nessuna distribuzione installata",
+    "dock.state.launcherOnly": "Trovato solo un launcher; incorporamento non possibile",
+    "dock.powershell.locked": "PowerShell è il ripiego finale e non può essere disattivato.",
+    "dock.defaultChoice": "Shell predefinita (solo le scelte attive e disponibili sono elencate)",
+    "dock.wslDistro": "Distribuzione WSL (vuoto usa il predefinito WSL)",
+    "dock.fallback.notice": "{from} non è disponibile al momento, questo terminale è avviato con {to}.",
+    "dock.floor.notice": "Tutte le shell sono spente o non disponibili, ripiego su {to}.",
+    "dock.unavailable.noPty": "Nessun backend PTY disponibile: node-pty non è compilato e l'host non espone una terminal seam (eseguire pnpm approve-builds).",
+    "dock.unavailable.noSocket": "L'host non espone un percorso di upgrade WebSocket, il terminale inferiore non riceve output.",
+    "dock.unavailable.notInstalled": "L'host non ha ancora montato i percorsi del terminale; nessun terminale inferiore disponibile.",
+    "dock.hostProvided": "Il terminale dell'host è attivo; questo plugin si è fatto da parte.",
+    "dock.applying": "Salvataggio…",
+    "dock.failed": "Scrittura fallita: {message}",
+    "dock.terminals": "{count} terminale/i in esecuzione",
+    "dock.refresh": "Rileva di nuovo",
+    "dock.enabled.title": "Abilita terminale inferiore",
+    "dock.enabled.description": "Interruttore principale: se spento nasconde gli interruttori delle shell e rifiuta le allocazioni",
+    "dock.enabled.off": "Spento. Gli interruttori delle shell disponibili compaiono accendendolo",
+    "dock.shim.title": "Riprendi la riga del terminale ufficiale",
+    "dock.shim.description": "Attivare solo se l’host non ha un controller del terminale. Pubblicare due volte lo stesso servizio fa fallire l’altro fornitore; disattivato per impostazione predefinita.",
+    "dock.shim.published": "Ripresa: la riga “Terminale” ufficiale è ora alimentata da questo plugin",
+    "dock.shim.hostProvides": "L’host pubblica già webTerminals; nessun recupero (la riga ufficiale funziona già)",
+    "dock.state.floor": "ripiego",
+    "tab.title": "Terminale (più shell)",
+    "tab.description": "Apre Git Bash / MSYS2 / WSL / PowerShell sul backend PTY di questo plugin, accanto al terminale ufficiale",
+    "tab.new": "Nuovo",
+    "tab.noShell": "Nessuna shell disponibile (attivarne una nelle impostazioni)",
+    "tab.phase.allocating": "allocazione",
+    "tab.phase.connecting": "connessione",
+    "tab.phase.running": "in esecuzione",
+    "tab.phase.exited": "uscito",
+    "tab.phase.failed": "fallito",
+};
+const ru = {
+    "shell.title": "Терминал по умолчанию",
+    "shell.description": "Терминал для команд оболочки",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Настройки недоступны: мост конфигурации хоста не ответил",
+    "dock.title": "Нижний терминал",
+    "dock.hint": "Эти переключатели влияют только на терминал в нижней панели. Официальный правый терминал и инструменты модели не меняются.",
+    "dock.state.available": "Доступен",
+    "dock.state.notInstalled": "Не найден",
+    "dock.state.noDistro": "Нет установленных дистрибутивов",
+    "dock.state.launcherOnly": "Найден только лаунчер, встраивание невозможно",
+    "dock.powershell.locked": "PowerShell — резервный вариант, его нельзя отключить.",
+    "dock.defaultChoice": "Оболочка по умолчанию (показаны только активные и доступные)",
+    "dock.wslDistro": "Дистрибутив WSL (пусто — default из WSL)",
+    "dock.fallback.notice": "{from} сейчас недоступен, поэтому терминал запущен с {to}.",
+    "dock.floor.notice": "Все оболочки отключены или недоступны, использован резерв {to}.",
+    "dock.unavailable.noPty": "Нет доступного PTY-бэкенда: node-pty не собран и хост не предоставляет terminal seam (выполните pnpm approve-builds).",
+    "dock.unavailable.noSocket": "Хост не предоставляет маршрут обновления WebSocket, нижний терминал не получит вывод.",
+    "dock.unavailable.notInstalled": "Хост ещё не подключил маршруты терминала, нижний терминал недоступен.",
+    "dock.hostProvided": "Терминал хоста действует; этот плагин уступил.",
+    "dock.applying": "Сохранение…",
+    "dock.failed": "Ошибка записи: {message}",
+    "dock.terminals": "Выполняется {count} терминал(ов)",
+    "dock.refresh": "Проверить снова",
+    "dock.enabled.title": "Включить нижний терминал",
+    "dock.enabled.description": "Главный переключатель: выключенный скрывает дочерние переключатели оболочек и запрещает выделения",
+    "dock.enabled.off": "Выключено. Дочерние переключатели доступных оболочек появятся при включении",
+    "dock.shim.title": "Перенять строку официального терминала",
+    "dock.shim.description": "Включайте только если у хоста нет контроллера терминала. Двойная регистрация одного и того же сервиса приводит к сбою у другого; по умолчанию выключено.",
+    "dock.shim.published": "Перенято: строка «Терминал» теперь обслуживается этим плагином",
+    "dock.shim.hostProvides": "Хост уже публикует webTerminals, перенимать нечего (официальная строка работает)",
+    "dock.state.floor": "резерв",
+    "tab.title": "Терминал (несколько оболочек)",
+    "tab.description": "Открывает Git Bash / MSYS2 / WSL / PowerShell поверх PTY-бэкенда этого плагина, рядом с официальным терминалом",
+    "tab.new": "Создать",
+    "tab.noShell": "Нет доступной оболочки (включите в настройках)",
+    "tab.phase.allocating": "выделение",
+    "tab.phase.connecting": "подключение",
+    "tab.phase.running": "работает",
+    "tab.phase.exited": "завершено",
+    "tab.phase.failed": "ошибка",
+};
+const es = {
+    "shell.title": "Terminal predeterminada",
+    "shell.description": "Terminal usada por el comando shell",
+    "shell.powershell": "PowerShell",
+    "shell.gitbash": "Git Bash",
+    "shell.msys2": "MSYS2",
+    "shell.wsl": "WSL",
+    "shell.unavailable": "Configuración no disponible: el puente de configuración del host no respondió",
+    "dock.title": "Terminal inferior",
+    "dock.hint": "Estos interruptores solo afectan al terminal del panel inferior. El terminal oficial derecho y las herramientas del modelo no cambian.",
+    "dock.state.available": "Disponible",
+    "dock.state.notInstalled": "No detectado",
+    "dock.state.noDistro": "Sin distribución instalada",
+    "dock.state.launcherOnly": "Solo se encontró un lanzador; no se puede incrustar",
+    "dock.powershell.locked": "PowerShell es el respaldo final y no puede desactivarse.",
+    "dock.defaultChoice": "Shell predeterminada (solo se listan las activas y disponibles)",
+    "dock.wslDistro": "Distribución WSL (vacío usa la predeterminada de WSL)",
+    "dock.fallback.notice": "{from} no está disponible ahora, así que este terminal se inició con {to}.",
+    "dock.floor.notice": "Todas las shells están apagadas o no disponibles; se usó {to} como respaldo.",
+    "dock.unavailable.noPty": "No hay backend PTY disponible: node-pty no se compiló y el host no expone terminal seam (ejecuta pnpm approve-builds).",
+    "dock.unavailable.noSocket": "El host no expone una ruta de actualización WebSocket; el terminal inferior no recibe salida.",
+    "dock.unavailable.notInstalled": "El host aún no ha montado las rutas del terminal; no se ofrece terminal inferior.",
+    "dock.hostProvided": "El terminal del host está a cargo; este plugin se hizo a un lado.",
+    "dock.applying": "Guardando…",
+    "dock.failed": "Fallo de escritura: {message}",
+    "dock.terminals": "{count} terminal(es) en ejecución",
+    "dock.refresh": "Volver a detectar",
+    "dock.enabled.title": "Activar terminal inferior",
+    "dock.enabled.description": "Interruptor principal: apagado oculta los sub-interruptores de shells y rechaza asignaciones",
+    "dock.enabled.off": "Apagado. Los sub-interruptores de las shells disponibles aparecen al encenderlo",
+    "dock.shim.title": "Relevar la fila de terminal oficial",
+    "dock.shim.description": "Actívelo solo si el host no tiene controlador de terminal. Publicar dos veces el mismo servicio hace fallar al otro proveedor; desactivado por defecto.",
+    "dock.shim.published": "Relevada: la fila «Terminal» oficial ahora la alimenta este plugin",
+    "dock.shim.hostProvides": "El host ya publica webTerminals; no se relevó nada (la fila oficial ya funciona)",
+    "dock.state.floor": "respaldo",
+    "tab.title": "Terminal (multi-shell)",
+    "tab.description": "Abre Git Bash / MSYS2 / WSL / PowerShell sobre el backend PTY de este plugin, junto al terminal oficial",
+    "tab.new": "Nuevo",
+    "tab.noShell": "Ninguna shell disponible (activa una en ajustes)",
+    "tab.phase.allocating": "asignando",
+    "tab.phase.connecting": "conectando",
+    "tab.phase.running": "en ejecución",
+    "tab.phase.exited": "terminado",
+    "tab.phase.failed": "falló",
+};
+/** The registered dictionary, one row per host language. */
+export const dictionaries = { zh, en, ja, ko, fr, de, it, ru, es };
+/** The Chinese fallback used when the host exposes no `locale.bind` (0.1.0/0.1.1). */
+export const fallbackDict = { ...zh };

package/lib/settings-surface.d.ts

@@ -0,0 +1,20 @@
+/** The surface this host offers the plugin's settings. */
+export type SettingsSurface = "unknown" | "page" | "none";
+/** The settings-service capabilities the classification reads. */
+export interface SettingsSurfaceProbe {
+    register?: unknown;
+    installSection?: unknown;
+}
+/**
+ * Classify a settings service by what it exposes.
+ *
+ * Exported separately from `reportSettingsSurface` so every branch is testable without a
+ * host: the order matters. `installSection` outranks `register` because its presence is
+ * the 0.1.2 generation, which does have a page; only a line with `register` and no
+ * `installSection` is the first generation.
+ */
+export declare function classifySettingsService(svc: SettingsSurfaceProbe | undefined): SettingsSurface;
+/** Record the answer for the route handler and return it. */
+export declare function reportSettingsSurface(svc: SettingsSurfaceProbe | undefined): SettingsSurface;
+/** The last answer the host gave, or `unknown` before the settings service arrived. */
+export declare function settingsSurface(): SettingsSurface;

package/lib/settings-surface.js

@@ -0,0 +1,49 @@
+// Which settings surface this host line actually renders.
+//
+// Why the plugin needs to know: the settings live on the bundle detail page and on the
+// family tab, but 0.1.0-rc.x / 0.1.1-rc.x declare the whole `settings.*` slot map while
+// shipping **no page that renders it** - a card registered there is a card nobody can
+// open, and the only surface that paints is a shell-level overlay the plugin brings
+// itself. Showing that overlay on newer lines instead would put a third settings surface
+// over a working page, so it has to be conditional, and "which line am I on" must be
+// answered by capability rather than by a version string.
+//
+// The three generations are mutually exclusive on the settings SERVICE, which the plugin
+// already receives through `ctx.inject(["settings"])`:
+//
+//   0.1.0 / 0.1.1  `register` yes,   `installSection` no   -> no settings page at all
+//   0.1.2 / 0.1.5  `installSection` yes                    -> settings page exists
+//   0.1.7+ / 0.2.0 neither (both removed with rc.1, #40)   -> settings page exists
+//
+// Probing the service rather than importing `@deepseek-ai/dsh-settings` is deliberate:
+// the host packages live in the application's own tree, not in the profile's
+// `node_modules`, so a dynamic import from a plugin either fails (-> a permanent
+// "unknown", i.e. no fallback on exactly the lines that need one) or resolves a *fetched
+// copy* that is not the module the running host loaded. Both answers would be wrong.
+let settled = "unknown";
+/**
+ * Classify a settings service by what it exposes.
+ *
+ * Exported separately from `reportSettingsSurface` so every branch is testable without a
+ * host: the order matters. `installSection` outranks `register` because its presence is
+ * the 0.1.2 generation, which does have a page; only a line with `register` and no
+ * `installSection` is the first generation.
+ */
+export function classifySettingsService(svc) {
+    if (svc === undefined)
+        return "unknown";
+    if (typeof svc.installSection === "function")
+        return "page";
+    if (typeof svc.register === "function")
+        return "none";
+    return "page";
+}
+/** Record the answer for the route handler and return it. */
+export function reportSettingsSurface(svc) {
+    settled = classifySettingsService(svc);
+    return settled;
+}
+/** The last answer the host gave, or `unknown` before the settings service arrived. */
+export function settingsSurface() {
+    return settled;
+}

package/lib/shell-id.d.ts

@@ -0,0 +1,2 @@
+/** The four backends, in catalog order. */
+export type ShellId = "powershell" | "gitbash" | "msys2" | "wsl";

package/lib/shell-id.js

@@ -0,0 +1,9 @@
+// The shell identifier, in its own module on purpose.
+//
+// `shells.ts` needs `NodeJS.Platform` and the resolved-path types, so it belongs
+// to the host compile graph only. The browser half still has to name the same
+// four ids (in the socket frames and the catalog rows it renders), so the id type
+// lives here - a module with no Node references at all, which is what lets it sit
+// in both tsconfig graphs without dragging `@types/node` into the client purity
+// gate.
+export {};

package/lib/shells.d.ts

@@ -0,0 +1,114 @@
+import type { ResolvedPaths } from "./dsh-types.js";
+import type { ShellId } from "./shell-id.js";
+/** Re-exported so existing importers keep working (see shell-id.ts for why). */
+export type { ShellId };
+/** Catalog order = fallback order: powershell is BOTH first choice and floor. */
+export declare const SHELL_PRIORITY: readonly ShellId[];
+/** Why one backend is not launchable (drives the settings-row badge). */
+export type ShellUnavailable = "installed" | "not-installed" | "no-distro" | "launcher-only";
+/** One catalog row: what the UI shows and what the host would spawn. */
+export interface ShellEntry {
+    readonly id: ShellId;
+    /** Display label (a catalog constant, never inferred from the file name). */
+    readonly label: string;
+    /** Resolved executable, absent when the backend is not usable. */
+    readonly path?: string;
+    readonly available: boolean;
+    readonly reason: ShellUnavailable;
+    /** The activation switch state (powershell is always true: the floor). */
+    readonly activated: boolean;
+    /** False only for powershell, which the user cannot turn off. */
+    readonly togglable: boolean;
+    /** Interactive argv, present only when `available`. */
+    readonly argv?: readonly string[];
+}
+/** The activation switches as persisted in the plugin config. */
+export interface ShellSwitches {
+    gitbash: boolean;
+    msys2: boolean;
+    wsl: boolean;
+}
+/** Everything the catalog builder needs from the outside world. */
+export interface CatalogFacts {
+    /** Resolved executables (config override or candidate-list winner). */
+    paths: ResolvedPaths;
+    /** Whether one path is a launchable file. */
+    fsProbe(path: string): boolean;
+    /** `wsl -l -q` output. `undefined` means the probe could not answer (a timeout
+     * is not evidence of absence); `[]` means it answered "no distro installed". */
+    readonly distros: readonly string[] | undefined;
+    switches: ShellSwitches;
+    /** WSL distro override from config ('' = the WSL default). */
+    wslDistro: string;
+}
+/**
+ * `<SystemRoot>\System32\bash.exe` (and the sysnative mirror) is the deprecated
+ * WSL forwarder, not a shell. `candidateGitBashPaths` already skips it; this
+ * guard protects the second way a path reaches the catalog - a user-supplied
+ * `gitBashPath` / `msys2Path` config value.
+ */
+export declare function isWslLegacyBash(path: string): boolean;
+/**
+ * Console-allocating launchers: `git-bash.exe`, `msys2.exe`, `msys2_shell.cmd`.
+ * They open their own window and return zero bytes on a piped stdio (measured
+ * against MSYS2 with bash 5.3.15), so they can never host an embedded terminal.
+ */
+export declare function isConsoleLauncher(path: string): boolean;
+/**
+ * Interactive argv for the BROWSER terminal.
+ *
+ * Differences from the tool's `terminalArgv`: PowerShell keeps its profile (the
+ * user's aliases and prompt are the point of a UI terminal), and the three bash
+ * families are unchanged because those rules are about the shell itself:
+ * Git Bash needs `-i`, MSYS2 needs `-l` and NEVER `-lc` (this argv carries no
+ * command, and `bash -lc` with no operand exits 2), WSL needs `-- bash -i` on the
+ * default distro (bare `-e` fails under ConPTY with RPC 0x8007072c).
+ */
+export declare function uiArgv(shell: ShellId, paths: ResolvedPaths, wslDistro?: string): string[];
+/**
+ * Environment for the BROWSER terminal: the host process environment plus a real
+ * terminal type. `buildEnv` is deliberately NOT reused - it layers
+ * `TERM=dumb`/`NO_COLOR=1`/`PAGER=cat` over an agent-scoped map, which is right
+ * for a one-shot tool call and wrong for an interactive screen.
+ *
+ * The one rule carried over is MSYS2's `MSYSTEM`: without it MSYS2 starts in the
+ * bare MSYS environment and `/etc/profile` never puts `/mingw64/bin` on PATH, so
+ * gcc/make are missing in the very shell the user chose to get them from. An
+ * explicit value in the base environment wins, exactly as in `buildEnv`.
+ */
+export declare function uiEnv(shell: ShellId, baseEnv: NodeJS.ProcessEnv): Record<string, string | undefined>;
+/**
+ * The catalog the settings page and the spawn path both read.
+ *
+ * `powershell` is never `activated: false` even if a switch said so: it is the
+ * floor of the fallback chain (R2/R6), and a floor that can be removed is not a
+ * floor. The caller sees that through `togglable: false`.
+ */
+export declare function buildCatalog(facts: CatalogFacts): ShellEntry[];
+/** The result of resolving which shell a terminal should start with. */
+export interface ResolvedDefault {
+    readonly id: ShellId | "cmd";
+    readonly path: string;
+    readonly argv: readonly string[];
+    /** True when the stored value was replaced (the UI shows why). */
+    readonly fellBack: boolean;
+    /** True when nothing is activated and the floor was used. */
+    readonly floor: boolean;
+    /** The stored value that was not honoured, when there was one. */
+    readonly from?: string;
+}
+/**
+ * Decide the shell for one allocation (R4/R5/R6).
+ *
+ * Three distinct outcomes, because the UI has to say different things about them:
+ * - `""` means the user never chose: take the first candidate, no notice;
+ * - a non-empty value outside the candidates means the choice went stale (a
+ *   switch was turned off, or a shell was uninstalled): fall back AND report
+ *   `fellBack` with the original value;
+ * - no candidate at all: the floor is PowerShell's own chain (pwsh 7 -> Windows
+ *   PowerShell), and `cmd.exe` is the last resort when even that is gone.
+ *
+ * The stored config is never rewritten here - a fallback that persists would
+ * silently eat the user's choice.
+ */
+export declare function resolveDefaultShell(catalog: readonly ShellEntry[], configured: string, paths: ResolvedPaths): ResolvedDefault;