@orion-agents/orion-code 0.1.0

package/dist/tui-core/style.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * TUI style model: normalized, renderer-independent text styling.
+ *
+ * Styles are semantic tokens resolved by theme at layout time; ANSI SGR
+ * codes are only emitted by the terminal row encoder. Layout never writes
+ * raw escape sequences.
+ *
+ * NO_COLOR / FORCE_COLOR are respected at the encoder level - style
+ * fields are preserved in the model but color output is suppressed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SGR_RESET = exports.DEFAULT_THEME = exports.DEFAULT_STYLE = void 0;
+exports.normalizeStyle = normalizeStyle;
+exports.styleKey = styleKey;
+exports.stylesEqual = stylesEqual;
+exports.shouldSuppressColor = shouldSuppressColor;
+exports.encodeStyleToSgr = encodeStyleToSgr;
+exports.sanitizeTerminalText = sanitizeTerminalText;
+/** Shared immutable default style (no formatting). */
+exports.DEFAULT_STYLE = {};
+/**
+ * Normalize a style: remove undefined/false fields, clamp indexed/rgb values.
+ * Returns a new frozen object. Used for frame diff comparison.
+ */
+function normalizeStyle(style) {
+    const result = {};
+    if (style.foreground) {
+        result.foreground = normalizeColor(style.foreground);
+    }
+    if (style.background) {
+        result.background = normalizeColor(style.background);
+    }
+    if (style.bold)
+        result.bold = true;
+    if (style.dim)
+        result.dim = true;
+    if (style.italic)
+        result.italic = true;
+    if (style.underline)
+        result.underline = true;
+    if (style.inverse)
+        result.inverse = true;
+    return result;
+}
+function normalizeColor(color) {
+    switch (color.kind) {
+        case 'named':
+            return color;
+        case 'indexed':
+            return { kind: 'indexed', value: Math.max(0, Math.min(255, Math.floor(color.value))) };
+        case 'rgb':
+            return {
+                kind: 'rgb',
+                r: Math.max(0, Math.min(255, Math.floor(color.r))),
+                g: Math.max(0, Math.min(255, Math.floor(color.g))),
+                b: Math.max(0, Math.min(255, Math.floor(color.b))),
+            };
+    }
+}
+/**
+ * Compute a stable string key for style comparison.
+ * Used in frame diff to detect style-only changes efficiently.
+ */
+function styleKey(style) {
+    const parts = [];
+    if (style.foreground)
+        parts.push(`fg:${colorKey(style.foreground)}`);
+    if (style.background)
+        parts.push(`bg:${colorKey(style.background)}`);
+    if (style.bold)
+        parts.push('b');
+    if (style.dim)
+        parts.push('d');
+    if (style.italic)
+        parts.push('i');
+    if (style.underline)
+        parts.push('u');
+    if (style.inverse)
+        parts.push('v');
+    return parts.join(',');
+}
+function colorKey(color) {
+    switch (color.kind) {
+        case 'named': return color.value;
+        case 'indexed': return `i${color.value}`;
+        case 'rgb': return `r${color.r}.${color.g}.${color.b}`;
+    }
+}
+/**
+ * Check if two styles are equivalent after normalization.
+ */
+function stylesEqual(a, b) {
+    return styleKey(normalizeStyle(a)) === styleKey(normalizeStyle(b));
+}
+/** Default dark-theme semantic tokens. */
+exports.DEFAULT_THEME = {
+    assistantText: {},
+    heading: { foreground: { kind: 'named', value: 'cyan' }, bold: true },
+    code: {
+        foreground: { kind: 'named', value: 'white' },
+        background: { kind: 'rgb', r: 31, g: 35, b: 42 },
+    },
+    diffAdded: { foreground: { kind: 'named', value: 'green' } },
+    diffRemoved: { foreground: { kind: 'named', value: 'red' } },
+    diffHunk: { foreground: { kind: 'named', value: 'cyan' }, dim: true },
+    warning: { foreground: { kind: 'named', value: 'yellow' } },
+    error: { foreground: { kind: 'named', value: 'red' } },
+    activityRunning: { foreground: { kind: 'named', value: 'yellow' } },
+    activitySuccess: { foreground: { kind: 'named', value: 'green' } },
+    activityFailed: { foreground: { kind: 'named', value: 'red' } },
+    muted: { dim: true },
+    userMarker: { foreground: { kind: 'rgb', r: 0, g: 96, b: 116 }, bold: true },
+    userText: { foreground: { kind: 'rgb', r: 32, g: 35, b: 40 } },
+    userBackground: { background: { kind: 'rgb', r: 218, g: 221, b: 226 } },
+    inlineCode: {
+        foreground: { kind: 'named', value: 'yellow' },
+        background: { kind: 'rgb', r: 43, g: 47, b: 54 },
+    },
+    link: { foreground: { kind: 'named', value: 'cyan' }, underline: true },
+    toolRunning: { foreground: { kind: 'named', value: 'yellow' } },
+    toolSuccess: { foreground: { kind: 'named', value: 'green' } },
+    toolError: { foreground: { kind: 'named', value: 'red' } },
+    toolSkipped: { dim: true },
+    toolName: { foreground: { kind: 'named', value: 'cyan' }, bold: true },
+    toolMeta: { foreground: { kind: 'named', value: 'white' }, dim: true },
+    systemText: { foreground: { kind: 'named', value: 'white' }, dim: true },
+    commandMarker: { foreground: { kind: 'named', value: 'cyan' }, bold: true },
+    commandText: { foreground: { kind: 'named', value: 'white' } },
+    statusText: { dim: true },
+};
+// ============================================================================
+// ANSI SGR encoder
+// ============================================================================
+/** Check if NO_COLOR is set or output is not a TTY. */
+function shouldSuppressColor() {
+    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== '')
+        return true;
+    if (process.env.FORCE_COLOR === '0')
+        return true;
+    return false;
+}
+/**
+ * Encode a TuiStyle into ANSI SGR parameters.
+ * Returns an empty string if style is default or color is suppressed.
+ * Row encoder must emit SGR0 (\x1b[0m) after each styled span.
+ */
+function encodeStyleToSgr(style, suppressColor = shouldSuppressColor()) {
+    const norm = normalizeStyle(style);
+    const params = [];
+    if (norm.bold)
+        params.push('1');
+    if (norm.dim)
+        params.push('2');
+    if (norm.italic)
+        params.push('3');
+    if (norm.underline)
+        params.push('4');
+    if (norm.inverse)
+        params.push('7');
+    if (!suppressColor) {
+        if (norm.foreground)
+            params.push(...encodeColorSgr(norm.foreground, '3', '38'));
+        if (norm.background)
+            params.push(...encodeColorSgr(norm.background, '4', '48'));
+    }
+    if (params.length === 0)
+        return '';
+    return `\x1b[${params.join(';')}m`;
+}
+function encodeColorSgr(color, baseSingle, baseExtended) {
+    switch (color.kind) {
+        case 'named': {
+            const map = {
+                black: 0, red: 1, green: 2, yellow: 3,
+                blue: 4, magenta: 5, cyan: 6, white: 7,
+            };
+            const code = map[color.value];
+            if (code === undefined)
+                return [];
+            const base = parseInt(baseSingle, 10) * 10;
+            return [`${base + code}`];
+        }
+        case 'indexed':
+            return [`${baseExtended};5;${color.value}`];
+        case 'rgb':
+            return [`${baseExtended};2;${color.r};${color.g};${color.b}`];
+    }
+}
+/** SGR reset sequence. */
+exports.SGR_RESET = '\x1b[0m';
+// ============================================================================
+// Sanitizer
+// ============================================================================
+/**
+ * Sanitize text for terminal display.
+ *
+ * Strips entire ANSI escape sequences (CSI, OSC, etc.) and all C0/C1 control
+ * characters except \n and \t. Tab is expanded to spaces before entering layout.
+ * This prevents model content from injecting ANSI control sequences.
+ */
+function sanitizeTerminalText(text, tabWidth = 2) {
+    let result = '';
+    let i = 0;
+    while (i < text.length) {
+        const codePoint = text.codePointAt(i);
+        if (codePoint === undefined)
+            break;
+        const char = String.fromCodePoint(codePoint);
+        // ESC (0x1b): strip the entire escape sequence that follows.
+        if (codePoint === 0x1b) {
+            i = skipEscapeSequence(text, i + 1);
+            continue;
+        }
+        if (char === '\n') {
+            result += '\n';
+        }
+        else if (char === '\t') {
+            result += ' '.repeat(tabWidth);
+        }
+        else if (codePoint < 0x20 || (codePoint >= 0x7f && codePoint < 0xa0)) {
+            // C0/C1 control: strip. This includes DEL (0x7f).
+        }
+        else {
+            result += char;
+        }
+        i += char.length;
+    }
+    return result;
+}
+/**
+ * Skip past an ANSI escape sequence body starting after the ESC byte.
+ * CSI: ESC [ params final-byte (0x40-0x7e)
+ * OSC: ESC ] data ST (BEL 0x07 or ESC backslash)
+ * Other: ESC + single intermediate/final byte
+ * Returns the index after the consumed sequence.
+ */
+function skipEscapeSequence(text, start) {
+    if (start >= text.length)
+        return start;
+    const next = text.charCodeAt(start);
+    if (next === 0x5b) {
+        // CSI: ESC [ - consume params until final byte (0x40-0x7e).
+        let i = start + 1;
+        while (i < text.length) {
+            const c = text.charCodeAt(i);
+            if (c >= 0x40 && c <= 0x7e)
+                return i + 1;
+            i += 1;
+        }
+        return i;
+    }
+    if (next === 0x5d) {
+        // OSC: ESC ] - consume until BEL (0x07) or ST (ESC backslash).
+        let i = start + 1;
+        while (i < text.length) {
+            const c = text.charCodeAt(i);
+            if (c === 0x07)
+                return i + 1;
+            if (c === 0x1b && i + 1 < text.length && text.charCodeAt(i + 1) === 0x5c)
+                return i + 2;
+            i += 1;
+        }
+        return i;
+    }
+    // Other escape (e.g. ESC =, ESC >): consume one byte.
+    return start + 1;
+}
+//# sourceMappingURL=style.js.map

package/dist/tui-core/style.js.map

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

package/dist/tui-core/terminal-writer.d.ts

@@ -0,0 +1,34 @@
+import { type TuiFrame, type TuiFrameDiff } from './frame';
+export interface TuiTerminalRenderResult {
+    output: string;
+    diff: TuiFrameDiff;
+}
+export interface TuiTerminalWriterOptions {
+    /**
+     * Hide the terminal cursor while row updates are written, then restore the
+     * frame-declared cursor state at the end of the batch.
+     */
+    bracketCursor?: boolean;
+    /**
+     * Disable terminal autowrap while painting exact-width rows. Writing a full
+     * border row into the last column can otherwise leave some terminals in a
+     * pending-wrap state, which makes the real cursor drift away from the input.
+     */
+    bracketAutoWrap?: boolean;
+}
+export declare class TuiTerminalWriter {
+    private readonly output;
+    private readonly options;
+    private previous;
+    constructor(output: Pick<NodeJS.WriteStream, 'write'>, options?: TuiTerminalWriterOptions);
+    render(frame: TuiFrame): TuiTerminalRenderResult;
+    reset(): void;
+}
+export declare function renderTerminalFrame(previous: TuiFrame | null, next: TuiFrame, options?: TuiTerminalWriterOptions): TuiTerminalRenderResult;
+export declare function moveTo(row: number, column: number): string;
+export declare function clearLine(): string;
+export declare function cursorHide(): string;
+export declare function cursorShow(): string;
+export declare function disableAutoWrap(): string;
+export declare function enableAutoWrap(): string;
+//# sourceMappingURL=terminal-writer.d.ts.map

package/dist/tui-core/terminal-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-writer.d.ts","sourceRoot":"","sources":["../../src/tui-core/terminal-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAyB;gBAGtB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EACzC,OAAO,GAAE,wBAA6B;IAGzD,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,uBAAuB;IAShD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAmDzB;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/tui-core/terminal-writer.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TuiTerminalWriter = void 0;
+exports.renderTerminalFrame = renderTerminalFrame;
+exports.moveTo = moveTo;
+exports.clearLine = clearLine;
+exports.cursorHide = cursorHide;
+exports.cursorShow = cursorShow;
+exports.disableAutoWrap = disableAutoWrap;
+exports.enableAutoWrap = enableAutoWrap;
+const frame_1 = require("./frame");
+const style_1 = require("./style");
+class TuiTerminalWriter {
+    constructor(output, options = {}) {
+        this.output = output;
+        this.options = options;
+        this.previous = null;
+    }
+    render(frame) {
+        const result = renderTerminalFrame(this.previous, frame, this.options);
+        if (result.output) {
+            this.output.write(result.output);
+        }
+        this.previous = cloneFrame(frame);
+        return result;
+    }
+    reset() {
+        this.previous = null;
+    }
+}
+exports.TuiTerminalWriter = TuiTerminalWriter;
+function renderTerminalFrame(previous, next, options = {}) {
+    const diff = (0, frame_1.diffTuiFrames)(previous, next);
+    const chunks = [];
+    const bracketCursor = options.bracketCursor ?? true;
+    const shouldPaint = diff.changedRows.length > 0 || diff.cursorChanged;
+    const bracketAutoWrap = options.bracketAutoWrap ?? true;
+    const suppressColor = (0, style_1.shouldSuppressColor)();
+    if (shouldPaint && bracketAutoWrap) {
+        chunks.push(disableAutoWrap());
+    }
+    if (bracketCursor && shouldPaint) {
+        chunks.push(cursorHide());
+    }
+    for (const rowIndex of diff.changedRows) {
+        chunks.push(moveTo(rowIndex, 0));
+        chunks.push(clearLine());
+        // Emit styled spans: SGR per span, SGR0 reset at end (only if styled).
+        const spans = (0, frame_1.renderStyledFrameRow)(next.rows[rowIndex] ?? []);
+        let emittedSgr = false;
+        for (const span of spans) {
+            const sgr = (0, style_1.encodeStyleToSgr)(span.style, suppressColor);
+            if (sgr) {
+                chunks.push(sgr);
+                emittedSgr = true;
+            }
+            chunks.push(span.text);
+        }
+        if (emittedSgr)
+            chunks.push(style_1.SGR_RESET);
+    }
+    if (diff.cursorChanged || diff.changedRows.length > 0) {
+        chunks.push(moveTo(next.cursor.row, next.cursor.column));
+    }
+    if (bracketCursor && shouldPaint) {
+        chunks.push(next.cursor.visible ? cursorShow() : cursorHide());
+    }
+    else if (diff.cursorChanged && !next.cursor.visible) {
+        chunks.push(cursorHide());
+    }
+    if (shouldPaint && bracketAutoWrap) {
+        chunks.push(enableAutoWrap());
+    }
+    return {
+        output: chunks.join(''),
+        diff,
+    };
+}
+function moveTo(row, column) {
+    return `\x1b[${Math.max(1, Math.floor(row) + 1)};${Math.max(1, Math.floor(column) + 1)}H`;
+}
+function clearLine() {
+    return '\x1b[2K';
+}
+function cursorHide() {
+    return '\x1b[?25l';
+}
+function cursorShow() {
+    return '\x1b[?25h';
+}
+function disableAutoWrap() {
+    return '\x1b[?7l';
+}
+function enableAutoWrap() {
+    return '\x1b[?7h';
+}
+function cloneFrame(frame) {
+    return {
+        width: frame.width,
+        height: frame.height,
+        cursor: { ...frame.cursor },
+        rows: frame.rows.map(row => row.map(cell => ({ ...cell }))),
+    };
+}
+//# sourceMappingURL=terminal-writer.js.map

package/dist/tui-core/terminal-writer.js.map

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

package/dist/tui-ui/inline-surface.d.ts

@@ -0,0 +1,191 @@
+/**
+ * InlineTerminalSurface: primary-screen inline TUI surface.
+ *
+ * Replaces the alternate-screen (1049) approach. Finalized transcript
+ * content is committed once to stdout (entering shell native scrollback),
+ * while the bottom live region holds only ephemeral content (streaming
+ * assistant, running tools, overlay, status, prompt).
+ *
+ * Control sequences used (relative addressing only):
+ *   CR       \r             return to column 0
+ *   EL2      \x1b[2K        erase current line
+ *   CUU(n)   \x1b[<n>A      cursor up (relative)
+ *   CUD(n)   \x1b[<n>B      cursor down (relative)
+ *   CUF(n)   \x1b[<n>C      cursor forward (relative)
+ *   SGR0     \x1b[0m        reset style
+ *   DECTCEM  \x1b[?25l/?25h hide/show cursor
+ *   DECAWM   \x1b[?7l/?7h   disable/enable autowrap (paint batch)
+ *
+ * Forbidden (never emitted):
+ *   \x1b[?1049h / \x1b[?1049l  (alternate screen)
+ *   CSI row;col H / f         (absolute cursor positioning)
+ *   CSI 2J                     (full screen clear)
+ *   mouse reporting, OSC52, OSC8
+ *
+ * All operations are serialized via an internal FIFO queue so commit,
+ * renderLive, resize, suspend, and unmount never interleave on the same stream.
+ */
+import { type TuiFrame } from '../tui-core/frame';
+/** Minimal output stream interface. */
+export type SurfaceOutputEvent = 'drain' | 'error' | 'close';
+export interface SurfaceOutput {
+    write(chunk: string | Uint8Array): boolean;
+    on(event: SurfaceOutputEvent, listener: (error?: unknown) => void): this;
+    off(event: SurfaceOutputEvent, listener: (error?: unknown) => void): this;
+    readonly writable: boolean;
+}
+export interface InlineSurfaceOptions {
+    output: SurfaceOutput;
+    /** Inject for deterministic tests. */
+    now?: () => number;
+}
+export type SurfacePhase = 'idle' | 'mounted' | 'suspended' | 'unmounted' | 'failed';
+export interface InlineSurfaceState {
+    phase: SurfacePhase;
+    width: number;
+    height: number;
+    /** Height of the bottom live band. */
+    liveBandRows: number;
+    /** Rows currently owned by the inline live block. */
+    liveRegionCapacity: number;
+    cursorRow: number;
+    cursorColumn: number;
+    previousFrame: TuiFrame | null;
+}
+/** A committed transcript entry rendered to styled rows. */
+export interface CommittedEntry {
+    displayKey: string;
+    rows: {
+        text: string;
+        style?: import('../tui-core/style').TuiStyle;
+    }[][];
+}
+export interface TranscriptCommitBatch {
+    batchId?: string;
+    generation: number;
+    reason: 'append' | 'finalize' | 'restore' | 'replace' | 'clear-divider';
+    entries: CommittedEntry[];
+}
+export interface TuiTerminalRenderResult {
+    output: string;
+    committedEntries: number;
+    batchId?: string;
+    generation?: number;
+    displayKeys?: string[];
+}
+/**
+ * Get the latest live frame for rendering after a commit.
+ * The runner provides this so commit + finalize interleaving uses fresh state.
+ */
+export type LiveFrameProvider = () => TuiFrame | null;
+export declare class InlineTerminalSurface {
+    private phase;
+    private width;
+    private height;
+    /** Height of the bottom live band (status + prompt + live tail). */
+    private liveBandRows;
+    private liveRegionCapacity;
+    private cursorRow;
+    private cursorColumn;
+    private previousFrame;
+    /** Suppress stale-width live paints between SIGWINCH and the resize repaint. */
+    private resizePending;
+    private pendingResizeWidth;
+    private resizeGeneration;
+    private resizeWaiters;
+    private readonly output;
+    private readonly now;
+    private readonly suppressColor;
+    /** Serialized FIFO queue of pending operations. */
+    private queue;
+    private processing;
+    constructor(options: InlineSurfaceOptions);
+    /** Compute the live band height (~75% of screen, min 8, max height-1). */
+    private static computeBandRows;
+    /** Live band height for the runner to size its live frame. */
+    getLiveBandRows(): number;
+    /** History area rows above the band (recently scrolled committed lines). */
+    get historyAreaRows(): number;
+    getState(): InlineSurfaceState;
+    /** Mark the terminal as resizing before the debounced layout pass runs. */
+    beginResize(width?: number): number;
+    /**
+     * Await completion of all queued operations.
+     * Because the queue is strictly FIFO, enqueueing a no-op and awaiting it
+     * guarantees every operation enqueued before this call has finished. Used by
+     * tests to deterministically observe the terminal after a burst of renders.
+     */
+    whenIdle(): Promise<void>;
+    /** Safe content width: never write the last column (avoid pending-wrap). */
+    get safeContentWidth(): number;
+    /** Enqueue an operation; FIFO guarantees no interleaving. */
+    private enqueue;
+    private drainQueue;
+    /** Mount: enable bracketed paste + hide cursor. NO alternate screen. */
+    mount(width: number, height: number): Promise<void>;
+    /**
+     * Commit finalized transcript entries to native scrollback.
+     *
+     * Protocol:
+     *  1. Erase only the live rows owned by this surface and return to their top.
+     *  2. Release that block and write finalized rows as ordinary line-oriented
+     *     shell output. The terminal decides when those lines enter scrollback.
+     *  3. Allocate a fresh live block from the resulting cursor and repaint the
+     *     latest live frame below the committed output.
+     */
+    commit(batch: TranscriptCommitBatch, getLatestLiveFrame: LiveFrameProvider): Promise<TuiTerminalRenderResult>;
+    /** Render the live region frame (relative addressing, changed-row diff). */
+    renderLive(frame: TuiFrame): Promise<string>;
+    /** Forget the diff baseline and repaint only the currently owned live region. */
+    forceRedraw(frame: TuiFrame): Promise<string>;
+    private renderLiveInternal;
+    /** Render a single styled frame row to ANSI chunks (text + SGR + reset). */
+    private renderRowChunks;
+    /** Stable string form of a styled row, used for changed-row comparison. */
+    private renderRowString;
+    private trimDefaultTrailingCells;
+    private renderedRowWidth;
+    /**
+     * Ensure the surface owns exactly `requiredRows` rows starting at the current
+     * cursor. Allocation uses ordinary newlines, so existing shell output is
+     * preserved and may naturally move into terminal scrollback.
+     */
+    private ensureCapacity;
+    /** Clear the live band rows (relative, no absolute addressing). */
+    private clearLiveRegion;
+    /**
+     * Clear the old live block after the terminal has already adopted a new
+     * width. A previously full row can occupy multiple physical rows after
+     * reflow, so tracked logical rows are not sufficient during resize.
+     */
+    private clearReflowedLiveRegion;
+    private clearOwnedLiveRegion;
+    private waitForResizeCompletion;
+    private completeResize;
+    private releaseLiveRegion;
+    /** Resize: erase only the owned block, then rebuild from the current cursor. */
+    resize(width: number, height: number, getLatestLiveFrame: LiveFrameProvider, generation?: number): Promise<void>;
+    /** Suspend for child process: clear live region, disable bracketed paste, show cursor. */
+    suspend(): Promise<void>;
+    /** Restore after child process: re-enable bracketed paste, rebuild live frame. */
+    restore(getLatestLiveFrame: LiveFrameProvider, width?: number, height?: number): Promise<void>;
+    /** Unmount: clear live region, restore terminal state. Does NOT erase scrollback. */
+    unmount(): Promise<void>;
+    /** Flush: wait for queue to drain. Yields to I/O between checks. */
+    flush(): Promise<void>;
+    private writeRaw;
+    /** Reset for tests. */
+    reset(): void;
+}
+export declare class MemoryOutput implements SurfaceOutput {
+    chunks: string[];
+    writable: boolean;
+    private drainListeners;
+    write(chunk: string | Uint8Array): boolean;
+    on(event: SurfaceOutputEvent, listener: (error?: unknown) => void): this;
+    off(event: SurfaceOutputEvent, listener: (error?: unknown) => void): this;
+    text(): string;
+    /** Assert output never contains forbidden sequences. */
+    assertNoForbidden(): void;
+}
+//# sourceMappingURL=inline-surface.d.ts.map

package/dist/tui-ui/inline-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-surface.d.ts","sourceRoot":"","sources":["../../src/tui-ui/inline-surface.ts"],"names":[],"mappings":"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"}