SwiftMessages

https://github.com/swiftkickmobile/swiftmessages
Admin
SwiftMessages is a flexible view and view controller presentation library for UIKit and SwiftUI that...
Tokens:66,386
Snippets:591
Trust Score:9.3
License:MIT
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### open override func awakeFromNib()

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/KeyboardTrackingView.md

Calls postInit() after the view is loaded from a nib, ensuring proper setup.

```APIDOC
## awakeFromNib()

### Description
Calls postInit() after the view is loaded from a nib, ensuring proper setup.

### Method
awakeFromNib

### Code
```swift
open override func awakeFromNib() {
    super.awakeFromNib()
    postInit()
}
```
```

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

### show(context:completion:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Public method that installs the message view and performs the show animation.

```APIDOC
## show(context:completion:)

### Description
Installs the message view (leading/trailing pinned, top/bottom constrained with bounceOffset, panned offscreen by one view height), observes device orientation changes, installs the pan recognizer, and rounds leading corners for tab layouts. Animation completes with `true` on success.

### Method
show

### Signature
`public func show(context: AnimationContext, completion: @escaping AnimationCompletion)`

### Parameters
- **context** (AnimationContext) - Required - `messageView`, `containerView`, `safeZoneConflicts`, `interactiveHide`.
- **completion** (@escaping AnimationCompletion) - Required - `(Bool) -> Void`; called with `true` on success.

### Example
```swift
animation.show(context: context) { completed in
    // handle completion
}
```
```

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

### init(frame:) constructor

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/CornerRoundingView.md

Initializes the view with a frame and installs the shape layer mask.

```swift
override public init(frame: CGRect) {
    super.init(frame: frame)
    sharedInit()
}
```

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

### init(coder:) constructor

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/CornerRoundingView.md

Initializes the view from a nib or coder and installs the shape layer mask.

```swift
required public init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
    sharedInit()
}
```

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

### install() method for WindowViewController

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/WindowViewController.md

Installs the window into the config's window scene (or the key window's scene) and shows it. Records the previous key window (outside the SwiftMessages app-extension build) so it can be restored on uninstall. With becomeKey: true the window calls makeKeyAndVisible(), otherwise isHidden = false. The frame is the scene's coordinate space bounds, else the main screen bounds.

```swift
func install() {
    window?.windowScene = config.windowScene
    #if !SWIFTMESSAGES_APP_EXTENSIONS
    previousKeyWindow = UIWindow.keyWindow
    #endif
    show(
        becomeKey: config.shouldBecomeKeyWindow,
        frame: config.windowScene?.coordinateSpace.bounds
    )
}
```

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

### Create and show a card view

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Example usage of viewFromNib with .cardView layout, configuring theme, drop shadow, and content, then showing via SwiftMessages.show.

```swift
let view = MessageView.viewFromNib(layout: .cardView)
view.configureTheme(.warning)
view.configureDropShadow()
view.configureContent(title: "Warning", body: "Consider yourself warned.", iconText: "🤔")
SwiftMessages.show(view: view)
```

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

### Card-style programmatic layout example

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Shows a card-style programmatic layout using installBackgroundView with a card view and insets of 10 points on all sides.

```swift
// Card-style programmatic layout.
let card = UIView(frame: .zero)
messageView.installBackgroundView(card, insets: UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10))
```

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

### Set default configuration and customize

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Shows how to set default configuration options and then customize a copy of the default config for a specific message. The example sets presentation style to bottom, shows with default config, then creates a custom config with duration .forever and shows with it.

```swift
SwiftMessages.defaultConfig.presentationStyle = .bottom

// Show message with default config.
SwiftMessages.show(view: view)

// Customize config using the default as a base.
var config = SwiftMessages.defaultConfig
config.duration = .forever
SwiftMessages.show(config: config, view: view)
```

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

### MessageHostingView usage examples

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Two usage examples: one using MessageViewConvertible to let the model build its own view, and one using an explicit builder closure to access geometry.

```swift
// Data-driven: the model builds its own view.
extension DemoMessage: MessageViewConvertible {
    func asMessageView() -> DemoMessageView {
        DemoMessageView(message: self)
    }
}
let view = MessageHostingView(message: message)   // Content inferred as DemoMessageView

// With an explicit builder (access to geometry).
let view = MessageHostingView(message: message) { message, geometry in
    MyMessageView(message: message, maxWidth: geometry.size.width)
}
```

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

### Show animation with orientation observer

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsAnimation.md

Adds an orientation observer, installs the view, and runs the show animation. The animation starts at alpha 0.25 and scale 0.6, then animates to identity transform over showDuration with spring damping 0.6 and alpha to 1 over 0.3 × showDuration, wrapped in a CATransaction.

```swift
public func show(context: AnimationContext, completion: @escaping AnimationCompletion) {
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(adjustMargins),
        name: UIDevice.orientationDidChangeNotification,
        object: nil
    )
    install(context: context)
    showAnimation(context: context, completion: completion)
}
```

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

### containment Property

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessagesSegue.md

Determines how the destination view is installed into the message view.

```APIDOC
## containment Property

### Description
How the destination view is installed into `messageView`.

### Declaration
```swift
public var containment: Containment = .content
```

### Parameters
- **containment** (`Containment`) - Default `.content`. The containment mode.
```

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

### installContentView method implementation

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Installs a content view as a subview of the background view, pinned to its edges with insets and a 350pt low-priority height constraint. The contentView is required, and insets default to UIEdgeInsets.zero.

```swift
open func installContentView(_ contentView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero) {
    contentView.translatesAutoresizingMaskIntoConstraints = false
    backgroundView.addSubview(contentView)
    contentView.topAnchor.constraint(equalTo: backgroundView.topAnchor, constant: insets.top).isActive = true
    contentView.bottomAnchor.constraint(equalTo: backgroundView.bottomAnchor, constant: -insets.bottom).isActive = true
    contentView.leftAnchor.constraint(equalTo: backgroundView.leftAnchor, constant: insets.left).isActive = true
    contentView.rightAnchor.constraint(equalTo: backgroundView.rightAnchor, constant: -insets.right).isActive = true
    contentView.heightAnchor.constraint(equalToConstant: 350).with(priority: UILayoutPriority(rawValue: 200)).isActive = true
}
```

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

### Configure CornerRoundingView programmatically

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/CornerRoundingView.md

Example of how to access the background view of a MessageView and set the corner radius.

```swift
let view = MessageView.viewFromNib(layout: .cardView)
(view.backgroundView as? CornerRoundingView)?.cornerRadius = 10
```

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

### show(context:completion:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsAnimation.md

Presents the message view with a physics-based spring animation. Observes orientation changes, installs the view with proper constraints, and animates from alpha 0.25 and scale 0.6 to identity transform with spring damping.

```APIDOC
## show(context:completion:)

### Description
Presents the message view with a physics-based spring animation. Observes orientation changes, installs the view with proper constraints, and animates from alpha 0.25 and scale 0.6 to identity transform with spring damping.

### Method
`public func show(context: AnimationContext, completion: @escaping AnimationCompletion)`

### Parameters
- **context** (`AnimationContext`) - Required - Animation context.
- **completion** (`@escaping AnimationCompletion`) - Required - Completion callback.

### Code Example
```swift
public func show(context: AnimationContext, completion: @escaping AnimationCompletion) {
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(adjustMargins),
        name: UIDevice.orientationDidChangeNotification,
        object: nil
    )
    install(context: context)
    showAnimation(context: context, completion: completion)
}
```

### Behavior
Observes orientation changes for margin adjustment, installs the view (top/center/bottom anchor per `placement`, leading/trailing pinned, top ≥ container top and bottom ≤ container bottom so the message never spills), computes margins, and runs the show animation: start at alpha `0.25`, scale `0.6`; animate to identity transform over `showDuration` with spring damping `0.6`; alpha to `1` over `0.3 × showDuration`, wrapped in a `CATransaction` so both animations commit together.
```

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

### Example usage of viewFromNib variants

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Shows basic nib loading by name and error handling for the generic method that catches SwiftMessagesError.cannotLoadViewFromNib.

```swift
// Basic
let view: MessageView = try! SwiftMessages.viewFromNib(named: "MyCustomNib")

// Error handling — the nib must contain a MyCustomView view
let view: MyCustomView
do {
    view = try SwiftMessages.viewFromNib()
} catch SwiftMessagesError.cannotLoadViewFromNib(let nibName) {
    print("missing view in \(nibName).nib")
}
```

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

### Apply warning theme with haptic

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Example call to configureTheme with the .warning theme and haptic feedback enabled. This applies the predefined warning colors and icon, and triggers a warning haptic.

```swift
view.configureTheme(.warning, includeHaptic: true)
```

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

### SwiftMessages.show with viewProvider closure

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Example of using the static show(viewProvider:) convenience to display a MessageView with a warning theme.

```swift
SwiftMessages.show {
    let view = MessageView.viewFromNib(layout: .cardView)
    view.configureTheme(.warning)
    return view
}
```

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

### public func show(context:completion:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Shows the message view. Installs the view, observes orientation changes, and sets up interactive hide. Completes with true on success, or true when the app is not active (Fix #131) outside app-extension builds.

```swift
public func show(context: AnimationContext, completion: @escaping AnimationCompletion) {
    NotificationCenter.default.addObserver(self, selector: #selector(adjustMargins), name: UIDevice.orientationDidChangeNotification, object: nil)
    install(context: context)
    showAnimation(completion: completion)
}
```

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

### didMoveToSuperview override for hosting view setup

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

When the view moves to a superview, computes a MessageGeometryProxy from the superview's bounds and safe-area insets (layout direction aware), creates a UIHostingController with content(proxy), loads it, and pins its view to all edges.

```swift
public override func didMoveToSuperview() {
    guard let superview = self.superview else { return }
    let size = superview.bounds.size
    let insets = superview.safeAreaInsets
    let ltr = superview.effectiveUserInterfaceLayoutDirection == .leftToRight
    let proxy = MessageGeometryProxy(
        size: CGSize(width: size.width - insets.left - insets.right,
                     height: size.height - insets.top - insets.bottom),
        safeAreaInsets: EdgeInsets(top: insets.top,
                                   leading: ltr ? insets.left : insets.right,
                                   bottom: insets.bottom,
                                   trailing: ltr ? insets.right : insets.left)
    )
    let hostVC = UIHostingController(rootView: content(proxy))
    self.hostVC = hostVC
    hostVC.loadViewIfNeeded()
    installContentView(hostVC.view)
    hostVC.view.backgroundColor = .clear
}
```

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

### installBackgroundView method signature

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Declares the installBackgroundView method that installs a background view pinned to layout margins with card-style insets. The backgroundView is required, and insets default to UIEdgeInsets.zero.

```swift
open func installBackgroundView(_ backgroundView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero)
```

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

### Load MessageView from bundled nib layout

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Use this convenience method to load a MessageView from a bundled nib file by specifying the layout. This is the simplest way to get a pre-designed message view.

```swift
let view = MessageView.viewFromNib(layout: .cardView)
```

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

### installBackgroundVerticalView method signature

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Declares the installBackgroundVerticalView method that installs a background view pinned to horizontal layout margins and vertical view edges (tab-style). The backgroundView is required, and insets default to UIEdgeInsets.zero.

```swift
open func installBackgroundVerticalView(_ backgroundView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero)
```

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

### Using KeyboardTrackingView for keyboard avoidance

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/KeyboardTrackingView.md

Usage examples for KeyboardTrackingView. For SwiftMessages presentations, set it as the keyboardTrackingView in the default config. For standalone use, create with frame .zero and pin to bottom/leading/trailing edges with Auto Layout, then pin content to its top.

```swift
// Automatic keyboard avoidance for SwiftMessages presentations.
var config = SwiftMessages.defaultConfig
config.keyboardTrackingView = KeyboardTrackingView()

// Standalone use in your own view hierarchy:
let tracker = KeyboardTrackingView(frame: .zero)
// pin to bottom/leading/trailing edges with Auto Layout, then pin content to its top.
```

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

### Carthage Cartfile entry

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Add this line to your Cartfile to install SwiftMessages via Carthage.

```ruby
github "SwiftKickMobile/SwiftMessages"
```

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

### CocoaPods Podfile entry

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Add this line to your Podfile to install SwiftMessages via CocoaPods.

```ruby
pod 'SwiftMessages'
```

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

### init(coder:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Initializes a BaseView from a nib or coding deserialization. Sets backgroundView to self and zeroes layout margins.

```APIDOC
## init(coder:)

### Description
Initializes a BaseView from a nib or coding deserialization. Sets backgroundView to self and zeroes layout margins.

### Method
init

### Signature
`public required init?(coder aDecoder: NSCoder)`

### Parameters
- **aDecoder** (NSCoder) - Required - Nib/coding deserialization.

### Code Example
```swift
public required init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
    backgroundView = self
    layoutMargins = UIEdgeInsets.zero
}
```
```

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

### show(viewProvider:) implementation

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Convenience overload that uses SwiftMessages.defaultConfig and the viewProvider variant.

```swift
public func show(viewProvider: @escaping ViewProvider) {
    show(config: defaultConfig, viewProvider: viewProvider)
}
```

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

### tapHandler

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

A closure called when the background view is tapped. The tap recognizer is installed only when the handler is non-nil.

```APIDOC
## tapHandler

### Description
A closure called when the background view is tapped. The tap recognizer is installed only when the handler is non-nil.

### Property
`open var tapHandler: ((_ view: BaseView) -> Void)?`

### Default
`nil`

### Code Example
```swift
open var tapHandler: ((_ view: BaseView) -> Void)? {
    didSet { installTapRecognizer() }
}
```

### Usage Example
```swift
let baseView = BaseView(frame: .zero)
baseView.tapHandler = { _ in SwiftMessages.hide() }
```
```

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

### show(view:) implementation

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Convenience overload that uses SwiftMessages.defaultConfig.

```swift
public func show(view: UIView) {
    show(config: defaultConfig, view: view)
}
```

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

### tapHandler property

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Defines the tapHandler closure property; the tap recognizer is installed only when the handler is non-nil.

```swift
open var tapHandler: ((_ view: BaseView) -> Void)? {
    didSet { installTapRecognizer() }
}
```

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

### init(frame:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/BaseView.md

Initializes a BaseView with a specified frame. Sets backgroundView to self and zeroes layout margins.

```APIDOC
## init(frame:)

### Description
Initializes a BaseView with a specified frame. Sets backgroundView to self and zeroes layout margins.

### Method
init

### Signature
`public override init(frame: CGRect)`

### Parameters
- **frame** (CGRect) - Required - View frame.

### Code Example
```swift
public override init(frame: CGRect) {
    super.init(frame: frame)
    backgroundView = self
    layoutMargins = UIEdgeInsets.zero
}
```
```

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

### show(view:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Displays the given view using the default configuration (SwiftMessages.defaultConfig).

```APIDOC
## show(view:)

### Description
Displays the given view using the default configuration (SwiftMessages.defaultConfig).

### Method
show

### Signature
`public func show(view: UIView)`

### Parameters
- **view** (UIView) - Required - View to display using SwiftMessages.defaultConfig.

### Return Value
Void
```

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

### Set SwiftMessages.pauseBetweenMessages value

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Example usage showing how to set the pause duration between messages to 1.0 seconds.

```swift
SwiftMessages.pauseBetweenMessages = 1.0
```

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

### Weak usage example

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/Weak.md

Basic usage of Weak to hold a weak reference and guard against a collected referent.

```swift
// Basic use.
let weakRef = Weak<UIViewController>(value: myViewController)

// Guard against a collected referent.
if let vc = weakRef.value {
    vc.someMethod()
} else {
    // The view controller was released; fall back.
    showInNewWindow()
}
```

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

### public init(style: TopBottomAnimationStyle)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Initializes a TopBottomAnimation with a required style parameter, either .top or .bottom.

```swift
public init(style: TopBottomAnimationStyle) {
    self.style = style
}
```

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

### configureTheme(_:iconStyle:includeHaptic:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Applies a predefined theme with optional icon style and haptic feedback.

```APIDOC
## `public func configureTheme(_ theme: Theme, iconStyle: IconStyle = .default, includeHaptic: Bool = false)`

### Description
Applies a predefined theme with optional icon style and haptic feedback.

### Method
`configureTheme(_:iconStyle:includeHaptic:)`

### Parameters
- **theme** (`Theme`) - Required - The theme to apply: `.info`, `.success`, `.warning`, or `.error`.
- **iconStyle** (`IconStyle`) - Optional - Icon variant: `.default`, `.light`, `.subtle`, or `.none`. Defaults to `.default`.
- **includeHaptic** (`Bool`) - Optional - When `true`, sets `defaultHaptic` from the theme (`.info`/`.success` → success, `.warning` → warning, `.error` → error). Defaults to `false`.

### Description
Sets pre-defined background/foreground colors and icon image, with dark-style variants when the system interface style is dark/unspecified. Background colors: info gray `225/255`, success green `97-161-23`, warning amber `246-197-44`, error red `249-66-47` (light variants).

### Request Example
```swift
view.configureTheme(.warning, includeHaptic: true)
```

### Response
No return value.
```

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

### Retrieve messages by ID

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Shows how to get currently shown, queued, or both shown and queued messages by ID.

```swift
// Get a message view with the given ID if it is currently 
// being shown or hidden.
if let view = SwiftMessages.current(id: "some id") { ... }

// Get a message view with the given ID if is it currently 
// queued to be shown. 
if let view = SwiftMessages.queued(id: "some id") { ... }

// Get a message view with the given ID if it is currently being
// shown, hidden or in the queue to be shown.
if let view = SwiftMessages.currentOrQueued(id: "some id") { ... }
```

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

### init(style:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Public initializer that sets the animation style (top or bottom).

```APIDOC
## init(style:)

### Description
Initializes a TopBottomAnimation with the specified style.

### Method
init

### Signature
`public init(style: TopBottomAnimationStyle)`

### Parameters
- **style** (TopBottomAnimationStyle) - Required - `.top` or `.bottom`.

### Example
```swift
let animation = TopBottomAnimation(style: .top)
```
```

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

### show(viewProvider:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Displays a view provided by a closure using the default configuration. The closure is run on the main queue.

```APIDOC
## show(viewProvider:)

### Description
Displays a view provided by a closure using the default configuration. The closure is run on the main queue.

### Method
show

### Signature
`public func show(viewProvider: @escaping ViewProvider)`

### Parameters
- **viewProvider** (@escaping ViewProvider) - Required - Block returning the view; run on the main queue.

### Return Value
Void

### Example
```swift
SwiftMessages.show {
    let view = MessageView.viewFromNib(layout: .cardView)
    view.configureTheme(.warning)
    return view
}
```
```

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

### perform()

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessagesSegue.md

Starts the presentation of the message. The segue retains itself until dismissal, so it doesn't need to be retained unless perform() will be called more than once.

```APIDOC
## `override open func perform()`

### Description
Starts the presentation. The segue retains itself until dismissal (`selfRetainer`), so it doesn't need to be retained, unless `perform()` will be called more than once. A `startReleaseMonitor()` releases the self-retention if the presenting view controller leaves the hierarchy without dismissal.

### Method
`perform()`

### Parameters
None

### Return Value
None

### Example
```swift
segue.perform()
```
```

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

### init(style:delegate:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Initializer that sets the animation style and a delegate for animation callbacks.

```APIDOC
## init(style:delegate:)

### Description
Initializes a TopBottomAnimation with a style and a delegate.

### Method
init

### Signature
`init(style: TopBottomAnimationStyle, delegate: AnimationDelegate)`

### Parameters
- **style** (TopBottomAnimationStyle) - Required - Slide direction.
- **delegate** (AnimationDelegate) - Required - AnimationDelegate (`SwiftMessages` instance or custom).

### Example
```swift
let animation = TopBottomAnimation(style: .bottom, delegate: someDelegate)
```
```

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

### public init(id:content:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Initializes a MessageHostingView with a given identifier and SwiftUI content. The id is used for duplicate removal.

```APIDOC
## public init(id:content:)

### Description
Initializes a MessageHostingView with a given identifier and SwiftUI content. The id is used for duplicate removal.

### Method
Initializer

### Signature
```swift
public init(id: String, content: Content)
```

### Parameters
- **id** (String) - Required - Message identity used for deduplication.
- **content** (Content) - Required - SwiftUI view to host.

### Example
```swift
let view = MessageHostingView(id: "myMessage", content: MyMessageView())
```
```

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

### containment property declaration

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessagesSegue.md

Declares the containment property with a default value of .content, controlling how the destination view is installed into messageView.

```swift
public var containment: Containment = .content
```

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

### PhysicsAnimation.init()

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsAnimation.md

No-argument initializer for creating a PhysicsAnimation instance with default settings.

```APIDOC
## PhysicsAnimation.init()

### Description
No-argument initializer for creating a PhysicsAnimation instance with default settings.

### Method
init

### Signature
```swift
public override init() {}
```

### Parameters
None

### Return Value
A new PhysicsAnimation instance.

### Example
```swift
let animation = PhysicsAnimation()
```
```

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

### Convenience init() for WindowViewController

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/WindowViewController.md

Creates a WindowViewController with default SwiftMessages.Config. Equivalent to init(config: SwiftMessages.Config()).

```swift
convenience public init() {
    self.init(config: SwiftMessages.Config())
}
```

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

### containerView property declaration

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessagesSegue.md

Declares the containerView property as a CornerRoundingView instance. The destination view is installed here first, providing configurable squircle corners.

```swift
public var containerView: CornerRoundingView = CornerRoundingView()
```

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

### override public init(frame: CGRect)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/KeyboardTrackingView.md

Initializes the view with a specified frame, disables autoresizing, adds a zero-height anchor constraint, registers keyboard/application notification observers, and clears the background.

```APIDOC
## init(frame:)

### Description
Initializes the view with a specified frame, disables autoresizing, adds a zero-height anchor constraint, registers keyboard/application notification observers, and clears the background.

### Method
init

### Parameters
- **frame** (CGRect) - Required - View frame.

### Code
```swift
override public init(frame: CGRect) {
    super.init(frame: frame)
    postInit()
}
```
```

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

### Override perform method

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessagesSegue.md

Starts the presentation and retains the segue until dismissal. The self-retention is released if the presenting view controller leaves the hierarchy without dismissal.

```swift
override open func perform() {
    (source as? WindowViewController)?.install()
    selfRetainer = self
    startReleaseMonitor()
    if overrideModalPresentationStyle {
        destination.modalPresentationStyle = .custom
    }
    destination.transitioningDelegate = self
    source.present(destination, animated: true, completion: nil)
}
```

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

### BackgroundViewable protocol

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/types.md

Protocol for views that provide a background view. The pan-to-hide gesture and pan handler are installed in backgroundView; touches outside it are ignored (MessageView.point(inside:)).

```swift
public protocol BackgroundViewable {
    var backgroundView: UIView! { get }
}
```

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

### Configure theme with Theme, IconStyle, and haptic

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Declares the configureTheme method that applies a predefined theme with optional icon style and haptic feedback. When includeHaptic is true, it sets defaultHaptic based on the theme: .info/.success to success, .warning to warning, .error to error.

```swift
public func configureTheme(_ theme: Theme, iconStyle: IconStyle = .default, includeHaptic: Bool = false)
```

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

### configureContent(title:body:iconImage:iconText:buttonImage:buttonTitle:buttonTapHandler:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Full content configuration including optional button and icon.

```APIDOC
## configureContent(title:body:iconImage:iconText:buttonImage:buttonTitle:buttonTapHandler:)

### Description
Sets all outlets: title, body, image/text icon, button image/title (`.normal` state), and `buttonTapHandler`. Hidden states are recomputed from the presence of image/text.

### Signature
`public func configureContent(title: String?, body: String?, iconImage: UIImage?, iconText: String?, buttonImage: UIImage?, buttonTitle: String?, buttonTapHandler: ((_ button: UIButton) -> Void)?)`

### Parameters
- **title** (String?) - Optional - The text to set on the title label.
- **body** (String?) - Optional - The text to set on the body label.
- **iconImage** (UIImage?) - Optional - The image to display in the icon image view.
- **iconText** (String?) - Optional - The text to display in the icon label.
- **buttonImage** (UIImage?) - Optional - The image to display on the button in `.normal` state.
- **buttonTitle** (String?) - Optional - The title to display on the button in `.normal` state.
- **buttonTapHandler** ((_ button: UIButton) -> Void)? - Optional - Closure to handle button tap events.

### Behavior
Sets all outlets: title, body, image/text icon, button image/title (`.normal` state), and `buttonTapHandler`. Hidden states are recomputed from the presence of image/text.

### Example
```swift
view.configureContent(
    title: "Download",
    body: "Your file is ready.",
    iconImage: Icon.success.image,
    iconText: nil,
    buttonImage: nil,
    buttonTitle: "OK",
    buttonTapHandler: { _ in SwiftMessages.hide() }
)
```
```

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

### didMoveToSuperview()

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Override hook that is called when the view is added to a superview. It computes a MessageGeometryProxy from the superview's bounds and safe-area insets, creates a UIHostingController with the content, and installs its view.

```APIDOC
## `public override func didMoveToSuperview()`

### Description
Override hook that is called when the view is added to a superview. It computes a MessageGeometryProxy from the superview's bounds and safe-area insets, creates a UIHostingController with the content, and installs its view.

### Method
`didMoveToSuperview()`

### Parameters
None.

### Behavior
- If the superview is `nil`, the method returns early.
- Computes the size and safe-area insets from the superview, adjusting for layout direction.
- Creates a `MessageGeometryProxy` with the adjusted size and insets.
- Creates a `UIHostingController` with `content(proxy)` and loads its view.
- Installs the hosting controller's view as a subview, pinned to all edges, and sets its background to clear.
```

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

### AccessibleMessage protocol

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/types.md

Protocol for improved VoiceOver support. Implemented by MessageView; presented views conforming to it get announcement (UIAccessibility.Notification.announcement) on show, or layoutChanged focus for modal dims.

```swift
public protocol AccessibleMessage {
    var accessibilityMessage: String? { get }
    var accessibilityElement: NSObject? { get }
    var additionalAccessibilityElements: [NSObject]? { get }
}
```

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

### MessageHostingView init(id:content:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Initializer that takes an explicit id and a SwiftUI content view. Sets the background to clear.

```swift
public init(id: String, content: Content) {
    self.id = id
    self.content = { _ in content }
    super.init(frame: .zero)
    backgroundColor = .clear
}
```

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

### convenience public init<Message>(message:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Convenience initializer that creates a MessageHostingView from a MessageViewConvertible model. The view is produced by calling asMessageView() on the message.

```APIDOC
## convenience public init<Message>(message:)

### Description
Convenience initializer that creates a MessageHostingView from a MessageViewConvertible model. The view is produced by calling asMessageView() on the message.

### Method
Initializer

### Signature
```swift
convenience public init<Message>(message: Message) where Message: MessageViewConvertible, Message.Content == Content
```

### Parameters
- **message** (Message) - Required - Data model; the view is produced by `message.asMessageView()`.

### Example
```swift
let view = MessageHostingView(message: message)   // Content inferred as DemoMessageView
```
```

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

### PhysicsPanHandler init()

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsPanHandler.md

No-argument initializer for PhysicsPanHandler.

```swift
public init() {}
```

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

### Configure PhysicsPanHandler with AnimationContext and Animator

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsPanHandler.md

Installs a pan gesture recognizer on the message view (or its background view if BackgroundViewable) and stores the container view and animator. Used by PhysicsAnimation.installInteractive when context.interactiveHide is true.

```swift
public func configure(context: AnimationContext, animator: Animator) {
    if let oldView = (messageView as? BackgroundViewable)?.backgroundView ?? messageView {
        oldView.removeGestureRecognizer(pan)
    }
    messageView = context.messageView
    let view = (messageView as? BackgroundViewable)?.backgroundView ?? messageView
    view?.addGestureRecognizer(pan)
    containerView = context.containerView
    self.animator = animator
}
```

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

### MessageHostingView convenience init(message:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Convenience initializer for messages conforming to MessageViewConvertible. The view is produced by message.asMessageView().

```swift
convenience public init<Message>(message: Message) where Message: MessageViewConvertible, Message.Content == Content {
    self.init(id: message.id, content: message.asMessageView() )
}
```

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

### Configure Layout Shortcut

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/ViewControllers.md

Use the configure(layout:) method as a shortcut for basic layout and animation options.

```swift
// Configure a bottom card-style presentation
segue.configure(layout: .bottomCard)
```

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

### init(style:delegate:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Initializes a TopBottomAnimation with a style and an AnimationDelegate, which can be a SwiftMessages instance or custom delegate.

```swift
init(style: TopBottomAnimationStyle, delegate: AnimationDelegate) {
    self.style = style
    self.delegate = delegate
}
```

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

### Presenter.PresentationContext using Weak

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/Weak.md

Example from Presenter.swift showing an enum that stores weak references to a UIViewController or UIView, and methods to retrieve them. `viewControllerValue()` returns the held controller or nil, while `viewValue()` unwraps through `weak.value?.view`.

```swift
// Presenter.swift:141-153
@MainActor
enum PresentationContext {
    case viewController(_: Weak<UIViewController>)
    case view(_: Weak<UIView>)

    func viewControllerValue() -> UIViewController? {
        switch self {
        case .viewController(let weak):
            return weak.value
        case .view:
            return nil
        }
    }

    func viewValue() -> UIView? {
        switch self {
        case .viewController(let weak):
            return weak.value?.view
        case .view(let weak):
            return weak.value
        }
    }
}
```

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

### show(config:viewProvider:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Displays a view provided by a closure, guaranteed to be called on the main queue. Use this overload when the message may be added from a background queue.

```APIDOC
## show(config:viewProvider:)

### Description
Displays a view provided by a closure, guaranteed to be called on the main queue. Use this overload when the message may be added from a background queue; UIKit interactions inside the viewProvider are safe.

### Method
show

### Signature
`nonisolated open func show(config: Config, viewProvider: @escaping ViewProvider)`

### Parameters
- **config** (SwiftMessages.Config) - Required - Display options for this message.
- **viewProvider** (@escaping ViewProvider) - Required - Block () -> UIView; guaranteed to be called on the main queue.

### Return Value
Void

### Notes
The provider is invoked inside a Task on @MainActor; if self has been collected the block is skipped.
```

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

### TopBottomAnimation class declaration

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/TopBottomAnimation.md

Declares the TopBottomAnimation class as a public, @MainActor NSObject conforming to the Animator protocol. Use this as the starting point for implementing the sliding animation behavior for top and bottom presentation styles.

```swift
@MainActor
public class TopBottomAnimation: NSObject, Animator {
```

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

### PhysicsAnimation.init(delegate:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsAnimation.md

Initializer that accepts an AnimationDelegate to receive animation events.

```APIDOC
## PhysicsAnimation.init(delegate:)

### Description
Initializer that accepts an AnimationDelegate to receive animation events.

### Method
init

### Signature
```swift
init(delegate: AnimationDelegate) {
    self.delegate = delegate
}
```

### Parameters
- **delegate** (`AnimationDelegate`) - Required - The animation delegate.

### Return Value
A new PhysicsAnimation instance with the specified delegate.

### Example
```swift
let animation = PhysicsAnimation(delegate: myDelegate)
```
```

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

### init(config:) for WindowViewController

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/WindowViewController.md

Initializes the window controller with a given SwiftMessages.Config. Sets up a PassthroughView and PassthroughWindow, applies windowLevel (defaults to UIWindow.Level.normal) and overrideUserInterfaceStyle (iOS 13+).

```swift
public init(config: SwiftMessages.Config) {
    self.config = config
    let view = PassthroughView()
    let window = PassthroughWindow(hitTestView: view)
    self.window = window
    super.init(nibName: nil, bundle: nil)
    self.view = view
    window.rootViewController = self
    window.windowLevel = config.windowLevel ?? UIWindow.Level.normal
    window.overrideUserInterfaceStyle = config.overrideUserInterfaceStyle
}
```

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

### show(config:view:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Enqueues a presenter to display the given view with the specified configuration. Only one message is displayed at a time; duplicates are dropped if Config.ignoreDuplicates is true and the view conforms to Identifiable.

```APIDOC
## show(config:view:)

### Description
Enqueues a presenter to display the given view with the specified configuration. Only one message is displayed at a time; duplicates are dropped if Config.ignoreDuplicates is true and the view conforms to Identifiable.

### Method
show

### Signature
`open func show(config: Config, view: UIView)`

### Parameters
- **config** (SwiftMessages.Config) - Required - Display options for this message.
- **view** (UIView) - Required - View to display (any UIView instance).

### Return Value
Void

### Errors
Throws nothing directly; a Presenter constructed with a .automatic presentation context and no key-window root view controller causes an asynchronous SwiftMessagesError.noRootViewController.
```

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

### currentOrQueued<T>(id:) -> T? — SwiftMessages.swift:738

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/SwiftMessages.md

Returns the view if it is currently shown, hidden, or queued. The id parameter is required and must match an Identifiable message. The second block shows a usage example that retrieves a MessageView by id and updates its content. Defined in SwiftMessages.swift:738.

```swift
public func currentOrQueued<T: UIView>(id: String) -> T? {
    return current(id: id) ?? queued(id: id)
}
```

```swift
if let view = SwiftMessages.currentOrQueued(id: "order-42") as? MessageView {
    view.configureContent(body: "Status updated")
}
```

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

### KeyboardTrackingView lifecycle methods (init, awakeFromNib, layoutSubviews)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/KeyboardTrackingView.md

Lifecycle methods for KeyboardTrackingView. The frame initializer calls postInit() which disables autoresizing, adds a zero-height anchor constraint, registers keyboard/application notification observers, and clears the background. The coder initializer does not call postInit(); instead awakeFromNib() does. layoutSubviews() updates the height constraint based on calculateHeightConstant().

```swift
override public init(frame: CGRect) {
    super.init(frame: frame)
    postInit()
}
```

```swift
required public init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
}
```

```swift
open override func awakeFromNib() {
    super.awakeFromNib()
    postInit()
}
```

```swift
open override func layoutSubviews() {
    super.layoutSubviews()
    heightConstraint.constant = calculateHeightConstant()
}
```

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

### Configure SwiftMessages.Config with custom options

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/configuration.md

Use this snippet to create a custom configuration by starting from the shared defaults and overriding individual options. It sets presentation style, context, duration, dim mode, haptics, and more, then shows the message with SwiftMessages.show(config:view:). Note that prefersStatusBarHidden is needed for iOS 13+ because windows can't cover the status bar.

```swift
var config = SwiftMessages.defaultConfig          // start from the shared defaults
config.presentationStyle = .bottom
config.presentationContext = .window(windowLevel: .statusBar)
config.prefersStatusBarHidden = true              // iOS 13+: windows can't cover the status bar
config.duration = .forever
config.dimMode = .gray(interactive: true)
config.interactiveHide = false
config.haptic = .success
config.preferredStatusBarStyle = .lightContent
config.keyboardTrackingView = KeyboardTrackingView()
config.eventListeners.append() { event in
    if case .didHide = event { print("hidden \(event.id)") }
}
SwiftMessages.show(config: config, view: view)
```

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

### Configure Segue in prepare(for:sender:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/ViewControllers.md

Apply configurations directly within the presenting view controller by down-casting the segue.

```swift
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
    if let segue = segue as? SwiftMessagesSegue {
        segue.configure(layout: .bottomCard)
        segue.dimMode = .blur(style: .dark, alpha: 0.9, interactive: true)
        segue.messageView.configureNoDropShadow()
    }
}
```

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

### configureContent(title:body:iconImage:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Sets title, body, and shows an icon image while hiding the icon label.

```APIDOC
## configureContent(title:body:iconImage:)

### Description
Sets the title and body text, shows the icon image view, and hides the icon label.

### Signature
`public func configureContent(title: String, body: String, iconImage: UIImage)`

### Parameters
- **title** (String) - Required - The text to set on the title label.
- **body** (String) - Required - The text to set on the body label.
- **iconImage** (UIImage) - Required - The image to display in the icon image view.

### Behavior
Sets title/body, shows `iconImageView`, hides `iconLabel`.
```

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

### PhysicsPanHandler.configure(context:animator:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/PhysicsPanHandler.md

Documentation for the `configure(context:animator:)` method of `PhysicsPanHandler`, which sets up the pan gesture recognizer for interactive dismissal.

```APIDOC
## `public func configure(context: AnimationContext, animator: Animator)`

### Description
Configures the pan handler with the given animation context and animator. It installs a pan gesture recognizer on the message view (or its background view if it conforms to `BackgroundViewable`) and stores the container view and animator for later use.

### Method
`configure(context:animator:)`

### Parameters
- **context** (`AnimationContext`) - Required - Supplies `messageView` and `containerView`; the pan recognizer is installed on `backgroundView` when the view is `BackgroundViewable`, else on the view.
- **animator** (`Animator`) - Required - Owner animator whose delegate receives `panStarted`/`panEnded`/`hide`.

### Usage
```swift
let panHandler = PhysicsPanHandler()
panHandler.hideDelay = 0.1
// ... in myAnimator.show: panHandler.configure(context: context, animator: self)
```

### Notes
- Also used by `PhysicsAnimation.installInteractive` when `context.interactiveHide` is `true`.
- No throws are defined; guarded by `guard let messageView, let containerView, let animator else { return }`.
```

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

### configureContent(body:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageView.md

Sets the body label text.

```APIDOC
## configureContent(body:)

### Description
Sets the body label text.

### Signature
`public func configureContent(body: String)`

### Parameters
- **body** (String) - Required - The text to set on the body label.

### Behavior
Sets `bodyLabel.text` to the provided string.
```

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

### Configure and show a MessageView with card layout

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/README.md

Creates a MessageView from the cardView nib, configures its theme, drop shadow, content, layout margins, corner radius, and shows it. The comment notes that SwiftMessages searches for nib files in the main bundle first, allowing customization.

```swift
// Instantiate a message view from the provided card view layout. SwiftMessages searches for nib
// files in the main bundle first, so you can easily copy them into your project and make changes.
let view = MessageView.viewFromNib(layout: .cardView)

// Theme message elements with the warning style.
view.configureTheme(.warning)

// Add a drop shadow.
view.configureDropShadow()

// Set message title, body, and icon. Here, we're overriding the default warning
// image with an emoji character.
let iconText = ["🤔", "😳", "🙄", "😶"].randomElement()!
view.configureContent(title: "Warning", body: "Consider yourself warned.", iconText: iconText)

// Increase the external margin around the card. In general, the effect of this setting
// depends on how the given layout is constrained to the layout margins.
view.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20)

// Reduce the corner radius (applicable to layouts featuring rounded corners).
(view.backgroundView as? CornerRoundingView)?.cornerRadius = 10

// Show the message.
SwiftMessages.show(view: view)
```

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

### public init<Message>(message:content:)

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/_autodocs/api-reference/MessageHostingView.md

Initializes a MessageHostingView from an Identifiable message and a view builder that receives the message and a geometry proxy. The message's id is used as the view's id.

```APIDOC
## public init<Message>(message:content:)

### Description
Initializes a MessageHostingView from an Identifiable message and a view builder that receives the message and a geometry proxy. The message's id is used as the view's id.

### Method
Initializer

### Signature
```swift
public init<Message>(
    message: Message,
    @ViewBuilder content: @escaping (Message, MessageGeometryProxy) -> Content
) where Message: Identifiable
```

### Parameters
- **message** (Message) - Required - Data model; `message.id` becomes the message id.
- **content** (@escaping (Message, MessageGeometryProxy) -> Content) - Required - View builder receiving the message and a `MessageGeometryProxy` with the container geometry (a workaround for `GeometryReader` not working inside the builder).

### Example
```swift
let view = MessageHostingView(message: message) { message, geometry in
    MyMessageView(message: message, maxWidth: geometry.size.width)
}
```
```

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

### Presenting with WindowViewController

Source: https://github.com/swiftkickmobile/swiftmessages/blob/master/ViewControllers.md

Use WindowViewController as a source to present a controller independently of the current view hierarchy, with optional custom SwiftMessages.Config.

```swift
let destinationVC = ... // make a reference to a destination view controller
var config = SwiftMessages.defaultConfig
config.presentationContext = .windowScene(...) // specify the window properties
let sourceVC = WindowViewController(config: config)
let segue = SwiftMessagesSegue(identifier: nil, source: self, destination: destinationVC)
segue.perform()
```
Tokens:
Raw