@swiftbrowser/native 0.26.2 → 0.26.4

package/README.md

@@ -37,10 +37,10 @@ build against the exact version of the renderer this JavaScript was written
 for. `swiftbrowser native init` lays a project out that way:
 
 ```sh
-npx @swiftbrowser/cli native init MyApp   # MyApp.xcodeproj, ios/, src/, web/
+npx @swiftbrowser/cli native init MyApp   # MyApp.xcodeproj (iOS and macOS), apple/, src/, web/
 cd MyApp && npm install                   # React, @swiftbrowser/react, @swiftbrowser/web and this package
-npm run build                             # ios/app.js, the bundle the app ships
-open MyApp.xcodeproj                      # run it on a simulator
+npm run build                             # apple/app.js, the bundle the app ships
+open MyApp.xcodeproj                      # run it on a simulator, an iPhone or this Mac
 npm run dev:web                           # the same app as a web page
 ```
 
@@ -76,8 +76,8 @@ run(<App />);
 ```
 
 ```sh
-npx swiftbrowser-native build src/index.tsx --out ../ios/app.js     # the bundle Xcode ships
-npx swiftbrowser-native dev src/index.tsx --out ../ios/app.js       # http://localhost:5173/, Fast Refresh on save
+npx swiftbrowser-native build src/index.tsx --out ../apple/app.js   # the bundle Xcode ships
+npx swiftbrowser-native dev src/index.tsx --out ../apple/app.js     # http://localhost:5173/, Fast Refresh on save
 ```
 
 On the Swift side, `NativeApp().load()` runs the bundled `app.js` and
@@ -152,7 +152,7 @@ the app's scene phase here (`active`, `inactive`, `background`), as
 ## Workers
 
 ```sh
-npx swiftbrowser-native build src/index.tsx --out ../ios/app.js --worker render=src/render.worker.ts
+npx swiftbrowser-native build src/index.tsx --out ../apple/app.js --worker render=src/render.worker.ts
 ```
 
 ```ts
@@ -410,7 +410,7 @@ and a page can register its own element under the same name
 also from @swiftbrowser/react), so the same element draws on both.
 
 Swift that is not a view registers as a function, before the bundle loads
-(`swiftbrowser native init` writes an `ios/NativeFunctions.swift` for them):
+(`swiftbrowser native init` writes an `apple/NativeFunctions.swift` for them):
 
 ```swift
 NativeFunctions.register("purchase") { call in            // async

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftbrowser/native",
-  "version": "0.26.2",
+  "version": "0.26.4",
   "type": "module",
   "description": "Run a @swiftbrowser/react app natively: the runtime a JavaScriptCore-hosted app needs (timers, console, fetch and the other web globals over the SwiftBrowser Native bridge), the `run` entry that renders into the native SwiftUI renderer, and the bundler that builds app.js for the Xcode target.",
   "repository": {
@@ -63,8 +63,8 @@
   },
   "dependencies": {
     "@babel/core": "^7.29.7",
-    "@swiftbrowser/react": "0.26.2",
-    "@swiftbrowser/web": "0.26.2",
+    "@swiftbrowser/react": "0.26.4",
+    "@swiftbrowser/web": "0.26.4",
     "esbuild": "^0.28.2",
     "react-refresh": "^0.17.0"
   },

package/swift/Sources/SwiftBrowserNative/Runtime/NativeApp.swift

@@ -37,6 +37,8 @@ public final class NativeApp {
     public private(set) var colorScheme: String?
     public private(set) var dynamicTypeSize: String?
     public private(set) var horizontalSizeClass: String?
+    /// The platform the app runs on, `ios` or `macos` (docs/notes/macos.md), once the root view has said.
+    public private(set) var platform: String?
     /// URLs the app was opened with before its script could take them (a
     /// universal link that launched it): delivered once it loads.
     private var pendingURLs: [URL] = []
@@ -312,17 +314,18 @@ public final class NativeApp {
     }
 
     /// Tells the app the device environment; sent once at load and on change.
-    public func setEnvironment(colorScheme: String? = nil, dynamicTypeSize: String? = nil, horizontalSizeClass: String? = nil) {
+    public func setEnvironment(colorScheme: String? = nil, dynamicTypeSize: String? = nil, horizontalSizeClass: String? = nil, platform: String? = nil) {
         var changed = false
         if let colorScheme, colorScheme != self.colorScheme { self.colorScheme = colorScheme; changed = true }
         if let dynamicTypeSize, dynamicTypeSize != self.dynamicTypeSize { self.dynamicTypeSize = dynamicTypeSize; changed = true }
         if let horizontalSizeClass, horizontalSizeClass != self.horizontalSizeClass { self.horizontalSizeClass = horizontalSizeClass; changed = true }
+        if let platform, platform != self.platform { self.platform = platform; changed = true }
         if changed { sendEnvironment() }
     }
 
     private func sendEnvironment() {
-        guard isLoaded, colorScheme != nil || dynamicTypeSize != nil || horizontalSizeClass != nil else { return }
-        dispatch(.environment(colorScheme: colorScheme, dynamicTypeSize: dynamicTypeSize, horizontalSizeClass: horizontalSizeClass))
+        guard isLoaded, colorScheme != nil || dynamicTypeSize != nil || horizontalSizeClass != nil || platform != nil else { return }
+        dispatch(.environment(colorScheme: colorScheme, dynamicTypeSize: dynamicTypeSize, horizontalSizeClass: horizontalSizeClass, platform: platform))
     }
 
     /// The scene moved between the foreground, inactive and the background.

package/swift/Sources/SwiftBrowserNative/Views/Kinds/KeyboardBar.swift

@@ -81,4 +81,23 @@ private struct CapsuleGlass: ViewModifier {
     }
 }
 #endif
+
+/// `.navigationSubtitle` (macOS 11, iOS 26): the screen's `subtitle`, under
+/// the title in a Mac's title bar. The iOS build's SDK floor is older than
+/// the modifier, so only a Mac (and the shim's round trip) draws it.
+struct NavigationSubtitle: ViewModifier {
+    let subtitle: String?
+
+    func body(content: Content) -> some View {
+        #if os(macOS) || canImport(FoundationBridge)
+        if let subtitle, !subtitle.isEmpty {
+            content.navigationSubtitle(subtitle)
+        } else {
+            content
+        }
+        #else
+        content
+        #endif
+    }
+}
 #endif

package/swift/Sources/SwiftBrowserNative/Views/Kinds/Lists.swift

@@ -15,6 +15,9 @@ struct ListElement: View {
         let props = ListProps(props: node.props)
         let list = selectionList(props)
         let styled: AnyView = {
+            // A `Form` (the shim's and React's mark their list `form`): the
+            // system's form, which on a Mac is the columns style.
+            if props.form { return AnyView(Form { ListRowsView(children: node.children) }) }
             switch props.style {
             case "plain": return AnyView(list.listStyle(.plain))
             case "sidebar": return AnyView(list.listStyle(.sidebar))

package/swift/Sources/SwiftBrowserNative/Views/Kinds/Navigation.swift

@@ -145,6 +145,7 @@ struct NavigationScreenElement: View {
         let titled = content
             .modifier(KeyboardBarInset(toolbars: keyboardToolbars))
             .navigationTitle(props.title)
+            .modifier(NavigationSubtitle(subtitle: props.subtitle))
             .toolbar { ScreenToolbar(toolbars: shown) }
             .onAppear {
                 // A pushed screen, appearing: its bar as it is now, until the push has settled.

package/swift/Sources/SwiftBrowserNative/Views/NativeRootView.swift

@@ -84,9 +84,19 @@ public struct NativeRootView: View {
         app.setEnvironment(
             colorScheme: colorScheme == .dark ? "dark" : "light",
             dynamicTypeSize: dynamicTypeSize.protocolName,
-            horizontalSizeClass: sizeClassName
+            horizontalSizeClass: sizeClassName,
+            platform: Self.platformName
         )
     }
+
+    /// The platform the app is drawn on (docs/notes/macos.md): the OS, as the protocol names it.
+    static var platformName: String {
+        #if os(macOS)
+        "macos"
+        #else
+        "ios"
+        #endif
+    }
 }
 
 /// Presents the first of `presented` over `content` (a sheet, a full-screen

package/swift/Sources/SwiftBrowserProtocol/Props.swift

@@ -175,11 +175,14 @@ public struct ListProps: Equatable, Sendable {
     public var editing: Bool?
     /// `List(selection:)` over a `Set`: several rows may be selected.
     public var multiSelect: Bool
+    /// A `Form`: drawn as one (on a Mac, the columns style).
+    public var form: Bool
     public init(props: JSONObject) {
         style = props.string("style") ?? "insetGrouped"
         refreshable = props.bool("refreshable") ?? false
         editing = props.bool("editing")
         multiSelect = props.bool("multiSelect") ?? false
+        form = props.bool("form") ?? false
     }
 }
 
@@ -294,6 +297,8 @@ public struct ToggleProps: Equatable, Sendable {
 
 public struct NavScreenProps: Equatable, Sendable {
     public var title: String
+    /// `.navigationSubtitle`: under the title in a Mac's title bar.
+    public var subtitle: String?
     /// `automatic`, `large` or `inline`.
     public var displayMode: String
     /// 0 for the stack's root screen.
@@ -306,6 +311,7 @@ public struct NavScreenProps: Equatable, Sendable {
     public var statusBarHidden: Bool
     public init(props: JSONObject) {
         title = props.string("title") ?? ""
+        subtitle = props.string("subtitle")
         displayMode = props.string("displayMode") ?? "automatic"
         depth = props.int("depth") ?? 0
         toolbarRole = props.string("toolbarRole")

package/swift/Sources/SwiftBrowserProtocol/RendererEvent.swift

@@ -163,18 +163,21 @@ public struct RendererEvent: Equatable, Sendable {
         with("registered", id: id, ["name": .string(name), "value": value])
     }
 
-    /// The device appearance, text size or size class (sent once at launch and on change).
+    /// The device appearance, text size, size class or platform (`ios` or
+    /// `macos`, docs/notes/macos.md; sent once at launch and on change).
     public static func environment(
         colorScheme: String? = nil,
         dynamicTypeSize: String? = nil,
         horizontalSizeClass: String? = nil,
-        scenePhase: String? = nil
+        scenePhase: String? = nil,
+        platform: String? = nil
     ) -> RendererEvent {
         var fields: JSONObject = [:]
         if let colorScheme { fields["colorScheme"] = .string(colorScheme) }
         if let dynamicTypeSize { fields["dynamicTypeSize"] = .string(dynamicTypeSize) }
         if let horizontalSizeClass { fields["horizontalSizeClass"] = .string(horizontalSizeClass) }
         if let scenePhase { fields["scenePhase"] = .string(scenePhase) }
+        if let platform { fields["platform"] = .string(platform) }
         return RendererEvent(type: "environment", fields: fields)
     }
 

package/wasm/SwiftBrowserNative.wasm

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/wasm/SwiftBrowserNative.wasm
-size: 50270516 bytes
-sha256: 4ab90fcf8d11104965a65927418d4cf6f47e4595cfc42a018cecb08ee849644e
+size: 50287835 bytes
+sha256: af44f347a82278412c3e963bbb3d47e240c12ec80a8220b5641277010d238984