@progress/kendo-angular-conversational-ui 24.0.0-develop.10 → 24.0.0-develop.12

package/chat/api/chat-load-more-event.d.ts

@@ -0,0 +1,18 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Arguments for the `loadMore` event of the Chat.
+ * Fires when the user scrolls near the edge of the rendered message window in endless scroll mode.
+ */
+export interface ChatLoadMoreEvent {
+    /**
+     * The inclusive start index into the full messages array.
+     */
+    startIndex: number;
+    /**
+     * The exclusive end index into the full messages array.
+     */
+    endIndex: number;
+}

package/chat/api/chat-referenced-message-click-event.d.ts

@@ -0,0 +1,18 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Arguments for the `referencedMessageClick` event of the Chat.
+ * Fires when the user clicks a pinned message indicator or a reply preview.
+ */
+export interface ChatReferencedMessageClickEvent {
+    /**
+     * The ID of the referenced message that was clicked.
+     */
+    id: string | number;
+    /**
+     * Specifies whether the click originated from a pinned message indicator or a reply preview.
+     */
+    type: 'pinned' | 'reply';
+}

package/chat/api/index.d.ts

@@ -5,13 +5,17 @@
 export * from './action.interface';
 export * from './attachment.interface';
 export * from './chat-file-interface';
+export * from './chat-load-more-event';
+export * from './chat-referenced-message-click-event';
 export * from './chat-suggestion.interface';
 export * from './execute-action-event';
 export * from './message-action';
 export * from './message-width-mode';
 export * from './message.interface';
 export * from './message-settings.interface';
+export * from './message-status.interface';
 export * from './post-message-event';
+export * from './scroll-mode';
 export * from './user.interface';
 export * from './file-action';
 export * from './file-download-event.interface';

package/chat/api/scroll-mode.d.ts

@@ -0,0 +1,12 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Defines the scroll behavior of the Chat message list.
+ *
+ * - `scrollable`—All messages are rendered with standard scroll behavior.
+ * - `endless`—The Chat starts by rendering the last `pageSize` messages
+ *   and prepends older ones as the user scrolls up.
+ */
+export type ScrollMode = 'scrollable' | 'endless';

package/chat/chat.component.d.ts

@@ -7,19 +7,24 @@ import { SpeechToTextButtonSettings } from '@progress/kendo-angular-buttons';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { ContextMenuComponent, ContextMenuPopupEvent } from '@progress/kendo-angular-menu';
 import { SelectEvent } from '@progress/kendo-angular-upload';
+import { LicenseMessage } from '@progress/kendo-licensing';
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import { FileSelectButtonSettings } from '../promptbox/common/models';
 import { ExecuteActionEvent, FileAction, FileActionEvent, FileDownloadEvent, FilesLayoutMode, Message, MessageSettings, ResendMessageEvent, SendButtonSettings, SendMessageEvent } from './api';
 import { ChatFile } from './api/chat-file-interface';
+import { ChatLoadMoreEvent } from './api/chat-load-more-event';
+import { ChatReferencedMessageClickEvent } from './api/chat-referenced-message-click-event';
 import { ChatSuggestion } from './api/chat-suggestion.interface';
 import { MessageAction, MessageActionEvent } from './api/message-action';
 import { MessageBoxSettings, MessageBoxType } from './api/message-box';
 import { MessageWidthMode } from './api/message-width-mode';
+import { ScrollMode } from './api/scroll-mode';
 import { QuickActionsLayoutMode, SuggestionsLayoutMode } from './api/suggestions-layout';
 import { TimestampVisibilityMode } from './api/timestamp-visibility';
 import { AuthorMessageContentTemplateDirective, AuthorMessageTemplateDirective, MessageContentTemplateDirective, MessageTemplateDirective, NoDataTemplateDirective, ReceiverMessageContentTemplateDirective, ReceiverMessageTemplateDirective } from './chat.directives';
 import { ChatService } from './common/chat.service';
 import { ConversationalUIModelFields } from './common/models/model-fields';
+import { EndlessScrollState } from './common/endless-scroll-state';
 import { MessageBoxComponent } from './message-box.component';
 import { AttachmentTemplateDirective } from './templates/attachment-template.directive';
 import { ChatHeaderTemplateDirective } from './templates/header-template.directive';
@@ -225,6 +230,86 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     set sendButtonSettings(value: boolean | SendButtonSettings);
     get sendButtonSettings(): boolean | SendButtonSettings;
+    /**
+     * Controls the scrolling behavior of the message list.
+     *
+     * @default 'scrollable'
+     */
+    scrollMode: ScrollMode;
+    /**
+     * Sets the number of messages loaded per page in endless scroll mode.
+     * Ignored in `scrollable` mode.
+     *
+     * @default 50
+     */
+    pageSize: number;
+    /**
+     * Sets the minimum distance between a new receiver message and the top of the visible
+     * message area when auto-scrolling. Keeps older messages partially visible instead of
+     * scrolling them out of view.
+     *
+     * Accepts a percentage string relative to the visible area height (for example, `'30%'`)
+     * or a pixel value as a number. Negative values scroll the message fully to the bottom.
+     *
+     * Has no effect on author messages, which always scroll to the bottom.
+     *
+     * @default '20%'
+     */
+    autoScrollThreshold: number | string;
+    /**
+     * Sets the total number of messages in the conversation.
+     *
+     * When `messages.length` equals `total` (or `total` is not set), the Chat operates in
+     * **built-in mode** and manages rendering internally. When `messages.length < total`,
+     * the Chat operates in **remote mode** — the consumer manages data via
+     * [`loadMore`](slug:api_conversational-ui_chatcomponent#loadMore) events.
+     *
+     * Only relevant when [`scrollMode`](slug:api_conversational-ui_chatcomponent#scrollMode)
+     * is `'endless'`.
+     */
+    total: number;
+    /**
+     * Sets the index in the full conversation that `messages[0]` corresponds to.
+     *
+     * Only relevant in remote mode (`messages.length < total`). As the user scrolls up
+     * and the consumer prepends messages, `startIndex` decreases. The Chat uses this to
+     * compute the correct range for the next
+     * [`loadMore`](slug:api_conversational-ui_chatcomponent#loadMore) call.
+     *
+     * Ignored in built-in mode.
+     */
+    startIndex: number;
+    /**
+     * Sets the exclusive end index of the current batch in the full conversation.
+     *
+     * Only relevant in remote mode (`messages.length < total`). As the user scrolls down
+     * and the consumer appends messages, `endIndex` increases. The Chat uses this to know
+     * whether more messages exist below the current batch.
+     *
+     * Ignored in built-in mode.
+     */
+    endIndex: number;
+    /**
+     * Sets the full set of pinned messages in the conversation.
+     *
+     * Only needed in remote mode (`messages.length < total`). The Chat uses this to
+     * render the pinned message indicator when the pinned message is outside the current
+     * batch. In built-in mode, the Chat has all messages and can look them up directly.
+     *
+     * @default []
+     */
+    pinnedMessages: Message[];
+    /**
+     * Sets the reply targets that live outside the current batch.
+     *
+     * Only needed in remote mode (`messages.length < total`). The Chat uses this to
+     * render reply previews when the replied-to message is not in the current batch.
+     * The consumer resolves this after each data fetch by finding which `replyToId`
+     * targets are missing from the batch and fetching only those.
+     *
+     * @default []
+     */
+    repliedToMessages: Message[];
     /**
      * Sets the names of the model fields from which the Chat reads its data.
      * Lets you map custom data types to the expected `Message` format.
@@ -298,6 +383,14 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      * Fires when the user types in the message input box.
      */
     inputValueChange: EventEmitter<string>;
+    /**
+     * Fires when the user scrolls near the edge of the rendered message window in endless scroll mode.
+     */
+    loadMore: EventEmitter<ChatLoadMoreEvent>;
+    /**
+     * Fires when the user clicks a referenced message (pinned indicator or reply preview).
+     */
+    referencedMessageClick: EventEmitter<ChatReferencedMessageClickEvent>;
     get className(): string;
     get dirAttr(): string;
     set messagesContextMenu(contextMenu: ContextMenuComponent);
@@ -328,6 +421,18 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      * Returns processed messages when model fields are used, otherwise returns original messages.
      */
     get processedMessages(): Message[];
+    /**
+     * @hidden
+     * Returns `true` when the Chat is in remote endless scroll mode.
+     * Remote mode is active whenever the consumer provides a `total`.
+     */
+    get isRemoteMode(): boolean;
+    /**
+     * @hidden
+     * Returns the messages to render — sliced in endless mode, full in scrollable mode.
+     * In remote mode, returns processedMessages as-is (consumer already provides only the current batch).
+     */
+    get renderedMessages(): Message[];
     /**
      * @hidden
      */
@@ -362,6 +467,19 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      * @hidden
      */
     scrollToBottomIcon: SVGIcon;
+    /**
+     * @hidden
+     */
+    endlessState: EndlessScrollState;
+    /**
+     * @hidden
+     */
+    showLicenseWatermark: boolean;
+    /**
+     * @hidden
+     */
+    licenseMessage?: LicenseMessage;
+    private anchor;
     private direction;
     private subs;
     private _modelFields;
@@ -372,6 +490,16 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
     private _lastModelFields;
     private _cachedContextMenuActions;
     private _lastContextMenuActionsReference;
+    private _previousMessagesLength;
+    private _pendingScrollAction;
+    private _scrollHandledBeforePaint;
+    private _lastNewMessageId;
+    private _cachedRenderedMessages;
+    private _renderedMessagesSource;
+    private _renderedMessagesStart;
+    private _renderedMessagesEnd;
+    private _pendingRemoteScrollToMessageId;
+    private _remoteScrollToBottom;
     constructor(localization: LocalizationService, zone: NgZone, renderer: Renderer2, element: ElementRef, chatService: ChatService);
     /**
      * @hidden
@@ -400,7 +528,23 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
     /**
      * @hidden
      */
-    scrollToPinnedMessage(): void;
+    scrollToPinnedMessage(event?: MouseEvent): void;
+    /**
+     * @hidden
+     */
+    onNearTop(): void;
+    /**
+     * @hidden
+     */
+    onNearBottom(): void;
+    /**
+     * @hidden
+     */
+    onScrollToBottomClick(): void;
+    /**
+     * @hidden
+     */
+    handleReferencedMessageClick(messageId: string | number, type: 'pinned' | 'reply'): void;
     /**
      * @hidden
      */
@@ -413,9 +557,27 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      * @hidden
      */
     onActionButtonClick(event: MouseEvent): void;
+    /**
+     * @hidden
+     */
+    onMessageListResize(): void;
+    /**
+     * Schedules the new-message scroll adjustment on zone.onStable so it runs
+     * after Angular renders the new DOM but before the browser paints,
+     * preventing a visible intermediate frame.
+     */
+    private scheduleNewMessageScroll;
+    private detectNewMessageScrollAction;
+    private getLastNewMessageElement;
     private findLastPinnedMessage;
+    private initEndlessScroll;
+    private handleMessagesChange;
+    private handleRemoteMessagesChange;
+    private handleRemoteReferencedMessageClick;
+    private handlePendingRemoteScroll;
     private updateChatServiceProperties;
+    private validateRemoteInputs;
     private mergeWithDefaultActions;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChatComponent, "kendo-chat", never, { "messages": { "alias": "messages"; "required": false; }; "authorId": { "alias": "authorId"; "required": false; }; "messageBoxType": { "alias": "messageBoxType"; "required": false; }; "height": { "alias": "height"; "required": false; }; "width": { "alias": "width"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "messageWidthMode": { "alias": "messageWidthMode"; "required": false; }; "timestampVisibility": { "alias": "timestampVisibility"; "required": false; }; "showUsername": { "alias": "showUsername"; "required": false; }; "showAvatar": { "alias": "showAvatar"; "required": false; }; "allowMessageCollapse": { "alias": "allowMessageCollapse"; "required": false; }; "speechToTextButton": { "alias": "speechToTextButton"; "required": false; }; "fileSelectButton": { "alias": "fileSelectButton"; "required": false; }; "messageBoxSettings": { "alias": "messageBoxSettings"; "required": false; }; "messageToolbarActions": { "alias": "messageToolbarActions"; "required": false; }; "inputValue": { "alias": "inputValue"; "required": false; }; "authorMessageSettings": { "alias": "authorMessageSettings"; "required": false; }; "receiverMessageSettings": { "alias": "receiverMessageSettings"; "required": false; }; "messageContextMenuActions": { "alias": "messageContextMenuActions"; "required": false; }; "fileActions": { "alias": "fileActions"; "required": false; }; "messageFilesLayout": { "alias": "messageFilesLayout"; "required": false; }; "suggestionsLayout": { "alias": "suggestionsLayout"; "required": false; }; "quickActionsLayout": { "alias": "quickActionsLayout"; "required": false; }; "suggestions": { "alias": "suggestions"; "required": false; }; "sendButton": { "alias": "sendButton"; "required": false; }; "sendButtonSettings": { "alias": "sendButtonSettings"; "required": false; }; "modelFields": { "alias": "modelFields"; "required": false; }; "scrollToBottomButton": { "alias": "scrollToBottomButton"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; }, { "sendMessage": "sendMessage"; "resendMessage": "resendMessage"; "toolbarActionClick": "toolbarActionClick"; "contextMenuActionClick": "contextMenuActionClick"; "fileActionClick": "fileActionClick"; "download": "download"; "executeAction": "executeAction"; "suggestionExecute": "suggestionExecute"; "fileSelect": "fileSelect"; "fileRemove": "fileRemove"; "unpin": "unpin"; "inputValueChange": "inputValueChange"; }, ["attachmentTemplate", "chatHeaderTemplate", "chatNoDataTemplate", "authorMessageContentTemplate", "receiverMessageContentTemplate", "messageContentTemplate", "authorMessageTemplate", "receiverMessageTemplate", "messageTemplate", "timestampTemplate", "suggestionTemplate", "statusTemplate", "messageBoxTemplate", "messageBoxStartAffixTemplate", "messageBoxEndAffixTemplate", "messageBoxTopAffixTemplate", "userStatusTemplate"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatComponent, "kendo-chat", never, { "messages": { "alias": "messages"; "required": false; }; "authorId": { "alias": "authorId"; "required": false; }; "messageBoxType": { "alias": "messageBoxType"; "required": false; }; "height": { "alias": "height"; "required": false; }; "width": { "alias": "width"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "messageWidthMode": { "alias": "messageWidthMode"; "required": false; }; "timestampVisibility": { "alias": "timestampVisibility"; "required": false; }; "showUsername": { "alias": "showUsername"; "required": false; }; "showAvatar": { "alias": "showAvatar"; "required": false; }; "allowMessageCollapse": { "alias": "allowMessageCollapse"; "required": false; }; "speechToTextButton": { "alias": "speechToTextButton"; "required": false; }; "fileSelectButton": { "alias": "fileSelectButton"; "required": false; }; "messageBoxSettings": { "alias": "messageBoxSettings"; "required": false; }; "messageToolbarActions": { "alias": "messageToolbarActions"; "required": false; }; "inputValue": { "alias": "inputValue"; "required": false; }; "authorMessageSettings": { "alias": "authorMessageSettings"; "required": false; }; "receiverMessageSettings": { "alias": "receiverMessageSettings"; "required": false; }; "messageContextMenuActions": { "alias": "messageContextMenuActions"; "required": false; }; "fileActions": { "alias": "fileActions"; "required": false; }; "messageFilesLayout": { "alias": "messageFilesLayout"; "required": false; }; "suggestionsLayout": { "alias": "suggestionsLayout"; "required": false; }; "quickActionsLayout": { "alias": "quickActionsLayout"; "required": false; }; "suggestions": { "alias": "suggestions"; "required": false; }; "sendButton": { "alias": "sendButton"; "required": false; }; "sendButtonSettings": { "alias": "sendButtonSettings"; "required": false; }; "scrollMode": { "alias": "scrollMode"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "autoScrollThreshold": { "alias": "autoScrollThreshold"; "required": false; }; "total": { "alias": "total"; "required": false; }; "startIndex": { "alias": "startIndex"; "required": false; }; "endIndex": { "alias": "endIndex"; "required": false; }; "pinnedMessages": { "alias": "pinnedMessages"; "required": false; }; "repliedToMessages": { "alias": "repliedToMessages"; "required": false; }; "modelFields": { "alias": "modelFields"; "required": false; }; "scrollToBottomButton": { "alias": "scrollToBottomButton"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; }, { "sendMessage": "sendMessage"; "resendMessage": "resendMessage"; "toolbarActionClick": "toolbarActionClick"; "contextMenuActionClick": "contextMenuActionClick"; "fileActionClick": "fileActionClick"; "download": "download"; "executeAction": "executeAction"; "suggestionExecute": "suggestionExecute"; "fileSelect": "fileSelect"; "fileRemove": "fileRemove"; "unpin": "unpin"; "inputValueChange": "inputValueChange"; "loadMore": "loadMore"; "referencedMessageClick": "referencedMessageClick"; }, ["attachmentTemplate", "chatHeaderTemplate", "chatNoDataTemplate", "authorMessageContentTemplate", "receiverMessageContentTemplate", "messageContentTemplate", "authorMessageTemplate", "receiverMessageTemplate", "messageTemplate", "timestampTemplate", "suggestionTemplate", "statusTemplate", "messageBoxTemplate", "messageBoxStartAffixTemplate", "messageBoxEndAffixTemplate", "messageBoxTopAffixTemplate", "userStatusTemplate"], never, true, never>;
 }

package/chat/common/chat.service.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { ViewContainerRef, ElementRef } from '@angular/core';
+import { ViewContainerRef, ElementRef, NgZone } from '@angular/core';
 import { SpeechToTextButtonSettings } from '@progress/kendo-angular-buttons';
 import { MessageWidthMode } from '../api/message-width-mode';
 import { FileAction, FileActionEvent, FileDownloadEvent, FilesLayoutMode, Message, MessageAction, MessageActionEvent, MessageSettings, QuickActionsLayoutMode, ResendMessageEvent, SendButtonSettings, SuggestionsLayoutMode } from '../api';
@@ -15,15 +15,17 @@ import * as i0 from "@angular/core";
  * @hidden
  */
 export declare class ChatService {
+    private zone;
     authorId: string | number;
     messageWidthMode: MessageWidthMode;
-    messageToolbarActions: MessageAction[];
     messageContextMenuActions: MessageAction[];
     calculatedContextMenuActions: MessageAction[];
     fileActions: FileAction[];
     toggleMessageState: boolean;
+    layoutChangeInProgress: boolean;
     reply: Message;
     messages: Message[];
+    repliedToMessages: Message[];
     chatElement: ViewContainerRef;
     messageElementsMap: Map<string | number, ElementRef>;
     messagesContextMenu: ContextMenuComponent;
@@ -41,6 +43,7 @@ export declare class ChatService {
     private _messageBoxSettings;
     private _suggestionsLayout;
     private _quickActionsLayout;
+    private _messageToolbarActions;
     _authorMessageSettings: MessageSettings;
     _receiverMessageSettings: MessageSettings;
     private _allowMessageCollapse;
@@ -58,6 +61,8 @@ export declare class ChatService {
     authorMessageSettingsChange$: import("rxjs").Observable<MessageSettings>;
     receiverMessageSettingsChange$: import("rxjs").Observable<MessageSettings>;
     allowMessageCollapseChange$: import("rxjs").Observable<boolean>;
+    messageToolbarActionsChange$: import("rxjs").Observable<MessageAction[]>;
+    constructor(zone: NgZone);
     set authorMessageSettings(settings: MessageSettings);
     get authorMessageSettings(): MessageSettings;
     set receiverMessageSettings(settings: MessageSettings);
@@ -74,6 +79,8 @@ export declare class ChatService {
     get suggestionsLayout(): SuggestionsLayoutMode;
     set quickActionsLayout(layoutMode: QuickActionsLayoutMode);
     get quickActionsLayout(): QuickActionsLayoutMode;
+    set messageToolbarActions(value: MessageAction[]);
+    get messageToolbarActions(): MessageAction[];
     set allowMessageCollapse(value: boolean);
     get allowMessageCollapse(): boolean;
     calculateContextMenuActions(isOwn: boolean): void;
@@ -81,9 +88,11 @@ export declare class ChatService {
     getMessageById(id: string | number): Message | undefined;
     registerMessageElement(messageId: string | number, elementRef: ElementRef): void;
     unregisterMessageElement(messageId: string | number): void;
-    scrollToMessage(messageId: string | number): void;
+    scrollToMessage(messageId: string | number, behavior?: ScrollBehavior): void;
     focusActiveMessageElement(): void;
     isOwnMessage(message: Message): boolean;
+    private getScrollContainer;
+    private computeScrollTarget;
     private updateComponentSettings;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ChatService>;

package/chat/common/endless-scroll-state.d.ts

@@ -0,0 +1,36 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * @hidden
+ *
+ * Tracks the rendered range for endless scroll mode.
+ * Pure logic — no Angular dependency.
+ */
+export interface EndlessScrollRange {
+    start: number;
+    end: number;
+}
+/**
+ * @hidden
+ */
+export declare class EndlessScrollState {
+    startIndex: number;
+    endIndex: number;
+    isLoading: boolean;
+    get isAtStart(): boolean;
+    get isAtEnd(): boolean;
+    private _total;
+    private _pageSize;
+    get pageSize(): number;
+    init(total: number, pageSize: number): EndlessScrollRange;
+    extendUp(): EndlessScrollRange | null;
+    extendDown(): EndlessScrollRange | null;
+    jumpTo(targetIndex: number): EndlessScrollRange;
+    jumpToEnd(): EndlessScrollRange;
+    updateTotal(total: number): void;
+    reset(): void;
+    contains(index: number): boolean;
+    syncFromInputs(start: number, end: number, total: number): void;
+}

package/chat/common/models/pending-scroll-action.d.ts

@@ -0,0 +1,11 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * @hidden
+ * Scroll action scheduled after a new message is appended.
+ * `author` — the local user sent the message; scroll fully to the bottom.
+ * `receiver` — a remote message arrived while the user was near the bottom; scroll with threshold.
+ */
+export type PendingScrollAction = 'author' | 'receiver';

package/chat/common/scroll-anchor.directive.d.ts

@@ -13,13 +13,35 @@ export declare class ScrollAnchorDirective implements AfterViewInit, OnInit, OnD
     private renderer;
     private cdr;
     autoScroll: boolean;
+    autoScrollThreshold: number | string;
+    set endlessMode(value: boolean);
+    get endlessMode(): boolean;
+    rangeIsAtEnd: boolean;
     autoScrollChange: EventEmitter<boolean>;
+    nearTop: EventEmitter<void>;
+    nearBottom: EventEmitter<void>;
     overflowAnchor: string;
+    get scrollBehaviorStyle(): string;
     showScrollToBottomButton: boolean;
     showMessageBoxSeparator: boolean;
     private scrolling;
     private unsubscribe;
     private scrollUpdate;
+    private _previousScrollHeight;
+    private _previousScrollTop;
+    private _pendingScrollPreservation;
+    private _endlessMode;
+    private _nearTopLocked;
+    private _nearBottomLocked;
+    private _scrollingToMessage;
+    private _initialScrollDone;
+    private _subs;
+    private _streamingFollow;
+    private _thresholdScrollCap;
+    private _streamingPrevScrollTop;
+    private _streamingPrevHeight;
+    private _streamingPrevMsgCount;
+    private _mutationObserver;
     constructor(element: ElementRef, zone: NgZone, renderer: Renderer2, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngAfterViewInit(): void;
@@ -27,9 +49,24 @@ export declare class ScrollAnchorDirective implements AfterViewInit, OnInit, OnD
     onScroll(): void;
     autoScrollToBottom(): void;
     scrollToBottom(): void;
+    scrollToBottomWithSettle(onComplete?: () => void): void;
+    scrollWithThreshold(messageEl: HTMLElement): void;
+    recordScrollHeight(): void;
+    preserveScrollPosition(): void;
     calculateMessageBoxSeparator(): void;
+    getDistanceFromBottom(): number;
+    setAriaLive(value: string): void;
+    lockForMessageScroll(): void;
+    unlockForMessageScroll(): void;
+    getAutoScrollThresholdPx(): number;
+    get isFollowingThreshold(): boolean;
+    private followStreamingContent;
+    private updateScrollToBottomButton;
+    private detectStreamingScrollUp;
+    private parseThreshold;
+    private getPinnedBarHeight;
     private setupScrollUpdate;
     private performScroll;
     static ɵfac: i0.ɵɵFactoryDeclaration<ScrollAnchorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ScrollAnchorDirective, "[kendoChatScrollAnchor]", ["scrollAnchor"], { "autoScroll": { "alias": "autoScroll"; "required": false; }; }, { "autoScrollChange": "autoScrollChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ScrollAnchorDirective, "[kendoChatScrollAnchor]", ["scrollAnchor"], { "autoScroll": { "alias": "autoScroll"; "required": false; }; "autoScrollThreshold": { "alias": "autoScrollThreshold"; "required": false; }; "endlessMode": { "alias": "endlessMode"; "required": false; }; "rangeIsAtEnd": { "alias": "rangeIsAtEnd"; "required": false; }; }, { "autoScrollChange": "autoScrollChange"; "nearTop": "nearTop"; "nearBottom": "nearBottom"; }, never, never, true, never>;
 }

package/chat/common/utils.d.ts

@@ -7,6 +7,21 @@ import { ConversationalUIModelFields } from "./models/model-fields";
 import { FileSelectButtonSettings } from '../../promptbox/common/models';
 import { SpeechToTextButtonSettings } from "@progress/kendo-angular-buttons";
 import { MessageBoxSettings } from "../api/message-box";
+import { NgZone } from "@angular/core";
+/**
+ * @hidden
+ *
+ * Show the scroll-to-bottom button when the user is this many pixels from the bottom.
+ */
+export declare const scrollButtonThreshold = 100;
+/**
+ * @hidden
+ *
+ * Pins a scroll container to a computed target across layout shifts.
+ * Observers extend the idle window until layout has settled; the initial and
+ * final pins bracket the settle window so the viewport lands exactly on target.
+ */
+export declare const settleScroll: (zone: NgZone, el: HTMLElement, computeTarget: () => number | null, onComplete: () => void, idleMs?: number, timeoutMs?: number) => void;
 /**
  * @hidden
  */

package/chat/message.component.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { ChangeDetectorRef, ElementRef, OnDestroy, OnInit } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, NgZone, OnDestroy, OnInit } from '@angular/core';
 import { Message } from './api/message.interface';
 import { MessageStatus } from './api/message-status.interface';
 import { ChatItem } from './chat-item';
@@ -31,6 +31,7 @@ export declare class MessageComponent extends ChatItem implements OnInit, OnDest
     chatService: ChatService;
     private localization;
     private cdr;
+    private zone;
     set message(value: Message);
     get message(): Message;
     tabbable: boolean;
@@ -71,7 +72,7 @@ export declare class MessageComponent extends ChatItem implements OnInit, OnDest
     get showToolbar(): boolean;
     private subs;
     private _message;
-    constructor(element: ElementRef, intl: IntlService, chatService: ChatService, localization: LocalizationService, cdr: ChangeDetectorRef);
+    constructor(element: ElementRef, intl: IntlService, chatService: ChatService, localization: LocalizationService, cdr: ChangeDetectorRef, zone: NgZone);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
@@ -99,6 +100,7 @@ export declare class MessageComponent extends ChatItem implements OnInit, OnDest
     private getMessageSettings;
     private getToolbarActions;
     private getFileActions;
+    private updateExpandCollapseIconAfterStable;
     static ɵfac: i0.ɵɵFactoryDeclaration<MessageComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MessageComponent, "kendo-chat-message", never, { "message": { "alias": "message"; "required": false; }; "tabbable": { "alias": "tabbable"; "required": false; }; "authorMessageContentTemplate": { "alias": "authorMessageContentTemplate"; "required": false; }; "receiverMessageContentTemplate": { "alias": "receiverMessageContentTemplate"; "required": false; }; "messageContentTemplate": { "alias": "messageContentTemplate"; "required": false; }; "authorMessageTemplate": { "alias": "authorMessageTemplate"; "required": false; }; "receiverMessageTemplate": { "alias": "receiverMessageTemplate"; "required": false; }; "messageTemplate": { "alias": "messageTemplate"; "required": false; }; "statusTemplate": { "alias": "statusTemplate"; "required": false; }; "showMessageTime": { "alias": "showMessageTime"; "required": false; }; "authorId": { "alias": "authorId"; "required": false; }; }, {}, never, never, true, never>;
 }