@rt-tools/ui-kit-v2 0.16.0 → 0.18.0

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

@@ -0,0 +1,93 @@
+import * as i0 from '@angular/core';
+import { Signal, ElementRef, WritableSignal, InputSignal } from '@angular/core';
+import { TRtKitLabelMap, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+import { RtPopoverDirective, IRtPopover } from '@rt-tools/ui-kit-v2/popover';
+import { IRtSelect, RtSelectTriggerDirective } from '@rt-tools/ui-kit-v2/select';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Multi-select с chip-rendering выбранных значений в trigger.
+ *
+ * Panel рендерится через CDK Overlay (`[rtPopover]`) — не обрезается overflow,
+ * авто-flip. Панель НЕ закрывается после выбора (multi vs single). CVA через
+ * общий `RtFormControlBase`. Reuses `IRtSelect.Option<TValue>` (type-import).
+ * Чипы закрываются поштучно; крестик (`clearable`) слева от шеврона очищает весь
+ * выбор.
+ *
+ * Keyboard-nav (activedescendant): фокус на trigger'е, ArrowUp/Down — highlight,
+ * Enter — toggle опции (panel остаётся открытой), Escape — закрыть. Home/End —
+ * deferred.
+ */
+declare class RtMultiselectComponent<TValue> extends RtFormControlBase<ReadonlyArray<TValue>> {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly panelId: string;
+    protected readonly placeholderText: Signal<string>;
+    protected readonly popover: Signal<RtPopoverDirective>;
+    protected readonly triggerEl: Signal<ElementRef<HTMLButtonElement> | undefined>;
+    protected readonly activeIndex: WritableSignal<number>;
+    /** Раскрытые ветки дерева. Живут, пока открыта панель: при открытии раскрыты ветки над выбранным. */
+    protected readonly openBranches: WritableSignal<ReadonlySet<TValue>>;
+    /** Дерево ли список: тогда у строк есть место под стрелку и отступ по уровню. */
+    protected readonly isTree: Signal<boolean>;
+    /** Видимые строки: плоский список — как прежде, дерево — по раскрытым веткам. */
+    protected readonly rows: Signal<ReadonlyArray<IRtSelect.Row<TValue>>>;
+    /** Флажок каждой строки: у листа — выбран ли он, у ветки — выведен из её включённых листьев. */
+    protected readonly rowChecks: Signal<ReadonlyArray<IRtSelect.TBranchState>>;
+    protected readonly isOpen: Signal<boolean>;
+    /** Идентификатор подсвеченной опции — тот же, что уходит в `aria-activedescendant`. */
+    protected readonly activeOptionId: Signal<string | null>;
+    /**
+     * Своя разметка указателя, если потребитель её объявил. Маркер тот же, что у выбора одного
+     * значения: семьи отличаются только разметкой внутри кнопки.
+     */
+    protected readonly triggerTpl: Signal<RtSelectTriggerDirective<ReadonlyArray<TValue>> | undefined>;
+    protected readonly hasValue: Signal<boolean>;
+    protected readonly visibleChips: Signal<ReadonlyArray<TValue>>;
+    protected readonly extraChipsCount: Signal<number>;
+    /** Три значения, которые кит отдаёт своей разметке указателя, и не больше. */
+    protected readonly triggerState: Signal<IRtSelect.TriggerState<ReadonlyArray<TValue>>>;
+    readonly displayText: Signal<string>;
+    readonly options: InputSignal<ReadonlyArray<IRtSelect.Option<TValue>>>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly placeholder: InputSignal<string>;
+    readonly maxChips: InputSignal<number>;
+    /** Иконка слева в указателе — та же, что у `rt-select`: перед подсказкой или чипами. */
+    readonly iconLeft: InputSignal<IRtIcon.Name | null>;
+    /**
+     * Чем мерится панель. По умолчанию она не уже кнопки и дальше растёт по содержимому:
+     * со своим указателем кнопка бывает узкой, и панель по её ширине давила бы содержимое.
+     * `trigger` возвращает прежнее — ровно по кнопке, `auto` пускает панель по содержимому
+     * целиком. Предел высоты назначается входом `panelMaxHeight`.
+     */
+    readonly panelWidth: InputSignal<IRtPopover.Width>;
+    /**
+     * Предел высоты панели — длина как в стилях, например `20rem`. Пусто — предел кита
+     * `--rt-input-panel-max-height`, и длинный список прокручивается внутри панели: без предела
+     * он уходил за нижний край экрана, и пункты за краем были недостижимы. `none` снимает предел —
+     * для короткого списка, который должен открываться целиком, без прокрутки. Значение ставится
+     * на саму панель: она рисуется в наложении, вне поддерева блока.
+     */
+    readonly panelMaxHeight: InputSignal<string | null>;
+    constructor();
+    setDisabledState(disabled: boolean): void;
+    protected getEmptyValue(): ReadonlyArray<TValue>;
+    protected focusAfterClear(): void;
+    protected labelOf(value: TValue): string;
+    protected isSelected(value: TValue): boolean;
+    protected onOpened(): void;
+    protected toggleBranch(event: Event, value: TValue): void;
+    protected onClosed(): void;
+    /**
+     * Лист переключается сам. Ветка выбирает все свои включённые листья или снимает их, когда
+     * выбраны все; своё значение ветки в выбор не пишется.
+     */
+    protected toggleOption(opt: IRtSelect.Option<TValue>): void;
+    protected removeChip(value: TValue, event: MouseEvent): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtMultiselectComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtMultiselectComponent<any>, "rt-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxChips": { "alias": "maxChips"; "required": false; "isSignal": true; }; "iconLeft": { "alias": "iconLeft"; "required": false; "isSignal": true; }; "panelWidth": { "alias": "panelWidth"; "required": false; "isSignal": true; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; "isSignal": true; }; }, {}, ["triggerTpl"], never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtMultiselectComponent };

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

@@ -0,0 +1,39 @@
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, OutputEmitterRef } from '@angular/core';
+
+/**
+ * Контракты `rt-night-grid` — плотная сетка суток.
+ *
+ * Домен в ui-kit не протаскивается: сетка знает про «свободно / основное /
+ * второстепенное», а не про статусы броней. Маппинг доменных состояний на эти
+ * три — забота потребителя.
+ */
+declare namespace IRtNightGrid {
+    type State = 'free' | 'primary' | 'secondary';
+    interface Cell {
+        readonly id: string;
+        readonly state: State;
+        /** Нативный title: подпись дня и, если занят, чем именно. */
+        readonly title: string;
+    }
+}
+
+/**
+ * Плотная сетка суток: ряд мелких ячеек, каждая — одна ночь. Применяется там, где
+ * нужно окинуть взглядом занятость на недели вперёд, а не листать календарь.
+ *
+ * Сетка скроллится внутри себя по горизонтали — документ боком не едет.
+ */
+declare class RtNightGridComponent {
+    #private;
+    protected readonly ariaText: Signal<string>;
+    readonly cells: InputSignal<ReadonlyArray<IRtNightGrid.Cell>>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly ariaLabel: InputSignal<string>;
+    readonly cellClick: OutputEmitterRef<IRtNightGrid.Cell>;
+    protected onCellClick(cell: IRtNightGrid.Cell): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtNightGridComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtNightGridComponent, "rt-night-grid", never, { "cells": { "alias": "cells"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "cellClick": "cellClick"; }, never, never, true, never>;
+}
+
+export { IRtNightGrid, RtNightGridComponent };

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

@@ -0,0 +1,21 @@
+import * as i0 from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Тихая информационная заметка-callout для асайдов и форм: приглушённый текст
+ * на subtle-фоне, без иконки и severity-цвета. Назначение — пояснить контекст
+ * (предупреждения, подсказки, контекстные примечания),
+ * не перебивая основной контент.
+ *
+ * Семантика — `role="note"` (ancillary-контент). Это НЕ alert: для громких
+ * цветных уведомлений с severity/иконкой/закрытием используйте `rt-message`.
+ *
+ * Контент проецируется через `<ng-content />` — допустимы инлайн-теги
+ * (`<strong>`, `<a>`) и control-flow (`@if`) внутри.
+ */
+declare class RtNoteComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtNoteComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtNoteComponent, "rt-note", never, {}, {}, never, ["*"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtNoteComponent };

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

@@ -0,0 +1,23 @@
+import * as i0 from '@angular/core';
+import { InputSignalWithTransform, InputSignal, OutputEmitterRef } from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Колокольчик в шапке: открывает ленту событий и показывает точкой, что
+ * непрочитанное есть.
+ *
+ * Маркер — точка, а не число: точное число получатель видит в самой ленте, а
+ * двузначное в шапке спорило бы с подписями разделов.
+ */
+declare class RtNotificationsBellComponent {
+    readonly unread: InputSignalWithTransform<boolean, boolean | string>;
+    readonly ariaLabel: InputSignal<string>;
+    /** Подпись маркера для скринридера: точка сама по себе ничего не говорит */
+    readonly unreadLabel: InputSignal<string>;
+    readonly clicked: OutputEmitterRef<void>;
+    protected onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtNotificationsBellComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtNotificationsBellComponent, "rt-notifications-bell", never, { "unread": { "alias": "unread"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "unreadLabel": { "alias": "unreadLabel"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtNotificationsBellComponent };

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

@@ -0,0 +1,173 @@
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, WritableSignal, InputSignal, TemplateRef, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { IRtIcon, TRtKitTranslator, TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+
+declare namespace IRtPageHeader {
+    /**
+     * Описание пункта верхней навигации — раздела первого уровня или пункта
+     * панели второго.
+     *
+     * Форма пункта решается его полями:
+     * - `columns` с хотя бы одним пунктом внутри → кнопка-триггер с указателем
+     *   раскрытия; панель открывается наведением, `route` родителя игнорируется,
+     *   родитель подсвечивается при активном вложенном адресе;
+     * - `route` задан и `!disabled` → анкор с `[routerLink]`/`routerLinkActive`;
+     * - иначе → `<button>`: `itemClick` у доступного, ничего у недоступного.
+     */
+    interface Item {
+        readonly id: string;
+        readonly label: string;
+        /** У пункта панели иконку носит заголовок его группы, а не он сам. */
+        readonly icon?: IRtIcon.Name;
+        readonly route?: string;
+        /** По умолчанию `false`. */
+        readonly routerLinkActiveExact?: boolean;
+        readonly disabled?: boolean;
+        /**
+         * Непросмотренное: пункт с признаком показывает точку у правого края.
+         * У раздела с панелью точка горит и от признака любого пункта внутри.
+         */
+        readonly unread?: boolean;
+        /** Панель второго уровня: колонка → группа → пункт. */
+        readonly columns?: ReadonlyArray<Column>;
+    }
+    /** Колонка панели. Ширина панели считается числом колонок, а не содержимым. */
+    interface Column {
+        readonly id: string;
+        readonly groups: ReadonlyArray<Group>;
+    }
+    /** Группа пунктов внутри колонки. Без `label` группа идёт без заголовка. */
+    interface Group {
+        readonly id: string;
+        readonly label?: string;
+        readonly icon?: IRtIcon.Name;
+        readonly items: ReadonlyArray<Item>;
+    }
+    /**
+     * Юзер-блок справа от навигации.
+     *
+     * `avatar` — заранее посчитанные инициалы (одна буква в верхнем регистре);
+     * fallback'ом берётся первая буква `name`.
+     */
+    interface User {
+        readonly name: string;
+        readonly avatar?: string;
+    }
+}
+
+/** Чем пункт отрисуется: панелью, ссылкой или кнопкой. */
+declare enum ERtPageHeaderEntry {
+    Panel = "panel",
+    Link = "link",
+    Button = "button"
+}
+declare namespace IRtPageHeaderView {
+    /** Пункт, готовый к отрисовке: форма решена заранее, шаблон её не выводит. */
+    interface Entry {
+        readonly id: string;
+        readonly label: string;
+        readonly icon: IRtIcon.Name | null;
+        readonly route: string;
+        readonly routerLinkActiveExact: boolean;
+        readonly disabled: boolean;
+        readonly unread: boolean;
+        readonly kind: ERtPageHeaderEntry;
+    }
+    interface Group {
+        readonly id: string;
+        readonly label: string;
+        readonly icon: IRtIcon.Name | null;
+        readonly items: ReadonlyArray<Entry>;
+    }
+    interface Column {
+        readonly id: string;
+        readonly groups: ReadonlyArray<Group>;
+    }
+    interface Section extends Entry {
+        readonly columns: ReadonlyArray<Column>;
+        readonly columnCount: number;
+        /** Все пункты панели одним списком: подсветка раздела и сведение маркера. */
+        readonly panelItems: ReadonlyArray<Entry>;
+        /** Группы всех колонок подряд: на узком экране колонок нет, а группы есть. */
+        readonly panelGroups: ReadonlyArray<Group>;
+    }
+}
+
+/**
+ * Верхняя горизонтальная плашка-навигация для первого уровня доменных страниц.
+ *
+ * Контракт:
+ * - `items` — `Item[]`. Анкор для пунктов с `route`; `<button>` для недоступных
+ *   и для тех, кто обрабатывается снаружи (`itemClick`). Пункт с `columns` —
+ *   кнопка-триггер: панель второго уровня открывается наведением ([rtPopover]).
+ * - `user` — необязательный блок справа. Если задан `userMenu` (TemplateRef) —
+ *   блок становится hover-триггером попапа с этим контентом (клик — touch-fallback,
+ *   панель прижата к правому краю); иначе по клику emit'ит `userClick`.
+ *
+ * Active state — через `RouterLinkActive` с классом `rt-page-header__link--is-active`;
+ * для раздела с панелью — вычисляется по текущему URL (своего route у него нет).
+ */
+declare class RtPageHeaderComponent {
+    #private;
+    /** Переводчик для чистого пайпа подписи: шаблон отдаёт его вторым доводом. */
+    protected readonly translate: Signal<TRtKitTranslator>;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly mobileNavPopoverRef: Signal<RtPopoverDirective | undefined>;
+    /** Кнопка «ещё» сжатой полосы открывает ту же панель, что и бургер, своим поповером. */
+    protected readonly compactNavPopoverRef: Signal<RtPopoverDirective | undefined>;
+    /** Сжатое состояние: шапка липкая и прилипла к верху. */
+    protected readonly compact: Signal<boolean>;
+    /** Разделы в кругах сжатой полосы: первые с иконкой, число — по входу. */
+    protected readonly compactSections: Signal<ReadonlyArray<IRtPageHeaderView.Section>>;
+    /** Форма пункта решается один раз здесь, а не ветвлениями в шаблоне. */
+    protected readonly sections: Signal<ReadonlyArray<IRtPageHeaderView.Section>>;
+    /**
+     * id разделов с активным вложенным адресом — для O(1) lookup в шаблоне.
+     * Зависит от #currentUrl + items (сигналы) → подсветка реактивна на навигацию.
+     */
+    protected readonly activeSectionIds: Signal<ReadonlySet<string>>;
+    protected readonly userAvatar: Signal<string>;
+    /** Узкий вьюпорт (≤1080px): инлайн-навигация прячется, показывается гамбургер. */
+    protected readonly isNarrow: Signal<boolean>;
+    /**
+     * id раскрытых разделов-аккордеонов в мобильной панели. Ключ — только раздел:
+     * группы внутри раскрытого раздела показаны сразу, и совпасть идентификаторам
+     * раздела и группы в этом множестве негде.
+     */
+    protected readonly expandedSectionIds: WritableSignal<ReadonlySet<string>>;
+    protected readonly EntryKind: typeof ERtPageHeaderEntry;
+    readonly items: InputSignal<ReadonlyArray<IRtPageHeader.Item>>;
+    readonly user: InputSignal<IRtPageHeader.User | null>;
+    readonly userTitle: InputSignal<string>;
+    readonly userMenu: InputSignal<TemplateRef<unknown> | null>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly ariaLabel: InputSignal<string>;
+    /**
+     * Шапка липнет к верху окна и, прилипнув, сжимается в полосу: круги первых разделов,
+     * кнопка «ещё» и три слота потребителя. Выключено — поведение прежнее.
+     */
+    readonly stickyCompact: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Сколько разделов с иконкой показывать кругами в сжатой полосе; остальные — под «ещё». */
+    readonly compactVisibleCount: InputSignalWithTransform<number, NumberInput>;
+    /** Своё имя навигации важнее умолчания */
+    readonly navAriaLabel: Signal<string>;
+    readonly itemClick: OutputEmitterRef<string>;
+    readonly userClick: OutputEmitterRef<void>;
+    constructor();
+    /** Панель разделов открывают и бургер, и кнопка «ещё»: закрываются обе. */
+    protected closeNavPanels(): void;
+    /** Круг раздела без адреса: раздел с панелью открывает общую панель, прочий — сообщает наружу. */
+    protected onCompactSectionClick(section: IRtPageHeaderView.Section): void;
+    protected onItemClick(id: string): void;
+    protected onUserClick(): void;
+    /** Аккордеон мобильной панели: тумблер раскрытия раздела по его id. */
+    protected toggleSection(id: string): void;
+    /** Клик по плоскому пункту мобильной панели: emit + закрыть панель. */
+    protected onMobileItemClick(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtPageHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtPageHeaderComponent, "rt-page-header", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "userTitle": { "alias": "userTitle"; "required": false; "isSignal": true; }; "userMenu": { "alias": "userMenu"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "stickyCompact": { "alias": "stickyCompact"; "required": false; "isSignal": true; }; "compactVisibleCount": { "alias": "compactVisibleCount"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; "userClick": "userClick"; }, never, ["[rtCompactLeft]", "[rtCompactCenter]", "[rtCompactRight]", "[rtHeaderBell]"], true, never>;
+}
+
+export { IRtPageHeader, RtPageHeaderComponent };

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

@@ -0,0 +1,64 @@
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { IPageModel } from '@rt-tools/utils';
+import { TRtKitLabelMap, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import { IRtSelect } from '@rt-tools/ui-kit-v2/select';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+declare namespace IRtPagination {
+    /** Элемент полосы страниц: номер или разрыв «…». */
+    type PageItem = number | 'gap';
+    /**
+     * Счёт номеров: `neighbours` — первая, последняя и соседи открытой, при одной странице полосы
+     * номеров нет; `seven` — семь мест первого кита, и одна страница рисуется номером со стрелками.
+     */
+    type Numbering = 'neighbours' | 'seven';
+}
+
+declare class RtPaginationComponent {
+    protected readonly t: Signal<TRtKitLabelMap>;
+    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>;
+    readonly perPageOptions: InputSignal<ReadonlyArray<number>>;
+    /** Значок стрелки «назад»: вид первого кита рисует стрелку, а не шеврон. */
+    readonly prevIcon: InputSignal<IRtIcon.Name>;
+    /** Значок стрелки «вперёд». */
+    readonly nextIcon: InputSignal<IRtIcon.Name>;
+    /** Счёт номеров: список под материальным набором просит семь мест первого кита. */
+    readonly numbering: InputSignal<IRtPagination.Numbering>;
+    readonly loading: InputSignalWithTransform<boolean, unknown>;
+    readonly pageChange: OutputEmitterRef<number>;
+    readonly perPageChange: OutputEmitterRef<number>;
+    /**
+     * Пагинацию показываем, только когда есть что листать/менять: всё не влезает
+     * на одну страницу даже при минимальной опции размера (`total > наименьший
+     * perPageOption`). Иначе и навигация, и селектор размера бесполезны — прячем
+     * весь бар (включая пустой и пустой-по-фильтру список).
+     */
+    readonly isVisible: Signal<boolean>;
+    /** Сколько всего страниц при нынешнем размере страницы. */
+    readonly lastPage: Signal<number>;
+    /**
+     * Границы диапазона записей открытой страницы. Собираются числами, а сама
+     * подпись — в шаблоне: только там подстановка проходит через словарь и
+     * переживает смену языка.
+     */
+    readonly rangeFrom: Signal<number>;
+    readonly rangeTo: Signal<number>;
+    /** Полоса номеров страниц с разрывами «…». По соседям пуста при единственной странице. */
+    readonly pageItems: Signal<ReadonlyArray<IRtPagination.PageItem>>;
+    goTo(pageNumber: number): void;
+    protected onPerPage(value: number | null): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtPaginationComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtPaginationComponent, "rt-pagination", never, { "pageModel": { "alias": "pageModel"; "required": true; "isSignal": true; }; "perPageOptions": { "alias": "perPageOptions"; "required": false; "isSignal": true; }; "prevIcon": { "alias": "prevIcon"; "required": false; "isSignal": true; }; "nextIcon": { "alias": "nextIcon"; "required": false; "isSignal": true; }; "numbering": { "alias": "numbering"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "perPageChange": "perPageChange"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { IRtPagination, RtPaginationComponent };

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

@@ -0,0 +1,98 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ElementRef, WritableSignal } from '@angular/core';
+import { IRtPicture, TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Контракты полноэкранного просмотрщика фотографий. Один корневой неймспейс с
+ * префиксом `I`.
+ */
+declare namespace IRtPhotoViewer {
+    /**
+     * Кадр в просмотрщике. Адреса собирает вызывающая сторона — кит не знает про
+     * хранилище; он получает готовую начинку `<picture>` и не решает, какие
+     * форматы существуют и какой из них запасной.
+     */
+    interface Photo {
+        readonly id: string;
+        readonly alt: string;
+        readonly picture: IRtPicture;
+        /** `width / height` — резервирует место до загрузки кадра */
+        readonly aspectRatio: string;
+    }
+    /** Контекст панели: кадр, на котором сейчас стоит просмотрщик */
+    interface PanelContext {
+        readonly $implicit: Photo;
+        readonly index: number;
+    }
+    /**
+     * Данные открытия: список кадров и тот, с которого начинаем.
+     *
+     * `panel` — необязательный шаблон под дорожкой. Он существует ради экранов,
+     * где кадр решают не только смотреть, но и править: подпись, видимость и
+     * порядок правятся там же, где принимается решение, а не после закрытия
+     * просмотра и поисков того же кадра в сетке. Просмотрщик
+     * открывается диалогом, поэтому проекция содержимого сюда не дотягивается —
+     * шаблон приходит вместе с данными.
+     */
+    interface Data {
+        readonly photos: readonly Photo[];
+        readonly startIndex: number;
+        readonly panel?: TemplateRef<PanelContext>;
+    }
+}
+
+/**
+ * Полноэкранный просмотрщик фотографий поверх `RtDialogService`.
+ *
+ * Листание — нативный `scroll-snap`: свайп, инерцию и прилипание даёт сам
+ * браузер, и на телефоне это ощущается правильнее любой реализации на
+ * обработчиках. Готовую библиотеку не берём — весь кит здесь собственный, а
+ * токены, BEM и `qa-dataid` ложатся естественно.
+ *
+ * Руками сделаны: стрелки, клавиши `←` `→`, счётчик и предзагрузка соседних
+ * кадров. `Esc`, блокировку прокрутки фона и затемнение даёт сам диалог.
+ */
+declare class RtPhotoViewerComponent {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly track: Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly photos: readonly IRtPhotoViewer.Photo[];
+    /** Панель правки под дорожкой; там, где кадр только смотрят, её нет */
+    protected readonly panel: TemplateRef<IRtPhotoViewer.PanelContext> | null;
+    protected readonly currentIndex: WritableSignal<number>;
+    protected readonly counter: Signal<string>;
+    /** Соседние кадры готовятся заранее, дальние в разметку не попадают */
+    protected readonly rendered: Signal<readonly boolean[]>;
+    constructor();
+    /** Наружу отдаётся кадр, на котором закрыли: по нему вызывающая сторона чистит адрес */
+    close(): void;
+    protected move(step: number): void;
+    protected select(index: number): void;
+    /** Свайп листает мимо стрелок — счётчик догоняет позицию дорожки */
+    protected onScroll(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtPhotoViewerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtPhotoViewerComponent, "rt-photo-viewer", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Чистая логика просмотрщика: переходы между кадрами и то, какие из них стоит
+ * держать загруженными.
+ */
+/** Листание по кругу: с последнего кадра стрелка вправо ведёт на первый */
+declare function nextPhotoIndex(current: number, total: number, step: number): number;
+/** Индекс из адреса: в URL кадры нумеруются с единицы, внутри — с нуля */
+declare function indexFromParam(param: string | null, total: number): number;
+declare function paramFromIndex(index: number): string;
+/**
+ * Индекс кадра по позиции прокрутки. Нужен, потому что листать можно свайпом:
+ * без этого счётчик показывал бы один кадр, а на экране был бы другой.
+ */
+declare function indexFromScroll(scrollLeft: number, slideWidth: number, total: number): number;
+/**
+ * Кадры, которые держим в разметке: текущий и соседние. Полноразмерная
+ * фотография весит сотни килобайт, и загружать все пятьдесят разом — значит
+ * выесть трафик пользователя ради кадров, до которых он не долистает.
+ */
+declare function shouldRenderPhoto(index: number, current: number, total: number): boolean;
+
+export { IRtPhotoViewer, RtPhotoViewerComponent, indexFromParam, indexFromScroll, nextPhotoIndex, paramFromIndex, shouldRenderPhoto };

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

@@ -0,0 +1,79 @@
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { OnDestroy, WritableSignal, InputSignal, TemplateRef, InputSignalWithTransform, OutputEmitterRef, Signal } from '@angular/core';
+
+/**
+ * Модель `[rtPopover]`: один корневой неймспейс с префиксом `I`.
+ */
+declare namespace IRtPopover {
+    /** Жест, открывающий popover. `manual` — host управляет через open()/close(). */
+    type Trigger = 'click' | 'hover' | 'manual';
+    /**
+     * Стратегия ширины панели: ровно по host'у (dropdown), не уже host'а и дальше по
+     * содержимому (`trigger-min`) или по содержимому целиком (tooltip).
+     */
+    type Width = 'trigger' | 'trigger-min' | 'auto';
+    /** Горизонтальное выравнивание панели относительно host'а. */
+    type Align = 'start' | 'end';
+}
+
+/**
+ * Переиспользуемый popover-примитив поверх CDK Overlay. Привязывает плавающую
+ * панель (`<ng-template>`) к host-элементу. Движок — CDK Overlay
+ * (`flexibleConnectedTo`): авто-flip у края viewport, reposition при скролле,
+ * outside-click и Escape закрытие из коробки — без ручного `position: absolute`
+ * в `:host` (тот резался `overflow: hidden` предками: таблицы, aside, карточки).
+ *
+ * Триггеры:
+ * - `click` (default) — toggle по клику на host; outside-click закрывает.
+ * - `hover` — открытие на `mouseenter`, закрытие с grace-периодом на `mouseleave`
+ *   (наведение на панель удерживает её открытой).
+ * - `manual` — авто-listener'ы не вешаются; host сам зовёт `open()/close()`.
+ *   Используется form-control'ами с собственным жестом (autocomplete — открытие
+ *   по набору текста).
+ *
+ * `open()/close()/toggle()/isOpen()` публичны во ВСЕХ режимах — `trigger` лишь
+ * определяет авто-listener'ы. `width: 'trigger'` синхронизирует ширину панели с
+ * host'ом (dropdown'ы), `'trigger-min'` не даёт панели стать уже host'а и дальше пускает
+ * её по содержимому, `'auto'` — content-sized (тултипы).
+ */
+declare class RtPopoverDirective implements OnDestroy {
+    #private;
+    protected readonly isOpenState: WritableSignal<boolean>;
+    readonly template: InputSignal<TemplateRef<unknown> | null>;
+    readonly trigger: InputSignal<IRtPopover.Trigger>;
+    readonly width: InputSignal<IRtPopover.Width>;
+    /** `end` — панель прижата к правому краю host'а (триггеры у правого края viewport). */
+    readonly align: InputSignal<IRtPopover.Align>;
+    /**
+     * Панель обязана уместиться во вьюпорт: не влезающая по ширине сдвигается от
+     * края экрана внутрь, не влезающая по высоте ужимается до свободного места под
+     * триггером, и содержимое в ней прокручивается.
+     *
+     * По умолчанию выключено: панель стоит ровно там, куда её ставит привязка к
+     * триггеру, даже если часть её ушла за экран. Включать там, где панель широкая
+     * или высокая настолько, что привязка сама по себе её не удерживает, — иначе
+     * пункты навигации остаются за краем экрана и недостижимы.
+     */
+    readonly fitViewport: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly context: InputSignal<unknown>;
+    readonly panelClass: InputSignal<string>;
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly offsetY: InputSignalWithTransform<number, NumberInput>;
+    readonly offsetX: InputSignalWithTransform<number, NumberInput>;
+    readonly opened: OutputEmitterRef<void>;
+    readonly closed: OutputEmitterRef<void>;
+    readonly isOpen: Signal<boolean>;
+    constructor();
+    ngOnDestroy(): void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    protected onHostClick(): void;
+    protected onHostMouseEnter(): void;
+    protected onHostMouseLeave(event: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtPopoverDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtPopoverDirective, "[rtPopover]", ["rtPopover"], { "template": { "alias": "rtPopover"; "required": false; "isSignal": true; }; "trigger": { "alias": "rtPopoverTrigger"; "required": false; "isSignal": true; }; "width": { "alias": "rtPopoverWidth"; "required": false; "isSignal": true; }; "align": { "alias": "rtPopoverAlign"; "required": false; "isSignal": true; }; "fitViewport": { "alias": "rtPopoverFitViewport"; "required": false; "isSignal": true; }; "context": { "alias": "rtPopoverContext"; "required": false; "isSignal": true; }; "panelClass": { "alias": "rtPopoverPanelClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "rtPopoverDisabled"; "required": false; "isSignal": true; }; "offsetY": { "alias": "rtPopoverOffsetY"; "required": false; "isSignal": true; }; "offsetX": { "alias": "rtPopoverOffsetX"; "required": false; "isSignal": true; }; }, { "opened": "rtPopoverOpened"; "closed": "rtPopoverClosed"; }, never, never, true, never>;
+}
+
+export { IRtPopover, RtPopoverDirective };