@teaui/term 0.1.0

package/.dist/sgr.js

@@ -0,0 +1,160 @@
+/**
+ * Parse blessed-style descriptor strings into ANSI escape codes.
+ * Replaces BlessedProgram.prototype.style / _attr.
+ *
+ * Supports:
+ *   Attributes: "bold", "dim", "italic", "underline", "strikeout", "blink", "inverse", "invisible"
+ *   Negated:    "!bold", "!dim", etc.
+ *   Named fg:   "red fg", "brightBlue fg", "gray fg", "default fg"
+ *   Named bg:   "red bg", "brightBlue bg", "gray bg", "default bg"
+ *   Hex fg/bg:  "#ff0000 fg", "#ff0000(196) fg", "#aabb00 bg"
+ *   SGR index:  "196 fg", "232 bg"
+ *   Combined:   ["bold", "red fg"] or "bold, red fg"
+ *   Default:    "default"
+ */
+import * as colors from './colors.js';
+const CSI = '\x1b[';
+// Attribute on/off codes
+const attrOn = {
+    default: `${CSI}m`,
+    bold: `${CSI}1m`,
+    dim: `${CSI}2m`,
+    italic: `${CSI}3m`,
+    underline: `${CSI}4m`,
+    ul: `${CSI}4m`,
+    underlined: `${CSI}4m`,
+    blink: `${CSI}5m`,
+    inverse: `${CSI}7m`,
+    invisible: `${CSI}8m`,
+    strikeout: `${CSI}9m`,
+};
+const attrOff = {
+    default: '',
+    bold: `${CSI}22m`,
+    dim: `${CSI}22m`,
+    italic: `${CSI}23m`,
+    underline: `${CSI}24m`,
+    ul: `${CSI}24m`,
+    underlined: `${CSI}24m`,
+    blink: `${CSI}25m`,
+    inverse: `${CSI}27m`,
+    invisible: `${CSI}28m`,
+    strikeout: `${CSI}29m`,
+};
+// Named color → SGR code
+const namedFg = {
+    black: 30, red: 31, green: 32, yellow: 33,
+    blue: 34, magenta: 35, cyan: 36, white: 37,
+    brightBlack: 90, grey: 90, gray: 90, brightGrey: 37, brightGray: 37,
+    brightRed: 91, brightGreen: 92, brightYellow: 93,
+    brightBlue: 94, brightMagenta: 95, brightCyan: 96, brightWhite: 97,
+};
+const namedBg = {
+    black: 40, red: 41, green: 42, yellow: 43,
+    blue: 44, magenta: 45, cyan: 46, white: 47,
+    brightBlack: 100, grey: 100, gray: 100, brightGrey: 47, brightGray: 47,
+    brightRed: 101, brightGreen: 102, brightYellow: 103,
+    brightBlue: 104, brightMagenta: 105, brightCyan: 106, brightWhite: 107,
+};
+function parseSingle(param, enabled) {
+    // Negation prefix
+    if (param.startsWith('!')) {
+        return parseSingle(param.slice(1), !enabled);
+    }
+    // Simple attributes
+    if (attrOn[param] !== undefined) {
+        return enabled ? attrOn[param] : (attrOff[param] ?? '');
+    }
+    // "default fg bg"
+    if (param === 'default fg bg') {
+        return enabled ? `${CSI}39;49m` : '';
+    }
+    // "color fg" or "color bg"
+    const fgbgMatch = /^(.+)\s+(fg|bg)$/.exec(param);
+    if (fgbgMatch) {
+        const [, colorStr, fgbg] = fgbgMatch;
+        // "default fg" / "default bg"
+        if (colorStr === 'default') {
+            if (!enabled)
+                return '';
+            return fgbg === 'fg' ? `${CSI}39m` : `${CSI}49m`;
+        }
+        // Named color
+        const namedMap = fgbg === 'fg' ? namedFg : namedBg;
+        if (namedMap[colorStr] !== undefined) {
+            if (!enabled)
+                return fgbg === 'fg' ? `${CSI}39m` : `${CSI}49m`;
+            return `${CSI}${namedMap[colorStr]}m`;
+        }
+        // Hex color: "#rrggbb fg" or "#rrggbb(index) fg"
+        if (colorStr.startsWith('#')) {
+            if (!enabled)
+                return fgbg === 'fg' ? `${CSI}39m` : `${CSI}49m`;
+            const hex = colorStr.replace(/\(\d+\)$/, '');
+            const [r, g, b] = colors.hexToRGB(hex);
+            return fgbg === 'fg'
+                ? `${CSI}38;2;${r};${g};${b}m`
+                : `${CSI}48;2;${r};${g};${b}m`;
+        }
+        // Numeric SGR index: "196 fg"
+        const colorNum = parseInt(colorStr, 10);
+        if (!isNaN(colorNum)) {
+            if (!enabled || colorNum === -1) {
+                return fgbg === 'fg' ? `${CSI}39m` : `${CSI}49m`;
+            }
+            if (colorNum < 8) {
+                return `${CSI}${colorNum + (fgbg === 'fg' ? 30 : 40)}m`;
+            }
+            else if (colorNum < 16) {
+                return `${CSI}${colorNum - 8 + (fgbg === 'fg' ? 90 : 100)}m`;
+            }
+            return fgbg === 'fg'
+                ? `${CSI}38;5;${colorNum}m`
+                : `${CSI}48;5;${colorNum}m`;
+        }
+    }
+    // Raw numeric codes: "38;5;196"
+    if (/^[\d;]*$/.test(param)) {
+        return `${CSI}${param}m`;
+    }
+    return '';
+}
+/**
+ * Convert blessed-style descriptor(s) to ANSI escape sequence.
+ *
+ * @example
+ *   parseStyleDescriptor('bold')              // '\x1b[1m'
+ *   parseStyleDescriptor('!bold')             // '\x1b[22m'
+ *   parseStyleDescriptor(['bold', 'red fg'])  // '\x1b[1;31m'
+ *   parseStyleDescriptor('bold, red fg')      // '\x1b[1;31m'
+ */
+export function parseStyleDescriptor(param) {
+    let parts;
+    if (Array.isArray(param)) {
+        parts = param;
+    }
+    else {
+        parts = param.split(/\s*[,;]\s*/);
+    }
+    if (parts.length === 0)
+        return '';
+    if (parts.length === 1) {
+        return parseSingle(parts[0], true);
+    }
+    // Multiple parts: combine into single CSI sequence
+    const used = new Set();
+    const codes = [];
+    for (const part of parts) {
+        const code = parseSingle(part, true);
+        // Extract the numeric portion between CSI and 'm'
+        const inner = code.slice(2, -1);
+        if (inner === '' || used.has(inner))
+            continue;
+        used.add(inner);
+        codes.push(inner);
+    }
+    if (codes.length === 0)
+        return '';
+    return `${CSI}${codes.join(';')}m`;
+}
+//# sourceMappingURL=sgr.js.map

package/.dist/sgr.js.map

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

package/.dist/style.d.ts

@@ -0,0 +1,25 @@
+import type { Color } from './types.js';
+interface StyleEntry {
+    open: string;
+    close: string;
+}
+export declare class StyleBuilder {
+    private readonly entries;
+    constructor(entries?: readonly StyleEntry[]);
+    private add;
+    bold(): StyleBuilder;
+    dim(): StyleBuilder;
+    italic(): StyleBuilder;
+    underline(): StyleBuilder;
+    blink(): StyleBuilder;
+    inverse(): StyleBuilder;
+    hidden(): StyleBuilder;
+    strikethrough(): StyleBuilder;
+    fg(color: Color): StyleBuilder;
+    bg(color: Color): StyleBuilder;
+    open(): string;
+    close(): string;
+    wrap(text: string): string;
+}
+export {};
+//# sourceMappingURL=style.d.ts.map

package/.dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,YAAY,CAAA;AAGtD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,OAAO,GAAE,SAAS,UAAU,EAAO;IAI/C,OAAO,CAAC,GAAG;IAIX,IAAI,IAAI,YAAY;IAIpB,GAAG,IAAI,YAAY;IAInB,MAAM,IAAI,YAAY;IAItB,SAAS,IAAI,YAAY;IAIzB,KAAK,IAAI,YAAY;IAIrB,OAAO,IAAI,YAAY;IAIvB,MAAM,IAAI,YAAY;IAItB,aAAa,IAAI,YAAY;IAI7B,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IAI9B,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IAI9B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,MAAM;IAOf,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG3B"}

package/.dist/style.js

@@ -0,0 +1,53 @@
+import { fgColor, fgReset, bgColor, bgReset, textAttr, textAttrOff } from './ansi.js';
+export class StyleBuilder {
+    entries;
+    constructor(entries = []) {
+        this.entries = entries;
+    }
+    add(open, close) {
+        return new StyleBuilder([...this.entries, { open, close }]);
+    }
+    bold() {
+        return this.add(textAttr('bold'), textAttrOff('bold'));
+    }
+    dim() {
+        return this.add(textAttr('dim'), textAttrOff('dim'));
+    }
+    italic() {
+        return this.add(textAttr('italic'), textAttrOff('italic'));
+    }
+    underline() {
+        return this.add(textAttr('underline'), textAttrOff('underline'));
+    }
+    blink() {
+        return this.add(textAttr('blink'), textAttrOff('blink'));
+    }
+    inverse() {
+        return this.add(textAttr('inverse'), textAttrOff('inverse'));
+    }
+    hidden() {
+        return this.add(textAttr('hidden'), textAttrOff('hidden'));
+    }
+    strikethrough() {
+        return this.add(textAttr('strikethrough'), textAttrOff('strikethrough'));
+    }
+    fg(color) {
+        return this.add(fgColor(color), fgReset());
+    }
+    bg(color) {
+        return this.add(bgColor(color), bgReset());
+    }
+    open() {
+        return this.entries.map((e) => e.open).join('');
+    }
+    close() {
+        return [...this.entries]
+            .reverse()
+            .map((e) => e.close)
+            .join('');
+    }
+    wrap(text) {
+        return this.open() + text + this.close();
+    }
+}
+//# sourceMappingURL=style.js.map

package/.dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAOrF,MAAM,OAAO,YAAY;IACN,OAAO,CAAuB;IAE/C,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEO,GAAG,CAAC,IAAY,EAAE,KAAa;QACrC,OAAO,IAAI,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IACxD,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;IACtD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAA;IAClE,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,EAAE,CAAC,KAAY;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,EAAE,CAAC,KAAY;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;aACrB,OAAO,EAAE;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACnB,IAAI,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;IAC1C,CAAC;CACF"}

package/.dist/terminal.d.ts

@@ -0,0 +1,84 @@
+import type { Color, ScreenSize, ColorSupport, TerminalOptions, FullscreenOptions, InputEvent, ImageOptions, UnderlineStyle } from './types.js';
+import { StyleBuilder } from './style.js';
+export declare class Terminal {
+    private output;
+    private input;
+    private cursorCtrl;
+    private screenCtrl;
+    private inputReader;
+    private screenBuffer;
+    private useBuffer;
+    private styleOpen;
+    private wasRawMode;
+    private resizeCleanup;
+    private writeBuffer;
+    constructor(options?: TerminalOptions);
+    private _write;
+    /**
+     * Enable write buffering. All writes are collected in memory until
+     * `flushWrites()` is called, which emits them as a single `output.write()`.
+     */
+    enableWriteBuffer(): this;
+    /**
+     * Flush buffered writes to the output stream as a single write call.
+     * No-op when write buffering is not enabled.
+     */
+    flushWrites(): this;
+    private addAttr;
+    bold(): this;
+    dim(): this;
+    italic(): this;
+    underline(): this;
+    strikethrough(): this;
+    inverse(): this;
+    fg(color: Color): this;
+    bg(color: Color): this;
+    reset(): this;
+    write(text: string): this;
+    writeln(text: string): this;
+    /** Write directly to the output stream, bypassing the buffer. */
+    writeRaw(text: string): this;
+    moveTo(x: number, y: number): this;
+    moveBy(dx: number, dy: number): this;
+    saveCursor(): this;
+    restoreCursor(): this;
+    showCursor(): this;
+    hideCursor(): this;
+    get size(): ScreenSize;
+    /** Number of columns. Alias for `size.columns`. */
+    get cols(): number;
+    /** Number of rows. Alias for `size.rows`. */
+    get rows(): number;
+    get colorSupport(): ColorSupport;
+    onResize(cb: (size: ScreenSize) => void): () => void;
+    clear(): this;
+    /**
+     * Flush the screen buffer — diffs against the previous frame and writes
+     * only changed cells. Uses synchronized output to prevent tearing.
+     * No-op when buffer mode is disabled.
+     */
+    flush(): this;
+    enterFullscreen(options?: FullscreenOptions): this;
+    exitFullscreen(): this;
+    onInput(cb: (event: InputEvent) => void): () => void;
+    /**
+     * Listen for raw data on stdin. Useful for reading proprietary escape
+     * sequence responses (e.g. iTerm2 background color query).
+     */
+    onRawData(cb: (data: Buffer) => void): () => void;
+    /**
+     * Listen for raw data once, then remove the listener.
+     */
+    onceRawData(cb: (data: Buffer) => void): void;
+    link(url: string, text: string): this;
+    image(data: Buffer, options?: ImageOptions): this;
+    beginSync(): this;
+    endSync(): this;
+    sync(fn: () => void): this;
+    underlineStyle(style: UnderlineStyle): this;
+    underlineColor(color: Color): this;
+    title(title: string): this;
+    notify(title: string, body?: string): this;
+    style(): StyleBuilder;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/.dist/terminal.d.ts.map

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

package/.dist/terminal.js

@@ -0,0 +1,325 @@
+import * as ansi from './ansi.js';
+import { CursorController } from './cursor.js';
+import { ScreenController, detectColorSupport } from './screen.js';
+import { InputReader } from './input.js';
+import { StyleBuilder } from './style.js';
+import { ScreenBuffer } from './buffer.js';
+import { itermImage, kittyImage, detectImageProtocol } from './image.js';
+import * as modern from './modern.js';
+export class Terminal {
+    output;
+    input;
+    cursorCtrl;
+    screenCtrl;
+    inputReader;
+    screenBuffer = null;
+    useBuffer;
+    styleOpen = [];
+    wasRawMode = false;
+    resizeCleanup = null;
+    writeBuffer = null;
+    constructor(options = {}) {
+        const stdout = options.stdout ?? process.stdout;
+        this.output = stdout;
+        this.input = (options.stdin ?? process.stdin);
+        this.useBuffer = options.buffer ?? false;
+        const write = (s) => {
+            this._write(s);
+        };
+        this.cursorCtrl = new CursorController(write);
+        this.screenCtrl = new ScreenController(write);
+        this.inputReader = new InputReader();
+        if (this.useBuffer) {
+            const { columns, rows } = this.size;
+            this.screenBuffer = new ScreenBuffer(columns, rows);
+        }
+    }
+    // --- Low-level write (respects write-buffer) ---
+    _write(s) {
+        if (this.writeBuffer) {
+            this.writeBuffer.push(s);
+        }
+        else {
+            this.output.write(s);
+        }
+    }
+    /**
+     * Enable write buffering. All writes are collected in memory until
+     * `flushWrites()` is called, which emits them as a single `output.write()`.
+     */
+    enableWriteBuffer() {
+        if (!this.writeBuffer) {
+            this.writeBuffer = [];
+        }
+        return this;
+    }
+    /**
+     * Flush buffered writes to the output stream as a single write call.
+     * No-op when write buffering is not enabled.
+     */
+    flushWrites() {
+        if (this.writeBuffer && this.writeBuffer.length > 0) {
+            this.output.write(this.writeBuffer.join(''));
+            this.writeBuffer = [];
+        }
+        return this;
+    }
+    // --- Style (mutable state, returns this) ---
+    addAttr(attr) {
+        this.styleOpen.push(ansi.textAttr(attr));
+        return this;
+    }
+    bold() {
+        return this.addAttr('bold');
+    }
+    dim() {
+        return this.addAttr('dim');
+    }
+    italic() {
+        return this.addAttr('italic');
+    }
+    underline() {
+        return this.addAttr('underline');
+    }
+    strikethrough() {
+        return this.addAttr('strikethrough');
+    }
+    inverse() {
+        return this.addAttr('inverse');
+    }
+    fg(color) {
+        this.styleOpen.push(ansi.fgColor(color));
+        return this;
+    }
+    bg(color) {
+        this.styleOpen.push(ansi.bgColor(color));
+        return this;
+    }
+    reset() {
+        this.styleOpen = [];
+        return this;
+    }
+    // --- Output ---
+    write(text) {
+        const style = this.styleOpen.join('');
+        this.styleOpen = [];
+        if (this.screenBuffer) {
+            this.screenBuffer.write(text, style);
+        }
+        else if (style) {
+            this._write(style + text + ansi.resetAll());
+        }
+        else {
+            this._write(text);
+        }
+        return this;
+    }
+    writeln(text) {
+        this.write(text);
+        if (this.screenBuffer) {
+            this.screenBuffer.write('\n', '');
+        }
+        else {
+            this._write('\n');
+        }
+        return this;
+    }
+    /** Write directly to the output stream, bypassing the buffer. */
+    writeRaw(text) {
+        this.styleOpen = [];
+        this.output.write(text);
+        return this;
+    }
+    // --- Cursor delegation ---
+    moveTo(x, y) {
+        if (this.screenBuffer) {
+            this.screenBuffer.moveTo(x, y);
+        }
+        else {
+            this.cursorCtrl.moveTo(x, y);
+        }
+        return this;
+    }
+    moveBy(dx, dy) {
+        this.cursorCtrl.moveBy(dx, dy);
+        return this;
+    }
+    saveCursor() {
+        this.cursorCtrl.save();
+        return this;
+    }
+    restoreCursor() {
+        this.cursorCtrl.restore();
+        return this;
+    }
+    showCursor() {
+        this.cursorCtrl.show();
+        return this;
+    }
+    hideCursor() {
+        this.cursorCtrl.hide();
+        return this;
+    }
+    // --- Screen delegation ---
+    get size() {
+        return {
+            columns: this.output.columns ?? 80,
+            rows: this.output.rows ?? 24,
+        };
+    }
+    /** Number of columns. Alias for `size.columns`. */
+    get cols() {
+        return this.size.columns;
+    }
+    /** Number of rows. Alias for `size.rows`. */
+    get rows() {
+        return this.size.rows;
+    }
+    get colorSupport() {
+        return detectColorSupport();
+    }
+    onResize(cb) {
+        const handler = () => cb(this.size);
+        process.stdout.on('resize', handler);
+        return () => {
+            process.stdout.removeListener('resize', handler);
+        };
+    }
+    clear() {
+        if (this.screenBuffer) {
+            this.screenBuffer.clear();
+        }
+        else {
+            this.screenCtrl.clear();
+        }
+        return this;
+    }
+    /**
+     * Flush the screen buffer — diffs against the previous frame and writes
+     * only changed cells. Uses synchronized output to prevent tearing.
+     * No-op when buffer mode is disabled.
+     */
+    flush() {
+        if (this.screenBuffer) {
+            this.screenBuffer.flush((s) => this.output.write(s));
+        }
+        return this;
+    }
+    enterFullscreen(options) {
+        this.screenCtrl.enterFullscreen(options);
+        if (this.input) {
+            this.inputReader.attach(this.input);
+            // Enable raw mode so we get character-by-character input
+            const stream = this.input;
+            if (typeof stream.isTTY !== 'undefined' && stream.isTTY) {
+                if (typeof stream.setRawMode === 'function') {
+                    this.wasRawMode = stream.isRaw ?? false;
+                    stream.setRawMode(true);
+                }
+                if (typeof stream.resume === 'function') {
+                    stream.resume();
+                }
+            }
+        }
+        // Resize buffer to match screen and track future resizes
+        if (this.screenBuffer) {
+            const { columns, rows } = this.size;
+            this.screenBuffer.resize(columns, rows);
+            this.resizeCleanup = this.onResize(({ columns, rows }) => {
+                this.screenBuffer?.resize(columns, rows);
+            });
+        }
+        return this;
+    }
+    exitFullscreen() {
+        this.screenCtrl.exitFullscreen();
+        this.inputReader.detach();
+        if (this.resizeCleanup) {
+            this.resizeCleanup();
+            this.resizeCleanup = null;
+        }
+        // Restore raw mode to previous state
+        if (this.input) {
+            const stream = this.input;
+            if (typeof stream.setRawMode === 'function') {
+                stream.setRawMode(this.wasRawMode);
+            }
+        }
+        return this;
+    }
+    // --- Input ---
+    onInput(cb) {
+        return this.inputReader.onInput(cb);
+    }
+    /**
+     * Listen for raw data on stdin. Useful for reading proprietary escape
+     * sequence responses (e.g. iTerm2 background color query).
+     */
+    onRawData(cb) {
+        if (!this.input)
+            throw new Error('No input stream');
+        const handler = (data) => cb(data);
+        this.input.on('data', handler);
+        return () => {
+            this.input.removeListener('data', handler);
+        };
+    }
+    /**
+     * Listen for raw data once, then remove the listener.
+     */
+    onceRawData(cb) {
+        if (!this.input)
+            throw new Error('No input stream');
+        this.input.once('data', cb);
+    }
+    // --- Modern features ---
+    link(url, text) {
+        this._write(modern.hyperlink(url, text));
+        return this;
+    }
+    image(data, options) {
+        const protocol = detectImageProtocol();
+        if (protocol === 'kitty') {
+            this._write(kittyImage(data, options));
+        }
+        else if (protocol === 'iterm') {
+            this._write(itermImage(data, options));
+        }
+        return this;
+    }
+    beginSync() {
+        this._write(modern.syncStart());
+        return this;
+    }
+    endSync() {
+        this._write(modern.syncEnd());
+        return this;
+    }
+    sync(fn) {
+        this.beginSync();
+        fn();
+        this.endSync();
+        return this;
+    }
+    underlineStyle(style) {
+        this.styleOpen.push(modern.styledUnderline(style));
+        return this;
+    }
+    underlineColor(color) {
+        this.styleOpen.push(modern.underlineColor(color));
+        return this;
+    }
+    title(title) {
+        this._write(modern.setTitle(title));
+        return this;
+    }
+    notify(title, body) {
+        this._write(modern.notification(title, body));
+        return this;
+    }
+    // --- Standalone style builder ---
+    style() {
+        return new StyleBuilder();
+    }
+}
+//# sourceMappingURL=terminal.js.map