GrConfigProvider

type GrComponentSize = typeof GR_COMPONENT_SIZES[number];

type GrConfigurableComponent = keyof GrComponentDefaultsRegistry;

type GrComponentDefaults = {
    [TComponent in GrConfigurableComponent]?: Partial<GrComponentDefaultsRegistry[TComponent]>;
};

interface GrConfigContext {
    /** Дефолтный размер контролов (если проп `size` не задан на компоненте). */
    size: ComputedRef<GrComponentSize | undefined>;
    /** Дефолтные пропсы по компонентам. */
    componentDefaults: ComputedRef<GrComponentDefaults>;
    /**
     * Тема поддерева (`data-theme`). Необязательна: тип публичный, и контекст
     * строят руками — например хост императивных диалогов.
     */
    theme?: ComputedRef<string | undefined>;
    /**
     * Куда монтируются оверлеи поддерева (`usePortalTarget`). Необязательно, как
     * и `theme`: контекст строят руками — например хост императивных диалогов.
     */
    portalTarget?: ComputedRef<string | HTMLElement | undefined>;
}

function useGrConfig(): GrConfigContext;

type GrConfigSource = GrConfigContext | {
    provides?: Record<symbol | string, unknown>;
};

type UseGrComponentSizeOptions<TSize extends string> = {
    /**
     * Имя компонента, чтобы учесть точечный `componentDefaults[Component].size`.
     * Без него читается только глобальный `size` провайдера.
     */
    component?: GrConfigurableComponent;
    /** Размер, когда ни проп, ни конфиг ничего не дали. По умолчанию `md`. */
    fallback?: TSize;
    /**
     * Размеры, которые компонент реально умеет. Значение из конфига вне этого
     * списка игнорируется в пользу `fallback`.
     *
     * Обязателен для компонентов, у которых size-шкала уже общей (`GrSlider`,
     * `GrRating`, `GrSwitch`, `GrLink`, `GrStatistic` не знают про `xs`): без него
     * `<GrConfigProvider size="xs">` дал бы `sizeMap['xs'] === undefined`, то есть
     * компонент без размерных классов — молча, без ошибки сборки.
     */
    supported?: readonly TSize[];
};

function useGrComponentSize<TSize extends string = GrComponentSize>(localSize: () => TSize | undefined, options?: UseGrComponentSizeOptions<TSize>): ComputedRef<TSize>;
/** Дефолтные пропсы конкретного компонента из ближайшего провайдера. */
export declare function useGrComponentDefaults<TComponent extends GrConfigurableComponent>(name: TComponent): ComputedRef<GrDefaultsOf<TComponent>>;
/**
 * Эффективное значение «оформительского» пропа: локальный проп →
 * `componentDefaults[Component][prop]` → собственный дефолт компонента.
 *
 * Обязательное условие на стороне компонента: у такого пропа в `withDefaults`
 * должен стоять `undefined`, а «настоящий» дефолт — переехать сюда, в `fallback`.
 * Иначе конфиг не сработает никогда: Vue отдаёт `props.x` уже с подставленным
 * дефолтом, и отличить «пользователь передал значение» от «сработал дефолт»
 * изнутри компонента невозможно.
 */
export declare function useGrComponentProp<TComponent extends GrConfigurableComponent, TProp extends keyof GrDefaultsOf<TComponent>>(component: TComponent, prop: TProp, localValue: () => GrDefaultsOf<TComponent>[TProp], fallback: NonNullable<GrDefaultsOf<TComponent>[TProp]>): ComputedRef<NonNullable<GrDefaultsOf<TComponent>[TProp]>>;
/**
 * Атрибут темы для **телепортируемого** корня панели.
 *
 * Панель уезжает в `body`, то есть вне DOM-поддерева провайдера, и `data-theme`
 * с его обёртки на неё не наследуется. В дереве компонентов она при этом
 * остаётся внутри — `inject` работает, — поэтому тему панель ставит себе сама.
 * Без этого «тёмный остров» ломался бы на первом же открытом дропдауне.
 *
 * ```vue
 * <teleport to="body">
 *   <div v-bind="themeAttrs">…</div>
 * </teleport>
 * ```
 */
export declare function useGrThemeAttrs(): ComputedRef<{
    'data-theme'?: string;

function useGrComponentDefaults<TComponent extends GrConfigurableComponent>(name: TComponent): ComputedRef<GrDefaultsOf<TComponent>>;

function useGrComponentProp<TComponent extends GrConfigurableComponent, TProp extends keyof GrDefaultsOf<TComponent>>(component: TComponent, prop: TProp, localValue: () => GrDefaultsOf<TComponent>[TProp], fallback: NonNullable<GrDefaultsOf<TComponent>[TProp]>): ComputedRef<NonNullable<GrDefaultsOf<TComponent>[TProp]>>;
/**
 * Атрибут темы для **телепортируемого** корня панели.
 *
 * Панель уезжает в `body`, то есть вне DOM-поддерева провайдера, и `data-theme`
 * с его обёртки на неё не наследуется. В дереве компонентов она при этом
 * остаётся внутри — `inject` работает, — поэтому тему панель ставит себе сама.
 * Без этого «тёмный остров» ломался бы на первом же открытом дропдауне.
 *
 * ```vue
 * <teleport to="body">
 *   <div v-bind="themeAttrs">…</div>
 * </teleport>
 * ```
 */
export declare function useGrThemeAttrs(): ComputedRef<{
    'data-theme'?: string;
}

function useGrThemeAttrs(): ComputedRef<{
    'data-theme'?: string;
}>;

interface GrComponentDefaultsRegistry {
}

const grConfigProviderConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrConfigProvider">;

interface GrConfigProviderProps {
    /** Дефолтный размер контролов для вложенных компонентов. */
    size?: GrComponentSize;
    /** Дефолтные пропсы по компонентам: `{ GrButton: { variant: 'secondary' } }`. */
    componentDefaults?: GrComponentDefaults;
    /** Адаптер переводов (fint-i18n-совместимый). Прокидывается вложенным компонентам. */
    i18n?: GranularityI18nAdapter | null;
    /**
     * Просьба к адаптеру переключить язык (`syncLocale`, у инстанса fint-i18n —
     * `setLocale`). Источником истины остаётся сам адаптер — провайдер лишь
     * передаёт ему намерение.
     */
    locale?: string;
    /**
     * Тема поддерева: значение уезжает в `data-theme`. Тема **документа** —
     * работа `useTheme`/`initThemeEarly`, здесь именно остров.
     */
    theme?: string;
    /**
     * Куда монтировать оверлеи поддерева. По умолчанию — общий `#gr-portal` в
     * `body`. Своё значение нужно там, где приложение живёт в контейнере:
     * микрофронтенд, shadow DOM, CSS-скоупинг под конкретным корнем.
     */
    portalTarget?: string | HTMLElement;
    /**
     * База шкалы слоёв. Переменные `--gr-z-*` пересчитываются от неё и ставятся
     * на `<html>`: панели телепортируются в `body`, и переменные поддерева до
     * них не доходят.
     */
    zIndexBase?: number;
    /** Тег обёртки. По умолчанию прозрачный `<div style="display:contents">`. */
    tag?: string;
}