@feugene/granularity 0.13.0 → 0.16.0

package/dist/types/src/composables/useFocusTrap.d.ts

@@ -0,0 +1,50 @@
+import type { Ref } from 'vue';
+export interface UseFocusTrapOptions {
+    /**
+     * Работает ли ловушка сейчас. Геттер, а не значение: модальное окно держит
+     * фокус, только пока оно верхнее в стеке слоёв, — иначе нижнее окно отбирало
+     * бы фокус у открытого поверх него.
+     */
+    active?: () => boolean;
+    /** Кому отдать фокус при активации. Не задан или не фокусируем — первый в контейнере. */
+    initialFocus?: () => HTMLElement | null | undefined;
+    /**
+     * Запасной приёмник фокуса, когда фокусировать внутри нечего: обычно сама
+     * панель с `tabindex="-1"`. Без него фокус остался бы снаружи, и Tab увёл бы
+     * пользователя на страницу под окном.
+     */
+    fallbackFocus?: () => HTMLElement | null | undefined;
+    /**
+     * Дополнительные корни, которые считаются частью слоя. Панель селекта,
+     * открытого внутри окна, телепортирована в `body` и лежит вне поддерева
+     * контейнера — без этого списка ловушка отбирала бы у неё фокус.
+     */
+    containers?: () => (HTMLElement | null | undefined)[];
+    /**
+     * Возвращать фокус туда, где он был до активации. По умолчанию — да.
+     * Оверлеи пакета выключают: возврат делает стек слоёв по более строгому
+     * правилу (только если фокус на момент закрытия ещё внутри слоя).
+     */
+    restoreFocus?: boolean;
+}
+/**
+ * Ловушка фокуса: пока активна, Tab ходит по кругу внутри слоя, а фокус,
+ * утёкший наружу, возвращается обратно.
+ *
+ * Реализована на `keydown` и `focusin`, **без sentinel-узлов**: распространённый
+ * подход с двумя focus-guard кнопками по краям кладёт в разметку интерактивные
+ * элементы, а внутрь контейнера с ARIA-ролью их класть нельзя — роль объявляет
+ * потомков презентационными (axe: `nested-interactive`).
+ *
+ * Слой из ловушки не выводится: порядок окон, Esc и `inert` — забота
+ * `useOverlayLayer`. Композиция такая:
+ *
+ * ```ts
+ * const layer = useOverlayLayer(open, close, { modal: true, root: panelRef })
+ * useFocusTrap(panelRef, {
+ *   active: () => open.value && isTopmost.value,
+ *   containers: layer.rootsAbove,
+ * })
+ * ```
+ */
+export declare function useFocusTrap(container: Ref<HTMLElement | null>, options?: UseFocusTrapOptions): void;

package/dist/types/src/composables/useGrFormControl.d.ts

@@ -0,0 +1,52 @@
+import type { ComputedRef } from 'vue';
+/**
+ * Общий контракт форм-контрола.
+ *
+ * До него каждый контрол решал одно и то же по-своему: `invalid` был то своим
+ * пропом, то только контекстом, то не был реализован вовсе; `readonly` жил у
+ * трёх контролов из пятнадцати, `required` — у двух. Из-за этого «форма только
+ * на чтение» приходилось делать через `disabled`, а это меняет и семантику
+ * (значение не уходит в форму), и контраст.
+ *
+ * Композабл сводит два источника — собственные пропы контрола и контекст
+ * `GrFormField` — в одно состояние. Правило одно: **проп контрола сильнее**,
+ * контекст работает как fallback. Исключение — `invalid`, `required` и
+ * `disabled`: там источники складываются по «или», потому что поле может
+ * объявить ошибку, о которой контрол не знает (правило формы), а форма —
+ * выключить себя целиком на время отправки.
+ */
+export interface GrFormControlProps {
+    /** Контрол недоступен: не фокусируется, значение не отправляется. */
+    disabled?: boolean;
+    /** Значение видно и отправляется, но не редактируется. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
+    /** Обязательное поле. */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
+}
+export interface GrFormControlState {
+    /** Итоговый `disabled`. */
+    disabled: ComputedRef<boolean>;
+    /** Итоговый `readonly`. */
+    readonly: ComputedRef<boolean>;
+    /** Итоговый `invalid`: свой проп ИЛИ ошибка поля. */
+    invalid: ComputedRef<boolean>;
+    /** Итоговый `required`: свой проп ИЛИ обязательность поля. */
+    required: ComputedRef<boolean>;
+    /** Id контрола из поля (для `<label for>`). */
+    id: ComputedRef<string | undefined>;
+    /** Id подписи поля — для виджетов с ARIA-ролью, к которым `<label for>` неприменим. */
+    labelId: ComputedRef<string | undefined>;
+    /** `aria-describedby`: подсказка и/или текст ошибки поля. */
+    describedBy: ComputedRef<string | undefined>;
+    /** `true`, когда контрол не принимает ввод (`disabled` или `readonly`). */
+    locked: ComputedRef<boolean>;
+}
+/**
+ * @param source геттер собственных пропов контрола. Геттер, а не объект, —
+ * чтобы не терять реактивность на `props`.
+ */
+export declare function useGrFormControl(source?: () => GrFormControlProps): GrFormControlState;

package/dist/types/src/composables/useOverlayLayer.d.ts

@@ -0,0 +1,67 @@
+import type { Ref } from 'vue';
+export interface UseOverlayLayerOptions {
+    /**
+     * Модальный слой: блокирует страницу, и модалки под ним получают `inert`.
+     * Немодальные (поповеры, меню, подсказки) участвуют только в очереди Esc.
+     * По умолчанию `false`.
+     *
+     * Геттером — там, где модальность включается пропом (`GrDrawer`): значение
+     * читается в момент регистрации, то есть при каждом открытии.
+     */
+    modal?: boolean | (() => boolean);
+    /**
+     * Закрывать ли слой по Esc. Геттер, а не значение, — чтобы читать реактивный
+     * проп (`closeOnEsc`). По умолчанию закрывается всегда.
+     *
+     * Если геттер вернёт `false`, нажатие всё равно не пройдёт на слой ниже:
+     * пользователь видит верхним этот слой, и Esc адресован ему.
+     */
+    closeOnEscape?: () => boolean;
+    /**
+     * Уведомление «этот модальный слой сейчас верхний». Компонент вешает по нему
+     * `inert` на свой корень, когда перестал быть верхним.
+     */
+    onTopmostChange?: (isTopmost: boolean) => void;
+    /**
+     * Возвращать фокус элементу, который был активен до открытия. По умолчанию —
+     * да. Отключать имеет смысл там, где фокус с триггера и не уходил: `GrSelect`
+     * ведёт список через `aria-activedescendant`.
+     */
+    restoreFocus?: boolean;
+    /**
+     * Корень слоя. Нужен дважды: для правила возврата фокуса (если на момент
+     * закрытия фокус уже вне слоя, пользователь ушёл сам — забирать нельзя) и
+     * для ловушки фокуса слоя под ним, которая обязана считать этот корень
+     * своим (панель селекта внутри модалки телепортирована в `body`).
+     */
+    root?: Ref<HTMLElement | null>;
+}
+export interface OverlayLayerHandle {
+    /**
+     * Корни слоёв, открытых поверх этого. Передаётся в `useFocusTrap` как
+     * `containers`: пока панель, открытая изнутри окна, жива, фокус в ней
+     * законен.
+     */
+    rootsAbove: () => HTMLElement[];
+}
+/**
+ * Регистрирует оверлей в общем стеке слоёв, пока `open` истинно.
+ *
+ * Один контракт на порядок Esc, `inert` и возврат фокуса — три механизма,
+ * которые обязаны видеть один и тот же порядок слоёв. Что берёт на себя:
+ *
+ *  - **Esc** — верхнему слою, вниз не проваливается;
+ *  - **`inert`** — через `onTopmostChange` у модальных слоёв;
+ *  - **возврат фокуса** — по единому правилу (см. ниже).
+ *
+ * Чего **не** делает: фокус-ловушку — это `useFocusTrap`, отдельный примитив.
+ * Поповеру ловушка и не нужна: Tab обязан уводить фокус наружу и закрывать его,
+ * поэтому связка «слой + ловушка» собирается в компоненте, а не тут.
+ *
+ * Правило возврата фокуса: восстанавливаем, **только если на момент закрытия
+ * фокус всё ещё внутри слоя**. Если пользователь кликнул в другое поле, фокус
+ * уже там — забирать его обратно нельзя. Эвристика «возвращать, если открыли с
+ * клавиатуры» промахивается в обе стороны: мышью открытый слой фокус не вернёт,
+ * а клавиатурный отберёт его у того, куда пользователь ушёл сам.
+ */
+export declare function useOverlayLayer(open: Ref<boolean>, onDismiss: () => void, options?: UseOverlayLayerOptions): OverlayLayerHandle;

package/dist/types/src/composables/usePortalTarget.d.ts

@@ -0,0 +1,28 @@
+import type { ComputedRef } from 'vue';
+export interface PortalTarget {
+    /** Куда телепортировать: элемент портала либо селектор из конфига. */
+    target: ComputedRef<string | HTMLElement>;
+    /**
+     * Можно ли телепортировать прямо сейчас. `false` на сервере и на первом
+     * клиентском рендере — иначе разметка разъедется на гидрации.
+     */
+    enabled: ComputedRef<boolean>;
+}
+/**
+ * Куда монтируются оверлеи пакета.
+ *
+ * Приоритет: локальное переопределение компонента (`teleportTo`) →
+ * `portalTarget` из `GrConfigProvider` → общий корень `#gr-portal`, который
+ * создаётся при первом обращении.
+ *
+ * ```vue
+ * const { target, enabled } = usePortalTarget(() => props.teleportTo)
+ *
+ * <teleport :to="target" :disabled="!enabled">…</teleport>
+ * ```
+ *
+ * Композабл публичный: свой оверлей потребителя должен уезжать туда же, куда и
+ * оверлеи библиотеки, — иначе он окажется вне ветки портала и будет помечен
+ * `inert` вместе со страницей, как только откроется модалка.
+ */
+export declare function usePortalTarget(local?: () => string | HTMLElement | undefined): PortalTarget;

package/dist/types/src/composables/useTheme.d.ts

@@ -1,4 +1,4 @@
-import type { Ref } from 'vue';
+import type { App, InjectionKey, Ref } from 'vue';
 export type ThemeName = 'light' | 'dark';
 export type UseThemeOptions = {
     /**
@@ -11,11 +11,56 @@ export type UseThemeOptions = {
      * По умолчанию: `true`.
      */
     persist?: boolean;
+    /**
+     * Куда писать `data-theme`. По умолчанию — `<html>` (канон одного приложения).
+     *
+     * Геттер, а не элемент: на момент `app.use(...)` корень приложения ещё не
+     * смонтирован. Обязателен нескольким приложениям с независимыми темами:
+     * селектор тем атрибутный (`[data-theme='dark']`), поэтому тема работает от
+     * любого контейнера, а без `target` все приложения писали бы в один `<html>`
+     * и побеждал бы последний.
+     */
+    target?: () => HTMLElement | null;
+};
+/**
+ * Состояние темы одного приложения.
+ *
+ * `theme` общий для всех вызовов `useTheme()` внутри приложения: свой `ref` на
+ * вызов означал бы, что переключение темы в одном компоненте не трогает
+ * `theme`/`isDark` в другом — менялся бы только DOM-атрибут, а реактивные
+ * потребители разъехались бы.
+ */
+type ThemeState = {
+    theme: Ref<ThemeName>;
+    storageKey: string;
+    persist: boolean;
+    /** Корень, получающий `data-theme`; не задан — `<html>`. */
+    target?: () => HTMLElement | null;
+    listenersBound: boolean;
+    /**
+     * Снимает window-слушатели состояния. Появляется после `bindListeners`;
+     * зовёт `app.onUnmount` у app-scoped состояний — модульный синглтон живёт со
+     * страницей, и снимать его незачем.
+     */
+    teardownListeners?: () => void;
+    /** Разрешена ли мутация — см. `resolveThemeState`. */
+    writable: boolean;
+};
+/** Ключ provide/inject для app-scoped состояния темы (устанавливает плагин ниже). */
+export declare const GRANULARITY_THEME_STATE: InjectionKey<ThemeState>;
+export declare const granularityThemePlugin: {
+    install(app: App, options?: UseThemeOptions): void;
 };
+/** Сброс dev-предупреждения о фолбэке. Внутреннее API — нужно тестам. */
+export declare function resetThemeContextWarning(): void;
 /**
  * Для применения темы максимально рано (до монтирования Vue), чтобы избежать "мигания".
- * Также сидирует shared-синглтон, чтобы значение в `useTheme()` совпадало с уже
+ * Также сидирует модульное состояние, чтобы значение в `useTheme()` совпадало с уже
  * применённым к документу.
+ *
+ * Функция клиентская: её зовут из браузерной точки входа до создания приложения,
+ * то есть app-scoped состояние инжектить там ещё неоткуда. Расхождения с плагином
+ * это не даёт — оба сидируются из одного `localStorage`.
  */
 export declare function initThemeEarly(options?: UseThemeOptions): void;
 export declare function useTheme(options?: UseThemeOptions): {
@@ -25,3 +70,4 @@ export declare function useTheme(options?: UseThemeOptions): {
     toggleTheme: () => void;
     initTheme: () => void;
 };
+export {};

package/dist/types/src/composables/useToast.d.ts

@@ -31,6 +31,15 @@ export type ToastInput = {
     /** Несколько action-кнопок в теле тоста. Рендерятся после `action`. */
     actions?: ToastAction[];
 };
+/**
+ * Сообщения для `promise`. Строка — шорткат для `{ title }`; функция получает
+ * результат промиса (или причину отказа), чтобы подставить его в текст.
+ */
+export type ToastPromiseMessages<T> = {
+    loading: string | ToastInput;
+    success: string | ToastInput | ((value: T) => string | ToastInput);
+    error: string | ToastInput | ((reason: unknown) => string | ToastInput);
+};
 export type Toast = {
     id: string;
     title: string;
@@ -53,25 +62,25 @@ type ToastTimer = {
 export type ToastState = {
     toasts: Toast[];
     timers: Map<string, ToastTimer>;
+    /** Потолок очереди: сверх него самые старые тосты вытесняются. */
+    maxToasts: number;
+};
+export type GranularityToastPluginOptions = {
+    /** Потолок очереди. По умолчанию `20`. */
+    maxToasts?: number;
 };
 /** Ключ provide/inject для app-scoped состояния тостов (устанавливает плагин ниже). */
 export declare const GRANULARITY_TOAST_STATE: InjectionKey<ToastState>;
-/**
- * Vue-плагин: даёт каждому приложению собственное изолированное состояние тостов
- * через `app.provide`. Обязателен для (а) нескольких Vue-приложений на одной
- * странице (микрофронтенды — иначе делят один стек тостов) и (б) SSR (иначе
- * модульное состояние течёт между запросами).
- *
- * ```ts
- * app.use(granularityToastPlugin)
- * ```
- */
 export declare const granularityToastPlugin: {
-    install(app: App): void;
+    install(app: App, options?: GranularityToastPluginOptions): void;
 };
+/** Сброс dev-предупреждения о фолбэке. Внутреннее API — нужно тестам. */
+export declare function resetToastContextWarning(): void;
 export declare function useToast(): {
     list: import("vue").ComputedRef<Toast[]>;
     push: (input: ToastInput) => string;
+    update: (id: string, patch: Partial<ToastInput>) => boolean;
+    promise: <T>(input: Promise<T>, messages: ToastPromiseMessages<T>) => Promise<T>;
     dismiss: (id: string) => void;
     clear: () => void;
     pause: (id: string) => void;

package/dist/types/src/composables/useVirtualList.d.ts

@@ -0,0 +1,119 @@
+import type { ComputedRef, Ref } from 'vue';
+/**
+ * Виртуализация длинного списка: в DOM живёт только окно вокруг вьюпорта.
+ *
+ * Композабл считает геометрию и отдаёт три числа — какой срез рисовать
+ * (`range`), какой высоты держать распорку (`totalSize`) и на сколько сдвинуть
+ * отрисованное (`offset`). Разметку строит потребитель: примитив ничего не
+ * рендерит и ничего не знает про роли и клавиатуру своего списка.
+ *
+ * Скролл-протяжённость держат псевдоэлементы контейнера: `spacerStyle` отдаёт
+ * их высоты переменными, а правило живёт в `<style>` компонента. Так
+ * отрисованные строки остаются **прямыми детьми** контейнера, и роль вроде
+ * `tree` или `listbox` не теряет обязательных потомков.
+ *
+ * ```vue
+ * const container = useTemplateRef('scroller')
+ * const { range, spacerStyle, measure } = useVirtualList({
+ *   container,
+ *   count: () => rows.value.length,
+ *   itemSize: 28,
+ *   viewportSize: () => props.maxHeight,
+ * })
+ *
+ * <div
+ *   ref="scroller"
+ *   role="tree"
+ *   data-gr-virtual
+ *   :style="{ overflow: 'auto', maxHeight: '280px', ...spacerStyle }"
+ * >
+ *   <Row v-for="i in window" :key="…" :ref="el => measure(i, el)" />
+ * </div>
+ *
+ * <style scoped>
+ * [data-gr-virtual]::before,
+ * [data-gr-virtual]::after { content: ''; display: block; flex: none; }
+ * [data-gr-virtual]::before { height: var(--gr-virtual-before, 0px); }
+ * [data-gr-virtual]::after { height: var(--gr-virtual-after, 0px); }
+ * </style>
+ * ```
+ *
+ * Почему правило повторяется в каждом компоненте, а не лежит в одном файле:
+ * единственный глобальный стиль пакета (`styles/base.css`) потребитель вправе
+ * не подключать, и уехавшее туда правило молча ломало бы прокрутку. Сверяет
+ * копии гейт `src/__tests__/virtualSpacer.test.ts`.
+ */
+/** Куда поставить элемент относительно вьюпорта при прокрутке к нему. */
+export type GrVirtualAlign = 'auto' | 'start' | 'center' | 'end';
+export interface UseVirtualListOptions {
+    /** Скроллящийся контейнер. До монтирования — `null`. */
+    container: Ref<HTMLElement | null>;
+    /** Сколько элементов в списке. */
+    count: () => number;
+    /**
+     * Оценка высоты элемента. Фактическая берётся из замера, как только элемент
+     * отрисован, — строки пакета заданы через `min-height`, и точного числа тут
+     * знать неоткуда.
+     */
+    itemSize: number | ((index: number) => number);
+    /**
+     * Высота вьюпорта до первого замера контейнера. Нужна, чтобы **первый рендер
+     * был детерминированным**: на сервере контейнера нет вовсе, а на клиенте он
+     * ещё не измерен. Без неё сервер и клиент нарисовали бы разные окна и
+     * гидрация разъехалась бы; с ней оба считают окно от одного числа.
+     */
+    viewportSize?: () => number | undefined;
+    /**
+     * Идентити-токен данных списка — обычно сам массив. Смена идентичности
+     * сбрасывает все замеры (`invalidate()`): они привязаны к индексам, и после
+     * сортировки или замены массива хранили бы высоты чужих строк.
+     *
+     * Правило потребителя: **мутация массива на месте сохраняет замеры, замена
+     * массива сбрасывает**. Append в тот же реактивный массив (инфинити-скролл)
+     * идентичность не меняет — префикс замеров остаётся валидным.
+     */
+    source?: () => unknown;
+    /**
+     * Зазор между элементами в пикселях (`gap` у flex/grid-контейнера).
+     *
+     * Замер элемента его не видит — `getBoundingClientRect` меряет коробку, а не
+     * шаг раскладки. Без этого числа список считался бы короче, чем он есть,
+     * и окно уползало бы тем сильнее, чем дальше прокрутка.
+     */
+    gap?: number;
+    /** Сколько элементов рисовать за пределами вьюпорта. По умолчанию `4`. */
+    overscan?: number;
+}
+export interface UseVirtualListReturn {
+    /** Полуинтервал индексов к отрисовке: `[start, end)`. */
+    range: ComputedRef<{
+        start: number;
+        end: number;
+    }>;
+    /** Полная высота содержимого: распорка, которая держит скроллбар. */
+    totalSize: ComputedRef<number>;
+    /** Отступ сверху: высота срезанного до окна. */
+    offset: ComputedRef<number>;
+    /** Отступ снизу: высота срезанного после окна. */
+    offsetEnd: ComputedRef<number>;
+    /**
+     * Стиль контейнера: высоты распорок и выключенный scroll anchoring.
+     *
+     * Имена переменных приезжают готовыми, поэтому написать их руками — и
+     * разойтись с правилом в `<style>` — нельзя. Опечатка в имени давала бы
+     * список без прокрутки, и увидеть это можно было бы только глазами.
+     */
+    spacerStyle: ComputedRef<Record<string, string>>;
+    /** Регистрация отрисованного элемента: замер и подписка на изменение высоты. */
+    measure: (index: number, el: Element | null) => void;
+    /** Прокрутка к элементу. Без выравнивания — минимальным движением. */
+    scrollToIndex: (index: number, align?: GrVirtualAlign) => void;
+    /**
+     * Сбрасывает замеры с индекса `from` (по умолчанию — все) к оценкам.
+     * Видимые строки перемеряются первым же рендером; для смены данных обычно
+     * достаточно опции `source` — ручной вызов нужен, когда высоты строк
+     * изменились без замены массива (смена плотности, ресайз колонок).
+     */
+    invalidate: (from?: number) => void;
+}
+export declare function useVirtualList(options: UseVirtualListOptions): UseVirtualListReturn;

package/dist/types/src/directives/loading.d.ts

@@ -1,4 +1,5 @@
 import type { AppContext, Component, Directive } from 'vue';
+import type { GrIconSize, GrIconTone } from '../components/GrIcon/grIconStyles';
 export type LoadingTarget = string | HTMLElement;
 export type LoadingOptions = {
     /**
@@ -15,9 +16,14 @@ export type LoadingOptions = {
     text?: string;
     spinner?: Component;
     spinnerClass?: string;
+    spinnerSize?: GrIconSize | number;
+    spinnerTone?: GrIconTone;
     animated?: boolean;
     background?: string;
-    zIndex?: number;
+    /** Имя CSS-переменной слоя — escape-hatch мимо `--gr-z-loading`. */
+    zIndexVar?: string;
+    /** Задержка показа в миллисекундах: короткая загрузка не мигает оверлеем. */
+    delay?: number;
     customClass?: string;
     /**
      * Внутренний контекст Vue-приложения.

package/dist/types/src/fileValidation/i18n.d.ts

@@ -0,0 +1,24 @@
+import type { FileValidationIssue, FileValidationIssueCode } from './types';
+/**
+ * Неймспейс ключей перевода встроенных валидаторов.
+ *
+ * Ключ выводится из `code`, поэтому новый встроенный валидатор получает перевод
+ * автоматически — достаточно завести строку в `i18n/locales/*.json`.
+ */
+export declare const FILE_VALIDATION_I18N_NAMESPACE = "gr.fileValidation";
+export declare function fileValidationI18nKey(code: FileValidationIssueCode): string;
+/**
+ * Текст ошибки валидации для показа пользователю.
+ *
+ * Порядок: явный `i18nKey` → ключ, выведенный из `code` → английский `message`.
+ *
+ * `i18nKey` существует отдельно от `code` не для симметрии: `code` — это ветка
+ * для обработчика на стороне потребителя, и два разных по смыслу сообщения
+ * могут делить один `code` (так у `allowedMimeTypesValidator`: обычный
+ * запрещённый тип и fallback-тип — оба `mimeType`). Формулировка при этом нужна
+ * разная, и различает их именно ключ.
+ *
+ * `message` остаётся обязательным полем типа и работает как безопасный fallback:
+ * валидатор потребителя, ничего не знающий про i18n, продолжает показываться.
+ */
+export declare function resolveFileValidationMessage(issue: FileValidationIssue, t: (key: string, fallback: string, params?: Record<string, unknown>) => string): string;

package/dist/types/src/fileValidation/index.d.ts

@@ -2,10 +2,12 @@ export type * from './types';
 export { FileValidationError } from './FileValidationError';
 export { normalizeFiles, runFileValidators } from './runFileValidators';
 export { matchAccept } from './matchAccept';
+export { FILE_VALIDATION_I18N_NAMESPACE, fileValidationI18nKey, resolveFileValidationMessage } from './i18n';
 export { acceptValidator } from './acceptValidator';
 export { allowedExtensionsValidator } from './allowedExtensionsValidator';
 export { allowedMimeTypesValidator } from './allowedMimeTypesValidator';
 export type { AllowedMimeTypesValidatorOptions } from './allowedMimeTypesValidator';
-export { maxFileSizeBytesValidator } from './maxFileSizeBytesValidator';
-export { maxSizeMbValidator } from './maxSizeMbValidator';
+export { maxCountValidator } from './maxCountValidator';
+export { maxFileSize } from './maxFileSize';
+export type { MaxFileSizeOptions } from './maxFileSize';
 export { maxTotalSizeBytesValidator } from './maxTotalSizeBytesValidator';

package/dist/types/src/fileValidation/maxCountValidator.d.ts

@@ -0,0 +1,9 @@
+import type { FileValidator } from './types';
+/**
+ * Ограничение количества файлов в наборе.
+ *
+ * Валидатором, а не проверкой внутри компонента: тогда ограничение одинаково
+ * работает и на выборе через диалог, и на перетаскивании, и его сообщение
+ * проходит тем же путём локализации, что и остальные.
+ */
+export declare function maxCountValidator(maxCount: number | undefined): FileValidator;

package/dist/types/src/fileValidation/maxFileSize.d.ts

@@ -0,0 +1,16 @@
+import type { FileValidator } from './types';
+export interface MaxFileSizeOptions {
+    /** Предел в байтах. */
+    bytes?: number;
+    /** Предел в мегабайтах — sugar к `bytes` (1 МБ = 1024 × 1024). */
+    mb?: number;
+}
+/**
+ * Ограничение размера **одного** файла. Суммарный размер набора — отдельный
+ * валидатор `maxTotalSizeBytesValidator`.
+ *
+ * Предел задаётся либо в байтах, либо в мегабайтах. Если заданы оба, берётся
+ * меньший: молча игнорировать один из двух объявленных пределов хуже, чем
+ * применить строгий.
+ */
+export declare function maxFileSize(options: MaxFileSizeOptions): FileValidator;

package/dist/types/src/fileValidation/types.d.ts

@@ -1,4 +1,4 @@
-export type FileValidationIssueCode = 'accept' | 'mimeType' | 'extension' | 'maxSize' | 'maxFileSize' | 'maxTotalSize' | (string & {});
+export type FileValidationIssueCode = 'accept' | 'mimeType' | 'extension' | 'maxCount' | 'maxFileSize' | 'maxTotalSize' | (string & {});
 export type FileValidationIssue = {
     fileName?: string;
     code: FileValidationIssueCode;
@@ -14,7 +14,13 @@ export type FileValidationIssue = {
     i18nKey?: string;
     i18nParams?: Record<string, unknown>;
 };
-export type FileValidatorSource = 'input' | 'drop';
+/**
+ * Откуда пришёл набор: выбор в диалоге, перетаскивание или проверка формы перед
+ * отправкой (правило `file` у `GrForm`). Последний случай отличают не ради
+ * симметрии: дорогой валидатор вправе работать на submit и молчать на каждом
+ * выборе файла.
+ */
+export type FileValidatorSource = 'input' | 'drop' | 'form';
 export type FileValidatorContext = {
     source: FileValidatorSource;
     multiple: boolean;

package/dist/types/src/granular-provider/index.d.ts

@@ -1,3 +1,3 @@
 export * from './shared';
-export declare const granularityProvider: import("@feugene/unocss-preset-granular").GranularProvider;
+export declare const granularityProvider: import("@feugene/unocss-preset-granular/contract").GranularProvider;
 export default granularityProvider;

package/dist/types/src/granular-provider/node.d.ts

@@ -1,3 +1,2 @@
-export * from './shared';
-export declare const granularityProvider: import("@feugene/unocss-preset-granular").GranularProvider;
-export default granularityProvider;
+export * from './index';
+export { default } from './index';