@terminai/cli 0.21.0

package/dist/src/ui/hooks/useMessageQueue.test.js

@@ -0,0 +1,294 @@
+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 { act } from 'react';
+import { render } from '../../test-utils/render.js';
+import { waitFor } from '../../test-utils/async.js';
+import { useMessageQueue } from './useMessageQueue.js';
+import { StreamingState } from '../types.js';
+describe('useMessageQueue', () => {
+    let mockSubmitQuery;
+    beforeEach(() => {
+        mockSubmitQuery = vi.fn();
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.clearAllMocks();
+    });
+    const renderMessageQueueHook = (initialProps) => {
+        let hookResult;
+        function TestComponent(props) {
+            hookResult = useMessageQueue(props);
+            return null;
+        }
+        const { rerender } = render(_jsx(TestComponent, { ...initialProps }));
+        return {
+            result: {
+                get current() {
+                    return hookResult;
+                },
+            },
+            rerender: (newProps) => rerender(_jsx(TestComponent, { ...initialProps, ...newProps })),
+        };
+    };
+    it('should initialize with empty queue', () => {
+        const { result } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Idle,
+            submitQuery: mockSubmitQuery,
+        });
+        expect(result.current.messageQueue).toEqual([]);
+        expect(result.current.getQueuedMessagesText()).toBe('');
+    });
+    it('should add messages to queue', () => {
+        const { result } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        act(() => {
+            result.current.addMessage('Test message 1');
+            result.current.addMessage('Test message 2');
+        });
+        expect(result.current.messageQueue).toEqual([
+            'Test message 1',
+            'Test message 2',
+        ]);
+    });
+    it('should filter out empty messages', () => {
+        const { result } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        act(() => {
+            result.current.addMessage('Valid message');
+            result.current.addMessage('   '); // Only whitespace
+            result.current.addMessage(''); // Empty
+            result.current.addMessage('Another valid message');
+        });
+        expect(result.current.messageQueue).toEqual([
+            'Valid message',
+            'Another valid message',
+        ]);
+    });
+    it('should clear queue', () => {
+        const { result } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        act(() => {
+            result.current.addMessage('Test message');
+        });
+        expect(result.current.messageQueue).toEqual(['Test message']);
+        act(() => {
+            result.current.clearQueue();
+        });
+        expect(result.current.messageQueue).toEqual([]);
+    });
+    it('should return queued messages as text with double newlines', () => {
+        const { result } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        act(() => {
+            result.current.addMessage('Message 1');
+            result.current.addMessage('Message 2');
+            result.current.addMessage('Message 3');
+        });
+        expect(result.current.getQueuedMessagesText()).toBe('Message 1\n\nMessage 2\n\nMessage 3');
+    });
+    it('should auto-submit queued messages when transitioning to Idle', async () => {
+        const { result, rerender } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        // Add some messages
+        act(() => {
+            result.current.addMessage('Message 1');
+            result.current.addMessage('Message 2');
+        });
+        expect(result.current.messageQueue).toEqual(['Message 1', 'Message 2']);
+        // Transition to Idle
+        rerender({ streamingState: StreamingState.Idle });
+        await waitFor(() => {
+            expect(mockSubmitQuery).toHaveBeenCalledWith('Message 1\n\nMessage 2');
+            expect(result.current.messageQueue).toEqual([]);
+        });
+    });
+    it('should not auto-submit when queue is empty', () => {
+        const { rerender } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        // Transition to Idle with empty queue
+        rerender({ streamingState: StreamingState.Idle });
+        expect(mockSubmitQuery).not.toHaveBeenCalled();
+    });
+    it('should not auto-submit when not transitioning to Idle', () => {
+        const { result, rerender } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Responding,
+            submitQuery: mockSubmitQuery,
+        });
+        // Add messages
+        act(() => {
+            result.current.addMessage('Message 1');
+        });
+        // Transition to WaitingForConfirmation (not Idle)
+        rerender({ streamingState: StreamingState.WaitingForConfirmation });
+        expect(mockSubmitQuery).not.toHaveBeenCalled();
+        expect(result.current.messageQueue).toEqual(['Message 1']);
+    });
+    it('should handle multiple state transitions correctly', async () => {
+        const { result, rerender } = renderMessageQueueHook({
+            isConfigInitialized: true,
+            streamingState: StreamingState.Idle,
+            submitQuery: mockSubmitQuery,
+        });
+        // Start responding
+        rerender({ streamingState: StreamingState.Responding });
+        // Add messages while responding
+        act(() => {
+            result.current.addMessage('First batch');
+        });
+        // Go back to idle - should submit
+        rerender({ streamingState: StreamingState.Idle });
+        await waitFor(() => {
+            expect(mockSubmitQuery).toHaveBeenCalledWith('First batch');
+            expect(result.current.messageQueue).toEqual([]);
+        });
+        // Start responding again
+        rerender({ streamingState: StreamingState.Responding });
+        // Add more messages
+        act(() => {
+            result.current.addMessage('Second batch');
+        });
+        // Go back to idle - should submit again
+        rerender({ streamingState: StreamingState.Idle });
+        await waitFor(() => {
+            expect(mockSubmitQuery).toHaveBeenCalledWith('Second batch');
+            expect(mockSubmitQuery).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('popAllMessages', () => {
+        it('should pop all messages and return them joined with double newlines', () => {
+            const { result } = renderMessageQueueHook({
+                isConfigInitialized: true,
+                streamingState: StreamingState.Responding,
+                submitQuery: mockSubmitQuery,
+            });
+            // Add multiple messages
+            act(() => {
+                result.current.addMessage('Message 1');
+                result.current.addMessage('Message 2');
+                result.current.addMessage('Message 3');
+            });
+            expect(result.current.messageQueue).toEqual([
+                'Message 1',
+                'Message 2',
+                'Message 3',
+            ]);
+            // Pop all messages
+            let poppedMessages;
+            act(() => {
+                poppedMessages = result.current.popAllMessages();
+            });
+            expect(poppedMessages).toBe('Message 1\n\nMessage 2\n\nMessage 3');
+            expect(result.current.messageQueue).toEqual([]);
+        });
+        it('should return undefined when queue is empty', () => {
+            const { result } = renderMessageQueueHook({
+                isConfigInitialized: true,
+                streamingState: StreamingState.Responding,
+                submitQuery: mockSubmitQuery,
+            });
+            let poppedMessages = 'not-undefined';
+            act(() => {
+                poppedMessages = result.current.popAllMessages();
+            });
+            expect(poppedMessages).toBeUndefined();
+            expect(result.current.messageQueue).toEqual([]);
+        });
+        it('should handle single message correctly', () => {
+            const { result } = renderMessageQueueHook({
+                isConfigInitialized: true,
+                streamingState: StreamingState.Responding,
+                submitQuery: mockSubmitQuery,
+            });
+            act(() => {
+                result.current.addMessage('Single message');
+            });
+            let poppedMessages;
+            act(() => {
+                poppedMessages = result.current.popAllMessages();
+            });
+            expect(poppedMessages).toBe('Single message');
+            expect(result.current.messageQueue).toEqual([]);
+        });
+        it('should clear the entire queue after popping', () => {
+            const { result } = renderMessageQueueHook({
+                isConfigInitialized: true,
+                streamingState: StreamingState.Responding,
+                submitQuery: mockSubmitQuery,
+            });
+            act(() => {
+                result.current.addMessage('Message 1');
+                result.current.addMessage('Message 2');
+            });
+            act(() => {
+                result.current.popAllMessages();
+            });
+            // Queue should be empty
+            expect(result.current.messageQueue).toEqual([]);
+            expect(result.current.getQueuedMessagesText()).toBe('');
+            // Popping again should return undefined
+            let secondPop = 'not-undefined';
+            act(() => {
+                secondPop = result.current.popAllMessages();
+            });
+            expect(secondPop).toBeUndefined();
+        });
+        it('should work correctly with state updates', () => {
+            const { result } = renderMessageQueueHook({
+                isConfigInitialized: true,
+                streamingState: StreamingState.Responding,
+                submitQuery: mockSubmitQuery,
+            });
+            // Add messages
+            act(() => {
+                result.current.addMessage('First');
+                result.current.addMessage('Second');
+            });
+            // Pop all messages
+            let firstPop;
+            act(() => {
+                firstPop = result.current.popAllMessages();
+            });
+            expect(firstPop).toBe('First\n\nSecond');
+            // Add new messages after popping
+            act(() => {
+                result.current.addMessage('Third');
+                result.current.addMessage('Fourth');
+            });
+            // Pop again
+            let secondPop;
+            act(() => {
+                secondPop = result.current.popAllMessages();
+            });
+            expect(secondPop).toBe('Third\n\nFourth');
+            expect(result.current.messageQueue).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=useMessageQueue.test.js.map

package/dist/src/ui/hooks/useMessageQueue.test.js.map

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

package/dist/src/ui/hooks/useModelCommand.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface UseModelCommandReturn {
+    isModelDialogOpen: boolean;
+    openModelDialog: () => void;
+    closeModelDialog: () => void;
+}
+export declare const useModelCommand: () => UseModelCommandReturn;
+export {};

package/dist/src/ui/hooks/useModelCommand.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useCallback } from 'react';
+export const useModelCommand = () => {
+    const [isModelDialogOpen, setIsModelDialogOpen] = useState(false);
+    const openModelDialog = useCallback(() => {
+        setIsModelDialogOpen(true);
+    }, []);
+    const closeModelDialog = useCallback(() => {
+        setIsModelDialogOpen(false);
+    }, []);
+    return {
+        isModelDialogOpen,
+        openModelDialog,
+        closeModelDialog,
+    };
+};
+//# sourceMappingURL=useModelCommand.js.map

package/dist/src/ui/hooks/useModelCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelCommand.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useModelCommand.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAQ9C,MAAM,CAAC,MAAM,eAAe,GAAG,GAA0B,EAAE;IACzD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElE,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+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 } from 'vitest';
+import { act } from 'react';
+import { render } from '../../test-utils/render.js';
+import { useModelCommand } from './useModelCommand.js';
+describe('useModelCommand', () => {
+    let result;
+    function TestComponent() {
+        result = useModelCommand();
+        return null;
+    }
+    it('should initialize with the model dialog closed', () => {
+        const { unmount } = render(_jsx(TestComponent, {}));
+        expect(result.isModelDialogOpen).toBe(false);
+        unmount();
+    });
+    it('should open the model dialog when openModelDialog is called', () => {
+        const { unmount } = render(_jsx(TestComponent, {}));
+        act(() => {
+            result.openModelDialog();
+        });
+        expect(result.isModelDialogOpen).toBe(true);
+        unmount();
+    });
+    it('should close the model dialog when closeModelDialog is called', () => {
+        const { unmount } = render(_jsx(TestComponent, {}));
+        // Open it first
+        act(() => {
+            result.openModelDialog();
+        });
+        expect(result.isModelDialogOpen).toBe(true);
+        // Then close it
+        act(() => {
+            result.closeModelDialog();
+        });
+        expect(result.isModelDialogOpen).toBe(false);
+        unmount();
+    });
+});
+//# sourceMappingURL=useModelCommand.test.js.map

package/dist/src/ui/hooks/useModelCommand.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModelCommand.test.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useModelCommand.test.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,MAA0C,CAAC;IAE/C,SAAS,aAAa;QACpB,MAAM,GAAG,eAAe,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,KAAC,aAAa,KAAG,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,KAAC,aAAa,KAAG,CAAC,CAAC;QAE9C,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,KAAC,aAAa,KAAG,CAAC,CAAC;QAE9C,gBAAgB;QAChB,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,gBAAgB;QAChB,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/hooks/useMouse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MouseHandler, MouseEvent } from '../contexts/MouseContext.js';
+export type { MouseEvent };
+/**
+ * A hook that listens for mouse events from stdin.
+ *
+ * @param onMouseEvent - The callback function to execute on each mouse event.
+ * @param options - Options to control the hook's behavior.
+ * @param options.isActive - Whether the hook should be actively listening for input.
+ */
+export declare function useMouse(onMouseEvent: MouseHandler, { isActive }: {
+    isActive: boolean;
+}): void;

package/dist/src/ui/hooks/useMouse.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect } from 'react';
+import { useMouseContext } from '../contexts/MouseContext.js';
+/**
+ * A hook that listens for mouse events from stdin.
+ *
+ * @param onMouseEvent - The callback function to execute on each mouse event.
+ * @param options - Options to control the hook's behavior.
+ * @param options.isActive - Whether the hook should be actively listening for input.
+ */
+export function useMouse(onMouseEvent, { isActive }) {
+    const { subscribe, unsubscribe } = useMouseContext();
+    useEffect(() => {
+        if (!isActive) {
+            return;
+        }
+        subscribe(onMouseEvent);
+        return () => {
+            unsubscribe(onMouseEvent);
+        };
+    }, [isActive, onMouseEvent, subscribe, unsubscribe]);
+}
+//# sourceMappingURL=useMouse.js.map

package/dist/src/ui/hooks/useMouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMouse.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useMouse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAI9D;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,YAA0B,EAC1B,EAAE,QAAQ,EAAyB;IAEnC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,SAAS,CAAC,YAAY,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import { renderHook } from '../../test-utils/render.js';
+import { useMouse } from './useMouse.js';
+import { MouseProvider, useMouseContext } from '../contexts/MouseContext.js';
+vi.mock('../contexts/MouseContext.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    const subscribe = vi.fn();
+    const unsubscribe = vi.fn();
+    return {
+        ...actual,
+        useMouseContext: () => ({
+            subscribe,
+            unsubscribe,
+        }),
+    };
+});
+describe('useMouse', () => {
+    const mockOnMouseEvent = vi.fn();
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should not subscribe when isActive is false', () => {
+        renderHook(() => useMouse(mockOnMouseEvent, { isActive: false }), {
+            wrapper: MouseProvider,
+        });
+        const { subscribe } = useMouseContext();
+        expect(subscribe).not.toHaveBeenCalled();
+    });
+    it('should subscribe when isActive is true', () => {
+        renderHook(() => useMouse(mockOnMouseEvent, { isActive: true }), {
+            wrapper: MouseProvider,
+        });
+        const { subscribe } = useMouseContext();
+        expect(subscribe).toHaveBeenCalledWith(mockOnMouseEvent);
+    });
+    it('should unsubscribe on unmount', () => {
+        const { unmount } = renderHook(() => useMouse(mockOnMouseEvent, { isActive: true }), { wrapper: MouseProvider });
+        const { unsubscribe } = useMouseContext();
+        unmount();
+        expect(unsubscribe).toHaveBeenCalledWith(mockOnMouseEvent);
+    });
+    it('should unsubscribe when isActive becomes false', () => {
+        const { rerender } = renderHook(({ isActive }) => useMouse(mockOnMouseEvent, { isActive }), {
+            initialProps: { isActive: true },
+            wrapper: MouseProvider,
+        });
+        const { unsubscribe } = useMouseContext();
+        rerender({ isActive: false });
+        expect(unsubscribe).toHaveBeenCalledWith(mockOnMouseEvent);
+    });
+});
+//# sourceMappingURL=useMouse.test.js.map

package/dist/src/ui/hooks/useMouse.test.js.map

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

package/dist/src/ui/hooks/useMouseClick.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type DOMElement } from 'ink';
+import type React from 'react';
+import { type MouseEvent } from '../contexts/MouseContext.js';
+export declare const useMouseClick: (containerRef: React.RefObject<DOMElement | null>, handler: (event: MouseEvent, relativeX: number, relativeY: number) => void, options?: {
+    isActive?: boolean;
+    button?: "left" | "right";
+}) => void;

package/dist/src/ui/hooks/useMouseClick.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getBoundingBox } from 'ink';
+import { useMouse } from '../contexts/MouseContext.js';
+export const useMouseClick = (containerRef, handler, options = {}) => {
+    const { isActive = true, button = 'left' } = options;
+    useMouse((event) => {
+        const eventName = button === 'left' ? 'left-press' : 'right-release';
+        if (event.name === eventName && containerRef.current) {
+            const { x, y, width, height } = getBoundingBox(containerRef.current);
+            // Terminal mouse events are 1-based, Ink layout is 0-based.
+            const mouseX = event.col - 1;
+            const mouseY = event.row - 1;
+            const relativeX = mouseX - x;
+            const relativeY = mouseY - y;
+            if (relativeX >= 0 &&
+                relativeX < width &&
+                relativeY >= 0 &&
+                relativeY < height) {
+                handler(event, relativeX, relativeY);
+            }
+        }
+    }, { isActive });
+};
+//# sourceMappingURL=useMouseClick.js.map

package/dist/src/ui/hooks/useMouseClick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMouseClick.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useMouseClick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAmB,MAAM,KAAK,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAmB,MAAM,6BAA6B,CAAC;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,YAAgD,EAChD,OAA0E,EAC1E,UAA6D,EAAE,EAC/D,EAAE;IACF,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAErD,QAAQ,CACN,CAAC,KAAiB,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACrE,4DAA4D;YAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YAE7B,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC;YAE7B,IACE,SAAS,IAAI,CAAC;gBACd,SAAS,GAAG,KAAK;gBACjB,SAAS,IAAI,CAAC;gBACd,SAAS,GAAG,MAAM,EAClB,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,QAAQ,EAAE,CACb,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach } from 'vitest';
+import { renderHook } from '../../test-utils/render.js';
+import { useMouseClick } from './useMouseClick.js';
+import { getBoundingBox } from 'ink';
+// Mock ink
+vi.mock('ink', async () => ({
+    getBoundingBox: vi.fn(),
+}));
+// Mock MouseContext
+const mockUseMouse = vi.fn();
+vi.mock('../contexts/MouseContext.js', async () => ({
+    useMouse: (cb, opts) => mockUseMouse(cb, opts),
+}));
+describe('useMouseClick', () => {
+    let handler;
+    let containerRef;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        handler = vi.fn();
+        containerRef = { current: {} };
+    });
+    it('should call handler with relative coordinates when click is inside bounds', () => {
+        vi.mocked(getBoundingBox).mockReturnValue({
+            x: 10,
+            y: 5,
+            width: 20,
+            height: 10,
+        });
+        renderHook(() => useMouseClick(containerRef, handler));
+        // Get the callback registered with useMouse
+        expect(mockUseMouse).toHaveBeenCalled();
+        const callback = mockUseMouse.mock.calls[0][0];
+        // Simulate click inside: x=15 (col 16), y=7 (row 8)
+        // Terminal events are 1-based. col 16 -> mouseX 15. row 8 -> mouseY 7.
+        // relativeX = 15 - 10 = 5
+        // relativeY = 7 - 5 = 2
+        callback({ name: 'left-press', col: 16, row: 8 });
+        expect(handler).toHaveBeenCalledWith(expect.objectContaining({ name: 'left-press' }), 5, 2);
+    });
+    it('should not call handler when click is outside bounds', () => {
+        vi.mocked(getBoundingBox).mockReturnValue({
+            x: 10,
+            y: 5,
+            width: 20,
+            height: 10,
+        });
+        renderHook(() => useMouseClick(containerRef, handler));
+        const callback = mockUseMouse.mock.calls[0][0];
+        // Click outside: x=5 (col 6), y=7 (row 8) -> left of box
+        callback({ name: 'left-press', col: 6, row: 8 });
+        expect(handler).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=useMouseClick.test.js.map