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

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

@@ -0,0 +1,739 @@
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { WritableSignal, Signal, InputSignal, InputSignalWithTransform, TemplateRef, PipeTransform, OutputEmitterRef, ModelSignal } from '@angular/core';
+import { IRtIconButton } from '@rt-tools/ui-kit-v2/icon-button';
+import { IRtIcon, TRtKitLabelMap } from '@rt-tools/ui-kit-v2/core';
+import { TFilterOperatorType, ISortModel, TListSortOrderType, IFilterModel } from '@rt-tools/utils';
+import { CdkTable, CdkColumnDef, CdkTableDataSourceInput } from '@angular/cdk/table';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+import { Observable } from 'rxjs';
+import { RtRouteAsideComponent } from '@rt-tools/ui-kit-v2/container';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import { FormControl } from '@angular/forms';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+import { IRtSelect } from '@rt-tools/ui-kit-v2/select';
+
+/** Значение для буфера: явная строка/число либо `null` (тогда берётся отображаемый текст). */
+type TCopyValue = string | number | null;
+/**
+ * Ячейка с копированием в буфер — переиспользуемый примитив для `cdkCellDef`
+ * (и не только). rt-table projection-driven: контент ячейки пишет
+ * потребитель, поэтому копирование оформлено отдельным cell-level компонентом,
+ * а не флагом на конфиге колонки.
+ *
+ * Потребитель проецирует отображаемый контент через `<ng-content>`. Что уйдёт в
+ * буфер:
+ * - если задан `[value]` — ровно он (нужно когда копируемое отличается от
+ *   отображаемого: для id-ячейки показываем `#123`, копируем `123`);
+ * - если `[value]` не задан — берётся отображаемый текст (textContent
+ *   проецируемого контента, схлопнутые пробелы) — «копировать как показано»,
+ *   удобно для составных ячеек (`#7 — Имя`).
+ *
+ * По умолчанию кнопка скрыта и проявляется при наведении/фокусе (для плотных
+ * таблиц). Вне таблиц (модалки, карточки) строки для hover нет — там
+ * `revealOnHover="false"` держит кнопку всегда видимой. Палитра кнопки —
+ * через `variant` (по умолчанию `ghost`). После клика на `RESET_DELAY_MS`
+ * иконка меняется `copy`→`check`, подпись — на «Скопировано».
+ */
+declare class RtCopyCellComponent {
+    #private;
+    protected readonly copied: WritableSignal<boolean>;
+    /**
+     * Подсказка со значением целиком — только у обрезанного.
+     *
+     * У помещающегося она повторяла бы то, что человек и так читает, и всплывала бы над каждой
+     * ячейкой таблицы; пустая строка директиву подсказки выключает.
+     */
+    protected readonly hint: WritableSignal<string>;
+    protected readonly iconName: Signal<IRtIcon.Name>;
+    protected readonly actionLabel: Signal<string>;
+    /**
+     * Строка для буфера. Если не задана — копируется отображаемый текст
+     * (textContent проецируемого контента). Число приводится к строке.
+     */
+    readonly value: InputSignal<TCopyValue>;
+    /** Палитра кнопки копирования. В таблицах — `ghost`; вне таблиц удобнее `secondary`. */
+    readonly variant: InputSignal<IRtIconButton.Variant>;
+    /**
+     * Прятать кнопку до наведения/фокуса (поведение плотных таблиц). `false` —
+     * кнопка всегда видима: нужно вне таблиц (модалки/карточки), где нет строки
+     * для hover.
+     */
+    readonly revealOnHover: InputSignalWithTransform<boolean, BooleanInput>;
+    constructor();
+    /**
+     * Замер обрезки в момент наведения.
+     *
+     * Ширина известна только отрисованному узлу, а меняется она и от переезда столбца, и от
+     * ширины окна: посчитанная один раз при заведении, она соврала бы при первом же изменении.
+     */
+    protected measureTruncation(): void;
+    protected onCopy(event: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtCopyCellComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtCopyCellComponent, "rt-copy-cell", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "revealOnHover": { "alias": "revealOnHover"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Контракты `rt-table` — стилизованная обёртка над `cdk-table` из `@angular/cdk/table`.
+ * Один корневой неймспейс с префиксом `I`.
+ *
+ * Сама декларация колонок (`cdkColumnDef`, `*cdkHeaderCellDef`, `*cdkCellDef`) и
+ * строк (`*cdkHeaderRowDef`, `*cdkRowDef`) живёт на стороне consumer'а — пишется
+ * в шаблоне через template-projection. rt-table даёт визуальный treatment
+ * (border 1px, height 50px, padding 16px 20px, hover-строка, `density`).
+ */
+
+declare namespace IRtTable {
+    /** Плотность таблицы — модификатор `rt-table--density--<value>`. */
+    type Density = 'default' | 'compact';
+    /**
+     * Есть ли у строки хотя бы одно доступное действие. Заполняется экраном тем же
+     * признаком, которым он гейтит сами пункты меню.
+     */
+    type RowActionsPredicate<TRow> = (row: TRow) => boolean;
+    /**
+     * Метаданные колонки для настраиваемых таблиц (панель настроек: видимость + порядок).
+     * `key` совпадает с `cdkColumnDef` и именем в `displayedColumns`. Порядок по умолчанию —
+     * позиция в массиве `[columnsConfig]`.
+     */
+    interface ColumnConfig {
+        key: string;
+        label: string;
+        /** Скрыта по умолчанию (пользователь может показать в панели). Default false. */
+        hidden?: boolean;
+        /** Нельзя скрыть/переместить — всегда видима на своём месте. Default false. */
+        locked?: boolean;
+        /** Заголовок колонки переключает порядок строк. Default false. */
+        sortable?: boolean;
+        /** Чем колонка отбирает. Без этого поля отбора у колонки нет вовсе. */
+        filter?: IRtTable.ColumnFilter;
+    }
+    /**
+     * Одна ячейка строки отбора: ключ колонки и её отбор. `null` в отборе значит, что колонка
+     * ничего не отбирает, — ячейка рисуется пустой и держит место колонки.
+     */
+    interface FilterCell {
+        key: string;
+        filter: IRtTable.ColumnFilter | null;
+        /** Ячейка колонки действий строки: она нулевая, как шапка и ячейки этой колонки. */
+        actions: boolean;
+    }
+    /** Каким видом колонка отбирает: вид решает, какую готовую часть кита позовёт шапка. */
+    type FilterKind = 'text' | 'number' | 'select' | 'date';
+    /**
+     * Чем колонка отбирает. Вид объявляет колонка, а не угадывает значение: догадка по значению
+     * читает пустую колонку как текст, и колонка получает сравнение, которого не обещала.
+     *
+     * `operators` — те виды сравнения, которые колонка разрешает; `startOperator` — тот, с
+     * которого она начинает. `options` нужны только виду `select`.
+     */
+    interface ColumnFilter {
+        kind: IRtTable.FilterKind;
+        operators?: readonly TFilterOperatorType[];
+        startOperator?: TFilterOperatorType;
+        options?: readonly IRtTable.FilterOption[];
+    }
+    /** Один вариант выбора для отбора вида `select`. */
+    interface FilterOption {
+        value: string | number;
+        label: string;
+    }
+    /** Текущее состояние настроек колонок (порядок ключей + скрытые ключи), применяемое к рендеру. */
+    interface ColumnSettings {
+        order: string[];
+        hidden: string[];
+    }
+    /** Строка списка в панели настроек: конфиг колонки + разрешённое «скрыта». */
+    interface ColumnSettingItem extends ColumnConfig {
+        hidden: boolean;
+    }
+}
+
+/** Значение атрибута `aria-sort` заголовка: направление либо его отсутствие. */
+type TRtTableAriaSort = 'ascending' | 'descending' | 'none';
+/**
+ * Следующее состояние сортировки при нажатии на заголовок колонки.
+ *
+ * Порядок кругов: по возрастанию → по убыванию → без сортировки. Третье состояние
+ * нужно, чтобы пользователь мог вернуть исходный порядок, не перезагружая список.
+ */
+declare function nextSort(current: ISortModel<string> | null, propertyName: string): ISortModel<string> | null;
+/** Направление сортировки по этой колонке либо `null`, когда сортирует другая. */
+declare function sortDirectionOf(current: ISortModel<string> | null, propertyName: string): TListSortOrderType | null;
+/** Значение `aria-sort` заголовка: направление читается скринридером с самой колонки. */
+declare function ariaSortOf(current: ISortModel<string> | null, propertyName: string): TRtTableAriaSort;
+/**
+ * Сортируется ли колонка. Колонка, описанная в `columnsConfig`, сортируется только
+ * по своему признаку; колонки, которой в конфиге нет, метаданных взять неоткуда —
+ * объявлением служит сам заголовок.
+ */
+declare function isColumnSortable(config: ReadonlyArray<IRtTable.ColumnConfig>, key: string): boolean;
+
+/**
+ * Заголовок сортируемой колонки — атрибутом на ячейке шапки:
+ * `<th *cdkHeaderCellDef cdk-header-cell rtSortHeader="checkIn">Заезд</th>`.
+ *
+ * Подпись проецируется внутрь кнопки, и доступное имя кнопки берётся из неё — порядок
+ * меняется не только мышью. Текущее направление читается с самой колонки через
+ * `aria-sort`, а видно его по стрелке.
+ *
+ * Колонка сортируется, только когда помечена `sortable` в `[columnsConfig]` таблицы;
+ * иначе заголовок остаётся обычной подписью. Элементная форма селектора нужна правилу
+ * префиксов и в разметке не применяется: `aria-sort` принадлежит ячейке шапки.
+ */
+declare class RtTableSortHeaderComponent {
+    #private;
+    /** Направление сортировки по этой колонке; `null` — сортирует другая либо никакая. */
+    protected readonly direction: Signal<TListSortOrderType | null>;
+    protected readonly icon: Signal<IRtIcon.Name>;
+    protected readonly sortable: Signal<boolean>;
+    /** Ключ колонки — тот же, что в `cdkColumnDef` и в `[columnsConfig]`. */
+    readonly rtSortHeader: InputSignal<string>;
+    readonly ariaSort: Signal<TRtTableAriaSort>;
+    protected onToggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableSortHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtTableSortHeaderComponent, "rt-table-sort-header, th[rtSortHeader]", never, { "rtSortHeader": { "alias": "rtSortHeader"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Контекст шаблона `[rtTableCard]`: `$implicit` — строка таблицы.
+ */
+interface IRtTableCardContext<TRow> {
+    $implicit: TRow;
+}
+/**
+ * Захватывает `<ng-template rtTableCard let-row>` — кастомную разметку карточки
+ * строки для мобильного (узкого) режима `rt-table`. Когда задан, rt-table на
+ * узком экране (≤1080px) рендерит эту разметку в `<article>` вместо
+ * авто-карточки «label: value» по колонкам.
+ *
+ * Escape-hatch для страниц, которым нужна rich-карточка (составной primary-блок,
+ * теги, произвольная раскладка), а не построчный список полей.
+ *
+ * @example
+ * ```html
+ * <rt-table #t="rtTable" [dataSource]="rows" ...>
+ *     ...колонки...
+ *     <ng-template rtTableCard [rtTableCardRowType]="rows" let-row>
+ *         <div class="my-card-head">{{ row.login }}</div>
+ *     </ng-template>
+ *     <tr cdk-row *cdkRowDef="let row; columns: t.displayedColumns()"></tr>
+ * </rt-table>
+ * ```
+ */
+declare class RtTableCardDirective<TRow = unknown> {
+    readonly template: TemplateRef<IRtTableCardContext<TRow>>;
+    /**
+     * Type-carrier для вывода `TRow`: биндят тот же массив, что в `dataSource`.
+     * Значение в рантайме не читается — служит только подсказкой типизации для
+     * `let-row` (через `ngTemplateContextGuard`).
+     */
+    readonly rtTableCardRowType: InputSignal<readonly TRow[]>;
+    /** Type-guard: сужает контекст шаблона до строки таблицы при проверке шаблонов. */
+    static ngTemplateContextGuard<TRow>(_directive: RtTableCardDirective<TRow>, context: unknown): context is IRtTableCardContext<TRow>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableCardDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtTableCardDirective<any>, "ng-template[rtTableCard]", never, { "rtTableCardRowType": { "alias": "rtTableCardRowType"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Контекст шаблона `[rtTableRowActions]`: `$implicit` — строка таблицы.
+ */
+interface IRtTableRowActionsContext<TRow> {
+    $implicit: TRow;
+}
+/**
+ * Захватывает `<ng-template rtTableRowActions let-row>` — содержимое «…»-меню
+ * действий строки. `rt-table` (`[showRowActions]`) рендерит этот шаблон в конце
+ * каждой строки внутри `rt-menu`, прокидывая строку через `$implicit`.
+ *
+ * Тип `let-row` выводится из `[rtTableRowActionsRowType]` (передаётся тот же
+ * массив, что в `dataSource`) — type-carrier, как `*ngFor` выводит тип из
+ * `ngForOf`. В рантайме значение не используется.
+ *
+ * @example
+ * ```html
+ * <rt-table #t="rtTable" [columns]="cols" [showRowActions]="true" [dataSource]="rows" ...>
+ *     ...колонки...
+ *     <ng-template rtTableRowActions [rtTableRowActionsRowType]="rows" let-row>
+ *         <rt-menu-item icon="ico-edit" label="Редактировать" (selected)="edit(row)" />
+ *     </ng-template>
+ *     <tr cdk-header-row *cdkHeaderRowDef="t.displayedColumns()"></tr>
+ *     <tr cdk-row *cdkRowDef="let row; columns: t.displayedColumns()"></tr>
+ * </rt-table>
+ * ```
+ */
+declare class RtTableRowActionsDirective<TRow = unknown> {
+    readonly template: TemplateRef<IRtTableRowActionsContext<TRow>>;
+    /**
+     * Type-carrier для вывода `TRow`: биндят тот же массив, что в `dataSource`.
+     * Значение в рантайме не читается — служит только подсказкой типизации для
+     * `let-row` (через `ngTemplateContextGuard`). Имя совпадает с binding'ом —
+     * без alias, чтобы не триггерить `no-input-rename`.
+     */
+    readonly rtTableRowActionsRowType: InputSignal<readonly TRow[]>;
+    /** Type-guard: сужает контекст шаблона до строки таблицы при проверке шаблонов. */
+    static ngTemplateContextGuard<TRow>(_directive: RtTableRowActionsDirective<TRow>, context: unknown): context is IRtTableRowActionsContext<TRow>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableRowActionsDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtTableRowActionsDirective<any>, "ng-template[rtTableRowActions]", never, { "rtTableRowActionsRowType": { "alias": "rtTableRowActionsRowType"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Есть ли у строки хотя бы одно доступное действие.
+ *
+ * Признак приходит предикатом от экрана, а не подсчётом отрисованных пунктов меню:
+ * содержимое спроецированного шаблона известно только после отрисовки, и кнопка
+ * успевала бы мигнуть на первом кадре.
+ *
+ * Предикат не задан — у строки есть действия: экран, который ничего не гейтит,
+ * показывает кнопку меню, как и раньше.
+ */
+declare function rowHasAvailableActions<TRow>(row: TRow, hasActions: IRtTable.RowActionsPredicate<TRow> | null): boolean;
+
+/**
+ * Есть ли у строки доступные действия — гейт кнопки «…» в ячейке действий.
+ *
+ * Pure-pipe: пересчитывается только при смене строки или предиката, а не на каждом
+ * цикле проверки. Значение приходит из контекста шаблона (строка таблицы), поэтому
+ * `computed()` здесь неприменим.
+ */
+declare class RtRowHasActionsPipe implements PipeTransform {
+    transform<TRow>(row: TRow, hasActions: IRtTable.RowActionsPredicate<TRow> | null): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtRowHasActionsPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<RtRowHasActionsPipe, "rtRowHasActions", true>;
+}
+
+/**
+ * Делает строку таблицы (`<tr cdk-row>`) активируемой — общий паттерн «клик по
+ * строке открывает деталь/асайд». Инкапсулирует доступность: строка становится
+ * focusable, активируется кликом и Enter/Space, наружу отдаёт `(activated)`.
+ *
+ * Клик/клавиша по интерактивному потомку (кнопка/ссылка/контрол) активацией
+ * строки НЕ считается — иначе вложенные действия конфликтовали бы с переходом.
+ * Роль строки не переопределяется (table-семантика для скрин-ридеров сохраняется).
+ * Визуальный аффорданс (cursor/hover/focus-ring) включает `[clickable]` на rt-table.
+ */
+declare class RtTableRowDirective {
+    readonly activated: OutputEmitterRef<void>;
+    protected onClick(event: MouseEvent): void;
+    protected onKey(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableRowDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtTableRowDirective, "[rtTableRow]", never, {}, { "activated": "activated"; }, never, never, true, never>;
+}
+
+/** Имя внутренней «…»-колонки действий, добавляемой при `[showRowActions]`. */
+declare const RT_TABLE_ROW_ACTIONS_COLUMN: string;
+/**
+ * Колонки конфига без применённых настроек пользователя — источник для кнопки
+ * «Сбросить» в панели. Закрытая колонка видима всегда: скрыть её панель не даёт.
+ */
+declare function defaultColumnItems(config: ReadonlyArray<IRtTable.ColumnConfig>): ReadonlyArray<IRtTable.ColumnSettingItem>;
+/**
+ * Разрешённые колонки настраиваемой таблицы: конфиг в применённом порядке с текущим
+ * признаком скрытия.
+ *
+ * Порядок берётся из сохранённых настроек, а колонки, появившиеся в конфиге после
+ * сохранения, встают в конец: настройки, снятые с прежнего состава, иначе прятали бы
+ * новую колонку молча. Настроек нет — порядок и скрытие берутся из самого конфига.
+ */
+declare function resolveColumns(config: ReadonlyArray<IRtTable.ColumnConfig>, settings: IRtTable.ColumnSettings | null): ReadonlyArray<IRtTable.ColumnSettingItem>;
+/**
+ * Имена колонок для строк CDK: у настраиваемой таблицы — видимые в применённом порядке,
+ * у остальных — то, что назвал вход `[columns]`. Колонка действий встаёт последней, когда
+ * действия строки включены.
+ */
+declare function displayedColumnKeys(resolved: ReadonlyArray<IRtTable.ColumnSettingItem>, legacyColumns: ReadonlyArray<string>, configurable: boolean, showRowActions: boolean): ReadonlyArray<string>;
+/**
+ * Настройки панели, приведённые к конфигу: ключи закрытых колонок из списка скрытых
+ * вычищаются. Панель их не предлагает, но настройки приезжают и из хранилища — снятые с
+ * той поры, когда колонка закрытой ещё не была.
+ */
+declare function withoutLockedHidden(config: ReadonlyArray<IRtTable.ColumnConfig>, settings: IRtTable.ColumnSettings): IRtTable.ColumnSettings;
+
+/**
+ * Поле авто-карточки узкого экрана: подпись колонки и её шаблон ячейки. Значение рисуется
+ * тем же шаблоном, что и в строке таблицы, — второй разметки у карточки нет.
+ */
+interface IRtTableCardColumn<TRow> {
+    key: string;
+    label: string;
+    cell: TemplateRef<IRtTableCardContext<TRow>>;
+}
+
+/**
+ * Таблица — стилизованная обёртка над `cdk-table` (`@angular/cdk/table`).
+ *
+ * Селектор работает и как element (`<rt-table>`), и как attribute на native `<table rt-table>`.
+ * Native-вариант предпочтительнее — даёт правильную table-семантику для скрин-ридеров, но
+ * наложения загрузки, пустого места и заглушек требуют element-варианта: `<div>` не валиден как
+ * ребёнок `<table>`.
+ *
+ * Какие состояния таблица различает и чем рисует каждое — в заметке семьи рядом, `CONTEXT.md`.
+ */
+declare class RtTableComponent<TRow> extends CdkTable<TRow> {
+    #private;
+    /** Колонка действий и её ячейки: регистрируются в CdkTable вручную — почему, сказано в `CONTEXT.md`. */
+    private readonly actionsColumnDef?;
+    private readonly actionsCellDef?;
+    private readonly actionsHeaderCellDef?;
+    /**
+     * Роль хоста: у native `<table rt-table>` она есть от самого тега, а элементному
+     * `<rt-table>` её ставим сами. Без неё скрин-ридер читает список строками текста: роли
+     * строк и ячеек CDK проставляет сам, а роли самой таблицы у него нет, и проставленные
+     * остаются висеть вне таблицы. Считается один раз — тег хоста по ходу жизни не меняется.
+     */
+    protected readonly hostRole: 'table' | null;
+    /** `true` когда initial-load в полёте и entities ещё нет — рендерим skeleton rows. */
+    protected readonly isInitialLoading: Signal<boolean>;
+    /** `true` когда загрузка завершена и entities пустые — рендерим empty placeholder. */
+    protected readonly isEmpty: Signal<boolean>;
+    /** Массив для `@for` — числа от 0 до skeletonRows-1, рендерим placeholder-rows. */
+    protected readonly skeletonRowIndexes: Signal<ReadonlyArray<number>>;
+    /** Шаблон содержимого «…»-меню действий строки (`<ng-template rtTableRowActions>`). */
+    protected readonly rowActions: Signal<RtTableRowActionsDirective | undefined>;
+    /** Кастомный шаблон карточки мобильного режима (`<ng-template rtTableCard>`). Опционален. */
+    protected readonly cardTemplate: Signal<RtTableCardDirective | undefined>;
+    /**
+     * Все проецируемые потребителем `cdkColumnDef` — источник cell-шаблонов для
+     * авто-карточек. «…»-колонка действий объявлена во view rt-table, поэтому в
+     * этот content-query не попадает.
+     */
+    protected readonly columnDefs: Signal<ReadonlyArray<CdkColumnDef>>;
+    /** Узкий вьюпорт (≤1080px): таблица прячется, строки рендерятся карточками. */
+    protected readonly isNarrow: Signal<boolean>;
+    /** Карточки показываются только когда card-режим включён (`[cards]`) и экран узкий. */
+    protected readonly showCards: Signal<boolean>;
+    /**
+     * Строки для карточек узкого экрана. Признак `#dataSourceVersion` пересчитывает список
+     * при смене источника: CDK хранит его полем, а не сигналом.
+     */
+    protected readonly cardRows: Signal<ReadonlyArray<TRow>>;
+    /** Поля авто-карточки узкого экрана: видимые колонки с подписью и шаблоном ячейки. */
+    protected readonly cardColumns: Signal<ReadonlyArray<IRtTableCardColumn<TRow>>>;
+    /** ContentChild template для кастом empty-placeholder'а. Опционален; fallback — emptyMessage. */
+    readonly emptyTemplate: Signal<TemplateRef<unknown> | undefined>;
+    /** ARIA-label корневого `<table>` (или `<rt-table>` элемента). */
+    readonly ariaLabel: InputSignal<string | null>;
+    /** Плотность: `"compact"` уменьшает padding и высоту ячеек. */
+    readonly density: InputSignal<IRtTable.Density>;
+    /**
+     * Мобильный card-режим на узком экране (≤1080px): таблица рендерится списком
+     * карточек «поле: значение». Включён по умолчанию для всех списков. Отключать
+     * (`[cards]="false"`) для не-списочных таблиц — например, key-value quote-таблицы
+     * внутри асайда, где карточки дублируют смысл.
+     */
+    readonly cards: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Строки кликабельны (открывают деталь/асайд). Включает визуальный аффорданс
+     * (cursor/focus-ring); саму активацию + a11y обеспечивает директива
+     * `rtTableRow` на `<tr cdk-row>`.
+     */
+    readonly clickable: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Initial-load в полёте. При `true` + пустых entities рендерит skeleton rows. */
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Re-fetch в полёте. При `true` рисует sticky overlay c rt-spinner поверх существующих rows. */
+    readonly fetching: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Имена колонок (тот же массив что в `*cdkRowDef columns: ...`). Нужен для skeleton row layout. */
+    readonly columns: InputSignal<ReadonlyArray<string>>;
+    /**
+     * Метаданные колонок для настраиваемой таблицы: `[{key,label,hidden?,locked?}]`.
+     * Когда задан — `displayedColumns()` вычисляется из него с учётом настроек
+     * (видимость + порядок), а таблица получает панель настроек (при заданном `[tableId]`).
+     * Пуст — таблица работает по legacy `[columns]` без панели.
+     */
+    readonly columnsConfig: InputSignal<ReadonlyArray<IRtTable.ColumnConfig>>;
+    /**
+     * Идентификатор таблицы для персиста настроек колонок (ключ в IndexedDB).
+     * Без него панель настроек недоступна (`canConfigure()` = false).
+     */
+    readonly tableId: InputSignal<string | null>;
+    /**
+     * Добавляет в конец строки «…»-колонку действий (`rt-menu`). Содержимое меню —
+     * через `<ng-template rtTableRowActions let-row>`; колонку нужно подключить
+     * в row-def'ах через `displayedColumns()`.
+     */
+    readonly showRowActions: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Есть ли у строки доступные действия. Строка, которой нельзя сделать ничего,
+     * кнопки «…» не показывает вовсе. Экран заполняет тем же признаком, которым
+     * гейтит пункты меню; `null` — у всех строк действия есть.
+     */
+    readonly rowHasActions: InputSignal<IRtTable.RowActionsPredicate<TRow> | null>;
+    /**
+     * Показывать ли строку отбора под шапкой. Таблица с отбором в настройке колонок не
+     * становится таблицей с полями над строками сама: вторая строка шапки стоит высоты
+     * экрана, и платить за неё решает потребитель.
+     */
+    readonly showFilters: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Набор условий, по которому нарисованы ячейки отбора. Держит его потребитель. */
+    readonly filters: InputSignal<ReadonlyArray<IFilterModel<string>>>;
+    /** Набор условий изменился. Строки сужает потребитель — таблица только сообщает. */
+    readonly filtersChange: OutputEmitterRef<ReadonlyArray<IFilterModel<string>>>;
+    /** Выбранная сортировка: `null` — порядок задаёт источник данных. */
+    readonly sort: InputSignal<ISortModel<string> | null>;
+    /** Пользователь переключил порядок заголовком. Саму выборку делает потребитель. */
+    readonly sortChange: OutputEmitterRef<ISortModel<string> | null>;
+    /** Текущая сортировка — её читают заголовки колонок (`rtSortHeader`). */
+    readonly currentSort: Signal<ISortModel<string> | null>;
+    /**
+     * Разрешённые колонки настраиваемой таблицы: `[columnsConfig]` в применённом
+     * порядке, с текущим флагом `hidden` (locked всегда видимы). Панель настроек
+     * читает этот список для отрисовки; из него же строится `displayedColumns()`.
+     * Пустой при отсутствии `[columnsConfig]` (legacy-режим).
+     */
+    readonly resolvedColumns: Signal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
+    /**
+     * Колонки для `*cdkHeaderRowDef`/`*cdkRowDef`. При заданном `[columnsConfig]` —
+     * видимые колонки в применённом порядке; иначе — legacy `[columns]`. Плюс
+     * «…»-колонка действий в конце при `[showRowActions]`. Потребитель читает через
+     * template-ref: `<rt-table #t="rtTable" ...>` →
+     * `*cdkRowDef="let row; columns: t.displayedColumns()"`.
+     */
+    readonly displayedColumns: Signal<ReadonlyArray<string>>;
+    /**
+     * Ячейки строки отбора: по ячейке на каждую показанную колонку, в том же порядке. У
+     * колонки без объявленного отбора ячейка пустая, но своё место держит — иначе ячейки
+     * съезжают на соседние колонки. Колонка действий строки попадает сюда тем же путём:
+     * `displayedColumns()` уже несёт её последней.
+     */
+    readonly filterCells: Signal<ReadonlyArray<IRtTable.FilterCell>>;
+    /** `true` когда таблица настраиваемая: есть и `[columnsConfig]`, и `[tableId]`. */
+    readonly canConfigure: Signal<boolean>;
+    /** Сколько skeleton-строк рендерить во время initial-load. Default 5. */
+    readonly skeletonRows: InputSignalWithTransform<number, NumberInput>;
+    /** Подпись пустой таблицы; пусто — берётся переведённое умолчание. */
+    readonly emptyMessage: InputSignal<string>;
+    /** Своя подпись пустой таблицы важнее умолчания */
+    readonly emptyText: Signal<string>;
+    /** Иконка дефолтного empty-placeholder'а (rt-empty-state). `null` — без иконки. */
+    readonly emptyIcon: InputSignal<IRtIcon.Name | null>;
+    /** Описание под заголовком дефолтного empty-placeholder'а. Опционально. */
+    readonly emptyDescription: InputSignal<string | null>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Переключает порядок по колонке: по возрастанию → по убыванию → без сортировки.
+     * Выбранное состояние уходит наружу — выборку делает потребитель.
+     */
+    toggleSort(propertyName: string): void;
+    /** Ячейка отбора сообщила новый набор условий — таблица отдаёт его наружу целиком. */
+    reportFilters(filters: ReadonlyArray<IFilterModel<string>>): void;
+    applyColumnSettings(settings: IRtTable.ColumnSettings): void;
+    /**
+     * Пробрасывает `dataSource` в CdkTable и отдельно инвалидирует signals,
+     * которые вычисляют loading/empty-состояния по plain CDK input.
+     */
+    set dataSource(dataSource: CdkTableDataSourceInput<TRow>);
+    /** Возвращает текущий источник данных, сохранённый базовым CdkTable. */
+    get dataSource(): CdkTableDataSourceInput<TRow>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtTableComponent<any>, "rt-table, table[rt-table]", ["rtTable"], { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "cards": { "alias": "cards"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "columnsConfig": { "alias": "columnsConfig"; "required": false; "isSignal": true; }; "tableId": { "alias": "tableId"; "required": false; "isSignal": true; }; "showRowActions": { "alias": "showRowActions"; "required": false; "isSignal": true; }; "rowHasActions": { "alias": "rowHasActions"; "required": false; "isSignal": true; }; "showFilters": { "alias": "showFilters"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyIcon": { "alias": "emptyIcon"; "required": false; "isSignal": true; }; "emptyDescription": { "alias": "emptyDescription"; "required": false; "isSignal": true; }; }, { "filtersChange": "filtersChange"; "sortChange": "sortChange"; }, ["rowActions", "cardTemplate", "columnDefs", "emptyTemplate"], ["caption", "colgroup, col"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+/**
+ * Регистрация настраиваемой таблицы в реестре: её текущие/дефолтные колонки
+ * (сигналы) + callback применения новых настроек (применяет к таблице и
+ * персистит). Заполняется самой `rt-table`, читается route-асайдом настроек.
+ */
+interface IRtTableSettingsRegistration {
+    columns: Signal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
+    defaults: Signal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
+    apply: (settings: IRtTable.ColumnSettings) => void;
+}
+/**
+ * Реестр настраиваемых таблиц — мост между `rt-table` (shared UI) и route-асайдом
+ * настроек колонок, которые живут в разных ветках дерева и не видят друг друга
+ * напрямую. `rt-table` регистрируется по `tableId` на init, снимается на destroy;
+ * асайд читает регистрацию активной таблицы (`active()` выставляется при открытии).
+ *
+ * Реестр реактивный (`Map` живёт в сигнале): при F5 route-асайд инициализируется
+ * раньше `rt-table`, и синхронный промах по пустому реестру не должен быть
+ * финальным — асайд дожидается регистрации через `effect` (фикс F-16).
+ */
+declare class RtTableSettingsRegistry {
+    #private;
+    /** Id таблицы, чьи настройки сейчас открыты в асайде (или `null`). */
+    readonly active: Signal<string | null>;
+    /**
+     * Id единственной зарегистрированной таблицы (или `null`, если их 0 или >1).
+     * Нужен асайду для восстановления `active` после F5: сервис пересоздан,
+     * `setActive` никто не звал, но открытая страница регистрирует ровно
+     * одну настраиваемую таблицу.
+     */
+    readonly soleTableId: Signal<string | null>;
+    register(tableId: string, registration: IRtTableSettingsRegistration): void;
+    unregister(tableId: string): void;
+    /** Реактивная регистрация таблицы: `null`, пока таблица не зарегистрировалась. */
+    get(tableId: string): Signal<IRtTableSettingsRegistration | null>;
+    setActive(tableId: string): void;
+    clearActive(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableSettingsRegistry, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+/**
+ * Общий route-driven side-sheet настроек колонок для любой `rt-table`. Открывается
+ * навигацией на `(ro:table-settings)`; какая таблица настраивается — берётся из
+ * `RtTableSettingsRegistry.active()` (потребитель выставляет `setActive(tableId)`
+ * перед навигацией). Create-mode: id в route нет (`tableId` — строка, числовой базой
+ * не резолвится).
+ *
+ * Тело списка (drag-reorder + видимость) — переиспользуемый `rt-table-settings-panel`;
+ * «Сохранить»/«Сбросить» живут в chrome асайда над локальным `items`, засеянным из
+ * активной регистрации. Регистрируется в `routes.ts` каждого shell под `outlet: "ro"`.
+ */
+declare class RtTableSettingsAsideComponent extends RtRouteAsideComponent<never> {
+    #private;
+    /** Рабочая копия списка колонок (сидится из регистрации, редактируется телом-панелью). */
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly items: WritableSignal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
+    constructor();
+    protected resolve(): Observable<never | null>;
+    /** Сбросить рабочую копию к дефолтным колонкам из конфига. */
+    protected onReset(): void;
+    /** Применить настройки к таблице (через registry) и закрыть асайд. */
+    protected onSave(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableSettingsAsideComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtTableSettingsAsideComponent, "rt-table-settings-aside", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Презентационный редактор списка колонок таблицы: reorder (drag-drop) + видимость
+ * (глаз). Locked-колонки всегда видимы и не перетаскиваются. Двусторонний `items` —
+ * текущее состояние; контейнер (route-асайд настроек) владеет сигналом, читает его
+ * для «Сохранить»/«Сбросить» и передаёт сюда через `[(items)]`.
+ */
+declare class RtTableSettingsPanelComponent {
+    protected readonly t: Signal<TRtKitLabelMap>;
+    readonly items: ModelSignal<ReadonlyArray<IRtTable.ColumnSettingItem>>;
+    /** Reorder через drag-drop. Locked-строки drag-disabled; индексы — по всему списку. */
+    protected onDrop(event: CdkDragDrop<ReadonlyArray<IRtTable.ColumnSettingItem>>): void;
+    /** Переключить видимость колонки (locked — нельзя). */
+    protected onToggleHidden(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableSettingsPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtTableSettingsPanelComponent, "rt-table-settings-panel", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; }, { "items": "itemsChange"; }, never, never, true, never>;
+}
+
+/** Значение условия в том виде, в каком оно хранится и сверяется. */
+type TRtTableFilterValue = string | number | boolean;
+/** Что приходит в ячейку от человека: дата приходит объектом, остальное — уже готовым значением. */
+type TRtTableFilterInput = TRtTableFilterValue | Date | null | undefined;
+/**
+ * Значение в том виде, в каком оно хранится: дата — строкой.
+ *
+ * `Date` не равен строке никогда, и без приведения повторный выбор той же даты каждый раз
+ * считался бы новым значением — а тогда статья «повтор того же значения не сообщает ничего»
+ * не держалась бы именно там, где её проще всего нарушить.
+ */
+declare function filterValueOf(value: TRtTableFilterInput): TRtTableFilterValue;
+/** Условие по этой колонке из набора либо `null`, когда колонка ничего не отбирает. */
+declare function filterOf(filters: readonly IFilterModel<string>[], propertyName: string): IFilterModel<string> | null;
+/**
+ * Набор условий после перемены значения по одной колонке.
+ *
+ * Пустое значение снимает колонку с отбора, а не уходит пустым условием: условие без значения
+ * просит потребителя ответить «подходит всё», и потребитель, прочитавший его буквально, не
+ * вернёт ни одной строки.
+ *
+ * Возвращает прежний набор тем же объектом, когда менять нечего: по этому признаку ячейка и
+ * решает, сообщать ли наружу.
+ */
+declare function filtersWithValue(filters: readonly IFilterModel<string>[], propertyName: string, operatorType: TFilterOperatorType, value: TRtTableFilterValue): readonly IFilterModel<string>[];
+/**
+ * Набор условий после перемены вида сравнения по одной колонке.
+ *
+ * Пока значения нет, менять вид сравнения не у чего: отбирать нечего, и набор условий не
+ * изменился — значит, наружу ничего не уходит.
+ */
+declare function filtersWithOperator(filters: readonly IFilterModel<string>[], propertyName: string, operatorType: TFilterOperatorType): readonly IFilterModel<string>[];
+/** Вид сравнения, с которого колонка начинает: свой, первый разрешённый либо равенство. */
+declare function startOperatorOf(allowed: readonly TFilterOperatorType[] | undefined, start: TFilterOperatorType | undefined): TFilterOperatorType;
+/**
+ * Ячейки строки отбора: по ячейке на каждую показанную колонку, в том же порядке.
+ *
+ * У колонки без объявленного отбора ячейка пустая, и место своё она держит: убрать её значило бы
+ * сдвинуть все следующие ячейки на одну колонку влево — поле города встало бы под шапкой цены.
+ * Колонка действий строки приходит сюда тем же путём, последней, и отбора у неё нет никогда; её
+ * ячейка помечена, чтобы строка отбора не дала ширины колонке, которая места не занимает.
+ */
+declare function filterCellsOf(columns: ReadonlyArray<string>, config: ReadonlyArray<IRtTable.ColumnConfig>): ReadonlyArray<IRtTable.FilterCell>;
+
+/** Один вид сравнения в списке: сам вид и его подпись из словаря. */
+interface IOperatorView {
+    readonly type: TFilterOperatorType;
+    readonly label: string;
+}
+/**
+ * Отбор в шапке столбца таблицы.
+ *
+ * Стоит рядом с именем колонки: сужение, живущее в стороне от того, что сужает, не даёт увидеть,
+ * какая колонка сузила список — человек читает короткий список и не узнаёт, почему он короткий.
+ *
+ * Своих полей не рисует ни одного: вид отбора решает, какую готовую часть кита позвать. Поля кита
+ * ведутся формой, поэтому значение идёт через `FormControl`, а не входом со своим выходом.
+ *
+ * Наружу уходит весь набор условий, а не одно изменившееся: потребитель спрашивает сервер набором,
+ * и, получив одно условие, держал бы вторую копию набора — две копии расходятся молча. Строк
+ * семейство не отбирает: строки принадлежат тому, кто держит список.
+ */
+declare class RtTableFilterHeaderComponent {
+    #private;
+    /** Значение ведёт форма: поля кита берут его только так. */
+    protected readonly control: FormControl<TRtTableFilterInput>;
+    /**
+     * Условие по этой колонке либо `null`: по нему видно и значение, и вид сравнения. Сверяется по
+     * содержимому, а не по ссылке: перемена соседней колонки приносит новый набор, и условие этой
+     * колонки, пересобранное потребителем тем же, переменой не считается.
+     */
+    protected readonly own: Signal<IFilterModel<string> | null>;
+    /**
+     * Вид сравнения, выбранный здесь, пока значения нет: условия ещё нет, и хранить выбор, кроме
+     * самой ячейки, негде. Без него выбор терялся бы, и введённое значение уходило бы с видом по
+     * умолчанию. Условие этой колонки, пришедшее снаружи, выбор сбрасывает — вид берётся из него.
+     */
+    protected readonly chosenOperator: WritableSignal<TFilterOperatorType | null>;
+    protected readonly value: Signal<TRtTableFilterValue>;
+    /** Очистка видна только там, где есть что очищать. */
+    protected readonly clearable: Signal<boolean>;
+    protected readonly operator: Signal<TFilterOperatorType>;
+    /** Виды сравнения, которые разрешила колонка; молчит колонка — разрешены все. */
+    protected readonly operators: Signal<readonly TFilterOperatorType[]>;
+    protected readonly chooseLabel: Signal<string>;
+    protected readonly valueLabel: Signal<string>;
+    protected readonly clearLabel: Signal<string>;
+    protected readonly filtersLabel: Signal<string>;
+    /** Список видов сравнения открыт в слое; выбор пункта закрывает его отсюда — сам пункт не умеет. */
+    protected readonly operatorPopover: Signal<RtPopoverDirective | undefined>;
+    /** Список видов сравнения с подписями: шаблон читает готовое, а не зовёт словарь сам. */
+    protected readonly operatorViews: Signal<readonly IOperatorView[]>;
+    /** Подпись текущего вида сравнения — её несёт кнопка, открывающая список. */
+    protected readonly operatorLabel: Signal<string>;
+    /**
+     * Имя кнопки для скринридера: что она открывает и какой вид стоит сейчас. Одно «Фильтры»
+     * не отличало бы кнопку одной колонки от другой и не говорило бы, какой вид выбран.
+     */
+    protected readonly operatorAriaLabel: Signal<string>;
+    /** Сообщает ли этот вид сразу: у выбора и даты недописанного состояния нет. */
+    protected readonly instant: Signal<boolean>;
+    protected readonly options: Signal<ReadonlyArray<IRtSelect.Option<string | number>>>;
+    /** Ключ колонки — тот же, что в `cdkColumnDef` и в `[columnsConfig]`. */
+    readonly propertyName: InputSignal<string>;
+    /**
+     * Чем колонка отбирает. Объявляет колонка, а не угадывает значение; колонка, которая молчит,
+     * не отбирает вовсе — решает это сама ячейка, а не тот, кто её ставит: иначе обещание держал
+     * бы каждый потребитель по-своему.
+     */
+    readonly filter: InputSignal<IRtTable.ColumnFilter | null>;
+    /** Текущий набор условий — весь, по всем колонкам сразу. */
+    readonly filters: InputSignal<readonly IFilterModel<string>[]>;
+    readonly filtersChange: OutputEmitterRef<readonly IFilterModel<string>[]>;
+    constructor();
+    protected onOperator(operatorType: TFilterOperatorType): void;
+    protected onClear(): void;
+    /** Уход из поля и Enter: набранное значение уходит наружу разом, а не по знаку. */
+    protected onCommit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtTableFilterHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtTableFilterHeaderComponent, "rt-table-filter-header", never, { "propertyName": { "alias": "propertyName"; "required": true; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; }, { "filtersChange": "filtersChange"; }, never, never, true, never>;
+}
+
+export { IRtTable, RT_TABLE_ROW_ACTIONS_COLUMN, RtCopyCellComponent, RtRowHasActionsPipe, RtTableCardDirective, RtTableComponent, RtTableFilterHeaderComponent, RtTableRowActionsDirective, RtTableRowDirective, RtTableSettingsAsideComponent, RtTableSettingsPanelComponent, RtTableSettingsRegistry, RtTableSortHeaderComponent, ariaSortOf, defaultColumnItems, displayedColumnKeys, filterCellsOf, filterOf, filterValueOf, filtersWithOperator, filtersWithValue, isColumnSortable, nextSort, resolveColumns, rowHasAvailableActions, sortDirectionOf, startOperatorOf, withoutLockedHidden };
+export type { IRtTableCardContext, IRtTableRowActionsContext, IRtTableSettingsRegistration, TRtTableAriaSort, TRtTableFilterInput, TRtTableFilterValue };