@feugene/granularity 0.24.1 → 0.26.0

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/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/GrForm/index.d.ts

@@ -5,6 +5,6 @@ export { default as GrForm } from './GrForm.vue';
 export { grFormConfig } from './config';
 export { type GrFormContext, useGrFormContext } from './context';
 export type { GrFormFileRule, GrFormProps, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './GrForm.vue';
-export { createGrFormMessageResolver, type GrFormMessageResolver, type GrFormMessageTranslate, type GrFormRuleFailure, runFieldRules, } from './validation';
+export { createGrFormMessageResolver, getByPath, type GrFormMessageResolver, type GrFormMessageTranslate, type GrFormRuleFailure, isEmpty, runFieldRules, setByPath, } from './validation';
 export type { GrFormEmits } from './GrForm.vue';
 export type GrFormInstance = ComponentExposed<typeof GrFormComponent>;

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

@@ -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/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;
+    }
+}

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

@@ -0,0 +1,63 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrStepStatus } from './stepsModel';
+export type GrStepsSize = GrComponentSize;
+export type GrStepsOrientation = 'horizontal' | 'vertical';
+export type GrStepsVariant = 'steps' | 'compact';
+export declare const stepsRootClass = "w-full min-w-0";
+export declare const stepsListClass: Record<GrStepsOrientation, string>;
+/**
+ * Пункт растёт по горизонтали и прижимается влево по вертикали.
+ *
+ * В горизонтальной ленте маркер стоит **над** подписью, а не слева от неё:
+ * соединитель идёт от маркера к маркеру на их высоте, и подпись сбоку он бы
+ * перечёркивал. В вертикальной колонке места по ширине хватает, там подпись
+ * справа, а линия спускается вниз.
+ */
+export declare const stepsItemClass: Record<GrStepsOrientation, string>;
+/** Отступ снизу у вертикального пункта — место, по которому идёт соединитель. */
+export declare const stepsItemConnectedClass: Record<GrStepsOrientation, string>;
+/**
+ * Кегль и метрика маркера на ступени.
+ *
+ * Шкала контрольная (`--gr-control-text-*`): шаги стоят в шапке мастера рядом с
+ * кнопками «Назад»/«Далее», и подпись обязана совпасть с ними, а не с меткой.
+ * Диаметр маркера — покомпонентный токен, потому что ступени в общей шкале для
+ * него нет: это не кегль и не радиус, а собственная метрика компонента.
+ */
+export declare const stepsSizeClassBySize: Record<GrStepsSize, string>;
+export declare const stepsTriggerClass = "min-w-0 bg-transparent focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-offset-2 focus-visible:ring-offset-[var(--gr-bg)] rounded-[var(--gr-radius-md)]";
+export declare const stepsTriggerClassByOrientation: Record<GrStepsOrientation, string>;
+/** Кликабельный шаг обязан выглядеть кликабельным — иначе о нём не догадаются. */
+export declare const stepsTriggerEnabledClass = "cursor-pointer";
+export declare const stepsMarkerClass = "inline-flex shrink-0 items-center justify-center rounded-[var(--gr-radius-full)] border font-600 leading-none h-[var(--gr-steps-marker-size)] w-[var(--gr-steps-marker-size)] text-[length:var(--gr-control-text-2xs)]";
+/**
+ * Маркер по статусу.
+ *
+ * Пройденный — сплошная заливка, текущий — обводка тем же тоном, будущий —
+ * приглушённый. Различие идёт по светлоте, а не по оттенку: три соседних цвета
+ * одного тона на одной ленте не читаются, а сплошное/полое — читается и в
+ * монохроме. `error` — единственный, кто меняет тон, и меняет его осмысленно.
+ */
+export declare const stepsMarkerClassByStatus: Record<GrStepStatus, string>;
+export declare const stepsLabelClass = "block min-w-0 font-600";
+export declare const stepsLabelClassByStatus: Record<GrStepStatus, string>;
+export declare const stepsDescriptionClass = "block mt-0.5 text-[length:var(--gr-control-text-xs)] text-[var(--gr-muted-fg)]";
+/**
+ * Соединитель между шагами.
+ *
+ * Позиция считается от диаметра маркера, а не от жёсткой высоты: маркер растёт
+ * со ступенью размера, и линия обязана оставаться на его оси. По горизонтали
+ * пункты делят ширину поровну, поэтому маркер стоит ровно по центру пункта —
+ * отсюда `50%` слева и `-50%` справа: линия идёт от края одного маркера до
+ * края соседнего.
+ */
+export declare const stepsConnectorClass: Record<GrStepsOrientation, string>;
+export declare const stepsConnectorDoneClass = "bg-[var(--gr-steps-connector-done,var(--gr-primary-solid))]";
+export declare const stepsConnectorPendingClass = "bg-[var(--gr-steps-connector-pending,var(--gr-brd))]";
+/** Компактный вариант: подпись и полоса вместо ленты. */
+export declare const stepsCompactRowClass = "flex items-baseline justify-between gap-3";
+export declare const stepsCompactCounterClass = "shrink-0 text-[length:var(--gr-control-text-xs)] text-[var(--gr-muted-fg)]";
+export declare const stepsCompactLabelClass = "min-w-0 truncate font-600 text-[var(--gr-fg)]";
+export declare const stepsCompactBarClass = "mt-2";
+export declare function grStepsMarkerClass(status: GrStepStatus): string;
+export declare function grStepsLabelClass(status: GrStepStatus): string;

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

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrStepsComponent from './GrSteps.vue';
+export { default } from './GrSteps.vue';
+export { default as GrSteps } from './GrSteps.vue';
+export { grStepsConfig } from './config';
+export type { GrStepsConfigurableProps } from './defaults';
+export type { GrStepsOrientation, GrStepsSize, GrStepsVariant } from './grStepsStyles';
+export { grStepsSafelist } from './safelist';
+export type { GrStep, GrStepStatus } from './stepsModel';
+export type { GrStepsEmits, GrStepsProps } from './GrSteps.vue';
+export type GrStepsInstance = ComponentExposed<typeof GrStepsComponent>;

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

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

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

@@ -0,0 +1,57 @@
+import type { Component } from 'vue';
+/**
+ * Правила шагового мастера — чистая арифметика без Vue.
+ *
+ * Вынесено отдельным модулем и тестируется без монтирования: «можно ли уйти на
+ * шаг N» и «какого он статуса» — вся содержательная логика компонента, и
+ * проверять её через отрендеренный DOM было бы дороже и слабее (эталон —
+ * `GrForm/validation.ts`).
+ */
+/**
+ * Состояние шага.
+ *
+ * `error` не выводится из позиции — его ставит приложение, когда шаг пройден,
+ * но не прошёл проверку. Без него мастер не умеет сказать «на втором шаге
+ * остались ошибки», ради чего гейт перехода и заводится.
+ */
+export type GrStepStatus = 'complete' | 'current' | 'upcoming' | 'error';
+export type GrStep = {
+    value: string;
+    label: string;
+    /** Вторая строка под подписью: что от пользователя ждут на этом шаге. */
+    description?: string;
+    /**
+     * Иконка вместо номера — декоративна. Vue-компонент либо класс иконки вашей
+     * UnoCSS-сборки (`i-lucide-*` требует вашего `presetIcons`).
+     */
+    icon?: string | Component;
+    /** Явный статус. Не задан — выводится из позиции относительно текущего шага. */
+    status?: GrStepStatus;
+    disabled?: boolean;
+};
+export declare function stepIndexOf(steps: readonly GrStep[], value: string): number;
+/**
+ * Статус шага: явный побеждает позиционный.
+ *
+ * Позиция даёт три состояния из четырёх, и только `error` приходит снаружи —
+ * вывести его неоткуда, ошибка живёт в форме, а не в порядке шагов.
+ */
+export declare function stepStatusAt(steps: readonly GrStep[], index: number, currentIndex: number): GrStepStatus;
+/**
+ * Можно ли уйти на шаг по его индексу.
+ *
+ * `linear` ограничивает **только движение вперёд**, и не одним шагом, а первым
+ * непройденным: вернуться назад и снова прыгнуть на тот же шаг, до которого уже
+ * дошёл, — нормальный сценарий правки заполненного мастера. Запрещать его
+ * значило бы заставлять пользователя проходить всё заново ради одной опечатки.
+ */
+export declare function canEnterStep(options: {
+    steps: readonly GrStep[];
+    index: number;
+    currentIndex: number;
+    linear: boolean;
+}): boolean;
+/** Индекс следующего доступного шага, или `-1`, если дальше идти некуда. */
+export declare function nextEnterableIndex(steps: readonly GrStep[], currentIndex: number): number;
+/** Индекс предыдущего доступного шага, или `-1`. */
+export declare function previousEnterableIndex(steps: readonly GrStep[], currentIndex: number): number;

package/dist/types/composables/internal/useMenuItemsFocus.d.ts

@@ -0,0 +1,24 @@
+export interface UseMenuItemsFocusOptions {
+    /** Корень, внутри которого живут пункты. */
+    container: () => HTMLElement | null;
+    /** Закрыть меню — `Tab` уводит фокус наружу, панель при этом закрывается. */
+    close: () => void;
+}
+export interface UseMenuItemsFocusReturn {
+    /** Пункты в порядке документа. */
+    items: () => HTMLElement[];
+    /** Сфокусировать по индексу; отрицательный и превышающий заворачиваются. */
+    focusAt: (index: number) => void;
+    /** Стрелки, `Home`/`End`, `Tab`, typeahead. `true` — клавиша обработана. */
+    onKeydown: (event: KeyboardEvent) => boolean;
+    reset: () => void;
+}
+/**
+ * Клавиатура панели-меню: кольцо фокуса плюс поиск по первым буквам.
+ *
+ * Пункты ищутся в DOM, а не в модели, и это осознанно: у панели бывает
+ * произвольное содержимое из слота, в котором ключей нет вовсе. По той же
+ * причине здесь не `useRovingFocus` — он адресуется ключами и ведёт
+ * `tabindex="0"` на активном элементе, а пункты меню обязаны быть `-1`.
+ */
+export declare function useMenuItemsFocus(options: UseMenuItemsFocusOptions): UseMenuItemsFocusReturn;

package/dist/types/composables/internal/useTypeahead.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Буфер живёт ровно столько: дальше набранное перестаёт быть одним словом.
+ * Значение из WAI-ARIA APG, оно же стояло во всех трёх прежних копиях.
+ */
+export declare const TYPEAHEAD_RESET_MS = 600;
+export interface UseTypeaheadOptions<TItem> {
+    /** Кандидаты в порядке отображения. Опрашивается на каждый символ. */
+    items: () => readonly TItem[];
+    /** Текст кандидата. Нормализацию (`trim` + нижний регистр) делает композабл. */
+    textOf: (item: TItem, index: number) => string;
+    /** Откуда шагать. Получает уже разрешённый набор, чтобы не опрашивать его дважды. */
+    currentIndex: (items: readonly TItem[]) => number;
+    /** Совпадение найдено. Фокус, `activeIndex` — решает потребитель. */
+    onMatch: (item: TItem, index: number) => void;
+    resetMs?: number;
+}
+export interface UseTypeaheadReturn {
+    /** Обработать печатный символ. `true` — совпадение найдено. */
+    type: (char: string) => boolean;
+    /** Пуст ли буфер: правило «`Space` при пустом буфере активирует пункт». */
+    isEmpty: () => boolean;
+    reset: () => void;
+}
+/**
+ * Поиск по первым буквам в списке — паттерн `typeahead` из WAI-ARIA APG.
+ *
+ * Буфер намеренно не реактивный: на рендер он не влияет, а читается синхронно
+ * внутри обработчика `keydown`.
+ */
+export declare function useTypeahead<TItem>(options: UseTypeaheadOptions<TItem>): UseTypeaheadReturn;

package/dist/types/composables/useFloating.d.ts

@@ -1,6 +1,35 @@
 import type { CSSProperties, Ref } from 'vue';
-import type { Placement } from '@floating-ui/dom';
+import type { Placement, VirtualElement } from '@floating-ui/dom';
 export type UseFloatingPlacement = Placement;
+/**
+ * Прямоугольник в координатах вьюпорта — якорь, которого нет в DOM.
+ *
+ * Точка курсора описывается прямоугольником `0×0`. Размеры необязательны именно
+ * поэтому: контекстное меню, открытое с клавиатуры, встаёт у **прямоугольника**
+ * сфокусированной строки, а не у её угла, и переворачивается вместе с ней.
+ */
+export interface GrFloatingAnchorRect {
+    x: number;
+    y: number;
+    /** По умолчанию 0. */
+    width?: number;
+    /** По умолчанию 0. */
+    height?: number;
+}
+/** Ссылка позиционирования: элемент, виртуальный якорь или ничего. */
+export type UseFloatingReference = HTMLElement | VirtualElement | null;
+/**
+ * Виртуальный якорь: объект создаётся один раз, координаты читает геттер на
+ * каждом измерении.
+ *
+ * Стабильность объекта здесь не стилистика, а условие работы: `useFloating`
+ * пересоздаёт подписку `autoUpdate` при смене самой ссылки, поэтому новый объект
+ * на каждое движение курсора рвал бы и заводил её заново. С одним объектом смена
+ * точки — это просто `update()`.
+ */
+export declare function createFloatingAnchor(get: () => GrFloatingAnchorRect | null | undefined, options?: {
+    contextElement?: () => Element | null | undefined;
+}): VirtualElement;
 export interface UseFloatingOptions {
     /**
      * Предпочитаемое место панели относительно триггера. По умолчанию `bottom-start`.
@@ -19,6 +48,8 @@ export interface UseFloatingOptions {
      * - `'min'` — панель растёт по контенту (`width: max-content`), но не уже триггера
      *   (`min-width = ширина триггера`) — режим `GrSelect view="link"`;
      * - функция-геттер — как и `placement`, для реактивной зависимости от пропа.
+     *
+     * С виртуальным якорем не работает: ширина точки равна нулю.
      */
     matchWidth?: boolean | 'min' | (() => boolean | 'min');
     /**
@@ -54,4 +85,4 @@ export interface UseFloatingReturn {
  * `<teleport to="body">` + `v-show`, а не `v-if`): позиционирование не может измерить
  * элемент, которого нет в дереве.
  */
-export declare function useFloating(referenceEl: Ref<HTMLElement | null>, floatingEl: Ref<HTMLElement | null>, open: Ref<boolean>, options?: UseFloatingOptions): UseFloatingReturn;
+export declare function useFloating(reference: Ref<HTMLElement | null> | (() => UseFloatingReference), floatingEl: Ref<HTMLElement | null>, open: Ref<boolean>, options?: UseFloatingOptions): UseFloatingReturn;

package/dist/types/granular-provider/shared.d.ts

@@ -23,12 +23,15 @@ export declare const granularityComponentConfigs: {
     GrCard: GranularComponentDescriptor<"GrCard">;
     GrCheckbox: GranularComponentDescriptor<"GrCheckbox">;
     GrCheckboxGroup: GranularComponentDescriptor<"GrCheckboxGroup">;
+    GrChip: GranularComponentDescriptor<"GrChip">;
+    GrChipGroup: GranularComponentDescriptor<"GrChipGroup">;
     GrCodeBlock: GranularComponentDescriptor<"GrCodeBlock">;
     GrCollapse: GranularComponentDescriptor<"GrCollapse">;
     GrColorPicker: GranularComponentDescriptor<"GrColorPicker">;
     GrCommandPalette: GranularComponentDescriptor<"GrCommandPalette">;
     GrConfigProvider: GranularComponentDescriptor<"GrConfigProvider">;
     GrConfirmDialog: GranularComponentDescriptor<"GrConfirmDialog">;
+    GrContextMenu: GranularComponentDescriptor<"GrContextMenu">;
     GrDataTable: GranularComponentDescriptor<"GrDataTable">;
     GrDelta: GranularComponentDescriptor<"GrDelta">;
     GrDescriptionList: GranularComponentDescriptor<"GrDescriptionList">;
@@ -74,6 +77,7 @@ export declare const granularityComponentConfigs: {
     GrSortableList: GranularComponentDescriptor<"GrSortableList">;
     GrSplitter: GranularComponentDescriptor<"GrSplitter">;
     GrStatistic: GranularComponentDescriptor<"GrStatistic">;
+    GrSteps: GranularComponentDescriptor<"GrSteps">;
     GrSwitch: GranularComponentDescriptor<"GrSwitch">;
     GrTable: GranularComponentDescriptor<"GrTable">;
     GrTabPanels: GranularComponentDescriptor<"GrTabPanels">;