@vybestack/llxprt-code 0.1.20-nightly.250818.90f427f5 → 0.1.21

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

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, } from 'vitest';
+import { renderHook } from '@testing-library/react';
+import { useResponsive } from './useResponsive.js';
+import { useTerminalSize } from './useTerminalSize.js';
+vi.mock('./useTerminalSize');
+describe('useResponsive', () => {
+    let mockUseTerminalSize;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockUseTerminalSize = useTerminalSize;
+    });
+    it('should return NARROW breakpoint for narrow widths', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 60, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(60);
+        expect(result.current.breakpoint).toBe('NARROW');
+        expect(result.current.isNarrow).toBe(true);
+        expect(result.current.isStandard).toBe(false);
+        expect(result.current.isWide).toBe(false);
+    });
+    it('should return STANDARD breakpoint for width at narrow threshold', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 80, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(80);
+        expect(result.current.breakpoint).toBe('STANDARD');
+        expect(result.current.isNarrow).toBe(false);
+        expect(result.current.isStandard).toBe(true);
+        expect(result.current.isWide).toBe(false);
+    });
+    it('should return STANDARD breakpoint for standard widths', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 100, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(100);
+        expect(result.current.breakpoint).toBe('STANDARD');
+        expect(result.current.isNarrow).toBe(false);
+        expect(result.current.isStandard).toBe(true);
+        expect(result.current.isWide).toBe(false);
+    });
+    it('should return STANDARD breakpoint for width at standard threshold', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 120, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(120);
+        expect(result.current.breakpoint).toBe('STANDARD');
+        expect(result.current.isNarrow).toBe(false);
+        expect(result.current.isStandard).toBe(true);
+        expect(result.current.isWide).toBe(false);
+    });
+    it('should return WIDE breakpoint for wide widths', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 200, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(200);
+        expect(result.current.breakpoint).toBe('WIDE');
+        expect(result.current.isNarrow).toBe(false);
+        expect(result.current.isStandard).toBe(false);
+        expect(result.current.isWide).toBe(true);
+    });
+    it('should return WIDE breakpoint for width at wide threshold', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 160, rows: 20 });
+        const { result } = renderHook(() => useResponsive());
+        expect(result.current.width).toBe(160);
+        expect(result.current.breakpoint).toBe('WIDE');
+        expect(result.current.isNarrow).toBe(false);
+        expect(result.current.isStandard).toBe(false);
+        expect(result.current.isWide).toBe(true);
+    });
+    it('should update when terminal size changes', () => {
+        mockUseTerminalSize.mockReturnValue({ columns: 60, rows: 20 });
+        const { result, rerender } = renderHook(() => useResponsive());
+        expect(result.current.breakpoint).toBe('NARROW');
+        // Simulate terminal size change
+        mockUseTerminalSize.mockReturnValue({ columns: 150, rows: 20 });
+        rerender();
+        expect(result.current.width).toBe(150);
+        expect(result.current.breakpoint).toBe('WIDE');
+        expect(result.current.isWide).toBe(true);
+    });
+    it('should provide consistent boolean flags for each breakpoint', () => {
+        const testCases = [
+            {
+                width: 50,
+                expectedNarrow: true,
+                expectedStandard: false,
+                expectedWide: false,
+            },
+            {
+                width: 80,
+                expectedNarrow: false,
+                expectedStandard: true,
+                expectedWide: false,
+            },
+            {
+                width: 100,
+                expectedNarrow: false,
+                expectedStandard: true,
+                expectedWide: false,
+            },
+            {
+                width: 120,
+                expectedNarrow: false,
+                expectedStandard: true,
+                expectedWide: false,
+            },
+            {
+                width: 180,
+                expectedNarrow: false,
+                expectedStandard: false,
+                expectedWide: true,
+            },
+        ];
+        testCases.forEach(({ width, expectedNarrow, expectedStandard, expectedWide }) => {
+            mockUseTerminalSize.mockReturnValue({ columns: width, rows: 20 });
+            const { result } = renderHook(() => useResponsive());
+            expect(result.current.isNarrow).toBe(expectedNarrow);
+            expect(result.current.isStandard).toBe(expectedStandard);
+            expect(result.current.isWide).toBe(expectedWide);
+        });
+    });
+});
+//# sourceMappingURL=useResponsive.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResponsive.test.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useResponsive.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,EAAE,EACF,MAAM,EACN,EAAE,EACF,UAAU,GAEX,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAE7B,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,mBAA2D,CAAC;IAEhE,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,mBAAmB,GAAG,eAErB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjD,gCAAgC;QAChC,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,QAAQ,EAAE,CAAC;QAEX,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG;YAChB;gBACE,KAAK,EAAE,EAAE;gBACT,cAAc,EAAE,IAAI;gBACpB,gBAAgB,EAAE,KAAK;gBACvB,YAAY,EAAE,KAAK;aACpB;YACD;gBACE,KAAK,EAAE,EAAE;gBACT,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,KAAK;aACpB;YACD;gBACE,KAAK,EAAE,GAAG;gBACV,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,KAAK;aACpB;YACD;gBACE,KAAK,EAAE,GAAG;gBACV,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,KAAK;aACpB;YACD;gBACE,KAAK,EAAE,GAAG;gBACV,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,KAAK;gBACvB,YAAY,EAAE,IAAI;aACnB;SACF,CAAC;QAEF,SAAS,CAAC,OAAO,CACf,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,EAAE,EAAE;YAC5D,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAElE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACzD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/hooks/useReverseSearchCompletion.test.d.ts

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

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

@@ -0,0 +1,163 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** @vitest-environment jsdom */
+import { describe, it, expect } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { useReverseSearchCompletion } from './useReverseSearchCompletion.js';
+import { useTextBuffer } from '../components/shared/text-buffer.js';
+describe('useReverseSearchCompletion', () => {
+    function useTextBufferForTest(text) {
+        return useTextBuffer({
+            initialText: text,
+            initialCursorOffset: text.length,
+            viewport: { width: 80, height: 20 },
+            isValidPath: () => false,
+            onChange: () => { },
+        });
+    }
+    describe('Core Hook Behavior', () => {
+        describe('State Management', () => {
+            it('should initialize with default state', () => {
+                const mockShellHistory = ['echo hello'];
+                const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest(''), mockShellHistory, false));
+                expect(result.current.suggestions).toEqual([]);
+                expect(result.current.activeSuggestionIndex).toBe(-1);
+                expect(result.current.visibleStartIndex).toBe(0);
+                expect(result.current.showSuggestions).toBe(false);
+                expect(result.current.isLoadingSuggestions).toBe(false);
+            });
+            it('should reset state when reverseSearchActive becomes false', () => {
+                const mockShellHistory = ['echo hello'];
+                const { result, rerender } = renderHook(({ text, active }) => {
+                    const textBuffer = useTextBufferForTest(text);
+                    return useReverseSearchCompletion(textBuffer, mockShellHistory, active);
+                }, { initialProps: { text: 'echo', active: true } });
+                // Simulate reverseSearchActive becoming false
+                rerender({ text: 'echo', active: false });
+                expect(result.current.suggestions).toEqual([]);
+                expect(result.current.activeSuggestionIndex).toBe(-1);
+                expect(result.current.visibleStartIndex).toBe(0);
+                expect(result.current.showSuggestions).toBe(false);
+            });
+            describe('Navigation', () => {
+                it('should handle navigateUp with no suggestions', () => {
+                    const mockShellHistory = ['echo hello'];
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('grep'), mockShellHistory, true));
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(-1);
+                });
+                it('should handle navigateDown with no suggestions', () => {
+                    const mockShellHistory = ['echo hello'];
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('grep'), mockShellHistory, true));
+                    act(() => {
+                        result.current.navigateDown();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(-1);
+                });
+                it('should navigate up through suggestions with wrap-around', () => {
+                    const mockShellHistory = [
+                        'ls -l',
+                        'ls -la',
+                        'cd /some/path',
+                        'git status',
+                        'echo "Hello, World!"',
+                        'echo Hi',
+                    ];
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('echo'), mockShellHistory, true));
+                    expect(result.current.suggestions.length).toBe(2);
+                    expect(result.current.activeSuggestionIndex).toBe(0);
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(1);
+                });
+                it('should navigate down through suggestions with wrap-around', () => {
+                    const mockShellHistory = [
+                        'ls -l',
+                        'ls -la',
+                        'cd /some/path',
+                        'git status',
+                        'echo "Hello, World!"',
+                        'echo Hi',
+                    ];
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('ls'), mockShellHistory, true));
+                    expect(result.current.suggestions.length).toBe(2);
+                    expect(result.current.activeSuggestionIndex).toBe(0);
+                    act(() => {
+                        result.current.navigateDown();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(1);
+                });
+                it('should handle navigation with multiple suggestions', () => {
+                    const mockShellHistory = [
+                        'ls -l',
+                        'ls -la',
+                        'cd /some/path/l',
+                        'git status',
+                        'echo "Hello, World!"',
+                        'echo "Hi all"',
+                    ];
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('l'), mockShellHistory, true));
+                    expect(result.current.suggestions.length).toBe(5);
+                    expect(result.current.activeSuggestionIndex).toBe(0);
+                    act(() => {
+                        result.current.navigateDown();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(1);
+                    act(() => {
+                        result.current.navigateDown();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(2);
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(1);
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(0);
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(4);
+                });
+                it('should handle navigation with large suggestion lists and scrolling', () => {
+                    const largeMockCommands = Array.from({ length: 15 }, (_, i) => `echo ${i}`);
+                    const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('echo'), largeMockCommands, true));
+                    expect(result.current.suggestions.length).toBe(15);
+                    expect(result.current.activeSuggestionIndex).toBe(0);
+                    expect(result.current.visibleStartIndex).toBe(0);
+                    act(() => {
+                        result.current.navigateUp();
+                    });
+                    expect(result.current.activeSuggestionIndex).toBe(14);
+                    expect(result.current.visibleStartIndex).toBe(Math.max(0, 15 - 8));
+                });
+            });
+        });
+    });
+    describe('Filtering', () => {
+        it('filters history by buffer.text and sets showSuggestions', () => {
+            const history = ['foo', 'barfoo', 'baz'];
+            const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('foo'), history, true));
+            // should only return the two entries containing "foo"
+            expect(result.current.suggestions.map((s) => s.value)).toEqual([
+                'foo',
+                'barfoo',
+            ]);
+            expect(result.current.showSuggestions).toBe(true);
+        });
+        it('hides suggestions when there are no matches', () => {
+            const history = ['alpha', 'beta'];
+            const { result } = renderHook(() => useReverseSearchCompletion(useTextBufferForTest('γ'), history, true));
+            expect(result.current.suggestions).toEqual([]);
+            expect(result.current.showSuggestions).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=useReverseSearchCompletion.test.js.map

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

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

package/dist/src/ui/hooks/useShellHistory.test.d.ts

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

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

@@ -0,0 +1,162 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { renderHook, act, waitFor } from '@testing-library/react';
+import { useShellHistory } from './useShellHistory.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+vi.mock('fs/promises');
+vi.mock('os');
+vi.mock('crypto');
+const MOCKED_PROJECT_ROOT = '/test/project';
+const MOCKED_HOME_DIR = '/test/home';
+const MOCKED_PROJECT_HASH = 'mocked_hash';
+const MOCKED_HISTORY_DIR = path.join(MOCKED_HOME_DIR, '.llxprt', 'tmp', MOCKED_PROJECT_HASH);
+const MOCKED_HISTORY_FILE = path.join(MOCKED_HISTORY_DIR, 'shell_history');
+describe('useShellHistory', () => {
+    const mockedFs = vi.mocked(fs);
+    const mockedOs = vi.mocked(os);
+    const mockedCrypto = vi.mocked(crypto);
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockedFs.readFile.mockResolvedValue('');
+        mockedFs.writeFile.mockResolvedValue(undefined);
+        mockedFs.mkdir.mockResolvedValue(undefined);
+        mockedOs.homedir.mockReturnValue(MOCKED_HOME_DIR);
+        const hashMock = {
+            update: vi.fn().mockReturnThis(),
+            digest: vi.fn().mockReturnValue(MOCKED_PROJECT_HASH),
+        };
+        mockedCrypto.createHash.mockReturnValue(hashMock);
+    });
+    it('should initialize and read the history file from the correct path', async () => {
+        mockedFs.readFile.mockResolvedValue('cmd1\ncmd2');
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        await waitFor(() => {
+            expect(mockedFs.readFile).toHaveBeenCalledWith(MOCKED_HISTORY_FILE, 'utf-8');
+        });
+        let command = null;
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        // History is loaded newest-first: ['cmd2', 'cmd1']
+        expect(command).toBe('cmd2');
+    });
+    it('should handle a nonexistent history file gracefully', async () => {
+        const error = new Error('File not found');
+        error.code = 'ENOENT';
+        mockedFs.readFile.mockRejectedValue(error);
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        await waitFor(() => {
+            expect(mockedFs.readFile).toHaveBeenCalled();
+        });
+        let command = null;
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe(null);
+    });
+    it('should add a command and write to the history file', async () => {
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        await waitFor(() => expect(mockedFs.readFile).toHaveBeenCalled());
+        act(() => {
+            result.current.addCommandToHistory('new_command');
+        });
+        await waitFor(() => {
+            expect(mockedFs.mkdir).toHaveBeenCalledWith(MOCKED_HISTORY_DIR, {
+                recursive: true,
+            });
+            expect(mockedFs.writeFile).toHaveBeenCalledWith(MOCKED_HISTORY_FILE, 'new_command');
+        });
+        let command = null;
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe('new_command');
+    });
+    it('should navigate history correctly with previous/next commands', async () => {
+        mockedFs.readFile.mockResolvedValue('cmd1\ncmd2\ncmd3');
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        // Wait for history to be loaded: ['cmd3', 'cmd2', 'cmd1']
+        await waitFor(() => expect(mockedFs.readFile).toHaveBeenCalled());
+        let command = null;
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe('cmd3');
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe('cmd2');
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe('cmd1');
+        // Should stay at the oldest command
+        act(() => {
+            command = result.current.getPreviousCommand();
+        });
+        expect(command).toBe('cmd1');
+        act(() => {
+            command = result.current.getNextCommand();
+        });
+        expect(command).toBe('cmd2');
+        act(() => {
+            command = result.current.getNextCommand();
+        });
+        expect(command).toBe('cmd3');
+        // Should return to the "new command" line (represented as empty string)
+        act(() => {
+            command = result.current.getNextCommand();
+        });
+        expect(command).toBe('');
+    });
+    it('should not add empty or whitespace-only commands to history', async () => {
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        await waitFor(() => expect(mockedFs.readFile).toHaveBeenCalled());
+        act(() => {
+            result.current.addCommandToHistory('   ');
+        });
+        expect(mockedFs.writeFile).not.toHaveBeenCalled();
+    });
+    it('should truncate history to MAX_HISTORY_LENGTH (100)', async () => {
+        const oldCommands = Array.from({ length: 120 }, (_, i) => `old_cmd_${i}`);
+        mockedFs.readFile.mockResolvedValue(oldCommands.join('\n'));
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        await waitFor(() => expect(mockedFs.readFile).toHaveBeenCalled());
+        act(() => {
+            result.current.addCommandToHistory('new_cmd');
+        });
+        // Wait for the async write to happen and then inspect the arguments.
+        await waitFor(() => expect(mockedFs.writeFile).toHaveBeenCalled());
+        // The hook stores history newest-first.
+        // Initial state: ['old_cmd_119', ..., 'old_cmd_0']
+        // After adding 'new_cmd': ['new_cmd', 'old_cmd_119', ..., 'old_cmd_21'] (100 items)
+        // Written to file (reversed): ['old_cmd_21', ..., 'old_cmd_119', 'new_cmd']
+        const writtenContent = mockedFs.writeFile.mock.calls[0][1];
+        const writtenLines = writtenContent.split('\n');
+        expect(writtenLines.length).toBe(100);
+        expect(writtenLines[0]).toBe('old_cmd_21'); // New oldest command
+        expect(writtenLines[99]).toBe('new_cmd'); // Newest command
+    });
+    it('should move an existing command to the top when re-added', async () => {
+        mockedFs.readFile.mockResolvedValue('cmd1\ncmd2\ncmd3');
+        const { result } = renderHook(() => useShellHistory(MOCKED_PROJECT_ROOT));
+        // Initial state: ['cmd3', 'cmd2', 'cmd1']
+        await waitFor(() => expect(mockedFs.readFile).toHaveBeenCalled());
+        act(() => {
+            result.current.addCommandToHistory('cmd1');
+        });
+        // After re-adding 'cmd1': ['cmd1', 'cmd3', 'cmd2']
+        // Written to file (reversed): ['cmd2', 'cmd3', 'cmd1']
+        await waitFor(() => expect(mockedFs.writeFile).toHaveBeenCalled());
+        const writtenContent = mockedFs.writeFile.mock.calls[0][1];
+        const writtenLines = writtenContent.split('\n');
+        expect(writtenLines).toEqual(['cmd2', 'cmd3', 'cmd1']);
+    });
+});
+//# sourceMappingURL=useShellHistory.test.js.map

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

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

package/dist/src/ui/hooks/useSlashCompletion.test.d.ts

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