@cometchat/skills 4.4.2 → 5.0.0

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

@@ -1,88 +0,0 @@
-# Idle timeout on Flutter V6 (Bloc-based)
-
-Same SDK API as V5; Bloc-based wiring. Read `cometchat-flutter-v5-calls/references/idle-timeout.md` first.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/idle-timeout
-
----
-
-## SDK API + listener bridge
-
-Set the idle period on `SessionSettingsBuilder().setIdleTimeoutPeriod(int)` (seconds — `cometchat_calls_sdk-5.0.2` `src/builder/session_settings.dart:185`). The monolithic `CometChatCallsEventsListener` is `@Deprecated` in 5.0.2 (`src/listener/cometchat_calls_events_listener.dart:16`) — use the v5 split listeners instead. `onSessionTimedOut()` lives on `SessionStatusListeners` (`src/listener/session_status_listeners.dart`), registered via `CallSession.getInstance()?.addSessionStatusListener(...)` (`src/call_session.dart:66`). There is no `CometChatCalls.addCallEventListener`.
-
-Listener via Bloc bridge (cf. `cometchat-flutter-v6-calls/references/raise-hand.md`):
-
-```dart
-// Apply the idle timeout when building session settings:
-final settings = SessionSettingsBuilder().setIdleTimeoutPeriod(180).build();
-
-abstract class CallEvent {}
-class _SessionTimedOut extends CallEvent {}
-
-class CallBloc extends Bloc<CallEvent, CallState> implements SessionStatusListeners {
-  CallBloc() : super(const CallState()) {
-    on<_SessionTimedOut>(_onTimedOut);
-    CallSession.getInstance()?.addSessionStatusListener(this);
-  }
-
-  @override
-  void onSessionTimedOut() {
-    add(_SessionTimedOut());
-  }
-
-  void _onTimedOut(_SessionTimedOut event, Emitter<CallState> emit) {
-    emit(state.copyWith(timedOut: true));
-  }
-
-  // ... other SessionStatusListeners callbacks (onSessionJoined/onSessionLeft/...) as no-ops
-
-  @override
-  Future<void> close() {
-    CallSession.getInstance()?.removeSessionStatusListener(this);
-    return super.close();
-  }
-}
-```
-
-UI listens for `state.timedOut`:
-
-```dart
-BlocListener<CallBloc, CallState>(
-  listenWhen: (prev, curr) => !prev.timedOut && curr.timedOut,
-  listener: (context, state) async {
-    ScaffoldMessenger.of(context).showSnackBar(
-      const SnackBar(content: Text('Call ended due to inactivity')),
-    );
-    Navigator.of(context).popUntil((route) => route.isFirst);
-  },
-  child: /* call surface */,
-)
-```
-
-`BlocListener` is one-shot side effects (navigation, snackbars). `listenWhen` ensures the listener only fires on the transition.
-
----
-
-## Custom prompt — same showDialog as V5
-
-Identical code; cite V5 sister reference.
-
----
-
-## Verification checklist
-
-- [ ] `SessionSettingsBuilder().setIdleTimeoutPeriod(seconds)` sets the idle period
-- [ ] CallBloc implements `SessionStatusListeners` and bridges `onSessionTimedOut` to `_SessionTimedOut`
-- [ ] Listener registered via `CallSession.getInstance()?.addSessionStatusListener(this)`
-- [ ] BlocListener with `listenWhen` triggers nav + snackbar
-- [ ] Bloc `close()` removes the listener via `removeSessionStatusListener(this)`
-- [ ] Real-device smoke: same as V5
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/idle-timeout.md` — V5 sister
-- `cometchat-flutter-v6-calls` SKILL.md — V6 hard rules
-- `cometchat-flutter-v6-calls/references/raise-hand.md` — Bloc-bridge sibling pattern
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/idle-timeout

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

@@ -1,125 +0,0 @@
-# In-call chat on Flutter V6 (Bloc)
-
-Same SDK shape; Bloc-driven open/unread state.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/in-call-chat
-**Read first:** `cometchat-flutter-v5-calls/references/in-call-chat.md` — sheet pattern + group-as-session helper.
-
----
-
-## State + bloc
-
-```dart
-class InCallChatState extends Equatable {
-  final bool open;
-  final int unread;
-  final Group? group;
-  const InCallChatState({this.open = false, this.unread = 0, this.group});
-  InCallChatState copyWith({bool? open, int? unread, Group? group}) =>
-    InCallChatState(open: open ?? this.open, unread: unread ?? this.unread, group: group ?? this.group);
-  @override List<Object?> get props => [open, unread, group?.guid];
-}
-
-abstract class InCallChatEvent {}
-class InitChat extends InCallChatEvent { final String sessionId; InitChat(this.sessionId); }
-class OpenChat extends InCallChatEvent {}
-class CloseChat extends InCallChatEvent {}
-class _MessageReceived extends InCallChatEvent {}
-
-class InCallChatBloc extends Bloc<InCallChatEvent, InCallChatState> {
-  InCallChatBloc() : super(const InCallChatState()) {
-    on<InitChat>(_onInit);
-    on<OpenChat>(_onOpen);
-    on<CloseChat>(_onClose);
-    on<_MessageReceived>(_onReceived);
-  }
-
-  Future<void> _onInit(InitChat event, Emitter<InCallChatState> emit) async {
-    final group = await ensureCallGroup(event.sessionId);
-    emit(state.copyWith(group: group));
-  }
-
-  void _onOpen(OpenChat event, Emitter<InCallChatState> emit) {
-    emit(state.copyWith(open: true, unread: 0));
-    // setChatButtonUnreadCount is an instance method on CallSession
-    // (cometchat_calls_sdk-5.0.2 src/call_session.dart:489), not static.
-    CallSession.getInstance()?.setChatButtonUnreadCount(0);
-  }
-
-  void _onClose(OpenChat event, Emitter<InCallChatState> emit) {
-    emit(state.copyWith(open: false));
-  }
-
-  void _onReceived(_MessageReceived event, Emitter<InCallChatState> emit) {
-    if (state.open) return;
-    final next = state.unread + 1;
-    emit(state.copyWith(unread: next));
-    CallSession.getInstance()?.setChatButtonUnreadCount(next);
-  }
-}
-```
-
----
-
-## Triggering open from SDK event
-
-`onChatButtonClicked()` is on `ButtonClickListeners` (v5 split listener), registered via `CallSession.getInstance()?.addButtonClickListener(...)` — NOT the deprecated `CometChatCallsEventsListener`:
-
-```dart
-// class ... implements ButtonClickListeners
-@override
-void onChatButtonClicked() {
-  context.read<InCallChatBloc>().add(OpenChat());
-}
-```
-
----
-
-## Sheet UI
-
-Same `showModalBottomSheet` shape as V5. Use `BlocSelector` to react to `state.open`:
-
-```dart
-BlocListener<InCallChatBloc, InCallChatState>(
-  listenWhen: (prev, curr) => !prev.open && curr.open,
-  listener: (context, state) {
-    if (state.group == null) return;
-    showModalBottomSheet(
-      context: context,
-      isScrollControlled: true,
-      barrierColor: Colors.transparent,
-      builder: (_) => InCallChatPanel(group: state.group!),
-    ).whenComplete(() {
-      context.read<InCallChatBloc>().add(CloseChat());
-    });
-  },
-  child: /* call surface */,
-)
-```
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus V6-specific:
-
-1. **`BlocBuilder` instead of `BlocListener` for opening the sheet.** BlocBuilder is for rebuilding UI; sheet-open is a one-shot side effect → BlocListener.
-2. **`listenWhen` omitted.** Sheet opens on every state change.
-
----
-
-## Verification checklist
-
-- [ ] InCallChatBloc with `InitChat`, `OpenChat`, `CloseChat`, `_MessageReceived` events
-- [ ] BlocListener with `listenWhen` for the open transition
-- [ ] `showModalBottomSheet.whenComplete` dispatches `CloseChat`
-- [ ] Real-device smoke: same as V5
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/in-call-chat.md` — V5 sister (sheet pattern)
-- `cometchat-flutter-v6-calls` SKILL.md
-- `cometchat-flutter-v6-calls/references/raise-hand.md` — Bloc bridge sibling
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/in-call-chat

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

@@ -1,275 +0,0 @@
-# Raise hand on Flutter (UIKit V6, Bloc-based)
-
-Same SDK conceptual API as V5; the difference is state management — V6 uses `flutter_bloc` rather than GetX. The reactive shape is `RaiseHandBloc → emit(state)` where state is an immutable record of `localRaised + raisedParticipants`.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/raise-hand
-**Read first:** `cometchat-flutter-v5-calls/references/raise-hand.md` — UX shape is identical; this is the V6 Bloc translation.
-
----
-
-## SDK API (same as V5)
-
-Raise/lower hand are **instance methods on the `CallSession` singleton**, NOT static on `CometChatCalls` (verified `cometchat_calls_sdk-5.0.2` `src/call_session.dart:292,306`; the static `CometChatCalls` class has no `raiseHand`/`lowerHand`). Participant hand events arrive via `ParticipantEventListeners`, registered through `CallSession.getInstance()?.addParticipantEventListener(...)` (`src/call_session.dart:78`) — there is no `CometChatCalls.addCallEventListener`.
-
-```dart
-import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';
-import 'package:cometchat_chat_uikit/cometchat_calls_uikit.dart';
-
-CallSession.getInstance()?.raiseHand();
-CallSession.getInstance()?.lowerHand();
-
-// Register a ParticipantEventListeners implementation:
-CallSession.getInstance()?.addParticipantEventListener(myListener);
-
-// In your ParticipantEventListeners implementation:
-@override
-void onParticipantHandRaised(Participant p) { /* ... */ }
-@override
-void onParticipantHandLowered(Participant p) { /* ... */ }
-
-// hideRaiseHandButton is a METHOD on the (non-deprecated) SessionSettingsBuilder.
-// `CallSettingsBuilder` is @Deprecated in 5.0.2 (src/builder/call_settings.dart:208).
-final settings = SessionSettingsBuilder().hideRaiseHandButton(true).build();
-```
-
----
-
-## Bloc setup
-
-```dart
-import 'package:bloc/bloc.dart';
-import 'package:equatable/equatable.dart';
-import 'package:cometchat_chat_uikit/cometchat_calls_uikit.dart';
-
-// State
-class RaiseHandState extends Equatable {
-  final bool localRaised;
-  final List<RaisedParticipant> raised;
-  const RaiseHandState({this.localRaised = false, this.raised = const []});
-
-  RaiseHandState copyWith({bool? localRaised, List<RaisedParticipant>? raised}) =>
-    RaiseHandState(
-      localRaised: localRaised ?? this.localRaised,
-      raised: raised ?? this.raised,
-    );
-
-  @override
-  List<Object> get props => [localRaised, raised];
-}
-
-class RaisedParticipant extends Equatable {
-  final String uid;
-  final String name;
-  final DateTime raisedAt;
-  const RaisedParticipant({required this.uid, required this.name, required this.raisedAt});
-  @override
-  List<Object> get props => [uid, name, raisedAt];
-}
-
-// Events
-abstract class RaiseHandEvent {}
-class ToggleHand extends RaiseHandEvent {}
-class _ParticipantRaised extends RaiseHandEvent {
-  final Participant participant;
-  _ParticipantRaised(this.participant);
-}
-class _ParticipantLowered extends RaiseHandEvent {
-  final Participant participant;
-  _ParticipantLowered(this.participant);
-}
-```
-
----
-
-## Bloc implementation
-
-```dart
-class RaiseHandBloc extends Bloc<RaiseHandEvent, RaiseHandState>
-    implements ParticipantEventListeners {
-
-  RaiseHandBloc() : super(const RaiseHandState()) {
-    on<ToggleHand>(_onToggle);
-    on<_ParticipantRaised>(_onParticipantRaised);
-    on<_ParticipantLowered>(_onParticipantLowered);
-
-    // Self-register as the participant event listener (v5 split listener).
-    CallSession.getInstance()?.addParticipantEventListener(this);
-  }
-
-  void _onToggle(ToggleHand event, Emitter<RaiseHandState> emit) {
-    if (state.localRaised) {
-      CallSession.getInstance()?.lowerHand();
-    } else {
-      CallSession.getInstance()?.raiseHand();
-    }
-    emit(state.copyWith(localRaised: !state.localRaised));
-  }
-
-  void _onParticipantRaised(_ParticipantRaised event, Emitter<RaiseHandState> emit) {
-    final entry = RaisedParticipant(
-      uid: event.participant.uid,
-      name: event.participant.name,
-      raisedAt: DateTime.now(),
-    );
-    final next = [...state.raised.where((r) => r.uid != entry.uid), entry];
-    next.sort((a, b) => a.raisedAt.compareTo(b.raisedAt));
-    emit(state.copyWith(raised: next));
-  }
-
-  void _onParticipantLowered(_ParticipantLowered event, Emitter<RaiseHandState> emit) {
-    final next = state.raised.where((r) => r.uid != event.participant.uid).toList();
-    emit(state.copyWith(raised: next));
-  }
-
-  // ParticipantEventListeners — bridge to Bloc events
-  @override
-  void onParticipantHandRaised(Participant p) {
-    add(_ParticipantRaised(p));
-  }
-
-  @override
-  void onParticipantHandLowered(Participant p) {
-    add(_ParticipantLowered(p));
-  }
-
-  // ... implement other ParticipantEventListeners methods (no-ops or pass-through)
-
-  @override
-  Future<void> close() {
-    CallSession.getInstance()?.removeParticipantEventListener(this);
-    return super.close();
-  }
-}
-```
-
-The bridge pattern: the bloc IS the SDK listener. SDK callbacks call `add()` on the bloc, which dispatches an event handler that emits new state. This keeps Bloc's "single source of truth" intact — no parallel state outside the bloc.
-
----
-
-## Toggle button widget
-
-```dart
-class RaiseHandButton extends StatelessWidget {
-  const RaiseHandButton({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return BlocBuilder<RaiseHandBloc, RaiseHandState>(
-      buildWhen: (prev, curr) => prev.localRaised != curr.localRaised,
-      builder: (context, state) => Semantics(
-        button: true,
-        selected: state.localRaised,
-        label: state.localRaised ? 'Lower hand' : 'Raise hand',
-        child: GestureDetector(
-          onTap: () {
-            context.read<RaiseHandBloc>().add(ToggleHand());
-            SemanticsService.announce(
-              state.localRaised ? 'Hand lowered' : 'Hand raised',
-              TextDirection.ltr,
-            );
-          },
-          child: Container(
-            padding: const EdgeInsets.all(12),
-            decoration: BoxDecoration(
-              color: state.localRaised ? const Color(0xFFFFD60A) : Colors.white24,
-              borderRadius: BorderRadius.circular(32),
-            ),
-            child: Row(
-              children: [
-                const Text('✋'),
-                const SizedBox(width: 4),
-                Text(state.localRaised ? 'Lower' : 'Raise'),
-              ],
-            ),
-          ),
-        ),
-      ),
-    );
-  }
-}
-```
-
-`buildWhen` ensures the button only rebuilds when `localRaised` changes — not on every roster update. Performance discipline matters in a video call.
-
----
-
-## Raised-hands sheet
-
-Same `DraggableScrollableSheet` shape as V5; bind via `BlocBuilder` instead of `Obx`:
-
-```dart
-BlocBuilder<RaiseHandBloc, RaiseHandState>(
-  buildWhen: (prev, curr) => prev.raised != curr.raised,
-  builder: (context, state) => ListView(
-    children: [
-      Text('Raised hands (${state.raised.length})'),
-      for (final p in state.raised)
-        ListTile(leading: const Text('✋'), title: Text(p.name)),
-    ],
-  ),
-)
-```
-
-`buildWhen` again — only rebuild when the roster changes, not on toggle.
-
----
-
-## Wiring to the call screen
-
-```dart
-class CallScreen extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return BlocProvider(
-      create: (_) => RaiseHandBloc(),
-      child: Scaffold(
-        body: Stack(
-          children: [
-            // ... call surface (CometChatOngoingCall)
-            const Positioned(bottom: 100, right: 20, child: RaiseHandButton()),
-            const RaisedHandsSheet(),
-          ],
-        ),
-      ),
-    );
-  }
-}
-```
-
-`BlocProvider(create:)` scopes the bloc to the screen — disposed automatically on screen pop.
-
----
-
-## Anti-patterns
-
-Web sister reference rules apply, plus V6-specific:
-
-1. **`buildWhen` omitted.** Every state change rebuilds every BlocBuilder — lots of unnecessary work during a call. Add `buildWhen` for narrow rebuilds.
-2. **Mutating `state.raised` directly** instead of creating a new list. `Equatable` props compare via `==`; mutation doesn't trigger rebuild.
-3. **Calling `CallSession.getInstance()?.raiseHand()` outside the bloc.** Bypasses the state machine; UI doesn't update. Always go through `add(ToggleHand())`.
-4. **Adding the SDK listener in `initState`** instead of the bloc constructor. Component-level lifecycle ≠ Bloc lifecycle. Bloc `close()` is the canonical place to clean up.
-
----
-
-## Verification checklist
-
-- [ ] `RaiseHandBloc` extends `Bloc<RaiseHandEvent, RaiseHandState>`
-- [ ] `RaiseHandState` extends `Equatable` with proper `props`
-- [ ] Bloc registers itself as `ParticipantEventListeners` via `CallSession.getInstance()?.addParticipantEventListener(this)` in constructor
-- [ ] Bloc `close()` removes the listener via `removeParticipantEventListener(this)`
-- [ ] `BlocProvider(create:)` scopes the bloc to the call screen
-- [ ] `buildWhen` on every BlocBuilder narrows rebuilds
-- [ ] `Semantics` + `SemanticsService.announce` for a11y
-- [ ] `SessionSettingsBuilder().hideRaiseHandButton(true)` if custom UI
-- [ ] Real-device smoke: 3 devices (iOS + Android), 2 raise hands, host sees both
-- [ ] Hot-reload smoke: trigger raise → save code → bloc state survives (bloc is created via `create:`, persists across hot reload)
-
----
-
-## Pointers
-
-- `cometchat-react-calls/references/raise-hand.md` — sister reference (UX shape)
-- `cometchat-flutter-v5-calls/references/raise-hand.md` — V5 sibling (GetX-based)
-- `cometchat-flutter-v6-calls` SKILL.md — V6 hard rules + Bloc patterns
-- `cometchat-a11y` — Flutter Semantics + SemanticsService
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/raise-hand

package/skills/cometchat-flutter-v6-calls/references/ringing-integration.md

@@ -1,171 +0,0 @@
-# Ringing — call signaling with custom UI (Flutter V6 / Bloc)
-
-Same SDK shape; Bloc-driven state instead of GetX.
-
-**Read first:**
-- `cometchat-flutter-v5-calls/references/ringing-integration.md` — V5 sister (GetX patterns)
-- `cometchat-react-calls/references/ringing-integration.md` — full architecture, hard rules
-
----
-
-## Bloc
-
-```dart
-class CallSignalingState extends Equatable {
-  final Call? incoming;
-  final Call? outgoing;
-  final String? activeSessionId;
-
-  const CallSignalingState({this.incoming, this.outgoing, this.activeSessionId});
-  CallSignalingState copyWith({Call? incoming, Call? outgoing, String? activeSessionId}) =>
-      CallSignalingState(
-        incoming: incoming ?? this.incoming,
-        outgoing: outgoing ?? this.outgoing,
-        activeSessionId: activeSessionId ?? this.activeSessionId,
-      );
-  CallSignalingState clear() => const CallSignalingState();
-  @override
-  List<Object?> get props => [incoming?.sessionId, outgoing?.sessionId, activeSessionId];
-}
-
-abstract class CallSignalingEvent {}
-class _IncomingReceived extends CallSignalingEvent { final Call call; _IncomingReceived(this.call); }
-class _OutgoingAccepted extends CallSignalingEvent { final Call call; _OutgoingAccepted(this.call); }
-class _OutgoingRejected extends CallSignalingEvent {}
-class _IncomingCancelled extends CallSignalingEvent {}
-class _CallEnded extends CallSignalingEvent {}
-class InitiateCall extends CallSignalingEvent { final String receiverUid; final String type; InitiateCall(this.receiverUid, {this.type = 'video'}); }
-class AcceptCall extends CallSignalingEvent { final Call call; AcceptCall(this.call); }
-class RejectCall extends CallSignalingEvent { final Call call; RejectCall(this.call); }
-
-class CallSignalingBloc extends Bloc<CallSignalingEvent, CallSignalingState> implements CallListener {
-  static const _listenerId = 'app';
-
-  CallSignalingBloc() : super(const CallSignalingState()) {
-    on<_IncomingReceived>((e, emit) => emit(state.copyWith(incoming: e.call)));
-    on<_OutgoingAccepted>((e, emit) => emit(state.copyWith(outgoing: null, activeSessionId: e.call.sessionId)));
-    on<_OutgoingRejected>((_, emit) => emit(state.copyWith(outgoing: null)));
-    on<_IncomingCancelled>((_, emit) => emit(state.copyWith(incoming: null)));
-    on<_CallEnded>((_, emit) => emit(state.clear()));
-    on<InitiateCall>(_onInitiate);
-    on<AcceptCall>(_onAccept);
-    on<RejectCall>(_onReject);
-
-    CometChat.addCallListener(_listenerId, this);
-  }
-
-  @override
-  void onIncomingCallReceived(Call call) => add(_IncomingReceived(call));
-  @override
-  void onOutgoingCallAccepted(Call call) => add(_OutgoingAccepted(call));
-  @override
-  void onOutgoingCallRejected(Call call) => add(_OutgoingRejected());
-  @override
-  void onIncomingCallCancelled(Call call) => add(_IncomingCancelled());
-  @override
-  void onCallEndedMessageReceived(Call call) => add(_CallEnded());
-
-  Future<void> _onInitiate(InitiateCall e, Emitter<CallSignalingState> emit) async {
-    final call = Call(
-      receiverUid: e.receiverUid,
-      callType: e.type == 'video' ? CometChatCallType.video : CometChatCallType.audio,
-      receiverType: CometChatReceiverType.user,
-    );
-    final result = await CometChat.initiateCall(call: call);
-    if (result is Call) emit(state.copyWith(outgoing: result));
-  }
-
-  Future<void> _onAccept(AcceptCall e, Emitter<CallSignalingState> emit) async {
-    final result = await CometChat.acceptCall(sessionId: e.call.sessionId!);
-    if (result is Call) emit(state.copyWith(incoming: null, activeSessionId: result.sessionId));
-  }
-
-  Future<void> _onReject(RejectCall e, Emitter<CallSignalingState> emit) async {
-    await CometChat.rejectCall(sessionId: e.call.sessionId!, status: CallStatus.rejected);
-    emit(state.copyWith(incoming: null));
-  }
-
-  @override
-  Future<void> close() {
-    CometChat.removeCallListener(_listenerId);
-    return super.close();
-  }
-}
-```
-
----
-
-## Provide above the router
-
-```dart
-BlocProvider<CallSignalingBloc>(
-  create: (_) => CallSignalingBloc(),
-  child: MaterialApp.router(...),
-);
-```
-
----
-
-## Incoming-call overlay
-
-```dart
-class IncomingCallOverlay extends StatelessWidget {
-  const IncomingCallOverlay({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return BlocBuilder<CallSignalingBloc, CallSignalingState>(
-      buildWhen: (prev, curr) => prev.incoming?.sessionId != curr.incoming?.sessionId,
-      builder: (context, state) {
-        final call = state.incoming;
-        if (call == null) return const SizedBox.shrink();
-        // Same UI as V5 sister; replace ctrl.accept/reject with bloc.add(...)
-        return Material(/* ... see V5 sister ... */);
-      },
-    );
-  }
-}
-```
-
-Mount in `MaterialApp.builder`:
-
-```dart
-MaterialApp.router(
-  builder: (context, child) => Stack(
-    children: [
-      child ?? const SizedBox.shrink(),
-      const IncomingCallOverlay(),
-    ],
-  ),
-  routerConfig: ...,
-);
-```
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus V6-specific:
-
-1. **`BlocBuilder` without `buildWhen`.** Rebuilds on every state change — listener events for outgoing/active also retrigger incoming UI.
-2. **Calling SDK methods from UI directly.** Adds back to bloc — use `bloc.add(InitiateCall(...))`.
-3. **Provider scoped to a feature module.** Backgrounded ring path can't find the bloc when push fires.
-
----
-
-## Verification checklist
-
-- [ ] `BlocProvider<CallSignalingBloc>` above `MaterialApp`
-- [ ] `IncomingCallOverlay` in `MaterialApp.builder`'s Stack
-- [ ] `BlocBuilder` uses `buildWhen` to scope rebuilds to `incoming` changes
-- [ ] `close()` calls `removeCallListener`
-- [ ] Real-device smoke: same as V5 sister
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/ringing-integration.md` — V5 sister (GetX)
-- `cometchat-flutter-v6-calls/SKILL.md` — V6 Bloc patterns
-- `cometchat-flutter-v6-calls/references/server-push-bridge.md` — backgrounded ring
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/ringing