@quantum-ai/gemini-cli 0.45.8 → 0.45.9

package/dist/src/ui/utils/terminalSetup.js

@@ -1,419 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Terminal setup utility for configuring Shift+Enter and Ctrl+Enter support.
- *
- * This module provides automatic detection and configuration of various terminal
- * emulators to support multiline input through modified Enter keys.
- *
- * Supported terminals:
- * - VS Code: Configures keybindings.json to send \\\r\n
- * - Cursor: Configures keybindings.json to send \\\r\n (VS Code fork)
- * - Windsurf: Configures keybindings.json to send \\\r\n (VS Code fork)
- * - Antigravity: Configures keybindings.json to send \\\r\n (VS Code fork)
- *
- * For VS Code and its forks:
- * - Shift+Enter: Sends \\\r\n (backslash followed by CRLF)
- * - Ctrl+Enter: Sends \\\r\n (backslash followed by CRLF)
- *
- * The module will not modify existing shift+enter or ctrl+enter keybindings
- * to avoid conflicts with user customizations.
- */
-import { promises as fs } from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { terminalCapabilityManager } from './terminalCapabilityManager.js';
-import { debugLogger, homedir } from '@google/gemini-cli-core';
-import { useEffect } from 'react';
-import { persistentState } from '../../utils/persistentState.js';
-import { requestConsentInteractive } from '../../config/extensions/consent.js';
-export const VSCODE_SHIFT_ENTER_SEQUENCE = '\\\r\n';
-const execAsync = promisify(exec);
-/**
- * Removes single-line JSON comments (// ...) from a string to allow parsing
- * VS Code style JSON files that may contain comments.
- */
-function stripJsonComments(content) {
-    // Remove single-line comments (// ...)
-    return content.replace(/^\s*\/\/.*$/gm, '');
-}
-const TERMINAL_DATA = {
-    vscode: { terminalName: 'VS Code', appName: 'Code' },
-    cursor: { terminalName: 'Cursor', appName: 'Cursor' },
-    windsurf: { terminalName: 'Windsurf', appName: 'Windsurf' },
-    antigravity: { terminalName: 'Antigravity', appName: 'Antigravity' },
-};
-/**
- * Maps a supported terminal ID to its display name and config folder name.
- */
-function getSupportedTerminalData(terminal) {
-    return TERMINAL_DATA[terminal] || null;
-}
-function isKeybinding(kb) {
-    return typeof kb === 'object' && kb !== null;
-}
-/**
- * Checks if a keybindings array contains our specific binding for a given key.
- */
-function hasOurBinding(keybindings, key) {
-    return keybindings.some((kb) => {
-        if (!isKeybinding(kb))
-            return false;
-        return (kb.key === key &&
-            kb.command === 'workbench.action.terminal.sendSequence' &&
-            kb.args?.text === VSCODE_SHIFT_ENTER_SEQUENCE);
-    });
-}
-export function getTerminalProgram() {
-    const termProgram = process.env['TERM_PROGRAM'];
-    // Check VS Code and its forks - check forks first to avoid false positives
-    // Check for Cursor-specific indicators
-    if (process.env['CURSOR_TRACE_ID'] ||
-        process.env['VSCODE_GIT_ASKPASS_MAIN']?.toLowerCase().includes('cursor')) {
-        return 'cursor';
-    }
-    // Check for Windsurf-specific indicators
-    if (process.env['VSCODE_GIT_ASKPASS_MAIN']?.toLowerCase().includes('windsurf')) {
-        return 'windsurf';
-    }
-    // Check for Antigravity-specific indicators
-    if (process.env['VSCODE_GIT_ASKPASS_MAIN']
-        ?.toLowerCase()
-        .includes('antigravity')) {
-        return 'antigravity';
-    }
-    // Check VS Code last since forks may also set VSCODE env vars
-    if (termProgram === 'vscode' || process.env['VSCODE_GIT_IPC_HANDLE']) {
-        return 'vscode';
-    }
-    return null;
-}
-// Terminal detection
-async function detectTerminal() {
-    const envTerminal = getTerminalProgram();
-    if (envTerminal) {
-        return envTerminal;
-    }
-    // Check parent process name
-    if (os.platform() !== 'win32') {
-        try {
-            const { stdout } = await execAsync('ps -o comm= -p $PPID');
-            const parentName = stdout.trim();
-            // Check forks before VS Code to avoid false positives
-            if (parentName.includes('windsurf') || parentName.includes('Windsurf'))
-                return 'windsurf';
-            if (parentName.includes('antigravity') ||
-                parentName.includes('Antigravity'))
-                return 'antigravity';
-            if (parentName.includes('cursor') || parentName.includes('Cursor'))
-                return 'cursor';
-            if (parentName.includes('code') || parentName.includes('Code'))
-                return 'vscode';
-        }
-        catch (error) {
-            // Continue detection even if process check fails
-            debugLogger.debug('Parent process detection failed:', error);
-        }
-    }
-    return null;
-}
-// Backup file helper
-async function backupFile(filePath) {
-    try {
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-        const backupPath = `${filePath}.backup.${timestamp}`;
-        await fs.copyFile(filePath, backupPath);
-    }
-    catch (error) {
-        // Log backup errors but continue with operation
-        debugLogger.warn(`Failed to create backup of ${filePath}:`, error);
-    }
-}
-// Helper function to get VS Code-style config directory
-function getVSCodeStyleConfigDir(appName) {
-    const platform = os.platform();
-    if (platform === 'darwin') {
-        return path.join(homedir(), 'Library', 'Application Support', appName, 'User');
-    }
-    else if (platform === 'win32') {
-        if (!process.env['APPDATA']) {
-            return null;
-        }
-        return path.join(process.env['APPDATA'], appName, 'User');
-    }
-    else {
-        return path.join(homedir(), '.config', appName, 'User');
-    }
-}
-// Generic VS Code-style terminal configuration
-async function configureVSCodeStyle(terminalName, appName) {
-    const configDir = getVSCodeStyleConfigDir(appName);
-    if (!configDir) {
-        return {
-            success: false,
-            message: `Could not determine ${terminalName} config path on Windows: APPDATA environment variable is not set.`,
-        };
-    }
-    const keybindingsFile = path.join(configDir, 'keybindings.json');
-    try {
-        await fs.mkdir(configDir, { recursive: true });
-        let keybindings = [];
-        try {
-            const content = await fs.readFile(keybindingsFile, 'utf8');
-            await backupFile(keybindingsFile);
-            try {
-                const cleanContent = stripJsonComments(content);
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-                const parsedContent = JSON.parse(cleanContent);
-                if (!Array.isArray(parsedContent)) {
-                    return {
-                        success: false,
-                        message: `${terminalName} keybindings.json exists but is not a valid JSON array. ` +
-                            `Please fix the file manually or delete it to allow automatic configuration.\n` +
-                            `File: ${keybindingsFile}`,
-                    };
-                }
-                keybindings = parsedContent;
-            }
-            catch (parseError) {
-                return {
-                    success: false,
-                    message: `Failed to parse ${terminalName} keybindings.json. The file contains invalid JSON.\n` +
-                        `Please fix the file manually or delete it to allow automatic configuration.\n` +
-                        `File: ${keybindingsFile}\n` +
-                        `Error: ${parseError}`,
-                };
-            }
-        }
-        catch {
-            // File doesn't exist, will create new one
-        }
-        const targetBindings = [
-            {
-                key: 'shift+enter',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
-            },
-            {
-                key: 'ctrl+enter',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
-            },
-            {
-                key: 'cmd+z',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: '\u001b[122;9u' },
-            },
-            {
-                key: 'alt+z',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: '\u001b[122;3u' },
-            },
-            {
-                key: 'shift+cmd+z',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: '\u001b[122;10u' },
-            },
-            {
-                key: 'shift+alt+z',
-                command: 'workbench.action.terminal.sendSequence',
-                when: 'terminalFocus',
-                args: { text: '\u001b[122;4u' },
-            },
-        ];
-        const results = targetBindings.map((target) => {
-            const hasOurBinding = keybindings.some((kb) => {
-                if (!isKeybinding(kb))
-                    return false;
-                return (kb.key === target.key &&
-                    kb.command === target.command &&
-                    kb.args?.text === target.args.text);
-            });
-            const existingBinding = keybindings.find((kb) => {
-                if (!isKeybinding(kb))
-                    return false;
-                return kb.key === target.key;
-            });
-            return {
-                target,
-                hasOurBinding,
-                conflict: !!existingBinding && !hasOurBinding,
-                conflictMessage: `- ${target.key.charAt(0).toUpperCase() + target.key.slice(1)} binding already exists`,
-            };
-        });
-        if (results.every((r) => r.hasOurBinding)) {
-            return {
-                success: true,
-                message: `${terminalName} keybindings already configured.`,
-            };
-        }
-        const conflicts = results.filter((r) => r.conflict);
-        if (conflicts.length > 0) {
-            return {
-                success: false,
-                message: `Existing keybindings detected. Will not modify to avoid conflicts.\n` +
-                    conflicts.map((c) => c.conflictMessage).join('\n') +
-                    '\n' +
-                    `Please check and modify manually if needed: ${keybindingsFile}`,
-            };
-        }
-        for (const { hasOurBinding, target } of results) {
-            if (!hasOurBinding) {
-                keybindings.unshift(target);
-            }
-        }
-        await fs.writeFile(keybindingsFile, JSON.stringify(keybindings, null, 4));
-        return {
-            success: true,
-            message: `Added ${targetBindings
-                .map((b) => b.key.charAt(0).toUpperCase() + b.key.slice(1))
-                .join(', ')} keybindings to ${terminalName}.\nModified: ${keybindingsFile}`,
-            requiresRestart: true,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            message: `Failed to configure ${terminalName}.\nFile: ${keybindingsFile}\nError: ${error}`,
-        };
-    }
-}
-/**
- * Determines whether it is useful to prompt the user to run /terminal-setup
- * in the current environment.
- *
- * Returns true when:
- * - Kitty/modifyOtherKeys keyboard protocol is not already enabled, and
- * - We're running inside a supported terminal (VS Code, Cursor, Windsurf, Antigravity), and
- * - The keybindings file either does not exist or does not already contain both
- *   of our Shift+Enter and Ctrl+Enter bindings.
- */
-export async function shouldPromptForTerminalSetup() {
-    if (terminalCapabilityManager.isKittyProtocolEnabled()) {
-        return false;
-    }
-    const terminal = await detectTerminal();
-    if (!terminal) {
-        return false;
-    }
-    const terminalData = getSupportedTerminalData(terminal);
-    if (!terminalData) {
-        return false;
-    }
-    const configDir = getVSCodeStyleConfigDir(terminalData.appName);
-    if (!configDir) {
-        return false;
-    }
-    const keybindingsFile = path.join(configDir, 'keybindings.json');
-    try {
-        const content = await fs.readFile(keybindingsFile, 'utf8');
-        const cleanContent = stripJsonComments(content);
-        const parsedContent = JSON.parse(cleanContent);
-        if (!Array.isArray(parsedContent)) {
-            return true;
-        }
-        const hasOurShiftEnter = hasOurBinding(parsedContent, 'shift+enter');
-        const hasOurCtrlEnter = hasOurBinding(parsedContent, 'ctrl+enter');
-        return !(hasOurShiftEnter && hasOurCtrlEnter);
-    }
-    catch (error) {
-        debugLogger.debug(`Failed to read or parse keybindings, assuming prompt is needed: ${error}`);
-        return true;
-    }
-}
-/**
- * Main terminal setup function that detects and configures the current terminal.
- *
- * This function:
- * 1. Detects the current terminal emulator
- * 2. Applies appropriate configuration for Shift+Enter and Ctrl+Enter support
- * 3. Creates backups of configuration files before modifying them
- *
- * @returns Promise<TerminalSetupResult> Result object with success status and message
- *
- * @example
- * const result = await terminalSetup();
- * if (result.success) {
- *   console.log(result.message);
- *   if (result.requiresRestart) {
- *     console.log('Please restart your terminal');
- *   }
- * }
- */
-export async function terminalSetup() {
-    // Check if terminal already has optimal keyboard support
-    if (terminalCapabilityManager.isKittyProtocolEnabled()) {
-        return {
-            success: true,
-            message: 'Your terminal is already configured for an optimal experience with multiline input (Shift+Enter and Ctrl+Enter).',
-        };
-    }
-    const terminal = await detectTerminal();
-    if (!terminal) {
-        return {
-            success: false,
-            message: 'Could not detect terminal type. Supported terminals: VS Code, Cursor, Windsurf, and Antigravity.',
-        };
-    }
-    const terminalData = getSupportedTerminalData(terminal);
-    if (!terminalData) {
-        return {
-            success: false,
-            message: `Terminal "${terminal}" is not supported yet.`,
-        };
-    }
-    return configureVSCodeStyle(terminalData.terminalName, terminalData.appName);
-}
-export const TERMINAL_SETUP_CONSENT_MESSAGE = 'Gemini CLI works best with Shift+Enter/Ctrl+Enter for multiline input. ' +
-    'Would you like to automatically configure your terminal keybindings?';
-export function formatTerminalSetupResultMessage(result) {
-    let content = result.message;
-    if (result.requiresRestart) {
-        content +=
-            '\n\nPlease restart your terminal for the changes to take effect.';
-    }
-    return content;
-}
-/**
- * Hook that shows a one-time prompt to run /terminal-setup when it would help.
- */
-export function useTerminalSetupPrompt({ addConfirmUpdateExtensionRequest, addItem, }) {
-    useEffect(() => {
-        const hasBeenPrompted = persistentState.get('terminalSetupPromptShown');
-        if (hasBeenPrompted) {
-            return;
-        }
-        let cancelled = false;
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        (async () => {
-            const shouldPrompt = await shouldPromptForTerminalSetup();
-            if (!shouldPrompt || cancelled)
-                return;
-            persistentState.set('terminalSetupPromptShown', true);
-            const confirmed = await requestConsentInteractive(TERMINAL_SETUP_CONSENT_MESSAGE, addConfirmUpdateExtensionRequest);
-            if (!confirmed || cancelled)
-                return;
-            const result = await terminalSetup();
-            if (cancelled)
-                return;
-            addItem({
-                type: result.success ? 'info' : 'error',
-                text: formatTerminalSetupResultMessage(result),
-            }, Date.now());
-        })();
-        return () => {
-            cancelled = true;
-        };
-    }, [addConfirmUpdateExtensionRequest, addItem]);
-}
-//# sourceMappingURL=terminalSetup.js.map

package/dist/src/ui/utils/terminalSetup.js.map

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

package/dist/src/ui/utils/terminalUtils.d.ts

@@ -1,23 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Returns the color depth of the current terminal.
- * Returns 24 (TrueColor) if unknown or not a TTY.
- */
-export declare function getColorDepth(): number;
-/**
- * Returns true if the terminal has low color depth (less than 24-bit).
- */
-export declare function isLowColorDepth(): boolean;
-/**
- * Returns true if the current terminal is iTerm2.
- */
-export declare function isITerm2(): boolean;
-/**
- * Resets the cached iTerm2 detection value.
- * Primarily used for testing.
- */
-export declare function resetITerm2Cache(): void;

package/dist/src/ui/utils/terminalUtils.js

@@ -1,38 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import process from 'node:process';
-/**
- * Returns the color depth of the current terminal.
- * Returns 24 (TrueColor) if unknown or not a TTY.
- */
-export function getColorDepth() {
-    return process.stdout.getColorDepth ? process.stdout.getColorDepth() : 24;
-}
-/**
- * Returns true if the terminal has low color depth (less than 24-bit).
- */
-export function isLowColorDepth() {
-    return getColorDepth() < 24;
-}
-let cachedIsITerm2;
-/**
- * Returns true if the current terminal is iTerm2.
- */
-export function isITerm2() {
-    if (cachedIsITerm2 !== undefined) {
-        return cachedIsITerm2;
-    }
-    cachedIsITerm2 = process.env['TERM_PROGRAM'] === 'iTerm.app';
-    return cachedIsITerm2;
-}
-/**
- * Resets the cached iTerm2 detection value.
- * Primarily used for testing.
- */
-export function resetITerm2Cache() {
-    cachedIsITerm2 = undefined;
-}
-//# sourceMappingURL=terminalUtils.js.map

package/dist/src/ui/utils/terminalUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminalUtils.js","sourceRoot":"","sources":["../../../../src/ui/utils/terminalUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,EAAE,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,IAAI,cAAmC,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,cAAc,KAAK,SAAS,EAAE;QAChC,OAAO,cAAc,CAAC;KACvB;IAED,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,WAAW,CAAC;IAE7D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC"}

package/dist/src/ui/utils/textOutput.d.ts

@@ -1,28 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/// <reference types="node" resolution-mode="require"/>
-export declare class TextOutput {
-    private atStartOfLine;
-    private outputStream;
-    constructor(outputStream?: NodeJS.WriteStream);
-    /**
-     * Writes a string to stdout.
-     * @param str The string to write.
-     */
-    write(str: string): void;
-    /**
-     * Writes a string to stdout, ensuring it starts on a new line.
-     * If the previous output did not end with a newline, one will be added.
-     * This prevents adding extra blank lines if a newline already exists.
-     * @param str The string to write.
-     */
-    writeOnNewLine(str: string): void;
-    /**
-     * Ensures that the output ends with a newline. If the last character
-     * written was not a newline, one will be added.
-     */
-    ensureTrailingNewline(): void;
-}

package/dist/src/ui/utils/textOutput.js

@@ -1,53 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * A utility to manage writing text to stdout, ensuring that newlines
- * are handled consistently and robustly across the application.
- */
-import stripAnsi from 'strip-ansi';
-export class TextOutput {
-    atStartOfLine = true;
-    outputStream;
-    constructor(outputStream = process.stdout) {
-        this.outputStream = outputStream;
-    }
-    /**
-     * Writes a string to stdout.
-     * @param str The string to write.
-     */
-    write(str) {
-        if (str.length === 0) {
-            return;
-        }
-        this.outputStream.write(str);
-        const strippedStr = stripAnsi(str);
-        if (strippedStr.length > 0) {
-            this.atStartOfLine = strippedStr.endsWith('\n');
-        }
-    }
-    /**
-     * Writes a string to stdout, ensuring it starts on a new line.
-     * If the previous output did not end with a newline, one will be added.
-     * This prevents adding extra blank lines if a newline already exists.
-     * @param str The string to write.
-     */
-    writeOnNewLine(str) {
-        if (!this.atStartOfLine) {
-            this.write('\n');
-        }
-        this.write(str);
-    }
-    /**
-     * Ensures that the output ends with a newline. If the last character
-     * written was not a newline, one will be added.
-     */
-    ensureTrailingNewline() {
-        if (!this.atStartOfLine) {
-            this.write('\n');
-        }
-    }
-}
-//# sourceMappingURL=textOutput.js.map

package/dist/src/ui/utils/textOutput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"textOutput.js","sourceRoot":"","sources":["../../../../src/ui/utils/textOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,MAAM,OAAO,UAAU;IACb,aAAa,GAAG,IAAI,CAAC;IACrB,YAAY,CAAqB;IAEzC,YAAY,eAAmC,OAAO,CAAC,MAAM;QAC3D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE;YACpB,OAAO;SACR;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;YAC1B,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SACjD;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAW;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAClB;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAClB;IACH,CAAC;CACF"}

package/dist/src/ui/utils/textUtils.d.ts

@@ -1,68 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Calculates the maximum width of a multi-line ASCII art string.
- * @param asciiArt The ASCII art string.
- * @returns The length of the longest line in the ASCII art.
- */
-export declare const getAsciiArtWidth: (asciiArt: string) => number;
-/**
- * Checks if a string contains only ASCII characters (0-127).
- */
-export declare function isAscii(str: string): boolean;
-export declare function toCodePoints(str: string): string[];
-export declare function cpLen(str: string): number;
-/**
- * Converts a code point index to a UTF-16 code unit offset.
- */
-export declare function cpIndexToOffset(str: string, cpIndex: number): number;
-export declare function cpSlice(str: string, start: number, end?: number): string;
-/**
- * Strip characters that can break terminal rendering.
- *
- * This is a strict sanitization function intended for general display
- * contexts. It strips all C1 control characters (0x80-0x9F) and VT
- * control sequences. For list display contexts where a more lenient
- * approach is needed (preserving C1 characters and only stripping ANSI
- * codes and newlines/tabs), use a separate function instead.
- *
- * Processing order:
- * 1. stripAnsi removes ANSI escape sequences (including 8-bit CSI 0x9B)
- * 2. Regex strips C0, C1, BiDi, and zero-width control characters
- * 3. stripVTControlCharacters removes any remaining VT sequences
- *
- * Characters stripped:
- * - ANSI escape sequences (via strip-ansi)
- * - VT control sequences (via Node.js util.stripVTControlCharacters)
- * - C0 control chars (0x00-0x1F) except TAB(0x09), LF(0x0A), CR(0x0D)
- * - C1 control chars (0x80-0x9F) that can cause display issues
- * - BiDi control chars (U+200E, U+200F, U+202A-U+202E, U+2066-U+2069)
- * - Zero-width chars (U+200B, U+FEFF)
- *
- * Characters preserved:
- * - All printable Unicode including emojis
- * - ZWJ (U+200D) - needed for complex emoji sequences
- * - ZWNJ (U+200C) - preserve zero-width non-joiner
- * - DEL (0x7F) - handled functionally by applyOperations, not a display issue
- * - CR/LF (0x0D/0x0A) - needed for line breaks
- * - TAB (0x09) - preserve tabs
- */
-export declare function stripUnsafeCharacters(str: string): string;
-/**
- * Sanitize a string for display in inline UI components (e.g. Help, Suggestions).
- * Removes ANSI codes, dangerous control characters, collapses whitespace
- * characters into a single space, and optionally truncates.
- */
-export declare function sanitizeForDisplay(str: string, maxLength?: number): string;
-/**
- * Normalizes escaped newline characters (e.g., "\\n") into actual newline characters.
- */
-export declare function normalizeEscapedNewlines(value: string): string;
-/**
- * Cached version of stringWidth function for better performance
- */
-export declare const getCachedStringWidth: (str: string) => number;
-export declare function escapeAnsiCtrlCodes<T>(obj: T): T;