@feugene/granularity 0.13.0 → 0.16.0

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

@@ -1,28 +1,46 @@
-import type { GrTableDensity } from '../GrTable';
-export type GrDataColumn = {
-    key: string;
+import { type GrDataTableSortDir } from './grDataTableSort';
+import { type GrDataTableSize } from './grDataTableStyles';
+/**
+ * Ключ колонки. Собственные поля строки подсказываются автодополнением, но
+ * произвольная строка тоже допустима: колонка может быть вычисляемой и жить
+ * только в слоте `#cell-<key>`.
+ */
+export type GrDataColumnKey<TRow extends Record<string, unknown> = Record<string, unknown>> = Extract<keyof TRow, string> | (string & {});
+export type GrDataColumn<TRow extends Record<string, unknown> = Record<string, unknown>> = {
+    key: GrDataColumnKey<TRow>;
     label: string;
     sortable?: boolean;
     align?: 'left' | 'center' | 'right';
+    /**
+     * Ширина колонки: число — пиксели, строка — как есть (`'40%'`, `'12rem'`).
+     *
+     * Уезжает в заголовочную ячейку: при фиксированной раскладке ширины колонок
+     * задаёт первая строка таблицы, а это и есть `<thead>`.
+     */
+    width?: string | number;
 };
 export type GrDataTableRowKey<TRow extends Record<string, unknown> = Record<string, unknown>> = string | ((row: TRow) => string | number);
+/** Порядок обхода состояний сортировки по клику на заголовок. */
+export type GrDataTableSortCycle = 'asc-desc' | 'asc-desc-none';
 export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<string, unknown>> {
     rows: TRow[];
-    columns: GrDataColumn[];
+    columns: GrDataColumn<TRow>[];
     /** Ключ строки или функция-резолвер. По умолчанию — поле `'id'`. */
     rowKey?: GrDataTableRowKey<TRow>;
     /** Ключ колонки для начальной сортировки (uncontrolled-режим). */
     initialSortKey?: string;
     /** Направление начальной сортировки (uncontrolled-режим). */
-    initialSortDir?: 'asc' | 'desc';
+    initialSortDir?: GrDataTableSortDir;
     /** Контролируемый ключ сортировки: `v-model:sortKey`. Задаёт controlled-режим. */
     sortKey?: string;
     /** Контролируемое направление сортировки: `v-model:sortDir`. */
-    sortDir?: 'asc' | 'desc';
+    sortDir?: GrDataTableSortDir;
+    /** Клик по заголовку: `asc → desc` или `asc → desc → без сортировки`. */
+    sortCycle?: GrDataTableSortCycle;
     /**
      * Внешняя сортировка (например серверная): компонент НЕ сортирует `rows`
      * сам, а только сообщает о смене через `update:sortKey`/`update:sortDir`/
-     * `sort-change`. `rows` при этом должны приходить уже отсортированными.
+     * `sortChange`. `rows` при этом должны приходить уже отсортированными.
      */
     externalSort?: boolean;
     /**
@@ -32,6 +50,8 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
     selectable?: boolean;
     /** Контролируемый список выбранных ключей строк: `v-model:selected`. */
     selected?: Array<string | number>;
+    /** Предикат «строку можно выбрать». Невыбираемые строки не попадают и в «выбрать все». */
+    selectableRow?: (row: TRow) => boolean;
     /**
      * Состояние загрузки: тело таблицы заменяется строкой-индикатором.
      * `empty`-состояние при этом не показывается.
@@ -39,50 +59,95 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
     loading?: boolean;
     /** Текст индикатора загрузки. i18n: fallback `gr.dataTable.loading`. */
     loadingText?: string;
-    density?: GrTableDensity;
+    /** Текст пустого состояния. i18n: fallback `gr.dataTable.empty`; слот `#empty` сильнее. */
+    emptyText?: string;
+    /** Класс строки: общий для всех либо вычисляемый по строке. */
+    rowClass?: string | ((row: TRow, index: number) => string | undefined);
+    /** Произвольные атрибуты строки (`data-*`, `title`, …). */
+    rowProps?: (row: TRow, index: number) => Record<string, unknown> | undefined;
+    /**
+     * Размер таблицы: кегль, паддинги ячеек, стрелки сортировки и чекбоксы.
+     * Прокидывается в `GrTable`.
+     */
+    size?: GrDataTableSize;
     caption?: string;
     ariaLabel?: string;
     ariaLabelledby?: string;
     regionLabel?: string;
     /** Прилипающий заголовок при вертикальном скролле (нужен `maxHeight`). */
     stickyHeader?: boolean;
+    /**
+     * Виртуализация строк: в DOM живёт только окно вокруг вьюпорта. Высоту окна
+     * задаёт `maxHeight`, без него окна прокрутки не существует.
+     *
+     * Включает фиксированную раскладку таблицы: ширина колонки считается по
+     * содержимому всех строк, а в DOM их только окно — без фиксации колонки
+     * прыгали бы на каждой прокрутке. Ширины стоит задать через `width` у
+     * колонок, иначе фиксированная раскладка делит место поровну.
+     */
+    virtual?: boolean;
     /** Максимальная высота таблицы (вертикальный скролл). Число — в пикселях. */
     maxHeight?: string | number;
 }
+export interface GrDataTableEmits<TRow extends Record<string, unknown> = Record<string, unknown>> {
+    (e: 'update:sortKey', value: string): void;
+    (e: 'update:sortDir', value: GrDataTableSortDir): void;
+    (e: 'sortChange', value: {
+        key: string;
+        dir: GrDataTableSortDir;
+    }): void;
+    (e: 'update:selected', value: Array<string | number>): void;
+    (e: 'rowClick', payload: {
+        row: TRow;
+        index: number;
+        event: MouseEvent;
+    }): void;
+}
 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:sortKey"?: ((value: string) => any) | undefined;
-        "onUpdate:sortDir"?: ((value: "desc" | "asc") => any) | undefined;
-        "onSort-change"?: ((value: {
+        "onUpdate:sortDir"?: ((value: GrDataTableSortDir) => any) | undefined;
+        onSortChange?: ((value: {
             key: string;
-            dir: "asc" | "desc";
+            dir: GrDataTableSortDir;
         }) => any) | undefined;
         "onUpdate:selected"?: ((value: (string | number)[]) => any) | undefined;
+        onRowClick?: ((payload: {
+            row: TRow;
+            index: number;
+            event: MouseEvent;
+        }) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
-    expose: (exposed: {}) => void;
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        /** Прокрутить к строке по её ключу. `false` — строки нет в DOM. */
+        scrollToRow: (key: string | number, options?: ScrollIntoViewOptions) => boolean;
+        /** Прокрутить скролл-контейнер таблицы. */
+        scrollTo: (options: ScrollToOptions) => void;
+        /** Снять сортировку (эквивалент третьего состояния). */
+        clearSort: () => void;
+        /** Отметить/снять все выбираемые строки. */
+        toggleAll: () => void;
+    }>) => void;
     attrs: any;
-    slots: {
-        [x: `cell-${string}`]: ((props: {
-            row: TRow;
-        }) => any) | undefined;
-    } & {
+    slots: { [K in NonNullable<`header-${string & {}}` | `header-${Extract<keyof TRow, string>}`>]?: ((props: {
+        column: GrDataColumn<TRow>;
+    }) => any) | undefined; } & { [K_1 in NonNullable<`header-${string & {}}` | `header-${Extract<keyof TRow, string>}`>]?: ((props: {
+        column: GrDataColumn<TRow>;
+    }) => any) | undefined; } & { [K_2 in NonNullable<`cell-${string & {}}` | `cell-${Extract<keyof TRow, string>}`>]?: ((props: {
+        row: TRow;
+        index: number;
+    }) => any) | undefined; } & {
         caption?: (props: {}) => any;
+    } & {
+        loading?: (props: {}) => any;
     } & {
         empty?: (props: {}) => any;
     } & {
-        foot?: (props: {}) => any;
-    };
-    emit: {
-        (e: "update:sortKey", value: string): void;
-        (e: "update:sortDir", value: "asc" | "desc"): void;
-        (e: "sort-change", value: {
-            key: string;
-            dir: "asc" | "desc";
-        }): void;
-        (e: "update:selected", value: Array<string | number>): void;
+        footer?: (props: {}) => any;
     };
+    emit: GrDataTableEmits<TRow>;
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

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

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

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

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

package/dist/types/src/components/GrDataTable/grDataTableSort.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Сравнение значений ячеек для сортировки `GrDataTable`.
+ *
+ * Логика вынесена из SFC: у неё есть крайние случаи, которые дешевле проверить
+ * прямым вызовом, чем через монтирование таблицы.
+ *
+ * Прежняя реализация приводила значение к числу через `Number(value)`, а он
+ * считает нулём и `null`, и пустую строку: пустые ячейки оседали в середине
+ * числового ряда, между отрицательными и положительными. Здесь пустое значение —
+ * отдельная категория, и она всегда в конце, независимо от направления.
+ */
+export type GrDataTableSortDir = 'asc' | 'desc';
+/** Пустое значение ячейки: нечего сравнивать, место таким — в конце списка. */
+export declare function isEmptyCell(value: unknown): boolean;
+/**
+ * Сравнивает два значения ячейки. Возвращает готовую разницу с учётом `dir` —
+ * кроме пустых значений: они всегда в конце, иначе «пустые» в `desc` уезжали бы
+ * наверх и таблица выглядела бы сломанной.
+ */
+export declare function compareCells(a: unknown, b: unknown, dir: GrDataTableSortDir, locale?: string): number;
+/**
+ * Новый отсортированный массив. Исходный не мутируется: `rows` приходят пропом,
+ * сортировка на месте меняла бы данные потребителя.
+ */
+export declare function sortRows<TRow extends Record<string, unknown>>(rows: readonly TRow[], key: string, dir: GrDataTableSortDir, locale?: string): TRow[];

package/dist/types/src/components/GrDataTable/grDataTableStyles.d.ts

@@ -0,0 +1,29 @@
+import type { GrCheckboxSize } from '../GrCheckbox/grCheckboxStyles';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrDataTableSize = GrComponentSize;
+/** Паддинг ячейки — и в шапке, и в теле: колонки обязаны совпадать по сетке. */
+export declare const cellPaddings: Record<GrDataTableSize, string>;
+/**
+ * Оценка высоты строки по размеру: два вертикальных отступа ячейки плюс строка
+ * текста и рамка. Виртуализация уточняет её замером — точное число здесь знать
+ * неоткуда, содержимое ячейки задаёт потребитель.
+ */
+export declare const rowHeightEstimates: Record<GrDataTableSize, number>;
+/** Заглушки loading/empty: по горизонтали как ячейка, по вертикали просторнее. */
+export declare const placeholderPaddings: Record<GrDataTableSize, string>;
+/** Подпись колонки набирается мельче тела таблицы — она не данные, а навигация. */
+export declare const headerTextSizes: Record<GrDataTableSize, string>;
+/**
+ * Размер `GrCheckbox` в колонке выбора. Здесь не классы, а ступень шкалы:
+ * коробку рисует сам чекбокс — он же держит `indeterminate`, disabled без
+ * `opacity` и фокус-кольцо.
+ */
+export declare const selectCheckboxSizes: Record<GrDataTableSize, GrCheckboxSize>;
+/** Ширина колонки выбора: коробка чекбокса плюс горизонтальный паддинг ячейки. */
+export declare const selectColumnWidths: Record<GrDataTableSize, string>;
+/** Зазор между подписью колонки и стрелкой сортировки. */
+export declare const headerGaps: Record<GrDataTableSize, string>;
+/** Спиннер в строке загрузки — тем же кеглем, что иконка сортировки рядом. */
+export declare const spinnerSizes: Record<GrDataTableSize, string>;
+/** Стрелка сортировки берёт размер из шкалы `GrIcon` (`xs…lg` → `14…20px`). */
+export declare const sortIconSizes: Record<GrDataTableSize, GrComponentSize>;

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

@@ -1,4 +1,13 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrDataTableComponent from './GrDataTable.vue';
 export { default } from './GrDataTable.vue';
 export { default as GrDataTable } from './GrDataTable.vue';
-export type { GrDataColumn, GrDataTableProps, GrDataTableRowKey } from './GrDataTable.vue';
+export type { GrDataColumn, GrDataColumnKey, GrDataTableProps, GrDataTableRowKey, GrDataTableSortCycle, } from './GrDataTable.vue';
+export type { GrDataTableSortDir } from './grDataTableSort';
+export { compareCells, isEmptyCell, sortRows } from './grDataTableSort';
 export { grDataTableConfig } from './config';
+export type { GrDataTableConfigurableProps } from './defaults';
+export type { GrDataTableSize } from './grDataTableStyles';
+export { grDataTableSafelist } from './safelist';
+export type { GrDataTableEmits } from './GrDataTable.vue';
+export type GrDataTableInstance = ComponentExposed<typeof GrDataTableComponent>;

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

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

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

@@ -1,3 +1,4 @@
+import type { GrModalScrollBehavior } from '../GrModal/grModalStyles';
 import { type GrDialogSectionConfig, type GrDialogSize } from './dialogShared';
 export interface GrDialogProps {
     modelValue: boolean;
@@ -12,7 +13,33 @@ export interface GrDialogProps {
     bodyConfig?: GrDialogSectionConfig;
     /** A11y-лейбл кнопки закрытия (i18n). */
     closeLabel?: string;
+    /**
+     * Доступное имя окна, когда заголовка нет вовсе: `showHeader: false` без
+     * `title` и без слота `#header` оставил бы окно безымянным.
+     */
+    ariaLabel?: string;
+    /**
+     * Кто скроллится при длинном содержимом. При `inside` шапка и подвал
+     * закреплены, а едет только тело.
+     */
+    scrollBehavior?: GrModalScrollBehavior;
+    /**
+     * Элемент, получающий фокус при открытии. По умолчанию — панель окна.
+     * Элемент **из самого диалога** сюда передавать нельзя: проп, возвращающий
+     * наверх то, что рождено внутри поддерева, замыкает рендер в цикл. Фокус на
+     * своём содержимом ставится из содержимого — так это сделано в
+     * `GrPromptDialog`.
+     */
+    initialFocus?: HTMLElement | null;
 }
+export interface GrDialogEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    /** Окно открылось и анимация закончилась. */
+    (e: 'opened'): void;
+    /** Окно закрылось и анимация закончилась — содержимое можно размонтировать. */
+    (e: 'closed'): void;
+}
+import './defaults';
 type __VLS_Slots = {
     default?: () => any;
     header?: (props: {
@@ -20,37 +47,57 @@ type __VLS_Slots = {
     }) => any;
     footer?: () => any;
 };
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDialogProps>, {
     title: undefined;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
     showHeader: boolean;
     showCloseButton: boolean;
-    size: string;
+    size: undefined;
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
     closeLabel: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    ariaLabel: undefined;
+    scrollBehavior: string;
+    initialFocus: null;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
+    opened: () => void;
+    closed: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDialogProps>, {
     title: undefined;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
     showHeader: boolean;
     showCloseButton: boolean;
-    size: string;
+    size: undefined;
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
     closeLabel: undefined;
+    ariaLabel: undefined;
+    scrollBehavior: string;
+    initialFocus: null;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onOpened?: (() => any) | undefined;
+    onClosed?: (() => any) | undefined;
 }>, {
     size: GrDialogSize;
     title: string;
-    closeOnBackdrop: boolean;
+    scrollBehavior: GrModalScrollBehavior;
+    ariaLabel: string;
+    initialFocus: HTMLElement | null;
     closeOnEsc: boolean;
+    closeOnBackdrop: boolean;
     showCloseButton: boolean;
     closeLabel: string;
     showHeader: boolean;

package/dist/types/src/components/GrDialog/GrDialogCloseButton.vue.d.ts

@@ -1,3 +1,6 @@
+export interface GrDialogCloseButtonEmits {
+    (e: 'click'): void;
+}
 declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     click: () => void;
 }, string, import("vue").PublicProps, Readonly<{}> & Readonly<{

package/dist/types/src/components/GrDialog/GrDialogHeader.vue.d.ts

@@ -6,6 +6,9 @@ export interface GrDialogHeaderProps {
     /** A11y-лейбл кнопки закрытия (i18n). */
     closeLabel?: string;
 }
+export interface GrDialogHeaderEmits {
+    (e: 'close'): void;
+}
 type __VLS_Slots = {
     default?: (props: {
         title?: string;

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

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

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

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

package/dist/types/src/components/GrDialog/dialogShared.d.ts

@@ -1,4 +1,5 @@
-export type GrDialogSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+import type { GrOverlaySize } from '../shared/sizes';
+export type GrDialogSize = GrOverlaySize;
 export interface GrDialogSectionConfig {
     paddingX?: string;
     paddingY?: string;

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

@@ -1,3 +1,5 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrDialogComponent from './GrDialog.vue';
 export { default } from './GrDialog.vue';
 export { default as GrDialog, type GrDialogProps } from './GrDialog.vue';
 export { default as GrDialogHeader, type GrDialogHeaderProps } from './GrDialogHeader.vue';
@@ -5,3 +7,6 @@ export { default as GrDialogFooter, type GrDialogFooterProps } from './GrDialogF
 export { default as GrDialogCloseButton } from './GrDialogCloseButton.vue';
 export { DEFAULT_GR_DIALOG_BODY_CONFIG, DEFAULT_GR_DIALOG_FOOTER_CONFIG, DEFAULT_GR_DIALOG_HEADER_CONFIG, type GrDialogSectionConfig, type GrDialogSize, resolveGrDialogSectionConfig, resolveGrDialogTitle, } from './dialogShared';
 export { grDialogSafelist } from './safelist';
+export type { GrDialogEmits } from './GrDialog.vue';
+export type GrDialogInstance = ComponentExposed<typeof GrDialogComponent>;
+export type { GrDialogCloseButtonEmits } from './GrDialogCloseButton.vue';

package/dist/types/src/components/GrDialogService/GrDialogServiceHost.vue.d.ts

@@ -1,3 +1,20 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+import type { DialogServiceState } from './store';
+export interface GrDialogServiceHostProps {
+    /**
+     * Состояние инстанса сервиса. Приходит пропом при программном монтировании:
+     * хост живёт вне дерева и своим `inject` до app-scoped состояния не дотянулся
+     * бы. `inject` остаётся для случая, когда хост поставили в шаблон руками.
+     */
+    state?: DialogServiceState | null;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrDialogServiceHostProps>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrDialogServiceHostProps>>> & Readonly<{}>, {}, {}, {}, {}, 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/src/components/GrDialogService/GrDialogServiceItem.vue.d.ts

@@ -0,0 +1,15 @@
+import type { DialogRequest } from './store';
+type __VLS_Props = {
+    request: DialogRequest;
+};
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>> & Readonly<{}>, {}, {}, {}, {}, 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/src/components/GrDialogService/config.d.ts

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

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

@@ -1,4 +1,6 @@
 export { default as GrDialogServiceHost } from './GrDialogServiceHost.vue';
-export { dialogService, teardownDialogService, useDialogService } from './useDialogService';
+export { dialogService, GRANULARITY_DIALOG_SERVICE_STATE, granularityDialogServicePlugin, teardownDialogService, useDialogService, } from './useDialogService';
+export type { DialogServiceState } from './store';
 export { grDialogServiceConfig } from './config';
 export type { DialogAlertOptions, DialogBaseOptions, DialogCloseAction, DialogConfirmContext, DialogConfirmOptions, DialogErrorOptions, DialogKind, DialogOnConfirm, DialogPromise, DialogPromptOptions, DialogResult, DialogService, DialogServiceDefaults, } from './types';
+export type { GrDialogServiceHostProps } from './GrDialogServiceHost.vue';

package/dist/types/src/components/GrDialogService/store.d.ts

@@ -1,11 +1,11 @@
-import type { Raw } from 'vue';
+import type { AppContext, Raw } from 'vue';
 import type { GrConfigContext } from '../GrConfigProvider/context';
 import type { GranularityI18nLike } from '../../internal/granularityI18n';
 import type { DialogBaseOptions, DialogKind, DialogOnConfirm, DialogResult } from './types';
 /**
  * Внутреннее описание одного запроса диалога в очереди. Создаётся методами
  * сервиса (`confirm`/`alert`/`prompt`/`open`) и потребляется хостом
- * (`GrDialogServiceHost`), который рендерит «голову» очереди (FIFO).
+ * (`GrDialogServiceHost`), который рендерит видимую часть очереди.
  */
 export interface DialogRequest {
     id: string;
@@ -13,6 +13,22 @@ export interface DialogRequest {
     message: string;
     options: DialogBaseOptions;
     onConfirm?: DialogOnConfirm<any>;
+    /** Позиция среди ожидающих: больше — раньше. При равенстве порядок FIFO. */
+    priority: number;
+    /**
+     * Заявка создана из `onConfirm` уже открытого диалога и показывается **поверх**
+     * него, а не за ним. Без этого вложенный вызов вставал бы в очередь за тем,
+     * кто его ждёт: внешнее окно висело бы в загрузке, а промис не резолвился бы
+     * никогда.
+     */
+    nested: boolean;
+    /**
+     * Заявка уже завершена. Флаг живёт на самой заявке, а не на хосте: завершить
+     * её могут трое (кнопка в окне, `close()` промиса, `closeAll()`), и общее
+     * состояние на хосте означало бы, что второй и третий путь про первый не
+     * знают.
+     */
+    settled: boolean;
     /** Резолвит промис вызова детальным результатом `{ action, value }`. */
     resolve: (result: DialogResult<any>) => void;
     /**
@@ -21,7 +37,7 @@ export interface DialogRequest {
      * `document.body` вне дерева, поэтому сам их не увидит — см.
      * `SPEC-GrConfig-resolver.md`.
      *
-     * Лежат в запросе, а не в модульной переменной: два поддерева с разными
+     * Лежат в запросе, а не в состоянии сервиса: два поддерева с разными
      * провайдерами должны получать каждое свой конфиг.
      *
      * `Raw<…>` обязателен: очередь — `reactive`, а он разворачивает вложенные рефы.
@@ -31,10 +47,65 @@ export interface DialogRequest {
     config?: Raw<GrConfigContext> | null;
     i18n?: Raw<GranularityI18nLike> | null;
 }
+/** Контекст, захваченный вызовом `useDialogService()` внутри `setup`. */
+export interface CapturedDialogContext {
+    config: Raw<GrConfigContext> | null;
+    i18n: Raw<GranularityI18nLike> | null;
+}
 /**
- * Модульный синглтон очереди диалогов: единый источник правды для всех
- * вызовов сервиса. Хост-компонент рендерит только `queue[0]` — это
- * сериализует диалоги (FIFO) и исключает конкуренцию за фокус-трап.
+ * Состояние одного инстанса сервиса: очередь, смонтированный хост и захваченный
+ * контекст приложения. Живёт либо в приложении (через
+ * `granularityDialogServicePlugin`), либо в ленивом модульном фолбэке для
+ * простых SPA — см. `useDialogService.ts`.
  */
-export declare const dialogQueue: import("vue").Reactive<DialogRequest[]>;
+export interface DialogServiceState {
+    /** Очередь заявок. Видимую часть выбирает хост, остальные ждут. */
+    queue: DialogRequest[];
+    mounted: boolean;
+    container: HTMLElement | null;
+    appContext: AppContext | null;
+    lastCapturedContext: CapturedDialogContext | null;
+    contextlessWarned: boolean;
+    /**
+     * Заявки, чей `onConfirm` сейчас в полёте, от внешней к самой глубокой.
+     * По ним определяется вложенность нового вызова.
+     */
+    inFlight: DialogRequest[];
+}
+export declare function createDialogServiceState(): DialogServiceState;
 export declare function makeDialogId(): string;
+/**
+ * Видимая часть очереди: голова и непрерывный хвост вложенных заявок за ней.
+ * Всё остальное ждёт — обычные вызовы по-прежнему идут по одному, чтобы три
+ * алерта из цикла не легли стопкой.
+ */
+export declare function visibleDialogRequests(state: DialogServiceState): DialogRequest[];
+/**
+ * Ставит заявку в очередь. Единственное место, где решается её позиция:
+ *
+ * - вложенная (создана, пока `onConfirm` другой заявки в полёте) встаёт сразу
+ *   за своим родителем и показывается поверх него;
+ * - обычная — перед всеми ожидающими с меньшим приоритетом; показанные окна не
+ *   трогаются, выдёргивать фокус-ловушку из-под пользователя нельзя.
+ */
+export declare function enqueueDialogRequest(state: DialogServiceState, request: DialogRequest): void;
+/**
+ * Заявка входит в «полёт»: пока её `onConfirm` не вернулся, новые вызовы
+ * считаются вложенными в неё.
+ */
+export declare function startDialogInFlight(state: DialogServiceState, request: DialogRequest): void;
+/** Заявка вышла из полёта (колбэк вернулся или окно размонтировано). */
+export declare function finishDialogInFlight(state: DialogServiceState, request: DialogRequest): void;
+/**
+ * Единственный способ завершить заявку: идемпотентно резолвит промис и снимает
+ * её из очереди.
+ *
+ * `removeFromQueue: false` нужен окну: оно гасит себя и даёт анимации закрытия
+ * доиграть, прежде чем заявка исчезнет из очереди. Корректность от этой
+ * отсрочки не зависит: повторное завершение отсекается флагом на заявке.
+ */
+export declare function settleDialogRequest(state: DialogServiceState, request: DialogRequest, result: DialogResult<any>, { removeFromQueue }?: {
+    removeFromQueue?: boolean;
+}): boolean;
+/** Снимает заявку из очереди, если она ещё там. */
+export declare function removeDialogRequest(state: DialogServiceState, request: DialogRequest): void;