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

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

@@ -1,6 +1,6 @@
 import * as i0 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 { RtFormControlBase, IQuillDelta, TRtKitLabelMap, IRtAiRunStatus, IRtTimeline, IRtThreadList, IRtSideMenu } from '@rt-tools/ui-kit-v2';
 import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
 import { FormGroup, FormControl } from '@angular/forms';
 
@@ -540,6 +540,190 @@ interface IToRtMessageOptions<TMessage extends IRtMappableMessage> {
  */
 declare function toRtMessage<TMessage extends IRtMappableMessage>(message: TMessage, options: IToRtMessageOptions<TMessage>): IRtChat.Message;
 
+declare namespace IRtAiChat {
+    /** Кто написал сообщение. */
+    type Role = 'user' | 'assistant';
+    /** Оценка ответа человеком; `null` — не оценён. */
+    type Feedback = 'liked' | 'disliked' | null;
+    /** Ход работы над ответом: строка `rt-ai-run-status` над текстом ответа. */
+    interface Run {
+        readonly state: IRtAiRunStatus.State;
+        readonly label: string;
+        readonly meta?: string;
+        readonly steps?: readonly IRtTimeline.Step[];
+    }
+    interface Message {
+        readonly id: string;
+        readonly role: Role;
+        /** Текст сообщения; у ответа — markdown. Пустой ответ рисует только ход работы. */
+        readonly text: string;
+        /** Время под пузырём вопроса; пусто — не рисуется. */
+        readonly time?: string;
+        /** Ход работы над этим ответом. */
+        readonly run?: Run;
+        /** Ответ ещё пишется: оценка не рисуется. */
+        readonly streaming?: boolean;
+        readonly feedback?: Feedback;
+    }
+    /** Ответ оборвался: текст ошибки, номер обращения и можно ли спросить снова. */
+    interface RunError {
+        readonly message: string;
+        readonly referenceId?: string;
+        readonly retryable?: boolean;
+    }
+    /** Беседа в списке бесед. */
+    interface Thread {
+        readonly id: string;
+        readonly title: string;
+        /** Время последнего сообщения, готовой строкой. */
+        readonly time?: string;
+        /** Непрочитанных ответов; больше нуля — строка помечена и показывает число. */
+        readonly unreadCount?: number;
+    }
+    /** Оценка ответа: какое сообщение и какая оценка. */
+    interface FeedbackChange {
+        readonly messageId: string;
+        readonly feedback: Feedback;
+    }
+    /** Контекст шаблона вложений ответа. */
+    interface ExtraContext {
+        readonly $implicit: Message;
+    }
+}
+
+/**
+ * Вложения ответа ассистента: то, что рисует приложение под текстом ответа — график, таблица,
+ * карточка. Шаблон получает сообщение.
+ */
+declare class RtAiChatMessageExtraDirective {
+    readonly templateRef: TemplateRef<IRtAiChat.ExtraContext>;
+    static ngTemplateContextGuard(_directive: RtAiChatMessageExtraDirective, context: unknown): context is IRtAiChat.ExtraContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtAiChatMessageExtraDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtAiChatMessageExtraDirective, "ng-template[rtAiChatMessageExtra]", never, {}, {}, never, never, true, never>;
+}
+
+/** Строка беседы для списка бесед: `rt-thread-list` ждёт `id` и `hasUnread`. */
+interface IThreadRow extends IRtThreadList.Row {
+    readonly id: string;
+    readonly hasUnread: boolean;
+    readonly title: string;
+    readonly titleParts: readonly IRtSideMenu.TitlePart[];
+    readonly time: string;
+    readonly unreadCount: number;
+}
+/**
+ * Панель ИИ-ассистента одним компонентом: шапка с действиями, лента вопросов и ответов с ходом
+ * работы, пустой экран с подсказками, ошибка с номером обращения, поле сообщения и подпись под
+ * ним; по кнопке «Conversations» — список бесед.
+ *
+ * Компонент презентационный: сообщения, ход работы, беседы и ошибка приходят входами, действия
+ * уходят выходами. Вложения ответа — графики и прочее — приложение отдаёт шаблоном
+ * `rtAiChatMessageExtra`.
+ */
+declare class RtAiChatComponent {
+    #private;
+    protected readonly composer: Signal<RtMessageComposerComponent | undefined>;
+    protected readonly backButton: Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly feed: Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly extraTemplate: Signal<RtAiChatMessageExtraDirective | undefined>;
+    /** Ответы, у которых человек раскрыл шаги. */
+    protected readonly openRuns: WritableSignal<ReadonlySet<string>>;
+    protected readonly titleText: Signal<string>;
+    protected readonly emptyTitleText: Signal<string>;
+    protected readonly emptyDescriptionText: Signal<string>;
+    protected readonly disclaimerText: Signal<string>;
+    protected readonly hasThreads: Signal<boolean>;
+    /** Список бесед стоит колонкой слева: на весь экран, когда беседы есть. */
+    protected readonly isThreadColumn: Signal<boolean>;
+    /** Список бесед стоит на месте ленты: в узкой панели по кнопке «Conversations». */
+    protected readonly isThreadPage: Signal<boolean>;
+    protected readonly isEmpty: Signal<boolean>;
+    /** Строка поиска по беседам: подсвечивает совпадения и меняет подпись пустого списка. */
+    protected readonly threadQuery: WritableSignal<string>;
+    protected readonly threadRows: Signal<readonly IThreadRow[]>;
+    /** Пустой список: без поиска — «бесед нет», с поиском — подпись списка «ничего не найдено». */
+    protected readonly threadsEmptyText: Signal<string>;
+    /** Заголовок беседы над лентой; пусто — строки нет. */
+    readonly title: InputSignal<string>;
+    /** Вторая строка шапки — обычно название беседы. Пусто — не рисуется. */
+    readonly subtitle: InputSignal<string>;
+    readonly messages: InputSignal<readonly IRtAiChat.Message[]>;
+    /** Готовые вопросы пустого экрана. */
+    readonly suggestions: InputSignal<readonly string[]>;
+    readonly emptyTitle: InputSignal<string>;
+    readonly emptyDescription: InputSignal<string>;
+    /** Подсказка в поле сообщения; пусто — подпись поля кита. */
+    readonly placeholder: InputSignal<string>;
+    /** Подпись под полем сообщения; `null` — подпись кита, пустая строка — без подписи. */
+    readonly disclaimer: InputSignal<string | null>;
+    /** Ответ пишется: поле сообщения в режиме остановки, подсказки и новая беседа выключены. */
+    readonly sending: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Беседа загружается: крутилка, пока сообщений нет. */
+    readonly loading: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly error: InputSignal<IRtAiChat.RunError | null>;
+    /** Беседы; `null` — кнопки «Conversations» нет. */
+    readonly threads: InputSignal<readonly IRtAiChat.Thread[] | null>;
+    readonly activeThreadId: InputSignal<string | null>;
+    readonly threadsLoading: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly threadsFetching: InputSignalWithTransform<boolean, BooleanInput>;
+    readonly threadsHasMore: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Кнопка «Full screen» в шапке. */
+    readonly fullScreenable: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Кнопка закрытия в шапке. */
+    readonly closable: InputSignalWithTransform<boolean, BooleanInput>;
+    /** Черновик в поле сообщения. */
+    readonly draft: ModelSignal<string>;
+    /** Список бесед открыт на месте ленты. */
+    readonly threadsOpen: ModelSignal<boolean>;
+    readonly fullScreen: ModelSignal<boolean>;
+    /** Вопрос ушёл: набранный или выбранная подсказка. */
+    readonly send: OutputEmitterRef<string>;
+    readonly stop: OutputEmitterRef<void>;
+    readonly retry: OutputEmitterRef<void>;
+    readonly newThread: OutputEmitterRef<void>;
+    readonly closed: OutputEmitterRef<void>;
+    readonly selectThread: OutputEmitterRef<string>;
+    readonly deleteThread: OutputEmitterRef<string>;
+    readonly searchThreads: OutputEmitterRef<string>;
+    readonly loadMoreThreads: OutputEmitterRef<void>;
+    readonly feedbackChange: OutputEmitterRef<IRtAiChat.FeedbackChange>;
+    constructor();
+    /** Фокус в поле сообщения после отрисовки: приложению — после своих действий вне панели. */
+    focusComposer(): void;
+    protected onFeedScroll(): void;
+    protected onSubmitted(value: IRtMessageComposer.SubmitPayload): void;
+    protected onSuggestion(text: string): void;
+    protected onToggleRun(messageId: string, open: boolean): void;
+    protected onFeedback(message: IRtAiChat.Message, feedback: Exclude<IRtAiChat.Feedback, null>): void;
+    protected onToggleThreads(): void;
+    protected onNewThread(): void;
+    protected onStop(): void;
+    protected onToggleFullScreen(): void;
+    protected onSearchThreads(query: string): void;
+    protected onSelectThread(id: IRtThreadList.TRowId): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtAiChatComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtAiChatComponent, "rt-ai-chat", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "emptyTitle": { "alias": "emptyTitle"; "required": false; "isSignal": true; }; "emptyDescription": { "alias": "emptyDescription"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disclaimer": { "alias": "disclaimer"; "required": false; "isSignal": true; }; "sending": { "alias": "sending"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "threads": { "alias": "threads"; "required": false; "isSignal": true; }; "activeThreadId": { "alias": "activeThreadId"; "required": false; "isSignal": true; }; "threadsLoading": { "alias": "threadsLoading"; "required": false; "isSignal": true; }; "threadsFetching": { "alias": "threadsFetching"; "required": false; "isSignal": true; }; "threadsHasMore": { "alias": "threadsHasMore"; "required": false; "isSignal": true; }; "fullScreenable": { "alias": "fullScreenable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "draft": { "alias": "draft"; "required": false; "isSignal": true; }; "threadsOpen": { "alias": "threadsOpen"; "required": false; "isSignal": true; }; "fullScreen": { "alias": "fullScreen"; "required": false; "isSignal": true; }; }, { "draft": "draftChange"; "threadsOpen": "threadsOpenChange"; "fullScreen": "fullScreenChange"; "send": "send"; "stop": "stop"; "retry": "retry"; "newThread": "newThread"; "closed": "closed"; "selectThread": "selectThread"; "deleteThread": "deleteThread"; "searchThreads": "searchThreads"; "loadMoreThreads": "loadMoreThreads"; "feedbackChange": "feedbackChange"; }, ["extraTemplate"], never, true, never>;
+}
+
+/**
+ * Ответ ассистента в ленте `rt-ai-chat`: ход работы, текст в markdown, вложения приложения и оценка.
+ * Оценка появляется, когда текст дописан.
+ */
+declare class RtAiChatAnswerComponent {
+    protected readonly t: Signal<TRtKitLabelMap>;
+    protected readonly isRated: Signal<boolean>;
+    readonly message: InputSignal<IRtAiChat.Message>;
+    /** Шаблон вложений ответа; `null` — вложений нет. */
+    readonly extra: InputSignal<TemplateRef<IRtAiChat.ExtraContext> | null>;
+    /** Шаги хода работы раскрыты. */
+    readonly expanded: ModelSignal<boolean>;
+    /** Нажата оценка; повторное нажатие той же снимает её — решает родитель. */
+    readonly feedbackChange: OutputEmitterRef<Exclude<IRtAiChat.Feedback, null>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtAiChatAnswerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtAiChatAnswerComponent, "rt-ai-chat-answer", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "extra": { "alias": "extra"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; "feedbackChange": "feedbackChange"; }, never, never, true, never>;
+}
+
 /** Ключ текстовой расшифровки иконки статуса сообщения. */
 declare class RtChatStatusLabelPipe implements PipeTransform {
     transform(status: ERtChatMessageStatus): string;
@@ -547,5 +731,5 @@ declare class RtChatStatusLabelPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<RtChatStatusLabelPipe, "rtChatStatusLabel", true>;
 }
 
-export { ERtChatMessageStatus, IRtChat, IRtMessageComposer, RtChatComponent, RtChatMessageActionsDirective, RtChatMessageHasActionsPipe, RtChatStatusLabelPipe, RtMessageComposerComponent, RtRichEditorComponent, deliveryStatus, messageHasAvailableActions, pendingToRtMessage, toRtMessage };
+export { ERtChatMessageStatus, IRtAiChat, IRtChat, IRtMessageComposer, RtAiChatAnswerComponent, RtAiChatComponent, RtAiChatMessageExtraDirective, RtChatComponent, RtChatMessageActionsDirective, RtChatMessageHasActionsPipe, RtChatStatusLabelPipe, RtMessageComposerComponent, RtRichEditorComponent, deliveryStatus, messageHasAvailableActions, pendingToRtMessage, toRtMessage };
 export type { IRtChatMessageActionsContext, IRtMappableMessage, IRtPendingMessage, IToRtMessageOptions, TRtRichEditorToolbar };

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

@@ -148,6 +148,12 @@ declare class RtSelectComponent<TValue> extends RtFormControlBase<TValue | null>
     protected getEmptyValue(): TValue | null;
     protected focusAfterClear(): void;
     protected clear(event?: Event): void;
+    /**
+     * Открытый список встаёт подсветкой на выбранный пункт.
+     *
+     * Иначе стрелка вниз начинала с первого пункта, и человек с выбранным «20» из «10, 20, 40»
+     * получал «10» вместо «40».
+     */
     protected onOpened(): void;
     protected toggleBranch(event: Event, value: TValue): void;
     protected onClosed(): void;

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

@@ -41,6 +41,18 @@ declare class RtThreadListRowDirective<TRow extends IRtThreadList.Row> {
     static ɵfac: i0.ɵɵFactoryDeclaration<RtThreadListRowDirective<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RtThreadListRowDirective<any>, "ng-template[rtThreadListRow]", never, { "rows": { "alias": "rtThreadListRow"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/**
+ * Помечает `<ng-template>` действий строки (удалить, закрепить). Действия рисуются рядом с
+ * кнопкой строки, а не внутри неё: вложенная кнопка в `<button>` недопустима и крадёт клик
+ * выбора строки. Видны при наведении и фокусе внутри строки.
+ */
+declare class RtThreadListRowActionsDirective<TRow extends IRtThreadList.Row> {
+    readonly templateRef: TemplateRef<IRtThreadList.RowContext<TRow>>;
+    readonly rows: InputSignal<readonly TRow[]>;
+    static ngTemplateContextGuard<TRow extends IRtThreadList.Row>(_directive: RtThreadListRowActionsDirective<TRow>, context: unknown): context is IRtThreadList.RowContext<TRow>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RtThreadListRowActionsDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RtThreadListRowActionsDirective<any>, "ng-template[rtThreadListRowActions]", never, { "rows": { "alias": "rtThreadListRowActions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
 /**
  * Помечает `<ng-template>` с фильтрами — его содержимое рендерится в поповере,
  * который открывает иконка-фильтр в шапке списка.
@@ -86,6 +98,7 @@ declare class RtThreadListComponent<TRow extends IRtThreadList.Row> implements O
     }[];
     protected readonly searchControl: FormControl<string>;
     protected readonly rowTemplate: Signal<RtThreadListRowDirective<TRow> | undefined>;
+    protected readonly rowActionsTemplate: Signal<RtThreadListRowActionsDirective<TRow> | undefined>;
     protected readonly filtersTemplate: Signal<RtThreadListFiltersDirective | undefined>;
     protected readonly searchTemplate: Signal<RtThreadListSearchDirective | undefined>;
     readonly rows: InputSignal<readonly TRow[]>;
@@ -105,7 +118,7 @@ declare class RtThreadListComponent<TRow extends IRtThreadList.Row> implements O
     protected onSelect(id: IRtThreadList.TRowId, event: MouseEvent): void;
     protected onLoadMore(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RtThreadListComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RtThreadListComponent<any>, "rt-thread-list", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "activeId": { "alias": "activeId"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "hasMore": { "alias": "hasMore"; "required": false; "isSignal": true; }; "filtersActive": { "alias": "filtersActive"; "required": false; "isSignal": true; }; }, { "selectRow": "selectRow"; "openInNewTab": "openInNewTab"; "searchChange": "searchChange"; "loadMore": "loadMore"; }, ["rowTemplate", "filtersTemplate", "searchTemplate"], never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RtThreadListComponent<any>, "rt-thread-list", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "activeId": { "alias": "activeId"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fetching": { "alias": "fetching"; "required": false; "isSignal": true; }; "hasMore": { "alias": "hasMore"; "required": false; "isSignal": true; }; "filtersActive": { "alias": "filtersActive"; "required": false; "isSignal": true; }; }, { "selectRow": "selectRow"; "openInNewTab": "openInNewTab"; "searchChange": "searchChange"; "loadMore": "loadMore"; }, ["rowTemplate", "rowActionsTemplate", "filtersTemplate", "searchTemplate"], never, true, [{ directive: typeof i1.RtRadiusDirective; inputs: { "radius": "radius"; }; outputs: {}; }]>;
 }
 
-export { IRtThreadList, RtThreadListComponent, RtThreadListFiltersDirective, RtThreadListRowDirective, RtThreadListSearchDirective };
+export { IRtThreadList, RtThreadListComponent, RtThreadListFiltersDirective, RtThreadListRowActionsDirective, RtThreadListRowDirective, RtThreadListSearchDirective };

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

@@ -1,5 +1,6 @@
 export * from '@rt-tools/ui-kit-v2/core';
 export * from '@rt-tools/ui-kit-v2/accordion';
+export * from '@rt-tools/ui-kit-v2/ai-run-status';
 export * from '@rt-tools/ui-kit-v2/action-bar';
 export * from '@rt-tools/ui-kit-v2/aside-section';
 export * from '@rt-tools/ui-kit-v2/aside';
@@ -13,6 +14,7 @@ export * from '@rt-tools/ui-kit-v2/checkbox';
 export * from '@rt-tools/ui-kit-v2/collapsible-text';
 export * from '@rt-tools/ui-kit-v2/confirm-popover';
 export * from '@rt-tools/ui-kit-v2/container';
+export * from '@rt-tools/ui-kit-v2/copy-value';
 export * from '@rt-tools/ui-kit-v2/counter-row';
 export * from '@rt-tools/ui-kit-v2/counter';
 export * from '@rt-tools/ui-kit-v2/data-list';
@@ -57,6 +59,7 @@ export * from '@rt-tools/ui-kit-v2/page-header';
 export * from '@rt-tools/ui-kit-v2/pagination';
 export * from '@rt-tools/ui-kit-v2/photo-viewer';
 export * from '@rt-tools/ui-kit-v2/popover';
+export * from '@rt-tools/ui-kit-v2/prompt-suggestion';
 export * from '@rt-tools/ui-kit-v2/radio-button';
 export * from '@rt-tools/ui-kit-v2/radius';
 export * from '@rt-tools/ui-kit-v2/ripple';