@nuvin/ink 7.6.0-alpha → 7.7.0-alpha

package/build/explicit-width-detection.js

@@ -0,0 +1,172 @@
+import stringWidth from 'string-width';
+/** Whether pending Ink output will overwrite the one-cell probe at column 1. */
+export const canOverwriteFirstCell = (text) => {
+    let remaining = text;
+    while (remaining.startsWith('\u001B')) {
+        // Only rendition controls are safe here. Do not treat arbitrary CSI/OSC
+        // payloads as evidence that Ink will overwrite the reserved cell.
+        const prefix = /^(?:\u001B\[[\d;:]*m|\u001B\]8;[^\u001B\u0007\r\n]*(?:\u001B\\|\u0007))/.exec(remaining);
+        if (!prefix)
+            return false;
+        remaining = remaining.slice(prefix[0].length);
+    }
+    if (!/^[\p{L}\p{N}\p{P}\p{S}\p{Zs}]/u.test(remaining))
+        return false;
+    const first = new Intl.Segmenter(undefined, { granularity: 'grapheme' })
+        .segment(remaining)[Symbol.iterator]()
+        .next().value;
+    return first !== undefined && stringWidth(first.segment) > 0;
+};
+/** One bounded, per-instance negotiation. Ink owns pending frames and raw input. */
+export class ExplicitWidthDetection {
+    phase = 'idle';
+    inputReady = false;
+    firstRow = 0;
+    timer;
+    deadline;
+    writing = false;
+    deferredResult;
+    replies = [];
+    settlementCallbacks = [];
+    resolveFinished;
+    finished = new Promise(resolve => {
+        this.resolveFinished = resolve;
+    });
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    get pending() {
+        return this.phase !== 'idle' && this.phase !== 'settled';
+    }
+    get settled() {
+        return this.phase === 'settled';
+    }
+    get publicationBlocked() {
+        return this.writing || this.phase === 'settling';
+    }
+    onSettled(callback) {
+        if (this.settled) {
+            callback();
+            return;
+        }
+        this.settlementCallbacks.push(callback);
+    }
+    start() {
+        if (this.phase !== 'idle')
+            return;
+        this.phase = 'waiting';
+        this.deadline = Date.now() + 200;
+        this.timer = setTimeout(() => this.cancel(), 200);
+        this.queryIfReady();
+    }
+    setInputReady(ready) {
+        if (!ready && this.inputReady)
+            this.cancel();
+        this.inputReady = ready;
+        this.queryIfReady();
+    }
+    accept(position) {
+        if (this.writing) {
+            // There are only two outstanding measurements. Keep synchronous
+            // stream callbacks bounded and process them after the full write.
+            if (this.replies.length < 2)
+                this.replies.push(position);
+            return;
+        }
+        if (this.phase !== 'first' && this.phase !== 'second')
+            return;
+        if (this.expired()) {
+            this.cancel();
+            return;
+        }
+        const { columns, rows } = this.options.getSize();
+        const { row, column } = position;
+        if (!Number.isInteger(row) ||
+            !Number.isInteger(column) ||
+            row < 1 ||
+            row > rows ||
+            column < 1 ||
+            column > columns) {
+            this.cancel();
+            return;
+        }
+        if (this.phase === 'second') {
+            this.finish(row === this.firstRow && column === 2);
+            return;
+        }
+        if (column !== 1 ||
+            columns < 2 ||
+            !this.options.reserve() ||
+            this.expired()) {
+            this.cancel();
+            return;
+        }
+        this.firstRow = row;
+        this.phase = 'second';
+        this.send('\u001B]66;w=1; \u001B\\\u001B[?6n\r');
+    }
+    cancel() {
+        this.finish(false);
+    }
+    expired() {
+        return this.deadline !== undefined && Date.now() >= this.deadline;
+    }
+    queryIfReady() {
+        if (this.phase !== 'waiting' || !this.inputReady)
+            return;
+        if (this.expired()) {
+            this.cancel();
+            return;
+        }
+        this.phase = 'first';
+        this.send('\u001B[?6n');
+    }
+    send(text) {
+        this.writing = true;
+        try {
+            this.options.write(text);
+        }
+        catch {
+            this.cancel();
+        }
+        finally {
+            this.writing = false;
+        }
+        if (this.deferredResult !== undefined) {
+            const result = this.deferredResult;
+            this.deferredResult = undefined;
+            this.publish(result);
+        }
+        while (this.replies.length > 0)
+            this.accept(this.replies.shift());
+    }
+    finish(supported) {
+        if (this.phase === 'settling' || this.settled)
+            return;
+        this.phase = 'settling';
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        if (this.writing) {
+            this.deferredResult = supported;
+            return;
+        }
+        this.publish(supported);
+    }
+    publish(supported) {
+        try {
+            this.options.onResult(supported);
+        }
+        finally {
+            this.phase = 'settled';
+            try {
+                for (const callback of this.settlementCallbacks.splice(0))
+                    callback();
+            }
+            finally {
+                this.resolveFinished();
+            }
+        }
+    }
+}
+//# sourceMappingURL=explicit-width-detection.js.map

package/build/explicit-width-detection.js.map

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

package/build/explicit-width.d.ts

@@ -0,0 +1 @@
+export declare function createExplicitWidthEncoder(): (text: string) => string;

package/build/explicit-width.js

@@ -0,0 +1,114 @@
+import { Buffer } from 'node:buffer';
+import stringWidth from 'string-width';
+import { readTerminalControl } from './terminal-control.js';
+const ascii = /^[\u0000-\u007F]*$/;
+const terminalControl = /[\u0000-\u001F\u007F-\u009F]/;
+const formatOnly = /^\p{Format}+$/u;
+const noncharacter = /[\uFDD0-\uFDEF\uFFFE\uFFFF\u{1FFFE}\u{1FFFF}\u{2FFFE}\u{2FFFF}\u{3FFFE}\u{3FFFF}\u{4FFFE}\u{4FFFF}\u{5FFFE}\u{5FFFF}\u{6FFFE}\u{6FFFF}\u{7FFFE}\u{7FFFF}\u{8FFFE}\u{8FFFF}\u{9FFFE}\u{9FFFF}\u{AFFFE}\u{AFFFF}\u{BFFFE}\u{BFFFF}\u{CFFFE}\u{CFFFF}\u{DFFFE}\u{DFFFF}\u{EFFFE}\u{EFFFF}\u{FFFFE}\u{FFFFF}\u{10FFFE}\u{10FFFF}]/u;
+const isWellFormed = (value) => value.isWellFormed();
+const remember = (cache, key, value, maxEntries, maxBytes) => {
+    if (Buffer.byteLength(key, 'utf8') + Buffer.byteLength(value, 'utf8') >
+        maxBytes) {
+        return;
+    }
+    if (!cache.has(key) && cache.size >= maxEntries) {
+        const oldest = cache.keys().next();
+        if (!oldest.done) {
+            cache.delete(oldest.value);
+        }
+    }
+    cache.set(key, value);
+};
+export function createExplicitWidthEncoder() {
+    const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+    const rowCache = new Map();
+    const graphemeCache = new Map();
+    const encodeGrapheme = (grapheme) => {
+        if (ascii.test(grapheme)) {
+            return grapheme;
+        }
+        const cached = graphemeCache.get(grapheme);
+        if (cached !== undefined) {
+            return cached;
+        }
+        let encoded = grapheme;
+        if (isWellFormed(grapheme) &&
+            !terminalControl.test(grapheme) &&
+            !formatOnly.test(grapheme) &&
+            !noncharacter.test(grapheme) &&
+            Buffer.byteLength(grapheme, 'utf8') <= 4096) {
+            const width = stringWidth(grapheme);
+            if (Number.isInteger(width) && width >= 1 && width <= 7) {
+                encoded = `\u001B]66;w=${width};${grapheme}\u001B\\`;
+            }
+        }
+        remember(graphemeCache, grapheme, encoded, 1024, 8192);
+        return encoded;
+    };
+    const encodePrintable = (text) => {
+        if (ascii.test(text)) {
+            return text;
+        }
+        const pieces = [];
+        for (const { segment } of segmenter.segment(text)) {
+            pieces.push(encodeGrapheme(segment));
+        }
+        return pieces.join('');
+    };
+    const scanRow = (row) => {
+        const pieces = [];
+        let index = 0;
+        let printableStart = 0;
+        const flushPrintable = (end) => {
+            if (end > printableStart) {
+                pieces.push(encodePrintable(row.slice(printableStart, end)));
+            }
+        };
+        while (index < row.length) {
+            const code = row.charCodeAt(index);
+            if (code <= 0x1f || code === 0x7f || (code >= 0x80 && code <= 0x9f)) {
+                const control = readTerminalControl(row, index);
+                if (control === undefined) {
+                    return undefined;
+                }
+                flushPrintable(index);
+                pieces.push(control.raw);
+                index = control.end;
+                printableStart = index;
+                continue;
+            }
+            index++;
+        }
+        flushPrintable(row.length);
+        return pieces.join('');
+    };
+    const encodeRow = (row) => {
+        const cached = rowCache.get(row);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const encoded = scanRow(row);
+        if (encoded === undefined) {
+            return undefined;
+        }
+        remember(rowCache, row, encoded, 256, 16_384);
+        return encoded;
+    };
+    return (text) => {
+        if (!text.includes('\n')) {
+            const encoded = encodeRow(text);
+            return encoded === undefined ? text : encoded;
+        }
+        const rows = text.split('\n');
+        const encodedRows = [];
+        for (const row of rows) {
+            const encoded = encodeRow(row);
+            if (encoded === undefined) {
+                return text;
+            }
+            encodedRows.push(encoded);
+        }
+        return encodedRows.join('\n');
+    };
+}
+//# sourceMappingURL=explicit-width.js.map

package/build/explicit-width.js.map

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

package/build/ink.d.ts

@@ -45,6 +45,7 @@ export type Options = {
     */
     concurrent?: boolean;
     kittyKeyboard?: KittyKeyboardOptions;
+    explicitWidth?: 'auto' | 'disabled';
     /**
     Override automatic interactive mode detection.
 
@@ -93,6 +94,7 @@ export default class Ink {
     private alternateScreen;
     private isUnmounted;
     private isUnmounting;
+    private outputError;
     private lastOutput;
     private lastOutputToRender;
     private lastOutputHeight;
@@ -115,12 +117,29 @@ export default class Ink {
     private nextRenderCommit?;
     private readonly textSelection;
     private lastLayoutWidth?;
+    private lastLayoutRows?;
+    private pendingStaticOutput;
+    private pendingHistoryAdvance;
+    private transformOutput?;
+    private paintEligible;
+    private paintCapability;
+    private readonly widthDetection?;
+    private pendingFrame?;
+    private reservedFrame?;
+    private readonly deferredWidthRenders;
+    private readonly deferredWidthLifecycleActions;
+    private rawInputReady;
+    private resumePendingInput?;
+    private kittyAutoFlags?;
+    private kittyQuerySent;
     constructor(options: Options);
     resized: () => void;
     resolveExitPromise: (result?: unknown) => void;
     rejectExitPromise: (reason?: Error) => void;
     unsubscribeExit: () => void;
     handleAppExit: (errorOrResult?: unknown) => void;
+    handleStdoutError: (error: Error) => void;
+    surfaceOutputError(error: unknown): void;
     setCursorPosition: (position: CursorPosition | undefined) => void;
     restoreLastOutput: () => void;
     calculateLayout: () => void;
@@ -143,7 +162,30 @@ export default class Ink {
     private hasPendingConcurrentWork;
     private awaitNextRender;
     private renderInteractiveFrame;
+    private renderPendingFrame;
+    private renderSeekFrame;
+    private renderRawInteractiveFrame;
+    private encodeTerminalOutput;
+    private commitInteractiveFrame;
+    private resolvePaintContext;
+    private getSeekPaintContext;
+    private clearPhysicalFrame;
+    private leaveSeekViewport;
+    private consumeHistoryAdvance;
+    private failExternalOutput;
+    private writeExternalOutput;
+    private writePaintRequest;
+    private publishLogicalFrame;
+    private takeStaticOutput;
+    private deferStatic;
+    private scheduleLayoutRender;
+    private reserveExplicitWidthFrame;
+    private settleExplicitWidth;
+    private deferUntilExplicitWidthSettlement;
+    private finishExplicitWidthSettlement;
+    private isTerminalResponsePending;
+    private handleInputReady;
+    private handleTerminalResponse;
     private initKittyKeyboard;
-    private confirmKittySupport;
     private enableKittyProtocol;
 }