Skip to content
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -2589,6 +2589,7 @@
"group": "Chat",
"pages": [
"ui-kit/angular/core-features",
"ui-kit/angular/offline-support",
"ui-kit/angular/extensions",
"ui-kit/angular/ai-features"
]
Expand Down
4 changes: 2 additions & 2 deletions ui-kit/angular/angular-conversation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,10 +39,10 @@

## Step 1 — Update the Root Component

Wire the conversation list and message components together in your root component. The UIKit's `ChatStateService` handles all the wiring — when a user clicks a conversation, `cometchat-conversations` updates the service, and the message components automatically react to the change.

Check warning on line 42 in ui-kit/angular/angular-conversation.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-conversation.mdx#L42

Did you really mean 'UIKit's'?

<Note>
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
</Note>

```ts title="src/app/app.ts" expandable
Expand Down Expand Up @@ -128,7 +128,7 @@
})
export class App implements OnInit {
chatStateService = inject(ChatStateService);
isLoggedIn = signal(false); // a signal so the view updates in zoneless apps (Angular 21 default)
isLoggedIn = signal(false); // a signal so the view updates in zoneless apps (the default since Angular 21)

ngOnInit(): void {
CometChatUIKit.getLoggedinUser().then((user: CometChat.User | null) => {
Expand All @@ -147,12 +147,12 @@
<Warning>
**The shell needs `overflow: hidden`, and every flex ancestor of the message list needs `min-height: 0`.**

`height: 100vh` alone is not enough. The kit's lists scroll internally, but a flex child defaults to `min-height: auto` and refuses to shrink below its content — so the message list pushes the shell past the viewport and the browser scrolls the **page** instead of the list, carrying the header and composer off-screen with it.

Check warning on line 150 in ui-kit/angular/angular-conversation.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-conversation.mdx#L150

Did you really mean 'viewport'?

One missing `min-height: 0` anywhere between the viewport and the message list is enough to bring the page scroll back. `100dvh` is preferred over `100vh` because `vh` units include mobile browser chrome and overflow on phones.

Check warning on line 152 in ui-kit/angular/angular-conversation.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-conversation.mdx#L152

Did you really mean 'viewport'?
</Warning>

The browser's default 8px `body` margin also pushes a `100dvh` shell 16px past the viewport, so the page scrolls slightly. Reset it in your global stylesheet (below the CometChat `@import` if you chose that option in Step 5 of [Integration](/ui-kit/angular/integration)):

Check warning on line 155 in ui-kit/angular/angular-conversation.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-conversation.mdx#L155

Did you really mean 'viewport'?

```css title="src/styles.css"
body {
Expand Down
2 changes: 1 addition & 1 deletion ui-kit/angular/angular-one-to-one-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@
The app fetches a user (or group) on mount, sets it as the active entity via `ChatStateService`, and renders the three message components. The components auto-subscribe to the service — no prop passing needed.

<Note>
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
</Note>

```ts title="src/app/app.ts" expandable
Expand Down Expand Up @@ -148,12 +148,12 @@
<Warning>
**The shell needs `overflow: hidden`, and every flex ancestor of the message list needs `min-height: 0`.**

`height: 100vh` alone is not enough. The kit's lists scroll internally, but a flex child defaults to `min-height: auto` and refuses to shrink below its content — so the message list pushes the shell past the viewport and the browser scrolls the **page** instead of the list, carrying the header and composer off-screen with it.

Check warning on line 151 in ui-kit/angular/angular-one-to-one-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-one-to-one-chat.mdx#L151

Did you really mean 'viewport'?

One missing `min-height: 0` anywhere between the viewport and the message list is enough to bring the page scroll back. `100dvh` is preferred over `100vh` because `vh` units include mobile browser chrome and overflow on phones.

Check warning on line 153 in ui-kit/angular/angular-one-to-one-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-one-to-one-chat.mdx#L153

Did you really mean 'viewport'?
</Warning>

The browser's default 8px `body` margin also pushes a `100dvh` shell 16px past the viewport, so the page scrolls slightly. Reset it in your global stylesheet (below the CometChat `@import` if you chose that option in Step 5 of [Integration](/ui-kit/angular/integration)):

Check warning on line 156 in ui-kit/angular/angular-one-to-one-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-one-to-one-chat.mdx#L156

Did you really mean 'viewport'?

```css title="src/styles.css"
body {
Expand Down
4 changes: 2 additions & 2 deletions ui-kit/angular/angular-tab-based-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
Wire everything together. `ChatStateService` handles the state — `cometchat-conversations` and `cometchat-users` automatically update the service when an item is clicked, and the message components auto-subscribe.

<Note>
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
</Note>

```ts title="src/app/app.ts" expandable
Expand Down Expand Up @@ -190,7 +190,7 @@
})
export class App implements OnInit {
chatStateService = inject(ChatStateService);
isLoggedIn = signal(false); // a signal so the view updates in zoneless apps (Angular 21 default)
isLoggedIn = signal(false); // a signal so the view updates in zoneless apps (the default since Angular 21)
activeTab: "chats" | "calls" | "users" = "chats";

ngOnInit(): void {
Expand All @@ -210,12 +210,12 @@
<Warning>
**The shell needs `overflow: hidden`, and every flex ancestor of the message list needs `min-height: 0`.**

`height: 100vh` alone is not enough. The kit's lists scroll internally, but a flex child defaults to `min-height: auto` and refuses to shrink below its content — so the message list pushes the shell past the viewport and the browser scrolls the **page** instead of the list, carrying the header and composer off-screen with it.

Check warning on line 213 in ui-kit/angular/angular-tab-based-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-tab-based-chat.mdx#L213

Did you really mean 'viewport'?

One missing `min-height: 0` anywhere between the viewport and the message list is enough to bring the page scroll back. `100dvh` is preferred over `100vh` because `vh` units include mobile browser chrome and overflow on phones.

Check warning on line 215 in ui-kit/angular/angular-tab-based-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-tab-based-chat.mdx#L215

Did you really mean 'viewport'?
</Warning>

The browser's default 8px `body` margin also pushes a `100dvh` shell 16px past the viewport, so the page scrolls slightly. Reset it in your global stylesheet (below the CometChat `@import` if you chose that option in Step 5 of [Integration](/ui-kit/angular/integration)):

Check warning on line 218 in ui-kit/angular/angular-tab-based-chat.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/angular-tab-based-chat.mdx#L218

Did you really mean 'viewport'?

```css title="src/styles.css"
body {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "Formatter Config Service"
description: "Service Reference for the centralized text-formatter configuration service in CometChat Angular UIKit"

Check warning on line 3 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L3

Did you really mean 'UIKit'?
---

<Accordion title="AI Integration Quick Reference">

| Field | Value |
| --- | --- |
| Purpose | App-wide default text formatters, so mentions/URLs/hashtags are configured once rather than per component instance. |

Check warning on line 10 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L10

Did you really mean 'formatters'?
| Class | `FormatterConfigService` |
| Package | `@cometchat/chat-uikit-angular` v5.x |
| Import | `import { FormatterConfigService } from "@cometchat/chat-uikit-angular";` |
Expand All @@ -19,14 +19,14 @@

</Accordion>

The `FormatterConfigService` is a centralized Angular service for managing default text formatters across the CometChat UIKit. It provides a single source of truth for formatter configuration, allowing you to set formatters once and have them automatically applied across all text-displaying components.

Check warning on line 22 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L22

Did you really mean 'formatters'?

Check warning on line 22 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L22

Did you really mean 'UIKit'?

Check warning on line 22 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L22

Did you really mean 'formatters'?

## Overview

The service manages text formatters that transform raw text into formatted HTML with support for:

Check warning on line 26 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L26

Did you really mean 'formatters'?
- Mentions (@user) with self-mention detection
- URLs with automatic link creation
- Custom formatters (hashtags, emails, etc.)

Check warning on line 29 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L29

Did you really mean 'formatters'?
- Context-aware formatting (logged-in user, message alignment)
- Formatter priority ordering
- Performance optimization through instance reuse
Expand All @@ -46,7 +46,7 @@

## Default Behavior

When no custom formatters are configured, the service provides two built-in formatters:

Check warning on line 49 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L49

Did you really mean 'formatters'?

Check warning on line 49 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L49

Did you really mean 'formatters'?

1. **CometChatMentionsFormatter** (priority 20)
- Detects mentions in format `<@uid:{uid}>` or `<@all:{label}>`
Expand All @@ -59,19 +59,19 @@
- Converts to clickable links
- Adds security attributes (`target="_blank"`, `rel="noopener noreferrer"`)

These formatters are singleton instances, reused across all components for optimal performance.

Check warning on line 62 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L62

Did you really mean 'formatters'?

## Core Methods

### `getDefaultFormatters(): CometChatTextFormatter[]`

Gets the configured default formatters.

Check warning on line 68 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L68

Did you really mean 'formatters'?

**Returns:** Array of text formatters in priority order

Check warning on line 70 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L70

Did you really mean 'formatters'?

**Priority:**
1. Custom formatters (if set via `setDefaultFormatters`)

Check warning on line 73 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L73

Did you really mean 'formatters'?
2. Built-in defaults + additional formatters (if added via `addFormatters`)

Check warning on line 74 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L74

Did you really mean 'formatters'?
3. Built-in defaults only (mentions + URLs)

**Example:**
Expand All @@ -81,23 +81,23 @@
private formatters: CometChatTextFormatter[] = [];

ngOnInit() {
// Get default formatters

Check warning on line 84 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L84

Did you really mean 'formatters'?
this.formatters = this.formatterConfig.getDefaultFormatters();

Check warning on line 85 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L85

Did you really mean 'formatters'?
}
}
```

### `setDefaultFormatters(formatters: CometChatTextFormatter[]): void`

Replaces the built-in default formatters with custom formatters.

Check warning on line 92 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L92

Did you really mean 'formatters'?

**Parameters:**
- `formatters`: Array of custom formatters to use as defaults

Check warning on line 95 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L95

Did you really mean 'formatters'?

**Use Case:** When you want complete control over which formatters are used globally.

Check warning on line 97 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L97

Did you really mean 'formatters'?

**Example:**
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.

```typescript expandable
// In app initialization (main.ts or app.ts)
Expand All @@ -106,7 +106,7 @@

ngOnInit() {
// Replace defaults with custom formatters
const customFormatters = [

Check warning on line 109 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L109

Did you really mean 'Formatters'?
new MyCustomMentionsFormatter(),
new MyCustomUrlFormatter(),
new HashtagFormatter(),
Expand All @@ -118,16 +118,16 @@
}
```

**Note:** Once custom formatters are set, `addFormatters()` has no effect. To add to custom formatters, include them in the array passed to `setDefaultFormatters()`.

Check warning on line 121 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L121

Did you really mean 'formatters'?

### `addFormatters(formatters: CometChatTextFormatter[]): void`

Adds additional formatters to the built-in defaults without replacing them.

Check warning on line 125 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L125

Did you really mean 'formatters'?

**Parameters:**
- `formatters`: Array of formatters to add to the default set

Check warning on line 128 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L128

Did you really mean 'formatters'?

**Use Case:** When you want to keep the built-in formatters (mentions + URLs) and add custom ones.

Check warning on line 130 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L130

Did you really mean 'formatters'?

**Example:**
```typescript expandable
Expand All @@ -135,7 +135,7 @@
private formatterConfig = inject(FormatterConfigService);

ngOnInit() {
// Add custom formatters to defaults

Check warning on line 138 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L138

Did you really mean 'formatters'?
const additionalFormatters = [
new HashtagFormatter(),
new EmailFormatter(),
Expand All @@ -150,11 +150,11 @@
}
```

**Note:** If custom formatters have been set via `setDefaultFormatters()`, this method has no effect.

Check warning on line 153 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L153

Did you really mean 'formatters'?

### `resetToDefaults(): void`

Resets to the built-in default formatters, clearing any custom or additional formatters.

Check warning on line 157 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L157

Did you really mean 'formatters'?

**Use Case:** When you want to restore the original formatter configuration.

Expand All @@ -163,7 +163,7 @@
export class SettingsComponent {
private formatterConfig = inject(FormatterConfigService);

resetFormatters() {

Check warning on line 166 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L166

Did you really mean 'Formatters'?
// Clear all customizations
this.formatterConfig.resetToDefaults();

Expand All @@ -175,13 +175,13 @@

### `getFormattersWithContext(loggedInUser?, alignment?): CometChatTextFormatter[]`

Gets formatters configured with context for self-mention detection and direction CSS classes.

Check warning on line 178 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L178

Did you really mean 'formatters'?

**Parameters:**
- `loggedInUser` (optional): The logged-in user for self-mention detection
- `alignment` (optional): Message bubble alignment for direction CSS classes

**Returns:** Array of formatters configured with the provided context

Check warning on line 184 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L184

Did you really mean 'formatters'?

**Context Configuration:**

Expand All @@ -198,7 +198,7 @@
```typescript expandable
export class MessageListComponent implements OnInit {
private formatterConfig = inject(FormatterConfigService);
private formatters: CometChatTextFormatter[] = [];

Check warning on line 201 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L201

Did you really mean 'formatters'?

ngOnInit() {
const loggedInUser = CometChat.getLoggedInUser();
Expand All @@ -212,7 +212,7 @@
);

// Pass to text bubble component
message.formatters = formatters;

Check warning on line 215 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L215

Did you really mean 'formatters'?
});
}

Expand Down Expand Up @@ -265,9 +265,9 @@

## Usage Patterns

### Pattern 1: Use Default Formatters (Recommended)

Check warning on line 268 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L268

Did you really mean 'Formatters'?

The simplest approach - let the service provide the default formatters.

Check warning on line 270 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L270

Did you really mean 'formatters'?

```typescript
export class TextBubbleComponent implements OnInit {
Expand All @@ -283,9 +283,9 @@

**When to use:** Most components should use this pattern.

### Pattern 2: Set Custom Formatters Globally

Check warning on line 286 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L286

Did you really mean 'Formatters'?

Replace the built-in formatters with your own custom set.

Check warning on line 288 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L288

Did you really mean 'formatters'?

```typescript expandable
// In app initialization (main.ts or app.ts)
Expand All @@ -308,7 +308,7 @@

**When to use:** When you need complete control over formatter behavior globally.

### Pattern 3: Extend Default Formatters

Check warning on line 311 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L311

Did you really mean 'Formatters'?

Keep the built-in formatters and add custom ones.

Expand All @@ -330,7 +330,7 @@
}
```

**When to use:** When you want to add functionality without losing the built-in formatters.

Check warning on line 333 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L333

Did you really mean 'formatters'?

### Pattern 4: Context-Aware Formatting

Expand All @@ -347,7 +347,7 @@
const alignment = this.getMessageAlignment(message);

// Get formatters with context
const formatters = this.formatterConfig.getFormattersWithContext(

Check warning on line 350 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L350

Did you really mean 'formatters'?
loggedInUser,
alignment
);
Expand All @@ -361,7 +361,7 @@

**When to use:** In message lists where self-mention detection and direction classes are needed.

### Pattern 5: Component-Specific Formatters

Check warning on line 364 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L364

Did you really mean 'Formatters'?

Override formatters for a specific component instance.

Expand All @@ -373,14 +373,14 @@
private formatters: CometChatTextFormatter[] = [];

ngOnInit() {
// Use input formatters if provided, otherwise use defaults

Check warning on line 376 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L376

Did you really mean 'formatters'?
this.formatters = this.textFormatters ||
this.formatterConfig.getDefaultFormatters();
}
}
```

**When to use:** When a specific component needs different formatters than the global defaults.

Check warning on line 383 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L383

Did you really mean 'formatters'?

## Creating Custom Formatters

Expand Down Expand Up @@ -429,7 +429,7 @@

## Formatter Priority

Formatters execute in order of their `priority` property (lower number = earlier execution):

Check warning on line 432 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L432

Did you really mean 'Formatters'?

| Formatter | Priority | Execution Order |
|-----------|----------|-----------------|
Expand All @@ -450,7 +450,7 @@
// Result: Both mentions and URLs are properly formatted
```

**Setting priority in custom formatters:**

Check warning on line 453 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L453

Did you really mean 'formatters'?

```typescript
export class EmailFormatter extends CometChatTextFormatter {
Expand All @@ -467,7 +467,7 @@

### 1. Singleton Instances

Formatters are created once and reused across all components:

Check warning on line 470 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L470

Did you really mean 'Formatters'?

```typescript
// ✅ GOOD: Service reuses instances
Expand All @@ -487,7 +487,7 @@

### 3. Conditional Execution

Formatters check `shouldFormat()` before applying regex:

Check warning on line 490 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L490

Did you really mean 'Formatters'?

```typescript expandable
export class MyFormatter extends CometChatTextFormatter {
Expand Down Expand Up @@ -556,7 +556,7 @@

### 1. Configure Once, Use Everywhere

Set formatters globally in app initialization:

Check warning on line 559 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L559

Did you really mean 'formatters'?

```typescript expandable
// ✅ GOOD: Configure once in the root component (`App`)
Expand Down Expand Up @@ -593,7 +593,7 @@

### 3. Respect Formatter Priority

Set appropriate priority values for custom formatters:

Check warning on line 596 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L596

Did you really mean 'formatters'?

```typescript expandable
// ✅ GOOD: Logical priority
Expand Down Expand Up @@ -631,7 +631,7 @@

### 5. Handle Edge Cases

Ensure formatters handle empty or invalid input:

Check warning on line 634 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L634

Did you really mean 'formatters'?

```typescript
// ✅ GOOD: Defensive programming
Expand All @@ -646,9 +646,9 @@

## Common Patterns

### Pattern: Feature Flag for Formatters

Check warning on line 649 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L649

Did you really mean 'Formatters'?

Enable/disable formatters based on feature flags:

Check warning on line 651 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L651

Did you really mean 'formatters'?

```typescript expandable
export class App implements OnInit {
Expand All @@ -674,7 +674,7 @@
}
```

### Pattern: User Preference for Formatters

Check warning on line 677 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L677

Did you really mean 'Formatters'?

Allow users to customize formatter behavior:

Expand Down Expand Up @@ -732,11 +732,11 @@

## Troubleshooting

### Formatters Not Applied

Check warning on line 735 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L735

Did you really mean 'Formatters'?

**Problem:** Text is not being formatted.

**Solution:** Check that formatters are configured:

Check warning on line 739 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L739

Did you really mean 'formatters'?

```typescript
// Debug: Log formatters
Expand Down Expand Up @@ -781,9 +781,9 @@
]);
```

### Formatters Execute in Wrong Order

Check warning on line 784 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L784

Did you really mean 'Formatters'?

**Problem:** Formatters execute in unexpected order.

Check warning on line 786 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L786

Did you really mean 'Formatters'?

**Solution:** Check priority values:

Expand All @@ -805,7 +805,7 @@

## Scoping for Multiple Instances

`FormatterConfigService` is provided at the root level (`providedIn: 'root'`), so all components share the same formatter configuration by default. If you need different formatters for different message lists (e.g., a main chat with full formatting vs. a thread panel with minimal formatting), scope the service to a wrapper component:

Check warning on line 808 in ui-kit/angular/api-reference/formatter-config-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/formatter-config-service.mdx#L808

Did you really mean 'formatters'?

```typescript expandable
@Component({
Expand Down
2 changes: 1 addition & 1 deletion ui-kit/angular/api-reference/introduction.mdx
Original file line number Diff line number Diff line change
@@ -1,26 +1,26 @@
---
title: Services
description: "Reference for CometChat UIKit Angular injectable services."

Check warning on line 3 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L3

Did you really mean 'UIKit'?

Check warning on line 3 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L3

Did you really mean 'injectable'?
---

<Accordion title="AI Integration Quick Reference">

| Field | Value |
| --- | --- |
| Purpose | Index of the Angular UI Kit's injectable services — start here to find the right one |

Check warning on line 10 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L10

Did you really mean 'injectable'?
| Package | `@cometchat/chat-uikit-angular` v5.x |
| Services | `ChatStateService` · `FormatterConfigService` · `MessageBubbleConfigService` · `RichTextEditorService` · `SearchConversationsService` · `SearchMessagesService` · `CometChatTemplatesService` |
| Injected with | `inject(<Service>)` — all are `providedIn: 'root'` |
| Injected with | `inject(<Service>)` — all are `providedIn: 'root'` except `SearchConversationsService` and `SearchMessagesService`, which are component-provided (add them to your component's `providers`) |
| Full list | See [Services](#services) |

</Accordion>
This section documents the Angular services provided by the CometChat UIKit. These are injectable services you use via Angular's dependency injection to manage state, configure components, and customize behavior.

Check warning on line 17 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L17

Did you really mean 'UIKit'?

Check warning on line 17 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L17

Did you really mean 'injectable'?

## Core Classes

### CometChatUIKit

The main entry point for initializing and configuring the UIKit.

Check warning on line 23 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L23

Did you really mean 'UIKit'?

```typescript expandable
class CometChatUIKit {
Expand All @@ -39,7 +39,7 @@
```

<Note>
The UIKit exposes two session-check methods with intentionally different casing — this mirrors the underlying CometChat SDK naming.

Check warning on line 42 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L42

Did you really mean 'UIKit'?

- `getLoggedInUser()` (capital **I**, synchronous) — returns the in-memory cached user immediately. Use this for quick checks inside components where you already know the user is logged in.
- `getLoggedinUser()` (lowercase **i**, async) — makes an SDK call to verify the session. Use this in `ngOnInit` or `main.ts` before rendering components, as it is the authoritative check.
Expand Down Expand Up @@ -73,7 +73,7 @@
| `subscribePresenceForRoles(roles)` | `string[]` | — | Subscribe to presence updates for specific roles |
| `setAutoEstablishSocketConnection(auto)` | `boolean` | `true` | Auto-establish WebSocket connection on init |
| `setCallingEnabled(enabled)` | `boolean` | `false` | Enable voice/video calling. When `true`, the Calls SDK is initialized after login and call buttons become visible in MessageHeader, CallButtons, and CallLogs. When `false` (default), call buttons are hidden and the Calls SDK is not initialized |
| `setCallAppSettings(settings)` | `any` | — | Custom `CallAppSettings` for the Calls SDK. Built via `CometChatUIKitCalls.CallAppSettingsBuilder`. If not set, the UIKit builds default settings from `appId` and `region` |

Check warning on line 76 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L76

Did you really mean 'UIKit'?
| `setStorageMode(mode)` | `CometChat.StorageMode` | `LOCAL` | Storage mode for the SDK |
| `setAdminHost(host)` | `string` | — | Override the admin host URL |
| `setClientHost(host)` | `string` | — | Override the client host URL |
Expand All @@ -91,7 +91,7 @@
| ChatStateService | Centralized chat state management service — tracks active user, group, and conversation across components | [ChatStateService](/ui-kit/angular/api-reference/chat-state-service) |
| MessageBubbleConfigService | Centralized message bubble view configuration — customize bubble parts globally or per message type | [MessageBubbleConfigService](/ui-kit/angular/api-reference/message-bubble-config-service) |
| CometChatTemplatesService | SDK-wide template customization service — shared and component-specific templates for all list components | [CometChatTemplatesService](/ui-kit/angular/api-reference/templates-service) |
| FormatterConfigService | Text formatter configuration service — manages text formatting rules and custom formatters | [FormatterConfigService](/ui-kit/angular/api-reference/formatter-config-service) |

Check warning on line 94 in ui-kit/angular/api-reference/introduction.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/introduction.mdx#L94

Did you really mean 'formatters'?
| RichTextEditorService | Rich text editor configuration service — controls editor behavior, toolbar options, and input modes | [RichTextEditorService](/ui-kit/angular/api-reference/rich-text-editor-service) |
| GlobalConfig | Centralized configuration via `COMETCHAT_GLOBAL_CONFIG` injection token — sets defaults for display, sound, calls, and more across all components | [GlobalConfig](/ui-kit/angular/customization/global-config) |

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
| Class | `SearchConversationsService` |
| Package | `@cometchat/chat-uikit-angular` v5.x |
| Import | `import { SearchConversationsService } from "@cometchat/chat-uikit-angular";` |
| Injected with | `private svc = inject(SearchConversationsService);` — `providedIn: 'root'`, no module wiring |
| Injected with | `private svc = inject(SearchConversationsService);` — add `providers: [SearchConversationsService]` to your component. Not root-provided: `CometChatSearch` provides its own instance. |
| Key methods | `search` · `loadMore` · `attachListeners` · `detachListeners` · `reset` |
| Full API | See [Methods](#methods) |
| Usage | See [Usage](#usage) |
Expand Down Expand Up @@ -62,7 +62,7 @@

### loadMore()

Fetches the next page of results and appends to the existing list. Deduplicates by conversation ID.

Check warning on line 65 in ui-kit/angular/api-reference/search-conversations-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/search-conversations-service.mdx#L65

Did you really mean 'Deduplicates'?

```typescript
async loadMore(): Promise<void>
Expand Down Expand Up @@ -134,6 +134,7 @@
import { CometChatSearchFilter, States } from '@cometchat/chat-uikit-angular';

@Component({
providers: [SearchConversationsService],
selector: 'app-custom-search',
template: `
@switch (service.fetchState()) {
Expand Down
3 changes: 2 additions & 1 deletion ui-kit/angular/api-reference/search-messages-service.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
| Class | `SearchMessagesService` |
| Package | `@cometchat/chat-uikit-angular` v5.x |
| Import | `import { SearchMessagesService } from "@cometchat/chat-uikit-angular";` |
| Injected with | `private svc = inject(SearchMessagesService);` — `providedIn: 'root'`, no module wiring |
| Injected with | `private svc = inject(SearchMessagesService);` — add `providers: [SearchMessagesService]` to your component. Not root-provided: `CometChatSearch` provides its own instance. |
| Key methods | `search` · `loadMore` · `reset` |
| Full API | See [Methods](#methods) |
| Usage | See [Usage](#usage) |
Expand Down Expand Up @@ -61,7 +61,7 @@
| `customBuilder` | `MessagesRequestBuilder` | Optional custom builder that overrides the default |
| `alwaysShowSeeMore` | `boolean` | When true, limits initial results to 3 (preview mode with "See more" button) |

Validation: search requires at least one of: non-empty keyword, active message filter, uid, or guid. Otherwise `fetchState` is set to `States.empty`.

Check warning on line 64 in ui-kit/angular/api-reference/search-messages-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/search-messages-service.mdx#L64

Did you really mean 'uid'?

Check warning on line 64 in ui-kit/angular/api-reference/search-messages-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/search-messages-service.mdx#L64

Did you really mean 'guid'?

### loadMore()

Expand All @@ -85,8 +85,8 @@

- `hideDeletedMessages(true)` — always excludes deleted messages
- `setSearchKeyword()` — when keyword is non-empty
- `setUID()` — when uid is provided (scoped to user)

Check warning on line 88 in ui-kit/angular/api-reference/search-messages-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/search-messages-service.mdx#L88

Did you really mean 'uid'?
- `setGUID()` — when guid is provided (scoped to group)

Check warning on line 89 in ui-kit/angular/api-reference/search-messages-service.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/api-reference/search-messages-service.mdx#L89

Did you really mean 'guid'?
- `hasLinks(true)` — when the `Links` filter is active
- `setAttachmentTypes()` — maps filters to SDK attachment types:

Expand All @@ -110,6 +110,7 @@
import { CometChatSearchFilter, States } from '@cometchat/chat-uikit-angular';

@Component({
providers: [SearchMessagesService],
selector: 'app-message-search',
template: `
@if (service.fetchState() === States.loaded) {
Expand Down
2 changes: 1 addition & 1 deletion ui-kit/angular/api-reference/templates-service.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ interface MessageListTemplates {

### Shared Loading + Component-Specific Override

Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.

```typescript expandable
@Component({
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ import {
`,
})
export class AiChatComponent implements OnInit {
// A signal so the view updates when the fetch resolves — required in zoneless apps (Angular 21 default)
// A signal so the view updates when the fetch resolves — required in zoneless apps (the default since Angular 21)
agentUser = signal<CometChat.User | undefined>(undefined);

constructor(private streamingService: CometChatAIStreamingService) {}
Expand Down
6 changes: 5 additions & 1 deletion ui-kit/angular/components/cometchat-conversations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,10 +40,11 @@
- **Service-Based Architecture**: Clean separation of concerns with Angular best practices
- **Keyboard Navigation**: Full keyboard accessibility with arrow keys and shortcuts (WCAG 2.1 Level AA compliant)
- **Selection Modes**: Support for single and multiple conversation selection
- **Search Functionality**: Built-in search with debouncing

Check warning on line 43 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L43

Did you really mean 'debouncing'?
- **Context Menu**: Customizable actions for each conversation
- **Sound Notifications**: Optional notification sounds for new messages
- **Error Handling**: Comprehensive error handling with retry logic
- **Offline Support**: With offline support on, saved chats show at once and the list shows **Connect to load chats** offline with nothing saved. See [Offline Support](/ui-kit/angular/offline-support)

## Keyboard Accessibility

Expand Down Expand Up @@ -80,7 +81,7 @@
- `aria-label` with conversation details (name, last message, unread count)
- `aria-selected` indicates selected conversations
- `aria-live="polite"` region for screen reader announcements
- Proper `tabindex` management (roving tabindex pattern)

Check warning on line 84 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L84

Did you really mean 'tabindex'?

**Screen Reader Support:**
- Announces conversation details when focused
Expand All @@ -93,7 +94,7 @@
- Visible focus indicators (2px border) meeting WCAG contrast requirements
- Focus trap within modals (delete confirmation)
- Focus restoration after closing overlays
- Roving tabindex for efficient keyboard navigation

Check warning on line 97 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L97

Did you really mean 'tabindex'?
- High contrast mode support

**WCAG 2.1 Compliance:**
Expand Down Expand Up @@ -177,6 +178,7 @@
|----------|------|---------|-------------|
| `hideReceipts` | `boolean` | `false` | Hide message read receipts in conversation items |
| `hideError` | `boolean` | `false` | Hide error views when errors occur |
| `hideOfflineNotices` | `boolean` | `false` | Hide the notice shown when the offline cache was reset and unsent messages were lost. No effect while offline support is off. See [Offline Support](/ui-kit/angular/offline-support#hide-the-offline-notices) |
| `hidePinConversation` | `boolean` | `false` | Hide the pin/unpin option in the row context menu. See [Pinned Conversations](#pinned-conversations) |
| `hideDeleteConversation` | `boolean` | `false` | Hide delete option in context menu |
| `hideUserStatus` | `boolean` | `false` | Hide online/offline status indicators |
Expand Down Expand Up @@ -396,7 +398,7 @@
const isPinned = conversation.isPinned?.();
```

The presence of `pinnedAt` *is* the boolean — an unpinned conversation carries no key at all, so this is never "pinned at 0". `isPinned()` covers both a personal pin and an app-wide one; `isSystemPinned()` distinguishes them, which is preferable to comparing `getPinnedBy()` against `"app_system"` yourself. The accessor is optional-called because older Chat SDK builds do not expose it.

Check warning on line 401 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L401

Did you really mean 'accessor'?

### Behavior

Expand Down Expand Up @@ -1127,7 +1129,7 @@

Configure the ConversationsService to set defaults for all component instances:

Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name instead.

```typescript expandable
import { Component, OnInit } from '@angular/core';
Expand Down Expand Up @@ -1330,7 +1332,7 @@
- Clear focus indicators using the primary color
- Focus is maintained when navigating with keyboard
- Focus returns to the last focused item after menu interactions
- Focus is trapped within modal dialogs (context menus)

Check warning on line 1335 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L1335

Did you really mean 'dialogs'?

### High Contrast Mode

Expand Down Expand Up @@ -1427,12 +1429,14 @@

### Retry Logic

The service includes automatic retry logic with exponential backoff for recoverable errors:

Check warning on line 1432 in ui-kit/angular/components/cometchat-conversations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-conversations.mdx#L1432

Did you really mean 'backoff'?

- Network errors: Retries up to 3 times
- Timeout errors: Retries with increasing delays (1s, 2s, 4s)
- Authentication errors: No retry (requires user action)

With [offline support](/ui-kit/angular/offline-support) on, this retry does not run. A load that fails offline with nothing on screen shows **Connect to load chats** and loads once by itself when the connection is back; a real error shows the error view with Retry.

### Custom Error View

Provide a custom error view with retry functionality:
Expand Down
1 change: 1 addition & 0 deletions ui-kit/angular/components/cometchat-message-composer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@

### Key Features

- **Auto-Expanding Text Input**: Textarea that grows with content up to a configurable maximum height

Check warning on line 39 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L39

Did you really mean 'Textarea'?
- **Attachments**: Multi-attachment support for images, videos, audio, and files — staged in a tray and sent as a batch (see [Multiple Attachments](#multiple-attachments))
- **Rich Text Editing**: Optional rich text formatting using custom RichTextEditorService (bold, italic, lists, code blocks, etc.)
- **Emoji Picker**: Built-in emoji keyboard with category navigation
Expand All @@ -46,6 +46,7 @@
- **Full Accessibility**: WCAG 2.1 Level AA compliant with keyboard navigation and screen reader support
- **Extensive Customization**: Template inputs for all UI sections
- **Lightweight**: No external rich text editor dependencies (100KB+ smaller bundle)
- **Offline Support**: With offline support on, text messages sent offline are queued and sent on reconnect. Edits are never queued: a failed edit leaves edit mode and reaches the `(error)` output. See [Offline Support](/ui-kit/angular/offline-support#composer-and-sending)


<Info>
Expand Down Expand Up @@ -164,7 +165,7 @@
This layout is ideal for:
- Desktop applications with ample horizontal space
- Chat interfaces where vertical space is limited
- Traditional messaging UIs similar to Slack or Teams

Check warning on line 168 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L168

Did you really mean 'UIs'?

```typescript expandable
import { Component } from '@angular/core';
Expand Down Expand Up @@ -201,7 +202,7 @@
This layout is ideal for:
- Mobile applications where horizontal space is limited
- Interfaces where you want to maximize input area width
- Chat UIs that prioritize typing space over button visibility

Check warning on line 205 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L205

Did you really mean 'UIs'?

```typescript expandable
import { Component } from '@angular/core';
Expand Down Expand Up @@ -381,7 +382,7 @@

| Property | Type | Default | Description |
|----------|------|---------|-------------|
| `enableRichText` | `boolean` | `true` | Enable rich text editing. When disabled, pasting/adding content won't apply rich text formatting. Mentions and other formatters still work independently. |

Check warning on line 385 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L385

Did you really mean 'formatters'?
| `hideRichTextToolbar` | `boolean` | `false` | Hide the rich text formatting toolbar. |
| `showBubbleMenuOnSelection` | `boolean` | `false` | Show floating bubble menu when text is selected (Web/Desktop only) |

Expand All @@ -395,7 +396,7 @@
| `liveReactionIcon` | `string` | `undefined` | Custom icon for live reaction button |
| `messageToEdit` | `CometChat.BaseMessage` | `undefined` | Message to edit (enables edit mode) |
| `messageToReply` | `CometChat.BaseMessage` | `undefined` | Message to reply to (enables reply preview) |
| `textFormatters` | `CometChatTextFormatter[]` | `undefined` | Array of text formatters to apply |

Check warning on line 399 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L399

Did you really mean 'formatters'?
| `hideError` | `boolean` | `false` | Hides the built-in composer error UI (useful when using `(error)` or a custom `errorView`). |


Expand Down Expand Up @@ -706,7 +707,7 @@
- No external dependencies
- Smaller bundle size (100KB+ reduction)
- Full keyboard shortcut support
- XSS protection with HTML sanitization

Check warning on line 710 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L710

Did you really mean 'sanitization'?
- Unicode and emoji support
- Undo/redo with history grouping (500ms delay)

Expand Down Expand Up @@ -752,7 +753,7 @@
})
export class ComposerWithColorComponent {
group!: CometChat.Group;
// textFormatters replaces the built-ins, so list them alongside your own.

Check warning on line 756 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L756

Did you really mean 'Formatters'?
formatters: CometChatTextFormatter[] = [
new CometChatMentionsFormatter(),
new CometChatMarkdownFormatter(),
Expand Down Expand Up @@ -780,7 +781,7 @@

Your template is rendered as-is, with no wrapper class — style it yourself. It sits inside `.cometchat-message-composer__toolbar`, after an automatically inserted `.cometchat-message-composer__toolbar-separator`. Wrap several buttons in one element if you need more than one.

For a complete walkthrough that builds the formatter as well as the button, see the [Custom Text Formatter guide](/ui-kit/angular/guides/custom-text-formatter).

Check warning on line 784 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L784

Did you really mean 'walkthrough'?

### Rich Text Enhancements

Expand Down Expand Up @@ -828,7 +829,7 @@

#### Always-Visible Toolbar

Keep the formatting toolbar visible at all times for improved discoverability.

Check warning on line 832 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L832

Did you really mean 'discoverability'?

```typescript
<cometchat-message-composer
Expand All @@ -841,7 +842,7 @@

**Benefits:**
- Toolbar remains visible even when editor is empty
- Improved discoverability of formatting options

Check warning on line 845 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L845

Did you really mean 'discoverability'?
- Consistent UI with no layout shifts
- Ideal for professional/business contexts

Expand Down Expand Up @@ -1369,9 +1370,9 @@
}
```

## Text Formatters

Check warning on line 1373 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L1373

Did you really mean 'Formatters'?

The component supports custom text formatters for automatic text transformation and metadata extraction.

Check warning on line 1375 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L1375

Did you really mean 'formatters'?

### Built-in Formatters

Expand All @@ -1382,12 +1383,12 @@
- Supports @all mentions for groups

**CometChatUrlFormatter:**
- Detects URL patterns (http://, https://, www.)

Check warning on line 1386 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L1386

Did you really mean 'www'?
- Converts URLs to clickable links
- Opens links in new tabs
- Extracts URL metadata

### Using Custom Formatters

Check warning on line 1391 in ui-kit/angular/components/cometchat-message-composer.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-composer.mdx#L1391

Did you really mean 'Formatters'?

```typescript expandable
import { Component } from '@angular/core';
Expand Down
11 changes: 7 additions & 4 deletions ui-kit/angular/components/cometchat-message-list.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
| Standalone | Add `CometChatMessageListComponent` to the consuming component's `imports: []` or it renders **nothing**, silently |
| Primary output | `(threadRepliesClick)` — emits the parent message to open in a thread |
| Prerequisites | `CometChatUIKit.initFromSettings()` resolved **and** `login()` complete before render — see [Integration](/ui-kit/angular/integration) |
| Stitching | Bind `[user]` **or** `[group]` (never both). Wire `(threadRepliesClick)` → render `<cometchat-thread-header>` plus a second list with `[parentMessageId]`, or hide the reply affordance — a wired-but-dead reply button is a defect. See [Threaded Messages](/ui-kit/angular/guides/threaded-messages). |

Check warning on line 18 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L18

Did you really mean 'affordance'?
| Automatic behaviour | Real-time delivery, receipts, reactions, and every message-type bubble are rendered by the list — do not hand-roll bubbles |
| Sizing | Fills its container — an ancestor without a resolved height collapses it to 0px |
| Full props | see the page body |
Expand Down Expand Up @@ -43,9 +43,10 @@
- **Conversation Starters**: AI-generated conversation starters for empty conversations
- **Message Options**: Customizable context menu with actions like edit, delete, reply, forward
- **Reactions**: Support for message reactions with emoji picker
- **Text Formatters**: Extensible text formatting for mentions, links, and custom patterns

Check warning on line 46 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L46

Did you really mean 'Formatters'?
- **Keyboard Navigation**: Full keyboard accessibility (WCAG 2.1 Level AA compliant)
- **Sound Notifications**: notification sounds for new messages
- **Offline Support**: With offline support on, saved messages show at once, a **Connect to load more** row marks the end of what is saved, and unsent messages show **Not sent yet** or **Not sent. Tap to retry** with Retry and Delete. See [Offline Support](/ui-kit/angular/offline-support)


<Info>
Expand Down Expand Up @@ -87,10 +88,10 @@
`
})
export class ChatComponent implements OnInit {
// A signal so the view updates when the fetch resolves — required in zoneless apps (Angular 21 default)
// A signal so the view updates when the fetch resolves — required in zoneless apps (the default since Angular 21)
chatUser = signal<CometChat.User | undefined>(undefined);

async ngOnInit(): Promise<void> {

Check warning on line 94 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L94

Did you really mean 'ng'?
try {
this.chatUser.set(await CometChat.getUser('RECEIVER_UID'));
} catch (error) {
Expand Down Expand Up @@ -356,14 +357,14 @@
| `parentMessageId` | `number` | `undefined` | **Deprecated — pass `parentMessage` instead.** Enables thread mode by id. Still honoured when `parentMessage` is absent, so existing integrations keep working. |
| `messagesRequestBuilder` | `CometChat.MessagesRequestBuilder` | `undefined` | Custom request builder for advanced message filtering and pagination configuration. |
| `reactionsRequestBuilder` | `CometChat.ReactionsRequestBuilder` | `undefined` | Custom request builder for configuring how reactions are fetched. |
| `textFormatters` | `CometChatTextFormatter[]` | `undefined` | Array of text formatters for processing message text content (mentions, links, custom patterns). |

Check warning on line 360 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L360

Did you really mean 'formatters'?
| `messageAlignment` | `MessageListAlignment` | `MessageListAlignment.standard` | Message alignment mode. Options: `MessageListAlignment.left` (all messages left-aligned) or `MessageListAlignment.standard` (sent right, received left). The enum is numeric, so bind the enum member, not a string. |
| `scrollToBottomOnNewMessages` | `boolean` | `false` | When `true`, automatically scrolls to the bottom when new messages arrive. |
| `quickOptionsCount` | `number` | `2` | Number of quick action options to display directly on the message bubble. |
| `disableSoundForMessages` | `boolean` | `false` | When `true`, disables notification sounds for incoming messages. |
| `customSoundForMessages` | `string` | `undefined` | Custom sound URL to play for message notifications instead of the default sound. |
| `goToMessageId` | `string` | `undefined` | Message ID to scroll to and highlight when the component loads. |
| `showScrollbar` | `boolean` | `false` | When `true`, shows the scrollbar in the message list container. |

Check warning on line 367 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L367

Did you really mean 'scrollbar'?

#### Display Control Properties

Expand All @@ -375,12 +376,13 @@
| `hideAvatar` | `boolean` | `false` | Hides user avatars next to messages. |
| `hideGroupActionMessages` | `boolean` | `false` | Hides system messages for group actions (member joined, left, etc.). |
| `hideError` | `boolean` | `false` | Hides error views when errors occur during message loading. |
| `hideOfflineNotices` | `boolean` | `false` | Hides the offline notices about unsent messages (removed, not sent, outbox full, send under way, cache reset, and the other notices listed on the Offline Support page). No effect while offline support is off. See [Offline Support](/ui-kit/angular/offline-support#hide-the-offline-notices). |
| `hideReplyInThreadOption` | `boolean` | `false` | Hides the "Reply in Thread" option from message context menu. |
| `hideThreadSubscriptionOption` | `boolean` | `false` | Hides the thread follow/unfollow option from the message context menu, without turning the feature off. See [Thread Subscription](#thread-subscription). |
| `hidePinMessageOption` | `boolean` | `false` | Hides "Pin message" from the Organise flyout. See [Pin and Save](#pin-and-save). |

Check warning on line 382 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L382

Did you really mean 'flyout'?
| `hideUnpinMessageOption` | `boolean` | `false` | Hides "Unpin message" from the Organise flyout. |

Check warning on line 383 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L383

Did you really mean 'flyout'?
| `hideSaveMessageOption` | `boolean` | `false` | Hides "Save message" from the Organise flyout. |

Check warning on line 384 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L384

Did you really mean 'flyout'?
| `hideUnsaveMessageOption` | `boolean` | `false` | Hides "Unsave message" from the Organise flyout. |

Check warning on line 385 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L385

Did you really mean 'Unsave'?

Check warning on line 385 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L385

Did you really mean 'flyout'?
| `hideTranslateMessageOption` | `boolean` | `false` | Hides the "Translate" option from message context menu. |
| `hideEditMessageOption` | `boolean` | `false` | Hides the "Edit" option from message context menu (only shown for own text messages). |
| `hideDeleteMessageOption` | `boolean` | `false` | Hides the "Delete" option from message context menu (only shown for own messages). |
Expand Down Expand Up @@ -456,9 +458,9 @@

### Pin and Save

**Pin message** and **Save message** are gathered under an **Organise ▸** flyout, placed before Translate. The flyout is omitted entirely when neither action applies, rather than opening onto nothing.

Check warning on line 461 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L461

Did you really mean 'flyout'?

Check warning on line 461 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L461

Did you really mean 'flyout'?

The menu shows Pin **or** Unpin, and Save **or** Unsave — never a toggling third state — because the presence of `pinnedAt` / `savedAt` on the message *is* the boolean.

Check warning on line 463 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L463

Did you really mean 'Unsave'?

```html expandable
<cometchat-message-list
Expand All @@ -470,20 +472,20 @@

| Behavior | Detail |
|:---|:---|
| Feature gate | The `features.ux.messages.pinned.enabled` / `features.ux.messages.saved.enabled` app settings, reported by `CometChat.isPinMessageEnabled()` / `isSaveMessageEnabled()` and overridable via `enablePinMessage` / `enableSaveMessage` in global config |

Check warning on line 475 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L475

Did you really mean 'overridable'?
| Eligibility | Excludes deleted, in-flight, moderation-held, and `action` category messages. Thread replies **are** eligible |
| Pin permission | No client-side role gate — Pin is offered to every member and the server decides, refusing with `ERR_PERMISSION_DENIED`. The one client-side exception is a system pin, whose Unpin is withheld. Saving has no gate |
| Confirmation | Pin and Save run immediately; **Unpin and Unsave ask first** |

Check warning on line 478 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L478

Did you really mean 'Unsave'?
| Indicators | Pinned and saved bubbles keep their status-info footer and show a marker there, even mid-batch |

See the [Pin and Save guide](/ui-kit/angular/guides/pin-and-save-messages) for the full feature.

<Warning>
**These outputs are affordances, not behaviour — an unbound output leaves a visible control that does nothing.**

Check warning on line 484 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L484

Did you really mean 'affordances'?

The thread-replies indicator is the one that bites. It renders automatically on any message that has replies, and it is clickable whether or not you bind `(threadRepliesClick)`. Leave it unbound and the user clicks it, nothing happens, and there is no error in the console to explain why — the component simply emitted into a listener that was never attached.

Either wire the output to a thread surface (`<cometchat-thread-header>` plus a second `<cometchat-message-list>` bound to `[parentMessageId]`), or hide the affordance. Do not ship it visible and dead. The same applies to `smartReplyClick`, `conversationStarterClick` and `messagePrivatelyClick`.

Check warning on line 488 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L488

Did you really mean 'affordance'?
</Warning>


Expand Down Expand Up @@ -591,6 +593,7 @@
| `getMessageOptions` | `message: CometChat.BaseMessage` | `CometChatActionsIcon[]` | Returns the available context menu options for a message based on hide* inputs. |
| `handleKeydown` | `event: KeyboardEvent` | `void` | Handles keyboard navigation events. Called automatically but can be triggered manually. |
| `handleRetryClick` | none | `void` | Retries loading messages after an error. |
| `retryOfflineRead` | none | `void` | Offline support: reads the page behind the **Connect to load more** row, as tapping the row does. See [Offline Support](/ui-kit/angular/offline-support#your-own-connect-to-load-more-control). |
| `copyMessageToClipboard` | `message: CometChat.BaseMessage` | `Promise<void>` | Copies the text content of a message to the clipboard. |

### CalendarObject Interface
Expand Down Expand Up @@ -641,7 +644,7 @@

### Usage Examples for Complex Properties

#### Custom Text Formatters

Check warning on line 647 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L647

Did you really mean 'Formatters'?

```typescript expandable
import {
Expand Down Expand Up @@ -739,7 +742,7 @@

### Customization Approaches

CometChat UIKit offers multiple ways to customize the message list:

Check warning on line 745 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L745

Did you really mean 'UIKit'?

| Approach | Use Case | Scope |
|----------|----------|-------|
Expand All @@ -747,7 +750,7 @@
| **Service-based** | Global customization via MessageBubbleConfigService | All message list instances |
| **CSS Variables** | Visual styling and theming | Global or scoped |
| **Custom Templates** | Complete control over message rendering | Per message type or global |
| **Text Formatters** | Custom text processing and formatting | All text messages |

Check warning on line 753 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L753

Did you really mean 'Formatters'?

---

Expand Down Expand Up @@ -1158,7 +1161,7 @@

By default, `MessageBubbleConfigService` and `FormatterConfigService` are provided at the root level (`providedIn: 'root'`), meaning all message list instances share the same configuration. This works well for most applications.

However, if you need different bubble styles or formatters for different message lists (e.g., a main chat panel and a thread panel side by side), you can scope these services to a wrapper component using Angular's hierarchical dependency injection.

Check warning on line 1164 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1164

Did you really mean 'formatters'?

<Note>
Each `<cometchat-message-list>` already gets its own `MessageListService` instance automatically (the component provides it internally). The scoping technique below applies only to customization services like `MessageBubbleConfigService` and `FormatterConfigService`.
Expand Down Expand Up @@ -1282,13 +1285,13 @@
---


### Custom Text Formatters

Check warning on line 1288 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1288

Did you really mean 'Formatters'?

Text formatters allow you to process and transform message text content. They can detect patterns like mentions, URLs, hashtags, or custom patterns and apply formatting.

Check warning on line 1290 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1290

Did you really mean 'formatters'?

#### Understanding Text Formatters

Check warning on line 1292 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1292

Did you really mean 'Formatters'?

Text formatters extend the `CometChatTextFormatter` base class:

Check warning on line 1294 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1294

Did you really mean 'formatters'?

```typescript expandable
import { CometChat } from '@cometchat/chat-sdk-javascript';
Expand Down Expand Up @@ -1412,7 +1415,7 @@
}
```

#### Using Custom Formatters

Check warning on line 1418 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1418

Did you really mean 'Formatters'?

```typescript expandable
import { Component, OnInit } from '@angular/core';
Expand Down Expand Up @@ -1470,7 +1473,7 @@
```

<Note>
Formatters are applied in order of their `priority` property (lower numbers run first). Each formatter receives the output of the previous formatter as its input.

Check warning on line 1476 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1476

Did you really mean 'Formatters'?
</Note>

---
Expand Down Expand Up @@ -1562,7 +1565,7 @@

### CSS Variable Customization

CometChat UIKit uses CSS variables for styling, making it easy to customize the appearance without modifying component code. Override these variables in your global styles or scoped to specific components.

Check warning on line 1568 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1568

Did you really mean 'UIKit'?

#### Core CSS Variables

Expand Down Expand Up @@ -1746,7 +1749,7 @@

### Theming (Light/Dark Mode)

CometChat UIKit supports both light and dark themes through CSS variables. The theme is controlled by the `data-theme` attribute on the root element.

Check warning on line 1752 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1752

Did you really mean 'UIKit'?

#### Switching Themes

Expand Down Expand Up @@ -1926,7 +1929,7 @@
```

<Tip>
Use CSS variables consistently throughout your application to ensure theme changes propagate correctly. Avoid hardcoding color values in component styles.

Check warning on line 1932 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L1932

Did you really mean 'hardcoding'?
</Tip>

---
Expand Down Expand Up @@ -2278,7 +2281,7 @@
<Warning>
`parentMessageId` is **deprecated**. Pass the whole `parentMessage` instead.

The id alone cannot answer "is this thread subscribed right now", and a reply arriving over the socket carries no subscription flag of its own — it has to inherit the parent's. A list holding only the id therefore renders realtime replies with the wrong subscription state in their action menu. The id used for scoping is derived from `parentMessage` when it is present, so passing both is redundant; passing only the id still works, it just opts out of realtime subscription state on replies.

Check warning on line 2284 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L2284

Did you really mean 'realtime'?

Check warning on line 2284 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L2284

Did you really mean 'realtime'?
</Warning>

Re-pass `parentMessage` when the parent updates in real time, so the list keeps reading its current state.
Expand Down Expand Up @@ -3240,11 +3243,11 @@

| Key | Action | Context |
|-----|--------|---------|
| `Tab` | Move focus to next focusable element | Global navigation |

Check warning on line 3246 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3246

Did you really mean 'focusable'?
| `Shift + Tab` | Move focus to previous focusable element | Global navigation |

Check warning on line 3247 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3247

Did you really mean 'focusable'?
| `Enter` | Activate focused button or link | Buttons, links, interactive elements |
| `Space` | Activate focused button, toggle checkbox | Buttons, checkboxes, toggles |
| `Escape` | Close modal, menu, or panel; Cancel current action | Modals, context menus, thread panels, dialogs |

Check warning on line 3250 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3250

Did you really mean 'dialogs'?
| `Arrow Up` | Navigate to previous item in list | Context menus, reaction picker, message options |
| `Arrow Down` | Navigate to next item in list | Context menus, reaction picker, message options |
| `Arrow Left` | Navigate to previous option | Horizontal option lists, emoji picker |
Expand Down Expand Up @@ -3335,11 +3338,11 @@

The component implements proper focus management for a seamless keyboard experience:

1. **Focus Trapping in Modals**: When dialogs (delete confirmation, flag message, etc.) are open, focus is trapped within the modal until it's closed.

Check warning on line 3341 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3341

Did you really mean 'dialogs'?

2. **Focus Restoration**: When a modal or menu is closed, focus returns to the element that triggered it.

3. **Visible Focus Indicators**: All focusable elements have visible focus indicators using CSS:

Check warning on line 3345 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3345

Did you really mean 'focusable'?

```css expandable
/* Focus indicator styles (built into the component) */
Expand Down Expand Up @@ -3372,13 +3375,13 @@
| `role="list"` | Message container | Identifies the message container as a list |
| `role="listitem"` | Message bubble | Identifies each message as a list item |
| `role="button"` | Interactive elements | Identifies clickable elements as buttons |
| `role="dialog"` | Modals | Identifies modal dialogs |

Check warning on line 3378 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3378

Did you really mean 'dialogs'?
| `role="menu"` | Context menu | Identifies the context menu |
| `role="menuitem"` | Menu options | Identifies individual menu items |
| `role="status"` | Status indicators | Identifies status information (typing, receipts) |
| `role="alert"` | Error messages | Identifies important alerts |
| `aria-label` | Buttons, icons | Provides accessible names for elements without visible text |
| `aria-labelledby` | Dialogs, sections | References the element that labels this element |

Check warning on line 3384 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3384

Did you really mean 'Dialogs'?
| `aria-describedby` | Complex elements | References elements that describe this element |
| `aria-live` | Dynamic content | Announces content changes to screen readers |
| `aria-expanded` | Expandable elements | Indicates whether an element is expanded or collapsed |
Expand Down Expand Up @@ -3497,7 +3500,7 @@
</div>
```

**Modal Dialogs:**

Check warning on line 3503 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3503

Did you really mean 'Dialogs'?
```html expandable
<!-- Delete confirmation dialog -->
<div
Expand Down Expand Up @@ -3605,8 +3608,8 @@
- [ ] Error messages are announced immediately
- [ ] Loading states are announced

**Dialogs and Modals:**

Check warning on line 3611 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3611

Did you really mean 'Dialogs'?
- [ ] Dialogs are announced when opened

Check warning on line 3612 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L3612

Did you really mean 'Dialogs'?
- [ ] Focus moves to dialog when opened
- [ ] Can navigate dialog with Tab key
- [ ] Escape key closes dialog
Expand Down Expand Up @@ -4082,7 +4085,7 @@
}
```

#### 3. Implement trackBy for Custom Lists

Check warning on line 4088 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4088

Did you really mean 'trackBy'?

If you render additional lists within message templates, always use `trackBy`:

Expand Down Expand Up @@ -4126,9 +4129,9 @@
}
```

#### 5. Debounce Scroll Events

Check warning on line 4132 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4132

Did you really mean 'Debounce'?

If you add custom scroll handlers, debounce them to prevent performance issues:

Check warning on line 4134 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4134

Did you really mean 'debounce'?

```typescript expandable
import { Component, OnInit, OnDestroy } from '@angular/core';
Expand Down Expand Up @@ -4169,9 +4172,9 @@
}
```

#### 6. Optimize Text Formatters

Check warning on line 4175 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4175

Did you really mean 'Formatters'?

Keep text formatters efficient by avoiding complex regex patterns:

Check warning on line 4177 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4177

Did you really mean 'formatters'?

```typescript expandable
// ❌ BAD: Complex regex with backtracking
Expand Down Expand Up @@ -4569,7 +4572,7 @@
|--------|---------|--------|--------------|
| CPU | Fast | Limited | Reduce JS execution time |
| Memory | 8-16GB | 2-4GB | Limit message history |
| Network | Fast | Variable | Implement offline support |
| Network | Fast | Variable | Turn on [offline support](/ui-kit/angular/offline-support) |
| Battery | N/A | Critical | Reduce background processing |
| Touch | N/A | Primary | Optimize touch handlers |

Expand Down Expand Up @@ -4661,8 +4664,8 @@
#### Runtime Optimization
- [ ] Avoid expensive computations in templates
- [ ] Use `trackBy` for all `@for` loops
- [ ] Debounce scroll and resize event handlers

Check warning on line 4667 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4667

Did you really mean 'Debounce'?
- [ ] Keep text formatters simple and efficient

Check warning on line 4668 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4668

Did you really mean 'formatters'?

#### Memory Management
- [ ] Clean up subscriptions on component destroy
Expand All @@ -4673,7 +4676,7 @@
#### Mobile Optimization
- [ ] Reduce page size for mobile devices
- [ ] Implement touch-optimized interactions
- [ ] Consider offline support for poor connectivity
- [ ] Consider [offline support](/ui-kit/angular/offline-support) for poor connectivity
- [ ] Test on actual mobile devices

#### Monitoring
Expand All @@ -4687,7 +4690,7 @@
</Tip>

<Warning>
Avoid premature optimization. Focus on the most impactful optimizations first (pagination, lazy loading, change detection) before micro-optimizing. Always measure before and after changes to verify improvements.

Check warning on line 4693 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L4693

Did you really mean 'impactful'?
</Warning>


Expand All @@ -4708,7 +4711,7 @@

This example demonstrates the complete setup process for integrating CometChatMessageList into your Angular application, including CometChat initialization, user login, and component configuration.

Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 17–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name in `main.ts` instead.
Angular 20+ names the root component `App` in `src/app/app.ts`, as below. A project created with Angular 18–19 uses `AppComponent` in `src/app/app.component.ts` — use that file and class name in `main.ts` instead.

<Tabs>
<Tab title="Complete Setup">
Expand Down Expand Up @@ -5248,14 +5251,14 @@

<Step title="Install Dependencies">
```bash
npm install @cometchat/chat-uikit-angular @cometchat/chat-sdk-javascript @cometchat/cards-angular dompurify

Check warning on line 5254 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L5254

Did you really mean 'dompurify'?
```
</Step>

<Step title="Update Configuration">
Replace placeholder values in the code:
- `YOUR_APP_ID` → Your CometChat App ID
- `YOUR_REGION` → Your region (us, eu, in, etc.)

Check warning on line 5261 in ui-kit/angular/components/cometchat-message-list.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-message-list.mdx#L5261

Did you really mean 'eu'?
- `YOUR_AUTH_KEY` → Your Auth Key
- `CURRENT_USER_ID` → The logged-in user's ID
- `RECEIVER_USER_ID` → The user ID to chat with
Expand Down
4 changes: 3 additions & 1 deletion ui-kit/angular/components/cometchat-search.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
| Primary output | `(messageClick)` — emits the matched message to jump to |
| Prerequisites | `CometChatUIKit.initFromSettings()` resolved **and** `login()` complete before render — see [Integration](/ui-kit/angular/integration) |
| Stitching | Set scope via `[searchIn]` / `[searchFilters]`; pass `[uid]`/`[guid]` to scope to one chat. Render as a column, not an overlay — see [Search Messages](/ui-kit/angular/guides/search-messages). |
| Automatic behaviour | Debounce and pagination are handled internally |

Check warning on line 19 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L19

Did you really mean 'Debounce'?
| Sizing | Fills its container — an ancestor without a resolved height collapses it to 0px |
| Full props | See [Properties](#properties) |
| Events | See [Events](#events) |
Expand All @@ -26,7 +26,7 @@

## Overview

The CometChatSearch component provides a unified search experience across conversations and messages. It combines a debounced search input, a filter chip bar, and two lazy-loaded result sections (conversations and messages) into a single, cohesive UI.

Check warning on line 29 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L29

Did you really mean 'debounced'?

The component follows a **service-driven architecture**:
- **SearchConversationsService** handles conversation search queries, pagination, and real-time listener updates
Expand All @@ -39,7 +39,7 @@
- **Cross-Entity Search**: Search across both conversations and messages simultaneously, or scope to one
- **9 Filter Types**: Audio, Documents, Groups, Photos, Videos, Links, Unread, Conversations, Messages
- **Scoped Search**: Narrow results to a specific user (`uid`) or group (`guid`)
- **Debounced Input**: 500ms debounce prevents excessive SDK calls while typing

Check warning on line 42 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L42

Did you really mean 'Debounced'?

Check warning on line 42 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L42

Did you really mean 'debounce'?
- **Lazy-Loaded Sections**: Conversation and message result lists use `@defer` for optimal initial load
- **Unified State Views**: Single empty/error view when both sections report the same state
- **Template Customization**: Override any section of conversation or message result items
Expand Down Expand Up @@ -160,7 +160,7 @@
| `conversationsRequestBuilder` | `ConversationsRequestBuilder` | `undefined` | Custom request builder for conversation search queries |
| `messagesRequestBuilder` | `MessagesRequestBuilder` | `undefined` | Custom request builder for message search queries |
| `conversationOptions` | `(conv: Conversation) => CometChatOption[]` | `undefined` | Function to provide custom context menu options for conversation results |
| `textFormatters` | `CometChatTextFormatter[]` | `[]` | Custom text formatters for message content display |

Check warning on line 163 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L163

Did you really mean 'formatters'?
| `messageSentAtDateTimeFormat` | `CalendarObject` | `undefined` | Custom date/time format for message timestamps |

### Display Control Properties
Expand Down Expand Up @@ -312,6 +312,8 @@

When only one scope is active (via `searchIn`, `uid`, or `guid`), that section handles its own empty/error states independently.

With [offline support](/ui-kit/angular/offline-support#search) on, a keyword search that cannot reach the server, with no saved match, shows **Connect to search** instead of an error when every failed request was a not-connected one, and runs again once when the connection is back. Errors still reach `(searchError)`.


## Advanced Usage

Expand Down Expand Up @@ -637,7 +639,7 @@
**Focus Management:**
- Search input auto-focuses on component load
- Clear button restores focus to search input after clearing
- Result items are focusable with `tabindex="0"` (message results)

Check warning on line 642 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L642

Did you really mean 'focusable'?
- Visible focus indicators meeting WCAG contrast requirements

## Styling with CSS Variables
Expand Down Expand Up @@ -733,7 +735,7 @@

### Error State Behavior

- If only one section errors while the other has results, the errored section shows its own error view with its section header

Check warning on line 738 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L738

Did you really mean 'errored'?
- If both sections error, a single unified error view is shown without section headers
- Custom `errorView` templates are used when provided

Expand Down Expand Up @@ -850,7 +852,7 @@
- **Change Detection**: Uses `OnPush` strategy for optimal performance
- **Lazy Loading**: Child result components use `@defer` blocks for code splitting
- **Signal-Based State**: Services use Angular signals for reactive state management
- **Debounced Search**: 500ms debounce on the search input to reduce SDK calls

Check warning on line 855 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L855

Did you really mean 'Debounced'?

Check warning on line 855 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L855

Did you really mean 'debounce'?
- **BEM CSS**: Follows Block Element Modifier naming convention (`cometchat-search__*`)
- **Localization**: All text uses the `translate` pipe for i18n support

Expand All @@ -861,5 +863,5 @@
- [SearchConversationsService](/ui-kit/angular/api-reference/search-conversations-service) — Conversation search state, SDK queries, real-time listeners
- [SearchMessagesService](/ui-kit/angular/api-reference/search-messages-service) — Message search state, attachment-type filtering, scoped queries
- [CometChatTemplatesService](/ui-kit/angular/api-reference/templates-service) — Template resolution priority chain and global template overrides
- [Accessibility](/ui-kit/angular/accessibility#search) — Cross-component keyboard accessibility reference
- [Accessibility](/ui-kit/angular/accessibility) — Cross-component keyboard accessibility reference
- [Events](/ui-kit/angular/events) — UIKit event bus for decoupled component communication

Check warning on line 867 in ui-kit/angular/components/cometchat-search.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

ui-kit/angular/components/cometchat-search.mdx#L867

Did you really mean 'UIKit'?
Loading