@feugene/granularity 0.48.0 → 0.50.0

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.48.0",
+  "version": "0.50.0",
   "framework": "vue",
   "js-types-syntax": "typescript",
   "description-markup": "markdown",
@@ -194,7 +194,7 @@
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "GrAutocompleteOption<TValue>[] | undefined"
+                "type": "GrAutocompleteOptionOrGroup<TValue>[] | undefined"
               }
             },
             {
@@ -339,7 +339,7 @@
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "((query: string, signal: AbortSignal) => Promise<GrAutocompleteOption<TValue>[]>) | undefined"
+                "type": "((query: string, signal: AbortSignal) => Promise<GrAutocompleteOptionOrGroup<TValue>[]>) | undefined"
               }
             },
             {
@@ -667,6 +667,15 @@
                 "kind": "expression",
                 "type": "GrBadgeRadius | undefined"
               }
+            },
+            {
+              "name": "dot",
+              "description": "Точка-маркер перед подписью: «● Активен». Имя тона красит маркер отдельно от плашки — ради пары «тихая плашка + цветной маркер», из-за которой паттерн и существует. `true` берёт тон самого бейджа. На заливке (`dark`) маркер всегда цвета текста: тон там слился бы с подложкой, взятой из того же слоя.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | GrBadgeDotTone | undefined"
+              }
             }
           ],
           "slots": [
@@ -1348,6 +1357,24 @@
                 "type": "string | undefined"
               }
             },
+            {
+              "name": "virtual",
+              "description": "Не рисовать содержимое кадров вдали от текущего. Виртуализируется **нутро кадра, а не кадр**: кадры приходят слотом, и не отрисовать чужой узел лента не может. Пустая обёртка держит место в ряду и почти ничего не весит, а картинки и карточки из DOM уходят.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "orientation",
+              "description": "Ось движения ленты. По вертикали вьюпорту нужна **определённая высота**: шаг считается от неё, и без высоты лента вырождается в столбец кадров.",
+              "default": "\"horizontal\"",
+              "value": {
+                "kind": "expression",
+                "type": "\"horizontal\" | \"vertical\" | undefined"
+              }
+            },
             {
               "name": "autoplay",
               "description": "Запустить показ. Под `prefers-reduced-motion` не стартует — тумблер остаётся.",
@@ -1375,6 +1402,15 @@
                 "type": "boolean | undefined"
               }
             },
+            {
+              "name": "virtualOverscan",
+              "description": "Сколько кадров по обе стороны от текущего рисовать сверх него. Меньше единицы ставить нельзя: следующий кадр обязан быть готов **до** перехода, иначе лента поедет на пустоту, а содержимое проявится уже на месте.",
+              "default": "1",
+              "value": {
+                "kind": "expression",
+                "type": "number | undefined"
+              }
+            },
             {
               "name": "indicators",
               "description": "Вид переключателя кадров. `none` меняет и роль самих слайдов.",
@@ -1587,6 +1623,15 @@
                 "type": "string | undefined"
               }
             },
+            {
+              "name": "tabindex",
+              "description": "Остановка `Tab` у самого переключателя. Нужна составным виджетам, которые забирают таб-порядок себе: в сетке `GrDataTable` (`cell-navigation`) `Tab` принадлежит таблице целиком, и чекбокс в ячейке своей остановки держать не должен — до него добираются стрелкой до ячейки и `Enter`. Выключенный переключатель остаётся вне обхода в любом случае.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "number | undefined"
+              }
+            },
             {
               "name": "form",
               "default": "undefined",
@@ -1802,28 +1847,28 @@
               }
             },
             {
-              "name": "dark",
+              "name": "value",
+              "description": "Значение чипа в группе. Вне `GrChipGroup` не используется.",
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "boolean | undefined"
+                "type": "GrChipValue | undefined"
               }
             },
             {
-              "name": "radius",
+              "name": "dark",
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "GrBadgeRadius | undefined"
+                "type": "boolean | undefined"
               }
             },
             {
-              "name": "value",
-              "description": "Значение чипа в группе. Вне `GrChipGroup` не используется.",
+              "name": "radius",
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "GrChipValue | undefined"
+                "type": "GrBadgeRadius | undefined"
               }
             },
             {
@@ -2249,6 +2294,24 @@
                 "type": "boolean | undefined"
               }
             },
+            {
+              "name": "view",
+              "description": "Как задаются насыщенность и светлота: двумя бегунками или квадратом. Оттенок и прозрачность остаются бегунками в обоих видах.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "\"sliders\" | \"area\" | undefined"
+              }
+            },
+            {
+              "name": "eyedropper",
+              "description": "Кнопка пипетки. Рисуется только там, где браузер даёт `EyeDropper`, — сегодня это Chromium.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "presets",
               "description": "Палитра быстрого выбора. Пусто — блок не рендерится.",
@@ -2399,6 +2462,15 @@
                 "type": "string | null | undefined"
               }
             },
+            {
+              "name": "hotkeyId",
+              "description": "Идентификатор записи в реестре (`granularityHotkeysPlugin`) вместо сочетания строкой: подсказка и привязка берутся из одного источника и не могут разойтись. Сильнее `hotkey`.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
             {
               "name": "maxHeight",
               "description": "Максимальная высота списка, px.",
@@ -3198,6 +3270,33 @@
                 "type": "Record<string, number> | undefined"
               }
             },
+            {
+              "name": "pinnableColumns",
+              "description": "Закрепление колонок задаёт пользователь: в шапке появляется меню с «закрепить слева / справа / открепить». Без пропа `pinned` у колонки остаётся тем, чем был, — объявлением в конфиге, которое меняется только кодом.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "pinnedColumns",
+              "description": "Контролируемое закрепление по ключу колонки (`v-model:pinnedColumns`). Не задано — компонент помнит его сам, начиная с `pinned` у колонок.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "Record<string, GrColumnPin> | undefined"
+              }
+            },
+            {
+              "name": "cellNavigation",
+              "description": "Клавиатура по ячейкам: паттерн `grid` из WAI-ARIA APG. Вся таблица становится **одной** остановкой `Tab`, внутрь ведут стрелки, а в содержимое ячейки — `Enter` или `F2`. Поэтому проп отдельный, а не поведение по умолчанию: он переставляет таб-порядок у всех, кто таблицу уже поставил.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "expandable",
               "description": "Второй ярус строки: колонка с кнопкой раскрытия и блок подробностей под строкой. Содержимое рисует слот `#detail`.",
@@ -3300,6 +3399,12 @@
               {
                 "name": "columnResize"
               },
+              {
+                "name": "update:pinnedColumns"
+              },
+              {
+                "name": "columnPin"
+              },
               {
                 "name": "update:expandedKeys"
               },
@@ -4273,6 +4378,15 @@
                 "kind": "expression",
                 "type": "2 | 3 | 4 | 5 | 6 | undefined"
               }
+            },
+            {
+              "name": "kind",
+              "description": "Что за пустота: ещё ничего не создано (`empty`) или под запросом ничего не нашлось (`search`). Меняет иконку и заголовок по умолчанию; заданный `title` сильнее в обоих случаях.",
+              "default": "\"empty\"",
+              "value": {
+                "kind": "expression",
+                "type": "\"search\" | \"empty\" | undefined"
+              }
             }
           ],
           "slots": [
@@ -5113,6 +5227,15 @@
                 "type": "string | undefined"
               }
             },
+            {
+              "name": "reorderable",
+              "description": "Порядок набора задаёт пользователь: у строки появляется ручка переноса. Нужно там, где последовательность файлов что-то значит, — галерея, страницы документа, очередь вложений. Осмысленно только с `multiple`.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "errors",
               "description": "Контролируемый список ошибок: `v-model:errors`. Задан — показывается он, и внутренняя валидация его не перетирает. Сюда же кладутся ошибки, пришедшие с сервера. Не задан — компонент держит свои ошибки сам.",
@@ -5752,6 +5875,15 @@
                 "type": "boolean | undefined"
               }
             },
+            {
+              "name": "describeAddons",
+              "description": "Аддоны `prefix`/`suffix` несут смысл, а не украшают. По умолчанию они скрыты от скринридера: чаще всего там иконка поиска или глиф, повторяющий подпись поля, и второе прочтение мешает. Но `https://` или `₽` бывают единственным местом, где сказано, что вводить, — тогда аддон уезжает в `aria-describedby` поля. Декоративную иконку внутри слота помечайте `aria-hidden` сами: проп снимает скрытие со всей обёртки, а не разбирает её содержимое.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "passwordToggle",
               "description": "Кнопка показать/скрыть пароль (только при `type=\"password\"`).",
@@ -6015,6 +6147,15 @@
                 "type": "((tag: string) => boolean | Promise<boolean>) | undefined"
               }
             },
+            {
+              "name": "editable",
+              "description": "Правка тега на месте: `F2` на чипе или двойной клик по нему открывают поле, `Enter` подтверждает, `Escape` отменяет. Проп, а не поведение по умолчанию: двойной клик по чипу сегодня ничего не делает, и превращать его во вход в правку у всех потребителей — тихая смена поведения.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "tagClosable",
               "default": "true",
@@ -6132,6 +6273,9 @@
               },
               {
                 "name": "reject"
+              },
+              {
+                "name": "edit"
               }
             ]
           }
@@ -6265,7 +6409,7 @@
           "props": [
             {
               "name": "keys",
-              "description": "Сочетание: строкой (`\"mod+shift+K\"`) или набором токенов (`['mod', 'K']`). Токен `mod` — Cmd на macOS, Ctrl на остальных.",
+              "description": "Сочетание: строкой (`\"mod+shift+K\"`) или набором токенов (`['mod', 'K']`). Токен `mod` — Cmd на macOS, Ctrl на остальных. Пробел в строке делит её на шаги: `\"g i\"` рисуется как «G затем I», а `\"mod+k p\"` — как «⌘K затем P». Форма массива остаётся плоским аккордом: что там шаг, а что клавиша, массив не различает.",
               "default": "undefined",
               "value": {
                 "kind": "expression",
@@ -6298,6 +6442,15 @@
                 "type": "string | undefined"
               }
             },
+            {
+              "name": "hotkey",
+              "description": "Идентификатор записи в реестре (`granularityHotkeysPlugin`). Сочетание берётся оттуда, поэтому подсказка не может разойтись с привязкой. Сильнее `keys`: если задан и он, побеждает реестр — иначе два источника спорили бы молча.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
             {
               "name": "platform",
               "default": "\"auto\"",
@@ -6810,6 +6963,15 @@
                 "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
               }
             },
+            {
+              "name": "headingLevel",
+              "description": "Сделать заголовок настоящим `h1`…`h6`. По умолчанию заголовок — `div`, и это верно для большинства шапок: логотип и название приложения заголовками не являются, и `h1` на них исказил бы структуру страницы. Но шапка раздела админки или имя документа — заголовок и есть, а обойти такую страницу по структуре иначе нечем. Через `GrConfigProvider` не настраивается намеренно: «заголовка нет» там не выразить (`useGrComponentProp` требует не-nullable фолбэк), то есть общим дефолтом стал бы какой-то уровень. Да и шапка у оболочки одна — глобальный дефолт настраивал бы единственное место вызова.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "2 | 1 | 3 | 4 | 5 | 6 | undefined"
+              }
+            },
             {
               "name": "showMenuButton",
               "default": "false",
@@ -7179,15 +7341,14 @@
           }
         },
         {
-          "name": "GrPagination",
+          "name": "GrOtpInput",
           "source": {
-            "module": "@feugene/granularity/components/GrPagination",
-            "symbol": "GrPagination"
+            "module": "@feugene/granularity/components/GrOtpInput",
+            "symbol": "GrOtpInput"
           },
           "props": [
             {
               "name": "disabled",
-              "description": "Гасит всю пагинацию: номера, кнопки, селект размера и поле перехода.",
               "default": "false",
               "value": {
                 "kind": "expression",
@@ -7195,88 +7356,84 @@
               }
             },
             {
-              "name": "size",
+              "name": "length",
+              "description": "Число ячеек.",
               "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
+                "type": "number | undefined"
               }
             },
             {
-              "name": "ariaLabel",
-              "description": "Имя навигационного лендмарка. По умолчанию — `gr.pagination.label`; задавать стоит там, где пагинаций на странице несколько и их надо различать.",
-              "default": "undefined",
+              "name": "type",
+              "description": "Допустимый алфавит и раскладка мобильной клавиатуры.",
+              "default": "\"numeric\"",
               "value": {
                 "kind": "expression",
-                "type": "string | undefined"
+                "type": "\"text\" | \"numeric\" | \"alphanumeric\" | undefined"
               }
             },
             {
-              "name": "compact",
-              "description": "Компактный вариант: вместо нумерованных страниц показывается индикатор «текущая / всего» — удобно для узких мест (мобайл, тулбары таблиц).",
-              "default": "false",
+              "name": "modelValue",
+              "description": "Код целиком, без разделителей.",
+              "default": "\"\"",
               "value": {
                 "kind": "expression",
-                "type": "boolean | undefined"
+                "type": "string | undefined"
               }
             },
             {
-              "name": "pageSizes",
-              "description": "Варианты размера страницы. Число — подпись равна значению; пара — своя подпись при том же значении («50 / стр.»), которую иначе было не собрать.",
-              "default": "[10, 20, 50]",
+              "name": "readonly",
+              "default": "false",
               "value": {
                 "kind": "expression",
-                "type": "GrPaginationPageSizeOption[] | undefined"
+                "type": "boolean | undefined"
               }
             },
             {
-              "name": "siblingCount",
-              "description": "Сколько соседних страниц показывать вокруг текущей. По умолчанию `1`.",
-              "default": "1",
+              "name": "invalid",
+              "default": "false",
               "value": {
                 "kind": "expression",
-                "type": "number | undefined"
+                "type": "boolean | undefined"
               }
             },
             {
-              "name": "boundaryCount",
-              "description": "Сколько крайних страниц всегда показывать с каждого края. По умолчанию `1`.",
-              "default": "1",
+              "name": "required",
+              "default": "false",
               "value": {
                 "kind": "expression",
-                "type": "number | undefined"
+                "type": "boolean | undefined"
               }
             },
             {
-              "name": "showJumper",
-              "description": "Показывать поле «перейти к странице» с быстрым переходом по вводу номера.",
-              "default": "false",
+              "name": "size",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "boolean | undefined"
+                "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
               }
             },
             {
-              "name": "showPageSize",
-              "description": "Показывать селект размера страницы.",
-              "default": "false",
+              "name": "placeholder",
+              "description": "Знак в пустой ячейке.",
+              "default": "\"\"",
               "value": {
                 "kind": "expression",
-                "type": "boolean | undefined"
+                "type": "string | undefined"
               }
             },
             {
-              "name": "showTotal",
-              "description": "Показывать диапазон показанных элементов — «1–20 из 137». Слот `#total` сильнее.",
-              "default": "false",
+              "name": "ariaLabel",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "boolean | undefined"
+                "type": "string | undefined"
               }
             },
             {
-              "name": "jumperLabel",
-              "description": "i18n-подпись перед полем перехода. По умолчанию — `gr.pagination.jumpTo`.",
+              "name": "name",
+              "description": "Имя поля для нативной отправки формы.",
               "default": "undefined",
               "value": {
                 "kind": "expression",
@@ -7284,64 +7441,43 @@
               }
             },
             {
-              "name": "page",
-              "required": true,
+              "name": "form",
+              "description": "`id` формы, если поле лежит вне неё.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "number"
+                "type": "string | undefined"
               }
             },
             {
-              "name": "pageSize",
-              "required": true,
+              "name": "pattern",
+              "description": "Свой алфавит регуляркой на **один символ**. Перекрывает `type`.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "number"
+                "type": "string | undefined"
               }
             },
             {
-              "name": "total",
-              "required": true,
+              "name": "groups",
+              "description": "Разбивка на группы: `[3, 3]` рисует `123 – 456`. Сумма обязана равняться `length`.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "number"
-              }
-            }
-          ],
-          "slots": [
-            {
-              "name": "total",
-              "description": "Диапазон показанных элементов целиком — вместо строки из локали."
-            }
-          ],
-          "js": {
-            "events": [
-              {
-                "name": "update:page"
-              },
-              {
-                "name": "update:pageSize"
+                "type": "number[] | undefined"
               }
-            ]
-          }
-        },
-        {
-          "name": "GrPopover",
-          "source": {
-            "module": "@feugene/granularity/components/GrPopover",
-            "symbol": "GrPopover"
-          },
-          "props": [
+            },
             {
-              "name": "placement",
-              "default": "\"bottom-start\"",
+              "name": "masked",
+              "description": "Точки вместо символов — сценарий PIN. На `modelValue` не влияет.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "Placement | undefined"
+                "type": "boolean | undefined"
               }
             },
             {
-              "name": "disabled",
+              "name": "autofocus",
               "default": "false",
               "value": {
                 "kind": "expression",
@@ -7349,9 +7485,228 @@
               }
             },
             {
-              "name": "open",
-              "description": "Открыт ли поповер. Без этого пропа компонент ведёт состояние сам (uncontrolled), с ним — слушайте `update:open`.",
-              "default": "undefined",
+              "name": "oneTimeCode",
+              "description": "`autocomplete=\"one-time-code\"`: код из SMS подставляется на iOS и macOS.",
+              "default": "true",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "webOtp",
+              "description": "Приём кода из SMS на Android через WebOTP. Выключен: требует HTTPS и особого хвоста в тексте сообщения, который добавляет бэкенд.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "cell",
+              "description": "Своё оформление ячейки. Размер и рамку по-прежнему держит компонент."
+            },
+            {
+              "name": "separator",
+              "description": "Знак между группами. По умолчанию — тире."
+            }
+          ],
+          "js": {
+            "events": [
+              {
+                "name": "update:modelValue"
+              },
+              {
+                "name": "change"
+              },
+              {
+                "name": "focus"
+              },
+              {
+                "name": "blur"
+              },
+              {
+                "name": "complete"
+              }
+            ]
+          }
+        },
+        {
+          "name": "GrPagination",
+          "source": {
+            "module": "@feugene/granularity/components/GrPagination",
+            "symbol": "GrPagination"
+          },
+          "props": [
+            {
+              "name": "disabled",
+              "description": "Гасит всю пагинацию: номера, кнопки, селект размера и поле перехода.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "size",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
+              }
+            },
+            {
+              "name": "ariaLabel",
+              "description": "Имя навигационного лендмарка. По умолчанию — `gr.pagination.label`; задавать стоит там, где пагинаций на странице несколько и их надо различать.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "compact",
+              "description": "Компактный вариант: вместо нумерованных страниц показывается индикатор «текущая / всего» — удобно для узких мест (мобайл, тулбары таблиц).",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "pageSizes",
+              "description": "Варианты размера страницы. Число — подпись равна значению; пара — своя подпись при том же значении («50 / стр.»), которую иначе было не собрать.",
+              "default": "[10, 20, 50]",
+              "value": {
+                "kind": "expression",
+                "type": "GrPaginationPageSizeOption[] | undefined"
+              }
+            },
+            {
+              "name": "siblingCount",
+              "description": "Сколько соседних страниц показывать вокруг текущей. По умолчанию `1`.",
+              "default": "1",
+              "value": {
+                "kind": "expression",
+                "type": "number | undefined"
+              }
+            },
+            {
+              "name": "boundaryCount",
+              "description": "Сколько крайних страниц всегда показывать с каждого края. По умолчанию `1`.",
+              "default": "1",
+              "value": {
+                "kind": "expression",
+                "type": "number | undefined"
+              }
+            },
+            {
+              "name": "showJumper",
+              "description": "Показывать поле «перейти к странице» с быстрым переходом по вводу номера.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "showPageSize",
+              "description": "Показывать селект размера страницы.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "showTotal",
+              "description": "Показывать диапазон показанных элементов — «1–20 из 137». Слот `#total` сильнее.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "jumperLabel",
+              "description": "i18n-подпись перед полем перехода. По умолчанию — `gr.pagination.jumpTo`.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "page",
+              "required": true,
+              "value": {
+                "kind": "expression",
+                "type": "number"
+              }
+            },
+            {
+              "name": "pageSize",
+              "required": true,
+              "value": {
+                "kind": "expression",
+                "type": "number"
+              }
+            },
+            {
+              "name": "total",
+              "required": true,
+              "value": {
+                "kind": "expression",
+                "type": "number"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "total",
+              "description": "Диапазон показанных элементов целиком — вместо строки из локали."
+            }
+          ],
+          "js": {
+            "events": [
+              {
+                "name": "update:page"
+              },
+              {
+                "name": "update:pageSize"
+              }
+            ]
+          }
+        },
+        {
+          "name": "GrPopover",
+          "source": {
+            "module": "@feugene/granularity/components/GrPopover",
+            "symbol": "GrPopover"
+          },
+          "props": [
+            {
+              "name": "placement",
+              "default": "\"bottom-start\"",
+              "value": {
+                "kind": "expression",
+                "type": "Placement | undefined"
+              }
+            },
+            {
+              "name": "disabled",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "open",
+              "description": "Открыт ли поповер. Без этого пропа компонент ведёт состояние сам (uncontrolled), с ним — слушайте `update:open`.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
                 "type": "boolean | undefined"
@@ -7668,21 +8023,21 @@
               }
             },
             {
-              "name": "shape",
-              "description": "Замкнутое кольцо или дуга с вырезом снизу.",
-              "default": "undefined",
+              "name": "value",
+              "description": "Текущее значение `0..100`; выходящие за границы клампятся, `NaN` → `0`.",
+              "default": "0",
               "value": {
                 "kind": "expression",
-                "type": "\"circle\" | \"dashboard\" | undefined"
+                "type": "number | undefined"
               }
             },
             {
-              "name": "value",
-              "description": "Текущее значение `0..100`; выходящие за границы клампятся, `NaN` → `0`.",
-              "default": "0",
+              "name": "shape",
+              "description": "Замкнутое кольцо или дуга с вырезом снизу.",
+              "default": "undefined",
               "value": {
                 "kind": "expression",
-                "type": "number | undefined"
+                "type": "\"circle\" | \"dashboard\" | undefined"
               }
             },
             {
@@ -9384,6 +9739,15 @@
                 "type": "string | undefined"
               }
             },
+            {
+              "name": "open",
+              "description": "Открыт ли слой. Поддерживает `v-model:open`; без `overlay` не значит ничего.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "ariaLabel",
               "description": "Имя лендмарка: без него две панели на странице неразличимы.",
@@ -9463,6 +9827,15 @@
                 "kind": "expression",
                 "type": "string | undefined"
               }
+            },
+            {
+              "name": "overlay",
+              "description": "Панель как модальный слой поверх страницы: подложка, `Esc`, ловушка фокуса, блокировка прокрутки. Для узкого экрана, где колонке места нет. Когда включать — решает приложение: своей системы брейкпоинтов у пакета нет, а спрашивать среду в `setup` нельзя — первый клиентский рендер разошёлся бы с серверным и сломал гидрацию.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
             }
           ],
           "slots": [
@@ -9481,6 +9854,9 @@
           ],
           "js": {
             "events": [
+              {
+                "name": "update:open"
+              },
               {
                 "name": "update:collapsed"
               }
@@ -9694,6 +10070,16 @@
               }
             }
           ],
+          "slots": [
+            {
+              "name": "mark",
+              "description": "Подпись деления шкалы. Слот наполняет её узел, а не заменяет: позиция, `aria-hidden` и дублирование значения диктору остаются за компонентом."
+            },
+            {
+              "name": "thumb",
+              "description": "Содержимое бегунка. Слот рендерится **внутрь** ручки, а не вместо неё: на самом узле висят `role=\"slider\"`, `tabindex`, восемь `aria-*` и позиционирование, и отдать его разметке потребителя значит отдать вместе с ним весь виджетный контракт. Вид самой ручки меняется токенами `--gr-slider-thumb-*`."
+            }
+          ],
           "js": {
             "events": [
               {
@@ -10434,12 +10820,56 @@
                 "kind": "expression",
                 "type": "string | undefined"
               }
+            },
+            {
+              "name": "showStateText",
+              "description": "Подпись состояния внутри дорожки — на свободной от бегунка стороне. Помещается только на `md` и `lg`; на мелких ступенях не рисуется.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "checkedText",
+              "description": "Текст включённого состояния. Без него — `gr.switch.on` из локали.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "uncheckedText",
+              "description": "Текст выключенного состояния. Без него — `gr.switch.off` из локали.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "autoWidth",
+              "description": "Дорожка растягивается под подпись, а ступень размера становится нижней границей ширины. Без `showStateText` смысла не имеет: тянуться не под что.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
             }
           ],
           "slots": [
             {
               "name": "default",
               "description": "Подпись переключателя."
+            },
+            {
+              "name": "checked-icon",
+              "description": "Знак на бегунке во включённом состоянии — галочка, замок, что угодно. Размер задаёт обёртка по ступени `size`, поэтому содержимое слота тянется до неё: `class=\"h-full w-full\"`, как у `GrBadge` и `GrChip`. Знак декоративен — бегунок целиком `aria-hidden`, а состояние диктор берёт из `aria-checked`. Смысла, которого нет больше нигде, сюда класть нельзя."
+            },
+            {
+              "name": "unchecked-icon",
+              "description": "То же для выключенного состояния. Слоты независимы."
             }
           ],
           "js": {
@@ -10605,6 +11035,15 @@
                 "type": "number | undefined"
               }
             },
+            {
+              "name": "role",
+              "description": "Роль таблицы. `grid` — интерактивная сетка с клавиатурой по ячейкам (паттерн WAI-ARIA `grid`): она объявляет диктору, что по таблице ходят стрелками, а не читают её как статичную. Роль ставит тот, кто клавиатуру и реализует, — сама по себе она обещание, которое таблица не выполняет.",
+              "default": "\"table\"",
+              "value": {
+                "kind": "expression",
+                "type": "\"grid\" | \"table\" | undefined"
+              }
+            },
             {
               "name": "columnCount",
               "description": "Сколько колонок занимает служебная строка (пустое состояние и скелетоны).",
@@ -10623,6 +11062,24 @@
                 "type": "boolean | undefined"
               }
             },
+            {
+              "name": "rowGroups",
+              "description": "Тело собрано группами строк, и рисует их потребитель: слот по умолчанию встаёт прямо в таблицу, без обёртки в `<tbody>`. Нужно там, где пара строк обязана мериться и жить вместе — второй ярус `GrDataTable` рядом со своей строкой. Обернуть две `<tr>` в таблице больше не во что: группа строк — единственный контейнер, который для них существует.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "stickyColumn",
+              "description": "Прилипающая первая колонка: остаётся видимой при горизонтальном скролле. Только первая, и это не упрощение: `left` со второй колонки равен сумме ширин предыдущих, а ячейки принадлежат потребителю — мерить их «тонкому» контейнеру нечем. Многоколоночное закрепление есть у `GrDataTable`: он знает свои колонки и меряет смещения сам.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "rowCount",
               "description": "Полное число строк набора, включая строки заголовка (`aria-rowcount`). Нужен, когда в DOM не весь набор — например, при виртуализации: диктор считает строки по разметке и объявил бы «5 из 20» на таблице в десять тысяч. Строки при этом обязаны нести `aria-rowindex`.",
@@ -10785,6 +11242,117 @@
             ]
           }
         },
+        {
+          "name": "GrTabsWithPanels",
+          "source": {
+            "module": "@feugene/granularity/components/GrTabsWithPanels",
+            "symbol": "GrTabsWithPanels"
+          },
+          "props": [
+            {
+              "name": "variant",
+              "description": "Вид ряда: обойма с таблетками или ряд с подчёркиванием.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "\"pills\" | \"line\" | undefined"
+              }
+            },
+            {
+              "name": "closable",
+              "description": "Крестик на вкладках и закрытие по `Delete`/`Backspace`. Точечно снимается `closable: false` у самой вкладки.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "size",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
+              }
+            },
+            {
+              "name": "orientation",
+              "description": "Горизонтальный (по умолчанию) или вертикальный список вкладок.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "GrTabsOrientation | undefined"
+              }
+            },
+            {
+              "name": "activationMode",
+              "description": "`automatic` (по умолчанию) — стрелка сразу переключает вкладку; `manual` — стрелка двигает только фокус, выбор подтверждается `Enter`/`Space`. Второй режим для вкладок с тяжёлой загрузкой: перебор стрелками иначе тянет каждую панель.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "GrTabsActivationMode | undefined"
+              }
+            },
+            {
+              "name": "emptyText",
+              "description": "Текст, когда список вкладок пуст. Слот `#empty` сильнее.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "idBase",
+              "description": "База id для ARIA-связки с `GrTabPanels`. Если задана, каждая вкладка получает `id=\"<idBase>-tab-<value>\"` и `aria-controls=\"<idBase>-panel-<value>\"`. Передайте тот же `idBase` в `GrTabPanels`, чтобы связать `tab`↔`tabpanel`.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
+            {
+              "name": "modelValue",
+              "required": true,
+              "value": {
+                "kind": "expression",
+                "type": "string"
+              }
+            },
+            {
+              "name": "tabs",
+              "required": true,
+              "value": {
+                "kind": "expression",
+                "type": "GrTab[]"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "default",
+              "description": "Панели (`GrTabPanel`)."
+            },
+            {
+              "name": "tab",
+              "description": "Содержимое вкладки целиком — уходит в `GrTabs`."
+            },
+            {
+              "name": "empty",
+              "description": "Пустой ряд вкладок — уходит в `GrTabs`."
+            }
+          ],
+          "js": {
+            "events": [
+              {
+                "name": "close"
+              },
+              {
+                "name": "update:modelValue"
+              }
+            ]
+          }
+        },
         {
           "name": "GrTextarea",
           "source": {
@@ -10970,6 +11538,12 @@
               }
             }
           ],
+          "slots": [
+            {
+              "name": "count",
+              "description": "Своя формулировка счётчика символов вместо `12 / 60` — «осталось 48», «почти предел» и что угодно ещё. Встроенных счётчиков два, но оба фиксированы по форме, и вторая готовая формулировка первой не заменяет."
+            }
+          ],
           "js": {
             "events": [
               {
@@ -11136,6 +11710,15 @@
                 "type": "GrToasterPlacement | undefined"
               }
             },
+            {
+              "name": "collapse",
+              "description": "Со скольких видимых тостов стек схлопывается в стопку: колонка занимает место одного тоста, а остальные выглядывают из-под передней. Разворачивается по наведению и по фокусу. `false` — не схлопывать никогда. Порог, а не переключатель: пока тостов мало, колонка читается лучше стопки, и менять её незачем.",
+              "default": "3",
+              "value": {
+                "kind": "expression",
+                "type": "number | false | undefined"
+              }
+            },
             {
               "name": "regionLabel",
               "description": "A11y-лейбл контейнера-региона (i18n).",
@@ -11240,6 +11823,15 @@
                 "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
               }
             },
+            {
+              "name": "block",
+              "description": "Обёртка занимает ширину родителя вместо ширины содержимого. Нужно там, где триггер обязан тянуться: пункт списка, строка меню, ячейка. `inline-flex` по умолчанию схлопнул бы такой триггер по содержимому, и подсветка с кольцом фокуса сжались бы вместе с ним.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "offsetPx",
               "description": "Зазор между триггером и панелью, px.",
@@ -11284,6 +11876,15 @@
                 "kind": "expression",
                 "type": "string | undefined"
               }
+            },
+            {
+              "name": "describeTrigger",
+              "description": "Вешать ли `aria-describedby` на триггер. По умолчанию да. `false` — когда подсказка **дословно повторяет** доступное имя триггера: тогда это не описание, а шум, и диктор произносит подпись дважды. Так устроен свёрнутый `GrSidebarItem`: имя у него уже в `aria-label`.",
+              "default": "true",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
             }
           ],
           "slots": [
@@ -11389,6 +11990,24 @@
                 "type": "((item: TItem, query: string) => boolean) | undefined"
               }
             },
+            {
+              "name": "loading",
+              "description": "Каталог в пути: пустая панель говорит «ищем», а не «ничего не найдено». Проп общий на обе панели, а не свой у каждой: `items` — один каталог, и обе панели его виды, так что пока он едет, пусты обе. Подгрузку запускает потребитель по событию `search`, поэтому и флаг держит он.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "loadingText",
+              "description": "Текст индикатора. Не задан — из локали (`gr.transfer.loading`).",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "string | undefined"
+              }
+            },
             {
               "name": "sortable",
               "description": "Правую панель можно переставлять.",
@@ -11416,6 +12035,15 @@
                 "type": "string | number | undefined"
               }
             },
+            {
+              "name": "virtual",
+              "description": "Держать в DOM только окно строк вокруг вьюпорта. Нужен `maxHeight`: без него панель не прокручивается, окна нет и виртуализировать нечего. Перенос от этого не страдает — он идёт по модели, а не по разметке. А вот перетаскивание указателем ограничено отрисованными строками: навести указатель на то, чего нет на экране, всё равно нечем.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
             {
               "name": "size",
               "default": "undefined",
@@ -11481,6 +12109,10 @@
             {
               "name": "empty",
               "description": "Пустая панель. `filtered` — пусто из-за поиска, а не по сути."
+            },
+            {
+              "name": "loading",
+              "description": "Панель под загрузкой — вместо текста «ищем»."
             }
           ],
           "js": {
@@ -12187,6 +12819,57 @@
                 "type": "boolean | undefined"
               }
             },
+            {
+              "name": "tags",
+              "description": "Чипы выбранных узлов в триггере вместо строки «a, b, c». Работает только вместе с `multiple`: у одиночного выбора чип был бы плашкой на одно значение.",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "maxTagCount",
+              "description": "Сколько чипов показать до сворачивания остатка в «+N». Без него растёт весь набор, а высота триггера за ним не идёт — лишние чипы уходят за край.",
+              "default": "undefined",
+              "value": {
+                "kind": "expression",
+                "type": "number | undefined"
+              }
+            },
+            {
+              "name": "tagTone",
+              "description": "Вид чипов. Чип — это `GrBadge`: своя плашка на светлой теме почти не отличалась бы от фона поля. Имена и шкалы те же, что у `GrSelect`, — переходя с одного компонента на другой, потребитель не переучивается.",
+              "default": "\"neutral\"",
+              "value": {
+                "kind": "expression",
+                "type": "\"primary\" | \"neutral\" | \"success\" | \"warning\" | \"danger\" | \"info\" | \"slate\" | \"azure\" | undefined"
+              }
+            },
+            {
+              "name": "tagDark",
+              "default": "false",
+              "value": {
+                "kind": "expression",
+                "type": "boolean | undefined"
+              }
+            },
+            {
+              "name": "tagSize",
+              "default": "\"sm\"",
+              "value": {
+                "kind": "expression",
+                "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | undefined"
+              }
+            },
+            {
+              "name": "tagRadius",
+              "default": "\"round\"",
+              "value": {
+                "kind": "expression",
+                "type": "GrBadgeRadius | undefined"
+              }
+            },
             {
               "name": "clearable",
               "default": "false",