@office-ai/aioncli-core 0.2.2 → 0.8.1

package/dist/src/utils/terminalSerializer.js

@@ -0,0 +1,432 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Attribute;
+(function (Attribute) {
+    Attribute[Attribute["inverse"] = 1] = "inverse";
+    Attribute[Attribute["bold"] = 2] = "bold";
+    Attribute[Attribute["italic"] = 4] = "italic";
+    Attribute[Attribute["underline"] = 8] = "underline";
+    Attribute[Attribute["dim"] = 16] = "dim";
+})(Attribute || (Attribute = {}));
+export var ColorMode;
+(function (ColorMode) {
+    ColorMode[ColorMode["DEFAULT"] = 0] = "DEFAULT";
+    ColorMode[ColorMode["PALETTE"] = 1] = "PALETTE";
+    ColorMode[ColorMode["RGB"] = 2] = "RGB";
+})(ColorMode || (ColorMode = {}));
+class Cell {
+    cell;
+    x;
+    y;
+    cursorX;
+    cursorY;
+    attributes = 0;
+    fg = 0;
+    bg = 0;
+    fgColorMode = ColorMode.DEFAULT;
+    bgColorMode = ColorMode.DEFAULT;
+    constructor(cell, x, y, cursorX, cursorY) {
+        this.cell = cell;
+        this.x = x;
+        this.y = y;
+        this.cursorX = cursorX;
+        this.cursorY = cursorY;
+        if (!cell) {
+            return;
+        }
+        if (cell.isInverse()) {
+            this.attributes += Attribute.inverse;
+        }
+        if (cell.isBold()) {
+            this.attributes += Attribute.bold;
+        }
+        if (cell.isItalic()) {
+            this.attributes += Attribute.italic;
+        }
+        if (cell.isUnderline()) {
+            this.attributes += Attribute.underline;
+        }
+        if (cell.isDim()) {
+            this.attributes += Attribute.dim;
+        }
+        if (cell.isFgRGB()) {
+            this.fgColorMode = ColorMode.RGB;
+        }
+        else if (cell.isFgPalette()) {
+            this.fgColorMode = ColorMode.PALETTE;
+        }
+        else {
+            this.fgColorMode = ColorMode.DEFAULT;
+        }
+        if (cell.isBgRGB()) {
+            this.bgColorMode = ColorMode.RGB;
+        }
+        else if (cell.isBgPalette()) {
+            this.bgColorMode = ColorMode.PALETTE;
+        }
+        else {
+            this.bgColorMode = ColorMode.DEFAULT;
+        }
+        if (this.fgColorMode === ColorMode.DEFAULT) {
+            this.fg = -1;
+        }
+        else {
+            this.fg = cell.getFgColor();
+        }
+        if (this.bgColorMode === ColorMode.DEFAULT) {
+            this.bg = -1;
+        }
+        else {
+            this.bg = cell.getBgColor();
+        }
+    }
+    isCursor() {
+        return this.x === this.cursorX && this.y === this.cursorY;
+    }
+    getChars() {
+        return this.cell?.getChars() || ' ';
+    }
+    isAttribute(attribute) {
+        return (this.attributes & attribute) !== 0;
+    }
+    equals(other) {
+        return (this.attributes === other.attributes &&
+            this.fg === other.fg &&
+            this.bg === other.bg &&
+            this.fgColorMode === other.fgColorMode &&
+            this.bgColorMode === other.bgColorMode &&
+            this.isCursor() === other.isCursor());
+    }
+}
+export function serializeTerminalToObject(terminal) {
+    const buffer = terminal.buffer.active;
+    const cursorX = buffer.cursorX;
+    const cursorY = buffer.cursorY;
+    const defaultFg = '';
+    const defaultBg = '';
+    const result = [];
+    for (let y = 0; y < terminal.rows; y++) {
+        const line = buffer.getLine(buffer.viewportY + y);
+        const currentLine = [];
+        if (!line) {
+            result.push(currentLine);
+            continue;
+        }
+        let lastCell = new Cell(null, -1, -1, cursorX, cursorY);
+        let currentText = '';
+        for (let x = 0; x < terminal.cols; x++) {
+            const cellData = line.getCell(x);
+            const cell = new Cell(cellData || null, x, y, cursorX, cursorY);
+            if (x > 0 && !cell.equals(lastCell)) {
+                if (currentText) {
+                    const token = {
+                        text: currentText,
+                        bold: lastCell.isAttribute(Attribute.bold),
+                        italic: lastCell.isAttribute(Attribute.italic),
+                        underline: lastCell.isAttribute(Attribute.underline),
+                        dim: lastCell.isAttribute(Attribute.dim),
+                        inverse: lastCell.isAttribute(Attribute.inverse) || lastCell.isCursor(),
+                        fg: convertColorToHex(lastCell.fg, lastCell.fgColorMode, defaultFg),
+                        bg: convertColorToHex(lastCell.bg, lastCell.bgColorMode, defaultBg),
+                    };
+                    currentLine.push(token);
+                }
+                currentText = '';
+            }
+            currentText += cell.getChars();
+            lastCell = cell;
+        }
+        if (currentText) {
+            const token = {
+                text: currentText,
+                bold: lastCell.isAttribute(Attribute.bold),
+                italic: lastCell.isAttribute(Attribute.italic),
+                underline: lastCell.isAttribute(Attribute.underline),
+                dim: lastCell.isAttribute(Attribute.dim),
+                inverse: lastCell.isAttribute(Attribute.inverse) || lastCell.isCursor(),
+                fg: convertColorToHex(lastCell.fg, lastCell.fgColorMode, defaultFg),
+                bg: convertColorToHex(lastCell.bg, lastCell.bgColorMode, defaultBg),
+            };
+            currentLine.push(token);
+        }
+        result.push(currentLine);
+    }
+    return result;
+}
+// ANSI color palette from https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
+const ANSI_COLORS = [
+    '#000000',
+    '#800000',
+    '#008000',
+    '#808000',
+    '#000080',
+    '#800080',
+    '#008080',
+    '#c0c0c0',
+    '#808080',
+    '#ff0000',
+    '#00ff00',
+    '#ffff00',
+    '#0000ff',
+    '#ff00ff',
+    '#00ffff',
+    '#ffffff',
+    '#000000',
+    '#00005f',
+    '#000087',
+    '#0000af',
+    '#0000d7',
+    '#0000ff',
+    '#005f00',
+    '#005f5f',
+    '#005f87',
+    '#005faf',
+    '#005fd7',
+    '#005fff',
+    '#008700',
+    '#00875f',
+    '#008787',
+    '#0087af',
+    '#0087d7',
+    '#0087ff',
+    '#00af00',
+    '#00af5f',
+    '#00af87',
+    '#00afaf',
+    '#00afd7',
+    '#00afff',
+    '#00d700',
+    '#00d75f',
+    '#00d787',
+    '#00d7af',
+    '#00d7d7',
+    '#00d7ff',
+    '#00ff00',
+    '#00ff5f',
+    '#00ff87',
+    '#00ffaf',
+    '#00ffd7',
+    '#00ffff',
+    '#5f0000',
+    '#5f005f',
+    '#5f0087',
+    '#5f00af',
+    '#5f00d7',
+    '#5f00ff',
+    '#5f5f00',
+    '#5f5f5f',
+    '#5f5f87',
+    '#5f5faf',
+    '#5f5fd7',
+    '#5f5fff',
+    '#5f8700',
+    '#5f875f',
+    '#5f8787',
+    '#5f87af',
+    '#5f87d7',
+    '#5f87ff',
+    '#5faf00',
+    '#5faf5f',
+    '#5faf87',
+    '#5fafaf',
+    '#5fafd7',
+    '#5fafff',
+    '#5fd700',
+    '#5fd75f',
+    '#5fd787',
+    '#5fd7af',
+    '#5fd7d7',
+    '#5fd7ff',
+    '#5fff00',
+    '#5fff5f',
+    '#5fff87',
+    '#5fffaf',
+    '#5fffd7',
+    '#5fffff',
+    '#870000',
+    '#87005f',
+    '#870087',
+    '#8700af',
+    '#8700d7',
+    '#8700ff',
+    '#875f00',
+    '#875f5f',
+    '#875f87',
+    '#875faf',
+    '#875fd7',
+    '#875fff',
+    '#878700',
+    '#87875f',
+    '#878787',
+    '#8787af',
+    '#8787d7',
+    '#8787ff',
+    '#87af00',
+    '#87af5f',
+    '#87af87',
+    '#87afaf',
+    '#87afd7',
+    '#87afff',
+    '#87d700',
+    '#87d75f',
+    '#87d787',
+    '#87d7af',
+    '#87d7d7',
+    '#87d7ff',
+    '#87ff00',
+    '#87ff5f',
+    '#87ff87',
+    '#87ffaf',
+    '#87ffd7',
+    '#87ffff',
+    '#af0000',
+    '#af005f',
+    '#af0087',
+    '#af00af',
+    '#af00d7',
+    '#af00ff',
+    '#af5f00',
+    '#af5f5f',
+    '#af5f87',
+    '#af5faf',
+    '#af5fd7',
+    '#af5fff',
+    '#af8700',
+    '#af875f',
+    '#af8787',
+    '#af87af',
+    '#af87d7',
+    '#af87ff',
+    '#afaf00',
+    '#afaf5f',
+    '#afaf87',
+    '#afafaf',
+    '#afafd7',
+    '#afafff',
+    '#afd700',
+    '#afd75f',
+    '#afd787',
+    '#afd7af',
+    '#afd7d7',
+    '#afd7ff',
+    '#afff00',
+    '#afff5f',
+    '#afff87',
+    '#afffaf',
+    '#afffd7',
+    '#afffff',
+    '#d70000',
+    '#d7005f',
+    '#d70087',
+    '#d700af',
+    '#d700d7',
+    '#d700ff',
+    '#d75f00',
+    '#d75f5f',
+    '#d75f87',
+    '#d75faf',
+    '#d75fd7',
+    '#d75fff',
+    '#d78700',
+    '#d7875f',
+    '#d78787',
+    '#d787af',
+    '#d787d7',
+    '#d787ff',
+    '#d7af00',
+    '#d7af5f',
+    '#d7af87',
+    '#d7afaf',
+    '#d7afd7',
+    '#d7afff',
+    '#d7d700',
+    '#d7d75f',
+    '#d7d787',
+    '#d7d7af',
+    '#d7d7d7',
+    '#d7d7ff',
+    '#d7ff00',
+    '#d7ff5f',
+    '#d7ff87',
+    '#d7ffaf',
+    '#d7ffd7',
+    '#d7ffff',
+    '#ff0000',
+    '#ff005f',
+    '#ff0087',
+    '#ff00af',
+    '#ff00d7',
+    '#ff00ff',
+    '#ff5f00',
+    '#ff5f5f',
+    '#ff5f87',
+    '#ff5faf',
+    '#ff5fd7',
+    '#ff5fff',
+    '#ff8700',
+    '#ff875f',
+    '#ff8787',
+    '#ff87af',
+    '#ff87d7',
+    '#ff87ff',
+    '#ffaf00',
+    '#ffaf5f',
+    '#ffaf87',
+    '#ffafaf',
+    '#ffafd7',
+    '#ffafff',
+    '#ffd700',
+    '#ffd75f',
+    '#ffd787',
+    '#ffd7af',
+    '#ffd7d7',
+    '#ffd7ff',
+    '#ffff00',
+    '#ffff5f',
+    '#ffff87',
+    '#ffffaf',
+    '#ffffd7',
+    '#ffffff',
+    '#080808',
+    '#121212',
+    '#1c1c1c',
+    '#262626',
+    '#303030',
+    '#3a3a3a',
+    '#444444',
+    '#4e4e4e',
+    '#585858',
+    '#626262',
+    '#6c6c6c',
+    '#767676',
+    '#808080',
+    '#8a8a8a',
+    '#949494',
+    '#9e9e9e',
+    '#a8a8a8',
+    '#b2b2b2',
+    '#bcbcbc',
+    '#c6c6c6',
+    '#d0d0d0',
+    '#dadada',
+    '#e4e4e4',
+    '#eeeeee',
+];
+export function convertColorToHex(color, colorMode, defaultColor) {
+    if (colorMode === ColorMode.RGB) {
+        const r = (color >> 16) & 255;
+        const g = (color >> 8) & 255;
+        const b = color & 255;
+        return `#${r.toString(16).padStart(2, '0')}${g
+            .toString(16)
+            .padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+    }
+    if (colorMode === ColorMode.PALETTE) {
+        return ANSI_COLORS[color] || defaultColor;
+    }
+    return defaultColor;
+}
+//# sourceMappingURL=terminalSerializer.js.map

package/dist/src/utils/terminalSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalSerializer.js","sourceRoot":"","sources":["../../../src/utils/terminalSerializer.ts"],"names":[],"mappings":"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AAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,SAAoB,EACpB,YAAoB;IAEpB,IAAI,SAAS,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAC7B,MAAM,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;QACtB,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;aAC3C,QAAQ,CAAC,EAAE,CAAC;aACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC;IAC5C,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/src/utils/terminalSerializer.test.d.ts

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

package/dist/src/utils/terminalSerializer.test.js

@@ -0,0 +1,176 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { Terminal } from '@xterm/headless';
+import { serializeTerminalToObject, convertColorToHex, ColorMode, } from './terminalSerializer.js';
+const RED_FG = '\x1b[31m';
+const RESET = '\x1b[0m';
+function writeToTerminal(terminal, data) {
+    return new Promise((resolve) => {
+        terminal.write(data, resolve);
+    });
+}
+describe('terminalSerializer', () => {
+    describe('serializeTerminalToObject', () => {
+        it('should handle an empty terminal', () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            const result = serializeTerminalToObject(terminal);
+            expect(result).toHaveLength(24);
+            result.forEach((line) => {
+                // Expect each line to be either empty or contain a single token with spaces
+                if (line.length > 0) {
+                    expect(line[0].text.trim()).toBe('');
+                }
+            });
+        });
+        it('should serialize a single line of text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, 'Hello, world!');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].text).toContain('Hello, world!');
+        });
+        it('should serialize multiple lines of text', async () => {
+            const terminal = new Terminal({
+                cols: 7,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, 'Line 1\r\nLine 2');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].text).toBe('Line 1 ');
+            expect(result[1][0].text).toBe('Line 2');
+        });
+        it('should handle bold text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[1mBold text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bold).toBe(true);
+            expect(result[0][0].text).toBe('Bold text');
+        });
+        it('should handle italic text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[3mItalic text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].italic).toBe(true);
+            expect(result[0][0].text).toBe('Italic text');
+        });
+        it('should handle underlined text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[4mUnderlined text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].underline).toBe(true);
+            expect(result[0][0].text).toBe('Underlined text');
+        });
+        it('should handle dim text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[2mDim text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].dim).toBe(true);
+            expect(result[0][0].text).toBe('Dim text');
+        });
+        it('should handle inverse text', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[7mInverse text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].inverse).toBe(true);
+            expect(result[0][0].text).toBe('Inverse text');
+        });
+        it('should handle foreground colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, `${RED_FG}Red text${RESET}`);
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].fg).toBe('#800000');
+            expect(result[0][0].text).toBe('Red text');
+        });
+        it('should handle background colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[42mGreen background\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bg).toBe('#008000');
+            expect(result[0][0].text).toBe('Green background');
+        });
+        it('should handle RGB colors', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[38;2;100;200;50mRGB text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].fg).toBe('#64c832');
+            expect(result[0][0].text).toBe('RGB text');
+        });
+        it('should handle a combination of styles', async () => {
+            const terminal = new Terminal({
+                cols: 80,
+                rows: 24,
+                allowProposedApi: true,
+            });
+            await writeToTerminal(terminal, '\x1b[1;31;42mStyled text\x1b[0m');
+            const result = serializeTerminalToObject(terminal);
+            expect(result[0][0].bold).toBe(true);
+            expect(result[0][0].fg).toBe('#800000');
+            expect(result[0][0].bg).toBe('#008000');
+            expect(result[0][0].text).toBe('Styled text');
+        });
+    });
+    describe('convertColorToHex', () => {
+        it('should convert RGB color to hex', () => {
+            const color = (100 << 16) | (200 << 8) | 50;
+            const hex = convertColorToHex(color, ColorMode.RGB, '#000000');
+            expect(hex).toBe('#64c832');
+        });
+        it('should convert palette color to hex', () => {
+            const hex = convertColorToHex(1, ColorMode.PALETTE, '#000000');
+            expect(hex).toBe('#800000');
+        });
+        it('should return default color for ColorMode.DEFAULT', () => {
+            const hex = convertColorToHex(0, ColorMode.DEFAULT, '#ffffff');
+            expect(hex).toBe('#ffffff');
+        });
+        it('should return default color for invalid palette index', () => {
+            const hex = convertColorToHex(999, ColorMode.PALETTE, '#000000');
+            expect(hex).toBe('#000000');
+        });
+    });
+});
+//# sourceMappingURL=terminalSerializer.test.js.map

package/dist/src/utils/terminalSerializer.test.js.map

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

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

@@ -3,6 +3,11 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Safely replaces text with literal strings, avoiding ECMAScript GetSubstitution issues.
+ * Escapes $ characters to prevent template interpretation.
+ */
+export declare function safeLiteralReplace(str: string, oldString: string, newString: string): string;
 /**
  * Checks if a Buffer is likely binary by testing for the presence of a NULL byte.
  * The presence of a NULL byte is a strong indicator that the data is not plain text.

package/dist/src/utils/textUtils.js

@@ -3,6 +3,20 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Safely replaces text with literal strings, avoiding ECMAScript GetSubstitution issues.
+ * Escapes $ characters to prevent template interpretation.
+ */
+export function safeLiteralReplace(str, oldString, newString) {
+    if (oldString === '' || !str.includes(oldString)) {
+        return str;
+    }
+    if (!newString.includes('$')) {
+        return str.replaceAll(oldString, newString);
+    }
+    const escapedNewString = newString.replaceAll('$', '$$$$');
+    return str.replaceAll(oldString, escapedNewString);
+}
 /**
  * Checks if a Buffer is likely binary by testing for the presence of a NULL byte.
  * The presence of a NULL byte is a strong indicator that the data is not plain text.

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

@@ -1 +1 @@
-{"version":3,"file":"textUtils.js","sourceRoot":"","sources":["../../../src/utils/textUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA+B,EAC/B,UAAU,GAAG,GAAG;IAEhB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,iEAAiE;QACjE,mEAAmE;QACnE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"textUtils.js","sourceRoot":"","sources":["../../../src/utils/textUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,SAAiB,EACjB,SAAiB;IAEjB,IAAI,SAAS,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,gBAAgB,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA+B,EAC/B,UAAU,GAAG,GAAG;IAEhB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,iEAAiE;QACjE,mEAAmE;QACnE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,OAAO,KAAK,CAAC;AACf,CAAC"}