@trukhinyuri/gemini-pp 0.27.0-nightly.20260121.97aac696f

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

@@ -0,0 +1,47 @@
+/**
+ * @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;
+export declare function toCodePoints(str: string): string[];
+export declare function cpLen(str: string): number;
+export declare function cpSlice(str: string, start: number, end?: number): string;
+/**
+ * Strip characters that can break terminal rendering.
+ *
+ * Uses Node.js built-in stripVTControlCharacters to handle VT sequences,
+ * then filters remaining control characters that can disrupt display.
+ *
+ * Characters stripped:
+ * - ANSI escape sequences (via strip-ansi)
+ * - VT control sequences (via Node.js util.stripVTControlCharacters)
+ * - C0 control chars (0x00-0x1F) except CR/LF which are handled elsewhere
+ * - C1 control chars (0x80-0x9F) that can cause display issues
+ *
+ * Characters preserved:
+ * - All printable Unicode including emojis
+ * - 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 list-like UI components (e.g. Help, Suggestions).
+ * Removes ANSI codes, collapses whitespace characters into a single space, and optionally truncates.
+ */
+export declare function sanitizeForListDisplay(str: string, maxLength?: number): string;
+/**
+ * Cached version of stringWidth function for better performance
+ */
+export declare const getCachedStringWidth: (str: string) => number;
+/**
+ * Clear the string width cache
+ */
+export declare const clearStringWidthCache: () => void;
+export declare function escapeAnsiCtrlCodes<T>(obj: T): T;

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

@@ -0,0 +1,213 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import stripAnsi from 'strip-ansi';
+import ansiRegex from 'ansi-regex';
+import { stripVTControlCharacters } from 'node:util';
+import stringWidth from 'string-width';
+import { LRUCache } from 'mnemonist';
+import { LRU_BUFFER_PERF_CACHE_LIMIT } from '../constants.js';
+/**
+ * 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 const getAsciiArtWidth = (asciiArt) => {
+    if (!asciiArt) {
+        return 0;
+    }
+    const lines = asciiArt.split('\n');
+    return Math.max(...lines.map((line) => line.length));
+};
+/*
+ * -------------------------------------------------------------------------
+ *  Unicode‑aware helpers (work at the code‑point level rather than UTF‑16
+ *  code units so that surrogate‑pair emoji count as one "column".)
+ * ---------------------------------------------------------------------- */
+// Cache for code points
+const MAX_STRING_LENGTH_TO_CACHE = 1000;
+const codePointsCache = new LRUCache(LRU_BUFFER_PERF_CACHE_LIMIT);
+export function toCodePoints(str) {
+    // ASCII fast path - check if all chars are ASCII (0-127)
+    let isAscii = true;
+    for (let i = 0; i < str.length; i++) {
+        if (str.charCodeAt(i) > 127) {
+            isAscii = false;
+            break;
+        }
+    }
+    if (isAscii) {
+        return str.split('');
+    }
+    // Cache short strings
+    if (str.length <= MAX_STRING_LENGTH_TO_CACHE) {
+        const cached = codePointsCache.get(str);
+        if (cached !== undefined) {
+            return cached;
+        }
+    }
+    const result = Array.from(str);
+    // Cache result
+    if (str.length <= MAX_STRING_LENGTH_TO_CACHE) {
+        codePointsCache.set(str, result);
+    }
+    return result;
+}
+export function cpLen(str) {
+    return toCodePoints(str).length;
+}
+export function cpSlice(str, start, end) {
+    // Slice by code‑point indices and re‑join.
+    const arr = toCodePoints(str).slice(start, end);
+    return arr.join('');
+}
+/**
+ * Strip characters that can break terminal rendering.
+ *
+ * Uses Node.js built-in stripVTControlCharacters to handle VT sequences,
+ * then filters remaining control characters that can disrupt display.
+ *
+ * Characters stripped:
+ * - ANSI escape sequences (via strip-ansi)
+ * - VT control sequences (via Node.js util.stripVTControlCharacters)
+ * - C0 control chars (0x00-0x1F) except CR/LF which are handled elsewhere
+ * - C1 control chars (0x80-0x9F) that can cause display issues
+ *
+ * Characters preserved:
+ * - All printable Unicode including emojis
+ * - DEL (0x7F) - handled functionally by applyOperations, not a display issue
+ * - CR/LF (0x0D/0x0A) - needed for line breaks
+ * - TAB (0x09) - preserve tabs
+ */
+export function stripUnsafeCharacters(str) {
+    const strippedAnsi = stripAnsi(str);
+    const strippedVT = stripVTControlCharacters(strippedAnsi);
+    return toCodePoints(strippedVT)
+        .filter((char) => {
+        const code = char.codePointAt(0);
+        if (code === undefined)
+            return false;
+        // Preserve CR/LF/TAB for line handling
+        if (code === 0x0a || code === 0x0d || code === 0x09)
+            return true;
+        // Remove C0 control chars (except CR/LF) that can break display
+        // Examples: BELL(0x07) makes noise, BS(0x08) moves cursor, VT(0x0B), FF(0x0C)
+        if (code >= 0x00 && code <= 0x1f)
+            return false;
+        // Remove C1 control chars (0x80-0x9f) - legacy 8-bit control codes
+        if (code >= 0x80 && code <= 0x9f)
+            return false;
+        // Preserve DEL (0x7f) - it's handled functionally by applyOperations as backspace
+        // and doesn't cause rendering issues when displayed
+        // Preserve all other characters including Unicode/emojis
+        return true;
+    })
+        .join('');
+}
+/**
+ * Sanitize a string for display in list-like UI components (e.g. Help, Suggestions).
+ * Removes ANSI codes, collapses whitespace characters into a single space, and optionally truncates.
+ */
+export function sanitizeForListDisplay(str, maxLength) {
+    if (!str) {
+        return '';
+    }
+    let sanitized = stripAnsi(str).replace(/\s+/g, ' ');
+    if (maxLength && sanitized.length > maxLength) {
+        sanitized = sanitized.substring(0, maxLength - 3) + '...';
+    }
+    return sanitized;
+}
+const stringWidthCache = new LRUCache(LRU_BUFFER_PERF_CACHE_LIMIT);
+/**
+ * Cached version of stringWidth function for better performance
+ */
+export const getCachedStringWidth = (str) => {
+    // ASCII printable chars (32-126) have width 1.
+    // This is a very frequent path, so we use a fast numeric check.
+    if (str.length === 1) {
+        const code = str.charCodeAt(0);
+        if (code >= 0x20 && code <= 0x7e) {
+            return 1;
+        }
+    }
+    const cached = stringWidthCache.get(str);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let width;
+    try {
+        width = stringWidth(str);
+    }
+    catch {
+        // Fallback for characters that cause string-width to crash (e.g. U+0602)
+        // See: https://github.com/google-gemini/gemini-cli/issues/16418
+        width = toCodePoints(stripAnsi(str)).length;
+    }
+    stringWidthCache.set(str, width);
+    return width;
+};
+/**
+ * Clear the string width cache
+ */
+export const clearStringWidthCache = () => {
+    stringWidthCache.clear();
+};
+const regex = ansiRegex();
+/* Recursively traverses a JSON-like structure (objects, arrays, primitives)
+ * and escapes all ANSI control characters found in any string values.
+ *
+ * This function is designed to be robust, handling deeply nested objects and
+ * arrays. It applies a regex-based replacement to all string values to
+ * safely escape control characters.
+ *
+ * To optimize performance, this function uses a "copy-on-write" strategy.
+ * It avoids allocating new objects or arrays if no nested string values
+ * required escaping, returning the original object reference in such cases.
+ *
+ * @param obj The JSON-like value (object, array, string, etc.) to traverse.
+ * @returns A new value with all nested string fields escaped, or the
+ * original `obj` reference if no changes were necessary.
+ */
+export function escapeAnsiCtrlCodes(obj) {
+    if (typeof obj === 'string') {
+        if (obj.search(regex) === -1) {
+            return obj; // No changes return original string
+        }
+        regex.lastIndex = 0; // needed for global regex
+        return obj.replace(regex, (match) => JSON.stringify(match).slice(1, -1));
+    }
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        let newArr = null;
+        for (let i = 0; i < obj.length; i++) {
+            const value = obj[i];
+            const escapedValue = escapeAnsiCtrlCodes(value);
+            if (escapedValue !== value) {
+                if (newArr === null) {
+                    newArr = [...obj];
+                }
+                newArr[i] = escapedValue;
+            }
+        }
+        return (newArr !== null ? newArr : obj);
+    }
+    let newObj = null;
+    const keys = Object.keys(obj);
+    for (const key of keys) {
+        const value = obj[key];
+        const escapedValue = escapeAnsiCtrlCodes(value);
+        if (escapedValue !== value) {
+            if (newObj === null) {
+                newObj = { ...obj };
+            }
+            newObj[key] = escapedValue;
+        }
+    }
+    return newObj !== null ? newObj : obj;
+}
+//# sourceMappingURL=textUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textUtils.js","sourceRoot":"","sources":["../../../../src/ui/utils/textUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF;;;;4EAI4E;AAE5E,wBAAwB;AACxB,MAAM,0BAA0B,GAAG,IAAI,CAAC;AACxC,MAAM,eAAe,GAAG,IAAI,QAAQ,CAClC,2BAA2B,CAC5B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,yDAAyD;IACzD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC;YAC5B,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,sBAAsB;IACtB,IAAI,GAAG,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/B,eAAe;IACf,IAAI,GAAG,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QAC7C,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,GAAY;IAC9D,2CAA2C;IAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;IAE1D,OAAO,YAAY,CAAC,UAAU,CAAC;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAErC,uCAAuC;QACvC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEjE,gEAAgE;QAChE,8EAA8E;QAC9E,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAE/C,mEAAmE;QACnE,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAE/C,kFAAkF;QAClF,oDAAoD;QAEpD,yDAAyD;QACzD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,SAAkB;IAElB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpD,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC9C,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAC5D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,gBAAgB,GAAG,IAAI,QAAQ,CACnC,2BAA2B,CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC1D,+CAA+C;IAC/C,gEAAgE;IAChE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,gEAAgE;QAChE,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,CAAC;IAED,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAS,EAAE;IAC9C,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAI,GAAM;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,CAAC,oCAAoC;QAClD,CAAC;QAED,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,0BAA0B;QAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAClC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9B,CAAC;IACT,CAAC;IAED,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,MAAM,GAAqB,IAAI,CAAC;QAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;gBAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;gBACpB,CAAC;gBACD,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAM,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,GAAa,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAEhD,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;YAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YACtB,CAAC;YACA,MAAkC,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/utils/textUtils.test.js

@@ -0,0 +1,168 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { escapeAnsiCtrlCodes, stripUnsafeCharacters, getCachedStringWidth, sanitizeForListDisplay, } from './textUtils.js';
+describe('textUtils', () => {
+    describe('sanitizeForListDisplay', () => {
+        it('should strip ANSI codes and replace newlines/tabs with spaces', () => {
+            const input = '\u001b[31mLine 1\nLine 2\tTabbed\r\nEnd\u001b[0m';
+            expect(sanitizeForListDisplay(input)).toBe('Line 1 Line 2 Tabbed End');
+        });
+        it('should collapse multiple consecutive whitespace characters into a single space', () => {
+            const input = 'Multiple \n\n newlines and \t\t tabs';
+            expect(sanitizeForListDisplay(input)).toBe('Multiple newlines and tabs');
+        });
+        it('should truncate long strings', () => {
+            const longInput = 'a'.repeat(50);
+            expect(sanitizeForListDisplay(longInput, 20)).toBe('a'.repeat(17) + '...');
+        });
+        it('should handle empty or null input', () => {
+            expect(sanitizeForListDisplay('')).toBe('');
+            expect(sanitizeForListDisplay(null)).toBe('');
+        });
+    });
+    describe('getCachedStringWidth', () => {
+        it('should handle unicode characters that crash string-width', () => {
+            // U+0602 caused string-width to crash (see #16418)
+            const char = '؂';
+            expect(getCachedStringWidth(char)).toBe(1);
+        });
+        it('should handle unicode characters that crash string-width with ANSI codes', () => {
+            const charWithAnsi = '\u001b[31m' + '؂' + '\u001b[0m';
+            expect(getCachedStringWidth(charWithAnsi)).toBe(1);
+        });
+    });
+    describe('stripUnsafeCharacters', () => {
+        it('should not strip tab characters', () => {
+            const input = 'hello	world';
+            expect(stripUnsafeCharacters(input)).toBe('hello	world');
+        });
+    });
+    describe('escapeAnsiCtrlCodes', () => {
+        describe('escapeAnsiCtrlCodes string case study', () => {
+            it('should replace ANSI escape codes with a visible representation', () => {
+                const text = '\u001b[31mHello\u001b[0m';
+                const expected = '\\u001b[31mHello\\u001b[0m';
+                expect(escapeAnsiCtrlCodes(text)).toBe(expected);
+                const text2 = "sh -e 'good && bad# \u001b[9D\u001b[K && good";
+                const expected2 = "sh -e 'good && bad# \\u001b[9D\\u001b[K && good";
+                expect(escapeAnsiCtrlCodes(text2)).toBe(expected2);
+            });
+            it('should not change a string with no ANSI codes', () => {
+                const text = 'Hello, world!';
+                expect(escapeAnsiCtrlCodes(text)).toBe(text);
+            });
+            it('should handle an empty string', () => {
+                expect(escapeAnsiCtrlCodes('')).toBe('');
+            });
+            describe('toolConfirmationDetails case study', () => {
+                it('should sanitize command and rootCommand for exec type', () => {
+                    const details = {
+                        title: '\u001b[34mfake-title\u001b[0m',
+                        type: 'exec',
+                        command: '\u001b[31mmls -l\u001b[0m',
+                        rootCommand: '\u001b[32msudo apt-get update\u001b[0m',
+                        rootCommands: ['sudo'],
+                        onConfirm: async () => { },
+                    };
+                    const sanitized = escapeAnsiCtrlCodes(details);
+                    if (sanitized.type === 'exec') {
+                        expect(sanitized.title).toBe('\\u001b[34mfake-title\\u001b[0m');
+                        expect(sanitized.command).toBe('\\u001b[31mmls -l\\u001b[0m');
+                        expect(sanitized.rootCommand).toBe('\\u001b[32msudo apt-get update\\u001b[0m');
+                    }
+                });
+                it('should sanitize properties for edit type', () => {
+                    const details = {
+                        type: 'edit',
+                        title: '\u001b[34mEdit File\u001b[0m',
+                        fileName: '\u001b[31mfile.txt\u001b[0m',
+                        filePath: '/path/to/\u001b[32mfile.txt\u001b[0m',
+                        fileDiff: 'diff --git a/file.txt b/file.txt\n--- a/\u001b[33mfile.txt\u001b[0m\n+++ b/file.txt',
+                        onConfirm: async () => { },
+                    };
+                    const sanitized = escapeAnsiCtrlCodes(details);
+                    if (sanitized.type === 'edit') {
+                        expect(sanitized.title).toBe('\\u001b[34mEdit File\\u001b[0m');
+                        expect(sanitized.fileName).toBe('\\u001b[31mfile.txt\\u001b[0m');
+                        expect(sanitized.filePath).toBe('/path/to/\\u001b[32mfile.txt\\u001b[0m');
+                        expect(sanitized.fileDiff).toBe('diff --git a/file.txt b/file.txt\n--- a/\\u001b[33mfile.txt\\u001b[0m\n+++ b/file.txt');
+                    }
+                });
+                it('should sanitize properties for mcp type', () => {
+                    const details = {
+                        type: 'mcp',
+                        title: '\u001b[34mCloud Run\u001b[0m',
+                        serverName: '\u001b[31mmy-server\u001b[0m',
+                        toolName: '\u001b[32mdeploy\u001b[0m',
+                        toolDisplayName: '\u001b[33mDeploy Service\u001b[0m',
+                        onConfirm: async () => { },
+                    };
+                    const sanitized = escapeAnsiCtrlCodes(details);
+                    if (sanitized.type === 'mcp') {
+                        expect(sanitized.title).toBe('\\u001b[34mCloud Run\\u001b[0m');
+                        expect(sanitized.serverName).toBe('\\u001b[31mmy-server\\u001b[0m');
+                        expect(sanitized.toolName).toBe('\\u001b[32mdeploy\\u001b[0m');
+                        expect(sanitized.toolDisplayName).toBe('\\u001b[33mDeploy Service\\u001b[0m');
+                    }
+                });
+                it('should sanitize properties for info type', () => {
+                    const details = {
+                        type: 'info',
+                        title: '\u001b[34mWeb Search\u001b[0m',
+                        prompt: '\u001b[31mSearch for cats\u001b[0m',
+                        urls: ['https://\u001b[32mgoogle.com\u001b[0m'],
+                        onConfirm: async () => { },
+                    };
+                    const sanitized = escapeAnsiCtrlCodes(details);
+                    if (sanitized.type === 'info') {
+                        expect(sanitized.title).toBe('\\u001b[34mWeb Search\\u001b[0m');
+                        expect(sanitized.prompt).toBe('\\u001b[31mSearch for cats\\u001b[0m');
+                        expect(sanitized.urls?.[0]).toBe('https://\\u001b[32mgoogle.com\\u001b[0m');
+                    }
+                });
+            });
+            it('should not change the object if no sanitization is needed', () => {
+                const details = {
+                    type: 'info',
+                    title: 'Web Search',
+                    prompt: 'Search for cats',
+                    urls: ['https://google.com'],
+                    onConfirm: async () => { },
+                };
+                const sanitized = escapeAnsiCtrlCodes(details);
+                expect(sanitized).toBe(details);
+            });
+            it('should handle nested objects and arrays', () => {
+                const details = {
+                    a: '\u001b[31mred\u001b[0m',
+                    b: {
+                        c: '\u001b[32mgreen\u001b[0m',
+                        d: ['\u001b[33myellow\u001b[0m', { e: '\u001b[34mblue\u001b[0m' }],
+                    },
+                    f: 123,
+                    g: null,
+                    h: () => '\u001b[35mpurple\u001b[0m',
+                };
+                const sanitized = escapeAnsiCtrlCodes(details);
+                expect(sanitized.a).toBe('\\u001b[31mred\\u001b[0m');
+                if (typeof sanitized.b === 'object' && sanitized.b !== null) {
+                    const b = sanitized.b;
+                    expect(b.c).toBe('\\u001b[32mgreen\\u001b[0m');
+                    expect(b.d[0]).toBe('\\u001b[33myellow\\u001b[0m');
+                    if (typeof b.d[1] === 'object' && b.d[1] !== null) {
+                        const e = b.d[1];
+                        expect(e.e).toBe('\\u001b[34mblue\\u001b[0m');
+                    }
+                }
+                expect(sanitized.f).toBe(123);
+                expect(sanitized.g).toBe(null);
+                expect(sanitized.h()).toBe('\u001b[35mpurple\u001b[0m');
+            });
+        });
+    });
+});
+//# sourceMappingURL=textUtils.test.js.map

package/dist/src/ui/utils/textUtils.test.js.map

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

package/dist/src/ui/utils/ui-sizing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type LoadedSettings } from '../../config/settings.js';
+export declare const calculateMainAreaWidth: (terminalWidth: number, settings: LoadedSettings) => number;

package/dist/src/ui/utils/ui-sizing.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { lerp } from '../../utils/math.js';
+import {} from '../../config/settings.js';
+import { isAlternateBufferEnabled } from '../hooks/useAlternateBuffer.js';
+const getMainAreaWidthInternal = (terminalWidth) => {
+    if (terminalWidth <= 80) {
+        return Math.round(0.98 * terminalWidth);
+    }
+    if (terminalWidth >= 132) {
+        return Math.round(0.9 * terminalWidth);
+    }
+    // Linearly interpolate between 80 columns (98%) and 132 columns (90%).
+    const t = (terminalWidth - 80) / (132 - 80);
+    const percentage = lerp(98, 90, t);
+    return Math.round(percentage * terminalWidth * 0.01);
+};
+export const calculateMainAreaWidth = (terminalWidth, settings) => {
+    if (settings.merged.ui.useFullWidth) {
+        if (isAlternateBufferEnabled(settings)) {
+            return terminalWidth - 1;
+        }
+        return terminalWidth;
+    }
+    return getMainAreaWidthInternal(terminalWidth);
+};
+//# sourceMappingURL=ui-sizing.js.map

package/dist/src/ui/utils/ui-sizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-sizing.js","sourceRoot":"","sources":["../../../../src/ui/utils/ui-sizing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAuB,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,wBAAwB,GAAG,CAAC,aAAqB,EAAU,EAAE;IACjE,IAAI,aAAa,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC;IACzC,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,aAAqB,EACrB,QAAwB,EAChB,EAAE;IACV,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,OAAO,aAAa,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,wBAAwB,CAAC,aAAa,CAAC,CAAC;AACjD,CAAC,CAAC"}

package/dist/src/ui/utils/ui-sizing.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/utils/ui-sizing.test.js

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { calculateMainAreaWidth } from './ui-sizing.js';
+import {} from '../../config/settings.js';
+// Mock dependencies
+const mocks = vi.hoisted(() => ({
+    isAlternateBufferEnabled: vi.fn(),
+}));
+vi.mock('../hooks/useAlternateBuffer.js', () => ({
+    isAlternateBufferEnabled: mocks.isAlternateBufferEnabled,
+}));
+describe('ui-sizing', () => {
+    const createSettings = (useFullWidth) => ({
+        merged: {
+            ui: {
+                useFullWidth,
+            },
+        },
+    });
+    describe('calculateMainAreaWidth', () => {
+        it.each([
+            // width, useFullWidth, alternateBuffer, expected
+            [80, true, false, 80],
+            [100, true, false, 100],
+            [80, true, true, 79], // -1 for alternate buffer
+            [100, true, true, 99],
+            // Default behavior (useFullWidth true)
+            [100, true, false, 100],
+            // useFullWidth: false (Smart sizing)
+            [80, false, false, 78], // 98% of 80
+            [132, false, false, 119], // 90% of 132
+            [200, false, false, 180], // 90% of 200 (>= 132)
+            // Interpolation check
+            [106, false, false, 100], // Approx middle
+        ])('should return %i when width=%i, useFullWidth=%s, altBuffer=%s', (width, useFullWidth, altBuffer, expected) => {
+            mocks.isAlternateBufferEnabled.mockReturnValue(altBuffer);
+            const settings = createSettings(useFullWidth);
+            expect(calculateMainAreaWidth(width, settings)).toBe(expected);
+        });
+        it('should match snapshot for interpolation range', () => {
+            mocks.isAlternateBufferEnabled.mockReturnValue(false);
+            const settings = createSettings(false);
+            const results = {};
+            // Test range from 80 to 132
+            for (let w = 80; w <= 132; w += 4) {
+                results[w] = calculateMainAreaWidth(w, settings);
+            }
+            expect(results).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=ui-sizing.test.js.map

package/dist/src/ui/utils/ui-sizing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-sizing.test.js","sourceRoot":"","sources":["../../../../src/ui/utils/ui-sizing.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAuB,MAAM,0BAA0B,CAAC;AAE/D,oBAAoB;AACpB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9B,wBAAwB,EAAE,EAAE,CAAC,EAAE,EAAE;CAClC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;CACzD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,cAAc,GAAG,CAAC,YAAsB,EAAkB,EAAE,CAChE,CAAC;QACC,MAAM,EAAE;YACN,EAAE,EAAE;gBACF,YAAY;aACb;SACF;KACF,CAA8B,CAAC;IAElC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,IAAI,CAAC;YACN,iDAAiD;YACjD,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrB,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;YACvB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,0BAA0B;YAChD,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YAErB,uCAAuC;YACvC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;YAEvB,qCAAqC;YACrC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,YAAY;YACpC,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,aAAa;YACvC,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,sBAAsB;YAEhD,sBAAsB;YACtB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,gBAAgB;SAC3C,CAAC,CACA,+DAA+D,EAC/D,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC3C,KAAK,CAAC,wBAAwB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE9C,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC,CACF,CAAC;QAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,KAAK,CAAC,wBAAwB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAEvC,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,4BAA4B;YAC5B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import semver from 'semver';
+import type { LoadedSettings } from '../../config/settings.js';
+export declare const FETCH_TIMEOUT_MS = 2000;
+export interface UpdateInfo {
+    latest: string;
+    current: string;
+    name: string;
+    type?: semver.ReleaseType;
+}
+export interface UpdateObject {
+    message: string;
+    update: UpdateInfo;
+}
+export declare function checkForUpdates(settings: LoadedSettings): Promise<UpdateObject | null>;