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

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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InputSignal, WritableSignal, Renderer2, InjectionToken, Signal, InputSignalWithTransform, EnvironmentProviders, OutputEmitterRef, OnInit, OnDestroy, TemplateRef, ElementRef, AfterViewInit, DestroyRef, AfterContentInit, PipeTransform, ModelSignal } from '@angular/core';
+import { InputSignal, WritableSignal, Renderer2, InjectionToken, Signal, EnvironmentProviders, InputSignalWithTransform, OutputEmitterRef, OnInit, OnDestroy, TemplateRef, ElementRef, AfterViewInit, DestroyRef, AfterContentInit, PipeTransform, ModelSignal } from '@angular/core';
 import { OverlayRef, ComponentType, ConnectedPosition } from '@angular/cdk/overlay';
 import { Observable, MonoTypeOperatorFunction } from 'rxjs';
 import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
@@ -191,6 +191,262 @@ declare class RtAsideService {
  */
 declare const RT_ASIDE_DATA: InjectionToken<unknown>;
 
+/**
+ * Английские подписи кита — умолчание, а не локализация.
+ *
+ * Кит рисует часть текста сам: кнопки диалогов, тексты ошибок поля, расшифровки
+ * иконок для скринридера. Своего языка у него нет и быть не может — его знает
+ * приложение и отдаёт функцией-переводчиком (`provideRtKitLabels`). Этот набор
+ * стоит под ней умолчанием, чтобы кит без единой настройки не рисовал пустоты:
+ * среди ключей много `aria`-подписей, и пустая там означает кнопку без имени
+ * для скринридера.
+ *
+ * Набор задаёт и **перечень ключей**: `RtKitLabelKey` выводится отсюда, поэтому
+ * опечатка в ключе не доживает до рантайма.
+ *
+ * Места вида `{{name}}` заполняются параметрами — их принимает `rtKitLabel()`.
+ */
+declare const RT_KIT_LABELS_EN: {
+    readonly bottomSheetClose: "Close";
+    readonly chatAttachAria: "Attach a file";
+    readonly chatAttachTooltip: "Attach a file";
+    readonly chatAttachmentFallback: "Attachment";
+    readonly chatCollapse: "Collapse chat";
+    readonly chatComposerAria: "Message input";
+    readonly chatDeleteAria: "Delete message";
+    readonly chatDeleteTooltip: "Delete";
+    readonly chatDropOverlay: "Drop the files to attach them to your message";
+    readonly chatEmptyHint: "Chat is not available yet.";
+    readonly chatEmptyThread: "No messages yet.";
+    readonly chatExpand: "Expand chat to full screen";
+    readonly chatMessageDeleted: "Message deleted";
+    readonly chatPlaceholder: "Type a message";
+    readonly chatRefreshAria: "Refresh messages";
+    readonly chatRefreshTooltip: "Refresh messages";
+    readonly chatRetryAria: "Send again";
+    readonly chatRetryTooltip: "Retry";
+    readonly chatSendAria: "Send message";
+    readonly chatSendLabel: "Send";
+    readonly chatStatusFailed: "Not sent";
+    readonly chatStatusRead: "Read";
+    readonly chatStatusSending: "Sending";
+    readonly chatStatusSent: "Delivered";
+    readonly chatTitle: "Chat";
+    readonly counterDecrease: "Decrease";
+    readonly counterIncrease: "Increase";
+    readonly fieldErrorEmail: "Invalid email";
+    readonly fieldErrorMax: "Value is too large";
+    readonly fieldErrorMaxLength: "Value is too long";
+    readonly fieldErrorMin: "Value is too small";
+    readonly fieldErrorMinLength: "Value is too short";
+    readonly fieldErrorPattern: "Invalid format";
+    readonly fieldErrorRequired: "Required field";
+    readonly photoViewerClose: "Close viewer";
+    readonly photoViewerNext: "Next photo";
+    readonly photoViewerPrev: "Previous photo";
+    readonly themeToggleLabel: "Switch theme";
+    readonly uiActions: "Actions";
+    readonly uiAuditEmptyHint: "Deal events will appear here — stage changes and other actions.";
+    readonly uiBack: "Back";
+    readonly uiBackToList: "Back to list";
+    readonly uiBaseline: "was {{value}}";
+    readonly uiCancel: "Cancel";
+    readonly uiChangeAgent: "Change agent";
+    readonly uiChooseFile: "Choose file";
+    readonly uiClear: "Clear";
+    readonly uiClose: "Close";
+    readonly uiCollapse: "Collapse";
+    readonly uiColumnLocked: "Column is pinned";
+    readonly uiColumnSettings: "Column settings";
+    readonly uiColumnSettingsTitle: "Configure columns";
+    readonly uiCommentOptional: "Comment (optional)";
+    readonly uiConfirm: "Confirm";
+    readonly uiConfirmAction: "Confirm action";
+    readonly uiContinue: "Continue";
+    readonly uiCopied: "Copied";
+    readonly uiCopy: "Copy";
+    readonly uiCurrentStage: "Current stage";
+    readonly uiDetails: "Details";
+    readonly uiDownload: "Download";
+    readonly uiDownloadFile: "Download: {{name}}";
+    readonly uiDragColumn: "Drag column";
+    readonly uiFileDropOverlay: "Drop the files to attach them";
+    readonly uiFilters: "Filters";
+    readonly uiForward: "Forward";
+    readonly uiHide: "Hide";
+    readonly uiHideColumn: "Hide column";
+    readonly uiHidePassword: "Hide password";
+    readonly uiHint: "Hint";
+    readonly uiHistory: "History";
+    readonly uiInviteUser: "Invite user";
+    readonly uiItemsPerPage: "Items per page";
+    readonly uiLiveOnSite: "On the site now";
+    readonly uiLoadMore: "Load more";
+    readonly uiMainNav: "Main navigation";
+    readonly uiMore: "More";
+    readonly uiMoreActions: "More actions";
+    readonly uiMoveStage: "Move";
+    readonly uiMoveStageAria: "Move stage";
+    readonly uiNavMenu: "Navigation menu";
+    readonly uiNavUnread: "Unread";
+    readonly uiNextPage: "Next page";
+    readonly uiNightGridAria: "Occupancy grid";
+    readonly uiNoData: "No data yet";
+    readonly uiNoOptions: "No options";
+    readonly uiNoRows: "No data";
+    readonly uiNothingFound: "Nothing found";
+    readonly uiNotifications: "Notifications";
+    readonly uiPageOf: "Page {{page}} of {{last}}";
+    readonly uiPagination: "Pagination";
+    readonly uiPerPage: "Per page:";
+    readonly uiPickAgent: "Select an agent";
+    readonly uiPickAnotherAgent: "Select a different agent";
+    readonly uiPickTransition: "Select a transition";
+    readonly uiPrevPage: "Previous page";
+    readonly uiProfile: "Profile";
+    readonly uiRangeEmpty: "0 of 0";
+    readonly uiRangeOf: "{{from}}–{{to}} of {{total}}";
+    readonly uiRemove: "Delete";
+    readonly uiRename: "Rename";
+    readonly uiReplace: "Replace";
+    readonly uiReplaceAgentTitle: "Replace agent";
+    readonly uiResetDefaults: "Reset to defaults";
+    readonly uiResizeDetails: "Resize details pane";
+    readonly uiResizeList: "Resize list pane";
+    readonly uiRevert: "Revert";
+    readonly uiSave: "Save";
+    readonly uiSaveNewAgent: "Save the new agent";
+    readonly uiSearch: "Search";
+    readonly uiSectionInProgress: "{{label}} — section under development";
+    readonly uiSelectValues: "Select values";
+    readonly uiShow: "Show";
+    readonly uiShowColumn: "Show column";
+    readonly uiShowDetails: "Show details";
+    readonly uiShowPassword: "Show password";
+    readonly uiStageNoteHint: "Internal note — the client will not see it.";
+    readonly uiStageTransition: "Stage transition";
+    readonly uiSubscribeNotifications: "Subscribe to notifications";
+    readonly uiTabInvalid: "This tab contains errors";
+    readonly uiTargetStage: "Target stage";
+    readonly uiTargetStageRequired: "Select a target stage.";
+    readonly uiThreadListEmptyHint: "New threads will appear here.";
+    readonly uiToList: "To list";
+    readonly uiUnsavedDiscard: "Close without saving";
+    readonly uiUnsavedMessage: "The panel has edits that have not been saved yet. Choose what to do with them.";
+    readonly uiUnsavedSave: "Save and close";
+    readonly uiUnsavedStay: "Stay";
+    readonly uiUnsavedTitle: "Unsaved changes";
+    readonly uiWelcomeAria: "Welcome message for a new user";
+    readonly uiYearOverYear: "YoY";
+};
+
+/**
+ * Ключ подписи кита. Перечень выводится из английского набора — того самого,
+ * что стоит умолчанием, — поэтому ключа, которого кит не рисует, не существует,
+ * а опечатка не доживает до рантайма.
+ */
+type RtKitLabelKey = keyof typeof RT_KIT_LABELS_EN;
+/**
+ * Подстановки в места вида `{{name}}`. Их просят пять подписей: строка
+ * сравнения, имя скачиваемого файла, «страница N из M», диапазон записей и
+ * подпись раздела в разработке.
+ */
+type RtKitLabelParams = Readonly<Record<string, string | number>>;
+/**
+ * Чем кит получает подпись. Даёт её приложение — оно одно знает и язык
+ * продукта, и его формулировки.
+ *
+ * Возвращать функция обязана готовую строку: подстановки уже сделаны, ключа на
+ * экране не бывает. Вернувшая пустое считается не давшей ответа — кит возьмёт
+ * английское умолчание, потому что пустая `aria`-подпись означает кнопку без
+ * имени для скринридера, а это хуже чужого языка.
+ */
+type RtKitTranslator = (key: RtKitLabelKey, params?: RtKitLabelParams) => string;
+/**
+ * Все подписи разом, ключ → готовая строка.
+ *
+ * Компонент читает карту целиком (`t().uiClose`), а не ключ по одному: одно поле
+ * на компонент вместо десятка, и при смене языка перерисовывается всё сразу.
+ * Подписи с подстановками в карту не входят — им нужны параметры, и они берутся
+ * через `rtKitLabel()`.
+ */
+type RtKitLabelMap = Readonly<Record<RtKitLabelKey, string>>;
+
+/**
+ * Функция, которой кит получает подписи. Её отдаёт приложение —
+ * `provideRtKitLabels()`.
+ *
+ * Токен объявлен **сигналом**, а не просто функцией: приложение, меняющее язык
+ * на ходу, кладёт в него новую функцию, и всё, что от неё считано,
+ * пересчитывается само.
+ */
+declare const RT_KIT_TRANSLATOR: InjectionToken<Signal<RtKitTranslator>>;
+/**
+ * Активная локаль. Ею кит форматирует даты — больше ни для чего она ему не
+ * нужна.
+ *
+ * Данные локали для `DatePipe` регистрирует приложение: без них пайп падает
+ * `Missing locale data`, и кит за это не отвечает.
+ */
+declare const RT_KIT_LOCALE: InjectionToken<Signal<string>>;
+/**
+ * Все подписи кита разом, ключ → готовая строка.
+ *
+ * Этим пользуются компоненты: `t().uiClose` вместо ключа по одному. Карта
+ * строится один раз на приложение (`providedIn: 'root'`) и пересчитывается,
+ * только когда приложение сменило функцию-переводчик.
+ *
+ * Подпись, которой переводчик не дал (вернул пустое или упал), берётся
+ * английской: пустая `aria`-подпись означает кнопку без имени для скринридера.
+ */
+declare const RT_KIT_LABELS: InjectionToken<Signal<RtKitLabelMap>>;
+/**
+ * Одна подпись, а не вся карта.
+ *
+ * Карте не годятся две вещи: подпись с подстановками (параметры приходят из
+ * состояния компонента) и подпись, ключ которой выбирается на ходу — кнопка
+ * «свернуть ↔ развернуть», текст ошибки поля по сработавшему валидатору. Обе
+ * берутся отсюда. Зовётся в поле класса, в инъекционном контексте.
+ *
+ * ```typescript
+ * readonly #range: Signal<string> = rtKitLabel('uiRangeOf', this.#rangeParams);
+ * readonly #expand: Signal<string> = rtKitLabel(computed(() => (this.expanded() ? 'chatCollapse' : 'chatExpand')));
+ * ```
+ *
+ * @param key Ключ подписи — значением или сигналом, если он меняется. Пустой
+ *   ключ даёт пустую строку: у поля без сработавшего валидатора подписи нет, и
+ *   умолчание тут показало бы ошибку там, где её не случилось.
+ * @param params Подстановки — значением или сигналом, если они меняются.
+ */
+declare function rtKitLabel(key: RtKitLabelKey | '' | Signal<RtKitLabelKey | ''>, params?: RtKitLabelParams | Signal<RtKitLabelParams>): Signal<string>;
+/**
+ * Отдаёт киту подписи приложения.
+ *
+ * Без него кит работает на английском умолчании — оно вшито и покрывает все
+ * ключи, поэтому пустой кнопки на экране не бывает никогда.
+ *
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *     providers: [
+ *         provideRtKitLabels({
+ *             translator: computed(() => (key, params) => transloco.translate(`rtKit.${key}`, params)),
+ *             locale: toSignal(transloco.langChanges$, { initialValue: transloco.getActiveLang() }),
+ *         }),
+ *     ],
+ * };
+ * ```
+ *
+ * Способ доставки — дело приложения: Transloco, `$localize`, собственный
+ * словарь. Кит знает только ключи и то, что на них отвечают строкой.
+ *
+ * @param source Функция-переводчик и активная локаль. Локаль необязательна —
+ *   без неё кит форматирует даты по-английски.
+ */
+declare function provideRtKitLabels(source: {
+    readonly translator: Signal<RtKitTranslator>;
+    readonly locale?: Signal<string>;
+}): EnvironmentProviders;
+
 /**
  * Имена иконок rt-icon. Набор лежит в `assets/icons` пакета, откуда сборка
  * приложения кладёт его туда, куда указывает `provideRtIcons()`. Большинство
@@ -395,6 +651,7 @@ declare class RtAsideHeaderComponent {
     #private;
     /** Текст заголовка — рендерится в `<h2>`. Null/пустая строка вместе с
      *  `[loading]=true` показывают skeleton вместо title. */
+    protected readonly t: Signal<RtKitLabelMap>;
     readonly title: InputSignal<string | null>;
     /**
      * Мелкий приглушённый надзаголовок НАД основным title (контекст действия:
@@ -664,6 +921,7 @@ declare namespace IRtAutocomplete {
  */
 declare class RtAutocompleteComponent<TItem> extends RtFormControlBase<TItem | null> {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly panelId: string;
     protected readonly popover: Signal<RtPopoverDirective>;
     protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -738,6 +996,7 @@ declare class RtBarListComponent {
 
 declare class RtBottomSheetComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly dragDeltaY: WritableSignal<number>;
     protected readonly dragging: WritableSignal<boolean>;
     readonly open: InputSignal<boolean>;
@@ -777,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>
  * ```
@@ -1147,13 +1406,14 @@ declare namespace IRtChat {
 declare class RtChatComponent {
     #private;
     /**
-     * Дата сообщения форматируется по активному языку Transloco, а не по
+     * Дата сообщения форматируется по активной локали приложения, а не по
      * `LOCALE_ID`: тот вычисляется на подъёме приложения и там, где язык
      * переключают на ходу, оставил бы часы в прежнем формате до перезагрузки.
      *
      * Данные локали для `DatePipe` регистрирует приложение: без них пайп падает
      * `Missing locale data`, и кит за это не отвечает.
      */
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly locale: Signal<string>;
     /**
      * Скролл-контейнер треда — для автопрокрутки к последнему сообщению.
@@ -1414,6 +1674,7 @@ declare class RtCheckboxComponent implements ControlValueAccessor {
 
 declare class RtCollapsibleTextComponent implements OnDestroy {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly textRef: Signal<ElementRef<HTMLElement> | undefined>;
     protected readonly expanded: WritableSignal<boolean>;
     protected readonly overflowing: WritableSignal<boolean>;
@@ -1868,9 +2129,12 @@ declare abstract class RtRouteAsideComponent<T> implements OnInit {
     protected onResolved(): void;
     protected closeOutlets(): Record<string, Array<string> | null>;
     /**
-     * `successKey` — ключ словаря для тоста об успехе. Ключ принадлежит
-     * конкретной мутации, а не панели: у снятия промокода и опроса подписки свой
-     * текст успеха, и один ключ на панель показал бы не тот.
+     * `successText` — готовый текст тоста об успехе. Он принадлежит конкретной
+     * мутации, а не панели: у снятия промокода и опроса подписки свой текст
+     * успеха, и один на панель показал бы не тот.
+     *
+     * Именно текст, а не ключ словаря: ключ принадлежал бы словарю приложения, а
+     * кит чужих словарей не знает — переводит приложение и передаёт готовое.
      *
      * `errorText` принимается и функцией: причина отказа известна только после
      * него — стор кладёт её в свой сигнал, а панель без стора выводит из ответа
@@ -1878,7 +2142,7 @@ declare abstract class RtRouteAsideComponent<T> implements OnInit {
      */
     protected runMutation(op$: Observable<unknown>, opts?: {
         onSuccess?: () => void;
-        successKey?: string;
+        successText?: string;
         errorText?: string | ((error: unknown) => string);
         closeOnSuccess?: boolean;
         refreshOnSuccess?: boolean;
@@ -1901,19 +2165,6 @@ declare abstract class RtRouteAsideComponent<T> implements OnInit {
 interface IRtAsideDeactivate {
     canDeactivate(): Observable<boolean>;
 }
-/**
- * Панель с несохранёнными правками спрашивает о них и при смене маршрута, а не
- * только при закрытии: аутлет `ro` занимает соседняя панель, и правки пропали бы
- * молча.
- *
- * Ставится на каждый ro-маршрут: гард висит на кнопках, нажатии мимо и Esc, а
- * смену маршрута ловит только роутер.
- *
- * Панели может не быть: роутер зовёт гард и для маршрута, чей компонент не создан.
- * Спрашивать тогда не о чем — уступить место можно. Без этой проверки первая же
- * такая навигация падает, а следом отказывает любая другая: маршрут остаётся
- * активным, и приложение застревает на адресе панели.
- */
 declare const rtAsideUnsavedGuard: CanDeactivateFn<IRtAsideDeactivate | null>;
 
 /**
@@ -1976,8 +2227,8 @@ declare class RtCounterComponent implements ControlValueAccessor {
  * берёт компонент, у которого есть доступ к текущей локали; перекрываются
  * поштучно через input'ы `decreaseLabel` / `increaseLabel`.
  */
-declare const RT_COUNTER_DECREASE_KEY: string;
-declare const RT_COUNTER_INCREASE_KEY: string;
+declare const RT_COUNTER_DECREASE_KEY: RtKitLabelKey;
+declare const RT_COUNTER_INCREASE_KEY: RtKitLabelKey;
 
 /**
  * Строка списка со счётчиком: подпись с пояснением слева, контрол справа,
@@ -2015,6 +2266,7 @@ declare namespace IRtDatePicker {
  */
 declare class RtDatePickerComponent extends RtFormControlBase<string> {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly hasValue: Signal<boolean>;
     readonly displayText: Signal<string>;
@@ -2262,6 +2514,7 @@ declare const RT_DIALOG_DATA: InjectionToken<unknown>;
 declare class RtDialogHeaderComponent {
     #private;
     /** Текст заголовка — рендерится в `<h2>`. */
+    protected readonly t: Signal<RtKitLabelMap>;
     readonly title: InputSignal<string>;
     /** Показывать кнопку закрытия в углу заголовка. Дефолт `true`. */
     readonly closable: InputSignalWithTransform<boolean, BooleanInput>;
@@ -2291,6 +2544,11 @@ declare class RtDialogFooterComponent {
 }
 
 declare class RtDownloadLinkComponent {
+    /**
+     * Подпись для скринридера: имя файла подставляется в неё, поэтому карты
+     * подписей ей мало — параметр приходит из входа.
+     */
+    protected readonly downloadAriaLabel: Signal<string>;
     readonly label: InputSignal<string>;
     readonly downloadClick: OutputEmitterRef<void>;
     protected onClick(): void;
@@ -2340,7 +2598,7 @@ declare namespace IRtField {
  * страницы ещё неизвестен, и готовый текст остался бы на языке по умолчанию
  * даже под переведённой подписью поля. Переводит сам компонент поля.
  */
-declare const RT_FIELD_DEFAULT_ERROR_KEYS: IRtField.ErrorMessages;
+declare const RT_FIELD_DEFAULT_ERROR_KEYS: Readonly<Record<string, RtKitLabelKey>>;
 /** Текст-плейсхолдер read-only поля без значения. */
 declare const RT_FIELD_EMPTY_VALUE: string;
 
@@ -2360,6 +2618,7 @@ declare const RT_FIELD_EMPTY_VALUE: string;
  */
 declare class RtFieldComponent implements AfterContentInit {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly projectedControl: Signal<RtFormControlBase<unknown> | undefined>;
     protected readonly projectedHint: Signal<RtFieldHintDirective | undefined>;
     /** Итоговый id: явный controlId контрола важнее авто-id. */
@@ -2438,6 +2697,7 @@ declare namespace IRtFileCard {
  */
 declare class RtFileCardComponent {
     /** Имя цветной иконки типа файла по расширению. */
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly iconName: Signal<IRtIcon.Name>;
     /** Заголовок карточки, выведенный из имени файла (без расширения, разделители → пробелы). */
     protected readonly title: Signal<string>;
@@ -2724,6 +2984,7 @@ declare class RtFilterControlComponent<T = string> {
  * страницы в dark).
  */
 declare class RtHeaderComponent {
+    protected readonly t: Signal<RtKitLabelMap>;
     readonly canGoBack: InputSignal<boolean>;
     /** Показывать action-иконку «Пригласить пользователя» слева от колокола. */
     readonly showInvite: InputSignalWithTransform<boolean, boolean | string>;
@@ -2836,6 +3097,7 @@ declare class RtInfoItemComponent {
  * Все размеры/цвета — через `--rt-input-*` semantic-токены.
  */
 declare class RtInputComponent extends RtFormControlBase<string> {
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly isPasswordVisible: WritableSignal<boolean>;
     protected readonly hasValue: Signal<boolean>;
@@ -2883,6 +3145,7 @@ declare class RtInputComponent extends RtFormControlBase<string> {
  */
 declare class RtInputNumberComponent extends RtFormControlBase<number | null> {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly fieldEl: Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly displayValue: WritableSignal<string>;
     protected readonly hasValue: Signal<boolean>;
@@ -3189,6 +3452,7 @@ declare class RtMessageComponent {
      * передайте пустую строку как `[icon]` — она будет falsy и не «победит» default.
      * Полное отключение делается через severity `secondary` / `neutral`.
      */
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly effectiveIcon: Signal<IRtIcon.Name | null>;
     /** Семантическая палитра. По умолчанию `info` (синий info-banner). */
     readonly severity: InputSignal<IRtTag.Severity>;
@@ -3220,6 +3484,7 @@ interface IComposerFormShape {
  */
 declare class RtMessageComposerComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly placeholderText: Signal<string>;
     protected readonly fileInput: Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly form: FormGroup<IComposerFormShape>;
@@ -3305,6 +3570,7 @@ declare class RtMoneyRowComponent {
  */
 declare class RtMultiselectComponent<TValue> extends RtFormControlBase<ReadonlyArray<TValue>> {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly panelId: string;
     protected readonly placeholderText: Signal<string>;
     protected readonly popover: Signal<RtPopoverDirective>;
@@ -3524,6 +3790,7 @@ declare namespace IRtPageHeaderView {
  */
 declare class RtPageHeaderComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly mobileNavPopoverRef: Signal<RtPopoverDirective | undefined>;
     /** Форма пункта решается один раз здесь, а не ветвлениями в шаблоне. */
     protected readonly sections: Signal<ReadonlyArray<IRtPageHeaderView.Section>>;
@@ -3553,6 +3820,12 @@ declare class RtPageHeaderComponent {
     readonly itemClick: OutputEmitterRef<string>;
     readonly userClick: OutputEmitterRef<void>;
     constructor();
+    /**
+     * Подпись раздела в разработке. Методом, а не сигналом: имя раздела приходит
+     * элементом цикла, и до него подписи ещё нет. Метод читает сигнал
+     * переводчика, поэтому смена языка перерисовывает разметку и зовёт его заново.
+     */
+    protected sectionInProgressLabel(label: string): string;
     protected onItemClick(id: string): void;
     protected onUserClick(): void;
     /** Аккордеон мобильной панели: тумблер раскрытия раздела по его id. */
@@ -3615,6 +3888,7 @@ declare namespace IRtPhotoViewer {
  */
 declare class RtPhotoViewerComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly track: Signal<ElementRef<HTMLElement> | undefined>;
     protected readonly photos: readonly IRtPhotoViewer.Photo[];
     /** Панель правки под дорожкой; там, где кадр только смотрят, её нет */
@@ -3661,7 +3935,14 @@ declare namespace IRtPagination {
 }
 
 declare class RtPaginationComponent {
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly perPageSelectOptions: Signal<ReadonlyArray<IRtSelect.Option<number>>>;
+    /**
+     * Диапазон записей и номер страницы — с подстановками, поэтому карте подписей
+     * они не годятся: числа приходят из модели страницы.
+     */
+    protected readonly rangeLabel: Signal<string>;
+    protected readonly pageLabel: Signal<string>;
     protected readonly isFirst: Signal<boolean>;
     protected readonly isLast: Signal<boolean>;
     readonly pageModel: InputSignal<IPageModel>;
@@ -3725,6 +4006,7 @@ type IBooleanInput = boolean | string;
  */
 declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue | null> {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly panelId: string;
     protected readonly filterPlaceholderText: Signal<string>;
     protected readonly popover: Signal<RtPopoverDirective>;
@@ -3971,6 +4253,7 @@ declare class RtStatTileComponent {
      * = null) не рисуется вовсе: «—» рядом с цифрой читается как поломка, а не
      * как «сравнивать не с чем».
      */
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly primaryDelta: Signal<IDeltaRow | null>;
     /** Годовое сравнение — отдельным компактным чипом, без слов в строке. */
     protected readonly yearDelta: Signal<IDeltaRow | null>;
@@ -4554,6 +4837,7 @@ declare class RtTableSettingsRegistry {
 declare class RtTableSettingsAsideComponent extends RtRouteAsideComponent<never> {
     #private;
     /** Рабочая копия списка колонок (сидится из регистрации, редактируется телом-панелью). */
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly items: WritableSignal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
     constructor();
     protected resolve(): Observable<never | null>;
@@ -4572,6 +4856,7 @@ declare class RtTableSettingsAsideComponent extends RtRouteAsideComponent<never>
  * для «Сохранить»/«Сбросить» и передаёт сюда через `[(items)]`.
  */
 declare class RtTableSettingsPanelComponent {
+    protected readonly t: Signal<RtKitLabelMap>;
     readonly items: ModelSignal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
     /** Reorder через drag-drop. Locked-строки drag-disabled; индексы — по всему списку. */
     protected onDrop(event: CdkDragDrop<ReadonlyArray<IRtTable.ColumnSettingItem>>): void;
@@ -4643,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>;
 }
@@ -4724,6 +5015,7 @@ declare class RtTabsComponent {
  */
 declare class RtTagComponent {
     /** Текст pill — обязательный input. */
+    protected readonly t: Signal<RtKitLabelMap>;
     readonly value: InputSignal<string>;
     /** Семантическая палитра. По умолчанию `neutral` (нейтральный серый). */
     readonly severity: InputSignal<IRtTag.Severity>;
@@ -4880,6 +5172,7 @@ declare class RtThreadListSearchDirective {
  */
 declare class RtThreadListComponent<TRow extends IRtThreadList.Row> implements OnInit {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly searchPlaceholderText: Signal<string>;
     protected readonly emptyTitle: Signal<string>;
     protected readonly skeletonRows: number[];
@@ -5116,6 +5409,7 @@ declare namespace IRtToaster {
 
 declare class RtToastComponent implements AfterViewInit, OnDestroy {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly icon: Signal<IRtIcon.Name>;
     readonly toast: InputSignal<IRtToaster.Toast>;
     readonly index: InputSignal<number>;
@@ -5387,6 +5681,7 @@ declare namespace IRtWelcomeDialog {
  */
 declare class RtWelcomeDialogComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly title: string;
     protected readonly paragraphs: string[];
     /** Своя подпись важнее умолчания: роль знает, куда ведёт кнопка */
@@ -5442,6 +5737,7 @@ declare class RtWorkspaceAsideDirective {
 
 declare class RtWorkspaceComponent implements IRtWorkspace.PanelApi {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly listSlot: Signal<RtWorkspaceListDirective | undefined>;
     protected readonly centerSlot: Signal<RtWorkspaceCenterDirective | undefined>;
     protected readonly asideSlot: Signal<RtWorkspaceAsideDirective | undefined>;
@@ -5552,6 +5848,7 @@ interface ITransitionFormShape {
 }
 declare class RtWorkspaceDetailsComponent {
     #private;
+    protected readonly t: Signal<RtKitLabelMap>;
     protected readonly editingAgent: WritableSignal<boolean>;
     protected readonly selectedAgentId: WritableSignal<number | null>;
     protected readonly transitionForm: FormGroup<ITransitionFormShape>;
@@ -5643,52 +5940,5 @@ declare class RtInfiniteScrollDirective implements OnDestroy {
     static ɵdir: i0.ɵɵDirectiveDeclaration<RtInfiniteScrollDirective, "[rtInfiniteScroll]", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rootMargin": { "alias": "rootMargin"; "required": false; "isSignal": true; }; }, { "loadMore": "loadMore"; }, never, never, true, never>;
 }
 
-/**
- * Словари кита: подписи, которые компоненты рисуют сами — кнопки диалогов,
- * ярлыки состояний, подсказки для скринридера, тексты ошибок поля.
- *
- * Ключи лежат в собственном неймспейсе `rtKit`, чтобы не занимать глобальное
- * пространство ключей приложения: в разметке они пишутся полным именем
- * (`'rtKit.uiClose' | transloco`), а грузит их `provideRtKitTranslations()`.
- *
- * Приложение переопределяет любую подпись, передав свой словарь тем же
- * провайдером: переданные ключи ложатся поверх этих.
- */
-declare const RT_KIT_TRANSLATIONS: Readonly<Record<string, Readonly<Record<string, string>>>>;
-
-/**
- * Неймспейс, под которым лежат подписи кита. Он же — префикс ключа в разметке:
- * `'rtKit.uiClose' | transloco`.
- */
-declare const RT_KIT_TRANSLATION_NAMESPACE: string;
-/**
- * Подключает словари кита к Transloco приложения.
- *
- * Кит рисует часть подписей сам — кнопки диалогов, тексты ошибок поля,
- * расшифровки иконок для скринридера, — и без этого провайдера на экране
- * остались бы ключи. Словари вшиты в пакет: сеть за ними не ходит и копировать
- * ассеты не нужно.
- *
- * ```typescript
- * export const appConfig: ApplicationConfig = {
- *     providers: [provideTransloco({ config, loader }), provideRtKitTranslations()],
- * };
- * ```
- *
- * Ключи ложатся в общий словарь языка под собственным неймспейсом, а не
- * скоупом Transloco: скоуп, объявленный на корне, приписался бы и ко всем
- * ключам приложения. Загрузку своих словарей это не задевает — они прилетают
- * позже и домешиваются рядом.
- *
- * Раскладываются все восемь языков, но прочитаются только заявленные в
- * `availableLangs` приложения: язык вне этого списка Transloco считает не
- * языком, а именем скоупа, и ключ по нему не найдётся.
- *
- * @param translations Свои словари поверх вшитых: ключи ложатся сверху по
- *   каждому языку отдельно. Так переопределяется одна подпись, а не весь набор,
- *   и так же добавляется язык, которого в пакете нет.
- */
-declare function provideRtKitTranslations(translations?: Readonly<Record<string, Readonly<Record<string, string>>>>): EnvironmentProviders;
-
-export { BreakpointsService, CATEGORY_ORDER, ERtCalendarDayState, ERtChatMessageStatus, ERtStorageKeys, IButton, ICON_CATEGORY_RULES, INotification, IRtAsideHeader, IRtAutocomplete, IRtBarList, IRtCalendar, IRtChat, IRtConfirmPopover, IRtDatePicker, IRtField, IRtFileCard, IRtFileDrop, IRtFileInput, IRtFilterControl, IRtIcon, IRtIconButton, IRtInput, IRtLogo, IRtMenu, IRtMessageComposer, IRtNightGrid, IRtPageHeader, IRtPagination, IRtPhotoViewer, IRtPopover, IRtSectionNav, IRtSelect, IRtSpinner, IRtSplitButton, IRtStatTile, IRtStepper, IRtTable, IRtTabs, IRtTag, IRtThemeToggle, IRtThreadList, IRtTimeline, IRtToaster, IRtToggleButtonGroup, IRtToggleSwitch, IRtTooltip, IRtWelcomeDialog, IRtWorkspace, IRtWorkspaceDetails, ITheme, MessageBus, NotificationBus, RT_ASIDE_DATA, RT_COUNTER_DECREASE_KEY, RT_COUNTER_INCREASE_KEY, RT_DIALOG_DATA, RT_FIELD_DEFAULT_ERROR_KEYS, RT_FIELD_EMPTY_VALUE, RT_ICONS_BASE_URL, RT_KIT_TRANSLATIONS, RT_KIT_TRANSLATION_NAMESPACE, RT_MENU_SELECT_EVENT, RT_TABLE_ROW_ACTIONS_COLUMN, RT_TOASTER_GAP_PX, RtAsideComponent, RtAsideFooterComponent, RtAsideHeaderComponent, RtAsideRef, RtAsideSectionComponent, RtAsideService, RtAutocompleteComponent, RtBarListComponent, RtBottomSheetComponent, RtButtonDirective, RtCalendarComponent, RtCardComponent, RtChatComponent, RtChatStatusLabelPipe, RtCheckboxComponent, RtCollapsibleTextComponent, RtConfirmDirective, RtConfirmPopoverComponent, RtContainerComponent, RtContainerContentDirective, RtContainerContentPanelDirective, RtContainerHeaderDirective, RtContainerLeftSidenavDirective, RtContainerLeftSidenavPanelDirective, RtContainerRightSidenavDirective, RtContainerRightSidenavPanelDirective, RtContainerStateService, RtContainerToolbarCenterDirective, RtContainerToolbarLeftDirective, RtContainerToolbarRightDirective, RtCopyCellComponent, RtCounterComponent, RtCounterRowComponent, RtDatePickerComponent, RtDayStampPipe, RtDeltaViewComponent, RtDetailListComponent, RtDetailRowComponent, RtDialogComponent, RtDialogFooterComponent, RtDialogHeaderComponent, RtDialogRef, RtDialogService, RtDownloadLinkComponent, RtEmptyStateComponent, RtFieldComponent, RtFieldHintDirective, RtFileCardComponent, RtFileDropComponent, RtFileInputComponent, RtFileListComponent, RtFilterControlComponent, RtFormControlBase, RtHeaderComponent, RtIconButtonComponent, RtIconComponent, RtIconRegistry, RtInfiniteScrollDirective, RtInfoItemComponent, RtInputComponent, RtInputNumberComponent, RtLiveBadgeComponent, RtLogoComponent, RtMenuComponent, RtMenuItemComponent, RtMessageComponent, RtMessageComposerComponent, RtMoneyListComponent, RtMoneyRowComponent, RtMultiselectComponent, RtNightGridComponent, RtNoteComponent, RtNotificationsBellComponent, RtPageHeaderComponent, RtPaginationComponent, RtPhotoViewerComponent, RtPopoverDirective, RtRichEditorComponent, RtRouteAsideComponent, RtRowHasActionsPipe, RtSectionNavComponent, RtSelectComponent, RtSkeletonComponent, RtSkeletonWrapperComponent, RtSpinnerComponent, RtSplitButtonComponent, RtStatTileComponent, RtStepperComponent, RtTabDirective, RtTableCardDirective, RtTableComponent, RtTableRowActionsDirective, RtTableRowDirective, RtTableSettingsAsideComponent, RtTableSettingsPanelComponent, RtTableSettingsRegistry, RtTableSortHeaderComponent, RtTabsComponent, RtTabsControlDirective, RtTagComponent, RtTextareaComponent, RtThemeToggleComponent, RtThreadListComponent, RtThreadListFiltersDirective, RtThreadListRowDirective, RtThreadListSearchDirective, RtTimelineComponent, RtToastComponent, RtToasterComponent, RtToggleButtonGroupComponent, RtToggleSwitchComponent, RtToolbarCenterDirective, RtToolbarComponent, RtToolbarLeftDirective, RtToolbarRightDirective, RtTooltipComponent, RtTooltipDirective, RtTruncateMiddlePipe, RtWelcomeDialogComponent, RtWorkspaceAsideDirective, RtWorkspaceCenterDirective, RtWorkspaceComponent, RtWorkspaceDesktopOnlyDirective, RtWorkspaceDetailsComponent, RtWorkspaceListDirective, SEARCH_DEBOUNCE_MS, ThemeService, ariaSortOf, categoryOf, coerceQuillDeltaOutput, deliveryStatus, deriveFileTitle, fileNameFromUrl, formatFileSize, getFileTypeIcon, iconsName, indexFromParam, indexFromScroll, isColumnSortable, nextPhotoIndex, nextSort, normalizeQuillDelta, paramFromIndex, pendingToRtMessage, provideRtIcons, provideRtKitTranslations, rowHasAvailableActions, rtAsideUnsavedGuard, searchDebounce, shouldRenderPhoto, sortDirectionOf, toRtMessage };
-export type { IIconCategory, IMessageBusEvent, IQuillDelta, IQuillDeltaAttributes, IQuillDeltaOp, IRtAsideConfig, IRtAsideContentLayout, IRtAsideDeactivate, IRtAsidePosition, IRtAsideSize, IRtDialogConfig, IRtDialogSize, IRtMappableMessage, IRtPendingMessage, IRtPicture, IRtPictureSource, IRtRichEditorToolbar, IRtSkeletonRadius, IRtSkeletonShape, IRtSkeletonSize, IRtTableAriaSort, IRtTableCardContext, IRtTableRowActionsContext, IRtTableSettingsRegistration, IRtTextareaResize, IToRtMessageOptions };
+export { BreakpointsService, CATEGORY_ORDER, ERtCalendarDayState, ERtChatMessageStatus, ERtStorageKeys, IButton, ICON_CATEGORY_RULES, INotification, IRtAsideHeader, IRtAutocomplete, IRtBarList, IRtCalendar, IRtChat, IRtConfirmPopover, IRtDatePicker, IRtField, IRtFileCard, IRtFileDrop, IRtFileInput, IRtFilterControl, IRtIcon, IRtIconButton, IRtInput, IRtLogo, IRtMenu, IRtMessageComposer, IRtNightGrid, IRtPageHeader, IRtPagination, IRtPhotoViewer, IRtPopover, IRtSectionNav, IRtSelect, IRtSpinner, IRtSplitButton, IRtStatTile, IRtStepper, IRtTable, IRtTabs, IRtTag, IRtThemeToggle, IRtThreadList, IRtTimeline, IRtToaster, IRtToggleButtonGroup, IRtToggleSwitch, IRtTooltip, IRtWelcomeDialog, IRtWorkspace, IRtWorkspaceDetails, ITheme, MessageBus, NotificationBus, RT_ASIDE_DATA, RT_COUNTER_DECREASE_KEY, RT_COUNTER_INCREASE_KEY, RT_DIALOG_DATA, RT_FIELD_DEFAULT_ERROR_KEYS, RT_FIELD_EMPTY_VALUE, RT_ICONS_BASE_URL, RT_KIT_LABELS, RT_KIT_LABELS_EN, RT_KIT_LOCALE, RT_KIT_TRANSLATOR, RT_MENU_SELECT_EVENT, RT_TABLE_ROW_ACTIONS_COLUMN, RT_TOASTER_GAP_PX, RtAsideComponent, RtAsideFooterComponent, RtAsideHeaderComponent, RtAsideRef, RtAsideSectionComponent, RtAsideService, RtAutocompleteComponent, RtBarListComponent, RtBottomSheetComponent, RtButtonDirective, RtCalendarComponent, RtCardComponent, RtChatComponent, RtChatStatusLabelPipe, RtCheckboxComponent, RtCollapsibleTextComponent, RtConfirmDirective, RtConfirmPopoverComponent, RtContainerComponent, RtContainerContentDirective, RtContainerContentPanelDirective, RtContainerHeaderDirective, RtContainerLeftSidenavDirective, RtContainerLeftSidenavPanelDirective, RtContainerRightSidenavDirective, RtContainerRightSidenavPanelDirective, RtContainerStateService, RtContainerToolbarCenterDirective, RtContainerToolbarLeftDirective, RtContainerToolbarRightDirective, RtCopyCellComponent, RtCounterComponent, RtCounterRowComponent, RtDatePickerComponent, RtDayStampPipe, RtDeltaViewComponent, RtDetailListComponent, RtDetailRowComponent, RtDialogComponent, RtDialogFooterComponent, RtDialogHeaderComponent, RtDialogRef, RtDialogService, RtDownloadLinkComponent, RtEmptyStateComponent, RtFieldComponent, RtFieldHintDirective, RtFileCardComponent, RtFileDropComponent, RtFileInputComponent, RtFileListComponent, RtFilterControlComponent, RtFormControlBase, RtHeaderComponent, RtIconButtonComponent, RtIconComponent, RtIconRegistry, RtInfiniteScrollDirective, RtInfoItemComponent, RtInputComponent, RtInputNumberComponent, RtLiveBadgeComponent, RtLogoComponent, RtMenuComponent, RtMenuItemComponent, RtMessageComponent, RtMessageComposerComponent, RtMoneyListComponent, RtMoneyRowComponent, RtMultiselectComponent, RtNightGridComponent, RtNoteComponent, RtNotificationsBellComponent, RtPageHeaderComponent, RtPaginationComponent, RtPhotoViewerComponent, RtPopoverDirective, RtRichEditorComponent, RtRouteAsideComponent, RtRowHasActionsPipe, RtSectionNavComponent, RtSelectComponent, RtSkeletonComponent, RtSkeletonWrapperComponent, RtSpinnerComponent, RtSplitButtonComponent, RtStatTileComponent, RtStepperComponent, RtTabDirective, RtTableCardDirective, RtTableComponent, RtTableRowActionsDirective, RtTableRowDirective, RtTableSettingsAsideComponent, RtTableSettingsPanelComponent, RtTableSettingsRegistry, RtTableSortHeaderComponent, RtTabsComponent, RtTabsControlDirective, RtTagComponent, RtTextareaComponent, RtThemeToggleComponent, RtThreadListComponent, RtThreadListFiltersDirective, RtThreadListRowDirective, RtThreadListSearchDirective, RtTimelineComponent, RtToastComponent, RtToasterComponent, RtToggleButtonGroupComponent, RtToggleSwitchComponent, RtToolbarCenterDirective, RtToolbarComponent, RtToolbarLeftDirective, RtToolbarRightDirective, RtTooltipComponent, RtTooltipDirective, RtTruncateMiddlePipe, RtWelcomeDialogComponent, RtWorkspaceAsideDirective, RtWorkspaceCenterDirective, RtWorkspaceComponent, RtWorkspaceDesktopOnlyDirective, RtWorkspaceDetailsComponent, RtWorkspaceListDirective, SEARCH_DEBOUNCE_MS, ThemeService, ariaSortOf, categoryOf, coerceQuillDeltaOutput, deliveryStatus, deriveFileTitle, fileNameFromUrl, formatFileSize, getFileTypeIcon, iconsName, indexFromParam, indexFromScroll, isColumnSortable, nextPhotoIndex, nextSort, normalizeQuillDelta, paramFromIndex, pendingToRtMessage, provideRtIcons, provideRtKitLabels, rowHasAvailableActions, rtAsideUnsavedGuard, rtKitLabel, searchDebounce, shouldRenderPhoto, sortDirectionOf, toRtMessage };
+export type { IIconCategory, IMessageBusEvent, IQuillDelta, IQuillDeltaAttributes, IQuillDeltaOp, IRtAsideConfig, IRtAsideContentLayout, IRtAsideDeactivate, IRtAsidePosition, IRtAsideSize, IRtDialogConfig, IRtDialogSize, IRtMappableMessage, IRtPendingMessage, IRtPicture, IRtPictureSource, IRtRichEditorToolbar, IRtSkeletonRadius, IRtSkeletonShape, IRtSkeletonSize, IRtTableAriaSort, IRtTableCardContext, IRtTableRowActionsContext, IRtTableSettingsRegistration, IRtTextareaResize, IToRtMessageOptions, RtKitLabelKey, RtKitLabelMap, RtKitLabelParams, RtKitTranslator };