@aexol/spectral 0.7.7 → 0.8.0

package/dist/pi/tui/terminal-image.js

@@ -1,335 +0,0 @@
-let cachedCapabilities = null;
-// Default cell dimensions - updated by TUI when terminal responds to query
-let cellDimensions = { widthPx: 9, heightPx: 18 };
-export function getCellDimensions() {
-    return cellDimensions;
-}
-export function setCellDimensions(dims) {
-    cellDimensions = dims;
-}
-export function detectCapabilities() {
-    const termProgram = process.env.TERM_PROGRAM?.toLowerCase() || "";
-    const term = process.env.TERM?.toLowerCase() || "";
-    const colorTerm = process.env.COLORTERM?.toLowerCase() || "";
-    const hasTrueColorHint = colorTerm === "truecolor" || colorTerm === "24bit";
-    // tmux and screen swallow OSC 8 by default (passthrough is opt-in and wraps
-    // sequences differently). Force hyperlinks off whenever we detect them, even
-    // when the outer terminal would otherwise support OSC 8. Image protocols are
-    // also unreliable under tmux/screen, so leave `images: null` for safety.
-    const inTmuxOrScreen = !!process.env.TMUX || term.startsWith("tmux") || term.startsWith("screen");
-    if (inTmuxOrScreen) {
-        return { images: null, trueColor: hasTrueColorHint, hyperlinks: false };
-    }
-    if (process.env.KITTY_WINDOW_ID || termProgram === "kitty") {
-        return { images: "kitty", trueColor: true, hyperlinks: true };
-    }
-    if (termProgram === "ghostty" || term.includes("ghostty") || process.env.GHOSTTY_RESOURCES_DIR) {
-        return { images: "kitty", trueColor: true, hyperlinks: true };
-    }
-    if (process.env.WEZTERM_PANE || termProgram === "wezterm") {
-        return { images: "kitty", trueColor: true, hyperlinks: true };
-    }
-    if (process.env.ITERM_SESSION_ID || termProgram === "iterm.app") {
-        return { images: "iterm2", trueColor: true, hyperlinks: true };
-    }
-    if (termProgram === "vscode") {
-        return { images: null, trueColor: true, hyperlinks: true };
-    }
-    if (termProgram === "alacritty") {
-        return { images: null, trueColor: true, hyperlinks: true };
-    }
-    // Unknown terminal: be conservative. OSC 8 is rendered invisibly as "just
-    // text" on terminals that swallow it, which means the URL disappears from
-    // the rendered output. Default to the legacy `text (url)` behavior unless we
-    // have positively identified a hyperlink-capable terminal above.
-    return { images: null, trueColor: hasTrueColorHint || !!process.env.WT_SESSION, hyperlinks: false };
-}
-export function getCapabilities() {
-    if (!cachedCapabilities) {
-        cachedCapabilities = detectCapabilities();
-    }
-    return cachedCapabilities;
-}
-export function resetCapabilitiesCache() {
-    cachedCapabilities = null;
-}
-/** Override the cached capabilities. Useful in tests to exercise both code paths. */
-export function setCapabilities(caps) {
-    cachedCapabilities = caps;
-}
-const KITTY_PREFIX = "\x1b_G";
-const ITERM2_PREFIX = "\x1b]1337;File=";
-export function isImageLine(line) {
-    // Fast path: sequence at line start (single-row images)
-    if (line.startsWith(KITTY_PREFIX) || line.startsWith(ITERM2_PREFIX)) {
-        return true;
-    }
-    // Slow path: sequence elsewhere (multi-row images have cursor-up prefix)
-    return line.includes(KITTY_PREFIX) || line.includes(ITERM2_PREFIX);
-}
-/**
- * Generate a random image ID for Kitty graphics protocol.
- * Uses random IDs to avoid collisions between different module instances
- * (e.g., main app vs extensions).
- */
-export function allocateImageId() {
-    // Use random ID in range [1, 0xffffffff] to avoid collisions
-    return Math.floor(Math.random() * 0xfffffffe) + 1;
-}
-export function encodeKitty(base64Data, options = {}) {
-    const CHUNK_SIZE = 4096;
-    const params = ["a=T", "f=100", "q=2"];
-    if (options.moveCursor === false)
-        params.push("C=1");
-    if (options.columns)
-        params.push(`c=${options.columns}`);
-    if (options.rows)
-        params.push(`r=${options.rows}`);
-    if (options.imageId)
-        params.push(`i=${options.imageId}`);
-    if (base64Data.length <= CHUNK_SIZE) {
-        return `\x1b_G${params.join(",")};${base64Data}\x1b\\`;
-    }
-    const chunks = [];
-    let offset = 0;
-    let isFirst = true;
-    while (offset < base64Data.length) {
-        const chunk = base64Data.slice(offset, offset + CHUNK_SIZE);
-        const isLast = offset + CHUNK_SIZE >= base64Data.length;
-        if (isFirst) {
-            chunks.push(`\x1b_G${params.join(",")},m=1;${chunk}\x1b\\`);
-            isFirst = false;
-        }
-        else if (isLast) {
-            chunks.push(`\x1b_Gm=0;${chunk}\x1b\\`);
-        }
-        else {
-            chunks.push(`\x1b_Gm=1;${chunk}\x1b\\`);
-        }
-        offset += CHUNK_SIZE;
-    }
-    return chunks.join("");
-}
-/**
- * Delete a Kitty graphics image by ID.
- * Uses uppercase 'I' to also free the image data.
- */
-export function deleteKittyImage(imageId) {
-    return `\x1b_Ga=d,d=I,i=${imageId},q=2\x1b\\`;
-}
-/**
- * Delete all visible Kitty graphics images.
- * Uses uppercase 'A' to also free the image data.
- */
-export function deleteAllKittyImages() {
-    return "\x1b_Ga=d,d=A,q=2\x1b\\";
-}
-export function encodeITerm2(base64Data, options = {}) {
-    const params = [`inline=${options.inline !== false ? 1 : 0}`];
-    if (options.width !== undefined)
-        params.push(`width=${options.width}`);
-    if (options.height !== undefined)
-        params.push(`height=${options.height}`);
-    if (options.name) {
-        const nameBase64 = Buffer.from(options.name).toString("base64");
-        params.push(`name=${nameBase64}`);
-    }
-    if (options.preserveAspectRatio === false) {
-        params.push("preserveAspectRatio=0");
-    }
-    return `\x1b]1337;File=${params.join(";")}:${base64Data}\x07`;
-}
-export function calculateImageCellSize(imageDimensions, maxWidthCells, maxHeightCells, cellDimensions = { widthPx: 9, heightPx: 18 }) {
-    const maxWidth = Math.max(1, Math.floor(maxWidthCells));
-    const maxHeight = maxHeightCells === undefined ? undefined : Math.max(1, Math.floor(maxHeightCells));
-    const imageWidth = Math.max(1, imageDimensions.widthPx);
-    const imageHeight = Math.max(1, imageDimensions.heightPx);
-    const widthScale = (maxWidth * cellDimensions.widthPx) / imageWidth;
-    const heightScale = maxHeight === undefined ? widthScale : (maxHeight * cellDimensions.heightPx) / imageHeight;
-    const scale = Math.min(widthScale, heightScale);
-    const scaledWidthPx = imageWidth * scale;
-    const scaledHeightPx = imageHeight * scale;
-    const columns = Math.ceil(scaledWidthPx / cellDimensions.widthPx);
-    const rows = Math.ceil(scaledHeightPx / cellDimensions.heightPx);
-    return {
-        columns: Math.max(1, Math.min(maxWidth, columns)),
-        rows: Math.max(1, maxHeight === undefined ? rows : Math.min(maxHeight, rows)),
-    };
-}
-export function calculateImageRows(imageDimensions, targetWidthCells, cellDimensions = { widthPx: 9, heightPx: 18 }) {
-    return calculateImageCellSize(imageDimensions, targetWidthCells, undefined, cellDimensions).rows;
-}
-export function getPngDimensions(base64Data) {
-    try {
-        const buffer = Buffer.from(base64Data, "base64");
-        if (buffer.length < 24) {
-            return null;
-        }
-        if (buffer[0] !== 0x89 || buffer[1] !== 0x50 || buffer[2] !== 0x4e || buffer[3] !== 0x47) {
-            return null;
-        }
-        const width = buffer.readUInt32BE(16);
-        const height = buffer.readUInt32BE(20);
-        return { widthPx: width, heightPx: height };
-    }
-    catch {
-        return null;
-    }
-}
-export function getJpegDimensions(base64Data) {
-    try {
-        const buffer = Buffer.from(base64Data, "base64");
-        if (buffer.length < 2) {
-            return null;
-        }
-        if (buffer[0] !== 0xff || buffer[1] !== 0xd8) {
-            return null;
-        }
-        let offset = 2;
-        while (offset < buffer.length - 9) {
-            if (buffer[offset] !== 0xff) {
-                offset++;
-                continue;
-            }
-            const marker = buffer[offset + 1];
-            if (marker >= 0xc0 && marker <= 0xc2) {
-                const height = buffer.readUInt16BE(offset + 5);
-                const width = buffer.readUInt16BE(offset + 7);
-                return { widthPx: width, heightPx: height };
-            }
-            if (offset + 3 >= buffer.length) {
-                return null;
-            }
-            const length = buffer.readUInt16BE(offset + 2);
-            if (length < 2) {
-                return null;
-            }
-            offset += 2 + length;
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-export function getGifDimensions(base64Data) {
-    try {
-        const buffer = Buffer.from(base64Data, "base64");
-        if (buffer.length < 10) {
-            return null;
-        }
-        const sig = buffer.slice(0, 6).toString("ascii");
-        if (sig !== "GIF87a" && sig !== "GIF89a") {
-            return null;
-        }
-        const width = buffer.readUInt16LE(6);
-        const height = buffer.readUInt16LE(8);
-        return { widthPx: width, heightPx: height };
-    }
-    catch {
-        return null;
-    }
-}
-export function getWebpDimensions(base64Data) {
-    try {
-        const buffer = Buffer.from(base64Data, "base64");
-        if (buffer.length < 30) {
-            return null;
-        }
-        const riff = buffer.slice(0, 4).toString("ascii");
-        const webp = buffer.slice(8, 12).toString("ascii");
-        if (riff !== "RIFF" || webp !== "WEBP") {
-            return null;
-        }
-        const chunk = buffer.slice(12, 16).toString("ascii");
-        if (chunk === "VP8 ") {
-            if (buffer.length < 30)
-                return null;
-            const width = buffer.readUInt16LE(26) & 0x3fff;
-            const height = buffer.readUInt16LE(28) & 0x3fff;
-            return { widthPx: width, heightPx: height };
-        }
-        else if (chunk === "VP8L") {
-            if (buffer.length < 25)
-                return null;
-            const bits = buffer.readUInt32LE(21);
-            const width = (bits & 0x3fff) + 1;
-            const height = ((bits >> 14) & 0x3fff) + 1;
-            return { widthPx: width, heightPx: height };
-        }
-        else if (chunk === "VP8X") {
-            if (buffer.length < 30)
-                return null;
-            const width = (buffer[24] | (buffer[25] << 8) | (buffer[26] << 16)) + 1;
-            const height = (buffer[27] | (buffer[28] << 8) | (buffer[29] << 16)) + 1;
-            return { widthPx: width, heightPx: height };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-export function getImageDimensions(base64Data, mimeType) {
-    if (mimeType === "image/png") {
-        return getPngDimensions(base64Data);
-    }
-    if (mimeType === "image/jpeg") {
-        return getJpegDimensions(base64Data);
-    }
-    if (mimeType === "image/gif") {
-        return getGifDimensions(base64Data);
-    }
-    if (mimeType === "image/webp") {
-        return getWebpDimensions(base64Data);
-    }
-    return null;
-}
-export function renderImage(base64Data, imageDimensions, options = {}) {
-    const caps = getCapabilities();
-    if (!caps.images) {
-        return null;
-    }
-    const maxWidth = options.maxWidthCells ?? 80;
-    const size = calculateImageCellSize(imageDimensions, maxWidth, options.maxHeightCells, getCellDimensions());
-    if (caps.images === "kitty") {
-        const sequence = encodeKitty(base64Data, {
-            columns: size.columns,
-            rows: size.rows,
-            imageId: options.imageId,
-            moveCursor: options.moveCursor,
-        });
-        return { sequence, rows: size.rows, imageId: options.imageId };
-    }
-    if (caps.images === "iterm2") {
-        const sequence = encodeITerm2(base64Data, {
-            width: size.columns,
-            height: "auto",
-            preserveAspectRatio: options.preserveAspectRatio ?? true,
-        });
-        return { sequence, rows: size.rows };
-    }
-    return null;
-}
-/**
- * Wrap text in an OSC 8 hyperlink sequence.
- * The text is rendered as a clickable hyperlink in terminals that support OSC 8
- * (Ghostty, Kitty, WezTerm, iTerm2, VSCode, and others).
- * In terminals that do not support OSC 8, the escape sequences are ignored
- * and only the plain text is displayed.
- *
- * @param text - The visible text to display
- * @param url - The URL to link to
- */
-export function hyperlink(text, url) {
-    return `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
-}
-export function imageFallback(mimeType, dimensions, filename) {
-    const parts = [];
-    if (filename)
-        parts.push(filename);
-    parts.push(`[${mimeType}]`);
-    if (dimensions)
-        parts.push(`${dimensions.widthPx}x${dimensions.heightPx}`);
-    return `[Image: ${parts.join(" ")}]`;
-}

package/dist/pi/tui/terminal.js

@@ -1,324 +0,0 @@
-import * as fs from "node:fs";
-import { createRequire } from "node:module";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { setKittyProtocolActive } from "./keys.js";
-import { StdinBuffer } from "./stdin-buffer.js";
-const cjsRequire = createRequire(import.meta.url);
-const TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;
-const TERMINAL_PROGRESS_ACTIVE_SEQUENCE = "\x1b]9;4;3\x07";
-const TERMINAL_PROGRESS_CLEAR_SEQUENCE = "\x1b]9;4;0;\x07";
-/**
- * Real terminal using process.stdin/stdout
- */
-export class ProcessTerminal {
-    wasRaw = false;
-    inputHandler;
-    resizeHandler;
-    _kittyProtocolActive = false;
-    _modifyOtherKeysActive = false;
-    stdinBuffer;
-    stdinDataHandler;
-    progressInterval;
-    writeLogPath = (() => {
-        const env = process.env.PI_TUI_WRITE_LOG || "";
-        if (!env)
-            return "";
-        try {
-            if (fs.statSync(env).isDirectory()) {
-                const now = new Date();
-                const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}_${String(now.getHours()).padStart(2, "0")}-${String(now.getMinutes()).padStart(2, "0")}-${String(now.getSeconds()).padStart(2, "0")}`;
-                return path.join(env, `tui-${ts}-${process.pid}.log`);
-            }
-        }
-        catch {
-            // Not an existing directory - use as-is (file path)
-        }
-        return env;
-    })();
-    get kittyProtocolActive() {
-        return this._kittyProtocolActive;
-    }
-    start(onInput, onResize) {
-        this.inputHandler = onInput;
-        this.resizeHandler = onResize;
-        // Save previous state and enable raw mode
-        this.wasRaw = process.stdin.isRaw || false;
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(true);
-        }
-        process.stdin.setEncoding("utf8");
-        process.stdin.resume();
-        // Enable bracketed paste mode - terminal will wrap pastes in \x1b[200~ ... \x1b[201~
-        process.stdout.write("\x1b[?2004h");
-        // Set up resize handler immediately
-        process.stdout.on("resize", this.resizeHandler);
-        // Refresh terminal dimensions - they may be stale after suspend/resume
-        // (SIGWINCH is lost while process is stopped). Unix only.
-        if (process.platform !== "win32") {
-            process.kill(process.pid, "SIGWINCH");
-        }
-        // On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends
-        // VT escape sequences (e.g. \x1b[Z for Shift+Tab) instead of raw console
-        // events that lose modifier information. Must run AFTER setRawMode(true)
-        // since that resets console mode flags.
-        this.enableWindowsVTInput();
-        // Query and enable Kitty keyboard protocol
-        // The query handler intercepts input temporarily, then installs the user's handler
-        // See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
-        this.queryAndEnableKittyProtocol();
-    }
-    /**
-     * Set up StdinBuffer to split batched input into individual sequences.
-     * This ensures components receive single events, making matchesKey/isKeyRelease work correctly.
-     *
-     * Also watches for Kitty protocol response and enables it when detected.
-     * This is done here (after stdinBuffer parsing) rather than on raw stdin
-     * to handle the case where the response arrives split across multiple events.
-     */
-    setupStdinBuffer() {
-        this.stdinBuffer = new StdinBuffer({ timeout: 10 });
-        // Kitty protocol response pattern: \x1b[?<flags>u
-        const kittyResponsePattern = /^\x1b\[\?(\d+)u$/;
-        // Forward individual sequences to the input handler
-        this.stdinBuffer.on("data", (sequence) => {
-            // Check for Kitty protocol response (only if not already enabled)
-            if (!this._kittyProtocolActive) {
-                const match = sequence.match(kittyResponsePattern);
-                if (match) {
-                    this._kittyProtocolActive = true;
-                    setKittyProtocolActive(true);
-                    // Enable Kitty keyboard protocol (push flags)
-                    // Flag 1 = disambiguate escape codes
-                    // Flag 2 = report event types (press/repeat/release)
-                    // Flag 4 = report alternate keys (shifted key, base layout key)
-                    // Base layout key enables shortcuts to work with non-Latin keyboard layouts
-                    process.stdout.write("\x1b[>7u");
-                    return; // Don't forward protocol response to TUI
-                }
-            }
-            if (this.inputHandler) {
-                this.inputHandler(sequence);
-            }
-        });
-        // Re-wrap paste content with bracketed paste markers for existing editor handling
-        this.stdinBuffer.on("paste", (content) => {
-            if (this.inputHandler) {
-                this.inputHandler(`\x1b[200~${content}\x1b[201~`);
-            }
-        });
-        // Handler that pipes stdin data through the buffer
-        this.stdinDataHandler = (data) => {
-            this.stdinBuffer.process(data);
-        };
-    }
-    /**
-     * Query terminal for Kitty keyboard protocol support and enable if available.
-     *
-     * Sends CSI ? u to query current flags. If terminal responds with CSI ? <flags> u,
-     * it supports the protocol and we enable it with CSI > 1 u.
-     *
-     * If no Kitty response arrives shortly after startup, fall back to enabling
-     * xterm modifyOtherKeys mode 2. This is needed for tmux, which can forward
-     * modified enter keys as CSI-u when extended-keys is enabled, but may not
-     * answer the Kitty protocol query.
-     *
-     * The response is detected in setupStdinBuffer's data handler, which properly
-     * handles the case where the response arrives split across multiple stdin events.
-     */
-    queryAndEnableKittyProtocol() {
-        this.setupStdinBuffer();
-        process.stdin.on("data", this.stdinDataHandler);
-        process.stdout.write("\x1b[?u");
-        setTimeout(() => {
-            if (!this._kittyProtocolActive && !this._modifyOtherKeysActive) {
-                process.stdout.write("\x1b[>4;2m");
-                this._modifyOtherKeysActive = true;
-            }
-        }, 150);
-    }
-    /**
-     * On Windows, add ENABLE_VIRTUAL_TERMINAL_INPUT (0x0200) to the stdin
-     * console handle so the terminal sends VT sequences for modified keys
-     * (e.g. \x1b[Z for Shift+Tab). Without this, libuv's ReadConsoleInputW
-     * discards modifier state and Shift+Tab arrives as plain \t.
-     */
-    enableWindowsVTInput() {
-        if (process.platform !== "win32")
-            return;
-        try {
-            const arch = process.arch;
-            if (arch !== "x64" && arch !== "arm64")
-                return;
-            // Dynamic require so non-Windows and bundled/browser paths never load the
-            // native helper. In the npm package native/ is next to dist/; in compiled
-            // binary archives native/ is copied next to the executable.
-            const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-            const nativePath = path.join("native", "win32", "prebuilds", `win32-${arch}`, "win32-console-mode.node");
-            const candidates = [
-                path.join(moduleDir, "..", nativePath),
-                path.join(moduleDir, nativePath),
-                path.join(path.dirname(process.execPath), nativePath),
-            ];
-            for (const modulePath of candidates) {
-                try {
-                    const helper = cjsRequire(modulePath);
-                    helper.enableVirtualTerminalInput?.();
-                    return;
-                }
-                catch {
-                    // Try the next possible packaging location.
-                }
-            }
-        }
-        catch {
-            // Native helper not available — Shift+Tab won't be distinguishable from Tab.
-        }
-    }
-    async drainInput(maxMs = 1000, idleMs = 50) {
-        if (this._kittyProtocolActive) {
-            // Disable Kitty keyboard protocol first so any late key releases
-            // do not generate new Kitty escape sequences.
-            process.stdout.write("\x1b[<u");
-            this._kittyProtocolActive = false;
-            setKittyProtocolActive(false);
-        }
-        if (this._modifyOtherKeysActive) {
-            process.stdout.write("\x1b[>4;0m");
-            this._modifyOtherKeysActive = false;
-        }
-        const previousHandler = this.inputHandler;
-        this.inputHandler = undefined;
-        let lastDataTime = Date.now();
-        const onData = () => {
-            lastDataTime = Date.now();
-        };
-        process.stdin.on("data", onData);
-        const endTime = Date.now() + maxMs;
-        try {
-            while (true) {
-                const now = Date.now();
-                const timeLeft = endTime - now;
-                if (timeLeft <= 0)
-                    break;
-                if (now - lastDataTime >= idleMs)
-                    break;
-                await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));
-            }
-        }
-        finally {
-            process.stdin.removeListener("data", onData);
-            this.inputHandler = previousHandler;
-        }
-    }
-    stop() {
-        if (this.clearProgressInterval()) {
-            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
-        }
-        // Disable bracketed paste mode
-        process.stdout.write("\x1b[?2004l");
-        // Disable Kitty keyboard protocol if not already done by drainInput()
-        if (this._kittyProtocolActive) {
-            process.stdout.write("\x1b[<u");
-            this._kittyProtocolActive = false;
-            setKittyProtocolActive(false);
-        }
-        if (this._modifyOtherKeysActive) {
-            process.stdout.write("\x1b[>4;0m");
-            this._modifyOtherKeysActive = false;
-        }
-        // Clean up StdinBuffer
-        if (this.stdinBuffer) {
-            this.stdinBuffer.destroy();
-            this.stdinBuffer = undefined;
-        }
-        // Remove event handlers
-        if (this.stdinDataHandler) {
-            process.stdin.removeListener("data", this.stdinDataHandler);
-            this.stdinDataHandler = undefined;
-        }
-        this.inputHandler = undefined;
-        if (this.resizeHandler) {
-            process.stdout.removeListener("resize", this.resizeHandler);
-            this.resizeHandler = undefined;
-        }
-        // Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being
-        // re-interpreted after raw mode is disabled. This fixes a race condition
-        // where Ctrl+D could close the parent shell over SSH.
-        process.stdin.pause();
-        // Restore raw mode state
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(this.wasRaw);
-        }
-    }
-    write(data) {
-        process.stdout.write(data);
-        if (this.writeLogPath) {
-            try {
-                fs.appendFileSync(this.writeLogPath, data, { encoding: "utf8" });
-            }
-            catch {
-                // Ignore logging errors
-            }
-        }
-    }
-    get columns() {
-        return process.stdout.columns || Number(process.env.COLUMNS) || 80;
-    }
-    get rows() {
-        return process.stdout.rows || Number(process.env.LINES) || 24;
-    }
-    moveBy(lines) {
-        if (lines > 0) {
-            // Move down
-            process.stdout.write(`\x1b[${lines}B`);
-        }
-        else if (lines < 0) {
-            // Move up
-            process.stdout.write(`\x1b[${-lines}A`);
-        }
-        // lines === 0: no movement
-    }
-    hideCursor() {
-        process.stdout.write("\x1b[?25l");
-    }
-    showCursor() {
-        process.stdout.write("\x1b[?25h");
-    }
-    clearLine() {
-        process.stdout.write("\x1b[K");
-    }
-    clearFromCursor() {
-        process.stdout.write("\x1b[J");
-    }
-    clearScreen() {
-        process.stdout.write("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
-    }
-    setTitle(title) {
-        // OSC 0;title BEL - set terminal window title
-        process.stdout.write(`\x1b]0;${title}\x07`);
-    }
-    setProgress(active) {
-        if (active) {
-            // OSC 9;4;3 - indeterminate progress
-            process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
-            if (!this.progressInterval) {
-                this.progressInterval = setInterval(() => {
-                    process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
-                }, TERMINAL_PROGRESS_KEEPALIVE_MS);
-            }
-        }
-        else {
-            this.clearProgressInterval();
-            // OSC 9;4;0 - clear progress
-            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
-        }
-    }
-    clearProgressInterval() {
-        if (!this.progressInterval)
-            return false;
-        clearInterval(this.progressInterval);
-        this.progressInterval = undefined;
-        return true;
-    }
-}