@feugene/granularity 0.24.1 → 0.26.0

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

@@ -0,0 +1,118 @@
+import type { GrChipValue } from './grChipGroupContext';
+import type { GrChipRadius, GrChipSize, GrChipTone } from './grChipStyles';
+/**
+ * Интерактивный тег: снимаемый, выбираемый, с иконкой.
+ *
+ * От `GrBadge` отличается не видом, а природой: бейдж — метка, чип — виджет.
+ * Поэтому цвета и радиусы взяты у бейджа как есть (в одном ряду они обязаны
+ * совпадать), а роль, клавиатура и размеры — свои.
+ */
+export interface GrChipProps {
+    /** Значение чипа в группе. Вне `GrChipGroup` не используется. */
+    value?: GrChipValue;
+    /**
+     * Подпись. Нужна отдельно от слота: из неё собирается имя кнопки снятия —
+     * «Убрать» на двадцати кнопках подряд не даёт выбрать нужную.
+     */
+    label?: string;
+    tone?: GrChipTone;
+    dark?: boolean;
+    size?: GrChipSize;
+    radius?: GrChipRadius;
+    /** Чип становится переключателем: `aria-pressed`, `Enter`/`Space`. */
+    selectable?: boolean;
+    /** Состояние переключателя вне группы. Внутри группы значение ведёт группа. */
+    selected?: boolean;
+    /** Крестик. Внутри виджета он не кнопка — см. блок про роли ниже. */
+    closable?: boolean;
+    disabled?: boolean;
+    /** Доступное имя, когда подпись не объясняет назначения. */
+    ariaLabel?: string;
+    /** Имя кнопки снятия целиком. Перебивает собранное из `label`. */
+    removeLabel?: string;
+}
+export interface GrChipEmits {
+    (e: 'update:selected', value: boolean): void;
+    (e: 'remove'): void;
+}
+type __VLS_Slots = {
+    /** Подпись чипа. Внутри выбираемого чипа — только фразовое содержимое. */
+    default?: () => unknown;
+    /** Иконка перед подписью. */
+    icon?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrChipProps>, {
+    value: undefined;
+    label: undefined;
+    tone: undefined;
+    dark: undefined;
+    size: undefined;
+    radius: undefined;
+    selectable: boolean;
+    selected: boolean;
+    closable: boolean;
+    disabled: boolean;
+    ariaLabel: undefined;
+    removeLabel: undefined;
+}>>, {
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:selected": (value: boolean) => void;
+    remove: () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrChipProps>, {
+    value: undefined;
+    label: undefined;
+    tone: undefined;
+    dark: undefined;
+    size: undefined;
+    radius: undefined;
+    selectable: boolean;
+    selected: boolean;
+    closable: boolean;
+    disabled: boolean;
+    ariaLabel: undefined;
+    removeLabel: undefined;
+}>>> & Readonly<{
+    "onUpdate:selected"?: ((value: boolean) => any) | undefined;
+    onRemove?: (() => any) | undefined;
+}>, {
+    tone: GrChipTone;
+    closable: boolean;
+    size: GrChipSize;
+    radius: GrChipRadius;
+    dark: boolean;
+    value: GrChipValue;
+    label: string;
+    disabled: boolean;
+    ariaLabel: string;
+    selectable: boolean;
+    selected: boolean;
+    removeLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrChip/config.d.ts

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

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

@@ -0,0 +1,16 @@
+import type { GrChipRadius, GrChipSize, GrChipTone } from './grChipStyles';
+/**
+ * Пропы `GrChip`, настраиваемые глобально через `componentDefaults`.
+ * Только оформление: выбор и снятие относятся к экземпляру.
+ */
+export interface GrChipConfigurableProps {
+    tone: GrChipTone;
+    size: GrChipSize;
+    radius: GrChipRadius;
+    dark: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrChip: GrChipConfigurableProps;
+    }
+}

package/dist/types/components/GrChip/grChipGroupContext.d.ts

@@ -0,0 +1,52 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+import type { GrChipRadius, GrChipSize, GrChipTone } from './grChipStyles';
+/**
+ * Значение чипа в группе.
+ *
+ * Не только строка: набор фильтров чаще всего адресуется id. Объекты сюда
+ * намеренно не входят — значение уходит в `data-value` и в скрытое поле
+ * нативной формы, а значит обязано иметь однозначное строковое представление.
+ */
+export type GrChipValue = string | number | boolean;
+/** Как группа обращается со множественностью выбора. */
+export type GrChipSelection = 'single' | 'multiple';
+export type GrChipEntry = {
+    value: () => GrChipValue;
+    disabled: () => boolean;
+    /**
+     * Корневой узел чипа. Геттер, а не значение: регистрация идёт в `setup`,
+     * когда элемента ещё нет. Благодаря ему группа переносит фокус, не обходя
+     * DOM селекторами.
+     */
+    el: () => HTMLElement | null;
+};
+export type GrChipGroupContext = {
+    selection: ComputedRef<GrChipSelection>;
+    isSelected: (value: GrChipValue) => boolean;
+    toggle: (value: GrChipValue) => void;
+    /** Снятие чипа группа не выполняет — состав рисует потребитель; она ретранслирует. */
+    requestRemove: (value: GrChipValue) => void;
+    disabled: ComputedRef<boolean>;
+    /** Выбор видно, но он не меняется. Группа объявляет это `aria-readonly` на себе. */
+    readonly: ComputedRef<boolean>;
+    invalid: ComputedRef<boolean>;
+    closable: ComputedRef<boolean>;
+    size: ComputedRef<GrChipSize>;
+    tone: ComputedRef<GrChipTone | undefined>;
+    radius: ComputedRef<GrChipRadius | undefined>;
+    dark: ComputedRef<boolean | undefined>;
+    /**
+     * Регистрация чипа в группе. Порядок регистрации совпадает с порядком в
+     * документе (setup детей идёт сверху вниз), поэтому состав известен и на
+     * сервере — без обхода DOM.
+     */
+    register: (entry: GrChipEntry) => () => void;
+    /**
+     * Значение чипа, который держит `tabindex="0"`. Roving tabindex: группа —
+     * одна остановка Tab, внутрь попадают стрелками.
+     */
+    rovingValue: ComputedRef<GrChipValue | undefined>;
+    /** Стрелки, `Home`, `End`. Вернул `true` — клавиша обработана. */
+    handleNavigationKeys: (event: KeyboardEvent) => boolean;
+};
+export declare const GR_CHIP_GROUP_CONTEXT: InjectionKey<GrChipGroupContext>;

package/dist/types/components/GrChip/grChipStyles.d.ts

@@ -0,0 +1,64 @@
+import type { GrBadgeRadius, GrBadgeTone } from '../GrBadge/grBadgeStyles';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrChipTone = GrBadgeTone;
+export type GrChipSize = GrComponentSize;
+export type GrChipRadius = GrBadgeRadius;
+/**
+ * Размеры у чипа свои, а не бейджевые.
+ *
+ * Шкал кегля в пакете две: контрольная `xs…lg` (12/13/14/16) у полей и мельче
+ * `3xs…md` (10/11/12/14) у метки — `GrBadge`, `GrTooltip`. Чип берёт
+ * контрольную: по нему кликают, и цель нажатия обязана совпадать с соседним
+ * контролом, а не с подписью. Отсюда же явная высота — у метки её нет вовсе,
+ * а у цели нажатия она и есть главное.
+ *
+ * Тона и радиусы при этом переиспользуются у `GrBadge` без изменений: чип
+ * должен стоять с бейджем в одном ряду и не расходиться с ним по цвету.
+ */
+export declare const chipSizeClassBySize: Record<GrChipSize, string>;
+/** Крестик и иконка не растут вместе с кеглем один в один — плитка бы разъехалась. */
+export declare const chipIconSizeClassBySize: Record<GrChipSize, string>;
+/**
+ * `leading-none` осознанно: у контрольной шкалы парных ступеней межстрочного
+ * нет, и без явного значения плитка поехала бы за `line-height` приложения.
+ * Тот же приём у `GrBadge` и `GrKbd`.
+ */
+export declare const chipRootClass = "inline-flex max-w-full items-center border align-middle leading-none whitespace-nowrap";
+/** Подпись жмётся, а не ломает ряд: чип с длинным тегом не должен рвать раскладку. */
+export declare const chipLabelClass = "min-w-0 truncate";
+export declare const chipInteractiveClass = "cursor-pointer transition-colors duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-out)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-offset-1 focus-visible:ring-offset-[var(--gr-bg)]";
+/**
+ * Disabled гасится токеном фона, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста и роняет контраст (`library-conventions.md`).
+ */
+export declare const chipDisabledClass = "cursor-not-allowed bg-[var(--gr-chip-disabled-bg,var(--gr-muted))] text-[var(--gr-chip-disabled-fg,var(--gr-disabled-fg))] border-[var(--gr-chip-disabled-brd,var(--gr-brd))]";
+/**
+ * Выбранный чип берёт **плотный** вариант своего тона, а не оттенок соседнего.
+ *
+ * Тон остаётся тем же — иначе набор фильтров превратился бы в радугу, — но
+ * меняется вес заливки: светлая подложка сменяется насыщенной, как у
+ * filled-бейджа. Это перепад светлоты, а не оттенка, поэтому различие
+ * переживает и монохром, и дальтонизм.
+ *
+ * Одной заливки всё же мало: **`font-600` остаётся вторым, нецветовым
+ * каналом** (WCAG 1.4.1). Он же вытягивает случай, когда потребитель поставил
+ * `dark` всему набору и заливка у выбранного и невыбранного совпадает.
+ */
+export declare const chipSelectedClass = "font-600";
+/** Крестик наследует цвет тона: своей роли у него нет, он часть плитки. */
+export declare const chipCloseClass = "shrink-0 inline-flex items-center justify-center rounded-[var(--gr-radius-full)] text-current transition-colors duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-out)] hover:bg-[color-mix(in_srgb,currentColor_18%,transparent)]";
+/**
+ * Крестик-кнопка стоит в таб-порядке и обязана показывать фокус сама: она
+ * появляется только там, где чип не виджет, то есть кольца на корне нет.
+ */
+export declare const chipCloseButtonClass = "shrink-0 inline-flex items-center justify-center rounded-[var(--gr-radius-full)] text-current transition-colors duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-out)] hover:bg-[color-mix(in_srgb,currentColor_18%,transparent)] cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const chipIconClass = "shrink-0";
+export declare function grChipClass(options: {
+    tone: GrChipTone;
+    dark: boolean;
+    size: GrChipSize;
+    radius: GrChipRadius;
+    interactive: boolean;
+    selected: boolean;
+    disabled: boolean;
+}): string;

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

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrChipComponent from './GrChip.vue';
+export { default } from './GrChip.vue';
+export { default as GrChip } from './GrChip.vue';
+export { grChipConfig } from './config';
+export type { GrChipConfigurableProps } from './defaults';
+export type { GrChipGroupContext, GrChipSelection, GrChipValue } from './grChipGroupContext';
+export type { GrChipRadius, GrChipSize, GrChipTone } from './grChipStyles';
+export { grChipSafelist } from './safelist';
+export type { GrChipEmits, GrChipProps } from './GrChip.vue';
+export type GrChipInstance = ComponentExposed<typeof GrChipComponent>;

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

@@ -0,0 +1,7 @@
+/**
+ * Тона и радиусы приходят из `grBadgeStyles.ts`, поэтому их safelist берётся
+ * ссылкой, а не копией: копия разошлась бы с оригиналом молча. Ребро
+ * `GrChip → GrBadge` объявлено в `config.ts` — без него пресет не подмешает
+ * стили бейджа при гранулярной селекции, и чип придёт бесцветным.
+ */
+export declare const grChipSafelist: string[];

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

@@ -0,0 +1,128 @@
+import type { GrChipSelection, GrChipValue } from '../GrChip/grChipGroupContext';
+import type { GrChipRadius, GrChipSize, GrChipTone } from '../GrChip/grChipStyles';
+/**
+ * GrChipGroup — набор выбираемых чипов: фильтры, теги записи, быстрый выбор.
+ *
+ * Составной виджет: одна остановка `Tab`, внутрь попадают стрелками
+ * (roving tabindex). Роль зависит от множественности выбора — `radiogroup`
+ * в одиночном, `listbox` с `aria-multiselectable` во множественном; чипы
+ * получают парную роль через контекст и сами её не выбирают.
+ *
+ * Состав группа не рисует: чипы приходят слотом, потому что у каждого своя
+ * подпись и иконка. Отсюда же и `remove` — группа его ретранслирует, а снимает
+ * чип потребитель, у которого лежит массив.
+ */
+export interface GrChipGroupProps {
+    /** Одиночный выбор — значение, множественный — массив. */
+    modelValue?: GrChipValue | GrChipValue[] | null;
+    selection?: GrChipSelection;
+    /** Имя для нативной формы. Множественный выбор отдаёт по полю на значение. */
+    name?: string;
+    disabled?: boolean;
+    /** Выбор видно, но он не меняется. */
+    readonly?: boolean;
+    invalid?: boolean;
+    required?: boolean;
+    /** Крестик у всех чипов набора. Точечно перебивается пропом самого чипа. */
+    closable?: boolean;
+    size?: GrChipSize;
+    tone?: GrChipTone;
+    radius?: GrChipRadius;
+    dark?: boolean;
+    ariaLabel?: string;
+}
+export interface GrChipGroupEmits {
+    (e: 'update:modelValue', value: GrChipValue | GrChipValue[] | null): void;
+    (e: 'change', value: GrChipValue | GrChipValue[] | null): void;
+    (e: 'remove', value: GrChipValue): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+type __VLS_Slots = {
+    /** Чипы набора. */
+    default?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrChipGroupProps>, {
+    modelValue: undefined;
+    selection: string;
+    name: undefined;
+    disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    closable: boolean;
+    size: undefined;
+    tone: undefined;
+    radius: undefined;
+    dark: undefined;
+    ariaLabel: undefined;
+}>>, {
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: GrChipValue | GrChipValue[] | null) => void;
+    change: (value: GrChipValue | GrChipValue[] | null) => void;
+    remove: (value: GrChipValue) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrChipGroupProps>, {
+    modelValue: undefined;
+    selection: string;
+    name: undefined;
+    disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    closable: boolean;
+    size: undefined;
+    tone: undefined;
+    radius: undefined;
+    dark: undefined;
+    ariaLabel: undefined;
+}>>> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: GrChipValue | GrChipValue[] | null) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: GrChipValue | GrChipValue[] | null) => any) | undefined;
+    onRemove?: ((value: GrChipValue) => any) | undefined;
+}>, {
+    tone: GrChipTone;
+    closable: boolean;
+    size: GrChipSize;
+    radius: GrChipRadius;
+    dark: boolean;
+    readonly: boolean;
+    name: string;
+    invalid: boolean;
+    disabled: boolean;
+    modelValue: GrChipValue | GrChipValue[] | null;
+    required: boolean;
+    ariaLabel: string;
+    selection: GrChipSelection;
+}, {}, {}, {}, 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/GrChipGroup/config.d.ts

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

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

@@ -0,0 +1,13 @@
+import type { GrChipSize } from '../GrChip/grChipStyles';
+/**
+ * Пропы `GrChipGroup`, настраиваемые глобально через `componentDefaults`.
+ * Размер группы доезжает до чипов контекстом — задавать его на каждом не нужно.
+ */
+export interface GrChipGroupConfigurableProps {
+    size: GrChipSize;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrChipGroup: GrChipGroupConfigurableProps;
+    }
+}

package/dist/types/components/GrChipGroup/grChipGroupStyles.d.ts

@@ -0,0 +1,7 @@
+/**
+ * У группы своих вариантов нет: она раскладывает чипы и ничего не красит.
+ * Класс вынесен сюда, а не оставлен литералом в шаблоне, только ради safelist —
+ * из `.vue` литералы попадают в скан сами, но тогда список классов группы жил
+ * бы в двух местах.
+ */
+export declare const chipGroupRootClass = "flex flex-wrap items-center gap-2";

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

@@ -0,0 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrChipGroupComponent from './GrChipGroup.vue';
+export { default } from './GrChipGroup.vue';
+export { default as GrChipGroup } from './GrChipGroup.vue';
+export { grChipGroupConfig } from './config';
+export type { GrChipGroupConfigurableProps } from './defaults';
+export { grChipGroupSafelist } from './safelist';
+export type { GrChipGroupEmits, GrChipGroupProps } from './GrChipGroup.vue';
+export type GrChipGroupInstance = ComponentExposed<typeof GrChipGroupComponent>;

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

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

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>;