@rt-tools/ui-kit-v2 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/ui-kit-v2",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",
@@ -19,7 +19,6 @@
     "@angular/forms": "^22.0.0",
     "@angular/platform-browser": "^22.0.0",
     "@angular/router": "^22.0.0",
-    "@jsverse/transloco": "^8.4.0",
     "quill": "^2.0.3",
     "rxjs": "^7.8.2",
     "typescript": "^6.0.0"

package/src/lib/components/CONTEXT.md

@@ -26,7 +26,7 @@ tag/
   `rt-tag--closable`, камелкейс превращается в дефис (`hasIndicator` → `--has-indicator`).
 - **Точки для проверок помечены `qa-dataid`** — по нему компонент находят и спеки, и e2e.
 - **Подписи, которые кит рисует сам**, живут в неймспейсе `rtKit` и приходят через
-  `provideRtKitTranslations()`. Свой текст почти везде перебивает переведённый; пустая строка
+  `provideRtKitLabels()`. Свой текст почти везде перебивает переведённый; пустая строка
   равна отсутствию входа.
 - **Цвета и размеры — только токены `--rt-*`**, ни одного HEX в компонентных стилях.
 

package/src/lib/components/bar-list/CONTEXT.md

@@ -6,11 +6,11 @@
 <rt-bar-list title="Источники" [rows]="[{ id: 'direct', title: 'Прямые заходы', meta: '1 240 визитов', value: '52%', sharePercent: 52 }]" />
 ```
 
-| вход        | тип                                                        | умолчание               |
-| ----------- | ---------------------------------------------------------- | ----------------------- |
-| `rows`      | `ReadonlyArray<{ id, title, meta?, value, sharePercent }>` | **обязателен**          |
-| `title`     | `string`                                                   | `''`                    |
-| `emptyText` | `string`                                                   | `''` → `rtKit.uiNoData` |
+| вход        | тип                                                        | умолчание         |
+| ----------- | ---------------------------------------------------------- | ----------------- |
+| `rows`      | `ReadonlyArray<{ id, title, meta?, value, sharePercent }>` | **обязателен**    |
+| `title`     | `string`                                                   | `''`              |
+| `emptyText` | `string`                                                   | `''` → `uiNoData` |
 
 Выходов нет.
 

package/src/lib/components/button/rt-button.directive.scss

@@ -79,10 +79,14 @@
         cursor: not-allowed;
     }
 
+    /* `flex-shrink: 0` — иконке заданного размера. Без него в кнопке, которой ширину
+       навязали снаружи (пункт меню `rt-split-button` берёт её от панели), лейбл давит
+       на иконку, и та сжимается до нуля: место занято, а иконки не видно. */
     &__icon {
         display: inline-flex;
         width: var(--rt-btn-icon-size);
         height: var(--rt-btn-icon-size);
+        flex-shrink: 0;
         align-items: center;
         justify-content: center;
         font-size: var(--rt-btn-icon-size);

package/src/lib/components/checkbox/rt-checkbox.component.scss

@@ -44,8 +44,12 @@ rt-checkbox .rt-checkbox {
             border-color var(--rt-duration-fast) ease;
     }
 
-    &--checked &__box,
-    &--indeterminate &__box {
+    /* Элемент адресуется классом, а не вторым `&`: родитель здесь составной
+       (`rt-checkbox .rt-checkbox`), и второй `&` развернулся бы в него целиком —
+       `… .rt-checkbox--checked rt-checkbox .rt-checkbox__box`, то есть в селектор,
+       требующий вложенного чекбокса. Заливка отмеченного из-за этого не применялась. */
+    &--checked .rt-checkbox__box,
+    &--indeterminate .rt-checkbox__box {
         border-color: var(--rt-color-action-primary);
         background: var(--rt-color-action-primary);
     }

package/src/lib/components/confirm-popover/CONTEXT.md

@@ -13,14 +13,14 @@
     (confirmed)="reject()" />
 ```
 
-| вход (алиас)           | тип                                  | умолчание                |
-| ---------------------- | ------------------------------------ | ------------------------ |
-| `rtConfirm`            | `string`                             | `''`                     |
-| `rtConfirmTitle`       | `string \| null`                     | `null`                   |
-| `rtConfirmLabel`       | `string`                             | `''` → `rtKit.uiConfirm` |
-| `rtConfirmCancelLabel` | `string`                             | `''` → `rtKit.uiCancel`  |
-| `rtConfirmTone`        | `'danger' \| 'warning' \| 'primary'` | `'danger'`               |
-| `rtConfirmDisabled`    | `boolean`                            | `false`                  |
+| вход (алиас)           | тип                                  | умолчание          |
+| ---------------------- | ------------------------------------ | ------------------ |
+| `rtConfirm`            | `string`                             | `''`               |
+| `rtConfirmTitle`       | `string \| null`                     | `null`             |
+| `rtConfirmLabel`       | `string`                             | `''` → `uiConfirm` |
+| `rtConfirmCancelLabel` | `string`                             | `''` → `uiCancel`  |
+| `rtConfirmTone`        | `'danger' \| 'warning' \| 'primary'` | `'danger'`         |
+| `rtConfirmDisabled`    | `boolean`                            | `false`            |
 
 | выход       | тип    |
 | ----------- | ------ |

package/src/lib/components/container/CONTEXT.md

@@ -36,6 +36,28 @@
 **Стопка уведомлений встроена в каркас** (`rt-toaster` внизу по центру): заводить её отдельно
 не нужно.
 
+## Уход с route-панели
+
+Панель, живущая на своём маршруте (`RtRouteAsideComponent` + `rtAsideUnsavedGuard` на
+ro-маршруте), уступает место навигацией, и о несохранённых правках её спрашивает роутер.
+
+**Гард спрашивает панель, учтённую под маршрутом ухода, а не компонент, который ему подставил
+роутер.** Когда ro-маршрут объявлен под уровнем без своего компонента — тем, что держит одни
+`providers` для ветки, — Angular отдаёт детям контекст родителя, и в гард приходит компонент
+первичного аутлета. Учёт ведёт `RtRouteAsideRegistry`: панель встаёт в него, когда занимает
+аутлет, и снимается при уничтожении. Наружу кита учёт не выведен — приложению он не нужен.
+
+**Компонент от роутера остаётся запасным путём.** Панель приложения может отвечать о правках,
+не наследуя `RtRouteAsideComponent`: гард спросит её, если под маршрутом никто не учтён и метод
+у компонента есть.
+
+**Уход, начатый самой панелью, о правках не спрашивает.** Разрешение выдаётся вплотную к вызову
+роутера, действует на один уход и снимается, если навигация не состоялась. Поэтому закрытие
+после удачной записи не открывает окно про то, что уже сохранено.
+
+**Отказом навигации гард не отвечает никогда.** Упавший ответ панели отменяет один уход и
+снимает панель с учёта: приложение не запирается на адресе панели.
+
 ## Рядом
 
 - [`rt-toaster`](../toast/CONTEXT.md) — та самая стопка.

package/src/lib/components/dialog/footer/rt-dialog-footer.component.scss

@@ -1,13 +1,24 @@
-/* rt-dialog-footer — footer-слот модалки. ViewEncapsulation.None. */
+/* rt-dialog-footer — footer-слот модалки. ViewEncapsulation.None.
 
-.rt-dialog-footer {
-    display: flex;
-    justify-content: flex-end;
-    padding: var(--rt-space-lg);
-    border-block-start: 1px solid var(--rt-color-border-subtle);
-    gap: var(--rt-space-sm);
+   Хост адресуется по имени элемента, а не по классу блока: класс
+   `.rt-dialog-footer` висит и на `<rt-dialog-footer>`, и на `<footer>` внутри
+   него. Правило на голом классе доставалось обоим — кнопки прижимались к правому
+   краю не окна, а строки по содержимому, и разделитель рисовался дважды. Заодно
+   `:empty` теперь спрашивается у `<footer>`, а не у хоста: у хоста внутри всегда
+   лежит `<footer>`, и пустым он не бывал никогда. */
 
-    &:empty {
-        display: none;
+rt-dialog-footer {
+    display: contents;
+
+    .rt-dialog-footer {
+        display: flex;
+        justify-content: flex-end;
+        padding: var(--rt-space-lg);
+        border-block-start: 1px solid var(--rt-color-border-subtle);
+        gap: var(--rt-space-sm);
+
+        &:empty {
+            display: none;
+        }
     }
 }

package/src/lib/components/dialog/header/rt-dialog-header.component.scss

@@ -1,21 +1,33 @@
 /* rt-dialog-header — заголовок модалки. ViewEncapsulation.None.
-   Селекторы префиксованы `.rt-dialog-header`. */
+   Селекторы префиксованы `.rt-dialog-header`.
 
-.rt-dialog-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: var(--rt-space-lg);
-    border-block-end: 1px solid var(--rt-color-border-subtle);
-    gap: var(--rt-space-sm);
+   Хост адресуется по имени элемента, а не по классу блока: класс
+   `.rt-dialog-header` висит и на `<rt-dialog-header>`, и на `<header>` внутри
+   него. Правило на голом классе доставалось обоим — хост становился flex-строкой,
+   а `<header>` внутри неё сжимался по содержимому: заголовок и крестик стояли
+   вплотную вместо краёв окна, и разделитель рисовался дважды, двумя линиями
+   разной длины. Хост боксом не становится: строка шапки должна быть прямым
+   flex-ребёнком рамки окна. */
 
-    &__title {
-        margin: 0;
-        color: var(--rt-color-text-primary);
-        font-size: var(--rt-text-xl);
-    }
+rt-dialog-header {
+    display: contents;
+
+    .rt-dialog-header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: var(--rt-space-lg);
+        border-block-end: 1px solid var(--rt-color-border-subtle);
+        gap: var(--rt-space-sm);
+
+        &__title {
+            margin: 0;
+            color: var(--rt-color-text-primary);
+            font-size: var(--rt-text-xl);
+        }
 
-    &__close {
-        margin-inline-start: auto;
+        &__close {
+            margin-inline-start: auto;
+        }
     }
 }

package/src/lib/components/download-link/CONTEXT.md

@@ -21,6 +21,6 @@
 ## Как этим пользоваться
 
 - Подпись для скринридера собирается из переведённой формулировки и имени файла
-  (`rtKit.uiDownloadFile` с подстановкой `{{name}}`) — на экране видно имя, а вслух читается
+  (`uiDownloadFile` с подстановкой `{{name}}`) — на экране видно имя, а вслух читается
   «Download: Договор.pdf».
 - Для перечня вложений есть [`rt-file-list`](../file-list/CONTEXT.md); эта кнопка — одиночная.

package/src/lib/components/download-link/rt-download-link.component.scss

@@ -14,6 +14,19 @@
         font-weight: var(--rt-font-weight-medium);
         gap: var(--rt-space-sm);
         line-height: var(--rt-leading-snug);
+
+        &:hover {
+            text-decoration: underline;
+        }
+
+        /* Своей рамки у кнопки нет — она нарисована как ссылка, и умолчательный контур
+           браузер снимает вместе с рамкой. Без этого правила место фокуса с клавиатуры
+           не видно вовсе: кнопка выглядит одинаково выбранной и невыбранной. */
+        &:focus-visible {
+            border-radius: var(--rt-radius-sm);
+            box-shadow: var(--rt-shadow-focus-ring);
+            outline: none;
+        }
     }
 
     &__icon {

package/src/lib/components/file-drop/CONTEXT.md

@@ -9,12 +9,12 @@
 </rt-file-drop>
 ```
 
-| вход           | тип               | умолчание                        |
-| -------------- | ----------------- | -------------------------------- |
-| `disabled`     | `boolean`         | `false`                          |
-| `overlayLabel` | `string`          | `''` → `rtKit.uiFileDropOverlay` |
-| `zones`        | `readonly Zone[]` | `[]`                             |
-| `accept`       | `string`          | `''`                             |
+| вход           | тип               | умолчание                  |
+| -------------- | ----------------- | -------------------------- |
+| `disabled`     | `boolean`         | `false`                    |
+| `overlayLabel` | `string`          | `''` → `uiFileDropOverlay` |
+| `zones`        | `readonly Zone[]` | `[]`                       |
+| `accept`       | `string`          | `''`                       |
 
 Выходы: `filesDropped` (`File[]`), `zoneFilesDropped` (`{ zoneId, files }`), `draggingChange`.
 

package/src/lib/components/file-input/CONTEXT.md

@@ -10,12 +10,12 @@
 
 Свои входы поверх общих из [`RtFormControlBase`](../form-control/CONTEXT.md):
 
-| вход          | тип              | умолчание                   |
-| ------------- | ---------------- | --------------------------- |
-| `multiple`    | `boolean`        | `false`                     |
-| `accept`      | `string \| null` | `null`                      |
-| `directory`   | `boolean`        | `false`                     |
-| `buttonLabel` | `string`         | `''` → `rtKit.uiChooseFile` |
+| вход          | тип              | умолчание             |
+| ------------- | ---------------- | --------------------- |
+| `multiple`    | `boolean`        | `false`               |
+| `accept`      | `string \| null` | `null`                |
+| `directory`   | `boolean`        | `false`               |
+| `buttonLabel` | `string`         | `''` → `uiChooseFile` |
 
 Значение — `File[]`.
 

package/src/lib/components/live-badge/CONTEXT.md

@@ -4,11 +4,11 @@
 <rt-live-badge label="Смотрят сейчас" [count]="visitors()" [active]="streamAlive()" />
 ```
 
-| вход     | тип              | умолчание                                |
-| -------- | ---------------- | ---------------------------------------- |
-| `label`  | `string`         | `''` → переведённое `rtKit.uiLiveOnSite` |
-| `count`  | `number \| null` | `null` → прочерк `—`                     |
-| `active` | `boolean`        | `false`                                  |
+| вход     | тип              | умолчание                          |
+| -------- | ---------------- | ---------------------------------- |
+| `label`  | `string`         | `''` → переведённое `uiLiveOnSite` |
+| `count`  | `number \| null` | `null` → прочерк `—`               |
+| `active` | `boolean`        | `false`                            |
 
 Выходов нет.
 

package/src/lib/components/menu/CONTEXT.md

@@ -17,12 +17,12 @@
 
 ## `rt-menu`
 
-| вход        | тип                | умолчание                |
-| ----------- | ------------------ | ------------------------ |
-| `icon`      | `IRtIcon.Name`     | `'ellipsis-h'`           |
-| `ariaLabel` | `string`           | `''` → `rtKit.uiActions` |
-| `align`     | `'start' \| 'end'` | `'end'`                  |
-| `disabled`  | `boolean`          | `false`                  |
+| вход        | тип                | умолчание          |
+| ----------- | ------------------ | ------------------ |
+| `icon`      | `IRtIcon.Name`     | `'ellipsis-h'`     |
+| `ariaLabel` | `string`           | `''` → `uiActions` |
+| `align`     | `'start' \| 'end'` | `'end'`            |
+| `disabled`  | `boolean`          | `false`            |
 
 ## `rt-menu-item`
 

package/src/lib/components/message-composer/CONTEXT.md

@@ -11,16 +11,16 @@
     (submitted)="send($event)" />
 ```
 
-| вход                   | тип                    | умолчание                      |
-| ---------------------- | ---------------------- | ------------------------------ |
-| `placeholder`          | `string`               | `''` → `rtKit.chatPlaceholder` |
-| `attachments`          | `boolean`              | `false`                        |
-| `accept`               | `string`               | `''`                           |
-| `sending` / `disabled` | `boolean`              | `false`                        |
-| `formatting`           | `boolean`              | `false`                        |
-| `toolbar`              | `IRtRichEditorToolbar` | `'full'`                       |
-| `minRows` / `maxRows`  | `number`               | 1 / 6                          |
-| `droppedFiles`         | `File[] \| null`       | `null`                         |
+| вход                   | тип                    | умолчание                |
+| ---------------------- | ---------------------- | ------------------------ |
+| `placeholder`          | `string`               | `''` → `chatPlaceholder` |
+| `attachments`          | `boolean`              | `false`                  |
+| `accept`               | `string`               | `''`                     |
+| `sending` / `disabled` | `boolean`              | `false`                  |
+| `formatting`           | `boolean`              | `false`                  |
+| `toolbar`              | `IRtRichEditorToolbar` | `'full'`                 |
+| `minRows` / `maxRows`  | `number`               | 1 / 6                    |
+| `droppedFiles`         | `File[] \| null`       | `null`                   |
 
 Выход: `submitted` — `{ text, delta?, files }`.
 

package/src/lib/components/multiselect/CONTEXT.md

@@ -8,11 +8,11 @@
 
 Свои входы поверх общих из [`RtFormControlBase`](../form-control/CONTEXT.md):
 
-| вход          | тип                                                                          | умолчание                     |
-| ------------- | ---------------------------------------------------------------------------- | ----------------------------- |
-| `options`     | `ReadonlyArray<{ label, value, disabled? }>` (тот же тип, что у `rt-select`) | `[]`                          |
-| `placeholder` | `string`                                                                     | `''` → `rtKit.uiSelectValues` |
-| `maxChips`    | `number`                                                                     | `3`                           |
+| вход          | тип                                                                          | умолчание               |
+| ------------- | ---------------------------------------------------------------------------- | ----------------------- |
+| `options`     | `ReadonlyArray<{ label, value, disabled? }>` (тот же тип, что у `rt-select`) | `[]`                    |
+| `placeholder` | `string`                                                                     | `''` → `uiSelectValues` |
+| `maxChips`    | `number`                                                                     | `3`                     |
 
 Значение — `ReadonlyArray<TValue>`. Отдельного выхода выбора нет: значение едет только формой.
 
@@ -31,7 +31,7 @@
 - Закрытие панели помечает контрол тронутым; `FormControl.disable()` закрывает раскрытую панель.
 - Подпись фишки берётся из `options` пайпом `rtMultiselectLabel`; для значения вне набора
   подставляется его строковое представление.
-- Отключённые опции не выбираются, пустой набор даёт `rtKit.uiNoOptions`.
+- Отключённые опции не выбираются, пустой набор даёт `uiNoOptions`.
 
 ## Клавиатура
 

package/src/lib/components/night-grid/CONTEXT.md

@@ -6,10 +6,10 @@
 <rt-night-grid ariaLabel="Ночи марта" [cells]="cells()" (cellClick)="toggle($event)" />
 ```
 
-| вход        | тип                                   | умолчание                      |
-| ----------- | ------------------------------------- | ------------------------------ |
-| `cells`     | `ReadonlyArray<{ id, state, title }>` | **обязателен**                 |
-| `ariaLabel` | `string`                              | `''` → `rtKit.uiNightGridAria` |
+| вход        | тип                                   | умолчание                |
+| ----------- | ------------------------------------- | ------------------------ |
+| `cells`     | `ReadonlyArray<{ id, state, title }>` | **обязателен**           |
+| `ariaLabel` | `string`                              | `''` → `uiNightGridAria` |
 
 Выход: `cellClick` — отдаёт **целую клетку**, а не идентификатор.
 

package/src/lib/components/page-header/CONTEXT.md

@@ -6,13 +6,13 @@
 <rt-page-header ariaLabel="Разделы" [items]="sections()" [user]="user()" (itemClick)="go($event)" (userClick)="openProfile()" />
 ```
 
-| вход        | тип                         | умолчание                |
-| ----------- | --------------------------- | ------------------------ |
-| `items`     | `ReadonlyArray<Item>`       | `[]`                     |
-| `user`      | `{ name, avatar? } \| null` | `null`                   |
-| `userTitle` | `string`                    | `''`                     |
-| `userMenu`  | `TemplateRef \| null`       | `null`                   |
-| `ariaLabel` | `string`                    | `''` → `rtKit.uiMainNav` |
+| вход        | тип                         | умолчание          |
+| ----------- | --------------------------- | ------------------ |
+| `items`     | `ReadonlyArray<Item>`       | `[]`               |
+| `user`      | `{ name, avatar? } \| null` | `null`             |
+| `userTitle` | `string`                    | `''`               |
+| `userMenu`  | `TemplateRef \| null`       | `null`             |
+| `ariaLabel` | `string`                    | `''` → `uiMainNav` |
 
 Выходы: `itemClick`, `userClick`.
 

package/src/lib/components/pagination/CONTEXT.md

@@ -38,6 +38,6 @@
 - Узкая и широкая разметки живут в DOM **одновременно** (`pagination-compact` и
   `pagination-nav`): какую показать, решает медиазапрос, а не условная отрисовка.
 - **У пустого набора нет своего вида строки диапазона — бар при нём спрятан целиком.** Ветка на
-  `rtKit.uiRangeEmpty` тут была, но показать её не могло ничто: правило видимости прячет бар
+  `uiRangeEmpty` тут была, но показать её не могло ничто: правило видимости прячет бар
   раньше. Сам ключ в словаре остался (он часть публичного `rtKit`), но кит его больше не читает.
   Про пустоту говорит [`rt-empty-state`](../empty-state/CONTEXT.md), а не пагинация.

package/src/lib/components/select/CONTEXT.md

@@ -8,13 +8,13 @@
 
 Свои входы поверх общих из [`RtFormControlBase`](../form-control/CONTEXT.md):
 
-| вход                | тип                                          | умолчание               |
-| ------------------- | -------------------------------------------- | ----------------------- |
-| `options`           | `ReadonlyArray<{ label, value, disabled? }>` | `[]`                    |
-| `placeholder`       | `string`                                     | `''`                    |
-| `iconLeft`          | `IRtIcon.Name \| null`                       | `null`                  |
-| `filter`            | `boolean`                                    | `false`                 |
-| `filterPlaceholder` | `string`                                     | `''` → `rtKit.uiSearch` |
+| вход                | тип                                          | умолчание         |
+| ------------------- | -------------------------------------------- | ----------------- |
+| `options`           | `ReadonlyArray<{ label, value, disabled? }>` | `[]`              |
+| `placeholder`       | `string`                                     | `''`              |
+| `iconLeft`          | `IRtIcon.Name \| null`                       | `null`            |
+| `filter`            | `boolean`                                    | `false`           |
+| `filterPlaceholder` | `string`                                     | `''` → `uiSearch` |
 
 | выход             | тип              |
 | ----------------- | ---------------- |
@@ -45,7 +45,7 @@
 - Закрытие списка помечает контрол тронутым и сбрасывает строку фильтра.
 - `FormControl.disable()` **закрывает уже раскрытый** список — иначе панель висела бы над
   контролом, которым уже нельзя пользоваться.
-- Пустой набор опций рисует строку `rtKit.uiNoOptions`.
+- Пустой набор опций рисует строку `uiNoOptions`.
 - Ширина панели равна ширине триггера (`rtPopoverWidth="trigger"`).
 
 ## Рядом

package/src/lib/components/split-button/CONTEXT.md

@@ -11,13 +11,13 @@
     (itemSelect)="run($event)" />
 ```
 
-| вход                   | тип                                             | умолчание                    |
-| ---------------------- | ----------------------------------------------- | ---------------------------- |
-| `label`                | `string`                                        | **обязателен**               |
-| `menuItems`            | `readonly { value, label, icon?, disabled? }[]` | **обязателен**               |
-| `theme` / `size`       | как у [`[rtButton]`](../button/CONTEXT.md)      | `'primary'` / `'md'`         |
-| `menuAriaLabel`        | `string`                                        | `''` → `rtKit.uiMoreActions` |
-| `loading` / `disabled` | `boolean`                                       | `false`                      |
+| вход                   | тип                                             | умолчание              |
+| ---------------------- | ----------------------------------------------- | ---------------------- |
+| `label`                | `string`                                        | **обязателен**         |
+| `menuItems`            | `readonly { value, label, icon?, disabled? }[]` | **обязателен**         |
+| `theme` / `size`       | как у [`[rtButton]`](../button/CONTEXT.md)      | `'primary'` / `'md'`   |
+| `menuAriaLabel`        | `string`                                        | `''` → `uiMoreActions` |
+| `loading` / `disabled` | `boolean`                                       | `false`                |
 
 Выходы: `faceClick`, `itemSelect` (значение пункта).
 

package/src/lib/components/split-button/rt-split-button.component.scss

@@ -57,8 +57,21 @@
         list-style: none;
     }
 
+    /* Ширину пункту задаёт панель, а не его текст: `width="trigger"` держит её равной
+       кнопке. Пункт длиннее обязан обрезаться, иначе лейбл вылезает за скруглённую
+       рамку панели и висит в воздухе. Многоточие требует блочного лейбла: у
+       `inline-flex` `text-overflow` не работает — текст внутри становится анонимным
+       flex-элементом, и обрезка проходит без знака. */
     &__menu-item.rt-button {
+        overflow: hidden;
         width: 100%;
         justify-content: flex-start;
+
+        .rt-button__label {
+            display: block;
+            overflow: hidden;
+            min-width: 0;
+            text-overflow: ellipsis;
+        }
     }
 }

package/src/lib/components/stat-tile/CONTEXT.md

@@ -29,7 +29,7 @@
 Знак и стрелка выводятся из числа: `> 0` — «+» и стрелка вверх, `< 0` — стрелка вниз. Дробная
 часть отделяется запятой.
 
-**Значение базы уходит параметром перевода, а не подставляется в готовую строку.** Transloco
+**Значение базы уходит параметром подписи, а не подставляется в готовую строку.** Переводчик приложения
 интерполирует `{{value}}` в момент перевода, и к возвращённой строке подставлять уже нечего:
 `String.replace` после `translateSignal` не находил плейсхолдера, и от подписи оставалась одна
 приставка («было», «was»). Параметр передан сигналом — смена базы переписывает строку.

package/src/lib/components/table/CONTEXT.md

@@ -47,7 +47,7 @@
 
 ## Края
 
-- Пустой набор рисует заглушку с переведённым `rtKit.uiNoData`; свой текст перебивает её.
+- Пустой набор рисует заглушку с переведённым `uiNoData`; свой текст перебивает её.
 - Колонка `rtRowActions` добавляется китом сама, когда включён `showRowActions`, и рисует
   [`rt-menu`](../menu/CONTEXT.md) в строке.
 - Спеки логики лежат рядом: сортировка и предикат действий строки проверены отдельно.

package/src/lib/components/table/sort-header/CONTEXT.md

@@ -0,0 +1,40 @@
+# `rt-table-sort-header`
+
+Заголовок сортируемой колонки. Ставится атрибутом на ячейку шапки таблицы, а ключ колонки —
+тот же, что в `cdkColumnDef` и в `[columnsConfig]`.
+
+```html
+<th *cdkHeaderCellDef cdk-header-cell rtSortHeader="checkIn">Заезд</th>
+```
+
+| вход           | тип      | умолчание    |
+| -------------- | -------- | ------------ |
+| `rtSortHeader` | `string` | обязательный |
+
+## Главное, что нужно знать
+
+**Сортируемость объявляет таблица, а не заголовок.** Колонка получает кнопку только когда
+помечена `sortable` в `[columnsConfig]`; иначе заголовок остаётся обычной подписью, и лишнего
+элемента управления в шапке не появляется.
+
+**Направление читается с самой ячейки.** `aria-sort` стоит на `<th>`, а не на кнопке внутри:
+скринридер объявляет порядок вместе с колонкой. Глазами то же самое показывает стрелка — обе
+стрелки без сортировки, одна выбранная при ней.
+
+**Порядок ходит по кругу из трёх состояний:** по возрастанию → по убыванию → без сортировки.
+Третье нужно, чтобы вернуть исходный порядок, не перезагружая список.
+
+**Подпись проецируется внутрь кнопки** и служит её доступным именем — отдельного `aria-label`
+у кнопки нет и не должно быть.
+
+## Края
+
+- Блок BEM объявлен в шаблоне, а не только классом на хосте: `rtElem` внутри требует блока в
+  своём инжекторе, и без него компонент не поднимался вовсе — потребитель получал `NG0201`.
+- Сортировка по соседней колонке эту не помечает: `aria-sort` у неё остаётся `none`, а стрелка
+  возвращается к нейтральной.
+
+## Рядом
+
+- [`rt-table`](../CONTEXT.md) — таблица, у которой заголовок спрашивает порядок и которой
+  сообщает о нажатии.

package/src/lib/components/tabs/CONTEXT.md

@@ -23,15 +23,15 @@
 
 ## `[rtTab]`
 
-| вход                              | тип                                           | умолчание                   |
-| --------------------------------- | --------------------------------------------- | --------------------------- |
-| `rtTab`                           | `IRtTabs.Id` — идентификатор вкладки          | `''`                        |
-| `label`                           | `string`                                      | `''`                        |
-| `titleTemplate`                   | `TemplateRef \| null`                         | `null`                      |
-| `icon` / `iconColor`              | `IRtIcon.Name \| null` / `IRtTabs.TitleColor` | `null` / `'current'`        |
-| `badge`                           | `string \| number \| null`                    | `null`                      |
-| `disabled` / `hidden` / `invalid` | `boolean`                                     | `false`                     |
-| `invalidMessage`                  | `string`                                      | `''` → `rtKit.uiTabInvalid` |
+| вход                              | тип                                           | умолчание             |
+| --------------------------------- | --------------------------------------------- | --------------------- |
+| `rtTab`                           | `IRtTabs.Id` — идентификатор вкладки          | `''`                  |
+| `label`                           | `string`                                      | `''`                  |
+| `titleTemplate`                   | `TemplateRef \| null`                         | `null`                |
+| `icon` / `iconColor`              | `IRtIcon.Name \| null` / `IRtTabs.TitleColor` | `null` / `'current'`  |
+| `badge`                           | `string \| number \| null`                    | `null`                |
+| `disabled` / `hidden` / `invalid` | `boolean`                                     | `false`               |
+| `invalidMessage`                  | `string`                                      | `''` → `uiTabInvalid` |
 
 ## Главное, что нужно знать
 
@@ -41,6 +41,11 @@
 **Идентификатор, которого нет, откатывается на первую доступную вкладку.** То же с отключённой:
 активной она стать не может. Так вкладка из старой ссылки не оставляет пустой экран.
 
+**Контрол шапки объявляется `[rtTabsControl]` на `<ng-template>`.** Сторона задаётся значением
+директивы: `rtTabsControl="left"` слева, `[rtTabsControl]="side"` — вычисленной стороной. Без
+значения контрол встаёт справа — пустая строка приводится к правой стороне намеренно, иначе
+`<ng-template rtTabsControl>` не попадал бы ни в один слот и пропадал из шапки вовсе.
+
 ## Клавиатура и доступность
 
 - Стрелки (влево/вправо, а в вертикальной раскладке вверх/вниз) перешагивают отключённые вкладки