@kingkoo1985/ink 6.6.6

package/build/worker/compositor.js

@@ -0,0 +1,308 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { calculateScrollbarThumb } from '../measure-element.js';
+import { renderScrollbar } from '../render-scrollbar.js';
+import { getBackgroundColorEscape } from '../colorize.js';
+/**
+ * Handles rendering of various UI elements onto a Canvas.
+ */
+export class Compositor {
+    options;
+    static lastBackgroundColor;
+    static lastBackgroundStyles;
+    constructor(options) {
+        this.options = options;
+    }
+    drawContent(canvas, region, absX, absY, clip) {
+        const scrollTop = region.scrollTop ?? 0;
+        const scrollLeft = region.scrollLeft ?? 0;
+        const isOpaque = Boolean(region.opaque) || Boolean(region.backgroundColor);
+        for (let sy = clip.y; sy < clip.y + clip.h; sy++) {
+            if (sy < 0 || sy >= canvas.height) {
+                continue;
+            }
+            const dy = sy - absY;
+            const contentY = Math.round(scrollTop + dy);
+            const line = region.lines[contentY];
+            if (!line) {
+                continue;
+            }
+            const startSx = Math.round(clip.x);
+            const endSx = Math.round(clip.x + clip.w);
+            for (let sx = startSx; sx < endSx; sx++) {
+                if (sx < 0 || sx >= canvas.width) {
+                    continue;
+                }
+                const dx = sx - absX;
+                const contentX = scrollLeft + dx;
+                if (contentX < line.length) {
+                    const val = line.getValue(contentX);
+                    const isEmpty = val === ' ' && !line.hasStyles(contentX);
+                    if (isEmpty) {
+                        if (!isOpaque) {
+                            continue;
+                        }
+                        if (region.backgroundColor) {
+                            const bgColor = this.getBackgroundStyles(region.backgroundColor);
+                            if (bgColor) {
+                                canvas.setChar(sx, sy, val, line.getFormatFlags(contentX), line.getFgColor(contentX), bgColor, line.getLink(contentX));
+                                continue;
+                            }
+                        }
+                    }
+                    canvas.setChar(sx, sy, val, line.getFormatFlags(contentX), line.getFgColor(contentX), line.getBgColor(contentX), line.getLink(contentX));
+                }
+            }
+        }
+    }
+    drawStickyHeaders(canvas, region, absX, absY, clip) {
+        if (this.options.skipStickyHeaders) {
+            return;
+        }
+        const scrollTop = region.scrollTop ?? 0;
+        for (const header of region.stickyHeaders) {
+            const useStuckPosition = this.isHeaderStuck(header, absY, scrollTop, region);
+            // ONLY draw if stuck. Natural versions are already in the background buffer.
+            if (!useStuckPosition) {
+                continue;
+            }
+            const linesToRender = header.stuckLines ?? header.lines;
+            let headerY = absY + header.y;
+            const headerH = linesToRender.length;
+            if (this.options.stickyHeadersInBackbuffer &&
+                region.overflowToBackbuffer) {
+                if (header.type === 'top') {
+                    if (headerY < 0 && absY + region.height > 0) {
+                        headerY = 0;
+                    }
+                }
+                else if (header.type === 'bottom') {
+                    const stuckPos = this.options.canvasHeight -
+                        (header.stuckLines ?? header.lines).length;
+                    if (headerY > stuckPos && absY < stuckPos + headerH) {
+                        headerY = stuckPos;
+                    }
+                }
+            }
+            // Clamp to maxStuckY / minStuckY
+            if (header.type === 'top' && header.maxStuckY !== undefined) {
+                const absoluteMaxStuckY = absY + header.maxStuckY;
+                if (headerY > absoluteMaxStuckY) {
+                    headerY = absoluteMaxStuckY;
+                }
+            }
+            else if (header.type === 'bottom' && header.minStuckY !== undefined) {
+                const absoluteMinStuckY = absY + header.minStuckY;
+                if (headerY < absoluteMinStuckY) {
+                    headerY = absoluteMinStuckY;
+                }
+            }
+            for (let i = 0; i < headerH; i++) {
+                const sy = Math.round(headerY + i);
+                // If header is within the region's clip (standard behavior)
+                const withinRegionClip = sy >= clip.y && sy < clip.y + clip.h;
+                // If header is above/below the region and we want sticky headers there
+                const aboveRegionAndStickyEnabled = header.type === 'top' &&
+                    absY < 0 &&
+                    this.options.stickyHeadersInBackbuffer &&
+                    region.overflowToBackbuffer &&
+                    sy >= 0 &&
+                    sy < Math.min(canvas.height, absY + region.height);
+                const belowRegionAndStickyEnabled = header.type === 'bottom' &&
+                    absY + region.height > this.options.canvasHeight &&
+                    this.options.stickyHeadersInBackbuffer &&
+                    region.overflowToBackbuffer &&
+                    sy >= Math.max(0, absY) &&
+                    sy < this.options.canvasHeight;
+                if (!withinRegionClip &&
+                    !aboveRegionAndStickyEnabled &&
+                    !belowRegionAndStickyEnabled) {
+                    continue;
+                }
+                if (sy < 0 || sy >= canvas.height) {
+                    continue;
+                }
+                const line = linesToRender[i];
+                if (!line) {
+                    continue;
+                }
+                const headerX = Math.round(header.x + absX);
+                const headerW = Math.round(line.length);
+                const hx1 = Math.max(headerX, clip.x);
+                const hx2 = Math.min(headerX + headerW, clip.x + clip.w);
+                for (let sx = hx1; sx < hx2; sx++) {
+                    const cx = sx - headerX;
+                    if (cx < line.length) {
+                        canvas.setChar(sx, sy, line.getValue(cx), line.getFormatFlags(cx), line.getFgColor(cx), line.getBgColor(cx), line.getLink(cx));
+                    }
+                }
+            }
+        }
+    }
+    drawScrollbars(canvas, region, absX, absY, clip) {
+        if (Boolean(this.options.skipScrollbars && region.overflowToBackbuffer) ||
+            !region.isScrollable ||
+            region.scrollbarVisible === false) {
+            return;
+        }
+        const scrollTop = region.scrollTop ?? 0;
+        const scrollLeft = region.scrollLeft ?? 0;
+        const scrollHeight = region.scrollHeight ?? 0;
+        const scrollWidth = region.scrollWidth ?? 0;
+        const isVerticalScrollbarVisible = (region.isVerticallyScrollable ?? false) && scrollHeight > region.height;
+        const isHorizontalScrollbarVisible = (region.isHorizontallyScrollable ?? false) && scrollWidth > region.width;
+        if (isVerticalScrollbarVisible) {
+            let scrollPosition = scrollTop;
+            const targetScrollTop = this.options.targetScrollTops.get(region.id);
+            if (this.options.animatedScroll &&
+                targetScrollTop !== undefined &&
+                targetScrollTop !== scrollTop) {
+                const wasAtEnd = this.options.regionWasAtEnd.get(region.id);
+                const isTargetAtEnd = targetScrollTop >= scrollHeight - region.height;
+                if (wasAtEnd && isTargetAtEnd) {
+                    scrollPosition = targetScrollTop;
+                }
+            }
+            const { startIndex, endIndex, thumbStartHalf, thumbEndHalf } = calculateScrollbarThumb({
+                scrollbarDimension: region.height,
+                clientDimension: region.height,
+                scrollDimension: scrollHeight,
+                scrollPosition,
+                axis: 'vertical',
+            });
+            const barX = absX + region.width - 1 - (region.marginRight ?? 0);
+            renderScrollbar({
+                layout: {
+                    x: barX,
+                    y: absY,
+                    width: 1,
+                    height: region.height,
+                    thumb: {
+                        x: barX,
+                        y: absY + startIndex,
+                        width: 1,
+                        height: endIndex - startIndex,
+                        start: startIndex,
+                        end: endIndex,
+                        startHalf: thumbStartHalf,
+                        endHalf: thumbEndHalf,
+                    },
+                },
+                clip,
+                axis: 'vertical',
+                color: region.scrollbarThumbColor,
+                setChar(x, y, value, formatFlags, fgColor, bgColor, link) {
+                    canvas.setChar(x, y, value, formatFlags, fgColor, bgColor, link);
+                },
+                getExistingChar(x, y) {
+                    return canvas.getChar(x, y);
+                },
+            });
+        }
+        if (isHorizontalScrollbarVisible) {
+            const scrollbarWidth = region.width - (isVerticalScrollbarVisible ? 1 : 0);
+            const { startIndex, endIndex, thumbStartHalf, thumbEndHalf } = calculateScrollbarThumb({
+                scrollbarDimension: scrollbarWidth,
+                clientDimension: region.width,
+                scrollDimension: scrollWidth,
+                scrollPosition: scrollLeft,
+                axis: 'horizontal',
+            });
+            const barY = absY + region.height - 1 - (region.marginBottom ?? 0);
+            renderScrollbar({
+                layout: {
+                    x: absX,
+                    y: barY,
+                    width: scrollbarWidth,
+                    height: 1,
+                    thumb: {
+                        x: absX + startIndex,
+                        y: barY,
+                        width: endIndex - startIndex,
+                        height: 1,
+                        start: startIndex,
+                        end: endIndex,
+                        startHalf: thumbStartHalf,
+                        endHalf: thumbEndHalf,
+                    },
+                },
+                clip,
+                axis: 'horizontal',
+                color: region.scrollbarThumbColor,
+                setChar(x, y, value, formatFlags, fgColor, bgColor, link) {
+                    canvas.setChar(x, y, value, formatFlags, fgColor, bgColor, link);
+                },
+                getExistingChar(x, y) {
+                    return canvas.getChar(x, y);
+                },
+            });
+        }
+    }
+    isHeaderStuck(header, absY, scrollTop, region) {
+        const isStuckState = header.type === 'bottom'
+            ? Math.round(header.naturalRow - scrollTop + header.lines.length) >=
+                Math.round(header.y + (header.stuckLines ?? header.lines).length)
+            : Math.round(header.naturalRow - scrollTop) <= Math.round(header.y);
+        if (!isStuckState) {
+            return false;
+        }
+        if (header.type === 'top') {
+            if (region.overflowToBackbuffer &&
+                absY + header.y <= 0 &&
+                !(this.options.stickyHeadersInBackbuffer ?? false)) {
+                return false;
+            }
+            return true;
+        }
+        return true;
+    }
+    calculateActualStuckTopHeight(region, absY, scrollTop) {
+        let stuckHeight = 0;
+        const topHeaders = [...region.stickyHeaders]
+            .filter(h => h.type === 'top')
+            .sort((a, b) => a.y - b.y);
+        for (const header of topHeaders) {
+            if (this.isHeaderStuck(header, absY, scrollTop, region) &&
+                Math.abs(Math.round(header.y) - stuckHeight) < 0.5) {
+                const linesToRender = header.stuckLines ?? header.lines;
+                stuckHeight += linesToRender.length;
+            }
+            else if (this.isHeaderStuck(header, absY, scrollTop, region)) {
+                break;
+            }
+        }
+        return stuckHeight;
+    }
+    calculateActualStuckBottomHeight(region, absY, scrollTop) {
+        let stuckHeight = 0;
+        const bottomHeaders = [...region.stickyHeaders]
+            .filter(h => h.type === 'bottom')
+            .sort((a, b) => b.y - a.y);
+        for (const header of bottomHeaders) {
+            if (this.isHeaderStuck(header, absY, scrollTop, region)) {
+                const linesToRender = header.stuckLines ?? header.lines;
+                const footerRowInRegion = region.height - linesToRender.length - stuckHeight;
+                if (Math.round(header.y) === Math.round(footerRowInRegion)) {
+                    stuckHeight += linesToRender.length;
+                }
+                else {
+                    break;
+                }
+            }
+        }
+        return stuckHeight;
+    }
+    getBackgroundStyles(color) {
+        if (color === Compositor.lastBackgroundColor) {
+            return Compositor.lastBackgroundStyles;
+        }
+        const styles = getBackgroundColorEscape(color);
+        Compositor.lastBackgroundColor = color;
+        Compositor.lastBackgroundStyles = styles;
+        return styles;
+    }
+}
+//# sourceMappingURL=compositor.js.map

package/build/worker/compositor.js.map

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

package/build/worker/platform.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Handles platform-specific terminal quirks.
+ */
+export declare const platform: {
+    /**
+     * Terminal.app doesn't respect scroll regions starting at line 0 for scroll
+     * escape sequences. We need to use a workaround for this terminal.
+     */
+    isAppleTerminal(): boolean;
+};

package/build/worker/platform.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import process from 'node:process';
+/**
+ * Handles platform-specific terminal quirks.
+ */
+export const platform = {
+    /**
+     * Terminal.app doesn't respect scroll regions starting at line 0 for scroll
+     * escape sequences. We need to use a workaround for this terminal.
+     */
+    isAppleTerminal() {
+        return process.env['TERM_PROGRAM'] === 'Apple_Terminal';
+    },
+};
+//# sourceMappingURL=platform.js.map

package/build/worker/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/worker/platform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB;;;OAGG;IACH,eAAe;QACd,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,gBAAgB,CAAC;IACzD,CAAC;CACD,CAAC"}

package/build/worker/render-worker.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type RegionNode, type RegionUpdate } from '../output.js';
+import { type InkOptions } from '../components/AppContext.js';
+import { type ReplayFrame } from '../replay.js';
+import { type RenderLine } from './terminal-writer.js';
+import { SceneManager } from './scene-manager.js';
+export declare const debugWorker = false;
+/**
+ * Core renderer that composes together scrollable blocks of styled content.
+ */
+export declare class TerminalBufferWorker {
+    columns: number;
+    rows: number;
+    frameIndex: number;
+    debugRainbowEnabled: boolean;
+    isAlternateBufferEnabled: boolean;
+    stickyHeadersInBackbuffer: boolean;
+    animatedScroll: boolean;
+    animationInterval: number;
+    backbufferUpdateDelay: number;
+    maxScrollbackLength: number;
+    forceScrollToBottomOnBackbufferRefresh: boolean;
+    resized: boolean;
+    cursorPosition?: {
+        row: number;
+        col: number;
+    };
+    forceNextRender: boolean;
+    isRecording: boolean;
+    recordingFilename: string;
+    recordedFrames: ReplayFrame[];
+    recordingStartTime: number;
+    screen: RenderLine[];
+    backbuffer: RenderLine[];
+    private renderPromise?;
+    private readonly sceneManager;
+    private readonly animationController;
+    private readonly scrollOptimizer;
+    private readonly primaryTerminalWriter;
+    private readonly alternateTerminalWriter;
+    private get terminalWriter();
+    get backbufferDirty(): boolean;
+    set backbufferDirty(value: boolean);
+    get backbufferDirtyCurrentFrame(): boolean;
+    set backbufferDirtyCurrentFrame(value: boolean);
+    constructor(columns: number, rows: number, options?: {
+        debugRainbowEnabled?: boolean;
+        stdout?: NodeJS.WriteStream;
+        isAlternateBufferEnabled?: boolean;
+        stickyHeadersInBackbuffer?: boolean;
+        animatedScroll?: boolean;
+        animationInterval?: number;
+        backbufferUpdateDelay?: number;
+        maxScrollbackLength?: number;
+        forceScrollToBottomOnBackbufferRefresh?: boolean;
+    });
+    waitForIdle(): Promise<void>;
+    getExpectedState(): {
+        backbuffer: RenderLine[];
+        screen: RenderLine[];
+        cursorX: number;
+        cursorY: number;
+    };
+    getSceneManager(): SceneManager;
+    startRecording(filename: string): void;
+    stopRecording(): void;
+    dumpCurrentFrame(filename: string): void;
+    updateOptions(options: InkOptions): void;
+    update(tree: RegionNode, updates: RegionUpdate[], cursorPosition?: {
+        row: number;
+        col: number;
+    }): boolean;
+    resize(columns: number, rows: number): void;
+    fullRender(): Promise<void>;
+    render(): Promise<void>;
+    flushPendingRender(): Promise<void>;
+    done(): void;
+    getLinesUpdated(): number;
+    resetLinesUpdated(): void;
+    clear(): void;
+    private serializeCurrentRegions;
+    private _render;
+    private tickAnimation;
+    private composeScene;
+    /**
+     * Recursively composites a region and its children onto the provided canvas.
+     *
+     * @param node The hierarchical node to compose.
+     * @param canvas The target canvas to draw upon.
+     * @param layout Layout and clipping options for the current composition pass.
+     * @param layout.clip Optional bounding box to clip rendering.
+     * @param layout.offsetY The cumulative Y offset (used for scrolling/camera adjustments).
+     * @param layout.offsetX The cumulative X offset (used for scrolling/camera adjustments).
+     * @param layout.overrideHeight Optional height to force for the current region, typically used when composing to the backbuffer to capture content that has scrolled out of view.
+     * @param layout.isExpanded If true, forces the region to render at its full scroll height rather than its constrained layout height. When composing the backbuffer, this flag is passed down to the specific scrollable descendant that has `overflowToBackbuffer` enabled (typically only one such region should exist), allowing its complete content to be captured instead of just the visible viewport.
+     * @param options Additional composition flags.
+     * @param options.skipStickyHeaders If true, sticky headers will not be drawn.
+     * @param options.skipScrollbars If true, scrollbars will not be drawn.
+     */
+    private composeNode;
+    private createCompositor;
+    private getCameraY;
+    private syncCursor;
+    private appendToBackbuffer;
+    private updateTrackingMaps;
+    private findNodeForRegion;
+    private logScene;
+}