@aragon-agent/cli 0.6.47 → 0.6.48

package/dist/ui/scrollback/writer-shapes.d.ts

@@ -1,127 +0,0 @@
-/**
- * Byte shapes of the native-scroll writer (tui-native-terminal-scroll §4.3 /
- * Appendix A). Stateless string assembly only — the state machine that decides
- * WHICH shape to emit lives in `scrollback-writer.ts`.
- *
- * THE WHITELIST (I-S5 / I-S6). Every byte produced here is drawn from: SGR, CUU,
- * CUD, CR, CRLF, ED0, EL0, DEC 2026 and DECTCEM. There is no absolute CUP, no
- * scroll region, no `CSI S/T`, no `ED2/ED3`. Relative addressing is what makes the
- * geometry independent of the terminal scrolling underneath it (spec appendix B).
- *
- * Each row is `SGR0 · text · SGR0`: the leading reset stops one row's style leaking
- * into the next, and the trailing one stops a background-colour-erase terminal from
- * painting the following ED0/EL0 in the row's last colour.
- */
-export declare const SGR0 = "\u001B[0m";
-/** First write of a session: the cursor is already on a fresh line at column 0. */
-export declare function seedBytes(input: {
-    lines: readonly string[];
-    statics: readonly string[];
-    sync: boolean;
-    /** After a foreign write the cursor may sit mid-line; start on a new one (RV-11). */
-    reseed: boolean;
-}): string;
-/**
- * CUD(n): move down n rows WITHOUT writing a single cell.
- *
- * This is how the canvas spends its `gap` (D3). A blank row that is never written
- * cannot be pushed into the scrollback by a later overflow, which is the whole
- * reason the gap is not a run of `\r\n` (I-B3). The sequence is already whitelisted
- * (`diffBytes` uses it to step between changed rows); this is the same CUD used to
- * skip empty space instead.
- */
-export declare function skipRows(rows: number): string;
-/**
- * First canvas batch (or the first one after a reset): the screen below the cursor
- * is assumed empty, so there is nothing to erase — only `[gap][content][region]` to
- * write, ending with the cursor parked on the last row.
- */
-export declare function canvasSeedBytes(input: {
-    /**
-     * Rows to descend from the cursor to the canvas top, when the canvas is shorter
-     * than the space measured below the cursor.
-     *
-     * Non-zero only on a terminal taller than the start-of-canvas cap: the canvas then
-     * begins BELOW the cursor, and a seed that started writing at the cursor would park
-     * the region low and leave the top of the canvas empty for the whole session.
-     */
-    downToTop: number;
-    /** Blank rows to skip before the first content row. */
-    gap: number;
-    /** Content rows, already clipped, oldest first. */
-    held: readonly string[];
-    /** The live region. */
-    lines: readonly string[];
-    sync: boolean;
-    /** After a foreign write the cursor may sit mid-line; start on a new one. */
-    reseed: boolean;
-}): string;
-/**
- * Redraw the whole canvas: erase the previous one, then write `[gap][content][region]`.
- *
- * ORDER IS SEMANTICS: `ED0`, then the gap, then the content, then the region. Moving
- * the gap after the content puts the blank space back between the reply and the
- * composer, which is the exact defect this feature fixes (M1 in the spec).
- *
- * `held` is the FULL content sequence, not the part that will still be on screen: the
- * rows that do not fit are supposed to leave through the bottom, and the terminal can
- * only scroll away what it was given.
- */
-export declare function canvasBytes(input: {
-    /** Previous canvas height: the erase distance. */
-    eraseUp: number;
-    gap: number;
-    held: readonly string[];
-    lines: readonly string[];
-    sync: boolean;
-}): string;
-/** Erase exactly the previous live region, print static rows, redraw the region. */
-export declare function fullBytes(input: {
-    lines: readonly string[];
-    statics: readonly string[];
-    /** Rows between the region top and the parked cursor. */
-    eraseUp: number;
-    sync: boolean;
-}): string;
-/**
- * Fill the screen down to the LAST row before the first batch (D4 rung 2 / §4.3).
- *
- * This is the fallback for a terminal that never answers `ESC[6n`: from any row, a
- * run of `rows - 1` line feeds is guaranteed to leave the cursor on the bottom row
- * (extra feeds only scroll, which is why the count is the caller's business). It is
- * written ONCE, before anything else, so the rows it scrolls away are the host's old
- * output — which is still in the scrollback — and never this session's content.
- *
- * The argument is the NUMBER OF LINE FEEDS, not the terminal height: `cli.tsx` passes
- * `rows - 1`. Naming it after the height instead made the caller subtract twice and
- * left the cursor one row short of the bottom.
- */
-export declare function fillBytes(count: number): string;
-/** Same height, no static rows: rewrite only the rows that changed. `''` if none did. */
-export declare function diffBytes(input: {
-    lines: readonly string[];
-    prev: readonly string[];
-    sync: boolean;
-}): string;
-/**
- * Exit: erase the live region, flush leftover static rows, print the summary.
- * `eraseUp < 0` means the geometry is unknown (a foreign write intervened), in
- * which case the only safe move is to start on a fresh line and erase nothing.
- */
-export declare function finalizeBytes(input: {
-    eraseUp: number;
-    statics: readonly string[];
-    summary: readonly string[];
-}): string;
-/**
- * Cut a row to `maxCols` DISPLAY columns (I-S13), keeping SGR / OSC 8 intact.
- *
- * Returns the input unchanged (same reference) when it already fits, which is the
- * overwhelmingly common case. Width is measured the way Ink measures it
- * (`string-width` over the ANSI-stripped text): that is the number Ink used to
- * wrap, so a disagreement with the terminal is the only way a row can exceed it.
- */
-export declare function clipLine(line: string, maxCols: number): {
-    text: string;
-    clipped: boolean;
-};

package/dist/ui/scrollback/writer-shapes.js

@@ -1,159 +0,0 @@
-/**
- * Byte shapes of the native-scroll writer (tui-native-terminal-scroll §4.3 /
- * Appendix A). Stateless string assembly only — the state machine that decides
- * WHICH shape to emit lives in `scrollback-writer.ts`.
- *
- * THE WHITELIST (I-S5 / I-S6). Every byte produced here is drawn from: SGR, CUU,
- * CUD, CR, CRLF, ED0, EL0, DEC 2026 and DECTCEM. There is no absolute CUP, no
- * scroll region, no `CSI S/T`, no `ED2/ED3`. Relative addressing is what makes the
- * geometry independent of the terminal scrolling underneath it (spec appendix B).
- *
- * Each row is `SGR0 · text · SGR0`: the leading reset stops one row's style leaking
- * into the next, and the trailing one stops a background-colour-erase terminal from
- * painting the following ED0/EL0 in the row's last colour.
- */
-import stringWidth from 'string-width';
-import stripAnsi from 'strip-ansi';
-const CSI = '\x1b[';
-export const SGR0 = `${CSI}0m`;
-const ED0 = `${CSI}J`;
-const EL0 = `${CSI}K`;
-const SYNC_BEGIN = `${CSI}?2026h`;
-const SYNC_END = `${CSI}?2026l`;
-const SHOW_CURSOR = `${CSI}?25h`;
-const OSC8_CLOSE = '\x1b]8;;\x07';
-const up = (n) => (n > 0 ? `${CSI}${n}A` : '');
-const down = (n) => (n > 0 ? `${CSI}${n}B` : '');
-const row = (text) => SGR0 + text + SGR0 + '\r\n';
-const rows = (list) => list.map(row).join('');
-const wrapSync = (payload, sync) => sync ? SYNC_BEGIN + payload + SYNC_END : payload;
-/** First write of a session: the cursor is already on a fresh line at column 0. */
-export function seedBytes(input) {
-    const lead = input.reseed ? '\r\n' : '';
-    return wrapSync(lead + '\r' + SGR0 + rows(input.statics) + rows(input.lines), input.sync);
-}
-/**
- * CUD(n): move down n rows WITHOUT writing a single cell.
- *
- * This is how the canvas spends its `gap` (D3). A blank row that is never written
- * cannot be pushed into the scrollback by a later overflow, which is the whole
- * reason the gap is not a run of `\r\n` (I-B3). The sequence is already whitelisted
- * (`diffBytes` uses it to step between changed rows); this is the same CUD used to
- * skip empty space instead.
- */
-export function skipRows(rows) {
-    return down(Math.max(0, Math.floor(Number.isFinite(rows) ? rows : 0)));
-}
-/**
- * First canvas batch (or the first one after a reset): the screen below the cursor
- * is assumed empty, so there is nothing to erase — only `[gap][content][region]` to
- * write, ending with the cursor parked on the last row.
- */
-export function canvasSeedBytes(input) {
-    const lead = input.reseed ? '\r\n' : '';
-    const skip = skipRows(input.downToTop) + skipRows(input.gap);
-    return wrapSync(lead + '\r' + SGR0 + skip + rows(input.held) + rows(input.lines), input.sync);
-}
-/**
- * Redraw the whole canvas: erase the previous one, then write `[gap][content][region]`.
- *
- * ORDER IS SEMANTICS: `ED0`, then the gap, then the content, then the region. Moving
- * the gap after the content puts the blank space back between the reply and the
- * composer, which is the exact defect this feature fixes (M1 in the spec).
- *
- * `held` is the FULL content sequence, not the part that will still be on screen: the
- * rows that do not fit are supposed to leave through the bottom, and the terminal can
- * only scroll away what it was given.
- */
-export function canvasBytes(input) {
-    return wrapSync(up(input.eraseUp) + '\r' + SGR0 + ED0 + skipRows(input.gap) +
-        rows(input.held) + rows(input.lines), input.sync);
-}
-/** Erase exactly the previous live region, print static rows, redraw the region. */
-export function fullBytes(input) {
-    return wrapSync(up(input.eraseUp) + '\r' + SGR0 + ED0 + rows(input.statics) + rows(input.lines), input.sync);
-}
-/**
- * Fill the screen down to the LAST row before the first batch (D4 rung 2 / §4.3).
- *
- * This is the fallback for a terminal that never answers `ESC[6n`: from any row, a
- * run of `rows - 1` line feeds is guaranteed to leave the cursor on the bottom row
- * (extra feeds only scroll, which is why the count is the caller's business). It is
- * written ONCE, before anything else, so the rows it scrolls away are the host's old
- * output — which is still in the scrollback — and never this session's content.
- *
- * The argument is the NUMBER OF LINE FEEDS, not the terminal height: `cli.tsx` passes
- * `rows - 1`. Naming it after the height instead made the caller subtract twice and
- * left the cursor one row short of the bottom.
- */
-export function fillBytes(count) {
-    return '\r\n'.repeat(Math.max(0, Math.floor(count)));
-}
-/** Same height, no static rows: rewrite only the rows that changed. `''` if none did. */
-export function diffBytes(input) {
-    const { lines, prev } = input;
-    const height = lines.length;
-    let out = '';
-    let cursor = -1;
-    for (let i = 0; i < height; i += 1) {
-        if (lines[i] === prev[i])
-            continue;
-        // Paint, THEN clear the tail: never ESC[2K first, which would blank the row
-        // the user is looking at for the instant between the two writes.
-        out += (cursor < 0 ? up(height - i) : down(i - cursor)) + '\r' + SGR0 + lines[i] + SGR0 + EL0;
-        cursor = i;
-    }
-    if (cursor < 0)
-        return '';
-    // Park on the row below the region, column 0 (I-S4).
-    return wrapSync(out + down(height - cursor) + '\r', input.sync);
-}
-/**
- * Exit: erase the live region, flush leftover static rows, print the summary.
- * `eraseUp < 0` means the geometry is unknown (a foreign write intervened), in
- * which case the only safe move is to start on a fresh line and erase nothing.
- */
-export function finalizeBytes(input) {
-    const head = input.eraseUp < 0 ? '\r\n' : up(input.eraseUp) + '\r' + SGR0 + ED0;
-    return head + rows(input.statics) + rows(input.summary) + SHOW_CURSOR;
-}
-const ESCAPE = /(\x1b\[[0-?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\))/;
-const segmenter = typeof Intl !== 'undefined' && 'Segmenter' in Intl
-    ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
-    : null;
-function graphemes(text) {
-    return segmenter ? Array.from(segmenter.segment(text), (part) => part.segment) : Array.from(text);
-}
-/**
- * Cut a row to `maxCols` DISPLAY columns (I-S13), keeping SGR / OSC 8 intact.
- *
- * Returns the input unchanged (same reference) when it already fits, which is the
- * overwhelmingly common case. Width is measured the way Ink measures it
- * (`string-width` over the ANSI-stripped text): that is the number Ink used to
- * wrap, so a disagreement with the terminal is the only way a row can exceed it.
- */
-export function clipLine(line, maxCols) {
-    if (maxCols < 1)
-        return { text: '', clipped: line.length > 0 };
-    if (stringWidth(stripAnsi(line)) <= maxCols)
-        return { text: line, clipped: false };
-    let out = '';
-    let width = 0;
-    let linkOpen = false;
-    for (const part of line.split(ESCAPE)) {
-        if (part.startsWith('\x1b')) {
-            out += part;
-            if (part.startsWith('\x1b]8;'))
-                linkOpen = !/^\x1b\]8;[^;]*;(?:\x07|\x1b\\)$/.test(part);
-            continue;
-        }
-        for (const glyph of graphemes(part)) {
-            const glyphWidth = stringWidth(glyph);
-            if (width + glyphWidth > maxCols)
-                return { text: out + SGR0 + (linkOpen ? OSC8_CLOSE : ''), clipped: true };
-            out += glyph;
-            width += glyphWidth;
-        }
-    }
-    return { text: out, clipped: false };
-}

package/dist/ui/scrollbar-controller.d.ts

@@ -1,30 +0,0 @@
-import type { MouseEvent } from '../input/mouse-events.js';
-import { type ScrollbarGeometry } from './layout/scrollbar-geometry.js';
-export interface ScrollbarController {
-    handle(event: MouseEvent): boolean;
-    cancel(): void;
-    dispose(): void;
-    isCaptured(): boolean;
-}
-export interface ScrollbarOptions {
-    getGeometry(): ScrollbarGeometry | null;
-    setOffset(offset: number): void;
-    page(direction: 'pageUp' | 'pageDown'): void;
-    onHold(held: boolean): void;
-    onStart(): void;
-    isEnabled(): boolean;
-}
-export interface ScrollbarBridge {
-    controller: ScrollbarController | null;
-    geometry: ScrollbarGeometry | null;
-    frameReady: boolean;
-    isEnabled(): boolean;
-    onStart?: () => void;
-    onGeometry?: () => void;
-    requestRedraw?: () => void;
-    invalidate(): void;
-}
-/** Build the late-bound terminal bridge; no scroll position is owned here. */
-export declare function createScrollbarBridge(isEnabled: () => boolean): ScrollbarBridge;
-/** Own one pointer gesture and bounded timers; positioning remains in the viewport. */
-export declare function createScrollbarController(options: ScrollbarOptions): ScrollbarController;

package/dist/ui/scrollbar-controller.js

@@ -1,124 +0,0 @@
-import { offsetForThumb } from './layout/scrollbar-geometry.js';
-/** Build the late-bound terminal bridge; no scroll position is owned here. */
-export function createScrollbarBridge(isEnabled) {
-    const bridge = {
-        controller: null, geometry: null, frameReady: false, isEnabled,
-        invalidate: () => { bridge.frameReady = false; bridge.controller?.cancel(); },
-    };
-    return bridge;
-}
-/** Own one pointer gesture and bounded timers; positioning remains in the viewport. */
-export function createScrollbarController(options) {
-    return new ScrollbarGesture(options);
-}
-class ScrollbarGesture {
-    options;
-    capture = null;
-    timer = null;
-    watchdog = null;
-    swallowLate = false;
-    disposed = false;
-    constructor(options) {
-        this.options = options;
-    }
-    isCaptured() { return this.capture !== null; }
-    cancel() {
-        if (this.timer)
-            clearTimeout(this.timer);
-        if (this.watchdog)
-            clearTimeout(this.watchdog);
-        this.timer = this.watchdog = null;
-        const held = this.capture !== null;
-        this.capture = null;
-        if (held) {
-            this.swallowLate = true;
-            this.options.onHold(false);
-        }
-    }
-    dispose() { this.cancel(); this.disposed = true; }
-    armWatchdog() {
-        if (this.watchdog)
-            clearTimeout(this.watchdog);
-        this.watchdog = setTimeout(() => this.cancel(), 30000);
-        this.watchdog.unref?.();
-    }
-    flush() {
-        if (this.timer)
-            clearTimeout(this.timer);
-        this.timer = null;
-        const g = this.options.getGeometry();
-        if (!this.capture || !g || !this.options.isEnabled() ||
-            g.revision !== this.capture.revision) {
-            this.cancel();
-            return;
-        }
-        const y = this.capture.pendingY;
-        this.capture.pendingY = null;
-        if (y !== null)
-            this.options.setOffset(offsetForThumb({ geometry: g,
-                pointerY: y, grabRow: this.capture.grabRow }));
-    }
-    move(y) {
-        if (!this.capture || this.capture.kind !== 'thumb' || y === this.capture.lastPointerY)
-            return;
-        this.capture.lastPointerY = y;
-        this.capture.pendingY = y;
-        if (!this.timer) {
-            this.timer = setTimeout(() => this.flush(), 16);
-            this.timer.unref?.();
-        }
-    }
-    press(event) {
-        this.cancel();
-        this.swallowLate = false;
-        const g = this.options.getGeometry();
-        if (!g || !this.canPress(event, g))
-            return false;
-        const row = event.y - g.trackTop;
-        const thumb = g.thumb;
-        const inside = thumb && row >= thumb.start && row < thumb.start + thumb.size;
-        this.capture = { kind: inside && g.trackRows > thumb.size ? 'thumb' : 'track',
-            grabRow: inside ? row - thumb.start : 0, revision: g.revision,
-            lastPointerY: event.y, pendingY: null };
-        this.options.onStart();
-        this.options.onHold(true);
-        this.armWatchdog();
-        if (thumb && !inside)
-            this.options.page(row < thumb.start ? 'pageUp' : 'pageDown');
-        return true;
-    }
-    canPress(event, g) {
-        const plainLeft = event.button === 0 && !event.shift && !event.alt && !event.ctrl;
-        const inTrack = event.x === g.trackCol && event.y >= g.trackTop &&
-            event.y < g.trackTop + g.trackRows;
-        return this.options.isEnabled() && plainLeft && inTrack;
-    }
-    handle(event) {
-        if (this.disposed)
-            return false;
-        if (event.kind === 'wheel')
-            return this.capture !== null;
-        if (![event.x, event.y].every(Number.isFinite))
-            return this.capture !== null;
-        if (event.kind === 'press')
-            return this.press(event);
-        if (!this.capture)
-            return this.swallowLate;
-        if (event.button !== 0) {
-            this.cancel();
-            return false;
-        }
-        if (!this.options.isEnabled()) {
-            this.cancel();
-            return true;
-        }
-        this.move(event.y);
-        if (event.kind === 'release') {
-            this.flush();
-            this.cancel();
-        }
-        else
-            this.armWatchdog();
-        return true;
-    }
-}

package/dist/ui/selection/highlight.d.ts

@@ -1,39 +0,0 @@
-/**
- * The row painter (tui-selection-and-scroll-follow §4.4.4). PURE — strings in,
- * strings out.
- *
- * It runs inside the frame differ's `decorate` hook rather than in React (D-6):
- * a re-render per drag event goes through the render governor and the whole
- * component tree, while this repaints one to three rows with no commit at all.
- */
-import type { Theme } from '../theme.js';
-import type { TermCapabilities } from '../capabilities.js';
-/**
- * The SGR sequence that opens a highlighted run.
- *
- * TRUECOLOR OR REVERSE VIDEO, WITH NOTHING IN BETWEEN, and that is deliberate.
- * `getTheme` degrades every palette colour to the terminal's depth, so below
- * ansi-256 `theme.selectionBg` is a CHALK COLOUR NAME (`'blue'`) rather than a
- * hex triple — and a name cannot be turned into an escape sequence here without
- * duplicating chalk's own table. Reverse video is what a terminal that shallow
- * would render anyway, it needs no colour support at all, and it is exactly what
- * the emulator's own selection looks like. The `HEX` test is therefore both the
- * colour-depth check and the type check.
- */
-export declare function selectionOpen(theme: Theme, caps: TermCapabilities): string;
-/**
- * Paint `[from, to)` of one frame line.
- *
- * `to` is already clamped to the terminal width by the caller, so `Infinity`
- * never reaches here.
- *
- * STRIPPING SGR INSIDE THE SELECTION IS NOT LAZINESS. An inner `\x1b[0m` — which
- * `Markdown` and `cli-highlight` emit constantly — would cancel the highlight
- * attribute mid-run and leave holes in it. Terminals repaint selected text in
- * the selection's own colours for exactly this reason.
- *
- * `pad` is what gives a multi-row selection a straight right edge over short
- * lines, and it measures with `columnsOf` — the same oracle `sliceColumns`
- * charges with — rather than reaching for a third width function (I-12).
- */
-export declare function paintRow(line: string, from: number, to: number, open: string): string;

package/dist/ui/selection/highlight.js

@@ -1,64 +0,0 @@
-/**
- * The row painter (tui-selection-and-scroll-follow §4.4.4). PURE — strings in,
- * strings out.
- *
- * It runs inside the frame differ's `decorate` hook rather than in React (D-6):
- * a re-render per drag event goes through the render governor and the whole
- * component tree, while this repaints one to three rows with no commit at all.
- */
-import stripAnsi from 'strip-ansi';
-import { columnsOf, sliceColumns } from './selection.js';
-const CSI = '\x1b[';
-const SGR_RESET = `${CSI}0m`;
-/** Reverse video — the universal fallback, and what a monochrome terminal gets. */
-const REVERSE = `${CSI}7m`;
-const HEX = /^#[0-9a-f]{6}$/i;
-function rgb(hex) {
-    const n = Number.parseInt(hex.slice(1), 16);
-    return `${(n >> 16) & 0xff};${(n >> 8) & 0xff};${n & 0xff}`;
-}
-/**
- * The SGR sequence that opens a highlighted run.
- *
- * TRUECOLOR OR REVERSE VIDEO, WITH NOTHING IN BETWEEN, and that is deliberate.
- * `getTheme` degrades every palette colour to the terminal's depth, so below
- * ansi-256 `theme.selectionBg` is a CHALK COLOUR NAME (`'blue'`) rather than a
- * hex triple — and a name cannot be turned into an escape sequence here without
- * duplicating chalk's own table. Reverse video is what a terminal that shallow
- * would render anyway, it needs no colour support at all, and it is exactly what
- * the emulator's own selection looks like. The `HEX` test is therefore both the
- * colour-depth check and the type check.
- */
-export function selectionOpen(theme, caps) {
-    if (caps.colorLevel < 2)
-        return REVERSE;
-    const bg = theme.selectionBg;
-    const fg = theme.selectionFg;
-    if (!bg || !fg || !HEX.test(bg) || !HEX.test(fg))
-        return REVERSE;
-    return `${CSI}48;2;${rgb(bg)}m${CSI}38;2;${rgb(fg)}m`;
-}
-/**
- * Paint `[from, to)` of one frame line.
- *
- * `to` is already clamped to the terminal width by the caller, so `Infinity`
- * never reaches here.
- *
- * STRIPPING SGR INSIDE THE SELECTION IS NOT LAZINESS. An inner `\x1b[0m` — which
- * `Markdown` and `cli-highlight` emit constantly — would cancel the highlight
- * attribute mid-run and leave holes in it. Terminals repaint selected text in
- * the selection's own colours for exactly this reason.
- *
- * `pad` is what gives a multi-row selection a straight right edge over short
- * lines, and it measures with `columnsOf` — the same oracle `sliceColumns`
- * charges with — rather than reaching for a third width function (I-12).
- */
-export function paintRow(line, from, to, open) {
-    if (!(to > from))
-        return line;
-    const head = sliceColumns(line, 0, from);
-    const mid = stripAnsi(sliceColumns(line, from, to));
-    const pad = ' '.repeat(Math.max(0, to - from - columnsOf(mid)));
-    const tail = sliceColumns(line, to);
-    return `${head}${open}${mid}${pad}${SGR_RESET}${tail}`;
-}

package/dist/ui/selection/screen-mirror.d.ts

@@ -1,24 +0,0 @@
-/**
- * The screen mirror (tui-selection-and-scroll-follow §7) — the single source of
- * truth for what text is on which row.
- *
- * I-4 RIDES ON THIS OBJECT. The highlight and the clipboard both read the rows
- * stored here, written by the same `decorate` call, so whatever changes under a
- * selection is simultaneously what is highlighted and what would be copied. What
- * you see is what you get BY CONSTRUCTION, rather than by a staleness check that
- * can be wrong.
- *
- * `plain` is computed LAZILY. `decorate` runs on every frame Ink produces —
- * 15-30 times a second during a run — while a copy happens when a human releases
- * a mouse button, so stripping every row eagerly would spend H regex passes per
- * frame to serve an event that may never come. The cache is dropped by `set`, so
- * the laziness is invisible to callers and cannot go stale.
- */
-export interface ScreenMirror {
-    /** Last frame, ANSI intact — what `decorate` paints over. */
-    readonly raw: readonly string[];
-    /** The same rows, ANSI stripped — what `selectedText` reads. */
-    readonly plain: readonly string[];
-    set(lines: readonly string[]): void;
-}
-export declare function createScreenMirror(): ScreenMirror;

package/dist/ui/selection/screen-mirror.js

@@ -1,35 +0,0 @@
-/**
- * The screen mirror (tui-selection-and-scroll-follow §7) — the single source of
- * truth for what text is on which row.
- *
- * I-4 RIDES ON THIS OBJECT. The highlight and the clipboard both read the rows
- * stored here, written by the same `decorate` call, so whatever changes under a
- * selection is simultaneously what is highlighted and what would be copied. What
- * you see is what you get BY CONSTRUCTION, rather than by a staleness check that
- * can be wrong.
- *
- * `plain` is computed LAZILY. `decorate` runs on every frame Ink produces —
- * 15-30 times a second during a run — while a copy happens when a human releases
- * a mouse button, so stripping every row eagerly would spend H regex passes per
- * frame to serve an event that may never come. The cache is dropped by `set`, so
- * the laziness is invisible to callers and cannot go stale.
- */
-import stripAnsi from 'strip-ansi';
-export function createScreenMirror() {
-    let raw = [];
-    let plain = null;
-    return {
-        get raw() {
-            return raw;
-        },
-        get plain() {
-            if (plain === null)
-                plain = raw.map((line) => stripAnsi(line));
-            return plain;
-        },
-        set(lines) {
-            raw = lines;
-            plain = null;
-        },
-    };
-}