@feugene/granularity 0.49.0 → 0.50.0

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

@@ -33,8 +33,16 @@ export type GrDataColumn<TRow extends Record<string, unknown> = Record<string, u
      * колонки из группы в группу запрещён, иначе «закреплена слева» перестало бы
      * означать «слева».
      */
-    pinned?: 'left' | 'right';
+    pinned?: GrColumnPinSide;
 };
+/** Край, к которому липнет колонка. */
+export type GrColumnPinSide = 'left' | 'right';
+/**
+ * Закрепление, выбранное пользователем. `null` — не «как в конфиге», а
+ * «откреплена»: без него снять закрепление, объявленное у колонки, было бы
+ * нечем — отсутствие ключа означает «решает конфиг».
+ */
+export type GrColumnPin = GrColumnPinSide | null;
 /**
  * Значения итоговой строки по ключам колонок.
  *
@@ -150,6 +158,28 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
      * Не заданы — ширины компонент помнит сам.
      */
     columnWidths?: Record<string, number>;
+    /**
+     * Закрепление колонок задаёт пользователь: в шапке появляется меню с
+     * «закрепить слева / справа / открепить».
+     *
+     * Без пропа `pinned` у колонки остаётся тем, чем был, — объявлением в
+     * конфиге, которое меняется только кодом.
+     */
+    pinnableColumns?: boolean;
+    /**
+     * Контролируемое закрепление по ключу колонки (`v-model:pinnedColumns`).
+     * Не задано — компонент помнит его сам, начиная с `pinned` у колонок.
+     */
+    pinnedColumns?: Record<string, GrColumnPin>;
+    /**
+     * Клавиатура по ячейкам: паттерн `grid` из WAI-ARIA APG.
+     *
+     * Вся таблица становится **одной** остановкой `Tab`, внутрь ведут стрелки, а
+     * в содержимое ячейки — `Enter` или `F2`. Поэтому проп отдельный, а не
+     * поведение по умолчанию: он переставляет таб-порядок у всех, кто таблицу
+     * уже поставил.
+     */
+    cellNavigation?: boolean;
     /**
      * Второй ярус строки: колонка с кнопкой раскрытия и блок подробностей под
      * строкой. Содержимое рисует слот `#detail`.
@@ -200,6 +230,11 @@ export interface GrDataTableEmits<TRow extends Record<string, unknown> = Record<
         key: string;
         width: number;
     }): void;
+    (e: 'update:pinnedColumns', value: Record<string, GrColumnPin>): void;
+    (e: 'columnPin', payload: {
+        key: string;
+        pinned: GrColumnPin;
+    }): void;
     (e: 'update:expandedKeys', value: Array<string | number>): void;
     (e: 'expand', payload: {
         row: TRow;
@@ -248,6 +283,11 @@ declare const __VLS_export: <TRow extends Record<string, unknown> = Record<strin
             key: string;
             width: number;
         }) => any) | undefined;
+        "onUpdate:pinnedColumns"?: ((value: Record<string, GrColumnPin>) => any) | undefined;
+        onColumnPin?: ((payload: {
+            key: string;
+            pinned: GrColumnPin;
+        }) => any) | undefined;
         "onUpdate:expandedKeys"?: ((value: (string | number)[]) => any) | undefined;
         onDetailLoadError?: ((payload: {
             row: TRow;

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

@@ -0,0 +1,53 @@
+import type { ComputedRef } from 'vue';
+/**
+ * Клавиатура по ячейкам: паттерн `grid` из WAI-ARIA APG.
+ *
+ * Своей арифметики здесь нет — её ведёт `useRovingFocus` в режиме `grid`. Этот
+ * модуль отвечает за то, чего примитив знать не может: как адресуется ячейка
+ * таблицы, что делать на краю окна виртуализации и куда прокрутить, прежде чем
+ * фокусировать.
+ *
+ * **Кольцо не замкнуто.** У списка зацикливание уместно, у сетки нет: строка
+ * ниже последней — это не первая, а «дальше некуда», и в виртуальном списке
+ * именно на этом краю начинается подгрузка.
+ *
+ * **Набор — отрисованное окно, а не вся таблица.** У десяти тысяч строк на шесть
+ * колонок ключей было бы шестьдесят тысяч, и пересобирались бы они при каждом
+ * чтении. Шаг за край окна разбирается до примитива (`windowStep`): список
+ * прокручивается, и фокус уходит в строку, появившуюся следующим кадром.
+ */
+/** Строка шапки адресуется как `-1`: в наборе она первая, но строкой данных не является. */
+export declare const HEADER_ROW_INDEX = -1;
+/** Ключ ячейки. Строка вместо пары чисел — примитив сравнивает ключи по `===`. */
+export type GrGridCellKey = string;
+export declare function gridCellKey(row: number, column: number): GrGridCellKey;
+export declare function parseGridCellKey(key: GrGridCellKey): {
+    row: number;
+    column: number;
+};
+export interface UseDataTableGridNavigationOptions {
+    /** Включена ли навигация по ячейкам. Выключенная не занимает ни одной клавиши. */
+    enabled: () => boolean;
+    /** Ширина сетки со служебными колонками. */
+    columns: () => number;
+    /** Индексы отрисованных строк в порядке показа. При виртуализации — только окно. */
+    renderedRows: () => number[];
+    /** Сколько всего строк: по нему считается край при виртуализации. */
+    totalRows: () => number;
+    /** Узлы ячеек по ключу. Заполняется `:ref` самой таблицы. */
+    cellEls: Map<GrGridCellKey, HTMLElement>;
+    /**
+     * Прокрутить список к строке. Есть только при виртуализации: без неё строка
+     * уже в разметке, и доводить до экрана её незачем.
+     */
+    scrollToRow?: (index: number) => void;
+}
+export interface DataTableGridNavigation {
+    /** Ключ ячейки, держащей остановку `Tab`. */
+    rovingKey: ComputedRef<GrGridCellKey | undefined>;
+    tabindexFor: (row: number, column: number) => 0 | -1;
+    setActive: (row: number, column: number) => void;
+    /** Обработчик `keydown` на таблице. Возвращает `true`, если клавиша разобрана. */
+    onKeydown: (event: KeyboardEvent) => boolean;
+}
+export declare function useDataTableGridNavigation(options: UseDataTableGridNavigationOptions): DataTableGridNavigation;

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

@@ -18,6 +18,14 @@ export declare const placeholderPaddings: Record<GrDataTableSize, string>;
  */
 export declare const columnHandleClass = "inline-flex shrink-0 cursor-grab items-center text-[var(--gr-datatable-drag-handle,var(--gr-muted-fg))] opacity-0 [touch-action:none] transition-opacity duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:opacity-100 focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] rounded-[var(--gr-radius-sm)] group-hover:opacity-100";
 export declare const columnHandleActiveClass = "opacity-100";
+/**
+ * Кнопка меню колонки. Как и ручка переноса, в покое не видна: три значка в
+ * каждом заголовке — шум, а нужны они по случаю.
+ *
+ * Открытое меню держит кнопку видимой само (`aria-expanded`), иначе она гасла
+ * бы ровно в тот момент, когда указатель уходит с заголовка на её же панель.
+ */
+export declare const columnMenuTriggerClass = "absolute end-1 top-1/2 -translate-y-1/2 inline-flex shrink-0 items-center rounded-[var(--gr-radius-sm)] text-[var(--gr-muted-fg)] opacity-0 transition-opacity duration-[var(--gr-duration-fast)] hover:text-[var(--gr-fg)] focus:outline-none focus-visible:opacity-100 focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] group-hover:opacity-100 [&[aria-expanded=true]]:opacity-100 disabled:cursor-not-allowed disabled:text-[var(--gr-disabled-fg)]";
 /** Переносимая колонка гасится, чтобы было видно, что она «поднята». */
 export declare const columnDraggingClass = "bg-[var(--gr-muted)]";
 /**

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

@@ -2,7 +2,7 @@ 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, GrDataColumnKey, GrDataTableProps, GrDataTableRowKey, GrDataTableSortCycle, GrDataTableSummary, } from './GrDataTable.vue';
+export type { GrColumnPin, GrColumnPinSide, GrDataColumn, GrDataColumnKey, GrDataTableProps, GrDataTableRowKey, GrDataTableSortCycle, GrDataTableSummary, } from './GrDataTable.vue';
 export type { GrDataTableSortDir } from './grDataTableSort';
 export { grDataTableConfig } from './config';
 export type { GrDataTableConfigurableProps } from './defaults';

package/dist/types/components/GrDelta/grDeltaStyles.d.ts

@@ -20,8 +20,12 @@ export declare const deltaRootClass = "inline-flex items-baseline tabular-nums";
  * оказывается мельче окружающих слов.
  *
  * Дефолт `GrValue` рассчитан на плитку, где величина крупная и приписке есть
- * куда уменьшаться. Здесь он переопределяется — ровно теми же токенами, что
- * доступны потребителю.
+ * куда уменьшаться. Здесь он переопределяется.
+ *
+ * **Переопределение ссылается на свои хуки, а не задаёт значение.** Стиль
+ * применяется инлайном, а инлайн бьёт любой CSS потребителя: напиши тут
+ * `currentColor` — и вернуть приглушённый суффикс у дельты стало бы нечем.
+ * Ссылка на `--gr-delta-suffix-*` оставляет решение за тем, кто его задал.
  *
  * `currentColor` и `1em`, а не `inherit`: у пользовательского свойства
  * `inherit` значит «наследовать саму переменную», то есть ничего.
@@ -35,8 +39,11 @@ export declare const deltaValueStyle: Record<string, string>;
  * пиксельная лестница оставила бы стрелку 14-пиксельной внутри заголовка.
  * Чуть меньше единицы: стрелка декоративна, и равный вес спорил бы с самим
  * числом.
+ *
+ * Отбивка **логическая** (`me-`), как у приписок `GrValue`: физический
+ * `margin-right` в RTL поставил бы стрелку зазором не с той стороны.
  */
-export declare const deltaArrowClass = "mr-0.5 self-center shrink-0 h-[0.875em] w-[0.875em]";
+export declare const deltaArrowClass = "me-[var(--gr-delta-arrow-gap,0.125rem)] self-center shrink-0 h-[var(--gr-delta-arrow-size,0.875em)] w-[var(--gr-delta-arrow-size,0.875em)]";
 export declare const deltaToneClass: Record<GrDeltaTone, string>;
 /** Прочерк вместо величины: тона у него нет, но и цвет основного текста ему не нужен. */
 export declare const deltaEmptyClass = "text-[var(--gr-muted-fg)]";

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

@@ -1,5 +1,5 @@
-import { type GrEmptyStateHeadingLevel, type GrEmptyStateSize, type GrEmptyStateVariant } from './grEmptyStateStyles';
-export type { GrEmptyStateHeadingLevel, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
+import { type GrEmptyStateHeadingLevel, type GrEmptyStateSize, type GrEmptyStateKind, type GrEmptyStateVariant } from './grEmptyStateStyles';
+export type { GrEmptyStateHeadingLevel, GrEmptyStateKind, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
 /**
  * GrEmptyState — карточка пустого состояния: иконка, заголовок, описание и
  * слот действий.
@@ -16,6 +16,12 @@ export interface GrEmptyStateProps {
     /** `ghost` снимает рамку и фон: карточка внутри карточки рисует вторую рамку. */
     variant?: GrEmptyStateVariant;
     headingLevel?: GrEmptyStateHeadingLevel;
+    /**
+     * Что за пустота: ещё ничего не создано (`empty`) или под запросом ничего не
+     * нашлось (`search`). Меняет иконку и заголовок по умолчанию; заданный
+     * `title` сильнее в обоих случаях.
+     */
+    kind?: GrEmptyStateKind;
 }
 type __VLS_Slots = {
     /** Иконка вместо встроенной. */
@@ -32,18 +38,21 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     size: undefined;
     variant: undefined;
     headingLevel: undefined;
+    kind: string;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrEmptyStateProps>, {
     title: undefined;
     description: undefined;
     size: undefined;
     variant: undefined;
     headingLevel: undefined;
+    kind: string;
 }>>> & Readonly<{}>, {
     title: string;
     variant: GrEmptyStateVariant;
     size: GrEmptyStateSize;
     headingLevel: GrEmptyStateHeadingLevel;
     description: string;
+    kind: GrEmptyStateKind;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/components/GrEmptyState/grEmptyStateStyles.d.ts

@@ -7,6 +7,16 @@ export type GrEmptyStateVariant = typeof GR_EMPTY_STATE_VARIANTS[number];
  * Уровень заголовка. `h1` намеренно нет: пустое состояние живёт внутри уже
  * существующей структуры страницы, а не задаёт её.
  */
+/**
+ * Что за пустота. Значений два, и это не упрощение, а весь корпус: по репозиторию
+ * повторяются ровно они — «ещё ничего не создано» и «под запросом не нашлось».
+ *
+ * Разводить их обязательно: дефолтный заголовок «Пока пусто» под фильтром
+ * дезинформирует — данные есть, просто не совпали. Ошибка загрузки сюда не
+ * входит намеренно, у неё в пакете свои компоненты (`GrResponseErrorBanner`).
+ */
+export declare const GR_EMPTY_STATE_KINDS: readonly ["empty", "search"];
+export type GrEmptyStateKind = typeof GR_EMPTY_STATE_KINDS[number];
 export declare const GR_EMPTY_STATE_HEADING_LEVELS: readonly [2, 3, 4, 5, 6];
 export type GrEmptyStateHeadingLevel = typeof GR_EMPTY_STATE_HEADING_LEVELS[number];
 export declare const rootBaseClass = "text-center";

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

@@ -3,5 +3,5 @@ export { default as GrEmptyState } from './GrEmptyState.vue';
 export type { GrEmptyStateProps } from './GrEmptyState.vue';
 export { grEmptyStateConfig } from './config';
 export type { GrEmptyStateConfigurableProps } from './defaults';
-export type { GrEmptyStateHeadingLevel, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
+export type { GrEmptyStateHeadingLevel, GrEmptyStateKind, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
 export { grEmptyStateSafelist } from './safelist';

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

@@ -22,7 +22,8 @@ export type GrFileUploadRequest<TResponse = unknown> = (files: File[], ctx: GrFi
  * Пропы `GrFileUpload`.
  *
  * Либо `action` (URL для POST multipart/form-data), либо `request` — кастомный
- * загрузчик (например, через axios). Если переданы оба — приоритет у `request`.
+ * загрузчик (например, через axios). Если переданы оба — приоритет у `request`,
+ * а `action` не используется; в dev-сборке об этом предупреждает консоль.
  *
  * `placeholder` — надпись в дефолтном UI-варианте (без слота default).
  */

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

@@ -33,6 +33,13 @@ export interface GrFormFileProps {
     size?: GrFormFileSize;
     /** Миниатюры для картинок в наборе. Файлы других типов остаются строкой. */
     preview?: boolean;
+    /**
+     * Порядок набора задаёт пользователь: у строки появляется ручка переноса.
+     *
+     * Нужно там, где последовательность файлов что-то значит, — галерея,
+     * страницы документа, очередь вложений. Осмысленно только с `multiple`.
+     */
+    reorderable?: boolean;
     /** Дополнительная (кастомная) валидация на стороне потребителя. */
     validate?: (files: File[]) => GrFormFileError[] | Promise<GrFormFileError[]>;
     /**
@@ -62,6 +69,7 @@ declare function blur(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFileProps>, {
     multiple: boolean;
     preview: boolean;
+    reorderable: boolean;
     disabled: boolean;
     readonly: boolean;
     invalid: boolean;
@@ -91,6 +99,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFileProps>, {
     multiple: boolean;
     preview: boolean;
+    reorderable: boolean;
     disabled: boolean;
     readonly: boolean;
     invalid: boolean;
@@ -133,6 +142,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     changeText: string;
     removeText: string;
     clearAllText: string;
+    reorderable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

@@ -31,6 +31,18 @@ export interface GrInputProps {
     maxlength?: number;
     /** Показывать счётчик символов (`len` или `len/maxlength`). */
     showCount?: boolean;
+    /**
+     * Аддоны `prefix`/`suffix` несут смысл, а не украшают.
+     *
+     * По умолчанию они скрыты от скринридера: чаще всего там иконка поиска или
+     * глиф, повторяющий подпись поля, и второе прочтение мешает. Но `https://`
+     * или `₽` бывают единственным местом, где сказано, что вводить, — тогда
+     * аддон уезжает в `aria-describedby` поля.
+     *
+     * Декоративную иконку внутри слота помечайте `aria-hidden` сами: проп снимает
+     * скрытие со всей обёртки, а не разбирает её содержимое.
+     */
+    describeAddons?: boolean;
     /**
        * Фоновая работа по полю (проверка занятости логина, автосохранение):
        * спиннер в trailing-области + `aria-busy`. Ввод не блокируется —
@@ -112,6 +124,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     clearLabel: undefined;
     maxlength: undefined;
     showCount: boolean;
+    describeAddons: boolean;
     loading: boolean;
     passwordToggle: boolean;
     passwordShowLabel: undefined;
@@ -153,6 +166,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     clearLabel: undefined;
     maxlength: undefined;
     showCount: boolean;
+    describeAddons: boolean;
     loading: boolean;
     passwordToggle: boolean;
     passwordShowLabel: undefined;
@@ -198,6 +212,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     inputmode: "search" | "text" | "none" | "email" | "tel" | "url" | "numeric" | "decimal";
     state: "default" | "success" | "warning" | "danger";
     maxlength: number;
+    describeAddons: boolean;
     passwordToggle: boolean;
     passwordShowLabel: string;
     passwordHideLabel: string;

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

@@ -27,6 +27,15 @@ export interface GrInputTagProps {
      * сервере). Отклонённый тег не добавляется и уходит в событие `reject`.
      */
     beforeAdd?: (tag: string) => boolean | Promise<boolean>;
+    /**
+     * Правка тега на месте: `F2` на чипе или двойной клик по нему открывают
+     * поле, `Enter` подтверждает, `Escape` отменяет.
+     *
+     * Проп, а не поведение по умолчанию: двойной клик по чипу сегодня ничего не
+     * делает, и превращать его во вход в правку у всех потребителей — тихая
+     * смена поведения.
+     */
+    editable?: boolean;
     /** Кнопка «снести все теги». Настраивается через `GrConfigProvider`. */
     clearable?: boolean;
     /** Фоновая работа: спиннер + `aria-busy`. Асинхронный `beforeAdd` поднимает его сам. */
@@ -63,6 +72,8 @@ export interface GrInputTagEmits {
     (e: 'update:modelValue', value: string[]): void;
     (e: 'add', value: string): void;
     (e: 'remove', value: string, index: number): void;
+    /** Тег изменён на месте: новое значение, его позиция и то, что стояло раньше. */
+    (e: 'edit', value: string, index: number, previous: string): void;
     /** Тег не прошёл `beforeAdd`. */
     (e: 'reject', value: string): void;
     /** Набор снесён кнопкой «очистить». */
@@ -101,6 +112,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     max: undefined;
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
+    editable: boolean;
     beforeAdd: undefined;
     clearable: undefined;
     loading: boolean;
@@ -121,6 +133,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     "update:modelValue": (value: string[]) => void;
     add: (value: string) => void;
     remove: (value: string, index: number) => void;
+    edit: (value: string, index: number, previous: string) => void;
     reject: (value: string) => void;
     clear: () => void;
     change: (value: string[]) => void;
@@ -140,6 +153,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     max: undefined;
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
+    editable: boolean;
     beforeAdd: undefined;
     clearable: undefined;
     loading: boolean;
@@ -160,6 +174,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     onFocus?: ((event: FocusEvent) => any) | undefined;
     onRemove?: ((value: string, index: number) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+    onEdit?: ((value: string, index: number, previous: string) => any) | undefined;
     onReject?: ((value: string) => any) | undefined;
 }>, {
     disabled: boolean;
@@ -184,6 +199,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
     beforeAdd: (tag: string) => boolean | Promise<boolean>;
+    editable: boolean;
     tagClosable: boolean;
     removeTagLabel: string;
     clearAllLabel: string;

package/dist/types/components/GrInputTag/grInputTagStyles.d.ts

@@ -28,3 +28,14 @@ export declare function grInputTagWrapperClass(options: {
     disabled: boolean;
 }): string;
 export declare function grInputTagInputClass(size: GrInputTagSize): string;
+/**
+ * Поле правки тега — внутри чипа, вместо его содержимого.
+ *
+ * Ни фона, ни рамки: их рисует сам чип, и второй набор внутри выглядел бы
+ * полем в поле. А вот кольцо фокуса нужно: без него чип в правке неотличим от
+ * обычного — единственным признаком остаётся каретка, и режим не виден.
+ *
+ * Ширину задаёт нативный `size` по длине черновика: в режиме правки у чипа нет
+ * содержимого, от которого он взял бы ширину.
+ */
+export declare const tagEditInputClass = "min-w-[2ch] bg-transparent border-none p-0 text-inherit [font:inherit] rounded-[var(--gr-radius-sm)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";

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

@@ -11,8 +11,19 @@ export interface GrKbdProps {
     /**
      * Сочетание: строкой (`"mod+shift+K"`) или набором токенов
      * (`['mod', 'K']`). Токен `mod` — Cmd на macOS, Ctrl на остальных.
+     *
+     * Пробел в строке делит её на шаги: `"g i"` рисуется как «G затем I», а
+     * `"mod+k p"` — как «⌘K затем P». Форма массива остаётся плоским аккордом:
+     * что там шаг, а что клавиша, массив не различает.
      */
     keys?: string | string[];
+    /**
+     * Идентификатор записи в реестре (`granularityHotkeysPlugin`). Сочетание
+     * берётся оттуда, поэтому подсказка не может разойтись с привязкой. Сильнее
+     * `keys`: если задан и он, побеждает реестр — иначе два источника спорили бы
+     * молча.
+     */
+    hotkey?: string;
     /**
      * Разделитель между клавишами. Не задан — авто: в общей плашке символы
      * склеиваются (`⌘K`), а слова разделяются плюсом (`Ctrl+K`); у `split` это
@@ -39,12 +50,14 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     size: undefined;
     variant: string;
     keys: undefined;
+    hotkey: undefined;
     separator: undefined;
     platform: string;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrKbdProps>, {
     size: undefined;
     variant: string;
     keys: undefined;
+    hotkey: undefined;
     separator: undefined;
     platform: string;
 }>>> & Readonly<{}>, {
@@ -53,6 +66,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     size: GrKbdSize;
     separator: string;
     platform: GrKbdPlatform;
+    hotkey: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

@@ -1,4 +1,5 @@
 import { type GrComponentSize } from '../GrConfigProvider/context';
+import type { GrNavbarHeadingLevel } from './grNavbarStyles';
 /**
  * GrNavbar — верхняя панель приложения (header) с тремя зонами: слева заголовок
  * и кнопка меню, по центру — свободная зона (поиск, хлебные крошки), справа —
@@ -10,6 +11,20 @@ import { type GrComponentSize } from '../GrConfigProvider/context';
 export interface GrNavbarProps {
     /** Заголовок строкой. Слот `#title` сильнее и позволяет обойтись без пропа. */
     title?: string;
+    /**
+     * Сделать заголовок настоящим `h1`…`h6`.
+     *
+     * По умолчанию заголовок — `div`, и это верно для большинства шапок: логотип
+     * и название приложения заголовками не являются, и `h1` на них исказил бы
+     * структуру страницы. Но шапка раздела админки или имя документа — заголовок
+     * и есть, а обойти такую страницу по структуре иначе нечем.
+     *
+     * Через `GrConfigProvider` не настраивается намеренно: «заголовка нет» там не
+     * выразить (`useGrComponentProp` требует не-nullable фолбэк), то есть общим
+     * дефолтом стал бы какой-то уровень. Да и шапка у оболочки одна — глобальный
+     * дефолт настраивал бы единственное место вызова.
+     */
+    headingLevel?: GrNavbarHeadingLevel;
     showMenuButton?: boolean;
     /**
      * Ступень кнопки меню — и только её: остальное в шапке принадлежит
@@ -44,6 +59,7 @@ type __VLS_Slots = {
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNavbarProps>, {
     title: undefined;
+    headingLevel: undefined;
     showMenuButton: boolean;
     size: undefined;
     menuButtonClass: string;
@@ -52,6 +68,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     menu: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNavbarProps>, {
     title: undefined;
+    headingLevel: undefined;
     showMenuButton: boolean;
     size: undefined;
     menuButtonClass: string;
@@ -62,6 +79,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     sticky: boolean;
     title: string;
     size: GrComponentSize;
+    headingLevel: GrNavbarHeadingLevel;
     showMenuButton: boolean;
     menuButtonClass: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/types/components/GrNavbar/grNavbarStyles.d.ts

@@ -19,5 +19,14 @@ export declare const navbarSideClass = "flex min-w-0 items-center gap-3";
 export declare const navbarSideGrowClass = "flex-1";
 export declare const navbarRightAlignClass = "justify-end";
 export declare const navbarCenterClass = "flex min-w-0 flex-1 items-center justify-center gap-3";
-export declare const navbarTitleClass = "text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)] font-700";
+/**
+ * Уровни заголовка шапки.
+ *
+ * Единица разрешена, в отличие от `GrCard`, где шкала начинается с двойки:
+ * карточка никогда не бывает заголовком страницы, а шапка раздела — бывает, и
+ * имя раздела в ней и есть `h1`.
+ */
+export declare const GR_NAVBAR_HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
+export type GrNavbarHeadingLevel = typeof GR_NAVBAR_HEADING_LEVELS[number];
+export declare const navbarTitleClass = "m-0 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)] font-700";
 export declare function grNavbarRootClass(sticky: boolean): string;

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

@@ -1,6 +1,7 @@
 export { default } from './GrNavbar.vue';
 export { default as GrNavbar } from './GrNavbar.vue';
 export type { GrNavbarProps } from './GrNavbar.vue';
+export type { GrNavbarHeadingLevel } from './grNavbarStyles';
 export type { GrNavbarConfigurableProps } from './defaults';
 export { grNavbarConfig } from './config';
 export { grNavbarSafelist } from './safelist';

package/dist/types/components/GrSelect/composables/useSelectPanelItems.d.ts

@@ -1,42 +1,16 @@
 import type { ComputedRef } from 'vue';
+import type { OptionPanelItem, OptionPanelOptionRow, OptionPanelRow } from '../../shared/optionPanel';
 import type { GrSelectOption, GrSelectOptionGroup, GrSelectOptionOrGroup, GrSelectValue } from '../grSelectStyles';
 /**
  * Элемент рендера панели: либо заголовок группы, либо опция.
- * Группировка сохраняется, фильтрация по запросу скрывает пустые группы.
+ *
+ * Типы — алиасы общей машинерии (`shared/optionPanel`): алгоритм у панели
+ * `GrSelect` и `GrAutocomplete` один, и копия разошлась бы с оригиналом молча.
+ * Имена остаются своими, потому что они публичные.
  */
-export type GrSelectPanelItem<TValue extends GrSelectValue> = {
-    kind: 'group';
-    label: string;
-    key: string;
-}
-/** `groupKey` связывает опцию с заголовком её группы для скринридера. */
- | {
-    kind: 'option';
-    option: GrSelectOption<TValue>;
-    key: string;
-    groupKey?: string;
-};
-export type GrSelectPanelOptionRow<TValue extends GrSelectValue> = {
-    option: GrSelectOption<TValue>;
-    key: string;
-    index: number;
-};
-export type GrSelectPanelRow<TValue extends GrSelectValue> = {
-    kind: 'group';
-    label: string;
-    key: string;
-    options: GrSelectPanelOptionRow<TValue>[];
-    /**
-     * Есть ли в этой отрисовке видимый заголовок. При виртуализации окно может
-     * начаться серединой группы: обёртка нужна всё равно, а заголовка нет —
-     * имя тогда идёт в `aria-label`.
-     */
-    labelVisible?: boolean;
-    /** Позиция заголовка в `panelItems` — по ней его замеряет виртуализатор. */
-    labelIndex?: number;
-} | ({
-    kind: 'option';
-} & GrSelectPanelOptionRow<TValue>);
+export type GrSelectPanelItem<TValue extends GrSelectValue> = OptionPanelItem<GrSelectOption<TValue>>;
+export type GrSelectPanelOptionRow<TValue extends GrSelectValue> = OptionPanelOptionRow<GrSelectOption<TValue>>;
+export type GrSelectPanelRow<TValue extends GrSelectValue> = OptionPanelRow<GrSelectOption<TValue>>;
 /**
  * Состав панели `GrSelect`: плоский набор строк, их группировка и признак
  * «набранное можно добавить».

package/dist/types/components/GrSelect/composables/useSelectVirtualization.d.ts

@@ -1,6 +1,13 @@
 import type { ComputedRef, Ref } from 'vue';
 import type { GrSelectValue } from '../grSelectStyles';
 import type { GrSelectPanelItem, GrSelectPanelRow } from './useSelectPanelItems';
+/**
+ * Виртуализация панели `GrSelect` — тонкая обёртка над общей машинерией
+ * (`shared/optionPanel`): алгоритм тот же, что у `GrAutocomplete`, и держать
+ * его в двух местах значило бы разойтись молча.
+ *
+ * Своё здесь только имя ведущей строки: у селекта это «Add …».
+ */
 export interface UseSelectVirtualizationOptions<TValue extends GrSelectValue> {
     panelItems: ComputedRef<GrSelectPanelItem<TValue>[]>;
     panelRows: ComputedRef<GrSelectPanelRow<TValue>[]>;

package/dist/types/components/GrSelect/grSelectStyles.d.ts

@@ -122,7 +122,7 @@ export declare function grSelectTriggerClass(options: {
     state?: GrSelectState;
     invalid?: boolean;
 }): string;
-export declare const grSelectPanelClasses = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-popover)] text-[var(--gr-popover-fg)] shadow-[var(--gr-shadow-2)] overflow-hidden";
+export declare const grSelectPanelClasses = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-popover)] text-[var(--gr-popover-fg)] shadow-[var(--gr-shadow-2)] flex flex-col max-h-[var(--gr-floating-available-height,100vh)] overflow-hidden";
 export declare const selectOptionBaseClass = "rounded-[var(--gr-radius-md)] px-3 py-2 text-left text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-sm)]";
 export declare const selectOptionLinkWidthClass = "block min-w-full w-max whitespace-nowrap";
 export declare const selectOptionWidthClass = "w-full";