@rt-tools/ui-kit-v2 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/ui-kit-v2",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",

package/src/rich-editor/lib/components/message-composer/CONTEXT.md

@@ -18,13 +18,15 @@
 | `attachments`          | `boolean`              | `false`                  |
 | `accept`               | `string`               | `''`                     |
 | `sending` / `disabled` | `boolean`              | `false`                  |
+| `stoppable`            | `boolean`              | `false`                  |
+| `text` (model)         | `string`               | `''`                     |
 | `formatting`           | `boolean`              | `false`                  |
 | `hint`                 | `boolean`              | `false`                  |
 | `toolbar`              | `TRtRichEditorToolbar` | `'full'`                 |
 | `minRows` / `maxRows`  | `number`               | 1 / 6                    |
 | `droppedFiles`         | `File[] \| null`       | `null`                   |
 
-Выход: `submitted` — `{ text, delta?, files }`.
+Выходы: `submitted` — `{ text, delta?, files }`; `stopped` — клик по «Стоп». Метод: `focus()`.
 
 ## Главное, что нужно знать
 
@@ -32,6 +34,18 @@
 вложенный файл разблокирует отправку и без текста. Во время `sending` поле и кнопка заблокированы —
 иначе второе сообщение ушло бы поверх ещё не доставленного.
 
+**`stoppable` меняет смысл `sending` только для того, кто его включил.** При обоих флагах стрелку
+сменяет «Стоп», форма не блокируется, а `submit` отказывает по `canSend`, не трогая черновик:
+следующий вопрос набирается, пока идёт ответ. `rt-chat` и прочие потребители без флага получают
+прежнюю блокировку.
+
+**`text` — модель черновика, а не CVA.** У композера своя форма с файлами; потребителю нужно задать,
+прочитать и очистить текст, а не встроить поле в чужую форму. Синхронизация двусторонняя: эффект
+пишет модель в контрол, `valueChanges` контрола — в модель; сброс после отправки обнуляет обе.
+
+**`focus()` в режиме форматирования идёт через `RtRichEditorComponent.focus`.** Узел Quill появляется
+после динамического импорта; до него вызов ничего не делает.
+
 **Enter отправляет, Shift+Enter переносит строку.** Набор во время IME-композиции игнорируется.
 
 **`droppedFiles` — вход, а не выход.** Файлы, брошенные в область

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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { AfterViewInit, OnDestroy, Signal, ElementRef, WritableSignal, InputSignal, OutputEmitterRef, InputSignalWithTransform, TemplateRef, PipeTransform } from '@angular/core';
+import { AfterViewInit, OnDestroy, Signal, ElementRef, WritableSignal, InputSignal, OutputEmitterRef, InputSignalWithTransform, ModelSignal, 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';
@@ -32,6 +32,8 @@ declare class RtRichEditorComponent extends RtFormControlBase<IQuillDelta | null
     readonly enterPressed: OutputEmitterRef<void>;
     readonly displayText: Signal<string>;
     ngAfterViewInit(): Promise<void>;
+    /** Ставит фокус в редактор; до загрузки Quill ничего не делает. */
+    focus(): void;
     ngOnDestroy(): void;
     writeValue(value: IQuillDelta | null): void;
     setDisabledState(isDisabled: boolean): void;
@@ -70,6 +72,9 @@ interface IComposerFormShape {
  *
  * Отправка — `Enter` (без Shift) или клик по иконке; `Shift+Enter` — перенос
  * строки. Кнопка отправки активна, пока есть непустой текст или вложения.
+ *
+ * Со `stoppable` во время `sending` вместо стрелки стоит кнопка «Стоп», а поле
+ * остаётся открытым: следующий вопрос набирается, пока идёт ответ.
  */
 declare class RtMessageComposerComponent {
     #private;
@@ -77,12 +82,15 @@ declare class RtMessageComposerComponent {
     protected readonly placeholderText: Signal<string>;
     protected readonly fileInput: Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly textInput: Signal<ElementRef<HTMLTextAreaElement> | undefined>;
+    protected readonly richEditor: Signal<RtRichEditorComponent | undefined>;
     protected readonly form: FormGroup<IComposerFormShape>;
     protected readonly files: Signal<readonly File[]>;
     /** Отправка доступна: есть контент (текст/delta/файлы), композер не занят. */
     protected readonly canSend: Signal<boolean>;
     /** Капсула выше одной строки: перенос текста, вложения или режим форматирования. */
     protected readonly tall: Signal<boolean>;
+    /** Идёт ответ, который можно остановить: вместо стрелки — «Стоп», поле открыто. */
+    protected readonly isStoppable: Signal<boolean>;
     protected readonly capsuleMods: Signal<Record<string, boolean>>;
     /** Текст-подсказка textarea. Пусто — берётся переведённое умолчание. */
     readonly placeholder: InputSignal<string>;
@@ -94,6 +102,11 @@ declare class RtMessageComposerComponent {
     readonly attachments: InputSignalWithTransform<boolean, BooleanInput>;
     /** Отправка в процессе — блокирует submit, кнопка отправки крутит индикатор. */
     readonly sending: InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Ответ на сообщение можно остановить. Во время `sending` стрелку сменяет кнопка
+     * «Стоп», а поле не блокируется; без входа `sending` блокирует поле, как раньше.
+     */
+    readonly stoppable: InputSignalWithTransform<boolean, BooleanInput>;
     /** Полная блокировка композера. */
     readonly disabled: InputSignalWithTransform<boolean, BooleanInput>;
     /** Rich-режим: вместо textarea — Quill-редактор, отправка уходит delta-каналом. */
@@ -112,14 +125,21 @@ declare class RtMessageComposerComponent {
     readonly droppedFiles: InputSignal<File[] | null>;
     /** Отправка сообщения: текст + файлы (последние — только при `attachments`). */
     readonly submitted: OutputEmitterRef<IRtMessageComposer.SubmitPayload>;
+    /** Черновик поля без форматирования: задаётся снаружи, правки уходят наружу, после отправки пуст. */
+    readonly text: ModelSignal<string>;
+    /** Клик по кнопке «Стоп» во время ответа, который можно остановить. */
+    readonly stopped: OutputEmitterRef<void>;
     constructor();
+    /** Ставит фокус в поле: в textarea, а в режиме форматирования — в rich-редактор. */
+    focus(): void;
     protected onKeydown(event: KeyboardEvent): void;
+    protected stop(): 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; }; "hint": { "alias": "hint"; "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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtMessageComposerComponent, "rt-message-composer", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "stoppable": { "alias": "stoppable"; "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; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; "text": "textChange"; "stopped": "stopped"; }, never, never, true, never>;
 }
 
 /**

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

@@ -460,6 +460,8 @@ declare const RT_KIT_LABELS_EN: {
     readonly chatStatusRead: "Read";
     readonly chatStatusSending: "Sending";
     readonly chatStatusSent: "Delivered";
+    readonly chatStopAria: "Stop the answer";
+    readonly chatStopLabel: "Stop";
     readonly chatTitle: "Chat";
     readonly counterDecrease: "Decrease";
     readonly counterIncrease: "Increase";