@google/gemini-cli 0.1.1 → 0.1.3-rc.1

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

@@ -0,0 +1,383 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React, { Fragment, useEffect, useId } from 'react';
+import { Box, Text } from 'ink';
+import stringWidth from 'string-width';
+import { Colors } from '../../colors.js';
+import { toCodePoints } from '../../utils/textUtils.js';
+import { useOverflowActions } from '../../contexts/OverflowContext.js';
+let enableDebugLog = false;
+/**
+ * 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 const MINIMUM_MAX_HEIGHT = 2;
+export function setMaxSizedBoxDebugging(value) {
+    enableDebugLog = value;
+}
+function debugReportError(message, element) {
+    if (!enableDebugLog)
+        return;
+    if (!React.isValidElement(element)) {
+        console.error(message, `Invalid element: '${String(element)}' typeof=${typeof element}`);
+        return;
+    }
+    let sourceMessage = '<Unknown file>';
+    try {
+        const elementWithSource = element;
+        const fileName = elementWithSource._source?.fileName;
+        const lineNumber = elementWithSource._source?.lineNumber;
+        sourceMessage = fileName ? `${fileName}:${lineNumber}` : '<Unknown file>';
+    }
+    catch (error) {
+        console.error('Error while trying to get file name:', error);
+    }
+    console.error(message, `${String(element.type)}. Source: ${sourceMessage}`);
+}
+/**
+ * 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 const MaxSizedBox = ({ children, maxWidth, maxHeight, overflowDirection = 'top', additionalHiddenLinesCount = 0, }) => {
+    const id = useId();
+    const { addOverflowingId, removeOverflowingId } = useOverflowActions() || {};
+    const laidOutStyledText = [];
+    const targetMaxHeight = Math.max(Math.round(maxHeight ?? Number.MAX_SAFE_INTEGER), MINIMUM_MAX_HEIGHT);
+    if (maxWidth === undefined) {
+        throw new Error('maxWidth must be defined when maxHeight is set.');
+    }
+    function visitRows(element) {
+        if (!React.isValidElement(element)) {
+            return;
+        }
+        if (element.type === Fragment) {
+            React.Children.forEach(element.props.children, visitRows);
+            return;
+        }
+        if (element.type === Box) {
+            layoutInkElementAsStyledText(element, maxWidth, laidOutStyledText);
+            return;
+        }
+        debugReportError('MaxSizedBox children must be <Box> elements', element);
+    }
+    React.Children.forEach(children, visitRows);
+    const contentWillOverflow = (targetMaxHeight !== undefined &&
+        laidOutStyledText.length > targetMaxHeight) ||
+        additionalHiddenLinesCount > 0;
+    const visibleContentHeight = contentWillOverflow && targetMaxHeight !== undefined
+        ? targetMaxHeight - 1
+        : targetMaxHeight;
+    const hiddenLinesCount = visibleContentHeight !== undefined
+        ? Math.max(0, laidOutStyledText.length - visibleContentHeight)
+        : 0;
+    const totalHiddenLines = hiddenLinesCount + additionalHiddenLinesCount;
+    useEffect(() => {
+        if (totalHiddenLines > 0) {
+            addOverflowingId?.(id);
+        }
+        else {
+            removeOverflowingId?.(id);
+        }
+        return () => {
+            removeOverflowingId?.(id);
+        };
+    }, [id, totalHiddenLines, addOverflowingId, removeOverflowingId]);
+    const visibleStyledText = hiddenLinesCount > 0
+        ? overflowDirection === 'top'
+            ? laidOutStyledText.slice(hiddenLinesCount, laidOutStyledText.length)
+            : laidOutStyledText.slice(0, visibleContentHeight)
+        : laidOutStyledText;
+    const visibleLines = visibleStyledText.map((line, index) => (_jsx(Box, { children: line.length > 0 ? (line.map((segment, segIndex) => (_jsx(Text, { ...segment.props, children: segment.text }, segIndex)))) : (_jsx(Text, { children: " " })) }, index)));
+    return (_jsxs(Box, { flexDirection: "column", width: maxWidth, flexShrink: 0, children: [totalHiddenLines > 0 && overflowDirection === 'top' && (_jsxs(Text, { color: Colors.Gray, wrap: "truncate", children: ["... first ", totalHiddenLines, " line", totalHiddenLines === 1 ? '' : 's', ' ', "hidden ..."] })), visibleLines, totalHiddenLines > 0 && overflowDirection === 'bottom' && (_jsxs(Text, { color: Colors.Gray, wrap: "truncate", children: ["... last ", totalHiddenLines, " line", totalHiddenLines === 1 ? '' : 's', ' ', "hidden ..."] }))] }));
+};
+/**
+ * Flattens the child elements of MaxSizedBox into an array of `Row` objects.
+ *
+ * This function expects a specific child structure to function correctly:
+ * 1. The top-level child of `MaxSizedBox` should be a single `<Box>`. This
+ *    outer box is primarily for structure and is not directly rendered.
+ * 2. Inside the outer `<Box>`, there should be one or more children. Each of
+ *    these children must be a `<Box>` that represents a row.
+ * 3. Inside each "row" `<Box>`, the children must be `<Text>` components.
+ *
+ * The structure should look like this:
+ * <MaxSizedBox>
+ *   <Box> // Row 1
+ *     <Text>...</Text>
+ *     <Text>...</Text>
+ *   </Box>
+ *   <Box> // Row 2
+ *     <Text>...</Text>
+ *   </Box>
+ * </MaxSizedBox>
+ *
+ * It is an error for a <Text> child without wrapping to appear after a
+ * <Text> child with wrapping within the same row Box.
+ *
+ * @param element The React node to flatten.
+ * @returns An array of `Row` objects.
+ */
+function visitBoxRow(element) {
+    if (!React.isValidElement(element) || element.type !== Box) {
+        debugReportError(`All children of MaxSizedBox must be <Box> elements`, element);
+        return {
+            noWrapSegments: [{ text: '<ERROR>', props: {} }],
+            segments: [],
+        };
+    }
+    if (enableDebugLog) {
+        const boxProps = element.props;
+        // Ensure the Box has no props other than the default ones and key.
+        let maxExpectedProps = 4;
+        if (boxProps.children !== undefined) {
+            // Allow the key prop, which is automatically added by React.
+            maxExpectedProps += 1;
+        }
+        if (boxProps.flexDirection !== 'row') {
+            debugReportError('MaxSizedBox children must have flexDirection="row".', element);
+        }
+        if (Object.keys(boxProps).length > maxExpectedProps) {
+            debugReportError(`Boxes inside MaxSizedBox must not have additional props. ${Object.keys(boxProps).join(', ')}`, element);
+        }
+    }
+    const row = {
+        noWrapSegments: [],
+        segments: [],
+    };
+    let hasSeenWrapped = false;
+    function visitRowChild(element, parentProps) {
+        if (element === null) {
+            return;
+        }
+        if (typeof element === 'string' || typeof element === 'number') {
+            const text = String(element);
+            // Ignore empty strings as they don't need to be rendered.
+            if (!text) {
+                return;
+            }
+            const segment = { text, props: parentProps ?? {} };
+            // Check the 'wrap' property from the merged props to decide the segment type.
+            if (parentProps === undefined || parentProps.wrap === 'wrap') {
+                hasSeenWrapped = true;
+                row.segments.push(segment);
+            }
+            else {
+                if (!hasSeenWrapped) {
+                    row.noWrapSegments.push(segment);
+                }
+                else {
+                    // put in in the wrapped segment as the row is already stuck in wrapped mode.
+                    row.segments.push(segment);
+                    debugReportError('Text elements without wrapping cannot appear after elements with wrapping in the same row.', element);
+                }
+            }
+            return;
+        }
+        if (!React.isValidElement(element)) {
+            debugReportError('Invalid element.', element);
+            return;
+        }
+        if (element.type === Fragment) {
+            const fragmentChildren = element.props.children;
+            React.Children.forEach(fragmentChildren, (child) => visitRowChild(child, parentProps));
+            return;
+        }
+        if (element.type !== Text) {
+            debugReportError('Children of a row Box must be <Text> elements.', element);
+            return;
+        }
+        // Merge props from parent <Text> elements. Child props take precedence.
+        const { children, ...currentProps } = element.props;
+        const mergedProps = parentProps === undefined
+            ? currentProps
+            : { ...parentProps, ...currentProps };
+        React.Children.forEach(children, (child) => visitRowChild(child, mergedProps));
+    }
+    React.Children.forEach(element.props.children, (child) => visitRowChild(child, undefined));
+    return row;
+}
+function layoutInkElementAsStyledText(element, maxWidth, output) {
+    const row = visitBoxRow(element);
+    if (row.segments.length === 0 && row.noWrapSegments.length === 0) {
+        // Return a single empty line if there are no segments to display
+        output.push([]);
+        return;
+    }
+    const lines = [];
+    const nonWrappingContent = [];
+    let noWrappingWidth = 0;
+    // First, lay out the non-wrapping segments
+    row.noWrapSegments.forEach((segment) => {
+        nonWrappingContent.push(segment);
+        noWrappingWidth += stringWidth(segment.text);
+    });
+    if (row.segments.length === 0) {
+        // This is a bit of a special case when there are no segments that allow
+        // wrapping. It would be ideal to unify.
+        const lines = [];
+        let currentLine = [];
+        nonWrappingContent.forEach((segment) => {
+            const textLines = segment.text.split('\n');
+            textLines.forEach((text, index) => {
+                if (index > 0) {
+                    lines.push(currentLine);
+                    currentLine = [];
+                }
+                if (text) {
+                    currentLine.push({ text, props: segment.props });
+                }
+            });
+        });
+        if (currentLine.length > 0 ||
+            (nonWrappingContent.length > 0 &&
+                nonWrappingContent[nonWrappingContent.length - 1].text.endsWith('\n'))) {
+            lines.push(currentLine);
+        }
+        for (const line of lines) {
+            output.push(line);
+        }
+        return;
+    }
+    const availableWidth = maxWidth - noWrappingWidth;
+    if (availableWidth < 1) {
+        // No room to render the wrapping segments. TODO(jacob314): consider an alternative fallback strategy.
+        output.push(nonWrappingContent);
+        return;
+    }
+    // Now, lay out the wrapping segments
+    let wrappingPart = [];
+    let wrappingPartWidth = 0;
+    function addWrappingPartToLines() {
+        if (lines.length === 0) {
+            lines.push([...nonWrappingContent, ...wrappingPart]);
+        }
+        else {
+            if (noWrappingWidth > 0) {
+                lines.push([
+                    ...[{ text: ' '.repeat(noWrappingWidth), props: {} }],
+                    ...wrappingPart,
+                ]);
+            }
+            else {
+                lines.push(wrappingPart);
+            }
+        }
+        wrappingPart = [];
+        wrappingPartWidth = 0;
+    }
+    function addToWrappingPart(text, props) {
+        if (wrappingPart.length > 0 &&
+            wrappingPart[wrappingPart.length - 1].props === props) {
+            wrappingPart[wrappingPart.length - 1].text += text;
+        }
+        else {
+            wrappingPart.push({ text, props });
+        }
+    }
+    row.segments.forEach((segment) => {
+        const linesFromSegment = segment.text.split('\n');
+        linesFromSegment.forEach((lineText, lineIndex) => {
+            if (lineIndex > 0) {
+                addWrappingPartToLines();
+            }
+            const words = lineText.split(/(\s+)/); // Split by whitespace
+            words.forEach((word) => {
+                if (!word)
+                    return;
+                const wordWidth = stringWidth(word);
+                if (wrappingPartWidth + wordWidth > availableWidth &&
+                    wrappingPartWidth > 0) {
+                    addWrappingPartToLines();
+                    if (/^\s+$/.test(word)) {
+                        return;
+                    }
+                }
+                if (wordWidth > availableWidth) {
+                    // Word is too long, needs to be split across lines
+                    const wordAsCodePoints = toCodePoints(word);
+                    let remainingWordAsCodePoints = wordAsCodePoints;
+                    while (remainingWordAsCodePoints.length > 0) {
+                        let splitIndex = 0;
+                        let currentSplitWidth = 0;
+                        for (const char of remainingWordAsCodePoints) {
+                            const charWidth = stringWidth(char);
+                            if (wrappingPartWidth + currentSplitWidth + charWidth >
+                                availableWidth) {
+                                break;
+                            }
+                            currentSplitWidth += charWidth;
+                            splitIndex++;
+                        }
+                        if (splitIndex > 0) {
+                            const part = remainingWordAsCodePoints
+                                .slice(0, splitIndex)
+                                .join('');
+                            addToWrappingPart(part, segment.props);
+                            wrappingPartWidth += stringWidth(part);
+                            remainingWordAsCodePoints =
+                                remainingWordAsCodePoints.slice(splitIndex);
+                        }
+                        if (remainingWordAsCodePoints.length > 0) {
+                            addWrappingPartToLines();
+                        }
+                    }
+                }
+                else {
+                    addToWrappingPart(word, segment.props);
+                    wrappingPartWidth += wordWidth;
+                }
+            });
+        });
+        // Split omits a trailing newline, so we need to handle it here
+        if (segment.text.endsWith('\n')) {
+            addWrappingPartToLines();
+        }
+    });
+    if (wrappingPart.length > 0) {
+        addWrappingPartToLines();
+    }
+    for (const line of lines) {
+        output.push(line);
+    }
+}
+//# sourceMappingURL=MaxSizedBox.js.map

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

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

package/dist/src/ui/components/shared/MaxSizedBox.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/MaxSizedBox.test.js

@@ -0,0 +1,134 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from 'ink-testing-library';
+import { OverflowProvider } from '../../contexts/OverflowContext.js';
+import { MaxSizedBox, setMaxSizedBoxDebugging } from './MaxSizedBox.js';
+import { Box, Text } from 'ink';
+import { describe, it, expect } from 'vitest';
+describe('<MaxSizedBox />', () => {
+    // Make sure MaxSizedBox logs errors on invalid configurations.
+    // This is useful for debugging issues with the component.
+    // It should be set to false in production for perfornance and to avoid
+    // cluttering the console if there are ignoreable issues.
+    setMaxSizedBoxDebugging(true);
+    it('renders children without truncation when they fit', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 80, maxHeight: 10, children: _jsx(Box, { children: _jsx(Text, { children: "Hello, World!" }) }) }) }));
+        expect(lastFrame()).equals('Hello, World!');
+    });
+    it('hides lines when content exceeds maxHeight', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 2, children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 3" }) })] }) }));
+        expect(lastFrame()).equals(`... first 2 lines hidden ...
+Line 3`);
+    });
+    it('hides lines at the end when content exceeds maxHeight and overflowDirection is bottom', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 2, overflowDirection: "bottom", children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 3" }) })] }) }));
+        expect(lastFrame()).equals(`Line 1
+... last 2 lines hidden ...`);
+    });
+    it('wraps text that exceeds maxWidth', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 10, maxHeight: 5, children: _jsx(Box, { children: _jsx(Text, { wrap: "wrap", children: "This is a long line of text" }) }) }) }));
+        expect(lastFrame()).equals(`This is a
+long line
+of text`);
+    });
+    it('handles mixed wrapping and non-wrapping segments', () => {
+        const multilineText = `This part will wrap around.
+And has a line break.
+  Leading spaces preserved.`;
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 20, maxHeight: 20, children: [_jsx(Box, { children: _jsx(Text, { children: "Example" }) }), _jsxs(Box, { children: [_jsx(Text, { children: "No Wrap: " }), _jsx(Text, { wrap: "wrap", children: multilineText })] }), _jsxs(Box, { children: [_jsx(Text, { children: "Longer No Wrap: " }), _jsx(Text, { wrap: "wrap", children: "This part will wrap around." })] })] }) }));
+        expect(lastFrame()).equals(`Example
+No Wrap: This part
+         will wrap
+         around.
+         And has a
+         line break.
+           Leading
+         spaces
+         preserved.
+Longer No Wrap: This
+                part
+                will
+                wrap
+                arou
+                nd.`);
+    });
+    it('handles words longer than maxWidth by splitting them', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 5, maxHeight: 5, children: _jsx(Box, { children: _jsx(Text, { wrap: "wrap", children: "Supercalifragilisticexpialidocious" }) }) }) }));
+        expect(lastFrame()).equals(`... …
+istic
+expia
+lidoc
+ious`);
+    });
+    it('does not truncate when maxHeight is undefined', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: undefined, children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) })] }) }));
+        expect(lastFrame()).equals(`Line 1
+Line 2`);
+    });
+    it('shows plural "lines" when more than one line is hidden', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 2, children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 3" }) })] }) }));
+        expect(lastFrame()).equals(`... first 2 lines hidden ...
+Line 3`);
+    });
+    it('shows plural "lines" when more than one line is hidden and overflowDirection is bottom', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 2, overflowDirection: "bottom", children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 3" }) })] }) }));
+        expect(lastFrame()).equals(`Line 1
+... last 2 lines hidden ...`);
+    });
+    it('renders an empty box for empty children', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 80, maxHeight: 10 }) }));
+        // Expect an empty string or a box with nothing in it.
+        // Ink renders an empty box as an empty string.
+        expect(lastFrame()).equals('');
+    });
+    it('wraps text with multi-byte unicode characters correctly', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 5, maxHeight: 5, children: _jsx(Box, { children: _jsx(Text, { wrap: "wrap", children: "\u4F60\u597D\u4E16\u754C" }) }) }) }));
+        // "你好" has a visual width of 4. "世界" has a visual width of 4.
+        // With maxWidth=5, it should wrap after the second character.
+        expect(lastFrame()).equals(`你好
+世界`);
+    });
+    it('wraps text with multi-byte emoji characters correctly', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 5, maxHeight: 5, children: _jsx(Box, { children: _jsx(Text, { wrap: "wrap", children: "\uD83D\uDC36\uD83D\uDC36\uD83D\uDC36\uD83D\uDC36\uD83D\uDC36" }) }) }) }));
+        // Each "🐶" has a visual width of 2.
+        // With maxWidth=5, it should wrap every 2 emojis.
+        expect(lastFrame()).equals(`🐶🐶
+🐶🐶
+🐶`);
+    });
+    it('accounts for additionalHiddenLinesCount', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 2, additionalHiddenLinesCount: 5, children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 3" }) })] }) }));
+        // 1 line is hidden by overflow, 5 are additionally hidden.
+        expect(lastFrame()).equals(`... first 7 lines hidden ...
+Line 3`);
+    });
+    it('handles React.Fragment as a child', () => {
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsxs(MaxSizedBox, { maxWidth: 80, maxHeight: 10, children: [_jsxs(_Fragment, { children: [_jsx(Box, { children: _jsx(Text, { children: "Line 1 from Fragment" }) }), _jsx(Box, { children: _jsx(Text, { children: "Line 2 from Fragment" }) })] }), _jsx(Box, { children: _jsx(Text, { children: "Line 3 direct child" }) })] }) }));
+        expect(lastFrame()).equals(`Line 1 from Fragment
+Line 2 from Fragment
+Line 3 direct child`);
+    });
+    it('clips a long single text child from the top', () => {
+        const THIRTY_LINES = Array.from({ length: 30 }, (_, i) => `Line ${i + 1}`).join('\n');
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 80, maxHeight: 10, children: _jsx(Box, { children: _jsx(Text, { children: THIRTY_LINES }) }) }) }));
+        const expected = [
+            '... first 21 lines hidden ...',
+            ...Array.from({ length: 9 }, (_, i) => `Line ${22 + i}`),
+        ].join('\n');
+        expect(lastFrame()).equals(expected);
+    });
+    it('clips a long single text child from the bottom', () => {
+        const THIRTY_LINES = Array.from({ length: 30 }, (_, i) => `Line ${i + 1}`).join('\n');
+        const { lastFrame } = render(_jsx(OverflowProvider, { children: _jsx(MaxSizedBox, { maxWidth: 80, maxHeight: 10, overflowDirection: "bottom", children: _jsx(Box, { children: _jsx(Text, { children: THIRTY_LINES }) }) }) }));
+        const expected = [
+            ...Array.from({ length: 9 }, (_, i) => `Line ${i + 1}`),
+            '... last 21 lines hidden ...',
+        ].join('\n');
+        expect(lastFrame()).equals(expected);
+    });
+});
+//# sourceMappingURL=MaxSizedBox.test.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+/**
+ * Represents a single option for the RadioButtonSelect.
+ * Requires a label for display and a value to be returned on selection.
+ */
+export interface RadioSelectItem<T> {
+    label: string;
+    value: T;
+    disabled?: boolean;
+}
+/**
+ * Props for the RadioButtonSelect component.
+ * @template T The type of the value associated with each radio item.
+ */
+export interface RadioButtonSelectProps<T> {
+    /** An array of items to display as radio options. */
+    items: Array<RadioSelectItem<T> & {
+        themeNameDisplay?: string;
+        themeTypeDisplay?: string;
+    }>;
+    /** 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;
+}
+/**
+ * A specialized SelectInput component styled to look like radio buttons.
+ * It uses '◉' for selected and '○' for unselected items.
+ *
+ * @template T The type of the value associated with each radio item.
+ */
+export declare function RadioButtonSelect<T>({ items, initialIndex, onSelect, onHighlight, isFocused, }: RadioButtonSelectProps<T>): React.JSX.Element;

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

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, Box } from 'ink';
+import SelectInput from 'ink-select-input';
+import { Colors } from '../../colors.js';
+/**
+ * A specialized SelectInput component styled to look like radio buttons.
+ * It uses '◉' for selected and '○' for unselected items.
+ *
+ * @template T The type of the value associated with each radio item.
+ */
+export function RadioButtonSelect({ items, initialIndex, onSelect, onHighlight, isFocused, // This prop indicates if the current RadioButtonSelect group is focused
+ }) {
+    const handleSelect = (item) => {
+        onSelect(item.value);
+    };
+    const handleHighlight = (item) => {
+        if (onHighlight) {
+            onHighlight(item.value);
+        }
+    };
+    /**
+     * Custom indicator component displaying radio button style (◉/○).
+     * Color changes based on whether the item is selected and if its group is focused.
+     */
+    function DynamicRadioIndicator({ isSelected = false, }) {
+        return (_jsx(Box, { minWidth: 2, flexShrink: 0, children: _jsx(Text, { color: isSelected ? Colors.AccentGreen : Colors.Foreground, children: isSelected ? '●' : '○' }) }));
+    }
+    /**
+     * Custom item component for displaying the label.
+     * Color changes based on whether the item is selected and if its group is focused.
+     * Now also handles displaying theme type with custom color.
+     */
+    function CustomThemeItemComponent(props) {
+        const { isSelected = false, label } = props;
+        const itemWithThemeProps = props;
+        let textColor = Colors.Foreground;
+        if (isSelected) {
+            textColor = Colors.AccentGreen;
+        }
+        else if (itemWithThemeProps.disabled === true) {
+            textColor = Colors.Gray;
+        }
+        if (itemWithThemeProps.themeNameDisplay &&
+            itemWithThemeProps.themeTypeDisplay) {
+            return (_jsxs(Text, { color: textColor, wrap: "truncate", children: [itemWithThemeProps.themeNameDisplay, ' ', _jsx(Text, { color: Colors.Gray, children: itemWithThemeProps.themeTypeDisplay })] }));
+        }
+        return (_jsx(Text, { color: textColor, wrap: "truncate", children: label }));
+    }
+    initialIndex = initialIndex ?? 0;
+    return (_jsx(SelectInput, { indicatorComponent: DynamicRadioIndicator, itemComponent: CustomThemeItemComponent, items: items, initialIndex: initialIndex, onSelect: handleSelect, onHighlight: handleHighlight, isFocused: isFocused }));
+}
+//# sourceMappingURL=RadioButtonSelect.js.map