@progress/kendo-angular-conversational-ui 19.1.1-develop.2 → 19.1.1

package/esm2022/ai-prompt/templates/toolbar-actions.template.mjs

@@ -5,10 +5,20 @@
 import { Directive, Optional, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that allows you to define additional ToolBar actions.
- * The actions will be rendered right after all views' ToolBar buttons.
+ * Represents a template for additional Toolbar actions.
+ * The actions appear after the Toolbar buttons for all views.
+ *
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoAIPromptToolbarActionsTemplate` directive inside the `<kendo-aiprompt>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-aiprompt>
+ *   <ng-template kendoAIPromptToolbarActionsTemplate>
+ *     <button kendoButton>Custom Action</button>
+ *   </ng-template>
+ * </kendo-aiprompt>
+ * ```
  */
 export class AIPromptToolbarActionsDirective {
     templateRef;

package/esm2022/ai-prompt/views/base-view.mjs

@@ -28,7 +28,7 @@ export class BaseView {
         }
     }
     /**
-     * The text of the ToolBar button corresponding to the view.
+     * Sets the text for the Toolbar button of the current view.
      */
     set buttonText(value) {
         this._buttonText = value;
@@ -39,8 +39,8 @@ export class BaseView {
             this.messageFor(`${this.viewType}View`);
     }
     /**
-    * The font icon of the ToolBar button corresponding to the view.
-    */
+     * Sets the font icon for the Toolbar button of the current view.
+     */
     set icon(value) {
         if (isPresent(value)) {
             this._icon = value;
@@ -53,8 +53,8 @@ export class BaseView {
         return this._icon;
     }
     /**
-    * The SVG icon of the ToolBar button corresponding to the view.
-    */
+     * Sets the SVG icon for the Toolbar button of the current view.
+     */
     set svgIcon(value) {
         if (isPresent(value)) {
             this._svgIcon = value;

package/esm2022/ai-prompt/views/command-view.component.mjs

@@ -11,7 +11,14 @@ import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 import * as i2 from "../common/aiprompt.service";
 /**
- * The component for rendering the AIPrompt Command View.
+ * Represents the component that renders the **Command** view of the AIPrompt.
+ *
+ * @example
+ * ```html
+ * <kendo-aiprompt-command-view
+ *      buttonText="My command view">
+ * </kendo-aiprompt-command-view>
+ * ```
  */
 export class CommandViewComponent extends BaseView {
     service;

package/esm2022/ai-prompt/views/custom-view.component.mjs

@@ -8,7 +8,17 @@ import { BaseView } from './base-view';
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * The component for rendering an AIPrompt Custom View.
+ * Represents the component that renders a **Custom** view in the AIPrompt.
+ *
+ * @example
+ * ```html
+ * <kendo-aiprompt-custom-view [viewTemplate]="customTemplate">
+ * </kendo-aiprompt-custom-view>
+ *
+ * <ng-template #customTemplate>
+ *   <div>Custom content here</div>
+ * </ng-template>
+ * ```
  */
 export class CustomViewComponent extends BaseView {
     constructor(localization) {

package/esm2022/ai-prompt/views/output-view.component.mjs

@@ -12,7 +12,14 @@ import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 import * as i2 from "../common/aiprompt.service";
 /**
- * The component for rendering the AIPrompt Output View.
+ * Represents the component that renders the **Output** view of the AIPrompt.
+ *
+ * @example
+ * ```html
+ * <kendo-aiprompt-output-view
+ *      buttonText="My output view">
+ * </kendo-aiprompt-output-view>
+ * ```
  */
 export class OutputViewComponent extends BaseView {
     service;

package/esm2022/ai-prompt/views/prompt-view.component.mjs

@@ -15,7 +15,14 @@ import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 import * as i2 from "../common/aiprompt.service";
 /**
- * The component for rendering the AIPrompt Prompt View.
+ * Represents the component that renders the **Prompt** view of the AIPrompt.
+ *
+ * @example
+ * ```html
+ * <kendo-aiprompt-prompt-view
+ *      buttonText="My prompt view">
+ * </kendo-aiprompt-prompt-view>
+ * ```
  */
 export class PromptViewComponent extends BaseView {
     service;

package/esm2022/chat/api/action.interface.mjs

@@ -2,5 +2,4 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-// eslint-disable max-line-length
 export {};

package/esm2022/chat/api/execute-action-event.mjs

@@ -4,16 +4,18 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from "./preventable-event";
 /**
- * Arguments for the `executeAction` event. The `executeAction` event fires when the user clicks
- * a quick action button. Calling `preventDefault()` suppresses the built-in action handler.
+ * Represents the arguments for the `executeAction` event.
+ *
+ * The `executeAction` event fires when the user clicks a quick action button.
+ * Call `preventDefault()` to suppress the built-in action handler.
  */
 export class ExecuteActionEvent extends PreventableEvent {
     /**
-     * The action that will be executed.
+     * Represents the action to execute.
      */
     action;
     /**
-     * The message that contains the action.
+     * Represents the message that contains the action.
      */
     message;
     /**

package/esm2022/chat/api/post-message-event.mjs

@@ -3,15 +3,14 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Arguments for the `SendMessage` event.
- *
+ * Describes the arguments for the `sendMessage` event.
  */
 export class SendMessageEvent {
     /**
-     * The message which contains the metadata and the user input.
+     * Represents the message that contains the metadata and user input.
      *
-     * > The Chat does not automatically append the message to its data.
-     * > For more information, refer to the article on [data binding]({% slug databinding_chat %}).
+     * > The Chat does not automatically add the message to its data.
+     * > For more information, see [Data Binding](slug:databinding_chat).
      */
     message;
     /**

package/esm2022/chat/attachment-template.directive.mjs

@@ -5,12 +5,20 @@
 import { Directive, Optional, TemplateRef } from "@angular/core";
 import * as i0 from "@angular/core";
 /**
- * Defines a template that will be used for displaying message attachments. To define an attachment
- * template, nest an `<ng-template>` tag with the `kendoChatAttachmentTemplate` attribute inside the
- * `<kendo-chat>` component. The template context is set to the attachment instance. For more information,
- * refer to the article on [message attachments]({% slug attachments_chat %}).
+ * Defines a template for displaying message attachments.
  *
- * <demo metaUrl="conversational-ui/chat/attachments/templates/" height="700"></demo>
+ * To define an attachment template, nest an `<ng-template>` tag with the `kendoChatAttachmentTemplate` attribute inside the `<kendo-chat>` component.
+ * The template context is set to the attachment instance.
+ * For more information, refer to the article on [message attachments](slug:attachments_chat).
+ *
+ * @example
+ * ```html
+ * <kendo-chat>
+ *   <ng-template kendoChatAttachmentTemplate let-attachment>
+ *     <div>Attachment: {{ attachment.content }}</div>
+ *   </ng-template>
+ * </kendo-chat>
+ * ```
  */
 export class AttachmentTemplateDirective {
     templateRef;

package/esm2022/chat/cards/hero-card.component.mjs

@@ -7,24 +7,33 @@ import { NgIf, NgFor } from '@angular/common';
 import { ButtonComponent } from '@progress/kendo-angular-buttons';
 import * as i0 from "@angular/core";
 /**
- * Represents a Hero Card component ([see example]({% slug dialogflow_chat %})).
+ * Represents a Hero Card component ([see example](slug:dialogflow_chat)).
  * Hero cards host a single large image and action buttons with text content.
+ *
+ * @example
+ * ```html
+ * <kendo-chat-hero-card
+ *   title="Card Title"
+ *   subtitle="Card Subtitle"
+ *   [actions]="actions">
+ * </kendo-chat-hero-card>
+ * ```
  */
 export class HeroCardComponent {
     /**
-     * The URL of the hero card image.
+     * Sets the URL of the hero card image.
      */
     imageUrl;
     /**
-     * The title of the hero card.
+     * Sets the title of the hero card.
      */
     title;
     /**
-     * The subtitle of the hero card.
+     * Sets the subtitle of the hero card.
      */
     subtitle;
     /**
-     * An array with the possible quick actions for this hero card.
+     * Sets the array of quick actions for this hero card.
      */
     actions;
     cssClass = true;
@@ -32,6 +41,9 @@ export class HeroCardComponent {
      * Fires when the user clicks a button.
      */
     executeAction = new EventEmitter();
+    /**
+     * Emits the `executeAction` event when the user clicks an action button.
+     */
     onClick(action) {
         this.executeAction.next(action);
     }

package/esm2022/chat/chat.component.mjs

@@ -17,44 +17,53 @@ import { LocalizedMessagesDirective } from './l10n/localized-messages.directive'
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * Represents the Kendo UI Chat component for Angular.
+ * Represents the [Kendo UI Chat component for Angular](slug:overview_convui).
  *
- * <demo metaUrl="conversational-ui/chat/echo/" height="700"></demo>
+ * Provides a conversational UI for chat-based applications.
+ * Supports message templates, attachments, localization, and user actions.
  *
+ * @example
+ * ```html
+ * <kendo-chat
+ *   [messages]="messages"
+ *   [user]="user"
+ *   (sendMessage)="onSendMessage($event)"
+ *   (executeAction)="onExecuteAction($event)">
+ * </kendo-chat>
+ * ```
  */
 export class ChatComponent {
     localization;
     zone;
     /**
-     * Sets the messages of the Chat.
-     * The message timestamp, if provided, tracks unique messages.
+     * Defines the array of messages displayed in the Chat.
+     * Each message can include a timestamp for unique identification.
      * For more information, refer to [ngFor - Change Tracking](link:site.data.urls.angular['ngforof']#change-propagation).
      */
     messages;
     /**
-     * Sets the [`User`]({% slug api_conversational-ui_user %}) instance for the local user.
-     * The User ID identifies messages that are authored by the local user.
+     * Specifies the [`User`](slug:api_conversational-ui_user) instance representing the local user.
+     * The User ID is used to distinguish messages authored by the local user.
      */
     user;
     /**
-     * Used to switch between a one-liner input or a textarea.
-     * ([see example]({% slug message_box %})#toc-message-box-types).
-     * @default input
+     * Determines the type of input used in the message box.
+     * Can be set to `textbox` for a single-line input or `textarea` for multi-line input
+     * ([see example](slug:message_box#message-box-types)).
+     * @default 'textbox'
      */
     messageBoxType = 'textbox';
     /**
-     * Fires when the user types a message and clicks the **Send** button or presses **Enter**.
-     * Emits the [`SendMessageEvent`]({% slug api_conversational-ui_sendmessageevent %}).
+     * Emits when the user sends a message by clicking the **Send** button or pressing **Enter**.
      *
-     * > The message is not automatically appended to the `messages` array.
+     * > The message is not automatically added to the `messages` array.
      */
     sendMessage = new EventEmitter();
     /**
-     * Fires when the user clicks a quick action button.
-     * The Chat internally handles the `reply`, `openUrl`, and `call` [known actions]({% slug api_conversational-ui_actiontype %}).
+     * Emits when the user clicks a quick action button.
+     * The Chat internally handles [known actions](slug:api_conversational-ui_actiontype) such as `reply`, `openUrl`, and `call`.
      *
-     * Emits the [`ExecuteActionEvent`]({% slug api_conversational-ui_executeactionevent %}).
-     * The event is preventable. If `preventDefault` is called, the built-in action will be suppressed.
+     * The event is preventable&mdash;calling `preventDefault` suppresses the built-in action.
      */
     executeAction = new EventEmitter();
     get className() {

package/esm2022/chat/chat.module.mjs

@@ -15,7 +15,7 @@ import * as i5 from "./cards/hero-card.component";
 import * as i6 from "./message-box.directive";
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * The [NgModule](link:site.data.urls.angular['ngmodules']) for the Chat component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmodules']) for the Chat component.
  *
  * @example
  * ```ts-no-run
@@ -24,12 +24,12 @@ import * as i6 from "./message-box.directive";
  * import { BrowserModule } from '@angular/platform-browser';
  *
  * import { ChatModule } from '@progress/kendo-angular-conversational-ui';
- * import { AppComponent }   from './app.component';
+ * import { AppComponent } from './app.component';
  *
  * _@NgModule({
- *   imports:      [ BrowserModule, ChatModule ],
- *   declarations: [ AppComponent ],
- *   bootstrap:    [ AppComponent ]
+ *   imports: [BrowserModule, ChatModule],
+ *   declarations: [AppComponent],
+ *   bootstrap: [AppComponent]
  * })
  *
  * export class AppModule { }

package/esm2022/chat/l10n/custom-messages.component.mjs

@@ -9,8 +9,18 @@ import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 // eslint-disable no-forward-ref
 /**
- * Custom component messages override default component messages
- * ([see example]({% slug globalization_chat %}#toc-custom-messages)).
+ * Represents the custom messages component of the Chat.
+ *
+ * Use this component to override default messages for the Chat
+ * ([see example](slug:globalization_chat#custom-messages)).
+ *
+ * @example
+ * ```html
+ * <kendo-chat-messages
+ *   send="Send Message"
+ *   messagePlaceholder="Type here...">
+ * </kendo-chat-messages>
+ * ```
  */
 export class CustomMessagesComponent extends Messages {
     service;

package/esm2022/chat/l10n/messages.mjs

@@ -10,7 +10,7 @@ import * as i0 from "@angular/core";
  */
 export class Messages extends ComponentMessages {
     /**
-     * Sets the placeholder text of the message text input.
+     * Sets the placeholder text for the message text input.
      */
     messagePlaceholder;
     /**
@@ -18,24 +18,23 @@ export class Messages extends ComponentMessages {
      */
     send;
     /**
-     * The label for the Message list.
+     * Sets the label for the message list.
      */
     messageListLabel;
     /**
-     * The label for the Message input box.
-     *
+     * Sets the label for the message input box.
      */
     messageBoxInputLabel;
     /**
-     * The text for the left arrow of the message attachments.
+     * Sets the text for the left arrow of the message attachments.
      */
     messageAttachmentLeftArrow;
     /**
-     * The text for the right arrow of the message attachments.
+     * Sets the text for the right arrow of the message attachments.
      */
     messageAttachmentRightArrow;
     /**
-     * The alt attribute text for the avatar image.
+     * Sets the `alt` attribute text for the avatar image.
      */
     messageAvatarAlt;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });

package/esm2022/chat/message-box.directive.mjs

@@ -5,9 +5,19 @@
 import { Directive, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Creates a message box area that overrides the default message box of the Conversational UI Component.
- * To define a message-box template, nest an `<ng-template>` tag with the `kendoChatMessageBoxTemplate` directive inside the `<kendo-chat>` tag
- * [see example]({% slug message_box %}#toc-message-box-template).
+ * Creates a message box area that overrides the default message box of the Chat component.
+ *
+ * To define a message box template, nest an `<ng-template>` tag with the `kendoChatMessageBoxTemplate` directive inside the `<kendo-chat>` tag.
+ * For more information, see [Message Box Template](slug:message_box#toc-message-box-template).
+ *
+ * @example
+ * ```html
+ * <kendo-chat>
+ *   <ng-template kendoChatMessageBoxTemplate>
+ *     <input type="text" placeholder="Custom message box..." />
+ *   </ng-template>
+ * </kendo-chat>
+ * ```
  */
 export class ChatMessageBoxTemplateDirective {
     templateRef;

package/esm2022/chat/message-template.directive.mjs

@@ -5,12 +5,20 @@
 import { Directive, Optional, TemplateRef } from "@angular/core";
 import * as i0 from "@angular/core";
 /**
- * Defines a template that will be used for displaying Chat messages. To define an attachment
- * template, nest an `<ng-template>` tag with the `kendoChatMessageTemplate` attribute inside the
- * `<kendo-chat>` component. The template context is set to the message instance. For more information,
- * refer to the article on [message templates]({% slug message_templates_chat %}).
+ * Defines a template for displaying Chat messages.
  *
- * <demo metaUrl="conversational-ui/chat/messages/templates/" height="700"></demo>
+ * To define a message template, nest an `<ng-template>` tag with the `kendoChatMessageTemplate` directive inside the `<kendo-chat>` component.
+ * The template context is set to the `message` instance.
+ * For more information, refer to the article on [message templates](slug:message_templates_chat).
+ *
+ * @example
+ * ```html
+ * <kendo-chat>
+ *   <ng-template kendoChatMessageTemplate let-message>
+ *     <div>Message: {{ message.text }}</div>
+ *   </ng-template>
+ * </kendo-chat>
+ * ```
  */
 export class MessageTemplateDirective {
     templateRef;

package/esm2022/conversational-ui.module.mjs

@@ -25,34 +25,21 @@ import * as i13 from "./chat/cards/hero-card.component";
 import * as i14 from "./chat/message-box.directive";
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmodules'])
- * definition for the Conversational UI components.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmodules']) for the Conversational UI components.
  *
  * @example
- *
- * ```ts-no-run
- * // Import the Conversational UI module
- * import { ConversationalUIModule } from '@progress/kendo-angular-conversational-ui';
- *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
+ * ```ts
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { ConversationalUIModule } from '@progress/kendo-angular-conversational-ui';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, ConversationalUIModule], // import Conversational UI module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, ConversationalUIModule],
+ *   bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export class ConversationalUIModule {

package/esm2022/directives.mjs

@@ -16,7 +16,21 @@ import { MessageTemplateDirective } from "./chat/message-template.directive";
 import { HeroCardComponent } from "./chat/cards/hero-card.component";
 import { ChatMessageBoxTemplateDirective } from "./chat/message-box.directive";
 /**
- * Utility array that contains all `AIPrompt` related components and directives
+ * Utility array that contains all AIPrompt related components and directives.
+ *
+ * @example
+ * ```ts
+ * import { Component } from '@angular/core';
+ * import { KENDO_AIPROMPT } from '@progress/kendo-angular-conversational-ui';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_AIPROMPT],
+ *   selector: 'my-app',
+ *   template: `<kendo-aiprompt></kendo-aiprompt>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_AIPROMPT = [
     AIPromptComponent,
@@ -29,7 +43,21 @@ export const KENDO_AIPROMPT = [
     AIPromptToolbarFocusableDirective
 ];
 /**
- * Utility array that contains all `Chat` related components and directives
+ * Utility array that contains all Chat related components and directives.
+ *
+ * @example
+ * ```ts
+ * import { Component } from '@angular/core';
+ * import { KENDO_CHAT } from '@progress/kendo-angular-conversational-ui';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_CHAT],
+ *   selector: 'my-app',
+ *   template: `<kendo-chat></kendo-chat>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_CHAT = [
     ChatComponent,
@@ -40,7 +68,24 @@ export const KENDO_CHAT = [
     ChatMessageBoxTemplateDirective
 ];
 /**
- * Utility array that contains all `@progress/kendo-angular-conversational-ui` related components and directives
+ * Utility array that contains all `@progress/kendo-angular-conversational-ui` related components and directives.
+ *
+ * @example
+ * ```ts
+ * import { Component } from '@angular/core';
+ * import { KENDO_CONVERSATIONALUI } from '@progress/kendo-angular-conversational-ui';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_CONVERSATIONALUI],
+ *   selector: 'my-app',
+ *   template: `
+ *     <kendo-aiprompt></kendo-aiprompt>
+ *     <kendo-chat></kendo-chat>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_CONVERSATIONALUI = [
     ...KENDO_AIPROMPT,

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749196920,
-    version: '19.1.1-develop.2',
+    publishDate: 1749540414,
+    version: '19.1.1',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };