@feugene/granularity 0.12.0 → 0.16.0

package/dist/types/src/components/GrColorPicker/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grColorPickerSafelist: string[];

package/dist/types/src/components/GrCommandPalette/GrCommandPalette.vue.d.ts

@@ -0,0 +1,163 @@
+import { type GrCommandFilter, type GrCommandItem } from './filtering';
+import { type GrCommandPaletteSize } from './grCommandPaletteStyles';
+export type { GrCommandFilter, GrCommandGroup, GrCommandItem } from './filtering';
+export type { GrCommandPaletteSize } from './grCommandPaletteStyles';
+/**
+ * Публичный GR-примитив «Command palette» (⌘K) — модальный поиск по командам
+ * приложения с группировкой, подсказками сочетаний и клавиатурной навигацией.
+ *
+ * A11y: WAI-ARIA combobox поверх модалки — `role="combobox"` на поле ввода,
+ * `role="listbox"` на списке, `aria-activedescendant` на активной команде
+ * (фокус остаётся в поле). Esc, фокус-ловушка и блокировка скролла приходят
+ * из `GrModal`.
+ *
+ * Открытие по глобальному сочетанию (`hotkey`, по умолчанию `mod+k` — Cmd на
+ * macOS, Ctrl на прочих) компонент берёт на себя; передайте `hotkey: null`,
+ * чтобы управлять открытием только через `v-model`.
+ */
+export interface GrCommandPaletteProps {
+    /** Открыта ли палитра. */
+    modelValue: boolean;
+    /** Плоский список команд; группировка — по полю `group` самой команды. */
+    items?: GrCommandItem[];
+    /**
+     * Недавние команды: пока запрос пуст, они поднимаются отдельной группой
+     * наверх в этом порядке и не дублируются ниже.
+     */
+    recentIds?: string[];
+    placeholder?: string;
+    size?: GrCommandPaletteSize;
+    /** Глобальное сочетание открытия. `null` — не вешать слушатель. */
+    hotkey?: string | null;
+    /** Локальная фильтрация по запросу. `false` — фильтрует владелец по событию `search`. */
+    filterable?: boolean;
+    /** Кастомный матчер локальной фильтрации. */
+    filter?: GrCommandFilter;
+    /** Внешне управляемое состояние загрузки (для remote-поиска). */
+    loading?: boolean;
+    /** Закрывать палитру после выбора команды. */
+    closeOnSelect?: boolean;
+    /** Максимальная высота списка, px. */
+    maxHeight?: number;
+    /**
+     * Виртуализация списка: в DOM живёт только окно вокруг вьюпорта. Высоту окна
+     * задаёт `maxHeight`.
+     *
+     * Включается осознанно: на сотне команд выигрыша нет, а в разметке остаётся
+     * только окно — вместе с ним меняется и то, что находит `querySelector`
+     * потребителя. Профильный сценарий — палитра приложения на тысячи команд.
+     */
+    virtual?: boolean;
+    /** Показывать подсказку сочетания в поле ввода. */
+    showHotkeyHint?: boolean;
+    emptyText?: string;
+    ariaLabel?: string;
+}
+export interface GrCommandPaletteEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    /** Команда выбрана (клик или Enter). */
+    (e: 'select', item: GrCommandItem): void;
+    /** Поисковый запрос изменился — точка входа для remote-поиска. */
+    (e: 'search', query: string): void;
+}
+import './defaults';
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
+declare var __VLS_15: {
+    item: GrCommandItem;
+    active: boolean;
+}, __VLS_22: {
+    query: string;
+}, __VLS_24: {};
+type __VLS_Slots = {} & {
+    item?: (props: typeof __VLS_15) => any;
+} & {
+    empty?: (props: typeof __VLS_22) => any;
+} & {
+    footer?: (props: typeof __VLS_24) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCommandPaletteProps>, {
+    items: undefined;
+    recentIds: undefined;
+    placeholder: undefined;
+    size: undefined;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    virtual: boolean;
+    showHotkeyHint: boolean;
+    emptyText: undefined;
+    ariaLabel: undefined;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => void;
+    select: (item: GrCommandItem) => void;
+    search: (query: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCommandPaletteProps>, {
+    items: undefined;
+    recentIds: undefined;
+    placeholder: undefined;
+    size: undefined;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    virtual: boolean;
+    showHotkeyHint: boolean;
+    emptyText: undefined;
+    ariaLabel: undefined;
+}>>> & Readonly<{
+    onSearch?: ((query: string) => any) | undefined;
+    onSelect?: ((item: GrCommandItem) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrCommandPaletteSize;
+    filter: GrCommandFilter;
+    loading: boolean;
+    maxHeight: number;
+    placeholder: string;
+    ariaLabel: string;
+    filterable: boolean;
+    closeOnSelect: boolean;
+    virtual: boolean;
+    items: GrCommandItem[];
+    emptyText: string;
+    recentIds: string[];
+    hotkey: string | null;
+    showHotkeyHint: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/src/components/GrCommandPalette/config.d.ts

@@ -0,0 +1 @@
+export declare const grCommandPaletteConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrCommandPalette">;

package/dist/types/src/components/GrCommandPalette/defaults.d.ts

@@ -0,0 +1,14 @@
+import type { GrCommandPaletteSize } from './grCommandPaletteStyles';
+/**
+ * Пропы `GrCommandPalette`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrCommandPalette: { … } }">`.
+ * Только оформление — см. `GrButton/defaults.ts`.
+ */
+export interface GrCommandPaletteConfigurableProps {
+    size: GrCommandPaletteSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrCommandPalette: GrCommandPaletteConfigurableProps;
+    }
+}

package/dist/types/src/components/GrCommandPalette/filtering.d.ts

@@ -0,0 +1,59 @@
+/** Команда палитры. `id` обязателен — он же ключ рендера и цель `aria-activedescendant`. */
+export type GrCommandItem = {
+    id: string;
+    label: string;
+    /** Пояснение под меткой. */
+    description?: string;
+    /** UnoCSS-класс иконки (например `i-lucide-file-plus`). */
+    icon?: string;
+    /** Подсказка сочетания клавиш — массив клавиш, каждая рисуется отдельным `GrKbd`. */
+    shortcut?: string[];
+    /** Заголовок группы, под которой команда показывается в списке. */
+    group?: string;
+    /** Дополнительные слова для поиска (синонимы, транслитерация). */
+    keywords?: string[];
+    disabled?: boolean;
+};
+/** Команды, сгруппированные для рендера: порядок групп — порядок первого вхождения. */
+export type GrCommandGroup = {
+    /** `undefined` — команды без группы (рендерятся без заголовка). */
+    name: string | undefined;
+    items: GrCommandItem[];
+};
+export type GrCommandFilter = (item: GrCommandItem, query: string) => boolean;
+/**
+ * Матчер по умолчанию: подстрока (без учёта регистра) в метке, описании,
+ * названии группы или ключевых словах.
+ *
+ * Набор полей у команды шире, чем у опции списка, а сам подстрочный матч — тот
+ * же самый на весь пакет (`shared/optionFilter.ts`).
+ */
+export declare function matchCommandItem(item: GrCommandItem, query: string): boolean;
+export declare function filterCommandItems(items: GrCommandItem[], query: string, filter?: GrCommandFilter): GrCommandItem[];
+/**
+ * Раскладывает плоский список по группам, сохраняя порядок первого появления
+ * группы. Команды без `group` собираются в единственную безымянную группу,
+ * которая остаётся на своём месте в общем порядке.
+ */
+export declare function groupCommandItems(items: GrCommandItem[]): GrCommandGroup[];
+/** Кусок текста для подсветки: `match` — попал в запрос. */
+export type GrCommandMatchSegment = {
+    text: string;
+    match: boolean;
+};
+/**
+ * Режет текст на сегменты по вхождению запроса (без учёта регистра).
+ *
+ * Совпадения нет — один сегмент целиком: свой `filter` вправе матчить по
+ * `keywords`, и тогда в метке подсвечивать нечего. Регистр исходного текста
+ * сохраняется — подсветка не должна менять то, что читает пользователь.
+ */
+export declare function splitCommandMatch(text: string, query: string): GrCommandMatchSegment[];
+/**
+ * Поднимает «недавние» команды в отдельную группу наверх, сохраняя порядок
+ * `recentIds`, и убирает их из остального списка — иначе одна и та же команда
+ * оказалась бы в списке дважды, а `id` у неё один.
+ */
+export declare function withRecentCommands(groups: GrCommandGroup[], items: GrCommandItem[], recentIds: string[], title: string): GrCommandGroup[];
+/** Идентификаторы, встретившиеся больше одного раза. */
+export declare function findDuplicateCommandIds(items: GrCommandItem[]): string[];

package/dist/types/src/components/GrCommandPalette/grCommandPaletteStyles.d.ts

@@ -0,0 +1,45 @@
+import type { GrOverlaySize } from '../shared/sizes';
+export type GrCommandPaletteSize = GrOverlaySize;
+/**
+ * Кастомизация через CSS-переменные:
+ *
+ * - `--gr-command-active-bg` — фон активной (подсвеченной) команды.
+ * - `--gr-command-match-bg` — фон совпавшего с запросом фрагмента.
+ * - `--gr-command-list-max-height` — максимальная высота списка (иначе — проп `maxHeight`).
+ */
+export declare const commandPaletteModalSizeBySize: Record<GrCommandPaletteSize, GrOverlaySize>;
+export declare const commandSearchRowClass = "flex items-center gap-2 border-b border-[var(--gr-brd)] px-4";
+export declare const commandSearchInputClass = "min-w-0 flex-1 bg-transparent py-3.5 text-[length:var(--gr-command-input-font-size,15px)] text-[var(--gr-fg)] placeholder:text-[var(--gr-muted-fg)] focus:outline-none";
+export declare const commandGroupLabelClass = "px-3 pb-1 pt-3 text-[length:var(--gr-control-text-2xs)] font-medium uppercase tracking-wide text-[var(--gr-muted-fg)]";
+/** Описание под меткой команды. Цвет приходит из `commandItemMutedClass`. */
+export declare const commandItemDescriptionClass = "block truncate text-[length:var(--gr-text-xs)]";
+export declare const commandItemMutedEnabledClass = "text-[var(--gr-muted-fg)]";
+export declare const commandItemMutedDisabledClass = "text-[var(--gr-disabled-fg)]";
+/**
+ * Приглушённые части команды — иконка и описание.
+ *
+ * Гаснут вместе со строкой: свой `--gr-muted-fg` оставил бы у выключенной
+ * команды иконку темнее её же метки.
+ */
+export declare function commandItemMutedClass(disabled: boolean): string;
+/** Совпавший с запросом фрагмент. Фон — тот же токен подсветки, что у активной строки. */
+export declare const commandMatchClass = "rounded-[var(--gr-radius-xs)] bg-[var(--gr-command-match-bg,color-mix(in_srgb,var(--gr-primary)_22%,transparent))] text-[var(--gr-fg)]";
+/**
+ * Цвета текста в базе нет намеренно: два `text-[…]` в одном списке классов
+ * разрешаются порядком правил в сгенерированном CSS, а не порядком в атрибуте, —
+ * и цвет выключенной команды молча проигрывал бы базовому.
+ */
+export declare const commandItemBaseClass = "flex w-full items-center gap-3 rounded-[var(--gr-command-item-radius,10px)] px-3 py-2 text-left text-[length:var(--gr-control-text-md)]";
+export declare const commandItemEnabledClass = "cursor-pointer text-[var(--gr-fg)]";
+export declare const commandItemActiveClass = "bg-[var(--gr-command-active-bg,color-mix(in_srgb,var(--gr-muted)_45%,transparent))]";
+/**
+ * Выключенная команда гасится токенами состояния, а не `opacity`: прозрачность
+ * разбавляет выверенные на AA токены текста и роняет контраст.
+ */
+export declare const commandItemDisabledClass = "cursor-not-allowed bg-[var(--gr-disabled-bg)] text-[var(--gr-disabled-fg)]";
+export declare function commandItemClass(options: {
+    active: boolean;
+    disabled: boolean;
+}): string;
+export declare const commandEmptyClass = "px-4 py-10 text-center text-[length:var(--gr-control-text-sm)] text-[var(--gr-muted-fg)]";
+export declare const commandFooterClass = "flex items-center gap-3 border-t border-[var(--gr-brd)] px-4 py-2 text-[length:var(--gr-control-text-2xs)] text-[var(--gr-muted-fg)]";

package/dist/types/src/components/GrCommandPalette/index.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrCommandPaletteComponent from './GrCommandPalette.vue';
+export { default } from './GrCommandPalette.vue';
+export { default as GrCommandPalette } from './GrCommandPalette.vue';
+export { grCommandPaletteConfig } from './config';
+export { filterCommandItems, groupCommandItems, matchCommandItem, } from './filtering';
+export type { GrCommandFilter, GrCommandGroup, GrCommandItem, GrCommandPaletteProps, GrCommandPaletteSize, } from './GrCommandPalette.vue';
+export { grCommandPaletteSafelist } from './safelist';
+export type { GrCommandPaletteEmits } from './GrCommandPalette.vue';
+export type GrCommandPaletteInstance = ComponentExposed<typeof GrCommandPaletteComponent>;

package/dist/types/src/components/GrCommandPalette/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grCommandPaletteSafelist: string[];

package/dist/types/src/components/GrConfigProvider/GrConfigProvider.vue.d.ts

@@ -0,0 +1,93 @@
+import { type GranularityI18nAdapter } from '../../i18n/adapter';
+import { type GrComponentDefaults, type GrComponentSize } from './context';
+export type { GrComponentDefaults, GrComponentSize } from './context';
+export interface GrConfigProviderProps {
+    /** Дефолтный размер контролов для вложенных компонентов. */
+    size?: GrComponentSize;
+    /** Дефолтные пропсы по компонентам: `{ GrButton: { variant: 'secondary' } }`. */
+    componentDefaults?: GrComponentDefaults;
+    /** Адаптер переводов (fint-i18n-совместимый). Прокидывается вложенным компонентам. */
+    i18n?: GranularityI18nAdapter | null;
+    /**
+     * Просьба к адаптеру переключить язык (`syncLocale`). Источником истины
+     * остаётся сам адаптер — провайдер лишь передаёт ему намерение.
+     */
+    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;
+}
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrConfigProviderProps>, {
+    size: undefined;
+    componentDefaults: undefined;
+    i18n: undefined;
+    locale: undefined;
+    theme: undefined;
+    portalTarget: undefined;
+    zIndexBase: undefined;
+    tag: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrConfigProviderProps>, {
+    size: undefined;
+    componentDefaults: undefined;
+    i18n: undefined;
+    locale: undefined;
+    theme: undefined;
+    portalTarget: undefined;
+    zIndexBase: undefined;
+    tag: string;
+}>>> & Readonly<{}>, {
+    size: GrComponentSize;
+    componentDefaults: GrComponentDefaults;
+    theme: string;
+    portalTarget: string | HTMLElement;
+    tag: string;
+    i18n: GranularityI18nAdapter | null;
+    locale: string;
+    zIndexBase: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/src/components/GrConfigProvider/config.d.ts

@@ -0,0 +1 @@
+export declare const grConfigProviderConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrConfigProvider">;

package/dist/types/src/components/GrConfigProvider/context.d.ts

@@ -0,0 +1,158 @@
+import { type ComputedRef, type InjectionKey } from 'vue';
+/**
+ * Контекст `GrConfigProvider` — глобальные дефолты для вложенных GR-компонентов:
+ * размер контролов и per-component дефолтные пропсы.
+ *
+ * Компоненты читают его через {@link useGrConfig} (или хелперы ниже) и используют
+ * как fallback, когда соответствующий проп не задан на самом компоненте. Провайдер
+ * можно вкладывать — дочерний мержится поверх родительского.
+ */
+/**
+ * Размеры, которыми оперирует провайдер. Это «размеры контролов» — общий
+ * знаменатель формных компонентов, а не объединение всех size-шкал пакета
+ * (у оверлеев есть свои `xl`/`full`, у слайдера нет `xs`).
+ */
+export declare const GR_COMPONENT_SIZES: readonly ["xs", "sm", "md", "lg"];
+export type GrComponentSize = typeof GR_COMPONENT_SIZES[number];
+/**
+ * Открытый реестр компонентов, у которых есть настраиваемые через конфиг пропы.
+ *
+ * Пустой по умолчанию: каждый компонент дополняет его **из своей папки** через
+ * declaration merging (`GrButton/defaults.ts` и т. п.). Так провайдер не знает
+ * ни имён, ни типов конкретных компонентов — контракт объявляет тот, кто им
+ * владеет, а не общий модуль.
+ *
+ * Практическое следствие: реестр состоит ровно из тех компонентов, которые
+ * попали в граф типов потребителя. Импортировали только `GrButton` — в
+ * `componentDefaults` типизирована только кнопка, типы `GrBadge` в проект не
+ * приезжают.
+ *
+ * ```ts
+ * // GrButton/defaults.ts
+ * declare module '../GrConfigProvider/context' {
+ *   interface GrComponentDefaultsRegistry {
+ *     GrButton: GrButtonConfigurableProps
+ *   }
+ * }
+ * ```
+ */
+export interface GrComponentDefaultsRegistry {
+}
+/** Имя компонента, у которого есть настраиваемые через конфиг пропы. */
+export type GrConfigurableComponent = keyof GrComponentDefaultsRegistry;
+/**
+ * Дефолтные пропсы по имени компонента: `{ GrButton: { variant: 'secondary' } }`.
+ *
+ * Набор ключей закрыт реестром, а не `Record<string, unknown>`: через конфиг
+ * должны настраиваться только «оформительские» пропы. Пустить туда что угодно —
+ * значит разрешить задать глобальный `modelValue` или обработчик и получить баг,
+ * который ищется часами.
+ */
+export type GrComponentDefaults = {
+    [TComponent in GrConfigurableComponent]?: Partial<GrComponentDefaultsRegistry[TComponent]>;
+};
+type GrDefaultsOf<TComponent extends GrConfigurableComponent> = Partial<GrComponentDefaultsRegistry[TComponent]>;
+export interface GrConfigContext {
+    /** Дефолтный размер контролов (если проп `size` не задан на компоненте). */
+    size: ComputedRef<GrComponentSize | undefined>;
+    /** Дефолтные пропсы по компонентам. */
+    componentDefaults: ComputedRef<GrComponentDefaults>;
+    /**
+     * Тема поддерева (`data-theme`). Необязательна: тип публичный, и контекст
+     * строят руками — например хост императивных диалогов.
+     */
+    theme?: ComputedRef<string | undefined>;
+    /**
+     * Куда монтируются оверлеи поддерева (`usePortalTarget`). Необязательно, как
+     * и `theme`: контекст строят руками — например хост императивных диалогов.
+     */
+    portalTarget?: ComputedRef<string | HTMLElement | undefined>;
+}
+export declare const GR_CONFIG_KEY: InjectionKey<GrConfigContext>;
+/** Возвращает ближайший `GrConfigProvider` или пустой конфиг, если провайдера нет. */
+export declare function useGrConfig(): GrConfigContext;
+/**
+ * Источник конфига для {@link resolveGrConfig}: сам контекст, `AppContext` или
+ * инстанс компонента — у двух последних читается `provides`.
+ */
+export type GrConfigSource = GrConfigContext | {
+    provides?: Record<symbol | string, unknown>;
+};
+/**
+ * Конфиг там, где `inject` недоступен — вне `setup`: в директивах, императивных
+ * сервисах, утилитах. Порядок: явный контекст → `provides` источника → `inject`
+ * (если есть активный инстанс) → пустой конфиг.
+ *
+ * Важно понимать границу: `provides` у `AppContext` содержит только то, что
+ * роздано через `app.provide()`. Значения от `<GrConfigProvider>` живут в дереве
+ * компонентов, и достать их можно лишь оттуда, где это дерево ещё есть — то есть
+ * захватом в `setup`. Просто передать `appContext` в отрыве от дерева
+ * недостаточно; см. `SPEC-GrConfig-resolver.md`.
+ */
+export declare function resolveGrConfig(source?: GrConfigSource | null): GrConfigContext;
+export 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[];
+};
+/** Сброс дедупликации предупреждений. Внутреннее API — нужно тестам. */
+export declare function resetUnsupportedSizeWarnings(): void;
+/**
+ * Эффективный размер компонента. Приоритет:
+ * локальный проп → `componentDefaults[Component].size` → глобальный `size`
+ * провайдера → `fallback`. Точечная настройка компонента должна побеждать
+ * общую — иначе `componentDefaults` нельзя было бы использовать как исключение
+ * из глобального правила.
+ *
+ * Передавайте `size` геттером, чтобы сохранить реактивность.
+ *
+ * Локальный проп не проверяется по `supported`: он уже сужен типом пропа самого
+ * компонента, и передать туда лишнее — явная ошибка вызывающего кода. Проверка
+ * нужна конфигу: это глобальный канал, который не знает, кто его читает.
+ */
+export declare 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;
+}>;
+export {};

package/dist/types/src/components/GrConfigProvider/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './GrConfigProvider.vue';
+export { default as GrConfigProvider } from './GrConfigProvider.vue';
+export type { GrComponentDefaults, GrComponentSize } from './GrConfigProvider.vue';
+export { GR_COMPONENT_SIZES, GR_CONFIG_KEY, type GrComponentDefaultsRegistry, type GrConfigContext, type GrConfigSource, type GrConfigurableComponent, resolveGrConfig, useGrComponentDefaults, useGrComponentProp, useGrComponentSize, type UseGrComponentSizeOptions, useGrConfig, } from './context';
+export { grConfigProviderConfig } from './config';
+export type { GrConfigProviderProps } from './GrConfigProvider.vue';

package/dist/types/src/components/GrConfigProvider/zIndexScale.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Шкала слоёв, задаваемая пропом `zIndexBase` у `GrConfigProvider`.
+ *
+ * Переменные ставятся на `<html>`, а не на обёртку провайдера: панели
+ * телепортируются в `body`, то есть живут вне его DOM-поддерева, и
+ * «настройка слоёв поддеревом» была бы ложным обещанием.
+ *
+ * Отсюда же следует, что владелец шкалы один на документ: два провайдера с
+ * разными базами — это гонка, о которой надо сказать вслух, а не тихо
+ * применить последнюю.
+ */
+/**
+ * Смещения те же, что в `styles/tokens.css`: шаг 50 оставляет приложению место
+ * вклиниться между слоями, а тосты стоят выше модалок.
+ */
+export declare const GR_Z_INDEX_OFFSETS: Record<string, number>;
+/**
+ * Ставит шкалу от базы и возвращает функцию отката к прежним значениям.
+ * `null` — нечего ставить (нет базы или нет документа).
+ */
+export declare function applyGrZIndexBase(token: symbol, base: number | undefined): (() => void) | null;
+/** Тестовая очистка владельца шкалы между кейсами. */
+export declare function resetGrZIndexOwner(): void;