@blackbox_ai/blackbox-cli 0.0.4

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

@@ -0,0 +1,272 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** @vitest-environment jsdom */
+import { describe, it, expect, vi } from 'vitest';
+import { renderHook, waitFor } from '@testing-library/react';
+import { useSlashCompletion } from './useSlashCompletion.js';
+import { useState } from 'react';
+// Test harness to capture the state from the hook's callbacks.
+function useTestHarnessForSlashCompletion(enabled, query, slashCommands, commandContext) {
+    const [suggestions, setSuggestions] = useState([]);
+    const [isLoadingSuggestions, setIsLoadingSuggestions] = useState(false);
+    const [isPerfectMatch, setIsPerfectMatch] = useState(false);
+    const { completionStart, completionEnd } = useSlashCompletion({
+        enabled,
+        query,
+        slashCommands,
+        commandContext,
+        setSuggestions,
+        setIsLoadingSuggestions,
+        setIsPerfectMatch,
+    });
+    return {
+        suggestions,
+        isLoadingSuggestions,
+        isPerfectMatch,
+        completionStart,
+        completionEnd,
+    };
+}
+describe('useSlashCompletion', () => {
+    // A minimal mock is sufficient for these tests.
+    const mockCommandContext = {};
+    describe('Top-Level Commands', () => {
+        it('should suggest all top-level commands for the root slash', async () => {
+            const slashCommands = [
+                { name: 'help', altNames: ['?'], description: 'Show help' },
+                {
+                    name: 'stats',
+                    altNames: ['usage'],
+                    description: 'check session stats. Usage: /stats [model|tools]',
+                },
+                { name: 'clear', description: 'Clear the screen' },
+                {
+                    name: 'memory',
+                    description: 'Manage memory',
+                    subCommands: [{ name: 'show', description: 'Show memory' }],
+                },
+                { name: 'chat', description: 'Manage chat history' },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/', slashCommands, mockCommandContext));
+            expect(result.current.suggestions.length).toBe(slashCommands.length);
+            expect(result.current.suggestions.map((s) => s.label)).toEqual(expect.arrayContaining(['help', 'clear', 'memory', 'chat', 'stats']));
+        });
+        it('should filter commands based on partial input', async () => {
+            const slashCommands = [
+                { name: 'memory', description: 'Manage memory' },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/mem', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toEqual([
+                { label: 'memory', value: 'memory', description: 'Manage memory' },
+            ]);
+        });
+        it('should suggest commands based on partial altNames', async () => {
+            const slashCommands = [
+                {
+                    name: 'stats',
+                    altNames: ['usage'],
+                    description: 'check session stats. Usage: /stats [model|tools]',
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/usag', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toEqual([
+                {
+                    label: 'stats',
+                    value: 'stats',
+                    description: 'check session stats. Usage: /stats [model|tools]',
+                },
+            ]);
+        });
+        it('should NOT provide suggestions for a perfectly typed command that is a leaf node', async () => {
+            const slashCommands = [
+                { name: 'clear', description: 'Clear the screen', action: vi.fn() },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/clear', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(0);
+        });
+        it.each([['/?'], ['/usage']])('should not suggest commands when altNames is fully typed', async (query) => {
+            const mockSlashCommands = [
+                {
+                    name: 'help',
+                    altNames: ['?'],
+                    description: 'Show help',
+                    action: vi.fn(),
+                },
+                {
+                    name: 'stats',
+                    altNames: ['usage'],
+                    description: 'check session stats. Usage: /stats [model|tools]',
+                    action: vi.fn(),
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, query, mockSlashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(0);
+        });
+        it('should not provide suggestions for a fully typed command that has no sub-commands or argument completion', async () => {
+            const slashCommands = [
+                { name: 'clear', description: 'Clear the screen' },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/clear ', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(0);
+        });
+        it('should not provide suggestions for an unknown command', async () => {
+            const slashCommands = [
+                { name: 'help', description: 'Show help' },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/unknown-command', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(0);
+        });
+    });
+    describe('Sub-Commands', () => {
+        it('should suggest sub-commands for a parent command', async () => {
+            const slashCommands = [
+                {
+                    name: 'memory',
+                    description: 'Manage memory',
+                    subCommands: [
+                        { name: 'show', description: 'Show memory' },
+                        { name: 'add', description: 'Add to memory' },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/memory', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(2);
+            expect(result.current.suggestions).toEqual(expect.arrayContaining([
+                { label: 'show', value: 'show', description: 'Show memory' },
+                { label: 'add', value: 'add', description: 'Add to memory' },
+            ]));
+        });
+        it('should suggest all sub-commands when the query ends with the parent command and a space', async () => {
+            const slashCommands = [
+                {
+                    name: 'memory',
+                    description: 'Manage memory',
+                    subCommands: [
+                        { name: 'show', description: 'Show memory' },
+                        { name: 'add', description: 'Add to memory' },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/memory ', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(2);
+            expect(result.current.suggestions).toEqual(expect.arrayContaining([
+                { label: 'show', value: 'show', description: 'Show memory' },
+                { label: 'add', value: 'add', description: 'Add to memory' },
+            ]));
+        });
+        it('should filter sub-commands by prefix', async () => {
+            const slashCommands = [
+                {
+                    name: 'memory',
+                    description: 'Manage memory',
+                    subCommands: [
+                        { name: 'show', description: 'Show memory' },
+                        { name: 'add', description: 'Add to memory' },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/memory a', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toEqual([
+                { label: 'add', value: 'add', description: 'Add to memory' },
+            ]);
+        });
+        it('should provide no suggestions for an invalid sub-command', async () => {
+            const slashCommands = [
+                {
+                    name: 'memory',
+                    description: 'Manage memory',
+                    subCommands: [
+                        { name: 'show', description: 'Show memory' },
+                        { name: 'add', description: 'Add to memory' },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/memory dothisnow', slashCommands, mockCommandContext));
+            expect(result.current.suggestions).toHaveLength(0);
+        });
+    });
+    describe('Argument Completion', () => {
+        it('should call the command.completion function for argument suggestions', async () => {
+            const availableTags = [
+                'my-chat-tag-1',
+                'my-chat-tag-2',
+                'another-channel',
+            ];
+            const mockCompletionFn = vi
+                .fn()
+                .mockImplementation(async (_context, partialArg) => availableTags.filter((tag) => tag.startsWith(partialArg)));
+            const slashCommands = [
+                {
+                    name: 'chat',
+                    description: 'Manage chat history',
+                    subCommands: [
+                        {
+                            name: 'resume',
+                            description: 'Resume a saved chat',
+                            completion: mockCompletionFn,
+                        },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/chat resume my-ch', slashCommands, mockCommandContext));
+            await waitFor(() => {
+                expect(mockCompletionFn).toHaveBeenCalledWith(mockCommandContext, 'my-ch');
+            });
+            await waitFor(() => {
+                expect(result.current.suggestions).toEqual([
+                    { label: 'my-chat-tag-1', value: 'my-chat-tag-1' },
+                    { label: 'my-chat-tag-2', value: 'my-chat-tag-2' },
+                ]);
+            });
+        });
+        it('should call command.completion with an empty string when args start with a space', async () => {
+            const mockCompletionFn = vi
+                .fn()
+                .mockResolvedValue(['my-chat-tag-1', 'my-chat-tag-2', 'my-channel']);
+            const slashCommands = [
+                {
+                    name: 'chat',
+                    description: 'Manage chat history',
+                    subCommands: [
+                        {
+                            name: 'resume',
+                            description: 'Resume a saved chat',
+                            completion: mockCompletionFn,
+                        },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/chat resume ', slashCommands, mockCommandContext));
+            await waitFor(() => {
+                expect(mockCompletionFn).toHaveBeenCalledWith(mockCommandContext, '');
+            });
+            await waitFor(() => {
+                expect(result.current.suggestions).toHaveLength(3);
+            });
+        });
+        it('should handle completion function that returns null', async () => {
+            const completionFn = vi.fn().mockResolvedValue(null);
+            const slashCommands = [
+                {
+                    name: 'chat',
+                    description: 'Manage chat history',
+                    subCommands: [
+                        {
+                            name: 'resume',
+                            description: 'Resume a saved chat',
+                            completion: completionFn,
+                        },
+                    ],
+                },
+            ];
+            const { result } = renderHook(() => useTestHarnessForSlashCompletion(true, '/chat resume ', slashCommands, mockCommandContext));
+            await waitFor(() => {
+                expect(result.current.suggestions).toHaveLength(0);
+            });
+        });
+    });
+});
+//# sourceMappingURL=useSlashCompletion.test.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+export declare const useStateAndRef: <T extends object | null | undefined | number | string>(initialValue: T) => readonly [React.RefObject<T>, React.Dispatch<React.SetStateAction<T>>];

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+// Hook to return state, state setter, and ref to most up-to-date value of state.
+// We need this in order to setState and reference the updated state multiple
+// times in the same function.
+export const useStateAndRef = (initialValue) => {
+    const [_, setState] = React.useState(initialValue);
+    const ref = React.useRef(initialValue);
+    const setStateInternal = React.useCallback((newStateOrCallback) => {
+        let newValue;
+        if (typeof newStateOrCallback === 'function') {
+            newValue = newStateOrCallback(ref.current);
+        }
+        else {
+            newValue = newStateOrCallback;
+        }
+        setState(newValue);
+        ref.current = newValue;
+    }, []);
+    return [ref, setStateInternal];
+};
+//# sourceMappingURL=useStateAndRef.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStateAndRef.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useStateAndRef.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,iFAAiF;AACjF,6EAA6E;AAC7E,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,CAI5B,YAAe,EACf,EAAE;IACF,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAI,YAAY,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAI,YAAY,CAAC,CAAC;IAE1C,MAAM,gBAAgB,GAAG,KAAK,CAAC,WAAW,CACxC,CAAC,kBAAkB,EAAE,EAAE;QACrB,IAAI,QAAW,CAAC;QAChB,IAAI,OAAO,kBAAkB,KAAK,UAAU,EAAE,CAAC;YAC7C,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,kBAAkB,CAAC;QAChC,CAAC;QACD,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnB,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC;IACzB,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAU,CAAC;AAC1C,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function useSubagentCreateDialog(): {
+    isSubagentCreateDialogOpen: boolean;
+    openSubagentCreateDialog: () => void;
+    closeSubagentCreateDialog: () => void;
+};

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useCallback } from 'react';
+export function useSubagentCreateDialog() {
+    const [isSubagentCreateDialogOpen, setIsSubagentCreateDialogOpen] = useState(false);
+    const openSubagentCreateDialog = useCallback(() => {
+        setIsSubagentCreateDialogOpen(true);
+    }, []);
+    const closeSubagentCreateDialog = useCallback(() => {
+        setIsSubagentCreateDialogOpen(false);
+    }, []);
+    return {
+        isSubagentCreateDialogOpen,
+        openSubagentCreateDialog,
+        closeSubagentCreateDialog,
+    };
+}
+//# sourceMappingURL=useSubagentCreateDialog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSubagentCreateDialog.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useSubagentCreateDialog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAE9C,MAAM,UAAU,uBAAuB;IACrC,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,GAC/D,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElB,MAAM,wBAAwB,GAAG,WAAW,CAAC,GAAG,EAAE;QAChD,6BAA6B,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,yBAAyB,GAAG,WAAW,CAAC,GAAG,EAAE;QACjD,6BAA6B,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,0BAA0B;QAC1B,wBAAwB;QACxB,yBAAyB;KAC1B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function useTerminalSize(): {
+    columns: number;
+    rows: number;
+};

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect, useState } from 'react';
+const TERMINAL_PADDING_X = 8;
+export function useTerminalSize() {
+    const [size, setSize] = useState({
+        columns: (process.stdout.columns || 60) - TERMINAL_PADDING_X,
+        rows: process.stdout.rows || 20,
+    });
+    useEffect(() => {
+        function updateSize() {
+            setSize({
+                columns: (process.stdout.columns || 60) - TERMINAL_PADDING_X,
+                rows: process.stdout.rows || 20,
+            });
+        }
+        process.stdout.on('resize', updateSize);
+        return () => {
+            process.stdout.off('resize', updateSize);
+        };
+    }, []);
+    return size;
+}
+//# sourceMappingURL=useTerminalSize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminalSize.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTerminalSize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;QAC/B,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,kBAAkB;QAC5D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;KAChC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,UAAU;YACjB,OAAO,CAAC;gBACN,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,kBAAkB;gBAC5D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;aAChC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { LoadedSettings, SettingScope } from '../../config/settings.js';
+import { type HistoryItem } from '../types.js';
+interface UseThemeCommandReturn {
+    isThemeDialogOpen: boolean;
+    openThemeDialog: () => void;
+    handleThemeSelect: (themeName: string | undefined, scope: SettingScope) => void;
+    handleThemeHighlight: (themeName: string | undefined) => void;
+}
+export declare const useThemeCommand: (loadedSettings: LoadedSettings, setThemeError: (error: string | null) => void, addItem: (item: Omit<HistoryItem, "id">, timestamp: number) => void) => UseThemeCommandReturn;
+export {};

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

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { themeManager } from '../themes/theme-manager.js';
+import { MessageType } from '../types.js';
+import process from 'node:process';
+export const useThemeCommand = (loadedSettings, setThemeError, addItem) => {
+    const [isThemeDialogOpen, setIsThemeDialogOpen] = useState(false);
+    // Check for invalid theme configuration on startup
+    useEffect(() => {
+        const effectiveTheme = loadedSettings.merged.ui?.theme;
+        if (effectiveTheme && !themeManager.findThemeByName(effectiveTheme)) {
+            setIsThemeDialogOpen(true);
+            setThemeError(`Theme "${effectiveTheme}" not found.`);
+        }
+        else {
+            setThemeError(null);
+        }
+    }, [loadedSettings.merged.ui?.theme, setThemeError]);
+    const openThemeDialog = useCallback(() => {
+        if (process.env['NO_COLOR']) {
+            addItem({
+                type: MessageType.INFO,
+                text: 'Theme configuration unavailable due to NO_COLOR env variable.',
+            }, Date.now());
+            return;
+        }
+        setIsThemeDialogOpen(true);
+    }, [addItem]);
+    const applyTheme = useCallback((themeName) => {
+        if (!themeManager.setActiveTheme(themeName)) {
+            // If theme is not found, open the theme selection dialog and set error message
+            setIsThemeDialogOpen(true);
+            setThemeError(`Theme "${themeName}" not found.`);
+        }
+        else {
+            setThemeError(null); // Clear any previous theme error on success
+        }
+    }, [setThemeError]);
+    const handleThemeHighlight = useCallback((themeName) => {
+        applyTheme(themeName);
+    }, [applyTheme]);
+    const handleThemeSelect = useCallback((themeName, scope) => {
+        try {
+            // Merge user and workspace custom themes (workspace takes precedence)
+            const mergedCustomThemes = {
+                ...(loadedSettings.user.settings.ui?.customThemes || {}),
+                ...(loadedSettings.workspace.settings.ui?.customThemes || {}),
+            };
+            // Only allow selecting themes available in the merged custom themes or built-in themes
+            const isBuiltIn = themeManager.findThemeByName(themeName);
+            const isCustom = themeName && mergedCustomThemes[themeName];
+            if (!isBuiltIn && !isCustom) {
+                setThemeError(`Theme "${themeName}" not found in selected scope.`);
+                setIsThemeDialogOpen(true);
+                return;
+            }
+            loadedSettings.setValue(scope, 'ui.theme', themeName); // Update the merged settings
+            if (loadedSettings.merged.ui?.customThemes) {
+                themeManager.loadCustomThemes(loadedSettings.merged.ui?.customThemes);
+            }
+            applyTheme(loadedSettings.merged.ui?.theme); // Apply the current theme
+            setThemeError(null);
+        }
+        finally {
+            setIsThemeDialogOpen(false); // Close the dialog
+        }
+    }, [applyTheme, loadedSettings, setThemeError]);
+    return {
+        isThemeDialogOpen,
+        openThemeDialog,
+        handleThemeSelect,
+        handleThemeHighlight,
+    };
+};
+//# sourceMappingURL=useThemeCommand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeCommand.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useThemeCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAoB,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,OAAO,MAAM,cAAc,CAAC;AAYnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,cAA8B,EAC9B,aAA6C,EAC7C,OAAmE,EAC5C,EAAE;IACzB,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElE,mDAAmD;IACnD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC;QACvD,IAAI,cAAc,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;YACpE,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC3B,aAAa,CAAC,UAAU,cAAc,cAAc,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;IAErD,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,CACL;gBACE,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,+DAA+D;aACtE,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACF,OAAO;QACT,CAAC;QACD,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,SAA6B,EAAE,EAAE;QAChC,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,+EAA+E;YAC/E,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC3B,aAAa,CAAC,UAAU,SAAS,cAAc,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,4CAA4C;QACnE,CAAC;IACH,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,MAAM,oBAAoB,GAAG,WAAW,CACtC,CAAC,SAA6B,EAAE,EAAE;QAChC,UAAU,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,SAA6B,EAAE,KAAmB,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,kBAAkB,GAAG;gBACzB,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,YAAY,IAAI,EAAE,CAAC;gBACxD,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,YAAY,IAAI,EAAE,CAAC;aAC9D,CAAC;YACF,uFAAuF;YACvF,MAAM,SAAS,GAAG,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,SAAS,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAC5D,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,aAAa,CAAC,UAAU,SAAS,gCAAgC,CAAC,CAAC;gBACnE,oBAAoB,CAAC,IAAI,CAAC,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,6BAA6B;YACpF,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC;gBAC3C,YAAY,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YACxE,CAAC;YACD,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,0BAA0B;YACvE,aAAa,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB;QAClD,CAAC;IACH,CAAC,EACD,CAAC,UAAU,EAAE,cAAc,EAAE,aAAa,CAAC,CAC5C,CAAC;IAEF,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,oBAAoB;KACrB,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Custom hook to manage a timer that increments every second.
+ * @param isActive Whether the timer should be running.
+ * @param resetKey A key that, when changed, will reset the timer to 0 and restart the interval.
+ * @returns The elapsed time in seconds.
+ */
+export declare const useTimer: (isActive: boolean, resetKey: unknown) => number;

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

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useEffect, useRef } from 'react';
+/**
+ * Custom hook to manage a timer that increments every second.
+ * @param isActive Whether the timer should be running.
+ * @param resetKey A key that, when changed, will reset the timer to 0 and restart the interval.
+ * @returns The elapsed time in seconds.
+ */
+export const useTimer = (isActive, resetKey) => {
+    const [elapsedTime, setElapsedTime] = useState(0);
+    const timerRef = useRef(null);
+    const prevResetKeyRef = useRef(resetKey);
+    const prevIsActiveRef = useRef(isActive);
+    useEffect(() => {
+        let shouldResetTime = false;
+        if (prevResetKeyRef.current !== resetKey) {
+            shouldResetTime = true;
+            prevResetKeyRef.current = resetKey;
+        }
+        if (prevIsActiveRef.current === false && isActive) {
+            // Transitioned from inactive to active
+            shouldResetTime = true;
+        }
+        if (shouldResetTime) {
+            setElapsedTime(0);
+        }
+        prevIsActiveRef.current = isActive;
+        // Manage interval
+        if (isActive) {
+            // Clear previous interval unconditionally before starting a new one
+            // This handles resetKey changes while active, ensuring a fresh interval start.
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+            }
+            timerRef.current = setInterval(() => {
+                setElapsedTime((prev) => prev + 1);
+            }, 1000);
+        }
+        else {
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        }
+        return () => {
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+    }, [isActive, resetKey]);
+    return elapsedTime;
+};
+//# sourceMappingURL=useTimer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTimer.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTimer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAiB,EAAE,QAAiB,EAAE,EAAE;IAC/D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,eAAe,GAAG,KAAK,CAAC;QAE5B,IAAI,eAAe,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzC,eAAe,GAAG,IAAI,CAAC;YACvB,eAAe,CAAC,OAAO,GAAG,QAAQ,CAAC;QACrC,CAAC;QAED,IAAI,eAAe,CAAC,OAAO,KAAK,KAAK,IAAI,QAAQ,EAAE,CAAC;YAClD,uCAAuC;YACvC,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,cAAc,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,eAAe,CAAC,OAAO,GAAG,QAAQ,CAAC;QAEnC,kBAAkB;QAClB,IAAI,QAAQ,EAAE,CAAC;YACb,oEAAoE;YACpE,+EAA+E;YAC/E,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;YACD,QAAQ,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;gBAClC,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEzB,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

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

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