@termuijs/core 0.1.1 → 0.1.3

package/dist/index.d.cts

@@ -88,6 +88,11 @@ declare class Terminal {
     private _resizeHandlers;
     private _cleanupHandlers;
     private _originalRawMode;
+    private _resizeHandler;
+    private _exitHandler;
+    private _sigintHandler;
+    private _sigtermHandler;
+    private _restored;
     constructor(options?: TerminalOptions);
     /** Current terminal width in columns */
     get cols(): number;
@@ -109,6 +114,7 @@ declare class Terminal {
     onResize(handler: (cols: number, rows: number) => void): () => void;
     /**
      * Restore terminal to its original state.
+     * Removes all process signal handlers to prevent leaks.
      * Called automatically on SIGINT, SIGTERM, process exit.
      */
     restore(): void;
@@ -693,6 +699,52 @@ declare function createLayoutNode(id: string, style: Style, children?: LayoutNod
  */
 declare function computeLayout(root: LayoutNode, containerWidth: number, containerHeight: number): void;
 
+type Constraint = {
+    type: 'length';
+    value: number;
+} | {
+    type: 'percentage';
+    value: number;
+} | {
+    type: 'ratio';
+    num: number;
+    den: number;
+} | {
+    type: 'min';
+    value: number;
+} | {
+    type: 'max';
+    value: number;
+} | {
+    type: 'fill';
+    weight: number;
+};
+/** Exactly n cells. */
+declare const length: (n: number) => Constraint;
+/** n% of available space. */
+declare const percentage: (n: number) => Constraint;
+/** num/den of available space. */
+declare const ratio: (num: number, den: number) => Constraint;
+/** At least n cells. */
+declare const min: (n: number) => Constraint;
+/** At most n cells. */
+declare const max: (n: number) => Constraint;
+/** Fill remaining space with the given weight. Default weight: 1. */
+declare const fill: (weight?: number) => Constraint;
+/**
+ * Split a rectangle into sub-rectangles using constraints.
+ *
+ * Example:
+ * ```ts
+ * const [header, body, footer] = splitRect(
+ *     area,
+ *     [length(3), fill(), length(1)],
+ *     'vertical',
+ * );
+ * ```
+ */
+declare function splitRect(rect: Rect, constraints: Constraint[], direction?: 'horizontal' | 'vertical', gap?: number): Rect[];
+
 /**
  * Strongly-typed event emitter using TypeScript generics.
  * Supports `on`, `off`, `once`, `emit` with type-safe event maps.
@@ -839,6 +891,250 @@ declare class FocusManager {
     private _changeFocus;
 }
 
+interface BorderSet {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    cross: string;
+}
+declare const BorderSets: {
+    readonly PLAIN: {
+        readonly topLeft: "┌";
+        readonly topRight: "┐";
+        readonly bottomLeft: "└";
+        readonly bottomRight: "┘";
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly ROUNDED: {
+        readonly topLeft: "╭";
+        readonly topRight: "╮";
+        readonly bottomLeft: "╰";
+        readonly bottomRight: "╯";
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly DOUBLE: {
+        readonly topLeft: "╔";
+        readonly topRight: "╗";
+        readonly bottomLeft: "╚";
+        readonly bottomRight: "╝";
+        readonly horizontal: "═";
+        readonly vertical: "║";
+        readonly cross: "╬";
+    };
+    readonly THICK: {
+        readonly topLeft: "┏";
+        readonly topRight: "┓";
+        readonly bottomLeft: "┗";
+        readonly bottomRight: "┛";
+        readonly horizontal: "━";
+        readonly vertical: "┃";
+        readonly cross: "╋";
+    };
+    readonly QUADRANT_INSIDE: {
+        readonly topLeft: "▗";
+        readonly topRight: "▖";
+        readonly bottomLeft: "▝";
+        readonly bottomRight: "▘";
+        readonly horizontal: "▀";
+        readonly vertical: "▐";
+        readonly cross: "█";
+    };
+    readonly QUADRANT_OUTSIDE: {
+        readonly topLeft: "▛";
+        readonly topRight: "▜";
+        readonly bottomLeft: "▙";
+        readonly bottomRight: "▟";
+        readonly horizontal: "▀";
+        readonly vertical: "▌";
+        readonly cross: "█";
+    };
+    readonly EMPTY: {
+        readonly topLeft: " ";
+        readonly topRight: " ";
+        readonly bottomLeft: " ";
+        readonly bottomRight: " ";
+        readonly horizontal: " ";
+        readonly vertical: " ";
+        readonly cross: " ";
+    };
+};
+interface BarSet {
+    full: string;
+    sevenEighths: string;
+    threeQuarters: string;
+    fiveEighths: string;
+    half: string;
+    threeEighths: string;
+    oneQuarter: string;
+    oneEighth: string;
+    empty: string;
+}
+/**
+ * Vertical bar symbols: bottom-up block characters ▁▂▃▄▅▆▇█
+ * 9 levels (including empty) for sub-cell precision.
+ */
+declare const BarSets: {
+    readonly NINE_LEVELS: {
+        readonly full: "█";
+        readonly sevenEighths: "▇";
+        readonly threeQuarters: "▆";
+        readonly fiveEighths: "▅";
+        readonly half: "▄";
+        readonly threeEighths: "▃";
+        readonly oneQuarter: "▂";
+        readonly oneEighth: "▁";
+        readonly empty: " ";
+    };
+    readonly THREE_LEVELS: {
+        readonly full: "█";
+        readonly sevenEighths: "░";
+        readonly threeQuarters: "░";
+        readonly fiveEighths: "░";
+        readonly half: "▄";
+        readonly threeEighths: "░";
+        readonly oneQuarter: "░";
+        readonly oneEighth: "░";
+        readonly empty: " ";
+    };
+    readonly ASCII: {
+        readonly full: "#";
+        readonly sevenEighths: "#";
+        readonly threeQuarters: "#";
+        readonly fiveEighths: "#";
+        readonly half: "#";
+        readonly threeEighths: "-";
+        readonly oneQuarter: "-";
+        readonly oneEighth: "-";
+        readonly empty: " ";
+    };
+};
+/** Ordered vertical bar symbols from empty to full (9 levels). */
+declare const VERTICAL_BAR_SYMBOLS: readonly string[];
+/** Ordered horizontal bar symbols from empty to full (9 levels). */
+declare const HORIZONTAL_BAR_SYMBOLS: readonly string[];
+interface ScrollbarSet {
+    track: string;
+    thumb: string;
+    begin: string;
+    end: string;
+}
+declare const ScrollbarSets: {
+    readonly VERTICAL: {
+        readonly track: "│";
+        readonly thumb: "█";
+        readonly begin: "↑";
+        readonly end: "↓";
+    };
+    readonly HORIZONTAL: {
+        readonly track: "─";
+        readonly thumb: "█";
+        readonly begin: "←";
+        readonly end: "→";
+    };
+    readonly DOUBLE_VERTICAL: {
+        readonly track: "║";
+        readonly thumb: "▐";
+        readonly begin: "▲";
+        readonly end: "▼";
+    };
+    readonly DOUBLE_HORIZONTAL: {
+        readonly track: "═";
+        readonly thumb: "▌";
+        readonly begin: "◄";
+        readonly end: "►";
+    };
+};
+interface LineSet {
+    horizontal: string;
+    vertical: string;
+    cross: string;
+}
+declare const LineSets: {
+    readonly NORMAL: {
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly THICK: {
+        readonly horizontal: "━";
+        readonly vertical: "┃";
+        readonly cross: "╋";
+    };
+    readonly DOUBLE: {
+        readonly horizontal: "═";
+        readonly vertical: "║";
+        readonly cross: "╬";
+    };
+};
+declare const Shade: {
+    readonly FULL: "█";
+    readonly DARK: "▓";
+    readonly MEDIUM: "▒";
+    readonly LIGHT: "░";
+    readonly EMPTY: " ";
+};
+/** Unicode braille range offset (U+2800). */
+declare const BRAILLE_OFFSET = 10240;
+/**
+ * Braille dot bit positions.
+ * Each row is [leftBit, rightBit] for a 2-wide, 4-tall braille cell.
+ */
+declare const BRAILLE_DOTS: readonly (readonly [number, number])[];
+
+/**
+ * In-memory grid that captures rendered output.
+ * Use `createTestScreen()` to create one, render widgets into it,
+ * then call `testScreenToString()` to get a plain-text snapshot.
+ */
+interface TestScreen {
+    readonly width: number;
+    readonly height: number;
+    cells: Cell[][];
+}
+/**
+ * Create an in-memory test screen of the given dimensions.
+ * Every cell starts as empty (space character, default colors).
+ */
+declare function createTestScreen(width: number, height: number): TestScreen;
+/**
+ * Set a cell in the test screen at (x, y).
+ * Out-of-bounds writes are silently ignored.
+ */
+declare function testScreenSetCell(screen: TestScreen, x: number, y: number, cell: Cell): void;
+/**
+ * Get the cell at (x, y) in the test screen.
+ * Returns undefined for out-of-bounds coordinates.
+ */
+declare function testScreenGetCell(screen: TestScreen, x: number, y: number): Cell | undefined;
+/**
+ * Convert the test screen to a plain-text string.
+ * Each row becomes a line. Trailing spaces on each line are preserved.
+ *
+ * Example output:
+ * ```
+ * ┌Hello──┐
+ * │World  │
+ * └───────┘
+ * ```
+ */
+declare function testScreenToString(screen: TestScreen): string;
+/**
+ * Clear the test screen, resetting all cells to empty.
+ */
+declare function testScreenClear(screen: TestScreen): void;
+/**
+ * Write a string into the test screen starting at (x, y).
+ * Characters that fall outside the screen bounds are clipped.
+ */
+declare function testScreenSetString(screen: TestScreen, x: number, y: number, str: string): void;
+
 interface AppOptions extends TerminalOptions {
     /** Frames per second for the render loop */
     fps?: number;
@@ -848,6 +1144,8 @@ interface AppOptions extends TerminalOptions {
     mouse?: boolean;
     /** Force fallback (static) rendering */
     forceFallback?: boolean;
+    /** Skip fallback detection — always run interactively. Default: false */
+    skipFallback?: boolean;
     /** Title to set on the terminal window */
     title?: string;
 }
@@ -1078,4 +1376,4 @@ declare namespace ansi {
   export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline };
 }
 
-export { App, type AppOptions, BORDER_CHARS, type BorderChars, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type Size, type Style, Terminal, type TerminalOptions, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, defaultStyle, detectColorDepth, emptyCell, emptyRect, getBorderChars, intersectRect, isMouseSequence, mergeStyles, normalizeEdges, parseColor, parseMouseEvent, renderFallback, shouldUseFallback, shrinkRect, stringWidth, stripAnsi, styleToCellAttrs, truncate, unionRect, wordWrap };
+export { App, type AppOptions, BORDER_CHARS, BRAILLE_DOTS, BRAILLE_OFFSET, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, wordWrap };

package/dist/index.d.ts

@@ -88,6 +88,11 @@ declare class Terminal {
     private _resizeHandlers;
     private _cleanupHandlers;
     private _originalRawMode;
+    private _resizeHandler;
+    private _exitHandler;
+    private _sigintHandler;
+    private _sigtermHandler;
+    private _restored;
     constructor(options?: TerminalOptions);
     /** Current terminal width in columns */
     get cols(): number;
@@ -109,6 +114,7 @@ declare class Terminal {
     onResize(handler: (cols: number, rows: number) => void): () => void;
     /**
      * Restore terminal to its original state.
+     * Removes all process signal handlers to prevent leaks.
      * Called automatically on SIGINT, SIGTERM, process exit.
      */
     restore(): void;
@@ -693,6 +699,52 @@ declare function createLayoutNode(id: string, style: Style, children?: LayoutNod
  */
 declare function computeLayout(root: LayoutNode, containerWidth: number, containerHeight: number): void;
 
+type Constraint = {
+    type: 'length';
+    value: number;
+} | {
+    type: 'percentage';
+    value: number;
+} | {
+    type: 'ratio';
+    num: number;
+    den: number;
+} | {
+    type: 'min';
+    value: number;
+} | {
+    type: 'max';
+    value: number;
+} | {
+    type: 'fill';
+    weight: number;
+};
+/** Exactly n cells. */
+declare const length: (n: number) => Constraint;
+/** n% of available space. */
+declare const percentage: (n: number) => Constraint;
+/** num/den of available space. */
+declare const ratio: (num: number, den: number) => Constraint;
+/** At least n cells. */
+declare const min: (n: number) => Constraint;
+/** At most n cells. */
+declare const max: (n: number) => Constraint;
+/** Fill remaining space with the given weight. Default weight: 1. */
+declare const fill: (weight?: number) => Constraint;
+/**
+ * Split a rectangle into sub-rectangles using constraints.
+ *
+ * Example:
+ * ```ts
+ * const [header, body, footer] = splitRect(
+ *     area,
+ *     [length(3), fill(), length(1)],
+ *     'vertical',
+ * );
+ * ```
+ */
+declare function splitRect(rect: Rect, constraints: Constraint[], direction?: 'horizontal' | 'vertical', gap?: number): Rect[];
+
 /**
  * Strongly-typed event emitter using TypeScript generics.
  * Supports `on`, `off`, `once`, `emit` with type-safe event maps.
@@ -839,6 +891,250 @@ declare class FocusManager {
     private _changeFocus;
 }
 
+interface BorderSet {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    cross: string;
+}
+declare const BorderSets: {
+    readonly PLAIN: {
+        readonly topLeft: "┌";
+        readonly topRight: "┐";
+        readonly bottomLeft: "└";
+        readonly bottomRight: "┘";
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly ROUNDED: {
+        readonly topLeft: "╭";
+        readonly topRight: "╮";
+        readonly bottomLeft: "╰";
+        readonly bottomRight: "╯";
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly DOUBLE: {
+        readonly topLeft: "╔";
+        readonly topRight: "╗";
+        readonly bottomLeft: "╚";
+        readonly bottomRight: "╝";
+        readonly horizontal: "═";
+        readonly vertical: "║";
+        readonly cross: "╬";
+    };
+    readonly THICK: {
+        readonly topLeft: "┏";
+        readonly topRight: "┓";
+        readonly bottomLeft: "┗";
+        readonly bottomRight: "┛";
+        readonly horizontal: "━";
+        readonly vertical: "┃";
+        readonly cross: "╋";
+    };
+    readonly QUADRANT_INSIDE: {
+        readonly topLeft: "▗";
+        readonly topRight: "▖";
+        readonly bottomLeft: "▝";
+        readonly bottomRight: "▘";
+        readonly horizontal: "▀";
+        readonly vertical: "▐";
+        readonly cross: "█";
+    };
+    readonly QUADRANT_OUTSIDE: {
+        readonly topLeft: "▛";
+        readonly topRight: "▜";
+        readonly bottomLeft: "▙";
+        readonly bottomRight: "▟";
+        readonly horizontal: "▀";
+        readonly vertical: "▌";
+        readonly cross: "█";
+    };
+    readonly EMPTY: {
+        readonly topLeft: " ";
+        readonly topRight: " ";
+        readonly bottomLeft: " ";
+        readonly bottomRight: " ";
+        readonly horizontal: " ";
+        readonly vertical: " ";
+        readonly cross: " ";
+    };
+};
+interface BarSet {
+    full: string;
+    sevenEighths: string;
+    threeQuarters: string;
+    fiveEighths: string;
+    half: string;
+    threeEighths: string;
+    oneQuarter: string;
+    oneEighth: string;
+    empty: string;
+}
+/**
+ * Vertical bar symbols: bottom-up block characters ▁▂▃▄▅▆▇█
+ * 9 levels (including empty) for sub-cell precision.
+ */
+declare const BarSets: {
+    readonly NINE_LEVELS: {
+        readonly full: "█";
+        readonly sevenEighths: "▇";
+        readonly threeQuarters: "▆";
+        readonly fiveEighths: "▅";
+        readonly half: "▄";
+        readonly threeEighths: "▃";
+        readonly oneQuarter: "▂";
+        readonly oneEighth: "▁";
+        readonly empty: " ";
+    };
+    readonly THREE_LEVELS: {
+        readonly full: "█";
+        readonly sevenEighths: "░";
+        readonly threeQuarters: "░";
+        readonly fiveEighths: "░";
+        readonly half: "▄";
+        readonly threeEighths: "░";
+        readonly oneQuarter: "░";
+        readonly oneEighth: "░";
+        readonly empty: " ";
+    };
+    readonly ASCII: {
+        readonly full: "#";
+        readonly sevenEighths: "#";
+        readonly threeQuarters: "#";
+        readonly fiveEighths: "#";
+        readonly half: "#";
+        readonly threeEighths: "-";
+        readonly oneQuarter: "-";
+        readonly oneEighth: "-";
+        readonly empty: " ";
+    };
+};
+/** Ordered vertical bar symbols from empty to full (9 levels). */
+declare const VERTICAL_BAR_SYMBOLS: readonly string[];
+/** Ordered horizontal bar symbols from empty to full (9 levels). */
+declare const HORIZONTAL_BAR_SYMBOLS: readonly string[];
+interface ScrollbarSet {
+    track: string;
+    thumb: string;
+    begin: string;
+    end: string;
+}
+declare const ScrollbarSets: {
+    readonly VERTICAL: {
+        readonly track: "│";
+        readonly thumb: "█";
+        readonly begin: "↑";
+        readonly end: "↓";
+    };
+    readonly HORIZONTAL: {
+        readonly track: "─";
+        readonly thumb: "█";
+        readonly begin: "←";
+        readonly end: "→";
+    };
+    readonly DOUBLE_VERTICAL: {
+        readonly track: "║";
+        readonly thumb: "▐";
+        readonly begin: "▲";
+        readonly end: "▼";
+    };
+    readonly DOUBLE_HORIZONTAL: {
+        readonly track: "═";
+        readonly thumb: "▌";
+        readonly begin: "◄";
+        readonly end: "►";
+    };
+};
+interface LineSet {
+    horizontal: string;
+    vertical: string;
+    cross: string;
+}
+declare const LineSets: {
+    readonly NORMAL: {
+        readonly horizontal: "─";
+        readonly vertical: "│";
+        readonly cross: "┼";
+    };
+    readonly THICK: {
+        readonly horizontal: "━";
+        readonly vertical: "┃";
+        readonly cross: "╋";
+    };
+    readonly DOUBLE: {
+        readonly horizontal: "═";
+        readonly vertical: "║";
+        readonly cross: "╬";
+    };
+};
+declare const Shade: {
+    readonly FULL: "█";
+    readonly DARK: "▓";
+    readonly MEDIUM: "▒";
+    readonly LIGHT: "░";
+    readonly EMPTY: " ";
+};
+/** Unicode braille range offset (U+2800). */
+declare const BRAILLE_OFFSET = 10240;
+/**
+ * Braille dot bit positions.
+ * Each row is [leftBit, rightBit] for a 2-wide, 4-tall braille cell.
+ */
+declare const BRAILLE_DOTS: readonly (readonly [number, number])[];
+
+/**
+ * In-memory grid that captures rendered output.
+ * Use `createTestScreen()` to create one, render widgets into it,
+ * then call `testScreenToString()` to get a plain-text snapshot.
+ */
+interface TestScreen {
+    readonly width: number;
+    readonly height: number;
+    cells: Cell[][];
+}
+/**
+ * Create an in-memory test screen of the given dimensions.
+ * Every cell starts as empty (space character, default colors).
+ */
+declare function createTestScreen(width: number, height: number): TestScreen;
+/**
+ * Set a cell in the test screen at (x, y).
+ * Out-of-bounds writes are silently ignored.
+ */
+declare function testScreenSetCell(screen: TestScreen, x: number, y: number, cell: Cell): void;
+/**
+ * Get the cell at (x, y) in the test screen.
+ * Returns undefined for out-of-bounds coordinates.
+ */
+declare function testScreenGetCell(screen: TestScreen, x: number, y: number): Cell | undefined;
+/**
+ * Convert the test screen to a plain-text string.
+ * Each row becomes a line. Trailing spaces on each line are preserved.
+ *
+ * Example output:
+ * ```
+ * ┌Hello──┐
+ * │World  │
+ * └───────┘
+ * ```
+ */
+declare function testScreenToString(screen: TestScreen): string;
+/**
+ * Clear the test screen, resetting all cells to empty.
+ */
+declare function testScreenClear(screen: TestScreen): void;
+/**
+ * Write a string into the test screen starting at (x, y).
+ * Characters that fall outside the screen bounds are clipped.
+ */
+declare function testScreenSetString(screen: TestScreen, x: number, y: number, str: string): void;
+
 interface AppOptions extends TerminalOptions {
     /** Frames per second for the render loop */
     fps?: number;
@@ -848,6 +1144,8 @@ interface AppOptions extends TerminalOptions {
     mouse?: boolean;
     /** Force fallback (static) rendering */
     forceFallback?: boolean;
+    /** Skip fallback detection — always run interactively. Default: false */
+    skipFallback?: boolean;
     /** Title to set on the terminal window */
     title?: string;
 }
@@ -1078,4 +1376,4 @@ declare namespace ansi {
   export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline };
 }
 
-export { App, type AppOptions, BORDER_CHARS, type BorderChars, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type Size, type Style, Terminal, type TerminalOptions, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, defaultStyle, detectColorDepth, emptyCell, emptyRect, getBorderChars, intersectRect, isMouseSequence, mergeStyles, normalizeEdges, parseColor, parseMouseEvent, renderFallback, shouldUseFallback, shrinkRect, stringWidth, stripAnsi, styleToCellAttrs, truncate, unionRect, wordWrap };
+export { App, type AppOptions, BORDER_CHARS, BRAILLE_DOTS, BRAILLE_OFFSET, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, wordWrap };