export type TuiThemeId = 'auto' | 'dark' | 'light' | (string & {});
export type DoubleEscapeAction = 'none' | 'tree' | 'fork';
export type TreeFilterMode = 'default' | 'no-tools' | 'user-only' | 'labeled-only' | 'all';
export interface TuiSettings {
    /** `auto` follows terminal background detection; `dark`/`light` or custom theme name. */
    theme: TuiThemeId;
    showThinking: boolean;
    toolsExpanded: boolean;
    doubleEscapeAction: DoubleEscapeAction;
    showTerminalProgress: boolean;
    /** Show expanded startup hints under the header title. */
    showStartupHints: boolean;
    /** Render image content blocks inline when the terminal supports images. */
    showImages: boolean;
    /** Preferred inline image width in terminal cells. */
    imageWidthCells: number;
    /** Show the terminal hardware cursor at the editor cursor for IME support. */
    showHardwareCursor: boolean;
    /** Horizontal padding for the input editor. */
    editorPaddingX: number;
    /** Maximum visible autocomplete rows before the completion menu scrolls. */
    autocompleteMaxVisible: number;
    /** Clear empty terminal rows when rendered content shrinks. */
    clearOnShrink: boolean;
    /** Default transcript filter when opening `/tree`. */
    treeFilterMode: TreeFilterMode;
}
export declare const DEFAULT_TUI_SETTINGS: TuiSettings;
/** Load persisted TUI settings from `~/.xopc/tui-settings.json`. */
export declare function loadTuiSettings(): TuiSettings;
/** Persist TUI settings. */
export declare function saveTuiSettings(settings: TuiSettings): void;
export declare function getTuiSettingsPath(): string;