Update AppKit Components & Examples #784

Mx-Iris · 2026-02-08T13:21:42Z

No description provided.

Copilot

Pull request overview

Updates the AppKit hosting integration to better participate in Auto Layout sizing, window lifecycle coordination, and example app setup.

Changes:

Added sizing/intrinsic-content-size logic and window/content-size constraint management to NSHostingView.
Extended NSHostingController to expose sceneBridgingOptions, participate in sizing via preferredContentSize, and set its view during common init.
Updated AppKit app delegate + hosting example to construct windows via NSWindow(contentViewController:) and keep strong references to window controllers.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift	Adds constraint/sizing behaviors, window notifications, and environment/container updates.
Sources/OpenSwiftUI/Integration/Hosting/AppKit/Controller/NSHostingController.swift	Wires hosting view as controller’s view and exposes additional sizing/scene-bridging APIs.
Sources/OpenSwiftUI/App/App/AppKit/AppKitAppDelegate.swift	Updates window creation to use `contentViewController` and retains the window controller.
Example/HostingExample/ViewController.swift	Switches macOS example to a window-controller-based setup using `NSHostingController`.
Example/HostingExample/AppDelegate.swift	Removes now-duplicated window controller and relies on the new macOS setup.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

Copilot · 2026-02-08T13:25:33Z

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

+            center.addObserver(self, selector: #selector(windowDidChangeMain), name: NSWindow.didBecomeMainNotification, object: newWindow)
+            center.addObserver(self, selector: #selector(windowDidChangeMain), name: NSWindow.didResignMainNotification, object: newWindow)
+            center.addObserver(self, selector: #selector(windowDidChangeKey), name: NSWindow.didBecomeKeyNotification, object: newWindow)
+            center.addObserver(self, selector: #selector(windowDidChangeKey), name: NSWindow.didResignKeyNotification, object: newWindow)
+            // TODO: NSWindowDidOrderOnScreenNotification / NSWindowDidOrderOffScreenNotification → windowDidChangeVisibility
+            center.addObserver(self, selector: #selector(windowWillBeginSheet), name: NSWindow.willBeginSheetNotification, object: newWindow)
+            center.addObserver(self, selector: #selector(windowDidEndSheet), name: NSWindow.didEndSheetNotification, object: newWindow)
+            center.addObserver(self, selector: #selector(windowDidChangeScreen), name: NSWindow.didChangeScreenNotification, object: newWindow)


The observers added in viewWillMove(toWindow:) use #selector(windowDidChangeMain)/etc, but the corresponding handler methods should be #selector(windowDidChangeMain(_:)) (and so on) to match NotificationCenter’s required method signature. Update both the selector and method signatures consistently.

Suggested change

center.addObserver(self, selector: #selector(windowDidChangeMain), name: NSWindow.didBecomeMainNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeMain), name: NSWindow.didResignMainNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeKey), name: NSWindow.didBecomeKeyNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeKey), name: NSWindow.didResignKeyNotification, object: newWindow)

// TODO: NSWindowDidOrderOnScreenNotification / NSWindowDidOrderOffScreenNotification → windowDidChangeVisibility

center.addObserver(self, selector: #selector(windowWillBeginSheet), name: NSWindow.willBeginSheetNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidEndSheet), name: NSWindow.didEndSheetNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeScreen), name: NSWindow.didChangeScreenNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeMain(_:)), name: NSWindow.didBecomeMainNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeMain(_:)), name: NSWindow.didResignMainNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeKey(_:)), name: NSWindow.didBecomeKeyNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeKey(_:)), name: NSWindow.didResignKeyNotification, object: newWindow)

// TODO: NSWindowDidOrderOnScreenNotification / NSWindowDidOrderOffScreenNotification → windowDidChangeVisibility

center.addObserver(self, selector: #selector(windowWillBeginSheet(_:)), name: NSWindow.willBeginSheetNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidEndSheet(_:)), name: NSWindow.didEndSheetNotification, object: newWindow)

center.addObserver(self, selector: #selector(windowDidChangeScreen(_:)), name: NSWindow.didChangeScreenNotification, object: newWindow)

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

augmentcode · 2026-02-08T13:25:46Z

🤖 Augment PR Summary

Summary: This PR updates the AppKit hosting components and the macOS hosting example to better align window/controller setup and begin fleshing out sizing/window-bridging behavior.

Changes:

Refactors the macOS example to use an NSWindowController that directly creates an NSWindow with an NSHostingController as its contentViewController.
Updates AppKitAppDelegate to create the window via NSWindow(contentViewController:) and retain the window controller instance.
Moves NSHostingController view setup into a shared initializer path and adds API surface for sceneBridgingOptions, preferredContentSize derivation, and identifier propagation.
Significantly extends NSHostingView with intrinsic-size caching, constraint update handling, window notification wiring, container/environment update hooks, and window content min/max size synchronization.

Technical Notes: The new AppKit hosting behavior introduces more Auto Layout integration and window-awareness (constraints + content size extrema), and begins scaffolding “scene/window bridging” options for future toolbar/title integration.

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 4 suggestions posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-02-08T13:25:47Z

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

+        guard sizingOptions.contains(.intrinsicContentSize),
+              !checkForReentrantLayout()
+        else {
+            return cachedIntrinsicContentSize


intrinsicContentSize returns cachedIntrinsicContentSize when .intrinsicContentSize isn’t in sizingOptions; if sizingOptions is toggled from enabled → disabled, the cached value could keep advertising an intrinsic size unexpectedly. Consider ensuring the “disabled” path reports no intrinsic metric (or clears the cache) so sizingOptions = [] truly opts out.

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-02-08T13:25:47Z

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

+        }
+
+        if let newWindow {
+            center.addObserver(self, selector: #selector(windowDidChangeMain), name: NSWindow.didBecomeMainNotification, object: newWindow)


The view registers for multiple NSWindow notifications via NotificationCenter in viewWillMove(toWindow:); if the view is deallocated without a final move to nil, those observers can still fire and message a freed object. Consider also removing observers in deinit as a safety net.

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-02-08T13:25:47Z

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift

-        }

        // TODO: screen.displayID
        let displayID = CGMainDisplayID()


startAsyncRendering() always creates the display link using CGMainDisplayID() without checking window?.screen, which can schedule rendering even when the view isn’t in a window (and can target the wrong display’s refresh characteristics). It seems safer to gate display-link creation on having an attached window/screen (or otherwise deliberately document why main display is correct).

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-02-08T13:25:47Z

Sources/OpenSwiftUI/Integration/Hosting/AppKit/Controller/NSHostingController.swift

+    /// window, the default value for this property will be `.all`, which
+    /// includes the options for `.toolbars` and `.title`. Otherwise, the
+    /// default value is `[]`.
+    public var sceneBridgingOptions: NSHostingSceneBridgingOptions {


The docs for sceneBridgingOptions say the default becomes .all when used as a window’s contentViewController, but the current implementation only forwards to host.sceneBridgingOptions (which defaults to []). This looks like a docs/behavior mismatch that could confuse callers relying on the documented default.

Severity: low

Other Locations

Sources/OpenSwiftUI/Integration/Hosting/AppKit/View/NSHostingView.swift:102

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

codecov · 2026-02-08T13:44:31Z

Codecov Report

❌ Patch coverage is 54.92063% with 142 lines in your changes missing coverage. Please review.
✅ Project coverage is 26.57%. Comparing base (1ff649d) to head (c3e21c9).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...ntegration/Hosting/AppKit/View/NSHostingView.swift	56.37%	130 Missing ⚠️
...osting/AppKit/Controller/NSHostingController.swift	35.71%	9 Missing ⚠️
...OpenSwiftUI/App/App/AppKit/AppKitAppDelegate.swift	0.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #784      +/-   ##
==========================================
+ Coverage   26.19%   26.57%   +0.37%     
==========================================
  Files         650      650              
  Lines       40232    40529     +297     
==========================================
+ Hits        10539    10769     +230     
- Misses      29693    29760      +67

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copilot AI review requested due to automatic review settings February 8, 2026 13:21

Mx-Iris requested a review from Kyle-Ye as a code owner February 8, 2026 13:21

Copilot started reviewing on behalf of Mx-Iris February 8, 2026 13:22 View session

github-actions bot added enhancement New feature or request platform: macOS labels Feb 8, 2026

Copilot AI reviewed Feb 8, 2026

View reviewed changes

augmentcode bot reviewed Feb 8, 2026

View reviewed changes

Mx-Iris and others added 2 commits February 8, 2026 22:14

Update AppKit Components & Examples

2eff868

Update documentation

c3e21c9

Kyle-Ye force-pushed the bugfix/ns_hosting_controller branch from fd8e792 to c3e21c9 Compare February 8, 2026 14:15

github-actions bot added the documentation Improvements or additions to documentation label Feb 8, 2026

Kyle-Ye merged commit 9916291 into main Feb 8, 2026
7 of 8 checks passed

Kyle-Ye deleted the bugfix/ns_hosting_controller branch February 8, 2026 14:16

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update AppKit Components & Examples #784

Update AppKit Components & Examples #784

Uh oh!

Mx-Iris commented Feb 8, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

augmentcode bot commented Feb 8, 2026

Uh oh!

augmentcode bot left a comment

Uh oh!

augmentcode bot Feb 8, 2026

Uh oh!

augmentcode bot Feb 8, 2026

Uh oh!

augmentcode bot Feb 8, 2026

Uh oh!

augmentcode bot Feb 8, 2026

Uh oh!

codecov bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Update AppKit Components & Examples #784

Update AppKit Components & Examples #784

Uh oh!

Conversation

Mx-Iris commented Feb 8, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

augmentcode bot commented Feb 8, 2026

Uh oh!

augmentcode bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

codecov bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

codecov bot commented Feb 8, 2026 •

edited

Loading