@feugene/granularity 0.12.0 → 0.13.0

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

@@ -23,12 +23,12 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
-    variant: string;
-    tone: string;
-    size: string;
+    variant: undefined;
+    tone: undefined;
+    size: undefined;
     loading: boolean;
     disabled: boolean;
-    square: boolean;
+    square: undefined;
     type: string;
     ariaLabel: undefined;
     as: undefined;
@@ -37,12 +37,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     rel: undefined;
     external: boolean;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
-    variant: string;
-    tone: string;
-    size: string;
+    variant: undefined;
+    tone: undefined;
+    size: undefined;
     loading: boolean;
     disabled: boolean;
-    square: boolean;
+    square: undefined;
     type: string;
     ariaLabel: undefined;
     as: undefined;
@@ -53,15 +53,15 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>> & Readonly<{}>, {
     tone: GrButtonTone;
     variant: GrButtonVariant;
-    type: "button" | "submit" | "reset";
-    square: boolean;
     size: GrButtonSize;
+    square: boolean;
+    type: "button" | "submit" | "reset";
+    target: string;
+    href: string;
     loading: boolean;
     disabled: boolean;
     ariaLabel: string;
     as: string | Component;
-    href: string;
-    target: string;
     rel: string;
     external: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -0,0 +1,25 @@
+import type { GrButtonSize, GrButtonTone, GrButtonVariant } from './grButtonStyles';
+/**
+ * Пропы `GrButton`, которые можно задать глобально через
+ * `<GrConfigProvider :component-defaults="{ GrButton: { … } }">`.
+ *
+ * Набор закрытый и осознанный: только оформление. `modelValue`, обработчики и
+ * всё, что относится к конкретному экземпляру, через конфиг настраиваться не
+ * должно — иначе получим глобальное состояние, которое ищется часами.
+ */
+export interface GrButtonConfigurableProps {
+    variant: GrButtonVariant;
+    tone: GrButtonTone;
+    size: GrButtonSize;
+    square: boolean;
+}
+/**
+ * Регистрация контракта в открытом реестре провайдера. Живёт здесь, а не в
+ * `GrConfigProvider`, чтобы провайдер не знал про конкретные компоненты: тип
+ * приезжает к потребителю ровно тогда, когда он импортирует сам `GrButton`.
+ */
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrButton: GrButtonConfigurableProps;
+    }
+}

package/dist/types/src/components/GrButton/grButtonStyles.d.ts

@@ -22,8 +22,8 @@ export type GrButtonToneTokens = {
     borderHover: string;
     borderActive: string;
 };
-export declare const base = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] disabled:opacity-50 disabled:cursor-not-allowed";
-export declare const grButtonBaseClass = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] disabled:opacity-50 disabled:cursor-not-allowed";
+export declare const base = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:opacity-50 disabled:cursor-not-allowed";
+export declare const grButtonBaseClass = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:opacity-50 disabled:cursor-not-allowed";
 export declare const sizes: Record<GrButtonSize, string>;
 export declare const squareSizes: Record<GrButtonSize, string>;
 export declare const tones: Record<GrButtonTone, GrButtonToneTokens>;

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

@@ -1,6 +1,7 @@
 export { default } from './GrButton.vue';
 export { default as GrButton } from './GrButton.vue';
 export { grButtonConfig } from './config';
+export type { GrButtonConfigurableProps } from './defaults';
 export type { GrButtonSize, GrButtonTone, GrButtonVariant } from './grButtonStyles';
 export { grButtonClass } from './grButtonStyles';
 export { grButtonClassTokens, grButtonSafelist } from './safelist';

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

@@ -38,12 +38,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     form: string;
-    value: string;
+    id: string;
+    name: string;
+    disabled: boolean;
     modelValue: boolean;
+    value: string;
     required: boolean;
-    disabled: boolean;
-    name: string;
-    id: string;
     indeterminate: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -31,11 +31,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     disabled: boolean;
     divided: boolean;
 }>>> & Readonly<{
-    "onUpdate:modelValue"?: ((value: GrCollapseModelValue) => any) | undefined;
     onChange?: ((value: GrCollapseModelValue) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: GrCollapseModelValue) => any) | undefined;
 }>, {
-    modelValue: GrCollapseValue | GrCollapseValue[];
     disabled: boolean;
+    modelValue: GrCollapseValue | GrCollapseValue[];
     accordion: boolean;
     divided: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/types/src/components/GrCollapse/GrCollapseItem.vue.d.ts

@@ -27,8 +27,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     disabled: boolean;
 }>>> & Readonly<{}>, {
     title: string;
-    disabled: boolean;
     name: GrCollapseValue;
+    disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

@@ -0,0 +1,128 @@
+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[];
+    placeholder?: string;
+    size?: GrCommandPaletteSize;
+    /** Глобальное сочетание открытия. `null` — не вешать слушатель. */
+    hotkey?: string | null;
+    /** Локальная фильтрация по запросу. `false` — фильтрует владелец по событию `search`. */
+    filterable?: boolean;
+    /** Кастомный матчер локальной фильтрации. */
+    filter?: GrCommandFilter;
+    /** Внешне управляемое состояние загрузки (для remote-поиска). */
+    loading?: boolean;
+    /** Закрывать палитру после выбора команды. */
+    closeOnSelect?: boolean;
+    /** Максимальная высота списка, px. */
+    maxHeight?: number;
+    /** Показывать подсказку сочетания в поле ввода. */
+    showHotkeyHint?: boolean;
+    emptyText?: string;
+    ariaLabel?: string;
+}
+declare var __VLS_16: {
+    item: GrCommandItem;
+    active: boolean;
+}, __VLS_24: {
+    query: string;
+}, __VLS_26: {};
+type __VLS_Slots = {} & {
+    item?: (props: typeof __VLS_16) => any;
+} & {
+    empty?: (props: typeof __VLS_24) => any;
+} & {
+    footer?: (props: typeof __VLS_26) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCommandPaletteProps>, {
+    items: undefined;
+    placeholder: undefined;
+    size: string;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    showHotkeyHint: boolean;
+    emptyText: undefined;
+    ariaLabel: undefined;
+}>>, {}, {}, {}, {}, 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;
+    placeholder: undefined;
+    size: string;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    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;
+    items: GrCommandItem[];
+    hotkey: string | null;
+    showHotkeyHint: boolean;
+    emptyText: string;
+}, {}, {}, {}, 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").GranularComponentDescriptor<"GrCommandPalette">;

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

@@ -0,0 +1,35 @@
+/** Команда палитры. `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;
+/**
+ * Матчер по умолчанию: подстрока (без учёта регистра) в метке, описании,
+ * названии группы или ключевых словах.
+ */
+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[];

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

@@ -0,0 +1,20 @@
+export type GrCommandPaletteSize = 'md' | 'lg' | 'xl';
+/**
+ * Кастомизация через CSS-переменные:
+ *
+ * - `--gr-command-active-bg` — фон активной (подсвеченной) команды.
+ * - `--gr-command-list-max-height` — максимальная высота списка (иначе — проп `maxHeight`).
+ */
+export declare const commandPaletteModalSizeBySize: Record<GrCommandPaletteSize, 'md' | 'lg' | 'xl'>;
+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-[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-[11px] font-medium uppercase tracking-wide text-[var(--gr-muted-fg)]";
+export declare const commandItemBaseClass = "flex w-full items-center gap-3 rounded-[10px] px-3 py-2 text-left text-[14px] text-[var(--gr-fg)]";
+export declare const commandItemActiveClass = "bg-[var(--gr-command-active-bg,color-mix(in_srgb,var(--gr-muted)_45%,transparent))]";
+export declare const commandItemDisabledClass = "cursor-not-allowed opacity-50";
+export declare function commandItemClass(options: {
+    active: boolean;
+    disabled: boolean;
+}): string;
+export declare const commandEmptyClass = "px-4 py-10 text-center text-[13px] 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-[11px] text-[var(--gr-muted-fg)]";

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

@@ -0,0 +1,23 @@
+/**
+ * Разбор и матчинг сочетания открытия палитры.
+ *
+ * Директива `v-hotkey` здесь не подходит: ей нужен смонтированный элемент, а
+ * палитра в закрытом состоянии не рендерит ничего (весь UI живёт внутри
+ * `GrModal`, который скрыт). Поэтому — минимальный собственный матчер на
+ * `window`, с тем же синтаксисом комбинаций плюс токен `mod`.
+ */
+export type ParsedCommandHotkey = {
+    key: string;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+    /** `mod` — Cmd на macOS, Ctrl на остальных платформах. */
+    mod: boolean;
+};
+export declare function parseCommandHotkey(combo: string): ParsedCommandHotkey | null;
+/** macOS определяем по платформе — от неё зависит, чем является `mod`. */
+export declare function isAppleDevice(): boolean;
+export declare function matchesCommandHotkey(event: KeyboardEvent, hotkey: ParsedCommandHotkey, apple?: boolean): boolean;
+/** Человекочитаемые клавиши для подсказки в поле ввода (`⌘` / `Ctrl`). */
+export declare function formatCommandHotkey(hotkey: ParsedCommandHotkey, apple?: boolean): string[];

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

@@ -0,0 +1,6 @@
+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';

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,59 @@
+import { type GranularityI18nAdapter } from '../../i18n/adapter';
+import { type GrComponentDefaults, type GrComponentSize } from './context';
+export type { GrComponentDefaults, GrComponentSize } from './context';
+type __VLS_Props = {
+    /** Дефолтный размер контролов для вложенных компонентов. */
+    size?: GrComponentSize;
+    /** Дефолтные пропсы по компонентам: `{ GrButton: { variant: 'secondary' } }`. */
+    componentDefaults?: GrComponentDefaults;
+    /** Адаптер переводов (fint-i18n-совместимый). Прокидывается вложенным компонентам. */
+    i18n?: GranularityI18nAdapter | null;
+    /** Тег обёртки. По умолчанию прозрачный `<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<__VLS_Props>, {
+    size: undefined;
+    componentDefaults: undefined;
+    i18n: undefined;
+    tag: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    size: undefined;
+    componentDefaults: undefined;
+    i18n: undefined;
+    tag: string;
+}>>> & Readonly<{}>, {
+    size: GrComponentSize;
+    componentDefaults: GrComponentDefaults;
+    tag: string;
+    i18n: GranularityI18nAdapter | null;
+}, {}, {}, {}, 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").GranularComponentDescriptor<"GrConfigProvider">;

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

@@ -0,0 +1,131 @@
+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>;
+}
+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]>>;
+export {};

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

@@ -0,0 +1,5 @@
+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';

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

@@ -94,12 +94,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     confirmDisabled: boolean;
     closeOnConfirm: boolean;
 }>>> & Readonly<{
-    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onCancel?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onConfirm?: (() => any) | undefined;
 }>, {
-    title: string;
     size: GrDialogSize;
+    title: string;
     error: ResponseErrorInfo | null;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;

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

@@ -25,11 +25,29 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
      * `sort-change`. `rows` при этом должны приходить уже отсортированными.
      */
     externalSort?: boolean;
+    /**
+     * Выбор строк: добавляет ведущую колонку с чекбоксами (+ «выбрать все» в шапке).
+     * Выбранные ключи строк — через `v-model:selected`.
+     */
+    selectable?: boolean;
+    /** Контролируемый список выбранных ключей строк: `v-model:selected`. */
+    selected?: Array<string | number>;
+    /**
+     * Состояние загрузки: тело таблицы заменяется строкой-индикатором.
+     * `empty`-состояние при этом не показывается.
+     */
+    loading?: boolean;
+    /** Текст индикатора загрузки. i18n: fallback `gr.dataTable.loading`. */
+    loadingText?: string;
     density?: GrTableDensity;
     caption?: string;
     ariaLabel?: string;
     ariaLabelledby?: string;
     regionLabel?: string;
+    /** Прилипающий заголовок при вертикальном скролле (нужен `maxHeight`). */
+    stickyHeader?: boolean;
+    /** Максимальная высота таблицы (вертикальный скролл). Число — в пикселях. */
+    maxHeight?: string | number;
 }
 declare const __VLS_export: <TRow extends Record<string, unknown> = Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrDataTableProps<TRow> & {
@@ -39,6 +57,7 @@ declare const __VLS_export: <TRow extends Record<string, unknown> = Record<strin
             key: string;
             dir: "asc" | "desc";
         }) => any) | undefined;
+        "onUpdate:selected"?: ((value: (string | number)[]) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
@@ -62,6 +81,7 @@ declare const __VLS_export: <TRow extends Record<string, unknown> = Record<strin
             key: string;
             dir: "asc" | "desc";
         }): void;
+        (e: "update:selected", value: Array<string | number>): void;
     };
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;

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

@@ -47,8 +47,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
-    title: string;
     size: GrDialogSize;
+    title: string;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
     showCloseButton: boolean;