@feugene/granularity 0.12.0 → 0.16.0

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

@@ -1,14 +1,26 @@
 import type { InputHTMLAttributes } from 'vue';
 import { type GrNumberInputControlsDirection, type GrNumberInputSize, type GrNumberInputState, type GrNumberInputTextAlign } from './grNumberInputStyles';
 export interface GrNumberInputProps {
-    /** Значение (строка — контролируем форматирование внутри). */
-    modelValue: string;
+    /**
+     * Значение поля. `null` — пусто.
+     *
+     * Незавершённый ввод («-», «1,») числом не является и в модель не попадает:
+     * пока он набирается, поле держит его во внутреннем черновике, а модель
+     * честно говорит «числа пока нет».
+     */
+    modelValue: number | null;
     placeholder?: string;
     autocomplete?: string;
     inputmode?: InputHTMLAttributes['inputmode'];
     disabled?: boolean;
     /** Быстрый флаг невалидности; эквивалент `state='danger'` + `aria-invalid`. */
     invalid?: boolean;
+    /** Только для чтения: значение видно и уходит в форму, но не редактируется. */
+    readonly?: boolean;
+    /** Обязательное поле (`aria-required`). Складывается с `required` у `GrFormField`. */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
     state?: GrNumberInputState;
     name?: string;
     id?: string;
@@ -19,6 +31,10 @@ export interface GrNumberInputProps {
     min?: number;
     max?: number;
     precision?: number;
+    /** Кнопка очистки значения. */
+    clearable?: boolean;
+    /** A11y-подпись кнопки очистки. */
+    clearLabel?: string;
     /**
      * BCP-47 локаль для отображения значения (группировка разрядов и разделители
      * через `Intl.NumberFormat`). Работает вместе с `useGrouping`.
@@ -48,23 +64,35 @@ export interface GrNumberInputProps {
     /** i18n-friendly aria-label для кнопки "уменьшить". */
     decreaseLabel?: string;
 }
-declare function focus(): void;
-declare var __VLS_1: {}, __VLS_3: {};
-type __VLS_Slots = {} & {
-    prefix?: (props: typeof __VLS_1) => any;
-} & {
-    suffix?: (props: typeof __VLS_3) => any;
+export interface GrNumberInputEmits {
+    (e: 'update:modelValue', value: number | null): void;
+    (e: 'change', value: number | null): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+    /** Значение стёрто кнопкой очистки. */
+    (e: 'clear'): void;
+}
+type __VLS_Slots = {
+    /** Аддон слева от поля: знак валюты, иконка. */
+    prefix?: () => any;
+    /** Аддон справа от поля: единица измерения. */
+    suffix?: () => any;
 };
+declare function focus(): void;
+declare function blur(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNumberInputProps>, {
     placeholder: undefined;
     autocomplete: undefined;
     inputmode: string;
     disabled: boolean;
     invalid: boolean;
+    readonly: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     state: string;
     name: undefined;
     id: undefined;
-    size: string;
+    size: undefined;
     textAlign: string;
     decimalSeparator: string;
     step: number;
@@ -73,6 +101,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     precision: undefined;
     locale: undefined;
     useGrouping: boolean;
+    clearable: undefined;
+    clearLabel: undefined;
     controls: boolean;
     controlsDirection: string;
     prefixMinWidth: undefined;
@@ -85,19 +115,26 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     decreaseLabel: undefined;
 }>>, {
     focus: typeof focus;
+    blur: typeof blur;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => void;
-    change: (value: string) => void;
+    "update:modelValue": (value: number | null) => void;
+    change: (value: number | null) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
+    clear: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNumberInputProps>, {
     placeholder: undefined;
     autocomplete: undefined;
     inputmode: string;
     disabled: boolean;
     invalid: boolean;
+    readonly: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     state: string;
     name: undefined;
     id: undefined;
-    size: string;
+    size: undefined;
     textAlign: string;
     decimalSeparator: string;
     step: number;
@@ -106,6 +143,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     precision: undefined;
     locale: undefined;
     useGrouping: boolean;
+    clearable: undefined;
+    clearLabel: undefined;
     controls: boolean;
     controlsDirection: string;
     prefixMinWidth: undefined;
@@ -117,31 +156,39 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     increaseLabel: undefined;
     decreaseLabel: undefined;
 }>>> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    onChange?: ((value: string) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: number | null) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
 }>, {
     size: GrNumberInputSize;
-    disabled: boolean;
+    clearable: boolean;
+    readonly: boolean;
     name: string;
-    id: string;
     invalid: boolean;
+    id: string;
     max: number;
-    inputmode: "text" | "search" | "none" | "email" | "tel" | "url" | "numeric" | "decimal";
-    placeholder: string;
-    autocomplete: string;
-    state: GrNumberInputState;
+    min: number;
     textAlign: GrNumberInputTextAlign;
+    disabled: boolean;
+    required: boolean;
+    placeholder: string;
+    ariaLabel: string;
+    clearLabel: string;
     prefixMinWidth: string;
     prefixMaxWidth: string;
     suffixMinWidth: string;
     suffixMaxWidth: string;
     prefixFixed: boolean;
     suffixFixed: boolean;
-    min: number;
-    decimalSeparator: string;
+    autocomplete: string;
     step: number;
-    precision: number;
+    inputmode: "search" | "text" | "none" | "email" | "tel" | "url" | "numeric" | "decimal";
+    state: GrNumberInputState;
     locale: string;
+    decimalSeparator: string;
+    precision: number;
     useGrouping: boolean;
     controls: boolean;
     controlsDirection: GrNumberInputControlsDirection;

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

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

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

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

package/dist/types/src/components/GrNumberInput/grNumberInputStyles.d.ts

@@ -1,5 +1,6 @@
-export type GrNumberInputState = 'default' | 'success' | 'warning' | 'danger';
-export type GrNumberInputSize = 'xs' | 'sm' | 'md' | 'lg';
+import type { GrComponentSize, GrControlState } from '../shared/sizes';
+export type GrNumberInputState = GrControlState;
+export type GrNumberInputSize = GrComponentSize;
 export type GrNumberInputControlsDirection = 'vertical' | 'horizontal';
 export type GrNumberInputTextAlign = 'left' | 'center' | 'right';
 export type NumberInputSize = GrNumberInputSize;
@@ -7,11 +8,26 @@ export type NumberInputControlsDirection = GrNumberInputControlsDirection;
 export declare const sizeClassBySize: Record<GrNumberInputSize, string>;
 export declare const textAlignClassByAlign: Record<GrNumberInputTextAlign, string>;
 export declare const borderClassByState: Record<GrNumberInputState, string>;
-/** Динамические классы для disabled-состояния shell'а — выбираются в рантайме. */
-export declare const disabledShellClass = "opacity-50 cursor-not-allowed";
+/**
+ * Ошибка валидации красится своей ролью, а не декоративным тоном `danger`:
+ * `state="danger"` — это подсветка по решению разработчика, `invalid` — вердикт
+ * валидации, и тема вправе развести их по цвету.
+ */
+export declare const invalidBorderClass = "border-[var(--gr-invalid-brd)] focus-within:ring-[var(--gr-invalid-ring)]";
+/**
+ * Недоступное поле гасится токенами, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста и роняет контраст подписи.
+ */
+export declare const disabledShellClass = "bg-[var(--gr-disabled-bg)] text-[var(--gr-disabled-fg)] cursor-not-allowed";
+/** Компактная кнопка вертикального стека ± . */
+export declare const stepperCompactClass = "h-4 w-7 rounded-[var(--gr-radius-sm)] inline-flex items-center justify-center text-[var(--gr-muted-fg)] hover:bg-[var(--gr-muted)] active:bg-[var(--gr-muted)] disabled:cursor-not-allowed disabled:text-[var(--gr-disabled-fg)] disabled:hover:bg-transparent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+/** Кнопка бокового стека ± — занимает всю высоту поля. */
+export declare const stepperWideClass = "h-full w-full inline-flex items-center justify-center text-[var(--gr-muted-fg)] hover:bg-[var(--gr-muted)] active:bg-[var(--gr-muted)] disabled:cursor-not-allowed disabled:text-[var(--gr-disabled-fg)] disabled:hover:bg-transparent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const clearButtonClass = "absolute top-1/2 -translate-y-1/2 inline-flex h-5 w-5 items-center justify-center rounded-[var(--gr-radius-full)] text-[var(--gr-muted-fg)] hover:bg-[var(--gr-muted)] hover:text-[var(--gr-fg)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
 export declare function grNumberInputShellClass(options: {
     disabled: boolean;
     state: GrNumberInputState;
+    invalid: boolean;
 }): string;
 export declare function grNumberInputInputClass(options: {
     size: GrNumberInputSize;

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

@@ -1,6 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrNumberInputComponent from './GrNumberInput.vue';
 export { default } from './GrNumberInput.vue';
 export { default as GrNumberInput } from './GrNumberInput.vue';
 export { grNumberInputConfig } from './config';
+export type { GrNumberInputConfigurableProps } from './defaults';
 export { grNumberInputSafelist } from './safelist';
 export type { GrNumberInputProps } from './GrNumberInput.vue';
 export type { GrNumberInputControlsDirection, GrNumberInputSize, GrNumberInputState, GrNumberInputTextAlign, NumberInputControlsDirection, NumberInputSize, } from './grNumberInputStyles';
+export type { GrNumberInputEmits } from './GrNumberInput.vue';
+export type GrNumberInputInstance = ComponentExposed<typeof GrNumberInputComponent>;

package/dist/types/src/components/GrNumberInput/numberInputMath.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Экспоненциальная запись разбирается отдельно: `String(1e-7)` — это `"1e-7"`,
+ * и поиск точки насчитал бы ноль знаков, после чего округление съело бы всё
+ * значение.
+ */
+export declare function decimalsOf(value: number): number;
+/**
+ * Двоичная дробь копит ошибку, поэтому сумма округляется. Разрядность — по
+ * большему из операндов: шаг `0.5` от значения `1.25` обязан дать `1.75`.
+ */
+export declare function addStep(current: number, step: number): number;
+/**
+ * Правило `GrSlider` (`bigStep` в `GrSlider.vue`): десять шагов либо десятая
+ * часть диапазона — что крупнее. У поля границы необязательны, и без них
+ * диапазона не существует.
+ */
+export declare function bigStep(step: number, min?: number, max?: number): number;

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

@@ -1,3 +1,4 @@
+import { type GrPaginationSize } from './grPaginationStyles';
 /**
  * Пропы пагинации.
  *
@@ -15,11 +16,52 @@ export interface GrPaginationProps {
     siblingCount?: number;
     /** Сколько крайних страниц всегда показывать с каждого края. По умолчанию `1`. */
     boundaryCount?: number;
+    /**
+     * Компактный вариант: вместо нумерованных страниц показывается индикатор
+     * «текущая / всего» — удобно для узких мест (мобайл, тулбары таблиц).
+     */
+    compact?: boolean;
+    /** Показывать поле «перейти к странице» с быстрым переходом по вводу номера. */
+    showJumper?: boolean;
+    /** Показывать селект размера страницы. */
+    showPageSize?: boolean;
+    /** Показывать диапазон показанных элементов — «1–20 из 137». Слот `#total` сильнее. */
+    showTotal?: boolean;
+    /** i18n-подпись перед полем перехода. По умолчанию — `gr.pagination.jumpTo`. */
+    jumperLabel?: string;
+    /**
+     * Имя навигационного лендмарка. По умолчанию — `gr.pagination.label`; задавать
+     * стоит там, где пагинаций на странице несколько и их надо различать.
+     */
+    ariaLabel?: string;
+    /** Гасит всю пагинацию: номера, кнопки, селект размера и поле перехода. */
+    disabled?: boolean;
+    size?: GrPaginationSize;
 }
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPaginationProps>, {
+export interface GrPaginationEmits {
+    (e: 'update:page', value: number): void;
+    (e: 'update:pageSize', value: number): void;
+}
+type __VLS_Slots = {
+    /** Диапазон показанных элементов целиком — вместо строки из локали. */
+    total?: (props: {
+        from: number;
+        to: number;
+        total: number;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPaginationProps>, {
     pageSizes: () => number[];
     siblingCount: number;
     boundaryCount: number;
+    compact: boolean;
+    showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
+    jumperLabel: undefined;
+    ariaLabel: undefined;
+    disabled: boolean;
+    size: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:page": (value: number) => void;
     "update:pageSize": (value: number) => void;
@@ -27,14 +69,31 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     pageSizes: () => number[];
     siblingCount: number;
     boundaryCount: number;
+    compact: boolean;
+    showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
+    jumperLabel: undefined;
+    ariaLabel: undefined;
+    disabled: boolean;
+    size: undefined;
 }>>> & Readonly<{
     "onUpdate:page"?: ((value: number) => any) | undefined;
     "onUpdate:pageSize"?: ((value: number) => any) | undefined;
 }>, {
+    size: GrPaginationSize;
+    compact: boolean;
+    disabled: boolean;
+    ariaLabel: string;
     pageSizes: number[];
     siblingCount: number;
     boundaryCount: number;
+    showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
+    jumperLabel: 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> = {
@@ -50,6 +109,11 @@ type __VLS_WithDefaults<P, D> = {
         default: D[K];
     }> : P[K];
 };
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
 type __VLS_PrettifyLocal<T> = (T extends any ? {
     [K in keyof T]: T[K];
 } : {

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

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

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

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrPagination`, настраиваемые глобально через `componentDefaults`. */
+export interface GrPaginationConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrPagination: GrPaginationConfigurableProps;
+    }
+}

package/dist/types/src/components/GrPagination/grPaginationStyles.d.ts

@@ -0,0 +1,19 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrPaginationSize = GrComponentSize;
+/** Номер страницы и многоточие: одна и та же коробка, чтобы ряд не прыгал. */
+export declare const pageSizes: Record<GrPaginationSize, string>;
+/** Коробка та же, что у номера, но поле́ уже: многоточию не нужен клик-таргет. */
+export declare const ellipsisSizes: Record<GrPaginationSize, string>;
+/** Вспомогательный текст: индикатор «текущая / всего» и подпись у поля перехода. */
+export declare const labelSizes: Record<GrPaginationSize, string>;
+export declare const jumperSizes: Record<GrPaginationSize, string>;
+export declare const rowGaps: Record<GrPaginationSize, string>;
+export declare const pageListGaps: Record<GrPaginationSize, string>;
+export declare const pageSizeSelectWidths: Record<GrPaginationSize, string>;
+/**
+ * Навигационные кнопки берут размер из шкалы `GrButton`, а не из своей: они
+ * обязаны стоять в один ряд с номерами страниц, а высоты у `GrButton`
+ * `xs…lg` — `28/32/40/44px`. На `md` номера страниц ростом `h-8`, поэтому
+ * кнопке достаётся `sm`, а не одноимённый `md`.
+ */
+export declare const navButtonSizes: Record<GrPaginationSize, GrComponentSize>;

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

@@ -1,3 +1,7 @@
 export { default } from './GrPagination.vue';
 export { default as GrPagination, type GrPaginationProps } from './GrPagination.vue';
 export { grPaginationConfig } from './config';
+export type { GrPaginationConfigurableProps } from './defaults';
+export type { GrPaginationSize } from './grPaginationStyles';
+export { grPaginationSafelist } from './safelist';
+export type { GrPaginationEmits } from './GrPagination.vue';

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

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

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

@@ -0,0 +1,161 @@
+import { type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrPopoverRole, type GrPopoverSize } from './grPopoverStyles';
+export interface GrPopoverProps {
+    /**
+     * Открыт ли поповер. Без этого пропа компонент ведёт состояние сам
+     * (uncontrolled), с ним — слушайте `update:open`.
+     */
+    open?: boolean;
+    placement?: UseFloatingPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offsetPx?: number;
+    size?: GrPopoverSize;
+    /** Роль панели. Меняется теми, кто строит поверх примитива своё меню/список. */
+    role?: GrPopoverRole;
+    /**
+     * Модальный режим: фон уходит в `inert`, Tab ходит по кругу внутри панели,
+     * скролл страницы блокируется, а слой встаёт в стек модальным — как окно.
+     * Нужен поповеру с формой или подтверждением внутри: без изоляции фона
+     * пользователь уводит фокус на страницу, к которой поповер и относится.
+     *
+     * В этом режиме фокус переносится в панель независимо от `autoFocus`: фон
+     * недоступен, и слой без фокуса внутри стал бы клавиатурной ловушкой.
+     */
+    modal?: boolean;
+    /** Доступное имя панели. Обязательно для `role="dialog"` без видимого заголовка. */
+    ariaLabel?: string;
+    /** `id` видимого заголовка внутри панели — альтернатива `ariaLabel`. */
+    labelledBy?: string;
+    /**
+     * `manual` — открывать только программно (через `v-model:open`). Нужно для
+     * контекстного меню и подтверждений, где момент открытия решает потребитель.
+     */
+    trigger?: 'click' | 'manual';
+    closeOnEsc?: boolean;
+    closeOnClickOutside?: boolean;
+    /** Закрывать по клику внутри панели — удобно для меню, вредно для формы. */
+    closeOnContentClick?: boolean;
+    /**
+     * Переносить фокус на панель при открытии. Именно на панель, а не на первый
+     * контрол внутри: сфокусировать поле ввода за пользователя — решение
+     * содержимого, а не оболочки.
+     */
+    autoFocus?: boolean;
+    /**
+     * Точечное переопределение точки монтирования. По умолчанию — общий портал
+     * оверлеев (`#gr-portal` либо `portalTarget` из `GrConfigProvider`).
+     */
+    teleportTo?: string | HTMLElement;
+    contentClass?: string;
+    disabled?: boolean;
+}
+export interface GrPopoverEmits {
+    (e: 'update:open', value: boolean): void;
+}
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
+declare var __VLS_1: {
+    open: boolean;
+    toggle: typeof toggle;
+    close: typeof close;
+    triggerProps: {
+        'aria-haspopup': "dialog" | "menu" | "grid" | "listbox" | undefined;
+        'aria-expanded': boolean;
+        'aria-controls': string | undefined;
+        disabled: true | undefined;
+    };
+}, __VLS_15: {
+    close: typeof close;
+};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_1) => any;
+} & {
+    content?: (props: typeof __VLS_15) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPopoverProps>, {
+    open: undefined;
+    placement: string;
+    offsetPx: number;
+    size: undefined;
+    role: string;
+    modal: boolean;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    trigger: string;
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: undefined;
+    contentClass: undefined;
+    disabled: boolean;
+}>>, {
+    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<GrPopoverProps>, {
+    open: undefined;
+    placement: string;
+    offsetPx: number;
+    size: undefined;
+    role: string;
+    modal: boolean;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    trigger: string;
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: undefined;
+    contentClass: undefined;
+    disabled: boolean;
+}>>> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrPopoverSize;
+    role: GrPopoverRole;
+    placement: UseFloatingPlacement;
+    open: boolean;
+    disabled: boolean;
+    modal: boolean;
+    ariaLabel: string;
+    labelledBy: string;
+    offsetPx: number;
+    trigger: "click" | "manual";
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: string | HTMLElement;
+    contentClass: 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/src/components/GrPopover/config.d.ts

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

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

@@ -0,0 +1,15 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/**
+ * Пропы `GrPopover`, настраиваемые глобально через `componentDefaults`.
+ *
+ * Только оформление: `open` и обработчики принадлежат конкретному экземпляру и
+ * через конфиг задаваться не должны.
+ */
+export interface GrPopoverConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrPopover: GrPopoverConfigurableProps;
+    }
+}

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

@@ -0,0 +1,28 @@
+import type { Placement } from '@floating-ui/dom';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrPopoverSize = GrComponentSize;
+/**
+ * Роль панели.
+ *
+ * `dialog` — произвольный интерактивный контент (значение по умолчанию).
+ * Остальные нужны компонентам, которые строятся поверх этого примитива:
+ * меню (`GrMenu`, `GrContextMenu`), списки, палитры. Роль задаёт потребитель,
+ * потому что клавиатурный паттерн принадлежит ему, а не поповеру.
+ */
+export type GrPopoverRole = 'dialog' | 'menu' | 'listbox' | 'grid' | 'group' | 'none';
+export declare const panelSizes: Record<GrPopoverSize, string>;
+/**
+ * `transform-origin` для scale-анимации: координаты панели уже посчитал
+ * `useFloating`, здесь остаётся направление «роста» относительно триггера.
+ *
+ * Ключ — `resolvedPlacement`, то есть положение **после** `flip`: если снизу не
+ * хватило места и панель перевернуло вверх, origin переворачивается вместе с ней.
+ */
+export declare const originClassByPlacement: Partial<Record<Placement, string>>;
+export declare function grPopoverOriginClass(placement: Placement): string;
+/**
+ * Поверхность панели. `max-w-[min(...)]` не даёт поповеру вылезти за узкий
+ * экран: `useFloating` смещает панель в пределах viewport, но не сужает её.
+ */
+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;

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

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrPopoverComponent from './GrPopover.vue';
+export { default } from './GrPopover.vue';
+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 { grPopoverSafelist } from './safelist';
+export type { GrPopoverEmits } from './GrPopover.vue';
+export type GrPopoverInstance = ComponentExposed<typeof GrPopoverComponent>;

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

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