fix(ios): correct v5 UI Kit docs against the shipped 5.1.19 kit

ui-kit/ios/ai-assistant-chat-history.mdx

@@ -37,7 +37,7 @@
   "sdkListeners": [],
   "compositionExample": {
     "description": "AIAssistanceChatHistory shows previous AI conversations for a user or group",
-    "components": ["CometChatAIAssistanceChatHistory", "CometChatMessages"],
+    "components": ["CometChatAIAssistanceChatHistory", "CometChatMessageList"],
     "flow": "User opens AI history → selects conversation → views full AI chat"
   }
 }
@@ -56,7 +56,7 @@
 
 <Steps>
 <Step title="Install CometChat UI Kit">
 Add to your Podfile:
 ```ruby
 pod 'CometChatUIKitSwift', '5.1.9'
 ```
@@ -71,13 +71,13 @@
 ```swift lines
 import CometChatUIKitSwift
 
 let uikitSettings = UIKitSettings()
     .set(appID: "YOUR_APP_ID")
     .set(authKey: "YOUR_AUTH_KEY")
     .set(region: "YOUR_REGION")
     .build()
 
 CometChatUIKit.init(uiKitSettings: uikitSettings) { result in
     switch result {
     case .success:
         CometChatUIKit.login(uid: "USER_ID") { _ in }
@@ -108,7 +108,7 @@
         let chatHistory = CometChatAIAssistanceChatHistory()
         chatHistory.user = user  // Required!
 
         navigationController?.pushViewController(chatHistory, animated: true)
     }
 }
 ```
@@ -258,7 +258,7 @@
     // MARK: - Actions
     private func startNewAIChat() {
         // Option 1: Open messages view for new AI chat
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = user
         navigationController?.pushViewController(messagesVC, animated: true)
 
@@ -284,7 +284,7 @@
     }
 
     private func continueChat(from message: BaseMessage) {
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = user
         navigationController?.pushViewController(messagesVC, animated: true)
     }
@@ -336,7 +336,7 @@
 import UIKit
 import CometChatUIKitSwift
 
 class CustomEmptyView: UIView {
 
     private let imageView: UIImageView = {
         let iv = UIImageView()
@@ -416,13 +416,13 @@
 }
 
 // Usage
 let chatHistory = CometChatAIAssistanceChatHistory()
 chatHistory.user = user
 
 let emptyView = CustomEmptyView()
 emptyView.startChatButton.addTarget(self, action: #selector(startNewChat), for: .touchUpInside)
 
 chatHistory.set(emptyView: emptyView)
 ```
 </Tab>
 </Tabs>
@@ -538,7 +538,7 @@
 import CometChatSDK
 import CometChatUIKitSwift
 
 let chatHistory = CometChatAIAssistanceChatHistory()
 chatHistory.user = user
 
 // Create custom message request builder
@@ -589,7 +589,7 @@
 
     private func setupTabs() {
         // Chats Tab
-        let chatsVC = CometChatConversationsWithMessages()
+        let chatsVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let chatsNav = UINavigationController(rootViewController: chatsVC)
         chatsNav.tabBarItem = UITabBarItem(
             title: "Chats",
@@ -611,7 +611,7 @@
         )
 
         // Users Tab
-        let usersVC = CometChatUsersWithMessages()
+        let usersVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let usersNav = UINavigationController(rootViewController: usersVC)
         usersNav.tabBarItem = UITabBarItem(
             title: "Users",
@@ -623,7 +623,7 @@
     }
 
     private func startNewAIChat() {
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = currentUser
 
         if let nav = selectedViewController as? UINavigationController {
@@ -683,7 +683,7 @@
         chatHistory.user = user
 
         chatHistory.onNewChatButtonClicked = { [weak self] selectedUser in
-            let messagesVC = CometChatMessages()
+            let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
             messagesVC.user = selectedUser
             self?.navigationController?.pushViewController(messagesVC, animated: true)
         }
@@ -762,7 +762,7 @@
     chatHistory.user = currentUser
 
     chatHistory.onNewChatButtonClicked = { [weak self] user in
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = user
         self?.navigationController?.pushViewController(messagesVC, animated: true)
     }
@@ -785,7 +785,7 @@
 
 chatHistory.onMessageClicked = { [weak self] message in
     // Open the messages view to continue the conversation
-    let messagesVC = CometChatMessages()
+    let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
     messagesVC.user = self?.user
     self?.navigationController?.pushViewController(messagesVC, animated: true)
 }
@@ -846,7 +846,7 @@
         aiHistory.user = currentUser
 
         aiHistory.onNewChatButtonClicked = { [weak self] user in
-            let messagesVC = CometChatMessages()
+            let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
             messagesVC.user = user
             if let nav = self?.selectedViewController as? UINavigationController {
                 nav.pushViewController(messagesVC, animated: true)

ui-kit/ios/ai-features.mdx

@@ -9,7 +9,7 @@
 {
   "category": "ai",
   "features": [
-    {"name": "aiAgentChat", "description": "Chat with AI-powered assistants", "component": "CometChatMessages", "enabledByDefault": false},
+    {"name": "aiAgentChat", "description": "Chat with AI-powered assistants", "component": "CometChatMessageList", "enabledByDefault": false},
     {"name": "chatHistory", "description": "Browse and resume previous AI sessions", "component": "CometChatAIAssistanceChatHistory", "enabledByDefault": false},
     {"name": "streamingResponses", "description": "Real-time AI message streaming", "component": "CometChatMessageList", "enabledByDefault": false},
     {"name": "suggestedMessages", "description": "AI-powered conversation starters and smart replies", "component": "CometChatMessageComposer", "enabledByDefault": false}
@@ -18,7 +18,7 @@
     "location": "CometChat Dashboard → AI",
     "features": ["Conversation Starter", "Smart Replies", "Conversation Summary"]
   },
-  "relatedComponents": ["CometChatMessages", "CometChatAIAssistanceChatHistory", "CometChatMessageList", "CometChatMessageComposer"]
+  "relatedComponents": ["CometChatMessageList", "CometChatAIAssistanceChatHistory", "CometChatMessageList", "CometChatMessageComposer"]
 }
 ```
 </Accordion>
@@ -80,7 +80,7 @@
 
 ### Implementation
 
-Conversation starters appear automatically in `CometChatMessages`:
+Conversation starters appear automatically in `CometChatMessageList`:
 
 <Tabs>
 <Tab title="Swift">
@@ -94,7 +94,7 @@
     func openChatWithUser(uid: String) {
         CometChat.getUser(UID: uid) { [weak self] user in
             DispatchQueue.main.async {
-                let messagesVC = CometChatMessages()
+                let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
                 messagesVC.user = user
 
                 // Conversation starters appear automatically
@@ -102,7 +102,7 @@
 
                 self?.navigationController?.pushViewController(messagesVC, animated: true)
             }
         } onError: { error in
             print("Error: \(error?.errorDescription ?? "")")
         }
     }
@@ -142,7 +142,7 @@
 class ChatViewController: UIViewController {
 
     func openChat(with user: CometChat.User) {
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = user
 
         // Smart replies appear automatically in the composer
@@ -186,7 +186,7 @@
 class ChatViewController: UIViewController {
 
     func openChat(with user: CometChat.User) {
-        let messagesVC = CometChatMessages()
+        let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
         messagesVC.user = user
 
         // Conversation summary option appears in composer action sheet
@@ -400,7 +400,7 @@
 
     private func setupTabs() {
         // Chats - AI features (starters, smart replies, summary) work automatically
-        let chatsVC = CometChatConversationsWithMessages()
+        let chatsVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let chatsNav = UINavigationController(rootViewController: chatsVC)
         chatsNav.tabBarItem = UITabBarItem(
             title: "Chats",
@@ -418,7 +418,7 @@
         )
 
         // Users
-        let usersVC = CometChatUsersWithMessages()
+        let usersVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let usersNav = UINavigationController(rootViewController: usersVC)
         usersNav.tabBarItem = UITabBarItem(
             title: "Users",
@@ -491,7 +491,7 @@
 
         chatHistory.onNewChatButtonClicked = { [weak self] in
             // Start new AI chat
-            let messagesVC = CometChatMessages()
+            let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
             messagesVC.user = user
             self?.navigationController?.pushViewController(messagesVC, animated: true)
         }

ui-kit/ios/call-buttons.mdx

@@ -92,7 +92,7 @@
 <Tab title="Swift">
 ```swift lines
 let cometChatCallButton = CometChatCallButtons(width: 24, height: 24)
-.set(onVoiceCallClick: { user, group in
+.onVoiceCallClick = { user, group in
 //Perform Your Action
 })
 ```
@@ -109,7 +109,7 @@
 <Tab title="Swift">
 ```swift lines
 let cometChatCallButton = CometChatCallButtons(width: 24, height: 24)
-.set(onVideoCallClick: { user, group in
+.onVideoCallClick = { user, group in
 //Perform Your Action
 
 })
@@ -259,7 +259,7 @@
 callButtonStyle.videoCallButtonBackground = UIColor(hex: "#EDEAFA")
 callButtonStyle.videoCallIconTint = UIColor(hex: "#6852D6")
 
 let callButton = CometChatCallButtons(width: 10, height: 10)
 callButton.style = callButtonStyle
 ```
 
@@ -308,7 +308,7 @@
 | set(group:Group)                | Sets the Group object for CometChatCallButtons.                      | `.set(group:Group)`                                          |
 | set(outgoingCallConfiguration:) | Sets the configuration for outgoing calls.                           | `setOutgoingCallConfiguration(config)`                       |
 | set(customSoundForCalls:)       | Sets a custom sound for incoming and outgoing calls.                 | `set(customSoundForCalls: URL)`                              |
-| set(callSettingBuilder:)        | Function to build call settings based on call type and participants. | `.set(callSettingBuilder { callType, participants in ... })` |
+| set(callSettingsBuilder:)        | Function to build call settings based on call type and participants. | `.set(callSettingBuilder { callType, participants in ... })` |
 
 ### Advanced
 
@@ -345,7 +345,7 @@
 
 **Example**
 
 Let's say you want to change the style of the Outgoing Call subcomponent and, in addition, you only want to disable soundForCalls.
 
 You can modify the style using the `OutgoingCallStyle` property, disable sound for calls using `.disable(soundForCalls: bool)` property.
 
@@ -374,7 +374,7 @@
 
 ```swift lines
 let callButtons = CometChatCallButtons(width: 24, height: 24)
 callButtons.set(controller: UIViewController) // Passing the controller is required
 ```
 
 </Note>
@@ -476,7 +476,7 @@
 ```swift lines
 class CustomMessageHeader: UIView {
 
     private var callButtons: CometChatCallButtons!
 
     func configure(with user: User) {
         callButtons = CometChatCallButtons(width: 24, height: 24)
@@ -516,7 +516,7 @@
 ```swift lines
 let callButtons = CometChatCallButtons(width: 24, height: 24)
 callButtons.set(user: user)
-callButtons.set(onVoiceCallClick: { [weak self] user, group in
+callButtons.onVoiceCallClick = { [weak self] user, group in
     let alert = UIAlertController(
         title: "Start Voice Call",
         message: "Call \(user?.name ?? group?.name ?? "")?",
@@ -546,7 +546,7 @@
 callButtons.set(controller: self)
 
 // Custom call settings for group calls
-callButtons.set(callSettingBuilder: { callType, participants in
+callButtons.set(callSettingsBuilder: { callType, participants in
     return CallSettingsBuilder()
         .setDefaultLayout(true)
         .setShowRecordingButton(true)

ui-kit/ios/call-features.mdx

@@ -104,7 +104,7 @@
 </Step>
 </Steps>
 
-**That's it!** Call buttons now appear in `CometChatMessages` header automatically.
+**That's it!** Call buttons appear in `CometChatMessageHeader` automatically.
 
 ---
 
@@ -119,7 +119,7 @@
 import CometChatUIKitSwift
 import CometChatSDK
 
 class SceneDelegate: UIResponder, UIWindowSceneDelegate {
 
     var window: UIWindow?
 
@@ -155,7 +155,7 @@
                     self?.setupMainInterface(windowScene: windowScene)
                 }
 
             case .onError(let error):
                 print("❌ Login failed: \(error.description)")
 
             @unknown default:
@@ -190,7 +190,7 @@
 
     private func setupTabs() {
         // Chats Tab - with calling enabled
-        let chatsVC = CometChatConversationsWithMessages()
+        let chatsVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let chatsNav = UINavigationController(rootViewController: chatsVC)
         chatsNav.tabBarItem = UITabBarItem(
             title: "Chats",
@@ -211,7 +211,7 @@
         )
 
         // Users Tab
-        let usersVC = CometChatUsersWithMessages()
+        let usersVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let usersNav = UINavigationController(rootViewController: usersVC)
         usersNav.tabBarItem = UITabBarItem(
             title: "Users",
@@ -220,7 +220,7 @@
         )
 
         // Groups Tab
-        let groupsVC = CometChatGroupsWithMessages()
+        let groupsVC = ChatListVC()   // your own list + chat screen — see /ui-kit/ios/ios-tab-based-chat
         let groupsNav = UINavigationController(rootViewController: groupsVC)
         groupsNav.tabBarItem = UITabBarItem(
             title: "Groups",
@@ -253,7 +253,7 @@
         // Fetch user and open chat
         CometChat.getUser(UID: uid) { [weak self] user in
             DispatchQueue.main.async {
-                let messagesVC = CometChatMessages()
+                let messagesVC = MessagesVC()   // your own VC — see /ui-kit/ios/ios-conversation
                 messagesVC.user = user
 
                 if let nav = self?.selectedViewController as? UINavigationController {
@@ -484,11 +484,11 @@
         callButtons.user = user
 
         // Customize actions
-        callButtons.set(onVoiceCallClick: { user, group in
+        callButtons.onVoiceCallClick = { user, group in
             print("Voice call to: \(user?.name ?? group?.name ?? "")")
         })
 
-        callButtons.set(onVideoCallClick: { user, group in
+        callButtons.onVideoCallClick = { user, group in
             print("Video call to: \(user?.name ?? group?.name ?? "")")
         })
 
@@ -581,8 +581,8 @@
 callButtons.user = user  // or callButtons.group = group
 
 // Callbacks
-callButtons.set(onVoiceCallClick: { user, group in })
-callButtons.set(onVideoCallClick: { user, group in })
+callButtons.onVoiceCallClick = { user, group in })
+callButtons.onVideoCallClick = { user, group in })
 callButtons.set(onError: { error in })
 ```
 
@@ -595,7 +595,7 @@
 incomingCall.set(call: call)
 
 incomingCall.set(onAcceptClick: { call in })
-incomingCall.set(onDeclineClick: { call in })
+incomingCall.set(onCancelClick: { call in })
 ```
 
 ### CometChatOutgoingCall

ui-kit/ios/component-styling.mdx

@@ -79,24 +79,24 @@
 import CometChatUIKitSwift
 
 // Create custom styles
 let avatarStyle = AvatarStyle()
 avatarStyle.backgroundColor = UIColor(hex: "#FBAA75")
 avatarStyle.cornerRadius = CometChatCornerStyle(cornerRadius: 8)
 
 let badgeStyle = BadgeStyle()
 badgeStyle.backgroundColor = UIColor(hex: "#F76808")
 badgeStyle.textColor = .white
 badgeStyle.textFont = UIFont.systemFont(ofSize: 12, weight: .bold)
 
 let receiptStyle = ReceiptStyle()
 receiptStyle.readIconTint = UIColor(hex: "#6200EE")
 receiptStyle.deliveredIconTint = UIColor(hex: "#9E9E9E")
 
 // Apply to conversations
 let conversations = CometChatConversations()
 conversations.avatarStyle = avatarStyle
 conversations.badgeStyle = badgeStyle
 conversations.receiptStyle = receiptStyle
 
 // Style the list
 conversations.style.titleColor = UIColor(hex: "#212121")
@@ -166,13 +166,13 @@
 import CometChatUIKitSwift
 
 // Avatar style for group icons
 let avatarStyle = AvatarStyle()
 avatarStyle.backgroundColor = UIColor(hex: "#FBAA75")
 avatarStyle.cornerRadius = CometChatCornerStyle(cornerRadius: 8)
 
 // Apply styles
 let groups = CometChatGroups()
 groups.avatarStyle = avatarStyle
 
 // List styling
 groups.style.titleColor = UIColor(hex: "#F76808")
@@ -303,7 +303,7 @@
 import CometChatUIKitSwift
 
 // Avatar style
 let avatarStyle = AvatarStyle()
 avatarStyle.backgroundColor = UIColor(hex: "#FBAA75")
 avatarStyle.cornerRadius = CometChatCornerStyle(cornerRadius: 8)
 
@@ -319,7 +319,7 @@
 CometChatCallLogs.style.outgoingCallIconTint = .systemGreen
 CometChatCallLogs.style.missedCallTitleColor = .systemRed
 
 CometChatCallLogs.avatarStyle = avatarStyle
 ```
 </Tab>
 </Tabs>
@@ -369,7 +369,7 @@
 import CometChatUIKitSwift
 
 // Date separator style
-let dateStyle = CometChatDateStyle()
+let dateStyle = DateStyle()
 dateStyle.textColor = UIColor(hex: "#8E8E93")
 dateStyle.textFont = UIFont.systemFont(ofSize: 12)
 
@@ -381,7 +381,7 @@
 CometChatAIAssistantChatHistory.style.newChatIconColor = UIColor(hex: "#F76808")
 CometChatAIAssistantChatHistory.style.itemTextColor = UIColor(hex: "#141414")
 CometChatAIAssistantChatHistory.style.itemTextFont = UIFont.systemFont(ofSize: 14)
 CometChatAIAssistantChatHistory.style.dateSeparatorStyle = dateStyle
 ```
 </Tab>
 </Tabs>
@@ -413,7 +413,7 @@
 <Tabs>
 <Tab title="Swift">
 ```swift lines
 let badgeStyle = BadgeStyle()
 badgeStyle.backgroundColor = UIColor(hex: "#F44336")
 badgeStyle.textColor = .white
 badgeStyle.textFont = UIFont.systemFont(ofSize: 12, weight: .bold)
@@ -430,7 +430,7 @@
 <Tabs>
 <Tab title="Swift">
 ```swift lines
 let statusStyle = StatusIndicatorStyle()
 statusStyle.backgroundColor = .systemGreen  // Online color
 statusStyle.borderColor = .white
 statusStyle.borderWidth = 2
@@ -446,7 +446,7 @@
 <Tabs>
 <Tab title="Swift">
 ```swift lines
 let receiptStyle = ReceiptStyle()
 receiptStyle.sentIconTint = UIColor(hex: "#9E9E9E")
 receiptStyle.deliveredIconTint = UIColor(hex: "#9E9E9E")
 receiptStyle.readIconTint = UIColor(hex: "#6200EE")
@@ -536,7 +536,7 @@
 
 // Apply in AppDelegate
 @main
 class AppDelegate: UIResponder, UIApplicationDelegate {
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
         StyleManager.applyGlobalStyles()
         return true