@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/views/settings-list.js

@@ -3,16 +3,20 @@
  * Pure — the provider owns live application of the selected values.
  * @module @agi-fans/dsh-tui
  */
+import { TERMINAL_TITLE_MODES, TERMINAL_STATE_MODES } from "../runtime/terminal-state.js";
 import { STARTUP_CHANGELOG_MODES } from "../session/release-notes.js";
-import { STATUS_COLOR_TOKENS, STATUS_CONTEXT_STYLES, STATUS_GROUP_IDS, STATUS_LABEL_STYLES, STATUS_META_IDS, isStatusItemId, isStatusMetaId, itemSide, resolveStatusBarConfig, } from "../chrome/status-config.js";
+import { STATUS_DENSITIES, STATUS_ITEM_IDS, isStatusItemId, resolveStatusBarConfig, statusBarDocument, statusItemVisible, toggleStatusItem, } from "../chrome/status-config.js";
 import { renderStatusFooter } from "../chrome/status-line.js";
-import { BOX, SYMBOL, THEME_NAMES, isThemeName } from "../chrome/theme.js";
-import { padToWidth, truncateToWidth, visibleWidth, wrapText } from "../chrome/width.js";
-import { MOTION_MODES } from "../session/tui-settings.js";
+import { BOX, THEME_NAMES, isThemeName } from "../chrome/theme.js";
+import { padToWidth, truncateToWidth, visibleWidth, wrapTextStable } from "../chrome/width.js";
+import { MOTION_MODES, NOTIFICATION_MODES, resolveNotificationMode, } from "../session/tui-settings.js";
 import { MATH_MODES } from "../chrome/math.js";
 import { MERMAID_MODES } from "../chrome/mermaid.js";
-import { formatOverlayHint } from "./hotkey-format.js";
+import { listNavigation } from "./list-navigation.js";
+import { LIST_CURSOR_CELLS, renderListRowWithValue } from "./list-view.js";
 import { FEATURE_TOGGLES } from "../session/feature-toggles.js";
+import { rankSearchResults } from "../input/fuzzy-search.js";
+import { moveGraphemeLeft } from "../chrome/grapheme.js";
 const COLOR_VALUES = ['on', 'off'];
 const STARTUP_CHANGELOG_VALUES = [...STARTUP_CHANGELOG_MODES];
 const AGENT_LANGUAGE_VALUES = ['Auto', 'Simplified Chinese', 'English'];
@@ -22,46 +26,30 @@ const AGENT_LANGUAGE_LABELS = {
     en: 'English',
 };
 const AGENT_LANGUAGE_IDS = Object.fromEntries(Object.entries(AGENT_LANGUAGE_LABELS).map(([id, label]) => [label, id]));
-const STATUS_ITEM_CONTROLS = 'Left/Right sets color; Space shows or hides; Enter then arrows move it.';
+const STATUS_ITEM_CONTROLS = 'Space shows or hides it.';
 const STATUS_ITEM_COPY = {
-    model: { label: 'Model', description: `Model name on the left of the first footer line. ${STATUS_ITEM_CONTROLS}`, sample: 'deepseek' },
+    model: { label: 'Model', description: `Model name on the first footer line. ${STATUS_ITEM_CONTROLS}`, sample: 'deepseek' },
     effort: { label: 'Effort', description: `Reasoning effort on the first footer line. ${STATUS_ITEM_CONTROLS}`, sample: 'max' },
     path: { label: 'Path', description: `Workspace path on the right of the first footer line. ${STATUS_ITEM_CONTROLS}`, sample: '~/project' },
-    git: { label: 'Git', description: `Git branch on the right of the first footer line. A dirty worktree stays warning while color is default. ${STATUS_ITEM_CONTROLS}`, sample: 'main *1' },
-    session: { label: 'Session', description: `Folded session title on the first footer line. Off by default; the terminal window title shows it regardless. ${STATUS_ITEM_CONTROLS}`, sample: 'Fix the parser' },
-    context: { label: 'Context', description: `Context occupancy; choose its representation in Context style. ${STATUS_ITEM_CONTROLS}`, sample: 'Ctx 1.6%' },
-    cache: { label: 'Cache', description: `Prompt-cache hit rate. Cache-hit percentages stay on the success color. ${STATUS_ITEM_CONTROLS}`, sample: 'Cache 99%' },
-    tokens: { label: 'Tokens', description: `Input and output token counts. ${STATUS_ITEM_CONTROLS}`, sample: '5.9M in' },
-    speed: { label: 'Latency', description: `First-token latency and decode rate. ${STATUS_ITEM_CONTROLS}`, sample: 'TTFT 1.2s' },
-    durations: { label: 'Time', description: `LLM and tool duration. ${STATUS_ITEM_CONTROLS}`, sample: 'LLM 16m51s' },
-    counts: { label: 'Activity', description: `Turn and step counts. ${STATUS_ITEM_CONTROLS}`, sample: '3 turns' },
+    git: { label: 'Git', description: `Git branch on the first footer line. A dirty worktree stays warning. ${STATUS_ITEM_CONTROLS}`, sample: 'main *1' },
+    session: { label: 'Session', description: `Folded session title on the first footer line. Off at Standard and Minimal; the terminal window title shows it regardless. ${STATUS_ITEM_CONTROLS}`, sample: 'Fix the parser' },
+    context: { label: 'Context', description: `Context occupancy, on the left of the second line. Its representation follows the density. ${STATUS_ITEM_CONTROLS}`, sample: 'Ctx 1.6%' },
+    cache: { label: 'Cache', description: `Prompt-cache hit rate, beside occupancy on the left. Cache-hit percentages stay on the success color. ${STATUS_ITEM_CONTROLS}`, sample: 'Cache 99%' },
+    tokens: { label: 'Tokens', description: `Input and output token counts, on the right with the other cost figures. ${STATUS_ITEM_CONTROLS}`, sample: '5.9M in' },
+    speed: { label: 'Latency', description: `First-token latency and decode rate, on the right. ${STATUS_ITEM_CONTROLS}`, sample: 'TTFT 1.2s' },
+    durations: { label: 'Time', description: `LLM and tool duration, on the right. ${STATUS_ITEM_CONTROLS}`, sample: 'LLM 16m51s' },
+    counts: { label: 'Activity', description: `Turn and step counts, on the right. ${STATUS_ITEM_CONTROLS}`, sample: '3 turns' },
 };
-function itemSwatch(id, token) {
-    if (token !== 'default')
-        return token === 'label' ? 'customMessageLabel' : token;
-    if (id === 'effort')
-        return 'customMessageLabel';
-    if (id === 'git')
-        return 'warning';
-    if (id === 'path')
-        return 'muted';
-    return 'text';
-}
-function statusItemVisible(config, id) {
-    return isStatusMetaId(id) ? (config.meta ?? STATUS_META_IDS).includes(id) : config.groups.includes(id);
-}
 function statusItemRow(config, id) {
     const visible = statusItemVisible(config, id);
-    const color = config.colors?.[id] ?? 'default';
     const copy = STATUS_ITEM_COPY[id];
     return {
         id: `statusItem:${id}`,
-        label: (itemSide(config, id) === 'right' ? '→ ' : '← ') + copy.label,
+        label: copy.label,
         description: copy.description,
         sample: visible ? copy.sample : 'hidden',
-        value: color,
-        values: STATUS_COLOR_TOKENS,
-        swatch: itemSwatch(id, color),
+        value: visible ? 'shown' : 'hidden',
+        values: ['shown', 'hidden'],
         hidden: !visible,
     };
 }
@@ -102,6 +90,13 @@ function generalSettingItems(prefs, editors = [{ id: 'auto', label: 'Auto' }]) {
             value: prefs.mermaidMode ?? 'auto',
             values: MERMAID_MODES,
         },
+        {
+            id: 'hideThinking',
+            label: 'Thinking in turns',
+            description: 'Shown keeps reasoning visible while a turn runs; Hidden collapses it to one line. Ctrl+T flips this for the session.',
+            value: prefs.hideThinking === true ? 'hidden' : 'shown',
+            values: ['shown', 'hidden'],
+        },
         {
             id: 'editor',
             label: 'Editor',
@@ -131,11 +126,10 @@ function generalSettingItems(prefs, editors = [{ id: 'auto', label: 'Auto' }]) {
             values: COLOR_VALUES,
         },
         {
-            id: 'terminalProgress',
-            label: 'Terminal activity',
-            description: 'Busy/idle status in supported terminal tabs and taskbars',
-            value: prefs.terminalProgress === true ? 'on' : 'off',
-            values: COLOR_VALUES,
+            id: 'terminalTitle', label: 'Terminal title', description: 'Status and session, session only, status and workspace, or Off. Changes the terminal tab title.', value: prefs.terminalTitle ?? 'status', values: TERMINAL_TITLE_MODES,
+        },
+        {
+            id: 'terminalState', label: 'Terminal status', description: 'Auto reports the root Agent lifecycle once the terminal answers an OSC 7501 capability query; On reports regardless; Off clears reports.', value: prefs.terminalState ?? 'auto', values: TERMINAL_STATE_MODES,
         },
         {
             id: 'checkUpdates',
@@ -154,23 +148,9 @@ function generalSettingItems(prefs, editors = [{ id: 'auto', label: 'Auto' }]) {
         {
             id: 'notifications',
             label: 'Notifications',
-            description: 'Notify when a turn finishes or input is required',
-            value: prefs.notifications ?? 'off',
-            values: ['off', 'long-running', 'always'],
-        },
-        {
-            id: 'notificationFocus',
-            label: 'Notify when',
-            description: 'Only notify while away from the terminal, or regardless of focus. Terminals without focus reports use the existing notification policy.',
-            value: prefs.notificationFocus ?? 'unfocused',
-            values: ['unfocused', 'always'],
-        },
-        {
-            id: 'notificationThreshold',
-            label: 'Long turn',
-            description: 'Minimum duration for long-running notifications',
-            value: prefs.notificationThreshold ?? '30s',
-            values: ['15s', '30s', '1m', '2m'],
+            description: 'Notify when a long turn finishes or input is required. Away also waits until the terminal loses focus; Always reports regardless of focus.',
+            value: resolveNotificationMode(prefs.notifications, prefs.notificationFocus),
+            values: NOTIFICATION_MODES,
         },
     ];
 }
@@ -191,28 +171,21 @@ function statusSettingItems(prefs) {
         {
             id: 'statusEnabled',
             label: 'Telemetry',
-            description: 'Show session metrics on the second footer line',
+            description: 'Show session metrics below the first footer line',
             value: statusBar.enabled ? 'on' : 'off',
             values: COLOR_VALUES,
         },
         {
-            id: 'statusLabels',
-            label: 'Context label',
-            description: 'Use Ctx or Context before the occupancy value',
-            value: statusBar.labels,
-            values: STATUS_LABEL_STYLES,
-        },
-        {
-            id: 'statusContextStyle',
-            label: 'Context style',
-            description: 'Percentage, a ten-cell bar, used/window tokens, or percentage with tokens',
-            value: statusBar.contextStyle,
-            values: STATUS_CONTEXT_STYLES,
+            id: 'statusDensity',
+            label: 'Density',
+            description: 'Minimal shows occupancy and cache; Standard adds latency; Verbose adds tokens on the same line and gives durations and activity a third, with long labels and the detailed context form',
+            value: statusBar.density,
+            values: STATUS_DENSITIES,
         },
-        ...statusBar.metaOrder.filter(id => itemSide(statusBar, id) === 'left').map(id => statusItemRow(statusBar, id)),
-        ...statusBar.metaOrder.filter(id => itemSide(statusBar, id) === 'right').map(id => statusItemRow(statusBar, id)),
-        ...statusBar.order.filter(id => itemSide(statusBar, id) === 'left').map(id => statusItemRow(statusBar, id)),
-        ...statusBar.order.filter(id => itemSide(statusBar, id) === 'right').map(id => statusItemRow(statusBar, id)),
+        // Each part has one fixed place, so the rows below are a list of what
+        // appears rather than a layout to assemble: Space shows or hides, and
+        // nothing has to be dragged into a column.
+        ...STATUS_ITEM_IDS.map(id => statusItemRow(statusBar, id)),
     ];
 }
 /**
@@ -230,68 +203,10 @@ function featureSettingItems(features) {
     }));
 }
 /** Product-owned rows shown in `/settings` (OMP settings-list cycle widgets). */
-export function tuiSettingItems(prefs, agent, features, plugins, editors) {
-    return [
-        ...generalSettingItems(prefs, editors),
-        ...agentSettingItems(agent),
-        ...(features === undefined ? [] : featureSettingItems(features)),
-        ...statusSettingItems(prefs),
-        ...(plugins ?? []).map(plugin => ({ ...plugin, id: `plugin:${plugin.id}`, value: 'Edit', values: [] })),
-    ];
-}
-function showInOrder(visible, order, id) {
-    const next = visible.filter(item => item !== id);
-    const position = order.indexOf(id);
-    const insert = next.findIndex(item => order.indexOf(item) > position);
-    next.splice(insert < 0 ? next.length : insert, 0, id);
-    return next;
-}
-function updateStatusGroup(config, id, value) {
-    const groups = config.groups.filter(group => group !== id);
-    if (value === 'hidden' || value === 'off')
-        return { ...config, groups };
-    if (value === 'shown')
-        return { ...config, groups: showInOrder(groups, config.order ?? STATUS_GROUP_IDS, id) };
-    const position = Number.parseInt(value, 10);
-    if (!Number.isInteger(position) || position < 1 || position > STATUS_GROUP_IDS.length)
-        return config;
-    groups.splice(Math.min(position - 1, groups.length), 0, id);
-    return { ...config, groups };
-}
-function toggleStatusItem(config, id) {
-    if (isStatusMetaId(id)) {
-        const meta = config.meta ?? [...STATUS_META_IDS];
-        const hidden = !meta.includes(id);
-        return {
-            ...config,
-            meta: hidden ? showInOrder(meta.filter(item => item !== id), config.metaOrder ?? STATUS_META_IDS, id) : meta.filter(item => item !== id),
-        };
-    }
-    return updateStatusGroup(config, id, statusItemVisible(config, id) ? 'hidden' : 'shown');
-}
-function reorderVisible(visible, order, moving, direction) {
-    const from = visible.indexOf(moving);
-    if (from < 0)
-        return { visible: [...visible], order: [...order] };
-    const to = Math.max(0, Math.min(visible.length - 1, from + direction));
-    const nextVisible = [...visible];
-    if (to !== from) {
-        nextVisible.splice(from, 1);
-        nextVisible.splice(to, 0, moving);
-    }
-    const visibleSet = new Set(nextVisible);
-    const nextOrder = [];
-    let visibleIndex = 0;
-    for (const item of order) {
-        if (visibleSet.has(item))
-            nextOrder.push(nextVisible[visibleIndex++]);
-        else
-            nextOrder.push(item);
-    }
-    for (const item of nextVisible)
-        if (!nextOrder.includes(item))
-            nextOrder.push(item);
-    return { visible: nextVisible, order: nextOrder };
+export function tuiSettingItems(prefs, agent, features, plugins, editors, actions) {
+    return settingGroups({ prefs, ...(agent === undefined ? {} : { agent }), ...(features === undefined ? {} : { features }),
+        ...(plugins === undefined ? {} : { plugins }), ...(editors === undefined ? {} : { editors }),
+        ...(actions === undefined ? {} : { actions }) }).flatMap(group => group.items);
 }
 /** Apply one cycled value back onto the prefs record. */
 export function applySettingValue(prefs, id, value) {
@@ -305,6 +220,8 @@ export function applySettingValue(prefs, id, value) {
         return { ...prefs, mathMode: value };
     if (id === 'mermaidMode' && MERMAID_MODES.includes(value))
         return { ...prefs, mermaidMode: value };
+    if (id === 'hideThinking')
+        return { ...prefs, hideThinking: value === 'hidden' };
     if (id === 'pasteProtection')
         return { ...prefs, pasteProtection: value === 'on' };
     if (id === 'copyOnSelect')
@@ -312,54 +229,60 @@ export function applySettingValue(prefs, id, value) {
     if (id === 'mouseInteraction' && ['auto', 'tui', 'native'].includes(value)) {
         return { ...prefs, mouseInteraction: value };
     }
-    if (id === 'terminalProgress')
-        return { ...prefs, terminalProgress: value === 'on' };
+    if (id === 'terminalTitle' && TERMINAL_TITLE_MODES.includes(value))
+        return { ...prefs, terminalTitle: value };
+    if (id === 'terminalState' && TERMINAL_STATE_MODES.includes(value))
+        return { ...prefs, terminalState: value };
     if (id === 'checkUpdates')
         return { ...prefs, checkUpdates: value === 'on' };
     if (id === 'startupChangelog' && STARTUP_CHANGELOG_MODES.includes(value)) {
         return { ...prefs, startupChangelog: value };
     }
-    if (id === 'notifications' && ['off', 'long-running', 'always'].includes(value)) {
+    if (id === 'notifications' && NOTIFICATION_MODES.includes(value)) {
         return { ...prefs, notifications: value };
     }
-    if (id === 'notificationFocus' && ['always', 'unfocused'].includes(value))
-        return { ...prefs, notificationFocus: value };
-    if (id === 'notificationThreshold' && ['15s', '30s', '1m', '2m'].includes(value)) {
-        return { ...prefs, notificationThreshold: value };
+    /**
+     * The status line is one document: a density, plus the parts hidden on top of
+     * it. Row identity decides which field moves — there is no per-item colour or
+     * column left to write, and `enabled` survives only as "telemetry off".
+     */
+    const statusBar = storedStatusBar(prefs);
+    if (id === 'statusDensity' && STATUS_DENSITIES.includes(value)) {
+        return { ...prefs, statusBar: { ...statusBar, density: value } };
     }
-    const statusBar = resolveStatusBarConfig(prefs.statusBar, prefs.statusPreset);
     if (id === 'statusEnabled')
         return { ...prefs, statusBar: { ...statusBar, enabled: value === 'on' } };
-    if (id === 'statusLabels' && STATUS_LABEL_STYLES.includes(value)) {
-        return { ...prefs, statusBar: { ...statusBar, labels: value } };
-    }
-    if (id === 'statusContextStyle' && STATUS_CONTEXT_STYLES.includes(value)) {
-        return { ...prefs, statusBar: { ...statusBar, contextStyle: value } };
-    }
     if (id.startsWith('statusItem:')) {
         const item = id.slice('statusItem:'.length);
-        if (isStatusItemId(item) && STATUS_COLOR_TOKENS.includes(value)) {
-            return { ...prefs, statusBar: { ...statusBar, colors: { ...statusBar.colors, [item]: value } } };
-        }
-        if (isStatusItemId(item) && (value === 'shown' || value === 'hidden' || value === 'off')) {
-            const wantVisible = value === 'shown';
-            if (statusItemVisible(statusBar, item) === wantVisible)
-                return prefs;
-            return { ...prefs, statusBar: toggleStatusItem(statusBar, item) };
-        }
-        if (STATUS_GROUP_IDS.includes(item)) {
-            return { ...prefs, statusBar: updateStatusGroup(statusBar, item, value) };
-        }
+        if (!isStatusItemId(item))
+            return prefs;
+        if (value !== 'shown' && value !== 'hidden' && value !== 'off')
+            return prefs;
+        const resolved = resolveStatusBarConfig(statusBar);
+        if (statusItemVisible(resolved, item) === (value === 'shown'))
+            return prefs;
+        return { ...prefs, statusBar: toggleStatusItem(statusBar, item) };
     }
     return prefs;
 }
+/**
+ * The document as it stands, ready for one edit.
+ *
+ * The narrowing is read from the *stored* document, not reconstructed from what
+ * the footer is showing. Reconstructing it turned every part the density happens
+ * to omit into an explicit hiding: pressing Space on one row then silently made
+ * a different density show less, which is the drift this replaced.
+ */
+function storedStatusBar(prefs) {
+    return statusBarDocument(resolveStatusBarConfig(prefs.statusBar, prefs.statusPreset));
+}
 function adjacentValue(current, values, direction) {
     const index = values.indexOf(current);
     return values[(index + direction + values.length) % values.length] ?? values[0] ?? current;
 }
 /** Open the overlay on the current prefs, optionally focused on one row. */
-export function createSettings(prefs, focusId, agent, features, plugins, editors) {
-    const items = tuiSettingItems(prefs, agent, features, plugins, editors);
+export function createSettings(prefs, focusId, agent, features, plugins, editors, actions) {
+    const items = tuiSettingItems(prefs, agent, features, plugins, editors, actions);
     const focused = focusId === undefined ? 0 : items.findIndex((item) => item.id === focusId);
     return {
         prefs,
@@ -368,93 +291,73 @@ export function createSettings(prefs, focusId, agent, features, plugins, editors
         ...(features === undefined ? {} : { features }),
         ...(plugins === undefined ? {} : { plugins }),
         ...(editors === undefined ? {} : { editors }),
+        ...(actions === undefined ? {} : { actions }),
     };
 }
 function selectedStatusItem(state) {
-    const id = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors)[state.selected]?.id;
+    const id = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions)[state.selected]?.id;
     if (id?.startsWith('statusItem:') !== true)
         return undefined;
     const item = id.slice('statusItem:'.length);
     return isStatusItemId(item) ? item : undefined;
 }
-function startMoving(state, item) {
-    const config = resolveStatusBarConfig(state.prefs.statusBar, state.prefs.statusPreset);
-    const prefs = statusItemVisible(config, item)
-        ? state.prefs
-        : { ...state.prefs, statusBar: toggleStatusItem(config, item) };
-    const selected = tuiSettingItems(prefs, state.agent, state.features, state.plugins, state.editors).findIndex(row => row.id === `statusItem:${item}`);
-    return { ...state, prefs, selected: Math.max(0, selected), moving: item };
-}
-function assignItemSide(config, id, side) {
-    if (itemSide(config, id) === side)
-        return config;
-    const next = { ...config, sides: { ...config.sides, [id]: side } };
-    if (isStatusMetaId(id)) {
-        const order = (next.metaOrder ?? STATUS_META_IDS).filter(item => item !== id);
-        let last = -1;
-        for (let index = 0; index < order.length; index += 1) {
-            if (itemSide(next, order[index]) === side)
-                last = index;
-        }
-        order.splice(last + 1, 0, id);
-        return { ...next, metaOrder: order };
-    }
-    const order = (next.order ?? STATUS_GROUP_IDS).filter(item => item !== id);
-    let last = -1;
-    for (let index = 0; index < order.length; index += 1) {
-        if (itemSide(next, order[index]) === side)
-            last = index;
-    }
-    order.splice(last + 1, 0, id);
-    return { ...next, order };
-}
-function moveStatusItem(state, direction) {
-    const moving = state.moving;
-    if (moving === undefined)
-        return state;
-    const config = resolveStatusBarConfig(state.prefs.statusBar, state.prefs.statusPreset);
-    const side = itemSide(config, moving);
-    if (isStatusMetaId(moving)) {
-        const reordered = reorderVisible(config.meta.filter(id => itemSide(config, id) === side), config.metaOrder, moving, direction);
-        const prefs = { ...state.prefs, statusBar: { ...config, meta: reordered.visible.concat(config.meta.filter(id => itemSide(config, id) !== side)), metaOrder: reordered.order } };
-        const selected = tuiSettingItems(prefs, state.agent, state.features, state.plugins, state.editors).findIndex(row => row.id === `statusItem:${moving}`);
-        return { ...state, prefs, selected, moving };
-    }
-    const reordered = reorderVisible(config.groups.filter(id => itemSide(config, id) === side), config.order, moving, direction);
-    const prefs = { ...state.prefs, statusBar: { ...config, groups: reordered.visible.concat(config.groups.filter(id => itemSide(config, id) !== side)), order: reordered.order } };
-    const selected = tuiSettingItems(prefs, state.agent, state.features, state.plugins, state.editors).findIndex(row => row.id === `statusItem:${moving}`);
-    return { ...state, prefs, selected, moving };
-}
-function moveStatusItemSide(state, side) {
-    const moving = state.moving;
-    if (moving === undefined)
-        return state;
-    const config = resolveStatusBarConfig(state.prefs.statusBar, state.prefs.statusPreset);
-    const prefs = { ...state.prefs, statusBar: assignItemSide(config, moving, side) };
-    const selected = tuiSettingItems(prefs, state.agent, state.features, state.plugins, state.editors).findIndex(row => row.id === `statusItem:${moving}`);
-    return { ...state, prefs, selected, moving };
+function settingGroups(state) {
+    const owned = (section) => (state.plugins ?? [])
+        .filter(entry => (entry.section ?? 'advanced') === section)
+        .map(entry => ({ ...entry, id: `plugin:${entry.id}`, value: entry.inline?.value ?? entry.summary ?? 'Configure',
+        values: entry.inline?.choices.map(choice => choice.label) ?? [], resettable: (entry.fields?.length ?? 0) > 0 }));
+    return [
+        { id: 'general', label: 'Interface', items: [...generalSettingItems(state.prefs, state.editors).map(item => ({ ...item,
+                    resettable: true, group: ['theme', 'colors', 'motion', 'mathMode', 'mermaidMode', 'hideThinking', 'terminalTitle', 'terminalState'].includes(item.id) ? 'Appearance'
+                        : ['editor', 'mouseInteraction', 'pasteProtection', 'copyOnSelect'].includes(item.id) ? 'Input'
+                            : ['checkUpdates', 'startupChangelog'].includes(item.id) ? 'Startup' : 'Notifications',
+                    description: item.description,
+                })), ...(state.actions ?? []).filter(item => item.group === 'Input')].sort((a, b) => ['Appearance', 'Input', 'Notifications', 'Startup'].indexOf(a.group ?? '') - ['Appearance', 'Input', 'Notifications', 'Startup'].indexOf(b.group ?? '')) },
+        { id: 'agent', label: 'Agent', items: [...(state.actions ?? []).filter(item => item.group !== 'Input'), ...agentSettingItems(state.agent).map(item => ({ ...item, resettable: true, description: `${item.description}. Saved in this profile; applies from the next turn.` })), ...owned('agent')] },
+        { id: 'tools', label: 'Tools', items: [...(state.features === undefined ? [] : featureSettingItems(state.features)), ...owned('tools')] },
+        { id: 'status', label: 'Status line', items: [...statusSettingItems(state.prefs).map(item => ({ ...item, resettable: true })),
+                { id: 'statusReset', label: 'Restore layout', value: 'Restore', values: [], resettable: true, description: 'Restore the inherited status-line layout, colors and visibility. Confirmation shows what will be restored.' }] },
+        { id: 'integrations', label: 'Integrations', items: owned('integrations') },
+        { id: 'advanced', label: 'Advanced', items: owned('advanced') },
+    ].filter(group => group.items.length > 0);
 }
 function settingSections(state) {
-    const generalEnd = generalSettingItems(state.prefs, state.editors).length;
-    const agentEnd = generalEnd + agentSettingItems(state.agent).length;
-    const featuresEnd = agentEnd + (state.features === undefined ? 0 : FEATURE_TOGGLES.length);
-    const statusEnd = featuresEnd + statusSettingItems(state.prefs).length;
-    return [
-        { id: 'general', label: 'General', start: 0, end: generalEnd },
-        ...(agentEnd === generalEnd ? [] : [{ id: 'agent', label: 'Agent', start: generalEnd, end: agentEnd }]),
-        ...(featuresEnd === agentEnd
-            ? []
-            : [{ id: 'features', label: 'Features', start: agentEnd, end: featuresEnd }]),
-        { id: 'status', label: 'Status line', start: featuresEnd, end: statusEnd },
-        ...(!state.plugins?.length ? [] : [{ id: 'plugins', label: 'Plugins', start: statusEnd, end: statusEnd + state.plugins.length }]),
-    ];
+    let start = 0;
+    return settingGroups(state).map(group => {
+        const section = { id: group.id, label: group.label, start, end: start + group.items.length };
+        start = section.end;
+        return section;
+    });
 }
 function selectedSection(state) {
     const sections = settingSections(state);
     return sections.find(section => state.selected >= section.start && state.selected < section.end)
         ?? sections[0];
 }
+function settingsMatches(state) {
+    let index = 0;
+    const rows = settingGroups(state).flatMap(group => group.items.map(item => ({ item, index: index++, section: group.label })));
+    return rankSearchResults(rows, state.search ?? '', row => [row.item.label, row.item.description, row.section, row.item.group ?? '', ...row.item.keywords ?? []]);
+}
+function searchSettings(state, query) {
+    const next = { ...state, search: query };
+    const rows = settingsMatches(next);
+    return { ...next, selected: rows.find(row => row.index === state.selected)?.index ?? rows[0]?.index ?? state.selected };
+}
+/** Preserve selection and a cross-category search when live configuration refreshes. */
+export function refreshSettings(state, next) {
+    const id = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions)[state.selected]?.id;
+    const selected = tuiSettingItems(next.prefs, next.agent, next.features, next.plugins, next.editors, next.actions).findIndex(item => item.id === id);
+    const updated = { ...next, selected: selected < 0 ? next.selected : selected,
+        ...(state.searchOrigin === undefined ? {} : { searchOrigin: state.searchOrigin }) };
+    return state.search === undefined ? updated : searchSettings(updated, state.search);
+}
 function moveSelected(state, next) {
+    if (state.search !== undefined) {
+        const rows = settingsMatches(state), current = rows.findIndex(row => row.index === state.selected);
+        const index = rows[Math.max(0, Math.min(rows.length - 1, current + next - state.selected))]?.index;
+        return index === undefined ? state : { ...state, selected: index };
+    }
     const section = selectedSection(state);
     const selected = Math.max(section.start, Math.min(next, section.end - 1));
     if (selected === state.selected)
@@ -466,15 +369,25 @@ function moveSection(state, direction) {
     const active = selectedSection(state);
     const current = sections.findIndex(section => section.id === active.id);
     const next = (current + direction + sections.length) % sections.length;
-    return { ...state, selected: sections[next]?.start ?? 0 };
+    const { search: _, searchOrigin: __, ...browse } = state;
+    return { ...browse, selected: sections[next]?.start ?? 0 };
 }
 function cycleSelected(state, direction = 1) {
-    const items = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors);
+    const items = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions);
     const item = items[state.selected];
     if (item === undefined)
         return { kind: 'ignore' };
-    if (item.id.startsWith('plugin:'))
+    if (item.action !== undefined)
         return { kind: 'ignore' };
+    if (item.id.startsWith('plugin:')) {
+        const entry = state.plugins?.find(entry => `plugin:${entry.id}` === item.id);
+        const choices = entry?.inline?.choices;
+        if (entry === undefined || choices === undefined || choices.length === 0)
+            return { kind: 'ignore' };
+        const current = choices.findIndex(choice => choice.label === item.value);
+        const next = current < 0 ? direction === 1 ? 0 : choices.length - 1 : (current + direction + choices.length) % choices.length;
+        return { kind: 'set-plugin', entry, value: choices[next].value };
+    }
     const value = adjacentValue(item.value, item.values, direction);
     if (item.id === 'editor') {
         const editor = state.editors?.find(choice => choice.label === value)?.id ?? 'auto';
@@ -502,25 +415,43 @@ function cycleSelected(state, direction = 1) {
 }
 /** Apply one decoded event to the overlay. */
 export function applySettingsEvent(state, event) {
-    if ((event.type === 'key' && event.id === 'enter') || (event.type === 'text' && event.value === ' ')) {
-        const selected = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors)[state.selected];
-        if (selected?.id.startsWith('plugin:'))
-            return { kind: 'open-plugin', id: selected.id.slice('plugin:'.length) };
-    }
-    if (state.moving !== undefined) {
-        if (event.type !== 'key')
-            return { kind: 'ignore' };
-        if (event.id === 'up' || event.id === 'down') {
-            return { kind: 'apply', domain: 'tui', state: moveStatusItem(state, event.id === 'up' ? -1 : 1) };
+    {
+        if (event.type === 'text' && (state.search !== undefined || event.value !== ' ')) {
+            const origin = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions)[state.selected]?.id;
+            const searching = state.search === undefined ? { ...state, search: '', ...(origin === undefined ? {} : { searchOrigin: origin }) } : state;
+            return { kind: 'update', state: searchSettings(searching, (searching.search ?? '') + (event.value === '/' && state.search === undefined ? '' : event.value.replace(/[\r\n]/gu, ' '))) };
         }
-        if (event.id === 'left' || event.id === 'right') {
-            return { kind: 'apply', domain: 'tui', state: moveStatusItemSide(state, event.id === 'left' ? 'left' : 'right') };
+        if (state.search !== undefined && event.type === 'key') {
+            if (event.id === 'escape' || event.id === 'ctrl+c') {
+                if (state.search !== '')
+                    return { kind: 'update', state: searchSettings(state, '') };
+                const { search: _, searchOrigin, ...browse } = state;
+                const index = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions).findIndex(item => item.id === searchOrigin);
+                return { kind: 'update', state: { ...browse, selected: index < 0 ? state.selected : index } };
+            }
+            if (event.id === 'backspace' || event.id === 'ctrl+u')
+                return { kind: 'update', state: searchSettings(state, event.id === 'ctrl+u' ? '' : state.search.slice(0, moveGraphemeLeft(state.search, state.search.length))) };
+            if (event.id === 'home' || event.id === 'end') {
+                const rows = settingsMatches(state);
+                return { kind: 'update', state: { ...state, selected: (event.id === 'home' ? rows[0] : rows.at(-1))?.index ?? state.selected } };
+            }
+            if (settingsMatches(state).length === 0 && ['enter', 'left', 'right', 'ctrl+r'].includes(event.id))
+                return { kind: 'ignore' };
         }
-        if (event.id === 'enter' || event.id === 'escape' || event.id === 'ctrl+c') {
-            const { moving: _, ...rest } = state;
-            return { kind: 'update', state: rest };
+        const selected = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions)[state.selected];
+        if (event.type === 'key' && event.id === 'ctrl+r' && selected?.resettable) {
+            const entry = state.plugins?.find(entry => `plugin:${entry.id}` === selected.id);
+            return { kind: 'reset', id: selected.id, label: selected.label, ...(entry === undefined ? {} : { entry }) };
         }
-        return { kind: 'ignore' };
+        if (event.type === 'key' && event.id === 'enter' && selected?.id === 'statusReset')
+            return { kind: 'reset', id: selected.id, label: selected.label };
+        if (selected?.action !== undefined && event.type === 'key' && event.id === 'enter')
+            return { kind: 'open-command', name: selected.action };
+    }
+    if ((event.type === 'key' && event.id === 'enter') || (event.type === 'text' && event.value === ' ')) {
+        const selected = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions)[state.selected];
+        if (selected?.id.startsWith('plugin:') && (event.type === 'key' || selected.values.length === 0))
+            return { kind: 'open-plugin', id: selected.id.slice('plugin:'.length) };
     }
     if (event.type === 'text' && event.value === ' ') {
         const item = selectedStatusItem(state);
@@ -531,10 +462,7 @@ export function applySettingsEvent(state, event) {
             domain: 'tui',
             state: {
                 ...state,
-                prefs: {
-                    ...state.prefs,
-                    statusBar: toggleStatusItem(resolveStatusBarConfig(state.prefs.statusBar, state.prefs.statusPreset), item),
-                },
+                prefs: { ...state.prefs, statusBar: toggleStatusItem(storedStatusBar(state.prefs), item) },
             },
         };
     }
@@ -542,33 +470,31 @@ export function applySettingsEvent(state, event) {
         return { kind: 'ignore' };
     switch (event.id) {
         case 'enter':
-            {
-                const item = selectedStatusItem(state);
-                if (item !== undefined)
-                    return { kind: 'apply', domain: 'tui', state: startMoving(state, item) };
-            }
             return cycleSelected(state);
         case 'right':
             return cycleSelected(state);
         case 'left':
             return cycleSelected(state, -1);
-        case 'escape':
-        case 'ctrl+c':
-            return { kind: 'close' };
-        case 'up':
-            return { kind: 'update', state: moveSelected(state, state.selected - 1) };
-        case 'down':
-            return { kind: 'update', state: moveSelected(state, state.selected + 1) };
+        // This overlay keeps three keys that a plain list would spend on movement:
+        // `tab` switches section, and `home`/`end` jump to the edge of the current
+        // section rather than of the whole list, which is the only reading that makes
+        // sense when the rows above belong to another category.
         case 'tab':
             return { kind: 'update', state: moveSection(state, 1) };
         case 'shift+tab':
             return { kind: 'update', state: moveSection(state, -1) };
         case 'home':
-            return { kind: 'update', state: moveSelected(state, 0) };
+            return { kind: 'update', state: moveSelected(state, selectedSection(state).start) };
         case 'end':
             return { kind: 'update', state: moveSelected(state, selectedSection(state).end - 1) };
-        default:
+        default: {
+            const navigation = listNavigation(event);
+            if (navigation.kind === 'close')
+                return { kind: 'close' };
+            if (navigation.kind === 'move')
+                return { kind: 'update', state: moveSelected(state, state.selected + navigation.delta) };
             return { kind: 'ignore' };
+        }
     }
 }
 /** First overlay-local row that paints a setting item. */
@@ -578,14 +504,11 @@ export const SETTINGS_ITEM_ROW = 3;
 const HOTKEY_NAVIGATE = { keys: '↑↓', action: 'Navigate rows' };
 const HOTKEY_CHANGE = { keys: '←→', action: 'Change the selected value' };
 const HOTKEY_TOGGLE = { keys: 'Space', action: 'Toggle — show or hide a status item, or cycle other rows' };
-const HOTKEY_MOVE = { keys: 'Enter', action: 'Change — move a status item, edit a plugin, or cycle other rows' };
+const HOTKEY_MOVE = { keys: 'Enter', action: 'Change — open configuration, or cycle other rows' };
 const HOTKEY_SECTION = { keys: 'Tab / Shift+Tab', action: 'Switch section' };
 const HOTKEY_EDGE = { keys: 'Home / End', action: 'Jump to the section edges' };
-const HOTKEY_CLOSE = { keys: 'Esc', action: 'Close the overlay' };
-const HOTKEY_CANCEL = { keys: 'Ctrl+C', action: 'Close the overlay, or place the grabbed item while moving' };
-const HOTKEY_ORDER = { keys: '↑↓', action: 'Order the grabbed item while moving' };
-const HOTKEY_COLUMN = { keys: '←→', action: 'Column — choose the footer side while moving' };
-const HOTKEY_PLACE = { keys: 'Enter / Esc', action: 'Place the grabbed item and stop moving' };
+const HOTKEY_CLOSE = { keys: 'Esc', action: 'Clear search, return to browsing, or close the overlay' };
+const HOTKEY_CANCEL = { keys: 'Ctrl+C', action: 'Close the overlay' };
 /** Keys the settings overlay accepts; `/help` and its bottom hint read this list. */
 export const SETTINGS_HOTKEYS = [
     HOTKEY_NAVIGATE,
@@ -594,17 +517,15 @@ export const SETTINGS_HOTKEYS = [
     HOTKEY_MOVE,
     HOTKEY_SECTION,
     HOTKEY_EDGE,
+    { keys: '/ or Text', action: 'Search across all categories' },
+    { keys: 'Backspace / Ctrl+U', action: 'Edit or clear the settings search' },
+    { keys: 'Ctrl+R', action: 'Restore inheritance for the selected setting' },
     HOTKEY_CLOSE,
     HOTKEY_CANCEL,
-    HOTKEY_ORDER,
-    HOTKEY_COLUMN,
-    HOTKEY_PLACE,
 ];
 /** Bottom hint for the overlay; the grabbed-row state swaps in its own gestures. */
-function settingsHints(moving) {
-    return moving
-        ? formatOverlayHint([HOTKEY_ORDER, HOTKEY_COLUMN, HOTKEY_PLACE])
-        : formatOverlayHint([HOTKEY_NAVIGATE, HOTKEY_CHANGE, HOTKEY_TOGGLE, HOTKEY_MOVE, HOTKEY_CLOSE]);
+function settingsHints() {
+    return '↑↓ select · ←→ change · Tab sections · / search · Ctrl+R reset · Esc back';
 }
 function fit(text, width) {
     if (width <= 0)
@@ -616,7 +537,7 @@ function border(theme, text) {
 }
 function topBorder(theme, width) {
     const inner = Math.max(0, width - 2);
-    const title = truncateToWidth(' Settings ', Math.max(0, inner - 2));
+    const title = truncateToWidth(' Settings · Profile ', Math.max(0, inner - 2));
     const fill = Math.max(0, inner - 1 - visibleWidth(title));
     return border(theme, BOX.topLeft + BOX.horizontal)
         + theme.bold(theme.fg('accent', title))
@@ -637,7 +558,9 @@ function renderSectionTabs(active, sections, theme, width) {
         ? theme.bold(theme.fg('accent', `● ${label}`))
         : theme.fg('muted', `○ ${label}`);
     const all = ' ' + sections.map(section => tab(section.id, section.label)).join('    ');
-    return framedRow(theme, visibleWidth(all) <= width - 4 ? all : ' ' + tab(active, sections.find(section => section.id === active)?.label ?? active), width);
+    const current = sections.findIndex(section => section.id === active);
+    return framedRow(theme, visibleWidth(all) <= width - 4 ? all
+        : ` ‹ ${tab(active, sections[current]?.label ?? active)} · ${current + 1}/${sections.length} ›`, width);
 }
 const STATUS_PREVIEW_STATS = {
     turns: 3,
@@ -680,7 +603,7 @@ function renderStatusPreview(state, theme, width, rows) {
 }
 /** Fullscreen OMP-style settings frame with stable chrome and section tabs. */
 export function renderSettings(state, theme, width, height = 24) {
-    const items = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors);
+    const items = tuiSettingItems(state.prefs, state.agent, state.features, state.plugins, state.editors, state.actions);
     const index = Math.max(0, Math.min(state.selected, Math.max(0, items.length - 1)));
     const viewState = index === state.selected ? state : { ...state, selected: index };
     const sections = settingSections(viewState);
@@ -697,39 +620,61 @@ export function renderSettings(state, theme, width, height = 24) {
         ? renderStatusPreview(state, theme, width, maxPreviewContent)
         : [];
     const previewRows = previewLines.length === 0 ? 0 : previewLines.length + 1;
-    const viewportHeight = Math.max(1, height - 6 - descriptionRows - previewRows);
-    const localSelection = index - sectionStart;
-    const visibleCount = Math.min(viewportHeight, sectionItems.length);
-    const start = Math.max(0, Math.min(localSelection - Math.floor(visibleCount / 2), sectionItems.length - visibleCount));
-    const visibleItems = sectionItems.slice(start, start + visibleCount);
-    const selected = items[index];
-    const lines = [topBorder(theme, width), renderSectionTabs(active, sections, theme, width), divider(theme, width)];
+    const matches = state.search === undefined ? undefined : settingsMatches(state);
+    let previousGroup;
+    const rows = matches ?? sectionItems.flatMap((item, offset) => {
+        const heading = item.group !== undefined && item.group !== previousGroup ? [{ group: item.group }] : [];
+        previousGroup = item.group;
+        return [...heading, { item, index: sectionStart + offset }];
+    });
+    const viewportHeight = Math.max(1, height - 6 - descriptionRows - previewRows - (matches === undefined ? 0 : 1));
+    const localSelection = rows.findIndex(row => 'item' in row && row.index === index);
+    const visibleCount = Math.min(viewportHeight, rows.length);
+    const start = Math.max(0, Math.min(localSelection - Math.floor(visibleCount / 2), rows.length - visibleCount));
+    const visibleItems = rows.slice(start, start + visibleCount);
+    const selected = matches?.length === 0 ? undefined : items[index];
+    const lines = [topBorder(theme, width), renderSectionTabs(active, sections, theme, width)];
+    if (matches !== undefined)
+        lines.push(framedRow(theme, `Search: ${state.search || 'type to filter'} · ${matches.length} matches`, width));
+    lines.push(divider(theme, width));
     if (previewLines.length > 0) {
         lines.push(...previewLines, divider(theme, width));
     }
     let cursorRow = SETTINGS_ITEM_ROW;
     for (let row = 0; row < viewportHeight; row += 1) {
-        const item = visibleItems[row];
-        if (item === undefined) {
-            lines.push(framedRow(theme, '', width));
+        const entry = visibleItems[row];
+        if (entry === undefined) {
+            lines.push(framedRow(theme, row === 0 && matches?.length === 0 ? theme.fg('muted', 'No matching settings') : '', width));
+            continue;
+        }
+        if ('group' in entry) {
+            lines.push(framedRow(theme, theme.fg('dim', ` ${entry.group}`), width));
             continue;
         }
-        const itemIndex = sectionStart + start + row;
-        const selectedRow = itemIndex === index;
+        const item = entry.item;
+        const selectedRow = entry.index === index;
         if (selectedRow)
             cursorRow = lines.length;
         const above = start > 0 && row === 0 ? theme.fg('dim', '↑ ') : '';
-        const below = start + visibleCount < sectionItems.length && row === viewportHeight - 1 ? theme.fg('dim', '↓ ') : '';
-        lines.push(framedRow(theme, renderSettingRow(item, selectedRow, theme, Math.max(1, width - 4), above || below, state.moving !== undefined && item.id === `statusItem:${state.moving}`), width));
+        const below = start + visibleCount < rows.length && row === viewportHeight - 1 ? theme.fg('dim', '↓ ') : '';
+        lines.push(framedRow(theme, renderSettingRow(entry.section === undefined ? item : { ...item, label: `${item.label} · ${entry.section}` }, selectedRow, theme, Math.max(1, width - 4), above || below, false), width));
     }
     lines.push(divider(theme, width));
-    const description = selected?.description ?? '';
-    const descriptionLines = wrapText(description, Math.max(1, width - 8)).slice(0, descriptionRows);
+    const description = selected === undefined ? '' : selected.description;
+    const descriptionLines = wrapTextStable(description, Math.max(1, width - 8)).slice(0, descriptionRows);
     for (let row = 0; row < descriptionRows; row += 1) {
         const text = descriptionLines[row] ?? '';
         lines.push(framedRow(theme, text === '' ? '' : '  ' + theme.fg('muted', text), width));
     }
-    const hints = theme.fg('dim', active === 'plugins' ? '↑↓ navigate · enter edit · tab section · esc close' : settingsHints(state.moving !== undefined));
+    const fullHint = matches !== undefined ? 'Type filter · ↑↓ select · ←→ change · Enter edit · Tab sections · Esc clear/back'
+        : selected?.action !== undefined ? 'Enter open · Tab sections · / search · Esc back'
+            : selected?.id.startsWith('plugin:') === true ? `Enter configure${selected.values.length > 0 ? ' · ←→ change' : ''} · Tab sections · / search${selected.resettable ? ' · Ctrl+R reset' : ''} · Esc back`
+                : selected?.id.startsWith('statusItem:') === true
+                    ? 'Space show/hide · / search · Esc back'
+                    : selected?.resettable === false ? '←→ change · Tab sections · / search · Esc back' : settingsHints();
+    const hints = theme.fg('dim', width < 60
+        ? matches !== undefined ? 'Type filter · ↑↓ · Esc clear/back' : 'Tab sections · / search · Esc back'
+        : fullHint);
     lines.push(framedRow(theme, hints, width), bottomBorder(theme, width));
     return {
         lines,
@@ -737,18 +682,25 @@ export function renderSettings(state, theme, width, height = 24) {
     };
 }
 function renderSettingRow(item, selected, theme, width, edge = '', moving = false) {
-    const cursor = selected ? theme.fg('accent', (moving ? '↕' : SYMBOL.cursor) + ' ') : '  ';
-    const label = selected
-        ? theme.bold(theme.fg('accent', item.label))
-        : item.hidden === true ? theme.fg('dim', item.label) : item.label;
-    const sample = item.sample === undefined
-        ? ''
-        : '  ' + theme.fg(item.hidden === true ? 'dim' : 'muted', item.sample);
+    // A colour value keeps its swatch tone only when the row is not selected;
+    // selection has to win, or the reader cannot tell which row the cursor is on.
     const rawValue = moving ? 'moving' : item.value;
-    const value = selected || item.swatch === undefined
-        ? theme.fg(selected ? 'accent' : 'muted', rawValue)
-        : theme.fg(item.swatch, rawValue);
-    const fill = Math.max(1, width - visibleWidth(cursor) - visibleWidth(label) - visibleWidth(sample) - visibleWidth(value) - visibleWidth(edge));
-    return truncateToWidth(cursor + label + sample + ' '.repeat(fill) + value + edge, width);
+    const value = selected || item.swatch === undefined ? rawValue : theme.fg(item.swatch, rawValue);
+    const row = {
+        label: item.label,
+        ...(item.sample === undefined ? {} : { description: item.sample }),
+        secondary: item.hidden === true,
+        value,
+    };
+    const rendered = renderListRowWithValue(row, theme, width, visibleWidth(item.label), {
+        selected,
+        ...(moving ? { moving } : {}),
+    });
+    // An edge mark replaces the cursor cell, which the shared row already
+    // reserved, so the row cannot shift when the reader reaches either end.
+    if (edge === '')
+        return rendered;
+    const mark = theme.fg('dim', edge.trimStart() + ' ');
+    return truncateToWidth(mark + rendered.slice(LIST_CURSOR_CELLS), width);
 }
 //# sourceMappingURL=settings-list.js.map