@dsh-cc/tui 0.5.0

package/lib/components/provider-box.js

@@ -0,0 +1,164 @@
+/**
+ * `/provider` overlay box (design doc §4.2–§4.6): the two-section provider
+ * list with credential badges, the manage detail view (§4.4), the add /
+ * custom / rotate wizard phases (§4.3, §4.6), and the remove double-confirm.
+ * The wizard's live text entry is a real pi-tui `Input` owned by the runtime
+ * (provider-command.ts) and rendered inside this box when a text step is
+ * active; the box itself stays a pure function of the panel state.
+ * @module @dsh-cc/tui/components/provider-box
+ */
+import { Container, Text } from '@dsh-cc/pi-tui';
+import { defaultTheme } from "./theme.js";
+/** Badge text for one row's credential state (§4.2). */
+function badgeText(row) {
+    const credential = row.credential;
+    if (credential === undefined || credential.badge === 'missing')
+        return 'key ✗ missing';
+    return `key ✓ (${credential.badge})`;
+}
+const CUSTOM_PROTOCOLS = ['openai-completions', 'openai-responses', 'anthropic-messages'];
+/** Render the live text field's lines inside the box (masked Input shows bullets). */
+function renderField(box, field) {
+    if (field === undefined)
+        return;
+    for (const line of field.render(100))
+        box.addChild(new Text(line, 0, 0));
+}
+/**
+ * Provider list box: "Providers" title, then the Configured section (live
+ * settings dict, document order) and the Available section (presets), with
+ * `●`/`○` current markers, credential badges, model counts, ⚠ on configured
+ * routes with models but no key, and the directory tail collapsed under
+ * "More providers (…)".
+ */
+export function createProviderPanelBox(view, theme = defaultTheme, field) {
+    const box = new Container();
+    if (view.phase === 'detail')
+        return detailBox(box, view, theme);
+    if (view.phase === 'wizard')
+        return wizardBox(box, view, theme, field);
+    if (view.phase === 'confirm-remove')
+        return confirmRemoveBox(box, view, theme);
+    box.addChild(new Text(theme.bold('Providers'), 0, 0));
+    const renderRow = (row, index) => {
+        const focused = view.phase === 'list' && view.cursor === index;
+        const marker = row.isCurrent ? '●' : '○';
+        const models = row.modelCount > 0 ? `   ${row.modelCount} models` : '';
+        const warning = row.credential?.warning === true ? '  ⚠' : '';
+        const prefix = focused ? '❯ ' : '  ';
+        box.addChild(new Text(`${prefix}${marker} ${row.route}   ${row.displayName}   ${badgeText(row)}${models}${warning}`, 0, 0));
+    };
+    // Rows arrive flat (configured block then available block); the section
+    // boundary is the first `available` row.
+    const split = view.rows.findIndex(row => row.section === 'available');
+    const configuredEnd = split === -1 ? view.rows.length : split;
+    box.addChild(new Text(theme.muted('  Configured'), 0, 0));
+    for (let index = 0; index < configuredEnd; index += 1)
+        renderRow(view.rows[index], index);
+    if (configuredEnd < view.rows.length) {
+        box.addChild(new Text(theme.muted('  Available'), 0, 0));
+        for (let index = configuredEnd; index < view.rows.length; index += 1)
+            renderRow(view.rows[index], index);
+    }
+    if (view.more.length > 0) {
+        box.addChild(new Text(`  … More providers (${view.more.map(m => m.provider).join(', ')})`, 0, 0));
+    }
+    if (view.message !== undefined) {
+        box.addChild(new Text(theme.warning(view.message), 0, 0));
+    }
+    box.addChild(new Text(theme.muted('j/k move · enter open · n add custom · esc close'), 0, 0));
+    return box;
+}
+/** Detail view (§4.4): resolved facts + raw profile JSON + action rows. */
+function detailBox(box, view, theme) {
+    box.addChild(new Text(theme.bold(`Provider ${view.selected ?? ''}`), 0, 0));
+    const detail = view.detail;
+    if (detail !== undefined) {
+        box.addChild(new Text(`endpoint  ${detail.endpoint}`, 0, 0));
+        box.addChild(new Text(`protocol  ${detail.api}`, 0, 0));
+        box.addChild(new Text(`models    ${detail.modelCount}`, 0, 0));
+        box.addChild(new Text(`key       ${detail.credentialLine}`, 0, 0));
+        box.addChild(new Text(theme.muted('profile (read-only):'), 0, 0));
+        for (const line of detail.profileJson.split('\n')) {
+            box.addChild(new Text(theme.muted(`  ${line}`), 0, 0));
+        }
+    }
+    const actions = view.actions ?? [];
+    for (let index = 0; index < actions.length; index += 1) {
+        const action = actions[index];
+        const marker = (view.actionCursor ?? 0) === index ? '❯ ' : '  ';
+        const suffix = action.disabled === true ? `  (unavailable — ${action.reason ?? ''})` : '';
+        box.addChild(new Text(`${marker}${action.label}${suffix}`, 0, 0));
+    }
+    if (view.message !== undefined) {
+        box.addChild(new Text(theme.warning(view.message), 0, 0));
+    }
+    box.addChild(new Text(theme.muted('j/k move · enter select · esc back'), 0, 0));
+    return box;
+}
+/** Wizard phases (§4.3/§4.6/rotate): step rail, live field, notes, prompts. */
+function wizardBox(box, view, theme, field) {
+    const wizard = view.wizard;
+    if (wizard === undefined)
+        return box;
+    const title = wizard.kind === 'rotate'
+        ? `Rotate key — ${wizard.route}`
+        : wizard.kind === 'custom' ? 'Add custom provider' : `Add ${wizard.route}${wizard.displayName === undefined ? '' : ` (${wizard.displayName})`}`;
+    box.addChild(new Text(theme.bold(title), 0, 0));
+    box.addChild(new Text(theme.muted(wizard.steps.map((step, index) => index === wizard.stepIndex ? `[${step}]` : step).join(' → ')), 0, 0));
+    const step = wizard.steps[wizard.stepIndex];
+    if (step === 'protocol') {
+        for (let index = 0; index < CUSTOM_PROTOCOLS.length; index += 1) {
+            const marker = (wizard.selectIndex ?? 0) === index ? '❯ ' : '  ';
+            box.addChild(new Text(`${marker}${CUSTOM_PROTOCOLS[index]}`, 0, 0));
+        }
+    }
+    else if (step === 'credential' || step === 'key') {
+        box.addChild(new Text(theme.muted(`API key for ${wizard.answers['ref'] ?? wizard.route} — stored in ~/.dsh/.credentials.yaml, never in settings`), 0, 0));
+        renderField(box, field);
+    }
+    else if (step === 'models') {
+        box.addChild(new Text(theme.muted('model ids — one per entry: id | Name | contextWindow | maxTokens'), 0, 0));
+        renderField(box, field);
+        box.addChild(new Text(theme.muted('tab fetch from endpoint · enter save'), 0, 0));
+    }
+    else if (step === 'verify') {
+        const verify = wizard.verify;
+        if (verify !== undefined)
+            box.addChild(new Text(verify.message ?? 'verifying…', 0, 0));
+    }
+    else if (step === 'done') {
+        const where = wizard.answers['ref'] === undefined ? '' : ` — key in ${wizard.answers['ref']}`;
+        box.addChild(new Text(`Added ${wizard.route || wizard.answers['route'] || ''}${where}.`, 0, 0));
+        box.addChild(new Text(theme.muted('Set as default? enter yes · esc no (/model switches the running session)'), 0, 0));
+    }
+    else {
+        renderField(box, field);
+    }
+    if (wizard.note !== undefined)
+        box.addChild(new Text(theme.warning(wizard.note), 0, 0));
+    if (wizard.modelErrors !== undefined) {
+        for (const error of wizard.modelErrors)
+            box.addChild(new Text(theme.warning(error), 0, 0));
+    }
+    if (view.message !== undefined)
+        box.addChild(new Text(theme.warning(view.message), 0, 0));
+    box.addChild(new Text(theme.muted('enter next · esc back'), 0, 0));
+    return box;
+}
+/** Remove double-confirm (§4.4): the unset confirm, then the credential-drop offer. */
+function confirmRemoveBox(box, view, theme) {
+    box.addChild(new Text(theme.bold(`Remove provider ${view.selected ?? ''}?`), 0, 0));
+    if (view.message !== undefined)
+        box.addChild(new Text(theme.warning(view.message), 0, 0));
+    if (view.stage === 'drop-credential') {
+        box.addChild(new Text('Route removed. Also drop the stored credential?', 0, 0));
+        box.addChild(new Text(theme.muted('enter drop · x keep · esc keep'), 0, 0));
+    }
+    else {
+        box.addChild(new Text(theme.muted('This unsets llm-pi-ai.providers.' + (view.selected ?? '')), 0, 0));
+        box.addChild(new Text(theme.muted('enter remove · esc cancel'), 0, 0));
+    }
+    return box;
+}
+//# sourceMappingURL=provider-box.js.map

package/lib/components/provider-box.js.map

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

package/lib/components/read-group.d.ts

@@ -0,0 +1,51 @@
+/**
+ * View-layer grouping of consecutive completed file-read tool rows. The store
+ * keeps a strict 1:1 mapping between rows and durable events, so collapsing
+ * N reads into one summary line can only happen here — after the transcript's
+ * line-budget clipping and purely for rendering. Nothing in this module feeds
+ * back into state.
+ * @module @dsh-cc/tui/components/read-group
+ */
+import type { TranscriptRow } from '../store.ts';
+/**
+ * One slot in the grouped render sequence: either an untouched row (rendered
+ * by the normal per-row path) or a group of completed read rows collapsed
+ * into a single summary line.
+ */
+export type RenderItem = {
+    kind: 'row';
+    row: TranscriptRow;
+} | {
+    kind: 'readGroup';
+    rows: readonly TranscriptRow[];
+};
+/**
+ * Collapse runs of ≥2 consecutive groupable read rows into `readGroup`
+ * items. Any other row (running/errored read, non-read tool, user text,
+ * status, …) closes the current segment. Single reads pass through as plain
+ * rows so a lone call keeps its familiar per-row rendering.
+ */
+export declare function groupReadRows(rows: readonly TranscriptRow[]): readonly RenderItem[];
+/**
+ * Stable cache key for a group: its member callId list. Deliberately free of
+ * row references — the store replaces row objects in place as results arrive,
+ * and the collapsed summary never depends on results.
+ */
+export declare function readGroupCacheKey(rows: readonly TranscriptRow[]): string;
+/** Most paths shown before the remainder collapses into "+M more". */
+export declare const READ_GROUP_MAX_PATHS = 4;
+/** Character cap for the rendered path list before it is truncated. */
+export declare const READ_GROUP_LIST_MAX_CHARS = 160;
+/**
+ * Extract the display path for one read row: the `file_path`/`path` field of
+ * the call's args JSON first, then the presenter title, then the bare tool
+ * name as a last resort (so the slot is never empty — an unstyled fallback
+ * beats rendering nothing between commas).
+ */
+export declare function readDisplayPath(row: TranscriptRow): string;
+/**
+ * Render a read group as one line:
+ * `⏺ Read N files · a.ts, b.ts +M more`
+ */
+export declare function renderReadGroup(rows: readonly TranscriptRow[]): string;
+//# sourceMappingURL=read-group.d.ts.map

package/lib/components/read-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-group.d.ts","sourceRoot":"","sources":["../../src/components/read-group.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAA;AAgBzD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,UAAU,EAAE,CAwBnF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAExE;AAED,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAgB1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAYtE"}

package/lib/components/read-group.js

@@ -0,0 +1,105 @@
+/**
+ * View-layer grouping of consecutive completed file-read tool rows. The store
+ * keeps a strict 1:1 mapping between rows and durable events, so collapsing
+ * N reads into one summary line can only happen here — after the transcript's
+ * line-budget clipping and purely for rendering. Nothing in this module feeds
+ * back into state.
+ * @module @dsh-cc/tui/components/read-group
+ */
+/** Tool names that collapse together (case-insensitive). */
+const READ_TOOL_NAMES = new Set(['read', 'read_image']);
+/**
+ * A read row is groupable only when it has finished cleanly: a running call
+ * still streams its own trail line, and an errored call must stay visible.
+ */
+function isGroupableRead(row) {
+    return row.kind === 'tool'
+        && READ_TOOL_NAMES.has(row.name.toLowerCase())
+        && !row.running
+        && row.error !== true;
+}
+/**
+ * Collapse runs of ≥2 consecutive groupable read rows into `readGroup`
+ * items. Any other row (running/errored read, non-read tool, user text,
+ * status, …) closes the current segment. Single reads pass through as plain
+ * rows so a lone call keeps its familiar per-row rendering.
+ */
+export function groupReadRows(rows) {
+    const items = [];
+    let segment = [];
+    const flush = () => {
+        if (segment.length === 1) {
+            items.push({ kind: 'row', row: segment[0] });
+        }
+        else if (segment.length > 1) {
+            items.push({ kind: 'readGroup', rows: segment });
+        }
+        segment = [];
+    };
+    for (const row of rows) {
+        if (isGroupableRead(row)) {
+            segment.push(row);
+        }
+        else {
+            flush();
+            items.push({ kind: 'row', row });
+        }
+    }
+    flush();
+    return items;
+}
+/**
+ * Stable cache key for a group: its member callId list. Deliberately free of
+ * row references — the store replaces row objects in place as results arrive,
+ * and the collapsed summary never depends on results.
+ */
+export function readGroupCacheKey(rows) {
+    return rows.map(row => row.kind === 'tool' ? row.callId : '').join('\n');
+}
+/** Most paths shown before the remainder collapses into "+M more". */
+export const READ_GROUP_MAX_PATHS = 4;
+/** Character cap for the rendered path list before it is truncated. */
+export const READ_GROUP_LIST_MAX_CHARS = 160;
+/**
+ * Extract the display path for one read row: the `file_path`/`path` field of
+ * the call's args JSON first, then the presenter title, then the bare tool
+ * name as a last resort (so the slot is never empty — an unstyled fallback
+ * beats rendering nothing between commas).
+ */
+export function readDisplayPath(row) {
+    if (row.kind !== 'tool')
+        return '';
+    try {
+        const parsed = JSON.parse(row.args);
+        if (typeof parsed === 'object' && parsed !== null) {
+            const record = parsed;
+            for (const key of ['file_path', 'path']) {
+                const value = record[key];
+                if (typeof value === 'string' && value.length > 0)
+                    return value;
+            }
+        }
+    }
+    catch {
+        // Unparseable args fall through to the title fallback.
+    }
+    if (row.title.length > 0)
+        return row.title;
+    return row.name;
+}
+/**
+ * Render a read group as one line:
+ * `⏺ Read N files · a.ts, b.ts +M more`
+ */
+export function renderReadGroup(rows) {
+    const paths = rows.map(readDisplayPath);
+    const shown = paths.slice(0, READ_GROUP_MAX_PATHS);
+    const moreCount = paths.length - shown.length;
+    const more = moreCount > 0 ? ` +${moreCount} more` : '';
+    let list = shown.join(', ');
+    if (list.length > READ_GROUP_LIST_MAX_CHARS) {
+        list = `${list.slice(0, READ_GROUP_LIST_MAX_CHARS)}…`;
+    }
+    return `⏺ Read ${rows.length} files · ${list}${more}`;
+}
+//# sourceMappingURL=read-group.js.map

package/lib/components/read-group.js.map

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

package/lib/components/root-bash.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `!` shell-mode behavior for the root pi-tui mount, factored out of
+ * components/root.ts so that file stays under its line budget.
+ *
+ * Shell mode is derived, not stored: the composer is in shell mode exactly
+ * while its text starts with `!`. The border switches to the warning role
+ * so the mode is visible, ↑/↓ browse the bash-only history stack, and Esc
+ * exits the mode ahead of the generic busy-interrupt branch (the ordering
+ * in root.ts's input listener is deliberate). Paste normalization lives at
+ * the driver's submit — a `!`-prefixed line runs locally no matter how it
+ * got into the buffer.
+ * @module @dsh-cc/tui/components/root-bash
+ */
+import type { Editor, TUI } from '@dsh-cc/pi-tui';
+import type { Theme } from './theme.ts';
+import type { Driver } from '../state/driver-types.ts';
+export interface AttachBashModeArgs {
+    editor: Editor;
+    driver: Driver;
+    tui: TUI;
+    theme: Theme;
+}
+export interface BashModeHandle {
+    /** True while a `!` command is in flight; the composer is disabled. */
+    bashRunning(): boolean;
+    inShellMode(): boolean;
+    browseBashHistory(towardsOlder: boolean): void;
+    resetBashHistoryBrowsing(): void;
+}
+/**
+ * Install the `!` shell-mode state and the editor change/submit hooks that
+ * drive it. Owns the bash-history browsing stack; assigns editor.onChange /
+ * editor.onSubmit exactly as root.ts did inline, so behavior is unchanged.
+ */
+export declare function attachBashMode(args: AttachBashModeArgs): BashModeHandle;
+//# sourceMappingURL=root-bash.d.ts.map

package/lib/components/root-bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-bash.d.ts","sourceRoot":"","sources":["../../src/components/root-bash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAGtD,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,GAAG,CAAA;IACR,KAAK,EAAE,KAAK,CAAA;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,WAAW,IAAI,OAAO,CAAA;IACtB,WAAW,IAAI,OAAO,CAAA;IACtB,iBAAiB,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9C,wBAAwB,IAAI,IAAI,CAAA;CACjC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA6FvE"}

package/lib/components/root-bash.js

@@ -0,0 +1,112 @@
+/**
+ * `!` shell-mode behavior for the root pi-tui mount, factored out of
+ * components/root.ts so that file stays under its line budget.
+ *
+ * Shell mode is derived, not stored: the composer is in shell mode exactly
+ * while its text starts with `!`. The border switches to the warning role
+ * so the mode is visible, ↑/↓ browse the bash-only history stack, and Esc
+ * exits the mode ahead of the generic busy-interrupt branch (the ordering
+ * in root.ts's input listener is deliberate). Paste normalization lives at
+ * the driver's submit — a `!`-prefixed line runs locally no matter how it
+ * got into the buffer.
+ * @module @dsh-cc/tui/components/root-bash
+ */
+import { parseSlash } from "../slash.js";
+/**
+ * Install the `!` shell-mode state and the editor change/submit hooks that
+ * drive it. Owns the bash-history browsing stack; assigns editor.onChange /
+ * editor.onSubmit exactly as root.ts did inline, so behavior is unchanged.
+ */
+export function attachBashMode(args) {
+    const { editor, driver, tui, theme } = args;
+    let bashBrowsing = false;
+    let bashBrowsingIndex = -1;
+    let bashDraft = '';
+    let bashRecallApplied = false;
+    let bashRunning = false;
+    const inShellMode = () => editor.getText().startsWith('!');
+    const resetBashHistoryBrowsing = () => {
+        bashBrowsing = false;
+        bashBrowsingIndex = -1;
+        bashDraft = '';
+    };
+    /**
+     * Browse the bash history stack (driver-owned, newest-first). ↑ walks
+     * toward older entries; ↓ walks back and restores the pre-browsing draft
+     * past the newest. Recalled entries are re-prefixed with `!` so the buffer
+     * stays shell-shaped and Enter re-runs them through the same submit path.
+     */
+    const browseBashHistory = (towardsOlder) => {
+        const entries = driver.bashHistory;
+        if (entries.length === 0)
+            return;
+        if (!bashBrowsing) {
+            bashBrowsing = true;
+            bashBrowsingIndex = -1;
+            bashDraft = editor.getText();
+        }
+        if (towardsOlder) {
+            if (bashBrowsingIndex + 1 >= entries.length)
+                return; // clamped at the oldest
+            bashBrowsingIndex += 1;
+        }
+        else {
+            bashBrowsingIndex -= 1;
+            if (bashBrowsingIndex < 0) {
+                // Down past the newest entry: restore the pre-browsing draft.
+                const draft = bashDraft;
+                resetBashHistoryBrowsing();
+                bashRecallApplied = true;
+                editor.setText(draft);
+                bashRecallApplied = false;
+                return;
+            }
+        }
+        bashRecallApplied = true;
+        editor.setText(`!${entries[bashBrowsingIndex]}`);
+        bashRecallApplied = false;
+    };
+    // Mirror the shell-mode border on every buffer change: the warning role
+    // while the buffer holds a `!`-prefixed line, the accent role otherwise.
+    const syncShellModeBorder = () => {
+        const styler = inShellMode() ? theme.warning : theme.accent;
+        if (editor.borderColor !== styler) {
+            editor.borderColor = styler;
+            tui.requestRender();
+        }
+    };
+    editor.onChange = (text) => {
+        driver.setDraft(text);
+        syncShellModeBorder();
+        // Any buffer change that was not a bash recall ends history browsing,
+        // so the next ↑ starts fresh (mirrors the editor's own navigation).
+        if (!bashRecallApplied)
+            resetBashHistoryBrowsing();
+    };
+    editor.onSubmit = (text) => {
+        if (text.startsWith('!')) {
+            // Shell command: never a composer prompt. While the driver runs it,
+            // the composer is disabled — the input listener swallows every key
+            // until submit settles (bounded by the command's own timeout).
+            resetBashHistoryBrowsing();
+            bashRunning = true;
+            void driver.submit(text)
+                .catch(() => { })
+                .then(() => {
+                bashRunning = false;
+                tui.requestRender();
+            });
+            return;
+        }
+        const parsed = parseSlash(text);
+        // Only prompts join editor recall; slash commands are not prompts.
+        if (parsed.kind === 'none')
+            editor.addToHistory(text);
+        // Submit is fire-and-forget. Quit/exit finalization — including the
+        // /quit worktree-exit confirmation — is owned by the driver's quit path
+        // (config.onQuit), not by the onSubmit special-case it used to have here.
+        void driver.submit(text);
+    };
+    return { bashRunning: () => bashRunning, inShellMode, browseBashHistory, resetBashHistoryBrowsing };
+}
+//# sourceMappingURL=root-bash.js.map

package/lib/components/root-bash.js.map

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

package/lib/components/root-types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Public mount contracts for the root pi-tui component, split out of root.ts
+ * to keep the factory under the line budget. Deliberately a leaf — must not
+ * import root.ts.
+ * @module @dsh-cc/tui/components/root-types
+ */
+import type { Editor, Terminal, TUI, TuiMode } from '@dsh-cc/pi-tui';
+import type { ThemeOverrides } from './theme.ts';
+export interface BuildRootOptions {
+    terminal?: Terminal;
+    onQuit?: () => void;
+    /**
+     * 'regular' (default) renders inline into the main screen scrollback;
+     * 'fullscreen' enters the alternate screen on start: the transcript scrolls
+     * inside a primary ScrollView while the dock (queue, todos, overlays,
+     * editor, statusline) stays pinned at the bottom.
+     */
+    uiMode?: TuiMode;
+    /** Fullscreen-only: mouse capture for wheel scrolling and app-owned selection. Default true. */
+    mouse?: boolean;
+    /**
+     * Per-role palette overrides for the terminal theme. Every role accepts a
+     * basic ANSI color name or a raw SGR code string; invalid values keep the
+     * built-in default, so an absent (or partial) override renders exactly like
+     * the historical fixed palette.
+     */
+    theme?: ThemeOverrides;
+}
+export interface RootHandle {
+    readonly tui: TUI;
+    readonly editor: Editor;
+    readonly mode: TuiMode;
+    destroy(): void;
+    /**
+     * Stop the surface. In fullscreen mode this leaves the alternate screen
+     * with the final frame preserved, then replays the chrome through a one-shot
+     * main-screen renderer so native scrollback ends up with the same inline
+     * layout a regular session would have produced.
+     */
+    stopForExit(): void;
+}
+//# sourceMappingURL=root-types.d.ts.map

package/lib/components/root-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-types.d.ts","sourceRoot":"","sources":["../../src/components/root-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,OAAO,IAAI,IAAI,CAAA;IACf;;;;;OAKG;IACH,WAAW,IAAI,IAAI,CAAA;CACnB"}

package/lib/components/root-types.js

@@ -0,0 +1,8 @@
+/**
+ * Public mount contracts for the root pi-tui component, split out of root.ts
+ * to keep the factory under the line budget. Deliberately a leaf — must not
+ * import root.ts.
+ * @module @dsh-cc/tui/components/root-types
+ */
+export {};
+//# sourceMappingURL=root-types.js.map

package/lib/components/root-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-types.js","sourceRoot":"","sources":["../../src/components/root-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/components/root-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Standalone helpers and constants extracted from the root mount: OS URL
+ * opening, active-task text capping, window-title sanitizing, and the
+ * double-press quit window.
+ * Deliberately a leaf — must not import root.ts.
+ * @module @dsh-cc/tui/components/root-utils
+ */
+/** How long after the first idle Ctrl+C a second press still quits (ms). */
+export declare const DOUBLE_PRESS_WINDOW_MS = 2000;
+export declare function truncateActive(content: string): string;
+/**
+ * Make a string safe for an OSC 0 window-title write: strip control
+ * characters, trim, cap the length, and fall back to 'dsh-cc' when nothing
+ * printable remains.
+ */
+export declare function sanitizeWindowTitle(title: string): string;
+/**
+ * Open an OSC 8 hyperlink with the OS handler. Fullscreen mouse capture takes
+ * over the terminal's native link activation, so clicks are routed here.
+ */
+export declare function openSystemUrl(url: string): void;
+//# sourceMappingURL=root-utils.d.ts.map

package/lib/components/root-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-utils.d.ts","sourceRoot":"","sources":["../../src/components/root-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAK1C,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM/C"}

package/lib/components/root-utils.js

@@ -0,0 +1,45 @@
+/**
+ * Standalone helpers and constants extracted from the root mount: OS URL
+ * opening, active-task text capping, window-title sanitizing, and the
+ * double-press quit window.
+ * Deliberately a leaf — must not import root.ts.
+ * @module @dsh-cc/tui/components/root-utils
+ */
+import { spawn } from 'node:child_process';
+/** How long after the first idle Ctrl+C a second press still quits (ms). */
+export const DOUBLE_PRESS_WINDOW_MS = 2000;
+/** Cap the active-task text shown in the todo strip (ellipsis past the cap). */
+const TODO_ACTIVE_CAP = 60;
+export function truncateActive(content) {
+    return content.length > TODO_ACTIVE_CAP ? `${content.slice(0, TODO_ACTIVE_CAP - 1)}…` : content;
+}
+/** Cap the terminal window title (chars, post-sanitize). */
+const WINDOW_TITLE_CAP = 120;
+// C0 controls (ESC/BEL included — they terminate or inject OSC sequences),
+// DEL, and C1 controls. The session-title service already normalizes; this
+// is defense-in-depth on an LLM-derived string crossing into the terminal.
+// eslint-disable-next-line no-control-regex
+const WINDOW_TITLE_CONTROL_CHARS = /[\x00-\x1f\x7f\x80-\x9f]/g;
+/**
+ * Make a string safe for an OSC 0 window-title write: strip control
+ * characters, trim, cap the length, and fall back to 'dsh-cc' when nothing
+ * printable remains.
+ */
+export function sanitizeWindowTitle(title) {
+    const cleaned = title.replace(WINDOW_TITLE_CONTROL_CHARS, '').trim();
+    if (cleaned.length === 0)
+        return 'dsh-cc';
+    return cleaned.length > WINDOW_TITLE_CAP ? cleaned.slice(0, WINDOW_TITLE_CAP) : cleaned;
+}
+/**
+ * Open an OSC 8 hyperlink with the OS handler. Fullscreen mouse capture takes
+ * over the terminal's native link activation, so clicks are routed here.
+ */
+export function openSystemUrl(url) {
+    const child = process.platform === 'win32'
+        ? spawn('cmd.exe', ['/c', 'start', '', url], { stdio: 'ignore', detached: true })
+        : spawn(process.platform === 'darwin' ? 'open' : 'xdg-open', [url], { stdio: 'ignore', detached: true });
+    child.on('error', () => { });
+    child.unref();
+}
+//# sourceMappingURL=root-utils.js.map