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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/chat/api/post-message-event.d.ts +1 -2
  2. package/chat/cards/hero-card.component.d.ts +1 -1
  3. package/chat/chat.component.d.ts +15 -17
  4. package/chat/common/models/message-box-options.d.ts +1 -0
  5. package/chat/l10n/messages.d.ts +9 -9
  6. package/chat/templates/attachment-template.directive.d.ts +5 -1
  7. package/chat/templates/suggestion-template.directive.d.ts +5 -2
  8. package/chat/templates/timestamp-template.directive.d.ts +4 -1
  9. package/esm2022/chat/api/post-message-event.mjs +1 -2
  10. package/esm2022/chat/cards/hero-card.component.mjs +1 -1
  11. package/esm2022/chat/chat.component.mjs +15 -17
  12. package/esm2022/chat/l10n/messages.mjs +9 -9
  13. package/esm2022/chat/templates/attachment-template.directive.mjs +5 -1
  14. package/esm2022/chat/templates/suggestion-template.directive.mjs +5 -2
  15. package/esm2022/chat/templates/timestamp-template.directive.mjs +4 -1
  16. package/esm2022/inline-ai-prompt/inlineaiprompt.component.mjs +18 -16
  17. package/esm2022/inline-ai-prompt/inlineaiprompt.service.mjs +17 -10
  18. package/esm2022/inline-ai-prompt/localization/custom-messages.component.mjs +1 -3
  19. package/esm2022/inline-ai-prompt/localization/messages.mjs +3 -3
  20. package/esm2022/inline-ai-prompt/models/inlineaiprompt-settings.mjs +5 -5
  21. package/esm2022/package-metadata.mjs +2 -2
  22. package/fesm2022/progress-kendo-angular-conversational-ui.mjs +86 -72
  23. package/inline-ai-prompt/inlineaiprompt.component.d.ts +18 -16
  24. package/inline-ai-prompt/inlineaiprompt.service.d.ts +17 -10
  25. package/inline-ai-prompt/localization/custom-messages.component.d.ts +1 -3
  26. package/inline-ai-prompt/localization/messages.d.ts +3 -3
  27. package/inline-ai-prompt/models/command.interface.d.ts +8 -8
  28. package/inline-ai-prompt/models/inlineaiprompt-popupsettings.d.ts +1 -1
  29. package/inline-ai-prompt/models/inlineaiprompt-settings.d.ts +5 -5
  30. package/inline-ai-prompt/models/messages.d.ts +3 -3
  31. package/inline-ai-prompt/models/output-action-click-event.d.ts +2 -2
  32. package/inline-ai-prompt/models/output-action.interface.d.ts +10 -11
  33. package/inline-ai-prompt/models/prompt-output.interface.d.ts +5 -5
  34. package/inline-ai-prompt/models/prompt-request-event.d.ts +3 -3
  35. package/package.json +14 -14
@@ -10,15 +10,15 @@ import * as i0 from "@angular/core";
10
10
  */
11
11
  export class Messages extends ComponentMessages {
12
12
  /**
13
- * Sets the Commands button title.
13
+ * The title for the Commands button.
14
14
  */
15
15
  commandsButtonTitle;
16
16
  /**
17
- * Sets the Generate button title.
17
+ * The title for the Generate button.
18
18
  */
19
19
  generateButtonTitle;
20
20
  /**
21
- * Sets the Speech to Text button title.
21
+ * The title for the Speech to Text button.
22
22
  */
23
23
  speechToTextButtonTitle;
24
24
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -7,7 +7,7 @@
7
7
  */
8
8
  export class InlineAIPromptSettings {
9
9
  /**
10
- * Specifies the settings for the Inline AI Prompt Popup.
10
+ * The settings for the Inline AI Prompt Popup.
11
11
  */
12
12
  popupSettings;
13
13
  /**
@@ -25,7 +25,7 @@ export class InlineAIPromptSettings {
25
25
  */
26
26
  promptValue;
27
27
  /**
28
- * Sets the placeholder of the Inline AI Prompt TextArea.
28
+ * Sets the placeholder text for the Inline AI Prompt TextArea.
29
29
  */
30
30
  placeholder;
31
31
  /**
@@ -41,15 +41,15 @@ export class InlineAIPromptSettings {
41
41
  */
42
42
  promptOutput;
43
43
  /**
44
- * Sets the visibility and configuration of the Speech to Text button.
44
+ * Controls the visibility and configuration of the Speech to Text button.
45
45
  */
46
46
  enableSpeechToTextButton;
47
47
  /**
48
- * Sets the template for the output content. If not provided, the default output template is used.
48
+ * Sets the template for the output content. If not provided, uses the default output template.
49
49
  */
50
50
  outputTemplate;
51
51
  /**
52
- * Sets whether the send button turns into a stop button.
52
+ * If `true`, the send button turns into a stop button.
53
53
  */
54
54
  streaming;
55
55
  /**
@@ -10,7 +10,7 @@ export const packageMetadata = {
10
10
  productName: 'Kendo UI for Angular',
11
11
  productCode: 'KENDOUIANGULAR',
12
12
  productCodes: ['KENDOUIANGULAR'],
13
- publishDate: 1756303264,
14
- version: '20.0.2',
13
+ publishDate: 1756905651,
14
+ version: '20.0.3-develop.2',
15
15
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
16
16
  };
@@ -87,8 +87,7 @@ class SendMessageEvent {
87
87
  /**
88
88
  * Represents the message that contains the metadata and user input.
89
89
  *
90
- * > The Chat does not automatically add the message to its data.
91
- * > For more information, see [Data Binding](slug:databinding_chat).
90
+ * The Chat does not automatically add the message to its data. For more information, see [Data Binding](slug:databinding_chat).
92
91
  */
93
92
  message;
94
93
  /**
@@ -217,8 +216,8 @@ const packageMetadata = {
217
216
  productName: 'Kendo UI for Angular',
218
217
  productCode: 'KENDOUIANGULAR',
219
218
  productCodes: ['KENDOUIANGULAR'],
220
- publishDate: 1756303264,
221
- version: '20.0.2',
219
+ publishDate: 1756905651,
220
+ version: '20.0.3-develop.2',
222
221
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
223
222
  };
224
223
 
@@ -1851,10 +1850,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1851
1850
  * The template context is set to the attachment instance.
1852
1851
  * For more information, refer to the article on [message attachments](slug:attachments_chat).
1853
1852
  *
1853
+ * You can use the following field:
1854
+ * - `attachment`—The attachment instance.
1855
+ * - `message`—The message instance.
1856
+ *
1854
1857
  * @example
1855
1858
  * ```html
1856
1859
  * <kendo-chat>
1857
- * <ng-template kendoChatAttachmentTemplate let-attachment>
1860
+ * <ng-template kendoChatAttachmentTemplate let-attachment let-message>
1858
1861
  * <div>Attachment: {{ attachment.content }}</div>
1859
1862
  * </ng-template>
1860
1863
  * </kendo-chat>
@@ -2220,11 +2223,14 @@ class ChatItem {
2220
2223
  /**
2221
2224
  * Represents the template for a suggestion in the Chat component.
2222
2225
  *
2226
+ * You can use the following field:
2227
+ * - `suggestion`&mdash;The suggestion instance.
2228
+ *
2223
2229
  * @example
2224
2230
  * ```html
2225
2231
  * <kendo-chat>
2226
- * <ng-template kendoChatSuggestionTemplate>
2227
- * Suggestion Text
2232
+ * <ng-template kendoChatSuggestionTemplate let-suggestion>
2233
+ * {{ suggestion.text }}
2228
2234
  * </ng-template>
2229
2235
  * </kendo-chat>
2230
2236
  * ```
@@ -3174,12 +3180,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
3174
3180
  }] } });
3175
3181
 
3176
3182
  /**
3177
- * Defines a template for displaying the timestamp of the messages.
3183
+ * Defines a template for displaying the chat timestamp.
3178
3184
  *
3179
3185
  * To define a timestamp template, nest an `<ng-template>` tag with the `kendoChatTimestampTemplate` directive inside the `<kendo-chat>` component.
3180
3186
  * The template context is set to the current timestamp.
3181
3187
  * For more information, refer to the article on [message templates](slug:message_templates_chat).
3182
3188
  *
3189
+ * You can use the following field:
3190
+ * - `timestamp`&mdash;The current timestamp.
3191
+ *
3183
3192
  * @example
3184
3193
  * ```html
3185
3194
  * <kendo-chat>
@@ -4573,16 +4582,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
4573
4582
  */
4574
4583
  let Messages$1 = class Messages extends ComponentMessages {
4575
4584
  /**
4576
- * Sets the text that is displayed when the sender deletes a message.
4585
+ * Sets the text that displays when the sender deletes a message.
4577
4586
  */
4578
4587
  deletedMessageSenderText;
4579
4588
  /**
4580
- * Sets the text that is displayed when the receiver deletes a message.
4589
+ * Sets the text that displays when the receiver deletes a message.
4581
4590
  */
4582
4591
  deletedMessageReceiverText;
4583
4592
  /**
4584
- * Sets the text that is displayed in the download section of the message.
4585
- * This message is displayed below all files in the message.
4593
+ * Sets the text that displays in the download section of the message.
4594
+ * This message displays below all files in the message.
4586
4595
  */
4587
4596
  downloadAllFilesText;
4588
4597
  /**
@@ -4618,23 +4627,23 @@ let Messages$1 = class Messages extends ComponentMessages {
4618
4627
  */
4619
4628
  fileSelectButtonTitle;
4620
4629
  /**
4621
- * Sets the title of the icon which removes the reply reference in the Message Box.
4630
+ * Sets the title of the icon that removes the reply reference in the Message Box.
4622
4631
  */
4623
4632
  removeReplyTitle;
4624
4633
  /**
4625
- * Sets the title of the icon which removes a selected file in the Message Box.
4634
+ * Sets the title of the icon that removes a selected file in the Message Box.
4626
4635
  */
4627
4636
  removeFileTitle;
4628
4637
  /**
4629
- * Sets the title of the icon which demonstrates that the message can be expanded.
4638
+ * Sets the title of the icon that shows the message can expand.
4630
4639
  */
4631
4640
  expandTitle;
4632
4641
  /**
4633
- * Sets the title of the icon which demonstrates that the message can be collapsed.
4642
+ * Sets the title of the icon that shows the message can collapse.
4634
4643
  */
4635
4644
  collapseTitle;
4636
4645
  /**
4637
- * Sets the title of the DropDownButton which opens the File actions.
4646
+ * Sets the title of the DropDownButton that opens the File actions.
4638
4647
  */
4639
4648
  fileActionsTitle;
4640
4649
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -4768,7 +4777,7 @@ class ChatComponent {
4768
4777
  /**
4769
4778
  * Defines the array of messages displayed in the Chat.
4770
4779
  * Each message can include a timestamp for unique identification.
4771
- * For more information, refer to [ngFor - Change Tracking](link:site.data.urls.angular['ngforof']#change-propagation).
4780
+ * For more information, see [ngFor - Change Tracking](link:site.data.urls.angular['ngforof']#change-propagation).
4772
4781
  */
4773
4782
  messages;
4774
4783
  /**
@@ -4785,13 +4794,13 @@ class ChatComponent {
4785
4794
  messageBoxType = 'textarea';
4786
4795
  /**
4787
4796
  * Sets the height of the Chat component.
4788
- * Accepts a string with CSS units (e.g., '400px', '50%') or a number (interpreted as pixels).
4797
+ * Accepts a string with CSS units (for example, `'400px'`, `'50%'`) or a number (interpreted as pixels).
4789
4798
  * The minimum height is `600px`.
4790
4799
  */
4791
4800
  height;
4792
4801
  /**
4793
4802
  * Sets the width of the Chat component.
4794
- * Accepts a string with CSS units (e.g., '400px', '50%') or a number (interpreted as pixels).
4803
+ * Accepts a string with CSS units (for example, `'400px'`, `'50%'`) or a number (interpreted as pixels).
4795
4804
  * The minimum width is `320px`.
4796
4805
  */
4797
4806
  width;
@@ -4806,9 +4815,8 @@ class ChatComponent {
4806
4815
  */
4807
4816
  messageWidthMode = 'standard';
4808
4817
  /**
4809
- * Enables the expand/collapse functionality of the messages.
4810
- *
4811
- * @default `false`
4818
+ * Enables the expand or collapse functionality for messages.
4819
+ * @default false
4812
4820
  */
4813
4821
  allowMessageCollapse = false;
4814
4822
  /**
@@ -4825,13 +4833,13 @@ class ChatComponent {
4825
4833
  enableFileSelect = true;
4826
4834
  /**
4827
4835
  * Specifies the actions available in the message toolbar.
4828
- * These actions are displayed in the message toolbar and can be used to perform specific operations on the message.
4829
- *
4836
+ * These actions display in the message toolbar and let you perform specific operations on the message.
4830
4837
  * @default []
4831
4838
  */
4832
4839
  messageToolbarActions = [];
4833
4840
  /**
4834
4841
  * Sets the value of the Message Box.
4842
+ * @default ''
4835
4843
  */
4836
4844
  inputValue = '';
4837
4845
  /**
@@ -4842,7 +4850,7 @@ class ChatComponent {
4842
4850
  defaultContextMenuActions = CONTEXT_MENU_ACTIONS;
4843
4851
  /**
4844
4852
  * Specifies the actions available in the message as a context menu.
4845
- * These actions are displayed as menu items and can be used to perform specific operations on the message.
4853
+ * These actions display as menu items and let you perform specific operations on the message.
4846
4854
  * The default actions are `copy` and `reply` and are defined by their `id`.
4847
4855
  */
4848
4856
  set messageContextMenuActions(actions) {
@@ -4857,7 +4865,7 @@ class ChatComponent {
4857
4865
  defaultFileActions = FILE_ACTIONS;
4858
4866
  /**
4859
4867
  * Specifies the actions available in the file as items of a DropDownButton.
4860
- * These actions are displayed when clicking on the file DropDownButton and can be used to perform specific operations on the file.
4868
+ * These actions display when you click the file DropDownButton and let you perform specific operations on the file.
4861
4869
  * The default action is `download` and is defined by its `id`.
4862
4870
  *
4863
4871
  * @default [{ id: 'download', label: 'Download', icon: 'download', svgIcon: downloadIcon, disabled: false }]
@@ -4870,8 +4878,7 @@ class ChatComponent {
4870
4878
  }
4871
4879
  /**
4872
4880
  * Sets the suggestions to display in the message input box.
4873
- * Suggestions are displayed as a list of clickable items that can be used to quickly insert predefined text into the message input.
4874
- *
4881
+ * Suggestions display as a list of clickable items that let you quickly insert predefined text into the message input.
4875
4882
  * @default []
4876
4883
  */
4877
4884
  suggestions = [];
@@ -4885,12 +4892,12 @@ class ChatComponent {
4885
4892
  * Sets the send button settings for the Chat component.
4886
4893
  * Allows customization of the send button appearance, icons and disabled state.
4887
4894
  *
4888
- * @default defaultButtonSettings
4895
+ * @default { fillMode: 'solid', rounded: 'full', size: 'medium', themeColor: 'primary', icon: 'paper-plane', svgIcon: paperPlaneIcon}
4889
4896
  */
4890
4897
  sendButtonSettings = SEND_BTN_DEFAULT_SETTINGS;
4891
4898
  /**
4892
4899
  * Sets the names of the model fields from which the Chat reads its data.
4893
- * Allows mapping of custom data structures to the expected Message format.
4900
+ * Lets you map custom data structures to the expected `Message` format.
4894
4901
  */
4895
4902
  set modelFields(value) {
4896
4903
  this._modelFields = { ...defaultModelFields, ...value };
@@ -4901,7 +4908,7 @@ class ChatComponent {
4901
4908
  /**
4902
4909
  * Emits when the user sends a message by clicking the **Send** button or pressing **Enter**.
4903
4910
  *
4904
- * > The message is not automatically added to the `messages` array.
4911
+ * The message is not automatically added to the `messages` array.
4905
4912
  */
4906
4913
  sendMessage = new EventEmitter();
4907
4914
  /**
@@ -4924,7 +4931,7 @@ class ChatComponent {
4924
4931
  * Emits when the user clicks a quick action button.
4925
4932
  * The Chat internally handles [known actions](slug:api_conversational-ui_actiontype) such as `reply`, `openUrl`, and `call`.
4926
4933
  *
4927
- * The event is preventable&mdash;calling `preventDefault` suppresses the built-in action.
4934
+ * The event is preventable. Calling [`preventDefault`](https://developer.mozilla.org/en-US/docs/Web/API/Event/preventDefault) suppresses the built-in action.
4928
4935
  */
4929
4936
  executeAction = new EventEmitter();
4930
4937
  /**
@@ -4941,7 +4948,7 @@ class ChatComponent {
4941
4948
  fileRemove = new EventEmitter();
4942
4949
  /**
4943
4950
  * Emits when the user unpins the pinned message.
4944
- * This event is triggered when the user clicks the delete button on the pinned message.
4951
+ * This event triggers when the user clicks the delete button on the pinned message.
4945
4952
  */
4946
4953
  unpin = new EventEmitter();
4947
4954
  /**
@@ -5529,7 +5536,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
5529
5536
 
5530
5537
  /**
5531
5538
  * Represents a Hero Card component.
5532
- * Hero cards host a single large image and action buttons with text content.
5539
+ * Hero cards display a single large image and action buttons with text content.
5533
5540
  *
5534
5541
  * @example
5535
5542
  * ```html
@@ -5643,15 +5650,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
5643
5650
  */
5644
5651
  class Messages extends ComponentMessages {
5645
5652
  /**
5646
- * Sets the Commands button title.
5653
+ * The title for the Commands button.
5647
5654
  */
5648
5655
  commandsButtonTitle;
5649
5656
  /**
5650
- * Sets the Generate button title.
5657
+ * The title for the Generate button.
5651
5658
  */
5652
5659
  generateButtonTitle;
5653
5660
  /**
5654
- * Sets the Speech to Text button title.
5661
+ * The title for the Speech to Text button.
5655
5662
  */
5656
5663
  speechToTextButtonTitle;
5657
5664
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -6291,18 +6298,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6291
6298
  *
6292
6299
  * @example
6293
6300
  * ```html
6294
- * <kendo-inlineaiprompt
6295
- * placeholder="Enter your prompt..."
6296
- * [promptOutput]="promptOutput"
6297
- * (promptRequest)="onPromptRequest($event)">
6298
- * </kendo-inlineaiprompt>
6301
+ * <kendo-inlineaiprompt
6302
+ * placeholder="Enter your prompt..."
6303
+ * [promptOutput]="promptOutput"
6304
+ * (promptRequest)="onPromptRequest($event)">
6305
+ * </kendo-inlineaiprompt>
6299
6306
  * ```
6300
6307
  */
6301
6308
  class InlineAIPromptComponent {
6302
6309
  ngZone;
6303
6310
  element;
6304
6311
  /**
6305
- * Sets the text of the TextArea.
6312
+ * Sets the TextArea value.
6313
+ *
6314
+ * @default ""
6306
6315
  */
6307
6316
  promptValue = "";
6308
6317
  /**
@@ -6321,8 +6330,7 @@ class InlineAIPromptComponent {
6321
6330
  */
6322
6331
  enableSpeechToText = true;
6323
6332
  /**
6324
- * Sets the streaming state of the component.
6325
- * When set to `true`, the send button displays a generating state and the component emits a `promptRequestCancel` event when you click it.
6333
+ * When set to `true`, the **Send** button displays a generating state and the component emits a `promptRequestCancel` event when you click it.
6326
6334
  *
6327
6335
  * @default false
6328
6336
  */
@@ -6357,7 +6365,8 @@ class InlineAIPromptComponent {
6357
6365
  */
6358
6366
  promptCommands;
6359
6367
  /**
6360
- * Sets the popup settings for the component.
6368
+ * Sets the Popup settings.
6369
+ *
6361
6370
  */
6362
6371
  set popupSettings(settings) {
6363
6372
  this._popupSettings = { ...defaultPopupSettings, ...settings };
@@ -6366,27 +6375,27 @@ class InlineAIPromptComponent {
6366
6375
  return this._popupSettings;
6367
6376
  }
6368
6377
  /**
6369
- * Fires when you click the send button.
6378
+ * Fires when the send button is clicked.
6370
6379
  */
6371
6380
  promptRequest = new EventEmitter();
6372
6381
  /**
6373
- * Fires when you click a command.
6382
+ * Fires when a command is executed.
6374
6383
  */
6375
6384
  commandExecute = new EventEmitter();
6376
6385
  /**
6377
- * Fires when you click an output action button.
6386
+ * Fires when an output action button is clicked.
6378
6387
  */
6379
6388
  outputActionClick = new EventEmitter();
6380
6389
  /**
6381
- * Fires when you cancel the prompt request by clicking the stop button.
6390
+ * Fires when the stop button is clicked during streaming.
6382
6391
  */
6383
6392
  promptRequestCancel = new EventEmitter();
6384
6393
  /**
6385
- * Fires when the component closes, either by clicking outside the popup, clicking the Discard action, or after pressing the Escape key.
6394
+ * Fires when the component closes (Escape key, Discard action or outside click).
6386
6395
  */
6387
6396
  close = new EventEmitter();
6388
6397
  /**
6389
- * Fires when the value of the TextArea changes.
6398
+ * Fires when the TextArea value changes.
6390
6399
  */
6391
6400
  promptValueChange = new EventEmitter();
6392
6401
  popupElement;
@@ -6418,7 +6427,7 @@ class InlineAIPromptComponent {
6418
6427
  this.subs.unsubscribe();
6419
6428
  }
6420
6429
  /**
6421
- * Focuses the TextArea of the Inline AI Prompt.
6430
+ * Focus the TextArea.
6422
6431
  */
6423
6432
  focus() {
6424
6433
  if (this.contentComponent?.textArea) {
@@ -6617,9 +6626,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6617
6626
  }] } });
6618
6627
 
6619
6628
  /**
6620
- * Represents the custom messages component of the Inline AI Prompt.
6621
- *
6622
- * Use this component to override default messages for the Inline AI Prompt.
6629
+ * Provides a component for customizing messages in the Inline AI Prompt. [See example](slug:globalization_chat#custom-messages).
6623
6630
  *
6624
6631
  * @example
6625
6632
  * ```html
@@ -6903,31 +6910,38 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6903
6910
  }] });
6904
6911
 
6905
6912
  /**
6906
- * Provides a service for opening Inline AI Prompt components dynamically.
6913
+ * Provides a service for opening and configuring the Inline AI Prompt component dynamically.
6907
6914
  *
6908
6915
  * @example
6909
6916
  * ```ts
6910
- * import { InlineAIPromptService } from '@progress/kendo-angular-conversational-ui';
6917
+ * export class DemoComponent {
6918
+ * @ViewChild('anchor', { read: ElementRef }) anchor: ElementRef;
6919
+ * constructor(private promptService: InlineAIPromptService) {}
6911
6920
  *
6912
- * constructor(private inlineAIPromptService: InlineAIPromptService) {}
6913
- *
6914
- * openPrompt(anchor: ElementRef) {
6915
- * const promptRef = this.inlineAIPromptService.open({
6916
- * anchor: anchor,
6917
- * placeholder: 'Enter your prompt...'
6918
- * });
6921
+ * open(): void {
6922
+ * this.promptService.open({
6923
+ * popupSettings: { anchor: this.anchor },
6924
+ * placeholder: 'Enter your prompt...'
6925
+ * });
6926
+ * }
6919
6927
  * }
6920
6928
  * ```
6929
+ * ```html
6930
+ * <button #anchor (click)="open()">Ask AI</button>
6931
+ * ```
6921
6932
  */
6922
6933
  class InlineAIPromptService {
6923
6934
  popupService;
6935
+ /**
6936
+ * @hidden
6937
+ */
6924
6938
  constructor(popupService) {
6925
6939
  this.popupService = popupService;
6926
6940
  }
6927
6941
  /**
6928
6942
  * Opens an Inline AI Prompt component in a popup. The popup appears near the specified anchor element or at the provided offset coordinates.
6929
6943
  *
6930
- * @param {InlineAIPromptSettings} options - The options for the InlineAIPromptComponent.
6944
+ * @param {InlineAIPromptSettings} options The options for the InlineAIPromptComponent.
6931
6945
  * @returns {PopupRef} A reference to the popup.
6932
6946
  */
6933
6947
  open(options) {
@@ -6983,7 +6997,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6983
6997
  */
6984
6998
  class InlineAIPromptSettings {
6985
6999
  /**
6986
- * Specifies the settings for the Inline AI Prompt Popup.
7000
+ * The settings for the Inline AI Prompt Popup.
6987
7001
  */
6988
7002
  popupSettings;
6989
7003
  /**
@@ -7001,7 +7015,7 @@ class InlineAIPromptSettings {
7001
7015
  */
7002
7016
  promptValue;
7003
7017
  /**
7004
- * Sets the placeholder of the Inline AI Prompt TextArea.
7018
+ * Sets the placeholder text for the Inline AI Prompt TextArea.
7005
7019
  */
7006
7020
  placeholder;
7007
7021
  /**
@@ -7017,15 +7031,15 @@ class InlineAIPromptSettings {
7017
7031
  */
7018
7032
  promptOutput;
7019
7033
  /**
7020
- * Sets the visibility and configuration of the Speech to Text button.
7034
+ * Controls the visibility and configuration of the Speech to Text button.
7021
7035
  */
7022
7036
  enableSpeechToTextButton;
7023
7037
  /**
7024
- * Sets the template for the output content. If not provided, the default output template is used.
7038
+ * Sets the template for the output content. If not provided, uses the default output template.
7025
7039
  */
7026
7040
  outputTemplate;
7027
7041
  /**
7028
- * Sets whether the send button turns into a stop button.
7042
+ * If `true`, the send button turns into a stop button.
7029
7043
  */
7030
7044
  streaming;
7031
7045
  /**
@@ -17,18 +17,20 @@ import * as i0 from "@angular/core";
17
17
  *
18
18
  * @example
19
19
  * ```html
20
- * <kendo-inlineaiprompt
21
- * placeholder="Enter your prompt..."
22
- * [promptOutput]="promptOutput"
23
- * (promptRequest)="onPromptRequest($event)">
24
- * </kendo-inlineaiprompt>
20
+ * <kendo-inlineaiprompt
21
+ * placeholder="Enter your prompt..."
22
+ * [promptOutput]="promptOutput"
23
+ * (promptRequest)="onPromptRequest($event)">
24
+ * </kendo-inlineaiprompt>
25
25
  * ```
26
26
  */
27
27
  export declare class InlineAIPromptComponent implements AfterViewInit, OnDestroy {
28
28
  private ngZone;
29
29
  element: ElementRef;
30
30
  /**
31
- * Sets the text of the TextArea.
31
+ * Sets the TextArea value.
32
+ *
33
+ * @default ""
32
34
  */
33
35
  promptValue: string;
34
36
  /**
@@ -47,8 +49,7 @@ export declare class InlineAIPromptComponent implements AfterViewInit, OnDestroy
47
49
  */
48
50
  enableSpeechToText: boolean | SpeechToTextButtonSettings;
49
51
  /**
50
- * Sets the streaming state of the component.
51
- * When set to `true`, the send button displays a generating state and the component emits a `promptRequestCancel` event when you click it.
52
+ * When set to `true`, the **Send** button displays a generating state and the component emits a `promptRequestCancel` event when you click it.
52
53
  *
53
54
  * @default false
54
55
  */
@@ -83,32 +84,33 @@ export declare class InlineAIPromptComponent implements AfterViewInit, OnDestroy
83
84
  */
84
85
  promptCommands: InlineAIPromptCommand[];
85
86
  /**
86
- * Sets the popup settings for the component.
87
+ * Sets the Popup settings.
88
+ *
87
89
  */
88
90
  set popupSettings(settings: InlineAIPromptPopupSettings);
89
91
  get popupSettings(): InlineAIPromptPopupSettings;
90
92
  /**
91
- * Fires when you click the send button.
93
+ * Fires when the send button is clicked.
92
94
  */
93
95
  promptRequest: EventEmitter<InlineAIPromptRequestEvent>;
94
96
  /**
95
- * Fires when you click a command.
97
+ * Fires when a command is executed.
96
98
  */
97
99
  commandExecute: EventEmitter<InlineAIPromptCommand>;
98
100
  /**
99
- * Fires when you click an output action button.
101
+ * Fires when an output action button is clicked.
100
102
  */
101
103
  outputActionClick: EventEmitter<InlineAIPromptOutputActionClickEvent>;
102
104
  /**
103
- * Fires when you cancel the prompt request by clicking the stop button.
105
+ * Fires when the stop button is clicked during streaming.
104
106
  */
105
107
  promptRequestCancel: EventEmitter<void>;
106
108
  /**
107
- * Fires when the component closes, either by clicking outside the popup, clicking the Discard action, or after pressing the Escape key.
109
+ * Fires when the component closes (Escape key, Discard action or outside click).
108
110
  */
109
111
  close: EventEmitter<void>;
110
112
  /**
111
- * Fires when the value of the TextArea changes.
113
+ * Fires when the TextArea value changes.
112
114
  */
113
115
  promptValueChange: EventEmitter<string>;
114
116
  popupElement: ElementRef;
@@ -125,7 +127,7 @@ export declare class InlineAIPromptComponent implements AfterViewInit, OnDestroy
125
127
  ngAfterViewInit(): void;
126
128
  ngOnDestroy(): void;
127
129
  /**
128
- * Focuses the TextArea of the Inline AI Prompt.
130
+ * Focus the TextArea.
129
131
  */
130
132
  focus(): void;
131
133
  /**
@@ -6,29 +6,36 @@ import { PopupService, PopupRef } from '@progress/kendo-angular-popup';
6
6
  import { InlineAIPromptSettings } from './models';
7
7
  import * as i0 from "@angular/core";
8
8
  /**
9
- * Provides a service for opening Inline AI Prompt components dynamically.
9
+ * Provides a service for opening and configuring the Inline AI Prompt component dynamically.
10
10
  *
11
11
  * @example
12
12
  * ```ts
13
- * import { InlineAIPromptService } from '@progress/kendo-angular-conversational-ui';
13
+ * export class DemoComponent {
14
+ * @ViewChild('anchor', { read: ElementRef }) anchor: ElementRef;
15
+ * constructor(private promptService: InlineAIPromptService) {}
14
16
  *
15
- * constructor(private inlineAIPromptService: InlineAIPromptService) {}
16
- *
17
- * openPrompt(anchor: ElementRef) {
18
- * const promptRef = this.inlineAIPromptService.open({
19
- * anchor: anchor,
20
- * placeholder: 'Enter your prompt...'
21
- * });
17
+ * open(): void {
18
+ * this.promptService.open({
19
+ * popupSettings: { anchor: this.anchor },
20
+ * placeholder: 'Enter your prompt...'
21
+ * });
22
+ * }
22
23
  * }
23
24
  * ```
25
+ * ```html
26
+ * <button #anchor (click)="open()">Ask AI</button>
27
+ * ```
24
28
  */
25
29
  export declare class InlineAIPromptService {
26
30
  private popupService;
31
+ /**
32
+ * @hidden
33
+ */
27
34
  constructor(popupService: PopupService);
28
35
  /**
29
36
  * Opens an Inline AI Prompt component in a popup. The popup appears near the specified anchor element or at the provided offset coordinates.
30
37
  *
31
- * @param {InlineAIPromptSettings} options - The options for the InlineAIPromptComponent.
38
+ * @param {InlineAIPromptSettings} options The options for the InlineAIPromptComponent.
32
39
  * @returns {PopupRef} A reference to the popup.
33
40
  */
34
41
  open(options: InlineAIPromptSettings): PopupRef;
@@ -6,9 +6,7 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
6
6
  import { Messages } from './messages';
7
7
  import * as i0 from "@angular/core";
8
8
  /**
9
- * Represents the custom messages component of the Inline AI Prompt.
10
- *
11
- * Use this component to override default messages for the Inline AI Prompt.
9
+ * Provides a component for customizing messages in the Inline AI Prompt. [See example](slug:globalization_chat#custom-messages).
12
10
  *
13
11
  * @example
14
12
  * ```html