@feugene/granularity 0.45.0 → 0.47.0

package/dist/types/components/GrAutocomplete/composables/useAutocompleteValues.d.ts

@@ -0,0 +1,28 @@
+import type { ComputedRef, Ref, ShallowRef } from 'vue';
+import type { GrAutocompleteModelValue, GrAutocompleteOption, GrAutocompleteValue } from '../GrAutocomplete.vue';
+/**
+ * Значение и опции `GrAutocomplete`: что выбрано и как это назвать.
+ *
+ * Ничего про панель, клавиатуру и вид. Состав списка зависит от того, отвечал
+ * ли уже сервер: до первого ответа источник — проп `options`, иначе последний
+ * ответ `fetchOptions`.
+ */
+export interface UseAutocompleteValuesOptions<TValue extends GrAutocompleteValue> {
+    modelValue: () => GrAutocompleteModelValue<TValue>;
+    options: () => GrAutocompleteOption<TValue>[] | undefined;
+    multiple: () => boolean;
+    fetchOptions: () => unknown;
+    remoteOptions: ShallowRef<GrAutocompleteOption<TValue>[]>;
+    remoteAnswered: Ref<boolean>;
+}
+export interface AutocompleteValues<TValue extends GrAutocompleteValue> {
+    optionsResolved: ComputedRef<GrAutocompleteOption<TValue>[]>;
+    isEmptyValue: (value: unknown) => boolean;
+    modelSingle: ComputedRef<TValue | ''>;
+    selectedValues: ComputedRef<TValue[]>;
+    hasSelection: ComputedRef<boolean>;
+    labelFor: (value: GrAutocompleteValue) => string;
+    selectedOptions: ComputedRef<GrAutocompleteOption<TValue>[]>;
+    singleSelectedLabel: ComputedRef<string>;
+}
+export declare function useAutocompleteValues<TValue extends GrAutocompleteValue>(options: UseAutocompleteValuesOptions<TValue>): AutocompleteValues<TValue>;

package/dist/types/components/GrAutocomplete/composables/useAutocompleteVirtual.d.ts

@@ -0,0 +1,33 @@
+import type { ComputedRef, Ref } from 'vue';
+import { useVirtualList } from '../../../composables/useVirtualList';
+import type { GrAutocompleteOption, GrAutocompleteValue } from '../GrAutocomplete.vue';
+/**
+ * Виртуализация панели `GrAutocomplete`.
+ *
+ * Набор — `[«Add …»?] + effectiveOptions`, тот же, по которому ходит клавиатура.
+ * Иначе верхняя распорка вытолкнула бы строку «Add …» вниз: она отрисована
+ * внутри listbox'а первой и является полноценной опцией. Отсюда `addOffset`,
+ * который сдвигает окно виртуализатора относительно индексов в списке опций.
+ */
+export interface UseAutocompleteVirtualOptions<TValue extends GrAutocompleteValue> {
+    /** Контейнер списка: по нему считается окно и замеряются строки. */
+    listboxEl: Ref<HTMLElement | null>;
+    effectiveOptions: ComputedRef<GrAutocompleteOption<TValue>[]>;
+    canAddCustom: ComputedRef<boolean>;
+    virtual: () => boolean;
+    dropdownMaxHeight: () => number;
+}
+export interface AutocompleteVirtual<TValue extends GrAutocompleteValue> {
+    /** Сдвиг окна из-за строки «Add …»: она идёт нулевым элементом набора. */
+    addOffset: ComputedRef<number>;
+    virtualCount: ComputedRef<number>;
+    virtualizer: ReturnType<typeof useVirtualList>;
+    showAddOption: ComputedRef<boolean>;
+    renderedOptions: ComputedRef<Array<{
+        option: GrAutocompleteOption<TValue>;
+        index: number;
+    }>>;
+    optionSetProps: (virtualIndex: number) => Record<string, number> | undefined;
+    listboxStyle: ComputedRef<Record<string, string>>;
+}
+export declare function useAutocompleteVirtual<TValue extends GrAutocompleteValue>(options: UseAutocompleteVirtualOptions<TValue>): AutocompleteVirtual<TValue>;

package/dist/types/components/GrAutocomplete/composables/useRemoteOptions.d.ts

@@ -0,0 +1,33 @@
+import type { Ref, ShallowRef } from 'vue';
+import type { GrAutocompleteOption, GrAutocompleteValue } from '../GrAutocomplete.vue';
+/**
+ * Дебаунснутая удалённая загрузка опций.
+ *
+ * Три вещи, каждая из которых по отдельности выглядит необязательной, а вместе
+ * составляют весь смысл модуля: запрос откладывается на `debounce`, летящий
+ * отменяется новым, а ответ, стартовавший раньше и пришедший позже, обязан
+ * проиграть последнему — иначе список показывает результат старого запроса.
+ *
+ * От DOM не зависит вовсе, поэтому проверяется без монтирования компонента.
+ *
+ * Единственный потребитель сегодня — `GrAutocomplete`. Появится второй
+ * (открытая строка аудита: `GrTransfer` отдаёт `search` наружу, а подгрузку
+ * делает потребитель) — модулю место в `composables/internal/`.
+ */
+export interface UseRemoteOptionsOptions<TValue extends GrAutocompleteValue> {
+    fetchOptions: () => ((query: string, signal: AbortSignal) => Promise<GrAutocompleteOption<TValue>[]>) | undefined;
+    /** Стартовый список: его смена сбрасывает ответ сервера. */
+    options: () => GrAutocompleteOption<TValue>[] | undefined;
+    debounce: () => number;
+    minQueryLength: () => number;
+    onSearch: (query: string) => void;
+    onSearchError: (error: unknown) => void;
+}
+export interface RemoteOptions<TValue extends GrAutocompleteValue> {
+    remoteOptions: ShallowRef<GrAutocompleteOption<TValue>[]>;
+    remoteAnswered: Ref<boolean>;
+    remoteLoading: Ref<boolean>;
+    scheduleSearch: (value: string) => void;
+    cancelSearch: () => void;
+}
+export declare function useRemoteOptions<TValue extends GrAutocompleteValue>(options: UseRemoteOptionsOptions<TValue>): RemoteOptions<TValue>;

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

@@ -1,4 +1,4 @@
-import { type GrDataTableSortDir } from './grDataTableSort';
+import type { GrDataTableSortDir } from './grDataTableSort';
 import { type GrDataTableSize } from './grDataTableStyles';
 /**
  * Ключ колонки. Собственные поля строки подсказываются автодополнением, но

package/dist/types/components/GrDataTable/composables/useDataTableColumnOrder.d.ts

@@ -0,0 +1,45 @@
+import type { ComputedRef } from 'vue';
+import { useDragSort } from '../../../composables/useDragSort';
+import { useRovingFocus } from '../../../composables/useRovingFocus';
+import type { GrDataColumn } from '../GrDataTable.vue';
+/**
+ * Порядок колонок `GrDataTable`: перестановка указателем и с клавиатуры.
+ *
+ * Закреплённые колонки стоят своими группами у своих краёв, и перенос через
+ * границу группы запрещён — иначе «закреплена слева» перестало бы означать
+ * «слева». Отсюда `pinGroupOf` и проверка `sameGroup` в каждом пути переноса.
+ *
+ * Карты элементов приходят снаружи: их наполняет шаблон, и они же нужны
+ * модулям ширины и раскладки — владеть ими единолично этот модуль не может.
+ */
+export interface UseDataTableColumnOrderOptions<TRow extends Record<string, unknown>> {
+    columns: () => GrDataColumn<TRow>[];
+    /** Контролируемый порядок. `undefined` — компонент помнит порядок сам. */
+    columnOrder: () => string[] | undefined;
+    reorderableColumns: () => boolean;
+    loading: () => boolean;
+    /** Заголовочные ячейки по ключу колонки — цель перетаскивания. */
+    headerCellEls: Map<string, HTMLElement>;
+    /** Ручки переноса по ключу колонки — кольцо роверного фокуса. */
+    columnHandleEls: Map<string, HTMLElement>;
+    onOrderChange: (order: string[], moved: {
+        key: string;
+        from: number;
+        to: number;
+    }) => void;
+    /** Объявление в живой регион: перенос указателем без него беззвучен. */
+    announceMove: (label: string, position: number, count: number) => void;
+}
+export interface DataTableColumnOrder<TRow extends Record<string, unknown>> {
+    orderedColumns: ComputedRef<GrDataColumn<TRow>[]>;
+    columnKeys: ComputedRef<string[]>;
+    pinGroupOf: (col: GrDataColumn<TRow>) => number;
+    indexOfColumn: (key: string) => number;
+    draggingColumnKey: ComputedRef<string | null>;
+    columnDropClass: (index: number) => string;
+    onColumnHandleKeydown: (event: KeyboardEvent, key: string) => Promise<void>;
+    /** Жест и кольцо фокуса отдаются целиком: шаблон зовёт их собственный API. */
+    columnSort: ReturnType<typeof useDragSort<string, number>>;
+    columnRoving: ReturnType<typeof useRovingFocus<string>>;
+}
+export declare function useDataTableColumnOrder<TRow extends Record<string, unknown>>(options: UseDataTableColumnOrderOptions<TRow>): DataTableColumnOrder<TRow>;

package/dist/types/components/GrDataTable/composables/useDataTableColumnWidths.d.ts

@@ -0,0 +1,38 @@
+import type { ComputedRef, Ref } from 'vue';
+import type { GrDataColumn } from '../GrDataTable.vue';
+/** Уже колонки не бывает: в неё перестаёт помещаться даже стрелка сортировки. */
+export declare const MIN_COLUMN_WIDTH = 48;
+/**
+ * Ширина колонок `GrDataTable`: протяжка ручки, клавиатура и сброс к авторазметке.
+ *
+ * Измеренные ширины сюда **приходят снаружи** (`setMeasuredWidths`): замер —
+ * дело раскладки, которая ходит в DOM после отрисовки, а здесь они только
+ * читаются, чтобы ручка называла значение с первого рендера.
+ */
+export interface UseDataTableColumnWidthsOptions<TRow extends Record<string, unknown>> {
+    /** Колонки в текущем порядке — по ним считается минимальная ширина таблицы. */
+    orderedColumns: () => GrDataColumn<TRow>[];
+    /** Контролируемые ширины. `undefined` — компонент помнит их сам. */
+    columnWidths: () => Record<string, number> | undefined;
+    resizableColumns: () => boolean;
+    loading: () => boolean;
+    /** Заголовочные ячейки: стартовая ширина протяжки берётся замером. */
+    headerCellEls: Map<string, HTMLElement>;
+    onWidthsChange: (widths: Record<string, number>) => void;
+    onColumnResize: (key: string, width: number) => void;
+    announceWidth: (label: string, width: number) => void;
+}
+export interface DataTableColumnWidths<TRow extends Record<string, unknown>> {
+    columnWidths: ComputedRef<Record<string, number>>;
+    measuredColumnWidths: Ref<Record<string, number>>;
+    setMeasuredWidths: (widths: Record<string, number>) => void;
+    widthOf: (col: GrDataColumn<TRow>) => string | number | undefined;
+    tableMinWidth: ComputedRef<number | undefined>;
+    resizingKey: Ref<string | null>;
+    onResizerPointerDown: (event: PointerEvent, key: string) => void;
+    onResizerKeydown: (event: KeyboardEvent, key: string) => void;
+    /** Сброс к авторазметке — двойной клик по ручке в шаблоне. */
+    resetColumnWidth: (key: string) => void;
+    resizerValue: (col: GrDataColumn<TRow>) => number;
+}
+export declare function useDataTableColumnWidths<TRow extends Record<string, unknown>>(options: UseDataTableColumnWidthsOptions<TRow>): DataTableColumnWidths<TRow>;

package/dist/types/components/GrDataTable/composables/useDataTableLayout.d.ts

@@ -0,0 +1,29 @@
+import type { ComputedRef } from 'vue';
+import type { GrDataColumn } from '../GrDataTable.vue';
+/** Служебная колонка выбора в реестре ячеек: своего ключа у неё нет. */
+export declare const SELECT_COLUMN_KEY = "__select__";
+/**
+ * Раскладка закреплённых колонок: смещения липких ячеек и замер шапки.
+ *
+ * Единственный модуль таблицы, который целиком про DOM. Смещения нельзя
+ * вычислить из пропов: колонка может жить на авторазметке, и её ширина
+ * известна только после отрисовки — отсюда замер, а не `computed`.
+ */
+export interface UseDataTableLayoutOptions<TRow extends Record<string, unknown>> {
+    orderedColumns: () => GrDataColumn<TRow>[];
+    columnKeys: () => string[];
+    selectable: () => boolean;
+    resizableColumns: () => boolean;
+    headerCellEls: Map<string, HTMLElement>;
+    /** Пересчитать раскладку заново при смене этих значений. */
+    watchSources: () => unknown;
+    /** Измеренные ширины уезжают модулю ширин: ручка ресайза называет по ним значение. */
+    onMeasuredWidths: (widths: Record<string, number>) => void;
+}
+export interface DataTableLayout<TRow extends Record<string, unknown>> {
+    hasPinnedLeft: ComputedRef<boolean>;
+    pinnedStyleOf: (col: GrDataColumn<TRow>) => Record<string, string> | undefined;
+    pinnedCellClass: (col: GrDataColumn<TRow>, index: number) => string[];
+    measureLayout: () => void;
+}
+export declare function useDataTableLayout<TRow extends Record<string, unknown>>(options: UseDataTableLayoutOptions<TRow>): DataTableLayout<TRow>;

package/dist/types/components/GrDataTable/composables/useDataTableRowKeys.d.ts

@@ -0,0 +1,16 @@
+import type { GrDataTableRowKey } from '../GrDataTable.vue';
+/**
+ * Ключ строки: значение из данных, а при его отсутствии — синтетический.
+ *
+ * Без синтетического строка получила бы `String(undefined ?? '')` — **один и
+ * тот же** ключ на всю таблицу: Vue переиспользовал бы DOM не по назначению, а
+ * выбор одной строки помечал бы выбранными все. Ключ привязан к идентичности
+ * объекта, поэтому переживает сортировку и не зависит от индекса.
+ */
+export interface UseDataTableRowKeysOptions<TRow extends Record<string, unknown>> {
+    rowKey: () => GrDataTableRowKey<TRow>;
+}
+export interface DataTableRowKeys<TRow extends Record<string, unknown>> {
+    rowKeyValue: (row: TRow) => string | number;
+}
+export declare function useDataTableRowKeys<TRow extends Record<string, unknown>>(options: UseDataTableRowKeysOptions<TRow>): DataTableRowKeys<TRow>;

package/dist/types/components/GrDataTable/composables/useDataTableSelection.d.ts

@@ -0,0 +1,32 @@
+import type { ComputedRef } from 'vue';
+/**
+ * Выбор строк `GrDataTable`.
+ *
+ * Считается по **видимым и выбираемым** строкам: они же дают состояние
+ * галочки в шапке. Ключи строк, которых сейчас в наборе нет (отфильтрованы,
+ * на другой странице), из выбора не выпадают — «снять все» убирает только
+ * видимые.
+ *
+ * Как и сортировка, эмитов не знает: наружу сообщает `onSelectedChange`.
+ */
+export interface UseDataTableSelectionOptions<TRow extends Record<string, unknown>> {
+    /** Строки в текущем порядке — уже отсортированные. */
+    rows: () => TRow[];
+    /** Контролируемый список ключей. `undefined` — компонент помнит выбор сам. */
+    selected: () => Array<string | number> | undefined;
+    selectableRow: () => ((row: TRow) => boolean) | undefined;
+    rowKeyValue: (row: TRow) => string | number;
+    onSelectedChange: (keys: Array<string | number>) => void;
+}
+export interface DataTableSelection<TRow extends Record<string, unknown>> {
+    selectedKeys: ComputedRef<Set<string | number>>;
+    isRowSelectable: (row: TRow) => boolean;
+    isRowSelected: (row: TRow) => boolean;
+    /** Видимые выбираемые строки: по их числу шапка гасит «выбрать все». */
+    selectableRows: ComputedRef<TRow[]>;
+    allSelected: ComputedRef<boolean>;
+    someSelected: ComputedRef<boolean>;
+    toggleRow: (row: TRow) => void;
+    toggleAll: () => void;
+}
+export declare function useDataTableSelection<TRow extends Record<string, unknown>>(options: UseDataTableSelectionOptions<TRow>): DataTableSelection<TRow>;

package/dist/types/components/GrDataTable/composables/useDataTableSort.d.ts

@@ -0,0 +1,37 @@
+import type { ComputedRef } from 'vue';
+import type { GrDataColumn, GrDataTableSortCycle } from '../GrDataTable.vue';
+import type { GrDataTableSortDir } from '../grDataTableSort';
+/**
+ * Сортировка `GrDataTable`: состояние, порядок строк и обход состояний по клику.
+ *
+ * Модель эмитов не знает — о смене сообщает колбэком `onSortChange`, а
+ * `update:sortKey`/`update:sortDir`/`sortChange` остаются заботой компонента.
+ * Так же устроен `GrTree`: модель отдельно, эмиты связывает SFC.
+ *
+ * Сравнение значений, включая пустые и смешанные типы, живёт в
+ * `grDataTableSort.ts` и здесь только вызывается.
+ */
+export interface UseDataTableSortOptions<TRow extends Record<string, unknown>> {
+    rows: () => TRow[];
+    /** Контролируемый ключ. `undefined` — компонент помнит порядок сам. */
+    sortKey: () => string | undefined;
+    /** Контролируемое направление. */
+    sortDir: () => GrDataTableSortDir | undefined;
+    initialSortKey: () => string | undefined;
+    initialSortDir: () => GrDataTableSortDir;
+    /** Внешняя сортировка: `rows` приходят уже отсортированными. */
+    externalSort: () => boolean;
+    sortCycle: () => GrDataTableSortCycle;
+    /** Язык сравнения строк; не задан — сравнение по умолчанию рантайма. */
+    locale: () => string | undefined;
+    onSortChange: (key: string, dir: GrDataTableSortDir) => void;
+}
+export interface DataTableSort<TRow extends Record<string, unknown>> {
+    currentSortKey: ComputedRef<string>;
+    currentSortDir: ComputedRef<GrDataTableSortDir>;
+    sortedRows: ComputedRef<TRow[]>;
+    toggleSort: (col: GrDataColumn<TRow>) => void;
+    clearSort: () => void;
+    ariaSortFor: (col: GrDataColumn<TRow>) => 'ascending' | 'descending' | 'none' | undefined;
+}
+export declare function useDataTableSort<TRow extends Record<string, unknown>>(options: UseDataTableSortOptions<TRow>): DataTableSort<TRow>;

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

@@ -17,7 +17,13 @@ export interface GrFormFieldProps {
     error?: string | string[];
     /** Подсказка под лейблом/над контролом (можно также через слот `#hint`). */
     hint?: string;
-    /** Помечает поле обязательным (маркер `*` + `aria-required` у контрола). */
+    /**
+     * Помечает поле обязательным: маркер `*` в подписи и `aria-required` у контрола.
+     *
+     * Маркер помечен `aria-hidden`, поэтому объявляет обязательность именно
+     * контрол — а чем именно, решает его роль. Разбор случая `role="group"`,
+     * который `aria-required` не допускает, — на странице компонента.
+     */
     required?: boolean;
     /** Всё поле только для чтения: контролы внутри перестают редактироваться. */
     readonly?: boolean;

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

@@ -7,11 +7,26 @@ import { type GrPaginationSize } from './grPaginationStyles';
  * (алгоритм boundary/sibling, как у MUI): всегда видны первая/последняя страница
  * и `siblingCount` соседей вокруг текущей.
  */
+/**
+ * Вариант размера страницы: число либо пара «значение + подпись».
+ *
+ * Пара нужна там, где подпись не равна числу («50 / стр.», «Все»): собрать её
+ * из голого `number[]` было нельзя, а обходной путь — свой `GrSelect` рядом —
+ * терял связь с пагинацией.
+ */
+export type GrPaginationPageSizeOption = number | {
+    value: number;
+    label: string;
+};
 export interface GrPaginationProps {
     page: number;
     pageSize: number;
     total: number;
-    pageSizes?: number[];
+    /**
+     * Варианты размера страницы. Число — подпись равна значению; пара — своя
+     * подпись при том же значении («50 / стр.»), которую иначе было не собрать.
+     */
+    pageSizes?: GrPaginationPageSizeOption[];
     /** Сколько соседних страниц показывать вокруг текущей. По умолчанию `1`. */
     siblingCount?: number;
     /** Сколько крайних страниц всегда показывать с каждого края. По умолчанию `1`. */
@@ -85,7 +100,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     size: GrPaginationSize;
     compact: boolean;
     ariaLabel: string;
-    pageSizes: number[];
+    pageSizes: GrPaginationPageSizeOption[];
     siblingCount: number;
     boundaryCount: number;
     showJumper: boolean;

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

@@ -1,7 +1,16 @@
 import type { GrComponentSize } from '../shared/sizes';
 export type GrPaginationSize = GrComponentSize;
-/** Номер страницы и многоточие: одна и та же коробка, чтобы ряд не прыгал. */
-export declare const pageSizes: Record<GrPaginationSize, string>;
+/**
+ * Номер страницы и многоточие: одна и та же коробка, чтобы ряд не прыгал.
+ *
+ * Высоты — шкала `GrButton` (`28/32/40/44`), а не своя. Номера стоят с
+ * навигационными кнопками в одном ряду, и собственная шкала это ломала:
+ * `sm` и `md` были одной коробкой `h-8`, а кнопке приходилось выдавать размер
+ * на ступень ниже имени. Имя `pageBoxSizes`, а не `pageSizes`, потому что
+ * `pageSizes` — проп со списком размеров страницы, и одно имя на два разных
+ * понятия в одном компоненте читается как ошибка.
+ */
+export declare const pageBoxSizes: Record<GrPaginationSize, string>;
 /** Коробка та же, что у номера, но поле́ уже: многоточию не нужен клик-таргет. */
 export declare const ellipsisSizes: Record<GrPaginationSize, string>;
 /** Вспомогательный текст: индикатор «текущая / всего» и подпись у поля перехода. */
@@ -11,9 +20,9 @@ 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`.
+ * Навигационные кнопки берут свой размер один в один: коробка номера теперь
+ * той же высоты, что и `GrButton` того же имени, и сдвигать ступень больше не
+ * нужно. Отображение оставлено явным — оно называет инвариант «кнопка и номер
+ * одного роста», который иначе держался бы на совпадении двух шкал.
  */
 export declare const navButtonSizes: Record<GrPaginationSize, GrComponentSize>;

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

@@ -4,4 +4,4 @@ export { grPaginationConfig } from './config';
 export type { GrPaginationConfigurableProps } from './defaults';
 export type { GrPaginationSize } from './grPaginationStyles';
 export { grPaginationSafelist } from './safelist';
-export type { GrPaginationEmits } from './GrPagination.vue';
+export type { GrPaginationEmits, GrPaginationPageSizeOption } from './GrPagination.vue';

package/dist/types/components/GrTree/grTreeStyles.d.ts

@@ -30,5 +30,5 @@ export declare const treeSizeVars: Record<GrTreeSize, GrTreeSizeVars>;
  * значки — это `expandIcon`/`collapseIcon` и слот строки, то есть решение
  * потребителя, а не вида.
  */
-export type GrTreeView = 'explorer' | 'rail' | 'outline';
+export type GrTreeView = 'explorer' | 'rail' | 'outline' | 'picker';
 export declare const grTreeViewVars: Record<GrTreeView, Record<string, string>>;

package/dist/types/components/GrTreeSections/grTreeSectionsStyles.d.ts

@@ -6,3 +6,18 @@ export declare const treeSectionsRootClass = "flex flex-col gap-4";
 export declare const treeSectionsHeadClass = "flex items-baseline gap-2 pb-1 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)] uppercase tracking-wider text-[var(--gr-muted-fg)] border-b border-[var(--gr-brd)]";
 export declare const treeSectionsCountClass = "ml-auto text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]";
 export declare const treeSectionsGroupClass = "flex flex-col gap-1";
+/**
+ * Собственный вид строк секций. Задаётся на самом дереве, а не на обёртке:
+ * `GrTree` объявляет значения по умолчанию на своём корне, и переменная,
+ * выставленная предком, до строки не доходит вовсе — её перекрывает
+ * собственное объявление дерева.
+ *
+ * Полоса у выбранной строки несёт то же, что заголовок группы, —
+ * принадлежность: подложка выбора отступает на отступ уровня, и на вложенных
+ * строках выбор переставал попадать в один вертикальный ряд с остальными.
+ */
+export declare const treeSectionsRowVars: {
+    readonly '--gr-tree-row-min-height': "32px";
+    readonly '--gr-tree-row-radius': "7px";
+    readonly '--gr-tree-row-current-bar-width': "2px";
+};

package/dist/types/components/shared/controlState.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Небуквенный признак состояния форм-контрола.
+ *
+ * `state="success"`/`"warning"` до этого несли смысл **только цветом рамки**, а
+ * это WCAG 1.4.1: цвет не может быть единственным носителем информации. Иконка
+ * добавляет форму, а скрытая подпись — программный канал: у `success` и
+ * `warning`, в отличие от `danger`, ARIA-состояния не существует вовсе, и
+ * объявить их нечем, кроме текста в `aria-describedby`.
+ *
+ * Модуль общий на пять контролов (`GrInput`, `GrTextarea`, `GrNumberInput`,
+ * `GrInputTag`, `GrTreeSelect`), поэтому его классы обязан объявить **каждый**
+ * импортёр: в `dist` общий модуль лежит в чанке без адреса и в область скана
+ * пресета не попадает.
+ */
+/** Состояния, у которых признак есть. `danger` его не получает — см. ниже. */
+export type GrControlSignalState = 'success' | 'warning';
+/**
+ * `danger` в набор не входит намеренно. Его смысл уже несут два канала:
+ * `aria-invalid` для скринридера и текст ошибки от `GrFormField` для глаз.
+ * Третья иконка рядом с ними — шум, а не признак.
+ */
+export declare const controlStateIconClass = "pointer-events-none flex h-6 w-6 shrink-0 items-center justify-center";
+/**
+ * Цвет иконки — роль `-text`, а не насыщенный тон: `--gr-success` выверен как
+ * заливка и в роли текста не добирает AA. Гейт `styleTokens` это ловит.
+ */
+export declare const controlStateIconColors: Record<GrControlSignalState, string>;
+/** Ключ локали подписи. Текст один на все контролы: состояние у них общее. */
+export declare const controlStateTextKey: Record<GrControlSignalState, string>;
+export declare const controlStateFallbackText: Record<GrControlSignalState, string>;
+/**
+ * Показывать ли признак: только у `success`/`warning` и только пока поле не
+ * объявлено невалидным. Иначе галочка «корректно» соседствовала бы с
+ * `aria-invalid="true"` и противоречила ему.
+ */
+export declare function controlSignalState(state: string | undefined, invalid: boolean): GrControlSignalState | undefined;

package/dist/types/i18n/messages/en.d.ts

@@ -48,6 +48,8 @@ export declare const en: {
                     add: string;
                     clear: string;
                     close: string;
+                    stateSuccess: string;
+                    stateWarning: string;
                 };
                 loading: {
                     defaultText: string;
@@ -441,6 +443,8 @@ export declare const en: {
                 add: string;
                 clear: string;
                 close: string;
+                stateSuccess: string;
+                stateWarning: string;
             };
             loading: {
                 defaultText: string;

package/dist/types/i18n/messages/es.d.ts

@@ -41,6 +41,8 @@ export declare const es: {
                     add: string;
                     clear: string;
                     close: string;
+                    stateSuccess: string;
+                    stateWarning: string;
                 };
                 loading: {
                     defaultText: string;
@@ -436,6 +438,8 @@ export declare const es: {
                 add: string;
                 clear: string;
                 close: string;
+                stateSuccess: string;
+                stateWarning: string;
             };
             loading: {
                 defaultText: string;

package/dist/types/i18n/messages/ru.d.ts

@@ -41,6 +41,8 @@ export declare const ru: {
                     add: string;
                     clear: string;
                     close: string;
+                    stateSuccess: string;
+                    stateWarning: string;
                 };
                 loading: {
                     defaultText: string;
@@ -438,6 +440,8 @@ export declare const ru: {
                 add: string;
                 clear: string;
                 close: string;
+                stateSuccess: string;
+                stateWarning: string;
             };
             loading: {
                 defaultText: string;

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@feugene/granularity",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "framework": "vue",
   "js-types-syntax": "typescript",
   "description-markup": "markdown",
@@ -4771,7 +4771,7 @@
             },
             {
               "name": "required",
-              "description": "Помечает поле обязательным (маркер `*` + `aria-required` у контрола).",
+              "description": "Помечает поле обязательным: маркер `*` в подписи и `aria-required` у контрола. Маркер помечен `aria-hidden`, поэтому объявляет обязательность именно контрол — а чем именно, решает его роль. Разбор случая `role=\"group\"`, который `aria-required` не допускает, — на странице компонента.",
               "default": "false",
               "value": {
                 "kind": "expression",
@@ -7147,10 +7147,11 @@
             },
             {
               "name": "pageSizes",
+              "description": "Варианты размера страницы. Число — подпись равна значению; пара — своя подпись при том же значении («50 / стр.»), которую иначе было не собрать.",
               "default": "[10, 20, 50]",
               "value": {
                 "kind": "expression",
-                "type": "number[] | undefined"
+                "type": "GrPaginationPageSizeOption[] | undefined"
               }
             },
             {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@feugene/granularity",
   "description": "Granularity design system package with Vue 3 components, consumed via the `@feugene/unocss-preset-granular` preset.",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "license": "LicenseRef-Granularity-EUC-1.1",
   "author": {
     "name": "Evgeniy Fureev",

package/dist/chunks/config-BhfNgyWL.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-BhfNgyWL.js","names":[],"sources":["../../src/components/GrTextarea/safelist.ts","../../src/components/GrTextarea/config.ts"],"sourcesContent":["import { splitClassTokens } from '../shared/classTokens'\nimport {\n  borderClassByState,\n  countClass,\n  countRowClass,\n  lineCountClass,\n  disabledSurfaceClass,\n  enabledSurfaceClass,\n  invalidBorderClass,\n  resizeClass,\n  sizes,\n} from './grTextareaStyles'\n\nexport const grTextareaSafelist = [...new Set([\n  ...Object.values(borderClassByState).flatMap(splitClassTokens),\n  ...splitClassTokens(invalidBorderClass),\n  ...Object.values(sizes).flatMap(splitClassTokens),\n  ...Object.values(resizeClass).flatMap(splitClassTokens),\n  ...splitClassTokens(enabledSurfaceClass),\n  ...splitClassTokens(disabledSurfaceClass),\n  ...splitClassTokens(countClass),\n  ...splitClassTokens(countRowClass),\n  ...splitClassTokens(lineCountClass),\n])]\n","import { defineGranularComponent } from '@feugene/unocss-preset-granular/contract'\n\nimport { grTextareaSafelist } from './safelist'\n\nexport const grTextareaConfig = defineGranularComponent(import.meta.url, {\n  name: 'GrTextarea',\n  safelist: grTextareaSafelist,\n})\n"],"mappings":";;;;AAaA,IAAa,qBAAqB,CAAC,mBAAG,IAAI,IAAI;CAC5C,GAAG,OAAO,OAAO,kBAAkB,CAAC,CAAC,QAAQ,gBAAgB;CAC7D,GAAG,iBAAiB,kBAAkB;CACtC,GAAG,OAAO,OAAO,KAAK,CAAC,CAAC,QAAQ,gBAAgB;CAChD,GAAG,OAAO,OAAO,WAAW,CAAC,CAAC,QAAQ,gBAAgB;CACtD,GAAG,iBAAiB,mBAAmB;CACvC,GAAG,iBAAiB,oBAAoB;CACxC,GAAG,iBAAiB,UAAU;CAC9B,GAAG,iBAAiB,aAAa;CACjC,GAAG,iBAAiB,cAAc;AACpC,CAAC,CAAC;;;ACnBF,IAAa,mBAAmB,wBAAwB,YAAY,KAAK;CACvE,MAAM;CACN,UAAU;AACZ,CAAC"}

package/dist/chunks/config-CIkdsWUk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-CIkdsWUk.js","names":[],"sources":["../../src/components/GrInput/safelist.ts","../../src/components/GrInput/config.ts"],"sourcesContent":["import { splitClassTokens } from '../shared/classTokens'\nimport {\n  addonInlinePrefixClass,\n  addonInlineSuffixClass,\n  addonSegmentPrefixClass,\n  addonSegmentSuffixClass,\n  invalidClass,\n  shellBaseClass,\n  shellDisabledClass,\n  shellEnabledClass,\n  sizes,\n  states,\n  textAlign,\n} from './grInputStyles'\n\nexport const grInputSafelist = [...new Set([\n  ...Object.values(sizes).flatMap(splitClassTokens),\n  ...Object.values(textAlign).flatMap(splitClassTokens),\n  ...Object.values(states).flatMap(splitClassTokens),\n  ...splitClassTokens(invalidClass),\n  ...splitClassTokens(shellBaseClass),\n  ...splitClassTokens(shellEnabledClass),\n  ...splitClassTokens(shellDisabledClass),\n  ...splitClassTokens(addonSegmentPrefixClass),\n  ...splitClassTokens(addonSegmentSuffixClass),\n  ...splitClassTokens(addonInlinePrefixClass),\n  ...splitClassTokens(addonInlineSuffixClass),\n])]\n","import { defineGranularComponent } from '@feugene/unocss-preset-granular/contract'\nimport { grInputSafelist } from './safelist'\n\nexport const grInputConfig = defineGranularComponent(import.meta.url, {\n  name: 'GrInput',\n  safelist: grInputSafelist,\n})\n"],"mappings":";;;;AAeA,IAAa,kBAAkB,CAAC,mBAAG,IAAI,IAAI;CACzC,GAAG,OAAO,OAAO,KAAK,CAAC,CAAC,QAAQ,gBAAgB;CAChD,GAAG,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,gBAAgB;CACpD,GAAG,OAAO,OAAO,MAAM,CAAC,CAAC,QAAQ,gBAAgB;CACjD,GAAG,iBAAiB,YAAY;CAChC,GAAG,iBAAiB,cAAc;CAClC,GAAG,iBAAiB,iBAAiB;CACrC,GAAG,iBAAiB,kBAAkB;CACtC,GAAG,iBAAiB,uBAAuB;CAC3C,GAAG,iBAAiB,uBAAuB;CAC3C,GAAG,iBAAiB,sBAAsB;CAC1C,GAAG,iBAAiB,sBAAsB;AAC5C,CAAC,CAAC;;;ACxBF,IAAa,gBAAgB,wBAAwB,YAAY,KAAK;CACpE,MAAM;CACN,UAAU;AACZ,CAAC"}

package/dist/chunks/config-ChnYtO4o.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-ChnYtO4o.js","names":[],"sources":["../../src/components/GrTreeSections/grTreeSectionsStyles.ts","../../src/components/GrTreeSections/safelist.ts","../../src/components/GrTreeSections/config.ts"],"sourcesContent":["export const treeSectionsRootClass = 'flex flex-col gap-4'\n\n/**\n * Заголовок группы набирается капителью и отделяется линией: он объявляет\n * рубрику, а не узел, и должен читаться иначе, чем строки под ним.\n */\nexport const treeSectionsHeadClass = 'flex items-baseline gap-2 pb-1 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)] uppercase tracking-wider text-[var(--gr-muted-fg)] border-b border-[var(--gr-brd)]'\n\nexport const treeSectionsCountClass = 'ml-auto text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]'\n\nexport const treeSectionsGroupClass = 'flex flex-col gap-1'\n","import { splitClassTokens } from '../shared/classTokens'\n\nimport {\n  treeSectionsCountClass,\n  treeSectionsGroupClass,\n  treeSectionsHeadClass,\n  treeSectionsRootClass,\n} from './grTreeSectionsStyles'\n\nexport const grTreeSectionsSafelist = [...new Set([\n  ...splitClassTokens(treeSectionsRootClass),\n  ...splitClassTokens(treeSectionsHeadClass),\n  ...splitClassTokens(treeSectionsCountClass),\n  ...splitClassTokens(treeSectionsGroupClass),\n])]\n","import { defineGranularComponent } from '@feugene/unocss-preset-granular/contract'\n\nimport { grTreeSectionsSafelist } from './safelist'\n\nexport const grTreeSectionsConfig = defineGranularComponent(import.meta.url, {\n  name: 'GrTreeSections',\n  dependencies: ['GrTree'],\n  safelist: grTreeSectionsSafelist,\n})\n"],"mappings":";;;AAAA,IAAa,wBAAwB;;;;;AAMrC,IAAa,wBAAwB;AAErC,IAAa,yBAAyB;AAEtC,IAAa,yBAAyB;;;ACDtC,IAAa,yBAAyB,CAAC,mBAAG,IAAI,IAAI;CAChD,GAAG,iBAAiB,qBAAqB;CACzC,GAAG,iBAAiB,qBAAqB;CACzC,GAAG,iBAAiB,sBAAsB;CAC1C,GAAG,iBAAiB,sBAAsB;AAC5C,CAAC,CAAC;;;ACVF,IAAa,uBAAuB,wBAAwB,YAAY,KAAK;CAC3E,MAAM;CACN,cAAc,CAAC,QAAQ;CACvB,UAAU;AACZ,CAAC"}

package/dist/chunks/config-CjKpUcmy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-CjKpUcmy.js","names":[],"sources":["../../src/components/GrPagination/grPaginationStyles.ts","../../src/components/GrPagination/safelist.ts","../../src/components/GrPagination/config.ts"],"sourcesContent":["import type { GrComponentSize } from '../shared/sizes'\n\nexport type GrPaginationSize = GrComponentSize\n\n/** Номер страницы и многоточие: одна и та же коробка, чтобы ряд не прыгал. */\nexport const pageSizes: Record<GrPaginationSize, string> = {\n  xs: 'h-7 min-w-7 px-1.5 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  sm: 'h-8 min-w-8 px-2 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  md: 'h-8 min-w-8 px-2 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)]',\n  lg: 'h-10 min-w-10 px-3 text-[length:var(--gr-text-base)] leading-[var(--gr-leading-base)]',\n}\n\n/** Коробка та же, что у номера, но поле́ уже: многоточию не нужен клик-таргет. */\nexport const ellipsisSizes: Record<GrPaginationSize, string> = {\n  xs: 'h-7 min-w-7 px-1 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  sm: 'h-8 min-w-8 px-1 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  md: 'h-8 min-w-8 px-1 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)]',\n  lg: 'h-10 min-w-10 px-2 text-[length:var(--gr-text-base)] leading-[var(--gr-leading-base)]',\n}\n\n/** Вспомогательный текст: индикатор «текущая / всего» и подпись у поля перехода. */\nexport const labelSizes: Record<GrPaginationSize, string> = {\n  xs: 'text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  sm: 'text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  md: 'text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)]',\n  lg: 'text-[length:var(--gr-text-base)] leading-[var(--gr-leading-base)]',\n}\n\nexport const jumperSizes: Record<GrPaginationSize, string> = {\n  xs: 'h-7 w-12 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  sm: 'h-8 w-14 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)]',\n  md: 'h-8 w-14 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)]',\n  lg: 'h-10 w-16 text-[length:var(--gr-text-base)] leading-[var(--gr-leading-base)]',\n}\n\nexport const rowGaps: Record<GrPaginationSize, string> = {\n  xs: 'gap-2',\n  sm: 'gap-2',\n  md: 'gap-3',\n  lg: 'gap-3',\n}\n\nexport const pageListGaps: Record<GrPaginationSize, string> = {\n  xs: 'gap-0.5',\n  sm: 'gap-1',\n  md: 'gap-1',\n  lg: 'gap-1',\n}\n\nexport const pageSizeSelectWidths: Record<GrPaginationSize, string> = {\n  xs: 'min-w-[84px]',\n  sm: 'min-w-[92px]',\n  md: 'min-w-[100px]',\n  lg: 'min-w-[112px]',\n}\n\n/**\n * Навигационные кнопки берут размер из шкалы `GrButton`, а не из своей: они\n * обязаны стоять в один ряд с номерами страниц, а высоты у `GrButton`\n * `xs…lg` — `28/32/40/44px`. На `md` номера страниц ростом `h-8`, поэтому\n * кнопке достаётся `sm`, а не одноимённый `md`.\n */\nexport const navButtonSizes: Record<GrPaginationSize, GrComponentSize> = {\n  xs: 'xs',\n  sm: 'sm',\n  md: 'sm',\n  lg: 'md',\n}\n","import { splitClassTokens } from '../shared/classTokens'\nimport {\n  ellipsisSizes,\n  jumperSizes,\n  labelSizes,\n  pageListGaps,\n  pageSizes,\n  pageSizeSelectWidths,\n  rowGaps,\n} from './grPaginationStyles'\n\nexport const grPaginationSafelist = [...new Set([\n  ...Object.values(pageSizes).flatMap(splitClassTokens),\n  ...Object.values(ellipsisSizes).flatMap(splitClassTokens),\n  ...Object.values(labelSizes).flatMap(splitClassTokens),\n  ...Object.values(jumperSizes).flatMap(splitClassTokens),\n  ...Object.values(rowGaps).flatMap(splitClassTokens),\n  ...Object.values(pageListGaps).flatMap(splitClassTokens),\n  ...Object.values(pageSizeSelectWidths).flatMap(splitClassTokens),\n])]\n","import { defineGranularComponent } from '@feugene/unocss-preset-granular/contract'\n\nimport { grPaginationSafelist } from './safelist'\n\nexport const grPaginationConfig = defineGranularComponent(import.meta.url, {\n  name: 'GrPagination',\n  dependencies: ['GrButton', 'GrSelect'],\n  safelist: grPaginationSafelist,\n})\n"],"mappings":";;;;AAKA,IAAa,YAA8C;CACzD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;AAGA,IAAa,gBAAkD;CAC7D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;AAGA,IAAa,aAA+C;CAC1D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAa,cAAgD;CAC3D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAa,UAA4C;CACvD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAa,eAAiD;CAC5D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAa,uBAAyD;CACpE,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;;;;;AAQA,IAAa,iBAA4D;CACvE,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;ACxDA,IAAa,uBAAuB,CAAC,mBAAG,IAAI,IAAI;CAC9C,GAAG,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,gBAAgB;CACpD,GAAG,OAAO,OAAO,aAAa,CAAC,CAAC,QAAQ,gBAAgB;CACxD,GAAG,OAAO,OAAO,UAAU,CAAC,CAAC,QAAQ,gBAAgB;CACrD,GAAG,OAAO,OAAO,WAAW,CAAC,CAAC,QAAQ,gBAAgB;CACtD,GAAG,OAAO,OAAO,OAAO,CAAC,CAAC,QAAQ,gBAAgB;CAClD,GAAG,OAAO,OAAO,YAAY,CAAC,CAAC,QAAQ,gBAAgB;CACvD,GAAG,OAAO,OAAO,oBAAoB,CAAC,CAAC,QAAQ,gBAAgB;AACjE,CAAC,CAAC;;;ACfF,IAAa,qBAAqB,wBAAwB,YAAY,KAAK;CACzE,MAAM;CACN,cAAc,CAAC,YAAY,UAAU;CACrC,UAAU;AACZ,CAAC"}