@askdkc/dsh-cli 0.11.3

package/lib/types/components/ExtensionDialog.js

@@ -0,0 +1,253 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The managed plugin dialog (`ctx.tuiDialogs`) — one panel rendering the
+ * store's current snapshot in the chat chrome (the slot approval/question
+ * panels occupy). Three kinds share one component:
+ *
+ * - `select`  — focus list (↑/↓, windowed), Enter settles the option id
+ * - `confirm` — two rows (confirm/cancel), Enter settles the boolean
+ * - `input`   — single-line text edit, Enter settles the text
+ *
+ * Esc (and Ctrl+C) always cancels — the plugin's promise resolves with the
+ * cancelled value. The panel owns the keyboard through its own useInput,
+ * the same contract as ApprovalPanel/AskUserQuestionPanel: Chat's global
+ * handler early-returns while a snapshot is pending.
+ *
+ * Two input-pipeline rules shape every handler below:
+ *
+ * - BATCHED KEYS: a terminal delivers one stdin chunk as several key events
+ *   inside a single React batch (Down+Enter arrives together), so state
+ *   queued by the first event is NOT visible to the second. Every piece of
+ *   editing state the handlers act on (focus, value, cursor) therefore
+ *   lives in a ref mutated SYNCHRONOUSLY per event; the useState mirror
+ *   only exists to re-render.
+ * - CODE POINTS: cursor movement and deletion step over whole code points
+ *   (`[...s]` iteration, same contract as the transcript search box), so an
+ *   emoji can never be split into a lone surrogate.
+ *
+ * All text arrives pre-sanitized from TuiDialogRuntime (control chars
+ * stripped, cell-width capped); the panel still renders everything through
+ * ListItem's single-line truncation.
+ */
+import React from 'react';
+import { t } from '../i18n.js';
+import { Box, Text, useInput, useTerminalSize } from '../ui.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { isPlainReturnInput } from '../utils/modifiers.js';
+import { actionMatches } from '../utils/keymap.js';
+import { readClipboard } from '../utils/clipboard.js';
+import { Pane } from './design-system/Pane.js';
+import { ListItem } from './design-system/ListItem.js';
+import { HintLine } from './design-system/HintLine.js';
+import { listWindow } from './listWindow.js';
+import { INPUT_CELLS } from '../dsh-adapter/dialogs.js';
+import { capCells, flattenPasteInline } from '../dsh-adapter/sanitize.js';
+export function ExtensionDialog({ dialog, onDecide, onCancel }) {
+    switch (dialog.kind) {
+        case 'select':
+            return _jsx(SelectDialog, { dialog: dialog, onDecide: onDecide, onCancel: onCancel });
+        case 'confirm':
+            return _jsx(ConfirmDialog, { dialog: dialog, onDecide: onDecide, onCancel: onCancel });
+        case 'input':
+            return _jsx(InputDialog, { dialog: dialog, onDecide: onDecide, onCancel: onCancel });
+    }
+}
+function SelectDialog({ dialog, onDecide, onCancel, }) {
+    const [focusIndex, setFocusIndex] = React.useState(0);
+    // Synchronous source of truth for the handlers (see the module header):
+    // Down+Enter in one stdin chunk must move AND read the new focus.
+    const focusRef = React.useRef(0);
+    const moveFocus = (delta) => {
+        const next = (focusRef.current + delta + dialog.options.length) % dialog.options.length;
+        focusRef.current = next;
+        setFocusIndex(next);
+    };
+    const { rows: terminalRows } = useTerminalSize();
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            onCancel();
+            return;
+        }
+        if (key.upArrow) {
+            moveFocus(-1);
+            return;
+        }
+        if (key.downArrow) {
+            moveFocus(1);
+            return;
+        }
+        // A bracketed paste that is all line breaks is pasted content, never an
+        // Enter press — the key carries isPasted, and isPlainReturnInput
+        // refuses pastes before the plain-return test.
+        if (isPlainReturnInput(input, key)) {
+            const option = dialog.options[focusRef.current];
+            if (option !== undefined)
+                onDecide(option.id);
+        }
+    }, { isActive: true });
+    // Row budget mirrors the rewind picker: a described option costs 2 rows,
+    // a bare one 1; frame rows: Pane 2 + title 2 + footer 1 + slack.
+    const { start, end } = listWindow(dialog.options.map(option => (option.description === undefined ? 1 : 2)), focusIndex, Math.max(terminalRows - 10, 2));
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: dialog.title }) }), dialog.options.slice(start, end).map((option, index) => {
+                        const absoluteIndex = start + index;
+                        return (_jsx(ListItem, { isFocused: absoluteIndex === focusIndex, description: option.description, showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < dialog.options.length, 
+                            // Click = decide this option (same as Enter on it).
+                            onClick: () => onDecide(option.id), children: option.label }, option.id));
+                    })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-select-exit') }) })] }));
+}
+function ConfirmDialog({ dialog, onDecide, onCancel, }) {
+    const [focusIndex, setFocusIndex] = React.useState(0);
+    // Synchronous source of truth for the handlers (see the module header):
+    // Right+Enter in one stdin chunk must settle the NEW row, not the old.
+    const focusRef = React.useRef(0);
+    const labels = [
+        dialog.confirmLabel || t('ext-dialog-yes'),
+        dialog.cancelLabel || t('ext-dialog-no'),
+    ];
+    const moveFocus = (delta) => {
+        const next = (focusRef.current + delta + labels.length) % labels.length;
+        focusRef.current = next;
+        setFocusIndex(next);
+    };
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            onCancel();
+            return;
+        }
+        if (key.upArrow || key.leftArrow) {
+            moveFocus(-1);
+            return;
+        }
+        if (key.downArrow || key.rightArrow) {
+            moveFocus(1);
+            return;
+        }
+        // A bracketed paste that is all line breaks is pasted content, never an
+        // Enter press — the key carries isPasted, and isPlainReturnInput
+        // refuses pastes before the plain-return test.
+        if (isPlainReturnInput(input, key)) {
+            onDecide(focusRef.current === 0);
+        }
+    }, { isActive: true });
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "remember", bold: true, children: dialog.title }), dialog.message !== undefined && _jsx(Text, { dimColor: true, children: dialog.message })] }), labels.map((label, index) => (_jsx(ListItem, { isFocused: index === focusIndex, 
+                        // Click = decide this row (same as Enter on it).
+                        onClick: () => onDecide(index === 0), children: label }, label)))] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-select-exit') }) })] }));
+}
+function InputDialog({ dialog, onDecide, onCancel, }) {
+    const [value, setValue] = React.useState(dialog.initial);
+    const [cursor, setCursor] = React.useState(() => [...dialog.initial].length);
+    // Synchronous source of truth for the handlers (see the module header):
+    // two Backspaces in one stdin chunk must BOTH delete, each seeing the
+    // other's result. The cursor counts CODE POINTS, not UTF-16 units — an
+    // emoji is one step and can never be split into a lone surrogate.
+    const valueRef = React.useRef(dialog.initial);
+    const cursorRef = React.useRef([...dialog.initial].length);
+    const applyEdit = (nextValue, nextCursor) => {
+        valueRef.current = nextValue;
+        cursorRef.current = nextCursor;
+        setValue(nextValue);
+        setCursor(nextCursor);
+    };
+    /** True while the component is mounted (async clipboard continuation
+     *  guard: the dialog can close before the read resolves). */
+    const mountedRef = React.useRef(true);
+    React.useEffect(() => () => { mountedRef.current = false; }, []);
+    /** True while a clipboard read is in flight (ignore repeat Ctrl+V). */
+    const pasteBusyRef = React.useRef(false);
+    /** Insert one chunk under the single-line + cell-cap contract: content
+     *  that fits lands at the caret; oversized PASTE content is truncated
+     *  (mayCap) while oversized typing stays ignored — the value never
+     *  exceeds INPUT_CELLS cells either way. */
+    const insertChunk = (chunk, mayCap) => {
+        const points = [...valueRef.current];
+        const at = cursorRef.current;
+        const chunkPoints = [...chunk].length;
+        const candidate = points.slice(0, at).join('') + chunk + points.slice(at).join('');
+        if (stringWidth(candidate) <= INPUT_CELLS) {
+            applyEdit(candidate, at + chunkPoints);
+        }
+        else if (mayCap) {
+            const capped = capCells(candidate, INPUT_CELLS);
+            applyEdit(capped, Math.min(at + chunkPoints, [...capped].length));
+        }
+    };
+    useInput((input, key, event) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            onCancel();
+            return;
+        }
+        // A bracketed paste that is all line breaks is inserted as text, never
+        // submitted — the key carries isPasted, and isPlainReturnInput refuses
+        // pastes before the plain-return test.
+        if (isPlainReturnInput(input, key)) {
+            onDecide(valueRef.current);
+            return;
+        }
+        const points = [...valueRef.current];
+        const at = cursorRef.current;
+        // Single-line editing, same key set as the transcript search bar.
+        if (key.backspace) {
+            if (at > 0) {
+                points.splice(at - 1, 1);
+                applyEdit(points.join(''), at - 1);
+            }
+            return;
+        }
+        if (key.delete) {
+            if (at < points.length) {
+                points.splice(at, 1);
+                applyEdit(points.join(''), at);
+            }
+            return;
+        }
+        if (key.leftArrow) {
+            if (at > 0)
+                applyEdit(valueRef.current, at - 1);
+            return;
+        }
+        if (key.rightArrow) {
+            if (at < points.length)
+                applyEdit(valueRef.current, at + 1);
+            return;
+        }
+        if (key.home) {
+            applyEdit(valueRef.current, 0);
+            return;
+        }
+        if (key.end) {
+            applyEdit(valueRef.current, points.length);
+            return;
+        }
+        // Clipboard paste (default Ctrl+V / Alt+V — the keymap `paste`
+        // binding): raw mode hands the key to the app, so the clipboard is
+        // read here. Only text offers insert — files/images have no text form
+        // in a single-line value, and read failures are silently ignored (the
+        // dialog has no notice channel; repeat keys while a read is in flight
+        // are dropped by the busy guard).
+        if (actionMatches('paste', input, key)) {
+            if (!pasteBusyRef.current) {
+                pasteBusyRef.current = true;
+                void readClipboard()
+                    .then(content => {
+                    if (!mountedRef.current)
+                        return;
+                    if (content?.kind === 'text' && content.text !== '') {
+                        insertChunk(flattenPasteInline(content.text), true);
+                    }
+                })
+                    .finally(() => { pasteBusyRef.current = false; });
+            }
+            return;
+        }
+        if (input && !key.ctrl && !key.meta && !key.super && !key.tab && !key.escape) {
+            // A bracketed paste arrives as one chunk and may carry newlines/control
+            // chars (even complete ANSI sequences) — this is a single-line panel,
+            // so strip ANSI and flatten controls to spaces (typed text is already
+            // control-free; mayCap only applies to paste).
+            insertChunk(event.isPasted ? flattenPasteInline(input) : input, event.isPasted === true);
+        }
+    }, { isActive: true });
+    const shown = value === '' && dialog.placeholder !== undefined ? dialog.placeholder : value;
+    const shownPoints = [...shown];
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: dialog.title }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: value === '', children: shownPoints.slice(0, cursor).join('') }), _jsx(Text, { inverse: true, children: shownPoints[cursor] ?? ' ' }), _jsx(Text, { children: shownPoints.slice(cursor + 1).join('') })] })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-ext-dialog-input') }) })] }));
+}

package/lib/types/components/FileActionsPanel.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+/**
+ * Click-to-act file menu (fullscreen): opened by clicking a file path in
+ * the transcript (tool cards, markdown code spans / plain text, file://
+ * links). Rows: open the target, reveal it in the file manager, copy its
+ * absolute path. The path shown is already resolved to an absolute path by
+ * the caller (Chat.tsx resolves against the channel cwd at click time).
+ * When the target is a directory, the first row reads "open folder" — the
+ * same action (default handler), just honest about what it opens.
+ */
+export declare const FILE_ACTION_COUNT = 3;
+export declare function FileActionsPanel({ path, isDir, focusIndex, onPick, }: {
+    /** Absolute path the actions operate on (caller-resolved). */
+    path: string;
+    /** Whether the target exists on disk and is a directory. */
+    isDir: boolean;
+    /** Index of the keyboard-focused row. */
+    focusIndex: number;
+    /** Mouse pick (fullscreen): clicked row's absolute index. */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=FileActionsPanel.d.ts.map

package/lib/types/components/FileActionsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileActionsPanel.d.ts","sourceRoot":"","sources":["../../../src/components/FileActionsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAKlC,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,MAAM,GACP,EAAE;IACD,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAiClB"}

package/lib/types/components/FileActionsPanel.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { Select } from './Select.js';
+import { HintLine } from './design-system/HintLine.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+/**
+ * Click-to-act file menu (fullscreen): opened by clicking a file path in
+ * the transcript (tool cards, markdown code spans / plain text, file://
+ * links). Rows: open the target, reveal it in the file manager, copy its
+ * absolute path. The path shown is already resolved to an absolute path by
+ * the caller (Chat.tsx resolves against the channel cwd at click time).
+ * When the target is a directory, the first row reads "open folder" — the
+ * same action (default handler), just honest about what it opens.
+ */
+export const FILE_ACTION_COUNT = 3;
+/** How many terminal cells of the path fit next to the title. */
+const PATH_DISPLAY_BUDGET = 48;
+export function FileActionsPanel({ path, isDir, focusIndex, onPick, }) {
+    const options = React.useMemo(() => [
+        { value: 'open', label: t(isDir ? 'file-actions-open-dir' : 'file-actions-open') },
+        { value: 'reveal', label: t('file-actions-reveal') },
+        { value: 'copy', label: t('file-actions-copy') },
+    ], [isDir]);
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", marginBottom: 1, children: [_jsx(Text, { color: "remember", bold: true, children: t('file-actions-title') }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [' ', truncateToWidth(path, PATH_DISPLAY_BUDGET)] })] }), _jsx(Select, { options: options, focusIndex: focusIndex, selectedValue: undefined, visibleOptionCount: FILE_ACTION_COUNT, onPick: onPick ? index => onPick(index) : undefined }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) })] }) }));
+}

package/lib/types/components/FileSuggestions.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { Color } from '../ink/styles.js';
+import type { Theme } from '../theme.js';
+import type { FileCandidate } from '../utils/fileSuggestions.js';
+export declare function FileSuggestions({ files, selectedIndex, columns, query, accent, onPick, onWheelStep, }: {
+    files: readonly FileCandidate[];
+    selectedIndex: number;
+    columns: number;
+    /** `@` 触发 token 里已输入的查询（`mention.query`），用于名字前缀高亮。 */
+    query?: string;
+    accent?: keyof Theme | Color;
+    /** 鼠标点击行（fullscreen）：上报过滤后列表的绝对索引（与键盘
+     *  selectedIndex 同一索引空间），接受路径由 PromptInput 复用。 */
+    onPick?: (index: number) => void;
+    /** 滚轮步进（fullscreen）：±1 移动选中行。 */
+    onWheelStep?: (step: 1 | -1) => void;
+}): React.ReactNode;
+//# sourceMappingURL=FileSuggestions.d.ts.map

package/lib/types/components/FileSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/FileSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAsFhE,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,OAAO,EACP,KAAU,EACV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC5B;sDACkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CAmDlB"}

package/lib/types/components/FileSuggestions.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+import { t } from '../i18n.js';
+import { POINTER } from '../terminal-utils/figures.js';
+import { SuggestionCard, cardContentWidth, splitQueryMatch } from './SuggestionCard.js';
+import { useTooltip } from './Tooltip.js';
+/**
+ * The `@` file-completion overlay, wrapped in the
+ * shared rounded `SuggestionCard` (与 `/` 命令菜单同一视觉语言):
+ *
+ *   ╭─ 文件 · 共 12 项 ──────────────────────╮
+ *   │ ❯ ▸ src/components/     directory     │
+ *   │   + README.md           file          │
+ *   ╰─────────────────────────────────────────╯
+ *
+ * Full relative path (directory suffix stripped) + a `file`/`directory`
+ * description; the selected row renders `❯` + bold in the theme's
+ * `suggestion` color, others dim with the query-matched prefix of the name
+ * highlighted (non-dim). The name column is padded to a fixed display width
+ * so the description column keeps its contract at narrow terminals (pinned
+ * by verify-cjk-truncate.tsx); every pad/truncate uses display width, so CJK
+ * names never split a glyph.
+ */
+const NAME_COLUMN = 20;
+/** Display name: directories show without the trailing slash. */
+function nameOf(file) {
+    return file.kind === 'directory' && file.path.endsWith('/') ? file.path.slice(0, -1) : file.path;
+}
+/**
+ * One candidate row: fixed-width name column + kind description. When the
+ * name runs past the row's text budget (`wrap="truncate"` cuts the tail),
+ * hovering pops the full path plus its kind — the 20-cell name column and
+ * the trailing description can both hide on a narrow terminal, and the
+ * path is exactly the piece that decides which candidate to pick.
+ */
+function FileSuggestionRow({ file, isSelected, query, usable, descriptionWidth }) {
+    const name = nameOf(file);
+    const icon = file.kind === 'directory' ? '▸ ' : '+ ';
+    const description = file.kind === 'directory' ? 'directory' : 'file';
+    const renderedDescription = stringWidth(description) > descriptionWidth
+        ? truncateToWidth(description, Math.max(0, descriptionWidth - 1)) + '…'
+        : description;
+    // Row prefix = leading space + pointer/gutter + icon = 5 cells. The name
+    // is hidden exactly when it runs past the remaining budget; otherwise the
+    // full path is already on screen and a float would just repeat it.
+    const tooltip = useTooltip(() => 5 + stringWidth(name) > usable
+        ? `${file.path}\n${description}`
+        : '');
+    const padded = name + ' '.repeat(Math.max(1, NAME_COLUMN - stringWidth(name)));
+    const parts = splitQueryMatch(name, query);
+    const pad = ' '.repeat(Math.max(1, NAME_COLUMN - stringWidth(name)));
+    return (_jsx(Box, { ...tooltip, children: _jsxs(Text, { wrap: "truncate", children: [' ', isSelected ? (_jsx(Text, { color: "suggestion", bold: true, children: `${POINTER} ${icon}${padded}` })) : parts ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: `  ${icon}${parts.before}` }), _jsx(Text, { children: parts.match }), _jsx(Text, { dimColor: true, children: `${parts.after}${pad}` })] })) : (_jsx(Text, { dimColor: true, children: `  ${icon}${padded}` })), _jsx(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: renderedDescription })] }) }));
+}
+export function FileSuggestions({ files, selectedIndex, columns, query = '', accent, onPick, onWheelStep, }) {
+    if (files.length === 0)
+        return null;
+    const usable = cardContentWidth(columns);
+    const maxVisible = 6;
+    const safeIndex = Math.min(Math.max(0, selectedIndex), files.length - 1);
+    const startIndex = Math.max(0, Math.min(safeIndex - Math.floor(maxVisible / 2), Math.max(0, files.length - maxVisible)));
+    const visible = files.slice(startIndex, startIndex + maxVisible);
+    const above = startIndex;
+    const below = files.length - (startIndex + visible.length);
+    // 行预算：内容宽 − 前导空格 1 − 指针列 2 − 图标列 2。
+    const descriptionWidth = Math.max(0, usable - 25);
+    const title = `${t('sugg-files-title')} · ${t('sugg-count', { n: files.length })}`;
+    const footer = above > 0 || below > 0
+        ? [
+            above > 0 ? t('sugg-more-above', { n: above }) : null,
+            below > 0 ? t('sugg-more-below', { n: below }) : null,
+        ]
+            .filter((part) => part !== null)
+            .join(' · ')
+        : null;
+    return (_jsx(SuggestionCard, { title: title, columns: columns, accent: accent, footer: footer, onRowPick: onPick ? index => onPick(startIndex + index) : undefined, onWheelStep: onWheelStep, rows: visible.map(file => (_jsx(FileSuggestionRow, { file: file, isSelected: file.id === files[safeIndex]?.id, query: query, usable: usable, descriptionWidth: descriptionWidth }, file.id))) }));
+}

package/lib/types/components/GoalTodoPanel.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { ChannelUi as Channel } from '../adapter/channel/ui-policy.js';
+import type { ChannelGoal } from '../dsh-adapter/channel.js';
+/**
+ * Compact goal chip for the status footer: phase glyph + rounds, colored by
+ * phase. `minimal` swaps the glyph for a text form, per the minimal-mode
+ * no-emoji contract.
+ */
+export declare function GoalStatusChip({ goal, minimal }: {
+    goal: ChannelGoal;
+    minimal?: boolean;
+}): React.ReactNode;
+/**
+ * Live goal + todo panel above the prompt input. Data rides on the channel:
+ * `channel.goal` is folded from `goal/change` context events and
+ * `channel.todos` from `todo/write` whole-list snapshots, so every model
+ * update re-renders this panel in real time (no polling). Renders nothing
+ * while both slots are empty.
+ *
+ * The todo section folds two ways: completed rows fold automatically once
+ * the agent goes idle (the header's `✓ done/total` count keeps the
+ * summary), and `collapsed` folds the whole section to that single header
+ * line any time — including mid-turn, where the line still previews the
+ * in-progress task. `onToggle` is the click affordance for the header row;
+ * the ctrl/cmd+q hotkey in Chat drives the same state.
+ *
+ * Goal elapsed time is the panel's own wall clock (started when the goal
+ * id first appears, frozen on completion) — deliberately not derived from
+ * session-event timestamps.
+ */
+export declare function GoalTodoPanel({ channel, collapsed, onToggle, }: {
+    channel: Channel;
+    /** Fold the whole todo section to its summary header line. */
+    collapsed?: boolean;
+    /** Toggle the fold (click on the header row; shares the hotkey state). */
+    onToggle?: () => void;
+}): React.ReactNode;
+//# sourceMappingURL=GoalTodoPanel.d.ts.map

package/lib/types/components/GoalTodoPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalTodoPanel.d.ts","sourceRoot":"","sources":["../../../src/components/GoalTodoPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,2BAA2B,CAAA;AAmC3E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,OAAe,EAAE,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAQnH;AA2CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,SAAiB,EACjB,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,GAAG,KAAK,CAAC,SAAS,CAwIlB"}

package/lib/types/components/GoalTodoPanel.js

@@ -0,0 +1,131 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text } from '../ui.js';
+import { t } from '../i18n.js';
+import { modLabel } from '../utils/modifiers.js';
+/** Maximum todo rows shown before the overflow line. */
+const MAX_TODOS = 8;
+const PHASE_LABEL = {
+    active: '● active',
+    paused: '⏸ paused',
+    blocked: '⛔ blocked',
+    complete: '✓ complete',
+};
+/** Compact phase marker for the status-footer chip. */
+const PHASE_GLYPH = {
+    active: '●',
+    paused: '⏸',
+    blocked: '⛔',
+    complete: '✓',
+};
+function phaseColor(phase) {
+    if (phase === 'active')
+        return 'success';
+    if (phase === 'paused')
+        return 'warning';
+    if (phase === 'blocked')
+        return 'error';
+    return undefined;
+}
+/** `47s` under a minute, `3m12s` after — same shape as the subagent cards. */
+function formatDuration(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+}
+/**
+ * Compact goal chip for the status footer: phase glyph + rounds, colored by
+ * phase. `minimal` swaps the glyph for a text form, per the minimal-mode
+ * no-emoji contract.
+ */
+export function GoalStatusChip({ goal, minimal = false }) {
+    return (_jsx(Text, { color: phaseColor(goal.phase), dimColor: goal.phase === 'complete', children: minimal
+            ? `goal ${goal.roundsStarted}/${goal.maxGoalRounds}`
+            : `${PHASE_GLYPH[goal.phase]} ${goal.roundsStarted}/${goal.maxGoalRounds}` }));
+}
+function PhaseBadge({ phase, roundsStarted, maxGoalRounds, elapsed, }) {
+    const color = phaseColor(phase);
+    return (_jsxs(Text, { color: color, dimColor: phase === 'complete', children: [PHASE_LABEL[phase], " \u00B7 ", roundsStarted, "/", maxGoalRounds, elapsed !== undefined ? ` · ${elapsed}` : ''] }));
+}
+function TodoGlyph({ status }) {
+    switch (status) {
+        case 'in_progress':
+            return _jsx(Text, { color: "suggestion", children: "\u25CF " });
+        case 'completed':
+            return _jsx(Text, { dimColor: true, children: "\u2713 " });
+        default:
+            return _jsx(Text, { dimColor: true, children: "\u25CB " });
+    }
+}
+/**
+ * Mind-map style branch prefix: `├─` for every row but the last, which
+ * closes with `└─`. The whole panel reads as one tree — the goal is the
+ * root and each todo hangs off it.
+ */
+function BranchPrefix({ last }) {
+    return _jsx(Text, { dimColor: true, children: last ? '└─ ' : '├─ ' });
+}
+/**
+ * Live goal + todo panel above the prompt input. Data rides on the channel:
+ * `channel.goal` is folded from `goal/change` context events and
+ * `channel.todos` from `todo/write` whole-list snapshots, so every model
+ * update re-renders this panel in real time (no polling). Renders nothing
+ * while both slots are empty.
+ *
+ * The todo section folds two ways: completed rows fold automatically once
+ * the agent goes idle (the header's `✓ done/total` count keeps the
+ * summary), and `collapsed` folds the whole section to that single header
+ * line any time — including mid-turn, where the line still previews the
+ * in-progress task. `onToggle` is the click affordance for the header row;
+ * the ctrl/cmd+q hotkey in Chat drives the same state.
+ *
+ * Goal elapsed time is the panel's own wall clock (started when the goal
+ * id first appears, frozen on completion) — deliberately not derived from
+ * session-event timestamps.
+ */
+export function GoalTodoPanel({ channel, collapsed = false, onToggle, }) {
+    const goal = channel.goal;
+    const allTodos = channel.todos ?? [];
+    const doneCount = allTodos.filter(todo => todo.status === 'completed').length;
+    // Completed rows are useful progress while a turn is running, but become
+    // stale footer noise once the agent is idle. Keep unfinished work visible;
+    // the header count carries the done summary either way.
+    const todos = channel.working
+        ? allTodos
+        : allTodos.filter(todo => todo.status !== 'completed');
+    // Local goal timer: remember when this goal id first rendered. Written in
+    // render (idempotent lazy ref init) so a fresh mount with a live goal
+    // starts counting immediately.
+    const startRef = React.useRef(undefined);
+    if (goal !== undefined && startRef.current?.id !== goal.id) {
+        startRef.current = { id: goal.id, at: Date.now() };
+    }
+    const [now, setNow] = React.useState(() => Date.now());
+    // Hover tint for the clickable todo fold header (mouse affordance).
+    const [headerHovered, setHeaderHovered] = React.useState(false);
+    React.useEffect(() => {
+        // Tick only while the goal is open; a complete goal freezes the last
+        // elapsed reading instead of counting past the finish line.
+        if (goal === undefined || goal.phase === 'complete')
+            return;
+        const timer = setInterval(() => setNow(Date.now()), 1000);
+        return () => clearInterval(timer);
+    }, [goal]);
+    const elapsed = goal !== undefined && startRef.current !== undefined
+        ? formatDuration(now - startRef.current.at)
+        : undefined;
+    // All-completed idle snapshot with no goal: nothing left to narrate —
+    // the whole panel folds away (historical behavior).
+    const anyUnfinished = allTodos.some(todo => todo.status !== 'completed');
+    const showTodoSection = allTodos.length > 0 && (channel.working || anyUnfinished || goal !== undefined);
+    if (goal === undefined && !showTodoSection)
+        return null;
+    const visible = todos.slice(0, MAX_TODOS);
+    const hidden = todos.length - visible.length;
+    // Collapsed preview: the live task when one runs, else the next open row.
+    const preview = allTodos.find(todo => todo.status === 'in_progress')
+        ?? allTodos.find(todo => todo.status !== 'completed');
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingRight: 2, paddingTop: 1, children: [goal !== undefined && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, children: [_jsx(Text, { color: "suggestion", children: "\uD83C\uDFAF " }), _jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { bold: true, wrap: "truncate", children: goal.objective }) }), _jsx(Box, { flexShrink: 0, marginLeft: 1, children: _jsx(PhaseBadge, { phase: goal.phase, roundsStarted: goal.roundsStarted, maxGoalRounds: goal.maxGoalRounds, elapsed: elapsed }) })] }), goal.phase === 'blocked' && goal.blockedReason !== undefined && (_jsxs(Box, { flexDirection: "row", marginTop: 1, height: 1, children: [_jsx(Text, { dimColor: true, children: "\u2502 " }), _jsx(Text, { color: "error", wrap: "truncate", children: goal.blockedReason.message })] }))] })), showTodoSection && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", height: 1, onClick: onToggle, onMouseEnter: () => setHeaderHovered(true), onMouseLeave: () => setHeaderHovered(false), backgroundColor: headerHovered ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Text, { dimColor: true, children: [collapsed ? '▸' : '▾', " "] }), _jsxs(Text, { dimColor: true, children: ["\u2713 ", doneCount, "/", allTodos.length] }), collapsed && preview !== undefined && (_jsx(Box, { flexGrow: 1, flexShrink: 1, marginLeft: 1, children: preview.status === 'in_progress' ? (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: "suggestion", children: "\u25CF " }), preview.content] })) : (_jsxs(Text, { wrap: "truncate", dimColor: true, children: ["\u25CB ", preview.content] })) }))] }), !collapsed && (_jsxs(Box, { flexDirection: "column", children: [visible.map((todo, index) => {
+                                const last = index === visible.length - 1 && hidden === 0;
+                                return (_jsxs(Box, { flexDirection: "row", height: 1, children: [_jsx(BranchPrefix, { last: last }), _jsx(TodoGlyph, { status: todo.status }), _jsx(Text, { wrap: "truncate", dimColor: todo.status === 'completed', children: todo.content })] }, index));
+                            }), hidden > 0 && (_jsxs(Box, { flexDirection: "row", height: 1, children: [_jsx(BranchPrefix, { last: true }), _jsxs(Text, { dimColor: true, children: ["\u2026 ", hidden, " more"] })] })), _jsxs(Text, { dimColor: true, children: ["  ", t('goal-todo-fold-hint', { mod: modLabel })] })] }))] }))] }));
+}

package/lib/types/components/HelpMenu.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { type ScrollBoxHandle } from '../ui.js';
+import type { LocalCommand } from '../commands.js';
+/**
+ * The `?` help menu with a three-column shortcut layout, trimmed to the keys
+ * dsh-tui actually binds.
+ * The command column lists the merged slash-command surface: built-in
+ * commands plus plugin-registered ones from the DSH registry (plan/goal/…).
+ * Skill entries (user-invocable skills merged for `/` completion, issue
+ * #86) are hidden — a skills directory can hold dozens of entries and the
+ * menu is for chrome commands. Modifier labels follow the platform
+ * convention: ⌘ on macOS, ctrl elsewhere.
+ */
+export declare function HelpMenu({ commands, viewportHeight, viewportWidth, scrollRef, onCommandPick, }: {
+    commands: readonly LocalCommand[];
+    /** Fixed viewport supplied by the prompt overlay; unset for standalone renders. */
+    viewportHeight?: number;
+    /** Terminal width used to collapse the three-column layout when necessary. */
+    viewportWidth?: number;
+    /** PromptInput owns keyboard routing and drives this scroll viewport. */
+    scrollRef?: React.Ref<ScrollBoxHandle>;
+    /**
+     * Mouse pick on a command row (fullscreen): fills `/<name> ` into the
+     * prompt — the Tab-completion's mouse equivalent. Absent for standalone
+     * renders (i18n verifier): rows render exactly as before.
+     */
+    onCommandPick?: (name: string) => void;
+}): React.ReactNode;
+//# sourceMappingURL=HelpMenu.d.ts.map

package/lib/types/components/HelpMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpMenu.d.ts","sourceRoot":"","sources":["../../../src/components/HelpMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAKlD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,GACd,EAAE;IACD,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IACtC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC,GAAG,KAAK,CAAC,SAAS,CAoHlB"}