@google/gemini-cli 0.7.0-nightly.20250918.2722473a → 0.7.0-preview.0

package/dist/src/ui/components/shared/BaseSelectionList.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+export interface RenderItemContext {
+    isSelected: boolean;
+    titleColor: string;
+    numberColor: string;
+}
+export interface BaseSelectionListProps<T, TItem = Record<string, unknown>> {
+    items: Array<TItem & {
+        value: T;
+        disabled?: boolean;
+    }>;
+    initialIndex?: number;
+    onSelect: (value: T) => void;
+    onHighlight?: (value: T) => void;
+    isFocused?: boolean;
+    showNumbers?: boolean;
+    showScrollArrows?: boolean;
+    maxItemsToShow?: number;
+    renderItem: (item: TItem & {
+        value: T;
+        disabled?: boolean;
+    }, context: RenderItemContext) => React.ReactNode;
+}
+/**
+ * Base component for selection lists that provides common UI structure
+ * and keyboard navigation logic via the useSelectionList hook.
+ *
+ * This component handles:
+ * - Radio button indicators
+ * - Item numbering
+ * - Scrolling for long lists
+ * - Color theming based on selection/disabled state
+ * - Keyboard navigation and numeric selection
+ *
+ * Specific components should use this as a base and provide
+ * their own renderItem implementation for custom content.
+ */
+export declare function BaseSelectionList<T, TItem = Record<string, unknown>>({ items, initialIndex, onSelect, onHighlight, isFocused, showNumbers, showScrollArrows, maxItemsToShow, renderItem, }: BaseSelectionListProps<T, TItem>): React.JSX.Element;

package/dist/src/ui/components/shared/BaseSelectionList.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Text, Box } from 'ink';
+import { theme } from '../../semantic-colors.js';
+import { useSelectionList } from '../../hooks/useSelectionList.js';
+/**
+ * Base component for selection lists that provides common UI structure
+ * and keyboard navigation logic via the useSelectionList hook.
+ *
+ * This component handles:
+ * - Radio button indicators
+ * - Item numbering
+ * - Scrolling for long lists
+ * - Color theming based on selection/disabled state
+ * - Keyboard navigation and numeric selection
+ *
+ * Specific components should use this as a base and provide
+ * their own renderItem implementation for custom content.
+ */
+export function BaseSelectionList({ items, initialIndex = 0, onSelect, onHighlight, isFocused = true, showNumbers = true, showScrollArrows = false, maxItemsToShow = 10, renderItem, }) {
+    const { activeIndex } = useSelectionList({
+        items,
+        initialIndex,
+        onSelect,
+        onHighlight,
+        isFocused,
+        showNumbers,
+    });
+    const [scrollOffset, setScrollOffset] = useState(0);
+    // Handle scrolling for long lists
+    useEffect(() => {
+        const newScrollOffset = Math.max(0, Math.min(activeIndex - maxItemsToShow + 1, items.length - maxItemsToShow));
+        if (activeIndex < scrollOffset) {
+            setScrollOffset(activeIndex);
+        }
+        else if (activeIndex >= scrollOffset + maxItemsToShow) {
+            setScrollOffset(newScrollOffset);
+        }
+    }, [activeIndex, items.length, scrollOffset, maxItemsToShow]);
+    const visibleItems = items.slice(scrollOffset, scrollOffset + maxItemsToShow);
+    const numberColumnWidth = String(items.length).length;
+    return (_jsxs(Box, { flexDirection: "column", children: [showScrollArrows && (_jsx(Text, { color: scrollOffset > 0 ? theme.text.primary : theme.text.secondary, children: "\u25B2" })), visibleItems.map((item, index) => {
+                const itemIndex = scrollOffset + index;
+                const isSelected = activeIndex === itemIndex;
+                // Determine colors based on selection and disabled state
+                let titleColor = theme.text.primary;
+                let numberColor = theme.text.primary;
+                if (isSelected) {
+                    titleColor = theme.status.success;
+                    numberColor = theme.status.success;
+                }
+                else if (item.disabled) {
+                    titleColor = theme.text.secondary;
+                    numberColor = theme.text.secondary;
+                }
+                if (!isFocused && !item.disabled) {
+                    numberColor = theme.text.secondary;
+                }
+                if (!showNumbers) {
+                    numberColor = theme.text.secondary;
+                }
+                const itemNumberText = `${String(itemIndex + 1).padStart(numberColumnWidth)}.`;
+                return (_jsxs(Box, { alignItems: "flex-start", children: [_jsx(Box, { minWidth: 2, flexShrink: 0, children: _jsx(Text, { color: isSelected ? theme.status.success : theme.text.primary, "aria-hidden": true, children: isSelected ? '●' : ' ' }) }), showNumbers && (_jsx(Box, { marginRight: 1, flexShrink: 0, minWidth: itemNumberText.length, "aria-state": { checked: isSelected }, children: _jsx(Text, { color: numberColor, children: itemNumberText }) })), _jsx(Box, { flexGrow: 1, children: renderItem(item, {
+                                isSelected,
+                                titleColor,
+                                numberColor,
+                            }) })] }, itemIndex));
+            }), showScrollArrows && (_jsx(Text, { color: scrollOffset + maxItemsToShow < items.length
+                    ? theme.text.primary
+                    : theme.text.secondary, children: "\u25BC" }))] }));
+}
+//# sourceMappingURL=BaseSelectionList.js.map

package/dist/src/ui/components/shared/BaseSelectionList.js.map

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

package/dist/src/ui/components/shared/BaseSelectionList.test.d.ts

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

package/dist/src/ui/components/shared/BaseSelectionList.test.js

@@ -0,0 +1,374 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { waitFor } from '@testing-library/react';
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { BaseSelectionList, } from './BaseSelectionList.js';
+import { useSelectionList } from '../../hooks/useSelectionList.js';
+import { Text } from 'ink';
+vi.mock('../../hooks/useSelectionList.js');
+const mockTheme = {
+    text: { primary: 'COLOR_PRIMARY', secondary: 'COLOR_SECONDARY' },
+    status: { success: 'COLOR_SUCCESS' },
+};
+vi.mock('../../semantic-colors.js', () => ({
+    theme: {
+        text: { primary: 'COLOR_PRIMARY', secondary: 'COLOR_SECONDARY' },
+        status: { success: 'COLOR_SUCCESS' },
+    },
+}));
+describe('BaseSelectionList', () => {
+    const mockOnSelect = vi.fn();
+    const mockOnHighlight = vi.fn();
+    const mockRenderItem = vi.fn();
+    // Define standard test items
+    const items = [
+        { value: 'A', label: 'Item A' },
+        { value: 'B', label: 'Item B', disabled: true },
+        { value: 'C', label: 'Item C' },
+    ];
+    // Helper to render the component with default props
+    const renderComponent = (props = {}, activeIndex = 0) => {
+        vi.mocked(useSelectionList).mockReturnValue({
+            activeIndex,
+            setActiveIndex: vi.fn(),
+        });
+        mockRenderItem.mockImplementation((item, context) => (_jsx(Text, { color: context.titleColor, children: item.label })));
+        const defaultProps = {
+            items,
+            onSelect: mockOnSelect,
+            onHighlight: mockOnHighlight,
+            renderItem: mockRenderItem,
+            ...props,
+        };
+        return renderWithProviders(_jsx(BaseSelectionList, { ...defaultProps }));
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('Rendering and Structure', () => {
+        it('should render all items using the renderItem prop', () => {
+            const { lastFrame } = renderComponent();
+            expect(lastFrame()).toContain('Item A');
+            expect(lastFrame()).toContain('Item B');
+            expect(lastFrame()).toContain('Item C');
+            expect(mockRenderItem).toHaveBeenCalledTimes(3);
+            expect(mockRenderItem).toHaveBeenCalledWith(items[0], expect.any(Object));
+        });
+        it('should render the selection indicator (● or space) and layout', () => {
+            const { lastFrame } = renderComponent({}, 0);
+            const output = lastFrame();
+            // Use regex to assert the structure: Indicator + Whitespace + Number + Label
+            expect(output).toMatch(/●\s+1\.\s+Item A/);
+            expect(output).toMatch(/\s+2\.\s+Item B/);
+            expect(output).toMatch(/\s+3\.\s+Item C/);
+        });
+        it('should handle an empty list gracefully', () => {
+            const { lastFrame } = renderComponent({ items: [] });
+            expect(mockRenderItem).not.toHaveBeenCalled();
+            expect(lastFrame()).toBe('');
+        });
+    });
+    describe('useSelectionList Integration', () => {
+        it('should pass props correctly to useSelectionList', () => {
+            const initialIndex = 1;
+            const isFocused = false;
+            const showNumbers = false;
+            renderComponent({ initialIndex, isFocused, showNumbers });
+            expect(useSelectionList).toHaveBeenCalledWith({
+                items,
+                initialIndex,
+                onSelect: mockOnSelect,
+                onHighlight: mockOnHighlight,
+                isFocused,
+                showNumbers,
+            });
+        });
+        it('should use the activeIndex returned by the hook', () => {
+            renderComponent({}, 2); // Active index is C
+            expect(mockRenderItem).toHaveBeenCalledWith(items[0], expect.objectContaining({ isSelected: false }));
+            expect(mockRenderItem).toHaveBeenCalledWith(items[2], expect.objectContaining({ isSelected: true }));
+        });
+    });
+    describe('Styling and Colors', () => {
+        it('should apply success color to the selected item', () => {
+            renderComponent({}, 0); // Item A selected
+            // Check renderItem context colors against the mocked theme
+            expect(mockRenderItem).toHaveBeenCalledWith(items[0], expect.objectContaining({
+                titleColor: mockTheme.status.success,
+                numberColor: mockTheme.status.success,
+                isSelected: true,
+            }));
+        });
+        it('should apply primary color to unselected, enabled items', () => {
+            renderComponent({}, 0); // Item A selected, Item C unselected/enabled
+            // Check renderItem context colors for Item C
+            expect(mockRenderItem).toHaveBeenCalledWith(items[2], expect.objectContaining({
+                titleColor: mockTheme.text.primary,
+                numberColor: mockTheme.text.primary,
+                isSelected: false,
+            }));
+        });
+        it('should apply secondary color to disabled items (when not selected)', () => {
+            renderComponent({}, 0); // Item A selected, Item B disabled
+            // Check renderItem context colors for Item B
+            expect(mockRenderItem).toHaveBeenCalledWith(items[1], expect.objectContaining({
+                titleColor: mockTheme.text.secondary,
+                numberColor: mockTheme.text.secondary,
+                isSelected: false,
+            }));
+        });
+        it('should apply success color to disabled items if they are selected', () => {
+            // The component should visually reflect the selection even if the item is disabled.
+            renderComponent({}, 1); // Item B (disabled) selected
+            // Check renderItem context colors for Item B
+            expect(mockRenderItem).toHaveBeenCalledWith(items[1], expect.objectContaining({
+                titleColor: mockTheme.status.success,
+                numberColor: mockTheme.status.success,
+                isSelected: true,
+            }));
+        });
+    });
+    describe('Numbering (showNumbers)', () => {
+        it('should show numbers by default with correct formatting', () => {
+            const { lastFrame } = renderComponent();
+            const output = lastFrame();
+            expect(output).toContain('1.');
+            expect(output).toContain('2.');
+            expect(output).toContain('3.');
+        });
+        it('should hide numbers when showNumbers is false', () => {
+            const { lastFrame } = renderComponent({ showNumbers: false });
+            const output = lastFrame();
+            expect(output).not.toContain('1.');
+            expect(output).not.toContain('2.');
+            expect(output).not.toContain('3.');
+        });
+        it('should apply correct padding for alignment in long lists', () => {
+            const longList = Array.from({ length: 15 }, (_, i) => ({
+                value: `Item ${i + 1}`,
+                label: `Item ${i + 1}`,
+            }));
+            // We must increase maxItemsToShow (default 10) to see the 10th item and beyond
+            const { lastFrame } = renderComponent({
+                items: longList,
+                maxItemsToShow: 15,
+            });
+            const output = lastFrame();
+            // Check formatting for single and double digits.
+            // The implementation uses padStart, resulting in " 1." and "10.".
+            expect(output).toContain(' 1.');
+            expect(output).toContain('10.');
+        });
+        it('should apply secondary color to numbers if showNumbers is false (internal logic check)', () => {
+            renderComponent({ showNumbers: false }, 0);
+            expect(mockRenderItem).toHaveBeenCalledWith(items[0], expect.objectContaining({
+                isSelected: true,
+                titleColor: mockTheme.status.success,
+                numberColor: mockTheme.text.secondary,
+            }));
+        });
+    });
+    describe('Scrolling and Pagination (maxItemsToShow)', () => {
+        const longList = Array.from({ length: 10 }, (_, i) => ({
+            value: `Item ${i + 1}`,
+            label: `Item ${i + 1}`,
+        }));
+        const MAX_ITEMS = 3;
+        const renderScrollableList = (initialActiveIndex = 0) => {
+            // Define the props used for the initial render and subsequent rerenders
+            const componentProps = {
+                items: longList,
+                maxItemsToShow: MAX_ITEMS,
+                onSelect: mockOnSelect,
+                onHighlight: mockOnHighlight,
+                renderItem: mockRenderItem,
+            };
+            vi.mocked(useSelectionList).mockReturnValue({
+                activeIndex: initialActiveIndex,
+                setActiveIndex: vi.fn(),
+            });
+            mockRenderItem.mockImplementation((item, context) => (_jsx(Text, { color: context.titleColor, children: item.label })));
+            const { rerender, lastFrame } = renderWithProviders(_jsx(BaseSelectionList, { ...componentProps }));
+            // Function to simulate the activeIndex changing over time
+            const updateActiveIndex = async (newIndex) => {
+                vi.mocked(useSelectionList).mockReturnValue({
+                    activeIndex: newIndex,
+                    setActiveIndex: vi.fn(),
+                });
+                rerender(_jsx(BaseSelectionList, { ...componentProps }));
+                await waitFor(() => {
+                    expect(lastFrame()).toBeTruthy();
+                });
+            };
+            return { updateActiveIndex, lastFrame };
+        };
+        it('should only show maxItemsToShow items initially', () => {
+            const { lastFrame } = renderScrollableList(0);
+            const output = lastFrame();
+            expect(output).toContain('Item 1');
+            expect(output).toContain('Item 3');
+            expect(output).not.toContain('Item 4');
+        });
+        it('should scroll down when activeIndex moves beyond the visible window', async () => {
+            const { updateActiveIndex, lastFrame } = renderScrollableList(0);
+            // Move to index 3 (Item 4). Should trigger scroll.
+            // New visible window should be Items 2, 3, 4 (scroll offset 1).
+            await updateActiveIndex(3);
+            const output = lastFrame();
+            expect(output).not.toContain('Item 1');
+            expect(output).toContain('Item 2');
+            expect(output).toContain('Item 4');
+            expect(output).not.toContain('Item 5');
+        });
+        it('should scroll up when activeIndex moves before the visible window', async () => {
+            const { updateActiveIndex, lastFrame } = renderScrollableList(0);
+            await updateActiveIndex(4);
+            let output = lastFrame();
+            expect(output).toContain('Item 3'); // Should see items 3, 4, 5
+            expect(output).toContain('Item 5');
+            expect(output).not.toContain('Item 2');
+            // Now test scrolling up: move to index 1 (Item 2)
+            // This should trigger scroll up to show items 2, 3, 4
+            await updateActiveIndex(1);
+            output = lastFrame();
+            expect(output).toContain('Item 2');
+            expect(output).toContain('Item 4');
+            expect(output).not.toContain('Item 5'); // Item 5 should no longer be visible
+        });
+        it('should pin the scroll offset to the end if selection starts near the end', async () => {
+            // List length 10. Max items 3. Active index 9 (last item).
+            // Scroll offset should be 10 - 3 = 7.
+            // Visible items: 8, 9, 10.
+            const { lastFrame } = renderScrollableList(9);
+            await waitFor(() => {
+                const output = lastFrame();
+                expect(output).toContain('Item 10');
+                expect(output).toContain('Item 8');
+                expect(output).not.toContain('Item 7');
+            });
+        });
+        it('should handle dynamic scrolling through multiple activeIndex changes', async () => {
+            const { updateActiveIndex, lastFrame } = renderScrollableList(0);
+            expect(lastFrame()).toContain('Item 1');
+            expect(lastFrame()).toContain('Item 3');
+            // Scroll down gradually
+            await updateActiveIndex(2); // Still within window
+            expect(lastFrame()).toContain('Item 1');
+            await updateActiveIndex(3); // Should trigger scroll
+            let output = lastFrame();
+            expect(output).toContain('Item 2');
+            expect(output).toContain('Item 4');
+            expect(output).not.toContain('Item 1');
+            await updateActiveIndex(5); // Scroll further
+            output = lastFrame();
+            expect(output).toContain('Item 4');
+            expect(output).toContain('Item 6');
+            expect(output).not.toContain('Item 3');
+        });
+        it('should correctly identify the selected item within the visible window', () => {
+            renderScrollableList(1); // activeIndex 1 = Item 2
+            expect(mockRenderItem).toHaveBeenCalledTimes(MAX_ITEMS);
+            expect(mockRenderItem).toHaveBeenCalledWith(expect.objectContaining({ value: 'Item 1' }), expect.objectContaining({ isSelected: false }));
+            expect(mockRenderItem).toHaveBeenCalledWith(expect.objectContaining({ value: 'Item 2' }), expect.objectContaining({ isSelected: true }));
+        });
+        it('should correctly identify the selected item when scrolled (high index)', async () => {
+            renderScrollableList(5);
+            await waitFor(() => {
+                // Item 6 (index 5) should be selected
+                expect(mockRenderItem).toHaveBeenCalledWith(expect.objectContaining({ value: 'Item 6' }), expect.objectContaining({ isSelected: true }));
+            });
+            // Item 4 (index 3) should not be selected
+            expect(mockRenderItem).toHaveBeenCalledWith(expect.objectContaining({ value: 'Item 4' }), expect.objectContaining({ isSelected: false }));
+        });
+        it('should handle maxItemsToShow larger than the list length', () => {
+            // Test edge case where maxItemsToShow exceeds available items
+            const { lastFrame } = renderComponent({ items: longList, maxItemsToShow: 15 }, 0);
+            const output = lastFrame();
+            // Should show all available items (10 items)
+            expect(output).toContain('Item 1');
+            expect(output).toContain('Item 10');
+            expect(mockRenderItem).toHaveBeenCalledTimes(10);
+        });
+    });
+    describe('Scroll Arrows (showScrollArrows)', () => {
+        const longList = Array.from({ length: 10 }, (_, i) => ({
+            value: `Item ${i + 1}`,
+            label: `Item ${i + 1}`,
+        }));
+        const MAX_ITEMS = 3;
+        it('should not show arrows by default', () => {
+            const { lastFrame } = renderComponent({
+                items: longList,
+                maxItemsToShow: MAX_ITEMS,
+            });
+            const output = lastFrame();
+            expect(output).not.toContain('▲');
+            expect(output).not.toContain('▼');
+        });
+        it('should show arrows with correct colors when enabled (at the top)', async () => {
+            const { lastFrame } = renderComponent({
+                items: longList,
+                maxItemsToShow: MAX_ITEMS,
+                showScrollArrows: true,
+            }, 0);
+            await waitFor(() => {
+                const output = lastFrame();
+                // At the top, should show first 3 items
+                expect(output).toContain('Item 1');
+                expect(output).toContain('Item 3');
+                expect(output).not.toContain('Item 4');
+                // Both arrows should be visible
+                expect(output).toContain('▲');
+                expect(output).toContain('▼');
+            });
+        });
+        it('should show arrows and correct items when scrolled to the middle', async () => {
+            const { lastFrame } = renderComponent({ items: longList, maxItemsToShow: MAX_ITEMS, showScrollArrows: true }, 5);
+            await waitFor(() => {
+                const output = lastFrame();
+                // After scrolling to middle, should see items around index 5
+                expect(output).toContain('Item 4');
+                expect(output).toContain('Item 6');
+                expect(output).not.toContain('Item 3');
+                expect(output).not.toContain('Item 7');
+                // Both scroll arrows should be visible
+                expect(output).toContain('▲');
+                expect(output).toContain('▼');
+            });
+        });
+        it('should show arrows and correct items when scrolled to the end', async () => {
+            const { lastFrame } = renderComponent({ items: longList, maxItemsToShow: MAX_ITEMS, showScrollArrows: true }, 9);
+            await waitFor(() => {
+                const output = lastFrame();
+                // At the end, should show last 3 items
+                expect(output).toContain('Item 8');
+                expect(output).toContain('Item 10');
+                expect(output).not.toContain('Item 7');
+                // Both arrows should be visible
+                expect(output).toContain('▲');
+                expect(output).toContain('▼');
+            });
+        });
+        it('should show both arrows dimmed when list fits entirely', () => {
+            const { lastFrame } = renderComponent({
+                items,
+                maxItemsToShow: 5,
+                showScrollArrows: true,
+            });
+            const output = lastFrame();
+            // Should show all items since maxItemsToShow > items.length
+            expect(output).toContain('Item A');
+            expect(output).toContain('Item B');
+            expect(output).toContain('Item C');
+            // Both arrows should be visible but dimmed (this test doesn't need waitFor since no scrolling occurs)
+            expect(output).toContain('▲');
+            expect(output).toContain('▼');
+        });
+    });
+});
+//# sourceMappingURL=BaseSelectionList.test.js.map

package/dist/src/ui/components/shared/BaseSelectionList.test.js.map

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

package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+export interface DescriptiveRadioSelectItem<T> {
+    value: T;
+    title: string;
+    description: string;
+    disabled?: boolean;
+}
+export interface DescriptiveRadioButtonSelectProps<T> {
+    /** An array of items to display as descriptive radio options. */
+    items: Array<DescriptiveRadioSelectItem<T>>;
+    /** The initial index selected */
+    initialIndex?: number;
+    /** Function called when an item is selected. Receives the `value` of the selected item. */
+    onSelect: (value: T) => void;
+    /** Function called when an item is highlighted. Receives the `value` of the selected item. */
+    onHighlight?: (value: T) => void;
+    /** Whether this select input is currently focused and should respond to input. */
+    isFocused?: boolean;
+    /** Whether to show numbers next to items. */
+    showNumbers?: boolean;
+    /** Whether to show the scroll arrows. */
+    showScrollArrows?: boolean;
+    /** The maximum number of items to show at once. */
+    maxItemsToShow?: number;
+}
+/**
+ * A radio button select component that displays items with title and description.
+ *
+ * @template T The type of the value associated with each descriptive radio item.
+ */
+export declare function DescriptiveRadioButtonSelect<T>({ items, initialIndex, onSelect, onHighlight, isFocused, showNumbers, showScrollArrows, maxItemsToShow, }: DescriptiveRadioButtonSelectProps<T>): React.JSX.Element;

package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, Box } from 'ink';
+import { theme } from '../../semantic-colors.js';
+import { BaseSelectionList } from './BaseSelectionList.js';
+/**
+ * A radio button select component that displays items with title and description.
+ *
+ * @template T The type of the value associated with each descriptive radio item.
+ */
+export function DescriptiveRadioButtonSelect({ items, initialIndex = 0, onSelect, onHighlight, isFocused = true, showNumbers = false, showScrollArrows = false, maxItemsToShow = 10, }) {
+    return (_jsx(BaseSelectionList, { items: items, initialIndex: initialIndex, onSelect: onSelect, onHighlight: onHighlight, isFocused: isFocused, showNumbers: showNumbers, showScrollArrows: showScrollArrows, maxItemsToShow: maxItemsToShow, renderItem: (item, { titleColor }) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: titleColor, children: item.title }), _jsx(Text, { color: theme.text.secondary, children: item.description })] })) }));
+}
+//# sourceMappingURL=DescriptiveRadioButtonSelect.js.map

package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptiveRadioButtonSelect.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/DescriptiveRadioButtonSelect.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA4B3D;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAI,EAC9C,KAAK,EACL,YAAY,GAAG,CAAC,EAChB,QAAQ,EACR,WAAW,EACX,SAAS,GAAG,IAAI,EAChB,WAAW,GAAG,KAAK,EACnB,gBAAgB,GAAG,KAAK,EACxB,cAAc,GAAG,EAAE,GACkB;IACrC,OAAO,CACL,KAAC,iBAAiB,IAChB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CACpC,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,IAAI,IAAC,KAAK,EAAE,UAAU,YAAG,IAAI,CAAC,KAAK,GAAQ,EAC5C,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,YAAG,IAAI,CAAC,WAAW,GAAQ,IACxD,CACP,GACD,CACH,CAAC;AACJ,CAAC"}

package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.test.d.ts

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