@feugene/granularity 0.48.0 → 0.50.0

package/dist/types/components/GrColorPicker/eyeDropper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Пипетка экрана поверх `EyeDropper`.
+ *
+ * API есть не везде (сегодня — браузеры на Chromium), поэтому вызывается через
+ * проверку, а не через `try`: кнопка не должна появляться там, где нажатие
+ * ничего не даст.
+ *
+ * Отказ пользователя ошибкой не считается. `open()` отклоняется `AbortError`
+ * и на `Esc`, и на обрыв через `AbortSignal` — оба исхода означают «цвет не
+ * выбран», и разговаривать о них с пользователем не о чем.
+ */
+/** Поддерживается ли пипетка. Зовётся после монтирования: на сервере `window` нет. */
+export declare function isEyeDropperSupported(): boolean;
+/**
+ * Открыть пипетку и дождаться цвета. `null` — пользователь отказался или API
+ * недоступно.
+ *
+ * Вызов обязан идти прямо из обработчика нажатия: без свежего жеста браузер
+ * отклоняет `open()` как `NotAllowedError`.
+ */
+export declare function pickScreenColor(signal?: AbortSignal): Promise<string | null>;

package/dist/types/components/GrColorPicker/grColorPickerStyles.d.ts

@@ -24,6 +24,43 @@ export declare const swatchBaseClass = "relative shrink-0 overflow-hidden rounde
 export declare const swatchFillClass = "absolute inset-0";
 export declare const panelBaseClass = "grid";
 export declare const previewClass = "relative h-10 w-full overflow-hidden rounded-[var(--gr-radius-md)] border border-[color-mix(in_srgb,var(--gr-fg)_18%,transparent)]";
+/** Вид панели: лестница каналов или квадрат насыщенность × светлота. */
+export declare const GR_COLOR_PICKER_VIEWS: readonly ["sliders", "area"];
+export type GrColorPickerView = typeof GR_COLOR_PICKER_VIEWS[number];
+/**
+ * Высота области. Ширину задаёт панель, поэтому квадрат тут не буквальный:
+ * на узкой ступени доля высоты крупнее, иначе область вырождается в полоску.
+ */
+export declare const areaHeightBySize: Record<GrColorPickerSize, string>;
+/**
+ * Область насыщенности и светлоты.
+ *
+ * Кольцо фокуса живёт на обёртке через `focus-within`: фокус получают скрытые
+ * `input[type=range]` внутри, и своё кольцо у них было бы шириной в пиксель.
+ */
+export declare const areaBaseClass = "relative w-full overflow-hidden rounded-[var(--gr-radius-md)] border border-[color-mix(in_srgb,var(--gr-fg)_18%,transparent)] [touch-action:none] focus-within:outline-none focus-within:ring-2 focus-within:ring-[var(--gr-ring)]";
+export declare const areaEnabledClass = "cursor-crosshair";
+export declare const areaDisabledClass = "cursor-not-allowed";
+/**
+ * Ручка области.
+ *
+ * Обвода два, светлый и тёмный: ручка лежит поверх произвольного цвета, и
+ * одиночный пропадал бы на своём конце шкалы — белый в углу белого, тёмный в
+ * углу чёрного.
+ *
+ * Оба независимы от темы намеренно: под ручкой не подложка компонента, а
+ * выбираемый цвет, и `--gr-fg` спорил бы с ним, а не с фоном страницы.
+ */
+export declare const areaThumbClass = "pointer-events-none absolute h-[var(--gr-color-picker-area-thumb-size,0.875rem)] w-[var(--gr-color-picker-area-thumb-size,0.875rem)] -translate-x-1/2 -translate-y-1/2 rounded-[var(--gr-radius-full)] border-2 border-[var(--gr-color-picker-area-thumb-border,#fff)] shadow-[0_0_0_1px_var(--gr-color-picker-area-thumb-ring,rgba(0,0,0,0.45))]";
+/** Оба поля осей: доступны диктору и клавиатуре, но не видны. */
+export declare const areaInputClass = "sr-only";
+/** Пипетка стоит в одном ряду с полем hex и повторяет его высоту. */
+export declare const eyedropperClass = "inline-flex shrink-0 items-center justify-center rounded-[var(--gr-radius-control)] border border-[var(--gr-brd)] bg-[var(--gr-bg)] text-[var(--gr-fg)] transition-colors duration-[var(--gr-duration-fast)] hover:border-[var(--gr-primary)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:cursor-not-allowed disabled:border-[var(--gr-brd)] disabled:bg-[var(--gr-muted)] disabled:text-[var(--gr-disabled-fg)]";
+export declare const eyedropperSizeBySize: Record<GrColorPickerSize, string>;
+export declare const eyedropperIconClass = "h-4 w-4 shrink-0";
+/** Поле hex и пипетка стоят рядом: поле тянется, кнопка держит свою ширину. */
+export declare const hexRowClass = "flex items-center gap-2";
+export declare const hexFieldClass = "min-w-0 flex-1";
 export declare const rowClass = "grid grid-cols-[1.25rem_minmax(0,1fr)_2.75rem] items-center gap-2";
 export declare const rowLabelClass = "text-[var(--gr-muted-fg)]";
 export declare const rowValueClass = "text-right text-[var(--gr-muted-fg)] tabular-nums";
@@ -37,3 +74,8 @@ export declare function grColorPickerTriggerClass(options: {
 }): string;
 export declare function grColorPickerPanelClass(size: GrColorPickerSize): string;
 export declare function grColorPickerPresetClass(selected: boolean): string;
+export declare function grColorPickerAreaClass(options: {
+    size: GrColorPickerSize;
+    locked: boolean;
+}): string;
+export declare function grColorPickerEyedropperClass(size: GrColorPickerSize): string;

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

@@ -29,6 +29,12 @@ export interface GrCommandPaletteProps {
     size?: GrCommandPaletteSize;
     /** Глобальное сочетание открытия. `null` — не вешать слушатель. */
     hotkey?: string | null;
+    /**
+     * Идентификатор записи в реестре (`granularityHotkeysPlugin`) вместо
+     * сочетания строкой: подсказка и привязка берутся из одного источника и не
+     * могут разойтись. Сильнее `hotkey`.
+     */
+    hotkeyId?: string;
     /** Локальная фильтрация по запросу. `false` — фильтрует владелец по событию `search`. */
     filterable?: boolean;
     /** Кастомный матчер локальной фильтрации. */
@@ -83,6 +89,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     placeholder: undefined;
     size: undefined;
     hotkey: string;
+    hotkeyId: undefined;
     filterable: boolean;
     filter: undefined;
     loading: boolean;
@@ -106,6 +113,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     placeholder: undefined;
     size: undefined;
     hotkey: string;
+    hotkeyId: undefined;
     filterable: boolean;
     filter: undefined;
     loading: boolean;
@@ -131,8 +139,9 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     closeOnSelect: boolean;
     virtual: boolean;
     items: GrCommandItem[];
-    recentIds: string[];
     hotkey: string | null;
+    recentIds: string[];
+    hotkeyId: string;
     showHotkeyHint: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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>;