@zgsm/costrict-cli 0.0.1

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

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { parseSGRMouseEvent, parseX11MouseEvent, isIncompleteMouseSequence, parseMouseEvent, } from './mouse.js';
+import { ESC } from './input.js';
+describe('mouse utils', () => {
+    describe('parseSGRMouseEvent', () => {
+        it('parses a valid SGR mouse press', () => {
+            // Button 0 (left), col 37, row 25, press (M)
+            const input = `${ESC}[<0;37;25M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 37,
+                row: 25,
+                shift: false,
+                meta: false,
+                ctrl: false,
+                button: 'left',
+            });
+            expect(result.length).toBe(input.length);
+        });
+        it('parses a valid SGR mouse release', () => {
+            // Button 0 (left), col 37, row 25, release (m)
+            const input = `${ESC}[<0;37;25m`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-release',
+                col: 37,
+                row: 25,
+                shift: false,
+                meta: false,
+                ctrl: false,
+                button: 'left',
+            });
+        });
+        it('parses SGR with modifiers', () => {
+            // Button 0 + Shift(4) + Meta(8) + Ctrl(16) = 0 + 4 + 8 + 16 = 28
+            const input = `${ESC}[<28;10;20M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 10,
+                row: 20,
+                shift: true,
+                meta: true,
+                ctrl: true,
+                button: 'left',
+            });
+        });
+        it('parses SGR move event', () => {
+            // Button 0 + Move(32) = 32
+            const input = `${ESC}[<32;10;20M`;
+            const result = parseSGRMouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event.name).toBe('move');
+            expect(result.event.button).toBe('left');
+        });
+        it('parses SGR scroll events', () => {
+            expect(parseSGRMouseEvent(`${ESC}[<64;1;1M`).event.name).toBe('scroll-up');
+            expect(parseSGRMouseEvent(`${ESC}[<65;1;1M`).event.name).toBe('scroll-down');
+        });
+        it('returns null for invalid SGR', () => {
+            expect(parseSGRMouseEvent(`${ESC}[<;1;1M`)).toBeNull();
+            expect(parseSGRMouseEvent(`${ESC}[<0;1;M`)).toBeNull();
+            expect(parseSGRMouseEvent(`not sgr`)).toBeNull();
+        });
+    });
+    describe('parseX11MouseEvent', () => {
+        it('parses a valid X11 mouse press', () => {
+            // Button 0 (left) + 32 = ' ' (space)
+            // Col 1 + 32 = '!'
+            // Row 1 + 32 = '!'
+            const input = `${ESC}[M !!`;
+            const result = parseX11MouseEvent(input);
+            expect(result).not.toBeNull();
+            expect(result.event).toEqual({
+                name: 'left-press',
+                col: 1,
+                row: 1,
+                shift: false,
+                meta: false,
+                ctrl: false,
+                button: 'left',
+            });
+            expect(result.length).toBe(6);
+        });
+        it('returns null for incomplete X11', () => {
+            expect(parseX11MouseEvent(`${ESC}[M !`)).toBeNull();
+        });
+    });
+    describe('isIncompleteMouseSequence', () => {
+        it('returns true for prefixes', () => {
+            expect(isIncompleteMouseSequence(ESC)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[`)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[<`)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[M`)).toBe(true);
+        });
+        it('returns true for partial SGR', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[<0;10;20`)).toBe(true);
+        });
+        it('returns true for partial X11', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[M `)).toBe(true);
+            expect(isIncompleteMouseSequence(`${ESC}[M !`)).toBe(true);
+        });
+        it('returns false for complete SGR', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[<0;10;20M`)).toBe(false);
+        });
+        it('returns false for complete X11', () => {
+            expect(isIncompleteMouseSequence(`${ESC}[M !!!`)).toBe(false);
+        });
+        it('returns false for non-mouse sequences', () => {
+            expect(isIncompleteMouseSequence('a')).toBe(false);
+            expect(isIncompleteMouseSequence(`${ESC}[A`)).toBe(false); // Arrow up
+        });
+        it('returns false for garbage that started like a mouse sequence but got too long (SGR)', () => {
+            const longGarbage = `${ESC}[<` + '0'.repeat(100);
+            expect(isIncompleteMouseSequence(longGarbage)).toBe(false);
+        });
+    });
+    describe('parseMouseEvent', () => {
+        it('parses SGR', () => {
+            expect(parseMouseEvent(`${ESC}[<0;1;1M`)).not.toBeNull();
+        });
+        it('parses X11', () => {
+            expect(parseMouseEvent(`${ESC}[M !!!`)).not.toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=mouse.test.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const VSCODE_SHIFT_ENTER_SEQUENCE = "\\\r\n";
+export interface TerminalSetupResult {
+    success: boolean;
+    message: string;
+    requiresRestart?: boolean;
+}
+type SupportedTerminal = 'vscode' | 'cursor' | 'windsurf';
+export declare function getTerminalProgram(): SupportedTerminal | null;
+/**
+ * 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 declare function terminalSetup(): Promise<TerminalSetupResult>;
+export {};

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

@@ -0,0 +1,290 @@
+/**
+ * @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)
+ *
+ * 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 { isKittyProtocolEnabled } from './kittyProtocolDetector.js';
+import { debugLogger } from '@google/gemini-cli-core';
+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, '');
+}
+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 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('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(os.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(os.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);
+                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 shiftEnterBinding = {
+            key: 'shift+enter',
+            command: 'workbench.action.terminal.sendSequence',
+            when: 'terminalFocus',
+            args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
+        };
+        const ctrlEnterBinding = {
+            key: 'ctrl+enter',
+            command: 'workbench.action.terminal.sendSequence',
+            when: 'terminalFocus',
+            args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
+        };
+        // Check if our specific bindings already exist
+        const hasOurShiftEnter = keybindings.some((kb) => {
+            const binding = kb;
+            return (binding.key === 'shift+enter' &&
+                binding.command === 'workbench.action.terminal.sendSequence' &&
+                binding.args?.text === '\\\r\n');
+        });
+        const hasOurCtrlEnter = keybindings.some((kb) => {
+            const binding = kb;
+            return (binding.key === 'ctrl+enter' &&
+                binding.command === 'workbench.action.terminal.sendSequence' &&
+                binding.args?.text === '\\\r\n');
+        });
+        if (hasOurShiftEnter && hasOurCtrlEnter) {
+            return {
+                success: true,
+                message: `${terminalName} keybindings already configured.`,
+            };
+        }
+        // Check if ANY shift+enter or ctrl+enter bindings already exist (that are NOT ours)
+        const existingShiftEnter = keybindings.find((kb) => {
+            const binding = kb;
+            return binding.key === 'shift+enter';
+        });
+        const existingCtrlEnter = keybindings.find((kb) => {
+            const binding = kb;
+            return binding.key === 'ctrl+enter';
+        });
+        if (existingShiftEnter || existingCtrlEnter) {
+            const messages = [];
+            // Only report conflict if it's not our binding (though we checked above, partial matches might exist)
+            if (existingShiftEnter && !hasOurShiftEnter) {
+                messages.push(`- Shift+Enter binding already exists`);
+            }
+            if (existingCtrlEnter && !hasOurCtrlEnter) {
+                messages.push(`- Ctrl+Enter binding already exists`);
+            }
+            if (messages.length > 0) {
+                return {
+                    success: false,
+                    message: `Existing keybindings detected. Will not modify to avoid conflicts.\n` +
+                        messages.join('\n') +
+                        '\n' +
+                        `Please check and modify manually if needed: ${keybindingsFile}`,
+                };
+            }
+        }
+        if (!hasOurShiftEnter)
+            keybindings.unshift(shiftEnterBinding);
+        if (!hasOurCtrlEnter)
+            keybindings.unshift(ctrlEnterBinding);
+        await fs.writeFile(keybindingsFile, JSON.stringify(keybindings, null, 4));
+        return {
+            success: true,
+            message: `Added Shift+Enter and Ctrl+Enter keybindings to ${terminalName}.\nModified: ${keybindingsFile}`,
+            requiresRestart: true,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to configure ${terminalName}.\nFile: ${keybindingsFile}\nError: ${error}`,
+        };
+    }
+}
+// Terminal-specific configuration functions
+async function configureVSCode() {
+    return configureVSCodeStyle('VS Code', 'Code');
+}
+async function configureCursor() {
+    return configureVSCodeStyle('Cursor', 'Cursor');
+}
+async function configureWindsurf() {
+    return configureVSCodeStyle('Windsurf', 'Windsurf');
+}
+/**
+ * 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 (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, and Windsurf.',
+        };
+    }
+    switch (terminal) {
+        case 'vscode':
+            return configureVSCode();
+        case 'cursor':
+            return configureCursor();
+        case 'windsurf':
+            return configureWindsurf();
+        default:
+            return {
+                success: false,
+                message: `Terminal "${terminal}" is not supported yet.`,
+            };
+    }
+}
+//# sourceMappingURL=terminalSetup.js.map

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

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

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

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

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

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { terminalSetup, VSCODE_SHIFT_ENTER_SEQUENCE } from './terminalSetup.js';
+// Mock dependencies
+const mocks = vi.hoisted(() => ({
+    exec: vi.fn(),
+    mkdir: vi.fn(),
+    readFile: vi.fn(),
+    writeFile: vi.fn(),
+    copyFile: vi.fn(),
+    homedir: vi.fn(),
+    platform: vi.fn(),
+    writeStream: {
+        write: vi.fn(),
+        on: vi.fn(),
+    },
+}));
+vi.mock('node:child_process', () => ({
+    exec: mocks.exec,
+    execFile: vi.fn(),
+}));
+vi.mock('node:fs', () => ({
+    createWriteStream: () => mocks.writeStream,
+    promises: {
+        mkdir: mocks.mkdir,
+        readFile: mocks.readFile,
+        writeFile: mocks.writeFile,
+        copyFile: mocks.copyFile,
+    },
+}));
+vi.mock('node:os', () => ({
+    homedir: mocks.homedir,
+    platform: mocks.platform,
+}));
+vi.mock('./kittyProtocolDetector.js', () => ({
+    isKittyProtocolEnabled: vi.fn().mockReturnValue(false),
+}));
+describe('terminalSetup', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        process.env = { ...originalEnv };
+        // Default mocks
+        mocks.homedir.mockReturnValue('/home/user');
+        mocks.platform.mockReturnValue('darwin');
+        mocks.mkdir.mockResolvedValue(undefined);
+        mocks.copyFile.mockResolvedValue(undefined);
+        mocks.exec.mockImplementation((cmd, cb) => cb(null, { stdout: '' }));
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    describe('detectTerminal', () => {
+        it('should detect VS Code from env var', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            const result = await terminalSetup();
+            expect(result.message).toContain('VS Code');
+        });
+        it('should detect Cursor from env var', async () => {
+            process.env['CURSOR_TRACE_ID'] = 'some-id';
+            const result = await terminalSetup();
+            expect(result.message).toContain('Cursor');
+        });
+        it('should detect Windsurf from env var', async () => {
+            process.env['VSCODE_GIT_ASKPASS_MAIN'] = '/path/to/windsurf/askpass';
+            const result = await terminalSetup();
+            expect(result.message).toContain('Windsurf');
+        });
+        it('should detect from parent process', async () => {
+            mocks.platform.mockReturnValue('linux');
+            mocks.exec.mockImplementation((cmd, cb) => {
+                cb(null, { stdout: 'code\n' });
+            });
+            const result = await terminalSetup();
+            expect(result.message).toContain('VS Code');
+        });
+    });
+    describe('configureVSCodeStyle', () => {
+        it('should create new keybindings file if none exists', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            mocks.readFile.mockRejectedValue(new Error('ENOENT'));
+            const result = await terminalSetup();
+            expect(result.success).toBe(true);
+            expect(mocks.writeFile).toHaveBeenCalled();
+            const writtenContent = JSON.parse(mocks.writeFile.mock.calls[0][1]);
+            expect(writtenContent).toMatchSnapshot();
+        });
+        it('should append to existing keybindings', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            mocks.readFile.mockResolvedValue('[]');
+            const result = await terminalSetup();
+            expect(result.success).toBe(true);
+            const writtenContent = JSON.parse(mocks.writeFile.mock.calls[0][1]);
+            expect(writtenContent).toHaveLength(2); // Shift+Enter and Ctrl+Enter
+        });
+        it('should not modify if bindings already exist', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            const existingBindings = [
+                {
+                    key: 'shift+enter',
+                    command: 'workbench.action.terminal.sendSequence',
+                    args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
+                },
+                {
+                    key: 'ctrl+enter',
+                    command: 'workbench.action.terminal.sendSequence',
+                    args: { text: VSCODE_SHIFT_ENTER_SEQUENCE },
+                },
+            ];
+            mocks.readFile.mockResolvedValue(JSON.stringify(existingBindings));
+            const result = await terminalSetup();
+            expect(result.success).toBe(true);
+            expect(mocks.writeFile).not.toHaveBeenCalled();
+        });
+        it('should fail gracefully if json is invalid', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            mocks.readFile.mockResolvedValue('{ invalid json');
+            const result = await terminalSetup();
+            expect(result.success).toBe(false);
+            expect(result.message).toContain('invalid JSON');
+        });
+        it('should handle comments in JSON', async () => {
+            process.env['TERM_PROGRAM'] = 'vscode';
+            const jsonWithComments = '// This is a comment\n[]';
+            mocks.readFile.mockResolvedValue(jsonWithComments);
+            const result = await terminalSetup();
+            expect(result.success).toBe(true);
+            expect(mocks.writeFile).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=terminalSetup.test.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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;
+}