@teaui/core 1.11.8 → 1.11.10

package/.dist/Buffer.d.ts

@@ -18,6 +18,11 @@ export declare class Buffer implements Terminal {
      * wrapping behavior).
      */
     writeChar(char: string, x: number, y: number, style: Style): void;
+    /**
+     * Fills a rectangular region with BG_DRAW cells lazily.
+     * The cells are materialized during flush or when overwritten by writeChar.
+     */
+    paintRect(style: Style, minX: number, minY: number, maxX: number, maxY: number): void;
     /**
      * Replaces the style of an existing cell without changing its character.
      * If no cell exists at (x, y), writes a space with the given style.

package/.dist/Buffer.js

@@ -2,11 +2,17 @@ import * as unicode from '@teaui/term';
 import { BG_DRAW } from './ansi.js';
 import { Style } from './Style.js';
 import { Size } from './geometry.js';
+const EMPTY_CELL = { char: ' ', style: Style.NONE, width: 1 };
 export class Buffer {
     size = Size.zero;
     #meta = '';
     #canvas = new Map();
     #prev = new Map();
+    #paintRects = [];
+    #prevPaintRects = [];
+    #dirtyRows = new Set();
+    #prevDirtyRows = new Set();
+    #mergeCache = new Map();
     setForeground(fg) { }
     setBackground(bg) { }
     resize(size) {
@@ -39,16 +45,17 @@ export class Buffer {
         if (x < 0 || x >= this.size.width || y < 0 || y >= this.size.height) {
             return;
         }
+        this.#dirtyRows.add(y);
         let line = this.#canvas.get(y);
         if (line) {
             const prev = line.get(x);
             if (prev?.char === BG_DRAW) {
-                const { foreground, background } = prev.style;
-                if (style.foreground === undefined) {
-                    style = style.merge({ foreground });
-                }
-                if (style.background === undefined) {
-                    style = style.merge({ background });
+                style = this.#mergeBackgroundStyle(style, prev.style);
+            }
+            else if (!prev) {
+                const paintStyle = this.#paintStyleAt(x, y);
+                if (paintStyle) {
+                    style = this.#mergeBackgroundStyle(style, paintStyle);
                 }
             }
             const leftChar = line.get(x - 1);
@@ -80,10 +87,95 @@ export class Buffer {
             }
         }
         else {
+            const paintStyle = this.#paintStyleAt(x, y);
+            if (paintStyle) {
+                style = this.#mergeBackgroundStyle(style, paintStyle);
+            }
             line = new Map([[x, { char, width, style }]]);
             this.#canvas.set(y, line);
         }
     }
+    /**
+     * Merges foreground/background from a background style into a text style,
+     * only when the text style is missing those properties. Single merge call.
+     */
+    #mergeBackgroundStyle(style, bgStyle) {
+        const needsFg = style.foreground === undefined && bgStyle.foreground !== undefined;
+        const needsBg = style.background === undefined && bgStyle.background !== undefined;
+        if (!needsFg && !needsBg) {
+            return style;
+        }
+        // Check cache
+        let bgCache = this.#mergeCache.get(bgStyle);
+        if (bgCache) {
+            const cached = bgCache.get(style);
+            if (cached)
+                return cached;
+        }
+        else {
+            bgCache = new Map();
+            this.#mergeCache.set(bgStyle, bgCache);
+        }
+        const merged = style.merge({
+            foreground: needsFg ? bgStyle.foreground : undefined,
+            background: needsBg ? bgStyle.background : undefined,
+        });
+        bgCache.set(style, merged);
+        return merged;
+    }
+    /**
+     * Fills a rectangular region with BG_DRAW cells lazily.
+     * The cells are materialized during flush or when overwritten by writeChar.
+     */
+    paintRect(style, minX, minY, maxX, maxY) {
+        const rMinX = Math.max(0, ~~minX);
+        const rMinY = Math.max(0, ~~minY);
+        const rMaxX = Math.min(this.size.width, ~~maxX);
+        const rMaxY = Math.min(this.size.height, ~~maxY);
+        // Clear canvas cells in this region so the lazy paint rect takes priority
+        // over content that was rendered before this paint call.
+        for (let y = rMinY; y < rMaxY; y++) {
+            const line = this.#canvas.get(y);
+            if (!line)
+                continue;
+            for (let x = rMinX; x < rMaxX; x++) {
+                line.delete(x);
+            }
+        }
+        this.#paintRects.push({
+            style,
+            cell: { char: BG_DRAW, width: 1, style },
+            minX: rMinX,
+            minY: rMinY,
+            maxX: rMaxX,
+            maxY: rMaxY,
+        });
+    }
+    /**
+     * Returns the paint style for coordinates that fall within a paint rect,
+     * checking most recent rects first.
+     */
+    #paintStyleAt(x, y) {
+        for (let i = this.#paintRects.length - 1; i >= 0; i--) {
+            const r = this.#paintRects[i];
+            if (x >= r.minX && x < r.maxX && y >= r.minY && y < r.maxY) {
+                return r.style;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Returns a pre-allocated Char for coordinates in a paint rect.
+     */
+    #paintCellAt(x, y) {
+        for (let i = this.#paintRects.length - 1; i >= 0; i--) {
+            const r = this.#paintRects[i];
+            if (x >= r.minX && x < r.maxX && y >= r.minY && y < r.maxY) {
+                return r.cell;
+            }
+        }
+        return undefined;
+    }
     /**
      * Replaces the style of an existing cell without changing its character.
      * If no cell exists at (x, y), writes a space with the given style.
@@ -94,6 +186,7 @@ export class Buffer {
         if (x < 0 || x >= this.size.width || y < 0 || y >= this.size.height) {
             return;
         }
+        this.#dirtyRows.add(y);
         let line = this.#canvas.get(y);
         if (!line) {
             line = new Map();
@@ -117,15 +210,34 @@ export class Buffer {
         if (this.#meta) {
             terminal.write(this.#meta);
         }
+        // Check if paint rects changed since last flush
+        const paintRectsChanged = !this.#paintRectsEqual(this.#paintRects, this.#prevPaintRects);
         let prevStyle = Style.NONE;
         for (let y = 0; y < this.size.height; y++) {
+            // Skip rows with no canvas writes (now or previously) and unchanged paint rects
+            if (!this.#dirtyRows.has(y) &&
+                !this.#prevDirtyRows.has(y) &&
+                !paintRectsChanged &&
+                this.#prev.has(y)) {
+                continue;
+            }
             const line = this.#canvas.get(y) ?? new Map();
             const prevLine = this.#prev.get(y) ?? new Map();
             this.#prev.set(y, prevLine);
+            // Pre-compute paint rects applicable to this row, newest first. There
+            // can be multiple disjoint paint rects on the same row (e.g. multiple
+            // themed calendars in a horizontal stack), so choose per-cell below.
+            const rowPaintRects = [];
+            for (let i = this.#paintRects.length - 1; i >= 0; i--) {
+                const r = this.#paintRects[i];
+                if (y >= r.minY && y < r.maxY) {
+                    rowPaintRects.push(r);
+                }
+            }
             let didWrite = false;
             let dx = 1;
             for (let x = 0; x < this.size.width; x += dx) {
-                const chrInfo = line.get(x) ?? { char: ' ', style: Style.NONE, width: 1 };
+                const chrInfo = line.get(x) ?? paintCellAt(rowPaintRects, x) ?? EMPTY_CELL;
                 const prevInfo = prevLine.get(x);
                 dx = chrInfo.width;
                 if (prevInfo && isCharEqual(chrInfo, prevInfo)) {
@@ -145,6 +257,10 @@ export class Buffer {
                     prevStyle = style;
                 }
                 terminal.write(char);
+                if (unicode.isAnnoyingWidth(char) &&
+                    x + chrInfo.width < this.size.width) {
+                    terminal.move(x + chrInfo.width, y);
+                }
                 prevLine.set(x, chrInfo);
                 if (chrInfo.width === 2) {
                     prevLine.delete(x + 1);
@@ -156,6 +272,33 @@ export class Buffer {
         }
         terminal.flush();
         this.#canvas = new Map();
+        this.#prevDirtyRows = this.#dirtyRows;
+        this.#dirtyRows = new Set();
+        this.#prevPaintRects = this.#paintRects;
+        this.#paintRects = [];
+    }
+    #paintRectsEqual(a, b) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            const ra = a[i];
+            const rb = b[i];
+            if (ra.minX !== rb.minX ||
+                ra.minY !== rb.minY ||
+                ra.maxX !== rb.maxX ||
+                ra.maxY !== rb.maxY ||
+                !ra.style.isEqual(rb.style)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+function paintCellAt(rects, x) {
+    for (const r of rects) {
+        if (x >= r.minX && x < r.maxX) {
+            return r.cell;
+        }
     }
 }
 function isCharEqual(lhs, rhs) {

package/.dist/Buffer.js.map

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

package/.dist/HeadlessProgram.d.ts

@@ -0,0 +1,24 @@
+import type { Program } from './types.js';
+import type { SystemEvent } from './events/index.js';
+import { StringTerminal } from './StringTerminal.js';
+/**
+ * A headless Program for offscreen rendering (screenshots, ANSI export).
+ * Wraps a StringTerminal and no-ops everything else.
+ */
+export declare class HeadlessProgram implements Program {
+    #private;
+    constructor({ cols, rows }: {
+        cols: number;
+        rows: number;
+    });
+    get terminal(): StringTerminal;
+    get cols(): number;
+    get rows(): number;
+    move(x: number, y: number): void;
+    write(str: string): void;
+    flush(): void;
+    setup(): void;
+    teardown(): void;
+    onEvents(_listener: (event: SystemEvent) => void): () => void;
+    onResize(_listener: () => void): () => void;
+}

package/.dist/HeadlessProgram.js

@@ -0,0 +1,41 @@
+import { StringTerminal } from './StringTerminal.js';
+/**
+ * A headless Program for offscreen rendering (screenshots, ANSI export).
+ * Wraps a StringTerminal and no-ops everything else.
+ */
+export class HeadlessProgram {
+    #terminal;
+    constructor({ cols, rows }) {
+        this.#terminal = new StringTerminal({ cols, rows });
+    }
+    get terminal() {
+        return this.#terminal;
+    }
+    // --- SGRTerminal interface ---
+    get cols() {
+        return this.#terminal.cols;
+    }
+    get rows() {
+        return this.#terminal.rows;
+    }
+    move(x, y) {
+        this.#terminal.move(x, y);
+    }
+    write(str) {
+        this.#terminal.write(str);
+    }
+    flush() {
+        this.#terminal.flush();
+    }
+    // --- Program lifecycle ---
+    setup() { }
+    teardown() { }
+    // --- Events ---
+    onEvents(_listener) {
+        return () => { };
+    }
+    onResize(_listener) {
+        return () => { };
+    }
+}
+//# sourceMappingURL=HeadlessProgram.js.map

package/.dist/HeadlessProgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadlessProgram.js","sourceRoot":"","sources":["../lib/HeadlessProgram.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAA;AAElD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B,SAAS,CAAgB;IAEzB,YAAY,EAAC,IAAI,EAAE,IAAI,EAA+B;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAA;IACnD,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED,gCAAgC;IAEhC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAA;IAC5B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAA;IAC5B,CAAC;IAED,IAAI,CAAC,CAAS,EAAE,CAAS;QACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IAED,4BAA4B;IAE5B,KAAK,KAAU,CAAC;IAChB,QAAQ,KAAU,CAAC;IAEnB,iBAAiB;IAEjB,QAAQ,CAAC,SAAuC;QAC9C,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;IAED,QAAQ,CAAC,SAAqB;QAC5B,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;CACF"}

package/.dist/{Theme.d.ts → Palette.d.ts}

@@ -14,7 +14,7 @@ interface Props {
     tableCheckedHighlight?: Color;
     emoji?: boolean;
 }
-export declare class Theme {
+export declare class Palette {
     textColor: Color;
     contrastTextColor: Color;
     dimTextColor: Color;
@@ -26,16 +26,16 @@ export declare class Theme {
     tableCheckedColor: Color;
     tableCheckedHighlightColor: Color;
     emoji: boolean;
-    static plain: Theme;
-    static primary: Theme;
-    static secondary: Theme;
-    static proceed: Theme;
-    static cancel: Theme;
-    static selected: Theme;
-    static red: Theme;
-    static green: Theme;
-    static blue: Theme;
-    static orange: Theme;
+    static plain: Palette;
+    static primary: Palette;
+    static secondary: Palette;
+    static proceed: Palette;
+    static cancel: Palette;
+    static selected: Palette;
+    static red: Palette;
+    static green: Palette;
+    static blue: Palette;
+    static orange: Palette;
     constructor({ text, contrastText, dimText, dimBackground, controlBackground, textBackground, highlight, darken, tableChecked, tableCheckedHighlight, emoji, }: Props);
     /**
      * "Ornament" is meant to draw decorative characters that disappear on hover/press
@@ -46,7 +46,7 @@ export declare class Theme {
         isOrnament?: boolean;
     }): Style;
     /**
-     * Creates a text style using the current theme.
+     * Creates a text style using the current purpose.
      *
      * Not all combinations are supported:
      * - isSelected and isPlaceholder revert to just isPlaceholder
@@ -58,6 +58,6 @@ export declare class Theme {
         isPlaceholder?: boolean;
         hasFocus?: boolean;
     }): Style;
-    merge(props: Partial<Props>): Theme;
+    merge(props: Partial<Props>): Palette;
 }
 export {};

package/.dist/{Theme.js → Palette.js}

@@ -3,7 +3,7 @@ const defaultText = 'default';
 const defaultContrastText = '#FFF(16)';
 const defaultDimText = '#808080(239)';
 const defaultDimBackground = '#434343(238)';
-export class Theme {
+export class Palette {
     textColor;
     contrastTextColor;
     dimTextColor;
@@ -15,7 +15,7 @@ export class Theme {
     tableCheckedColor;
     tableCheckedHighlightColor;
     emoji;
-    static plain = new Theme({
+    static plain = new Palette({
         controlBackground: '#4F4F4F(239)',
         textBackground: 'default',
         highlight: '#616161(241)',
@@ -23,7 +23,7 @@ export class Theme {
         tableChecked: '#3a2040',
         tableCheckedHighlight: '#4d2a55',
     });
-    static primary = new Theme({
+    static primary = new Palette({
         controlBackground: '#3B5EA7',
         textBackground: '#273F70',
         highlight: '#5A7AC2',
@@ -34,7 +34,7 @@ export class Theme {
         contrastText: '#5A7AC2',
         dimText: '#314F8C',
     });
-    static secondary = new Theme({
+    static secondary = new Palette({
         controlBackground: '#D0851C',
         textBackground: '#805211',
         highlight: '#D0924B',
@@ -45,7 +45,7 @@ export class Theme {
         contrastText: '#D0924B',
         dimText: '#A66A16',
     });
-    static proceed = new Theme({
+    static proceed = new Palette({
         controlBackground: '#4A7A5B',
         textBackground: '#2E4E3A',
         highlight: '#58A877',
@@ -56,7 +56,7 @@ export class Theme {
         contrastText: '#58A877',
         dimText: '#3D664C',
     });
-    static cancel = new Theme({
+    static cancel = new Palette({
         controlBackground: '#A04A4C',
         textBackground: '#5B282A',
         highlight: '#C46264',
@@ -67,7 +67,7 @@ export class Theme {
         contrastText: '#C46264',
         dimText: '#853D3F',
     });
-    static selected = new Theme({
+    static selected = new Palette({
         text: '#383838(236)',
         controlBackground: '#BDBDBD(250)',
         textBackground: '#BDBDBD(250)',
@@ -76,10 +76,10 @@ export class Theme {
         tableChecked: '#8fa1c8',
         tableCheckedHighlight: '#a7b8dc',
     });
-    static red = Theme.cancel;
-    static green = Theme.proceed;
-    static blue = Theme.primary;
-    static orange = Theme.secondary;
+    static red = Palette.cancel;
+    static green = Palette.proceed;
+    static blue = Palette.primary;
+    static orange = Palette.secondary;
     constructor({ text, contrastText, dimText, dimBackground, controlBackground, textBackground, highlight, darken, tableChecked, tableCheckedHighlight, emoji, }) {
         this.textColor = text ?? defaultText;
         this.contrastTextColor = contrastText ?? defaultContrastText;
@@ -89,9 +89,9 @@ export class Theme {
         this.textBackgroundColor = textBackground ?? controlBackground;
         this.highlightColor = highlight;
         this.darkenColor = darken;
-        this.tableCheckedColor = tableChecked ?? Theme.plain.tableCheckedColor;
+        this.tableCheckedColor = tableChecked ?? Palette.plain.tableCheckedColor;
         this.tableCheckedHighlightColor =
-            tableCheckedHighlight ?? Theme.plain.tableCheckedHighlightColor;
+            tableCheckedHighlight ?? Palette.plain.tableCheckedHighlightColor;
         this.emoji = emoji ?? true;
     }
     /**
@@ -124,7 +124,7 @@ export class Theme {
         }
     }
     /**
-     * Creates a text style using the current theme.
+     * Creates a text style using the current purpose.
      *
      * Not all combinations are supported:
      * - isSelected and isPlaceholder revert to just isPlaceholder
@@ -169,7 +169,7 @@ export class Theme {
         });
     }
     merge(props) {
-        return new Theme({
+        return new Palette({
             text: props.text ?? this.textColor,
             contrastText: props.contrastText ?? this.contrastTextColor,
             dimText: props.dimText ?? this.dimTextColor,
@@ -184,4 +184,4 @@ export class Theme {
         });
     }
 }
-//# sourceMappingURL=Theme.js.map
+//# sourceMappingURL=Palette.js.map

package/.dist/Palette.js.map

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

package/.dist/Screen.d.ts

@@ -1,15 +1,15 @@
 import { Terminal as TermTerminal } from '@teaui/term';
-import type { SGRTerminal } from './terminal.js';
 import type { Rect, Point } from './geometry.js';
+import { type Program } from './types.js';
 import { View } from './View.js';
 import type { HotKeyDef, KeyEvent, MouseEventListenerName, SystemEvent, SystemMouseEvent } from './events/index.js';
 import type { Modal } from './components/Modal.js';
 import { Window } from './components/Window.js';
-type KeyListener = (char: string, key: KeyEvent) => void;
 /**
  * Wraps @teaui/term's Terminal for use by Screen and the public API.
+ * Translates low-level terminal input into SystemEvents that Screen can consume.
  */
-export declare class TerminalProgram implements SGRTerminal {
+export declare class TerminalProgram implements Program {
     #private;
     constructor();
     get terminal(): TermTerminal;
@@ -18,22 +18,29 @@ export declare class TerminalProgram implements SGRTerminal {
     move(x: number, y: number): void;
     write(str: string): void;
     flush(): void;
-    enterFullscreen(): void;
-    exitFullscreen(): void;
-    clear(): void;
-    startInput(screen: Screen): void;
-    stopInput(): void;
+    setup(): void;
+    teardown(): void;
     /**
-     * Register a key binding.
-     * Pattern: 'escape', 'C-c', 'C-q', 'return', etc.
+     * Subscribe to translated system events from terminal input.
+     * Returns an unsubscribe function.
+     */
+    onEvents(listener: (event: SystemEvent) => void): () => void;
+    /**
+     * Subscribe to terminal resize events.
+     * Returns an unsubscribe function.
      */
-    key(pattern: string | string[], fn: KeyListener): void;
+    onResize(listener: () => void): () => void;
     /**
-     * Provide raw data listener (for iTerm2 etc.)
+     * Listen for raw data once (for iTerm2 proprietary escape sequences, etc.)
      */
-    once(event: string, fn: (...args: any[]) => void): void;
+    onceRawData(fn: (...args: any[]) => void): void;
 }
 type ViewConstructor<T extends View> = (program: TerminalProgram) => T | Promise<T>;
+/**
+ * A ViewConstructor that receives a Program (for use with Screen constructor directly).
+ */
+export type ProgramViewConstructor<T extends View> = (program: Program) => T | Promise<T>;
+type ScreenKeyListener = (char: string, key: KeyEvent) => void;
 export interface ScreenOptions {
     quitChar?: 'C-c' | 'C-q' | '' | undefined | false;
     emoji?: boolean;
@@ -45,16 +52,17 @@ interface ScreenEventMap {
 export declare class Screen {
     #private;
     rootView: View;
-    /**
-     * A helper function that puts the terminal into a "known good" state. I use this
-     * during debugging, if the app crashes and I need to get the terminal CLI working
-     * again.
-     */
-    static reset(): void;
     static start(): Promise<[Screen, TerminalProgram, Window]>;
     static start<T extends View>(viewConstructor: T | ViewConstructor<T>, opts?: Partial<ScreenOptions>): Promise<[Screen, TerminalProgram, T]>;
-    constructor(program: TerminalProgram, rootView: View);
+    constructor(program: Program, rootView: View, { isFocused }?: {
+        isFocused?: boolean;
+    });
     onExit(callback: () => void): void;
+    /**
+     * Register a key binding on the screen.
+     * Pattern: 'escape', 'C-c', 'C-q', 'return', etc.
+     */
+    key(pattern: string | string[], fn: ScreenKeyListener): void;
     /**
      * Called from Screen.start(). Don't call this yourself unless you wanted
      * to construct your own 'program'. I recommend starting with a
@@ -89,8 +97,6 @@ export declare class Screen {
      * Subscribe to a screen event. Returns an unsubscribe function.
      */
     on<K extends keyof ScreenEventMap>(event: K, listener: ScreenEventMap[K]): ScreenEventUnsubscribe;
-    nextFocus(): void;
-    prevFocus(): void;
     triggerKeyboard(event: KeyEvent): void;
     triggerPaste(text: string): void;
     /**
@@ -100,7 +106,11 @@ export declare class Screen {
     checkMouse(view: View, x: number, y: number): void;
     triggerMouse(systemEvent: SystemMouseEvent): void;
     registerTick(view: View): void;
-    triggerTick(dt: number): void;
+    /**
+     * Manually advance tick animations by `dt` milliseconds.
+     * Useful for testing animations without real timers.
+     */
+    tick(dt: number): void;
     preRender(view: View): void;
     /**
      * @return boolean Whether or not to rerender the view due to focus or mouse change