@feugene/granularity 0.23.0 → 0.25.0

package/dist/types/components/GrContextMenu/GrContextMenu.vue.d.ts

@@ -0,0 +1,157 @@
+import type { GrDropdownMenuAction, GrDropdownMenuEntry } from '../GrDropdownMenu/menuModel';
+import type { GrFloatingAnchorRect, UseFloatingPlacement } from '../../composables/useFloating';
+/** Чем открывается меню. `manual` — только императивно, из кода потребителя. */
+export type GrContextMenuTrigger = 'contextmenu' | 'manual';
+/** Откуда пришло открытие: указатель, клавиатура или вызов из кода. */
+export type GrContextMenuSource = 'pointer' | 'keyboard' | 'api';
+export interface GrContextMenuOpenContext {
+    source: GrContextMenuSource;
+    /** По чему кликнули или что было в фокусе — отсюда потребитель берёт строку. */
+    target: HTMLElement | null;
+    anchor: GrFloatingAnchorRect;
+    event: MouseEvent | KeyboardEvent | null;
+}
+export interface GrContextMenuProps {
+    /** Декларативное меню. Слот `#content` сильнее. */
+    items?: GrDropdownMenuEntry[];
+    /** Открыто ли меню. Без пропа компонент ведёт состояние сам. */
+    open?: boolean;
+    trigger?: GrContextMenuTrigger;
+    disabled?: boolean;
+    placement?: UseFloatingPlacement;
+    /** Зазор от якоря. Ноль по умолчанию: меню липнет к курсору. */
+    offsetPx?: number;
+    /** Меню из коротких слов не должно быть шириной в слово. */
+    minWidth?: number | string;
+    ariaLabel?: string;
+    labelledBy?: string;
+    teleportTo?: string | HTMLElement;
+    contentClass?: string;
+    listClass?: string;
+    dividers?: boolean;
+    /**
+     * Закрывать при прокрутке страницы. Якорь — точка вьюпорта, и панель осталась
+     * бы висеть на экране, пока контент под ней уезжает. Так же ведут себя
+     * нативные меню.
+     */
+    closeOnScroll?: boolean;
+    /** Пропускать `Shift`+правый клик к браузеру. */
+    allowNativeMenu?: boolean;
+}
+export interface GrContextMenuEmits {
+    (e: 'update:open', value: boolean): void;
+    /**
+     * Меню собирается открыться у этой цели. Приходит **до** открытия, чтобы
+     * потребитель успел пересобрать `items` под неё: пункты для папки и для файла
+     * разные, а узнать цель иначе неоткуда. Пустая модель после этого просто не
+     * откроется — отдельный способ отменить открытие не нужен.
+     */
+    (e: 'beforeOpen', context: GrContextMenuOpenContext): void;
+    (e: 'select', item: GrDropdownMenuAction): void;
+}
+/** Открыть у точки курсора или у произвольного прямоугольника вьюпорта. */
+declare function openAt(at: MouseEvent | GrFloatingAnchorRect): void;
+/** Открыть у прямоугольника элемента — клавиатурный путь для внешних композитов. */
+declare function openAtElement(element: Element): void;
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
+declare var __VLS_1: {
+    open: boolean;
+}, __VLS_22: {
+    close: () => void;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    content?: (props: typeof __VLS_22) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrContextMenuProps>, {
+    items: undefined;
+    open: undefined;
+    trigger: string;
+    disabled: boolean;
+    placement: string;
+    offsetPx: number;
+    minWidth: string;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    teleportTo: undefined;
+    contentClass: undefined;
+    listClass: undefined;
+    dividers: boolean;
+    closeOnScroll: boolean;
+    allowNativeMenu: boolean;
+}>>, {
+    openAt: typeof openAt;
+    openAtElement: typeof openAtElement;
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+    beforeOpen: (context: GrContextMenuOpenContext) => void;
+    select: (item: GrDropdownMenuAction) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrContextMenuProps>, {
+    items: undefined;
+    open: undefined;
+    trigger: string;
+    disabled: boolean;
+    placement: string;
+    offsetPx: number;
+    minWidth: string;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    teleportTo: undefined;
+    contentClass: undefined;
+    listClass: undefined;
+    dividers: boolean;
+    closeOnScroll: boolean;
+    allowNativeMenu: boolean;
+}>>> & Readonly<{
+    onSelect?: ((item: GrDropdownMenuAction) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onBeforeOpen?: ((context: GrContextMenuOpenContext) => any) | undefined;
+}>, {
+    minWidth: number | string;
+    placement: UseFloatingPlacement;
+    open: boolean;
+    disabled: boolean;
+    ariaLabel: string;
+    items: GrDropdownMenuEntry[];
+    labelledBy: string;
+    offsetPx: number;
+    trigger: GrContextMenuTrigger;
+    teleportTo: string | HTMLElement;
+    contentClass: string;
+    dividers: boolean;
+    listClass: string;
+    closeOnScroll: boolean;
+    allowNativeMenu: 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/components/GrContextMenu/config.d.ts

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

package/dist/types/components/GrContextMenu/contextMenuAnchor.d.ts

@@ -0,0 +1,29 @@
+import type { GrFloatingAnchorRect } from '../../composables/useFloating';
+/** Точка курсора — якорь нулевого размера. */
+export declare function anchorFromPointer(event: MouseEvent): GrFloatingAnchorRect;
+/**
+ * Прямоугольник элемента — якорь клавиатурного вызова.
+ *
+ * Не угол и не точка: меню, вызванное с клавиатуры, принадлежит **строке**, и
+ * при нехватке места снизу обязано перевернуться относительно неё целиком.
+ */
+export declare function anchorFromElement(element: Element): GrFloatingAnchorRect;
+/**
+ * `contextmenu` пришёл с клавиатуры, а не от мыши.
+ *
+ * Браузеры порождают это событие и для `Shift+F10`, но координаты в нём
+ * бесполезны: то угол элемента, то нули. Признаков два сразу, потому что по
+ * отдельности каждый ошибается — правый клик всегда `button === 2`, а
+ * клавиатурный вызов всегда без «числа кликов».
+ */
+export declare function isKeyboardContextMenu(event: MouseEvent): boolean;
+/**
+ * Пользователь просит нативное меню браузера.
+ *
+ * `Shift`+правый клик — де-факто escape-hatch, в Firefox задокументированный.
+ * `ctrlKey` сюда не входит намеренно: на macOS Ctrl+клик **и есть** правый
+ * клик, и меню перестало бы открываться у части пользователей.
+ */
+export declare function wantsNativeMenu(event: MouseEvent): boolean;
+/** Клавиатурный запрос контекстного меню: `Shift+F10` или клавиша `ContextMenu`. */
+export declare function isContextMenuKey(event: KeyboardEvent): boolean;

package/dist/types/components/GrContextMenu/index.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrContextMenuComponent from './GrContextMenu.vue';
+export { default } from './GrContextMenu.vue';
+export { default as GrContextMenu } from './GrContextMenu.vue';
+export type { GrContextMenuEmits, GrContextMenuOpenContext, GrContextMenuProps, GrContextMenuSource, GrContextMenuTrigger, } from './GrContextMenu.vue';
+export { grContextMenuConfig } from './config';
+export type GrContextMenuInstance = ComponentExposed<typeof GrContextMenuComponent>;

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

@@ -178,13 +178,13 @@ export interface GrDataTableEmits<TRow extends Record<string, unknown> = Record<
 }
 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> & {
+        "onUpdate:selected"?: ((value: (string | number)[]) => any) | undefined;
         "onUpdate:sortKey"?: ((value: string) => any) | undefined;
         "onUpdate:sortDir"?: ((value: GrDataTableSortDir) => any) | undefined;
         onSortChange?: ((value: {
             key: string;
             dir: GrDataTableSortDir;
         }) => any) | undefined;
-        "onUpdate:selected"?: ((value: (string | number)[]) => any) | undefined;
         onRowClick?: ((payload: {
             row: TRow;
             index: number;

package/dist/types/components/GrDelta/grDeltaStyles.d.ts

@@ -14,8 +14,20 @@ import type { GrDeltaTone } from './deltaTone';
  * читается как опечатка. Отбивку получают только стрелка и суффикс.
  */
 export declare const deltaRootClass = "inline-flex items-baseline tabular-nums";
+/**
+ * Величина стоит **в строке текста**, и приписка при ней приглушения не
+ * получает: «−15 %» набирается кеглем и цветом строки целиком, иначе процент
+ * оказывается мельче окружающих слов.
+ *
+ * Дефолт `GrValue` рассчитан на плитку, где величина крупная и приписке есть
+ * куда уменьшаться. Здесь он переопределяется — ровно теми же токенами, что
+ * доступны потребителю.
+ *
+ * `currentColor` и `1em`, а не `inherit`: у пользовательского свойства
+ * `inherit` значит «наследовать саму переменную», то есть ничего.
+ */
+export declare const deltaValueStyle: Record<string, string>;
 /** Суффикс — единица измерения, и от числа он отбивается: «−15 %», «120 мс». */
-export declare const deltaSuffixClass = "ml-1";
 /**
  * Стрелка выравнивается по строке, а не по базовой линии: у svg её нет.
  *

package/dist/types/components/GrDescriptionList/grDescriptionListStyles.d.ts

@@ -18,7 +18,35 @@ export declare const descriptionRootClass = "m-0 gap-x-4 [row-gap:var(--gr-descr
 /** Сетка колонок — раскладки `inline` и `stacked`. */
 export declare const descriptionRootGridClass = "grid";
 export declare const descriptionRootFlowClass = "flex flex-wrap items-baseline";
-export declare const descriptionColumnsClass: Record<GrDescriptionColumns, string>;
+/** Одна колонка — обычный класс: считать там нечего. */
+export declare const descriptionSingleColumnClass = "grid-cols-1";
+/**
+ * Колонки по ширине **контейнера**, а не вьюпорта.
+ *
+ * Медиазапрос меряет экран, а список живёт в карточке: на широком мониторе в
+ * колонке 290px включались две колонки, подпись фиксированной ширины съедала
+ * почти всё место, и значение переносилось посимвольно — «30» печаталось как
+ * «3» и «0» на двух строках. Показанное число становилось неверным.
+ *
+ * `auto-fit` решает это без медиазапросов, без JS и без замеров, то есть
+ * одинаково на сервере и на клиенте. `columns` при этом становится **потолком**:
+ * трек не уже `column-min`, но и не уже доли, на которую делится контейнер при
+ * N колонках, — поэтому шире N штук не встанет никогда.
+ *
+ * `min(100%, …)` спасает совсем узкий контейнер: без него трек шириной с
+ * `column-min` вылезал бы за край.
+ *
+ * Инлайновым стилем, а не классом: выражение зависит от N, и шкалы утилит для
+ * него не существует — тот же довод, что записан у сетки `GrDashboard`.
+ */
+export declare function descriptionColumnsStyle(columns: GrDescriptionColumns, 
+/**
+ * Ширина колонки подписей при `inline`. В этой раскладке подпись и значение
+ * стоят **рядом**, поэтому минимум колонки складывается из них двоих: колонка
+ * шириной с одну подпись оставляет значению несколько пикселей, и оно
+ * переносится посимвольно — тот же дефект, только в других числах.
+ */
+labelWidth?: string): Record<string, string>;
 export declare const descriptionPairInlineClass = "flex min-w-0 items-baseline gap-2";
 export declare const descriptionPairStackedClass = "min-w-0";
 export declare const descriptionPairFlowClass = "flex min-w-0 items-baseline gap-1";

package/dist/types/components/GrDropdownMenu/GrDropdownMenu.vue.d.ts

@@ -1,7 +1,7 @@
 import type { GrDropdownTrigger } from '../GrDropdown/GrDropdown.vue';
 import type { GrDropdownWidth } from '../GrDropdown/grDropdownStyles';
 import type { UseFloatingPlacement } from '../../composables/useFloating';
-import { type GrDropdownMenuAction, type GrDropdownMenuEntry } from './menuModel';
+import type { GrDropdownMenuAction, GrDropdownMenuEntry } from './menuModel';
 export interface GrDropdownMenuProps {
     /** Размещение панели относительно триггера; переворот при нехватке места остаётся. */
     placement?: UseFloatingPlacement;
@@ -122,10 +122,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     closeOnContentClick: boolean;
     teleportTo: string | HTMLElement;
     contentClass: string;
-    openDelay: number;
-    closeDelay: number;
     dividers: boolean;
     listClass: string;
+    openDelay: number;
+    closeDelay: number;
 }, {}, {}, {}, 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/components/GrDropdownMenu/GrDropdownMenuEntries.vue.d.ts

@@ -0,0 +1,22 @@
+import type { GrDropdownMenuAction, GrDropdownMenuEntry } from './menuModel';
+export interface GrDropdownMenuEntriesProps {
+    items?: GrDropdownMenuEntry[];
+}
+export interface GrDropdownMenuEntriesEmits {
+    (e: 'select', item: GrDropdownMenuAction): void;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrDropdownMenuEntriesProps>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: GrDropdownMenuAction) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrDropdownMenuEntriesProps>>> & Readonly<{
+    onSelect?: ((item: GrDropdownMenuAction) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+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;
+    };
+};

package/dist/types/components/GrFilePreview/GrFilePreview.vue.d.ts

@@ -70,12 +70,12 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     tileSize: GrSizeWithPx;
     ratio: GrFilePreviewRatio;
     loading: "lazy" | "eager";
+    clickable: boolean;
     name: string | null;
     href: string;
     ariaLabel: string;
     src: string | null;
     as: string | Component;
-    clickable: boolean;
     mime: string | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -55,12 +55,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
     density: GrListItemDensity;
+    clickable: boolean;
     title: string;
     description: string;
     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>;

package/dist/types/components/GrPopover/GrPopover.vue.d.ts

@@ -1,5 +1,5 @@
-import { type UseFloatingPlacement } from '../../composables/useFloating';
-import { type GrPopoverRole, type GrPopoverSize } from './grPopoverStyles';
+import { type GrFloatingAnchorRect, type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrPopoverPadding, type GrPopoverRole, type GrPopoverSize } from './grPopoverStyles';
 export interface GrPopoverProps {
     /**
      * Открыт ли поповер. Без этого пропа компонент ведёт состояние сам
@@ -48,6 +48,19 @@ export interface GrPopoverProps {
     teleportTo?: string | HTMLElement;
     contentClass?: string;
     disabled?: boolean;
+    /**
+     * Якорь-прямоугольник в координатах вьюпорта вместо обёртки слота `#trigger`:
+     * панель встаёт у точки курсора или у строки списка. Нужен контекстному меню,
+     * у которого триггера-элемента нет вовсе.
+     *
+     * `triggerProps` в этом режиме некому потребить, и своих ARIA-атрибутов
+     * поповер никуда не вешает: `aria-haspopup` невалиден вне интерактивного
+     * элемента, а `aria-expanded` без хозяина — шум. Связь с содержимым страницы
+     * объявляет тот, кто открывает.
+     */
+    anchor?: GrFloatingAnchorRect | null;
+    /** Поле панели. `none` — содержимое рисует своё (меню, список опций). */
+    padding?: GrPopoverPadding;
 }
 export interface GrPopoverEmits {
     (e: 'update:open', value: boolean): void;
@@ -90,6 +103,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     teleportTo: undefined;
     contentClass: undefined;
     disabled: boolean;
+    anchor: undefined;
+    padding: string;
 }>>, {
     open: typeof open;
     close: typeof close;
@@ -113,10 +128,14 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     teleportTo: undefined;
     contentClass: undefined;
     disabled: boolean;
+    anchor: undefined;
+    padding: string;
 }>>> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
     size: GrPopoverSize;
+    padding: GrPopoverPadding;
+    anchor: GrFloatingAnchorRect | null;
     role: GrPopoverRole;
     modal: boolean;
     placement: UseFloatingPlacement;

package/dist/types/components/GrPopover/grPopoverStyles.d.ts

@@ -10,6 +10,8 @@ export type GrPopoverSize = GrComponentSize;
  * потому что клавиатурный паттерн принадлежит ему, а не поповеру.
  */
 export type GrPopoverRole = 'dialog' | 'menu' | 'listbox' | 'grid' | 'group' | 'none';
+/** Поле панели. `none` — поле рисует содержимое (меню, список опций). */
+export type GrPopoverPadding = 'default' | 'none';
 export declare const panelSizes: Record<GrPopoverSize, string>;
 /**
  * `transform-origin` для scale-анимации: координаты панели уже посчитал
@@ -24,5 +26,13 @@ export declare function grPopoverOriginClass(placement: Placement): string;
  * Поверхность панели. `max-w-[min(...)]` не даёт поповеру вылезти за узкий
  * экран: `useFloating` смещает панель в пределах viewport, но не сужает её.
  */
+/**
+ * Кегль без поля.
+ *
+ * Отдельная мапа, а не `contentClass="p-0"`: поле и кегль приезжают одной
+ * строкой равной специфичности, и кто победит — решал бы порядок правил в
+ * сгенерированном CSS. Меню внутри поповера с `p-3` — визуально не меню.
+ */
+export declare const panelSizesFlush: Record<GrPopoverSize, string>;
 export declare const popoverPanelBaseClass = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-popover)] text-[var(--gr-popover-fg)] shadow-[var(--gr-shadow-2)] max-w-[min(22rem,calc(100vw-1rem))] focus:outline-none";
-export declare function grPopoverPanelClass(size: GrPopoverSize, placement: Placement, extra?: string): string;
+export declare function grPopoverPanelClass(size: GrPopoverSize, placement: Placement, extra?: string, padding?: GrPopoverPadding): string;

package/dist/types/components/GrPopover/index.d.ts

@@ -5,7 +5,7 @@ export { default as GrPopover } from './GrPopover.vue';
 export type { GrPopoverProps } from './GrPopover.vue';
 export { grPopoverConfig } from './config';
 export type { GrPopoverConfigurableProps } from './defaults';
-export type { GrPopoverRole, GrPopoverSize } from './grPopoverStyles';
+export type { GrPopoverPadding, GrPopoverRole, GrPopoverSize } from './grPopoverStyles';
 export { grPopoverSafelist } from './safelist';
 export type { GrPopoverEmits } from './GrPopover.vue';
 export type GrPopoverInstance = ComponentExposed<typeof GrPopoverComponent>;

package/dist/types/components/GrStatistic/GrStatistic.vue.d.ts

@@ -71,19 +71,19 @@ export interface GrStatisticProps {
 export interface GrStatisticEmits {
     (e: 'click', event: MouseEvent): void;
 }
-declare var __VLS_10: {}, __VLS_23: {}, __VLS_42: {}, __VLS_44: {}, __VLS_46: {}, __VLS_48: {};
+declare var __VLS_10: {}, __VLS_23: {}, __VLS_49: {}, __VLS_51: {}, __VLS_55: {}, __VLS_57: {};
 type __VLS_Slots = {} & {
     icon?: (props: typeof __VLS_10) => any;
 } & {
     title?: (props: typeof __VLS_23) => any;
 } & {
-    prefix?: (props: typeof __VLS_42) => any;
+    prefix?: (props: typeof __VLS_49) => any;
 } & {
-    default?: (props: typeof __VLS_44) => any;
+    default?: (props: typeof __VLS_51) => any;
 } & {
-    suffix?: (props: typeof __VLS_46) => any;
+    suffix?: (props: typeof __VLS_55) => any;
 } & {
-    trend?: (props: typeof __VLS_48) => any;
+    trend?: (props: typeof __VLS_57) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStatisticProps>, {
     title: undefined;
@@ -134,6 +134,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     size: GrStatisticSize;
     polarity: GrDeltaPolarity;
     loading: boolean;
+    clickable: boolean;
     title: string;
     icon: string | Component;
     animate: boolean;
@@ -141,7 +142,6 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     prefix: string;
     suffix: string;
     as: string | Component;
-    clickable: boolean;
     locale: string;
     precision: number;
     decimalSeparator: string;

package/dist/types/components/GrStatistic/grStatisticStyles.d.ts

@@ -13,6 +13,15 @@ export type GrStatisticTrend = 'up' | 'down' | 'flat';
 export declare const statisticTitleSizeBySize: Record<GrStatisticSize, string>;
 export declare const statisticValueSizeBySize: Record<GrStatisticSize, string>;
 export declare const statisticAffixSizeBySize: Record<GrStatisticSize, string>;
+/**
+ * Кегль приписки — значением токена, а не классом: он уезжает в
+ * `--gr-value-suffix-size`, которым `GrValue` и набирает суффикс.
+ *
+ * Ступень шкалы, а не доля от величины: у плитки шкала размеров своя, и на
+ * ступени `md` число крупное (`--gr-text-3xl`), а приписка при нём обязана
+ * остаться подписью. Доля дала бы её вровень с числом.
+ */
+export declare const statisticAffixSizeVarBySize: Record<GrStatisticSize, string>;
 export declare const statisticPlaceholderHeightBySize: Record<GrStatisticSize, string>;
 export declare const statisticTrendSizeBySize: Record<GrStatisticSize, string>;
 export declare const statisticValueClassByTone: Record<GrStatisticTone, string>;

package/dist/types/components/GrSteps/GrSteps.vue.d.ts

@@ -0,0 +1,118 @@
+import type { GrStepsOrientation, GrStepsSize, GrStepsVariant } from './grStepsStyles';
+import type { GrStep, GrStepStatus } from './stepsModel';
+/**
+ * Индикатор шагов многошагового мастера.
+ *
+ * По семантике это **навигация**, а не составной виджет выбора: `<nav>` со
+ * списком, где пройденный шаг — кнопка со своей остановкой `Tab`, текущий —
+ * `aria-current="step"`, будущий — вне таб-порядка. Той же формы держатся
+ * `GrBreadcrumbs` и `GrBottomNav`; `role="tab"` здесь неприменим — tablist без
+ * `tabpanel` это сломанный паттерн, а панель шага никакой роли не несёт.
+ *
+ * Контент шага компонент не рисует: его ставит потребитель обычным `v-if`.
+ */
+export interface GrStepsProps {
+    modelValue: string;
+    steps: GrStep[];
+    orientation?: GrStepsOrientation;
+    size?: GrStepsSize;
+    /** Компактный вид для узкой колонки: подпись текущего шага и полоса прогресса. */
+    variant?: GrStepsVariant;
+    /**
+     * Вперёд — не дальше первого непройденного. Назад свободно всегда: вернуться
+     * и поправить заполненное — обычный сценарий, а не обход правила.
+     */
+    linear?: boolean;
+    /** Переход кликом по шагу. Выключен — лента становится только индикатором. */
+    clickable?: boolean;
+    ariaLabel?: string;
+    /**
+     * Гейт перехода. Вернул `false` — перехода нет.
+     *
+     * Сюда потребитель кладёт валидацию шага: `GrSteps` про `GrForm` ничего не
+     * знает и знать не должен, а форма уже отдаёт `validate()`/`validateField()`.
+     */
+    beforeLeave?: (from: string, to: string) => boolean | Promise<boolean>;
+}
+export interface GrStepsEmits {
+    (e: 'update:modelValue', value: string): void;
+    (e: 'change', value: string): void;
+}
+type __VLS_Slots = {
+    /**
+     * Своя разметка пункта. Корневой тег, `aria-current` и клик остаются за
+     * компонентом — иначе доступность шага пришлось бы собирать заново.
+     */
+    step?: (props: {
+        step: GrStep;
+        index: number;
+        status: GrStepStatus;
+        enterable: boolean;
+    }) => unknown;
+};
+declare function next(): Promise<boolean>;
+declare function back(): Promise<boolean>;
+declare function goTo(value: string): Promise<boolean>;
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStepsProps>, {
+    orientation: undefined;
+    size: undefined;
+    variant: undefined;
+    linear: undefined;
+    clickable: undefined;
+    ariaLabel: undefined;
+    beforeLeave: undefined;
+}>>, {
+    next: typeof next;
+    back: typeof back;
+    goTo: typeof goTo;
+    isFirst: import("vue").ComputedRef<boolean>;
+    isLast: import("vue").ComputedRef<boolean>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => void;
+    change: (value: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStepsProps>, {
+    orientation: undefined;
+    size: undefined;
+    variant: undefined;
+    linear: undefined;
+    clickable: undefined;
+    ariaLabel: undefined;
+    beforeLeave: undefined;
+}>>> & Readonly<{
+    onChange?: ((value: string) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    variant: GrStepsVariant;
+    size: GrStepsSize;
+    orientation: GrStepsOrientation;
+    linear: boolean;
+    clickable: boolean;
+    ariaLabel: string;
+    beforeLeave: (from: string, to: string) => boolean | Promise<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/components/GrSteps/config.d.ts

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

package/dist/types/components/GrSteps/defaults.d.ts

@@ -0,0 +1,18 @@
+import type { GrStepsOrientation, GrStepsSize, GrStepsVariant } from './grStepsStyles';
+/**
+ * Пропы `GrSteps`, настраиваемые глобально через `componentDefaults`.
+ * Оформление и правило перехода — то, что приложение задаёт один раз на все
+ * мастера; текущий шаг относится к экземпляру и сюда не входит.
+ */
+export interface GrStepsConfigurableProps {
+    size: GrStepsSize;
+    orientation: GrStepsOrientation;
+    variant: GrStepsVariant;
+    linear: boolean;
+    clickable: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrSteps: GrStepsConfigurableProps;
+    }
+}