appkit-swiftui-bridge

Use NSViewRepresentable to wrap AppKit views such as NSTextField, NSTableView, or custom views so they can be embedded in SwiftUI view hierarchies. The protocol handles view creation and updates between the frameworks.

Use NSHostingView or NSHostingController to host SwiftUI content within AppKit windows and view hierarchies. NSHostingController works well for view-controller-based structures, while NSHostingView fits direct view embedding.

Bridge state using Combine publishers or the @Observable macro so changes propagate between AppKit and SwiftUI layers. A shared observable model object keeps both frameworks synchronized.

Use NSHostingView when embedding SwiftUI directly into an existing AppKit view hierarchy, and NSHostingController when you need view controller lifecycle integration such as in window or split view controllers.

Bridging adds complexity around state synchronization, responder chain behavior, and lifecycle mismatches between the frameworks. It is best suited for incremental migration rather than deeply interleaved view trees.