@feugene/granularity 0.12.0 → 0.16.0

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

@@ -1,17 +1,42 @@
-import { type GrDropdownAlign, type GrDropdownWidth } from './grDropdownStyles';
+import { type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrDropdownWidth } from './grDropdownStyles';
+export type GrDropdownTrigger = 'click' | 'hover';
 export interface GrDropdownProps {
-    /** Выравнивание панели относительно триггера. */
-    align?: GrDropdownAlign;
-    /** Ширина панели (tailwind-токены `w-*` или `auto`). */
+    /** Размещение панели относительно триггера; `flip` при нехватке места остаётся. */
+    placement?: UseFloatingPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offset?: number;
+    /** Ширина панели: число — пиксели, строка — CSS-длина, `auto` — по контенту. */
     width?: GrDropdownWidth;
+    /** Чем открывается панель. В любом режиме работают клик и клавиатура. */
+    trigger?: GrDropdownTrigger;
+    /** Задержка открытия по наведению, мс. */
+    openDelay?: number;
+    /** Задержка закрытия после ухода курсора, мс. */
+    closeDelay?: number;
+    /** Панель не открывается ничем; триггер остаётся фокусируемым. */
+    disabled?: boolean;
     /** Закрывать панель по клику внутри content. */
     closeOnContentClick?: boolean;
     /** Дополнительные классы контейнера content. */
     contentClass?: string;
-    /** Куда телепортировать панель (`body` по умолчанию). */
+    /**
+     * Точечное переопределение точки монтирования. По умолчанию — общий портал
+     * оверлеев (`#gr-portal` либо `portalTarget` из `GrConfigProvider`).
+     */
     teleportTo?: string | HTMLElement;
+    /**
+     * Контролируемое состояние панели (`v-model:open`). Без пропа панель ведёт
+     * себя сама (uncontrolled), с ним — слушайте `update:open` и меняйте проп.
+     */
+    open?: boolean;
+}
+export interface GrDropdownEmits {
+    /** Панель открылась/закрылась (`v-model:open`). */
+    (e: 'update:open', value: boolean): void;
 }
 declare function onTriggerKeydown(event: KeyboardEvent): void;
+declare function open(): void;
 declare function toggle(): void;
 declare function close(): void;
 declare var __VLS_1: {
@@ -22,6 +47,8 @@ declare var __VLS_1: {
         'aria-haspopup': "menu";
         'aria-expanded': boolean;
         'aria-controls': string | undefined;
+        'aria-disabled': boolean | undefined;
+        onClick: typeof toggle;
         onKeydown: typeof onTriggerKeydown;
     };
 }, __VLS_15: {
@@ -33,23 +60,49 @@ type __VLS_Slots = {} & {
     content?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownProps>, {
-    align: string;
+    placement: string;
+    offset: number;
     width: string;
+    trigger: string;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
     closeOnContentClick: boolean;
     contentClass: string;
-    teleportTo: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownProps>, {
-    align: string;
+    teleportTo: undefined;
+    open: undefined;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownProps>, {
+    placement: string;
+    offset: number;
     width: string;
+    trigger: string;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
     closeOnContentClick: boolean;
     contentClass: string;
-    teleportTo: string;
-}>>> & Readonly<{}>, {
+    teleportTo: undefined;
+    open: undefined;
+}>>> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
     width: GrDropdownWidth;
-    align: GrDropdownAlign;
+    offset: number;
+    placement: UseFloatingPlacement;
+    open: boolean;
+    disabled: boolean;
+    trigger: GrDropdownTrigger;
     closeOnContentClick: boolean;
-    contentClass: string;
     teleportTo: string | HTMLElement;
+    contentClass: 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/src/components/GrDropdown/config.d.ts

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

package/dist/types/src/components/GrDropdown/grDropdownStyles.d.ts

@@ -1,8 +1,7 @@
 import type { Placement } from '@floating-ui/dom';
-export type GrDropdownAlign = 'left' | 'right' | 'center';
-export type GrDropdownWidth = 'auto' | '20' | '48' | '60' | '64' | '80';
-export declare const widthClassByWidth: Record<GrDropdownWidth, string>;
-export declare const originClassByPlacement: Partial<Record<Placement, string>>;
-export declare function grDropdownWidthClass(width: GrDropdownWidth): string;
+/** Ширина панели: число — пиксели, строка — CSS-длина, `auto` — по контенту. */
+export type GrDropdownWidth = number | string;
+export declare const originClassByPlacement: Record<Placement, string>;
 export declare function grDropdownOriginClass(placement: Placement): string;
+export declare const dropdownContentBaseClass = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-card)] text-[var(--gr-card-fg)] shadow-[var(--gr-shadow-2)] p-1";
 export declare function grDropdownContentClass(contentClass?: string): string;

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

@@ -1,6 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrDropdownComponent from './GrDropdown.vue';
 export { default } from './GrDropdown.vue';
 export { default as GrDropdown } from './GrDropdown.vue';
 export { grDropdownConfig } from './config';
 export { grDropdownSafelist } from './safelist';
-export type { GrDropdownProps } from './GrDropdown.vue';
-export type { GrDropdownAlign, GrDropdownWidth } from './grDropdownStyles';
+export type { GrDropdownEmits, GrDropdownProps, GrDropdownTrigger } from './GrDropdown.vue';
+export type { GrDropdownWidth } from './grDropdownStyles';
+export type GrDropdownInstance = ComponentExposed<typeof GrDropdownComponent>;

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

@@ -1,14 +1,34 @@
-export type GrDropdownMenuAlign = 'left' | 'right' | 'center';
-export type GrDropdownMenuWidth = 'auto' | '20' | '48' | '60' | '64' | '80';
+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';
 export interface GrDropdownMenuProps {
-    /** Выравнивание панели относительно триггера. */
-    align?: GrDropdownMenuAlign;
-    /** Ширина панели. */
-    width?: GrDropdownMenuWidth;
+    /** Размещение панели относительно триггера; переворот при нехватке места остаётся. */
+    placement?: UseFloatingPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offset?: number;
+    /** Ширина панели: число — пиксели, строка — CSS-длина, `auto` — по контенту. */
+    width?: GrDropdownWidth;
+    /** Чем открывается панель. В любом режиме работают клик и клавиатура. */
+    trigger?: GrDropdownTrigger;
+    /** Задержка открытия по наведению, мс. */
+    openDelay?: number;
+    /** Задержка закрытия после ухода курсора, мс. */
+    closeDelay?: number;
+    /** Меню не открывается ничем; триггер остаётся фокусируемым. */
+    disabled?: boolean;
+    /** Куда телепортировать панель (`body` по умолчанию). */
+    /** Точечное переопределение точки монтирования; по умолчанию — общий портал. */
+    teleportTo?: string | HTMLElement;
     /** Закрывать по клику внутри content. */
     closeOnContentClick?: boolean;
     /** Дополнительные классы content-контейнера; по умолчанию `p-0`. */
     contentClass?: string;
+    /**
+     * Декларативное меню: пункты, группы и разделители массивом. Слот по
+     * умолчанию сильнее — он для меню, которое из модели не собирается.
+     */
+    items?: GrDropdownMenuEntry[];
     /** Разделители между пунктами. */
     dividers?: boolean;
     /** Верхний бордер контейнера списка. */
@@ -17,8 +37,19 @@ export interface GrDropdownMenuProps {
     borderBottom?: boolean;
     /** Дополнительные классы для wrapper'а списка. */
     listClass?: string;
+    /**
+     * Контролируемое состояние панели (`v-model:open`) — прокидывается в
+     * `GrDropdown`. Без пропа меню ведёт себя само (uncontrolled).
+     */
+    open?: boolean;
 }
-declare var __VLS_9: {
+export interface GrDropdownMenuEmits {
+    /** Выбран пункт декларативного меню. */
+    (e: 'select', item: GrDropdownMenuAction): void;
+    /** Панель открылась/закрылась (`v-model:open`). */
+    (e: 'update:open', value: boolean): void;
+}
+declare var __VLS_11: {
     open: boolean;
     toggle: () => void;
     close: () => void;
@@ -26,41 +57,73 @@ declare var __VLS_9: {
         'aria-haspopup': "menu";
         'aria-expanded': boolean;
         'aria-controls': string | undefined;
+        'aria-disabled': boolean | undefined;
+        onClick: () => void;
         onKeydown: (event: KeyboardEvent) => void;
     };
-}, __VLS_18: {
+}, __VLS_20: {
     close: () => void;
 };
 type __VLS_Slots = {} & {
-    trigger?: (props: typeof __VLS_9) => any;
+    trigger?: (props: typeof __VLS_11) => any;
 } & {
-    default?: (props: typeof __VLS_18) => any;
+    default?: (props: typeof __VLS_20) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuProps>, {
-    align: string;
+    placement: string;
+    offset: number;
     width: string;
+    trigger: string;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    teleportTo: undefined;
     closeOnContentClick: boolean;
     contentClass: string;
+    items: undefined;
     dividers: boolean;
     borderTop: boolean;
     borderBottom: boolean;
     listClass: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuProps>, {
-    align: string;
+    open: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: GrDropdownMenuAction) => void;
+    "update:open": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuProps>, {
+    placement: string;
+    offset: number;
     width: string;
+    trigger: string;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    teleportTo: undefined;
     closeOnContentClick: boolean;
     contentClass: string;
+    items: undefined;
     dividers: boolean;
     borderTop: boolean;
     borderBottom: boolean;
     listClass: string;
-}>>> & Readonly<{}>, {
-    width: GrDropdownMenuWidth;
-    align: GrDropdownMenuAlign;
+    open: undefined;
+}>>> & Readonly<{
+    onSelect?: ((item: GrDropdownMenuAction) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    width: GrDropdownWidth;
+    offset: number;
     borderBottom: boolean;
     borderTop: boolean;
+    placement: UseFloatingPlacement;
+    open: boolean;
+    disabled: boolean;
+    items: GrDropdownMenuEntry[];
+    trigger: GrDropdownTrigger;
     closeOnContentClick: boolean;
+    teleportTo: string | HTMLElement;
     contentClass: string;
+    openDelay: number;
+    closeDelay: number;
     dividers: boolean;
     listClass: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1,4 +1,5 @@
-export type GrDropdownMenuColumnAlign = 'left' | 'center' | 'right';
+import { type GrDropdownMenuColumnAlign } from './grDropdownMenuStyles';
+export type { GrDropdownMenuColumnAlign } from './grDropdownMenuStyles';
 export interface GrDropdownMenuColumnProps {
     align?: GrDropdownMenuColumnAlign;
 }

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

@@ -1,5 +1,6 @@
+import { type GrDropdownMenuColumnsCount } from './grDropdownMenuStyles';
 export interface GrDropdownMenuColumnsProps {
-    cols?: 2 | 3 | 4;
+    cols?: GrDropdownMenuColumnsCount;
 }
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -10,7 +11,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuColumnsProps>, {
     cols: number;
 }>>> & Readonly<{}>, {
-    cols: 2 | 3 | 4;
+    cols: GrDropdownMenuColumnsCount;
 }, {}, {}, {}, 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/GrDropdownMenu/GrDropdownMenuGroup.vue.d.ts

@@ -1,4 +1,4 @@
-import type { GrDropdownMenuHeaderAlign } from './GrDropdownMenuHeader.vue';
+import { type GrDropdownMenuHeaderAlign } from './grDropdownMenuStyles';
 export interface GrDropdownMenuGroupProps {
     title?: string;
     titleAlign?: GrDropdownMenuHeaderAlign;
@@ -22,8 +22,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>> & Readonly<{}>, {
     title: string;
     uppercase: boolean;
-    dividers: boolean;
     titleAlign: GrDropdownMenuHeaderAlign;
+    dividers: 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/GrDropdownMenu/GrDropdownMenuHeader.vue.d.ts

@@ -1,4 +1,5 @@
-export type GrDropdownMenuHeaderAlign = 'left' | 'center' | 'right';
+import { type GrDropdownMenuHeaderAlign } from './grDropdownMenuStyles';
+export type { GrDropdownMenuHeaderAlign } from './grDropdownMenuStyles';
 export interface GrDropdownMenuHeaderProps {
     title?: string;
     align?: GrDropdownMenuHeaderAlign;
@@ -18,8 +19,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     uppercase: boolean;
 }>>> & Readonly<{}>, {
     title: string;
-    align: GrDropdownMenuHeaderAlign;
     uppercase: boolean;
+    align: GrDropdownMenuHeaderAlign;
 }, {}, {}, {}, 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/GrDropdownMenu/GrDropdownMenuItem.vue.d.ts

@@ -1,31 +1,77 @@
 import type { Component } from 'vue';
-export type GrDropdownMenuItemAlign = 'left' | 'center' | 'right';
-export type GrDropdownMenuItemVariant = 'default' | 'danger';
+import { type GrDropdownMenuItemAlign, type GrDropdownMenuItemVariant } from './grDropdownMenuStyles';
+export type { GrDropdownMenuItemAlign, GrDropdownMenuItemVariant } from './grDropdownMenuStyles';
+/**
+ * Роль пункта. `menuitemcheckbox`/`menuitemradio` — пункты-переключатели: они
+ * обязаны нести `aria-checked`, иначе AT прочитает их как обычные команды.
+ */
+export type GrDropdownMenuItemRole = 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';
 export interface GrDropdownMenuItemProps {
     as?: string | Component;
     disabled?: boolean;
+    /** Пункт-ссылка. У выключенного пункта не рендерится: ссылка осталась бы рабочей. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    /** Шорткат для `target="_blank"` + `rel="noopener noreferrer"`. */
+    external?: boolean;
     align?: GrDropdownMenuItemAlign;
     variant?: GrDropdownMenuItemVariant;
+    role?: GrDropdownMenuItemRole;
+    /** Состояние переключателя. Осмысленно с `role="menuitemcheckbox|radio"`. */
+    checked?: boolean;
+    /** Иконка слева. Слот `#icon` сильнее. */
+    icon?: Component;
+    /** Подпись сочетания клавиш справа. Слот `#shortcut` сильнее. */
+    shortcut?: string;
 }
-declare var __VLS_10: {};
+declare var __VLS_15: {}, __VLS_22: {}, __VLS_24: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_10) => any;
+    icon?: (props: typeof __VLS_15) => any;
+} & {
+    default?: (props: typeof __VLS_22) => any;
+} & {
+    shortcut?: (props: typeof __VLS_24) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuItemProps>, {
     as: string;
     disabled: boolean;
+    href: undefined;
+    target: undefined;
+    rel: undefined;
+    external: boolean;
     align: string;
     variant: string;
+    role: string;
+    checked: undefined;
+    icon: undefined;
+    shortcut: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDropdownMenuItemProps>, {
     as: string;
     disabled: boolean;
+    href: undefined;
+    target: undefined;
+    rel: undefined;
+    external: boolean;
     align: string;
     variant: string;
+    role: string;
+    checked: undefined;
+    icon: undefined;
+    shortcut: undefined;
 }>>> & Readonly<{}>, {
     variant: GrDropdownMenuItemVariant;
+    icon: Component;
+    role: GrDropdownMenuItemRole;
+    target: string;
+    href: string;
     disabled: boolean;
     as: string | Component;
+    external: boolean;
+    rel: string;
+    checked: boolean;
     align: GrDropdownMenuItemAlign;
+    shortcut: 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/GrDropdownMenu/GrDropdownMenuList.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * `role="none"` на обёртке обязателен: `role="menu"` у панели объявляет своих
+ * потомков презентационными, и любой div между панелью и пунктом ломает
+ * `aria-required-children`, а пункты теряют принадлежность к меню.
+ */
 export interface GrDropdownMenuListProps {
     dividers?: boolean;
     borderTop?: boolean;

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

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

package/dist/types/src/components/GrDropdownMenu/grDropdownMenuStyles.d.ts

@@ -0,0 +1,33 @@
+export type GrDropdownMenuItemAlign = 'left' | 'center' | 'right';
+export type GrDropdownMenuItemVariant = 'default' | 'danger';
+export type GrDropdownMenuHeaderAlign = GrDropdownMenuItemAlign;
+export type GrDropdownMenuColumnAlign = GrDropdownMenuItemAlign;
+export type GrDropdownMenuColumnsCount = 2 | 3 | 4;
+export declare const alignClass: Record<GrDropdownMenuItemAlign, string>;
+export declare const textAlignClass: Record<GrDropdownMenuHeaderAlign, string>;
+export declare const colsClass: Record<GrDropdownMenuColumnsCount, string>;
+export declare const itemBaseClass = "w-full min-h-10 px-4 py-2.5 flex items-center gap-2 text-[length:var(--gr-text-sm)] transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const itemVariantClass: Record<GrDropdownMenuItemVariant, string>;
+export declare const itemInteractiveClass = "cursor-pointer hover:bg-[var(--gr-accent)] hover:text-[var(--gr-accent-fg)]";
+export declare const itemDisabledClass = "cursor-not-allowed pointer-events-none bg-[var(--gr-muted)] text-[var(--gr-muted-fg)]";
+export declare const itemIndicatorClass = "h-3.5 w-3.5 shrink-0";
+export declare const itemShortcutClass = "ml-auto pl-4 text-[length:var(--gr-text-xs)] text-[var(--gr-muted-fg)]";
+export declare const headerClass = "px-4 py-2 text-[length:var(--gr-text-xs)] tracking-wide text-[var(--gr-muted-fg)]";
+export declare const listBaseClass = "w-full";
+export declare const dividersClass = "divide-y divide-[var(--gr-brd)]";
+export declare const borderTopClass = "border-t border-[var(--gr-brd)]";
+export declare const borderBottomClass = "border-b border-[var(--gr-brd)]";
+export declare const columnsBaseClass = "w-full grid divide-x divide-[var(--gr-brd)]";
+export declare const columnBaseClass = "px-3 py-2 flex items-center";
+export declare const dividerClass = "border-t border-[var(--gr-brd)]";
+export declare const dividerInsetClass = "mx-2";
+export declare function grDropdownMenuItemClass(options: {
+    align: GrDropdownMenuItemAlign;
+    variant: GrDropdownMenuItemVariant;
+    disabled: boolean;
+}): string;
+export declare function grDropdownMenuListClass(options: {
+    dividers: boolean;
+    borderTop: boolean;
+    borderBottom: boolean;
+}): string;

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

@@ -8,11 +8,15 @@ export { default as GrDropdownMenuHeader } from './GrDropdownMenuHeader.vue';
 export { default as GrDropdownMenuItem } from './GrDropdownMenuItem.vue';
 export { default as GrDropdownMenuList } from './GrDropdownMenuList.vue';
 export { grDropdownMenuConfig } from './config';
-export type { GrDropdownMenuAlign, GrDropdownMenuProps, GrDropdownMenuWidth, } from './GrDropdownMenu.vue';
+export { grDropdownMenuSafelist } from './safelist';
+export { isMenuAction, isMenuSection, isMenuSeparator, } from './menuModel';
+export type { GrDropdownMenuAction, GrDropdownMenuEntry, GrDropdownMenuSection, GrDropdownMenuSeparator, } from './menuModel';
+export type { GrDropdownMenuProps, } from './GrDropdownMenu.vue';
 export type { GrDropdownMenuColumnAlign, GrDropdownMenuColumnProps, } from './GrDropdownMenuColumn.vue';
 export type { GrDropdownMenuColumnsProps } from './GrDropdownMenuColumns.vue';
 export type { GrDropdownMenuDividerProps } from './GrDropdownMenuDivider.vue';
 export type { GrDropdownMenuGroupProps } from './GrDropdownMenuGroup.vue';
 export type { GrDropdownMenuHeaderAlign, GrDropdownMenuHeaderProps, } from './GrDropdownMenuHeader.vue';
-export type { GrDropdownMenuItemAlign, GrDropdownMenuItemProps, GrDropdownMenuItemVariant, } from './GrDropdownMenuItem.vue';
+export type { GrDropdownMenuItemAlign, GrDropdownMenuItemProps, GrDropdownMenuItemRole, GrDropdownMenuItemVariant, } from './GrDropdownMenuItem.vue';
 export type { GrDropdownMenuListProps } from './GrDropdownMenuList.vue';
+export type { GrDropdownMenuEmits } from './GrDropdownMenu.vue';

package/dist/types/src/components/GrDropdownMenu/menuModel.d.ts

@@ -0,0 +1,42 @@
+import type { Component } from 'vue';
+import type { GrDropdownMenuItemRole } from './GrDropdownMenuItem.vue';
+import type { GrDropdownMenuItemVariant } from './grDropdownMenuStyles';
+/**
+ * Декларативная модель меню.
+ *
+ * Композиция из подкомпонентов остаётся основным способом — она нужна там, где
+ * пункт нестандартный. Но девять меню из десяти однотипны («иконка, подпись,
+ * шорткат, иногда разделитель»), и собирать их из пяти компонентов вручную
+ * значит каждый раз заново решать, где `role`, где `disabled`, где ключ.
+ */
+export interface GrDropdownMenuAction {
+    /** Ключ пункта — он же приходит в `select`. */
+    key: string;
+    label: string;
+    icon?: Component;
+    shortcut?: string;
+    disabled?: boolean;
+    variant?: GrDropdownMenuItemVariant;
+    role?: GrDropdownMenuItemRole;
+    /** Состояние переключателя для `menuitemcheckbox`/`menuitemradio`. */
+    checked?: boolean;
+    /** Пункт-ссылка: рендерится как `<a>` с этим `href`. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    /** Шорткат для `target="_blank"` + `rel="noopener noreferrer"`. */
+    external?: boolean;
+}
+export interface GrDropdownMenuSeparator {
+    type: 'divider';
+    inset?: boolean;
+}
+export interface GrDropdownMenuSection {
+    type: 'group';
+    title?: string;
+    items: GrDropdownMenuAction[];
+}
+export type GrDropdownMenuEntry = GrDropdownMenuAction | GrDropdownMenuSeparator | GrDropdownMenuSection;
+export declare function isMenuSeparator(entry: GrDropdownMenuEntry): entry is GrDropdownMenuSeparator;
+export declare function isMenuSection(entry: GrDropdownMenuEntry): entry is GrDropdownMenuSection;
+export declare function isMenuAction(entry: GrDropdownMenuEntry): entry is GrDropdownMenuAction;

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

@@ -0,0 +1,7 @@
+/**
+ * Классы каталога живут в `.ts`-хелпере, а его бандлер волен вынести в общий
+ * `dist/chunks/` — вне области скана компонента. Симптом промаха тут особенно
+ * незаметный: размеры пунктов на месте, а выравнивание, колонки и цвета
+ * пропали. Гейт — `src/__tests__/safelist.test.ts`.
+ */
+export declare const grDropdownMenuSafelist: string[];

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

@@ -1,25 +1,48 @@
+import { type GrEmptyStateHeadingLevel, type GrEmptyStateSize, type GrEmptyStateVariant } from './grEmptyStateStyles';
+export type { GrEmptyStateHeadingLevel, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
 /**
- * GrEmptyState — карточка пустого состояния с иконкой, заголовком,
- * опциональным описанием и CTA-слотом.
+ * GrEmptyState — карточка пустого состояния: иконка, заголовок, описание и
+ * слот действий.
  *
- * - Иконка по умолчанию — `lucide/inbox`, кастомизируется через слот `#icon`.
- * - Default-слот рендерится как контейнер для действий (центрирован).
+ * Заголовок — настоящий heading: без него пустое состояние не находится
+ * навигацией по заголовкам, а именно оно и объясняет, почему на экране ничего
+ * нет.
  */
 export interface GrEmptyStateProps {
-    title: string;
+    /** Заголовок. Не задан — берётся из локали; слот `#title` сильнее обоих. */
+    title?: string;
     description?: string;
+    size?: GrEmptyStateSize;
+    /** `ghost` снимает рамку и фон: карточка внутри карточки рисует вторую рамку. */
+    variant?: GrEmptyStateVariant;
+    headingLevel?: GrEmptyStateHeadingLevel;
 }
-declare var __VLS_1: {}, __VLS_14: {};
-type __VLS_Slots = {} & {
-    icon?: (props: typeof __VLS_1) => any;
-} & {
-    default?: (props: typeof __VLS_14) => any;
+type __VLS_Slots = {
+    /** Иконка вместо встроенной. */
+    icon?: () => unknown;
+    /** Заголовок разметкой: ссылка, выделение, счётчик. */
+    title?: () => unknown;
+    description?: () => unknown;
+    /** Действия под текстом: центрируются. */
+    default?: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrEmptyStateProps>, {
+    title: undefined;
     description: undefined;
+    size: undefined;
+    variant: undefined;
+    headingLevel: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrEmptyStateProps>, {
+    title: undefined;
     description: undefined;
+    size: undefined;
+    variant: undefined;
+    headingLevel: undefined;
 }>>> & Readonly<{}>, {
+    variant: GrEmptyStateVariant;
+    size: GrEmptyStateSize;
+    headingLevel: GrEmptyStateHeadingLevel;
+    title: string;
     description: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

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

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

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