@cometchat/chat-uikit-angular 5.0.3 → 5.0.4

package/types/cometchat-chat-uikit-angular.d.ts

@@ -1,10 +1,11 @@
-import { Observable, Subject, Subscription } from 'rxjs';
+import { Observable, Subject, BehaviorSubject, Subscription } from 'rxjs';
 import * as _cometchat_chat_sdk_javascript from '@cometchat/chat-sdk-javascript';
 import { CometChatSettings, FlagReason } from '@cometchat/chat-sdk-javascript';
 import * as _angular_core from '@angular/core';
-import { PipeTransform, TemplateRef, Signal, OnDestroy, InjectionToken, WritableSignal, DestroyRef, EventEmitter as EventEmitter$1, AfterViewInit, QueryList, ElementRef, OnChanges, SimpleChanges, OnInit, ChangeDetectorRef, NgZone, DoCheck, Renderer2, ApplicationRef, EnvironmentInjector } from '@angular/core';
+import { PipeTransform, TemplateRef, Signal, OnDestroy, InjectionToken, WritableSignal, DestroyRef, EventEmitter as EventEmitter$1, AfterViewInit, QueryList, ElementRef, OnChanges, SimpleChanges, OnInit, ChangeDetectorRef, NgZone, DoCheck, Renderer2, ApplicationRef, EnvironmentInjector, Injector, EffectRef } from '@angular/core';
 import { Config } from 'dompurify';
 import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import { CometChatCardThemeMode, CometChatCardThemeOverride, CometChatCardActionEvent, CometChatCardAction } from '@cometchat/cards-angular';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -697,6 +698,7 @@ declare class CometChatUIKitConstants {
         call: string;
         interactive: string;
         agentic: _cometchat_chat_sdk_javascript.MessageCategory.AGENTIC;
+        card: "card";
     }>;
     static moderationStatus: Readonly<{
         pending: _cometchat_chat_sdk_javascript.ModerationStatus.PENDING;
@@ -721,6 +723,21 @@ declare class CometChatUIKitConstants {
         toolArguments: string;
         toolResults: string;
     }>;
+    static ExtensionTypes: Readonly<{
+        poll: "extension_poll";
+        sticker: "extension_sticker";
+        whiteboard: "extension_whiteboard";
+        document: "extension_document";
+    }>;
+    static ComposerAttachmentOption: Readonly<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        file: "file";
+        poll: "polls";
+        collaborativeDocument: "collaborative-document";
+        collaborativeWhiteboard: "collaborative-whiteboard";
+    }>;
     static groupMemberAction: Readonly<{
         ROLE: "role";
         BLOCK: "block";
@@ -749,7 +766,7 @@ declare class CometChatUIKitConstants {
         replyInThread: "replyInThread";
         translateMessage: "translate";
         reactToMessage: "react";
-        messageInformation: "messageInformation";
+        messageInformation: "info";
         flagMessage: "flagMessage";
         copyMessage: "copy";
         shareMessage: "share";
@@ -2438,6 +2455,55 @@ interface MessageUpdatePayload {
 
 declare var CometChatUIKitCalls: any;
 
+/**
+ * ConnectionStateService
+ *
+ * A single, root-level service that owns exactly ONE CometChat ConnectionListener
+ * for the entire application. All components and services that need to react to
+ * WebSocket connect/disconnect events should inject this service instead of
+ * registering their own listeners.
+ *
+ * Why one listener?
+ * - The SDK fires the same event to every registered listener simultaneously.
+ *   Having N listeners (one per list component) causes N parallel refetches on
+ *   reconnect, which is wasteful and can cause race conditions.
+ * - A single shared signal/observable lets any part of the UI (e.g. a
+ *   "reconnecting…" banner) read connection state without extra wiring.
+ *
+ * Usage in services:
+ * ```typescript
+ * private connectionState = inject(ConnectionStateService);
+ *
+ * constructor() {
+ *   this.connectionState.reconnected$
+ *     .pipe(takeUntilDestroyed(this.destroyRef))
+ *     .subscribe(() => this.refresh());
+ * }
+ * ```
+ *
+ * Usage in templates:
+ * ```html
+ * @if (connectionState.connected() === false) {
+ *   <div class="reconnecting-banner">Reconnecting…</div>
+ * }
+ * ```
+ */
+declare class ConnectionStateService {
+    private readonly _connected;
+    /** Current connection state as a read-only signal. */
+    readonly connected: _angular_core.Signal<boolean | null>;
+    /**
+     * Observable that emits `true` every time the WebSocket reconnects.
+     * Skips the initial `null → true` transition that happens at app startup
+     * (that is not a reconnect, it is the first connect).
+     */
+    readonly reconnected$: Observable<boolean>;
+    private readonly listenerId;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConnectionStateService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConnectionStateService>;
+}
+
 /**
  * ChatStateService
  *
@@ -2549,6 +2615,7 @@ declare class ChatStateService {
 declare class ConversationsService {
     private destroyRef;
     private ngZone;
+    private connectionState;
     private conversationsSignal;
     private loadingStateSignal;
     private errorStateSignal;
@@ -2568,6 +2635,8 @@ declare class ConversationsService {
     readonly hasConversations: _angular_core.Signal<boolean>;
     readonly isLoading: _angular_core.Signal<boolean>;
     readonly hasError: _angular_core.Signal<boolean>;
+    private hasMoreSignal;
+    readonly hasMore: _angular_core.Signal<boolean>;
     private conversationsRequest?;
     private requestBuilder?;
     private messageListenerId;
@@ -2575,6 +2644,8 @@ declare class ConversationsService {
     private groupListenerId;
     private callListenerId;
     private retryAttempts;
+    /** Guard: only re-fetch on reconnect after the first fetch has completed. */
+    private initialFetchDone;
     private ccMessageSentSubscription;
     private ccMessageDeletedSubscription;
     private callEventSubscriptions;
@@ -2585,7 +2656,7 @@ declare class ConversationsService {
     setConversationsRequestBuilder(builder: CometChat.ConversationsRequestBuilder): void;
     setActiveConversation(conversation: CometChat.Conversation | null): void;
     getConversations(): CometChat.Conversation[];
-    fetchConversations(builder?: CometChat.ConversationsRequestBuilder): Promise<void>;
+    fetchConversations(builder?: CometChat.ConversationsRequestBuilder, silent?: boolean): Promise<void>;
     fetchNextConversations(): Promise<boolean>;
     deleteConversation(conversationWith: string, conversationType: string): Promise<void>;
     searchConversations(searchText: string): void;
@@ -3074,7 +3145,7 @@ interface MentionSuggestion$1 {
  * Handles sending text/media messages, editing, typing indicators,
  * file upload progress, and mention suggestions.
  *
- * @Injectable providedIn: 'root'
+ * @Injectable — provided at component level via CometChatMessageComposerComponent providers
  * @see Requirements 29.1–29.10
  */
 declare class MessageComposerService {
@@ -3461,6 +3532,7 @@ declare class RichTextEditor {
     private ariaLiveRegion;
     private _pendingLinkClick;
     private lastSavedRange;
+    private autofocusTimer;
     private currentFormatState;
     constructor(config: RichTextEditorConfig, element?: HTMLElement);
     private createAriaLiveRegion;
@@ -3842,6 +3914,21 @@ declare class MessageListService {
     flagMessage(message: CometChat.BaseMessage, reasonId: string, remark?: string): Promise<void>;
 }
 
+/**
+ * Default message types fetched by the MessageList when no custom
+ * `messagesRequestBuilder` is supplied. Exported so consumers can derive their
+ * own type list (e.g. keep all defaults but drop a single extension):
+ *
+ *   const types = DEFAULT_MESSAGE_TYPES.filter(t => t !== 'extension_poll');
+ */
+declare const DEFAULT_MESSAGE_TYPES: readonly string[];
+/**
+ * Default message categories fetched by the MessageList when no custom
+ * `messagesRequestBuilder` is supplied. Includes the `action` category, which
+ * the MessageList omits at runtime when `hideGroupActionMessages` is set.
+ */
+declare const DEFAULT_MESSAGE_CATEGORIES: readonly string[];
+
 /**
  * Types for MessageBubbleConfigService.
  */
@@ -4657,7 +4744,12 @@ declare class GroupMembersService {
     private errorCallback;
     private userListenerId;
     private groupListenerId;
+    /** Guard: only re-fetch on reconnect after the first fetch has completed. */
+    private initialFetchDone;
+    private connectionState;
+    private destroyRef;
     private static readonly DEFAULT_LIMIT;
+    constructor();
     setErrorCallback(callback: GroupMembersErrorCallback | null): void;
     /**
      * Initialize the service with a group and optional custom request builder.
@@ -4687,6 +4779,12 @@ declare class GroupMembersService {
     attachListeners(groupGuid: string, hideUserStatus: boolean): void;
     detachListeners(): void;
     cleanup(): void;
+    /**
+     * Called by ConnectionStateService when the WebSocket reconnects.
+     * Silently re-fetches page 1 without clearing the list or showing shimmer.
+     * Resets hasMore to true so pagination works again from the new first page.
+     */
+    private handleReconnect;
     private handleError;
     private toCometchatException;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GroupMembersService, never>;
@@ -6396,6 +6494,62 @@ declare class SearchConversationsService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SearchConversationsService>;
 }
 
+interface NotificationUnreadCountOptions {
+    /** Filter count by category */
+    category?: string;
+    /** Polling interval in ms. Default: 30000 */
+    pollingInterval?: number;
+}
+/**
+ * NotificationUnreadCountService
+ *
+ * Injectable Angular service for consuming notification feed unread count.
+ * Provides real-time updates via BehaviorSubject, polling, and WebSocket listener.
+ *
+ * Angular equivalent of React's useNotificationUnreadCount hook.
+ *
+ * NOTE: When used alongside CometChatNotificationFeedComponent, both register
+ * separate NotificationFeedListeners. The ViewModel handles feed item insertion,
+ * while this service handles badge count. Both optimistically update on
+ * onFeedItemReceived — the badge may briefly over-count by 1 until the next
+ * polling re-fetch corrects it (within 1 second). This is by design to avoid
+ * tight coupling between the badge and the feed component.
+ *
+ * @Injectable providedIn: 'root'
+ */
+declare class NotificationUnreadCountService implements OnDestroy {
+    /** Current unread count */
+    readonly count$: BehaviorSubject<number>;
+    /** Whether the initial fetch is in progress */
+    readonly isLoading$: BehaviorSubject<boolean>;
+    private pollingInterval;
+    private listenerId;
+    private isFetching;
+    private isStarted;
+    private focusHandler;
+    /**
+     * Start tracking unread count.
+     * Fetches initial count, registers WebSocket listener, and starts polling.
+     */
+    start(options?: NotificationUnreadCountOptions): void;
+    /**
+     * Stop tracking unread count.
+     * Removes listener, clears polling, removes focus handler.
+     */
+    stop(): void;
+    /**
+     * Manually refresh the unread count.
+     */
+    refresh(): Promise<void>;
+    ngOnDestroy(): void;
+    private fetchCount;
+    private registerListener;
+    private removeListener;
+    private stopPolling;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotificationUnreadCountService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NotificationUnreadCountService>;
+}
+
 /**
  * Conversation event subjects for handling actions related to conversations (e.g., conversation deletion)
  */
@@ -6431,6 +6585,27 @@ interface IMessages {
     parentMessageId?: number | null;
 }
 
+/**
+ * Payload for the `ccCardActionClicked` event (Card Messages).
+ * `message` is the owning message — the `CardMessage` for a developer card or
+ * the `AIAssistantMessage` for a nested agent-card block. `action` is the raw
+ * renderer action object, forwarded untouched (the kit performs no behavior).
+ */
+interface ICardActionEvent {
+    /**
+     * The owning message — `CardMessage` (developer) or `AIAssistantMessage`
+     * (persisted agent card). `null` only for a card tapped while the agent run is
+     * still streaming (no persisted message exists yet; the persisted bubble that
+     * follows is the source of truth).
+     */
+    message: CometChat.BaseMessage | null;
+    /** The renderer's raw discriminated action (`CometChatCardAction`) — forwarded untouched. */
+    action: unknown;
+    /** The renderer element id that emitted the action (for `customCallback`). */
+    elementId?: string;
+    /** The raw card JSON the action originated from (for `customCallback`). */
+    cardJson?: string;
+}
 /**
  * Message event subjects for handling actions related to messages (e.g., message sent, edited, deleted, etc.)
  */
@@ -6446,6 +6621,12 @@ declare class CometChatMessageEvents {
      */
     static ccMessageRead: Subject<CometChat.BaseMessage>;
     static ccMessageDeleted: Subject<CometChat.BaseMessage>;
+    /**
+     * Emitted when a user taps an action on a card (developer card or nested
+     * agent-card block). Pure forward — the kit performs no behavior; the app
+     * subscribes once and runs the action.
+     */
+    static ccCardActionClicked: Subject<ICardActionEvent>;
     static onTextMessageReceived: Subject<CometChat.TextMessage>;
     static onMessageModerated: Subject<CometChat.BaseMessage>;
     static onMediaMessageReceived: Subject<CometChat.MediaMessage>;
@@ -6462,7 +6643,7 @@ declare class CometChatMessageEvents {
     static onMessageReactionRemoved: Subject<CometChat.ReactionEvent>;
     static onCustomInteractiveMessageReceived: Subject<CometChat.InteractiveMessage>;
     static onFormMessageReceived: Subject<CometChat.InteractiveMessage>;
-    static onCardMessageReceived: Subject<CometChat.InteractiveMessage>;
+    static onCardMessageReceived: Subject<CometChat.CardMessage>;
     static onSchedulerMessageReceived: Subject<CometChat.InteractiveMessage>;
     static onAIAssistantMessageReceived: Subject<CometChat.AIAssistantMessage>;
     static onAIToolResultReceived: Subject<CometChat.AIToolResultMessage>;
@@ -6491,7 +6672,7 @@ declare class CometChatMessageEvents {
     static publishMessageReactionRemoved(event: CometChat.ReactionEvent): void;
     static publishCustomInteractiveMessageReceived(message: CometChat.InteractiveMessage): void;
     static publishFormMessageReceived(message: CometChat.InteractiveMessage): void;
-    static publishCardMessageReceived(message: CometChat.InteractiveMessage): void;
+    static publishCardMessageReceived(message: CometChat.CardMessage): void;
     static publishSchedulerMessageReceived(message: CometChat.InteractiveMessage): void;
     static publishAIAssistantMessageReceived(message: CometChat.AIAssistantMessage): void;
     static publishAIToolResultReceived(message: CometChat.AIToolResultMessage): void;
@@ -6518,7 +6699,9 @@ declare class CometChatMessageEvents {
     static subscribeOnMessageReactionRemoved(cb: (data: CometChat.ReactionEvent) => void, destroyRef?: DestroyRef): Subscription;
     static subscribeOnCustomInteractiveMessageReceived(cb: (data: CometChat.InteractiveMessage) => void, destroyRef?: DestroyRef): Subscription;
     static subscribeOnFormMessageReceived(cb: (data: CometChat.InteractiveMessage) => void, destroyRef?: DestroyRef): Subscription;
-    static subscribeOnCardMessageReceived(cb: (data: CometChat.InteractiveMessage) => void, destroyRef?: DestroyRef): Subscription;
+    static subscribeOnCardMessageReceived(cb: (data: CometChat.CardMessage) => void, destroyRef?: DestroyRef): Subscription;
+    /** Subscribes to card-action clicks; auto-cleans up when destroyRef is given. */
+    static subscribeOnCardActionClicked(cb: (data: ICardActionEvent) => void, destroyRef?: DestroyRef): Subscription;
     static subscribeOnSchedulerMessageReceived(cb: (data: CometChat.InteractiveMessage) => void, destroyRef?: DestroyRef): Subscription;
     static subscribeOnAIAssistantMessageReceived(cb: (data: CometChat.AIAssistantMessage) => void, destroyRef?: DestroyRef): Subscription;
     static subscribeOnAIToolResultReceived(cb: (data: CometChat.AIToolResultMessage) => void, destroyRef?: DestroyRef): Subscription;
@@ -6904,6 +7087,10 @@ declare class CometChatAvatarComponent implements OnChanges {
     /**
      * Generates an accessible label for screen readers.
      * Describes the avatar content for assistive technologies.
+     *
+     * Falls back to a hardcoded template when the localization service has not
+     * been initialized (e.g., in unit tests) so that the aria-label always
+     * contains the name when one is provided.
      */
     get ariaLabel(): string;
     /**
@@ -7228,7 +7415,7 @@ interface LinkPopoverData {
  *
  * A small popover that appears when clicking on a link in the editor.
  * Shows "Edit" and "Remove" buttons for quick link actions.
- * Positioned absolutely relative to the parent composer element.
+ * Positioned above the clicked link using viewport coordinates.
  *
  * @component
  */
@@ -7243,9 +7430,9 @@ declare class CometChatLinkPopoverComponent implements OnInit, AfterViewInit, On
     url: string;
     /** The link text */
     text: string;
-    /** X coordinate (viewport-relative, i.e. clientX) */
+    /** X coordinate (viewport-relative center of the link element) */
     x: number;
-    /** Y coordinate (viewport-relative, i.e. clientY) */
+    /** Y coordinate (viewport-relative top of the link element) */
     y: number;
     /** Emitted when the Edit button is clicked */
     editClick: EventEmitter$1<LinkPopoverData>;
@@ -7271,18 +7458,25 @@ declare class CometChatLinkPopoverComponent implements OnInit, AfterViewInit, On
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     private handleKeydown;
+    /**
+     * Keeps Tab focus cycling within the popover (dialog focus trap), so the
+     * close button and URL link are reachable instead of Tab closing the popover.
+     */
+    private trapTabFocus;
     private focusNextItem;
     private focusPreviousItem;
     private restoreFocus;
     /**
-     * Position the popover centered horizontally, just above the composer.
-     * Uses estimated popover height for initial placement before layout.
-     * In Storybook docs mode, positions relative to the nearest
-     * [data-cometchat-container] ancestor instead of the full viewport.
+     * Initial position estimate using link x/y coordinates.
+     * Uses estimated dimensions before the popover has been laid out.
+     */
+    private positionAboveLink;
+    /**
+     * Fallback positioning: center above the composer element.
      */
     private positionAboveComposer;
     /**
-     * After layout, refine position using actual popover dimensions.
+     * Refine position after layout using actual popover dimensions.
      */
     private refinePosition;
     /**
@@ -7346,6 +7540,7 @@ declare class CometChatContextMenuComponent implements OnInit, OnDestroy, AfterV
     private boundHandleResize;
     handleKeydown(event: KeyboardEvent): void;
     private focusItemAtIndex;
+    private originalSubMenuParent;
     private closeSubMenu;
     get topMenu(): ContextMenuItem[];
     get subMenu(): ContextMenuItem[];
@@ -7984,6 +8179,7 @@ declare class CometChatConversationsComponent implements OnInit, OnDestroy {
     handleDeleteCancel(): void;
     handleDialogKeydown(event: KeyboardEvent): void;
     private setupSearchDebouncing;
+    onSearch(value: string): void;
     handleSearchBarClick(): void;
     handleKeydown(event: KeyboardEvent): void;
     private handleSelectionKeyboard;
@@ -8512,6 +8708,7 @@ declare class CometChatStickersKeyboardComponent implements OnInit, OnDestroy {
     setComponentState(state: ComponentState): void;
     /**
      * Fetches stickers from the CometChat stickers extension.
+     * Retries once if the first attempt fails (handles SDK not ready after page refresh).
      * @see Requirements 8.4, 8.14, 8.15
      */
     fetchStickers(): Promise<void>;
@@ -8583,6 +8780,14 @@ declare class CometChatStickersKeyboardComponent implements OnInit, OnDestroy {
     getRowIndex(index: number): number;
     /** Gets the 1-based column index for ARIA grid navigation */
     getColIndex(index: number): number;
+    /** Total number of grid rows for the current category (aria-rowcount). */
+    getRowCount(): number;
+    /** Roving tabindex for category tabs: only the focused tab is in tab order. */
+    getTabTabIndex(index: number): number;
+    /** Roving tabindex for sticker cells: focused cell (or first when none) is tabbable. */
+    getStickerTabIndex(index: number): number;
+    /** Keeps the roving anchor in sync when a sticker cell receives focus. */
+    onStickerFocus(index: number): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatStickersKeyboardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatStickersKeyboardComponent, "cometchat-stickers-keyboard", never, { "errorStateText": { "alias": "errorStateText"; "required": false; }; "emptyStateText": { "alias": "emptyStateText"; "required": false; }; "autoFocus": { "alias": "autoFocus"; "required": false; }; "trapFocus": { "alias": "trapFocus"; "required": false; }; }, { "stickerClick": "stickerClick"; "closeKeyboard": "closeKeyboard"; }, never, never, true, never>;
@@ -8810,10 +9015,15 @@ declare class CometChatMessageComposerComponent implements OnInit, OnDestroy, On
     maxHeight: number;
     enterKeyBehavior: EnterKeyBehavior;
     attachmentOptions?: CometChatMessageComposerAction[];
+    /** @note kept for future attachment preview/queue support; active flow sends selected files directly. */
     maxAttachments: number;
+    /** @note kept for future attachment preview/queue support; active flow sends selected files directly. */
     allowedFileTypes?: string[];
+    /** @note kept for future attachment preview/queue support; active flow sends selected files directly. */
     maxFileSize?: number;
+    /** @note kept for future attachment preview/queue support; active flow sends selected files directly. */
     showAttachmentPreview: boolean;
+    /** @note kept for future attachment preview/queue support; active flow sends selected files directly. */
     enableDragDrop: boolean;
     hideAttachmentButton: boolean;
     hideImageAttachmentOption: boolean;
@@ -8865,7 +9075,9 @@ declare class CometChatMessageComposerComponent implements OnInit, OnDestroy, On
     sendButtonClick: EventEmitter$1<_cometchat_chat_sdk_javascript.BaseMessage>;
     error: EventEmitter$1<_cometchat_chat_sdk_javascript.CometChatException>;
     closePreview: EventEmitter$1<void>;
+    /** @note currently retained for future use; the active file flow sends selected files directly. */
     attachmentAdded: EventEmitter$1<File>;
+    /** @note currently retained for future use; the active file flow sends selected files directly. */
     attachmentRemoved: EventEmitter$1<File>;
     mentionSelected: EventEmitter$1<_cometchat_chat_sdk_javascript.User | _cometchat_chat_sdk_javascript.GroupMember>;
     textInputRef?: ElementRef<HTMLTextAreaElement>;
@@ -9403,8 +9615,13 @@ type MessagePreviewMode = 'reply' | 'edit';
  * </cometchat-message-preview>
  * ```
  */
-declare class CometChatMessagePreviewComponent implements OnInit, AfterViewInit, OnDestroy {
+declare class CometChatMessagePreviewComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
     private globalConfig;
+    private readonly htmlSanitizer;
+    private readonly formatterConfig;
+    private readonly cdr;
+    _cachedPreviewHasHtml: boolean;
+    _cachedFormattedPreview: string;
     private textFormattersExplicitlySet;
     private _textFormatters;
     /** Title to display in preview - accepts template */
@@ -9491,6 +9708,24 @@ declare class CometChatMessagePreviewComponent implements OnInit, AfterViewInit,
      * @see Requirements 7.1, 7.3
      */
     get messageContentPreview(): string;
+    /**
+     * Returns true when the message preview text should be rendered as HTML
+     * (contains markdown, rich text metadata, or SDK mention tags).
+     */
+    get messagePreviewHasHtml(): boolean;
+    /**
+     * Returns sanitized HTML for the preview when messagePreviewHasHtml is true.
+     * Applies the same formatter pipeline as CometChatConversationItem.
+     * Result is single-line (block elements collapsed to spaces).
+     */
+    get formattedMessagePreview(): string;
+    /** Get active formatters — explicit input takes priority over global config defaults. */
+    private getActiveFormatters;
+    /**
+     * Sanitize HTML to safe inline tags, collapsing block elements to spaces
+     * so the preview stays on a single line with ellipsis truncation.
+     */
+    private sanitizePreviewHtml;
     /**
      * Returns the CSS class for the media type icon.
      * Used to display appropriate icons for media messages.
@@ -9512,6 +9747,7 @@ declare class CometChatMessagePreviewComponent implements OnInit, AfterViewInit,
      */
     get containerClass(): string;
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     private setupResizeObserver;
@@ -9616,6 +9852,40 @@ declare class CometChatTextBubbleComponent implements OnInit, OnChanges, AfterVi
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatTextBubbleComponent, "cometchat-text-bubble", never, { "message": { "alias": "message"; "required": true; }; "alignment": { "alias": "alignment"; "required": false; }; "textFormatters": { "alias": "textFormatters"; "required": false; }; "translatedTextOverride": { "alias": "translatedTextOverride"; "required": false; }; }, { "linkClick": "linkClick"; "mentionClick": "mentionClick"; }, never, never, true, never>;
 }
 
+/** Payload emitted by the bubble's `onCardAction` output. */
+interface CardBubbleAction {
+    message: CometChat.CardMessage;
+    action: unknown;
+}
+declare class CometChatCardBubbleComponent {
+    /** The developer card message to render. */
+    readonly message: _angular_core.InputSignal<_cometchat_chat_sdk_javascript.CardMessage>;
+    /** Theme mode passed straight to the renderer. */
+    themeMode: CometChatCardThemeMode;
+    /** Optional renderer theme overrides. */
+    themeOverride?: CometChatCardThemeOverride;
+    /** Pure-forward of the raw renderer action (developer-card prop channel). */
+    onCardAction: EventEmitter$1<CardBubbleAction>;
+    /** Stringified raw card payload (`''` when there is nothing drawable). */
+    protected readonly cardJson: _angular_core.Signal<string>;
+    /** Whether a non-empty card payload is present. */
+    protected readonly hasCard: _angular_core.Signal<boolean>;
+    /**
+     * Single-line fallback for the empty/invalid-payload case:
+     * `getFallbackText()` → `getText()` → "Card Message". Lazy — the template only
+     * reads it when `hasCard()` is false.
+     */
+    protected readonly fallbackText: _angular_core.Signal<string>;
+    /**
+     * Forwards the raw renderer action on BOTH channels. The bubble runs
+     * no behavior of its own. Apps should act on one channel only to avoid
+     * double-handling (a stable messageId is available for dedupe).
+     */
+    protected handleAction(event: CometChatCardActionEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatCardBubbleComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatCardBubbleComponent, "cometchat-card-bubble", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "themeMode": { "alias": "themeMode"; "required": false; }; "themeOverride": { "alias": "themeOverride"; "required": false; }; }, { "onCardAction": "onCardAction"; }, never, never, true, never>;
+}
+
 /**
  * CometChatImageBubbleComponent renders image messages with single/multi-image layouts,
  * overflow handling, fullscreen gallery, and keyboard accessibility.
@@ -10029,6 +10299,7 @@ declare class CometChatUsersComponent implements OnInit, OnDestroy {
     private isFirstFetch;
     private initialLoadComplete;
     private userListenerId;
+    constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
     private initializeUsersManager;
@@ -10036,7 +10307,6 @@ declare class CometChatUsersComponent implements OnInit, OnDestroy {
     private setupUserListener;
     private removeUserListener;
     private setupUserEventSubscriptions;
-    private setupConnectionListener;
     private updateUser;
     private refreshUserList;
     fetchNextAndAppendUsers(): void;
@@ -10185,12 +10455,12 @@ declare class CometChatGroupsComponent implements OnInit, OnDestroy {
     readonly States: typeof States;
     private searchSubject$;
     private isFirstFetch;
+    constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
     private initializeGroupsManager;
     private setupSearchDebouncing;
     private setupGroupListeners;
-    private setupConnectionListener;
     private setupGroupEventSubscriptions;
     private refreshGroupList;
     handleLoadMore(): void;
@@ -10507,6 +10777,7 @@ declare class CometChatGroupMemberItemComponent {
     effectiveHideUserStatus: _angular_core.Signal<boolean>;
     effectiveDisableDefaultContextMenu: _angular_core.Signal<boolean>;
     contextMenuOptions?: CometChatOption[];
+    contextMenuRef?: CometChatContextMenuComponent;
     leadingView?: TemplateRef<{
         $implicit: CometChat.GroupMember;
     }>;
@@ -10533,7 +10804,7 @@ declare class CometChatGroupMemberItemComponent {
     get scopeLabel(): string;
     get accessibleLabel(): string;
     handleMouseDown(event: MouseEvent): void;
-    handleClick(): void;
+    handleClick(event?: MouseEvent): void;
     onItemFocus(): void;
     onKeyDown(event: KeyboardEvent): void;
     handleContextMenuOpen(): void;
@@ -10663,6 +10934,7 @@ declare class CometChatGroupItemComponent {
         group: CometChat.Group;
     }>;
     itemFocus: EventEmitter$1<void>;
+    contextMenuRef?: CometChatContextMenuComponent;
     readonly Placement: typeof Placement;
     get groupIcon(): string;
     get groupName(): string;
@@ -11782,6 +12054,7 @@ declare class CometChatMessageListComponent implements OnInit, OnDestroy, OnChan
     group?: CometChat.Group;
     parentMessageId?: number;
     isAgentChat: boolean;
+    loadLastAgentConversation: boolean;
     messagesRequestBuilder?: CometChat.MessagesRequestBuilder;
     reactionsRequestBuilder?: CometChat.ReactionsRequestBuilder;
     set textFormatters(value: CometChatTextFormatter[]);
@@ -12045,6 +12318,10 @@ declare class CometChatMessageListComponent implements OnInit, OnDestroy, OnChan
     private safeEmitUnreadCountChange;
     private shouldShowSmartRepliesForMessage;
     handleRetryClick(): void;
+    /** Adds a message to the list (used by parent components for temporary messages). */
+    addMessage(message: CometChat.BaseMessage): void;
+    /** Removes a message from the list by ID (used by parent components to remove temporary messages). */
+    removeMessage(messageId: number): void;
     onUserTyping(): void;
     onMessageSent(): void;
     onSmartReplyClick(reply: string): void;
@@ -12095,8 +12372,9 @@ declare class CometChatMessageListComponent implements OnInit, OnDestroy, OnChan
     trackByItem(_index: number, item: MessageListItem): string;
     trackByMessage(_index: number, message: CometChat.BaseMessage): string | number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatMessageListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatMessageListComponent, "cometchat-message-list", never, { "user": { "alias": "user"; "required": false; }; "group": { "alias": "group"; "required": false; }; "parentMessageId": { "alias": "parentMessageId"; "required": false; }; "isAgentChat": { "alias": "isAgentChat"; "required": false; }; "messagesRequestBuilder": { "alias": "messagesRequestBuilder"; "required": false; }; "reactionsRequestBuilder": { "alias": "reactionsRequestBuilder"; "required": false; }; "textFormatters": { "alias": "textFormatters"; "required": false; }; "messageAlignment": { "alias": "messageAlignment"; "required": false; }; "scrollToBottomOnNewMessages": { "alias": "scrollToBottomOnNewMessages"; "required": false; }; "quickOptionsCount": { "alias": "quickOptionsCount"; "required": false; }; "disableSoundForMessages": { "alias": "disableSoundForMessages"; "required": false; }; "customSoundForMessages": { "alias": "customSoundForMessages"; "required": false; }; "goToMessageId": { "alias": "goToMessageId"; "required": false; }; "showScrollbar": { "alias": "showScrollbar"; "required": false; }; "hideReceipts": { "alias": "hideReceipts"; "required": false; }; "hideDateSeparator": { "alias": "hideDateSeparator"; "required": false; }; "hideStickyDate": { "alias": "hideStickyDate"; "required": false; }; "hideAvatar": { "alias": "hideAvatar"; "required": false; }; "hideGroupActionMessages": { "alias": "hideGroupActionMessages"; "required": false; }; "hideError": { "alias": "hideError"; "required": false; }; "hideReplyInThreadOption": { "alias": "hideReplyInThreadOption"; "required": false; }; "hideTranslateMessageOption": { "alias": "hideTranslateMessageOption"; "required": false; }; "hideEditMessageOption": { "alias": "hideEditMessageOption"; "required": false; }; "hideDeleteMessageOption": { "alias": "hideDeleteMessageOption"; "required": false; }; "hideReactionOption": { "alias": "hideReactionOption"; "required": false; }; "hideMessagePrivatelyOption": { "alias": "hideMessagePrivatelyOption"; "required": false; }; "hideCopyMessageOption": { "alias": "hideCopyMessageOption"; "required": false; }; "hideMessageInfoOption": { "alias": "hideMessageInfoOption"; "required": false; }; "additionalOptions": { "alias": "additionalOptions"; "required": false; }; "optionsOverride": { "alias": "optionsOverride"; "required": false; }; "hideModerationView": { "alias": "hideModerationView"; "required": false; }; "hideFlagRemarkField": { "alias": "hideFlagRemarkField"; "required": false; }; "hideFlagMessageOption": { "alias": "hideFlagMessageOption"; "required": false; }; "showMarkAsUnreadOption": { "alias": "showMarkAsUnreadOption"; "required": false; }; "startFromUnreadMessages": { "alias": "startFromUnreadMessages"; "required": false; }; "hideReplyOption": { "alias": "hideReplyOption"; "required": false; }; "disableInteraction": { "alias": "disableInteraction"; "required": false; }; "emptyView": { "alias": "emptyView"; "required": false; }; "errorView": { "alias": "errorView"; "required": false; }; "loadingView": { "alias": "loadingView"; "required": false; }; "headerView": { "alias": "headerView"; "required": false; }; "footerView": { "alias": "footerView"; "required": false; }; "hideTimestamp": { "alias": "hideTimestamp"; "required": false; }; "bubbleFooterView": { "alias": "bubbleFooterView"; "required": false; }; "appendView": { "alias": "appendView"; "required": false; }; "listItemTemplate": { "alias": "listItemTemplate"; "required": false; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; }; "errorStateTemplate": { "alias": "errorStateTemplate"; "required": false; }; "loadingStateTemplate": { "alias": "loadingStateTemplate"; "required": false; }; "separatorDateTimeFormat": { "alias": "separatorDateTimeFormat"; "required": false; }; "stickyDateTimeFormat": { "alias": "stickyDateTimeFormat"; "required": false; }; "messageSentAtDateTimeFormat": { "alias": "messageSentAtDateTimeFormat"; "required": false; }; "messageInfoDateTimeFormat": { "alias": "messageInfoDateTimeFormat"; "required": false; }; "showConversationStarters": { "alias": "showConversationStarters"; "required": false; }; "showSmartReplies": { "alias": "showSmartReplies"; "required": false; }; "smartRepliesKeywords": { "alias": "smartRepliesKeywords"; "required": false; }; "smartRepliesDelayDuration": { "alias": "smartRepliesDelayDuration"; "required": false; }; }, { "error": "error"; "threadRepliesClick": "threadRepliesClick"; "reactionClick": "reactionClick"; "reactionListItemClick": "reactionListItemClick"; "smartReplyClick": "smartReplyClick"; "conversationStarterClick": "conversationStarterClick"; "messagePrivatelyClick": "messagePrivatelyClick"; "replyClick": "replyClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatMessageListComponent, "cometchat-message-list", never, { "user": { "alias": "user"; "required": false; }; "group": { "alias": "group"; "required": false; }; "parentMessageId": { "alias": "parentMessageId"; "required": false; }; "isAgentChat": { "alias": "isAgentChat"; "required": false; }; "loadLastAgentConversation": { "alias": "loadLastAgentConversation"; "required": false; }; "messagesRequestBuilder": { "alias": "messagesRequestBuilder"; "required": false; }; "reactionsRequestBuilder": { "alias": "reactionsRequestBuilder"; "required": false; }; "textFormatters": { "alias": "textFormatters"; "required": false; }; "messageAlignment": { "alias": "messageAlignment"; "required": false; }; "scrollToBottomOnNewMessages": { "alias": "scrollToBottomOnNewMessages"; "required": false; }; "quickOptionsCount": { "alias": "quickOptionsCount"; "required": false; }; "disableSoundForMessages": { "alias": "disableSoundForMessages"; "required": false; }; "customSoundForMessages": { "alias": "customSoundForMessages"; "required": false; }; "goToMessageId": { "alias": "goToMessageId"; "required": false; }; "showScrollbar": { "alias": "showScrollbar"; "required": false; }; "hideReceipts": { "alias": "hideReceipts"; "required": false; }; "hideDateSeparator": { "alias": "hideDateSeparator"; "required": false; }; "hideStickyDate": { "alias": "hideStickyDate"; "required": false; }; "hideAvatar": { "alias": "hideAvatar"; "required": false; }; "hideGroupActionMessages": { "alias": "hideGroupActionMessages"; "required": false; }; "hideError": { "alias": "hideError"; "required": false; }; "hideReplyInThreadOption": { "alias": "hideReplyInThreadOption"; "required": false; }; "hideTranslateMessageOption": { "alias": "hideTranslateMessageOption"; "required": false; }; "hideEditMessageOption": { "alias": "hideEditMessageOption"; "required": false; }; "hideDeleteMessageOption": { "alias": "hideDeleteMessageOption"; "required": false; }; "hideReactionOption": { "alias": "hideReactionOption"; "required": false; }; "hideMessagePrivatelyOption": { "alias": "hideMessagePrivatelyOption"; "required": false; }; "hideCopyMessageOption": { "alias": "hideCopyMessageOption"; "required": false; }; "hideMessageInfoOption": { "alias": "hideMessageInfoOption"; "required": false; }; "additionalOptions": { "alias": "additionalOptions"; "required": false; }; "optionsOverride": { "alias": "optionsOverride"; "required": false; }; "hideModerationView": { "alias": "hideModerationView"; "required": false; }; "hideFlagRemarkField": { "alias": "hideFlagRemarkField"; "required": false; }; "hideFlagMessageOption": { "alias": "hideFlagMessageOption"; "required": false; }; "showMarkAsUnreadOption": { "alias": "showMarkAsUnreadOption"; "required": false; }; "startFromUnreadMessages": { "alias": "startFromUnreadMessages"; "required": false; }; "hideReplyOption": { "alias": "hideReplyOption"; "required": false; }; "disableInteraction": { "alias": "disableInteraction"; "required": false; }; "emptyView": { "alias": "emptyView"; "required": false; }; "errorView": { "alias": "errorView"; "required": false; }; "loadingView": { "alias": "loadingView"; "required": false; }; "headerView": { "alias": "headerView"; "required": false; }; "footerView": { "alias": "footerView"; "required": false; }; "hideTimestamp": { "alias": "hideTimestamp"; "required": false; }; "bubbleFooterView": { "alias": "bubbleFooterView"; "required": false; }; "appendView": { "alias": "appendView"; "required": false; }; "listItemTemplate": { "alias": "listItemTemplate"; "required": false; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; }; "errorStateTemplate": { "alias": "errorStateTemplate"; "required": false; }; "loadingStateTemplate": { "alias": "loadingStateTemplate"; "required": false; }; "separatorDateTimeFormat": { "alias": "separatorDateTimeFormat"; "required": false; }; "stickyDateTimeFormat": { "alias": "stickyDateTimeFormat"; "required": false; }; "messageSentAtDateTimeFormat": { "alias": "messageSentAtDateTimeFormat"; "required": false; }; "messageInfoDateTimeFormat": { "alias": "messageInfoDateTimeFormat"; "required": false; }; "showConversationStarters": { "alias": "showConversationStarters"; "required": false; }; "showSmartReplies": { "alias": "showSmartReplies"; "required": false; }; "smartRepliesKeywords": { "alias": "smartRepliesKeywords"; "required": false; }; "smartRepliesDelayDuration": { "alias": "smartRepliesDelayDuration"; "required": false; }; }, { "error": "error"; "threadRepliesClick": "threadRepliesClick"; "reactionClick": "reactionClick"; "reactionListItemClick": "reactionListItemClick"; "smartReplyClick": "smartReplyClick"; "conversationStarterClick": "conversationStarterClick"; "messagePrivatelyClick": "messagePrivatelyClick"; "replyClick": "replyClick"; }, never, never, true, never>;
     static ngAcceptInputType_isAgentChat: unknown;
+    static ngAcceptInputType_loadLastAgentConversation: unknown;
     static ngAcceptInputType_scrollToBottomOnNewMessages: unknown;
     static ngAcceptInputType_disableSoundForMessages: unknown;
     static ngAcceptInputType_showScrollbar: unknown;
@@ -12924,7 +13202,7 @@ declare class CometChatReactionInfoComponent implements OnInit, OnChanges {
     /**
      * Current component state: loading, loaded, or error.
      */
-    state: _angular_core.WritableSignal<"error" | "loading" | "loaded">;
+    state: _angular_core.WritableSignal<"loading" | "error" | "loaded">;
     /**
      * Formatted names of users who reacted.
      */
@@ -14237,7 +14515,7 @@ declare class CometChatConversationSummaryComponent implements OnInit {
  * 15.  Paragraphs
  * 16.  GFM tables  | col | col |
  */
-type MarkdownNodeType = 'heading' | 'paragraph' | 'bold' | 'italic' | 'strikethrough' | 'inlineCode' | 'codeBlock' | 'blockquote' | 'orderedList' | 'unorderedList' | 'listItem' | 'link' | 'image' | 'hr' | 'lineBreak' | 'table' | 'text';
+type MarkdownNodeType = 'heading' | 'paragraph' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'inlineCode' | 'codeBlock' | 'blockquote' | 'orderedList' | 'unorderedList' | 'listItem' | 'link' | 'image' | 'hr' | 'lineBreak' | 'table' | 'text';
 interface MarkdownNode {
     type: MarkdownNodeType;
     content?: string;
@@ -14249,6 +14527,7 @@ interface MarkdownNode {
     rows?: string[][];
     headers?: string[];
 }
+declare function parseInline(text: string): MarkdownNode[];
 declare class CometChatMarkdownParser {
     parse(text: string, streaming?: boolean): MarkdownNode[];
 }
@@ -14278,6 +14557,19 @@ declare class CometChatMarkdownRenderer {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatMarkdownRenderer, "cometchat-markdown-renderer", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; }, { "imageClick": "imageClick"; }, never, never, true, never>;
 }
 
+/**
+ * A normalized content block derived from one `AIAssistantElement`.
+ * `text` blocks carry the assistant prose; `card` blocks carry the stringified raw
+ * card payload (or a fallback string when the payload is empty/invalid).
+ */
+type AIAssistantContentBlock = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'card';
+    cardJson: string;
+    fallback: string;
+};
 /**
  * CometChatAIAssistantMessageBubble renders a completed AI assistant message
  * with rich markdown formatting via CometChatMarkdownRenderer.
@@ -14291,7 +14583,14 @@ declare class CometChatAIAssistantMessageBubble {
     readonly message: _angular_core.InputSignal<_cometchat_chat_sdk_javascript.AIAssistantMessage>;
     /** Derived text from the message data — re-computes only when message() changes. */
     readonly messageText: _angular_core.Signal<string>;
-    /** Current color scheme, updated via window.matchMedia listener. */
+    /**
+     * Ordered content blocks from `getElements()`, or `null`
+     * when the message has no elements (older messages) — in which case the
+     * template falls back to the existing `getText()` markdown render. The
+     * `agentic/assistant` routing is unchanged; only this content view differs.
+     */
+    readonly blocks: _angular_core.Signal<AIAssistantContentBlock[] | null>;
+    /** Current color scheme, updated via window.matchMedia listener. Also handed to nested card renderers as the theme mode. */
     readonly colorScheme: _angular_core.WritableSignal<"light" | "dark">;
     /** Template ref for the image fullscreen viewer dialog. */
     imageViewerTpl: TemplateRef<unknown>;
@@ -14303,10 +14602,28 @@ declare class CometChatAIAssistantMessageBubble {
      * Opens the image in a dialog via CometChatUIEvents.ccShowDialog.
      */
     onImageClick(url: string): void;
+    /**
+     * Pure-forward of a nested agent-card action. This bubble is
+     * kit-instantiated, so no `(onCardAction)` prop reaches the app — the action is
+     * emitted on the global event bus only, carrying the owning AIAssistantMessage.
+     */
+    onCardAction(event: CometChatCardActionEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatAIAssistantMessageBubble, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatAIAssistantMessageBubble, "cometchat-ai-assistant-message-bubble", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * A card streamed live inside the AI bubble. Keyed by `cardId`
+ * so the `card_start` loader is replaced in place by the `card` payload.
+ */
+interface StreamedCard {
+    cardId: string;
+    status: 'loading' | 'ready';
+    /** Loader label from card_start (executionText), shown while status === 'loading'. */
+    label: string;
+    /** Stringified raw card payload, set on the `card` event. */
+    cardJson: string;
+}
 /**
  * CometChatStreamMessageBubble renders a live-streaming AI response.
  *
@@ -14327,9 +14644,19 @@ declare class CometChatStreamMessageBubble implements OnInit {
     readonly hasError: _angular_core.WritableSignal<boolean>;
     readonly streamedText: _angular_core.WritableSignal<string>;
     readonly toolExecutionText: _angular_core.WritableSignal<string>;
+    /** Cards streamed in this run (loader → rendered), in arrival order. */
+    readonly streamedCards: _angular_core.WritableSignal<StreamedCard[]>;
     readonly hasStreamedContent: _angular_core.Signal<boolean>;
     ngOnInit(): void;
     private _subscribeToStream;
+    /**
+     * Pure-forward of a streamed-card action. No persisted message
+     * exists yet, so the event carries `message: null`; the persisted bubble that
+     * follows is the source of truth.
+     */
+    protected onCardAction(event: CometChatCardActionEvent): void;
+    /** Inserts a new streamed card or updates the existing one (matched by cardId). */
+    private _upsertCard;
     private _registerOfflineListener;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatStreamMessageBubble, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatStreamMessageBubble, "cometchat-stream-message-bubble", never, { "chatId": { "alias": "chatId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -14387,6 +14714,7 @@ declare class CometChatToolCallResultBubble {
  */
 declare class CometChatAIAssistantChatHistory implements OnInit {
     private readonly destroyRef;
+    private readonly hostRef;
     readonly shimmerList: readonly number[];
     readonly user: _angular_core.InputSignal<_cometchat_chat_sdk_javascript.User | undefined>;
     readonly group: _angular_core.InputSignal<_cometchat_chat_sdk_javascript.Group | undefined>;
@@ -14437,6 +14765,11 @@ declare class CometChatAIAssistantChatHistory implements OnInit {
     /** Emits newChatClick with null. */
     onNewChatClick(): void;
     onKeyDown(event: KeyboardEvent, index: number): void;
+    /**
+     * Updates the roving tabindex anchor and moves DOM focus to that option, so
+     * arrow-key navigation actually moves keyboard focus (not just the tabindex).
+     */
+    private moveFocusTo;
     /** Returns tabindex for a given list item index. */
     getTabIndex(index: number): number;
     formatDate(timestampSeconds: number): string;
@@ -14455,9 +14788,10 @@ declare class CometChatAIAssistantChatHistory implements OnInit {
  * Requirements: 10.1–10.18, 11.1, 12.1, 12.3–12.5, 12.7, 13.1, 13.3, 13.4, 13.7,
  *               13.10, 13.12, 13.13, 16.1
  */
-declare class CometChatAIAssistantChat implements OnInit {
+declare class CometChatAIAssistantChat implements OnInit, AfterViewInit, OnDestroy {
     readonly streamingService: CometChatAIStreamingService;
     private readonly destroyRef;
+    private readonly bubbleConfigService;
     readonly user: _angular_core.InputSignal<_cometchat_chat_sdk_javascript.User>;
     readonly streamingSpeed: _angular_core.InputSignal<number>;
     readonly aiAssistantTools: _angular_core.InputSignal<CometChatAIAssistantTools | undefined>;
@@ -14486,9 +14820,21 @@ declare class CometChatAIAssistantChat implements OnInit {
     readonly sidebarTriggerEl: _angular_core.WritableSignal<HTMLElement | null>;
     readonly hasComposerText: _angular_core.WritableSignal<boolean>;
     readonly activeRunId: _angular_core.WritableSignal<string | null>;
+    /**
+     * Local mutable copy of loadLastAgentConversation. Set to false after the
+     * first load resolves or when "New Chat" is clicked — prevents the message
+     * list from staying in shimmer state forever.
+     */
+    readonly loadLastAgentConversationState: _angular_core.WritableSignal<boolean>;
+    /** Sentinel message ID used for the temporary streaming placeholder message. */
+    private readonly STREAMING_MESSAGE_ID;
+    /** The currently logged-in user (used in templates for sender checks). */
+    readonly loggedInUser: _angular_core.WritableSignal<_cometchat_chat_sdk_javascript.User | null>;
     sidebarContainerRef?: ElementRef<HTMLElement>;
     agentBubbleFooter?: TemplateRef<any>;
+    streamBubbleViewTpl?: TemplateRef<any>;
     composerRef?: CometChatMessageComposerComponent;
+    messageListRef?: CometChatMessageListComponent;
     /** True while the AI is streaming a response for this user. */
     readonly isStreaming: _angular_core.WritableSignal<boolean>;
     /** Suggestion pills: prefer explicit input, fall back to user metadata. */
@@ -14511,6 +14857,8 @@ declare class CometChatAIAssistantChat implements OnInit {
     }>;
     constructor();
     ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     /** Handle back button click — emits backClick output. */
     onBackClick(): void;
     /** Start a new chat: reset state, stop streaming, bump key. */
@@ -14537,7 +14885,8 @@ declare class CometChatAIAssistantChat implements OnInit {
     handleRetryClick(): void;
     /**
      * Subscribe to the streaming state observable for this user and keep
-     * the isStreaming signal in sync.
+     * the isStreaming signal in sync. When streaming stops, remove the
+     * temporary placeholder message from the list.
      */
     private _subscribeToStreamingState;
     /**
@@ -14551,6 +14900,15 @@ declare class CometChatAIAssistantChat implements OnInit {
      * so the stream bubble disappears and only the final message shows.
      */
     private _subscribeToAIMessageReceived;
+    /**
+     * Adds a temporary placeholder message to the message list that triggers
+     * the streaming bubble view via MessageBubbleConfigService.
+     */
+    private _addStreamingMessage;
+    /**
+     * Removes the temporary streaming placeholder message from the message list.
+     */
+    private _removeStreamingMessage;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatAIAssistantChat, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatAIAssistantChat, "cometchat-ai-assistant-chat", never, { "user": { "alias": "user"; "required": true; "isSignal": true; }; "streamingSpeed": { "alias": "streamingSpeed"; "required": false; "isSignal": true; }; "aiAssistantTools": { "alias": "aiAssistantTools"; "required": false; "isSignal": true; }; "loadLastAgentConversation": { "alias": "loadLastAgentConversation"; "required": false; "isSignal": true; }; "showSuggestedMessages": { "alias": "showSuggestedMessages"; "required": false; "isSignal": true; }; "suggestedMessages": { "alias": "suggestedMessages"; "required": false; "isSignal": true; }; "showBackButton": { "alias": "showBackButton"; "required": false; "isSignal": true; }; "greetingTemplate": { "alias": "greetingTemplate"; "required": false; "isSignal": true; }; }, { "backClick": "backClick"; }, never, never, true, never>;
 }
@@ -14818,6 +15176,8 @@ declare class CometChatSearchMessagesListComponent implements OnInit, OnChanges,
         toolArguments: string;
         toolResults: string;
     }>;
+    private readonly htmlSanitizer;
+    private readonly formatterConfig;
     private loggedInUser;
     constructor();
     /** Whether the paginated list is in loading state (initial load only) */
@@ -14837,6 +15197,23 @@ declare class CometChatSearchMessagesListComponent implements OnInit, OnChanges,
     getMessageTitle(message: CometChat.BaseMessage): string;
     shouldShowDateSeparator(index: number): boolean;
     getMessageSubtitle(message: CometChat.BaseMessage): string;
+    /**
+     * Returns true when the subtitle for a text message should be rendered as HTML
+     * (i.e. it contains markdown, rich text metadata, or SDK mention tags).
+     * Mirrors CometChatConversationItem.subtitleHasHtml.
+     */
+    subtitleHasHtml(message: CometChat.BaseMessage): boolean;
+    /**
+     * Returns sanitized HTML for the subtitle when subtitleHasHtml() is true.
+     * Mirrors CometChatConversationItem.formatLastMessageSubtitle.
+     */
+    getMessageSubtitleHtml(message: CometChat.BaseMessage): string;
+    /** Prepend "You: " or "SenderName: " as plain text before the HTML subtitle. */
+    private prependSenderHtml;
+    /** Get the active text formatters — explicit input takes priority over global config. */
+    private getFormattersForSubtitle;
+    /** Sanitize HTML to safe inline tags only for search subtitle — single line, truncated. */
+    private sanitizeSubtitleHtml;
     /**
      * Convert SDK mention tags into plain-text `@DisplayName`.
      * Falls back to the UID when a mentioned user is not hydrated on the message.
@@ -14907,5 +15284,469 @@ declare function hasValidSearchCriteria(keyword: string, filters: CometChatSearc
  */
 declare function hasValidMessageSearchCriteria(keyword: string, filters: CometChatSearchFilter[], uid?: string, guid?: string): boolean;
 
-export { AuxiliaryButtonAlignment, ButtonAction, COMETCHAT_GLOBAL_CONFIG, CalendarDatePipe, CallAnnouncerService, CallButtonsService, CallLogsService, CallWorkflow, ChatStateService, CometChatAIAssistantChat, CometChatAIAssistantChatHistory, CometChatAIAssistantMessageBubble, CometChatAIAssistantTools, CometChatAIStreamingService, CometChatActionBubbleComponent, CometChatActionSheetComponent, CometChatActions, CometChatActionsIcon, CometChatActionsView, CometChatAudioBubbleComponent, CometChatAvatarComponent, CometChatButtonComponent, CometChatCallBubbleComponent, CometChatCallButtonsComponent, CometChatCallEvents, CometChatCallLogsComponent, CometChatChangeScopeComponent, CometChatCheckboxComponent, CometChatCollaborativeDocumentBubbleComponent, CometChatCollaborativeWhiteboardBubbleComponent, CometChatConfirmDialogComponent, CometChatContextMenuComponent, CometChatConversationEvents, CometChatConversationItemComponent, CometChatConversationStarterComponent, CometChatConversationSummaryComponent, CometChatConversationsComponent, CometChatCreatePollComponent, CometChatDateComponent, CometChatDeleteBubbleComponent, CometChatDropDownComponent, CometChatEmojiFormatter, CometChatEmojiKeyboardComponent, CometChatErrorBoundaryComponent, CometChatFileBubbleComponent, CometChatFlagMessageDialogComponent, CometChatFullScreenViewerComponent, CometChatGroupEvents, CometChatGroupItemComponent, CometChatGroupMemberItemComponent, CometChatGroupMembersComponent, CometChatGroupsComponent, CometChatImageBubbleComponent, CometChatIncomingCallComponent, CometChatLinkDialogComponent, CometChatLinkPopoverComponent, CometChatListItemComponent, CometChatLocalize, CometChatLogger, CometChatMarkdownFormatter, CometChatMarkdownParser, CometChatMarkdownRenderer, CometChatMediaRecorderComponent, CometChatMentionsFormatter, CometChatMessageBubbleComponent, CometChatMessageComposerAction, CometChatMessageComposerComponent, CometChatMessageEvents, CometChatMessageHeaderComponent, CometChatMessageInformationComponent, CometChatMessageListComponent, CometChatMessagePreviewComponent, CometChatOngoingCallComponent, CometChatOption, CometChatOutgoingCallComponent, CometChatPaginatedListComponent, CometChatPollBubbleComponent, CometChatPopoverComponent, CometChatRadioButtonComponent, CometChatReactionInfoComponent, CometChatReactionListComponent, CometChatReactionsComponent, CometChatSearchBarComponent, CometChatSearchComponent, CometChatSearchConversationsListComponent, CometChatSearchFilter, CometChatSearchMessagesListComponent, CometChatSearchScope, CometChatSmartRepliesComponent, CometChatStickerBubbleComponent, CometChatStickersKeyboardComponent, CometChatStreamMessageBubble, CometChatTemplatesService, CometChatTextBubbleComponent, CometChatTextFormatter, CometChatThreadHeaderComponent, CometChatThreadViewComponent, CometChatToastComponent, CometChatToastService, CometChatToolCallArgumentBubble, CometChatToolCallResultBubble, CometChatTypingIndicatorComponent, CometChatUIEvents, CometChatUIKit, CometChatUIKitCalls, CometChatUIKitConstants, CometChatUrlFormatter, CometChatUserEvents, CometChatUserItemComponent, CometChatUsersComponent, CometChatVideoBubbleComponent, ConversationDatePipe, ConversationSubtitleService, ConversationsService, DateTimePickerMode, DialogFocusManager, DocumentIconAlignment, ElementType, EnterKeyBehavior, FocusTrapService, FormatterConfigService, GridNavigationService, GroupMembersService, HTTPSRequestMethods, HtmlSanitizerService, IconButtonAlignment, IncomingCallService, LabelAlignment, ListNavigationService, ListSelectionManager, LiveAnnouncerService, LogLevel, MENTIONS_LIMIT, MediaControlsService, MentionType, MentionsNavigationService, MentionsTargetElement, MentionsVisibility, MessageBubbleAlignment, MessageBubbleConfigService, MessageComposerService, MessageDatePipe, MessageHeaderService, MessageListAlignment, MessageListService, MessageStatus, MessageUtilsService, MouseEventSource, OngoingCallService, OutgoingCallService, PanelAlignment, Placement, PreviewMessageMode, Receipts, RecordingType, RichTextEditorService, SearchConversationsService, SearchMessagesService, SelectionMode, States, TabAlignment, TabsVisibility, ThemeService, TimestampAlignment, TitleAlignment, ToastType, TranslatePipe, TypeAheadService, UIKitSettings, UIKitSettingsBuilder, UserMemberListType, applyFormatters, closeCurrentMediaPlayer, currentAudioPlayer, formatText, getAvailableFilters, getLocalizedString, getMaxVisibleEmojis, getVisibleFilters, hasValidMessageSearchCriteria, hasValidSearchCriteria, isConversationFilter, isMessageFilter, shouldRenderConversations, shouldRenderMessages, toggleFilter };
-export type { AriaLivePoliteness, AttachmentFile, AudioAttachment, AudioState, BubblePart, BubblePartMap, CalendarObject, CallBubbleStatus, CallButtonClickEvent, CallLogTemplates, CallStatus, CallType, CollaborativePayload, CometChatEmoji, CometChatEmojiCategory, CometChatUiKitWindow, ComponentState, ComposerId, ContextMenuItem, ConversationSlotContext, ConversationSlots, ConversationTemplates, DialogConfig, ErrorCallback, FetchResult, FileAttachment, FocusTrapConfig, FormatterPipelineResult, FullscreenViewerMediaType, GlobalConfig, GridNavigationConfig, GridPosition, GroupMemberTemplates, GroupMembersErrorCallback, GroupTemplates, IAIStreamEvent, IActiveChatChanged, IDialog, IGroupLeft, IGroupMemberAdded, IGroupMemberJoined, IGroupMemberKickedBanned, IGroupMemberScopeChanged, IGroupMemberUnBanned, IMentionsCountWarning, IMessages, IModal, IMouseEvent, IOpenChat, IOwnershipChanged, IPanel, IShowOngoingCall, IncomingCallTemplateContext, InitResult, LinkData, LinkPopoverData, LinkPreviewData, ListNavigationConfig, ListSelectionState, ListTemplates, LocalizationSettings, LogoutResult, MarkdownNode, MarkdownNodeType, MediaAttachment, MediaControlsConfig, MediaControlsResult, MediaLayoutType, MentionData, MentionSuggestion, MentionsNavigationCallbacks, MessageListConfig, MessageListItem, MessageListTemplates, MessagePreviewMode, MessageTypeKey, MessageUpdatePayload, OutgoingCallTemplateContext, PollBubbleOption, PollCreatePayload, PollData, PollOption, PollOptionResult, PollResults, PollVoteErrorEvent, PollVoteEvent, RelativeTimeConfig, RichTextEditorConfig, RichTextFormatState, RichTextMetadata, SearchConversationClickEvent, SearchMessageClickEvent, SearchTemplates, SelectionState, SharedListTemplates, StickerClickEvent, StickerItem, StickerSet, SubtitleFormatter, TextFormatterContext, ToastConfig, TypeAheadConfig, UserReceiptInfo, UserTemplates, VoterInfo };
+/**
+ * Re-export the SDK's NotificationFeedItem type.
+ * This provides full type safety for all SDK method calls (markFeedItemAsDelivered, etc.)
+ * while giving consumers a convenient import path.
+ */
+type NotificationFeedItem = CometChat.NotificationFeedItem;
+/**
+ * Represents a notification category for filter chips.
+ */
+interface NotificationCategory {
+    id: string;
+    label: string;
+}
+/**
+ * Engagement type for feed interactions.
+ */
+type FeedEngagementType = 'viewed' | 'clicked' | 'interacted';
+/**
+ * Action triggered from a card element (from @cometchat/cards-angular).
+ */
+interface CardAction {
+    type: string;
+    params: Record<string, any>;
+    elementId?: string;
+    cardJson?: string;
+}
+/**
+ * Timestamp group for feed items grouped by date.
+ */
+interface TimestampGroup {
+    label: string;
+    items: NotificationFeedItem[];
+}
+/**
+ * Style customization for CometChatNotificationFeed.
+ */
+interface CometChatNotificationFeedStyle {
+    backgroundColor?: string;
+    width?: string;
+    height?: string;
+    headerTitleColor?: string;
+    headerTitleFont?: string;
+    chipActiveBackgroundColor?: string;
+    chipActiveTextColor?: string;
+    chipInactiveBackgroundColor?: string;
+    chipInactiveTextColor?: string;
+    chipBorderColor?: string;
+    badgeBackgroundColor?: string;
+    badgeTextColor?: string;
+    separatorColor?: string;
+    timestampTextColor?: string;
+    timestampFont?: string;
+    cardBackgroundColor?: string;
+    cardBorderColor?: string;
+    cardBorderRadius?: string;
+    cardBorderWidth?: string;
+    unreadIndicatorColor?: string;
+}
+/**
+ * Internal screen state for the feed.
+ */
+type ScreenState = 'loading' | 'loaded' | 'empty' | 'error';
+/**
+ * Internal state for the NotificationFeed ViewModel.
+ */
+interface NotificationFeedState {
+    items: NotificationFeedItem[];
+    groupedItems: TimestampGroup[];
+    categories: NotificationCategory[];
+    activeCategory: string | null;
+    totalUnreadCount: number;
+    categoryUnreadCounts: Map<string, number>;
+    screenState: ScreenState;
+    isLoadingMore: boolean;
+    isRefreshing: boolean;
+    isOffline: boolean;
+    error: CometChat.CometChatException | null;
+    hasMorePages: boolean;
+    paginationError: boolean;
+}
+
+/**
+ * CometChatNotificationFeed — Main notification feed component.
+ * Displays campaign/promotional notifications in a scrollable list with
+ * card rendering, real-time updates, and engagement reporting.
+ */
+declare class CometChatNotificationFeedComponent implements OnInit, OnDestroy, AfterViewInit {
+    private ngZone;
+    private cdr;
+    /** Title displayed in the header. Default: localized 'notifications_title' */
+    title: string;
+    /** Whether to show the header. Default: true */
+    showHeader: boolean;
+    /** Whether to show the back button. Default: false */
+    showBackButton: boolean;
+    /** Whether to show filter chips. Default: true */
+    showFilterChips: boolean;
+    /** Deep link: scroll to a specific item by ID */
+    scrollToItemId: string | undefined;
+    /** Custom request builder for fetching feed items */
+    notificationFeedRequestBuilder: any;
+    /** Custom request builder for fetching categories */
+    notificationCategoriesRequestBuilder: any;
+    /** Custom header template */
+    headerView: TemplateRef<any> | undefined;
+    /** Custom empty state template */
+    emptyStateView: TemplateRef<any> | undefined;
+    /** Custom error state template */
+    errorStateView: TemplateRef<any> | undefined;
+    /** Custom loading state template */
+    loadingStateView: TemplateRef<any> | undefined;
+    /** Style customization */
+    style: CometChatNotificationFeedStyle | undefined;
+    /** Card theme mode forwarded to @cometchat/cards-angular */
+    cardThemeMode: 'auto' | 'light' | 'dark';
+    /** Card theme override forwarded to @cometchat/cards-angular */
+    cardThemeOverride: Record<string, any> | undefined;
+    /** Emitted when a feed item is clicked */
+    itemClick: EventEmitter$1<_cometchat_chat_sdk_javascript.NotificationFeedItem>;
+    /** Emitted when a card action button is clicked */
+    actionClick: EventEmitter$1<{
+        item: NotificationFeedItem;
+        action: CometChatCardAction;
+    }>;
+    /** Emitted when an error occurs */
+    error: EventEmitter$1<_cometchat_chat_sdk_javascript.CometChatException>;
+    /** Emitted when back button is pressed */
+    backClick: EventEmitter$1<void>;
+    contentRef: ElementRef<HTMLDivElement>;
+    state: _angular_core.WritableSignal<NotificationFeedState>;
+    private viewModel;
+    private visibilityTracker;
+    private observedItemIds;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private initVisibilityTracker;
+    /**
+     * Called by the template to observe each feed item element.
+     * Tracks observed items to avoid redundant IntersectionObserver.observe() calls.
+     * Returns null for use in [attr.data-observe] binding.
+     */
+    observeItem(element: HTMLElement, item: NotificationFeedItem): null;
+    onScroll(event: Event): void;
+    onItemClick(item: NotificationFeedItem): void;
+    onCardAction(item: NotificationFeedItem, event: CometChatCardActionEvent): void;
+    onChipClick(category: string | null): void;
+    onRetry(): void;
+    onRetryPagination(): void;
+    onBackClick(): void;
+    private scrollToItem;
+    /**
+     * TrackBy function for grouped items.
+     */
+    trackByGroup(index: number, group: TimestampGroup): string;
+    /**
+     * TrackBy function for feed items.
+     */
+    trackByItem(index: number, item: NotificationFeedItem): string;
+    /**
+     * TrackBy function for categories.
+     */
+    trackByCategory(index: number, cat: NotificationCategory): string;
+    /**
+     * Get the card content as a JSON string for the cards renderer.
+     */
+    getCardJson(item: NotificationFeedItem): string;
+    /**
+     * Get fallback text for card content.
+     * Extracts readable text from the card JSON when @cometchat/cards-angular is not available.
+     */
+    getFallbackText(item: NotificationFeedItem): string;
+    /**
+     * Get category unread count.
+     */
+    getCategoryUnreadCount(categoryId: string): number;
+    /**
+     * Format badge count with 99+ cap.
+     */
+    formatBadgeCount(count: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatNotificationFeedComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatNotificationFeedComponent, "cometchat-notification-feed", never, { "title": { "alias": "title"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "showBackButton": { "alias": "showBackButton"; "required": false; }; "showFilterChips": { "alias": "showFilterChips"; "required": false; }; "scrollToItemId": { "alias": "scrollToItemId"; "required": false; }; "notificationFeedRequestBuilder": { "alias": "notificationFeedRequestBuilder"; "required": false; }; "notificationCategoriesRequestBuilder": { "alias": "notificationCategoriesRequestBuilder"; "required": false; }; "headerView": { "alias": "headerView"; "required": false; }; "emptyStateView": { "alias": "emptyStateView"; "required": false; }; "errorStateView": { "alias": "errorStateView"; "required": false; }; "loadingStateView": { "alias": "loadingStateView"; "required": false; }; "style": { "alias": "style"; "required": false; }; "cardThemeMode": { "alias": "cardThemeMode"; "required": false; }; "cardThemeOverride": { "alias": "cardThemeOverride"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "error": "error"; "backClick": "backClick"; }, never, never, true, never>;
+    static ngAcceptInputType_showHeader: unknown;
+    static ngAcceptInputType_showBackButton: unknown;
+    static ngAcceptInputType_showFilterChips: unknown;
+}
+
+/**
+ * ViewModel for CometChatNotificationFeed.
+ * Manages all data operations: fetching, pagination, engagement, real-time updates.
+ */
+declare class NotificationFeedViewModel {
+    private feedRequestBuilder;
+    private customFeedRequestBuilder;
+    private categoriesRequestBuilder;
+    private listenerId;
+    private pollingInterval;
+    private deliveredItemIds;
+    private fetchVersion;
+    private onStateChange;
+    private state;
+    constructor(onStateChange: (state: NotificationFeedState) => void, feedRequestBuilder?: any, categoriesRequestBuilder?: any);
+    /**
+     * Get current state.
+     */
+    getState(): NotificationFeedState;
+    /**
+     * Update state and notify the view.
+     */
+    private setState;
+    /**
+     * Initialize: fetch categories, first page, register listener.
+     */
+    init(): Promise<void>;
+    /**
+     * Cleanup: remove listener, stop polling.
+     */
+    dispose(): void;
+    /**
+     * Fetch available categories for filter chips.
+     */
+    fetchCategories(): Promise<void>;
+    /**
+     * Fetch the first page of feed items.
+     * Uses fetchVersion to discard stale results from previous category switches.
+     */
+    fetchInitialItems(): Promise<void>;
+    /**
+     * Fetch next page (infinite scroll).
+     */
+    fetchNextPage(): Promise<void>;
+    /**
+     * Retry pagination after error.
+     */
+    retryPagination(): void;
+    /**
+     * Refresh feed (pull-to-refresh or reconnect).
+     */
+    refresh(): Promise<void>;
+    /**
+     * Switch category filter.
+     */
+    switchCategory(category: string | null): void;
+    /**
+     * Report delivered for a batch of items (once per item).
+     */
+    private reportDeliveredBatch;
+    /**
+     * Report item as delivered (fire-and-forget, once per item).
+     */
+    reportDelivered(item: NotificationFeedItem): void;
+    /**
+     * Report item as viewed (fire-and-forget).
+     */
+    reportViewed(item: NotificationFeedItem): void;
+    /**
+     * Report item as read (after 1s visibility).
+     */
+    reportRead(item: NotificationFeedItem): void;
+    /**
+     * Report item as clicked.
+     */
+    reportClicked(item: NotificationFeedItem): void;
+    /**
+     * Report item as interacted (action button tap).
+     */
+    reportInteracted(item: NotificationFeedItem): void;
+    /**
+     * Register WebSocket listener for new feed items.
+     */
+    private registerListener;
+    /**
+     * Remove WebSocket listener.
+     */
+    private removeListener;
+    /**
+     * Handle new feed item received via WebSocket.
+     */
+    onFeedItemReceived(item: NotificationFeedItem): void;
+    /**
+     * Fetch current unread count.
+     */
+    private fetchUnreadCount;
+    /**
+     * Start polling unread count every 30 seconds.
+     */
+    startUnreadCountPolling(intervalMs?: number): void;
+    /**
+     * Stop polling.
+     */
+    stopUnreadCountPolling(): void;
+    /**
+     * Initialize or re-initialize the feed request builder.
+     * Respects custom builder if provided via constructor (when no category filter active).
+     */
+    private initFeedRequestBuilder;
+}
+
+/**
+ * Groups feed items by their sentAt timestamp into labeled sections.
+ *
+ * Rules:
+ * - sentAt is today → localized "Today"
+ * - sentAt is yesterday → localized "Yesterday"
+ * - sentAt is within this week → Day name (e.g., "Monday")
+ * - sentAt is older → Localized date (e.g., "Jan 15, 2025")
+ */
+declare function groupByTimestamp(items: NotificationFeedItem[]): TimestampGroup[];
+/**
+ * Visibility tracker using IntersectionObserver.
+ * Tracks which items are visible and manages read/viewed engagement timers.
+ */
+declare class VisibilityTracker {
+    private observer;
+    private timers;
+    private viewedItems;
+    private readItems;
+    private onViewed;
+    private onRead;
+    private itemMap;
+    constructor(onViewed: (item: NotificationFeedItem) => void, onRead: (item: NotificationFeedItem) => void);
+    /**
+     * Initialize the IntersectionObserver.
+     */
+    init(root: HTMLElement | null): void;
+    /**
+     * Observe a DOM element for a feed item.
+     */
+    observe(element: HTMLElement, item: NotificationFeedItem): void;
+    /**
+     * Unobserve a DOM element.
+     */
+    unobserve(element: HTMLElement): void;
+    /**
+     * Handle item becoming visible in viewport.
+     */
+    private handleItemVisible;
+    /**
+     * Handle item leaving viewport.
+     */
+    private handleItemHidden;
+    /**
+     * Mark an item as already read (e.g., when state updates externally).
+     */
+    markAsRead(itemId: string): void;
+    /**
+     * Reset the tracker state (call on category switch to prevent memory leak).
+     * Note: After disconnect(), the existing IntersectionObserver instance remains valid.
+     * Calling observe() on it after disconnect() will resume observation for newly
+     * added elements — this is per the IntersectionObserver spec. No re-creation needed.
+     */
+    reset(): void;
+    /**
+     * Cleanup all observers and timers.
+     */
+    dispose(): void;
+}
+
+/**
+ * Pure pipe to format badge count with 99+ cap.
+ * Replaces method call in template to avoid re-evaluation on every CD cycle.
+ */
+declare class BadgeCountPipe implements PipeTransform {
+    transform(count: number, max?: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeCountPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<BadgeCountPipe, "badgeCount", true>;
+}
+/**
+ * Pure pipe to extract card JSON string from a NotificationFeedItem.
+ * Replaces method call in template to avoid JSON.stringify on every CD cycle.
+ */
+declare class CardJsonPipe implements PipeTransform {
+    transform(item: NotificationFeedItem): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardJsonPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<CardJsonPipe, "cardJson", true>;
+}
+/**
+ * Pure pipe to get category unread count from the Map.
+ * Replaces method call in template to avoid re-evaluation on every CD cycle.
+ */
+declare class CategoryUnreadCountPipe implements PipeTransform {
+    transform(categoryId: string, categoryUnreadCounts: Map<string, number>): number;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CategoryUnreadCountPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<CategoryUnreadCountPipe, "categoryUnreadCount", true>;
+}
+
+/**
+ * Style customization for CometChatNotificationBadge.
+ */
+interface NotificationBadgeStyle {
+    backgroundColor?: string;
+    textColor?: string;
+    fontSize?: string;
+    borderRadius?: string;
+}
+
+/**
+ * CometChatNotificationBadge — Displays unread notification count.
+ * Subscribes to real-time updates and re-syncs on window focus.
+ *
+ * Usage:
+ * ```html
+ * <cometchat-notification-badge [max]="99"></cometchat-notification-badge>
+ * ```
+ */
+declare class CometChatNotificationBadgeComponent implements OnInit, OnDestroy {
+    private unreadCountService;
+    /** Filter count by category */
+    category: string | undefined;
+    /** Maximum count to display before showing "N+". Default: 99 */
+    max: number;
+    /** Style overrides */
+    style: NotificationBadgeStyle | undefined;
+    /** Internal count signal */
+    count: _angular_core.WritableSignal<number>;
+    private subscription;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Display text for the badge (computed signal for performance).
+     */
+    readonly displayText: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CometChatNotificationBadgeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CometChatNotificationBadgeComponent, "cometchat-notification-badge", never, { "category": { "alias": "category"; "required": false; }; "max": { "alias": "max"; "required": false; }; "style": { "alias": "style"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Options for safeEffect — mirrors Angular's EffectOptions but always
+ * includes allowSignalWrites: true so the effect works across Angular 18–21.
+ *
+ * Background:
+ * - Angular 18/19: `allowSignalWrites` is REQUIRED when writing to signals
+ *   inside an effect body. Omitting it throws a runtime error.
+ * - Angular 21+: `allowSignalWrites` is deprecated and optional (signal writes
+ *   inside effects are allowed by default).
+ *
+ * Using this wrapper means developers never need to remember to add the flag,
+ * and the codebase stays compatible across all supported Angular versions.
+ */
+interface SafeEffectOptions {
+    injector?: Injector;
+    manualCleanup?: boolean;
+}
+/**
+ * Drop-in replacement for Angular's `effect()` that is safe to use across
+ * Angular 18, 19, 20, and 21.
+ *
+ * Always passes `allowSignalWrites: true` so signal writes inside the effect
+ * body work on Angular 18/19 without requiring each call site to remember
+ * the flag. On Angular 21+ the flag is a no-op.
+ *
+ * @example
+ * // Instead of:
+ * effect(() => { this.someSignal.set(value); }, { injector: this.injector });
+ *
+ * // Use:
+ * safeEffect(() => { this.someSignal.set(value); }, { injector: this.injector });
+ *
+ * @param effectFn - The reactive effect function to run
+ * @param options  - Optional injector and manualCleanup settings
+ * @returns EffectRef that can be used to destroy the effect manually
+ */
+declare function safeEffect(effectFn: () => void, options?: SafeEffectOptions): EffectRef;
+
+export { AuxiliaryButtonAlignment, BadgeCountPipe, ButtonAction, COMETCHAT_GLOBAL_CONFIG, CalendarDatePipe, CallAnnouncerService, CallButtonsService, CallLogsService, CallWorkflow, CardJsonPipe, CategoryUnreadCountPipe, ChatStateService, CometChatAIAssistantChat, CometChatAIAssistantChatHistory, CometChatAIAssistantMessageBubble, CometChatAIAssistantTools, CometChatAIStreamingService, CometChatActionBubbleComponent, CometChatActionSheetComponent, CometChatActions, CometChatActionsIcon, CometChatActionsView, CometChatAudioBubbleComponent, CometChatAvatarComponent, CometChatButtonComponent, CometChatCallBubbleComponent, CometChatCallButtonsComponent, CometChatCallEvents, CometChatCallLogsComponent, CometChatCardBubbleComponent, CometChatChangeScopeComponent, CometChatCheckboxComponent, CometChatCollaborativeDocumentBubbleComponent, CometChatCollaborativeWhiteboardBubbleComponent, CometChatConfirmDialogComponent, CometChatContextMenuComponent, CometChatConversationEvents, CometChatConversationItemComponent, CometChatConversationStarterComponent, CometChatConversationSummaryComponent, CometChatConversationsComponent, CometChatCreatePollComponent, CometChatDateComponent, CometChatDeleteBubbleComponent, CometChatDropDownComponent, CometChatEmojiFormatter, CometChatEmojiKeyboardComponent, CometChatErrorBoundaryComponent, CometChatFileBubbleComponent, CometChatFlagMessageDialogComponent, CometChatFullScreenViewerComponent, CometChatGroupEvents, CometChatGroupItemComponent, CometChatGroupMemberItemComponent, CometChatGroupMembersComponent, CometChatGroupsComponent, CometChatImageBubbleComponent, CometChatIncomingCallComponent, CometChatLinkDialogComponent, CometChatLinkPopoverComponent, CometChatListItemComponent, CometChatLocalize, CometChatLogger, CometChatMarkdownFormatter, CometChatMarkdownParser, CometChatMarkdownRenderer, CometChatMediaRecorderComponent, CometChatMentionsFormatter, CometChatMessageBubbleComponent, CometChatMessageComposerAction, CometChatMessageComposerComponent, CometChatMessageEvents, CometChatMessageHeaderComponent, CometChatMessageInformationComponent, CometChatMessageListComponent, CometChatMessagePreviewComponent, CometChatNotificationBadgeComponent, CometChatNotificationFeedComponent, CometChatOngoingCallComponent, CometChatOption, CometChatOutgoingCallComponent, CometChatPaginatedListComponent, CometChatPollBubbleComponent, CometChatPopoverComponent, CometChatRadioButtonComponent, CometChatReactionInfoComponent, CometChatReactionListComponent, CometChatReactionsComponent, CometChatSearchBarComponent, CometChatSearchComponent, CometChatSearchConversationsListComponent, CometChatSearchFilter, CometChatSearchMessagesListComponent, CometChatSearchScope, CometChatSmartRepliesComponent, CometChatStickerBubbleComponent, CometChatStickersKeyboardComponent, CometChatStreamMessageBubble, CometChatTemplatesService, CometChatTextBubbleComponent, CometChatTextFormatter, CometChatThreadHeaderComponent, CometChatThreadViewComponent, CometChatToastComponent, CometChatToastService, CometChatToolCallArgumentBubble, CometChatToolCallResultBubble, CometChatTypingIndicatorComponent, CometChatUIEvents, CometChatUIKit, CometChatUIKitCalls, CometChatUIKitConstants, CometChatUrlFormatter, CometChatUserEvents, CometChatUserItemComponent, CometChatUsersComponent, CometChatVideoBubbleComponent, ConnectionStateService, ConversationDatePipe, ConversationSubtitleService, ConversationsService, DEFAULT_MESSAGE_CATEGORIES, DEFAULT_MESSAGE_TYPES, DateTimePickerMode, DialogFocusManager, DocumentIconAlignment, ElementType, EnterKeyBehavior, FocusTrapService, FormatterConfigService, GridNavigationService, GroupMembersService, HTTPSRequestMethods, HtmlSanitizerService, IconButtonAlignment, IncomingCallService, LabelAlignment, ListNavigationService, ListSelectionManager, LiveAnnouncerService, LogLevel, MENTIONS_LIMIT, MediaControlsService, MentionType, MentionsNavigationService, MentionsTargetElement, MentionsVisibility, MessageBubbleAlignment, MessageBubbleConfigService, MessageComposerService, MessageDatePipe, MessageHeaderService, MessageListAlignment, MessageListService, MessageStatus, MessageUtilsService, MouseEventSource, NotificationFeedViewModel, NotificationUnreadCountService, OngoingCallService, OutgoingCallService, PanelAlignment, Placement, PreviewMessageMode, Receipts, RecordingType, RichTextEditorService, SearchConversationsService, SearchMessagesService, SelectionMode, States, TabAlignment, TabsVisibility, ThemeService, TimestampAlignment, TitleAlignment, ToastType, TranslatePipe, TypeAheadService, UIKitSettings, UIKitSettingsBuilder, UserMemberListType, VisibilityTracker, applyFormatters, closeCurrentMediaPlayer, currentAudioPlayer, formatText, getAvailableFilters, getLocalizedString, getMaxVisibleEmojis, getVisibleFilters, groupByTimestamp, hasValidMessageSearchCriteria, hasValidSearchCriteria, isConversationFilter, isMessageFilter, parseInline, safeEffect, shouldRenderConversations, shouldRenderMessages, toggleFilter };
+export type { AIAssistantContentBlock, AriaLivePoliteness, AttachmentFile, AudioAttachment, AudioState, BubblePart, BubblePartMap, CalendarObject, CallBubbleStatus, CallButtonClickEvent, CallLogTemplates, CallStatus, CallType, CardAction, CardBubbleAction, CollaborativePayload, CometChatEmoji, CometChatEmojiCategory, CometChatNotificationFeedStyle, CometChatUiKitWindow, ComponentState, ComposerId, ContextMenuItem, ConversationSlotContext, ConversationSlots, ConversationTemplates, DialogConfig, ErrorCallback, FeedEngagementType, FetchResult, FileAttachment, FocusTrapConfig, FormatterPipelineResult, FullscreenViewerMediaType, GlobalConfig, GridNavigationConfig, GridPosition, GroupMemberTemplates, GroupMembersErrorCallback, GroupTemplates, IAIStreamEvent, IActiveChatChanged, ICardActionEvent, IDialog, IGroupLeft, IGroupMemberAdded, IGroupMemberJoined, IGroupMemberKickedBanned, IGroupMemberScopeChanged, IGroupMemberUnBanned, IMentionsCountWarning, IMessages, IModal, IMouseEvent, IOpenChat, IOwnershipChanged, IPanel, IShowOngoingCall, IncomingCallTemplateContext, InitResult, LinkData, LinkPopoverData, LinkPreviewData, ListNavigationConfig, ListSelectionState, ListTemplates, LocalizationSettings, LogoutResult, MarkdownNode, MarkdownNodeType, MediaAttachment, MediaControlsConfig, MediaControlsResult, MediaLayoutType, MentionData, MentionSuggestion, MentionsNavigationCallbacks, MessageListConfig, MessageListItem, MessageListTemplates, MessagePreviewMode, MessageTypeKey, MessageUpdatePayload, NotificationBadgeStyle, NotificationCategory, NotificationFeedItem, NotificationFeedState, NotificationUnreadCountOptions, OutgoingCallTemplateContext, PollBubbleOption, PollCreatePayload, PollData, PollOption, PollOptionResult, PollResults, PollVoteErrorEvent, PollVoteEvent, RelativeTimeConfig, RichTextEditorConfig, RichTextFormatState, RichTextMetadata, SafeEffectOptions, ScreenState, SearchConversationClickEvent, SearchMessageClickEvent, SearchTemplates, SelectionState, SharedListTemplates, StickerClickEvent, StickerItem, StickerSet, StreamedCard, SubtitleFormatter, TextFormatterContext, TimestampGroup, ToastConfig, TypeAheadConfig, UserReceiptInfo, UserTemplates, VoterInfo };