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

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

@@ -0,0 +1,17 @@
+import * as i0 from '@angular/core';
+import { Signal, InputSignal, OutputEmitterRef } from '@angular/core';
+
+declare class RtDownloadLinkComponent {
+    /**
+     * Подпись для скринридера: имя файла подставляется в неё, поэтому карты
+     * подписей ей мало — параметр приходит из входа.
+     */
+    protected readonly downloadAriaLabel: Signal<string>;
+    readonly label: InputSignal<string>;
+    readonly downloadClick: OutputEmitterRef<void>;
+    protected onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDownloadLinkComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDownloadLinkComponent, "rt-download-link", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, { "downloadClick": "downloadClick"; }, never, never, true, never>;
+}
+
+export { RtDownloadLinkComponent };

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

@@ -0,0 +1,139 @@
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { TemplateRef, OnInit, Signal, InputSignal, InputSignalWithTransform, OutputEmitterRef } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { TNullable, IPageModel } from '@rt-tools/utils';
+import { TRtKitLabelMap, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+
+/**
+ * Маркеры частей панели инструментов — своим файлом, как у соседних семей.
+ *
+ * В имени класса стоит слово «Toolbar», хотя в разметке его нет: имя `RtDynamicListSelectorsDirective`
+ * в дереве уже занято первым китом, и там оно означает другое — проводку состояния списка, а не
+ * маркер стороны полосы. Два одинаковых имени в двух китах проверка дерева не пропускает.
+ *
+ * Каждый маркер держит свой шаблон и о списке не знает ничего: список читает маркеры среди своего
+ * содержимого и берёт у них шаблон. Часть, которую потребитель не объявил, для списка просто
+ * отсутствует.
+ */
+/**
+ * Левая сторона панели: то, чем человек отбирает записи.
+ *
+ * @example
+ * ```html
+ * <rt-dynamic-list>
+ *     <ng-container *rtDynamicListSelectors>
+ *         <rt-select [options]="stages()" />
+ *     </ng-container>
+ * </rt-dynamic-list>
+ * ```
+ */
+declare class RtDynamicListToolbarSelectorsDirective {
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicListToolbarSelectorsDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDynamicListToolbarSelectorsDirective, "[rtDynamicListSelectors]", never, {}, {}, never, never, true, never>;
+}
+/** Правая сторона панели: действия над разделом. Поле поиска стоит после них и остаётся за семьёй. */
+declare class RtDynamicListToolbarActionsDirective {
+    readonly templateRef: TemplateRef<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicListToolbarActionsDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDynamicListToolbarActionsDirective, "[rtDynamicListActions]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Модель `<rt-dynamic-list>`: один корневой неймспейс с префиксом `I`.
+ */
+declare namespace IRtDynamicList {
+    /**
+     * Отчего пусто. Причины две, и человеку они говорят разное: в разделе записей нет вовсе или
+     * их не оставил отбор. Из второго человеку показывают дорогу назад.
+     */
+    type EmptyReason = 'section' | 'filter';
+}
+
+/**
+ * Список записей со своей панелью инструментов.
+ *
+ * Полосу панели семья раскладывает сама, а не зовёт `rt-toolbar`: у того стороны объявлены
+ * нешринкующимися, и на хозяине уже́ содержимого полоса раздаётся шире него и уезжает за край.
+ * Семья кладёт в полосу готовые части кита — поле, кнопки, флажок, — а строит её сама.
+ *
+ * Семья ничего не рисует сама: поиск — поле кита, действия — его кнопки со значком, пустое место —
+ * его пустое состояние, страницы — его нумерация. Сами записи проецируются: таблица между панелью
+ * и страницами — потребителя, с его колонками, ячейками и действиями строки.
+ *
+ * Договорённость — `docs/specs/ui-kit-v2/dynamic-list/`.
+ */
+declare class RtDynamicListComponent implements OnInit {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly searchControl: FormControl<string>;
+    protected readonly perPageOptions: ReadonlyArray<number>;
+    protected readonly selectorsTpl: Signal<TNullable<RtDynamicListToolbarSelectorsDirective>>;
+    protected readonly actionsTpl: Signal<TNullable<RtDynamicListToolbarActionsDirective>>;
+    /** «Выбрано: N» — подпись с подстановкой, потому её берут не из карты, а вызовом. */
+    protected readonly selectedLabel: Signal<string>;
+    /** Отчего пусто. Отбор стоит — значит, записи убрал он, и человеку показывают дорогу назад. */
+    protected readonly emptyReason: Signal<IRtDynamicList.EmptyReason>;
+    /** Значок пустого места: под отбором — лупа, у пустого раздела — лоток. */
+    protected readonly emptyIcon: Signal<IRtIcon.Name>;
+    /** Подпись пустого места. Своя подпись потребителя сильнее обеих подписей кита. */
+    protected readonly emptyTitleText: Signal<string>;
+    /**
+     * Полоса страниц рисуется, пока записей больше наименьшего размера страницы — то же правило, что у
+     * самой полосы. Число страниц при нынешнем размере тут не решает: выбравший крупный размер, при
+     * котором всё легло на одну страницу, иначе терял вместе с полосой и дорогу к размеру поменьше.
+     */
+    protected readonly isPaginationShown: Signal<boolean>;
+    /**
+     * Есть ли в панели хоть что-нибудь. Полоса без единой части — это отступ над записями, и
+     * место она забирает у них.
+     */
+    protected readonly isToolbarShown: Signal<boolean>;
+    /** Записи проецируются, и о числе страниц семья узнаёт только из модели страницы. */
+    readonly pageModel: InputSignal<TNullable<IPageModel>>;
+    /** Первая загрузка: вместо всего содержимого стоит вертушка. */
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Подгрузка поверх нарисованного: записи остаются на месте, вертушка стоит над ними. */
+    readonly fetching: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Записей нет вовсе. От пустого ответа под отбором отличается входом `filtered`. */
+    readonly empty: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Отбор стоит. Вместе с `empty` даёт вторую причину пустоты — ту, у которой есть дорога назад. */
+    readonly filtered: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Кнопка сброса отбора: показана у раздела с отбором, выключена, пока сбрасывать нечего. */
+    readonly showClearFilters: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly showRefresh: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly showColumnSettings: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly showSearch: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Выбор записей: флажок «выбрать все» и счётчик выбранного на левой стороне панели. */
+    readonly selectable: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly allSelected: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly someSelected: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly selectAllDisabled: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly selectedCount: InputSignalWithTransform<number, NumberInput>;
+    readonly emptyTitle: InputSignal<string>;
+    readonly emptyDescription: InputSignal<string | null>;
+    /** Поиск потребителя: поле следует за ним при каждой смене и потребителю его не возвращает. */
+    readonly searchTerm: InputSignal<TNullable<string>>;
+    readonly searchChange: OutputEmitterRef<string>;
+    readonly refreshed: OutputEmitterRef<void>;
+    readonly filtersCleared: OutputEmitterRef<void>;
+    readonly columnSettingsOpened: OutputEmitterRef<void>;
+    readonly pageChange: OutputEmitterRef<number>;
+    readonly perPageChange: OutputEmitterRef<number>;
+    readonly allSelectedChange: OutputEmitterRef<boolean>;
+    constructor();
+    ngOnInit(): void;
+    protected onSelectAll(checked: boolean): void;
+    /**
+     * Сброс отбора снимает и поиск: пустой ответ под поиском — тоже ответ под отбором, и дорога назад
+     * без очистки поля вела бы к тому же пустому ответу. Поле очищается молча: `filtersCleared`
+     * уже значит «и поиск снят», и отдельный пустой `searchChange` заставил бы потребителя
+     * запрашивать список дважды.
+     */
+    protected onClearFilters(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDynamicListComponent, "rt-dynamic-list", never, { "pageModel": { "alias": "pageModel"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "filtered": { "alias": "filtered"; "required": false; "isSignal": true; }; "showClearFilters": { "alias": "showClearFilters"; "required": false; "isSignal": true; }; "showRefresh": { "alias": "showRefresh"; "required": false; "isSignal": true; }; "showColumnSettings": { "alias": "showColumnSettings"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "allSelected": { "alias": "allSelected"; "required": false; "isSignal": true; }; "someSelected": { "alias": "someSelected"; "required": false; "isSignal": true; }; "selectAllDisabled": { "alias": "selectAllDisabled"; "required": false; "isSignal": true; }; "selectedCount": { "alias": "selectedCount"; "required": false; "isSignal": true; }; "emptyTitle": { "alias": "emptyTitle"; "required": false; "isSignal": true; }; "emptyDescription": { "alias": "emptyDescription"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "searchChange": "searchChange"; "refreshed": "refreshed"; "filtersCleared": "filtersCleared"; "columnSettingsOpened": "columnSettingsOpened"; "pageChange": "pageChange"; "perPageChange": "perPageChange"; "allSelectedChange": "allSelectedChange"; }, ["selectorsTpl", "actionsTpl"], ["*"], true, never>;
+}
+
+export { IRtDynamicList, RtDynamicListComponent, RtDynamicListToolbarActionsDirective, RtDynamicListToolbarSelectorsDirective };

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

@@ -0,0 +1,384 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, Signal, ElementRef, WritableSignal, InputSignal, InputSignalWithTransform, OutputEmitterRef, OnInit, ModelSignal } from '@angular/core';
+import { RtFormControlBase } from '@rt-tools/ui-kit-v2/form-control';
+import { TRtRadius, IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import { RtPopoverDirective } from '@rt-tools/ui-kit-v2/popover';
+
+/**
+ * Модель `rt-dynamic-selector`: один корневой неймспейс с префиксом `I`.
+ */
+declare namespace IRtDynamicSelector {
+    /** Состояние флажка «Выбрать всё» по видимым пунктам. */
+    type SelectAllState = 'none' | 'some' | 'all';
+    /** Как выбирает всплывающий список: один пункт переключателем или несколько флажками. */
+    type Mode = 'single' | 'multi';
+    /** Строки всплывающего выбора: отмеченные раньше над разделителем и найденные под ним. */
+    interface PopupRows<T> {
+        readonly ticked: ReadonlyArray<T>;
+        readonly found: ReadonlyArray<T>;
+    }
+    /** Строка всплывающего выбора, готовая для разметки. */
+    interface PopupRow<T> {
+        readonly entity: T;
+        readonly key: unknown;
+        readonly label: string;
+        readonly ticked: boolean;
+        /** Под строкой стоит разделитель. */
+        readonly separated: boolean;
+    }
+    /** Строка списка выбранного, готовая для разметки. */
+    interface ListRow<T> {
+        readonly item: T;
+        readonly key: unknown;
+        readonly label: string;
+        /** Строку нельзя убрать из списка. */
+        readonly locked: boolean;
+    }
+    /** Перенос строки списка выбранного: откуда и куда. */
+    interface Move {
+        readonly from: number;
+        readonly to: number;
+    }
+    /** Обстановка шаблона строки, который принёс вызывающий. */
+    interface RowContext<T> {
+        readonly $implicit: T;
+    }
+    /** Правка строки поля списка строк: прежнее значение и новое. */
+    interface TextEdit {
+        readonly previous: string;
+        readonly next: string;
+    }
+}
+
+/**
+ * Маркеры частей строки списка выбранного — своим файлом, как у соседних семей.
+ *
+ * Маркер держит свой шаблон и о списке не знает ничего: селектор и поле списка строк читают его
+ * среди своего содержимого и отдают шаблон списку. Удаление и ручка перетаскивания остаются
+ * за китом.
+ */
+/**
+ * Свои кнопки у каждой строки: стоят перед кнопкой удаления.
+ *
+ * @example
+ * ```html
+ * <rt-dynamic-selector keyExp="id" displayExp="name" [entities]="people()">
+ *     <ng-template rtDynamicSelectorRowControls let-person>
+ *         <rt-icon-button icon="info" ariaLabel="About" (clicked)="open(person)" />
+ *     </ng-template>
+ * </rt-dynamic-selector>
+ * ```
+ */
+declare class RtDynamicSelectorRowControlsDirective<T = unknown> {
+    readonly templateRef: TemplateRef<IRtDynamicSelector.RowContext<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicSelectorRowControlsDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDynamicSelectorRowControlsDirective<any>, "[rtDynamicSelectorRowControls]", never, {}, {}, never, never, true, never>;
+}
+/** Своё название строки вместо подписи из поля записи. */
+declare class RtDynamicSelectorRowTitleDirective<T = unknown> {
+    readonly templateRef: TemplateRef<IRtDynamicSelector.RowContext<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicSelectorRowTitleDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtDynamicSelectorRowTitleDirective<any>, "[rtDynamicSelectorRowTitle]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Поле списка строк: строки человек набирает сам. Значение — массив строк в порядке списка.
+ * Enter или уход из поля добавляют срезанный по краям текст в конец; пустой и повторный не
+ * добавляются. Сброс, очистка, удаление строки и перетаскивание — те же, что у селектора.
+ *
+ * @example
+ * ```html
+ * <rt-dynamic-input editable [formControl]="tags" />
+ * ```
+ */
+declare class RtDynamicInputComponent extends RtFormControlBase<string[]> {
+    #private;
+    protected readonly addLabel: Signal<string>;
+    protected readonly placeholderLabel: Signal<string>;
+    protected readonly field: Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly rowControls: Signal<RtDynamicSelectorRowControlsDirective<string> | undefined>;
+    protected readonly controlsTpl: Signal<TemplateRef<IRtDynamicSelector.RowContext<string>> | null>;
+    /** Поле набора открыто, и в нём текст. */
+    protected readonly isFieldShown: WritableSignal<boolean>;
+    protected readonly draft: WritableSignal<string>;
+    /** Приглашение снимается нажатием его кнопки и до новой записи формы не возвращается. */
+    protected readonly isInvitationDismissed: WritableSignal<boolean>;
+    protected readonly rows: Signal<IRtDynamicSelector.ListRow<string>[]>;
+    protected readonly isInvitationShown: Signal<boolean>;
+    protected readonly isAddShown: Signal<boolean>;
+    protected readonly isKeysReset: Signal<boolean>;
+    protected readonly isKeysClear: Signal<boolean>;
+    /** Правки в шаблоне строки держат сброс и очистку включёнными, даже когда строки не менялись. */
+    protected readonly isResetDisabled: Signal<boolean>;
+    protected readonly isClearDisabled: Signal<boolean>;
+    protected readonly addTitle: Signal<string>;
+    protected readonly fieldPlaceholder: Signal<string>;
+    protected readonly hasValue: Signal<boolean>;
+    readonly buttonTitle: InputSignal<string>;
+    readonly placeholder: InputSignal<string>;
+    /** Строки, которые нельзя убрать из списка. */
+    readonly readonlyKeys: InputSignal<ReadonlyArray<string>>;
+    readonly draggable: InputSignalWithTransform<boolean, unknown>;
+    /** Шаг скругления кнопок-иконок списка; по умолчанию они круглые. */
+    readonly buttonRadius: InputSignal<TRtRadius | null>;
+    readonly editable: InputSignalWithTransform<boolean, unknown>;
+    readonly invitation: InputSignalWithTransform<boolean, unknown>;
+    readonly invitationIcon: InputSignal<IRtIcon.Name | null>;
+    readonly invitationDescription: InputSignal<string>;
+    /** Корзина строк; без неё строки убирает только очистка или сам вызывающий. */
+    readonly removeShown: InputSignalWithTransform<boolean, unknown>;
+    /** Сброс и очистка под списком: `false` их убирает, кнопка добавления остаётся. */
+    readonly listActionsShown: InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Строки правлены в шаблоне вызывающего: сброс и очистка включены и тогда, когда строки прежние.
+     * Сброс сообщает `listReset`, очистка — `listCleared`, и вызывающий снимает свои правки.
+     */
+    readonly extraChanged: InputSignalWithTransform<boolean, unknown>;
+    readonly listReset: OutputEmitterRef<void>;
+    readonly listCleared: OutputEmitterRef<void>;
+    readonly displayText: Signal<string>;
+    /** Записанное формой становится и списком, и значением для сброса; пустой массив список опустошает. */
+    writeValue(value: string[] | null): void;
+    protected onAdd(): void;
+    /** Enter или уход из поля: пустой текст поле не закрывает, повторный закрывает без изменений. */
+    protected onCommit(): void;
+    protected onRemoved(key: unknown): void;
+    protected onMoved(move: IRtDynamicSelector.Move): void;
+    protected onEdited(edit: IRtDynamicSelector.TextEdit): void;
+    protected onReset(): void;
+    protected onCleared(): void;
+    protected getEmptyValue(): string[];
+    protected focusAfterClear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDynamicInputComponent, "rt-dynamic-input", never, { "buttonTitle": { "alias": "buttonTitle"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "readonlyKeys": { "alias": "readonlyKeys"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "buttonRadius": { "alias": "buttonRadius"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "invitation": { "alias": "invitation"; "required": false; "isSignal": true; }; "invitationIcon": { "alias": "invitationIcon"; "required": false; "isSignal": true; }; "invitationDescription": { "alias": "invitationDescription"; "required": false; "isSignal": true; }; "removeShown": { "alias": "removeShown"; "required": false; "isSignal": true; }; "listActionsShown": { "alias": "listActionsShown"; "required": false; "isSignal": true; }; "extraChanged": { "alias": "extraChanged"; "required": false; "isSignal": true; }; }, { "listReset": "listReset"; "listCleared": "listCleared"; }, ["rowControls"], never, true, never>;
+}
+
+/**
+ * Список выбранного семьи динамических селекторов: строки с удалением, ручкой перетаскивания и
+ * правкой, под ними полоса с кнопкой добавления вызывающего, сбросом и очисткой. Значения список
+ * не держит: он сообщает, что человек сделал, а селектор и поле списка строк решают, что из этого
+ * выходит.
+ */
+declare class RtDynamicSelectorListComponent<TItem> {
+    #private;
+    /** На узком экране подсказки кнопок не показываются: наведения там нет. */
+    protected readonly isNarrow: Signal<boolean>;
+    protected readonly dragLabel: Signal<string>;
+    protected readonly removeLabel: Signal<string>;
+    protected readonly editLabel: Signal<string>;
+    protected readonly applyLabel: Signal<string>;
+    protected readonly cancelLabel: Signal<string>;
+    protected readonly resetLabel: Signal<string>;
+    protected readonly clearLabel: Signal<string>;
+    /** Строка, открытая для правки, и текст в её поле. */
+    protected readonly editedIndex: WritableSignal<number | null>;
+    protected readonly draft: WritableSignal<string>;
+    readonly rows: InputSignal<ReadonlyArray<IRtDynamicSelector.ListRow<TItem>>>;
+    readonly draggable: InputSignalWithTransform<boolean, unknown>;
+    readonly editable: InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: InputSignalWithTransform<boolean, unknown>;
+    /** Полоса под строками; приглашение вызывающего встаёт на её место. */
+    readonly actionsShown: InputSignalWithTransform<boolean, unknown>;
+    /** Сброс и очистка в полосе; без них в полосе остаётся кнопка добавления. */
+    readonly resetClearShown: InputSignalWithTransform<boolean, unknown>;
+    /** Корзина строк; без неё строки двигаются и правятся, но не убираются. */
+    readonly removeShown: InputSignalWithTransform<boolean, unknown>;
+    readonly resetDisabled: InputSignalWithTransform<boolean, unknown>;
+    readonly clearDisabled: InputSignalWithTransform<boolean, unknown>;
+    /** Шаг скругления кнопок-иконок списка; по умолчанию они круглые. */
+    readonly buttonRadius: InputSignal<TRtRadius | null>;
+    readonly titleTpl: InputSignal<TemplateRef<IRtDynamicSelector.RowContext<TItem>> | null>;
+    readonly controlsTpl: InputSignal<TemplateRef<IRtDynamicSelector.RowContext<TItem>> | null>;
+    readonly removed: OutputEmitterRef<unknown>;
+    readonly moved: OutputEmitterRef<IRtDynamicSelector.Move>;
+    readonly edited: OutputEmitterRef<IRtDynamicSelector.TextEdit>;
+    readonly resetClicked: OutputEmitterRef<void>;
+    readonly cleared: OutputEmitterRef<void>;
+    /** Строка, взятая из чужого списка, ничего не меняет; брошенная на своё место — тоже. */
+    protected onDrop(event: CdkDragDrop<unknown>): void;
+    protected onRemove(row: IRtDynamicSelector.ListRow<TItem>): void;
+    protected onEditStart(index: number, row: IRtDynamicSelector.ListRow<TItem>): void;
+    protected onEditApply(row: IRtDynamicSelector.ListRow<TItem>): void;
+    protected onEditCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicSelectorListComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDynamicSelectorListComponent<any>, "rt-dynamic-selector-list", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "actionsShown": { "alias": "actionsShown"; "required": false; "isSignal": true; }; "resetClearShown": { "alias": "resetClearShown"; "required": false; "isSignal": true; }; "removeShown": { "alias": "removeShown"; "required": false; "isSignal": true; }; "resetDisabled": { "alias": "resetDisabled"; "required": false; "isSignal": true; }; "clearDisabled": { "alias": "clearDisabled"; "required": false; "isSignal": true; }; "buttonRadius": { "alias": "buttonRadius"; "required": false; "isSignal": true; }; "titleTpl": { "alias": "titleTpl"; "required": false; "isSignal": true; }; "controlsTpl": { "alias": "controlsTpl"; "required": false; "isSignal": true; }; }, { "removed": "removed"; "moved": "moved"; "edited": "edited"; "resetClicked": "resetClicked"; "cleared": "cleared"; }, never, ["*"], true, never>;
+}
+
+/** Сколько ждёт поиск на сервере после последней нажатой клавиши. */
+declare const RT_DYNAMIC_SELECTOR_SEARCH_DEBOUNCE: number;
+/**
+ * Всплывающий выбор динамического селектора: поиск, флажки или переключатели, «Выбрать всё»,
+ * догрузка при прокрутке, «Отмена» и «Применить». Отметки живут в самом окне и уходят наружу
+ * только по «Применить»: окно создаётся заново при каждом открытии, и закрытие их сбрасывает.
+ */
+declare class RtDynamicSelectorPopupComponent<TEntity extends object> implements OnInit {
+    #private;
+    protected readonly searchLabel: Signal<string>;
+    protected readonly selectAllLabel: Signal<string>;
+    protected readonly multiLabel: Signal<string>;
+    protected readonly multiHintLabel: Signal<string>;
+    protected readonly noResultsLabel: Signal<string>;
+    protected readonly cancelLabel: Signal<string>;
+    protected readonly applyLabel: Signal<string>;
+    /** Отмеченные ключи — ещё не применённые. */
+    protected readonly ticked: WritableSignal<unknown[]>;
+    protected readonly query: WritableSignal<string>;
+    /** Выбор нескольких включён: без него простое нажатие оставляет одну отметку. */
+    protected readonly isMultiOn: WritableSignal<boolean>;
+    /** Найденные строки: местный поиск отбирает сам, серверный отдаёт запрос наружу. */
+    protected readonly found: Signal<TEntity[]>;
+    protected readonly rows: Signal<IRtDynamicSelector.PopupRows<TEntity>>;
+    protected readonly visibleKeys: Signal<unknown[]>;
+    /** Строки для разметки: отмеченные раньше над разделителем, найденные — под ним. */
+    protected readonly rowItems: Signal<IRtDynamicSelector.PopupRow<TEntity>[]>;
+    protected readonly hasRows: Signal<boolean>;
+    protected readonly selectAllState: Signal<IRtDynamicSelector.SelectAllState>;
+    protected readonly isSingle: Signal<boolean>;
+    protected readonly isSelectAllShown: Signal<boolean>;
+    protected readonly isMultiToggleVisible: Signal<boolean>;
+    protected readonly lastPinnedKey: Signal<unknown>;
+    protected readonly isApplyDisabled: Signal<boolean>;
+    protected readonly isNavShown: Signal<boolean>;
+    /** Предлагаемые записи: ещё не выбранные, отсортированные селектором. */
+    readonly entities: InputSignal<ReadonlyArray<TEntity>>;
+    readonly keyExp: InputSignal<keyof TEntity & string>;
+    readonly displayExp: InputSignal<keyof TEntity & string>;
+    readonly mode: InputSignal<IRtDynamicSelector.Mode>;
+    readonly multiToggleShown: InputSignalWithTransform<boolean, unknown>;
+    readonly selectAllShown: InputSignalWithTransform<boolean, unknown>;
+    readonly localSearch: InputSignalWithTransform<boolean, unknown>;
+    readonly lazyLoad: InputSignalWithTransform<boolean, unknown>;
+    readonly loading: InputSignalWithTransform<boolean, unknown>;
+    readonly fetching: InputSignalWithTransform<boolean, unknown>;
+    readonly pinnedKeys: InputSignal<ReadonlyArray<unknown>>;
+    readonly navigateTitle: InputSignal<string>;
+    readonly navigateLink: InputSignal<string>;
+    /** Запрос, с которым выбор открывается; событием поиска он не уходит — вызывающий его знает. */
+    readonly searchTerm: InputSignal<string>;
+    /** Применённые ключи в порядке отметок. */
+    readonly applied: OutputEmitterRef<unknown[]>;
+    readonly cancelled: OutputEmitterRef<void>;
+    /** Запрос для поиска на сервере: через паузу после последней клавиши, стёртый — пустой строкой. */
+    readonly searchChange: OutputEmitterRef<string>;
+    readonly loadMore: OutputEmitterRef<void>;
+    /** Отмеченные записи: пустой список при открытии и текущие отметки после каждого поиска. */
+    readonly temporaryChoiceChange: OutputEmitterRef<TEntity[]>;
+    ngOnInit(): void;
+    protected onQueryChange(value: string | null): void;
+    /** Нажатие строки флажков: при выключенном выборе нескольких без Ctrl или Cmd остаётся одна отметка. */
+    protected onRowClick(event: MouseEvent, item: TEntity): void;
+    protected onRadioChange(item: TEntity): void;
+    protected onSelectAll(checked: boolean): void;
+    protected onMultiToggle(value: boolean): void;
+    protected onApply(): void;
+    protected onCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicSelectorPopupComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDynamicSelectorPopupComponent<any>, "rt-dynamic-selector-popup", never, { "entities": { "alias": "entities"; "required": false; "isSignal": true; }; "keyExp": { "alias": "keyExp"; "required": true; "isSignal": true; }; "displayExp": { "alias": "displayExp"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "multiToggleShown": { "alias": "multiToggleShown"; "required": false; "isSignal": true; }; "selectAllShown": { "alias": "selectAllShown"; "required": false; "isSignal": true; }; "localSearch": { "alias": "localSearch"; "required": false; "isSignal": true; }; "lazyLoad": { "alias": "lazyLoad"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "navigateTitle": { "alias": "navigateTitle"; "required": false; "isSignal": true; }; "navigateLink": { "alias": "navigateLink"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "applied": "applied"; "cancelled": "cancelled"; "searchChange": "searchChange"; "loadMore": "loadMore"; "temporaryChoiceChange": "temporaryChoiceChange"; }, never, never, true, never>;
+}
+
+/**
+ * Динамический селектор: поле формы со списком выбранных записей. Значение — массив ключей в
+ * порядке списка. Записи добавляются всплывающим выбором, убираются корзиной строки, список
+ * возвращается к записанному формой сбросом и пустеет очисткой — кроме строк только для чтения.
+ *
+ * @example
+ * ```html
+ * <rt-dynamic-selector keyExp="id" displayExp="name" [entities]="people()" [formControl]="team" />
+ * ```
+ */
+declare class RtDynamicSelectorComponent<TEntity extends object> extends RtFormControlBase<unknown[]> {
+    #private;
+    protected readonly addLabel: Signal<string>;
+    protected readonly nothingToChooseLabel: Signal<string>;
+    /** Всплывающий выбор открывается от нажатой кнопки добавления: у полосы и у приглашения — свой. */
+    protected readonly popovers: Signal<readonly RtPopoverDirective[]>;
+    protected readonly rowTitle: Signal<RtDynamicSelectorRowTitleDirective<TEntity> | undefined>;
+    protected readonly rowControls: Signal<RtDynamicSelectorRowControlsDirective<TEntity> | undefined>;
+    protected readonly titleTpl: Signal<TemplateRef<IRtDynamicSelector.RowContext<TEntity>> | null>;
+    protected readonly controlsTpl: Signal<TemplateRef<IRtDynamicSelector.RowContext<TEntity>> | null>;
+    /** Выбранные записи в порядке значения; ключ, которого нет среди записей, строки не рисует. */
+    protected readonly chosen: Signal<TEntity[]>;
+    protected readonly rows: Signal<IRtDynamicSelector.ListRow<TEntity>[]>;
+    /** Что предлагает всплывающий выбор: ещё не выбранное, в порядке вызывающего или по алфавиту. */
+    protected readonly offered: Signal<TEntity[]>;
+    protected readonly hasOffer: Signal<boolean>;
+    protected readonly isNothingToChoose: Signal<boolean>;
+    protected readonly isAddShown: Signal<boolean>;
+    protected readonly isKeysReset: Signal<boolean>;
+    protected readonly isKeysClear: Signal<boolean>;
+    /** Правки в шаблоне строки держат сброс и очистку включёнными, даже когда ключи не менялись. */
+    protected readonly isResetDisabled: Signal<boolean>;
+    protected readonly isClearDisabled: Signal<boolean>;
+    protected readonly addTitle: Signal<string>;
+    protected readonly hasValue: Signal<boolean>;
+    /** Записи, из которых выбирают; у каждой есть поле ключа и поле подписи. */
+    readonly entities: InputSignal<ReadonlyArray<TEntity>>;
+    readonly keyExp: InputSignal<keyof TEntity & string>;
+    readonly displayExp: InputSignal<keyof TEntity & string>;
+    readonly mode: InputSignal<IRtDynamicSelector.Mode>;
+    /** Название кнопки добавления; пустое — «Add» из словаря кита. */
+    readonly buttonTitle: InputSignal<string>;
+    readonly addShown: InputSignalWithTransform<boolean, unknown>;
+    /** Корзина строк; без неё записи убирает только очистка или сам вызывающий. */
+    readonly removeShown: InputSignalWithTransform<boolean, unknown>;
+    /** Сброс и очистка под списком: `false` их убирает, кнопка добавления остаётся. */
+    readonly listActionsShown: InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Строки правлены в шаблоне вызывающего: сброс и очистка включены и тогда, когда ключи прежние.
+     * Сброс сообщает `listReset`, очистка — `listCleared`, и вызывающий снимает свои правки.
+     */
+    readonly extraChanged: InputSignalWithTransform<boolean, unknown>;
+    /** Запрос, с которым открывается всплывающий выбор; событием поиска он не уходит. */
+    readonly searchTerm: InputSignal<string>;
+    /** Ключи, которые нельзя убрать из списка. */
+    readonly readonlyKeys: InputSignal<ReadonlyArray<unknown>>;
+    /** Ключи строк всплывающего выбора, под последней из которых стоит разделитель. */
+    readonly pinnedKeys: InputSignal<ReadonlyArray<unknown>>;
+    readonly draggable: InputSignalWithTransform<boolean, unknown>;
+    /** Шаг скругления кнопок-иконок списка; по умолчанию они круглые. */
+    readonly buttonRadius: InputSignal<TRtRadius | null>;
+    /** Приглашение вместо полосы кнопок: значок, описание и кнопка добавления. */
+    readonly invitation: InputSignalWithTransform<boolean, unknown>;
+    readonly invitationIcon: InputSignal<IRtIcon.Name | null>;
+    readonly invitationDescription: InputSignal<string>;
+    readonly multiToggleShown: InputSignalWithTransform<boolean, unknown>;
+    readonly selectAllShown: InputSignalWithTransform<boolean, unknown>;
+    readonly localSearch: InputSignalWithTransform<boolean, unknown>;
+    readonly lazyLoad: InputSignalWithTransform<boolean, unknown>;
+    readonly loading: InputSignalWithTransform<boolean, unknown>;
+    readonly fetching: InputSignalWithTransform<boolean, unknown>;
+    readonly navigateTitle: InputSignal<string>;
+    readonly navigateLink: InputSignal<string>;
+    readonly sortFn: InputSignal<((a: TEntity, b: TEntity) => number) | null>;
+    /** Выбранные записи: те же, что уходят событием изменения выбора. */
+    readonly chosenEntities: ModelSignal<TEntity[]>;
+    readonly selectionChange: OutputEmitterRef<TEntity[]>;
+    readonly listReset: OutputEmitterRef<void>;
+    readonly listCleared: OutputEmitterRef<void>;
+    /** Всплывающий выбор открылся или закрылся. */
+    readonly popupOpenChange: OutputEmitterRef<boolean>;
+    readonly searchChange: OutputEmitterRef<string>;
+    readonly loadMore: OutputEmitterRef<void>;
+    readonly temporaryChoiceChange: OutputEmitterRef<TEntity[]>;
+    /** Открыт ли всплывающий выбор — от кнопки полосы или от кнопки приглашения. */
+    readonly popupOpen: Signal<boolean>;
+    readonly displayText: Signal<string>;
+    /** Записанное формой становится и списком, и значением для сброса; пустой массив список опустошает. */
+    writeValue(value: unknown[] | null): void;
+    protected onAdd(popover: RtPopoverDirective): void;
+    protected onApplied(keys: unknown[]): void;
+    protected onCancelled(): void;
+    protected onRemoved(key: unknown): void;
+    protected onMoved(move: IRtDynamicSelector.Move): void;
+    protected onReset(): void;
+    protected onCleared(): void;
+    protected onOpened(): void;
+    protected onClosed(): void;
+    protected getEmptyValue(): unknown[];
+    protected focusAfterClear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtDynamicSelectorComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtDynamicSelectorComponent<any>, "rt-dynamic-selector", never, { "entities": { "alias": "entities"; "required": false; "isSignal": true; }; "keyExp": { "alias": "keyExp"; "required": true; "isSignal": true; }; "displayExp": { "alias": "displayExp"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "buttonTitle": { "alias": "buttonTitle"; "required": false; "isSignal": true; }; "addShown": { "alias": "addShown"; "required": false; "isSignal": true; }; "removeShown": { "alias": "removeShown"; "required": false; "isSignal": true; }; "listActionsShown": { "alias": "listActionsShown"; "required": false; "isSignal": true; }; "extraChanged": { "alias": "extraChanged"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "readonlyKeys": { "alias": "readonlyKeys"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "buttonRadius": { "alias": "buttonRadius"; "required": false; "isSignal": true; }; "invitation": { "alias": "invitation"; "required": false; "isSignal": true; }; "invitationIcon": { "alias": "invitationIcon"; "required": false; "isSignal": true; }; "invitationDescription": { "alias": "invitationDescription"; "required": false; "isSignal": true; }; "multiToggleShown": { "alias": "multiToggleShown"; "required": false; "isSignal": true; }; "selectAllShown": { "alias": "selectAllShown"; "required": false; "isSignal": true; }; "localSearch": { "alias": "localSearch"; "required": false; "isSignal": true; }; "lazyLoad": { "alias": "lazyLoad"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "navigateTitle": { "alias": "navigateTitle"; "required": false; "isSignal": true; }; "navigateLink": { "alias": "navigateLink"; "required": false; "isSignal": true; }; "sortFn": { "alias": "sortFn"; "required": false; "isSignal": true; }; "chosenEntities": { "alias": "chosenEntities"; "required": false; "isSignal": true; }; }, { "chosenEntities": "chosenEntitiesChange"; "selectionChange": "selectionChange"; "listReset": "listReset"; "listCleared": "listCleared"; "popupOpenChange": "popupOpenChange"; "searchChange": "searchChange"; "loadMore": "loadMore"; "temporaryChoiceChange": "temporaryChoiceChange"; }, ["rowTitle", "rowControls"], never, true, never>;
+}
+
+export { IRtDynamicSelector, RT_DYNAMIC_SELECTOR_SEARCH_DEBOUNCE, RtDynamicInputComponent, RtDynamicSelectorComponent, RtDynamicSelectorListComponent, RtDynamicSelectorPopupComponent, RtDynamicSelectorRowControlsDirective, RtDynamicSelectorRowTitleDirective };

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

@@ -0,0 +1,29 @@
+import { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from '@angular/core';
+import { InputSignal, InputSignalWithTransform } from '@angular/core';
+import { IRtIcon } from '@rt-tools/ui-kit-v2/core';
+import * as i1 from '@rt-tools/ui-kit-v2/radius';
+
+/**
+ * Заглушка пустого состояния: центрированная иконка в круглой подложке, заголовок,
+ * опциональное описание и проецируемый слот для действия (кнопка «Прикрепить»,
+ * «Выбрать» и т.п.). Применяется в пустых вкладках/списках и зонах загрузки, когда
+ * сущностей ещё нет.
+ *
+ * Иконка опциональна (`icon`), действие — через `<ng-content />` (если ничего не
+ * спроецировано, слот скрыт `:empty`). Громких severity-цветов нет — приглушённая
+ * палитра, как у `rt-note`.
+ */
+declare class RtEmptyStateComponent {
+    readonly icon: InputSignal<IRtIcon.Name | null>;
+    /** Имя Material вместо `icon` — рисуется так же, как вход `glyph` у `rt-icon`. */
+    readonly glyph: InputSignal<string | null>;
+    readonly title: InputSignal<string>;
+    readonly description: InputSignal<string | null>;
+    /** Пунктирная рамка вокруг заглушки — так она читается как зона, куда бросают файл. */
+    readonly framed: InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtEmptyStateComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtEmptyStateComponent, "rt-empty-state", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "glyph": { "alias": "glyph"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "framed": { "alias": "framed"; "required": false; "isSignal": true; }; }, {}, never, ["[rtEmptyIllustration]", "*"], true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+}
+
+export { RtEmptyStateComponent };