@terminai/cli 0.21.0

package/dist/src/ui/components/CopyModeWarning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyModeWarning.js","sourceRoot":"","sources":["../../../../src/ui/components/CopyModeWarning.tsx"],"names":[],"mappings":";AAQA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAa,GAAG,EAAE;IAC5C,MAAM,EAAE,eAAe,EAAE,GAAG,UAAU,EAAE,CAAC;IAEzC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,KAAC,GAAG,cACF,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,qDAE1B,GACH,CACP,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/ui/components/CopyModeWarning.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/components/CopyModeWarning.test.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from '../../test-utils/render.js';
+import { CopyModeWarning } from './CopyModeWarning.js';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { useUIState } from '../contexts/UIStateContext.js';
+vi.mock('../contexts/UIStateContext.js');
+describe('CopyModeWarning', () => {
+    const mockUseUIState = vi.mocked(useUIState);
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('renders nothing when copy mode is disabled', () => {
+        mockUseUIState.mockReturnValue({
+            copyModeEnabled: false,
+        });
+        const { lastFrame } = render(_jsx(CopyModeWarning, {}));
+        expect(lastFrame()).toBe('');
+    });
+    it('renders warning when copy mode is enabled', () => {
+        mockUseUIState.mockReturnValue({
+            copyModeEnabled: true,
+        });
+        const { lastFrame } = render(_jsx(CopyModeWarning, {}));
+        expect(lastFrame()).toContain('In Copy Mode');
+        expect(lastFrame()).toContain('Press any key to exit');
+    });
+});
+//# sourceMappingURL=CopyModeWarning.test.js.map

package/dist/src/ui/components/CopyModeWarning.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyModeWarning.test.js","sourceRoot":"","sources":["../../../../src/ui/components/CopyModeWarning.test.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAgB,MAAM,+BAA+B,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;AAEzC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,cAAc,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE7C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,cAAc,CAAC,eAAe,CAAC;YAC7B,eAAe,EAAE,KAAK;SACD,CAAC,CAAC;QACzB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,KAAC,eAAe,KAAG,CAAC,CAAC;QAClD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,cAAc,CAAC,eAAe,CAAC;YAC7B,eAAe,EAAE,IAAI;SACA,CAAC,CAAC;QACzB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,KAAC,eAAe,KAAG,CAAC,CAAC;QAClD,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/components/DebugProfiler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FixedDeque } from 'mnemonist';
+export declare const ACTION_TIMESTAMP_CAPACITY = 2048;
+export declare const FRAME_TIMESTAMP_CAPACITY = 2048;
+export declare const profiler: {
+    profilersActive: number;
+    numFrames: number;
+    totalIdleFrames: number;
+    totalFlickerFrames: number;
+    hasLoggedFirstFlicker: boolean;
+    lastFrameStartTime: number;
+    openedDebugConsole: boolean;
+    lastActionTimestamp: number;
+    possiblyIdleFrameTimestamps: FixedDeque<number>;
+    actionTimestamps: FixedDeque<number>;
+    reportAction(): void;
+    reportFrameRendered(): void;
+    checkForIdleFrames(): void;
+    registerFlickerHandler(constrainHeight: boolean): () => void;
+};
+export declare const DebugProfiler: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/src/ui/components/DebugProfiler.js

@@ -0,0 +1,163 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Text } from 'ink';
+import { useEffect, useState } from 'react';
+import { FixedDeque } from 'mnemonist';
+import { theme } from '../semantic-colors.js';
+import { useUIState } from '../contexts/UIStateContext.js';
+import { debugState } from '../debug.js';
+import { appEvents, AppEvent } from '../../utils/events.js';
+import { debugLogger } from '@terminai/core';
+// Frames that render at least this far before or after an action are considered
+// idle frames.
+const MIN_TIME_FROM_ACTION_TO_BE_IDLE = 500;
+export const ACTION_TIMESTAMP_CAPACITY = 2048;
+export const FRAME_TIMESTAMP_CAPACITY = 2048;
+// Exported for testing purposes.
+export const profiler = {
+    profilersActive: 0,
+    numFrames: 0,
+    totalIdleFrames: 0,
+    totalFlickerFrames: 0,
+    hasLoggedFirstFlicker: false,
+    lastFrameStartTime: 0,
+    openedDebugConsole: false,
+    lastActionTimestamp: 0,
+    possiblyIdleFrameTimestamps: new FixedDeque(Array, FRAME_TIMESTAMP_CAPACITY),
+    actionTimestamps: new FixedDeque(Array, ACTION_TIMESTAMP_CAPACITY),
+    reportAction() {
+        const now = Date.now();
+        if (now - this.lastActionTimestamp > 16) {
+            if (this.actionTimestamps.size >= ACTION_TIMESTAMP_CAPACITY) {
+                this.actionTimestamps.shift();
+            }
+            this.actionTimestamps.push(now);
+            this.lastActionTimestamp = now;
+        }
+    },
+    reportFrameRendered() {
+        if (this.profilersActive === 0) {
+            return;
+        }
+        const now = Date.now();
+        this.lastFrameStartTime = now;
+        this.numFrames++;
+        if (debugState.debugNumAnimatedComponents === 0) {
+            if (this.possiblyIdleFrameTimestamps.size >= FRAME_TIMESTAMP_CAPACITY) {
+                this.possiblyIdleFrameTimestamps.shift();
+            }
+            this.possiblyIdleFrameTimestamps.push(now);
+        }
+        else {
+            // If a spinner is present, consider this an action that both prevents
+            // this frame from being idle and also should prevent a follow on frame
+            // from being considered idle.
+            if (this.actionTimestamps.size >= ACTION_TIMESTAMP_CAPACITY) {
+                this.actionTimestamps.shift();
+            }
+            this.actionTimestamps.push(now);
+        }
+    },
+    checkForIdleFrames() {
+        const now = Date.now();
+        const judgementCutoff = now - MIN_TIME_FROM_ACTION_TO_BE_IDLE;
+        const oneSecondIntervalFromJudgementCutoff = judgementCutoff - 1000;
+        let idleInPastSecond = 0;
+        while (this.possiblyIdleFrameTimestamps.size > 0 &&
+            this.possiblyIdleFrameTimestamps.peekFirst() <= judgementCutoff) {
+            const frameTime = this.possiblyIdleFrameTimestamps.shift();
+            const start = frameTime - MIN_TIME_FROM_ACTION_TO_BE_IDLE;
+            const end = frameTime + MIN_TIME_FROM_ACTION_TO_BE_IDLE;
+            while (this.actionTimestamps.size > 0 &&
+                this.actionTimestamps.peekFirst() < start) {
+                this.actionTimestamps.shift();
+            }
+            const hasAction = this.actionTimestamps.size > 0 &&
+                this.actionTimestamps.peekFirst() <= end;
+            if (!hasAction) {
+                if (frameTime >= oneSecondIntervalFromJudgementCutoff) {
+                    idleInPastSecond++;
+                }
+                this.totalIdleFrames++;
+            }
+        }
+        if (idleInPastSecond >= 5) {
+            if (this.openedDebugConsole === false) {
+                this.openedDebugConsole = true;
+                appEvents.emit(AppEvent.OpenDebugConsole);
+            }
+            debugLogger.error(`${idleInPastSecond} frames rendered while the app was ` +
+                `idle in the past second. This likely indicates severe infinite loop ` +
+                `React state management bugs.`);
+        }
+    },
+    registerFlickerHandler(constrainHeight) {
+        const flickerHandler = () => {
+            // If we are not constraining the height, we are intentionally
+            // overflowing the screen.
+            if (!constrainHeight) {
+                return;
+            }
+            this.totalFlickerFrames++;
+            this.reportAction();
+            if (!this.hasLoggedFirstFlicker) {
+                this.hasLoggedFirstFlicker = true;
+                debugLogger.error('A flicker frame was detected. This will cause UI instability. Type `/profile` for more info.');
+            }
+        };
+        appEvents.on(AppEvent.Flicker, flickerHandler);
+        return () => {
+            appEvents.off(AppEvent.Flicker, flickerHandler);
+        };
+    },
+};
+export const DebugProfiler = () => {
+    const { showDebugProfiler, constrainHeight } = useUIState();
+    const [forceRefresh, setForceRefresh] = useState(0);
+    // Effect for listening to stdin for keypresses and stdout for resize events.
+    useEffect(() => {
+        profiler.profilersActive++;
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        const handler = () => {
+            profiler.reportAction();
+        };
+        stdin.on('data', handler);
+        stdout.on('resize', handler);
+        return () => {
+            stdin.off('data', handler);
+            stdout.off('resize', handler);
+            profiler.profilersActive--;
+        };
+    }, []);
+    useEffect(() => {
+        const updateInterval = setInterval(() => {
+            profiler.checkForIdleFrames();
+        }, 1000);
+        return () => clearInterval(updateInterval);
+    }, []);
+    useEffect(() => profiler.registerFlickerHandler(constrainHeight), [constrainHeight]);
+    // Effect for updating stats
+    useEffect(() => {
+        if (!showDebugProfiler) {
+            return;
+        }
+        // Only update the UX infrequently as updating the UX itself will cause
+        // frames to run so can disturb what we are measuring.
+        const forceRefreshInterval = setInterval(() => {
+            setForceRefresh((f) => f + 1);
+            profiler.reportAction();
+        }, 4000);
+        return () => clearInterval(forceRefreshInterval);
+    }, [showDebugProfiler]);
+    if (!showDebugProfiler) {
+        return null;
+    }
+    return (_jsxs(Text, { color: theme.status.warning, children: ["Renders: ", profiler.numFrames, " (total),", ' ', _jsxs(Text, { color: theme.status.error, children: [profiler.totalIdleFrames, " (idle)"] }), ",", ' ', _jsxs(Text, { color: theme.status.error, children: [profiler.totalFlickerFrames, " (flicker)"] })] }, forceRefresh));
+};
+//# sourceMappingURL=DebugProfiler.js.map

package/dist/src/ui/components/DebugProfiler.js.map

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

package/dist/src/ui/components/DebugProfiler.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/components/DebugProfiler.test.js

@@ -0,0 +1,202 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { appEvents, AppEvent } from '../../utils/events.js';
+import { profiler, DebugProfiler, ACTION_TIMESTAMP_CAPACITY, FRAME_TIMESTAMP_CAPACITY, } from './DebugProfiler.js';
+import { render } from '../../test-utils/render.js';
+import { useUIState } from '../contexts/UIStateContext.js';
+import { FixedDeque } from 'mnemonist';
+import { debugState } from '../debug.js';
+vi.mock('../contexts/UIStateContext.js', () => ({
+    useUIState: vi.fn(),
+}));
+describe('DebugProfiler', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        profiler.profilersActive = 1;
+        profiler.numFrames = 0;
+        profiler.totalIdleFrames = 0;
+        profiler.lastFrameStartTime = 0;
+        profiler.openedDebugConsole = false;
+        profiler.lastActionTimestamp = 0;
+        profiler.possiblyIdleFrameTimestamps = new FixedDeque(Array, FRAME_TIMESTAMP_CAPACITY);
+        profiler.actionTimestamps = new FixedDeque(Array, ACTION_TIMESTAMP_CAPACITY);
+        debugState.debugNumAnimatedComponents = 0;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        profiler.actionTimestamps.clear();
+        profiler.possiblyIdleFrameTimestamps.clear();
+        debugState.debugNumAnimatedComponents = 0;
+    });
+    it('should not exceed action timestamp capacity', () => {
+        for (let i = 0; i < ACTION_TIMESTAMP_CAPACITY + 10; i++) {
+            profiler.reportAction();
+            // To ensure we don't trigger the debounce
+            profiler.lastActionTimestamp = 0;
+        }
+        expect(profiler.actionTimestamps.size).toBe(ACTION_TIMESTAMP_CAPACITY);
+    });
+    it('should not exceed frame timestamp capacity', () => {
+        for (let i = 0; i < FRAME_TIMESTAMP_CAPACITY + 10; i++) {
+            profiler.reportFrameRendered();
+            // To ensure we don't trigger the debounce
+            profiler.lastFrameStartTime = 0;
+        }
+        expect(profiler.possiblyIdleFrameTimestamps.size).toBe(FRAME_TIMESTAMP_CAPACITY);
+    });
+    it('should drop oldest action timestamps when capacity is reached', () => {
+        for (let i = 0; i < ACTION_TIMESTAMP_CAPACITY; i++) {
+            profiler.actionTimestamps.push(i);
+        }
+        profiler.lastActionTimestamp = 0;
+        profiler.reportAction();
+        expect(profiler.actionTimestamps.size).toBe(ACTION_TIMESTAMP_CAPACITY);
+        expect(profiler.actionTimestamps.peekFirst()).toBe(1);
+    });
+    it('should drop oldest frame timestamps when capacity is reached', () => {
+        for (let i = 0; i < FRAME_TIMESTAMP_CAPACITY; i++) {
+            profiler.possiblyIdleFrameTimestamps.push(i);
+        }
+        profiler.lastFrameStartTime = 0;
+        profiler.reportFrameRendered();
+        expect(profiler.possiblyIdleFrameTimestamps.size).toBe(FRAME_TIMESTAMP_CAPACITY);
+        expect(profiler.possiblyIdleFrameTimestamps.peekFirst()).toBe(1);
+    });
+    it('should not report frames as idle if an action happens shortly after', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        for (let i = 0; i < 5; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.setSystemTime(startTime + 400);
+        profiler.reportAction();
+        vi.advanceTimersByTime(600);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(0);
+    });
+    it('should report frames as idle if no action happens nearby', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        for (let i = 0; i < 5; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.advanceTimersByTime(1000);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(5);
+    });
+    it('should not report frames as idle if an action happens shortly before', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        profiler.reportAction();
+        vi.advanceTimersByTime(400);
+        for (let i = 0; i < 5; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.advanceTimersByTime(600);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(0);
+    });
+    it('should correctly identify mixed idle and non-idle frames', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        for (let i = 0; i < 3; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.advanceTimersByTime(1000);
+        profiler.reportAction();
+        vi.advanceTimersByTime(100);
+        for (let i = 0; i < 3; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.advanceTimersByTime(600);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(3);
+    });
+    it('should report flicker frames', () => {
+        const reportActionSpy = vi.spyOn(profiler, 'reportAction');
+        const cleanup = profiler.registerFlickerHandler(true);
+        appEvents.emit(AppEvent.Flicker);
+        expect(profiler.totalFlickerFrames).toBe(1);
+        expect(reportActionSpy).toHaveBeenCalled();
+        cleanup();
+    });
+    it('should not report idle frames when actions are interleaved', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        profiler.reportFrameRendered();
+        vi.advanceTimersByTime(20);
+        profiler.reportFrameRendered();
+        vi.advanceTimersByTime(200);
+        profiler.reportAction();
+        vi.advanceTimersByTime(200);
+        profiler.reportFrameRendered();
+        vi.advanceTimersByTime(20);
+        profiler.reportFrameRendered();
+        vi.advanceTimersByTime(600);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(0);
+    });
+    it('should not report frames as idle if debugNumAnimatedComponents > 0', async () => {
+        const startTime = Date.now();
+        vi.setSystemTime(startTime);
+        debugState.debugNumAnimatedComponents = 1;
+        for (let i = 0; i < 5; i++) {
+            profiler.reportFrameRendered();
+            vi.advanceTimersByTime(20);
+        }
+        vi.advanceTimersByTime(1000);
+        profiler.checkForIdleFrames();
+        expect(profiler.totalIdleFrames).toBe(0);
+    });
+});
+describe('DebugProfiler Component', () => {
+    beforeEach(() => {
+        // Reset the mock implementation before each test
+        vi.mocked(useUIState).mockReturnValue({
+            showDebugProfiler: false,
+            constrainHeight: false,
+        });
+        // Mock process.stdin and stdout
+        // We need to be careful not to break the test runner's own output
+        // So we might want to skip mocking them if they are not strictly needed for the simple render test
+        // or mock them safely.
+        // For now, let's assume the component uses them in useEffect.
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return null when showDebugProfiler is false', () => {
+        vi.mocked(useUIState).mockReturnValue({
+            showDebugProfiler: false,
+            constrainHeight: false,
+        });
+        const { lastFrame } = render(_jsx(DebugProfiler, {}));
+        expect(lastFrame()).toBe('');
+    });
+    it('should render stats when showDebugProfiler is true', () => {
+        vi.mocked(useUIState).mockReturnValue({
+            showDebugProfiler: true,
+            constrainHeight: false,
+        });
+        profiler.numFrames = 10;
+        profiler.totalIdleFrames = 5;
+        profiler.totalFlickerFrames = 2;
+        const { lastFrame } = render(_jsx(DebugProfiler, {}));
+        const output = lastFrame();
+        expect(output).toContain('Renders: 10 (total)');
+        expect(output).toContain('5 (idle)');
+        expect(output).toContain('2 (flicker)');
+    });
+});
+//# sourceMappingURL=DebugProfiler.test.js.map

package/dist/src/ui/components/DebugProfiler.test.js.map

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

package/dist/src/ui/components/DetailedMessagesDisplay.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import type { ConsoleMessageItem } from '../types.js';
+interface DetailedMessagesDisplayProps {
+    messages: ConsoleMessageItem[];
+    maxHeight: number | undefined;
+    width: number;
+    hasFocus: boolean;
+}
+export declare const DetailedMessagesDisplay: React.FC<DetailedMessagesDisplayProps>;
+export {};

package/dist/src/ui/components/DetailedMessagesDisplay.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useRef, useCallback } from 'react';
+import { Box, Text } from 'ink';
+import { theme } from '../semantic-colors.js';
+import { ScrollableList, } from './shared/ScrollableList.js';
+const iconBoxWidth = 3;
+export const DetailedMessagesDisplay = ({ messages, maxHeight, width, hasFocus }) => {
+    const scrollableListRef = useRef(null);
+    const borderAndPadding = 3;
+    const estimatedItemHeight = useCallback((index) => {
+        const msg = messages[index];
+        if (!msg) {
+            return 1;
+        }
+        const textWidth = width - borderAndPadding - iconBoxWidth;
+        if (textWidth <= 0) {
+            return 1;
+        }
+        const lines = Math.ceil((msg.content?.length || 1) / textWidth);
+        return Math.max(1, lines);
+    }, [width, messages]);
+    if (messages.length === 0) {
+        return null;
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: theme.border.default, paddingLeft: 1, width: width, height: maxHeight, flexShrink: 0, flexGrow: 0, overflow: "hidden", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { bold: true, color: theme.text.primary, children: ["Debug Console ", _jsx(Text, { color: theme.text.secondary, children: "(F12 to close)" })] }) }), _jsx(Box, { height: maxHeight, width: width - borderAndPadding, children: _jsx(ScrollableList, { ref: scrollableListRef, data: messages, renderItem: ({ item: msg }) => {
+                        let textColor = theme.text.primary;
+                        let icon = 'ℹ'; // Information source (ℹ)
+                        switch (msg.type) {
+                            case 'warn':
+                                textColor = theme.status.warning;
+                                icon = '⚠'; // Warning sign (⚠)
+                                break;
+                            case 'error':
+                                textColor = theme.status.error;
+                                icon = '✖'; // Heavy multiplication x (✖)
+                                break;
+                            case 'debug':
+                                textColor = theme.text.secondary; // Or theme.text.secondary
+                                icon = '🔍'; // Left-pointing magnifying glass (🔍)
+                                break;
+                            case 'log':
+                            default:
+                                // Default textColor and icon are already set
+                                break;
+                        }
+                        return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { minWidth: iconBoxWidth, flexShrink: 0, children: _jsx(Text, { color: textColor, children: icon }) }), _jsxs(Text, { color: textColor, wrap: "wrap", children: [msg.content, msg.count && msg.count > 1 && (_jsxs(Text, { color: theme.text.secondary, children: [" (x", msg.count, ")"] }))] })] }));
+                    }, keyExtractor: (item, index) => `${item.content}-${index}`, estimatedItemHeight: estimatedItemHeight, hasFocus: hasFocus, initialScrollIndex: Number.MAX_SAFE_INTEGER }) })] }));
+};
+//# sourceMappingURL=DetailedMessagesDisplay.js.map

package/dist/src/ui/components/DetailedMessagesDisplay.js.map

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

package/dist/src/ui/components/DetailedMessagesDisplay.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/components/DetailedMessagesDisplay.test.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from '../../test-utils/render.js';
+import { DetailedMessagesDisplay } from './DetailedMessagesDisplay.js';
+import { describe, it, expect, vi } from 'vitest';
+import { Box } from 'ink';
+vi.mock('./shared/ScrollableList.js', () => ({
+    ScrollableList: ({ data, renderItem, }) => (_jsx(Box, { flexDirection: "column", children: data.map((item, index) => (_jsx(Box, { children: renderItem({ item }) }, index))) })),
+}));
+describe('DetailedMessagesDisplay', () => {
+    it('renders nothing when messages are empty', () => {
+        const { lastFrame } = render(_jsx(DetailedMessagesDisplay, { messages: [], maxHeight: 10, width: 80, hasFocus: false }));
+        expect(lastFrame()).toBe('');
+    });
+    it('renders messages correctly', () => {
+        const messages = [
+            { type: 'log', content: 'Log message', count: 1 },
+            { type: 'warn', content: 'Warning message', count: 1 },
+            { type: 'error', content: 'Error message', count: 1 },
+            { type: 'debug', content: 'Debug message', count: 1 },
+        ];
+        const { lastFrame } = render(_jsx(DetailedMessagesDisplay, { messages: messages, maxHeight: 20, width: 80, hasFocus: true }));
+        const output = lastFrame();
+        expect(output).toMatchSnapshot();
+    });
+    it('renders message counts', () => {
+        const messages = [
+            { type: 'log', content: 'Repeated message', count: 5 },
+        ];
+        const { lastFrame } = render(_jsx(DetailedMessagesDisplay, { messages: messages, maxHeight: 10, width: 80, hasFocus: false }));
+        const output = lastFrame();
+        expect(output).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=DetailedMessagesDisplay.test.js.map

package/dist/src/ui/components/DetailedMessagesDisplay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailedMessagesDisplay.test.js","sourceRoot":"","sources":["../../../../src/ui/components/DetailedMessagesDisplay.test.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,EAAE,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,cAAc,EAAE,CAAC,EACf,IAAI,EACJ,UAAU,GAIX,EAAE,EAAE,CAAC,CACJ,KAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,YACxB,IAAI,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,KAAa,EAAE,EAAE,CAAC,CAC1C,KAAC,GAAG,cAAc,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,IAA5B,KAAK,CAA8B,CAC9C,CAAC,GACE,CACP;CACF,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAC1B,KAAC,uBAAuB,IACtB,QAAQ,EAAE,EAAE,EACZ,SAAS,EAAE,EAAE,EACb,KAAK,EAAE,EAAE,EACT,QAAQ,EAAE,KAAK,GACf,CACH,CAAC;QACF,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,QAAQ,GAAyB;YACrC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;YACjD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE;YACtD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE;YACrD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE;SACtD,CAAC;QAEF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAC1B,KAAC,uBAAuB,IACtB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,EAAE,EACb,KAAK,EAAE,EAAE,EACT,QAAQ,EAAE,IAAI,GACd,CACH,CAAC;QACF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,QAAQ,GAAyB;YACrC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE;SACvD,CAAC;QAEF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAC1B,KAAC,uBAAuB,IACtB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,EAAE,EACb,KAAK,EAAE,EAAE,EACT,QAAQ,EAAE,KAAK,GACf,CACH,CAAC;QACF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/components/DialogManager.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type UseHistoryManagerReturn } from '../hooks/useHistoryManager.js';
+interface DialogManagerProps {
+    addItem: UseHistoryManagerReturn['addItem'];
+    terminalWidth: number;
+}
+export declare const DialogManager: ({ addItem, terminalWidth, }: DialogManagerProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};