@swiftbrowser/native 0.26.2 → 0.26.3

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.3",
   "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.3",
+    "@swiftbrowser/web": "0.26.3",
     "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/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/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: 50282598 bytes
+sha256: 36221c0c44b7bb993ff03090d3f241303c9b224b90b1b1dc398137d25926ba14