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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/ui-kit-v2",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",

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

@@ -41,6 +41,11 @@
 **Идентификатор, которого нет, откатывается на первую доступную вкладку.** То же с отключённой:
 активной она стать не может. Так вкладка из старой ссылки не оставляет пустой экран.
 
+**Контрол шапки объявляется `[rtTabsControl]` на `<ng-template>`.** Сторона задаётся значением
+директивы: `rtTabsControl="left"` слева, `[rtTabsControl]="side"` — вычисленной стороной. Без
+значения контрол встаёт справа — пустая строка приводится к правой стороне намеренно, иначе
+`<ng-template rtTabsControl>` не попадал бы ни в один слот и пропадал из шапки вовсе.
+
 ## Клавиатура и доступность
 
 - Стрелки (влево/вправо, а в вертикальной раскладке вверх/вниз) перешагивают отключённые вкладки

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

@@ -43,6 +43,14 @@ this.#notifications.error('Не удалось сохранить', 'danger', {
 - `meta` — приписка над сообщением (номер заявки), `description` — вторая строка под ним.
 - Положение раскладывается на два модификатора: `rt-toaster--y--bottom` и `rt-toaster--x--right`.
 
+## Края
+
+- **Нулевая длительность не значит «висит, пока не закроют».** `duration: 0` — это таймер на
+  ноль миллисекунд: тост гасит себя сразу после первой отрисовки. Держать его открытым умеет
+  только пауза таймера — признак `interacting` либо развёрнутая стопка.
+- **В матрице каждому тосту ставится `[interacting]="true"`.** Иначе ячейки гаснут одна за
+  другой, пока смотришь на показ, и кадр снимается с пустой сетки.
+
 ## Доступность
 
 Стопка — `role="region"` с переведённой подписью, каждый тост — `role="status"` с

package/types/rt-tools-ui-kit-v2.d.ts

@@ -1036,7 +1036,7 @@ declare namespace IButton {
  * ```html
  * <button rtButton label="Войти" theme="primary"></button>
  * <button rtButton label="Скачать" icon="ico-download" theme="success"></button>
- * <button rtButton icon="ico-pencil" theme="info" appearance="text"></button>
+ * <button rtButton icon="pencil" theme="info" appearance="text"></button>
  * <button rtButton label="Сохранение..." [loading]="saving()" [disabled]="saving()"></button>
  * <a rtButton label="Главная" [routerLink]="'/'"></a>
  * ```
@@ -2165,19 +2165,6 @@ declare abstract class RtRouteAsideComponent<T> implements OnInit {
 interface IRtAsideDeactivate {
     canDeactivate(): Observable<boolean>;
 }
-/**
- * Панель с несохранёнными правками спрашивает о них и при смене маршрута, а не
- * только при закрытии: аутлет `ro` занимает соседняя панель, и правки пропали бы
- * молча.
- *
- * Ставится на каждый ro-маршрут: гард висит на кнопках, нажатии мимо и Esc, а
- * смену маршрута ловит только роутер.
- *
- * Панели может не быть: роутер зовёт гард и для маршрута, чей компонент не создан.
- * Спрашивать тогда не о чем — уступить место можно. Без этой проверки первая же
- * такая навигация падает, а следом отказывает любая другая: маршрут остаётся
- * активным, и приложение застревает на адресе панели.
- */
 declare const rtAsideUnsavedGuard: CanDeactivateFn<IRtAsideDeactivate | null>;
 
 /**
@@ -4941,8 +4928,14 @@ declare class RtTabDirective {
 declare class RtTabsControlDirective {
     /** Шаблон контрола, выводимый в header-слоте. */
     readonly templateRef: TemplateRef<unknown>;
-    /** Сторона размещения относительно полосы вкладок. */
-    readonly side: InputSignal<IRtTabs.ControlSide>;
+    /**
+     * Сторона размещения относительно полосы вкладок.
+     *
+     * Пустое значение приводится к правой стороне: `<ng-template rtTabsControl>` без значения
+     * задаёт входу пустую строку, а не умолчание, и такой контрол не попадал ни в левый слот,
+     * ни в правый — он пропадал из шапки вовсе.
+     */
+    readonly side: InputSignalWithTransform<IRtTabs.ControlSide, IRtTabs.ControlSide | ''>;
     static ɵfac: i0.ɵɵFactoryDeclaration<RtTabsControlDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RtTabsControlDirective, "[rtTabsControl]", never, { "side": { "alias": "rtTabsControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }