@google/gemini-cli 0.1.21 → 0.2.0-preview.0

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

@@ -3,346 +3,25 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { useEffect, useRef } from 'react';
-import { useStdin } from 'ink';
-import readline from 'readline';
-import { PassThrough } from 'stream';
-import { KITTY_CTRL_C, BACKSLASH_ENTER_DETECTION_WINDOW_MS, MAX_KITTY_SEQUENCE_LENGTH, } from '../utils/platformConstants.js';
-import { KittySequenceOverflowEvent, logKittySequenceOverflow, } from '@google/gemini-cli-core';
-import { FOCUS_IN, FOCUS_OUT } from './useFocus.js';
-const ESC = '\u001B';
-export const PASTE_MODE_PREFIX = `${ESC}[200~`;
-export const PASTE_MODE_SUFFIX = `${ESC}[201~`;
+import { useEffect } from 'react';
+import { useKeypressContext, } from '../contexts/KeypressContext.js';
 /**
- * A hook that listens for keypress events from stdin, providing a
- * key object that mirrors the one from Node's `readline` module,
- * adding a 'paste' flag for characters input as part of a bracketed
- * paste (when enabled).
- *
- * Pastes are currently sent as a single key event where the full paste
- * is in the sequence field.
+ * A hook that listens for keypress events from stdin.
  *
  * @param onKeypress - The callback function to execute on each keypress.
  * @param options - Options to control the hook's behavior.
  * @param options.isActive - Whether the hook should be actively listening for input.
- * @param options.kittyProtocolEnabled - Whether Kitty keyboard protocol is enabled.
- * @param options.config - Optional config for telemetry logging.
  */
-export function useKeypress(onKeypress, { isActive, kittyProtocolEnabled = false, config, }) {
-    const { stdin, setRawMode } = useStdin();
-    const onKeypressRef = useRef(onKeypress);
-    useEffect(() => {
-        onKeypressRef.current = onKeypress;
-    }, [onKeypress]);
+export function useKeypress(onKeypress, { isActive }) {
+    const { subscribe, unsubscribe } = useKeypressContext();
     useEffect(() => {
-        if (!isActive || !stdin.isTTY) {
+        if (!isActive) {
             return;
         }
-        setRawMode(true);
-        const keypressStream = new PassThrough();
-        let usePassthrough = false;
-        const nodeMajorVersion = parseInt(process.versions.node.split('.')[0], 10);
-        if (nodeMajorVersion < 20 ||
-            process.env['PASTE_WORKAROUND'] === '1' ||
-            process.env['PASTE_WORKAROUND'] === 'true') {
-            // Prior to node 20, node's built-in readline does not support bracketed
-            // paste mode. We hack by detecting it with our own handler.
-            usePassthrough = true;
-        }
-        let isPaste = false;
-        let pasteBuffer = Buffer.alloc(0);
-        let kittySequenceBuffer = '';
-        let backslashTimeout = null;
-        let waitingForEnterAfterBackslash = false;
-        // Parse Kitty protocol sequences
-        const parseKittySequence = (sequence) => {
-            // Match CSI <number> ; <modifiers> u or ~
-            // Format: ESC [ <keycode> ; <modifiers> u/~
-            const kittyPattern = new RegExp(`^${ESC}\\[(\\d+)(;(\\d+))?([u~])$`);
-            const match = sequence.match(kittyPattern);
-            if (!match)
-                return null;
-            const keyCode = parseInt(match[1], 10);
-            const modifiers = match[3] ? parseInt(match[3], 10) : 1;
-            // Decode modifiers (subtract 1 as per Kitty protocol spec)
-            const modifierBits = modifiers - 1;
-            const shift = (modifierBits & 1) === 1;
-            const alt = (modifierBits & 2) === 2;
-            const ctrl = (modifierBits & 4) === 4;
-            // Handle Escape key (code 27)
-            if (keyCode === 27) {
-                return {
-                    name: 'escape',
-                    ctrl,
-                    meta: alt,
-                    shift,
-                    paste: false,
-                    sequence,
-                    kittyProtocol: true,
-                };
-            }
-            // Handle Enter key (code 13)
-            if (keyCode === 13) {
-                return {
-                    name: 'return',
-                    ctrl,
-                    meta: alt,
-                    shift,
-                    paste: false,
-                    sequence,
-                    kittyProtocol: true,
-                };
-            }
-            // Handle Ctrl+letter combinations (a-z)
-            // ASCII codes: a=97, b=98, c=99, ..., z=122
-            if (keyCode >= 97 && keyCode <= 122 && ctrl) {
-                const letter = String.fromCharCode(keyCode);
-                return {
-                    name: letter,
-                    ctrl: true,
-                    meta: alt,
-                    shift,
-                    paste: false,
-                    sequence,
-                    kittyProtocol: true,
-                };
-            }
-            // Handle other keys as needed
-            return null;
-        };
-        const handleKeypress = (_, key) => {
-            // Handle VS Code's backslash+return pattern (Shift+Enter)
-            if (key.name === 'return' && waitingForEnterAfterBackslash) {
-                // Cancel the timeout since we got the Enter
-                if (backslashTimeout) {
-                    clearTimeout(backslashTimeout);
-                    backslashTimeout = null;
-                }
-                waitingForEnterAfterBackslash = false;
-                // Convert to Shift+Enter
-                onKeypressRef.current({
-                    ...key,
-                    shift: true,
-                    sequence: '\\\r', // VS Code's Shift+Enter representation
-                });
-                return;
-            }
-            // Handle backslash - hold it to see if Enter follows
-            if (key.sequence === '\\' && !key.name) {
-                // Don't pass through the backslash yet - wait to see if Enter follows
-                waitingForEnterAfterBackslash = true;
-                // Set up a timeout to pass through the backslash if no Enter follows
-                backslashTimeout = setTimeout(() => {
-                    waitingForEnterAfterBackslash = false;
-                    backslashTimeout = null;
-                    // Pass through the backslash since no Enter followed
-                    onKeypressRef.current(key);
-                }, BACKSLASH_ENTER_DETECTION_WINDOW_MS);
-                return;
-            }
-            // If we're waiting for Enter after backslash but got something else,
-            // pass through the backslash first, then the new key
-            if (waitingForEnterAfterBackslash && key.name !== 'return') {
-                if (backslashTimeout) {
-                    clearTimeout(backslashTimeout);
-                    backslashTimeout = null;
-                }
-                waitingForEnterAfterBackslash = false;
-                // Pass through the backslash that was held
-                onKeypressRef.current({
-                    name: '',
-                    sequence: '\\',
-                    ctrl: false,
-                    meta: false,
-                    shift: false,
-                    paste: false,
-                });
-                // Then continue processing the current key normally
-            }
-            // If readline has already identified an arrow key, pass it through
-            // immediately, bypassing the Kitty protocol sequence buffering.
-            if (['up', 'down', 'left', 'right'].includes(key.name)) {
-                onKeypressRef.current(key);
-                return;
-            }
-            // Always pass through Ctrl+C immediately, regardless of protocol state
-            // Check both standard format and Kitty protocol sequence
-            if ((key.ctrl && key.name === 'c') ||
-                key.sequence === `${ESC}${KITTY_CTRL_C}`) {
-                kittySequenceBuffer = '';
-                // If it's the Kitty sequence, create a proper key object
-                if (key.sequence === `${ESC}${KITTY_CTRL_C}`) {
-                    onKeypressRef.current({
-                        name: 'c',
-                        ctrl: true,
-                        meta: false,
-                        shift: false,
-                        paste: false,
-                        sequence: key.sequence,
-                        kittyProtocol: true,
-                    });
-                }
-                else {
-                    onKeypressRef.current(key);
-                }
-                return;
-            }
-            // If Kitty protocol is enabled, handle CSI sequences
-            if (kittyProtocolEnabled) {
-                // If we have a buffer or this starts a CSI sequence
-                if (kittySequenceBuffer ||
-                    (key.sequence.startsWith(`${ESC}[`) &&
-                        !key.sequence.startsWith(PASTE_MODE_PREFIX) &&
-                        !key.sequence.startsWith(PASTE_MODE_SUFFIX) &&
-                        !key.sequence.startsWith(FOCUS_IN) &&
-                        !key.sequence.startsWith(FOCUS_OUT))) {
-                    kittySequenceBuffer += key.sequence;
-                    // Try to parse the buffer as a Kitty sequence
-                    const kittyKey = parseKittySequence(kittySequenceBuffer);
-                    if (kittyKey) {
-                        kittySequenceBuffer = '';
-                        onKeypressRef.current(kittyKey);
-                        return;
-                    }
-                    if (config?.getDebugMode()) {
-                        const codes = Array.from(kittySequenceBuffer).map((ch) => ch.charCodeAt(0));
-                        // Unless the user is sshing over a slow connection, this likely
-                        // indicates this is not a kitty sequence but we have incorrectly
-                        // interpreted it as such. See the examples above for sequences
-                        // such as FOCUS_IN that are not Kitty sequences.
-                        console.warn('Kitty sequence buffer has char codes:', codes);
-                    }
-                    // If buffer doesn't match expected pattern and is getting long, flush it
-                    if (kittySequenceBuffer.length > MAX_KITTY_SEQUENCE_LENGTH) {
-                        // Log telemetry for buffer overflow
-                        if (config) {
-                            const event = new KittySequenceOverflowEvent(kittySequenceBuffer.length, kittySequenceBuffer);
-                            logKittySequenceOverflow(config, event);
-                        }
-                        // Not a Kitty sequence, treat as regular key
-                        kittySequenceBuffer = '';
-                    }
-                    else {
-                        // Wait for more characters
-                        return;
-                    }
-                }
-            }
-            if (key.name === 'paste-start') {
-                isPaste = true;
-            }
-            else if (key.name === 'paste-end') {
-                isPaste = false;
-                onKeypressRef.current({
-                    name: '',
-                    ctrl: false,
-                    meta: false,
-                    shift: false,
-                    paste: true,
-                    sequence: pasteBuffer.toString(),
-                });
-                pasteBuffer = Buffer.alloc(0);
-            }
-            else {
-                if (isPaste) {
-                    pasteBuffer = Buffer.concat([pasteBuffer, Buffer.from(key.sequence)]);
-                }
-                else {
-                    // Handle special keys
-                    if (key.name === 'return' && key.sequence === `${ESC}\r`) {
-                        key.meta = true;
-                    }
-                    onKeypressRef.current({ ...key, paste: isPaste });
-                }
-            }
-        };
-        const handleRawKeypress = (data) => {
-            const pasteModePrefixBuffer = Buffer.from(PASTE_MODE_PREFIX);
-            const pasteModeSuffixBuffer = Buffer.from(PASTE_MODE_SUFFIX);
-            let pos = 0;
-            while (pos < data.length) {
-                const prefixPos = data.indexOf(pasteModePrefixBuffer, pos);
-                const suffixPos = data.indexOf(pasteModeSuffixBuffer, pos);
-                // Determine which marker comes first, if any.
-                const isPrefixNext = prefixPos !== -1 && (suffixPos === -1 || prefixPos < suffixPos);
-                const isSuffixNext = suffixPos !== -1 && (prefixPos === -1 || suffixPos < prefixPos);
-                let nextMarkerPos = -1;
-                let markerLength = 0;
-                if (isPrefixNext) {
-                    nextMarkerPos = prefixPos;
-                }
-                else if (isSuffixNext) {
-                    nextMarkerPos = suffixPos;
-                }
-                markerLength = pasteModeSuffixBuffer.length;
-                if (nextMarkerPos === -1) {
-                    keypressStream.write(data.slice(pos));
-                    return;
-                }
-                const nextData = data.slice(pos, nextMarkerPos);
-                if (nextData.length > 0) {
-                    keypressStream.write(nextData);
-                }
-                const createPasteKeyEvent = (name) => ({
-                    name,
-                    ctrl: false,
-                    meta: false,
-                    shift: false,
-                    paste: false,
-                    sequence: '',
-                });
-                if (isPrefixNext) {
-                    handleKeypress(undefined, createPasteKeyEvent('paste-start'));
-                }
-                else if (isSuffixNext) {
-                    handleKeypress(undefined, createPasteKeyEvent('paste-end'));
-                }
-                pos = nextMarkerPos + markerLength;
-            }
-        };
-        let rl;
-        if (usePassthrough) {
-            rl = readline.createInterface({
-                input: keypressStream,
-                escapeCodeTimeout: 0,
-            });
-            readline.emitKeypressEvents(keypressStream, rl);
-            keypressStream.on('keypress', handleKeypress);
-            stdin.on('data', handleRawKeypress);
-        }
-        else {
-            rl = readline.createInterface({ input: stdin, escapeCodeTimeout: 0 });
-            readline.emitKeypressEvents(stdin, rl);
-            stdin.on('keypress', handleKeypress);
-        }
+        subscribe(onKeypress);
         return () => {
-            if (usePassthrough) {
-                keypressStream.removeListener('keypress', handleKeypress);
-                stdin.removeListener('data', handleRawKeypress);
-            }
-            else {
-                stdin.removeListener('keypress', handleKeypress);
-            }
-            rl.close();
-            setRawMode(false);
-            // Clean up any pending backslash timeout
-            if (backslashTimeout) {
-                clearTimeout(backslashTimeout);
-                backslashTimeout = null;
-            }
-            // If we are in the middle of a paste, send what we have.
-            if (isPaste) {
-                onKeypressRef.current({
-                    name: '',
-                    ctrl: false,
-                    meta: false,
-                    shift: false,
-                    paste: true,
-                    sequence: pasteBuffer.toString(),
-                });
-                pasteBuffer = Buffer.alloc(0);
-            }
+            unsubscribe(onKeypress);
         };
-    }, [isActive, stdin, setRawMode, kittyProtocolEnabled, config]);
+    }, [isActive, onKeypress, subscribe, unsubscribe]);
 }
 //# sourceMappingURL=useKeypress.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useKeypress.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useKeypress.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useKeypress.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useKeypress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EACL,kBAAkB,GAGnB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,UAA2B,EAC3B,EAAE,QAAQ,EAAyB;IAEnC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AACrD,CAAC"}

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { useLoadingIndicator } from './useLoadingIndicator.js';
+import { StreamingState } from '../types.js';
+import { WITTY_LOADING_PHRASES, PHRASE_CHANGE_INTERVAL_MS, } from './usePhraseCycler.js';
+describe('useLoadingIndicator', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers(); // Restore real timers after each test
+        act(() => vi.runOnlyPendingTimers);
+    });
+    it('should initialize with default values when Idle', () => {
+        const { result } = renderHook(() => useLoadingIndicator(StreamingState.Idle));
+        expect(result.current.elapsedTime).toBe(0);
+        expect(result.current.currentLoadingPhrase).toBe(WITTY_LOADING_PHRASES[0]);
+    });
+    it('should reflect values when Responding', async () => {
+        const { result } = renderHook(() => useLoadingIndicator(StreamingState.Responding));
+        // Initial state before timers advance
+        expect(result.current.elapsedTime).toBe(0);
+        expect(WITTY_LOADING_PHRASES).toContain(result.current.currentLoadingPhrase);
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(PHRASE_CHANGE_INTERVAL_MS + 1);
+        });
+        // Phrase should cycle if PHRASE_CHANGE_INTERVAL_MS has passed
+        expect(WITTY_LOADING_PHRASES).toContain(result.current.currentLoadingPhrase);
+    });
+    it('should show waiting phrase and retain elapsedTime when WaitingForConfirmation', async () => {
+        const { result, rerender } = renderHook(({ streamingState }) => useLoadingIndicator(streamingState), { initialProps: { streamingState: StreamingState.Responding } });
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(60000);
+        });
+        expect(result.current.elapsedTime).toBe(60);
+        act(() => {
+            rerender({ streamingState: StreamingState.WaitingForConfirmation });
+        });
+        expect(result.current.currentLoadingPhrase).toBe('Waiting for user confirmation...');
+        expect(result.current.elapsedTime).toBe(60); // Elapsed time should be retained
+        // Timer should not advance further
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(2000);
+        });
+        expect(result.current.elapsedTime).toBe(60);
+    });
+    it('should reset elapsedTime and use a witty phrase when transitioning from WaitingForConfirmation to Responding', async () => {
+        const { result, rerender } = renderHook(({ streamingState }) => useLoadingIndicator(streamingState), { initialProps: { streamingState: StreamingState.Responding } });
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(5000); // 5s
+        });
+        expect(result.current.elapsedTime).toBe(5);
+        act(() => {
+            rerender({ streamingState: StreamingState.WaitingForConfirmation });
+        });
+        expect(result.current.elapsedTime).toBe(5);
+        expect(result.current.currentLoadingPhrase).toBe('Waiting for user confirmation...');
+        act(() => {
+            rerender({ streamingState: StreamingState.Responding });
+        });
+        expect(result.current.elapsedTime).toBe(0); // Should reset
+        expect(WITTY_LOADING_PHRASES).toContain(result.current.currentLoadingPhrase);
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(1000);
+        });
+        expect(result.current.elapsedTime).toBe(1);
+    });
+    it('should reset timer and phrase when streamingState changes from Responding to Idle', async () => {
+        const { result, rerender } = renderHook(({ streamingState }) => useLoadingIndicator(streamingState), { initialProps: { streamingState: StreamingState.Responding } });
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(10000); // 10s
+        });
+        expect(result.current.elapsedTime).toBe(10);
+        act(() => {
+            rerender({ streamingState: StreamingState.Idle });
+        });
+        expect(result.current.elapsedTime).toBe(0);
+        expect(result.current.currentLoadingPhrase).toBe(WITTY_LOADING_PHRASES[0]);
+        // Timer should not advance
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(2000);
+        });
+        expect(result.current.elapsedTime).toBe(0);
+    });
+});
+//# sourceMappingURL=useLoadingIndicator.test.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StreamingState } from '../types.js';
+export interface UseMessageQueueOptions {
+    streamingState: StreamingState;
+    submitQuery: (query: string) => void;
+}
+export interface UseMessageQueueReturn {
+    messageQueue: string[];
+    addMessage: (message: string) => void;
+    clearQueue: () => void;
+    getQueuedMessagesText: () => string;
+}
+/**
+ * Hook for managing message queuing during streaming responses.
+ * Allows users to queue messages while the AI is responding and automatically
+ * sends them when streaming completes.
+ */
+export declare function useMessageQueue({ streamingState, submitQuery, }: UseMessageQueueOptions): UseMessageQueueReturn;

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

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { StreamingState } from '../types.js';
+/**
+ * Hook for managing message queuing during streaming responses.
+ * Allows users to queue messages while the AI is responding and automatically
+ * sends them when streaming completes.
+ */
+export function useMessageQueue({ streamingState, submitQuery, }) {
+    const [messageQueue, setMessageQueue] = useState([]);
+    // Add a message to the queue
+    const addMessage = useCallback((message) => {
+        const trimmedMessage = message.trim();
+        if (trimmedMessage.length > 0) {
+            setMessageQueue((prev) => [...prev, trimmedMessage]);
+        }
+    }, []);
+    // Clear the entire queue
+    const clearQueue = useCallback(() => {
+        setMessageQueue([]);
+    }, []);
+    // Get all queued messages as a single text string
+    const getQueuedMessagesText = useCallback(() => {
+        if (messageQueue.length === 0)
+            return '';
+        return messageQueue.join('\n\n');
+    }, [messageQueue]);
+    // Process queued messages when streaming becomes idle
+    useEffect(() => {
+        if (streamingState === StreamingState.Idle && messageQueue.length > 0) {
+            // Combine all messages with double newlines for clarity
+            const combinedMessage = messageQueue.join('\n\n');
+            // Clear the queue and submit
+            setMessageQueue([]);
+            submitQuery(combinedMessage);
+        }
+    }, [streamingState, messageQueue, submitQuery]);
+    return {
+        messageQueue,
+        addMessage,
+        clearQueue,
+        getQueuedMessagesText,
+    };
+}
+//# sourceMappingURL=useMessageQueue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageQueue.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useMessageQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAc7C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,cAAc,EACd,WAAW,GACY;IACvB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IAE/D,6BAA6B;IAC7B,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,OAAe,EAAE,EAAE;QACjD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,eAAe,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,yBAAyB;IACzB,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,eAAe,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,kDAAkD;IAClD,MAAM,qBAAqB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,sDAAsD;IACtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,cAAc,KAAK,cAAc,CAAC,IAAI,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,wDAAwD;YACxD,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClD,6BAA6B;YAC7B,eAAe,CAAC,EAAE,CAAC,CAAC;YACpB,WAAW,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhD,OAAO;QACL,YAAY;QACZ,UAAU;QACV,UAAU;QACV,qBAAqB;KACtB,CAAC;AACJ,CAAC"}

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

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