@cometchat/skills 4.4.1 → 5.0.0

package/skills/cometchat-android-v6-calls/references/group-calls.md

@@ -1,191 +0,0 @@
-# Group calls — broadcast meeting pattern (Android V6)
-
-Group calls use a **different signaling channel than 1:1 user calls**. The Ringing flow (`CometChat.initiateCall` → `onIncomingCallReceived` on peer) is **1:1 user only**. For groups, the kit broadcasts a **custom message of type `"meeting"`** to the group; receivers see a "Join meeting" card in `CometChatMessageList` (kit) or need an explicit `MessageListener.onCustomMessageReceived` (custom UI).
-
-By-design kit behavior — same semantic across all CometChat kits.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/android/group-calls
-
-V6 specifics: this applies equally to Compose and Kotlin Views surfaces. Calls bundling into V6's chatuikit module doesn't change the signaling — the kit's `CometChatCallButtons` composable (or Views equivalent) sends the same meeting `CustomMessage` as V5.
-
----
-
-## Architecture
-
-```
-Caller (uidA, member of groupX)        CometChat                Receivers (members of groupX)
-  │                                       │                              │
-  │ CometChatCallButtons sends            │                              │
-  │ CustomMessage(GUID, GROUP, "meeting", │                              │
-  │   { callType, sessionId })            │                              │
-  ├──────────────────────────────────────>│                              │
-  │                                       │ onCustomMessageReceived      │
-  │                                       ├─────────────────────────────>│
-  │  caller jumps to OngoingCall surface  │  receiver taps Join          │
-  │     sessionId = groupGuid             │  → joinSession(GUID)         │
-  ├──────────────────────────────────────>│ <─────────────────────────── │
-  │            ───── WebRTC session active (sessionId = group GUID) ─────│
-```
-
-| Channel | 1:1 user calls | Group calls |
-|---|---|---|
-| Signaling | `CometChat.initiateCall(call, callback)` | `CometChat.sendCustomMessage(message, callback)` (type="meeting") |
-| Receiver event | `CallListener.onIncomingCallReceived` | `MessageListener.onCustomMessageReceived` |
-| Session ID | server-generated unique | group's GUID (persistent) |
-| Ring/decline | yes — `acceptCall` / `rejectCall` | no — receivers join or ignore |
-
----
-
-## Hard rules
-
-1. **Group calls broadcast a custom message; they do NOT use the call listener.** Add a `MessageListener` for custom UI.
-2. **Session ID = group GUID.** Persistent.
-3. **V6's "five required workarounds" (W1–W5 in SKILL.md) apply to group calls too** — same calls-sdk-android peer dep, same `Call` constructor arg order, same stub classes. Group calls share the underlying WebRTC layer.
-4. **No `CometChat.endCall` for groups.** Use `CallSession.getInstance().leaveSession()` only.
-
----
-
-## Caller side — Compose (kit)
-
-```kotlin
-import com.cometchat.chatuikit.calls.callbuttons.CometChatCallButtons
-
-@Composable
-fun GroupHeader(group: Group) {
-    Row {
-        Text(group.name)
-        // ⚠️ V6 W4 — DO NOT use CometChatCallButtons composable for 1:1 user
-        // calls (broken in 6.0.0 — captures first-rendered user globally).
-        // For groups, the composable's same bug may or may not apply; check
-        // current chatuikit-compose-android version's release notes.
-        CometChatCallButtons(group = group)
-    }
-}
-```
-
-The kit's `CometChatCallButtons(group = group)` composable sends the same `CustomMessage` of type `"meeting"` as the Kotlin Views variant. V6 W4 (the per-row state-capture bug) primarily affects the `user` prop variant; group-targeted use may be safer but verify against the installed version.
-
-## Caller side — Kotlin Views (kit)
-
-```kotlin
-val callButtons = CometChatCallButtons(this).apply {
-    setGroup(group)
-}
-```
-
-Same behavior as V5.
-
-## Caller side — custom UI
-
-```kotlin
-import com.cometchat.chat.core.CometChat
-import com.cometchat.chat.models.CustomMessage
-import com.cometchat.chat.constants.CometChatConstants
-import org.json.JSONObject
-
-fun startGroupCall(groupGuid: String, callType: String) {
-    val sessionId = groupGuid
-    val customData = JSONObject().apply {
-        put("callType", callType)
-        put("sessionId", sessionId)
-    }
-    val meetingMessage = CustomMessage(
-        groupGuid,
-        CometChatConstants.RECEIVER_TYPE_GROUP,
-        "meeting",
-        customData,
-    ).apply {
-        category = CometChatConstants.CATEGORY_CUSTOM
-        metadata = JSONObject().apply {
-            put("incrementUnreadCount", true)
-            put("pushNotification", "meeting")
-            put("callType", callType)
-            put("sessionId", sessionId)
-        }
-    }
-    CometChat.sendCustomMessage(meetingMessage, object : CometChat.CallbackListener<CustomMessage>() {
-        override fun onSuccess(p0: CustomMessage) {
-            // navigate to your OngoingCall composable / Activity with sessionId
-        }
-        override fun onError(p0: CometChatException) { /* surface */ }
-    })
-}
-```
-
----
-
-## Receiver side — kit-based (auto-renders meeting card)
-
-`CometChatMessageList(group = group)` (Compose) or the Kotlin Views equivalent renders the meeting message as a "Join meeting" card.
-
-## Receiver side — custom UI
-
-```kotlin
-private val GROUP_MEETING_LISTENER_ID = "APP_ROOT_GROUP_MEETING_LISTENER"
-
-CometChat.addMessageListener(GROUP_MEETING_LISTENER_ID, object : CometChat.MessageListener() {
-    override fun onCustomMessageReceived(msg: CustomMessage) {
-        if (msg.category != CometChatConstants.CATEGORY_CUSTOM) return
-        if (msg.type != "meeting") return
-        val customData = msg.customData ?: return
-        val sessionId = customData.optString("sessionId", msg.receiverUid)
-        val callType = customData.optString("callType", "video")
-        val fromUid = msg.sender.uid
-        val groupGuid = msg.receiverUid
-        // Compose: state.update { it.copy(incomingMeeting = ...) }
-        // Views: runOnUiThread { showIncomingMeetingDialog(...) }
-    }
-})
-
-// Cleanup:
-DisposableEffect(Unit) {
-    onDispose { CometChat.removeMessageListener(GROUP_MEETING_LISTENER_ID) }
-}
-```
-
-Wrap in `DisposableEffect` (Compose) or `onDestroy()` (Views).
-
----
-
-## Edge cases
-
-### Late joining
-
-Meeting message persists in chat history. Tap to join — works hours after.
-
-### V6 calls-sdk-android peer dep
-
-Same W1 workaround applies to group calls — `com.cometchat:calls-sdk-android:5.0.+` must be an explicit peer dep in `app/build.gradle.kts`. Without it, group-call join fails the same way 1:1 join fails.
-
-### Push notifications
-
-Meeting `CustomMessage.metadata.pushNotification = "meeting"` — routed via regular FCM. No ConnectionService-ring out of the box.
-
----
-
-## Anti-patterns
-
-1. **Registering `CometChat.addCallListener` only — expecting group ringing.** Won't fire.
-2. **Skipping the V6 W1–W5 workarounds for groups.** They apply equally — calls-sdk-android peer dep, annotations-java5 exclude, stub classes, Call constructor arg order, avoid V6 `CometChatCallButtons` composable per-row bug.
-3. **`CometChat.endCall(sessionId)` after group hangup.** No call entity. Use `CallSession.getInstance().leaveSession()`.
-4. **Treating sessionId as ephemeral.** It's the group GUID.
-
----
-
-## Verification checklist
-
-- [ ] V6 workarounds W1–W5 applied (calls-sdk-android peer dep + manifest etc. — see SKILL.md §"Five required workarounds")
-- [ ] Kit caller: `CometChatCallButtons(group = ...)` / `setGroup(group)` initiates meeting message
-- [ ] Custom caller: `CometChat.sendCustomMessage` with `type="meeting"`, `category=CATEGORY_CUSTOM`
-- [ ] Kit receiver: `CometChatMessageList` renders meeting card
-- [ ] Custom receiver: `addMessageListener` registered with category+type filter
-- [ ] On hangup: `CallSession.getInstance().leaveSession()` only (no `endCall`)
-
----
-
-## Pointers
-
-- `cometchat-android-v6-calls/SKILL.md` §"Five required workarounds" — V6 build prerequisites
-- `ringing-integration.md` — 1:1 user calls
-- Canonical docs: https://www.cometchat.com/docs/calls/android/group-calls
-- Cross-platform reference (semantic ground-truth): `cometchat-react-calls/references/group-calls.md`

package/skills/cometchat-android-v6-calls/references/idle-timeout.md

@@ -1,110 +0,0 @@
-# Idle timeout on Android V6 (Compose + Kotlin Views)
-
-Same SDK API as V5. V6-specific: Compose `AlertDialog` for new code, ViewModel + `collectAsStateWithLifecycle` (cf. `references/raise-hand.md` V6 sibling).
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/android/idle-timeout
-**Read first:** `cometchat-android-v5-calls/references/idle-timeout.md` — V5 sister covers ViewModel pattern.
-
----
-
-## SDK API (same as V5)
-
-There is a single `setIdleTimeoutPeriod(int)` — there is no separate before/after-prompt pair. `SessionSettingsBuilder` has only `()` and `(Activity)` constructors (no `(context, container)` form).
-
-```kotlin
-val settings = SessionSettingsBuilder(activity)  // or no-arg SessionSettingsBuilder()
-  .setSessionType(SessionType.VIDEO)
-  .setIdleTimeoutPeriod(60)   // SECONDS (= 60s); default 300
-  .build()
-```
-
-> **⚠ Unit footgun — Android takes SECONDS, not milliseconds.** `setIdleTimeoutPeriod(int)` is in **seconds** (default `300` = 5 min; docs: calls/android/idle-timeout). The **web / React Native / Angular** Calls SDK uses **milliseconds** for `SessionSettings.idleTimeoutPeriodBeforePrompt/AfterPrompt` — copying a web value like `60000` here is a ~16.7-hour timeout, not 60 seconds. Use `60` for one minute.
-
----
-
-## Compose prompt
-
-```kotlin
-@Composable
-fun IdleTimeoutPrompt(
-  onStay: () -> Unit,
-  onEnd: () -> Unit,
-) {
-  AlertDialog(
-    onDismissRequest = { /* prevent backdrop dismiss */ },
-    title = { Text("Still there?") },
-    text = { Text("You're alone in this call. It'll end in 60 seconds.") },
-    confirmButton = {
-      Button(onClick = onStay) { Text("Stay") }
-    },
-    dismissButton = {
-      TextButton(onClick = onEnd) {
-        Text("End now", color = MaterialTheme.colorScheme.error)
-      }
-    },
-  )
-}
-```
-
-`onDismissRequest = { }` (empty) prevents backdrop dismiss — Compose's AlertDialog doesn't have a `setCancelable(false)` equivalent; you swallow the dismiss.
-
----
-
-## Wiring in CallScreen
-
-```kotlin
-@Composable
-fun CallScreen(viewModel: CallViewModel = viewModel()) {
-  val state by viewModel.state.collectAsStateWithLifecycle()
-
-  Box(modifier = Modifier.fillMaxSize()) {
-    // CometChat call surface
-    CometChatOngoingCall(modifier = Modifier.fillMaxSize())
-
-    if (state.showIdlePrompt) {
-      IdleTimeoutPrompt(
-        onStay = { viewModel.dismissIdlePrompt() },
-        onEnd = { CallSession.getInstance().leaveSession() },
-      )
-    }
-
-    // Toast for actual timeout (after grace period)
-    val context = LocalContext.current
-    LaunchedEffect(state.timedOut) {
-      if (state.timedOut) {
-        Toast.makeText(context, "Call ended due to inactivity", Toast.LENGTH_LONG).show()
-      }
-    }
-  }
-}
-```
-
-`collectAsStateWithLifecycle()` (V6 pattern) replaces V5's manual `repeatOnLifecycle`.
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus V6-specific:
-
-1. **`AlertDialog` with `onDismissRequest = { onEnd() }`.** Wrong — backdrop tap accidentally ends the call. Empty body or explicit no-op.
-2. **`LaunchedEffect(state)` instead of `LaunchedEffect(state.timedOut)`.** Re-fires on every state change.
-
----
-
-## Verification checklist
-
-- [ ] SessionSettingsBuilder sets `setIdleTimeoutPeriod(int)`
-- [ ] Compose AlertDialog `onDismissRequest = { }` (empty)
-- [ ] `collectAsStateWithLifecycle()` for state binding
-- [ ] LaunchedEffect on specific field, not whole state
-- [ ] Real-device smoke: same as V5
-
----
-
-## Pointers
-
-- `cometchat-android-v5-calls/references/idle-timeout.md` — V5 sister
-- `cometchat-android-v6-calls` SKILL.md
-- `cometchat-android-v6-calls/references/raise-hand.md` — Compose pattern sibling
-- Canonical docs: https://www.cometchat.com/docs/calls/android/idle-timeout

package/skills/cometchat-android-v6-calls/references/in-call-chat.md

@@ -1,141 +0,0 @@
-# In-call chat on Android V6
-
-V5 has detailed in-call-chat reference; V6 adds Compose-specific UI patterns. The SDK API + group-as-session architecture is unchanged.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/android/in-call-chat
-**Read first:** `cometchat-android-v5-calls/references/in-call-chat.md` — full Kotlin Views + Java SDK patterns + group setup.
-
----
-
-## Compose ModalBottomSheet for in-call chat
-
-```kotlin
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-fun InCallChatSheet(
-  sessionId: String,
-  viewModel: InCallChatViewModel = viewModel(),
-) {
-  val state by viewModel.state.collectAsStateWithLifecycle()
-  val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = false)
-
-  if (state.open && state.group != null) {
-    ModalBottomSheet(
-      onDismissRequest = { viewModel.close() },
-      sheetState = sheetState,
-      shape = RoundedCornerShape(topStart = 16.dp, topEnd = 16.dp),
-    ) {
-      Column(modifier = Modifier
-        .fillMaxWidth()
-        .heightIn(min = 400.dp)
-        .padding(16.dp)) {
-        Text("Chat", style = MaterialTheme.typography.titleMedium)
-        Spacer(modifier = Modifier.height(8.dp))
-        // Compose call's CometChatMessageList composable
-        CometChatMessageList(
-          group = state.group,
-          modifier = Modifier.weight(1f),
-        )
-        CometChatMessageComposer(group = state.group)
-      }
-    }
-  }
-}
-```
-
-`Modifier.weight(1f)` makes the message list expand; composer pinned at bottom. Same minHeight:0 idea but Compose-flavored.
-
----
-
-## ViewModel
-
-```kotlin
-data class InCallChatState(
-  val open: Boolean = false,
-  val unread: Int = 0,
-  val group: Group? = null,
-)
-
-class InCallChatViewModel : ViewModel(), MessageListener {
-  private val _state = MutableStateFlow(InCallChatState())
-  val state: StateFlow<InCallChatState> = _state
-
-  fun init(sessionId: String) {
-    viewModelScope.launch {
-      val group = ensureGroup(sessionId)
-      _state.update { it.copy(group = group) }
-      CometChat.addMessageListener("in-call-chat-$sessionId", this@InCallChatViewModel)
-    }
-  }
-
-  override fun onTextMessageReceived(message: TextMessage) {
-    if (_state.value.open) return
-    if (message.receiverType != CometChatConstants.RECEIVER_TYPE_GROUP) return
-    if (message.receiverUid != _state.value.group?.guid) return
-    _state.update { it.copy(unread = it.unread + 1) }
-    CallSession.getInstance().setChatButtonUnreadCount(_state.value.unread)
-  }
-
-  fun open() {
-    _state.update { it.copy(open = true, unread = 0) }
-    CallSession.getInstance().setChatButtonUnreadCount(0)
-  }
-
-  fun close() {
-    _state.update { it.copy(open = false) }
-  }
-
-  override fun onCleared() {
-    CometChat.removeMessageListener("in-call-chat-${_state.value.group?.guid}")
-  }
-}
-```
-
----
-
-## Triggering from SDK event
-
-`onChatButtonClicked()` is a `ButtonClickListener` member (NOT on `CometChatCallsEventsListener`). Register it via `CallSession.addButtonClickListener(lifecycleOwner, ...)`:
-
-```kotlin
-import com.cometchat.calls.core.CallSession
-import com.cometchat.calls.listeners.ButtonClickListener
-
-CallSession.getInstance().addButtonClickListener(lifecycleOwner, object : ButtonClickListener() {
-  override fun onChatButtonClicked() {
-    // Listener is on background thread — dispatch to UI
-    Handler(Looper.getMainLooper()).post {
-      inCallChatViewModel.open()
-    }
-  }
-})
-```
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus Compose-specific:
-
-1. **`collectAsState()` instead of `collectAsStateWithLifecycle()`.** State updates while paused.
-2. **No `Modifier.weight(1f)` on the message list.** Composer pushes off bottom (same flex-shrink trap).
-3. **`ModalBottomSheet` without `skipPartiallyExpanded = false`.** Defaults to half-screen only; user can't drag to full.
-
----
-
-## Verification checklist
-
-- [ ] InCallChatViewModel uses StateFlow + collectAsStateWithLifecycle
-- [ ] Message list has `Modifier.weight(1f)`
-- [ ] ModalBottomSheet `skipPartiallyExpanded = false`
-- [ ] Listener cleanup in `onCleared`
-- [ ] Real-device smoke: 2 phones in call, message → badge → tap → see message
-
----
-
-## Pointers
-
-- `cometchat-android-v5-calls/references/in-call-chat.md` — V5 sister (Kotlin Views patterns)
-- `cometchat-android-v6-calls` SKILL.md
-- `cometchat-android-v6-calls/references/raise-hand.md` — Compose pattern sibling
-- Canonical docs: https://www.cometchat.com/docs/calls/android/in-call-chat

package/skills/cometchat-android-v6-calls/references/raise-hand.md

@@ -1,188 +0,0 @@
-# Raise hand on Android V6 (Compose + Kotlin Views)
-
-V6 ships the same SDK API as V5 with two key delta: (1) Compose-first surface for new code, Kotlin Views still supported; (2) ViewModel + `collectAsStateWithLifecycle` is the canonical state-binding shape rather than manual `repeatOnLifecycle`.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/android/raise-hand
-**Read first:** `cometchat-android-v5-calls/references/raise-hand.md` — the SDK API + ViewModel pattern is shared; this reference covers V6's Compose layer.
-
----
-
-## SDK API (same as V5)
-
-```kotlin
-import com.cometchat.calls.core.CallSession
-import com.cometchat.calls.listeners.CometChatCallsEventsListener
-import com.cometchat.calls.model.Participant
-
-// raiseHand / lowerHand are instance methods on the CallSession singleton.
-CallSession.getInstance().raiseHand()
-CallSession.getInstance().lowerHand()
-
-// SessionSettingsBuilder has only () and (Activity) constructors — no (context, container) form.
-val settings = SessionSettingsBuilder(activity)  // or no-arg SessionSettingsBuilder()
-  .setSessionType(SessionType.VIDEO)
-  .hideRaiseHandButton(true)
-  .build()
-```
-
-ViewModel + `StateFlow` pattern is identical to V5 (cf. sister reference). The Compose-specific delta is the UI layer.
-
----
-
-## Compose toggle button
-
-```kotlin
-@Composable
-fun RaiseHandButton(viewModel: RaiseHandViewModel = viewModel()) {
-  val state by viewModel.state.collectAsStateWithLifecycle()
-  val context = LocalContext.current
-
-  // Announce a11y on state change
-  LaunchedEffect(state.localRaised) {
-    val accessibilityManager = context.getSystemService(Context.ACCESSIBILITY_SERVICE)
-      as AccessibilityManager
-    if (accessibilityManager.isEnabled) {
-      val announcement = if (state.localRaised) "Hand raised" else "Hand lowered"
-      val event = AccessibilityEvent.obtain(AccessibilityEvent.TYPE_ANNOUNCEMENT)
-      event.text.add(announcement)
-      accessibilityManager.sendAccessibilityEvent(event)
-    }
-  }
-
-  IconButton(
-    onClick = { viewModel.toggle() },
-    modifier = Modifier
-      .semantics {
-        role = Role.Button
-        selected = state.localRaised
-        contentDescription = if (state.localRaised) "Lower hand" else "Raise hand"
-      }
-      .background(
-        color = if (state.localRaised) Color(0xFFFFD60A) else Color.White.copy(alpha = 0.2f),
-        shape = CircleShape,
-      )
-      .padding(12.dp),
-  ) {
-    Icon(
-      imageVector = if (state.localRaised) Icons.Filled.PanTool else Icons.Outlined.PanTool,
-      contentDescription = null,
-      tint = if (state.localRaised) Color.Black else Color.White,
-    )
-  }
-}
-```
-
-`collectAsStateWithLifecycle()` (from `androidx.lifecycle.compose:lifecycle-viewmodel-compose`) is the replacement for V5's manual `repeatOnLifecycle` — it pauses collection automatically when the Composable's lifecycle drops below STARTED.
-
-`semantics { ... }` is Compose's accessibility primitive — `role`, `selected`, `contentDescription` map to Android's TalkBack model.
-
----
-
-## Compose raised-hands sheet
-
-```kotlin
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-fun RaisedHandsSheet(viewModel: RaiseHandViewModel = viewModel()) {
-  val state by viewModel.state.collectAsStateWithLifecycle()
-  val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = false)
-
-  if (state.raised.isNotEmpty()) {
-    ModalBottomSheet(
-      onDismissRequest = { /* host control */ },
-      sheetState = sheetState,
-    ) {
-      Column(modifier = Modifier.padding(16.dp)) {
-        Text(
-          text = "Raised hands (${state.raised.size})",
-          style = MaterialTheme.typography.titleMedium,
-        )
-        Spacer(modifier = Modifier.height(8.dp))
-        LazyColumn {
-          items(state.raised, key = { it.uid }) { p ->
-            ListItem(
-              leadingContent = { Text("✋", fontSize = 20.sp) },
-              headlineContent = { Text(p.name) },
-              supportingContent = {
-                Text(
-                  "${(System.currentTimeMillis() - p.raisedAt) / 1000}s ago",
-                  style = MaterialTheme.typography.bodySmall,
-                  color = MaterialTheme.colorScheme.onSurfaceVariant,
-                )
-              },
-            )
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-`ModalBottomSheet` is Material 3 — the V6 default. `key = { it.uid }` on `LazyColumn.items` is critical (same as `trackBy` on the web/Angular side) — without it, every state change re-renders every item from scratch.
-
----
-
-## Wiring inside a CometChat call screen
-
-Whether the project uses Compose or Kotlin Views for the call surface affects where the button + sheet land. V6 supports both surfaces (cf. `cometchat-android-v6-calls` SKILL.md).
-
-**Compose surface:**
-
-```kotlin
-@Composable
-fun CallScreen() {
-  Box(modifier = Modifier.fillMaxSize()) {
-    // CometChat call surface (composable from chatuikit-compose-android)
-    CometChatOngoingCall(modifier = Modifier.fillMaxSize())
-
-    // Custom raise-hand overlay
-    Box(modifier = Modifier
-      .align(Alignment.BottomEnd)
-      .padding(20.dp)
-    ) {
-      RaiseHandButton()
-    }
-
-    RaisedHandsSheet()
-  }
-}
-```
-
-**Kotlin Views surface (XML layouts):** use the V5 `MaterialButton`-based pattern from the sister reference. The ViewModel + StateFlow plumbing is identical.
-
----
-
-## Anti-patterns
-
-V5 sister reference rules apply, plus V6 Compose-specific:
-
-1. **Forgetting `key = { it.uid }` on `LazyColumn.items`.** Without it, scrolling becomes jittery as items re-mount.
-2. **Using `collectAsState()` instead of `collectAsStateWithLifecycle()`.** The former doesn't pause on lifecycle pause; burns CPU during background.
-3. **`LaunchedEffect(state.localRaised)` firing the announcement on initial composition.** First render counts as a state change; if you don't want an announcement on screen open, gate on `if (state.localRaised) ... else ...` semantics with prior tracking.
-4. **Mixing Compose state (`mutableStateOf`) with StateFlow.** Pick one source of truth — StateFlow with `collectAsStateWithLifecycle` is the V6 recommended path.
-5. **Custom raise-hand button without the `semantics { selected = ... }`.** TalkBack reads "button" but doesn't announce selection state.
-
----
-
-## Verification checklist
-
-- [ ] `RaiseHandViewModel` uses `StateFlow` for state
-- [ ] Compose components use `collectAsStateWithLifecycle()` (not `collectAsState()`)
-- [ ] `LazyColumn.items` uses `key = { it.uid }`
-- [ ] Toggle has `semantics { role, selected, contentDescription }`
-- [ ] Accessibility announcement on state change via AccessibilityManager
-- [ ] `hideRaiseHandButton(true)` in SessionSettingsBuilder if custom UI
-- [ ] Compose surface: button mounted via `Box.align` overlay, doesn't shift CometChat call view
-- [ ] Real-device smoke: 3 Android phones, 2 raise → host's sheet shows both, sorted by time
-- [ ] TalkBack smoke: announces "Hand raised" / "Hand lowered" on toggle
-
----
-
-## Pointers
-
-- `cometchat-android-v5-calls/references/raise-hand.md` — V5 sister reference (Kotlin Views + StateFlow)
-- `cometchat-android-v6-calls` SKILL.md — V6 hard rules + Compose vs Views split
-- `cometchat-android-v6-calls/references/group-calls.md` (when authored) — group call composition patterns
-- `cometchat-a11y` — Android Compose semantics + TalkBack
-- Canonical docs: https://www.cometchat.com/docs/calls/android/raise-hand