@aragon-agent/cli 0.6.46 → 0.6.48

package/dist/ui/selection/selection.js

@@ -1,223 +0,0 @@
-/**
- * The selection model (tui-selection-and-scroll-follow §4.4.4). PURE — no React,
- * no I/O, no terminal.
- *
- * Coordinates are SCREEN CELLS, 0-based: frame line `i` is terminal row `i + 1`
- * and column `x - 1`, so an SGR report at `(x, y)` becomes `{ row: y - 1, col: x
- * - 1 }`. Screen coordinates are only sound while the rows hold still, and
- * holding them still is Stage 2's job — `press` sets `hold`, which anchors the
- * content and suspends the resume timer, so the transcript is frozen for the
- * duration of a drag (D-7).
- *
- * ═══════════════════════════════════════════════════════════════════════════
- * I-12 — `sliceColumns` IS THE ONE COLUMN→CHARACTER MAPPING IN THIS FEATURE,
- * and `stringWidth` is its only width oracle.
- *
- * The painter and the extractor are handed the SAME half-open column range by
- * `rowSpan`. If they turn that range into characters by different rules, the
- * copied text is not the highlighted text — silently, which is the one failure
- * mode I-4 exists to name. That is not hypothetical: `slice-ansi` advances its
- * cursor by `isFullWidth ? 2 : character.length`, i.e. display columns for CJK
- * but UTF-16 CODE UNITS for everything else, so a combining mark costs it a
- * column that occupies none and an astral code point costs two; and the obvious
- * `String.slice` for the extractor is code units throughout. Two mappings from
- * one range agree on ASCII and diverge on exactly the rows a user is most likely
- * to want to copy.
- *
- * So both call the function below, which walks GRAPHEME CLUSTERS and charges
- * each one `stringWidth(cluster)` columns. What is hand-rolled here is only the
- * column arithmetic — the width table is still `string-width`'s, and the escape
- * bookkeeping is `slice-ansi`'s idea re-indexed (R-13).
- * ═══════════════════════════════════════════════════════════════════════════
- */
-import stringWidth from 'string-width';
-export function normalize(sel) {
-    const { anchor, focus } = sel;
-    const anchorFirst = anchor.row < focus.row || (anchor.row === focus.row && anchor.col <= focus.col);
-    return anchorFirst ? { start: anchor, end: focus } : { start: focus, end: anchor };
-}
-export function isEmpty(sel) {
-    return sel.start.row === sel.end.row && sel.start.col === sel.end.col;
-}
-/**
- * The half-open column range to highlight on `row`, or `null` when the row is
- * outside the selection.
- *
- * LINEAR, NOT RECTANGULAR — what every terminal does: the first row runs from
- * `start.col` to end of line, whole middle rows are taken entirely, and the last
- * row stops at `end.col`. `Infinity` means "to the end of the line"; the painter
- * clamps it to the terminal width so a multi-row selection gets a straight right
- * edge, and the extractor treats it as "no upper bound".
- */
-export function rowSpan(sel, row) {
-    const { start, end } = sel;
-    if (row < start.row || row > end.row)
-        return null;
-    if (start.row === end.row) {
-        return end.col > start.col ? { from: start.col, to: end.col } : null;
-    }
-    if (row === start.row)
-        return { from: start.col, to: Number.POSITIVE_INFINITY };
-    if (row === end.row)
-        return end.col > 0 ? { from: 0, to: end.col } : null;
-    return { from: 0, to: Number.POSITIVE_INFINITY };
-}
-/**
- * The text a release would put on the clipboard.
- *
- * `plainRows` are the mirror's ANSI-STRIPPED rows — the same rows the highlight
- * was painted over, which is what makes I-4 hold by construction rather than by
- * a staleness check that can be wrong.
- */
-export function selectedText(plainRows, sel) {
-    const out = [];
-    for (let row = sel.start.row; row <= sel.end.row; row += 1) {
-        const span = rowSpan(sel, row);
-        if (!span)
-            continue;
-        const line = plainRows[row] ?? '';
-        const to = Number.isFinite(span.to) ? span.to : undefined;
-        out.push(sliceColumns(line, span.from, to).trimEnd());
-    }
-    return out.join('\n');
-}
-// ---------------------------------------------------------------------------
-// sliceColumns — the one mapping (I-12)
-// ---------------------------------------------------------------------------
-/**
- * CSI / OSC sequences. They occupy ZERO columns and are copied through so a
- * slice keeps the styling of the text around it.
- */
-const ANSI_RE = /\x1b(?:\[[0-9;:?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)|[@-Z\\-_])/g;
-/** SGR "all attributes off" — everything carried before it is cancelled. */
-const SGR_RESET_RE = /^\x1b\[0?m$/;
-const segmenter = typeof Intl !== 'undefined' && typeof Intl.Segmenter === 'function'
-    ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
-    : null;
-/**
- * Width cache. `stringWidth` re-segments and re-classifies on every call, and a
- * repaint slices every row of the selection; the key space is the set of
- * grapheme clusters on screen, which is tiny and bounded by the frame.
- */
-const widthCache = new Map();
-const WIDTH_CACHE_MAX = 4096;
-function clusterWidth(cluster) {
-    const hit = widthCache.get(cluster);
-    if (hit !== undefined)
-        return hit;
-    const w = stringWidth(cluster);
-    // A plain ceiling with a wholesale drop, like `virtual-window.ts`'s height
-    // cache: an LRU here would cost more bookkeeping than the values are worth.
-    if (widthCache.size >= WIDTH_CACHE_MAX)
-        widthCache.clear();
-    widthCache.set(cluster, w);
-    return w;
-}
-/** Split into ANSI sequences and grapheme clusters, in order. */
-function tokenize(text) {
-    const tokens = [];
-    ANSI_RE.lastIndex = 0;
-    let last = 0;
-    let m;
-    const pushPlain = (chunk) => {
-        if (chunk.length === 0)
-            return;
-        if (segmenter) {
-            for (const { segment } of segmenter.segment(chunk))
-                tokens.push({ text: segment, ansi: false });
-            return;
-        }
-        // No `Intl.Segmenter`: code points are a strictly worse but never wrong
-        // approximation — a combining mark becomes its own zero-width token, which
-        // the walk below already handles.
-        for (const cp of chunk)
-            tokens.push({ text: cp, ansi: false });
-    };
-    while ((m = ANSI_RE.exec(text)) !== null) {
-        pushPlain(text.slice(last, m.index));
-        tokens.push({ text: m[0], ansi: true });
-        last = m.index + m[0].length;
-    }
-    pushPlain(text.slice(last));
-    return tokens;
-}
-/**
- * Slice `text` by SCREEN COLUMNS, half-open `[from, to)`.
- *
- * Three properties are load-bearing:
- *
- *  - **Escape codes opened before `from` are carried into the result.** Without
- *    it the painter's tail — `sliceColumns(line, to)` — would lose the colour
- *    `Markdown` and `cli-highlight` gave it, on every row a selection touches.
- *  - **A wide cluster straddling either boundary becomes spaces for the part
- *    that is inside.** That keeps the arithmetic EXACT in columns, which is the
- *    whole point of I-12: half a CJK glyph is not a character, and inventing one
- *    would put the painter and the extractor back out of step.
- *  - **`to` is optional and means "to the end of the line".**
- */
-export function sliceColumns(text, from, to) {
-    const start = Math.max(0, Math.floor(from));
-    const end = to === undefined || !Number.isFinite(to) ? Number.POSITIVE_INFINITY : Math.floor(to);
-    if (end <= start)
-        return '';
-    let carried = '';
-    let out = '';
-    let col = 0;
-    let started = false;
-    const open = () => {
-        if (started)
-            return;
-        started = true;
-        out += carried;
-    };
-    for (const token of tokenize(text)) {
-        if (token.ansi) {
-            if (started)
-                out += token.text;
-            else {
-                if (SGR_RESET_RE.test(token.text))
-                    carried = '';
-                carried += token.text;
-            }
-            continue;
-        }
-        if (col >= end)
-            break;
-        const w = clusterWidth(token.text);
-        if (w === 0) {
-            // A zero-width cluster attaches to the cell before it, so it belongs to the
-            // slice only when that cell is already inside.
-            if (started)
-                out += token.text;
-            continue;
-        }
-        const cellEnd = col + w;
-        if (cellEnd <= start) {
-            col = cellEnd;
-            continue;
-        }
-        open();
-        if (col < start) {
-            // Straddles the LEFT boundary: only `cellEnd - start` columns are ours.
-            out += ' '.repeat(Math.min(cellEnd, end) - start);
-        }
-        else if (cellEnd > end) {
-            // Straddles the RIGHT boundary.
-            out += ' '.repeat(end - col);
-        }
-        else {
-            out += token.text;
-        }
-        col = cellEnd;
-    }
-    return out;
-}
-/** Display width in columns, using the same oracle `sliceColumns` charges with. */
-export function columnsOf(text) {
-    let total = 0;
-    for (const token of tokenize(text)) {
-        if (!token.ansi)
-            total += clusterWidth(token.text);
-    }
-    return total;
-}

package/dist/ui/shortcuts.d.ts

@@ -1,81 +0,0 @@
-/**
- * THE shortcut table (tui-shortcut-drawer-and-task-summary §4.6 / appendix B).
- *
- * ASCII ONLY, AND THAT IS A HARD CONSTRAINT RATHER THAN A STYLE CHOICE: this file
- * is inside `glyphs.test.ts::inScope` (`ui/` prefix), whose `A-1` case fails on a
- * single non-ASCII byte. Every `keyword` and `detail` below is English on
- * purpose; translating them would turn the scanner red, and the only escape
- * hatch - adding this file to the exemptions - is the thing that helper's own
- * comment argues against.
- *
- * THIS IS THE ONLY TRUTH ABOUT SHORTCUTS. The drawer, `/keys` and the tests all
- * derive from it, and `shortcut-table.test.ts` holds it in a BIDIRECTIONAL set
- * relation with `HelpOverlay`'s key column (D-8). The reverse direction is the
- * one that matters: without it `Alt+K`, `Esc twice` and `Esc again` could sit in
- * `/help` forever and never appear in the panel whose entire requirement is
- * "list ALL of them".
- *
- * `keyword` IS CAPPED AT 10 CELLS (`SHORTCUT_PANEL_LIMITS.keywordMaxCells`). A
- * longer one is a spec error, not a width problem: at 80 columns the keyword
- * column is 11 cells wide, and the only remaining remedy would be truncating it -
- * which is the exact defect (a column of `promp...`) this table exists to avoid.
- */
-export type ShortcutGroupId = 'compose' | 'run' | 'panels' | 'session' | 'view';
-/**
- * When a row can actually be used. Unavailable rows are STILL LISTED - the user
- * needs to know the key exists - but they render dim and explain themselves in
- * the detail line when selected.
- */
-export type ShortcutAvailability = 'always' | 'idle' | 'running' | 'app' | 'native';
-export interface ShortcutEntry {
-    /** Stable id used by tests and by `/keys <query>`. */
-    id: string;
-    /** The primary binding, spelled in full the way `HelpOverlay` spells it. */
-    keys: string;
-    /** One to two words, ASCII only, at most 10 columns. The requirement's second column. */
-    keyword: string;
-    /** One ASCII sentence, shown when the row is selected. */
-    detail: string;
-    group: ShortcutGroupId;
-    availability: ShortcutAvailability;
-    /** Extra spellings that must also resolve in `/keys <query>`. */
-    aliases?: readonly string[];
-}
-export declare const SHORTCUT_GROUPS: readonly {
-    id: ShortcutGroupId;
-    title: string;
-}[];
-/**
- * The 31 rows, in reading order. Group order is fixed by `SHORTCUT_GROUPS`, and
- * within a group the order is "how often a user reaches for it", not alphabetical:
- * a reference panel is scanned from the top.
- */
-export declare const SHORTCUTS: readonly ShortcutEntry[];
-/**
- * The longest `keys` string in cells - the input the column derivation needs.
- *
- * DERIVED, NEVER HARD-CODED: v1 fixed the key column at 21 cells, which left six
- * for the keyword at 80 columns and turned `prompt library` into `promp...`. A
- * derived value cannot go stale the day someone adds a longer binding.
- */
-export declare function widestKeysCells(entries: readonly ShortcutEntry[]): number;
-/**
- * Filter for `/keys <query>`: case-insensitive substring over id, keys, keyword
- * and aliases.
- *
- * NO KEYBOARD SEARCH IN THE PANEL ITSELF (§11 F-2): typing would fight `Esc` for
- * "clear the filter or close the panel", and `Esc` is App-owned. The command is
- * the zero-conflict way to reach the same filter.
- */
-export declare function filterShortcuts(entries: readonly ShortcutEntry[], query: string): ShortcutEntry[];
-/**
- * Whether a row can be used right now.
- *
- * `running` MEANS "ONLY WHILE RUNNING", not "unavailable while running" - the two
- * halves of the table would otherwise need two different predicates, which is the
- * kind of asymmetry a later reader gets backwards.
- */
-export declare function isAvailable(entry: ShortcutEntry, context: {
-    native: boolean;
-    running: boolean;
-}): boolean;

package/dist/ui/shortcuts.js

@@ -1,221 +0,0 @@
-/**
- * THE shortcut table (tui-shortcut-drawer-and-task-summary §4.6 / appendix B).
- *
- * ASCII ONLY, AND THAT IS A HARD CONSTRAINT RATHER THAN A STYLE CHOICE: this file
- * is inside `glyphs.test.ts::inScope` (`ui/` prefix), whose `A-1` case fails on a
- * single non-ASCII byte. Every `keyword` and `detail` below is English on
- * purpose; translating them would turn the scanner red, and the only escape
- * hatch - adding this file to the exemptions - is the thing that helper's own
- * comment argues against.
- *
- * THIS IS THE ONLY TRUTH ABOUT SHORTCUTS. The drawer, `/keys` and the tests all
- * derive from it, and `shortcut-table.test.ts` holds it in a BIDIRECTIONAL set
- * relation with `HelpOverlay`'s key column (D-8). The reverse direction is the
- * one that matters: without it `Alt+K`, `Esc twice` and `Esc again` could sit in
- * `/help` forever and never appear in the panel whose entire requirement is
- * "list ALL of them".
- *
- * `keyword` IS CAPPED AT 10 CELLS (`SHORTCUT_PANEL_LIMITS.keywordMaxCells`). A
- * longer one is a spec error, not a width problem: at 80 columns the keyword
- * column is 11 cells wide, and the only remaining remedy would be truncating it -
- * which is the exact defect (a column of `promp...`) this table exists to avoid.
- */
-import { cellWidth } from './layout/cells.js';
-export const SHORTCUT_GROUPS = [
-    { id: 'compose', title: 'COMPOSE' },
-    { id: 'run', title: 'RUN' },
-    { id: 'panels', title: 'PANELS' },
-    { id: 'session', title: 'SESSION' },
-    { id: 'view', title: 'VIEW' },
-];
-/**
- * The 31 rows, in reading order. Group order is fixed by `SHORTCUT_GROUPS`, and
- * within a group the order is "how often a user reaches for it", not alphabetical:
- * a reference panel is scanned from the top.
- */
-export const SHORTCUTS = [
-    // --- COMPOSE ---------------------------------------------------------------
-    {
-        id: 'enter', keys: 'Enter', keyword: 'send', group: 'compose', availability: 'always',
-        detail: 'Submits when idle; queues as steering while running;'
-            + ' re-pins the view to the newest output.',
-    },
-    {
-        id: 'alt-enter', keys: 'Alt+Enter', keyword: 'newline', group: 'compose',
-        availability: 'always',
-        detail: 'Multiline input; the host may intercept this combination.',
-    },
-    {
-        id: 'shift-enter', keys: 'Shift+Enter', keyword: 'newline', group: 'compose',
-        availability: 'always',
-        detail: 'Needs keyboard enhancement; /terminal-setup explains how to bind it.',
-    },
-    {
-        id: 'ctrl-j', keys: 'Ctrl+J', keyword: 'newline', group: 'compose', availability: 'always',
-        detail: 'Newline fallback that does not depend on keyboard enhancement.',
-    },
-    {
-        id: 'history', keys: 'Up / Down', keyword: 'history', group: 'compose', availability: 'always',
-        detail: 'Recalls earlier prompts when the input box is empty.',
-    },
-    {
-        id: 'paste', keys: 'Paste', keyword: 'paste', group: 'compose', availability: 'always',
-        detail: 'Up to 6 lines inserted as-is; larger becomes [Pasted text #N]; --no-paste disables.',
-    },
-    {
-        id: 'ctrl-o', keys: 'Ctrl+O', keyword: 'expand', group: 'compose', availability: 'always',
-        detail: 'Expands the newest tool output; in native mode it reprints it as a new block.',
-    },
-    {
-        id: 'ctrl-c', keys: 'Ctrl+C', keyword: 'copy/exit', group: 'compose', availability: 'always',
-        aliases: ['Ctrl+C (with a selection)'],
-        detail: 'Copies a pending selection; with a draft x2 clears and x3 exits;'
-            + ' empty input x2 exits.',
-    },
-    // --- RUN -------------------------------------------------------------------
-    {
-        id: 'esc', keys: 'Esc', keyword: 'close', group: 'run', availability: 'always',
-        detail: 'Closes the open overlay or menu; with nothing open it arms the interrupt ladder.',
-    },
-    {
-        id: 'esc-twice', keys: 'Esc twice', keyword: 'interrupt', group: 'run', availability: 'running',
-        aliases: ['Esc again'],
-        detail: 'Requests an interrupt within 1.5s; the next press forces the stop.',
-    },
-    {
-        id: 'shift-tab', keys: 'Shift+Tab', keyword: 'plan mode', group: 'run', availability: 'always',
-        detail: 'Cycles BUILD / PLAN / GOVERN / PLAN+GOVERN. PLAN refuses writes; GOVERN runs a governed team.',
-    },
-    {
-        id: 'ctrl-n', keys: 'Ctrl+N', keyword: 'plan mode', group: 'run', availability: 'always',
-        detail: 'The same cycle (BUILD / PLAN / GOVERN / PLAN+GOVERN), for consoles that cannot deliver Shift+Tab.',
-    },
-    {
-        id: 'ctrl-t', keys: 'Ctrl+T', keyword: 'thinking', group: 'run', availability: 'always',
-        detail: "Shows or hides the model's thinking (off by default).",
-    },
-    {
-        id: 'ctrl-r', keys: 'Ctrl+R', keyword: 'redraw', group: 'run', availability: 'always',
-        detail: 'Repaints the whole frame; use it when the terminal is garbled.',
-    },
-    // --- PANELS ----------------------------------------------------------------
-    {
-        id: 'ctrl-g', keys: 'Ctrl+G', keyword: 'all keys', group: 'panels', availability: 'always',
-        detail: 'Opens this panel; a second Ctrl+G closes it. Every shortcut is listed here.',
-    },
-    {
-        id: 'ctrl-b', keys: 'Ctrl+B', keyword: 'agents', group: 'panels', availability: 'always',
-        detail: 'Read-only subagent board: every child, its facts and its timeline.',
-    },
-    {
-        id: 'ctrl-p', keys: 'Ctrl+P', keyword: 'prompts', group: 'panels', availability: 'always',
-        detail: 'Quick prompt library: pick, edit, reorder.',
-    },
-    {
-        id: 'ctrl-k', keys: 'Ctrl+K', keyword: 'kits', group: 'panels', availability: 'always',
-        detail: 'Switch the main / fast / subagent model kit for this session.',
-    },
-    {
-        id: 'ctrl-i', keys: 'Ctrl+I', keyword: 'index', group: 'panels', availability: 'idle',
-        detail: 'Unavailable while running; asks first, then runs the project-indexer skill.',
-    },
-    {
-        id: 'alt-k', keys: 'Alt+K', keyword: 'kill line', group: 'panels', availability: 'always',
-        detail: 'Deletes from the cursor to the end of the line'
-            + ' (this was Ctrl+K before the kit picker).',
-    },
-    {
-        id: 'help', keys: '/help', keyword: 'reference', group: 'panels', availability: 'always',
-        detail: 'Full reference: keys, slash commands, plan mode, team, skills.',
-    },
-    // --- SESSION ---------------------------------------------------------------
-    {
-        id: 'ctrl-l', keys: 'Ctrl+L', keyword: 'branch', group: 'session', availability: 'always',
-        detail: 'Opens this session in a new terminal window with its own session id.',
-    },
-    {
-        id: 'clear', keys: '/clear', keyword: 'new task', group: 'session', availability: 'always',
-        detail: 'Archives the old conversation, clears the context;'
-            + ' the task summary is cleared with it.',
-    },
-    {
-        id: 'resume', keys: '/resume', keyword: 'switch', group: 'session', availability: 'always',
-        detail: 'Loads a saved session; the current session moves to a new id.',
-    },
-    {
-        id: 'session', keys: '/session', keyword: 'identity', group: 'session', availability: 'always',
-        detail: 'Shows the session id and file, copies the resume command, pins the id.',
-    },
-    // --- VIEW ------------------------------------------------------------------
-    {
-        id: 'page', keys: 'PgUp / PgDn', keyword: 'page', group: 'view', availability: 'always',
-        detail: 'Pages the transcript, or the overlay that currently owns the keyboard.',
-    },
-    {
-        id: 'wheel', keys: 'Wheel', keyword: 'scroll', group: 'view', availability: 'app',
-        detail: 'Scrolls the transcript in app mode; in native mode the terminal owns this.',
-    },
-    {
-        id: 'shift-wheel', keys: 'Shift+Wheel', keyword: 'page', group: 'view', availability: 'app',
-        detail: 'Scrolls a whole page.',
-    },
-    {
-        id: 'shift-arrows', keys: 'Shift+Up / Shift+Down', keyword: 'line', group: 'view',
-        availability: 'app',
-        detail: 'Scrolls one line; native mode leaves this to the terminal.',
-    },
-    {
-        id: 'drag-edge', keys: 'Drag right edge', keyword: 'scrollbar', group: 'view',
-        availability: 'app',
-        detail: 'Drags the right-edge scrollbar; the input stays fixed.',
-    },
-    {
-        id: 'drag-text', keys: 'Drag text (left button)', keyword: 'select', group: 'view',
-        availability: 'app',
-        detail: 'Drags to select on-screen text; the highlight waits for a copy.',
-    },
-];
-/**
- * The longest `keys` string in cells - the input the column derivation needs.
- *
- * DERIVED, NEVER HARD-CODED: v1 fixed the key column at 21 cells, which left six
- * for the keyword at 80 columns and turned `prompt library` into `promp...`. A
- * derived value cannot go stale the day someone adds a longer binding.
- */
-export function widestKeysCells(entries) {
-    return entries.reduce((widest, entry) => Math.max(widest, cellWidth(entry.keys)), 0);
-}
-/**
- * Filter for `/keys <query>`: case-insensitive substring over id, keys, keyword
- * and aliases.
- *
- * NO KEYBOARD SEARCH IN THE PANEL ITSELF (§11 F-2): typing would fight `Esc` for
- * "clear the filter or close the panel", and `Esc` is App-owned. The command is
- * the zero-conflict way to reach the same filter.
- */
-export function filterShortcuts(entries, query) {
-    const needle = query.trim().toLowerCase();
-    if (needle.length === 0)
-        return [...entries];
-    return entries.filter((entry) => {
-        const haystack = [entry.id, entry.keys, entry.keyword, ...(entry.aliases ?? [])];
-        return haystack.some((field) => field.toLowerCase().includes(needle));
-    });
-}
-/**
- * Whether a row can be used right now.
- *
- * `running` MEANS "ONLY WHILE RUNNING", not "unavailable while running" - the two
- * halves of the table would otherwise need two different predicates, which is the
- * kind of asymmetry a later reader gets backwards.
- */
-export function isAvailable(entry, context) {
-    switch (entry.availability) {
-        case 'always': return true;
-        case 'idle': return !context.running;
-        case 'running': return context.running;
-        case 'app': return !context.native;
-        case 'native': return context.native;
-        default: return true;
-    }
-}

package/dist/ui/status-feedback.d.ts

@@ -1,35 +0,0 @@
-/** Facts, never translated toast text, determine action ownership and feedback. */
-export interface StatusFeedback {
-    kind: 'confirm' | 'stopping' | 'force-stop' | 'exit' | 'clear-input' | 'copying' | 'copied' | 'copy-sent' | 'copy-cleanup' | 'copy-error' | 'notice';
-    text: string;
-    level: 'info' | 'warn' | 'error';
-}
-export type EscapeAction = 'menu' | 'cancel-start' | 'confirm-stop' | 'force-stop';
-export interface StatusFeedbackInput {
-    interactionPhase: 'idle' | 'starting' | 'running';
-    interruptPhase?: 'ready' | 'armed' | 'stopping';
-    completion?: 'none' | 'slash' | 'file';
-    overlay?: string | null;
-    copyState?: {
-        busy: boolean;
-        cleanupPending: boolean;
-    };
-    copyResult?: {
-        status: 'confirmed' | 'sent' | 'error';
-        text: string;
-    };
-    ctrlCArmed?: boolean;
-    /** Draft present: the armed feedback names the clear rung, not exit. */
-    hasDraft?: boolean;
-    selectionPending?: boolean;
-    liveServices?: number;
-    toast?: {
-        text: string;
-        level: 'info' | 'warn' | 'error';
-    };
-}
-export interface StatusFeedbackProjection {
-    feedback?: StatusFeedback;
-    escapeAction?: EscapeAction;
-}
-export declare function projectStatusFeedback(input: StatusFeedbackInput): StatusFeedbackProjection;

package/dist/ui/status-feedback.js

@@ -1,38 +0,0 @@
-export function projectStatusFeedback(input) {
-    const escapeAction = input.overlay ? undefined
-        : input.completion && input.completion !== 'none' ? 'menu'
-            : input.interactionPhase === 'starting' ? 'cancel-start'
-                : input.interactionPhase !== 'running' ? undefined
-                    : input.interruptPhase === 'stopping' ? 'force-stop' : 'confirm-stop';
-    let feedback;
-    if (input.ctrlCArmed && !input.copyState?.busy && !input.copyState?.cleanupPending
-        && !input.selectionPending && !input.liveServices) {
-        feedback = input.hasDraft
-            ? { kind: 'clear-input', text: 'Press Ctrl+C again to clear input', level: 'warn' }
-            : { kind: 'exit', text: 'Press Ctrl+C again to exit', level: 'warn' };
-    }
-    else if (input.copyState?.cleanupPending) {
-        feedback = { kind: 'copy-cleanup', text: 'Copy failed; cleaning up', level: 'error' };
-    }
-    else if (input.copyResult?.status === 'error') {
-        feedback = { kind: 'copy-error', text: input.copyResult.text, level: 'error' };
-    }
-    else if (input.copyState?.busy) {
-        feedback = { kind: 'copying', text: 'Copying', level: 'info' };
-    }
-    else if (input.copyResult) {
-        feedback = { kind: input.copyResult.status === 'confirmed' ? 'copied' : 'copy-sent',
-            text: input.copyResult.text, level: 'info' };
-    }
-    else if (input.interruptPhase === 'stopping' && escapeAction === 'force-stop') {
-        feedback = { kind: 'force-stop', text: 'Esc again to force-stop', level: 'warn' };
-    }
-    else if (input.interruptPhase === 'armed' && escapeAction && escapeAction !== 'menu') {
-        feedback = { kind: 'stopping', text: input.interactionPhase === 'starting'
-                ? 'Esc again to cancel start' : 'Esc again to stop', level: 'warn' };
-    }
-    else if (input.toast) {
-        feedback = { kind: 'notice', ...input.toast };
-    }
-    return { feedback, escapeAction };
-}

package/dist/ui/stdout-frame-writer.d.ts

@@ -1,74 +0,0 @@
-/**
- * Stdout frame writer — the `Proxy` that binds `frame-differ.ts` to a real
- * stream (tui-input-flicker-fix §3.2 / §5.5).
- *
- * Ink offers no hook for "how to write a frame": `Ink#log` is constructed
- * internally and `log-update` is a private module. It DOES accept a `stdout` in
- * `render()`'s options, so the whole interposition is one `Proxy` whose only
- * trapped behaviour is `write` — everything else is the real stream.
- *
- * THREE THINGS IN HERE ARE LOAD-BEARING:
- *
- *  - The `get` trap MUST bind non-`write` function members to the REAL stream.
- *    Without the bind, `stdout.on('resize', …)` executes with `this === proxy`,
- *    and `useTerminalSize` registers and removes its listener against a
- *    different `_events` object than the one Node emits on — the frame stops
- *    resizing and nothing reports why.
- *  - The UNTYPED BOUNDARY LIVES HERE, not in the differ (P1-4). A `Uint8Array`
- *    chunk, and any `write` whose `encoding` is present and is not UTF-8, is
- *    passed straight through after `invalidate()`: in both cases the bytes on
- *    the wire are not the string a differ could reason about, and diffing one
- *    encoding while writing another is the kind of bug that only shows up on
- *    someone else's machine.
- *  - The `'resize'` SUBSCRIPTION (I-8 / P0-2). Ink renders SYNCHRONOUSLY from its
- *    own `'resize'` handler while the frame's height is still the pre-resize one
- *    — `useTerminalSize` debounces by 50 ms — so the line count is unchanged
- *    across that window and the differ's line-count guard cannot see the resize.
- *    Meanwhile the emulator has re-flowed the alternate screen, so every row the
- *    differ believes unchanged is a row it will not repaint, for the rest of the
- *    drag. It goes on the REAL stream, not the `Proxy`, and `dispose()` removes
- *    it.
- */
-import type { FrameDiffer, FrameWriterStats } from './frame-differ.js';
-export interface FrameWriterHandle {
-    /** Hand this to `render(…, { stdout })`. */
-    stdout: NodeJS.WriteStream;
-    /** Hand this to `setFrameStatsProvider`. */
-    stats(): FrameWriterStats;
-    /**
-     * Re-paint the last frame through the differ's `decorate` hook — how a
-     * selection drag reaches the screen without a React commit.
-     *
-     * Returns whether anything was written. `false` means the differ had nothing
-     * safe to do (no cache, or a geometry stand-down), which is the caller's cue to
-     * fall back to `App`'s `redrawNonce`.
-     *
-     * I-3 / I-13 — IT WRITES TO THE REAL STREAM, NEVER THROUGH THE PROXY. Through
-     * the proxy the payload would be handed to `transform`, which would not
-     * recognise it and would `invalidate()`, turning every drag frame into a full
-     * repaint — the flicker `tui-input-flicker-fix` removed. It is also not a
-     * fallback and not a frame, so it touches neither counter.
-     */
-    repaint(): boolean;
-    /**
-     * Write bytes that are ours but are not a frame — today, the OSC 52 clipboard
-     * sequence (§4.4.5).
-     *
-     * The differ is invalidated first, because absolute addressing is only valid
-     * while nothing else writes to stdout, and one full repaint after a copy is the
-     * correct price.
-     *
-     * IT IS NOT A FALLBACK (P1-6 / I-13), and that is the whole reason this door
-     * exists rather than the caller reaching for `stdout.write`. `transform` cannot
-     * recognise an OSC 52 chunk, so through the proxy it would take
-     * `passThrough(true)` — which increments `fallbacks` and, on the first one,
-     * raises `onFirstFallback`, wired to `console.warn(FRAME_FALLBACK_NOTICE)`.
-     * The first copy of every session would print a diagnostic at a user who did
-     * nothing wrong, and `fallbacks` — documented to mean "something wrote to
-     * stdout behind Ink's back" — would stop being true for the rest of the run.
-     */
-    writeForeign(text: string): void;
-    /** Removes the `'resize'` subscription of I-8. Idempotent. */
-    dispose(): void;
-}
-export declare function wrapStdoutForFrames(stdout: NodeJS.WriteStream, differ: FrameDiffer): FrameWriterHandle;