@quantum-ai/gemini-cli 0.45.3

package/packages/cli/dist/src/ui/components/shared/SearchableList.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+import type { TextBuffer } from './text-buffer.js';
+/**
+ * Generic interface for items in a searchable list.
+ */
+export interface GenericListItem {
+    key: string;
+    label: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * State returned by the search hook.
+ */
+export interface SearchListState<T extends GenericListItem> {
+    filteredItems: T[];
+    searchBuffer: TextBuffer | undefined;
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    maxLabelWidth: number;
+}
+/**
+ * Props for the SearchableList component.
+ */
+export interface SearchableListProps<T extends GenericListItem> {
+    title?: string;
+    items: T[];
+    onSelect: (item: T) => void;
+    onClose: () => void;
+    searchPlaceholder?: string;
+    /** Custom item renderer */
+    renderItem?: (item: T, isActive: boolean, labelWidth: number) => React.ReactNode;
+    /** Optional header content */
+    header?: React.ReactNode;
+    /** Optional footer content */
+    footer?: (info: {
+        startIndex: number;
+        endIndex: number;
+        totalVisible: number;
+    }) => React.ReactNode;
+    maxItemsToShow?: number;
+    /** Hook to handle search logic */
+    useSearch: (props: {
+        items: T[];
+        onSearch?: (query: string) => void;
+    }) => SearchListState<T>;
+    onSearch?: (query: string) => void;
+    /** Whether to reset selection to the top when items change (e.g. after search) */
+    resetSelectionOnItemsChange?: boolean;
+    /** Whether the list is focused and accepts keyboard input. Defaults to true. */
+    isFocused?: boolean;
+}
+/**
+ * A generic searchable list component with keyboard navigation.
+ */
+export declare function SearchableList<T extends GenericListItem>({ title, items, onSelect, onClose, searchPlaceholder, renderItem, header, footer, maxItemsToShow, useSearch, onSearch, resetSelectionOnItemsChange, isFocused, }: SearchableListProps<T>): React.JSX.Element;

package/packages/cli/dist/src/ui/components/shared/SearchableList.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React, { useMemo, useCallback } from 'react';
+import { Box, Text } from 'ink';
+import { theme } from '../../semantic-colors.js';
+import { useSelectionList } from '../../hooks/useSelectionList.js';
+import { TextInput } from './TextInput.js';
+import { useKeypress } from '../../hooks/useKeypress.js';
+import { Command } from '../../key/keyMatchers.js';
+import { useKeyMatchers } from '../../hooks/useKeyMatchers.js';
+/**
+ * A generic searchable list component with keyboard navigation.
+ */
+export function SearchableList({ title, items, onSelect, onClose, searchPlaceholder = 'Search...', renderItem, header, footer, maxItemsToShow = 10, useSearch, onSearch, resetSelectionOnItemsChange = false, isFocused = true, }) {
+    const keyMatchers = useKeyMatchers();
+    const { filteredItems, searchBuffer, maxLabelWidth } = useSearch({
+        items,
+        onSearch,
+    });
+    const selectionItems = useMemo(() => filteredItems.map((item) => ({
+        key: item.key,
+        value: item,
+    })), [filteredItems]);
+    const handleSelectValue = useCallback((item) => {
+        onSelect(item);
+    }, [onSelect]);
+    const { activeIndex, setActiveIndex } = useSelectionList({
+        items: selectionItems,
+        onSelect: handleSelectValue,
+        isFocused,
+        showNumbers: false,
+        wrapAround: true,
+        priority: true,
+    });
+    const [scrollOffsetState, setScrollOffsetState] = React.useState(0);
+    // Compute effective scroll offset during render to avoid visual flicker
+    let scrollOffset = scrollOffsetState;
+    if (activeIndex < scrollOffset) {
+        scrollOffset = activeIndex;
+    }
+    else if (activeIndex >= scrollOffset + maxItemsToShow) {
+        scrollOffset = activeIndex - maxItemsToShow + 1;
+    }
+    const maxScroll = Math.max(0, filteredItems.length - maxItemsToShow);
+    if (scrollOffset > maxScroll) {
+        scrollOffset = maxScroll;
+    }
+    // Update state to match derived value if it changed
+    if (scrollOffsetState !== scrollOffset) {
+        setScrollOffsetState(scrollOffset);
+    }
+    // Reset selection to top when items change if requested
+    const prevItemsRef = React.useRef(filteredItems);
+    React.useLayoutEffect(() => {
+        if (resetSelectionOnItemsChange && filteredItems !== prevItemsRef.current) {
+            setActiveIndex(0);
+            setScrollOffsetState(0);
+        }
+        prevItemsRef.current = filteredItems;
+    }, [filteredItems, setActiveIndex, resetSelectionOnItemsChange]);
+    // Handle global Escape key to close the list
+    useKeypress((key) => {
+        if (keyMatchers[Command.ESCAPE](key)) {
+            onClose();
+            return true;
+        }
+        return false;
+    }, { isActive: isFocused });
+    const visibleItems = filteredItems.slice(scrollOffset, scrollOffset + maxItemsToShow);
+    const defaultRenderItem = (item, isActive, labelWidth) => (_jsxs(Box, { flexDirection: "row", alignItems: "flex-start", children: [_jsx(Box, { minWidth: 2, flexShrink: 0, children: _jsx(Text, { color: isActive ? theme.status.success : theme.text.secondary, children: isActive ? '●' : '' }) }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, minWidth: 0, children: [_jsx(Text, { color: isActive ? theme.status.success : theme.text.primary, children: item.label.padEnd(labelWidth) }), item.description && (_jsx(Text, { color: theme.text.secondary, wrap: "truncate-end", children: item.description }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", height: "100%", paddingX: 1, children: [title && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.text.primary, children: title }) })), searchBuffer && (_jsx(Box, { borderStyle: "round", borderColor: theme.border.default, paddingX: 1, marginBottom: 1, children: _jsx(TextInput, { buffer: searchBuffer, placeholder: searchPlaceholder, focus: isFocused }) })), header && _jsx(Box, { marginBottom: 1, children: header }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: filteredItems.length === 0 ? (_jsx(Box, { marginX: 2, children: _jsx(Text, { color: theme.text.secondary, children: "No items found." }) })) : (_jsxs(_Fragment, { children: [filteredItems.length > maxItemsToShow && (_jsx(Box, { marginX: 1, children: _jsx(Text, { color: theme.text.secondary, children: "\u25B2" }) })), visibleItems.map((item, index) => {
+                            const isSelected = activeIndex === scrollOffset + index;
+                            return (_jsx(Box, { marginBottom: 1, marginX: 1, children: renderItem
+                                    ? renderItem(item, isSelected, maxLabelWidth)
+                                    : defaultRenderItem(item, isSelected, maxLabelWidth) }, item.key));
+                        }), filteredItems.length > maxItemsToShow && (_jsx(Box, { marginX: 1, children: _jsx(Text, { color: theme.text.secondary, children: "\u25BC" }) }))] })) }), footer && (_jsx(Box, { marginTop: 1, children: footer({
+                    startIndex: scrollOffset,
+                    endIndex: scrollOffset + visibleItems.length,
+                    totalVisible: filteredItems.length,
+                }) }))] }));
+}
+//# sourceMappingURL=SearchableList.js.map

package/packages/cli/dist/src/ui/components/shared/SearchableList.js.map

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

package/packages/cli/dist/src/ui/components/shared/SearchableList.test.d.ts

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

package/packages/cli/dist/src/ui/components/shared/SearchableList.test.js

@@ -0,0 +1,169 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { waitFor } from '../../../test-utils/async.js';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { SearchableList, } from './SearchableList.js';
+import { useTextBuffer } from './text-buffer.js';
+const useMockSearch = (props) => {
+    const { onSearch, items, initialQuery = '' } = props;
+    const [text, setText] = React.useState(initialQuery);
+    const filteredItems = React.useMemo(() => items.filter((item) => item.label.toLowerCase().includes(text.toLowerCase())), [items, text]);
+    React.useEffect(() => {
+        onSearch?.(text);
+    }, [text, onSearch]);
+    const searchBuffer = useTextBuffer({
+        initialText: text,
+        onChange: setText,
+        viewport: { width: 100, height: 1 },
+        singleLine: true,
+    });
+    return {
+        filteredItems,
+        searchBuffer,
+        searchQuery: text,
+        setSearchQuery: setText,
+        maxLabelWidth: 10,
+    };
+};
+const mockItems = [
+    {
+        key: 'item-1',
+        label: 'Item One',
+        description: 'Description for item one',
+    },
+    {
+        key: 'item-2',
+        label: 'Item Two',
+        description: 'Description for item two',
+    },
+    {
+        key: 'item-3',
+        label: 'Item Three',
+        description: 'Description for item three',
+    },
+];
+describe('SearchableList', () => {
+    let mockOnSelect;
+    let mockOnClose;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockOnSelect = vi.fn();
+        mockOnClose = vi.fn();
+    });
+    const renderList = async (props = {}) => {
+        const defaultProps = {
+            title: 'Test List',
+            items: mockItems,
+            onSelect: mockOnSelect,
+            onClose: mockOnClose,
+            useSearch: useMockSearch,
+            ...props,
+        };
+        return renderWithProviders(_jsx(SearchableList, { ...defaultProps }));
+    };
+    it('should render all items initially', async () => {
+        const { lastFrame } = await renderList();
+        const frame = lastFrame();
+        expect(frame).toContain('Test List');
+        expect(frame).toContain('Item One');
+        expect(frame).toContain('Item Two');
+        expect(frame).toContain('Item Three');
+        expect(frame).toContain('Description for item one');
+    });
+    it('should reset selection to top when items change if resetSelectionOnItemsChange is true', async () => {
+        const { lastFrame, stdin } = await renderList({
+            resetSelectionOnItemsChange: true,
+        });
+        await React.act(async () => {
+            stdin.write('\u001B[B'); // Down arrow
+        });
+        await waitFor(() => {
+            const frame = lastFrame();
+            expect(frame).toContain('● Item Two');
+        });
+        expect(lastFrame()).toMatchSnapshot();
+        await React.act(async () => {
+            stdin.write('One');
+        });
+        await waitFor(() => {
+            const frame = lastFrame();
+            expect(frame).toContain('Item One');
+            expect(frame).not.toContain('Item Two');
+        });
+        expect(lastFrame()).toMatchSnapshot();
+        await React.act(async () => {
+            // Backspace "One" (3 chars)
+            stdin.write('\u007F\u007F\u007F');
+        });
+        await waitFor(() => {
+            const frame = lastFrame();
+            expect(frame).toContain('Item Two');
+            expect(frame).toContain('● Item One');
+            expect(frame).not.toContain('● Item Two');
+        });
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('should filter items based on search query', async () => {
+        const { lastFrame, stdin } = await renderList();
+        await React.act(async () => {
+            stdin.write('Two');
+        });
+        await waitFor(() => {
+            const frame = lastFrame();
+            expect(frame).toContain('Item Two');
+            expect(frame).not.toContain('Item One');
+            expect(frame).not.toContain('Item Three');
+        });
+    });
+    it('should show "No items found." when no items match', async () => {
+        const { lastFrame, stdin } = await renderList();
+        await React.act(async () => {
+            stdin.write('xyz123');
+        });
+        await waitFor(() => {
+            const frame = lastFrame();
+            expect(frame).toContain('No items found.');
+        });
+    });
+    it('should handle selection with Enter', async () => {
+        const { stdin } = await renderList();
+        await React.act(async () => {
+            stdin.write('\r'); // Enter
+        });
+        await waitFor(() => {
+            expect(mockOnSelect).toHaveBeenCalledWith(mockItems[0]);
+        });
+    });
+    it('should handle navigation and selection', async () => {
+        const { stdin } = await renderList();
+        await React.act(async () => {
+            stdin.write('\u001B[B'); // Down arrow
+        });
+        await React.act(async () => {
+            stdin.write('\r'); // Enter
+        });
+        await waitFor(() => {
+            expect(mockOnSelect).toHaveBeenCalledWith(mockItems[1]);
+        });
+    });
+    it('should handle close with Esc', async () => {
+        const { stdin } = await renderList();
+        await React.act(async () => {
+            stdin.write('\u001B'); // Esc
+        });
+        await waitFor(() => {
+            expect(mockOnClose).toHaveBeenCalled();
+        });
+    });
+    it('should match snapshot', async () => {
+        const { lastFrame } = await renderList();
+        expect(lastFrame()).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=SearchableList.test.js.map

package/packages/cli/dist/src/ui/components/shared/SearchableList.test.js.map

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

package/packages/cli/dist/src/ui/components/shared/SectionHeader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+export declare const SectionHeader: React.FC<{
+    title: string;
+    subtitle?: string;
+}>;

package/packages/cli/dist/src/ui/components/shared/SectionHeader.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { theme } from '../../semantic-colors.js';
+export const SectionHeader = ({ title, subtitle, }) => (_jsxs(Box, { width: "100%", flexDirection: "column", overflow: "hidden", children: [_jsx(Box, { width: "100%", borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, borderColor: theme.text.secondary }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: theme.text.primary, bold: true, wrap: "truncate-end", children: title }), subtitle && (_jsx(Text, { color: theme.text.secondary, wrap: "truncate-end", children: subtitle }))] })] }));
+//# sourceMappingURL=SectionHeader.js.map

package/packages/cli/dist/src/ui/components/shared/SectionHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionHeader.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/SectionHeader.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAmD,CAAC,EAC5E,KAAK,EACL,QAAQ,GACT,EAAE,EAAE,CAAC,CACJ,MAAC,GAAG,IAAC,KAAK,EAAC,MAAM,EAAC,aAAa,EAAC,QAAQ,EAAC,QAAQ,EAAC,QAAQ,aACxD,KAAC,GAAG,IACF,KAAK,EAAC,MAAM,EACZ,WAAW,EAAC,QAAQ,EACpB,SAAS,QACT,YAAY,EAAE,KAAK,EACnB,UAAU,EAAE,KAAK,EACjB,WAAW,EAAE,KAAK,EAClB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,GACjC,EACF,MAAC,GAAG,IAAC,aAAa,EAAC,KAAK,aACtB,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,QAAC,IAAI,EAAC,cAAc,YACtD,KAAK,GACD,EACN,QAAQ,IAAI,CACX,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAC,cAAc,YACnD,QAAQ,GACJ,CACR,IACG,IACF,CACP,CAAC"}

package/packages/cli/dist/src/ui/components/shared/SectionHeader.test.d.ts

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

package/packages/cli/dist/src/ui/components/shared/SectionHeader.test.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { SectionHeader } from './SectionHeader.js';
+describe('<SectionHeader />', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it.each([
+        {
+            description: 'renders correctly with a standard title',
+            title: 'My Header',
+            width: 40,
+        },
+        {
+            description: 'renders correctly when title is truncated but still shows dashes',
+            title: 'Very Long Header Title That Will Truncate',
+            width: 20,
+        },
+        {
+            description: 'renders correctly in a narrow container',
+            title: 'Narrow Container',
+            width: 25,
+        },
+        {
+            description: 'renders correctly with a subtitle',
+            title: 'Shortcuts',
+            subtitle: ' See /help for more',
+            width: 40,
+        },
+    ])('$description', async ({ title, subtitle, width }) => {
+        const { lastFrame, unmount } = await renderWithProviders(_jsx(SectionHeader, { title: title, subtitle: subtitle }), { width });
+        expect(lastFrame()).toMatchSnapshot();
+        unmount();
+    });
+});
+//# sourceMappingURL=SectionHeader.test.js.map

package/packages/cli/dist/src/ui/components/shared/SectionHeader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionHeader.test.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/SectionHeader.test.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN;YACE,WAAW,EAAE,yCAAyC;YACtD,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,EAAE;SACV;QACD;YACE,WAAW,EACT,kEAAkE;YACpE,KAAK,EAAE,2CAA2C;YAClD,KAAK,EAAE,EAAE;SACV;QACD;YACE,WAAW,EAAE,yCAAyC;YACtD,KAAK,EAAE,kBAAkB;YACzB,KAAK,EAAE,EAAE;SACV;QACD;YACE,WAAW,EAAE,mCAAmC;YAChD,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,qBAAqB;YAC/B,KAAK,EAAE,EAAE;SACV;KACF,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACtD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CACtD,KAAC,aAAa,IAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAI,EACnD,EAAE,KAAK,EAAE,CACV,CAAC;QAEF,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type MaxSizedBoxProps } from './MaxSizedBox.js';
+export interface SlicingMaxSizedBoxProps<T> extends Omit<MaxSizedBoxProps, 'children'> {
+    data: T;
+    maxLines?: number;
+    isAlternateBuffer?: boolean;
+    children: (truncatedData: T) => React.ReactNode;
+}
+/**
+ * An extension of MaxSizedBox that performs explicit slicing of the input data
+ * (string or array) before rendering. This is useful for performance and to
+ * ensure consistent truncation behavior for large outputs.
+ */
+export declare function SlicingMaxSizedBox<T>({ data, maxLines, isAlternateBuffer, children, ...boxProps }: SlicingMaxSizedBoxProps<T>): import("react/jsx-runtime").JSX.Element;

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useMemo } from 'react';
+import { MaxSizedBox } from './MaxSizedBox.js';
+// Large threshold to ensure we don't cause performance issues for very large
+// outputs that will get truncated further MaxSizedBox anyway.
+const MAXIMUM_RESULT_DISPLAY_CHARACTERS = 20000;
+/**
+ * An extension of MaxSizedBox that performs explicit slicing of the input data
+ * (string or array) before rendering. This is useful for performance and to
+ * ensure consistent truncation behavior for large outputs.
+ */
+export function SlicingMaxSizedBox({ data, maxLines, isAlternateBuffer, children, ...boxProps }) {
+    const { truncatedData, hiddenLinesCount } = useMemo(() => {
+        let hiddenLines = 0;
+        const overflowDirection = boxProps.overflowDirection ?? 'top';
+        // Only truncate string output if not in alternate buffer mode to ensure
+        // we can scroll through the full output.
+        if (typeof data === 'string' && !isAlternateBuffer) {
+            let text = data;
+            if (text.length > MAXIMUM_RESULT_DISPLAY_CHARACTERS) {
+                if (overflowDirection === 'bottom') {
+                    text = text.slice(0, MAXIMUM_RESULT_DISPLAY_CHARACTERS) + '...';
+                }
+                else {
+                    text = '...' + text.slice(-MAXIMUM_RESULT_DISPLAY_CHARACTERS);
+                }
+            }
+            if (maxLines !== undefined) {
+                const hasTrailingNewline = text.endsWith('\n');
+                const contentText = hasTrailingNewline ? text.slice(0, -1) : text;
+                const lines = contentText.split('\n');
+                if (lines.length > maxLines) {
+                    // We will have a label from MaxSizedBox. Reserve space for it.
+                    const targetLines = Math.max(1, maxLines - 1);
+                    hiddenLines = lines.length - targetLines;
+                    if (overflowDirection === 'bottom') {
+                        text =
+                            lines.slice(0, targetLines).join('\n') +
+                                (hasTrailingNewline ? '\n' : '');
+                    }
+                    else {
+                        text =
+                            lines.slice(-targetLines).join('\n') +
+                                (hasTrailingNewline ? '\n' : '');
+                    }
+                }
+            }
+            return {
+                truncatedData: text,
+                hiddenLinesCount: hiddenLines,
+            };
+        }
+        if (Array.isArray(data) && !isAlternateBuffer && maxLines !== undefined) {
+            if (data.length > maxLines) {
+                // We will have a label from MaxSizedBox. Reserve space for it.
+                const targetLines = Math.max(1, maxLines - 1);
+                const hiddenCount = data.length - targetLines;
+                return {
+                    truncatedData: overflowDirection === 'bottom'
+                        ? data.slice(0, targetLines)
+                        : data.slice(-targetLines),
+                    hiddenLinesCount: hiddenCount,
+                };
+            }
+        }
+        return { truncatedData: data, hiddenLinesCount: 0 };
+    }, [data, isAlternateBuffer, maxLines, boxProps.overflowDirection]);
+    return (_jsx(MaxSizedBox, { ...boxProps, additionalHiddenLinesCount: (boxProps.additionalHiddenLinesCount ?? 0) + hiddenLinesCount, children: children(truncatedData) }));
+}
+//# sourceMappingURL=SlicingMaxSizedBox.js.map

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.js.map

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

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.test.d.ts

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

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.test.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from '../../../test-utils/render.js';
+import { OverflowProvider } from '../../contexts/OverflowContext.js';
+import { SlicingMaxSizedBox } from './SlicingMaxSizedBox.js';
+import { Box, Text } from 'ink';
+import { describe, it, expect } from 'vitest';
+describe('<SlicingMaxSizedBox />', () => {
+    it('renders string data without slicing when it fits', async () => {
+        const { lastFrame, unmount } = await render(_jsx(OverflowProvider, { children: _jsx(SlicingMaxSizedBox, { data: "Hello World", maxWidth: 80, children: (truncatedData) => _jsx(Text, { children: truncatedData }) }) }));
+        expect(lastFrame()).toContain('Hello World');
+        unmount();
+    });
+    it('slices string data by characters when very long', async () => {
+        const veryLongString = 'A'.repeat(25000);
+        const { lastFrame, unmount } = await render(_jsx(OverflowProvider, { children: _jsx(SlicingMaxSizedBox, { data: veryLongString, maxWidth: 80, overflowDirection: "bottom", children: (truncatedData) => _jsx(Text, { children: truncatedData.length }) }) }));
+        // 20000 characters + 3 for '...'
+        expect(lastFrame()).toContain('20003');
+        unmount();
+    });
+    it('slices string data by lines when maxLines is provided', async () => {
+        const multilineString = 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5';
+        const { lastFrame, unmount } = await render(_jsx(OverflowProvider, { children: _jsx(SlicingMaxSizedBox, { data: multilineString, maxLines: 3, maxWidth: 80, maxHeight: 10, overflowDirection: "bottom", children: (truncatedData) => _jsx(Text, { children: truncatedData }) }) }));
+        // maxLines=3, so it should keep 3-1 = 2 lines
+        expect(lastFrame()).toContain('Line 1');
+        expect(lastFrame()).toContain('Line 2');
+        expect(lastFrame()).not.toContain('Line 3');
+        expect(lastFrame()).toContain('... last 3 lines hidden (Ctrl+O to show) ...');
+        unmount();
+    });
+    it('slices array data when maxLines is provided', async () => {
+        const dataArray = ['Item 1', 'Item 2', 'Item 3', 'Item 4', 'Item 5'];
+        const { lastFrame, unmount } = await render(_jsx(OverflowProvider, { children: _jsx(SlicingMaxSizedBox, { data: dataArray, maxLines: 3, maxWidth: 80, maxHeight: 10, overflowDirection: "bottom", children: (truncatedData) => (_jsx(Box, { flexDirection: "column", children: truncatedData.map((item, i) => (_jsx(Text, { children: item }, i))) })) }) }));
+        // maxLines=3, so it should keep 3-1 = 2 items
+        expect(lastFrame()).toContain('Item 1');
+        expect(lastFrame()).toContain('Item 2');
+        expect(lastFrame()).not.toContain('Item 3');
+        expect(lastFrame()).toContain('... last 3 lines hidden (Ctrl+O to show) ...');
+        unmount();
+    });
+    it('does not slice when isAlternateBuffer is true', async () => {
+        const multilineString = 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5';
+        const { lastFrame, unmount } = await render(_jsx(OverflowProvider, { children: _jsx(SlicingMaxSizedBox, { data: multilineString, maxLines: 3, maxWidth: 80, isAlternateBuffer: true, children: (truncatedData) => _jsx(Text, { children: truncatedData }) }) }));
+        expect(lastFrame()).toContain('Line 5');
+        expect(lastFrame()).not.toContain('hidden');
+        unmount();
+    });
+});
+//# sourceMappingURL=SlicingMaxSizedBox.test.js.map

package/packages/cli/dist/src/ui/components/shared/SlicingMaxSizedBox.test.js.map

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