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

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

@@ -0,0 +1,57 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ModelSignal, InputSignalWithTransform, InputSignal } from '@angular/core';
+
+/**
+ * Тело `rt-expansion-panel`, собираемое лениво: ставится на `<ng-template>` внутри панели, и его
+ * содержимое создаётся при раскрытии и уходит после сворачивания. Сворачивание при этом доигрывает
+ * движение до конца: тело уходит вместе со своим содержимым, а не пустым.
+ */
+declare class RtExpansionPanelContentDirective {
+    readonly templateRef: TemplateRef<unknown>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtExpansionPanelContentDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtExpansionPanelContentDirective, "ng-template[rtExpansionPanelContent]", never, {}, {}, never, never, true, never>;
+}
+
+declare namespace IRtExpansionPanel {
+    /**
+     * Вид панели: `card` — отдельная карточка на фоне поверхности с тенью, как панель Material;
+     * `plain` — без фона, тени и отступов, для панели внутри списка, который рисует строки сам.
+     */
+    type Appearance = 'card' | 'plain';
+}
+
+/**
+ * Раскрывающаяся панель: заголовок-кнопка во всю ширину с шевроном у правого края и тело под ним.
+ * Нажатие на заголовок раскрывает и сворачивает тело, раскрытие и сворачивание идут с движением.
+ * Заменяет во втором ките панель раскрытия Material первого кита.
+ *
+ * Заголовок — содержимое панели без отметки. Тело — узел с `rtExpansionPanelBody`, созданный сразу,
+ * или `<ng-template rtExpansionPanelContent>`, созданный при раскрытии.
+ *
+ * Состояние раскрытия — `expanded`, двусторонняя привязка: панель пишет в него сама, а владелец
+ * может держать его в своём сигнале и менять извне.
+ */
+declare class RtExpansionPanelComponent {
+    #private;
+    /** Ленивое тело: шаблон создаётся при раскрытии. */
+    protected readonly lazyContent: Signal<RtExpansionPanelContentDirective | undefined>;
+    protected readonly bodyId: string;
+    protected readonly headerDomId: Signal<string>;
+    /** Тело раскрыто. Двусторонняя привязка: нажатие на заголовок пишет сюда. */
+    readonly expanded: ModelSignal<boolean>;
+    /** Заголовок не нажимается, тело остаётся как было. */
+    readonly disabled: InputSignalWithTransform<boolean, unknown>;
+    /** Шеврона нет: раскрытие читается по содержимому или его нечего раскрывать. */
+    readonly hideToggle: InputSignalWithTransform<boolean, unknown>;
+    readonly appearance: InputSignal<IRtExpansionPanel.Appearance>;
+    /** Id кнопки заголовка. Нужен владельцу, который ищет заголовок по своему номеру; иначе — свой. */
+    readonly headerId: InputSignal<string | null>;
+    /** Имя кнопки заголовка для вспомогательных средств, когда видимой подписи мало. */
+    readonly ariaLabel: InputSignal<string | null>;
+    /** Нажатие на заголовок: раскрывает свёрнутую панель и сворачивает раскрытую. */
+    toggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtExpansionPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtExpansionPanelComponent, "rt-expansion-panel", never, { "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hideToggle": { "alias": "hideToggle"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "headerId": { "alias": "headerId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, ["lazyContent"], ["*", "[rtExpansionPanelBody]"], true, never>;
+}
+
+export { IRtExpansionPanel, RtExpansionPanelComponent, RtExpansionPanelContentDirective };

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

@@ -0,0 +1,82 @@
+import * as i0 from '@angular/core';
+import { AfterContentInit, Signal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { TRtKitLabelKey, TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+
+/**
+ * Маркер проецируемого hint'а для rt-field. Нужен, когда подсказке требуется
+ * разметка (`<strong>`, интерполяция значений), которую плоский string-input
+ * `[hint]` передать не может. Если проецируемый hint присутствует — rt-field
+ * рендерит его вместо строкового `[hint]` (тот остаётся fallback'ом).
+ */
+declare class RtFieldHintDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFieldHintDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtFieldHintDirective, "[rtFieldHint]", never, {}, {}, never, never, true, never>;
+}
+
+/** Контракт поля-обёртки common/ui. */
+declare namespace IRtField {
+    /** Карта validatorKey → человекочитаемое сообщение. */
+    type ErrorMessages = Record<string, string>;
+}
+/**
+ * Ключи сообщений об ошибках по имени валидатора (перекрываются input'ом
+ * [errors] поштучно, уже готовым текстом).
+ *
+ * Здесь ключи, а не переводы: карта собирается при загрузке модуля, когда язык
+ * страницы ещё неизвестен, и готовый текст остался бы на языке по умолчанию
+ * даже под переведённой подписью поля. Переводит сам компонент поля.
+ */
+declare const RT_FIELD_DEFAULT_ERROR_KEYS: Readonly<Record<string, TRtKitLabelKey>>;
+/** Текст-плейсхолдер read-only поля без значения. */
+declare const RT_FIELD_EMPTY_VALUE: string;
+
+/**
+ * Обёртка единой анатомии поля: label (+ опц. help-иконка с popover, + авто «*»
+ * для required) сверху, спроецированный rt-контрол посередине, hint/error снизу.
+ * `required` объявляет поле обязательным там, где валидатора на контроле нет (шаблонная форма).
+ * `hideRequiredMark` глушит авто-«*» — для форм, где все поля обязательны и
+ * маркер лишний (логин).
+ * `reserveHintSpace` держит под контролом строку высотой в одно сообщение даже
+ * когда ни ошибки, ни hint нет — чтобы появление ошибки не сдвигало форму вниз
+ * (нужно для полей без постоянного hint, напр. логин).
+ *
+ * Читает контрол через contentChild(RtFormControlBase): авто-связывает label[for],
+ * прокидывает read-only режим, показывает текст ошибки/required-маркер. На loading
+ * оборачивает зону контрола в rt-skeleton-wrapper (label/hint остаются видимыми) —
+ * нужно для route-aside, где поля рендерятся до прихода данных.
+ */
+declare class RtFieldComponent implements AfterContentInit {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly projectedControl: Signal<RtFormControlBase<unknown> | undefined>;
+    protected readonly projectedHint: Signal<RtFieldHintDirective | undefined>;
+    /** Итоговый id: явный controlId контрола важнее авто-id. */
+    protected readonly controlId: Signal<string>;
+    protected readonly isRequired: Signal<boolean>;
+    protected readonly showError: Signal<boolean>;
+    /** Сообщение об ошибке: текст, переданный формой, важнее умолчания */
+    protected readonly errorText: Signal<string>;
+    protected readonly emptyValue: string;
+    readonly label: InputSignal<string>;
+    readonly hint: InputSignal<string>;
+    readonly help: InputSignal<string>;
+    readonly readonly: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Поле обязательно, хотя валидатора на контроле нет: шаблонная форма его не кладёт. Даёт «*» и
+     * ошибку под тронутым пустым полем. Форму недействительной не делает — решение о записи
+     * остаётся у формы.
+     */
+    readonly required: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly hideRequiredMark: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly reserveHintSpace: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly errors: InputSignal<IRtField.ErrorMessages>;
+    constructor();
+    ngAfterContentInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFieldComponent, "rt-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "help": { "alias": "help"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hideRequiredMark": { "alias": "hideRequiredMark"; "required": false; "isSignal": true; }; "reserveHintSpace": { "alias": "reserveHintSpace"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, {}, ["projectedControl", "projectedHint"], ["*", "[rtFieldHint]"], true, never>;
+}
+
+export { IRtField, RT_FIELD_DEFAULT_ERROR_KEYS, RT_FIELD_EMPTY_VALUE, RtFieldComponent, RtFieldHintDirective };

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

@@ -0,0 +1,114 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef, PipeTransform } from '@angular/core';
+import { TRtKitLabelMap, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import { IRtIconButton } from '@rt-tools/ui-kit-v2/icon-button';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Модель `<rt-file-card>`: один корневой неймспейс с префиксом `I`.
+ */
+declare namespace IRtFileCard {
+    /**
+     * Плотность карточки. Меняет только метрики — отступы, кегли и размеры
+     * иконок; состав остаётся прежним, как у `rt-icon-button`. Маппинг на
+     * пиксели — в SCSS (`--rt-file-card-*`) и в карте размеров иконок.
+     */
+    type Size = 'sm' | 'md' | 'lg';
+    /**
+     * Нормализованное представление файла для карточки. Источник может быть разным
+     * (локальный `File`, сохранённый DTO, вложение сообщения) — caller сводит
+     * его к этой форме.
+     */
+    interface Model {
+        /** Имя файла с расширением — из него выводятся заголовок и иконка типа. */
+        name: string;
+        /** Размер в байтах. `null` → бейдж размера скрыт (размер неизвестен). */
+        sizeBytes: number | null;
+    }
+}
+
+/**
+ * Карточка загруженного файла: цветная иконка типа, заголовок (выведенный из имени),
+ * усечённое по середине имя файла, бейдж размера и опциональные действия справа
+ * (скачать / переименовать / удалить).
+ *
+ * Презентационный компонент: сам ничего не решает, только эмиттит события действий.
+ * Кнопки включаются точечно через `showDownload`/`showRemove`/`showRename` — в режиме
+ * загрузки обычно нужен только remove, при показе сохранённых файлов — download.
+ *
+ * `showRename` по умолчанию выключен и сейчас нигде не включается: бэкенд не
+ * поддерживает переименование (`original_name` неизменяем после создания). Вход
+ * оставлен, чтобы кнопку можно было включить без правки компонента, когда появится API.
+ */
+declare class RtFileCardComponent {
+    /** Имя цветной иконки типа файла по расширению. */
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly iconName: Signal<IRtIcon.Name>;
+    /** Заголовок карточки, выведенный из имени файла (без расширения, разделители → пробелы). */
+    protected readonly title: Signal<string>;
+    /** Отформатированный размер; пустая строка → размер неизвестен. */
+    protected readonly sizeLabel: Signal<string>;
+    /** Показывать ли бейдж размера. */
+    protected readonly hasSize: Signal<boolean>;
+    /** Размер иконки типа файла — маппится от размера карточки. */
+    protected readonly iconSize: Signal<IRtIcon.Size>;
+    /** Размер кнопок действий — маппится от размера карточки. */
+    protected readonly actionSize: Signal<IRtIconButton.Size>;
+    /** Имя файла с расширением — обязательно. */
+    readonly name: InputSignal<string>;
+    /** Размер в байтах. `null` → бейдж размера скрыт. */
+    readonly sizeBytes: InputSignal<number | null>;
+    /** Плотность карточки: `sm` для тесных мест вроде композера, `lg` — для страниц. */
+    readonly size: InputSignal<IRtFileCard.Size>;
+    /** Показывать кнопку скачивания. */
+    readonly showDownload: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Показывать кнопку удаления. */
+    readonly showRemove: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Показывать кнопку переименования (отключена до появления API на бэке). */
+    readonly showRename: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Блокирует кнопки действий (например, во время сабмита формы). */
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Запрошено скачивание файла. */
+    readonly download: OutputEmitterRef<void>;
+    /** Запрошено удаление файла. */
+    readonly removed: OutputEmitterRef<void>;
+    /** Запрошено переименование файла. */
+    readonly rename: OutputEmitterRef<void>;
+    protected onDownload(): void;
+    protected onRemove(): void;
+    protected onRename(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFileCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFileCardComponent, "rt-file-card", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "sizeBytes": { "alias": "sizeBytes"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showDownload": { "alias": "showDownload"; "required": false; "isSignal": true; }; "showRemove": { "alias": "showRemove"; "required": false; "isSignal": true; }; "showRename": { "alias": "showRename"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "download": "download"; "removed": "removed"; "rename": "rename"; }, never, never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+/**
+ * Усекает длинное имя файла по середине, сохраняя расширение видимым:
+ * `10588-1_EvaluationSearchReport.pdf` → `10588-1_EvaluationSearchRe...pdf`.
+ *
+ * Обычный CSS `text-overflow: ellipsis` режет хвост и теряет расширение —
+ * поэтому усечение по середине делается здесь, а не в стилях. Усечение
+ * посимвольное (не по ширине контейнера): предсказуемо и без измерений DOM.
+ *
+ * Pure-pipe: пересчитывается только при смене входа.
+ */
+declare class RtTruncateMiddlePipe implements PipeTransform {
+    transform(value: string | null | undefined, maxLength?: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTruncateMiddlePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<RtTruncateMiddlePipe, "rtTruncateMiddle", true>;
+}
+
+/**
+ * Возвращает имя иконки типа файла по его имени (берётся расширение после
+ * последней точки). Неизвестное/отсутствующее расширение → нейтральный `attach-other`.
+ */
+declare function getFileTypeIcon(fileName: string): IRtIcon.Name;
+/**
+ * Выводит читаемый заголовок из имени файла: отбрасывает расширение и заменяет
+ * разделители `_`/`-` на пробелы (CamelCase намеренно НЕ разбивается — это давало
+ * бы непредсказуемый результат на произвольных именах). Если после очистки строка
+ * пустая (например имя было `.pdf`) — возвращается исходное имя.
+ */
+declare function deriveFileTitle(fileName: string): string;
+
+export { IRtFileCard, RtFileCardComponent, RtTruncateMiddlePipe, deriveFileTitle, getFileTypeIcon };

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

@@ -0,0 +1,75 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { WritableSignal, Signal, InputSignalWithTransform, InputSignal, OutputEmitterRef } from '@angular/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/** Контракты rt-file-drop: мультизонный оверлей и адресный drop. */
+declare namespace IRtFileDrop {
+    /** Зона drop-оверлея; зоны рисуются вертикальной стопкой равной высоты. */
+    interface Zone {
+        id: string;
+        label: string;
+        /** Вторая строка подсказки (акцентная, под label). */
+        sublabel?: string;
+    }
+    /** Результат drop'а при мультизонном режиме: файлы + зона, куда их бросили. */
+    interface ZoneDrop {
+        zoneId: string;
+        files: File[];
+    }
+}
+
+/**
+ * Зона перетаскивания файлов: оборачивает произвольный контент через
+ * content-projection и превращает его в drop-зону. При перетаскивании файла над
+ * областью рисует приглушающий оверлей-приглашение поверх контента, на drop —
+ * эмитит выброшенные файлы через `(filesDropped)`.
+ *
+ * Мультизонный режим: при непустом `zones` оверлей делится на вертикальную стопку
+ * равных зон с подписями; зона под курсором подсвечивается, drop эмитится через
+ * `(zoneFilesDropped)` с id зоны (а `(filesDropped)` в этом режиме НЕ эмитится).
+ * Зона курсора вычисляется по Y-координате против host-rect — оверлей остаётся
+ * pointer-events:none, drag-события продолжают идти в host-listener'ы.
+ *
+ * `accept` (формат как у нативного input[accept]) отфильтровывает неподходящие
+ * файлы до эмита — drop в обход файл-пикера не проносит запрещённые расширения;
+ * отбрасывание молчаливое, как у самого пикера.
+ *
+ * Слушает drag-события на собственном host'е (всплывают со всего спроецированного
+ * контента), гасит браузерный навигейт по файлу и принимает только перетаскивание
+ * файлов (а не внутренний drag элементов формы). Потребитель управляет приёмом
+ * через `[disabled]` (например «активна вкладка файлов и форма редактируема») и
+ * сам решает, что делать с файлами — компонент состояние файлов не хранит.
+ *
+ * Оверлей `pointer-events: none` — не перехватывает drag/drop, события доходят до
+ * host-listener'ов.
+ */
+declare class RtFileDropComponent {
+    #private;
+    /** Активна ли подсветка drop-зоны (файл тащат над областью). */
+    protected readonly isDragging: WritableSignal<boolean>;
+    /** Зона под курсором в мультизонном режиме (id из `zones`). */
+    protected readonly activeZoneId: WritableSignal<string | null>;
+    protected readonly hasZones: Signal<boolean>;
+    protected readonly overlayText: Signal<string>;
+    /** Приём drop'а выключен (потребитель решает по своему контексту). */
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly overlayLabel: InputSignal<string>;
+    /** Мультизонный режим: непустой список зон делит оверлей на стопку целей. */
+    readonly zones: InputSignal<readonly IRtFileDrop.Zone[]>;
+    /** Фильтр расширений/MIME (формат нативного input[accept]); пусто — без фильтра. */
+    readonly accept: InputSignal<string>;
+    readonly filesDropped: OutputEmitterRef<File[]>;
+    /** Drop в мультизонном режиме: файлы + id зоны, куда их бросили. */
+    readonly zoneFilesDropped: OutputEmitterRef<IRtFileDrop.ZoneDrop>;
+    readonly draggingChange: OutputEmitterRef<boolean>;
+    constructor();
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFileDropComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFileDropComponent, "rt-file-drop", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "overlayLabel": { "alias": "overlayLabel"; "required": false; "isSignal": true; }; "zones": { "alias": "zones"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; }, { "filesDropped": "filesDropped"; "zoneFilesDropped": "zoneFilesDropped"; "draggingChange": "draggingChange"; }, never, ["*"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { IRtFileDrop, RtFileDropComponent };

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

@@ -0,0 +1,48 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, ElementRef, InputSignalWithTransform, InputSignal } from '@angular/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+
+/**
+ * Поле выбора файлов: кнопка «выбрать» + список выбранных файлов карточками
+ * `rt-file-card` (иконка типа, имя, размер, удаление). Скрывает нативный
+ * `<input type="file">`, value хранит как `File[]` (одиночный режим = максимум
+ * один файл). CVA через общий `RtFormControlBase`. Read-only представление —
+ * имена файлов через запятую.
+ *
+ * Без drag-drop (MVP). `accept` пробрасывается в нативный input, `multiple`
+ * включает множественный выбор.
+ */
+declare class RtFileInputComponent extends RtFormControlBase<File[]> {
+    #private;
+    protected readonly fileEl: Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly buttonText: Signal<string>;
+    protected readonly hasValue: Signal<boolean>;
+    readonly displayText: Signal<string>;
+    readonly multiple: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly accept: InputSignal<string | null>;
+    /**
+     * Выбор каталога целиком вместо отдельных файлов. Браузер отдаёт
+     * относительные пути (`webkitRelativePath`), по ним вызывающая сторона
+     * восстанавливает структуру — иначе пользователю пришлось бы выбирать
+     * десятки файлов по одному.
+     */
+    readonly directory: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Пусто — берётся переведённая подпись по умолчанию */
+    readonly buttonLabel: InputSignal<string>;
+    protected getEmptyValue(): File[];
+    protected focusAfterClear(): void;
+    protected openPicker(): void;
+    protected onFiles(event: Event): void;
+    protected removeFile(index: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFileInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFileInputComponent, "rt-file-input", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "directory": { "alias": "directory"; "required": false; "isSignal": true; }; "buttonLabel": { "alias": "buttonLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Контракт rt-file-input. */
+declare namespace IRtFileInput {
+    /** value контрола — всегда массив (одиночный режим = максимум 1 файл). */
+    type Value = File[];
+}
+
+export { IRtFileInput, RtFileInputComponent };

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

@@ -0,0 +1,13 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Вертикальный контейнер для карточек файлов (`rt-file-card`): задаёт отступы между
+ * карточками и растягивает их по ширине. Чисто презентационный — содержимое
+ * проецируется через `<ng-content />`, логику списка держит caller.
+ */
+declare class RtFileListComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFileListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFileListComponent, "rt-file-list", never, {}, {}, never, ["*"], true, never>;
+}
+
+export { RtFileListComponent };

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

@@ -0,0 +1,72 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { IRtSelect } from '@rt-tools/ui-kit-v2/select';
+import { IRtIcon } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Модель `<rt-filter-control>`: один корневой неймспейс с
+ * префиксом `I`. Форма опции повторяет `IRtToggleButtonGroup.Option`, поэтому
+ * существующие массивы фильтров присваиваются структурно, без кастов. Generic
+ * `T` пробрасывается в `Option<T>`.
+ */
+declare namespace IRtFilterControl {
+    /** Размерный тир — совпадает с rt-toggle-button-group / rt-select. */
+    type Size = 'sm' | 'md' | 'lg';
+    /**
+     * Описание одной опции фильтра.
+     *
+     * - `value` — эмитится в `valueChange`.
+     * - `label` — текстовая подпись.
+     * - `icon` / `title` — используются только сегментами (десктоп); rt-select
+     *   в узком режиме их игнорирует.
+     */
+    interface Option<T = string> {
+        readonly value: T;
+        readonly label: string;
+        readonly icon?: IRtIcon.Name;
+        readonly title?: string;
+    }
+}
+
+/**
+ * Адаптивный фильтр-контрол для тулбаров list-страниц.
+ *
+ * Один и тот же набор опций рендерится двумя способами по ширине вьюпорта:
+ *  - десктоп (> 1080px) — развёрнутые сегменты `rt-toggle-button-group`;
+ *  - узкий экран (≤ 1080px, `BreakpointsService.narrow`) — компактный
+ *    `rt-select` с `clearable=false` (сброс — через явную опцию «Все»).
+ *
+ * API повторяет controlled-контракт rt-toggle-button-group (`[options]` /
+ * `[value]` / `(valueChange)`), поэтому миграция потребителя — смена селектора
+ * без правки хендлеров. Sentinel «нет фильтра» задаёт сам потребитель реальным
+ * значением опции («»/false), а не `null`/`undefined` — rt-select всегда
+ * показывает выбранную опцию.
+ *
+ * Generic `<T = string>` сохраняет типизацию по value (union'ы, enum'ы).
+ */
+declare class RtFilterControlComponent<T = string> {
+    #private;
+    protected readonly isNarrow: Signal<boolean>;
+    /** Проекция опций фильтра в форму rt-select (icon/title отбрасываются). */
+    protected readonly selectOptions: Signal<ReadonlyArray<IRtSelect.Option<T>>>;
+    readonly options: InputSignal<ReadonlyArray<IRtFilterControl.Option<T>>>;
+    readonly value: InputSignal<T | undefined>;
+    readonly ariaLabel: InputSignal<string | null>;
+    readonly placeholder: InputSignal<string>;
+    /**
+     * Размер сегментов (десктоп). На узком экране select всегда рендерится в md,
+     * чтобы совпадать по высоте и ширине со строкой поиска list-страницы.
+     */
+    readonly size: InputSignal<IRtFilterControl.Size>;
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Растягивает сегменты на всю ширину контейнера (только десктоп-вариант). */
+    readonly fullWidth: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly valueChange: OutputEmitterRef<T>;
+    protected onValueChange(value: T): void;
+    protected onSelectionChange(value: T | null): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFilterControlComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtFilterControlComponent<any>, "rt-filter-control", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
+export { IRtFilterControl, RtFilterControlComponent };

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

@@ -0,0 +1,74 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { OnInit, WritableSignal, Signal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import { ControlValueAccessor, ValidationErrors } from '@angular/forms';
+import { IRtInput } from '@rt-tools/ui-kit-v2/core';
+
+declare abstract class RtFormControlBase<TValue> implements ControlValueAccessor, OnInit {
+    #private;
+    protected readonly value: WritableSignal<TValue>;
+    /**
+     * Отключение: вход и форма — два независимых источника, поле отключено,
+     * если так сказал любой из них. Сводить их в один signal нельзя: форма
+     * зовёт `setDisabledState` при связывании контрола, то есть раньше, чем
+     * поле впервые обновит своё вью, и мирроринг входа затирал бы её слово —
+     * контрол, созданный отключённым, оказывался бы редактируемым.
+     */
+    protected readonly isDisabled: Signal<boolean>;
+    protected readonly isInvalid: Signal<boolean>;
+    /** Видимость кнопки очистки: включена, есть значение, поле активно. */
+    protected readonly showClearButton: Signal<boolean>;
+    /** Есть ли в поле значение — гейт видимости крестика. */
+    protected abstract readonly hasValue: Signal<boolean>;
+    readonly size: InputSignal<IRtInput.Size>;
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly controlId: InputSignal<string | null>;
+    readonly ariaLabel: InputSignal<string | null>;
+    readonly clearable: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Видимая resting-рамка контрола. По умолчанию `true` — рамка видна на обеих
+     * темах. `false` снимает только resting-рамку; focus/invalid состояния свою
+     * рамку показывают всё равно, read-only остаётся плоским.
+     */
+    readonly bordered: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Итоговый id поля: явный input важнее авто-id, назначенного rt-field. */
+    readonly effectiveControlId: Signal<string | null>;
+    /** Read-only режим (плоский текст вместо контрола); включается rt-field'ом. */
+    readonly isReadonly: Signal<boolean>;
+    /** Публичный invalid для rt-field (touched/dirty учтён в состоянии). */
+    readonly invalid: Signal<boolean>;
+    /** Текущие ошибки связанного контрола — источник текста ошибки в rt-field. */
+    readonly errors: Signal<ValidationErrors | null>;
+    /** Обязателен ли контрол — по валидатору формы или по слову rt-field. Для авто-«*». */
+    readonly required: Signal<boolean>;
+    /** Текст read-only представления. Реализуется конкретным контролом. */
+    abstract readonly displayText: Signal<string>;
+    constructor();
+    ngOnInit(): void;
+    writeValue(value: TValue | null): void;
+    registerOnChange(fn: (value: TValue) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /** Назначить авто-id (rt-field), когда у контрола нет явного controlId. */
+    assignControlId(id: string): void;
+    /** Включить/выключить read-only режим — вызывает родительский rt-field. */
+    setReadonly(value: boolean): void;
+    /** Объявить контрол обязательным — вызывает родительский rt-field. */
+    setRequired(value: boolean): void;
+    /** Очистка значения по кнопке-крестику + возврат фокуса в поле. */
+    protected clear(event?: Event): void;
+    /** Сбрасывает значение к пустому. Поля с display-сигналом расширяют. */
+    protected clearValue(): void;
+    /** Прокидывает change наружу — для обработчиков пользовательского ввода. */
+    protected emitChange(value: TValue): void;
+    /** Помечает контрол touched — для blur/close-обработчиков. */
+    protected markTouched(): void;
+    /** Пустое значение поля (тип-специфично: "", null, []). */
+    protected abstract getEmptyValue(): TValue;
+    /** Возврат фокуса после очистки (в input или на trigger-кнопку). */
+    protected abstract focusAfterClear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtFormControlBase<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtFormControlBase<any>, never, never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { RtFormControlBase };

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

@@ -0,0 +1,40 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { Signal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Общий хедер приложения.
+ *
+ * Слева — slot 35×45 под back-button (rt-icon-button arrow-left, ghost variant),
+ * который виден по входному сигналу `canGoBack` и эмитит `backClick`. Когда
+ * `canGoBack=false` (default) — slot полностью скрыт через display:none, wordmark
+ * выравнивается слева.
+ *
+ * Далее — wordmark, справа — action-иконки (rt-icon-button шагом md): опциональная «Пригласить пользователя»
+ * (`showInvite`), слот колокольчика и профиль.
+ *
+ * Колокольчик уведомлений — проекция `[rtHeaderBell]`: домен кладёт в слот
+ * `rt-notifications-bell` (общий попап-компонент), хедер про его устройство не знает.
+ *
+ * Темизация — через семантические `--rt-color-bg-surface` / `--rt-color-text-primary`,
+ * dark override карточного фона выполняется в SCSS (header navy совпадает с фоном
+ * страницы в dark).
+ */
+declare class RtHeaderComponent {
+    protected readonly t: Signal<TRtKitLabelMap>;
+    readonly canGoBack: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Показывать action-иконку «Пригласить пользователя» слева от колокола. */
+    readonly showInvite: InputSignalWithTransform<boolean, boolean | string>;
+    readonly backClick: OutputEmitterRef<void>;
+    readonly inviteClick: OutputEmitterRef<void>;
+    readonly profileClick: OutputEmitterRef<void>;
+    protected onBackClick(): void;
+    protected onInviteClick(): void;
+    protected onProfileClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtHeaderComponent, "rt-header", never, { "canGoBack": { "alias": "canGoBack"; "required": false; "isSignal": true; }; "showInvite": { "alias": "showInvite"; "required": false; "isSignal": true; }; }, { "backClick": "backClick"; "inviteClick": "inviteClick"; "profileClick": "profileClick"; }, never, ["[rtHeaderBell]"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtHeaderComponent };