@dsh-cc/tui 0.5.0

package/lib/components/arg-completers.js

@@ -0,0 +1,75 @@
+/**
+ * Driver-backed slash argument completers injected into the TUI autocomplete
+ * provider. `/model` completes from the live model catalog in both forms the
+ * arg path accepts (`provider/id`, plus a bare `id` when unique across the
+ * catalog — mirroring parseModelChoice); `/effort` completes live effort
+ * levels; `/permissions` completes the five CC rule-engine modes; `/resume`
+ * completes session short ids.
+ * Candidates are fetched per completion request, so catalog/session staleness
+ * is bounded by the driver calls themselves.
+ * @module @dsh-cc/tui/components/arg-completers
+ */
+import { PERMISSION_COMMAND_MODES } from '@dsh-cc/command-permissions';
+import { PROVIDER_SUBCOMMANDS } from "../slash.js";
+import { shortenSession } from "../statusline.js";
+/**
+ * Build the per-command argument completer map handed to
+ * {@link TuiAutocompleteProvider}. Only commands with meaningful arguments are
+ * registered; every other slash command stays at the provider's null fallback.
+ */
+export function buildArgCompleters(driver) {
+    return {
+        model: async () => {
+            const catalog = await driver.loadModelCatalog();
+            // A bare id is only offered when it resolves unambiguously —
+            // parseModelChoice rejects an id shared by multiple providers.
+            const idCounts = new Map();
+            for (const entry of catalog)
+                idCounts.set(entry.id, (idCounts.get(entry.id) ?? 0) + 1);
+            const items = [];
+            for (const entry of catalog) {
+                const key = `${entry.provider}/${entry.id}`;
+                items.push({
+                    value: key,
+                    label: key,
+                    ...entry.name.length === 0 ? {} : { description: entry.name },
+                });
+                if (idCounts.get(entry.id) === 1) {
+                    items.push({
+                        value: entry.id,
+                        label: entry.id,
+                        ...entry.name.length === 0 ? {} : { description: entry.name },
+                    });
+                }
+            }
+            return items;
+        },
+        effort: async () => {
+            // The driver folds in the trailing reserved `default` entry and returns
+            // [] when no model (or no resolvable levels) — no dead-end completions.
+            const efforts = await driver.loadModelEfforts();
+            return efforts.map(level => ({ value: level, label: level }));
+        },
+        permissions: async () => {
+            return PERMISSION_COMMAND_MODES.map(mode => ({ value: mode, label: mode }));
+        },
+        resume: async () => {
+            const sessions = await driver.listSessions();
+            // Newest first, mirroring the /resume switcher overlay ordering.
+            const sorted = sessions.slice().sort((a, b) => b.createdAt - a.createdAt);
+            return sorted.map(session => {
+                const short = shortenSession(session.id);
+                return {
+                    value: short,
+                    label: short,
+                    ...short === session.id ? {} : { description: session.id },
+                };
+            });
+        },
+        provider: async () => {
+            // Static subcommand table (§4.1); route ids come from the overlay itself.
+            return PROVIDER_SUBCOMMANDS.map(sub => ({ value: sub, label: sub }));
+        },
+    };
+}
+//# sourceMappingURL=arg-completers.js.map

package/lib/components/arg-completers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-completers.js","sourceRoot":"","sources":["../../src/components/arg-completers.ts"],"names":[],"mappings":"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"}

package/lib/components/code-theme.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Syntax highlighting for fenced code blocks. highlight.js (common-languages
+ * subset, pinned ^11) tokenizes source into an HTML string of
+ * `<span class="hljs-...">` elements; a tiny stack-based walker converts that
+ * HTML into ANSI-styled lines. Styles never bleed across rows: every SGR
+ * opener is closed at the line end and reopened on the next line. Unknown or
+ * unsupported languages fall back to the unstyled source split by newlines.
+ *
+ * We import `highlight.js/lib/common` (not the full 190-language bundle) — it
+ * ships ~36 common languages and resolves cleanly under the repo's ESM
+ * `moduleResolution: bundler` tsconfig (the package's `exports` map points the
+ * `./lib/common` subpath at the ESM build with sibling `.d.ts` files).
+ * @module @dsh-cc/tui/components/code-theme
+ */
+import { type Theme } from './theme.ts';
+/**
+ * Highlight `code` (written in `lang`) and return ANSI-styled lines.
+ *
+ * - Styles come from the injected `theme` (default: the built-in palette).
+ * - Unknown or unsupported `lang` → plain `code.split('\n')` (never throws).
+ * - Empty `code` → `['']`.
+ * - The returned array length always matches `code.split('\n').length`.
+ */
+export declare function highlightCodeAnsi(code: string, lang?: string, theme?: Theme): string[];
+//# sourceMappingURL=code-theme.d.ts.map

package/lib/components/code-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-theme.d.ts","sourceRoot":"","sources":["../../src/components/code-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAyGrD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,KAAoB,GAAG,MAAM,EAAE,CASpG"}

package/lib/components/code-theme.js

@@ -0,0 +1,137 @@
+/**
+ * Syntax highlighting for fenced code blocks. highlight.js (common-languages
+ * subset, pinned ^11) tokenizes source into an HTML string of
+ * `<span class="hljs-...">` elements; a tiny stack-based walker converts that
+ * HTML into ANSI-styled lines. Styles never bleed across rows: every SGR
+ * opener is closed at the line end and reopened on the next line. Unknown or
+ * unsupported languages fall back to the unstyled source split by newlines.
+ *
+ * We import `highlight.js/lib/common` (not the full 190-language bundle) — it
+ * ships ~36 common languages and resolves cleanly under the repo's ESM
+ * `moduleResolution: bundler` tsconfig (the package's `exports` map points the
+ * `./lib/common` subpath at the ESM build with sibling `.d.ts` files).
+ * @module @dsh-cc/tui/components/code-theme
+ */
+import hljs from 'highlight.js/lib/common';
+import { defaultTheme } from "./theme.js";
+/**
+ * Map of highlight.js scope (the class name with the `hljs-` prefix stripped)
+ * to an SGR style, derived from the injected theme. Kept intentionally small —
+ * this is a terminal, not an IDE. Unmapped scopes render unstyled.
+ */
+function styleByScope(theme) {
+    return {
+        keyword: theme.warning,
+        literal: theme.accent,
+        number: theme.accent,
+        // No dedicated string color → strings fall back to the accent.
+        string: theme.accent,
+        comment: theme.muted,
+        title: theme.bold,
+        function: theme.bold,
+        'function_': theme.bold,
+        'title.function_': theme.bold,
+        built_in: theme.accent,
+        attr: theme.italic,
+        attribute: theme.italic,
+        type: theme.accent,
+        class: theme.bold,
+        meta: theme.italic,
+        regexp: theme.accent,
+        variable: theme.italic,
+    };
+}
+/** Decode the HTML entities highlight.js emits back to raw source characters. */
+function decodeEntities(s) {
+    // `&amp;` MUST be decoded last so a literal `&amp;` in source (emitted as
+    // `&amp;amp;`) round-trips correctly; a single-pass global replace does not
+    // re-scan replaced text, so this is safe.
+    return s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#x27;/g, "'")
+        .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+        .replace(/&amp;/g, '&');
+}
+/** Resolve the innermost open span to an SGR style (undefined = unstyled). */
+function styleForStackTop(stack, styles) {
+    for (let i = stack.length - 1; i >= 0; i--) {
+        const attr = stack[i];
+        if (!attr)
+            continue;
+        for (const part of attr.split(/\s+/)) {
+            const scope = part.startsWith('hljs-') ? part.slice(5) : part;
+            const style = styles[scope];
+            if (style)
+                return style;
+        }
+    }
+    return undefined;
+}
+/**
+ * Convert highlight.js HTML (only `<span class="hljs-...">`, `</span>`, and
+ * entity-escaped text) into ANSI-styled lines. The returned array length
+ * always equals the number of source lines; ANSI codes never span lines.
+ */
+function htmlToAnsiLines(html, styles) {
+    const lines = [];
+    let current = '';
+    const stack = [];
+    // The only `<` characters in hljs output are tag starts; text `<` is `&lt;`.
+    const parts = html.split(/(<\/?span\b[^>]*>)/);
+    for (const part of parts) {
+        if (part === '')
+            continue;
+        if (part === '</span>') {
+            stack.pop();
+            continue;
+        }
+        if (part.startsWith('<span')) {
+            const m = /class="([^"]*)"/.exec(part);
+            stack.push(m ? m[1] : '');
+            continue;
+        }
+        // Text node: decode entities, then split on newlines so each line opens
+        // and closes its own SGR codes (no cross-line bleed).
+        const text = decodeEntities(part);
+        const segs = text.split('\n');
+        for (let i = 0; i < segs.length; i++) {
+            if (i > 0) {
+                lines.push(current);
+                current = '';
+            }
+            const seg = segs[i];
+            if (!seg)
+                continue;
+            const style = styleForStackTop(stack, styles);
+            current += style ? style(seg) : seg;
+        }
+    }
+    lines.push(current);
+    return lines;
+}
+/**
+ * Highlight `code` (written in `lang`) and return ANSI-styled lines.
+ *
+ * - Styles come from the injected `theme` (default: the built-in palette).
+ * - Unknown or unsupported `lang` → plain `code.split('\n')` (never throws).
+ * - Empty `code` → `['']`.
+ * - The returned array length always matches `code.split('\n').length`.
+ */
+export function highlightCodeAnsi(code, lang, theme = defaultTheme) {
+    if (code === '')
+        return [''];
+    if (!lang || !hljs.getLanguage(lang))
+        return code.split('\n');
+    try {
+        const result = hljs.highlight(code, { language: lang, ignoreIllegals: true });
+        return htmlToAnsiLines(result.value, styleByScope(theme));
+    }
+    catch {
+        return code.split('\n');
+    }
+}
+//# sourceMappingURL=code-theme.js.map

package/lib/components/code-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-theme.js","sourceRoot":"","sources":["../../src/components/code-theme.ts"],"names":[],"mappings":"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"}

package/lib/components/completion.d.ts

@@ -0,0 +1,50 @@
+/**
+ * TUI autocomplete provider: slash-command suggestions + `@`-file completion.
+ * Implements pi-tui's `AutocompleteProvider` interface so the vendored Editor
+ * can drive it via `setAutocompleteProvider`. Slash suggestions come from an
+ * injected command catalog (local + harness); `@`-paths come from OUR OWN
+ * workspace walk (recursive readdir, no `fd` dependency).
+ * @module @dsh-cc/tui/components/completion
+ */
+import type { AutocompleteItem, AutocompleteProvider, AutocompleteSuggestions } from '@dsh-cc/pi-tui';
+/** A command in the injected catalog. */
+export interface CommandItem {
+    readonly name: string;
+    readonly description?: string;
+    readonly argumentHint?: string;
+}
+/** A workspace walk returns relative POSIX paths (no leading ./). */
+export type WorkspaceWalk = (cwd: string, signal: AbortSignal) => string[];
+/**
+ * Per-command argument completer: given the current argument word (may be
+ * empty) and the request's AbortSignal, return candidate items. The provider
+ * prefix-filters the returned values against the argument word, so a completer
+ * may return the full candidate list and let the provider narrow it.
+ */
+export type ArgCompleter = (prefix: string, signal: AbortSignal) => AutocompleteItem[] | Promise<AutocompleteItem[]>;
+/** Argument completers keyed by slash-command name (lowercase). */
+export type ArgCompleterMap = Readonly<Record<string, ArgCompleter>>;
+/**
+ * Autocomplete provider for the TUI composer. Handles `/command` suggestions
+ * (prefix-filtered from an injected catalog) and `@file` completion (fuzzy
+ * prefix match against a workspace walk rooted at `cwd`).
+ */
+export declare class TuiAutocompleteProvider implements AutocompleteProvider {
+    readonly triggerCharacters: string[];
+    private readonly commands;
+    private readonly cwd;
+    private readonly walk;
+    private readonly argCompleters;
+    constructor(commands: readonly CommandItem[], cwd: string, walk?: WorkspaceWalk, argCompleters?: ArgCompleterMap);
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, options: {
+        signal: AbortSignal;
+        force?: boolean;
+    }): Promise<AutocompleteSuggestions | null>;
+    applyCompletion(lines: string[], cursorLine: number, cursorCol: number, item: AutocompleteItem, prefix: string): {
+        lines: string[];
+        cursorLine: number;
+        cursorCol: number;
+    };
+    shouldTriggerFileCompletion(lines: string[], cursorLine: number, cursorCol: number): boolean;
+}
+//# sourceMappingURL=completion.d.ts.map

package/lib/components/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/components/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,gBAAgB,CAAA;AAGvB,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,MAAM,EAAE,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,KAChB,gBAAgB,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;AAErD,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;AAuHpE;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,QAAQ,CAAC,iBAAiB,WAAa;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;gBAG7C,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,aAA2B,EACjC,aAAa,GAAE,eAAoB;IAQ/B,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAChD,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAmE1C,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA+D7D,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAS7F"}

package/lib/components/completion.js

@@ -0,0 +1,279 @@
+/**
+ * TUI autocomplete provider: slash-command suggestions + `@`-file completion.
+ * Implements pi-tui's `AutocompleteProvider` interface so the vendored Editor
+ * can drive it via `setAutocompleteProvider`. Slash suggestions come from an
+ * injected command catalog (local + harness); `@`-paths come from OUR OWN
+ * workspace walk (recursive readdir, no `fd` dependency).
+ * @module @dsh-cc/tui/components/completion
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { fuzzyFilter } from '@dsh-cc/pi-tui';
+const MAX_WALK_RESULTS = 200;
+const MAX_WALK_DEPTH = 8;
+/** Directory names pruned from the walk unconditionally. */
+const PRUNED_DIRS = new Set(['.git', 'node_modules']);
+/**
+ * Path delimiters that bound a token. Mirrors pi-tui's PATH_DELIMITERS so token
+ * extraction is consistent with the vendored provider's expectations.
+ */
+const TOKEN_DELIMITERS = new Set([' ', '\t', '"', "'", '=']);
+function isPathDelimiter(ch) {
+    return ch !== undefined && TOKEN_DELIMITERS.has(ch);
+}
+function toPosix(p) {
+    return p.split(sep).join('/');
+}
+/** Find the start of the token (after the last path/space delimiter). */
+function tokenStart(text) {
+    for (let i = text.length - 1; i >= 0; i -= 1) {
+        if (isPathDelimiter(text[i]))
+            return i + 1;
+    }
+    return 0;
+}
+/**
+ * Recursive readdir walk from `cwd`, returning relative POSIX paths.
+ * Directory entries carry a trailing '/'. Prunes `.git` and `node_modules`;
+ * caps depth at {@link MAX_WALK_DEPTH} and total results at
+ * {@link MAX_WALK_RESULTS}. Honors the AbortSignal between directories.
+ * Dotfiles are included only when the user has already typed a leading dot in
+ * the prefix (so `@.` surfaces them but `@src` does not).
+ */
+function defaultWalk(cwd, signal) {
+    const results = [];
+    const walk = (dir, depth) => {
+        if (signal.aborted)
+            return;
+        if (results.length >= MAX_WALK_RESULTS)
+            return;
+        if (depth > MAX_WALK_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (signal.aborted)
+                return;
+            if (results.length >= MAX_WALK_RESULTS)
+                return;
+            if (PRUNED_DIRS.has(entry.name))
+                continue;
+            const full = join(dir, entry.name);
+            const rel = toPosix(relative(cwd, full));
+            if (entry.isDirectory()) {
+                results.push(`${rel}/`);
+                walk(full, depth + 1);
+            }
+            else if (entry.isSymbolicLink()) {
+                // Resolve the symlink target to classify dir-vs-file; follow with a
+                // guard against broken links (treat as a file if unreadable).
+                try {
+                    if (statSync(full).isDirectory()) {
+                        results.push(`${rel}/`);
+                    }
+                    else {
+                        results.push(rel);
+                    }
+                }
+                catch {
+                    results.push(rel);
+                }
+            }
+            else {
+                results.push(rel);
+            }
+        }
+    };
+    walk(cwd, 0);
+    return results;
+}
+/**
+ * Filter a walk tree down to entries whose relative path starts with the given
+ * prefix (case-insensitive on the path, segment-aware). Directory entries are
+ * indicated by a trailing '/'. Returns AutocompleteItem values: directories
+ * keep the trailing '/' in both value and label; files get a trailing space
+ * via applyCompletion (not here). Directories sort before files.
+ */
+function buildPathItems(tree, rawPrefix, isAtPrefix) {
+    const prefixLower = rawPrefix.toLowerCase();
+    const matched = [];
+    for (const rel of tree) {
+        const posixRel = rel.replace(/\\/g, '/');
+        if (!posixRel.toLowerCase().startsWith(prefixLower))
+            continue;
+        const isDir = posixRel.endsWith('/');
+        const clean = isDir ? posixRel.slice(0, -1) : posixRel;
+        const name = clean.split('/').pop() ?? clean;
+        matched.push({ rel: posixRel, isDir, name });
+    }
+    matched.sort((a, b) => {
+        if (a.isDir && !b.isDir)
+            return -1;
+        if (!a.isDir && b.isDir)
+            return 1;
+        return a.rel.localeCompare(b.rel);
+    });
+    return matched.slice(0, MAX_WALK_RESULTS).map(({ rel, isDir, name }) => {
+        const pathValue = isDir ? rel : rel; // dir already has trailing '/'
+        return {
+            value: isAtPrefix ? `@${pathValue}` : pathValue,
+            label: isDir ? `${name}/` : name,
+            description: isDir ? rel.slice(0, -1) : rel,
+        };
+    });
+}
+/**
+ * Autocomplete provider for the TUI composer. Handles `/command` suggestions
+ * (prefix-filtered from an injected catalog) and `@file` completion (fuzzy
+ * prefix match against a workspace walk rooted at `cwd`).
+ */
+export class TuiAutocompleteProvider {
+    triggerCharacters = ['/', '@'];
+    commands;
+    cwd;
+    walk;
+    argCompleters;
+    constructor(commands, cwd, walk = defaultWalk, argCompleters = {}) {
+        this.commands = commands;
+        this.cwd = cwd;
+        this.walk = walk;
+        this.argCompleters = argCompleters;
+    }
+    async getSuggestions(lines, cursorLine, cursorCol, options) {
+        const currentLine = lines[cursorLine] ?? '';
+        const before = currentLine.slice(0, cursorCol);
+        // --- @-file completion -------------------------------------------------
+        const start = tokenStart(before);
+        const token = before.slice(start);
+        if (token.startsWith('@')) {
+            const rawPrefix = token.slice(1); // strip '@'
+            // The walk itself honors the signal; call it even when already aborted so
+            // the provider reports a clean null (and tests can observe the call).
+            const tree = this.walk(this.cwd, options.signal);
+            if (options.signal.aborted)
+                return null;
+            const items = buildPathItems(tree, rawPrefix, true);
+            if (items.length === 0)
+                return null;
+            return { items, prefix: token };
+        }
+        // --- /command completion ----------------------------------------------
+        // Only at the start of the first line, with no space yet.
+        if (cursorLine === 0 && before.startsWith('/') && !before.includes(' ')) {
+            const cmdPrefix = before.slice(1);
+            const filtered = fuzzyFilter(this.commands.map(c => ({ name: c.name, description: c.description, argumentHint: c.argumentHint })), cmdPrefix, c => c.name);
+            const items = filtered.map(c => {
+                const hint = c.argumentHint;
+                const desc = c.description ?? '';
+                const fullDesc = hint ? (desc ? `${hint} — ${desc}` : hint) : desc;
+                return {
+                    value: c.name,
+                    label: c.name,
+                    ...fullDesc.length === 0 ? {} : { description: fullDesc },
+                };
+            });
+            if (items.length === 0)
+                return null;
+            return { items, prefix: before };
+        }
+        // --- /command argument completion --------------------------------------
+        // The editor's trigger pattern requires the trigger token to end the line,
+        // so it never fires once a space follows the command — argument suggestions
+        // are reachable only through explicit Tab. Dispatch to the per-command
+        // completer when one is registered; without one, stay at null (argument
+        // territory keeps the pre-completion behavior). An argument token starting
+        // with '@' never reaches here: the @-file branch above wins by design.
+        if (cursorLine === 0) {
+            const argMatch = /^\/(\S+)\s(.*)$/.exec(before);
+            if (argMatch !== null) {
+                const completer = this.argCompleters[argMatch[1].toLowerCase()];
+                if (completer === undefined)
+                    return null;
+                const args = argMatch[2];
+                const argPrefix = args.slice(tokenStart(args));
+                const candidates = await completer(argPrefix, options.signal);
+                if (options.signal.aborted)
+                    return null;
+                const prefixLower = argPrefix.toLowerCase();
+                const items = candidates.filter(item => item.value.toLowerCase().startsWith(prefixLower));
+                if (items.length === 0)
+                    return null;
+                return { items, prefix: argPrefix };
+            }
+        }
+        return null;
+    }
+    applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+        const currentLine = lines[cursorLine] ?? '';
+        const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
+        const afterCursor = currentLine.slice(cursorCol);
+        // Slash command: replace `/partial` with `/name` + a separating space
+        // (but only if the text after the cursor doesn't already begin with one,
+        // to avoid doubling spaces when completing mid-line).
+        if (prefix.startsWith('/') && beforePrefix.trim() === '') {
+            const separator = afterCursor.startsWith(' ') || afterCursor.startsWith('\t') ? '' : ' ';
+            const newLine = `${beforePrefix}/${item.value}${separator}${afterCursor}`;
+            const newLines = [...lines];
+            newLines[cursorLine] = newLine;
+            return {
+                lines: newLines,
+                cursorLine,
+                cursorCol: beforePrefix.length + 1 + item.value.length + separator.length, // +1 for '/'
+            };
+        }
+        // @-file: replace `@partial` with `@relpath` (+ trailing '/' kept open for dirs,
+        // + trailing space for files).
+        if (prefix.startsWith('@')) {
+            const isDir = item.label.endsWith('/');
+            const suffix = isDir ? '' : ' ';
+            const newLine = `${beforePrefix}${item.value}${suffix}${afterCursor}`;
+            const newLines = [...lines];
+            newLines[cursorLine] = newLine;
+            return {
+                lines: newLines,
+                cursorLine,
+                cursorCol: beforePrefix.length + item.value.length + suffix.length,
+            };
+        }
+        // Slash-command argument: replace only the current argument word, keeping
+        // the command name and everything before it intact. The prefix is exactly
+        // the word being replaced (see the argument branch in getSuggestions), so
+        // the generic before/after slicing already preserves the command; only the
+        // separator differs from plain insertion.
+        if (cursorLine === 0 && currentLine.startsWith('/') && beforePrefix.includes(' ')) {
+            const separator = afterCursor.startsWith(' ') || afterCursor.startsWith('\t') ? '' : ' ';
+            const newLine = `${beforePrefix}${item.value}${separator}${afterCursor}`;
+            const newLines = [...lines];
+            newLines[cursorLine] = newLine;
+            return {
+                lines: newLines,
+                cursorLine,
+                cursorCol: beforePrefix.length + item.value.length + separator.length,
+            };
+        }
+        // Fallback: plain insertion.
+        const newLine = `${beforePrefix}${item.value}${afterCursor}`;
+        const newLines = [...lines];
+        newLines[cursorLine] = newLine;
+        return {
+            lines: newLines,
+            cursorLine,
+            cursorCol: beforePrefix.length + item.value.length,
+        };
+    }
+    shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
+        const currentLine = lines[cursorLine] ?? '';
+        const before = currentLine.slice(0, cursorCol);
+        // Don't force-trigger while typing a slash command at the start of a line.
+        if (before.trimStart().startsWith('/') && !before.trimStart().includes(' ')) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=completion.js.map

package/lib/components/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/components/completion.ts"],"names":[],"mappings":"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"}

package/lib/components/diff-card.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Render structured FileDiff data as ANSI-styled hunk lines for the
+ * transcript. Hunks come from {@link computeHunks} (line-level LCS with a
+ * size-capped prefix/suffix fallback). Large unchanged runs between hunks
+ * collapse to a single dim `… N unchanged lines …` marker; small runs render
+ * as dim context so adjacent hunks read as one cluster. Changed lines carry a
+ * right-aligned gutter line number (old-side number on `-` lines, new-side on
+ * `+` lines). Output is capped so a single tool row never blows the
+ * transcript line budget, and truncation respects hunk boundaries: a hunk
+ * that fits in the remaining budget is never split in half.
+ * @module @dsh-cc/tui/components/diff-card
+ */
+import type { FileDiff } from '../tool-card.ts';
+import { type Theme } from './theme.ts';
+/** Default cap on emitted lines for a single tool row's diffs. */
+export declare const DEFAULT_DIFF_LINE_CAP = 60;
+/**
+ * Render FileDiff[] as ANSI-styled lines: a bold per-file header with a tag,
+ * then gutter-numbered removals (error role) and additions (success role)
+ * grouped into hunks, with muted context and `… N unchanged lines …` collapse
+ * markers between them. Capped at `maxLines` (default 60); a muted trailer is
+ * appended when content is cut, and the cut lands on a hunk boundary.
+ *
+ * Indentation (two leading spaces) is applied here so callers can drop the
+ * returned lines directly beneath a tool row's head line. Styles come from
+ * the injected `theme` (default: the built-in palette).
+ */
+export declare function renderDiffLines(diffs: readonly FileDiff[], maxLines?: number, theme?: Theme): string[];
+//# sourceMappingURL=diff-card.d.ts.map

package/lib/components/diff-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-card.d.ts","sourceRoot":"","sources":["../../src/components/diff-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAErD,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,KAAK,CAAA;AA4JvC;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,QAAQ,GAAE,MAA8B,EACxC,KAAK,GAAE,KAAoB,GAC1B,MAAM,EAAE,CAaV"}