@quantum-ai/gemini-cli 0.45.8 → 0.45.9

package/dist/test-utils/render.js

@@ -0,0 +1,606 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render as inkRenderDirect } from 'ink';
+;
+import { EventEmitter } from 'node:events';
+import { Box } from 'ink';
+;
+import { Terminal } from '@xterm/headless';
+import { vi } from 'vitest';
+import stripAnsi from 'strip-ansi';
+import { act, useState } from 'react';
+import { KeypressProvider } from '../ui/contexts/KeypressContext.js';
+import { SettingsContext } from '../ui/contexts/SettingsContext.js';
+import { ShellFocusContext } from '../ui/contexts/ShellFocusContext.js';
+import { UIStateContext } from '../ui/contexts/UIStateContext.js';
+import { ConfigContext } from '../ui/contexts/ConfigContext.js';
+import { VimModeProvider } from '../ui/contexts/VimModeContext.js';
+import { MouseProvider } from '../ui/contexts/MouseContext.js';
+import { ScrollProvider } from '../ui/contexts/ScrollProvider.js';
+import { StreamingContext } from '../ui/contexts/StreamingContext.js';
+import { UIActionsContext, } from '../ui/contexts/UIActionsContext.js';
+import { StreamingState } from '../ui/types.js';
+import { ToolActionsProvider } from '../ui/contexts/ToolActionsContext.js';
+import { AskUserActionsProvider } from '../ui/contexts/AskUserActionsContext.js';
+import { TerminalProvider } from '../ui/contexts/TerminalContext.js';
+import { OverflowProvider, useOverflowActions, useOverflowState, } from '../ui/contexts/OverflowContext.js';
+import { makeFakeConfig } from '@google/gemini-cli-core';
+import { FakePersistentState } from './persistentStateFake.js';
+import { AppContext } from '../ui/contexts/AppContext.js';
+import { createMockSettings } from './settings.js';
+import { SessionStatsProvider } from '../ui/contexts/SessionContext.js';
+import { themeManager, DEFAULT_THEME } from '../ui/themes/theme-manager.js';
+import { DefaultLight } from '../ui/themes/builtin/light/default-light.js';
+import { pickDefaultThemeName } from '../ui/themes/theme.js';
+import { generateSvgForTerminal } from './svg.js';
+export const persistentStateMock = new FakePersistentState();
+if (process.env['NODE_ENV'] === 'test') {
+    // We mock NODE_ENV to development during tests that use render.tsx
+    // so that animations (which check process.env.NODE_ENV !== 'test')
+    // are actually tested. We mutate process.env directly here because
+    // vi.stubEnv() is cleared by vi.unstubAllEnvs() in test-setup.ts
+    // after each test.
+    process.env['NODE_ENV'] = 'development';
+}
+vi.mock('../utils/persistentState.js', () => ({
+    get persistentState() {
+        return persistentStateMock;
+    },
+}));
+vi.mock('../ui/utils/terminalUtils.js', () => ({
+    isLowColorDepth: vi.fn(() => false),
+    getColorDepth: vi.fn(() => 24),
+    isITerm2: vi.fn(() => false),
+}));
+function isInkRenderMetrics(metrics) {
+    const m = metrics;
+    return (typeof m === 'object' &&
+        m !== null &&
+        'output' in m &&
+        // eslint-disable-next-line no-restricted-syntax
+        typeof m['output'] === 'string');
+}
+class XtermStdout extends EventEmitter {
+    state;
+    pendingWrites = 0;
+    renderCount = 0;
+    queue;
+    isTTY = true;
+    getColorDepth() {
+        return 24;
+    }
+    lastRenderOutput = undefined;
+    lastRenderStaticContent = undefined;
+    constructor(state, queue) {
+        super();
+        this.state = state;
+        this.queue = queue;
+    }
+    get columns() {
+        return this.state.terminal.cols;
+    }
+    get rows() {
+        return this.state.terminal.rows;
+    }
+    get frames() {
+        return [];
+    }
+    write = (data) => {
+        this.pendingWrites++;
+        this.queue.promise = this.queue.promise.then(async () => {
+            await new Promise((resolve) => this.state.terminal.write(data, resolve));
+            this.pendingWrites--;
+        });
+    };
+    clear = () => {
+        this.state.terminal.reset();
+        this.lastRenderOutput = undefined;
+        this.lastRenderStaticContent = undefined;
+    };
+    dispose = () => {
+        this.state.terminal.dispose();
+    };
+    onRender = (staticContent, output) => {
+        this.renderCount++;
+        this.lastRenderStaticContent = staticContent;
+        this.lastRenderOutput = output;
+        this.emit('render');
+    };
+    normalizeFrame = (text) => text.replace(/\r\n/g, '\n');
+    generateSvg = () => generateSvgForTerminal(this.state.terminal);
+    lastFrameRaw = (options = {}) => {
+        const result = (this.lastRenderStaticContent ?? '') + (this.lastRenderOutput ?? '');
+        const normalized = this.normalizeFrame(result);
+        if (normalized === '' && !options.allowEmpty) {
+            throw new Error('lastFrameRaw() returned an empty string. If this is intentional, use lastFrameRaw({ allowEmpty: true }). ' +
+                'Otherwise, ensure you are calling await waitUntilReady() and that the component is rendering correctly.');
+        }
+        return normalized;
+    };
+    lastFrame = (options = {}) => {
+        const buffer = this.state.terminal.buffer.active;
+        const allLines = [];
+        for (let i = 0; i < buffer.length; i++) {
+            allLines.push(buffer.getLine(i)?.translateToString(true) ?? '');
+        }
+        const trimmed = [...allLines];
+        while (trimmed.length > 0 && trimmed[trimmed.length - 1] === '') {
+            trimmed.pop();
+        }
+        const result = trimmed.join('\n');
+        const normalized = this.normalizeFrame(result);
+        if (normalized === '' && !options.allowEmpty) {
+            throw new Error('lastFrame() returned an empty string. If this is intentional, use lastFrame({ allowEmpty: true }). ' +
+                'Otherwise, ensure you are calling await waitUntilReady() and that the component is rendering correctly.');
+        }
+        return normalized === '' ? normalized : normalized + '\n';
+    };
+    async waitUntilReady() {
+        const startRenderCount = this.renderCount;
+        if (!vi.isFakeTimers()) {
+            // Give Ink a chance to start its rendering loop
+            await new Promise((resolve) => setImmediate(resolve));
+        }
+        await act(async () => {
+            if (vi.isFakeTimers()) {
+                await vi.advanceTimersByTimeAsync(50);
+            }
+            else {
+                // Wait for at least one render to be called if we haven't rendered yet or since start of this call,
+                // but don't wait forever as some renders might be synchronous or skipped.
+                if (this.renderCount === startRenderCount) {
+                    const renderPromise = new Promise((resolve) => this.once('render', resolve));
+                    const timeoutPromise = new Promise((resolve) => setTimeout(resolve, 1000));
+                    await Promise.race([renderPromise, timeoutPromise]);
+                }
+            }
+        });
+        let attempts = 0;
+        const maxAttempts = 50;
+        let lastCurrent = '';
+        let lastExpected = '';
+        while (attempts < maxAttempts) {
+            // Ensure all pending writes to the terminal are processed.
+            await this.queue.promise;
+            const currentFrame = stripAnsi(this.lastFrame({ allowEmpty: true })).trim();
+            const expectedFrame = this.normalizeFrame(stripAnsi((this.lastRenderStaticContent ?? '') + (this.lastRenderOutput ?? ''))).trim();
+            lastCurrent = currentFrame;
+            lastExpected = expectedFrame;
+            const isMatch = () => {
+                if (expectedFrame === '...') {
+                    // '...' is our fallback when output isn't in metrics, meaning Ink rendered *something*
+                    // but we don't know what it is. If terminal has content, we consider it a match.
+                    // However, if the component rendered null, both would be empty, but our fallback
+                    // made expectedFrame '...'. In that case, we can't easily know if it's ready,
+                    // but we can assume if there are no pending writes, it's ready.
+                    return currentFrame !== '' || this.pendingWrites === 0;
+                }
+                // If Ink expects nothing (no new static content and no dynamic output),
+                // we consider it a match because the terminal buffer will just hold the historical static content.
+                if (expectedFrame === '') {
+                    return true;
+                }
+                if (this.lastRenderOutput === undefined) {
+                    return false;
+                }
+                // If the terminal is empty but Ink expects something, it's not a match.
+                if (currentFrame === '') {
+                    return false;
+                }
+                // Check if the current frame contains the expected content.
+                // We use includes because xterm might have some formatting or
+                // extra whitespace that Ink doesn't account for in its raw output metrics.
+                return currentFrame.includes(expectedFrame);
+            };
+            if (this.pendingWrites === 0 && isMatch()) {
+                return;
+            }
+            attempts++;
+            await act(async () => {
+                if (vi.isFakeTimers()) {
+                    await vi.advanceTimersByTimeAsync(10);
+                }
+                else {
+                    await new Promise((resolve) => setTimeout(resolve, 10));
+                }
+            });
+        }
+        throw new Error(`waitUntilReady() timed out after ${maxAttempts} attempts.\n` +
+            `Expected content (stripped ANSI):\n"${lastExpected}"\n` +
+            `Actual content (stripped ANSI):\n"${lastCurrent}"\n` +
+            `Pending writes: ${this.pendingWrites}\n` +
+            `Render count: ${this.renderCount}`);
+    }
+}
+class XtermStderr extends EventEmitter {
+    state;
+    pendingWrites = 0;
+    queue;
+    isTTY = true;
+    constructor(state, queue) {
+        super();
+        this.state = state;
+        this.queue = queue;
+    }
+    write = (data) => {
+        this.pendingWrites++;
+        this.queue.promise = this.queue.promise.then(async () => {
+            await new Promise((resolve) => this.state.terminal.write(data, resolve));
+            this.pendingWrites--;
+        });
+    };
+    dispose = () => {
+        this.state.terminal.dispose();
+    };
+    lastFrame = () => '';
+}
+class XtermStdin extends EventEmitter {
+    isTTY = true;
+    data = null;
+    constructor(options = {}) {
+        super();
+        this.isTTY = options.isTTY ?? true;
+    }
+    write = (data) => {
+        this.data = data;
+        this.emit('readable');
+        this.emit('data', data);
+    };
+    setEncoding() { }
+    setRawMode() { }
+    resume() { }
+    pause() { }
+    ref() { }
+    unref() { }
+    read = () => {
+        const { data } = this;
+        this.data = null;
+        return data;
+    };
+}
+const instances = [];
+export const render = async (tree, terminalWidth) => {
+    const cols = terminalWidth ?? 100;
+    // We use 1000 rows to avoid windows with incorrect snapshots if a correct
+    // value was used (e.g. 40 rows). The alternatives to make things worse are
+    // windows unfortunately with odd duplicate content in the backbuffer
+    // which does not match actual behavior in xterm.js on windows.
+    const rows = 1000;
+    const terminal = new Terminal({
+        cols,
+        rows,
+        allowProposedApi: true,
+        convertEol: true,
+    });
+    const state = {
+        terminal,
+        cols,
+        rows,
+    };
+    const writeQueue = { promise: Promise.resolve() };
+    const stdout = new XtermStdout(state, writeQueue);
+    const stderr = new XtermStderr(state, writeQueue);
+    const stdin = new XtermStdin();
+    let instance;
+    stdout.clear();
+    act(() => {
+        instance = inkRenderDirect(tree, {
+            stdout: stdout,
+            stderr: stderr,
+            stdin: stdin,
+            debug: false,
+            exitOnCtrlC: false,
+            patchConsole: false,
+            onRender: (metrics) => {
+                const output = isInkRenderMetrics(metrics) ? metrics.output : '...';
+                const staticOutput = isInkRenderMetrics(metrics)
+                    ? (metrics.staticOutput ?? '')
+                    : '';
+                stdout.onRender(staticOutput, output);
+            },
+        });
+    });
+    instances.push(instance);
+    await stdout.waitUntilReady();
+    return {
+        rerender: (newTree) => {
+            act(() => {
+                stdout.clear();
+                instance.rerender(newTree);
+            });
+        },
+        unmount: () => {
+            act(() => {
+                instance.unmount();
+            });
+            stdout.dispose();
+            stderr.dispose();
+        },
+        cleanup: instance.cleanup,
+        stdout,
+        stderr,
+        stdin,
+        frames: stdout.frames,
+        lastFrame: stdout.lastFrame,
+        lastFrameRaw: stdout.lastFrameRaw,
+        generateSvg: stdout.generateSvg,
+        terminal: state.terminal,
+        waitUntilReady: () => stdout.waitUntilReady(),
+    };
+};
+export const cleanup = () => {
+    for (const instance of instances) {
+        act(() => {
+            instance.unmount();
+        });
+        instance.cleanup();
+    }
+    instances.length = 0;
+};
+export const simulateClick = async (stdin, col, row, button = 0) => {
+    // Terminal mouse events are 1-based, so convert if necessary.
+    const mouseEventString = `\x1b[<${button};${col};${row}M`;
+    await act(async () => {
+        stdin.write(mouseEventString);
+    });
+};
+export const mockSettings = createMockSettings();
+// A minimal mock UIState to satisfy the context provider.
+// Tests that need specific UIState values should provide their own.
+const baseMockUiState = {
+    history: [],
+    renderMarkdown: true,
+    streamingState: StreamingState.Idle,
+    isConfigInitialized: true,
+    isAuthenticating: false,
+    terminalWidth: 100,
+    terminalHeight: 40,
+    currentModel: 'gemini-pro',
+    terminalBackgroundColor: 'black',
+    cleanUiDetailsVisible: false,
+    allowPlanMode: true,
+    activePtyId: undefined,
+    backgroundTasks: new Map(),
+    backgroundTaskHeight: 0,
+    quota: {
+        userTier: undefined,
+        stats: undefined,
+        proQuotaRequest: null,
+        validationRequest: null,
+    },
+    hintMode: false,
+    hintBuffer: '',
+    bannerData: {
+        defaultText: '',
+        warningText: '',
+    },
+    bannerVisible: false,
+    nightly: false,
+    updateInfo: null,
+    pendingHistoryItems: [],
+    mainControlsRef: () => { },
+    rootUiRef: { current: null },
+};
+export const mockAppState = {
+    version: '1.2.3',
+    startupWarnings: [],
+};
+const mockUIActions = {
+    handleThemeSelect: vi.fn(),
+    closeThemeDialog: vi.fn(),
+    handleThemeHighlight: vi.fn(),
+    handleAuthSelect: vi.fn(),
+    setAuthState: vi.fn(),
+    onAuthError: vi.fn(),
+    handleEditorSelect: vi.fn(),
+    exitEditorDialog: vi.fn(),
+    exitPrivacyNotice: vi.fn(),
+    closeSettingsDialog: vi.fn(),
+    closeModelDialog: vi.fn(),
+    openVoiceModelDialog: vi.fn(),
+    closeVoiceModelDialog: vi.fn(),
+    openAgentConfigDialog: vi.fn(),
+    closeAgentConfigDialog: vi.fn(),
+    openPermissionsDialog: vi.fn(),
+    openSessionBrowser: vi.fn(),
+    closeSessionBrowser: vi.fn(),
+    handleResumeSession: vi.fn(),
+    handleDeleteSession: vi.fn(),
+    closePermissionsDialog: vi.fn(),
+    setShellModeActive: vi.fn(),
+    vimHandleInput: vi.fn(),
+    handleIdePromptComplete: vi.fn(),
+    handleFolderTrustSelect: vi.fn(),
+    setIsPolicyUpdateDialogOpen: vi.fn(),
+    setConstrainHeight: vi.fn(),
+    onEscapePromptChange: vi.fn(),
+    refreshStatic: vi.fn(),
+    handleFinalSubmit: vi.fn(),
+    handleClearScreen: vi.fn(),
+    handleProQuotaChoice: vi.fn(),
+    handleValidationChoice: vi.fn(),
+    handleOverageMenuChoice: vi.fn(),
+    handleEmptyWalletChoice: vi.fn(),
+    setQueueErrorMessage: vi.fn(),
+    addMessage: vi.fn(),
+    popAllMessages: vi.fn(),
+    handleApiKeySubmit: vi.fn(),
+    handleApiKeyCancel: vi.fn(),
+    setBannerVisible: vi.fn(),
+    setShortcutsHelpVisible: vi.fn(),
+    setCleanUiDetailsVisible: vi.fn(),
+    toggleCleanUiDetailsVisible: vi.fn(),
+    revealCleanUiDetailsTemporarily: vi.fn(),
+    handleWarning: vi.fn(),
+    setEmbeddedShellFocused: vi.fn(),
+    dismissBackgroundTask: vi.fn(),
+    setActiveBackgroundTaskPid: vi.fn(),
+    setIsBackgroundTaskListOpen: vi.fn(),
+    setAuthContext: vi.fn(),
+    dismissLoginRestart: vi.fn(),
+    onHintInput: vi.fn(),
+    onHintBackspace: vi.fn(),
+    onHintClear: vi.fn(),
+    onHintSubmit: vi.fn(),
+    handleRestart: vi.fn(),
+    handleNewAgentsSelect: vi.fn(),
+    getPreferredEditor: vi.fn(),
+    clearAccountSuspension: vi.fn(),
+    setVoiceModeEnabled: vi.fn(),
+};
+import { InputContext } from '../ui/contexts/InputContext.js';
+import { QuotaContext } from '../ui/contexts/QuotaContext.js';
+let capturedOverflowState;
+let capturedOverflowActions;
+const ContextCapture = ({ children, }) => {
+    capturedOverflowState = useOverflowState();
+    capturedOverflowActions = useOverflowActions();
+    return _jsx(_Fragment, { children: children });
+};
+export const renderWithProviders = async (component, { shellFocus = true, settings = mockSettings, uiState: providedUiState, quotaState: providedQuotaState, inputState: providedInputState, width, mouseEventsEnabled = false, config, uiActions, toolActions, persistentState, appState = mockAppState, } = {}) => {
+    const baseState = new Proxy({ ...baseMockUiState, ...providedUiState }, {
+        get(target, prop) {
+            if (prop in target) {
+                return target[prop];
+            }
+            // For properties not in the base mock or provided state,
+            // we'll check the original proxy to see if it's a defined but
+            // unprovided property, and if not, throw.
+            if (prop in baseMockUiState) {
+                return baseMockUiState[prop];
+            }
+            throw new Error(`mockUiState does not have property ${String(prop)}`);
+        },
+    });
+    const quotaState = {
+        userTier: undefined,
+        stats: undefined,
+        proQuotaRequest: null,
+        validationRequest: null,
+        overageMenuRequest: null,
+        emptyWalletRequest: null,
+        ...providedQuotaState,
+    };
+    const inputState = {
+        buffer: { text: '' },
+        userMessages: [],
+        shellModeActive: false,
+        showEscapePrompt: false,
+        copyModeEnabled: false,
+        inputWidth: 80,
+        suggestionsWidth: 40,
+        ...providedUiState,
+        ...providedInputState,
+    };
+    if (persistentState?.get) {
+        persistentStateMock.get.mockImplementation(persistentState.get);
+    }
+    if (persistentState?.set) {
+        persistentStateMock.set.mockImplementation(persistentState.set);
+    }
+    persistentStateMock.mockClear();
+    const terminalWidth = width ?? baseState.terminalWidth;
+    const finalConfig = config ||
+        makeFakeConfig({
+            useAlternateBuffer: settings.merged.ui?.useAlternateBuffer,
+            showMemoryUsage: settings.merged.ui?.showMemoryUsage,
+            accessibility: settings.merged.ui?.accessibility,
+        });
+    const mainAreaWidth = providedUiState?.mainAreaWidth ?? terminalWidth;
+    const finalUiState = {
+        ...baseState,
+        terminalWidth,
+        mainAreaWidth,
+    };
+    themeManager.setTerminalBackground(baseState.terminalBackgroundColor);
+    const themeName = pickDefaultThemeName(baseState.terminalBackgroundColor, themeManager.getAllThemes(), DEFAULT_THEME.name, DefaultLight.name);
+    themeManager.setActiveTheme(themeName);
+    const finalUIActions = { ...mockUIActions, ...uiActions };
+    const allToolCalls = (finalUiState.pendingHistoryItems || [])
+        .filter((item) => item.type === 'tool_group')
+        .flatMap((item) => item.tools);
+    capturedOverflowState = undefined;
+    capturedOverflowActions = undefined;
+    const wrapWithProviders = (comp) => (_jsx(AppContext.Provider, { value: appState, children: _jsx(ConfigContext.Provider, { value: finalConfig, children: _jsx(SettingsContext.Provider, { value: settings, children: _jsx(QuotaContext.Provider, { value: quotaState, children: _jsx(InputContext.Provider, { value: inputState, children: _jsx(UIStateContext.Provider, { value: finalUiState, children: _jsx(VimModeProvider, { children: _jsx(ShellFocusContext.Provider, { value: shellFocus, children: _jsx(SessionStatsProvider, { sessionId: finalConfig.getSessionId(), children: _jsx(StreamingContext.Provider, { value: finalUiState.streamingState, children: _jsx(UIActionsContext.Provider, { value: finalUIActions, children: _jsx(OverflowProvider, { children: _jsx(ToolActionsProvider, { config: finalConfig, toolCalls: allToolCalls, isExpanded: toolActions?.isExpanded ??
+                                                            vi.fn().mockReturnValue(false), toggleExpansion: toolActions?.toggleExpansion ?? vi.fn(), toggleAllExpansion: toolActions?.toggleAllExpansion ?? vi.fn(), children: _jsx(AskUserActionsProvider, { request: null, onSubmit: vi.fn(), onCancel: vi.fn(), children: _jsx(KeypressProvider, { children: _jsx(MouseProvider, { mouseEventsEnabled: mouseEventsEnabled, children: _jsx(TerminalProvider, { children: _jsx(ScrollProvider, { children: _jsx(ContextCapture, { children: _jsx(Box, { width: terminalWidth, flexShrink: 0, flexGrow: 0, flexDirection: "column", children: comp }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) }));
+    const renderResult = await render(wrapWithProviders(component), terminalWidth);
+    return {
+        ...renderResult,
+        rerender: (newComponent) => {
+            renderResult.rerender(wrapWithProviders(newComponent));
+        },
+        capturedOverflowState,
+        capturedOverflowActions,
+        simulateClick: (col, row, button) => simulateClick(renderResult.stdin, col, row, button),
+    };
+};
+export async function renderHook(renderCallback, options) {
+    const result = { current: undefined };
+    let currentProps = options?.initialProps;
+    function TestComponent({ renderCallback, props, }) {
+        result.current = renderCallback(props);
+        return null;
+    }
+    const Wrapper = options?.wrapper || (({ children }) => _jsx(_Fragment, { children: children }));
+    let inkRerender = () => { };
+    let unmount = () => { };
+    let waitUntilReady = async () => { };
+    let generateSvg = () => '';
+    const renderResult = await render(_jsx(Wrapper, { children: _jsx(TestComponent, { renderCallback: renderCallback, props: currentProps }) }));
+    inkRerender = renderResult.rerender;
+    unmount = renderResult.unmount;
+    waitUntilReady = renderResult.waitUntilReady;
+    generateSvg = renderResult.generateSvg;
+    function rerender(props) {
+        if (arguments.length > 0) {
+            currentProps = props;
+        }
+        act(() => {
+            inkRerender(_jsx(Wrapper, { children: _jsx(TestComponent, { renderCallback: renderCallback, props: currentProps }) }));
+        });
+    }
+    return { result, rerender, unmount, waitUntilReady, generateSvg };
+}
+export async function renderHookWithProviders(renderCallback, options = {}) {
+    const result = { current: undefined };
+    let setPropsFn;
+    let forceUpdateFn;
+    function TestComponent({ initialProps }) {
+        const [props, setProps] = useState(initialProps);
+        const [, forceUpdate] = useState(0);
+        setPropsFn = setProps;
+        forceUpdateFn = () => forceUpdate((n) => n + 1);
+        result.current = renderCallback(props);
+        return null;
+    }
+    const Wrapper = options.wrapper || (({ children }) => _jsx(_Fragment, { children: children }));
+    let renderResult;
+    await act(async () => {
+        renderResult = await renderWithProviders(_jsx(Wrapper, { children: _jsx(TestComponent, { initialProps: options.initialProps }) }), options);
+    });
+    function rerender(newProps) {
+        act(() => {
+            if (arguments.length > 0 && setPropsFn) {
+                setPropsFn(newProps);
+            }
+            else if (forceUpdateFn) {
+                forceUpdateFn();
+            }
+        });
+    }
+    return {
+        result,
+        rerender,
+        unmount: () => {
+            act(() => {
+                renderResult.unmount();
+            });
+        },
+        waitUntilReady: () => renderResult.waitUntilReady(),
+        generateSvg: () => renderResult.generateSvg(),
+    };
+}

package/dist/test-utils/settings.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { LoadedSettings, createTestMergedSettings, } from '../config/settings.js';
+/**
+ * Creates a mock LoadedSettings object for testing.
+ *
+ * @param overrides - Partial settings or LoadedSettings properties to override.
+ *                   If 'merged' is provided, it overrides the computed merged settings.
+ *                   Any functions in overrides are assigned directly to the LoadedSettings instance.
+ */
+export const createMockSettings = (overrides = {}) => {
+    const { system, systemDefaults, user, workspace, isTrusted, errors, merged: mergedOverride, ...settingsOverrides } = overrides;
+    const loaded = new LoadedSettings(system || { path: '', settings: {}, originalSettings: {} }, systemDefaults || { path: '', settings: {}, originalSettings: {} }, user || {
+        path: '',
+        settings: settingsOverrides,
+        originalSettings: settingsOverrides,
+    }, workspace || { path: '', settings: {}, originalSettings: {} }, isTrusted ?? true, errors || []);
+    if (mergedOverride) {
+        // @ts-expect-error - overriding private field for testing
+        loaded._merged = createTestMergedSettings(mergedOverride);
+    }
+    // Assign any function overrides (e.g., vi.fn() for methods)
+    for (const key in overrides) {
+        if (typeof overrides[key] === 'function') {
+            loaded[key] = overrides[key];
+        }
+    }
+    return loaded;
+};