@jrichman/ink 6.5.1-beta.5 → 6.5.1-beta.7

package/build/styled-lines.js

@@ -0,0 +1,110 @@
+/**
+ * A highly optimized representation of styled characters for terminal rendering.
+ * Replaces arrays of `StyledChar` objects with parallel arrays to eliminate
+ * massive GC overhead during large layout and scroll updates.
+ */
+export class StyledLines {
+    values = [];
+    fullWidths = [];
+    styles = [];
+    get length() {
+        return this.values.length;
+    }
+    set length(value) {
+        this.values.length = value;
+        this.fullWidths.length = value;
+        this.styles.length = value;
+    }
+    push(value, fullWidth, styles) {
+        this.values.push(value);
+        this.fullWidths.push(fullWidth);
+        this.styles.push(styles);
+    }
+    pushChar(char) {
+        this.values.push(char.value);
+        this.fullWidths.push(char.fullWidth || false);
+        this.styles.push(char.styles || []);
+    }
+    pushLine(other) {
+        for (let i = 0; i < other.length; i++) {
+            this.values.push(other.values[i]);
+            this.fullWidths.push(other.fullWidths[i]);
+            this.styles.push(other.styles[i]);
+        }
+    }
+    slice(start, end) {
+        const result = new StyledLines();
+        result.values = this.values.slice(start, end);
+        result.fullWidths = this.fullWidths.slice(start, end);
+        result.styles = this.styles.slice(start, end);
+        return result;
+    }
+    splice(start, deleteCount, ...items) {
+        const result = new StyledLines();
+        result.values = this.values.splice(start, deleteCount, ...items.map(i => i.value));
+        result.fullWidths = this.fullWidths.splice(start, deleteCount, ...items.map(i => i.fullWidth || false));
+        result.styles = this.styles.splice(start, deleteCount, ...items.map(i => i.styles || []));
+        return result;
+    }
+    *[Symbol.iterator]() {
+        for (let i = 0; i < this.length; i++) {
+            yield {
+                type: 'char',
+                value: this.values[i],
+                fullWidth: this.fullWidths[i],
+                styles: this.styles[i],
+            };
+        }
+    }
+    entries() {
+        let i = 0;
+        return {
+            [Symbol.iterator]() {
+                return this;
+            },
+            next: () => {
+                if (i >= this.length)
+                    return { done: true, value: undefined };
+                const val = [i, this.at(i)];
+                i++;
+                return { done: false, value: val };
+            },
+        };
+    }
+    map(callbackfn, thisArg) {
+        const result = [];
+        for (let i = 0; i < this.length; i++) {
+            result.push(callbackfn.call(thisArg, this.at(i), i, this));
+        }
+        return result;
+    }
+    indexOf(searchElement, fromIndex = 0) {
+        for (let i = fromIndex; i < this.length; i++) {
+            if (this.values[i] === searchElement.value &&
+                this.fullWidths[i] === searchElement.fullWidth)
+                return i;
+        }
+        return -1;
+    }
+    at(index) {
+        if (index < 0) {
+            index = this.length + index;
+        }
+        if (index < 0 || index >= this.length)
+            return undefined;
+        return {
+            type: 'char',
+            value: this.values[index],
+            fullWidth: this.fullWidths[index],
+            styles: this.styles[index],
+        };
+    }
+    clone() {
+        const result = new StyledLines();
+        result.values = [...this.values];
+        result.fullWidths = [...this.fullWidths];
+        result.styles = [...this.styles];
+        return result;
+    }
+}
+//# sourceMappingURL=styled-lines.js.map

package/build/styled-lines.js.map

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

package/build/terminal-writer.d.ts

@@ -0,0 +1,69 @@
+import { type StyledChar } from '@alcalzone/ansi-tokenize';
+export declare const rainbowColors: string[];
+export type RenderLine = {
+    styledChars: StyledChar[];
+    text: string;
+    length: number;
+    tainted: boolean;
+};
+export declare function linesEqual(lineA: StyledChar[] | undefined, lineB: StyledChar[] | undefined): boolean;
+export declare class TerminalWriter {
+    private columns;
+    private rows;
+    private readonly stdout;
+    isTainted: boolean;
+    debugRainbowColor?: string;
+    private screen;
+    private backbuffer;
+    private cursorX;
+    private cursorY;
+    private scrollRegionTop;
+    private scrollRegionBottom;
+    private firstRender;
+    private readonly enableSynchronizedOutput;
+    private cancelSlowFlush;
+    private outputBuffer;
+    private currentChunkBuffer;
+    constructor(columns: number, rows: number, stdout: NodeJS.WriteStream);
+    unkownCursorLocation(): void;
+    getBackbufferLength(): number;
+    getBackbufferEntry(index: number): RenderLine | undefined;
+    getScreenLine(y: number): RenderLine | undefined;
+    get isFirstRender(): boolean;
+    /**
+     * Append lines to the backbuffer leaving the on screen content unchanged.
+     */
+    appendLinesBackbuffer(lines: RenderLine[]): void;
+    updateBackbuffer(start: number, deleteCount: number, newLines: RenderLine[]): void;
+    writeLines(lines: RenderLine[]): void;
+    moveCursor(x: number, y: number): void;
+    clampLine(line: StyledChar[], width: number): RenderLine;
+    syncLine(line: RenderLine, y: number): void;
+    /**
+     * Trigger a scroll up of content into the backbuffer.
+     */
+    private applyScrollUpBackbuffer;
+    private applyScrollUp;
+    private applyScrollDown;
+    private performScroll;
+    scrollLines(options: {
+        start: number;
+        end: number;
+        linesToScroll: number;
+        lines: RenderLine[];
+        direction: 'up' | 'down';
+        scrollToBackbuffer: boolean;
+    }): void;
+    resize(columns: number, rows: number): void;
+    clear(): void;
+    startSynchronizedOutput(): void;
+    endSynchronizedOutput(): void;
+    flush(): void;
+    slowFlush(): Promise<void>;
+    validateLinesConsistent(lines: RenderLine[]): void;
+    private synchronizedWrite;
+    private resetScrollRegion;
+    private setScrollRegion;
+    private writeHelper;
+    private finishChunk;
+}