@trukhinyuri/gemini-pp 0.27.0-nightly.20260121.97aac696f

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

@@ -0,0 +1,134 @@
+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 { renderWithProviders } from '../../../test-utils/render.js';
+import { RadioButtonSelect, } from './RadioButtonSelect.js';
+import { BaseSelectionList, } from './BaseSelectionList.js';
+vi.mock('./BaseSelectionList.js', () => ({
+    BaseSelectionList: vi.fn(() => null),
+}));
+vi.mock('../../semantic-colors.js', () => ({
+    theme: {
+        text: { secondary: 'COLOR_SECONDARY' },
+    },
+}));
+const MockedBaseSelectionList = vi.mocked(BaseSelectionList);
+const extractRenderItem = () => {
+    const mockCalls = MockedBaseSelectionList.mock.calls;
+    if (mockCalls.length === 0) {
+        throw new Error('BaseSelectionList was not called. Ensure RadioButtonSelect is rendered before calling extractRenderItem.');
+    }
+    const props = mockCalls[0][0];
+    if (typeof props.renderItem !== 'function') {
+        throw new Error('renderItem prop was not found on BaseSelectionList call.');
+    }
+    return props.renderItem;
+};
+describe('RadioButtonSelect', () => {
+    const mockOnSelect = vi.fn();
+    const mockOnHighlight = vi.fn();
+    const ITEMS = [
+        { label: 'Option 1', value: 'one', key: 'one' },
+        { label: 'Option 2', value: 'two', key: 'two' },
+        { label: 'Option 3', value: 'three', disabled: true, key: 'three' },
+    ];
+    const renderComponent = (props = {}) => {
+        const defaultProps = {
+            items: ITEMS,
+            onSelect: mockOnSelect,
+            ...props,
+        };
+        return renderWithProviders(_jsx(RadioButtonSelect, { ...defaultProps }));
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('Prop forwarding to BaseSelectionList', () => {
+        it('should forward all props correctly when provided', () => {
+            const props = {
+                items: ITEMS,
+                initialIndex: 1,
+                onSelect: mockOnSelect,
+                onHighlight: mockOnHighlight,
+                isFocused: false,
+                showScrollArrows: true,
+                maxItemsToShow: 5,
+                showNumbers: false,
+            };
+            renderComponent(props);
+            expect(BaseSelectionList).toHaveBeenCalledTimes(1);
+            expect(BaseSelectionList).toHaveBeenCalledWith(expect.objectContaining({
+                ...props,
+                renderItem: expect.any(Function),
+            }), undefined);
+        });
+        it('should use default props if not provided', () => {
+            renderComponent({
+                items: ITEMS,
+                onSelect: mockOnSelect,
+            });
+            expect(BaseSelectionList).toHaveBeenCalledWith(expect.objectContaining({
+                initialIndex: 0,
+                isFocused: true,
+                showScrollArrows: false,
+                maxItemsToShow: 10,
+                showNumbers: true,
+            }), undefined);
+        });
+    });
+    describe('renderItem implementation', () => {
+        let renderItem;
+        const mockContext = {
+            isSelected: false,
+            titleColor: 'MOCK_TITLE_COLOR',
+            numberColor: 'MOCK_NUMBER_COLOR',
+        };
+        beforeEach(() => {
+            renderComponent();
+            renderItem = extractRenderItem();
+        });
+        it('should render the standard label display with correct color and truncation', () => {
+            const item = ITEMS[0];
+            const result = renderItem(item, mockContext);
+            expect(result?.props?.color).toBe(mockContext.titleColor);
+            expect(result?.props?.children).toBe('Option 1');
+            expect(result?.props?.wrap).toBe('truncate');
+        });
+        it('should render the special theme display when theme props are present', () => {
+            const themeItem = {
+                label: 'Theme A (Light)',
+                value: 'a-light',
+                themeNameDisplay: 'Theme A',
+                themeTypeDisplay: '(Light)',
+                key: 'a-light',
+            };
+            const result = renderItem(themeItem, mockContext);
+            expect(result?.props?.color).toBe(mockContext.titleColor);
+            expect(result?.props?.wrap).toBe('truncate');
+            const children = result?.props?.children;
+            if (!Array.isArray(children) || children.length < 3) {
+                throw new Error('Expected children to be an array with at least 3 elements for theme display');
+            }
+            expect(children[0]).toBe('Theme A');
+            expect(children[1]).toBe(' ');
+            const nestedTextElement = children[2];
+            expect(nestedTextElement?.props?.color).toBe('COLOR_SECONDARY');
+            expect(nestedTextElement?.props?.children).toBe('(Light)');
+        });
+        it('should fall back to standard display if only one theme prop is present', () => {
+            const partialThemeItem = {
+                label: 'Incomplete Theme',
+                value: 'incomplete',
+                themeNameDisplay: 'Only Name',
+                key: 'incomplete',
+            };
+            const result = renderItem(partialThemeItem, mockContext);
+            expect(result?.props?.children).toBe('Incomplete Theme');
+        });
+    });
+});
+//# sourceMappingURL=RadioButtonSelect.test.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import type { LoadableSettingScope } from '../../../config/settings.js';
+interface ScopeSelectorProps {
+    /** Callback function when a scope is selected */
+    onSelect: (scope: LoadableSettingScope) => void;
+    /** Callback function when a scope is highlighted */
+    onHighlight: (scope: LoadableSettingScope) => void;
+    /** Whether the component is focused */
+    isFocused: boolean;
+    /** The initial scope to select */
+    initialScope: LoadableSettingScope;
+}
+export declare function ScopeSelector({ onSelect, onHighlight, isFocused, initialScope, }: ScopeSelectorProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { getScopeItems } from '../../../utils/dialogScopeUtils.js';
+import { RadioButtonSelect } from './RadioButtonSelect.js';
+export function ScopeSelector({ onSelect, onHighlight, isFocused, initialScope, }) {
+    const scopeItems = getScopeItems().map((item) => ({
+        ...item,
+        key: item.value,
+    }));
+    const initialIndex = scopeItems.findIndex((item) => item.value === initialScope);
+    const safeInitialIndex = initialIndex >= 0 ? initialIndex : 0;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: isFocused, wrap: "truncate", children: [isFocused ? '> ' : '  ', "Apply To"] }), _jsx(RadioButtonSelect, { items: scopeItems, initialIndex: safeInitialIndex, onSelect: onSelect, onHighlight: onHighlight, isFocused: isFocused, showNumbers: isFocused })] }));
+}
+//# sourceMappingURL=ScopeSelector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeSelector.js","sourceRoot":"","sources":["../../../../../src/ui/components/shared/ScopeSelector.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAa3D,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,GACO;IACnB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChD,GAAG,IAAI;QACP,GAAG,EAAE,IAAI,CAAC,KAAK;KAChB,CAAC,CAAC,CAAC;IAEJ,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CACvC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,YAAY,CACtC,CAAC;IACF,MAAM,gBAAgB,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,MAAC,IAAI,IAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAC,UAAU,aACnC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,gBACnB,EACP,KAAC,iBAAiB,IAChB,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,GACtB,IACE,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React from 'react';
+interface ScrollableProps {
+    children?: React.ReactNode;
+    width?: number;
+    height?: number | string;
+    maxWidth?: number;
+    maxHeight?: number;
+    hasFocus: boolean;
+    scrollToBottom?: boolean;
+    flexGrow?: number;
+}
+export declare const Scrollable: React.FC<ScrollableProps>;
+export {};

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

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import React, { useState, useEffect, useRef, useLayoutEffect, useCallback, useMemo, } from 'react';
+import { Box, getInnerHeight, getScrollHeight } from 'ink';
+import { useKeypress } from '../../hooks/useKeypress.js';
+import { useScrollable } from '../../contexts/ScrollProvider.js';
+import { useAnimatedScrollbar } from '../../hooks/useAnimatedScrollbar.js';
+import { useBatchedScroll } from '../../hooks/useBatchedScroll.js';
+export const Scrollable = ({ children, width, height, maxWidth, maxHeight, hasFocus, scrollToBottom, flexGrow, }) => {
+    const [scrollTop, setScrollTop] = useState(0);
+    const ref = useRef(null);
+    const [size, setSize] = useState({
+        innerHeight: 0,
+        scrollHeight: 0,
+    });
+    const sizeRef = useRef(size);
+    useEffect(() => {
+        sizeRef.current = size;
+    }, [size]);
+    const childrenCountRef = useRef(0);
+    // This effect needs to run on every render to correctly measure the container
+    // and scroll to the bottom if new children are added. The if conditions
+    // prevent infinite loops.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useLayoutEffect(() => {
+        if (!ref.current) {
+            return;
+        }
+        const innerHeight = Math.round(getInnerHeight(ref.current));
+        const scrollHeight = Math.round(getScrollHeight(ref.current));
+        const isAtBottom = scrollTop >= size.scrollHeight - size.innerHeight - 1;
+        if (size.innerHeight !== innerHeight ||
+            size.scrollHeight !== scrollHeight) {
+            setSize({ innerHeight, scrollHeight });
+            if (isAtBottom) {
+                setScrollTop(Math.max(0, scrollHeight - innerHeight));
+            }
+        }
+        const childCountCurrent = React.Children.count(children);
+        if (scrollToBottom && childrenCountRef.current !== childCountCurrent) {
+            setScrollTop(Math.max(0, scrollHeight - innerHeight));
+        }
+        childrenCountRef.current = childCountCurrent;
+    });
+    const { getScrollTop, setPendingScrollTop } = useBatchedScroll(scrollTop);
+    const scrollBy = useCallback((delta) => {
+        const { scrollHeight, innerHeight } = sizeRef.current;
+        const current = getScrollTop();
+        const next = Math.min(Math.max(0, current + delta), Math.max(0, scrollHeight - innerHeight));
+        setPendingScrollTop(next);
+        setScrollTop(next);
+    }, [sizeRef, getScrollTop, setPendingScrollTop]);
+    const { scrollbarColor, flashScrollbar, scrollByWithAnimation } = useAnimatedScrollbar(hasFocus, scrollBy);
+    useKeypress((key) => {
+        if (key.shift) {
+            if (key.name === 'up') {
+                scrollByWithAnimation(-1);
+            }
+            if (key.name === 'down') {
+                scrollByWithAnimation(1);
+            }
+        }
+    }, { isActive: hasFocus });
+    const getScrollState = useCallback(() => ({
+        scrollTop: getScrollTop(),
+        scrollHeight: size.scrollHeight,
+        innerHeight: size.innerHeight,
+    }), [getScrollTop, size.scrollHeight, size.innerHeight]);
+    const hasFocusCallback = useCallback(() => hasFocus, [hasFocus]);
+    const scrollableEntry = useMemo(() => ({
+        ref: ref,
+        getScrollState,
+        scrollBy: scrollByWithAnimation,
+        hasFocus: hasFocusCallback,
+        flashScrollbar,
+    }), [getScrollState, scrollByWithAnimation, hasFocusCallback, flashScrollbar]);
+    useScrollable(scrollableEntry, hasFocus && ref.current !== null);
+    return (_jsx(Box, { ref: ref, maxHeight: maxHeight, width: width ?? maxWidth, height: height, flexDirection: "column", overflowY: "scroll", overflowX: "hidden", scrollTop: scrollTop, flexGrow: flexGrow, scrollbarThumbColor: scrollbarColor, children: _jsx(Box, { flexShrink: 0, paddingRight: 1, flexDirection: "column", children: children }) }));
+};
+//# sourceMappingURL=Scrollable.js.map

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

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

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

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { renderWithProviders } from '../../../test-utils/render.js';
+import { Scrollable } from './Scrollable.js';
+import { Text } from 'ink';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as ScrollProviderModule from '../../contexts/ScrollProvider.js';
+import { act } from 'react';
+vi.mock('ink', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        getInnerHeight: vi.fn(() => 5),
+        getScrollHeight: vi.fn(() => 10),
+        getBoundingBox: vi.fn(() => ({ x: 0, y: 0, width: 10, height: 5 })),
+    };
+});
+vi.mock('../../hooks/useAnimatedScrollbar.js', () => ({
+    useAnimatedScrollbar: (hasFocus, scrollBy) => ({
+        scrollbarColor: 'white',
+        flashScrollbar: vi.fn(),
+        scrollByWithAnimation: scrollBy,
+    }),
+}));
+describe('<Scrollable />', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('renders children', () => {
+        const { lastFrame } = renderWithProviders(_jsx(Scrollable, { hasFocus: false, height: 5, children: _jsx(Text, { children: "Hello World" }) }));
+        expect(lastFrame()).toContain('Hello World');
+    });
+    it('renders multiple children', () => {
+        const { lastFrame } = renderWithProviders(_jsxs(Scrollable, { hasFocus: false, height: 5, children: [_jsx(Text, { children: "Line 1" }), _jsx(Text, { children: "Line 2" }), _jsx(Text, { children: "Line 3" })] }));
+        expect(lastFrame()).toContain('Line 1');
+        expect(lastFrame()).toContain('Line 2');
+        expect(lastFrame()).toContain('Line 3');
+    });
+    it('matches snapshot', () => {
+        const { lastFrame } = renderWithProviders(_jsxs(Scrollable, { hasFocus: false, height: 5, children: [_jsx(Text, { children: "Line 1" }), _jsx(Text, { children: "Line 2" }), _jsx(Text, { children: "Line 3" })] }));
+        expect(lastFrame()).toMatchSnapshot();
+    });
+    it('updates scroll position correctly when scrollBy is called multiple times in the same tick', () => {
+        let capturedEntry;
+        vi.spyOn(ScrollProviderModule, 'useScrollable').mockImplementation((entry, isActive) => {
+            if (isActive) {
+                capturedEntry = entry;
+            }
+        });
+        renderWithProviders(_jsxs(Scrollable, { hasFocus: true, height: 5, children: [_jsx(Text, { children: "Line 1" }), _jsx(Text, { children: "Line 2" }), _jsx(Text, { children: "Line 3" }), _jsx(Text, { children: "Line 4" }), _jsx(Text, { children: "Line 5" }), _jsx(Text, { children: "Line 6" }), _jsx(Text, { children: "Line 7" }), _jsx(Text, { children: "Line 8" }), _jsx(Text, { children: "Line 9" }), _jsx(Text, { children: "Line 10" })] }));
+        expect(capturedEntry).toBeDefined();
+        if (!capturedEntry) {
+            throw new Error('capturedEntry is undefined');
+        }
+        // Initial state (starts at bottom because of auto-scroll logic)
+        expect(capturedEntry.getScrollState().scrollTop).toBe(5);
+        // Call scrollBy multiple times (upwards) in the same tick
+        act(() => {
+            capturedEntry.scrollBy(-1);
+            capturedEntry.scrollBy(-1);
+        });
+        // Should have moved up by 2
+        expect(capturedEntry.getScrollState().scrollTop).toBe(3);
+        act(() => {
+            capturedEntry.scrollBy(-2);
+        });
+        expect(capturedEntry.getScrollState().scrollTop).toBe(1);
+    });
+});
+//# sourceMappingURL=Scrollable.test.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import { type VirtualizedListRef } from './VirtualizedList.js';
+type VirtualizedListProps<T> = {
+    data: T[];
+    renderItem: (info: {
+        item: T;
+        index: number;
+    }) => React.ReactElement;
+    estimatedItemHeight: (index: number) => number;
+    keyExtractor: (item: T, index: number) => string;
+    initialScrollIndex?: number;
+    initialScrollOffsetInIndex?: number;
+};
+interface ScrollableListProps<T> extends VirtualizedListProps<T> {
+    hasFocus: boolean;
+}
+export type ScrollableListRef<T> = VirtualizedListRef<T>;
+declare const ScrollableListWithForwardRef: <T>(props: ScrollableListProps<T> & {
+    ref?: React.Ref<ScrollableListRef<T>>;
+}) => React.ReactElement;
+export { ScrollableListWithForwardRef as ScrollableList };

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

@@ -0,0 +1,152 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useRef, forwardRef, useImperativeHandle, useCallback, useMemo, useEffect, } from 'react';
+import { VirtualizedList, SCROLL_TO_ITEM_END, } from './VirtualizedList.js';
+import { useScrollable } from '../../contexts/ScrollProvider.js';
+import { Box } from 'ink';
+import { useAnimatedScrollbar } from '../../hooks/useAnimatedScrollbar.js';
+import { useKeypress } from '../../hooks/useKeypress.js';
+import { keyMatchers, Command } from '../../keyMatchers.js';
+const ANIMATION_FRAME_DURATION_MS = 33;
+function ScrollableList(props, ref) {
+    const { hasFocus } = props;
+    const virtualizedListRef = useRef(null);
+    const containerRef = useRef(null);
+    useImperativeHandle(ref, () => ({
+        scrollBy: (delta) => virtualizedListRef.current?.scrollBy(delta),
+        scrollTo: (offset) => virtualizedListRef.current?.scrollTo(offset),
+        scrollToEnd: () => virtualizedListRef.current?.scrollToEnd(),
+        scrollToIndex: (params) => virtualizedListRef.current?.scrollToIndex(params),
+        scrollToItem: (params) => virtualizedListRef.current?.scrollToItem(params),
+        getScrollIndex: () => virtualizedListRef.current?.getScrollIndex() ?? 0,
+        getScrollState: () => virtualizedListRef.current?.getScrollState() ?? {
+            scrollTop: 0,
+            scrollHeight: 0,
+            innerHeight: 0,
+        },
+    }), []);
+    const getScrollState = useCallback(() => virtualizedListRef.current?.getScrollState() ?? {
+        scrollTop: 0,
+        scrollHeight: 0,
+        innerHeight: 0,
+    }, []);
+    const scrollBy = useCallback((delta) => {
+        virtualizedListRef.current?.scrollBy(delta);
+    }, []);
+    const { scrollbarColor, flashScrollbar, scrollByWithAnimation } = useAnimatedScrollbar(hasFocus, scrollBy);
+    const smoothScrollState = useRef({ active: false, start: 0, from: 0, to: 0, duration: 0, timer: null });
+    const stopSmoothScroll = useCallback(() => {
+        if (smoothScrollState.current.timer) {
+            clearInterval(smoothScrollState.current.timer);
+            smoothScrollState.current.timer = null;
+        }
+        smoothScrollState.current.active = false;
+    }, []);
+    useEffect(() => stopSmoothScroll, [stopSmoothScroll]);
+    const smoothScrollTo = useCallback((targetScrollTop, duration = 200) => {
+        stopSmoothScroll();
+        const scrollState = virtualizedListRef.current?.getScrollState() ?? {
+            scrollTop: 0,
+            scrollHeight: 0,
+            innerHeight: 0,
+        };
+        const { scrollTop: startScrollTop, scrollHeight, innerHeight, } = scrollState;
+        const maxScrollTop = Math.max(0, scrollHeight - innerHeight);
+        let effectiveTarget = targetScrollTop;
+        if (targetScrollTop === SCROLL_TO_ITEM_END) {
+            effectiveTarget = maxScrollTop;
+        }
+        const clampedTarget = Math.max(0, Math.min(maxScrollTop, effectiveTarget));
+        if (duration === 0) {
+            if (targetScrollTop === SCROLL_TO_ITEM_END) {
+                virtualizedListRef.current?.scrollTo(SCROLL_TO_ITEM_END);
+            }
+            else {
+                virtualizedListRef.current?.scrollTo(Math.round(clampedTarget));
+            }
+            flashScrollbar();
+            return;
+        }
+        smoothScrollState.current = {
+            active: true,
+            start: Date.now(),
+            from: startScrollTop,
+            to: clampedTarget,
+            duration,
+            timer: setInterval(() => {
+                const now = Date.now();
+                const elapsed = now - smoothScrollState.current.start;
+                const progress = Math.min(elapsed / duration, 1);
+                // Ease-in-out
+                const t = progress;
+                const ease = t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+                const current = smoothScrollState.current.from +
+                    (smoothScrollState.current.to - smoothScrollState.current.from) *
+                        ease;
+                if (progress >= 1) {
+                    if (targetScrollTop === SCROLL_TO_ITEM_END) {
+                        virtualizedListRef.current?.scrollTo(SCROLL_TO_ITEM_END);
+                    }
+                    else {
+                        virtualizedListRef.current?.scrollTo(Math.round(current));
+                    }
+                    stopSmoothScroll();
+                    flashScrollbar();
+                }
+                else {
+                    virtualizedListRef.current?.scrollTo(Math.round(current));
+                }
+            }, ANIMATION_FRAME_DURATION_MS),
+        };
+    }, [stopSmoothScroll, flashScrollbar]);
+    useKeypress((key) => {
+        if (keyMatchers[Command.SCROLL_UP](key)) {
+            stopSmoothScroll();
+            scrollByWithAnimation(-1);
+        }
+        else if (keyMatchers[Command.SCROLL_DOWN](key)) {
+            stopSmoothScroll();
+            scrollByWithAnimation(1);
+        }
+        else if (keyMatchers[Command.PAGE_UP](key) ||
+            keyMatchers[Command.PAGE_DOWN](key)) {
+            const direction = keyMatchers[Command.PAGE_UP](key) ? -1 : 1;
+            const scrollState = getScrollState();
+            const current = smoothScrollState.current.active
+                ? smoothScrollState.current.to
+                : scrollState.scrollTop;
+            const innerHeight = scrollState.innerHeight;
+            smoothScrollTo(current + direction * innerHeight);
+        }
+        else if (keyMatchers[Command.SCROLL_HOME](key)) {
+            smoothScrollTo(0);
+        }
+        else if (keyMatchers[Command.SCROLL_END](key)) {
+            smoothScrollTo(SCROLL_TO_ITEM_END);
+        }
+    }, { isActive: hasFocus });
+    const hasFocusCallback = useCallback(() => hasFocus, [hasFocus]);
+    const scrollableEntry = useMemo(() => ({
+        ref: containerRef,
+        getScrollState,
+        scrollBy: scrollByWithAnimation,
+        scrollTo: smoothScrollTo,
+        hasFocus: hasFocusCallback,
+        flashScrollbar,
+    }), [
+        getScrollState,
+        hasFocusCallback,
+        flashScrollbar,
+        scrollByWithAnimation,
+        smoothScrollTo,
+    ]);
+    useScrollable(scrollableEntry, hasFocus);
+    return (_jsx(Box, { ref: containerRef, flexGrow: 1, flexDirection: "column", overflow: "hidden", children: _jsx(VirtualizedList, { ref: virtualizedListRef, ...props, scrollbarThumbColor: scrollbarColor }) }));
+}
+const ScrollableListWithForwardRef = forwardRef(ScrollableList);
+export { ScrollableListWithForwardRef as ScrollableList };
+//# sourceMappingURL=ScrollableList.js.map

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

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

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

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