@aiwayds/dsh-tui-pi 2.19.0 → 2.20.0

package/lib/settings.js

@@ -6,8 +6,9 @@
  * schemastery schemas → resolved values) and renders it as nested FW list
  * panels (src/panels.ts SettingsListPanel), one level per schema depth:
  *
- *   level 0   category list (searchable): general / models / plugins / agent,
- *             then `other` for unmapped namespaces. Namespace→category comes
+ *   level 0   category list (searchable), alphabetical by canonical label:
+ *             Agent Presets / General / Models / Other / Plugins / TUI,
+ *             with `other` hidden when no namespace falls into it. Namespace→category comes
  *             from a static mapping (categorizeNamespaces) mirroring the web
  *             settings page: the web client slots namespaces into categories
  *             client-side and the data plane carries no category field, so
@@ -19,9 +20,13 @@
  *             model summary, API-key state) instead of the raw namespace —
  *             the original schema surface is hidden — plus dedicated
  *             llm-deepseek / agent-default-model rows and an add-provider
- *             flow (built-in directory → one API key → write)
+ *             flow (built-in directory → one API key → write). The
+ *             single-namespace dsh-tui category drills straight through to
+ *             its field list, titled by the category label.
  *   level 2+  schema walk, dispatched on node type:
- *             - object/dict → drill in (nested list; dicts get an add-key row)
+ *             - object/dict → drill in (nested list; dicts get an add-key
+ *               row); at a grouped namespace's root (FIELD_GROUPS) member
+ *               fields collapse into one virtual group drill row
  *             - boolean / all-literal union → Enter cycles the value
  *             - string/number/mixed union → inline Input editor
  *             - array / literal / const / unknown → read-only viewer
@@ -37,26 +42,125 @@ import { getPath, nodeAtPath, rehydrateSchema } from "./schema-model.js";
 import { getKeybindings, Input, matchesKey, } from '@earendil-works/pi-tui';
 import { columnWidths, MARKER_W, padCell, panelThemeFns, SettingsListPanel, TABLE_SEP, tableHeaderLine, tableRuleLine, ViewerPanel, } from "./panels.js";
 import { ansiFg, BOLD, RESET } from "./theme/index.js";
+import { t } from "./i18n/index.js";
 import { clipToWidth, visibleWidth } from "./text.js";
 import { wrapFramedOverlay } from "./frame.js";
-import { catalogEntry, deriveKeyRef, directoryProviderEntries, providerProfileFor, providerRowView, unconfiguredCatalogEntries, } from "./provider-catalog.js";
+import { languagePickerPanel } from "./selectors.js";
+import { THEME_SETTINGS_NAMESPACE } from "./theme-settings.js";
+import { catalogEntry, deriveKeyRef, directoryProviderEntries, providerProfileFor, providerRowView, resolveCatalogHint, unconfiguredCatalogEntries, } from "./provider-catalog.js";
 /**
  * Static namespace→category mapping, mirroring the web settings page's
  * client-side slot structure (see the module header): the data plane carries
  * no category field, so the slots are maintained here by hand. Namespaces not
- * listed anywhere fall into the trailing `other` category.
+ * listed anywhere fall into the trailing `other` category. Beyond the web
+ * page's own slots, the plugins category enumerates the settings namespaces
+ * of the dsh plugins installed in this ecosystem (mcp-adapter, topics, vault,
+ * model-sync, dsh-feishu, dsh-llm-proxy) so their rows group under Plugins
+ * instead of leaking into `other`.
  *
- * Labels are English-only: pi-tui's SettingsList search matches the label
- * text, so English queries (model, shell, permission, …) hit directly.
+ * The `label`s here are the English source of truth: rows render through
+ * `categoryLabel()` (t() at render time, keyed by category id), so the active
+ * UI language translates them while search keeps matching whatever is
+ * displayed. The first level is ordered by this canonical label
+ * (categorizeNamespaces sorts), not by map order.
  */
 export const CATEGORY_MAP = [
-    { id: 'general', label: 'General', namespaces: ['permission', 'dsh-tui'] },
+    { id: 'dsh-tui', label: 'TUI', namespaces: ['dsh-tui'] },
+    { id: 'general', label: 'General', namespaces: ['permission'] },
     { id: 'models', label: 'Models', namespaces: ['llm-deepseek', 'llm-pi-ai', 'agent-default-model'] },
-    { id: 'plugins', label: 'Plugins', namespaces: ['shell', 'agent-loop', 'web-search-deepseek'] },
+    {
+        id: 'plugins',
+        label: 'Plugins',
+        namespaces: [
+            'shell',
+            'agent-loop',
+            'web-search-deepseek',
+            // Settings namespaces of installed dsh plugins — dsh-llm-proxy
+            // registers through settings.installSection, the rest through
+            // settings.register; plugins without a namespace never reach the
+            // settings browser.
+            'mcp-adapter',
+            'topics',
+            'vault',
+            'model-sync',
+            'dsh-feishu',
+            'dsh-llm-proxy',
+        ],
+    },
     { id: 'agent', label: 'Agent Presets', namespaces: ['agent-presets'] },
 ];
+/**
+ * Category id → i18n key resolver for the user-facing label. The static
+ * labels in CATEGORY_MAP stay English (module data must not freeze a
+ * language at import time); rows resolve through these literal t() call
+ * sites at render time and fall back to the static label for an id without
+ * an entry.
+ */
+const CATEGORY_LABEL_KEYS = {
+    'dsh-tui': () => t('settingsui.category.dsh-tui'),
+    general: () => t('settingsui.category.general'),
+    models: () => t('settingsui.category.models'),
+    plugins: () => t('settingsui.category.plugins'),
+    agent: () => t('settingsui.category.agent'),
+    other: () => t('settingsui.category.other'),
+};
+/** User-facing label of one category (t()-resolved; English fallback). */
+function categoryLabel(cat) {
+    const make = CATEGORY_LABEL_KEYS[cat.id];
+    return make === undefined ? cat.label : make();
+}
 /** Cap for a category row's member-name description line. */
 export const CATEGORY_DESC_MAX = 60;
+export const FIELD_GROUPS = {
+    'dsh-tui': [
+        {
+            id: 'subagent',
+            labelKey: 'settingsui.group.subagent',
+            fields: ['maxAgents', 'maxRounds', 'maxRoundsGrace', 'disableSubagent', 'registeredOnly'],
+        },
+    ],
+};
+/**
+ * Resolve one group's label to display text. The static tables carry i18n
+ * KEYS (module data must not freeze a language at import time); this switch
+ * enumerates them as literal t() call sites — which is also what the i18n
+ * coverage guard matches against. Anything else passes through `t()`
+ * unchanged, since a non-key falls back to itself.
+ */
+export function resolveFieldGroupLabel(labelKey) {
+    switch (labelKey) {
+        case 'settingsui.group.subagent': return t('settingsui.group.subagent');
+        default: return t(labelKey);
+    }
+}
+/**
+ * Order schema field keys for display: grouped fields collapse into a single
+ * group slot at the position of the group's FIRST member present (members
+ * list only the keys actually present, in group-declaration order). Keys in
+ * no group pass through in order. Unknown/hidden keys never reach this
+ * function — the caller walks already-filtered rows.
+ */
+export function slotFieldKeys(ns, keys) {
+    const groups = FIELD_GROUPS[ns];
+    if (groups === undefined || groups.length === 0) {
+        return keys.map(key => ({ kind: 'field', key }));
+    }
+    const keySet = new Set(keys);
+    const emitted = new Set();
+    const slots = [];
+    for (const key of keys) {
+        const group = groups.find(def => def.fields.includes(key));
+        if (group === undefined) {
+            slots.push({ kind: 'field', key });
+            continue;
+        }
+        if (emitted.has(group.id))
+            continue;
+        emitted.add(group.id);
+        slots.push({ kind: 'group', group, members: group.fields.filter(field => keySet.has(field)) });
+    }
+    return slots;
+}
 /**
  * Namespaces the Models category reads and writes. dsh-settings
  * 0.1.2-alpha.3 removed the runtime settingsNamespace() helper: plain
@@ -68,8 +172,11 @@ const NS_LLM_PI_AI = 'llm-pi-ai';
 const NS_LLM_DEEPSEEK = 'llm-deepseek';
 const NS_AGENT_DEFAULT_MODEL = 'agent-default-model';
 /**
- * Group a describe() namespace list into ordered categories — general, models,
- * plugins, agent, then `other` for everything unmapped. Categories with no
+ * Group a describe() namespace list into ordered categories. The result is
+ * sorted alphabetically by the canonical (English) label — Agent Presets,
+ * General, Models, Other, Plugins, TUI — so the first level reads the same
+ * regardless of CATEGORY_MAP order or the active UI language (sorting keys on
+ * the canonical label, never the t()-translated one). Categories with no
  * members are dropped, including `other` when nothing falls into it.
  *
  * Defensive: duplicate namespaces in the input count once (a namespace
@@ -92,7 +199,11 @@ export function categorizeNamespaces(nses) {
     const others = [...input].filter(ns => !mapped.has(ns));
     if (others.length > 0)
         categories.push({ id: 'other', label: 'Other', namespaces: others });
-    return categories;
+    return categories.sort((a, b) => {
+        const la = a.label.toLowerCase();
+        const lb = b.label.toLowerCase();
+        return la < lb ? -1 : la > lb ? 1 : 0;
+    });
 }
 /**
  * Description line for a category row: member names joined with ", ", capped
@@ -109,7 +220,7 @@ export function categoryDescription(namespaces, max = 60) {
 /** Human display for a resolved value (row value column; never re-scans anything). */
 export function formatValue(value) {
     if (value === undefined)
-        return '(unset)';
+        return t('settingsui.value.unset');
     if (value === null)
         return 'null';
     if (typeof value === 'string')
@@ -117,10 +228,10 @@ export function formatValue(value) {
     if (typeof value === 'number' || typeof value === 'boolean')
         return String(value);
     if (Array.isArray(value))
-        return value.length === 0 ? '[]' : `[${value.length} items]`;
+        return value.length === 0 ? '[]' : t('settingsui.value.items', { count: value.length });
     if (typeof value === 'object') {
         const keys = Object.keys(value);
-        return keys.length === 0 ? '{}' : `{${keys.length} keys}`;
+        return keys.length === 0 ? '{}' : `{${t('settingsui.value.keys', { count: keys.length })}}`;
     }
     return String(value);
 }
@@ -147,11 +258,11 @@ export function parseNumberInput(text) {
     // Literal decimal subset: hex/octal/binary prefixes and trailing garbage
     // are rejected; decimal scientific notation stays (1e3 = 1000).
     if (!/^[-+]?(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?$/.test(text.trim())) {
-        return { kind: 'error', error: `expected a number, got "${text}"` };
+        return { kind: 'error', error: t('settingsui.parse.number', { text }) };
     }
     const n = Number(text);
     if (!Number.isFinite(n))
-        return { kind: 'error', error: `expected a number, got "${text}"` };
+        return { kind: 'error', error: t('settingsui.parse.number', { text }) };
     return { kind: 'value', value: n };
 }
 export function parseStringInput(text) {
@@ -171,7 +282,7 @@ export function parseUnionInput(text, node) {
     const hasStringBranch = (node.list ?? []).some(member => member.type === 'string' || (member.type === 'literal' && typeof member.value === 'string'));
     if (hasStringBranch)
         return { kind: 'value', value: text };
-    return { kind: 'error', error: 'expected a JSON value (number, boolean, string, …)' };
+    return { kind: 'error', error: t('settingsui.parse.json') };
 }
 /** Seed value for a newly added dict key, from the inner schema. */
 export function defaultValueFor(node) {
@@ -206,27 +317,27 @@ export function fieldDescription(node, userOverride) {
         parts.push(raw['en'] ?? raw[''] ?? Object.values(raw)[0] ?? '');
     }
     if (meta.required === true)
-        parts.push('required');
+        parts.push(t('settingsui.meta.required'));
     if (meta.default !== undefined)
-        parts.push(`default: ${formatValue(meta.default)}`);
+        parts.push(t('settingsui.meta.default', { value: formatValue(meta.default) }));
     if (meta.min !== undefined)
-        parts.push(`min: ${meta.min}`);
+        parts.push(t('settingsui.meta.min', { value: meta.min }));
     if (meta.max !== undefined)
-        parts.push(`max: ${meta.max}`);
+        parts.push(t('settingsui.meta.max', { value: meta.max }));
     if (meta.step !== undefined)
-        parts.push(`step: ${meta.step}`);
+        parts.push(t('settingsui.meta.step', { value: meta.step }));
     if (meta.pattern !== undefined)
-        parts.push(`pattern: ${meta.pattern.source}`);
+        parts.push(t('settingsui.meta.pattern', { value: meta.pattern.source }));
     if (meta.role === 'secret')
-        parts.push('secret');
+        parts.push(t('settingsui.meta.secret'));
     if (meta.disabled === true)
-        parts.push('disabled');
+        parts.push(t('settingsui.meta.disabled'));
     for (const badge of meta.badges ?? []) {
         if (typeof badge.text === 'string')
             parts.push(badge.text);
     }
     if (userOverride)
-        parts.push('user-set');
+        parts.push(t('settingsui.meta.userSet'));
     return parts.filter(part => part !== '').join(' · ');
 }
 /** Inline value editor: title, current-value line, error/notice line, Input. */
@@ -330,7 +441,7 @@ export class EditField {
             lines.push(...this.input.render(width));
         }
         lines.push('');
-        lines.push(fns.subtle(clipToWidth('Enter save · Esc back', wrap)));
+        lines.push(fns.subtle(clipToWidth(t('settingsui.edit.footer'), wrap)));
         return lines;
     }
     /**
@@ -371,7 +482,7 @@ class ConfirmReset {
         return [
             fns.accent(BOLD + this.label + RESET),
             '',
-            fns.subtle(this.pending ? '  resetting…' : '  Enter: reset to defaults · Esc: cancel'),
+            fns.subtle(this.pending ? `  ${t('settingsui.reset.working')}` : `  ${t('settingsui.reset.hints')}`),
         ];
     }
     handleInput(data) {
@@ -452,12 +563,12 @@ export class AddProviderFlow {
             return;
         }
         this.list = new SettingsListPanel(theme, {
-            title: '⚙ Add provider',
+            title: t('settingsui.addProvider.title'),
             rows: options.entries.map(entry => ({
                 id: entry.id,
                 label: entry.name,
                 value: '',
-                description: entry.hint,
+                description: resolveCatalogHint(entry.hint),
                 submenu: (_current, done) => isCustom(entry)
                     ? options.customFlow(done)
                     : this.keyEditor(entry, options, done),
@@ -472,8 +583,8 @@ export class AddProviderFlow {
     keyEditor(entry, options, done) {
         const ref = deriveKeyRef(entry.id);
         return new EditField(this.tui, {
-            title: `API key for ${entry.name}`,
-            subtitle: `stored as ${ref} — never written to settings.yaml`,
+            title: t('settingsui.addProvider.keyTitle', { name: entry.name }),
+            subtitle: t('settingsui.addProvider.keySubtitle', { ref }),
             initial: '',
             // Never echo the key — masked dot row (B2).
             secret: true,
@@ -481,7 +592,7 @@ export class AddProviderFlow {
                 // Unlike an edit of a stored secret, the key is required here: a
                 // route with no key address cannot serve a request.
                 if (text.trim() === '')
-                    return { kind: 'error', error: 'API key must not be empty' };
+                    return { kind: 'error', error: t('settingsui.addProvider.keyRequired') };
                 return { kind: 'value', value: text.trim() };
             },
             onCommit: async (outcome) => {
@@ -509,11 +620,11 @@ export class AddProviderFlow {
         if (this.empty) {
             const fns = panelThemeFns(this.theme);
             return [
-                fns.accent(BOLD + '⚙ Add provider' + RESET),
+                fns.accent(BOLD + t('settingsui.addProvider.title') + RESET),
                 '',
-                fns.muted('All built-in providers are already configured.'),
+                fns.muted(t('settingsui.addProvider.empty')),
                 '',
-                fns.subtle('  Esc to close'),
+                fns.subtle(`  ${t('settingsui.escClose')}`),
             ];
         }
         return this.list.render(width);
@@ -555,7 +666,7 @@ export async function commitProvider(ctx, writeProfile, entry, key) {
         // No credential store in this process — the row is configured and the
         // key must come from the environment; this is a success with a hint,
         // never an error. Enter re-runs the commit idempotently.
-        return { notice: `provider added — no credentials service in this process: export ${ref} to use it` };
+        return { notice: t('settingsui.commit.noCredentials', { ref }) };
     }
     try {
         await credentials.set(ref, key);
@@ -565,8 +676,10 @@ export async function commitProvider(ctx, writeProfile, entry, key) {
         // counts as configured, so the user needs the manual path. The error
         // stays retryable in place — Enter re-runs the whole commit (B3).
         return {
-            error: `API key not stored: ${cause instanceof Error ? cause.message : String(cause)}`
-                + ` — provider added; export ${ref}=<key> to use it`,
+            error: t('settingsui.commit.keyFailed', {
+                cause: cause instanceof Error ? cause.message : String(cause),
+                ref,
+            }),
         };
     }
     return undefined;
@@ -671,7 +784,7 @@ class SettingsBrowser {
         return categorizeNamespaces(this.descriptors.map(d => d.ns));
     }
     categorySummary(cat) {
-        return `${cat.namespaces.length} namespaces`;
+        return t('settingsui.summary.namespaces', { count: cat.namespaces.length });
     }
     categoryDescription(cat) {
         return categoryDescription(cat.namespaces, CATEGORY_DESC_MAX);
@@ -679,19 +792,30 @@ class SettingsBrowser {
     categoryList() {
         const items = this.categories().map(cat => ({
             id: cat.id,
-            label: cat.label,
+            label: categoryLabel(cat),
             value: this.categorySummary(cat),
             description: this.categoryDescription(cat),
             submenu: cat.id === 'models'
                 ? (_current, done) => this.openModelsSubmenu(done)
-                : (_current, done) => {
-                    const list = this.namespaceList(cat.label, this.descriptors.filter(d => cat.namespaces.includes(d.ns)), done);
-                    this.nsList = list;
-                    return list;
-                },
+                : cat.id === 'dsh-tui'
+                    // Single-namespace category: drill straight into the config
+                    // fields — no intermediate namespace list repeating the namespace
+                    // name under the category that names it.
+                    ? (_current, done) => {
+                        const section = this.sectionList(THEME_SETTINGS_NAMESPACE, [], () => {
+                            this.refreshCategoryList();
+                            done();
+                        }, categoryLabel(cat));
+                        return section.list;
+                    }
+                    : (_current, done) => {
+                        const list = this.namespaceList(categoryLabel(cat), this.descriptors.filter(d => cat.namespaces.includes(d.ns)), done);
+                        this.nsList = list;
+                        return list;
+                    },
         }));
         return new SettingsListPanel(this.theme, {
-            title: '⚙ settings',
+            title: t('settingsui.title'),
             rows: items,
             maxVisible: 10,
             enableSearch: true,
@@ -710,14 +834,14 @@ class SettingsBrowser {
     nsSummary(desc) {
         const root = this.root(desc.ns);
         if (root !== undefined && root.type === 'object') {
-            return `${Object.keys(root.dict ?? {}).length} fields`;
+            return t('settingsui.fields.count', { count: Object.keys(root.dict ?? {}).length });
         }
         return formatValue(desc.value);
     }
     nsDescription(desc) {
-        const parts = [`applies: ${desc.applies}`];
+        const parts = [t('settingsui.ns.applies', { applies: desc.applies })];
         if (desc.user !== undefined)
-            parts.push('user-set');
+            parts.push(t('settingsui.meta.userSet'));
         return parts.join(' · ');
     }
     /** Namespace list for one category; Esc pops back to the category level. */
@@ -935,7 +1059,7 @@ class SettingsBrowser {
                     submenu: (_current, done) => new ViewerPanel(this.theme, {
                         title: `providers.${id}`,
                         lines: [
-                            'read-only in the TUI — edit the settings document to change it',
+                            t('settingsui.models.readonly'),
                             '',
                             ...JSON.stringify(profile, null, 2).split('\n'),
                         ],
@@ -949,7 +1073,7 @@ class SettingsBrowser {
         if (deepseekDesc !== undefined) {
             items.push({
                 id: 'llm-deepseek',
-                label: 'DeepSeek (official)',
+                label: t('settingsui.models.deepseek'),
                 value: this.nsSummary(deepseekDesc),
                 description: this.nsDescription(deepseekDesc),
                 submenu: (_current, done) => {
@@ -965,7 +1089,7 @@ class SettingsBrowser {
         if (agentDesc !== undefined) {
             items.push({
                 id: 'agent-default-model',
-                label: 'Default model',
+                label: t('settingsui.models.defaultModel'),
                 value: this.defaultModelSummary(agentDesc),
                 description: this.nsDescription(agentDesc),
                 submenu: (_current, done) => {
@@ -982,9 +1106,9 @@ class SettingsBrowser {
             const configured = new Set(Object.keys(providers.providers ?? {}));
             items.push({
                 id: '\u0000add-provider',
-                label: '+ Add provider…',
+                label: t('settingsui.models.add'),
                 value: '',
-                description: 'configure a built-in provider with its API key',
+                description: t('settingsui.models.addDesc'),
                 submenu: (_current, done) => new AddProviderFlow(this.tui, this.theme, {
                     entries: this.addProviderEntries(configured),
                     onCommit: (entry, key) => this.commitNewProvider(entry, key),
@@ -997,7 +1121,7 @@ class SettingsBrowser {
             });
         }
         return new SettingsListPanel(this.theme, {
-            title: '⚙ Models',
+            title: t('settingsui.models.title'),
             rows: items,
             maxVisible: 12,
             enableSearch: true,
@@ -1014,7 +1138,7 @@ class SettingsBrowser {
         if (typeof provider === 'string' && provider !== '' && typeof model === 'string' && model !== '') {
             const effort = value?.reasoningEffort;
             return typeof effort === 'string' && effort !== ''
-                ? `${provider}/${model} · think ${effort}`
+                ? t('settingsui.route.think', { provider, model, effort })
                 : `${provider}/${model}`;
         }
         return formatValue(desc.value);
@@ -1023,9 +1147,12 @@ class SettingsBrowser {
     /**
      * Build the FW list panel for one schema node at `path` of `ns`.
      * `onExit` runs when the list is popped (Esc) — it must refresh the parent
-     * level and call the parent's submenu `done()`.
+     * level and call the parent's submenu `done()`. `title` overrides the
+     * default panel title (the namespace or path spelling) — the TUI category's
+     * direct drill uses it to title the fields with the category label instead
+     * of the raw namespace name.
      */
-    sectionList(ns, path, onExit) {
+    sectionList(ns, path, onExit, title) {
         const root = this.root(ns);
         const desc = this.descriptor(ns);
         const node = root !== undefined && path.length > 0
@@ -1033,9 +1160,82 @@ class SettingsBrowser {
             : root;
         const rows = node === undefined ? [] : this.buildRows(ns, node, path, desc?.value);
         const refresh = () => { this.refreshRows(rows, list); };
+        // Reset/add-key rows always lead; the field rows after them collapse
+        // into virtual groups at a grouped namespace's root (FIELD_GROUPS).
+        const structural = rows.filter(row => row.kind === 'reset' || row.kind === 'addkey');
+        const fields = rows.filter(row => row.kind !== 'reset' && row.kind !== 'addkey');
+        const slots = path.length === 0 && node?.type === 'object'
+            ? slotFieldKeys(ns, fields.map(row => row.path[row.path.length - 1]))
+            : undefined;
+        let fieldItems;
+        if (slots === undefined) {
+            fieldItems = fields.map(row => this.rowItem(row, refresh));
+        }
+        else {
+            const byKey = new Map(fields.map(row => [row.path[row.path.length - 1], row]));
+            fieldItems = [];
+            for (const slot of slots) {
+                if (slot.kind === 'field') {
+                    const row = byKey.get(slot.key);
+                    if (row !== undefined)
+                        fieldItems.push(this.rowItem(row, refresh));
+                }
+                else {
+                    fieldItems.push(this.fieldGroupRow(ns, slot));
+                }
+            }
+        }
+        const items = [...structural.map(row => this.rowItem(row, refresh)), ...fieldItems];
+        const list = new SettingsListPanel(this.theme, {
+            title: title ?? (path.length === 0 ? ns : path.join('.')),
+            rows: items,
+            maxVisible: 12,
+            enableSearch: true,
+            onChange: (id, newValue) => { void this.onCycle(rows, list, id, newValue); },
+            onCancel: () => {
+                refresh();
+                onExit();
+            },
+        });
+        return { list, refresh };
+    }
+    /**
+     * The drill row of one virtual field group (see FIELD_GROUPS): value shows
+     * the member count, the description names the members, and Enter opens the
+     * group's field list.
+     */
+    fieldGroupRow(ns, slot) {
+        const label = resolveFieldGroupLabel(slot.group.labelKey);
+        return {
+            id: `group:${slot.group.id}`,
+            label,
+            value: `{${t('settingsui.fields.count', { count: slot.members.length })}}`,
+            description: slot.members.join(' · '),
+            submenu: (_current, done) => {
+                const child = this.fieldGroupList(ns, label, slot.members, done);
+                return child.list;
+            },
+        };
+    }
+    /**
+     * Field list of one virtual group: the member schema fields exactly as
+     * they would render flat, with the same cycle/input editing — minus the
+     * reset/add-key rows (a virtual group has no single path to reset; the
+     * namespace level still resets the whole subtree).
+     */
+    fieldGroupList(ns, label, members, onExit) {
+        const root = this.root(ns);
+        const rows = [];
+        for (const name of members) {
+            const child = root !== undefined && root.type === 'object' ? root.dict?.[name] : undefined;
+            if (child === undefined || fieldMeta(child).hidden === true)
+                continue;
+            rows.push(this.fieldRow(ns, child, [name], name));
+        }
+        const refresh = () => { this.refreshRows(rows, list); };
         const items = rows.map(row => this.rowItem(row, refresh));
         const list = new SettingsListPanel(this.theme, {
-            title: path.length === 0 ? ns : path.join('.'),
+            title: label,
             rows: items,
             maxVisible: 12,
             enableSearch: true,
@@ -1054,7 +1254,9 @@ class SettingsBrowser {
                 id: '\u0000reset',
                 ns,
                 path,
-                label: `Reset ${path.length === 0 ? 'this namespace' : path.join('.')} to defaults`,
+                label: path.length === 0
+                    ? t('settingsui.reset.namespace')
+                    : t('settingsui.reset.path', { path: path.join('.') }),
                 kind: 'reset',
                 node,
                 value: undefined,
@@ -1065,7 +1267,7 @@ class SettingsBrowser {
                     id: '\u0000add',
                     ns,
                     path,
-                    label: '+ Add key…',
+                    label: t('settingsui.addKey.label'),
                     kind: 'addkey',
                     node,
                     value: undefined,
@@ -1144,14 +1346,16 @@ class SettingsBrowser {
     }
     computeDisplay(kind, node, value, secret) {
         if (secret)
-            return value === undefined || value === null || value === '' ? '(unset)' : '••••••';
+            return value === undefined || value === null || value === '' ? t('settingsui.value.unset') : '••••••';
         switch (kind) {
             case 'drill': {
                 if (node.type === 'object')
-                    return `{${Object.keys(node.dict ?? {}).length} fields}`;
+                    return `{${t('settingsui.fields.count', { count: Object.keys(node.dict ?? {}).length })}}`;
                 if (node.type === 'dict') {
                     const entries = Object.keys((value ?? {}));
-                    return `dict · ${entries.length} ${entries.length === 1 ? 'entry' : 'entries'}`;
+                    return entries.length === 1
+                        ? t('settingsui.dict.one', { count: entries.length })
+                        : t('settingsui.dict.many', { count: entries.length });
                 }
                 return formatValue(value);
             }
@@ -1188,7 +1392,7 @@ class SettingsBrowser {
                 submenu: (_current, done) => new ViewerPanel(this.theme, {
                     title: row.path.join('.'),
                     lines: [
-                        'read-only in the TUI — edit the settings document to change it',
+                        t('settingsui.models.readonly'),
                         '',
                         ...JSON.stringify(row.value, null, 2).split('\n'),
                     ],
@@ -1305,6 +1509,12 @@ class SettingsBrowser {
     }
     /** Build the edit submenu for a leaf row; commits write to settings. */
     inputSubmenu(row, refresh, done) {
+        // dsh-tui.language: pick from the discovered locales instead of typing a
+        // raw id — the same panel the /language command opens, writing through
+        // the standard mutate path (the watch hook applies the language live).
+        if (row.ns === THEME_SETTINGS_NAMESPACE && row.path.length === 1 && row.path[0] === 'language') {
+            return this.languageSubmenu(row, refresh, done);
+        }
         const meta = fieldMeta(row.node);
         const initial = row.secret === true || row.value === undefined || row.value === null
             ? ''
@@ -1312,8 +1522,10 @@ class SettingsBrowser {
         return new EditField(this.tui, {
             title: row.path.join('.'),
             subtitle: row.secret === true
-                ? 'secret — leave empty to keep the current value'
-                : `current: ${row.display}${meta.required === true ? ' · required' : ''}`,
+                ? t('settingsui.edit.secret')
+                : t('settingsui.edit.current', {
+                    value: row.display + (meta.required === true ? ` · ${t('settingsui.meta.required')}` : ''),
+                }),
             initial,
             // role('secret') rows get the masked dot-row renderer too (B2).
             secret: row.secret === true,
@@ -1323,6 +1535,43 @@ class SettingsBrowser {
             onError: message => this.onError(message),
         }, this.theme);
     }
+    /**
+     * The language picker as the dsh-tui.language edit submenu: Enter picks
+     * and commits through the standard mutate path, Esc pops back. A failed
+     * write keeps the picker open with the error on the status line (the
+     * EditField ✘ contract, transplanted onto a table).
+     */
+    languageSubmenu(row, refresh, done) {
+        let status;
+        // A pick is single-shot: the commit is async, and a second Enter landing
+        // before it resolves would close the submenu twice — the second close
+        // returning to the LIST would then re-open the picker on the same row.
+        let settled = false;
+        // Esc may close the picker while a commit is in flight (the EditField
+        // contract); a late failure then has no status line to land on and goes
+        // through onError instead of vanishing.
+        let closed = false;
+        const cancel = () => { closed = true; done(); };
+        return languagePickerPanel(this.theme, typeof row.value === 'string' ? row.value : '', async (picked) => {
+            if (settled)
+                return;
+            settled = true;
+            const result = await this.commitInput(row, refresh, { kind: 'value', value: picked });
+            if (result?.error !== undefined) {
+                if (closed) {
+                    this.onError(result.error);
+                    return;
+                }
+                // The write failed with the picker still open — re-arm for a retry.
+                settled = false;
+                status = t('sel.status.saveFailed', { message: result.error });
+                this.tui.requestRender();
+                return;
+            }
+            if (!closed)
+                done();
+        }, cancel, () => status);
+    }
     parseFor(row, text) {
         // Whitespace-only input on a secret also means "keep" — an accidental
         // space must not unset (delete) the stored secret; clearing a secret is
@@ -1335,9 +1584,9 @@ class SettingsBrowser {
             case 'union': return parseUnionInput(text, row.node);
             case 'transform':
                 return row.node.inner === undefined
-                    ? { kind: 'error', error: `cannot edit ${row.node.type} value` }
+                    ? { kind: 'error', error: t('settingsui.parse.type', { type: row.node.type }) }
                     : this.parseFor({ ...row, node: row.node.inner }, text);
-            default: return { kind: 'error', error: `cannot edit ${row.node.type} value` };
+            default: return { kind: 'error', error: t('settingsui.parse.type', { type: row.node.type }) };
         }
     }
     async commitInput(row, refresh, outcome) {
@@ -1356,15 +1605,15 @@ class SettingsBrowser {
         const inner = row.node.inner ?? row.node;
         const existing = (getPath(this.descriptor(row.ns)?.value, row.path) ?? {});
         return new EditField(this.tui, {
-            title: `+ key in ${row.path.length === 0 ? '…' : row.path.join('.')}`,
-            subtitle: `default: ${formatValue(defaultValueFor(inner))} · Enter to add · Esc to cancel`,
+            title: t('settingsui.addKey.title', { path: row.path.length === 0 ? '…' : row.path.join('.') }),
+            subtitle: t('settingsui.addKey.subtitle', { default: formatValue(defaultValueFor(inner)) }),
             initial: '',
             parse: text => {
                 const key = text.trim();
                 if (key === '')
-                    return { kind: 'error', error: 'key must not be empty' };
+                    return { kind: 'error', error: t('settingsui.addKey.empty') };
                 if (key in existing)
-                    return { kind: 'error', error: `key "${key}" already exists` };
+                    return { kind: 'error', error: t('settingsui.addKey.exists', { key }) };
                 return { kind: 'value', value: key };
             },
             onCommit: async (outcome) => {
@@ -1383,8 +1632,8 @@ class SettingsBrowser {
     /** Reset-to-defaults confirmation for group/namespace rows. */
     resetSubmenu(row, refresh, done) {
         return new ConfirmReset(this.theme, row.path.length === 0
-            ? `Reset "${row.ns}" to defaults`
-            : `Reset ${row.path.join('.')} to defaults`, () => {
+            ? t('settingsui.reset.ns', { ns: row.ns })
+            : t('settingsui.reset.path', { path: row.path.join('.') }), () => {
             void this.write(row.ns, [{ op: 'unset', path: row.path }]).then(error => {
                 if (error !== undefined)
                     this.onError(error);