import { type HTMLAttributes } from 'react';
import { type VariantProps } from 'class-variance-authority';
import { type LocaleChangeHandler } from '../locale-picker/locale-picker';
import { type AccessibilityPreference, type ResolvedTheme, type ThemePreference } from '../../hooks';
declare const wrapperVariants: (props?: ({
    align?: "end" | "start" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export interface HeaderSettingsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof wrapperVariants> {
    /** Anchor side for the dropdown. Defaults to `end` (matches LTR + RTL). */
    align?: 'start' | 'end';
    /**
     * Size of the cog trigger only. Forwards to the underlying
     * `IconButton`. Defaults to `md`. The real target always meets
     * `--min-target-size`, including on desktop.
     * Use `sm` when composing alongside other `<Button size="sm">`
     * actions in a header row — keeps the visual rhythm consistent.
     *
     * The menu itself (language, appearance and accessible-mode rows)
     * stays at kit defaults regardless — this prop only sizes the
     * trigger.
     */
    size?: 'sm' | 'md' | 'lg';
    /** Disable the trigger entirely. */
    disabled?: boolean;
    /**
     * With no saved choice, start from the page's HTML lang before falling back
     * to the browser. Defaults to false. The first locale surface's mount effect
     * decides for the app lifecycle; pass the same option to LocalePicker.
     */
    initialLocaleFromHtmlLang?: boolean;
    /**
     * The page's HTML lang decides the starting locale, ahead of a saved
     * choice. For sites with one address per language, where the address
     * decides. Defaults to false. Pass the same option to LocalePicker.
     */
    followHtmlLang?: boolean;
    /**
     * Called after a language picked in the menu (or set through the agent
     * handle) has been applied and changed the language. Not called for the
     * starting locale. A site with one address per language navigates to
     * `resolved` here.
     */
    onLocaleChange?: LocaleChangeHandler;
}
export interface HeaderSettingsHandle {
    /**
     * Switch the active locale. Widened to `string` (vs. `Locale`) so
     * agent surfaces with untyped inputs can call through without
     * extra casting — invalid tags no-op silently.
     */
    setLocale: (next: string) => void;
    setTheme: (next: ThemePreference) => void;
    setAccessibility: (next: AccessibilityPreference) => void;
    /** Active IETF language tag, as i18next resolved it. */
    getLocale: () => string;
    /** Stored base-theme preference (`'system'` when no override is set). */
    getTheme: () => ThemePreference;
    /** Stored AAA-contrast preference (`'system'` when no override is set). */
    getAccessibility: () => AccessibilityPreference;
    /**
     * The theme actually painted once preference + OS signals resolve.
     * `theme: 'system'` and `theme: 'light'` both render `.theme-light`,
     * so this is what makes a `setTheme('system')` write verifiable.
     */
    getResolvedTheme: () => ResolvedTheme;
}
export declare const HeaderSettings: import("react").ForwardRefExoticComponent<HeaderSettingsProps & import("react").RefAttributes<HTMLDivElement>>;
export {};
//# sourceMappingURL=header-settings.d.ts.map