@progress/kendo-angular-conversational-ui 24.0.0-develop.15 → 24.0.0-develop.16

package/chat/chat.component.d.ts

@@ -244,68 +244,44 @@ export declare class ChatComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     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.
+     * Sets the minimum distance from the top of the visible message area that prevents auto-scrolling when a new receiver message arrives.
+     * Accepts a percentage string (for example, `'30%'`) or a pixel value as a number. Set to `0` to always auto-scroll to new messages.
      *
      * Has no effect on author messages, which always scroll to the bottom.
      *
+     * For more details, refer to the [Auto-Scroll Threshold](slug:scroll_modes_chat#auto-scroll-threshold) article.
+     *
      * @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'`.
+     * Sets the total number of messages in the conversation when using endless scrolling with remote data source. For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     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.
+     * Sets the index of the first message in the currently loaded batch within the full conversation.
+     * Used with remote data sources in endless scroll mode to compute the range for the next [`loadMore`](slug:api_conversational-ui_chatcomponent#loadMore) call.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     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.
+     * Sets the exclusive end index of the currently loaded batch within the full conversation.
+     * Used with remote data sources in endless scroll mode to determine whether more messages exist beyond the current batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     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.
+     * Used with remote data sources in endless scroll mode to render the pinned message indicator when the pinned message is outside the currently loaded batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      *
      * @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.
+     * Sets the messages that serve as reply targets for messages in the currently loaded batch but exist outside it.
+     * Used with remote data sources in endless scroll mode to render reply previews when the replied-to message is not in the current batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      *
      * @default []
      */

package/fesm2022/progress-kendo-angular-conversational-ui.mjs

@@ -215,8 +215,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1777541333,
-    version: '24.0.0-develop.15',
+    publishDate: 1777884265,
+    version: '24.0.0-develop.16',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -9190,68 +9190,44 @@ class ChatComponent {
      */
     pageSize = 50;
     /**
-     * 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.
+     * Sets the minimum distance from the top of the visible message area that prevents auto-scrolling when a new receiver message arrives.
+     * Accepts a percentage string (for example, `'30%'`) or a pixel value as a number. Set to `0` to always auto-scroll to new messages.
      *
      * Has no effect on author messages, which always scroll to the bottom.
      *
+     * For more details, refer to the [Auto-Scroll Threshold](slug:scroll_modes_chat#auto-scroll-threshold) article.
+     *
      * @default '20%'
      */
     autoScrollThreshold = '20%';
     /**
-     * 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'`.
+     * Sets the total number of messages in the conversation when using endless scrolling with remote data source. For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     total;
     /**
-     * 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.
+     * Sets the index of the first message in the currently loaded batch within the full conversation.
+     * Used with remote data sources in endless scroll mode to compute the range for the next [`loadMore`](slug:api_conversational-ui_chatcomponent#loadMore) call.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     startIndex;
     /**
-     * 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.
+     * Sets the exclusive end index of the currently loaded batch within the full conversation.
+     * Used with remote data sources in endless scroll mode to determine whether more messages exist beyond the current batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      */
     endIndex;
     /**
      * 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.
+     * Used with remote data sources in endless scroll mode to render the pinned message indicator when the pinned message is outside the currently loaded batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      *
      * @default []
      */
     pinnedMessages = [];
     /**
-     * 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.
+     * Sets the messages that serve as reply targets for messages in the currently loaded batch but exist outside it.
+     * Used with remote data sources in endless scroll mode to render reply previews when the replied-to message is not in the current batch.
+     * For more details, refer to the [Endless Scrolling with Remote Data](slug:scroll_modes_chat#remote-data) section in the documentation.
      *
      * @default []
      */

package/package-metadata.mjs

@@ -7,7 +7,7 @@ export const packageMetadata = {
   "productCodes": [
     "KENDOUIANGULAR"
   ],
-  "publishDate": 1777541333,
-  "version": "24.0.0-develop.15",
+  "publishDate": 1777884265,
+  "version": "24.0.0-develop.16",
   "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-conversational-ui",
-  "version": "24.0.0-develop.15",
+  "version": "24.0.0-develop.16",
   "description": "Kendo UI for Angular Conversational UI components",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -91,7 +91,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1777541333,
+      "publishDate": 1777884265,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -101,22 +101,22 @@
     "@angular/core": "19 - 21",
     "@angular/platform-browser": "19 - 21",
     "@progress/kendo-licensing": "^1.11.0",
-    "@progress/kendo-angular-buttons": "24.0.0-develop.15",
-    "@progress/kendo-angular-inputs": "24.0.0-develop.15",
-    "@progress/kendo-angular-layout": "24.0.0-develop.15",
-    "@progress/kendo-angular-icons": "24.0.0-develop.15",
-    "@progress/kendo-angular-common": "24.0.0-develop.15",
-    "@progress/kendo-angular-intl": "24.0.0-develop.15",
-    "@progress/kendo-angular-l10n": "24.0.0-develop.15",
-    "@progress/kendo-angular-menu": "24.0.0-develop.15",
-    "@progress/kendo-angular-popup": "24.0.0-develop.15",
-    "@progress/kendo-angular-toolbar": "24.0.0-develop.15",
-    "@progress/kendo-angular-upload": "24.0.0-develop.15",
+    "@progress/kendo-angular-buttons": "24.0.0-develop.16",
+    "@progress/kendo-angular-inputs": "24.0.0-develop.16",
+    "@progress/kendo-angular-layout": "24.0.0-develop.16",
+    "@progress/kendo-angular-icons": "24.0.0-develop.16",
+    "@progress/kendo-angular-common": "24.0.0-develop.16",
+    "@progress/kendo-angular-intl": "24.0.0-develop.16",
+    "@progress/kendo-angular-l10n": "24.0.0-develop.16",
+    "@progress/kendo-angular-menu": "24.0.0-develop.16",
+    "@progress/kendo-angular-popup": "24.0.0-develop.16",
+    "@progress/kendo-angular-toolbar": "24.0.0-develop.16",
+    "@progress/kendo-angular-upload": "24.0.0-develop.16",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "24.0.0-develop.15"
+    "@progress/kendo-angular-schematics": "24.0.0-develop.16"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-conversational-ui.mjs",