@feugene/granularity 0.13.0 → 0.16.0

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

@@ -18,11 +18,11 @@
  */
 import { type Component } from 'vue';
 import { type GrLinkSize, type GrLinkTone, type GrLinkUnderline, type GrLinkVariant } from './grLinkStyles';
-type __VLS_Props = {
+export interface GrLinkProps {
     /**
-     * Кастомный корневой тег/компонент. Если передан и компонент не `disabled` —
-     * рендерится через `<component :is="as">`. Игнорируется при `disabled`.
-     */
+    * Кастомный корневой тег/компонент. Если передан и компонент не `disabled` —
+    * рендерится через `<component :is="as">`. Игнорируется при `disabled`.
+    */
     as?: string | Component;
     href?: string;
     external?: boolean;
@@ -36,12 +36,19 @@ type __VLS_Props = {
     variant?: GrLinkVariant;
     underline?: GrLinkUnderline;
     size?: GrLinkSize;
-};
+    /**
+    * Иконка внешней ссылки. По умолчанию показывается у любой ссылки, которая
+    * открывается в новой вкладке, — не только при `external`.
+    */
+    externalIcon?: boolean;
+    /** i18n: скрытая подсказка «откроется в новой вкладке». */
+    newTabLabel?: 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>, {
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLinkProps>, {
     as: undefined;
     href: undefined;
     external: boolean;
@@ -52,8 +59,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tone: string;
     variant: string;
     underline: string;
-    size: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    size: undefined;
+    externalIcon: undefined;
+    newTabLabel: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLinkProps>, {
     as: undefined;
     href: undefined;
     external: boolean;
@@ -64,7 +73,9 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tone: string;
     variant: string;
     underline: string;
-    size: string;
+    size: undefined;
+    externalIcon: undefined;
+    newTabLabel: undefined;
 }>>> & Readonly<{}>, {
     tone: GrLinkTone;
     variant: GrLinkVariant;
@@ -75,8 +86,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     disabled: boolean;
     ariaLabel: string;
     as: string | Component;
-    rel: string;
     external: boolean;
+    rel: string;
+    externalIcon: boolean;
+    newTabLabel: string;
 }, {}, {}, {}, 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/GrLink/config.d.ts

@@ -1 +1 @@
-export declare const grLinkConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrLink">;
+export declare const grLinkConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrLink">;

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

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

package/dist/types/src/components/GrLink/grLinkStyles.d.ts

@@ -1,4 +1,5 @@
-import { GR_TONES, type GrTone } from '../shared/tones';
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
 /**
  * Архитектура цвета GrLink (согласована с остальной GR, ср. GrButton):
  *
@@ -10,34 +11,31 @@ import { GR_TONES, type GrTone } from '../shared/tones';
  *   - `muted` — приглушённый текст (`--gr-muted-fg`) в покое, окрашивается в `tone`
  *     при наведении (вторичные/inline-ссылки в плотных областях).
  *
- * Раньше `variant` смешивал цвет и акцент (`primary/default/muted/muted-primary/danger`).
- * Теперь это ортогональные оси: `tone` × `variant`.
+ * Оси ортогональны намеренно: «красная ссылка» и «приглушённая ссылка» —
+ * независимые решения, и любая их комбинация осмысленна.
  */
 export type GrLinkTone = GrTone;
 export type GrLinkVariant = 'default' | 'muted';
 export type GrLinkUnderline = 'auto' | 'always' | 'none';
-export type GrLinkSize = 'sm' | 'md' | 'lg';
-export declare const baseRootClass = "inline-flex items-center gap-1 rounded-[6px] transition-colors duration-150";
+export type GrLinkSize = GrComponentSize;
+export declare const baseRootClass = "inline-flex items-center gap-1 rounded-[var(--gr-radius-control)] transition-colors duration-[var(--gr-duration-fast)]";
 export declare const focusRingClass = "focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
 export declare const sizeClassBySize: Record<GrLinkSize, string>;
 export declare const colorClass = "text-[var(--gr-link-color)] visited:text-[var(--gr-link-color)] hover:text-[var(--gr-link-color-hover)] active:text-[var(--gr-link-color-active)]";
-type GrLinkToneColors = {
-    base: string;
-    hover: string;
-    active: string;
-};
-export declare const linkToneColors: Record<GrLinkTone, GrLinkToneColors>;
 /** Инлайновые CSS-переменные цвета для текущей комбинации `tone` × `variant`. */
 export declare function grLinkColorStyle(options: {
     tone: GrLinkTone;
     variant: GrLinkVariant;
     disabled: boolean;
 }): Record<string, string>;
-export declare const disabledStateClass = "cursor-not-allowed opacity-60 text-[var(--gr-muted-fg)]";
+/**
+ * Отключённая ссылка гасится цветом, а не `opacity`: прозрачность разбавляет
+ * выверенный на AA `--gr-muted-fg` и роняет контраст ниже нормы.
+ */
+export declare const disabledStateClass = "cursor-not-allowed text-[var(--gr-muted-fg)]";
 export declare const underlineClasses: readonly string[];
 export declare function grLinkClass(options: {
     size: GrLinkSize;
     underline: GrLinkUnderline;
     disabled: boolean;
 }): string;
-export { GR_TONES };

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

@@ -3,3 +3,5 @@ export { default as GrLink } from './GrLink.vue';
 export { grLinkConfig } from './config';
 export type { GrLinkSize, GrLinkTone, GrLinkUnderline, GrLinkVariant } from './grLinkStyles';
 export { grLinkSafelist } from './safelist';
+export type { GrLinkConfigurableProps } from './defaults';
+export type { GrLinkProps } from './GrLink.vue';

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

@@ -1,41 +1,66 @@
-export interface GrListProps {
+import type { GrCardVariant } from '../GrCard/grCardStyles';
+import { type GrVirtualAlign } from '../../composables/useVirtualList';
+export interface GrListProps<TItem = unknown> {
+    /**
+     * Поверхность списка — вариант карточки под ним. `ghost` убирает рамку и
+     * тень: список внутри уже существующей карточки не должен давать вторую.
+     */
+    variant?: GrCardVariant;
     /** Показывать ли горизонтальные разделители между элементами (по умолчанию — да). */
     divided?: boolean;
+    /** Идёт загрузка: вместо пунктов — строки-скелетоны, контейнер помечен `aria-busy`. */
+    loading?: boolean;
+    /** Сколько строк-заглушек показать при `loading`. */
+    loadingRows?: number;
+    /**
+     * Список пуст. По умолчанию определяется сам — по содержимому слота; проп
+     * нужен там, где потребитель знает лучше (например, слот заполнен
+     * заголовками групп, а данных в них нет).
+     */
+    empty?: boolean;
+    /** Текст пустого состояния. Слот `#empty` сильнее. */
+    emptyText?: string;
+    /**
+     * Данные списка. С ними пункты рисует слот `#item`, а не слот по умолчанию, —
+     * и только так список знает размер набора, то есть может его виртуализировать.
+     */
+    items?: TItem[];
+    /** Ключ пункта для `v-for`: имя поля или функция. Без него — индекс. */
+    itemKey?: string | ((item: TItem, index: number) => string | number);
+    /** Высота видимой части: контейнер становится скроллером. Число — пиксели. */
+    maxHeight?: number | string;
+    /** Держать в DOM только окно вокруг вьюпорта. Требует `items` и `maxHeight`. */
+    virtual?: boolean;
+    /** Оценка высоты пункта до замера. Уточняется по факту при первом рендере. */
+    estimatedItemSize?: number;
 }
-declare var __VLS_8: {}, __VLS_10: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-} & {
-    default?: (props: typeof __VLS_10) => any;
+declare const __VLS_export: <T = 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<GrListProps<T>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        scrollToIndex: (index: number, align?: GrVirtualAlign) => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        loading?: (props: {}) => any;
+    } & {
+        empty?: (props: {}) => any;
+    } & {
+        item?: (props: {
+            item: T;
+            index: number;
+            aria: Record<string, number>;
+        }) => any;
+    } & {
+        default?: (props: {}) => any;
+    };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListProps>, {
-    divided: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListProps>, {
-    divided: boolean;
-}>>> & Readonly<{}>, {
-    divided: 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];
 } : {

package/dist/types/src/components/GrList/GrListItem.vue.d.ts

@@ -1,4 +1,6 @@
-export type GrListItemDensity = 'compact' | 'regular';
+import { type Component } from 'vue';
+import { type GrListItemDensity } from './grListStyles';
+export type { GrListItemDensity } from './grListStyles';
 export interface GrListItemProps {
     /** Заголовок строки. Если передан слот `#title`, проп игнорируется. */
     title?: string;
@@ -6,29 +8,60 @@ export interface GrListItemProps {
     description?: string;
     /** Плотность вертикальных отступов: `regular` — 12px, `compact` — 8px. */
     density?: GrListItemDensity;
+    /** Ссылка: строка становится `<a>`. */
+    href?: string;
+    /** Свой корневой тег строки (`RouterLink`, `Link` от Inertia). Сильнее `href`. */
+    as?: string | Component;
+    /** Кликабельная строка без ссылки — `<button>` с событием `click`. */
+    clickable?: boolean;
+    /** Подсветка при наведении без интерактивности. */
+    hoverable?: boolean;
+    disabled?: boolean;
 }
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {};
+export interface GrListItemEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {};
 type __VLS_Slots = {} & {
-    prefix?: (props: typeof __VLS_1) => any;
+    prefix?: (props: typeof __VLS_9) => any;
 } & {
-    title?: (props: typeof __VLS_3) => any;
+    title?: (props: typeof __VLS_11) => any;
 } & {
-    description?: (props: typeof __VLS_5) => any;
+    description?: (props: typeof __VLS_13) => any;
 } & {
-    default?: (props: typeof __VLS_7) => any;
+    default?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
     title: undefined;
     description: undefined;
     density: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    disabled: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
     title: undefined;
     description: undefined;
     density: string;
-}>>> & Readonly<{}>, {
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    disabled: boolean;
+}>>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    density: GrListItemDensity;
     title: string;
     description: string;
-    density: GrListItemDensity;
+    href: string;
+    disabled: boolean;
+    as: string | Component;
+    clickable: boolean;
+    hoverable: 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/GrList/config.d.ts

@@ -1 +1 @@
-export declare const grListConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrList">;
+export declare const grListConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrList">;

package/dist/types/src/components/GrList/grListStyles.d.ts

@@ -0,0 +1,25 @@
+export type GrListItemDensity = 'compact' | 'regular';
+/**
+ * Классы `GrList`/`GrListItem`.
+ *
+ * Единственный источник правды для шаблонов и safelist: до этого карта
+ * плотности жила в SFC, а её копия — строковыми литералами прямо в `config.ts`,
+ * и разойтись они могли молча.
+ */
+export declare const densityPadding: Record<GrListItemDensity, string>;
+export declare const itemLayoutClass = "flex items-start justify-between gap-4";
+/** Интерактивная строка занимает всю ширину пункта — кликабельна вся, а не текст. */
+export declare const itemInteractiveClass = "w-full text-left transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-inset";
+export declare const itemHoverClass = "cursor-pointer hover:bg-[var(--gr-muted)]";
+/**
+ * Заблокированная строка гасится фоном и цветом, а не `opacity`: прозрачность
+ * разбавляет выверенные на AA токены текста.
+ */
+export declare const itemDisabledClass = "cursor-not-allowed bg-[var(--gr-muted)] text-[var(--gr-muted-fg)]";
+export declare const dividedClass = "divide-y divide-[var(--gr-brd)]";
+export declare const emptyClass = "px-4 py-6 text-center text-[length:var(--gr-text-sm)] text-[var(--gr-muted-fg)]";
+/** Заголовок и описание строки. Оба нужны обеим веткам пункта — интерактивной и обычной. */
+export declare const itemTitleClass = "text-[length:var(--gr-text-sm)] font-700";
+export declare const itemDescriptionClass = "mt-0.5 text-[length:var(--gr-text-sm)] text-[var(--gr-muted-fg)]";
+export declare const loadingRowClass = "px-4 py-3";
+export declare function grListItemPaddingClass(density: GrListItemDensity): string;

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

@@ -1,6 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrListComponent from './GrList.vue';
 export { default } from './GrList.vue';
 export { default as GrList } from './GrList.vue';
 export type { GrListProps } from './GrList.vue';
 export { default as GrListItem } from './GrListItem.vue';
 export type { GrListItemDensity, GrListItemProps } from './GrListItem.vue';
 export { grListConfig } from './config';
+export { grListSafelist } from './safelist';
+export type GrListInstance = ComponentExposed<typeof GrListComponent>;
+export type { GrListItemEmits } from './GrListItem.vue';

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

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

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

@@ -1,55 +1,90 @@
 import { type Component } from 'vue';
+import type { GrIconSize, GrIconTone } from '../GrIcon/grIconStyles';
 /**
- * Props for {@link GrLoading}.
- * Overlay primitive that renders a centered spinner with optional text above sibling content.
- * Use `fullscreen` to cover the whole viewport, otherwise overlays the nearest positioned ancestor.
+ * Пропы {@link GrLoading}.
+ *
+ * Оверлей загрузки: спиннер с подписью поверх соседнего контента. `fullscreen`
+ * накрывает весь экран, иначе оверлей ложится на ближайшего позиционированного
+ * предка.
  */
 export interface GrLoadingProps {
-    /** Text under the spinner. Pass an empty string to hide the text entirely. Defaults to `'Loading...'`. */
+    /** Подпись под спиннером. Пустая строка убирает её совсем. По умолчанию — из локали. */
     text?: string;
-    /** Custom spinner component (rendered instead of the default loader icon). */
+    /** Свой компонент спиннера вместо иконки по умолчанию. */
     spinner?: Component;
-    /** Extra classes for the spinner element. */
+    /** Дополнительные классы обёртки спиннера. */
     spinnerClass?: string;
-    /** When `true` (default), the default spinner rotates via `@keyframes gr-loading-spin`. */
+    /** Размер спиннера: шкала пакета либо произвольный в пикселях. */
+    spinnerSize?: GrIconSize | number;
+    /** Тон спиннера из палитры. */
+    spinnerTone?: GrIconTone;
+    /** Вращение спиннера. По умолчанию включено. */
     animated?: boolean;
-    /** Custom CSS `background-color`. When set, disables the default `bg-black/25` dim. */
+    /** Свой `background-color`. Задан — дефолтный скрим `--gr-overlay-bg` снимается. */
     background?: string;
-    /** Cover the whole viewport (`position: fixed`) instead of the nearest positioned ancestor. */
+    /** Накрыть весь экран (`position: fixed`) вместо ближайшего позиционированного предка. */
     fullscreen?: boolean;
-    /** Custom `z-index`. */
-    zIndex?: number;
-    /** Extra classes appended to the overlay root. */
+    /** Имя CSS-переменной слоя — escape-hatch мимо `--gr-z-loading`. */
+    zIndexVar?: string;
+    /** Задержка показа в миллисекундах: короткая загрузка не мигает оверлеем. */
+    delay?: number;
+    /** Дополнительные классы корня оверлея. */
     customClass?: string;
 }
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
+export interface GrLoadingEmits {
+    /**
+     * Оверлей появился на экране — сразу или по истечении `delay`. По этому
+     * событию директива блокирует контент под оверлеем: до показа блокировать
+     * нечего, иначе быстрый запрос молча «замораживал» бы форму.
+     */
+    (e: 'show'): void;
+}
+type __VLS_Slots = {
+    /** Содержимое панели целиком вместо спиннера с подписью. */
+    default?: () => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
     text: undefined;
     spinner: undefined;
     spinnerClass: undefined;
+    spinnerSize: number;
+    spinnerTone: string;
     animated: boolean;
     background: undefined;
     fullscreen: boolean;
-    zIndex: undefined;
+    zIndexVar: undefined;
+    delay: number;
     customClass: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    show: () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
     text: undefined;
     spinner: undefined;
     spinnerClass: undefined;
+    spinnerSize: number;
+    spinnerTone: string;
     animated: boolean;
     background: undefined;
     fullscreen: boolean;
-    zIndex: undefined;
+    zIndexVar: undefined;
+    delay: number;
     customClass: undefined;
-}>>> & Readonly<{}>, {
+}>>> & Readonly<{
+    onShow?: (() => any) | undefined;
+}>, {
     text: string;
     background: string;
+    fullscreen: boolean;
     spinner: Component;
     spinnerClass: string;
+    spinnerSize: GrIconSize | number;
+    spinnerTone: GrIconTone;
     animated: boolean;
-    fullscreen: boolean;
-    zIndex: number;
+    zIndexVar: string;
+    delay: number;
     customClass: 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> = {
@@ -65,6 +100,11 @@ type __VLS_WithDefaults<P, D> = {
         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];
 } : {

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

@@ -1 +1 @@
-export declare const grLoadingConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrLoading">;
+export declare const grLoadingConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrLoading">;

package/dist/types/src/components/GrLoading/grLoadingStyles.d.ts

@@ -1,11 +1,19 @@
+/**
+ * Полноэкранный оверлей сидит на собственном слое шкалы: он блокирует всё
+ * приложение целиком, поэтому обязан лечь выше модалки (`--gr-z-modal`), но
+ * ниже тоста — уведомление о фоновой ошибке загрузка прятать не должна.
+ * Инлайновый режим к шкале отношения не имеет: `z-10` — порядок внутри
+ * собственного контейнера.
+ */
 export declare const rootModeClass: {
-    readonly fullscreen: "fixed inset-0 z-50";
+    readonly fullscreen: "fixed inset-0 z-[var(--gr-z-loading)]";
     readonly inline: "absolute inset-0 z-10";
 };
-export declare const rootBackgroundClass = "bg-black/25";
+export declare const rootBackgroundClass = "bg-[var(--gr-overlay-bg)]";
 export declare const rootBackdropBlurClass = "backdrop-blur-sm";
 export declare function grLoadingRootClass(options: {
     fullscreen: boolean;
     hasBackground: boolean;
     customClass?: string;
 }): string;
+export declare const grLoadingClassTokens: string[];

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

@@ -3,3 +3,4 @@ export { default as GrLoading } from './GrLoading.vue';
 export { grLoadingConfig } from './config';
 export { grLoadingSafelist } from './safelist';
 export type { GrLoadingProps } from './GrLoading.vue';
+export type { GrLoadingEmits } from './GrLoading.vue';

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

@@ -1,34 +1,80 @@
-import { type GrModalSize } from './grModalStyles';
+import { type GrModalScrollBehavior, type GrModalSize } from './grModalStyles';
+export type { GrModalScrollBehavior };
 export interface GrModalProps {
     modelValue: boolean;
     closeOnBackdrop?: boolean;
     closeOnEsc?: boolean;
     size?: GrModalSize;
+    /**
+     * Кто скроллится при длинном содержимом: весь оверлей (`outside`) или сама
+     * панель (`inside` — окно остаётся на месте, шапка и подвал на виду).
+     */
+    scrollBehavior?: GrModalScrollBehavior;
+    /**
+     * Доступное имя окна, когда заголовка в слоте `#title` нет. Слот сильнее:
+     * при нём имя даёт `aria-labelledby`.
+     */
+    ariaLabel?: string;
+    /**
+     * Элемент, получающий фокус при открытии. По умолчанию — сама панель: она
+     * фокусируема программно (`tabindex="-1"`), диктор объявляет окно целиком, а
+     * первый Tab приводит в начало содержимого.
+     */
+    initialFocus?: HTMLElement | null;
 }
-declare var __VLS_49: {}, __VLS_57: {}, __VLS_59: {};
-type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_49) => any;
-} & {
-    description?: (props: typeof __VLS_57) => any;
-} & {
-    default?: (props: typeof __VLS_59) => any;
+export interface GrModalEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    /** Окно открылось и анимация закончилась. */
+    (e: 'opened'): void;
+    /** Окно закрылось и анимация закончилась — содержимое можно размонтировать. */
+    (e: 'closed'): void;
+}
+import './defaults';
+type __VLS_Slots = {
+    default?: () => any;
+    title?: () => any;
+    description?: () => any;
+    /** Закреплённая шапка: при `inside` остаётся на месте, скроллится только тело. */
+    header?: () => any;
+    /** Закреплённый подвал: там же, где и шапка, — вне скроллящегося тела. */
+    footer?: () => any;
 };
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrModalProps>, {
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
-    size: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    size: undefined;
+    scrollBehavior: string;
+    ariaLabel: undefined;
+    initialFocus: null;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
+    opened: () => void;
+    closed: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrModalProps>, {
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
-    size: string;
+    size: undefined;
+    scrollBehavior: string;
+    ariaLabel: undefined;
+    initialFocus: null;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onOpened?: (() => any) | undefined;
+    onClosed?: (() => any) | undefined;
 }>, {
     size: GrModalSize;
-    closeOnBackdrop: boolean;
+    scrollBehavior: GrModalScrollBehavior;
+    ariaLabel: string;
+    initialFocus: HTMLElement | null;
     closeOnEsc: boolean;
+    closeOnBackdrop: 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/GrModal/config.d.ts

@@ -1 +1 @@
-export declare const grModalConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrModal">;
+export declare const grModalConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrModal">;