igniteui-webcomponents 6.3.0-alpha.0 → 6.3.0-alpha.1

package/components/chat/chat-state.d.ts

@@ -1,7 +1,9 @@
+import { type Ref } from 'lit/directives/ref.js';
 import type IgcTextareaComponent from '../textarea/textarea.js';
 import type IgcChatComponent from './chat.js';
 import type { IgcChatComponentEventMap } from './chat.js';
-import type { IgcChatOptions, IgcMessage, IgcMessageAttachment } from './types.js';
+import { DefaultChatRenderer } from './chat-renderer.js';
+import { type IgcChatOptions, type IgcChatTemplates, type IgcMessage, type IgcMessageAttachment } from './types.js';
 /**
  * Internal state manager for the `<igc-chat>` component.
  *
@@ -13,8 +15,6 @@ export declare class ChatState {
     private _textArea;
     /** The current list of messages */
     private _messages;
-    /** Sorted copy of messages by timestamp */
-    private _sortedMessages;
     /** Chat options/configuration */
     private _options?;
     /** List of current input attachments */
@@ -25,18 +25,90 @@ export declare class ChatState {
      * Cache of accepted file types, organized into extensions, mimeTypes, and wildcardTypes
      */
     private _acceptedTypesCache;
+    /** Default position of the suggestions */
     private _suggestionsPosition;
-    /**
-     * Array of message IDs sorted by timestamp ascending.
-     */
-    get sortedMessagesIds(): string[];
+    /** Default time in milliseconds before dispatching stop typing event */
+    private _stopTypingDelay;
+    private _isTyping;
+    private _lastTyped;
+    private _fileIcon;
+    private _jsonIcon;
+    private _linkIcon;
+    private readonly _textAreaRef;
+    private readonly _attachmentsButtonInputRef;
+    private readonly _sharedTooltipRef;
+    private _chatRenderer?;
+    private resourceStrings;
+    /** Default templates of the chat components */
+    private _defaultTemplates;
+    /** The tooltip component used for showing action tooltips. */
+    private get _sharedTooltip();
+    private getIconName;
+    /**
+     * Default attachments area template used when no custom template is provided.
+     * Renders the list of input attachments as chips.
+     * @returns TemplateResult containing the attachments area
+     */
+    private renderDefaultAttachmentsArea;
+    /**
+     * Default text area template used when no custom template is provided.
+     * Renders a text area for user input.
+     * @returns TemplateResult containing the text area
+     */
+    private renderDefaultTextArea;
+    /**
+     * Default file upload button template used when no custom template is provided.
+     * Renders a file input for attaching files.
+     * @returns TemplateResult containing the file upload button
+     */
+    private renderDefaultFileUploadButton;
+    /**
+     * Default send button template used when no custom template is provided.
+     * Renders a send button that submits the current input value and attachments.
+     * @returns TemplateResult containing the send button
+     */
+    private renderDefaultSendButton;
+    private renderDefaultActionsArea;
+    /**
+     * Default typing indicator template used when no custom template is provided.
+     * Renders a simple typing indicator with three dots.
+     * @returns TemplateResult containing the typing indicator
+     */
+    private renderDefaultTypingIndicator;
+    /**
+     * Default message template used when no custom template is provided.
+     * Renders the message text, sanitized for security.
+     * @param message The chat message to render
+     * @returns TemplateResult containing the rendered message
+     */
+    private renderDefaultMessageTemplate;
+    private renderDefaultAttachmentHeaderText;
+    private handleHeaderClick;
+    /**
+     * Default attachment header template used when no custom template is provided.
+     * Renders the attachment icon and name.
+     * @param attachment The message attachment to render
+     * @returns TemplateResult containing the rendered attachment header
+     */
+    private renderDefaultAttachmentHeader;
+    /**
+     * Default attachment content template used when no custom template is provided.
+     * Renders the attachment content based on its type.
+     * @param attachment The message attachment to render
+     * @returns TemplateResult containing the rendered attachment content
+     */
+    private renderDefaultAttachmentContent;
+    private renderDefaultMessageActionsTemplate;
+    private handleMessageActionClick;
+    private renderDefaultAttachmentTemplate;
+    private renderDefaultAttachmentsTemplate;
+    private showTooltip;
     /**
      * Gets the list of chat messages.
      */
     get messages(): IgcMessage[];
     /**
      * Sets the list of chat messages.
-     * Also sorts messages by timestamp and requests host update.
      */
     set messages(value: IgcMessage[]);
     /**
@@ -55,6 +127,10 @@ export declare class ChatState {
      * Gets the current suggestionsPosition from options or returns the default value 'below-messages'.
      */
     get suggestionsPosition(): string;
+    /**
+     * Gets the current stopTypingDelay from options or returns the default value `3000`.
+     */
+    get stopTypingDelay(): number;
     /**
      * Gets the text area component.
      */
@@ -63,6 +139,10 @@ export declare class ChatState {
      * Sets the text area component.
      */
     set textArea(value: IgcTextareaComponent);
+    /**
+     * Gets the text area component.
+     */
+    get textAreaRef(): Ref<IgcTextareaComponent>;
     /**
      * Gets the list of attachments currently attached to input.
      */
@@ -79,6 +159,18 @@ export declare class ChatState {
      * Sets the current input value and requests host update.
      */
     set inputValue(value: string);
+    /** Returns all default templates applied in the chat component. */
+    get defaultTemplates(): Required<IgcChatTemplates>;
+    /** Sets the default templates applied in the chat component. */
+    set defaultTemplates(templates: Required<IgcChatTemplates>);
+    get mergedTemplates(): Required<IgcChatTemplates>;
+    get chatRenderer(): DefaultChatRenderer | undefined;
+    /**
+     * Handles input text changes.
+     * Updates internal inputValue and emits 'igcInputChange' event.
+     * @param e Input event from the text area
+     */
+    private handleInput;
     /**
      * Creates an instance of ChatState.
      * @param chat The host `<igc-chat>` component.
@@ -90,44 +182,47 @@ export declare class ChatState {
      * @param args Event detail or options
      * @returns true if event was not canceled, false otherwise
      */
-    emitEvent(name: keyof IgcChatComponentEventMap, args?: any): boolean;
-    /**
-     * Handles input text changes.
-     * Updates internal inputValue and emits 'igcInputChange' event.
-     * @param value New input value
-     */
-    handleInputChange(value: string): void;
+    emitEvent: (name: keyof IgcChatComponentEventMap, args?: any) => boolean;
     /**
      * Adds a new chat message.
      * Emits 'igcMessageCreated' event which can be canceled to prevent adding.
      * Clears input value and attachments on success.
      * @param message Partial message object with optional id, sender, timestamp
      */
-    addMessage(message: {
+    addMessage: (message: {
         id?: string;
         text: string;
         sender?: string;
         timestamp?: Date;
         attachments?: IgcMessageAttachment[];
-    }): void;
+    }) => void;
     /**
      * Adds files as attachments to the input.
      * Emits 'igcAttachmentChange' event which can be canceled to prevent adding.
      * @param files Array of File objects to attach
      */
     attachFiles(files: File[]): void;
+    private getURL;
+    private isImageAttachment;
+    private _fileIconMap;
+    private getFileExtension;
+    handleKeyDown: (e: KeyboardEvent) => void;
+    private handleFocus;
+    private handleBlur;
+    private sendMessage;
+    private handleFileUpload;
     /**
      * Removes an attachment by index.
      * Emits 'igcAttachmentChange' event which can be canceled to prevent removal.
      * @param index Index of the attachment to remove
      */
-    removeAttachment(index: number): void;
+    private removeAttachment;
     /**
      * Handles when a suggestion is clicked.
      * Adds the suggestion as a new message and focuses the text area.
      * @param suggestion The suggestion string clicked
      */
-    handleSuggestionClick(suggestion: string): void;
+    handleSuggestionClick: (suggestion: string) => void;
     /**
      * Updates the chat options partially.
      * @param options Partial options to merge with current options
@@ -137,14 +232,14 @@ export declare class ChatState {
      * Updates the internal cache for accepted file types.
      * Parses the acceptedFiles string option into extensions, mimeTypes, and wildcard types.
      */
-    updateAcceptedTypesCache(): void;
+    updateAcceptedTypesCache: () => void;
     /**
      * Checks if a file's type or extension is accepted by the chat's acceptedFiles setting.
      * @param file File object to check
      * @param type Optional MIME type override if no file provided
      * @returns True if accepted, false otherwise
      */
-    isFileTypeAccepted(file: File, type?: string): boolean;
+    isFileTypeAccepted: (file: File, type?: string) => boolean;
     /**
      * Checks if a slot is empty.
      * @param name Slot name to check