### Install MessageInputBar with Carthage

Source: https://github.com/messagekit/messageinputbar/blob/master/README.md

Add this line to your Cartfile to integrate the library using Carthage.

```text
github "MessageKit/MessageInputBar"
```

--------------------------------

### Basic Setup

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Demonstrates how to set up MessageInputBar as an input accessory view and handle delegate methods for sending messages and managing UI updates.

```APIDOC
## Basic Setup

Setting up MessageInputBar as an input accessory view with delegate handling for send actions.

```swift
import MessageInputBar

class ChatViewController: UIViewController, MessageInputBarDelegate {

    private let messageInputBar = MessageInputBar()

    override var inputAccessoryView: UIView? {
        return messageInputBar
    }

    override var canBecomeFirstResponder: Bool {
        return true
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        messageInputBar.delegate = self
    }

    // MARK: - MessageInputBarDelegate

    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String) {
        // Send the message
        sendMessage(text)
        // Clear the input
        inputBar.inputTextView.text = String()
        inputBar.invalidatePlugins()
    }

    func messageInputBar(_ inputBar: MessageInputBar, textViewTextDidChangeTo text: String) {
        // Use to send typing indicators
        sendTypingIndicator()
    }

    func messageInputBar(_ inputBar: MessageInputBar, didChangeIntrinsicContentTo size: CGSize) {
        // Adjust other UI elements based on input bar size changes
        tableView.contentInset.bottom = size.height
    }
}
```
```

--------------------------------

### Install MessageInputBar with CocoaPods

Source: https://github.com/messagekit/messageinputbar/blob/master/README.md

Add this line to your Podfile to include the library in your project.

```ruby
pod 'MessageInputBar'
```

--------------------------------

### Setup MessageInputBar in a ViewController

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Implement the MessageInputBar as an input accessory view and conform to the MessageInputBarDelegate to handle user interactions.

```swift
import MessageInputBar

class ChatViewController: UIViewController, MessageInputBarDelegate {

    private let messageInputBar = MessageInputBar()

    override var inputAccessoryView: UIView? {
        return messageInputBar
    }

    override var canBecomeFirstResponder: Bool {
        return true
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        messageInputBar.delegate = self
    }

    // MARK: - MessageInputBarDelegate

    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String) {
        // Send the message
        sendMessage(text)
        // Clear the input
        inputBar.inputTextView.text = String()
        inputBar.invalidatePlugins()
    }

    func messageInputBar(_ inputBar: MessageInputBar, textViewTextDidChangeTo text: String) {
        // Use to send typing indicators
        sendTypingIndicator()
    }

    func messageInputBar(_ inputBar: MessageInputBar, didChangeIntrinsicContentTo size: CGSize) {
        // Adjust other UI elements based on input bar size changes
        tableView.contentInset.bottom = size.height
    }
}
```

--------------------------------

### Example Typing Indicator Plugin

Source: https://context7.com/messagekit/messageinputbar/llms.txt

A sample TypingIndicatorPlugin implementing the InputPlugin protocol to manage and send typing status updates. It uses a timer to reset the typing status after a period of inactivity.

```swift
class TypingIndicatorPlugin: InputPlugin {

    weak var messageInputBar: MessageInputBar? 
    var onTypingStatusChanged: ((Bool) -> Void)?

    private var isTyping = false
    private var typingTimer: Timer?

    func reloadData() {
        guard let textView = messageInputBar?.inputTextView else { return }
        let hasText = !textView.text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty

        if hasText && !isTyping {
            isTyping = true
            onTypingStatusChanged?(true)
        }

        // Reset typing timer
        typingTimer?.invalidate()
        typingTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: false) { [weak self] _ in
            self?.isTyping = false
            self?.onTypingStatusChanged?(false)
        }
    }

    func invalidate() {
        isTyping = false
        typingTimer?.invalidate()
        typingTimer = nil
        onTypingStatusChanged?(false)
    }

    func handleInput(of object: AnyObject) -> Bool {
        // This plugin doesn't handle direct input
        return false
    }
}
```

```swift
// Usage
let typingPlugin = TypingIndicatorPlugin()
typingPlugin.onTypingStatusChanged = { isTyping in
    // Send typing indicator to server
    SocketManager.shared.sendTypingStatus(isTyping)
}
messageInputBar.plugins.append(typingPlugin)
```

--------------------------------

### Configure Button Spacing in MessageInputBar

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Use .fixed() for specific pixel spacing or .flexibleSpace for expandable spacing to control button layout. Example shows buttons on the left with the send button pushed to the right.

```swift
import MessageInputBar

// Fixed spacing - adds specific pixels after the button
let buttonWithFixedSpace = InputBarButtonItem()
    .configure {
        $0.image = UIImage(named: "ic_camera")
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
        $0.spacing = .fixed(10) // 10 points of space after this button
    }

// Flexible spacing - expands to fill available space
let flexibleSpaceButton = InputBarButtonItem.flexibleSpace

// Fixed space button - creates invisible spacer
let fixedSpacerButton = InputBarButtonItem.fixedSpace(20) // 20 point spacer

// Example: Buttons on left, send button pushed to right
let items = [
    InputBarButtonItem()
        .configure {
            $0.image = UIImage(named: "ic_camera")
            $0.setSize(CGSize(width: 30, height: 30), animated: false)
            $0.spacing = .fixed(10)
        },
    InputBarButtonItem()
        .configure {
            $0.image = UIImage(named: "ic_library")
            $0.setSize(CGSize(width: 30, height: 30), animated: false)
        },
    InputBarButtonItem.flexibleSpace, // Push remaining to right
    messageInputBar.sendButton
]

messageInputBar.setStackViewItems(items, forStack: .bottom, animated: false)
```

--------------------------------

### InputBarButtonItem Configuration

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Shows how to create and configure `InputBarButtonItem` instances with reactive behaviors for various events like touch, text changes, and keyboard interactions.

```APIDOC
## InputBarButtonItem Configuration

Creating customizable buttons with reactive hooks for various events including touch, text changes, and keyboard editing.

```swift
import MessageInputBar

// Create a camera button with reactive behaviors
let cameraButton = InputBarButtonItem()
    .configure {
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
        $0.image = UIImage(named: "ic_camera")?.withRenderingMode(.alwaysTemplate)
        $0.tintColor = .lightGray
    }
    .onTouchUpInside {
        item in
        // Handle camera button tap
        print("Camera button tapped")
    }
    .onTextViewDidChange {
        item, textView in
        // Disable camera when text is entered
        item.isEnabled = textView.text.isEmpty
    }
    .onKeyboardEditingBegins {
        item in
        // Animate when keyboard appears
        item.tintColor = .blue
    }
    .onKeyboardEditingEnds {
        item in
        // Reset when keyboard dismisses
        item.tintColor = .lightGray
    }
    .onEnabled {
        item in
        item.alpha = 1.0
    }
    .onDisabled {
        item in
        item.alpha = 0.5
    }

// Create send button with highlight effects
let sendButton = InputBarButtonItem()
    .configure {
        $0.setSize(CGSize(width: 52, height: 36), animated: false)
        $0.title = "Send"
        $0.titleLabel?.font = UIFont.boldSystemFont(ofSize: 15)
    }
    .onSelected {
        item in
        // Scale up on press
        item.transform = CGAffineTransform(scaleX: 1.2, y: 1.2)
    }
    .onDeselected {
        item in
        // Reset scale
        item.transform = .identity
    }
```
```

--------------------------------

### Working with Child View Controllers

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Demonstrates how to correctly integrate MessageInputBar within a child view controller and ensure the input accessory view is presented by calling `becomeFirstResponder` on the parent.

```APIDOC
## Working with Child View Controllers

Using MessageInputBar within a child view controller by calling becomeFirstResponder on the parent.

### Description

This section explains how to manage the `MessageInputBar` when it's part of a child view controller. The key is to ensure the parent view controller correctly handles the first responder status and presents the `inputAccessoryView`.

### Parent View Controller Setup

- The parent view controller must override `canBecomeFirstResponder` to return `true`.
- The parent view controller must override `inputAccessoryView` to return the `MessageInputBar` instance from the child view controller.
- Calling `becomeFirstResponder()` on the parent view controller is crucial for displaying the input accessory view.

### Child View Controller Setup

- The child view controller typically contains the `MessageInputBar` instance.
- It should conform to `MessageInputBarDelegate` to handle send actions.

### Example Usage

```swift
import MessageInputBar

class ParentViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad() // Ensure super.viewDidLoad() is called

        // Setup child view controller
        let childVC = ChatViewController()
        addChild(childVC)
        view.addSubview(childVC.view)
        childVC.view.frame = view.bounds // Adjust frame as needed
        childVC.didMove(toParent: self)

        // IMPORTANT: Call becomeFirstResponder on parent to show inputAccessoryView
        // This must be called after the view hierarchy is established and the child is added.
        DispatchQueue.main.async { [weak self] in
            self?.becomeFirstResponder()
        }
    }

    // Allow the parent view controller to become the first responder
    override var canBecomeFirstResponder: Bool { 
        return true
    }

    // Forward the inputAccessoryView to the child's MessageInputBar
    override var inputAccessoryView: UIView? {
        // Safely unwrap the child view controller and its MessageInputBar
        return (children.first as? ChatViewController)?.messageInputBar
    }
}

class ChatViewController: UIViewController, MessageInputBarDelegate {

    let messageInputBar = MessageInputBar()

    override func viewDidLoad() {
        super.viewDidLoad() // Ensure super.viewDidLoad() is called
        messageInputBar.delegate = self
        // Configure messageInputBar appearance and behavior here
    }

    // MessageInputBarDelegate method to handle send button taps
    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String) {
        print("Send: \(text)")
        // Clear the input text after sending
        inputBar.inputTextView.text = ""
        // Optionally, you might want to resign first responder here or handle it in the parent
        // inputBar.inputTextView.resignFirstResponder()
    }
}
```
```

--------------------------------

### Configure Stack View Items

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Set buttons in the left, right, and bottom stack views. Use .flexibleSpace for dynamic spacing in the bottom stack. Requires width constants for left and right stacks.

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Create custom buttons
let attachButton = InputBarButtonItem()
    .configure {
        $0.image = UIImage(named: "ic_plus")
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
    }
    .onTouchUpInside {
        print("Attach button tapped")
    }

let cameraButton = InputBarButtonItem()
    .configure {
        $0.image = UIImage(named: "ic_camera")
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
    }

// Set items in left stack view (requires width constant)
messageInputBar.setStackViewItems([attachButton, cameraButton], forStack: .left, animated: false)
messageInputBar.setLeftStackViewWidthConstant(to: 65, animated: false)

// Set items in right stack view
messageInputBar.setStackViewItems([messageInputBar.sendButton], forStack: .right, animated: false)
messageInputBar.setRightStackViewWidthConstant(to: 52, animated: false)

// Set items in bottom stack view with flexible spacing
let hashtagButton = InputBarButtonItem()
    .configure {
        $0.image = UIImage(named: "ic_hashtag")
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
        $0.spacing = .fixed(10)
    }

let atButton = InputBarButtonItem()
    .configure {
        $0.image = UIImage(named: "ic_at")
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
        $0.spacing = .fixed(10)
    }

messageInputBar.setStackViewItems([
    atButton,
    hashtagButton,
    .flexibleSpace,  // Pushes remaining items to the right
    messageInputBar.sendButton
], forStack: .bottom, animated: false)
```

--------------------------------

### Configure Padding and Layout

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Adjust padding for the main content view, top stack view, and text view. Configure separator line and background appearance, and enable translucent blur effects.

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Main padding around the content view
// V:|...[topStackView]-(padding.top)-[contentView]-(padding.bottom)-|
// H:|-(padding.left)-[contentView]-(padding.right)-|
messageInputBar.padding = UIEdgeInsets(top: 6, left: 12, bottom: 6, right: 12)

// Padding around the top stack view
messageInputBar.topStackViewPadding = UIEdgeInsets(top: 0, left: 12, bottom: 0, right: 12)

// Padding around the text view relative to left/right/bottom stack views
// H:|...-[leftStackView]-(textViewPadding.left)-[InputTextView]-(textViewPadding.right)-[rightStackView]-...|
// V:|...-(textViewPadding.top)-[InputTextView]-(textViewPadding.bottom)-[bottomStackView]-...|
messageInputBar.textViewPadding = UIEdgeInsets(top: 0, left: 8, bottom: 0, right: 8)

// Overlap text view with right stack view (negative padding)
messageInputBar.textViewPadding.right = -38

// Configure separator line
messageInputBar.separatorLine.isHidden = false
messageInputBar.separatorLine.backgroundColor = .lightGray

// Configure background
messageInputBar.backgroundView.backgroundColor = .white

// Enable translucent blur effect
messageInputBar.isTranslucent = true
```

--------------------------------

### Configure InputBarButtonItem

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Create and customize buttons with reactive hooks for touch events, keyboard states, and text changes.

```swift
import MessageInputBar

// Create a camera button with reactive behaviors
let cameraButton = InputBarButtonItem()
    .configure {
        $0.setSize(CGSize(width: 30, height: 30), animated: false)
        $0.image = UIImage(named: "ic_camera")?.withRenderingMode(.alwaysTemplate)
        $0.tintColor = .lightGray
    }
    .onTouchUpInside { item in
        // Handle camera button tap
        print("Camera button tapped")
    }
    .onTextViewDidChange { item, textView in
        // Disable camera when text is entered
        item.isEnabled = textView.text.isEmpty
    }
    .onKeyboardEditingBegins { item in
        // Animate when keyboard appears
        item.tintColor = .blue
    }
    .onKeyboardEditingEnds { item in
        // Reset when keyboard dismisses
        item.tintColor = .lightGray
    }
    .onEnabled { item in
        item.alpha = 1.0
    }
    .onDisabled { item in
        item.alpha = 0.5
    }

// Create send button with highlight effects
let sendButton = InputBarButtonItem()
    .configure {
        $0.setSize(CGSize(width: 52, height: 36), animated: false)
        $0.title = "Send"
        $0.titleLabel?.font = UIFont.boldSystemFont(ofSize: 15)
    }
    .onSelected { item in
        // Scale up on press
        item.transform = CGAffineTransform(scaleX: 1.2, y: 1.2)
    }
    .onDeselected { item in
        // Reset scale
        item.transform = .identity
    }
```

--------------------------------

### Implement AutocompleteManager in a ViewController

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Configures the AutocompleteManager with custom prefixes and handles data source and delegate methods for managing autocomplete sessions.

```swift
import MessageInputBar

class ChatViewController: UIViewController, AutocompleteManagerDelegate, AutocompleteManagerDataSource {

    let messageInputBar = MessageInputBar()

    lazy var autocompleteManager: AutocompleteManager = {
        let manager = AutocompleteManager(for: messageInputBar.inputTextView)
        manager.delegate = self
        manager.dataSource = self
        return manager
    }()

    let users = ["nathantannar4", "SD10", "zhongwuzw"]
    let hashtags = ["MessageKit", "MessageInputBar", "iOS", "Swift"]

    override func viewDidLoad() {
        super.viewDidLoad()
        messageInputBar.plugins = [autocompleteManager]

        // Register @ prefix with blue highlighting
        autocompleteManager.register(prefix: "@", with: [
            .font: UIFont.preferredFont(forTextStyle: .body),
            .foregroundColor: UIColor(red: 0, green: 122/255, blue: 1, alpha: 1),
            .backgroundColor: UIColor(red: 0, green: 122/255, blue: 1, alpha: 0.1)
        ])

        // Register # prefix with default styling
        autocompleteManager.register(prefix: "#")

        // Configuration options
        autocompleteManager.isCaseSensitive = false
        autocompleteManager.appendSpaceOnCompletion = true
        autocompleteManager.keepPrefixOnCompletion = true
        autocompleteManager.maxSpaceCountDuringCompletion = 1 // Allow "John Doe" style names
    }

    // MARK: - AutocompleteManagerDataSource

    func autocompleteManager(_ manager: AutocompleteManager, autocompleteSourceFor prefix: String) -> [AutocompleteCompletion] {
        if prefix == "@" {
            return users.map { AutocompleteCompletion(text: $0) }
        } else if prefix == "#" {
            return hashtags.map { AutocompleteCompletion(text: $0) }
        }
        return []
    }

    func autocompleteManager(_ manager: AutocompleteManager, tableView: UITableView, cellForRowAt indexPath: IndexPath, for session: AutocompleteSession) -> UITableViewCell {
        guard let cell = tableView.dequeueReusableCell(withIdentifier: AutocompleteCell.reuseIdentifier, for: indexPath) as? AutocompleteCell else {
            fatalError("Could not dequeue AutocompleteCell")
        }
        // Use helper method to create attributed text with matching characters bolded
        cell.textLabel?.attributedText = manager.attributedText(matching: session, fontSize: 15)
        return cell
    }

    // MARK: - AutocompleteManagerDelegate

    func autocompleteManager(_ manager: AutocompleteManager, shouldBecomeVisible: Bool) {
        let topStackView = messageInputBar.topStackView
        if shouldBecomeVisible && !topStackView.arrangedSubviews.contains(manager.tableView) {
            topStackView.insertArrangedSubview(manager.tableView, at: 0)
            topStackView.layoutIfNeeded()
        } else if !shouldBecomeVisible && topStackView.arrangedSubviews.contains(manager.tableView) {
            topStackView.removeArrangedSubview(manager.tableView)
            manager.tableView.removeFromSuperview()
            topStackView.layoutIfNeeded()
        }
    }

    // Optional: Control when autocomplete should register
    func autocompleteManager(_ manager: AutocompleteManager, shouldRegister prefix: String, at range: NSRange) -> Bool {
        return true
    }

    // Optional: Control when autocomplete should complete
    func autocompleteManager(_ manager: AutocompleteManager, shouldComplete prefix: String, with text: String) -> Bool {
        return true
    }
}
```

--------------------------------

### InputPlugin Protocol

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Defines the protocol for creating custom plugins that can be integrated with the MessageInputBar to extend its functionality and lifecycle.

```APIDOC
## InputPlugin Protocol

Creating custom plugins that integrate with the MessageInputBar's lifecycle.

### Description

The `InputPlugin` protocol allows developers to create custom components that interact with the `MessageInputBar`. Plugins can respond to data reloads, clear their state, and handle specific input types.

### Methods

- `reloadData()`: Called when the plugin's state needs to be reloaded, typically when the input bar's content changes.
- `invalidate()`: Called to clear all content and reset the plugin's state.
- `handleInput(of object: AnyObject) -> Bool`: Attempts to handle the input of a specific object. Returns `true` if the input was handled, `false` otherwise.

### Example Usage

```swift
import MessageInputBar

// InputPlugin protocol definition
public protocol InputPlugin: AnyObject {
    // Reload the plugin state
    func reloadData()

    // Clear all plugin content
    func invalidate()

    // Handle input of specific data types (return true if handled)
    func handleInput(of object: AnyObject) -> Bool
}

// Example: Custom typing indicator plugin
class TypingIndicatorPlugin: InputPlugin {

    weak var messageInputBar: MessageInputBar? // Reference to the MessageInputBar
    var onTypingStatusChanged: ((Bool) -> Void)? // Callback for typing status changes

    private var isTyping = false
    private var typingTimer: Timer? // Timer to manage typing indicator duration

    func reloadData() {
        guard let textView = messageInputBar?.inputTextView else { return }
        let hasText = !textView.text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty

        if hasText && !isTyping {
            isTyping = true
            onTypingStatusChanged?(true)
        }

        // Reset typing timer to auto-hide indicator after a delay
        typingTimer?.invalidate()
        typingTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: false) { [weak self] _ in
            self?.isTyping = false
            self?.onTypingStatusChanged?(false)
        }
    }

    func invalidate() {
        isTyping = false
        typingTimer?.invalidate()
        typingTimer = nil
        onTypingStatusChanged?(false)
    }

    func handleInput(of object: AnyObject) -> Bool {
        // This plugin doesn't handle direct input, only observes text changes via reloadData
        return false
    }
}

// Usage Example:
let typingPlugin = TypingIndicatorPlugin()
typingPlugin.onTypingStatusChanged = { isTyping in
    // Logic to send typing indicator status to a server
    SocketManager.shared.sendTypingStatus(isTyping)
}
// Assuming 'messageInputBar' is an instance of MessageInputBar
// messageInputBar.plugins.append(typingPlugin)
```
```

--------------------------------

### Implement Slack-style Input Bar in Swift

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Subclass MessageInputBar to configure custom background, text view styling, and bottom stack view items. Requires the MessageInputBar library.

```swift
import MessageInputBar

class SlackInputBar: MessageInputBar {

    override init(frame: CGRect) {
        super.init(frame: frame)
        configure()
    }

    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    func configure() {
        backgroundView.backgroundColor = .white
        inputTextView.backgroundColor = .clear
        inputTextView.layer.borderWidth = 0
        inputTextView.textContainerInset = UIEdgeInsets(top: 8, left: 0, bottom: 8, right: 0)
        inputTextView.placeholderLabelInsets = UIEdgeInsets(top: 8, left: 5, bottom: 8, right: 5)

        // Create bottom toolbar items
        let items = [
            makeButton(named: "ic_camera").onTextViewDidChange { button, textView in
                button.isEnabled = textView.text.isEmpty
            },
            makeButton(named: "ic_at").onTouchUpInside { [weak self] _ in
                self?.plugins.forEach { _ = $0.handleInput(of: "@" as AnyObject) }
            },
            makeButton(named: "ic_hashtag").onTouchUpInside { [weak self] _ in
                self?.plugins.forEach { _ = $0.handleInput(of: "#" as AnyObject) }
            },
            .flexibleSpace,
            makeButton(named: "ic_library"),
            sendButton.configure {
                $0.layer.cornerRadius = 8
                $0.layer.borderWidth = 1.5
                $0.layer.borderColor = $0.titleColor(for: .disabled)?.cgColor
                $0.setTitleColor(.white, for: .normal)
                $0.setSize(CGSize(width: 52, height: 30), animated: false)
            }.onEnabled {
                $0.backgroundColor = UIColor(red: 15/255, green: 135/255, blue: 255/255, alpha: 1.0)
                $0.layer.borderColor = UIColor.clear.cgColor
            }.onDisabled {
                $0.backgroundColor = .white
                $0.layer.borderColor = $0.titleColor(for: .disabled)?.cgColor
            }
        ]
        items.forEach { $0.tintColor = .lightGray }
        setStackViewItems(items, forStack: .bottom, animated: false)

        // Add expand/collapse button in right stack
        let maxSizeItem = InputBarButtonItem()
            .configure {
                $0.image = UIImage(named: "icons8-expand")?.withRenderingMode(.alwaysTemplate)
                $0.tintColor = .darkGray
                $0.setSize(CGSize(width: 20, height: 20), animated: false)
            }.onTouchUpInside { [weak self] item in
                guard let self = self else { return }
                let isExpanded = self.shouldForceTextViewMaxHeight
                item.image = isExpanded ?
                    UIImage(named: "icons8-expand")?.withRenderingMode(.alwaysTemplate) :
                    UIImage(named: "icons8-collapse")?.withRenderingMode(.alwaysTemplate)
                self.setShouldForceMaxTextViewHeight(to: !isExpanded, animated: true)
            }

        rightStackView.alignment = .top
        setStackViewItems([maxSizeItem], forStack: .right, animated: false)
        setRightStackViewWidthConstant(to: 20, animated: false)
    }

    private func makeButton(named: String) -> InputBarButtonItem {
        return InputBarButtonItem()
            .configure {
                $0.spacing = .fixed(10)
                $0.image = UIImage(named: named)?.withRenderingMode(.alwaysTemplate)
                $0.setSize(CGSize(width: 30, height: 30), animated: false)
            }.onSelected {
                $0.tintColor = UIColor(red: 15/255, green: 135/255, blue: 255/255, alpha: 1.0)
            }.onDeselected {
                $0.tintColor = .lightGray
            }
    }
}
```

--------------------------------

### Configure InputTextView

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Customize placeholder text, colors, insets, and styling for the text input area. Enables image pasting and provides access to pasted images and components.

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Configure placeholder
messageInputBar.inputTextView.placeholder = "Type a message..."
messageInputBar.inputTextView.placeholderTextColor = UIColor(white: 0.6, alpha: 1.0)

// Configure text insets
messageInputBar.inputTextView.textContainerInset = UIEdgeInsets(top: 8, left: 16, bottom: 8, right: 36)
messageInputBar.inputTextView.placeholderLabelInsets = UIEdgeInsets(top: 8, left: 20, bottom: 8, right: 36)

// Style the text view
messageInputBar.inputTextView.backgroundColor = UIColor(white: 0.95, alpha: 1.0)
messageInputBar.inputTextView.layer.borderColor = UIColor.lightGray.cgColor
messageInputBar.inputTextView.layer.borderWidth = 1.0
messageInputBar.inputTextView.layer.cornerRadius = 16.0
messageInputBar.inputTextView.layer.masksToBounds = true

// Enable/disable image pasting
messageInputBar.inputTextView.isImagePasteEnabled = true

// Access images pasted into the text view
let pastedImages: [UIImage] = messageInputBar.inputTextView.images

// Get all components (text and images) in order
let components: [Any] = messageInputBar.inputTextView.components
for component in components {
    if let text = component as? String {
        print("Text: \(text)")
    } else if let image = component as? UIImage {
        print("Image: \(image)")
    }
}
```

--------------------------------

### MessageInputBar Delegate Methods

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Implement these delegate methods to respond to user interactions with the MessageInputBar, such as pressing the send button or text changes.

```Swift
func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String)
```

```Swift
func messageInputBar(_ inputBar: MessageInputBar, didChangeIntrinsicContentTo size: CGSize)
```

```Swift
func messageInputBar(_ inputBar: MessageInputBar, textViewTextDidChangeTo text: String)
```

--------------------------------

### Define Custom InputPlugin Protocol

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Implement the InputPlugin protocol to create custom components that integrate with MessageInputBar's lifecycle. Requires conforming to reloadData, invalidate, and handleInput methods.

```swift
import MessageInputBar

// InputPlugin protocol definition
public protocol InputPlugin: AnyObject {
    // Reload the plugin state
    func reloadData()

    // Clear all plugin content
    func invalidate()

    // Handle input of specific data types (return true if handled)
    func handleInput(of object: AnyObject) -> Bool
}
```

--------------------------------

### Integrate MessageInputBar with Child View Controller

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Demonstrates how to embed MessageInputBar within a child view controller and manage its first responder status through the parent view controller. Ensure the parent view controller can become first responder and forwards the inputAccessoryView.

```swift
import MessageInputBar

class ParentViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        let childVC = ChatViewController()
        addChild(childVC)
        view.addSubview(childVC.view)
        childVC.view.frame = view.bounds
        childVC.didMove(toParent: self)

        // IMPORTANT: Call becomeFirstResponder on parent to show inputAccessoryView
        becomeFirstResponder()
    }

    override var canBecomeFirstResponder: Bool {
        return true
    }

    // Forward inputAccessoryView to child
    override var inputAccessoryView: UIView? {
        return (children.first as? ChatViewController)?.messageInputBar
    }
}

class ChatViewController: UIViewController, MessageInputBarDelegate {

    let messageInputBar = MessageInputBar()

    override func viewDidLoad() {
        super.viewDidLoad()
        messageInputBar.delegate = self
    }

    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String) {
        print("Send: \(text)")
        inputBar.inputTextView.text = ""
    }
}
```

--------------------------------

### Configure Custom Send Button Behavior

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Customize the appearance and behavior of the send button using the `configure`, `onEnabled`, `onDisabled`, and `onTouchUpInside` closures. This allows for animations and custom actions when the button's state changes or is tapped.

```swift
messageInputBar.sendButton
    .configure {
        $0.title = "Send"
        $0.setTitleColor(.systemBlue, for: .normal)
        $0.setTitleColor(.lightGray, for: .disabled)
    }
    .onEnabled {
        button in
        UIView.animate(withDuration: 0.2) {
            button.transform = .identity
        }
    }
    .onDisabled {
        button in
        UIView.animate(withDuration: 0.2) {
            button.transform = CGAffineTransform(scaleX: 0.9, y: 0.9)
        }
    }
    .onTouchUpInside {
        button in
        button.messageInputBar?.didSelectSendButton()
    }
```

--------------------------------

### Subclassing MessageInputBar for iMessage Style

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Create a custom class inheriting from MessageInputBar to override styling and layout configurations. Ensure the required init(coder:) is implemented as shown.

```swift
import MessageInputBar

class iMessageInputBar: MessageInputBar {

    override init(frame: CGRect) {
        super.init(frame: frame)
        configure()
    }

    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    func configure() {
        // Style the text view with rounded corners
        inputTextView.backgroundColor = UIColor(red: 250/255, green: 250/255, blue: 250/255, alpha: 1)
        inputTextView.placeholderTextColor = UIColor(red: 0.6, green: 0.6, blue: 0.6, alpha: 1)
        inputTextView.textContainerInset = UIEdgeInsets(top: 8, left: 16, bottom: 8, right: 36)
        inputTextView.placeholderLabelInsets = UIEdgeInsets(top: 8, left: 20, bottom: 8, right: 36)
        inputTextView.layer.borderColor = UIColor(red: 200/255, green: 200/255, blue: 200/255, alpha: 1).cgColor
        inputTextView.layer.borderWidth = 1.0
        inputTextView.layer.cornerRadius = 16.0
        inputTextView.layer.masksToBounds = true
        inputTextView.scrollIndicatorInsets = UIEdgeInsets(top: 8, left: 0, bottom: 8, right: 0)

        // Configure send button as circular arrow
        setRightStackViewWidthConstant(to: 38, animated: false)
        setStackViewItems([sendButton, InputBarButtonItem.fixedSpace(2)], forStack: .right, animated: false)
        sendButton.contentEdgeInsets = UIEdgeInsets(top: 2, left: 2, bottom: 2, right: 2)
        sendButton.setSize(CGSize(width: 36, height: 36), animated: false)
        sendButton.image = UIImage(named: "ic_up")
        sendButton.title = nil
        sendButton.imageView?.layer.cornerRadius = 16
        sendButton.imageView?.backgroundColor = tintColor
        sendButton.backgroundColor = .clear

        // Overlap send button with text view
        textViewPadding.right = -38

        // Style background
        separatorLine.isHidden = true
        backgroundView.backgroundColor = .white
        isTranslucent = true
    }
}

// Usage
let inputBar = iMessageInputBar()
```

--------------------------------

### Adjusting Stack View Width Constraints

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Methods to dynamically adjust the width constraints of the left and right stack views, useful for hiding or showing buttons.

```Swift
func setLeftStackViewWidthConstant(to newValue: CGFloat, animated: Bool)
```

```Swift
func setRightStackViewWidthConstant(to newValue: CGFloat, animated: Bool)
```

--------------------------------

### Max Text View Height Control

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Explains how to manage the maximum height of the `MessageInputBar`'s text view, including automatic and manual control, forcing the max height, and retrieving height-related properties.

```APIDOC
## Max Text View Height Control

Controlling the maximum height of the text view and implementing expand/collapse functionality.

### Description

This section details how to configure and interact with the `MessageInputBar`'s text view height. You can enable automatic height adjustments based on content or set a fixed maximum height, and query properties related to the text view's current and required height.

### Properties and Methods

- `shouldAutoUpdateMaxTextViewHeight` (Bool):
    - `true` (default): The `MessageInputBar` automatically calculates and updates the maximum height of the text view based on available screen space and content.
    - `false`: Disables automatic height calculation, allowing for manual control.

- `maxTextViewHeight` (CGFloat):
    - When `shouldAutoUpdateMaxTextViewHeight` is `false`, this property sets a fixed maximum height for the text view.

- `setShouldForceMaxTextViewHeight(to: Bool, animated: Bool)`:
    - Forces the text view to expand to its maximum allowed height (`maxTextViewHeight` or automatically calculated height).
    - `to`: Set to `true` to force max height, `false` to allow normal height adjustment.
    - `animated`: Set to `true` to animate the height change.

- `calculateMaxTextViewHeight() -> CGFloat`:
    - Calculates the maximum height the text view can occupy. This calculation typically considers the screen's vertical size class.
    - Returns `screen.height / 3` for regular vertical size class.
    - Returns `screen.height / 5` for compact vertical size class.

- `isOverMaxTextViewHeight` (Bool):
    - Returns `true` if the current text content requires a height greater than the maximum allowed height, `false` otherwise.

- `requiredInputTextViewHeight` (CGFloat):
    - Returns the height required to display the current text content without truncation.

### Example Usage

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Automatic height management (default behavior)
messageInputBar.shouldAutoUpdateMaxTextViewHeight = true

// Manual height control
messageInputBar.shouldAutoUpdateMaxTextViewHeight = false
messageInputBar.maxTextViewHeight = 200.0 // Set a fixed max height in points

// Force the text view to expand to its maximum height
messageInputBar.setShouldForceMaxTextViewHeight(to: true, animated: true)

// To revert to normal height adjustment after forcing max height:
// messageInputBar.setShouldForceMaxTextViewHeight(to: false, animated: true)

// Calculate the maximum possible height for the text view
let calculatedMaxHeight = messageInputBar.calculateMaxTextViewHeight()
print("Calculated Max Height: \(calculatedMaxHeight)")

// Check if the current text content exceeds the maximum allowed height
let isAtMaxHeight = messageInputBar.isOverMaxTextViewHeight
print("Is at max height: \(isAtMaxHeight)")

// Get the height needed to display all current text content
let requiredHeight = messageInputBar.requiredInputTextViewHeight
print("Required height for current text: \(requiredHeight)")
```
```

--------------------------------

### Integrate AttachmentManager Plugin

Source: https://context7.com/messagekit/messageinputbar/llms.txt

The AttachmentManager plugin handles image, URL, and data attachments, displaying them in a collection view. It requires conforming to the AttachmentManagerDelegate protocol.

```swift
import MessageInputBar

class ChatViewController: UIViewController, AttachmentManagerDelegate {

    let messageInputBar = MessageInputBar()

    lazy var attachmentManager: AttachmentManager = {
        let manager = AttachmentManager()
        manager.delegate = self
        return manager
    }()

    override func viewDidLoad() {
        super.viewDidLoad()
        // Register the plugin
        messageInputBar.plugins = [attachmentManager]
    }

    // MARK: - Adding Attachments

    func addImageAttachment(_ image: UIImage) {
        attachmentManager.insertAttachment(.image(image), at: attachmentManager.attachments.count)
    }

    func addURLAttachment(_ url: URL) {
        attachmentManager.insertAttachment(.url(url), at: 0)
    }

    func addDataAttachment(_ data: Data) {
        attachmentManager.insertAttachment(.data(data), at: 0)
    }

    // Alternative: Use handleInput for automatic type detection
    func addAttachmentViaHandleInput(_ image: UIImage) {
        let handled = attachmentManager.handleInput(of: image)
        if handled {
            print("Attachment added successfully")
        }
    }

    // MARK: - AttachmentManagerDelegate

    func attachmentManager(_ manager: AttachmentManager, shouldBecomeVisible: Bool) {
        // Show/hide attachment view in top stack view
        let topStackView = messageInputBar.topStackView
        if shouldBecomeVisible && !topStackView.arrangedSubviews.contains(manager.attachmentView) {
            topStackView.insertArrangedSubview(manager.attachmentView, at: 0)
            topStackView.layoutIfNeeded()
        } else if !shouldBecomeVisible && topStackView.arrangedSubviews.contains(manager.attachmentView) {
            topStackView.removeArrangedSubview(manager.attachmentView)
            manager.attachmentView.removeFromSuperview()
            topStackView.layoutIfNeeded()
        }
    }

    func attachmentManager(_ manager: AttachmentManager, didReloadTo attachments: [AttachmentManager.Attachment]) {
        messageInputBar.sendButton.isEnabled = attachments.count > 0
    }

    func attachmentManager(_ manager: AttachmentManager, didInsert attachment: AttachmentManager.Attachment, at index: Int) {
        messageInputBar.sendButton.isEnabled = manager.attachments.count > 0
    }

    func attachmentManager(_ manager: AttachmentManager, didRemove attachment: AttachmentManager.Attachment, at index: Int) {
        messageInputBar.sendButton.isEnabled = manager.attachments.count > 0
    }

    func attachmentManager(_ manager: AttachmentManager, didSelectAddAttachmentAt index: Int) {
        // User tapped the add button - present image picker
        let picker = UIImagePickerController()
        picker.sourceType = .photoLibrary
        present(picker, animated: true)
    }
}
```

--------------------------------

### Become First Responder for MessageInputBar

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

When using MessagesViewController as a child view controller, ensure the parent controller becomes the first responder to make the MessageInputBar appear. This is because MessageInputBar is the inputAccessoryView of MessagesViewController.

```Swift
class ParentVC: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
let childVC = MessagesViewController()
addChildViewController(childVC)
self.view.addSubview(childVC.view)
childVC.didMove(toParentViewController:self)
self.becomeFirstResponder()
}
}
```

--------------------------------

### Define MessageInputBarDelegate Protocol

Source: https://context7.com/messagekit/messageinputbar/llms.txt

The protocol defines methods for handling send actions, text changes, and intrinsic content size updates.

```swift
public protocol MessageInputBarDelegate: AnyObject {

    // Called when the send button is pressed with the current text
    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String)

    // Called when the intrinsic content size changes (for adjusting other views)
    func messageInputBar(_ inputBar: MessageInputBar, didChangeIntrinsicContentTo size: CGSize)

    // Called when the text in the InputTextView changes
    func messageInputBar(_ inputBar: MessageInputBar, textViewTextDidChangeTo text: String)
}

// All delegate methods have default empty implementations
```

--------------------------------

### MessageInputBarDelegate Protocol

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Defines the delegate methods for MessageInputBar to communicate events such as send button presses, text changes, and intrinsic content size changes.

```APIDOC
## MessageInputBarDelegate Protocol

Protocol for receiving notifications from the MessageInputBar including send button presses, text changes, and size changes.

```swift
public protocol MessageInputBarDelegate: AnyObject {

    // Called when the send button is pressed with the current text
    func messageInputBar(_ inputBar: MessageInputBar, didPressSendButtonWith text: String)

    // Called when the intrinsic content size changes (for adjusting other views)
    func messageInputBar(_ inputBar: MessageInputBar, didChangeIntrinsicContentTo size: CGSize)

    // Called when the text in the InputTextView changes
    func messageInputBar(_ inputBar: MessageInputBar, textViewTextDidChangeTo text: String)
}

// All delegate methods have default empty implementations
```
```

--------------------------------

### Define InputBarButtonItem Action Hooks

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Defines the type aliases and private action properties used to handle lifecycle and interaction events for InputBarButtonItem.

```swift
// MARK: - Hooks

public typealias InputBarButtonItemAction = ((InputBarButtonItem) -> Void)
    
private var onTouchUpInsideAction: InputBarButtonItemAction?
private var onKeyboardEditingBeginsAction: InputBarButtonItemAction?
private var onKeyboardEditingEndsAction: InputBarButtonItemAction?
private var onTextViewDidChangeAction: ((InputBarButtonItem, InputTextView) -> Void)?
private var onSelectedAction: InputBarButtonItemAction?
private var onDeselectedAction: InputBarButtonItemAction?
private var onEnabledAction: InputBarButtonItemAction?
private var onDisabledAction: InputBarButtonItemAction?
```

--------------------------------

### InputBarButtonItem Default StackView Properties

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Default properties applied to UIStackViews when using InputBarButtonItem, ensuring proper layout based on intrinsicContentSize.

```Swift
let view = UIStackView()
view.axis = .horizontal
view.distribution = .fill
view.alignment = .fill
view.spacing = 15
```

--------------------------------

### MessageInputBar Layout Constraints

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Defines the layout of the MessageInputBar using UIStackViews and an InputTextView. Padding can be adjusted using the 'padding' and 'textViewPadding' properties.

```Swift
H:|-(padding.left)-[UIStackView(leftStackViewWidthContant)]-(textViewPadding.left)-[InputTextView]-(textViewPadding.right)-[UIStackView(rightStackViewWidthContant)]-(padding.right)-|

V:|-(padding.top)-[InputTextView]-(textViewPadding.bottom)-[UIStackView]-(padding.bottom)-|
```

--------------------------------

### Manage Send Button State with MessageInputBar

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Set `shouldManageSendButtonEnabledState` to true for automatic management based on text. Set it to false for manual control, allowing you to enable or disable the send button directly.

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Automatic management (enabled when text is not empty)
messageInputbar.shouldManageSendButtonEnabledState = true

// Manual management
messageInputBar.shouldManageSendButtonEnabledState = false
messageInputBar.sendButton.isEnabled = false
```

--------------------------------

### InputBarButtonItem Spacing Configuration

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Configure spacing for InputBarButtonItems using the 'spacing' property. This affects content hugging priority and adds extra space to intrinsicContentSize when set to .fixed(CGFloat).

```Swift
let item = InputBarButtonItem()
item.spacing = .fixed(20) // Example of setting fixed spacing
```

--------------------------------

### Control MessageInputBar Max Text View Height

Source: https://context7.com/messagekit/messageinputbar/llms.txt

Manage the maximum height of the MessageInputBar's text view. Options include automatic height adjustment, setting a fixed maximum height, forcing the maximum height, and calculating required height based on content.

```swift
import MessageInputBar

let messageInputBar = MessageInputBar()

// Automatic height management (default)
messageInputBar.shouldAutoUpdateMaxTextViewHeight = true

// Manual height control
messageInputBar.shouldAutoUpdateMaxTextViewHeight = false
messageInputBar.maxTextViewHeight = 200.0 // Fixed max height

// Force max height (keeps text view at maximum size)
messageInputBar.setShouldForceMaxTextViewHeight(to: true, animated: true)

// Calculate max height based on screen
let calculatedMaxHeight = messageInputBar.calculateMaxTextViewHeight()
// Returns screen.height / 3 for regular vertical size class
// Returns screen.height / 5 for compact vertical size class

// Check if currently at max height
let isAtMaxHeight = messageInputBar.isOverMaxTextViewHeight

// Get required height for current text content
let requiredHeight = messageInputBar.requiredInputTextViewHeight
```

--------------------------------

### InputBarButtonItem Size Customization

Source: https://github.com/messagekit/messageinputbar/blob/master/Documentation/MessageInputBar.md

Override the intrinsicContentSize of an InputBarButtonItem by setting its 'size' property. If nil, the superclass's intrinsicContentSize is used.

```Swift
let item = InputBarButtonItem()
item.size = CGSize(width: 50, height: 30) // Example of setting a fixed size
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.