@terminai/cli 0.21.0

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

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import type { SelectionListItem } from '../../hooks/useSelectionList.js';
+export interface DescriptiveRadioSelectItem<T> extends SelectionListItem<T> {
+    title: string;
+    description?: string;
+}
+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 }), item.description && (_jsx(Text, { color: theme.text.secondary, children: item.description }))] }, item.key)) }));
+}
+//# 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":";AAQA,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;AA2B3D;;;;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,EAC3C,IAAI,CAAC,WAAW,IAAI,CACnB,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,YAAG,IAAI,CAAC,WAAW,GAAQ,CAC7D,KAJ8B,IAAI,CAAC,GAAG,CAKnC,CACP,GACD,CACH,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { DescriptiveRadioButtonSelect, } from './DescriptiveRadioButtonSelect.js';
+vi.mock('./BaseSelectionList.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        BaseSelectionList: vi.fn(({ children, ...props }) => (_jsx(actual.BaseSelectionList, { ...props, children: children }))),
+    };
+});
+vi.mock('../../semantic-colors.js', () => ({
+    theme: {
+        text: {
+            primary: 'COLOR_PRIMARY',
+            secondary: 'COLOR_SECONDARY',
+        },
+        status: {
+            success: 'COLOR_SUCCESS',
+        },
+    },
+}));
+describe('DescriptiveRadioButtonSelect', () => {
+    const mockOnSelect = vi.fn();
+    const mockOnHighlight = vi.fn();
+    const ITEMS = [
+        {
+            title: 'Foo Title',
+            description: 'This is Foo.',
+            value: 'foo',
+            key: 'foo',
+        },
+        {
+            title: 'Bar Title',
+            description: 'This is Bar.',
+            value: 'bar',
+            key: 'bar',
+        },
+        {
+            title: 'Baz Title',
+            description: 'This is Baz.',
+            value: 'baz',
+            disabled: true,
+            key: 'baz',
+        },
+    ];
+    const renderComponent = (props = {}) => {
+        const defaultProps = {
+            items: ITEMS,
+            onSelect: mockOnSelect,
+            ...props,
+        };
+        return renderWithProviders(_jsx(DescriptiveRadioButtonSelect, { ...defaultProps }));
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should render correctly with default props', () => {
+        const { lastFrame } = renderComponent();
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('should render correctly with custom props', () => {
+        const { lastFrame } = renderComponent({
+            initialIndex: 1,
+            isFocused: false,
+            showScrollArrows: true,
+            maxItemsToShow: 5,
+            showNumbers: true,
+            onHighlight: mockOnHighlight,
+        });
+        expect(lastFrame()).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=DescriptiveRadioButtonSelect.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptiveRadioButtonSelect.test.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/DescriptiveRadioButtonSelect.test.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EACL,4BAA4B,GAG7B,MAAM,mCAAmC,CAAC;AAE3C,EAAE,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACzD,MAAM,MAAM,GACV,MAAM,cAAc,EAA2C,CAAC;IAClE,OAAO;QACL,GAAG,MAAM;QACT,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACnD,KAAC,MAAM,CAAC,iBAAiB,OAAK,KAAK,YAAG,QAAQ,GAA4B,CAC3E,CAAC;KACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE,CAAC,CAAC;IACzC,KAAK,EAAE;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,eAAe;YACxB,SAAS,EAAE,iBAAiB;SAC7B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,eAAe;SACzB;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC7B,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAEhC,MAAM,KAAK,GAA8C;QACvD;YACE,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,cAAc;YAC3B,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,KAAK;SACX;QACD;YACE,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,cAAc;YAC3B,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,KAAK;SACX;QACD;YACE,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,cAAc;YAC3B,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,KAAK;SACX;KACF,CAAC;IAEF,MAAM,eAAe,GAAG,CACtB,QAA4D,EAAE,EAC9D,EAAE;QACF,MAAM,YAAY,GAA8C;YAC9D,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,YAAY;YACtB,GAAG,KAAK;SACT,CAAC;QACF,OAAO,mBAAmB,CACxB,KAAC,4BAA4B,OAAK,YAAY,GAAI,CACnD,CAAC;IACJ,CAAC,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAC;QACxC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC;YACpC,YAAY,EAAE,CAAC;YACf,SAAS,EAAE,KAAK;YAChB,gBAAgB,EAAE,IAAI;YACtB,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,eAAe;SAC7B,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import type { SettingEnumOption } from '../../../config/settingsSchema.js';
+interface EnumSelectorProps {
+    options: readonly SettingEnumOption[];
+    currentValue: string | number;
+    isActive: boolean;
+    onValueChange: (value: string | number) => void;
+}
+/**
+ * A left-right scrolling selector for enum values
+ */
+export declare function EnumSelector({ options, currentValue, isActive, onValueChange: _onValueChange, }: EnumSelectorProps): React.JSX.Element;
+export type { EnumSelectorProps };

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

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import { Colors } from '../../colors.js';
+/**
+ * A left-right scrolling selector for enum values
+ */
+export function EnumSelector({ options, currentValue, isActive, onValueChange: _onValueChange, }) {
+    const [currentIndex, setCurrentIndex] = useState(() => {
+        // Guard against empty options array
+        if (!options || options.length === 0) {
+            return 0;
+        }
+        const index = options.findIndex((option) => option.value === currentValue);
+        return index >= 0 ? index : 0;
+    });
+    // Update index when currentValue changes externally
+    useEffect(() => {
+        // Guard against empty options array
+        if (!options || options.length === 0) {
+            return;
+        }
+        const index = options.findIndex((option) => option.value === currentValue);
+        // Always update index, defaulting to 0 if value not found
+        setCurrentIndex(index >= 0 ? index : 0);
+    }, [currentValue, options]);
+    // Guard against empty options array
+    if (!options || options.length === 0) {
+        return _jsx(Box, {});
+    }
+    // Left/right navigation is handled by parent component
+    // This component is purely for display
+    // onValueChange is kept for interface compatibility but not used internally
+    const currentOption = options[currentIndex] || options[0];
+    const canScrollLeft = options.length > 1;
+    const canScrollRight = options.length > 1;
+    return (_jsxs(Box, { flexDirection: "row", alignItems: "center", children: [_jsx(Text, { color: isActive && canScrollLeft ? Colors.AccentGreen : Colors.Gray, children: canScrollLeft ? '←' : ' ' }), _jsx(Text, { children: " " }), _jsx(Text, { color: isActive ? Colors.AccentGreen : Colors.Foreground, bold: isActive, children: currentOption.label }), _jsx(Text, { children: " " }), _jsx(Text, { color: isActive && canScrollRight ? Colors.AccentGreen : Colors.Gray, children: canScrollRight ? '→' : ' ' })] }));
+}
+//# sourceMappingURL=EnumSelector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnumSelector.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/EnumSelector.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAUzC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,aAAa,EAAE,cAAc,GACX;IAClB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE;QACpD,oCAAoC;QACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;QAC3E,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,SAAS,CAAC,GAAG,EAAE;QACb,oCAAoC;QACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;QAC3E,0DAA0D;QAC1D,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,oCAAoC;IACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,KAAC,GAAG,KAAG,CAAC;IACjB,CAAC;IAED,uDAAuD;IACvD,uCAAuC;IACvC,4EAA4E;IAE5E,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAE1C,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,KAAK,EAAC,UAAU,EAAC,QAAQ,aAC1C,KAAC,IAAI,IACH,KAAK,EAAE,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,YAElE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GACrB,EACP,KAAC,IAAI,oBAAS,EACd,KAAC,IAAI,IACH,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EACxD,IAAI,EAAE,QAAQ,YAEb,aAAa,CAAC,KAAK,GACf,EACP,KAAC,IAAI,oBAAS,EACd,KAAC,IAAI,IACH,KAAK,EAAE,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,YAEnE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GACtB,IACH,CACP,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1,71 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { EnumSelector } from './EnumSelector.js';
+import { describe, it, expect } from 'vitest';
+const LANGUAGE_OPTIONS = [
+    { label: 'English', value: 'en' },
+    { label: '中文 (简体)', value: 'zh' },
+    { label: 'Español', value: 'es' },
+    { label: 'Français', value: 'fr' },
+];
+const NUMERIC_OPTIONS = [
+    { label: 'Low', value: 1 },
+    { label: 'Medium', value: 2 },
+    { label: 'High', value: 3 },
+];
+describe('<EnumSelector />', () => {
+    it('renders with string options and matches snapshot', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "en", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('renders with numeric options and matches snapshot', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: NUMERIC_OPTIONS, currentValue: 2, isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('renders inactive state and matches snapshot', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "zh", isActive: false, onValueChange: () => { } }));
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('renders with single option and matches snapshot', () => {
+        const singleOption = [
+            { label: 'Only Option', value: 'only' },
+        ];
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: singleOption, currentValue: "only", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('renders nothing when no options are provided', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: [], currentValue: "", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toBe('');
+    });
+    it('handles currentValue not found in options', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "invalid", isActive: true, onValueChange: () => { } }));
+        // Should default to first option
+        expect(lastFrame()).toContain('English');
+    });
+    it('updates when currentValue changes externally', () => {
+        const { rerender, lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "en", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toContain('English');
+        rerender(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "zh", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toContain('中文 (简体)');
+    });
+    it('shows navigation arrows when multiple options available', () => {
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: LANGUAGE_OPTIONS, currentValue: "en", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).toContain('←');
+        expect(lastFrame()).toContain('→');
+    });
+    it('hides navigation arrows when single option available', () => {
+        const singleOption = [
+            { label: 'Only Option', value: 'only' },
+        ];
+        const { lastFrame } = renderWithProviders(_jsx(EnumSelector, { options: singleOption, currentValue: "only", isActive: true, onValueChange: () => { } }));
+        expect(lastFrame()).not.toContain('←');
+        expect(lastFrame()).not.toContain('→');
+    });
+});
+//# sourceMappingURL=EnumSelector.test.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+/**
+ * Minimum height for the MaxSizedBox component.
+ * This ensures there is room for at least one line of content as well as the
+ * message that content was truncated.
+ */
+export declare const MINIMUM_MAX_HEIGHT = 2;
+export declare function setMaxSizedBoxDebugging(value: boolean): void;
+interface MaxSizedBoxProps {
+    children?: React.ReactNode;
+    maxWidth?: number;
+    maxHeight: number | undefined;
+    overflowDirection?: 'top' | 'bottom';
+    additionalHiddenLinesCount?: number;
+}
+/**
+ * A React component that constrains the size of its children and provides
+ * content-aware truncation when the content exceeds the specified `maxHeight`.
+ *
+ * `MaxSizedBox` requires a specific structure for its children to correctly
+ * measure and render the content:
+ *
+ * 1.  **Direct children must be `<Box>` elements.** Each `<Box>` represents a
+ *     single row of content.
+ * 2.  **Row `<Box>` elements must contain only `<Text>` elements.** These
+ *     `<Text>` elements can be nested and there are no restrictions to Text
+ *     element styling other than that non-wrapping text elements must be
+ *     before wrapping text elements.
+ *
+ * **Constraints:**
+ * - **Box Properties:** Custom properties on the child `<Box>` elements are
+ *   ignored. In debug mode, runtime checks will report errors for any
+ *   unsupported properties.
+ * - **Text Wrapping:** Within a single row, `<Text>` elements with no wrapping
+ *   (e.g., headers, labels) must appear before any `<Text>` elements that wrap.
+ * - **Element Types:** Runtime checks will warn if unsupported element types
+ *   are used as children.
+ *
+ * @example
+ * <MaxSizedBox maxWidth={80} maxHeight={10}>
+ *   <Box>
+ *     <Text>This is the first line.</Text>
+ *   </Box>
+ *   <Box>
+ *     <Text color="cyan" wrap="truncate">Non-wrapping Header: </Text>
+ *     <Text>This is the rest of the line which will wrap if it's too long.</Text>
+ *   </Box>
+ *   <Box>
+ *     <Text>
+ *       Line 3 with <Text color="yellow">nested styled text</Text> inside of it.
+ *     </Text>
+ *   </Box>
+ * </MaxSizedBox>
+ */
+export declare const MaxSizedBox: React.FC<MaxSizedBoxProps>;
+export {};