tuiuiu.js 0.1.1

package/dist/core/buffer.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Advanced Cell Buffer System
+ *
+ * Features:
+ * - Structured cell attributes (color, style as data, not strings)
+ * - Buffer diffing for delta rendering
+ * - Damage tracking for partial updates
+ * - Double buffering for flicker-free rendering
+ * - Buffer pooling for memory efficiency
+ *
+ *
+ */
+/** Text style attributes stored as flags for efficient comparison */
+export interface CellAttrs {
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    blink?: boolean;
+    inverse?: boolean;
+    hidden?: boolean;
+    strikethrough?: boolean;
+}
+/** Color can be: named, hex, rgb, or ANSI 256 */
+export type Color = string | {
+    r: number;
+    g: number;
+    b: number;
+} | {
+    ansi256: number;
+};
+/** A single terminal cell */
+export interface Cell {
+    /** The character (can be multi-byte for emoji/CJK) */
+    char: string;
+    /** Foreground color */
+    fg?: Color;
+    /** Background color */
+    bg?: Color;
+    /** Text attributes */
+    attrs: CellAttrs;
+    /** True if this cell is occupied by a wide char from previous cell */
+    isWide?: boolean;
+}
+/** A rectangular region that needs updating */
+export interface DamageRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Represents a change between two buffers */
+export interface CellPatch {
+    x: number;
+    y: number;
+    cell: Cell;
+}
+/** Create an empty cell */
+export declare function createCell(char?: string, fg?: Color, bg?: Color, attrs?: CellAttrs): Cell;
+/** Create a default empty cell */
+export declare function emptyCell(): Cell;
+/** Compare two colors for equality */
+export declare function colorEquals(a?: Color, b?: Color): boolean;
+/** Compare two cell attributes for equality */
+export declare function attrsEquals(a: CellAttrs, b: CellAttrs): boolean;
+/** Compare two cells for equality */
+export declare function cellEquals(a: Cell, b: Cell): boolean;
+/** Clone a cell */
+export declare function cloneCell(cell: Cell): Cell;
+/**
+ * A 2D grid of cells with damage tracking
+ */
+export declare class CellBuffer {
+    private cells;
+    private damageRects;
+    readonly width: number;
+    readonly height: number;
+    constructor(width: number, height: number);
+    /** Get cell at position */
+    get(x: number, y: number): Cell | undefined;
+    /** Set cell at position */
+    set(x: number, y: number, cell: Cell): void;
+    /** Write a character at position */
+    writeChar(x: number, y: number, char: string, fg?: Color, bg?: Color, attrs?: CellAttrs): void;
+    /** Write a string starting at position */
+    writeString(x: number, y: number, text: string, fg?: Color, bg?: Color, attrs?: CellAttrs): number;
+    /** Fill a rectangle with a cell */
+    fill(x: number, y: number, width: number, height: number, cell: Cell): void;
+    /** Clear the buffer with empty cells */
+    clear(): void;
+    /** Copy content from another buffer */
+    copyFrom(source: CellBuffer, srcX?: number, srcY?: number, dstX?: number, dstY?: number, width?: number, height?: number): void;
+    /** Add a damage rectangle */
+    addDamage(x: number, y: number, width: number, height: number): void;
+    /** Get all damage rectangles */
+    getDamage(): DamageRect[];
+    /** Clear damage tracking */
+    clearDamage(): void;
+    /** Check if any damage exists */
+    hasDamage(): boolean;
+    /** Merge overlapping damage rectangles for efficiency */
+    consolidateDamage(): DamageRect[];
+    /**
+     * Calculate patches needed to transform this buffer into target buffer
+     * Returns only cells that differ between buffers
+     */
+    diff(target: CellBuffer): CellPatch[];
+    /**
+     * Apply patches to this buffer
+     */
+    applyPatches(patches: CellPatch[]): void;
+    /** Iterate over all cells */
+    [Symbol.iterator](): Generator<{
+        x: number;
+        y: number;
+        cell: Cell;
+    }>;
+    /** Iterate over rows */
+    rows(): Generator<{
+        y: number;
+        cells: Cell[];
+    }>;
+}
+/**
+ * Double buffer for flicker-free rendering
+ *
+ * Maintains front (displayed) and back (being drawn) buffers.
+ * After drawing, swap() makes back buffer visible and old front becomes new back.
+ */
+export declare class DoubleBuffer {
+    private front;
+    private back;
+    readonly width: number;
+    readonly height: number;
+    constructor(width: number, height: number);
+    /** Get the back buffer for drawing */
+    getBackBuffer(): CellBuffer;
+    /** Get the front buffer (currently displayed) */
+    getFrontBuffer(): CellBuffer;
+    /** Swap front and back buffers, return patches for what changed */
+    swap(): CellPatch[];
+    /** Resize both buffers (clears content) */
+    resize(width: number, height: number): void;
+}
+/**
+ * Pool of reusable buffers to reduce allocations
+ */
+export declare class BufferPool {
+    private pool;
+    private maxPoolSize;
+    /** Get or create a buffer of specified size */
+    acquire(width: number, height: number): CellBuffer;
+    /** Return a buffer to the pool for reuse */
+    release(buffer: CellBuffer): void;
+    /** Clear all pooled buffers */
+    clear(): void;
+    /** Get pool statistics */
+    stats(): {
+        sizes: string[];
+        totalBuffers: number;
+    };
+}
+/** Convert a Color to ANSI escape code */
+export declare function colorToAnsi(color: Color | undefined, background: boolean): string;
+/** Convert cell attributes to ANSI codes */
+export declare function attrsToAnsi(attrs: CellAttrs): string[];
+/** Convert a cell to ANSI string with style */
+export declare function cellToAnsi(cell: Cell): string;
+/**
+ * Convert a CellBuffer to ANSI string (optimized for output)
+ */
+export declare function bufferToAnsi(buffer: CellBuffer): string;
+/**
+ * Generate ANSI commands for applying patches (delta rendering)
+ *
+ * Uses cursor positioning to only update changed cells
+ */
+export declare function patchesToAnsi(patches: CellPatch[], width: number): string;
+//# sourceMappingURL=buffer.d.ts.map

package/dist/core/buffer.d.ts.map

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