@rdmind/rdmind 0.0.6 → 0.0.8

package/dist/src/ui/contexts/KeypressContext.test.js

@@ -0,0 +1,894 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { renderHook, act, waitFor } from '@testing-library/react';
+import { vi } from 'vitest';
+import { KeypressProvider, useKeypressContext } from './KeypressContext.js';
+import { useStdin } from 'ink';
+import { EventEmitter } from 'node:events';
+// Mock the 'ink' module to control stdin
+vi.mock('ink', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        useStdin: vi.fn(),
+    };
+});
+class MockStdin extends EventEmitter {
+    isTTY = true;
+    setRawMode = vi.fn();
+    on = this.addListener;
+    removeListener = super.removeListener;
+    write = vi.fn();
+    resume = vi.fn();
+    pause = vi.fn();
+    // Helper to simulate a keypress event
+    pressKey(key) {
+        this.emit('keypress', null, key);
+    }
+    // Helper to simulate a kitty protocol sequence
+    sendKittySequence(sequence) {
+        this.emit('data', Buffer.from(sequence));
+    }
+    // Helper to simulate a paste event
+    sendPaste(text) {
+        const PASTE_MODE_PREFIX = `\x1b[200~`;
+        const PASTE_MODE_SUFFIX = `\x1b[201~`;
+        this.emit('data', Buffer.from(PASTE_MODE_PREFIX));
+        this.emit('data', Buffer.from(text));
+        this.emit('data', Buffer.from(PASTE_MODE_SUFFIX));
+    }
+}
+describe('KeypressContext - Kitty Protocol', () => {
+    let stdin;
+    const mockSetRawMode = vi.fn();
+    const wrapper = ({ children, kittyProtocolEnabled = true, pasteWorkaround = false, }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: kittyProtocolEnabled, pasteWorkaround: pasteWorkaround, children: children }));
+    beforeEach(() => {
+        vi.clearAllMocks();
+        stdin = new MockStdin();
+        useStdin.mockReturnValue({
+            stdin,
+            setRawMode: mockSetRawMode,
+        });
+    });
+    describe('Enter key handling', () => {
+        it('should recognize regular enter key (keycode 13) in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for regular enter: ESC[13u
+            act(() => {
+                stdin.sendKittySequence(`\x1b[13u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+                ctrl: false,
+                meta: false,
+                shift: false,
+            }));
+        });
+        it('should recognize numpad enter key (keycode 57414) in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for numpad enter: ESC[57414u
+            act(() => {
+                stdin.sendKittySequence(`\x1b[57414u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+                ctrl: false,
+                meta: false,
+                shift: false,
+            }));
+        });
+        it('should handle numpad enter with modifiers', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for numpad enter with Shift (modifier 2): ESC[57414;2u
+            act(() => {
+                stdin.sendKittySequence(`\x1b[57414;2u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+                ctrl: false,
+                meta: false,
+                shift: true,
+            }));
+        });
+        it('should handle numpad enter with Ctrl modifier', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for numpad enter with Ctrl (modifier 5): ESC[57414;5u
+            act(() => {
+                stdin.sendKittySequence(`\x1b[57414;5u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+                ctrl: true,
+                meta: false,
+                shift: false,
+            }));
+        });
+        it('should handle numpad enter with Alt modifier', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for numpad enter with Alt (modifier 3): ESC[57414;3u
+            act(() => {
+                stdin.sendKittySequence(`\x1b[57414;3u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+                ctrl: false,
+                meta: true,
+                shift: false,
+            }));
+        });
+        it('should not process kitty sequences when kitty protocol is disabled', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: false }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for numpad enter
+            act(() => {
+                stdin.sendKittySequence(`\x1b[57414u`);
+            });
+            // When kitty protocol is disabled, the sequence should be passed through
+            // as individual keypresses, not recognized as a single enter key
+            expect(keyHandler).not.toHaveBeenCalledWith(expect.objectContaining({
+                name: 'return',
+                kittyProtocol: true,
+            }));
+        });
+    });
+    describe('Escape key handling', () => {
+        it('should recognize escape key (keycode 27) in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, kittyProtocolEnabled: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send kitty protocol sequence for escape: ESC[27u
+            act(() => {
+                stdin.sendKittySequence('\x1b[27u');
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'escape',
+                kittyProtocol: true,
+            }));
+        });
+    });
+    describe('Tab and Backspace handling', () => {
+        it('should recognize Tab key in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => result.current.subscribe(keyHandler));
+            act(() => {
+                stdin.sendKittySequence(`\x1b[9u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'tab',
+                kittyProtocol: true,
+                shift: false,
+            }));
+        });
+        it('should recognize Shift+Tab in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => result.current.subscribe(keyHandler));
+            // Modifier 2 is Shift
+            act(() => {
+                stdin.sendKittySequence(`\x1b[9;2u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'tab',
+                kittyProtocol: true,
+                shift: true,
+            }));
+        });
+        it('should recognize Backspace key in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => result.current.subscribe(keyHandler));
+            act(() => {
+                stdin.sendKittySequence(`\x1b[127u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'backspace',
+                kittyProtocol: true,
+                meta: false,
+            }));
+        });
+        it('should recognize Option+Backspace in kitty protocol', async () => {
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => result.current.subscribe(keyHandler));
+            // Modifier 3 is Alt/Option
+            act(() => {
+                stdin.sendKittySequence(`\x1b[127;3u`);
+            });
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'backspace',
+                kittyProtocol: true,
+                meta: true,
+            }));
+        });
+    });
+    describe('paste mode', () => {
+        it('should handle multiline paste as a single event', async () => {
+            const keyHandler = vi.fn();
+            const pastedText = 'This \n is \n a \n multiline \n paste.';
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper,
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Simulate a bracketed paste event
+            act(() => {
+                stdin.sendPaste(pastedText);
+            });
+            await waitFor(() => {
+                // Expect the handler to be called exactly once for the entire paste
+                expect(keyHandler).toHaveBeenCalledTimes(1);
+            });
+            // Verify the single event contains the full pasted text
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                paste: true,
+                sequence: pastedText,
+            }));
+        });
+        describe('paste mode markers', () => {
+            // These tests use pasteWorkaround=true to force passthrough mode for raw keypress testing
+            it('should handle complete paste sequence with markers', async () => {
+                const keyHandler = vi.fn();
+                const pastedText = 'pasted content';
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send complete paste sequence: prefix + content + suffix
+                act(() => {
+                    stdin.emit('data', Buffer.from(`\x1b[200~${pastedText}\x1b[201~`));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(1);
+                });
+                // Should emit a single paste event with the content
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: pastedText,
+                    name: '',
+                }));
+            });
+            it('should handle empty paste sequence', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send empty paste sequence: prefix immediately followed by suffix
+                act(() => {
+                    stdin.emit('data', Buffer.from('\x1b[200~\x1b[201~'));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(1);
+                });
+                // Should emit a paste event with empty content
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: '',
+                    name: '',
+                }));
+            });
+            it('should handle data before paste markers', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send data before paste sequence
+                act(() => {
+                    stdin.emit('data', Buffer.from('before\x1b[200~pasted\x1b[201~'));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(7); // 6 chars + 1 paste event
+                });
+                // Should process 'before' as individual characters
+                expect(keyHandler).toHaveBeenNthCalledWith(1, expect.objectContaining({ name: 'b' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(2, expect.objectContaining({ name: 'e' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(3, expect.objectContaining({ name: 'f' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(4, expect.objectContaining({ name: 'o' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(5, expect.objectContaining({ name: 'r' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(6, expect.objectContaining({ name: 'e' }));
+                // Then emit paste event
+                expect(keyHandler).toHaveBeenNthCalledWith(7, expect.objectContaining({
+                    paste: true,
+                    sequence: 'pasted',
+                }));
+            });
+            it('should handle data after paste markers', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send paste sequence followed by data
+                act(() => {
+                    stdin.emit('data', Buffer.from('\x1b[200~pasted\x1b[201~after'));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(6); // 1 paste event + 5 individual chars for 'after'
+                });
+                // Should emit paste event first
+                expect(keyHandler).toHaveBeenNthCalledWith(1, expect.objectContaining({
+                    paste: true,
+                    sequence: 'pasted',
+                }));
+                // Then process 'after' as individual characters (since it doesn't contain return)
+                expect(keyHandler).toHaveBeenNthCalledWith(2, expect.objectContaining({
+                    name: 'a',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(3, expect.objectContaining({
+                    name: 'f',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(4, expect.objectContaining({
+                    name: 't',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(5, expect.objectContaining({
+                    name: 'e',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(6, expect.objectContaining({
+                    name: 'r',
+                    paste: false,
+                }));
+            });
+            it('should handle complex sequence with multiple paste blocks', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send complex sequence: data + paste1 + data + paste2 + data
+                act(() => {
+                    stdin.emit('data', Buffer.from('start\x1b[200~first\x1b[201~middle\x1b[200~second\x1b[201~end'));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(16); // 5 + 1 + 6 + 1 + 3 = 16 calls
+                });
+                // Check the sequence: 'start' (5 chars) + paste1 + 'middle' (6 chars) + paste2 + 'end' (3 chars as paste)
+                let callIndex = 1;
+                // 'start'
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 's' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 't' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'a' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'r' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 't' }));
+                // first paste
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({
+                    paste: true,
+                    sequence: 'first',
+                }));
+                // 'middle'
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'm' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'i' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'd' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'd' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'l' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'e' }));
+                // second paste
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({
+                    paste: true,
+                    sequence: 'second',
+                }));
+                // 'end' as individual characters (since it doesn't contain return)
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'e' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'n' }));
+                expect(keyHandler).toHaveBeenNthCalledWith(callIndex++, expect.objectContaining({ name: 'd' }));
+            });
+            it('should handle fragmented paste markers across multiple data events', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send fragmented paste sequence
+                act(() => {
+                    stdin.emit('data', Buffer.from('\x1b[200~partial'));
+                    stdin.emit('data', Buffer.from(' content\x1b[201~'));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(1);
+                });
+                // Should combine the fragmented content into a single paste event
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: 'partial content',
+                }));
+            });
+            it('should handle multiline content within paste markers', async () => {
+                const keyHandler = vi.fn();
+                const multilineContent = 'line1\nline2\nline3';
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send paste sequence with multiline content
+                act(() => {
+                    stdin.emit('data', Buffer.from(`\x1b[200~${multilineContent}\x1b[201~`));
+                });
+                await waitFor(() => {
+                    expect(keyHandler).toHaveBeenCalledTimes(1);
+                });
+                // Should emit a single paste event with the multiline content
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: multilineContent,
+                }));
+            });
+            it('should handle paste markers split across buffer boundaries', async () => {
+                const keyHandler = vi.fn();
+                const { result } = renderHook(() => useKeypressContext(), {
+                    wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+                });
+                act(() => {
+                    result.current.subscribe(keyHandler);
+                });
+                // Send paste marker split across multiple data events
+                act(() => {
+                    stdin.emit('data', Buffer.from('\x1b[20'));
+                    stdin.emit('data', Buffer.from('0~content\x1b[2'));
+                    stdin.emit('data', Buffer.from('01~'));
+                });
+                await waitFor(() => {
+                    // With the current implementation, fragmented paste markers get reconstructed
+                    // into a single paste event for 'content'
+                    expect(keyHandler).toHaveBeenCalledTimes(1);
+                });
+                // Should reconstruct the fragmented paste markers into a single paste event
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: 'content',
+                }));
+            });
+        });
+        it('buffers fragmented paste chunks before emitting newlines', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                act(() => {
+                    stdin.emit('data', Buffer.from('\r'));
+                    stdin.emit('data', Buffer.from('rest of paste'));
+                });
+                act(() => {
+                    vi.advanceTimersByTime(8);
+                });
+                // With the current implementation, fragmented data gets combined and
+                // treated as a single paste event due to the buffering mechanism
+                expect(keyHandler).toHaveBeenCalledTimes(1);
+                // Should be treated as a paste event with the combined content
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    paste: true,
+                    sequence: '\rrest of paste',
+                }));
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+    });
+    describe('Raw keypress pipeline', () => {
+        // These tests use pasteWorkaround=true to force passthrough mode for raw keypress testing
+        it('should buffer input data and wait for timeout', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // Send single character
+                act(() => {
+                    stdin.emit('data', Buffer.from('a'));
+                });
+                // With the current implementation, single characters are processed immediately
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    name: 'a',
+                    sequence: 'a',
+                }));
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+        it('should concatenate new data and reset timeout', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // Send first chunk
+                act(() => {
+                    stdin.emit('data', Buffer.from('hel'));
+                });
+                // Advance timer partially
+                act(() => {
+                    vi.advanceTimersByTime(4);
+                });
+                // Send second chunk before timeout
+                act(() => {
+                    stdin.emit('data', Buffer.from('lo'));
+                });
+                // With the current implementation, data is processed as individual characters
+                // since 'hel' doesn't contain return (0x0d)
+                expect(keyHandler).toHaveBeenNthCalledWith(1, expect.objectContaining({
+                    name: 'h',
+                    sequence: 'h',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(2, expect.objectContaining({
+                    name: 'e',
+                    sequence: 'e',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(3, expect.objectContaining({
+                    name: 'l',
+                    sequence: 'l',
+                    paste: false,
+                }));
+                // Second chunk 'lo' is also processed as individual characters
+                expect(keyHandler).toHaveBeenNthCalledWith(4, expect.objectContaining({
+                    name: 'l',
+                    sequence: 'l',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(5, expect.objectContaining({
+                    name: 'o',
+                    sequence: 'o',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenCalledTimes(5);
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+        it('should flush immediately when buffer exceeds limit', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // Create a large buffer that exceeds the 64 byte limit
+                const largeData = 'x'.repeat(65);
+                act(() => {
+                    stdin.emit('data', Buffer.from(largeData));
+                });
+                // Should flush immediately without waiting for timeout
+                // Large data without return gets treated as individual characters
+                expect(keyHandler).toHaveBeenCalledTimes(65);
+                // Each character should be processed individually
+                for (let i = 0; i < 65; i++) {
+                    expect(keyHandler).toHaveBeenNthCalledWith(i + 1, expect.objectContaining({
+                        name: 'x',
+                        sequence: 'x',
+                        paste: false,
+                    }));
+                }
+                // Advancing timer should not cause additional calls
+                const callCountBefore = keyHandler.mock.calls.length;
+                act(() => {
+                    vi.advanceTimersByTime(8);
+                });
+                expect(keyHandler).toHaveBeenCalledTimes(callCountBefore);
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+        it('should clear timeout when new data arrives', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // Send first chunk
+                act(() => {
+                    stdin.emit('data', Buffer.from('a'));
+                });
+                // Advance timer almost to completion
+                act(() => {
+                    vi.advanceTimersByTime(7);
+                });
+                // Send second chunk (should reset timeout)
+                act(() => {
+                    stdin.emit('data', Buffer.from('b'));
+                });
+                // With the current implementation, both characters are processed immediately
+                expect(keyHandler).toHaveBeenCalledTimes(2);
+                // First event should be 'a', second should be 'b'
+                expect(keyHandler).toHaveBeenNthCalledWith(1, expect.objectContaining({
+                    name: 'a',
+                    sequence: 'a',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(2, expect.objectContaining({
+                    name: 'b',
+                    sequence: 'b',
+                    paste: false,
+                }));
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+        it('should handle multiple separate keypress events', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // First keypress
+                act(() => {
+                    stdin.emit('data', Buffer.from('a'));
+                });
+                act(() => {
+                    vi.advanceTimersByTime(8);
+                });
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    sequence: 'a',
+                }));
+                keyHandler.mockClear();
+                // Second keypress after first completed
+                act(() => {
+                    stdin.emit('data', Buffer.from('b'));
+                });
+                act(() => {
+                    vi.advanceTimersByTime(8);
+                });
+                expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                    sequence: 'b',
+                }));
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+        it('should handle rapid sequential data within buffer limit', () => {
+            vi.useFakeTimers();
+            const keyHandler = vi.fn();
+            const { result } = renderHook(() => useKeypressContext(), {
+                wrapper: ({ children }) => wrapper({ children, pasteWorkaround: true }),
+            });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            try {
+                // Send multiple small chunks rapidly
+                act(() => {
+                    stdin.emit('data', Buffer.from('h'));
+                    stdin.emit('data', Buffer.from('e'));
+                    stdin.emit('data', Buffer.from('l'));
+                    stdin.emit('data', Buffer.from('l'));
+                    stdin.emit('data', Buffer.from('o'));
+                });
+                // With the current implementation, each character is processed immediately
+                expect(keyHandler).toHaveBeenCalledTimes(5);
+                // Each character should be processed as individual keypress events
+                expect(keyHandler).toHaveBeenNthCalledWith(1, expect.objectContaining({
+                    name: 'h',
+                    sequence: 'h',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(2, expect.objectContaining({
+                    name: 'e',
+                    sequence: 'e',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(3, expect.objectContaining({
+                    name: 'l',
+                    sequence: 'l',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(4, expect.objectContaining({
+                    name: 'l',
+                    sequence: 'l',
+                    paste: false,
+                }));
+                expect(keyHandler).toHaveBeenNthCalledWith(5, expect.objectContaining({
+                    name: 'o',
+                    sequence: 'o',
+                    paste: false,
+                }));
+            }
+            finally {
+                vi.useRealTimers();
+            }
+        });
+    });
+    describe('debug keystroke logging', () => {
+        let consoleLogSpy;
+        let consoleWarnSpy;
+        beforeEach(() => {
+            consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+            consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        });
+        afterEach(() => {
+            consoleLogSpy.mockRestore();
+            consoleWarnSpy.mockRestore();
+        });
+        it('should not log keystrokes when debugKeystrokeLogging is false', async () => {
+            const keyHandler = vi.fn();
+            const wrapper = ({ children }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: true, debugKeystrokeLogging: false, children: children }));
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send a kitty sequence
+            act(() => {
+                stdin.sendKittySequence('\x1b[27u');
+            });
+            expect(keyHandler).toHaveBeenCalled();
+            expect(consoleLogSpy).not.toHaveBeenCalledWith(expect.stringContaining('[DEBUG] Kitty'));
+        });
+        it('should log kitty buffer accumulation when debugKeystrokeLogging is true', async () => {
+            const keyHandler = vi.fn();
+            const wrapper = ({ children }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: true, debugKeystrokeLogging: true, children: children }));
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send a complete kitty sequence for escape
+            act(() => {
+                stdin.sendKittySequence('\x1b[27u');
+            });
+            expect(consoleLogSpy).toHaveBeenCalledWith('[DEBUG] Kitty buffer accumulating:', expect.stringContaining('\x1b[27u'));
+            expect(consoleLogSpy).toHaveBeenCalledWith('[DEBUG] Kitty sequence parsed successfully:', expect.stringContaining('\x1b[27u'));
+        });
+        it('should log kitty buffer overflow when debugKeystrokeLogging is true', async () => {
+            const keyHandler = vi.fn();
+            const wrapper = ({ children }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: true, debugKeystrokeLogging: true, children: children }));
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send an invalid long sequence to trigger overflow
+            const longInvalidSequence = '\x1b[' + 'x'.repeat(100);
+            act(() => {
+                stdin.sendKittySequence(longInvalidSequence);
+            });
+            expect(consoleLogSpy).toHaveBeenCalledWith('[DEBUG] Kitty buffer overflow, clearing:', expect.any(String));
+        });
+        it('should log kitty buffer clear on Ctrl+C when debugKeystrokeLogging is true', async () => {
+            const keyHandler = vi.fn();
+            const wrapper = ({ children }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: true, debugKeystrokeLogging: true, children: children }));
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send incomplete kitty sequence
+            act(() => {
+                stdin.pressKey({
+                    name: undefined,
+                    ctrl: false,
+                    meta: false,
+                    shift: false,
+                    sequence: '\x1b[1',
+                });
+            });
+            // Send Ctrl+C
+            act(() => {
+                stdin.pressKey({
+                    name: 'c',
+                    ctrl: true,
+                    meta: false,
+                    shift: false,
+                    sequence: '\x03',
+                });
+            });
+            expect(consoleLogSpy).toHaveBeenCalledWith('[DEBUG] Kitty buffer cleared on Ctrl+C:', '\x1b[1');
+            // Verify Ctrl+C was handled
+            expect(keyHandler).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'c',
+                ctrl: true,
+            }));
+        });
+        it('should show char codes when debugKeystrokeLogging is true even without debug mode', async () => {
+            const keyHandler = vi.fn();
+            const wrapper = ({ children }) => (_jsx(KeypressProvider, { kittyProtocolEnabled: true, debugKeystrokeLogging: true, children: children }));
+            const { result } = renderHook(() => useKeypressContext(), { wrapper });
+            act(() => {
+                result.current.subscribe(keyHandler);
+            });
+            // Send incomplete kitty sequence
+            const sequence = '\x1b[12';
+            act(() => {
+                stdin.pressKey({
+                    name: undefined,
+                    ctrl: false,
+                    meta: false,
+                    shift: false,
+                    sequence,
+                });
+            });
+            // Verify debug logging for accumulation
+            expect(consoleLogSpy).toHaveBeenCalledWith('[DEBUG] Kitty buffer accumulating:', sequence);
+            // Verify warning for char codes
+            expect(consoleWarnSpy).toHaveBeenCalledWith('Kitty sequence buffer has char codes:', [27, 91, 49, 50]);
+        });
+    });
+});
+//# sourceMappingURL=KeypressContext.test.js.map