Cometchat I18n

## Purpose

Localize the CometChat UI Kit to the user's language. Every kit ships with English + ~15 bundled languages (Arabic, Bengali, Chinese, German, Spanish, French, Hindi, Indonesian, Italian, Japanese, Korean, Malay, Portuguese, Russian, Swedish, Turkish — exact set varies by kit version). Custom languages can be added at runtime.

The biggest gotcha: **the `init` signature differs across kits and major versions**. The same audit pass that caught calls API drift caught one of these too (Angular Localize positional signature) — this skill is the canonical reference.

---

## API surface per family

### React (v6) — object signature

```ts
import { CometChatLocalize } from "@cometchat/chat-uikit-react";

CometChatLocalize.init({
  language: "es",
  fallbackLanguage: "en",
});
```

Object literal. `init({ ... })`.

### React Native (v5) — object signature

```ts
import { CometChatLocalize } from "@cometchat/chat-uikit-react-native";

CometChatLocalize.init({
  language: "es",
  fallbackLanguage: "en",
});
```

Same object signature as React.

### Angular (v4) — POSITIONAL signature

```ts
import { CometChatLocalize } from "@cometchat/chat-uikit-angular";

CometChatLocalize.init("es");
// or with custom resources:
CometChatLocalize.init("es", { es: { CHAT: "Charla" } });
```

**Positional, not object.** This was the v4.0 audit fix — calling `.init({ language: "es" })` on Angular sets `language = [object Object]` and silently breaks translations. The skill's verification checklist flags this drift.

### Android V5 — Java/Kotlin static method

```kotlin
// Kotlin
CometChatLocalize.setLocale(Locale.forLanguageTag("es"))
```

```java
// Java
CometChatLocalize.setLocale(Locale.forLanguageTag("es"));
```

`setLocale`, not `init`. Takes a `java.util.Locale`.

### Android V6 (beta) — same as V5

V6 keeps the `setLocale(Locale)` API. No drift here.

### iOS V5

```swift
import CometChatUIKitSwift

CometChatLocalize.setLocale(locale: "es")
```

`setLocale(locale:)`. Takes a String, not `Locale`.

### Flutter V5 (GetX-based)

```dart
import 'package:cometchat_calls_uikit/cometchat_calls_uikit.dart';

CometChatLocalize.init(language: 'es');
```

Named-arg, not positional. Single string.

### Flutter V6 (Bloc-based)

```dart
import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';

CometChatLocalize.init(language: 'es');
```

Same as V5 in Flutter — named arg.

---

## Cross-family signature summary

| Family | Init call | Notes |
|---|---|---|
| React (v6) | `CometChatLocalize.init({ language, fallbackLanguage })` | Object |
| React Native (v5) | `CometChatLocalize.init({ language, fallbackLanguage })` | Object |
| **Angular (v4)** | `CometChatLocalize.init("es")` | **Positional — drift trap** |
| Android (V5/V6) | `CometChatLocalize.setLocale(Locale.forLanguageTag("es"))` | Method name `setLocale`, takes `Locale` |
| iOS (V5) | `CometChatLocalize.setLocale(locale: "es")` | Method name `setLocale`, takes String |
| Flutter (V5/V6) | `CometChatLocalize.init(language: 'es')` | Named arg |

The agent must consult this table before writing any localization code. **Verify against the installed package's type definitions** if uncertain — symbol drift between mino