@terminai/cli 0.21.0

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

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { formatDuration, formatMemoryUsage } from './formatters.js';
+describe('formatters', () => {
+    describe('formatMemoryUsage', () => {
+        it('should format bytes into KB', () => {
+            expect(formatMemoryUsage(12345)).toBe('12.1 KB');
+        });
+        it('should format bytes into MB', () => {
+            expect(formatMemoryUsage(12345678)).toBe('11.8 MB');
+        });
+        it('should format bytes into GB', () => {
+            expect(formatMemoryUsage(12345678901)).toBe('11.50 GB');
+        });
+    });
+    describe('formatDuration', () => {
+        it('should format milliseconds less than a second', () => {
+            expect(formatDuration(500)).toBe('500ms');
+        });
+        it('should format a duration of 0', () => {
+            expect(formatDuration(0)).toBe('0s');
+        });
+        it('should format an exact number of seconds', () => {
+            expect(formatDuration(5000)).toBe('5.0s');
+        });
+        it('should format a duration in seconds with one decimal place', () => {
+            expect(formatDuration(12345)).toBe('12.3s');
+        });
+        it('should format an exact number of minutes', () => {
+            expect(formatDuration(120000)).toBe('2m');
+        });
+        it('should format a duration in minutes and seconds', () => {
+            expect(formatDuration(123000)).toBe('2m 3s');
+        });
+        it('should format an exact number of hours', () => {
+            expect(formatDuration(3600000)).toBe('1h');
+        });
+        it('should format a duration in hours and seconds', () => {
+            expect(formatDuration(3605000)).toBe('1h 5s');
+        });
+        it('should format a duration in hours, minutes, and seconds', () => {
+            expect(formatDuration(3723000)).toBe('1h 2m 3s');
+        });
+        it('should handle large durations', () => {
+            expect(formatDuration(86400000 + 3600000 + 120000 + 1000)).toBe('25h 2m 1s');
+        });
+        it('should handle negative durations', () => {
+            expect(formatDuration(-100)).toBe('0s');
+        });
+    });
+});
+//# sourceMappingURL=formatters.test.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type HighlightToken = {
+    text: string;
+    type: 'default' | 'command' | 'file';
+};
+export declare function parseInputForHighlighting(text: string, index: number): readonly HighlightToken[];
+export declare function buildSegmentsForVisualSlice(tokens: readonly HighlightToken[], sliceStart: number, sliceEnd: number): readonly HighlightToken[];

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

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { cpLen, cpSlice } from './textUtils.js';
+// Matches slash commands (e.g., /help) and @ references (files or MCP resource URIs).
+// The @ pattern uses a negated character class to support URIs like `@file:///example.txt`
+// which contain colons. It matches any character except delimiters: comma, whitespace,
+// semicolon, common punctuation, and brackets.
+const HIGHLIGHT_REGEX = /(^\/[a-zA-Z0-9_-]+|@(?:\\ |[^,\s;!?()[\]{}])+)/g;
+export function parseInputForHighlighting(text, index) {
+    if (!text) {
+        return [{ text: '', type: 'default' }];
+    }
+    const tokens = [];
+    let lastIndex = 0;
+    let match;
+    while ((match = HIGHLIGHT_REGEX.exec(text)) !== null) {
+        const [fullMatch] = match;
+        const matchIndex = match.index;
+        // Add the text before the match as a default token
+        if (matchIndex > lastIndex) {
+            tokens.push({
+                text: text.slice(lastIndex, matchIndex),
+                type: 'default',
+            });
+        }
+        // Add the matched token
+        const type = fullMatch.startsWith('/') ? 'command' : 'file';
+        // Only highlight slash commands if the index is 0.
+        if (type === 'command' && index !== 0) {
+            tokens.push({
+                text: fullMatch,
+                type: 'default',
+            });
+        }
+        else {
+            tokens.push({
+                text: fullMatch,
+                type,
+            });
+        }
+        lastIndex = matchIndex + fullMatch.length;
+    }
+    // Add any remaining text after the last match
+    if (lastIndex < text.length) {
+        tokens.push({
+            text: text.slice(lastIndex),
+            type: 'default',
+        });
+    }
+    return tokens;
+}
+export function buildSegmentsForVisualSlice(tokens, sliceStart, sliceEnd) {
+    if (sliceStart >= sliceEnd)
+        return [];
+    const segments = [];
+    let tokenCpStart = 0;
+    for (const token of tokens) {
+        const tokenLen = cpLen(token.text);
+        const tokenStart = tokenCpStart;
+        const tokenEnd = tokenStart + tokenLen;
+        const overlapStart = Math.max(tokenStart, sliceStart);
+        const overlapEnd = Math.min(tokenEnd, sliceEnd);
+        if (overlapStart < overlapEnd) {
+            const sliceStartInToken = overlapStart - tokenStart;
+            const sliceEndInToken = overlapEnd - tokenStart;
+            const rawSlice = cpSlice(token.text, sliceStartInToken, sliceEndInToken);
+            const last = segments[segments.length - 1];
+            if (last && last.type === token.type) {
+                last.text += rawSlice;
+            }
+            else {
+                segments.push({ type: token.type, text: rawSlice });
+            }
+        }
+        tokenCpStart += tokenLen;
+    }
+    return segments;
+}
+//# sourceMappingURL=highlight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../../../src/ui/utils/highlight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOhD,sFAAsF;AACtF,2FAA2F;AAC3F,uFAAuF;AACvF,+CAA+C;AAC/C,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAE1E,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,KAAa;IAEb,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrD,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QAC1B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAE/B,mDAAmD;QACnD,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC;gBACvC,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5D,mDAAmD;QACnD,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAED,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED,8CAA8C;IAC9C,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YAC3B,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAiC,EACjC,UAAkB,EAClB,QAAgB;IAEhB,IAAI,UAAU,IAAI,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,YAAY,CAAC;QAChC,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;QAEvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,UAAU,EAAE,CAAC;YAC9B,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,CAAC;YACpD,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,CAAC;YAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;YAEzE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,YAAY,IAAI,QAAQ,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

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

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

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { parseInputForHighlighting } from './highlight.js';
+describe('parseInputForHighlighting', () => {
+    it('should handle an empty string', () => {
+        expect(parseInputForHighlighting('', 0)).toEqual([
+            { text: '', type: 'default' },
+        ]);
+    });
+    it('should handle text with no commands or files', () => {
+        const text = 'this is a normal sentence';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text, type: 'default' },
+        ]);
+    });
+    it('should highlight a single command at the beginning when index is 0', () => {
+        const text = '/help me';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: '/help', type: 'command' },
+            { text: ' me', type: 'default' },
+        ]);
+    });
+    it('should NOT highlight a command at the beginning when index is not 0', () => {
+        const text = '/help me';
+        expect(parseInputForHighlighting(text, 1)).toEqual([
+            { text: '/help', type: 'default' },
+            { text: ' me', type: 'default' },
+        ]);
+    });
+    it('should highlight a single file path at the beginning', () => {
+        const text = '@path/to/file.txt please';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: '@path/to/file.txt', type: 'file' },
+            { text: ' please', type: 'default' },
+        ]);
+    });
+    it('should not highlight a command in the middle', () => {
+        const text = 'I need /help with this';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'I need /help with this', type: 'default' },
+        ]);
+    });
+    it('should highlight a file path in the middle', () => {
+        const text = 'Please check @path/to/file.txt for details';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'Please check ', type: 'default' },
+            { text: '@path/to/file.txt', type: 'file' },
+            { text: ' for details', type: 'default' },
+        ]);
+    });
+    it('should highlight files but not commands not at the start', () => {
+        const text = 'Use /run with @file.js and also /format @another/file.ts';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'Use /run with ', type: 'default' },
+            { text: '@file.js', type: 'file' },
+            { text: ' and also /format ', type: 'default' },
+            { text: '@another/file.ts', type: 'file' },
+        ]);
+    });
+    it('should handle adjacent highlights at start', () => {
+        const text = '/run@file.js';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: '/run', type: 'command' },
+            { text: '@file.js', type: 'file' },
+        ]);
+    });
+    it('should not highlight command at the end of the string', () => {
+        const text = 'Get help with /help';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'Get help with /help', type: 'default' },
+        ]);
+    });
+    it('should handle file paths with dots and dashes', () => {
+        const text = 'Check @./path-to/file-name.v2.txt';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'Check ', type: 'default' },
+            { text: '@./path-to/file-name.v2.txt', type: 'file' },
+        ]);
+    });
+    it('should not highlight command with dashes and numbers not at start', () => {
+        const text = 'Run /command-123 now';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'Run /command-123 now', type: 'default' },
+        ]);
+    });
+    it('should highlight command with dashes and numbers at start', () => {
+        const text = '/command-123 now';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: '/command-123', type: 'command' },
+            { text: ' now', type: 'default' },
+        ]);
+    });
+    it('should still highlight a file path on a non-zero line', () => {
+        const text = 'some text @path/to/file.txt';
+        expect(parseInputForHighlighting(text, 1)).toEqual([
+            { text: 'some text ', type: 'default' },
+            { text: '@path/to/file.txt', type: 'file' },
+        ]);
+    });
+    it('should not highlight command but highlight file on a non-zero line', () => {
+        const text = '/cmd @file.txt';
+        expect(parseInputForHighlighting(text, 2)).toEqual([
+            { text: '/cmd', type: 'default' },
+            { text: ' ', type: 'default' },
+            { text: '@file.txt', type: 'file' },
+        ]);
+    });
+    it('should highlight a file path with escaped spaces', () => {
+        const text = 'cat @/my\\ path/file.txt';
+        expect(parseInputForHighlighting(text, 0)).toEqual([
+            { text: 'cat ', type: 'default' },
+            { text: '@/my\\ path/file.txt', type: 'file' },
+        ]);
+    });
+});
+//# sourceMappingURL=highlight.test.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const ESC = "\u001B";
+export declare const SGR_EVENT_PREFIX = "\u001B[<";
+export declare const X11_EVENT_PREFIX = "\u001B[M";
+export declare const SGR_MOUSE_REGEX: RegExp;
+export declare const X11_MOUSE_REGEX: RegExp;
+export declare function couldBeSGRMouseSequence(buffer: string): boolean;
+export declare function couldBeMouseSequence(buffer: string): boolean;
+/**
+ * Checks if the buffer *starts* with a complete mouse sequence.
+ * Returns the length of the sequence if matched, or 0 if not.
+ */
+export declare function getMouseSequenceLength(buffer: string): number;

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

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const ESC = '\u001B';
+export const SGR_EVENT_PREFIX = `${ESC}[<`;
+export const X11_EVENT_PREFIX = `${ESC}[M`;
+// eslint-disable-next-line no-control-regex
+export const SGR_MOUSE_REGEX = /^\x1b\[<(\d+);(\d+);(\d+)([mM])/; // SGR mouse events
+// X11 is ESC [ M followed by 3 bytes.
+// eslint-disable-next-line no-control-regex
+export const X11_MOUSE_REGEX = /^\x1b\[M([\s\S]{3})/;
+export function couldBeSGRMouseSequence(buffer) {
+    if (buffer.length === 0)
+        return true;
+    // Check if buffer is a prefix of a mouse sequence starter
+    if (SGR_EVENT_PREFIX.startsWith(buffer))
+        return true;
+    // Check if buffer is a mouse sequence prefix
+    if (buffer.startsWith(SGR_EVENT_PREFIX))
+        return true;
+    return false;
+}
+export function couldBeMouseSequence(buffer) {
+    if (buffer.length === 0)
+        return true;
+    // Check SGR prefix
+    if (SGR_EVENT_PREFIX.startsWith(buffer) ||
+        buffer.startsWith(SGR_EVENT_PREFIX))
+        return true;
+    // Check X11 prefix
+    if (X11_EVENT_PREFIX.startsWith(buffer) ||
+        buffer.startsWith(X11_EVENT_PREFIX))
+        return true;
+    return false;
+}
+/**
+ * Checks if the buffer *starts* with a complete mouse sequence.
+ * Returns the length of the sequence if matched, or 0 if not.
+ */
+export function getMouseSequenceLength(buffer) {
+    const sgrMatch = buffer.match(SGR_MOUSE_REGEX);
+    if (sgrMatch)
+        return sgrMatch[0].length;
+    const x11Match = buffer.match(X11_MOUSE_REGEX);
+    if (x11Match)
+        return x11Match[0].length;
+    return 0;
+}
+//# sourceMappingURL=input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../src/ui/utils/input.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,iCAAiC,CAAC,CAAC,mBAAmB;AACrF,sCAAsC;AACtC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAErD,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,0DAA0D;IAC1D,IAAI,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,6CAA6C;IAC7C,IAAI,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,mBAAmB;IACnB,IACE,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAEnC,OAAO,IAAI,CAAC;IACd,mBAAmB;IACnB,IACE,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAEnC,OAAO,IAAI,CAAC;IAEd,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAExC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAExC,OAAO,CAAC,CAAC;AACX,CAAC"}

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { couldBeSGRMouseSequence, SGR_MOUSE_REGEX, ESC } from './input.js';
+describe('input utils', () => {
+    describe('SGR_MOUSE_REGEX', () => {
+        it('should match valid SGR mouse sequences', () => {
+            // Press left button at 10, 20
+            expect('\x1b[<0;10;20M').toMatch(SGR_MOUSE_REGEX);
+            // Release left button at 10, 20
+            expect('\x1b[<0;10;20m').toMatch(SGR_MOUSE_REGEX);
+            // Move with left button held at 30, 40
+            expect('\x1b[<32;30;40M').toMatch(SGR_MOUSE_REGEX);
+            // Scroll up at 5, 5
+            expect('\x1b[<64;5;5M').toMatch(SGR_MOUSE_REGEX);
+        });
+        it('should not match invalid sequences', () => {
+            expect('hello').not.toMatch(SGR_MOUSE_REGEX);
+            expect('\x1b[A').not.toMatch(SGR_MOUSE_REGEX); // Arrow up
+            expect('\x1b[<0;10;20').not.toMatch(SGR_MOUSE_REGEX); // Incomplete
+        });
+    });
+    describe('couldBeSGRMouseSequence', () => {
+        it('should return true for empty string', () => {
+            expect(couldBeSGRMouseSequence('')).toBe(true);
+        });
+        it('should return true for partial SGR prefixes', () => {
+            expect(couldBeSGRMouseSequence(ESC)).toBe(true);
+            expect(couldBeSGRMouseSequence(`${ESC}[`)).toBe(true);
+            expect(couldBeSGRMouseSequence(`${ESC}[<`)).toBe(true);
+        });
+        it('should return true for full SGR sequence start', () => {
+            expect(couldBeSGRMouseSequence(`${ESC}[<0;10;20M`)).toBe(true);
+        });
+        it('should return false for non-SGR sequences', () => {
+            expect(couldBeSGRMouseSequence('a')).toBe(false);
+            expect(couldBeSGRMouseSequence(`${ESC}a`)).toBe(false);
+            expect(couldBeSGRMouseSequence(`${ESC}[A`)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=input.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.test.js","sourceRoot":"","sources":["../../../../src/ui/utils/input.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE3E,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,8BAA8B;YAC9B,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAClD,gCAAgC;YAChC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAClD,uCAAuC;YACvC,MAAM,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACnD,oBAAoB;YACpB,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW;YAC1D,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,uBAAuB,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,uBAAuB,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,uBAAuB,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,CAAC,uBAAuB,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvD,MAAM,CAAC,uBAAuB,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isNarrowWidth(width: number): boolean;

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isNarrowWidth(width) {
+    return width < 80;
+}
+//# sourceMappingURL=isNarrowWidth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isNarrowWidth.js","sourceRoot":"","sources":["../../../../src/ui/utils/isNarrowWidth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,GAAG,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const findLastSafeSplitPoint: (content: string) => number;

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

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/*
+**Background & Purpose:**
+
+The `findSafeSplitPoint` function is designed to address the challenge of displaying or processing large, potentially streaming, pieces of Markdown text. When content (e.g., from an LLM like Gemini) arrives in chunks or grows too large for a single display unit (like a message bubble), it needs to be split. A naive split (e.g., just at a character limit) can break Markdown formatting, especially critical for multi-line elements like code blocks, lists, or blockquotes, leading to incorrect rendering.
+
+This function aims to find an *intelligent* or "safe" index within the provided `content` string at which to make such a split, prioritizing the preservation of Markdown integrity.
+
+**Key Expectations & Behavior (Prioritized):**
+
+1.  **No Split if Short Enough:**
+    * If `content.length` is less than or equal to `idealMaxLength`, the function should return `content.length` (indicating no split is necessary for length reasons).
+
+2.  **Code Block Integrity (Highest Priority for Safety):**
+    * The function must try to avoid splitting *inside* a fenced code block (i.e., between ` ``` ` and ` ``` `).
+    * If `idealMaxLength` falls within a code block:
+        * The function will attempt to return an index that splits the content *before* the start of that code block.
+        * If a code block starts at the very beginning of the `content` and `idealMaxLength` falls within it (meaning the block itself is too long for the first chunk), the function might return `0`. This effectively makes the first chunk empty, pushing the entire oversized code block to the second part of the split.
+    * When considering splits near code blocks, the function prefers to keep the entire code block intact in one of the resulting chunks.
+
+3.  **Markdown-Aware Newline Splitting (If Not Governed by Code Block Logic):**
+    * If `idealMaxLength` does not fall within a code block (or after code block considerations have been made), the function will look for natural break points by scanning backwards from `idealMaxLength`:
+        * **Paragraph Breaks:** It prioritizes splitting after a double newline (`\n\n`), as this typically signifies the end of a paragraph or a block-level element.
+        * **Single Line Breaks:** If no double newline is found in a suitable range, it will look for a single newline (`\n`).
+    * Any newline chosen as a split point must also not be inside a code block.
+
+4.  **Fall back to `idealMaxLength`:**
+    * If no "safer" split point (respecting code blocks or finding suitable newlines) is identified before or at `idealMaxLength`, and `idealMaxLength` itself is not determined to be an unsafe split point (e.g., inside a code block), the function may return a length larger than `idealMaxLength`, again it CANNOT break markdown formatting. This could happen with very long lines of text without Markdown block structures or newlines.
+
+**In essence, `findSafeSplitPoint` tries to be a good Markdown citizen when forced to divide content, preferring structural boundaries over arbitrary character limits, with a strong emphasis on not corrupting code blocks.**
+*/
+/**
+ * Checks if a given character index within a string is inside a fenced (```) code block.
+ * @param content The full string content.
+ * @param indexToTest The character index to test.
+ * @returns True if the index is inside a code block's content, false otherwise.
+ */
+const isIndexInsideCodeBlock = (content, indexToTest) => {
+    let fenceCount = 0;
+    let searchPos = 0;
+    while (searchPos < content.length) {
+        const nextFence = content.indexOf('```', searchPos);
+        if (nextFence === -1 || nextFence >= indexToTest) {
+            break;
+        }
+        fenceCount++;
+        searchPos = nextFence + 3;
+    }
+    return fenceCount % 2 === 1;
+};
+/**
+ * Finds the starting index of the code block that encloses the given index.
+ * Returns -1 if the index is not inside a code block.
+ * @param content The markdown content.
+ * @param index The index to check.
+ * @returns Start index of the enclosing code block or -1.
+ */
+const findEnclosingCodeBlockStart = (content, index) => {
+    if (!isIndexInsideCodeBlock(content, index)) {
+        return -1;
+    }
+    let currentSearchPos = 0;
+    while (currentSearchPos < index) {
+        const blockStartIndex = content.indexOf('```', currentSearchPos);
+        if (blockStartIndex === -1 || blockStartIndex >= index) {
+            break;
+        }
+        const blockEndIndex = content.indexOf('```', blockStartIndex + 3);
+        if (blockStartIndex < index) {
+            if (blockEndIndex === -1 || index < blockEndIndex + 3) {
+                return blockStartIndex;
+            }
+        }
+        if (blockEndIndex === -1)
+            break;
+        currentSearchPos = blockEndIndex + 3;
+    }
+    return -1;
+};
+export const findLastSafeSplitPoint = (content) => {
+    const enclosingBlockStart = findEnclosingCodeBlockStart(content, content.length);
+    if (enclosingBlockStart !== -1) {
+        // The end of the content is contained in a code block. Split right before.
+        return enclosingBlockStart;
+    }
+    // Search for the last double newline (\n\n) not in a code block.
+    let searchStartIndex = content.length;
+    while (searchStartIndex >= 0) {
+        const dnlIndex = content.lastIndexOf('\n\n', searchStartIndex);
+        if (dnlIndex === -1) {
+            // No more double newlines found.
+            break;
+        }
+        const potentialSplitPoint = dnlIndex + 2;
+        if (!isIndexInsideCodeBlock(content, potentialSplitPoint)) {
+            return potentialSplitPoint;
+        }
+        // If potentialSplitPoint was inside a code block,
+        // the next search should start *before* the \n\n we just found to ensure progress.
+        searchStartIndex = dnlIndex - 1;
+    }
+    // If no safe double newline is found, return content.length
+    // to keep the entire content as one piece.
+    return content.length;
+};
+//# sourceMappingURL=markdownUtilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdownUtilities.js","sourceRoot":"","sources":["../../../../src/ui/utils/markdownUtilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BE;AAEF;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,CAC7B,OAAe,EACf,WAAmB,EACV,EAAE;IACX,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;YACjD,MAAM;QACR,CAAC;QACD,UAAU,EAAE,CAAC;QACb,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAClC,OAAe,EACf,KAAa,EACL,EAAE;IACV,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,OAAO,gBAAgB,GAAG,KAAK,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACjE,IAAI,eAAe,KAAK,CAAC,CAAC,IAAI,eAAe,IAAI,KAAK,EAAE,CAAC;YACvD,MAAM;QACR,CAAC;QACD,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,eAAe,GAAG,KAAK,EAAE,CAAC;YAC5B,IAAI,aAAa,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtD,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,aAAa,KAAK,CAAC,CAAC;YAAE,MAAM;QAChC,gBAAgB,GAAG,aAAa,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAE,EAAE;IACxD,MAAM,mBAAmB,GAAG,2BAA2B,CACrD,OAAO,EACP,OAAO,CAAC,MAAM,CACf,CAAC;IACF,IAAI,mBAAmB,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/B,2EAA2E;QAC3E,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,iEAAiE;IACjE,IAAI,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IACtC,OAAO,gBAAgB,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC/D,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,iCAAiC;YACjC,MAAM;QACR,CAAC;QAED,MAAM,mBAAmB,GAAG,QAAQ,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;YAC1D,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,kDAAkD;QAClD,mFAAmF;QACnF,gBAAgB,GAAG,QAAQ,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,4DAA4D;IAC5D,2CAA2C;IAC3C,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC,CAAC"}

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

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