@craft-native/ios 0.0.214 → 0.0.216

package/README.md

@@ -192,6 +192,14 @@ wrong screen. `systemtap` targets the system button around a Live Activity rathe
 than its remotely hosted text. The [Live Activity layout fixture](./fixtures/live-activity)
 exercises long names and timer alignment using the production widget.
 
+Use `universallink https://example.com/profile` to test an associated HTTPS
+link after a fresh install. The driver host uses Apple's public
+`universalLinksOnly` option and waits up to 60 seconds for iOS to accept the
+association downloaded from Apple's CDN. A rejected association fails the
+journey; it cannot fall back to Safari. This operation does not launch the app
+under test directly, so a preceding `terminate` still tests a cold handoff.
+Use `openurl` for browser fallback checks and custom URL schemes.
+
 The iOS host uses the shared tree-layout ABI for eligible definite-size,
 non-grid, non-wrapped containers and retains a local fallback for older
 runtimes or unsupported styles. Both paths implement wrapped-line and grid

package/dist/index.js

@@ -156,8 +156,11 @@ function serializeSimulatorSteps(steps) {
       }
     } else if ("name" in step)
       arg = token(step.name);
-    else if ("url" in step)
+    else if ("url" in step) {
+      if (step.command === "universallink" && new URL(step.url).protocol !== "https:")
+        throw new Error("Universal Links require an HTTPS URL");
       arg = step.url;
+    }
     if (/[\r\n]/.test(arg))
       throw new Error("Simulator arguments cannot contain newlines");
     return `${step.command}${arg ? ` ${arg}` : ""}`;

package/dist/testing.d.ts

@@ -60,6 +60,11 @@ export type SimulatorStep = {
     command: 'openurl';
     url: string;
 }
+/** Use Apple's universalLinksOnly API, allowing association downloads up to 60 seconds. */
+ | {
+    command: 'universallink';
+    url: string;
+}
 /** Runs `step` only when the element with this identifier is there (a screen shown the first time). */
  | {
     command: 'ifid';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.214",
+  "version": "0.0.216",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",

package/templates/CraftNativeFlatList.swift

@@ -308,7 +308,7 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
 
     func setContentContainerStyle(_ raw: [String: Any]?) {
         func nonNegative(_ value: Any?) -> CGFloat? {
-            guard !(value is Bool), let number = value as? NSNumber else { return nil }
+            guard let number = craftNativeNumber(value) else { return nil }
             let points = CGFloat(truncating: number)
             guard points.isFinite, points >= 0 else { return nil }
             return points

package/templates/CraftNativeScreen.swift

@@ -1,4 +1,5 @@
 import Foundation
+import CoreFoundation
 import AVFoundation
 import AVKit
 import CryptoKit
@@ -12,32 +13,41 @@ import UIKit
 
 private let craftNativeCapabilityTimeoutMilliseconds = 30_000
 
+/// Foundation's `NSNumber(0/1) is Bool` is true even for JSON numbers.
+/// Check the Core Foundation identity so real booleans stay invalid numeric
+/// props while zero lengths, flex factors and opacity 1 remain numbers.
+func craftNativeNumber(_ value: Any?) -> NSNumber? {
+    guard let number = value as? NSNumber,
+          CFGetTypeID(number) != CFBooleanGetTypeID() else { return nil }
+    return number
+}
+
 /// A finite number from a prop, for the views outside the screen controller,
 /// which has its own: the keyboard-avoiding view and SVG text read theirs
 /// with it, and without it the template did not compile.
 private func number(_ value: Any?) -> CGFloat? {
     // JavaScript booleans bridge to NSNumber on Apple platforms; they are
     // invalid numeric styles and must stay unset like Android's Number cast.
-    guard !(value is Bool), let number = value as? NSNumber else { return nil }
+    guard let number = craftNativeNumber(value) else { return nil }
     let value = CGFloat(truncating: number)
     return value.isFinite ? value : nil
 }
 
 private func craftNativeFontWeight(_ value: Any?) -> String? {
     if let value = value as? String { return value }
-    guard !(value is Bool), let number = value as? NSNumber, number.doubleValue.isFinite else { return nil }
+    guard let number = craftNativeNumber(value), number.doubleValue.isFinite else { return nil }
     let integer = number.doubleValue.rounded()
     return integer == number.doubleValue ? String(Int(integer)) : nil
 }
 
 private func craftNativePickerValue(_ value: Any?) -> String? {
     if let value = value as? String, !value.isEmpty { return value }
-    if !(value is Bool), let value = value as? NSNumber, value.doubleValue.isFinite { return String(value.doubleValue) }
+    if let value = craftNativeNumber(value), value.doubleValue.isFinite { return String(value.doubleValue) }
     return nil
 }
 
 private func craftNativeGridColumnCount(_ value: Any?) -> Int {
-    if !(value is Bool), let number = value as? NSNumber { return max(1, number.intValue) }
+    if let number = craftNativeNumber(value) { return max(1, number.intValue) }
     guard let text = value as? String else { return 1 }
     let trimmed = text.trimmingCharacters(in: .whitespacesAndNewlines)
     if trimmed.hasPrefix("repeat(") {
@@ -1387,7 +1397,7 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
     }
 
     private static func numeric(_ value: Any?) -> Double? {
-        guard !(value is Bool), let number = value as? NSNumber else { return nil }
+        guard let number = craftNativeNumber(value) else { return nil }
         let value = number.doubleValue
         return value.isFinite ? value : nil
     }
@@ -1458,7 +1468,7 @@ private enum CraftNativeLength: Equatable {
     init?(_ value: Any?) {
         // JavaScript booleans can bridge to NSNumber on Apple platforms;
         // they are invalid CSS lengths and must stay unset like Android.
-        if !(value is Bool), let number = value as? NSNumber {
+        if let number = craftNativeNumber(value) {
             let points = CGFloat(truncating: number)
             guard points.isFinite else { return nil }
             self = .points(points)
@@ -1516,7 +1526,7 @@ private struct CraftNativeLayoutStyle {
 
     init(_ raw: [String: Any]) {
         func number(_ value: Any?) -> CGFloat? {
-            guard !(value is Bool), let number = value as? NSNumber else { return nil }
+            guard let number = craftNativeNumber(value) else { return nil }
             let value = CGFloat(truncating: number)
             return value.isFinite ? value : nil
         }
@@ -5000,7 +5010,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         else if let symbol = spec["symbol"] as? String { button.setImage(UIImage(systemName: symbol, withConfiguration: UIImage.SymbolConfiguration(pointSize: 20, weight: .regular)), for: .normal) }
         button.accessibilityIdentifier = spec["id"] as? String
         button.accessibilityLabel = spec["accessibilityLabel"] as? String
-        if !(spec["badge"] is Bool), let value = spec["badge"] as? NSNumber, value.intValue > 0 {
+        if let value = craftNativeNumber(spec["badge"]), value.intValue > 0 {
             let dot = spec["badgeStyle"] as? String == "dot"
             let size: CGFloat = dot ? 9 : 18
             // The fill is a tinted symbol, not a background colour: on iOS 26
@@ -7658,7 +7668,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     /// Countdown values use seconds when numeric, or `HH:mm[:ss]` text.
     static func countdownDuration(_ value: Any?) -> TimeInterval? {
         let maximum: TimeInterval = 23 * 3600 + 59 * 60 + 59
-        if let number = value as? NSNumber, !(value is Bool) {
+        if let number = craftNativeNumber(value) {
             let seconds = number.doubleValue
             guard seconds.isFinite else { return nil }
             return min(maximum, max(0, seconds))
@@ -7679,7 +7689,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     /// time), `2026-10-12T07:30` (local), a full ISO 8601 string, or
     /// milliseconds since 1970. Nil for anything else.
     static func pickerDate(_ value: Any?) -> Date? {
-        if let number = value as? NSNumber, !(value is Bool) {
+        if let number = craftNativeNumber(value) {
             let milliseconds = number.doubleValue
             guard milliseconds.isFinite else { return nil }
             return Date(timeIntervalSince1970: milliseconds / 1000)
@@ -7851,7 +7861,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     }
 
     private func number(_ value: Any?) -> CGFloat? {
-        guard !(value is Bool), let number = value as? NSNumber else { return nil }
+        guard let number = craftNativeNumber(value) else { return nil }
         let value = CGFloat(truncating: number)
         return value.isFinite ? value : nil
     }

package/templates/testing/DriverTests.swift.template

@@ -14,6 +14,7 @@ import XCTest
 ///   delay <ms>            every proxied request waits this long (0 = off)
 ///   exec <hook>           runs the switch's HOOKS/<hook>.sh on the Mac (restart the API, …)
 ///   openurl <url>         opens a link through the system, answering "Open in the app?"
+///   universallink <https-url> waits up to 60s for an OS-verified link; never opens a browser
 ///   shot <name>           screenshot → shots/<name>.png
 ///   tree <name>           accessibility tree → shots/<name>.txt
 ///   tap <text>            first hittable element whose label contains text
@@ -253,6 +254,21 @@ final class DriverTests: XCTestCase {
                 answerOpenPrompt()
                 note("openurl \(arg)")
             }
+        case "universallink":
+            guard let url = URL(string: arg), url.scheme == "https" else {
+                check(false, "universallink requires an HTTPS URL")
+                return
+            }
+            let host = XCUIApplication(bundleIdentifier: "{{BUNDLE_PREFIX}}.host")
+            host.launchArguments = ["--craft-universal-link", url.absoluteString]
+            host.launch()
+            let opened = app.wait(for: .runningForeground, timeout: 75)
+            if !opened {
+                post("/save?name=universal-link-host.txt", Data(host.debugDescription.utf8))
+                post("/save?name=universal-link-app.txt", Data(app.debugDescription.utf8))
+            }
+            check(opened, "universallink \(arg) opened the target app")
+            host.terminate()
         case "shot":
             let shot = XCUIScreen.main.screenshot()
             post("/save?name=\(arg).png", shot.pngRepresentation)

package/templates/testing/HostApp.swift

@@ -1,6 +1,36 @@
 import SwiftUI
+import UIKit
 
 @main
 struct HostApp: App {
-    var body: some Scene { WindowGroup { Text("Craft simulator driver") } }
+    @State private var status = "Craft simulator driver"
+
+    var body: some Scene {
+        WindowGroup {
+            Text(status).accessibilityIdentifier("craft-driver-status")
+                .task { await openUniversalLinkIfRequested() }
+        }
+    }
+
+    @MainActor
+    private func openUniversalLinkIfRequested() async {
+        let arguments = ProcessInfo.processInfo.arguments
+        guard let index = arguments.firstIndex(of: "--craft-universal-link"),
+              arguments.indices.contains(index + 1),
+              let url = URL(string: arguments[index + 1]), url.scheme == "https" else { return }
+        // Installation returns before iOS finishes downloading the AASA from
+        // Apple's CDN. Ask the public API until the OS accepts the association;
+        // universalLinksOnly prevents a failed attempt from opening Safari.
+        let deadline = Date().addingTimeInterval(60)
+        while Date() < deadline && !Task.isCancelled {
+            let opened = await UIApplication.shared.open(url, options: [.universalLinksOnly: true])
+            if opened {
+                status = "Universal Link accepted"
+                return
+            }
+            status = "Waiting for Universal Link association"
+            try? await Task.sleep(nanoseconds: 1_000_000_000)
+        }
+        status = "Universal Link was not accepted within 60 seconds"
+    }
 }