@rt-tools/ui-kit-v2 0.11.0 → 0.12.0

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

@@ -0,0 +1,529 @@
+import * as i0 from '@angular/core';
+import { AfterViewInit, OnDestroy, Signal, ElementRef, WritableSignal, InputSignal, OutputEmitterRef, InputSignalWithTransform, TemplateRef, PipeTransform } from '@angular/core';
+import { RtFormControlBase, IQuillDelta, TRtKitLabelMap } from '@rt-tools/ui-kit-v2';
+import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
+import { FormGroup, FormControl } from '@angular/forms';
+
+/**
+ * Режим тулбара: `full` — весь whitelist, `minimal` — жирный + два списка
+ * (G113: чаты оператора/админа/саппорта).
+ */
+type TRtRichEditorToolbar = 'full' | 'minimal';
+/**
+ * Rich-редактор чата на Quill. Наследует CVA-ядро input-семейства
+ * (`RtFormControlBase`) — плагается в reactive-форму. Quill грузится **лениво**
+ * (`import("quill")` в `ngAfterViewInit`), тип импортируется `import type` и в
+ * бандл не попадает. Значение CVA — `IQuillDelta` (или `null`, когда пусто).
+ */
+declare class RtRichEditorComponent extends RtFormControlBase<IQuillDelta | null> implements AfterViewInit, OnDestroy {
+    #private;
+    protected readonly editorHost: Signal<ElementRef<HTMLElement>>;
+    /**
+     * Смонтирована ли начинка редактора. Пока нет, хост несёт признак недостроенности: съёмке
+     * витрины и любой другой проверке снаружи иначе нечем отличить недостроенный редактор от
+     * достроенного пустого — оба выглядят пустым местом.
+     */
+    protected readonly mounted: WritableSignal<boolean>;
+    protected readonly hasValue: Signal<boolean>;
+    readonly placeholder: InputSignal<string>;
+    /** Набор кнопок форматирования; сужает и принимаемые форматы (вставка из буфера). */
+    readonly toolbar: InputSignal<TRtRichEditorToolbar>;
+    /** Enter без Shift в редакторе — сигнал отправки (Shift+Enter остаётся переносом). */
+    readonly enterPressed: OutputEmitterRef<void>;
+    readonly displayText: Signal<string>;
+    ngAfterViewInit(): Promise<void>;
+    ngOnDestroy(): void;
+    writeValue(value: IQuillDelta | null): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected getEmptyValue(): IQuillDelta | null;
+    protected focusAfterClear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtRichEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtRichEditorComponent, "rt-rich-editor", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; }, { "enterPressed": "enterPressed"; }, never, never, true, never>;
+}
+
+/**
+ * Модель `<rt-message-composer>`: один корневой неймспейс с
+ * префиксом `I`.
+ */
+declare namespace IRtMessageComposer {
+    /** Полезная нагрузка отправки: текст сообщения + прикреплённые файлы. */
+    interface SubmitPayload {
+        text: string;
+        files: File[];
+        /**
+         * Rich-тело строкой JSON (при `formatting`-режиме) — взаимоисключимо с
+         * непустым `text`. `null`/отсутствует ⇒ отправляется plain-текст.
+         */
+        delta?: string | null;
+    }
+}
+
+interface IComposerFormShape {
+    message: FormControl<string>;
+    files: FormControl<File[]>;
+    delta: FormControl<IQuillDelta | null>;
+}
+/**
+ * Композер сообщения: авто-растущая textarea сверху, под разделительной линией —
+ * ряд контролов (слева — прикрепить файл, справа — отправить). Презентационный,
+ * без data-access: наружу торчит только `submitted` с текстом и файлами.
+ *
+ * Отправка — `Enter` (без Shift) или клик по иконке; `Shift+Enter` — перенос
+ * строки. Кнопка отправки активна, пока есть непустой текст или вложения.
+ */
+declare class RtMessageComposerComponent {
+    #private;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly placeholderText: Signal<string>;
+    protected readonly fileInput: Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly form: FormGroup<IComposerFormShape>;
+    protected readonly files: Signal<readonly File[]>;
+    /** Отправка доступна: есть контент (текст/delta/файлы), композер не занят. */
+    protected readonly canSend: Signal<boolean>;
+    /** Текст-подсказка textarea. Пусто — берётся переведённое умолчание. */
+    readonly placeholder: InputSignal<string>;
+    /** Фильтр типов для file-input (`.pdf,.doc,...`). */
+    readonly accept: InputSignal<string>;
+    /** Показывать кнопку вложения и список файлов. */
+    readonly attachments: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Отправка в процессе — блокирует submit и показывает её недоступность. */
+    readonly sending: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Полная блокировка композера. */
+    readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Rich-режим: вместо textarea — Quill-редактор, отправка уходит delta-каналом. */
+    readonly formatting: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Набор кнопок rich-редактора (проброс в `rt-rich-editor`). */
+    readonly toolbar: InputSignal<TRtRichEditorToolbar>;
+    /** Минимальная высота textarea в строках. */
+    readonly minRows: InputSignalWithTransform<number, NumberInput>;
+    /** Максимальная высота textarea в строках (дальше — скролл). */
+    readonly maxRows: InputSignalWithTransform<number, NumberInput>;
+    /**
+     * Файлы, выброшенные drag-n-drop'ом в обёртку чата: пробрасываются сюда как
+     * вложения. Каждый физический drop даёт новый массив, поэтому effect
+     * перезапускается на каждое перетаскивание; файлы добавляются к уже выбранным.
+     */
+    readonly droppedFiles: InputSignal<File[] | null>;
+    /** Отправка сообщения: текст + файлы (последние — только при `attachments`). */
+    readonly submitted: OutputEmitterRef<IRtMessageComposer.SubmitPayload>;
+    constructor();
+    protected onKeydown(event: KeyboardEvent): void;
+    protected openPicker(): void;
+    protected onFilesPicked(event: Event): void;
+    protected removeFile(index: number): void;
+    protected submit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtMessageComposerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtMessageComposerComponent, "rt-message-composer", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "formatting": { "alias": "formatting"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "droppedFiles": { "alias": "droppedFiles"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; }, never, never, true, never>;
+}
+
+/**
+ * Модель общего чат-компонента `rt-chat`: один корневой неймспейс
+ * с префиксом `I`. Доменные стора маппят свою модель сообщения в `Message`, а сам
+ * `rt-chat` ничего не знает о доменных сущностях — только рисует тред и композер.
+ */
+/**
+ * Судьба своего сообщения в ленте: пока летит на сервер — часы, после записи —
+ * двойной чек, после того как собеседник открыл переписку — тот же чек синим,
+ * при обрыве — «!» с повтором. Входящие сообщения статуса не имеют.
+ */
+declare enum ERtChatMessageStatus {
+    Sending = "sending",
+    Sent = "sent",
+    Read = "read",
+    Failed = "failed"
+}
+declare namespace IRtChat {
+    /** Алиас enum'а для доменных мапперов, работающих через неймспейс. */
+    type MessageStatus = ERtChatMessageStatus;
+    /**
+     * Есть ли у реплики доступные действия потребителя — гейт кнопки «…» у неё.
+     *
+     * Признак приходит предикатом, а не полем модели: действие, которого кит не знает,
+     * его моделью и не описывается.
+     */
+    type MessageActionsPredicate = (message: Message) => boolean;
+    /** Вложение сообщения — домен маппит свой ресурс, скачивание по `public_id`. */
+    interface Attachment {
+        id: number;
+        /** Обезличенное имя для карточки файла. */
+        name: string;
+        /** Непрозрачный идентификатор файла — консюмер качает blob по нему. */
+        publicId: string;
+    }
+    /**
+     * Одно сообщение треда в уже подготовленной для отображения форме: автор —
+     * готовый лейбл (домен решает, как его собрать), `own`/`system` — флаги
+     * выравнивания и стиля, дата — ISO-строка (форматируется `DatePipe` внутри).
+     */
+    interface Message {
+        /** Идентификатор сообщения — ключ `@for track`. */
+        id: number | string;
+        /** Клиентский временный id оптимистичного сообщения (до ответа сервера). */
+        tempId?: string;
+        /**
+         * Статус своего сообщения. Отсутствует у входящих: чужому сообщению
+         * нечего сообщать о доставке.
+         */
+        status?: MessageStatus;
+        /** Готовый лейбл автора (доменный authorLabel). */
+        author: string;
+        /** Сообщение текущего пользователя — выравнивается вправо, акцентный фон. */
+        own: boolean;
+        /** Признак системного сообщения (рендерится обычным входящим пузырём). */
+        system?: boolean;
+        text: string;
+        /**
+         * Rich-тело (Quill delta) — при наличии рендерится вместо plain `text`
+         * через `rt-delta-view`. `null`/отсутствует ⇒ показываем `text`.
+         */
+        delta?: IQuillDelta | null;
+        /** ISO-дата создания. */
+        createdAt: string;
+        /** URL вложения (если есть) — наличие включает карточку файла. */
+        fileUrl?: string | null;
+        /** Имя вложения для отображения в карточке. */
+        fileName?: string | null;
+        /**
+         * Вложения сообщения (несколько файлов). Непустой массив имеет приоритет
+         * над legacy-парой `fileUrl`/`fileName` (та равна первому вложению).
+         */
+        attachments?: readonly Attachment[];
+        /** Внешняя ссылка-призыв (привязка Telegram) — наличие включает кнопку-ссылку. */
+        deepLink?: string | null;
+        /** Подпись кнопки-ссылки `deepLink` (домен решает текст по состоянию). */
+        deepLinkLabel?: string | null;
+        /** Сообщение помечено удалённым — рендерится плейсхолдером вместо содержимого. */
+        deleted?: boolean;
+        /** Показать действие «удалить» на этом сообщении (домен решает по правам/направлению). */
+        canDelete?: boolean;
+        /**
+         * Текст подтверждения перед удалением. Задан — клик по корзине открывает
+         * confirm-попап с этим текстом, удаление уходит только после подтверждения.
+         * Пусто/undefined — удаление сразу по клику (домен без confirm-семантики).
+         */
+        deleteConfirm?: string;
+    }
+    /** Payload отправки: текст + файлы (пусто/undefined, если вложения выключены). */
+    interface SendPayload {
+        text: string;
+        files?: File[];
+        /**
+         * Rich-тело строкой JSON (`JSON.stringify(getContents())`) — взаимоисключимо
+         * с непустым `text`. При наличии домен шлёт delta-канал (`message:""`).
+         */
+        delta?: string | null;
+    }
+}
+
+/**
+ * Контекст шаблона `[rtChatMessageActions]`: `$implicit` — реплика треда.
+ */
+interface IRtChatMessageActionsContext {
+    $implicit: IRtChat.Message;
+}
+/**
+ * Захватывает `<ng-template rtChatMessageActions let-message>` — содержимое «…»-меню
+ * действий у реплики. `rt-chat` рисует этот шаблон рядом с точечными действиями реплики,
+ * прокидывая её через `$implicit`.
+ *
+ * Точечные действия остаются на месте: удаление, повтор отправки и скачивание общи для
+ * любой переписки. Шаблон нужен тем действиям, которых кит не знает и знать не должен, —
+ * без него потребителю оставалось ждать правки кита либо ставить кнопку над диалогом, то
+ * есть не там, где читают реплику.
+ *
+ * Дженерика у контекста нет: тип реплики у переписки один, и type-carrier, который у
+ * строки таблицы несёт тип строки, здесь не нужен.
+ *
+ * @example
+ * ```html
+ * <rt-chat [messages]="messages()" [messageHasActions]="canAct">
+ *     <ng-template rtChatMessageActions let-message>
+ *         <rt-menu-item icon="link" label="Скопировать ссылку" (selected)="copy(message)" />
+ *     </ng-template>
+ * </rt-chat>
+ * ```
+ */
+declare class RtChatMessageActionsDirective {
+    readonly template: TemplateRef<IRtChatMessageActionsContext>;
+    /** Type-guard: сужает контекст шаблона до реплики при проверке шаблонов. */
+    static ngTemplateContextGuard(_directive: RtChatMessageActionsDirective, context: unknown): context is IRtChatMessageActionsContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtChatMessageActionsDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtChatMessageActionsDirective, "ng-template[rtChatMessageActions]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Общий презентационный чат: тред сообщений + композер. Никакого data-access/api — история
+ * приходит готовым массивом `IRtChat.Message[]`, отправка/обновление/скачивание уходят наружу
+ * через outputs, а стор и blob-загрузка остаются в feature-компоненте каждого домена.
+ *
+ * Композер держит свой `FormGroup` — наружу торчит только `send`. Полноэкранный
+ * режим (expand) — overlay внутри самого компонента (`--expanded`), потребителю
+ * лишь опционально сообщается через `expandedChange`.
+ *
+ * Шапка (тулбар «Чат» + refresh/expand) рендерится только когда включена хотя бы
+ * одна из иконок (`showRefresh`/`showExpand`): в диалогах своя header-обёртка,
+ * туда тулбар не нужен.
+ */
+declare class RtChatComponent {
+    #private;
+    /**
+     * Дата сообщения форматируется по активной локали приложения, а не по
+     * `LOCALE_ID`: тот вычисляется на подъёме приложения и там, где язык
+     * переключают на ходу, оставил бы часы в прежнем формате до перезагрузки.
+     *
+     * Данные локали для `DatePipe` регистрирует приложение: без них пайп падает
+     * `Missing locale data`, и кит за это не отвечает.
+     */
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly locale: Signal<string>;
+    /**
+     * Скролл-контейнер треда — для автопрокрутки к последнему сообщению.
+     * `viewChild` не работает на ES-private (`#`) поле, поэтому `protected`.
+     */
+    protected readonly thread: Signal<ElementRef<HTMLElement> | undefined>;
+    /** Скрытый нативный input — открывается кнопкой-скрепкой внутри поля ввода. */
+    protected readonly composerFileEl: Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly attachmentFallbackName: Signal<string>;
+    /** Подписи с учётом того, что передал хозяин компонента: своё важнее умолчания */
+    protected readonly titleText: Signal<string>;
+    protected readonly placeholderText: Signal<string>;
+    protected readonly emptyHintText: Signal<string>;
+    protected readonly MessageStatus: typeof ERtChatMessageStatus;
+    /** Плейсхолдеры скелетонов треда при первичной загрузке. */
+    protected readonly skeletonRows: readonly number[];
+    /** Полноэкранный режим (overlay поверх страницы). */
+    protected readonly expanded: WritableSignal<boolean>;
+    protected readonly replyForm: FormGroup<{
+        message: FormControl<string>;
+        files: FormControl<File[]>;
+    }>;
+    /** Композер заблокирован при загрузке/рефреше треда или отправке in-flight. */
+    protected readonly composerDisabled: Signal<boolean>;
+    /**
+     * Можно ли отправить: композер активен и есть содержимое — непустой текст или
+     * (при включённых вложениях) хотя бы один файл. Сообщение само по себе не
+     * бывает «невалидным» — пустоту гасим дизейблом кнопки, а не подсветкой поля.
+     */
+    protected readonly canSend: Signal<boolean>;
+    /** Показывать ли шапку: только когда включена хотя бы одна иконка. */
+    protected readonly showHeader: Signal<boolean>;
+    /** Подпись кнопки fullscreen: тернарник в шаблоне переводом не покрыть. */
+    protected readonly expandLabel: Signal<string>;
+    /** Выбранные, но ещё не отправленные файлы — карточки над полем ввода. */
+    protected readonly selectedFiles: Signal<File[]>;
+    /**
+     * Drop-зона активна только когда вложения включены, ответ доступен и композер
+     * не занят (загрузка/рефреш/отправка). Иначе обёртка `rt-file-drop` просто
+     * пропускает контент без оверлея.
+     */
+    protected readonly dropDisabled: Signal<boolean>;
+    /**
+     * Файл из drag-n-drop для rich-композера: каждый drop кладёт новый `File`,
+     * пробрасывается в `rt-message-composer` через input. Классический композер
+     * принимает drop напрямую в свой `replyForm`.
+     */
+    protected readonly droppedFiles: WritableSignal<File[] | null>;
+    /**
+     * Шаблон действий у реплики: `<ng-template rtChatMessageActions let-message>`.
+     *
+     * Не объявлен — разметка реплики прежняя, и лишней кнопки у неё не появляется.
+     */
+    protected readonly messageActions: Signal<RtChatMessageActionsDirective | undefined>;
+    /** История сообщений (consumer уже смаппил из доменной модели). */
+    readonly messages: InputSignal<readonly IRtChat.Message[]>;
+    /** Первичная загрузка — скелетоны вместо треда. */
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Рефреш при наличии данных — тред остаётся, композер дизейблится. */
+    readonly fetching: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Доступна ли отправка (иначе вместо композера — note с причиной). */
+    readonly canReply: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Причина блокировки ответа — note под тредом. */
+    readonly replyBlockReason: InputSignal<string | null>;
+    /** Отправка in-flight — спиннер/дизейбл на кнопке. */
+    readonly sending: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Подписи по умолчанию приходят пустыми и переводятся ниже: значение
+     * `input()` вычисляется при создании компонента, и готовый перевод застыл бы
+     * на языке, активном в этот момент.
+     */
+    readonly placeholder: InputSignal<string>;
+    readonly title: InputSignal<string>;
+    /** Текст, когда треда ещё нет (заявка не создана). */
+    readonly emptyHint: InputSignal<string>;
+    /** Есть ли тред (иначе показываем `emptyHint`). */
+    readonly hasThread: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Включить загрузку файлов в композере. */
+    readonly attachments: InputSignalWithTransform<boolean, BooleanInput>;
+    /** `accept` для file-input (`.pdf,.doc,...`). */
+    readonly accept: InputSignal<string>;
+    /**
+     * Компактный композер (`rt-message-composer`): авто-растущая textarea над
+     * разделителем + ряд иконок (прикрепить слева, отправить справа) вместо
+     * классического вертикального стека. По умолчанию выключен.
+     */
+    readonly richComposer: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Rich-текст в композере (Quill delta). Требует `richComposer` — форматирование
+     * живёт только в компактном композере. Отправка уходит delta-каналом.
+     */
+    readonly formatting: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Набор кнопок rich-редактора (проброс до `rt-rich-editor` через композер). */
+    readonly formattingToolbar: InputSignal<TRtRichEditorToolbar>;
+    /**
+     * Растягивать чат на всю высоту контейнера: тред занимает свободное место,
+     * композер прижат к низу. По умолчанию выключен (тред с фикс. max-height).
+     * Требует, чтобы родитель давал высоту (flex-цепочка).
+     */
+    readonly fill: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Показать иконку refresh в шапке. */
+    readonly showRefresh: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Показать иконку expand (fullscreen) в шапке. */
+    readonly showExpand: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Отправка сообщения (+файлы) — consumer вызывает свой store/api. */
+    readonly send: OutputEmitterRef<IRtChat.SendPayload>;
+    /** Клик refresh — consumer перетягивает тред. */
+    readonly refresh: OutputEmitterRef<void>;
+    /** Клик по вложению — consumer качает blob своим api. Шаблон зовёт выход прямо: релей-метод,
+     * который только повторял `emit`, ничего не добавлял, а файл при этом рос. */
+    readonly downloadFile: OutputEmitterRef<IRtChat.Message>;
+    /** Клик по карточке вложения из `attachments[]` — консюмер качает по `publicId`. */
+    readonly downloadAttachment: OutputEmitterRef<IRtChat.Attachment>;
+    /** Смена fullscreen-состояния. */
+    readonly expandedChange: OutputEmitterRef<boolean>;
+    readonly deleteMessage: OutputEmitterRef<IRtChat.Message>;
+    /** Повторная отправка своего сообщения со статусом `failed`. */
+    readonly retryMessage: OutputEmitterRef<IRtChat.Message>;
+    /**
+     * Есть ли у реплики действия потребителя — гейт кнопки «…» у неё.
+     *
+     * Не задан — точка действий показывается у каждой реплики: экран, который ничего не
+     * гейтит, показывает её так же, как это делает строка таблицы.
+     */
+    readonly messageHasActions: InputSignal<IRtChat.MessageActionsPredicate | null>;
+    constructor();
+    protected onSubmit(): void;
+    protected onComposerKeydown(event: KeyboardEvent): void;
+    /** Релей submit'а от `rt-message-composer` (rich-режим) наружу как `send`. */
+    protected onComposerSubmit(payload: IRtMessageComposer.SubmitPayload): void;
+    /**
+     * Файлы выброшены в обёртку чата: в rich-режиме отдаём массив композеру через
+     * input, в классическом — добавляем к уже выбранным в собственном `replyForm`.
+     */
+    protected onFilesDropped(files: File[]): void;
+    protected openFilePicker(): void;
+    protected onFilesPicked(event: Event): void;
+    protected removeFile(index: number): void;
+    /** Признак «читатель у нижнего края» обновляется по прокрутке: на нём стоит автопрокрутка. */
+    protected onThreadScroll(): void;
+    protected toggleExpand(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtChatComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtChatComponent, "rt-chat", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "canReply": { "alias": "canReply"; "required": false; "isSignal": true; }; "replyBlockReason": { "alias": "replyBlockReason"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "emptyHint": { "alias": "emptyHint"; "required": false; "isSignal": true; }; "hasThread": { "alias": "hasThread"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "richComposer": { "alias": "richComposer"; "required": false; "isSignal": true; }; "formatting": { "alias": "formatting"; "required": false; "isSignal": true; }; "formattingToolbar": { "alias": "formattingToolbar"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; "showRefresh": { "alias": "showRefresh"; "required": false; "isSignal": true; }; "showExpand": { "alias": "showExpand"; "required": false; "isSignal": true; }; "messageHasActions": { "alias": "messageHasActions"; "required": false; "isSignal": true; }; }, { "send": "send"; "refresh": "refresh"; "downloadFile": "downloadFile"; "downloadAttachment": "downloadAttachment"; "expandedChange": "expandedChange"; "deleteMessage": "deleteMessage"; "retryMessage": "retryMessage"; }, ["messageActions"], ["[rtChatHeaderActions]", "[rtChatFooter]"], true, never>;
+}
+
+/**
+ * Есть ли у реплики хотя бы одно доступное действие потребителя.
+ *
+ * Признак приходит предикатом от экрана, а не подсчётом отрисованных пунктов меню:
+ * содержимое спроецированного шаблона известно только после отрисовки, и кнопка
+ * успевала бы мигнуть на первом кадре.
+ *
+ * Предикат не задан — у реплики есть действия: экран, который ничего не гейтит,
+ * показывает кнопку меню. Так же это устроено у строки таблицы, и расхождение между
+ * двумя точками проекции одного кита читалось бы дефектом.
+ */
+declare function messageHasAvailableActions(message: IRtChat.Message, hasActions: IRtChat.MessageActionsPredicate | null): boolean;
+
+/**
+ * Есть ли у реплики доступные действия — гейт кнопки «…» у неё.
+ *
+ * Pure-pipe: пересчитывается только при смене реплики или предиката, а не на каждом
+ * цикле проверки. Значение приходит из контекста шаблона (реплика треда), поэтому
+ * `computed()` здесь неприменим.
+ */
+declare class RtChatMessageHasActionsPipe implements PipeTransform {
+    transform(message: IRtChat.Message, hasActions: IRtChat.MessageActionsPredicate | null): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtChatMessageHasActionsPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<RtChatMessageHasActionsPipe, "rtChatMessageHasActions", true>;
+}
+
+/**
+ * Статус уже сохранённого своего сообщения: сервер знает только, дошло ли оно до
+ * собеседника. Часы и ошибка — состояния клиентской очереди, сюда не попадают.
+ */
+declare function deliveryStatus(read: boolean): ERtChatMessageStatus;
+/**
+ * Сообщение, ещё не подтверждённое сервером. Серверного id и ссылок на вложения
+ * у него нет: есть клиентский ключ, текст и выбранные файлы.
+ *
+ * Rich-тело приходит уже разобранным — доменная форма его хранения тут ни при
+ * чём, а хранят его стороны по-разному: одна шлёт обычный текст, другая —
+ * строку композера, которая в том же виде уходит на сервер.
+ */
+interface IRtPendingMessage {
+    tempId: string;
+    text: string;
+    delta?: IQuillDelta | null;
+    createdAt: string;
+    status: IRtChat.MessageStatus;
+    files: readonly File[];
+}
+/**
+ * Неподтверждённое сообщение → строка ленты. Показывается сразу после отправки:
+ * ждать ответа сервера, глядя в пустоту, незачем ни одной из сторон.
+ *
+ * Скрыть такое сообщение нельзя: на сервере его ещё нет, и удалять нечего.
+ */
+declare function pendingToRtMessage(pending: IRtPendingMessage, authorLabel: string): IRtChat.Message;
+/**
+ * Структурный контракт доменного сообщения, достаточный для маппинга в
+ * `IRtChat.Message`. Доменные модели удовлетворяют ему по форме;
+ * роль-специфика (автор/own/system) задаётся опциями.
+ */
+interface IRtMappableMessage {
+    id: string | number;
+    tempId?: string;
+    status?: IRtChat.MessageStatus;
+    message: string;
+    messageDelta: IQuillDelta | null;
+    createdAt: string;
+    fileUrl: string | null;
+    attachments: readonly {
+        id: number;
+        name: string;
+        publicId: string;
+    }[];
+}
+/**
+ * Опции маппинга: роль-специфичные куски, которые не вывести из общего контракта.
+ *
+ * - `roleLabel` — подпись автора (обычно ярлык роли).
+ * - `isOwn` — своё ли это сообщение (правый пузырь).
+ * - `isSystem` — системное ли (нейтральный стиль); по умолчанию нет.
+ * - `fileName` — имя файла вложения; по умолчанию выводится из `fileUrl`.
+ * - `optimistic` — включить `tempId`/`status` (оптимистичная отправка); по умолчанию да.
+ *   Для read-only тредов (агент) — `false`: тогда `id` берётся из серверного `id`.
+ */
+interface IToRtMessageOptions<TMessage extends IRtMappableMessage> {
+    roleLabel: (message: TMessage) => string;
+    isOwn: (message: TMessage) => boolean;
+    isSystem?: (message: TMessage) => boolean;
+    fileName?: (message: TMessage) => string | null;
+    optimistic?: boolean;
+}
+/**
+ * Собрать `IRtChat.Message` из доменного сообщения. Общие поля (текст, delta,
+ * дата, вложения, файл) берутся из контракта; автор/own/system/имя файла —
+ * из опций. Ключ `id` — `tempId ?? id` в оптимистичном режиме (пока сервер не
+ * подтвердил), иначе серверный `id`.
+ */
+declare function toRtMessage<TMessage extends IRtMappableMessage>(message: TMessage, options: IToRtMessageOptions<TMessage>): IRtChat.Message;
+
+/** Ключ текстовой расшифровки иконки статуса сообщения. */
+declare class RtChatStatusLabelPipe implements PipeTransform {
+    transform(status: ERtChatMessageStatus): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtChatStatusLabelPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<RtChatStatusLabelPipe, "rtChatStatusLabel", true>;
+}
+
+export { ERtChatMessageStatus, IRtChat, IRtMessageComposer, RtChatComponent, RtChatMessageActionsDirective, RtChatMessageHasActionsPipe, RtChatStatusLabelPipe, RtMessageComposerComponent, RtRichEditorComponent, deliveryStatus, messageHasAvailableActions, pendingToRtMessage, toRtMessage };
+export type { IRtChatMessageActionsContext, IRtMappableMessage, IRtPendingMessage, IToRtMessageOptions, TRtRichEditorToolbar };