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

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

@@ -0,0 +1,494 @@
+import { IRtDataTable, IRtIcon, ERtDataTableFilterType, IRtInput, ERtDataTableColumnType, TRtDataTableFilters } from '@rt-tools/ui-kit-v2/core';
+import * as i0 from '@angular/core';
+import { Signal, TemplateRef, InjectionToken, InputSignal, InputSignalWithTransform, OnInit, WritableSignal, OutputEmitterRef, AfterViewChecked, ElementRef } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { SafeStyle } from '@angular/platform-browser';
+import { TNullable, ISortModel, TListSortOrderType, TFilterOperatorType, IFilterModel } from '@rt-tools/utils';
+import { IRtSelect } from '@rt-tools/ui-kit-v2/select';
+
+/** Значение ячейки: как его отдала запись или как его переделала колонка. */
+declare function dataTableCellValue<T>(row: T, column: IRtDataTable.Column<T>): T[keyof T] | string | number;
+/** Текст значения для подсказки и буфера — так же, как первый кит: строка, число, иначе JSON. */
+declare function dataTableCellText(value: unknown): string;
+/**
+ * Сторона кнопки копирования: заданная колонкой, иначе противоположная выравниванию значения —
+ * справа выровненное значение копируется кнопкой слева.
+ */
+declare function dataTableCopyButtonSide(column: IRtDataTable.Column<unknown>): 'left' | 'right';
+/**
+ * Значок набора кита для имени первого кита, либо `null`, если пары нет.
+ *
+ * Идёт через перечень соответствий кита, а не своим списком: второй список разошёлся бы с
+ * перечнем молча, и одно имя рисовалось бы в двух местах двумя рисунками.
+ */
+declare function dataTableIconName(glyph: string): IRtIcon.Name | null;
+
+/**
+ * Порядок имён колонок для сверки двух наборов.
+ *
+ * Какой именно порядок, значения не имеет: оба набора выстраиваются одним и тем же и сравниваются
+ * на равенство. Важно лишь, чтобы порядок был один и не зависел от вида значения, — умолчание
+ * `sort()` приводит элементы к строке по-своему и на числовых ключах даёт лексикографический.
+ */
+declare function comparePropNames(a: PropertyKey | undefined, b: PropertyKey | undefined): number;
+/**
+ * Настройки таблицы в хранилище браузера: порядок и видимость столбцов, полосы прокрутки.
+ *
+ * Перенесено из первого кита как есть: ключ — тот, что дало приложение, форма записи — та же.
+ * Поэтому настройки, сохранённые таблицей первого кита, читаются здесь без переделки.
+ */
+declare class RtDataTableConfigService<ENTITY_TYPE> {
+    #private;
+    readonly tableConfig: Signal<IRtDataTable.Config.Data<ENTITY_TYPE>>;
+    /**
+     * Потоки чтения и записи объявлены один раз, а методы только толкают в них просьбы.
+     *
+     * Чтение — `switchMap`: отвечает последний вызов, потому что настройка, прочитанная под
+     * прежний состав столбцов, к нынешнему уже не относится. Чтение, ещё не вернувшееся к
+     * `updateConfig`, гасится им: иначе прочитанное позже затёрло бы то, что поменяли после.
+     * Запись и снятие — один поток и `concatMap`: разведённые по двум, они теряют порядок между
+     * собой, и снятие, обогнавшее запись, оставляет в хранилище снятое.
+     */
+    constructor();
+    initConfig(storageKey: string, config: Array<IRtDataTable.Column<ENTITY_TYPE>>): void;
+    updateConfig(storageKey: string, config: IRtDataTable.Config.Data<ENTITY_TYPE>): void;
+    deleteConfig(storageKey: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableConfigService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+/** Что получает шаблон значка: имя, колонку и — в ячейке — запись строки. */
+interface IRtDataTableIconContext<T = Record<string, unknown>> {
+    /** Имя значка из описания колонки — то, что там написало приложение. */
+    $implicit: string;
+    column: IRtDataTable.Column<T>;
+    /** Запись строки; в шапке её нет. */
+    row: T | null;
+}
+/**
+ * Шаблон значка, который приложение отдаёт таблице.
+ *
+ * Когда он дан, значки шапки и ячеек, названные в описании колонок, рисует он, а перечень
+ * соответствий кита не спрашивается. Это выход для имени, которому в наборе кита нет пары.
+ *
+ * ```html
+ * <rt-data-table ...>
+ *     <ng-template rtDataTableIcon let-name let-row="row">
+ *         <rt-icon [name]="iconOf(name)" />
+ *     </ng-template>
+ * </rt-data-table>
+ * ```
+ */
+declare class RtDataTableIconDirective<T = Record<string, unknown>> {
+    readonly template: TemplateRef<IRtDataTableIconContext<T>>;
+    static ngTemplateContextGuard<T>(_directive: RtDataTableIconDirective<T>, context: unknown): context is IRtDataTableIconContext<T>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableIconDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableIconDirective<any>, "ng-template[rtDataTableIcon]", ["rtDataTableIcon"], {}, {}, never, never, true, never>;
+}
+
+/** Атрибут части строки, нажатие на которую до строки не доходит. */
+declare const RT_DATA_TABLE_STOP_ROW_CLICK_ATTRIBUTE: string;
+/** Кому строка сообщает о нажатии и двойном нажатии — самой таблице. */
+interface IRtDataTableRowHost<ENTITY_TYPE> {
+    onRowClick(row: ENTITY_TYPE, event: MouseEvent): void;
+    onRowDoubleClick(row: ENTITY_TYPE): void;
+}
+declare const RT_DATA_TABLE_ROW_HOST: InjectionToken<IRtDataTableRowHost<unknown>>;
+/**
+ * Помечает часть строки, нажатие на которую до строки не доходит, — картинку, кнопку приложения,
+ * блок текста в своей ячейке.
+ */
+declare class RtDataTableStopRowClickDirective implements OnInit {
+    #private;
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableStopRowClickDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableStopRowClickDirective, "[rtDataTableStopRowClick]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Нажатие и двойное нажатие строки — как в первом ките.
+ *
+ * О нажатии строка сообщает, когда кнопка опускается, а не когда отпускается, и любой кнопкой:
+ * так было в первом ките, и так переносится. Двойное нажатие поэтому приходит после двух нажатий
+ * строки.
+ */
+declare class RtDataTableRowClickDirective<ENTITY_TYPE> {
+    #private;
+    /** Запись строки. */
+    readonly entity: InputSignal<ENTITY_TYPE>;
+    /** Строка сообщает о нажатиях. */
+    readonly isTableRowClickable: InputSignalWithTransform<boolean, BooleanInput>;
+    onMouseDown(event: MouseEvent): void;
+    onDoubleClick(event: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableRowClickDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableRowClickDirective<any>, "[rtDataTableRowClick]", never, { "entity": { "alias": "rtDataTableRowClick"; "required": true; "isSignal": true; }; "isTableRowClickable": { "alias": "isTableRowClickable"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Готовая ячейка `rt-data-table` — ячейка первого кита без Material.
+ *
+ * Значение рисуется как пришло или как его переделала колонка; пустое — прочерком. Длинное
+ * обрезается в строку, и подсказка со значением целиком бывает только у обрезанного. Значок —
+ * набором кита по имени первого кита либо шаблоном значка приложения. Кнопка копирования
+ * проявляется при наведении и стоит на стороне, противоположной выравниванию значения.
+ */
+declare class RtDataTableCellComponent<T = Record<string, unknown>> {
+    #private;
+    /** Экран узкий: подсказки гаснут. Что кнопка копирования там видна всегда, решают стили. */
+    protected readonly narrow: Signal<boolean>;
+    protected readonly value: Signal<T[keyof T] | string | number>;
+    /**
+     * Копировать нечего: значение пусто. Считается той же утилитой, что рисует прочерк вместо
+     * значения, — второй ответ на этот вопрос разошёлся бы с прочерком молча.
+     */
+    protected readonly empty: Signal<boolean>;
+    protected readonly copyable: Signal<boolean>;
+    /**
+     * Значок колонки. Его видимость, цвет и подсказку ячейка не читает — как первый кит: поля
+     * приняты ради переезда без правок и ничего не меняют.
+     */
+    protected readonly icon: Signal<IRtDataTable.Icon | null>;
+    /** Значок набора кита для имени первого кита; без пары — ничего. */
+    protected readonly kitIcon: Signal<IRtIcon.Name | null>;
+    /**
+     * Имя без пары в перечне соответствий: его ячейка рисует глифом шрифта Material Symbols, как
+     * первый кит рисовал любой глиф. Шрифт кит не везёт — глиф виден там, где шрифт подключило
+     * приложение, а без шрифта на месте значка стоит его имя.
+     */
+    protected readonly glyph: Signal<string | null>;
+    /** Залитый глиф — как залитый значок набора: контурным его делает `outlined` колонки. */
+    protected readonly glyphMods: Signal<Record<string, boolean>>;
+    protected readonly iconContext: Signal<IRtDataTableIconContext<T> | null>;
+    /**
+     * Стиль значка, посчитанный колонкой по значению строки, — строкой, как в первом ките.
+     * Это одна из странностей первого кита, перенесённых как есть: такую строку не перекрашивает
+     * ни набор, ни тёмная тема.
+     */
+    protected readonly iconStyle: Signal<SafeStyle | null>;
+    protected readonly hovered: WritableSignal<boolean>;
+    protected readonly copied: WritableSignal<boolean>;
+    /** Подсказка: заданная колонкой, иначе значение целиком — и только у обрезанного. */
+    protected readonly hint: WritableSignal<string>;
+    protected readonly copyLabel: Signal<string>;
+    protected readonly copyIcon: Signal<IRtIcon.Name>;
+    protected readonly titleMods: Signal<Record<string, string>>;
+    protected readonly copyMods: Signal<Record<string, string | boolean>>;
+    readonly row: InputSignal<T>;
+    readonly column: InputSignal<IRtDataTable.Column<T>>;
+    /** Шаблон значка приложения; когда он дан, перечень кита не спрашивается. */
+    readonly iconTemplate: InputSignal<TemplateRef<IRtDataTableIconContext<T>> | null>;
+    constructor();
+    /**
+     * Наведение: проявить кнопку копирования и замерить обрезку.
+     *
+     * Ширина известна только отрисованному узлу, а меняется она и от переезда столбца, и от
+     * ширины окна: посчитанная один раз, она соврала бы при первом же изменении.
+     */
+    protected onMouseEnter(): void;
+    protected onCopy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableCellComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDataTableCellComponent<any>, "rt-data-table-cell", never, { "row": { "alias": "row"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "iconTemplate": { "alias": "iconTemplate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Какой порядок просит нажатие на шапку — как в первом ките: по возрастанию, а после возрастания
+ * по убыванию. Снятия порядка нет: после убывания снова возрастание.
+ */
+declare function dataTableNextSortOrder(current: TNullable<ISortModel<string>>): TListSortOrderType;
+/** Порядок таблицы сейчас стоит по этой колонке. */
+declare function dataTableSortActive(sort: TNullable<ISortModel<string>>, current: TNullable<ISortModel<string>>): boolean;
+/** Значение `aria-sort` шапки: скринридер называет порядок колонки, а не только её имя. */
+type TRtDataTableAriaSort = 'ascending' | 'descending' | 'none';
+/**
+ * `aria-sort` сортируемой колонки: порядок по ней, если он стоит по ней, иначе `none`. Колонке
+ * без сортировки атрибут не положен вовсе — `null` снимает его.
+ */
+declare function dataTableAriaSort(sort: TNullable<ISortModel<string>>, current: TNullable<ISortModel<string>>): TRtDataTableAriaSort | null;
+
+/**
+ * Ячейка шапки `rt-data-table` — шапка первого кита без Material.
+ *
+ * Нажатие на шапку сортируемой колонки просит порядок: по возрастанию, затем по убыванию, и так
+ * по кругу — снятия порядка нет. С клавиатуры то же делают Enter и пробел. Стрелки порядка видны
+ * при наведении, при фокусе и у колонки, по которой порядок стоит. Значок шапки — набором кита по имени первого кита либо шаблоном приложения.
+ */
+declare class RtDataTableHeaderCellComponent<T = Record<string, unknown>> {
+    /** Шапка сортируемой колонки нажимается и с клавиатуры: у неё фокус и роль кнопки. */
+    protected readonly sortable: Signal<boolean>;
+    protected readonly active: Signal<boolean>;
+    protected readonly labelMods: Signal<Record<string, string>>;
+    protected readonly arrowsMods: Signal<Record<string, boolean>>;
+    protected readonly descMods: Signal<Record<string, boolean>>;
+    protected readonly ascMods: Signal<Record<string, boolean>>;
+    /** Значок шапки; его цвет и видимость, как в первом ките, ничего не меняют. */
+    protected readonly icon: Signal<IRtDataTable.Icon | null>;
+    protected readonly kitIcon: Signal<IRtIcon.Name | null>;
+    /** Имя без пары в перечне шапка рисует глифом Material Symbols — так же, как ячейка. */
+    protected readonly glyph: Signal<string | null>;
+    /** Залитый глиф — как залитый значок набора: контурным его делает `outlined` колонки. */
+    protected readonly glyphMods: Signal<Record<string, boolean>>;
+    protected readonly iconContext: Signal<IRtDataTableIconContext<T> | null>;
+    readonly headerModel: InputSignal<IRtDataTable.Header>;
+    readonly sortModel: InputSignal<TNullable<ISortModel<string>>>;
+    readonly currentSortModel: InputSignal<TNullable<ISortModel<string>>>;
+    /** Колонка шапки — её получает шаблон значка приложения. */
+    readonly column: InputSignal<IRtDataTable.Column<T> | null>;
+    /** Шаблон значка приложения; когда он дан, перечень кита не спрашивается. */
+    readonly iconTemplate: InputSignal<TemplateRef<IRtDataTableIconContext<T>> | null>;
+    readonly sortChange: OutputEmitterRef<ISortModel<string>>;
+    /** Enter и пробел просят порядок так же, как нажатие; пробел иначе прокрутил бы страницу. */
+    protected onKey(event: Event): void;
+    protected onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableHeaderCellComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDataTableHeaderCellComponent<any>, "rt-data-table-header-cell", never, { "headerModel": { "alias": "headerModel"; "required": true; "isSignal": true; }; "sortModel": { "alias": "sortModel"; "required": true; "isSignal": true; }; "currentSortModel": { "alias": "currentSortModel"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": false; "isSignal": true; }; "iconTemplate": { "alias": "iconTemplate"; "required": false; "isSignal": true; }; }, { "sortChange": "sortChange"; }, never, never, true, never>;
+}
+
+/** Значение отбора в том виде, в каком его отдаёт приложению первый кит. */
+type TRtDataTableFilterValue = string | number | boolean;
+/**
+ * Значок вида сравнения — имя первого кита; набор кита рисует его по перечню соответствий.
+ * «Начинается с» и «заканчивается на» первый кит объявлял, но значка и пункта меню им не давал.
+ */
+declare const DATA_TABLE_FILTER_OPERATOR_GLYPHS: Readonly<Record<TFilterOperatorType, string | null>>;
+/** Пункты меню видов сравнения в порядке первого кита. */
+declare const DATA_TABLE_FILTER_MENU_OPERATORS: ReadonlyArray<TFilterOperatorType>;
+/** Вид сравнения колонки по умолчанию: незнакомое и пустое значение дают «равно». */
+declare function dataTableDefaultOperator(operator: TFilterOperatorType | null | undefined): TFilterOperatorType;
+/** Условие колонки из набора приложения, а без него — пустое условие с видом по умолчанию. */
+declare function dataTableColumnFilter<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, propertyName: KEY, defaultOperator: TFilterOperatorType): IFilterModel<KEY>;
+/**
+ * Набор условий после смены значения колонки; `null` — приложению сообщать нечего.
+ * Пустое значение снимает условие колонки, значение на колонке без условия добавляет его.
+ */
+declare function dataTableFiltersWithValue<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, current: IFilterModel<KEY>, value: TRtDataTableFilterValue): IFilterModel<KEY>[] | null;
+/** Набор условий после смены вида сравнения; `null` — ни условия, ни значения, спрашивать нечего. */
+declare function dataTableFiltersWithOperator<KEY extends string>(filters: ReadonlyArray<IFilterModel<KEY>>, current: IFilterModel<KEY>, operatorType: TFilterOperatorType): IFilterModel<KEY>[] | null;
+/**
+ * День поля даты кита (`2025-01-01`) — в момент ISO, как отдавал первый кит: полночь дня по
+ * местному времени. Пустая строка остаётся пустой — она снимает условие.
+ */
+declare function dataTableDayToIso(day: string): string;
+/** Обратно: момент условия — в день поля даты по местному времени; нераспознанное даёт пустое. */
+declare function dataTableIsoToDay(value: unknown): string;
+
+interface IOperatorItem {
+    operator: TFilterOperatorType;
+    icon: IRtIcon.Name;
+    label: string;
+}
+/**
+ * Ячейка строки отбора `rt-data-table` — ячейка отбора первого кита на полях кита.
+ *
+ * Своих условий у ячейки нет: она читает набор приложения и отдаёт ему новый при каждой смене.
+ * Текст и число фиксируются по Enter и уходу с поля, дата — выбором дня, список — выбором пункта;
+ * пустое значение снимает условие колонки. Кнопка вида сравнения предлагает остальные виды.
+ */
+declare class RtDataTableFilterCellComponent<KEY extends string = string> {
+    #private;
+    protected readonly filterTypes: typeof ERtDataTableFilterType;
+    protected readonly valuePlaceholder: Signal<string>;
+    protected readonly selectPlaceholder: Signal<string>;
+    protected readonly clearLabel: Signal<string>;
+    /** Условие колонки: из набора приложения, а вид сравнения без условия помнит сама ячейка. */
+    protected readonly currentFilter: WritableSignal<IFilterModel<KEY>>;
+    protected readonly hasValue: Signal<boolean>;
+    protected readonly day: Signal<string>;
+    protected readonly number: Signal<number | null>;
+    protected readonly operatorIcon: Signal<IRtIcon.Name>;
+    protected readonly operatorLabel: Signal<string>;
+    /**
+     * Пункты меню — предложенные колонкой виды в порядке первого кита, кроме нынешнего: его первый кит
+     * в меню не выводит, нынешний вид показывает кнопка.
+     */
+    protected readonly operatorItems: Signal<IOperatorItem[]>;
+    protected readonly selectOptions: Signal<IRtSelect.Option<string>[]>;
+    /** Колонка, по которой отбирает ячейка. */
+    /** Вид полей отбора: `outline` — рамка со всех сторон, `fill` — залитое поле с чертой снизу. */
+    readonly appearance: InputSignal<IRtInput.Appearance>;
+    readonly filterProperty: InputSignal<KEY>;
+    readonly filterType: InputSignal<IRtDataTable.FilterType>;
+    /** Весь набор условий приложения. */
+    readonly filterModel: InputSignalWithTransform<IFilterModel<KEY>[], IFilterModel<KEY>[] | null | undefined>;
+    readonly defaultFilterOperator: InputSignal<TFilterOperatorType | null | undefined>;
+    readonly filterOperators: InputSignalWithTransform<TFilterOperatorType[], TFilterOperatorType[] | null | undefined>;
+    readonly filterSelectOptions: InputSignalWithTransform<string[], string[] | null | undefined>;
+    readonly filterChange: OutputEmitterRef<IFilterModel<KEY>[]>;
+    /** Набор в поле: пустое поле — это очистка, она фиксируется сразу, как у первого кита. */
+    protected onDraft(value: TRtDataTableFilterValue | null): void;
+    /** Enter и уход с поля фиксируют набранное. */
+    protected onCommit(): void;
+    protected onNumberDraft(value: number | null): void;
+    protected onDayChange(day: string | null): void;
+    protected onValueChange(value: TRtDataTableFilterValue | null): void;
+    protected onOperatorChange(operatorType: TFilterOperatorType): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableFilterCellComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDataTableFilterCellComponent<any>, "rt-data-table-filter-cell", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "filterProperty": { "alias": "filterProperty"; "required": true; "isSignal": true; }; "filterType": { "alias": "filterType"; "required": true; "isSignal": true; }; "filterModel": { "alias": "filterModel"; "required": false; "isSignal": true; }; "defaultFilterOperator": { "alias": "defaultFilterOperator"; "required": false; "isSignal": true; }; "filterOperators": { "alias": "filterOperators"; "required": false; "isSignal": true; }; "filterSelectOptions": { "alias": "filterSelectOptions"; "required": false; "isSignal": true; }; }, { "filterChange": "filterChange"; }, never, never, true, never>;
+}
+
+/** Что получает шаблон приложения, рисующий строку целиком или её часть. */
+interface IRtDataTableRowContext<ENTITY_TYPE> {
+    $implicit: ENTITY_TYPE;
+}
+/**
+ * Шаблоны пользовательских ячеек: имя свойства колонки — шаблон её ячейки.
+ *
+ * Колонку типа «custom» таблица рисует этим шаблоном и готовой ячейки не берёт.
+ */
+declare class RtDataTableCustomCellsDirective<ENTITY_TYPE> {
+    readonly cellsTemplates: InputSignal<{
+        [K in keyof ENTITY_TYPE]?: TemplateRef<IRtDataTableRowContext<ENTITY_TYPE>>;
+    }>;
+    getTemplateByPropName(propName: keyof ENTITY_TYPE): TemplateRef<IRtDataTableRowContext<ENTITY_TYPE>> | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableCustomCellsDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableCustomCellsDirective<any>, "[rtDataTableCustomCells]", never, { "cellsTemplates": { "alias": "rtDataTableCustomCells"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Пункты меню строки: шаблон раскрывается в панели меню кита. */
+declare class RtDataTableRowActionsDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableRowActionsDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableRowActionsDirective, "[rtDataTableRowActions]", never, {}, {}, never, never, true, never>;
+}
+/** Действия строки рядом с кнопкой меню: шаблон рисуется в полосе действий. */
+declare class RtDataTableAdditionalRowActionsDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableAdditionalRowActionsDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableAdditionalRowActionsDirective, "[rtDataTableAdditionalRowActions]", never, {}, {}, never, never, true, never>;
+}
+
+/** Ключи записей списка. */
+declare function dataTableKeysOf<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(entities: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): Array<ENTITY_TYPE[KEY]>;
+/** Записи страницы, добавленные к отмеченным; повторов не будет. */
+declare function dataTableWithPageEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Отмеченные без записей страницы. */
+declare function dataTableWithoutPageEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, page: ReadonlyArray<ENTITY_TYPE>, keyExp: KEY): ENTITY_TYPE[];
+/** Отмеченные после отметки или снятия одной записи. */
+declare function dataTableWithEntity<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(selected: ReadonlyArray<ENTITY_TYPE>, entity: ENTITY_TYPE, checked: boolean, keyExp: KEY): ENTITY_TYPE[];
+/** Хоть одна запись страницы отмечена. */
+declare function dataTableAnyOnPage<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(page: ReadonlyArray<ENTITY_TYPE>, selectedKeys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): boolean;
+/** Отмечены все записи страницы; пустая страница у первого кита считается отмеченной целиком. */
+declare function dataTableAllOnPage<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(page: ReadonlyArray<ENTITY_TYPE>, selectedKeys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): boolean;
+/** Записи первой страницы, чьи ключи названы приложением как отмеченные заранее. */
+declare function dataTablePresetEntities<ENTITY_TYPE, KEY extends keyof ENTITY_TYPE>(entities: ReadonlyArray<ENTITY_TYPE>, keys: ReadonlyArray<ENTITY_TYPE[KEY]>, keyExp: KEY): ENTITY_TYPE[];
+
+/**
+ * Таблица записей первого кита во втором — без Material.
+ *
+ * Колонки берутся у службы настроек, строки приходят входом. Таблица рисует шапку, строку
+ * отбора, готовые или пользовательские ячейки, колонку выбора флажком либо радиокнопкой и полосу
+ * действий в конце строки. Своего отбора и своего порядка она не ведёт: обо всём просит
+ * приложение. Отметками строк занимается директива выбора — она ставит их сюда.
+ */
+declare class RtDataTableComponent<ENTITY_TYPE extends Record<string, unknown>, SORT_PROPERTY extends Extract<keyof ENTITY_TYPE, string>, KEY extends Extract<keyof ENTITY_TYPE, string>> implements AfterViewChecked {
+    #private;
+    /** Полоса действий и две ячейки, которым она отдаёт свою ширину, — приём первого кита. */
+    protected readonly rowActionsRef: Signal<TNullable<ElementRef<HTMLElement>>>;
+    protected readonly headerSpacerRef: Signal<TNullable<ElementRef<HTMLElement>>>;
+    protected readonly rowSpacerRef: Signal<TNullable<ElementRef<HTMLElement>>>;
+    protected readonly columnTypes: typeof ERtDataTableColumnType;
+    /** Набор даёт узел вокруг — список; тогда класс набора на самой таблице не ставится. */
+    protected readonly presetFromHost: boolean;
+    /** Классы меню строки: оно открывается поверх страницы и вид семьи получает от неё. */
+    protected readonly menuPanelClass: Signal<string[]>;
+    protected readonly actionsLabel: Signal<string>;
+    protected readonly selectRowLabel: Signal<string>;
+    protected readonly selectPageLabel: Signal<string>;
+    /** Полоса действий рисуется, когда приложение дало меню строки или действия рядом с ним. */
+    protected readonly hasRowActions: Signal<boolean>;
+    protected readonly visibleColumns: Signal<Array<IRtDataTable.Column<ENTITY_TYPE>>>;
+    /** `aria-sort` каждой показанной колонки по её имени: шаблон читает готовое, а не зовёт расчёт. */
+    protected readonly ariaSorts: Signal<Readonly<Record<string, TRtDataTableAriaSort | null>>>;
+    /** Колонки — из службы настроек: их порядок и видимость помнит она. */
+    /** Вид полей отбора: `outline` — рамка со всех сторон, `fill` — залитое поле с чертой снизу. */
+    /**
+     * Вид семьи. Материальный набор стоит на самом узле, а не на странице: семья выглядит как первый
+     * кит, где бы её ни поставили, и соседи на странице своего вида не теряют.
+     */
+    readonly look: InputSignal<IRtDataTable.Look>;
+    readonly filterAppearance: InputSignal<IRtInput.Appearance>;
+    readonly columns: Signal<Array<IRtDataTable.Column<ENTITY_TYPE>>>;
+    readonly isTableRowsClickable: InputSignalWithTransform<boolean, unknown>;
+    /** Свойство, которым записи отличаются друг от друга. */
+    readonly keyExp: InputSignal<NonNullable<KEY>>;
+    readonly entities: InputSignalWithTransform<ENTITY_TYPE[], ENTITY_TYPE[] | null | undefined>;
+    readonly currentSortModel: InputSignal<TNullable<ISortModel<SORT_PROPERTY>>>;
+    /**
+     * Условия отбора. Их ключ — имя свойства колонки, а не ключ записи: отбирают по колонке, и
+     * ключ записи здесь оказался бы уже нужного — строка отбора зовёт ячейку именем колонки.
+     */
+    readonly filterModel: InputSignalWithTransform<TRtDataTableFilters<ENTITY_TYPE>, TNullable<TRtDataTableFilters<ENTITY_TYPE>>>;
+    readonly isFiltersShown: InputSignalWithTransform<boolean, unknown>;
+    readonly rowClick: OutputEmitterRef<{
+        row: ENTITY_TYPE;
+        event: MouseEvent;
+    }>;
+    readonly rowDoubleClick: OutputEmitterRef<ENTITY_TYPE>;
+    readonly sortChange: OutputEmitterRef<ISortModel<SORT_PROPERTY>>;
+    readonly filterChange: OutputEmitterRef<TRtDataTableFilters<ENTITY_TYPE>>;
+    readonly customCellsTpl: Signal<TNullable<RtDataTableCustomCellsDirective<ENTITY_TYPE>>>;
+    readonly rowActionsTpl: Signal<TNullable<TemplateRef<IRtDataTableRowContext<ENTITY_TYPE>>>>;
+    readonly additionalRowActionsTpl: Signal<TNullable<TemplateRef<IRtDataTableRowContext<ENTITY_TYPE>>>>;
+    /** Шаблон значка приложения: его получают и шапка, и готовая ячейка. */
+    readonly iconTpl: Signal<TNullable<RtDataTableIconDirective<ENTITY_TYPE>>>;
+    /** Ключи отмеченных записей; их ставит директива выбора. */
+    readonly selectedEntitiesIds: WritableSignal<ENTITY_TYPE[KEY][]>;
+    readonly isPageEntitiesSelected: WritableSignal<boolean>;
+    readonly isPageEntitiesIndeterminate: WritableSignal<boolean>;
+    readonly isMultiSelect: WritableSignal<boolean>;
+    readonly isSelectorsColumnShown: WritableSignal<boolean>;
+    readonly isSelectorsColumnDisabled: WritableSignal<boolean>;
+    /** Строка с открытым меню; у первого кита она подсвечена, пока меню открыто. */
+    readonly activeRowIndex: WritableSignal<TNullable<number>>;
+    /** Отметить запись; метод ставит директива выбора, без неё колонки выбора нет вовсе. */
+    onToggleEntity: (entity: ENTITY_TYPE, checked: boolean) => void;
+    /** Отметить все строки показанной страницы; метод ставит директива выбора. */
+    onTogglePageEntities: (checked: boolean) => void;
+    ngAfterViewChecked(): void;
+    /**
+     * Имя колонки приходит строкой, а наружу уходит ключом домена: приведение сверяется с тем же
+     * набором колонок, который рисует таблица. Несовпавшее не отдаётся вовсе — приём первого кита.
+     */
+    onSortChange(sortModel: ISortModel<string>): void;
+    onFilterChange(filterModel: TRtDataTableFilters<ENTITY_TYPE>): void;
+    onRowClick(row: ENTITY_TYPE, event: MouseEvent): void;
+    onRowDoubleClick(row: ENTITY_TYPE): void;
+    protected onMenuOpenedChange(index: number, opened: boolean): void;
+    protected defaultOperator(column: IRtDataTable.Column<ENTITY_TYPE>): IRtDataTable.Column<ENTITY_TYPE>['defaultFilterOperator'];
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableComponent<any, any, any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDataTableComponent<any, any, any>, "rt-data-table", never, { "look": { "alias": "look"; "required": false; "isSignal": true; }; "filterAppearance": { "alias": "filterAppearance"; "required": false; "isSignal": true; }; "isTableRowsClickable": { "alias": "isTableRowsClickable"; "required": false; "isSignal": true; }; "keyExp": { "alias": "keyExp"; "required": false; "isSignal": true; }; "entities": { "alias": "entities"; "required": true; "isSignal": true; }; "currentSortModel": { "alias": "currentSortModel"; "required": true; "isSignal": true; }; "filterModel": { "alias": "filterModel"; "required": false; "isSignal": true; }; "isFiltersShown": { "alias": "isFiltersShown"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "rowDoubleClick": "rowDoubleClick"; "sortChange": "sortChange"; "filterChange": "filterChange"; }, ["customCellsTpl", "rowActionsTpl", "additionalRowActionsTpl", "iconTpl"], never, true, never>;
+}
+
+/**
+ * Выбор строк таблицы `rt-data-table` — колонка выбора первого кита.
+ *
+ * Директива ведёт отметки и ставит таблице всё, что та рисует: ключи отмеченных, состояние
+ * флажка страницы и признаки колонки выбора. Приложение читает отмеченные записи целиком —
+ * запись, отмеченная на странице, которой уже нет на экране, остаётся отмеченной.
+ */
+declare class RtDataTableSelectorsDirective<ENTITY_TYPE extends Record<string, unknown>, SORT_PROPERTY extends Extract<keyof ENTITY_TYPE, string>, KEY extends Extract<keyof ENTITY_TYPE, string>> implements OnInit {
+    #private;
+    readonly isMultiSelect: InputSignalWithTransform<boolean, unknown>;
+    readonly isSelectorColumnShown: InputSignalWithTransform<boolean, unknown>;
+    readonly isSelectorsColumnDisabled: InputSignalWithTransform<boolean, unknown>;
+    /** Ключи записей, отмеченных заранее; они применяются один раз — к первым пришедшим строкам. */
+    readonly selectedEntitiesKeys: InputSignalWithTransform<ENTITY_TYPE[KEY][], ENTITY_TYPE[KEY][] | null | undefined>;
+    /** Отмеченные записи целиком. */
+    readonly selectedEntities: Signal<ENTITY_TYPE[]>;
+    readonly selectedEntitiesIds: Signal<ENTITY_TYPE[KEY][]>;
+    readonly isPageEntitiesSelected: Signal<boolean>;
+    readonly isPageEntitiesIndeterminate: Signal<boolean>;
+    constructor();
+    ngOnInit(): void;
+    /** Отметить или снять все строки показанной страницы; других отметок это не трогает. */
+    togglePageEntities(checked: boolean): void;
+    /** Отметить или снять одну запись; при выборе по одной прежняя отметка уходит. */
+    toggleEntity(entity: ENTITY_TYPE, checked: boolean): void;
+    /** Снять все отметки. */
+    clearSelectedList(): void;
+    /**
+     * Пересчитать флажок страницы по показанным строкам: отмечен, когда отмечены все строки
+     * страницы, промежуточен, когда отмечена часть. Отметки других страниц здесь не в счёт.
+     */
+    setExistingEntitiesState(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDataTableSelectorsDirective<any, any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDataTableSelectorsDirective<any, any, any>, "rt-data-table[rtDataTableSelectors]", never, { "isMultiSelect": { "alias": "isMultiSelect"; "required": false; "isSignal": true; }; "isSelectorColumnShown": { "alias": "isSelectorColumnShown"; "required": false; "isSignal": true; }; "isSelectorsColumnDisabled": { "alias": "isSelectorsColumnDisabled"; "required": false; "isSignal": true; }; "selectedEntitiesKeys": { "alias": "selectedEntitiesKeys"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { DATA_TABLE_FILTER_MENU_OPERATORS, DATA_TABLE_FILTER_OPERATOR_GLYPHS, RT_DATA_TABLE_ROW_HOST, RT_DATA_TABLE_STOP_ROW_CLICK_ATTRIBUTE, RtDataTableAdditionalRowActionsDirective, RtDataTableCellComponent, RtDataTableComponent, RtDataTableConfigService, RtDataTableCustomCellsDirective, RtDataTableFilterCellComponent, RtDataTableHeaderCellComponent, RtDataTableIconDirective, RtDataTableRowActionsDirective, RtDataTableRowClickDirective, RtDataTableSelectorsDirective, RtDataTableStopRowClickDirective, comparePropNames, dataTableAllOnPage, dataTableAnyOnPage, dataTableAriaSort, dataTableCellText, dataTableCellValue, dataTableColumnFilter, dataTableCopyButtonSide, dataTableDayToIso, dataTableDefaultOperator, dataTableFiltersWithOperator, dataTableFiltersWithValue, dataTableIconName, dataTableIsoToDay, dataTableKeysOf, dataTableNextSortOrder, dataTablePresetEntities, dataTableSortActive, dataTableWithEntity, dataTableWithPageEntities, dataTableWithoutPageEntities };
+export type { IRtDataTableIconContext, IRtDataTableRowContext, IRtDataTableRowHost, TRtDataTableAriaSort, TRtDataTableFilterValue };