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>;
    /**
     * Слои `componentDefaults` порознь: темы — и всё, что над ней (приложение,
     * провайдеры). Остров темы подменяет только слой темы. Необязательны:
     * контекст, построенный руками, несёт один `componentDefaults`.
     */
    themeDefaults?: ComputedRef<GrComponentDefaults | undefined>;
    overrideDefaults?: ComputedRef<GrComponentDefaults>;
    /**
     * Тема поддерева — остров другой темы сборки. Необязательна: тип публичный,
     * и контекст строят руками — например хост императивных диалогов.
     */
    theme?: ComputedRef<GrThemeId | undefined>;
    /** Режим поддерева — остров. Необязателен по той же причине, что и `theme`. */
    mode?: ComputedRef<GrModeName | undefined>;
    /**
     * Куда монтируются оверлеи поддерева (`usePortalTarget`). Необязательно, как
     * и `theme`: контекст строят руками — например хост императивных диалогов.
     */
    portalTarget?: ComputedRef<string | HTMLElement | undefined>;
}

function themeComponentDefaults(manifest: GrThemeManifest | null | undefined, themeId?: GrThemeId): GrComponentDefaults | 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<Record<string, 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<Record<string, string>>;

function useGrThemeAttrs(): ComputedRef<Record<string, 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;
    /**
     * Режим поддерева — остров: `dark` уезжает в `data-theme` парой текущей темы
     * документа (`slate-dark`). Режима у темы нет — первый той же схемы, иначе её
     * режим по умолчанию. Режим **документа** — работа `useTheme`/`initThemeEarly`.
     */
    mode?: GrModeName;
    /**
     * Остров другой темы сборки: `theme="clay" mode="dark"` пишет
     * `data-theme="clay-dark"`. Тема обязана быть в `themes` конфига granum —
     * иначе её пар нет в CSS. Лист дополнительной темы остров подгружает сам по
     * адресу из манифеста; страница, которая показывает тему всегда, импортирует
     * его заранее (`virtual:granum/themes/<id>.css`) — тогда нет кадра без
     * значений, а загрузчик узнаёт лист и второй раз его не качает. Без `mode` —
     * режим документа, если он у темы есть, иначе той же схемы.
     */
    theme?: GrThemeId;
    /**
     * Куда монтировать оверлеи поддерева. По умолчанию — общий `#gr-portal` в
     * `body`. Своё значение нужно там, где приложение живёт в контейнере:
     * микрофронтенд, shadow DOM, CSS-скоупинг под конкретным корнем.
     */
    portalTarget?: string | HTMLElement;
    /**
     * База шкалы слоёв. От неё пересчитываются все семь `--gr-z-*` с шагами
     * темы — от нижней навигации (−150) до тостов (+200) — и ставятся на
     * `<html>`: панели телепортируются в `body`, и переменные поддерева до них
     * не доходят.
     */
    zIndexBase?: number;
    /** Тег обёртки. По умолчанию прозрачный `<div style="display:contents">`. */
    tag?: string;
}