@craft-native/ios 0.0.209 → 0.0.211

package/README.md

@@ -137,7 +137,13 @@ and linear gradients are applied by UIKit with the same style keys as Android;
 `elevation` remains Android-specific. Gradient layers follow the native view's
 bounds and corners through layout changes.
 
-The opt-in `native` renderer hosts compiled `.stx` screens in JavaScriptCore and renders their `View`, `SafeAreaView`, `Text`, `Button`, `Link`, `Checkbox`, `TextInput`, `Picker`, `DatePicker`, `Switch`, `Slider`, `ActivityIndicator`, `Icon`, `Image`, `ImageBackground`, `Video`, `Map`, `Svg`, `G`, `SvgText`, `ScrollView`, `SectionList`, and recycling `FlatList` nodes as UIKit controls. `Map` uses MapKit for trail polylines and marker taps; its overlays carry flat latitude/longitude `geometry` arrays, `strokeWidth` is expressed in logical points, and the camera supports controlled `region`, one-time `initialRegion`, and `fitToBounds`. `Svg` is a DOM-free drawing surface; grouped `G` and `SvgText` nodes are painted inside it. `Icon` uses SF Symbols with the shared symbol/name contract and accessibility metadata. `SectionList` uses the same native scroll host for ordinary `.stx` slot children; grouped section data should use `FlatList` until the section-data protocol is available. `FlatList` uses `UICollectionView` with stable keyed rows, incremental diffs, grids, horizontal and inverted layouts, list chrome, and end-reached pagination. Native views support `onLayout` callbacks with point-based frame measurements that refresh after safe-area or orientation changes. Flex items support `flex`, `flexGrow`, `flexShrink`, and numeric `flexBasis` for main-axis space distribution. Native screens also expose the versioned capability bridge: JSON storage and SQLite survive relaunch, lifecycle and deep-link events are scoped to the top route, and local notifications use `UNUserNotificationCenter`. Enable each capability in `craft.config.json`; disabled calls preserve Craft's `CAPABILITY_DISABLED` rejection code and every request has deterministic timeout/cancellation behavior. The default remains `web`; existing iOS apps are unchanged. `Checkbox` supports controlled `checked`/`value`, indeterminate state, and boolean `onValueChange`; `Picker` renders `<select>`/`<option>` values with `onValueChange` or `onChange`; `DatePicker` emits local date/time values plus ISO and millisecond timestamps; `Switch` supports state-aware `trackColor`, `thumbColor`, and iOS `ios_backgroundColor`; `Slider` supports track/thumb tint props and `step` snapping; `Image` reports load lifecycle events and structured failures; `Video` uses an `AVPlayerViewController` attached to the native screen for URI playback, native controls, and route-safe teardown. The portable component, capability, list, style, image-source, event, accessibility, and reconciliation behavior is specified in the [Native STX guide](../../docs/guides/native-stx.md).
+The opt-in `native` renderer hosts compiled `.stx` screens in JavaScriptCore and renders their `View`, `SafeAreaView`, `KeyboardAvoidingView`, `StatusBar`, `RefreshControl`, `Text`, `Button`, `Link`, `Checkbox`, `TextInput`, `Picker`, `DatePicker`, `Switch`, `Slider`, `ActivityIndicator`, `Icon`, `Image`, `ImageBackground`, `Video`, `Map`, `Svg`, `G`, `SvgText`, `ScrollView`, `SectionList`, and recycling `FlatList` nodes as UIKit controls. `StatusBar` and `RefreshControl` are screen/scroll utility nodes rather than visible children. `Map` uses MapKit for trail polylines and marker taps; its overlays carry flat latitude/longitude `geometry` arrays, `strokeWidth` is expressed in logical points, and the camera supports controlled `region`, one-time `initialRegion`, and `fitToBounds`. `Svg` is a DOM-free drawing surface; grouped `G` and `SvgText` nodes are painted inside it. `Icon` uses SF Symbols with the shared symbol/name contract and accessibility metadata. `SectionList` uses the same native scroll host for ordinary `.stx` slot children; grouped section data should use `FlatList` until the section-data protocol is available. `FlatList` uses `UICollectionView` with stable keyed rows, incremental diffs, grids, horizontal and inverted layouts, list chrome, and end-reached pagination. Native views support `onLayout` callbacks with point-based frame measurements that refresh after safe-area or orientation changes. Flex items support `flex`, `flexGrow`, `flexShrink`, and numeric `flexBasis` for main-axis space distribution. Native screens also expose the versioned capability bridge: JSON storage and SQLite survive relaunch, lifecycle and deep-link events are scoped to the top route, and local notifications use `UNUserNotificationCenter`. Enable each capability in `craft.config.json`; disabled calls preserve Craft's `CAPABILITY_DISABLED` rejection code and every request has deterministic timeout/cancellation behavior. The default remains `web`; existing iOS apps are unchanged. `Checkbox` supports controlled `checked`/`value`, indeterminate state, and boolean `onValueChange`; `Picker` renders `<select>`/`<option>` values with `onValueChange` or `onChange`; `DatePicker` emits local date/time values plus ISO and millisecond `timestamp` fields; `Switch` supports state-aware `trackColor`, `thumbColor`, and iOS `ios_backgroundColor`; `Slider` supports track/thumb tint props and `step` snapping; `Image` reports load lifecycle events and structured failures; `Video` uses an `AVPlayerViewController` attached to the native screen for URI playback, native controls, and route-safe teardown. `craft.navigation.setOptions` also accepts a `tabAccessory` destination beside the tab pill; it uses an app-local `path`, `title`, `symbol`, optional `badge`, and `accessibilityLabel`, and `null` clears it. The portable component, capability, list, style, image-source, event, accessibility, and reconciliation behavior is specified in the [Native STX guide](../../docs/guides/native-stx.md).
+
+JavaScriptCore has no DOM `window`; Craft aliases `globalThis.window` to
+`globalThis` before installing the native bridge so browser-safe SDK calls such
+as `window.craft.dialog.actionSheet()` reach the native capability host. This
+does not add `document` or DOM rendering; routes that do not opt into `native`
+continue using the WebView renderer.
 
 ```bash
 craft ios init NativeDemo --renderer native --output ./ios-native
@@ -181,6 +187,10 @@ under test is activated by its bundle identifier and is not rebuilt by the
 driver. Export evidence with `xcrun xcresulttool export attachments --path
 <result.xcresult> --output-path <evidence>`. Omitting `script` restores the
 control-server protocol, required for the `net`, `delay` and `exec` hooks.
+Journeys stop at the first failed check so later actions cannot operate on the
+wrong screen. `systemtap` targets the system button around a Live Activity rather
+than its remotely hosted text. The [Live Activity layout fixture](./fixtures/live-activity)
+exercises long names and timer alignment using the production widget.
 
 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

package/package.json

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

package/templates/CraftApp.swift

@@ -928,10 +928,12 @@ struct CraftTabBarView: View {
                 bar
                 if let accessory = chrome.tabAccessory {
                     Button { CraftHybrid.shared.open(accessory.id) } label: {
-                        Image(systemName: accessory.symbol)
-                            .font(.system(size: iconSize))
-                            .frame(width: 62, height: 62)
-                            .background(.ultraThinMaterial, in: Circle())
+                        surface {
+                            Image(systemName: accessory.symbol)
+                                .font(.system(size: iconSize))
+                                .foregroundStyle(Color.primary)
+                                .frame(width: 62, height: 62)
+                        }
                             .overlay(alignment: .topTrailing) {
                                 if let badge = accessory.badge {
                                     Text(badge)
@@ -967,24 +969,27 @@ struct CraftTabBarView: View {
         chrome.layoutChanged(max(0, screen - proxy.frame(in: .global).minY))
     }
 
-    @ViewBuilder private var bar: some View {
+    private var bar: some View {
+        surface { items.padding(4) }
+    }
+
+    /// Both the tab capsule and its circular accessory use the same material,
+    /// outline and shadow. A square capsule forms the accessory's circle.
+    @ViewBuilder private func surface<Content: View>(@ViewBuilder content: () -> Content) -> some View {
 #if compiler(>=6.2)
         if #available(iOS 26.0, *) {
             GlassEffectContainer {
-                items
-                    .padding(4)
+                content()
                     .glassEffect(.regular.interactive(), in: .capsule)
             }
         } else {
-            items
-                .padding(4)
+            content()
                 .background(.ultraThinMaterial, in: Capsule())
                 .overlay(Capsule().strokeBorder(Color.white.opacity(0.35), lineWidth: 0.5))
                 .shadow(color: .black.opacity(0.12), radius: 18, y: 6)
         }
 #else
-        items
-            .padding(4)
+        content()
             .background(.ultraThinMaterial, in: Capsule())
             .overlay(Capsule().strokeBorder(Color.white.opacity(0.35), lineWidth: 0.5))
             .shadow(color: .black.opacity(0.12), radius: 18, y: 6)

package/templates/CraftLiveActivityWidget.swift.template

@@ -11,9 +11,9 @@ struct CraftLiveActivityWidget: Widget {
     var body: some WidgetConfiguration {
         ActivityConfiguration(for: CraftActivityAttributes.self) { context in
             HStack(spacing: 12) {
-                Image(systemName: symbol(context)).font(.title2).foregroundStyle(tint(context))
+                activityIcon(context).font(.title2)
                 VStack(alignment: .leading, spacing: 4) {
-                    Text(context.attributes.title).font(.headline).lineLimit(1)
+                    Text(context.attributes.title).font(.headline).lineLimit(2)
                     if let detail = context.state.detail, !detail.isEmpty {
                         Text(detail).font(.subheadline).lineLimit(1)
                     }
@@ -33,14 +33,14 @@ struct CraftLiveActivityWidget: Widget {
         } dynamicIsland: { context in
             DynamicIsland {
                 DynamicIslandExpandedRegion(.leading) {
-                    Image(systemName: symbol(context)).foregroundStyle(tint(context)).font(.title2)
+                    activityIcon(context).font(.title2)
                 }
                 DynamicIslandExpandedRegion(.trailing) {
                     timer(context).font(.title2.monospacedDigit().weight(.semibold))
                 }
                 DynamicIslandExpandedRegion(.center) {
                     VStack(spacing: 3) {
-                        Text(context.attributes.title).font(.headline).lineLimit(1)
+                        Text(context.attributes.title).font(.headline).lineLimit(2)
                         Text(context.isStale ? context.state.staleStatus ?? context.state.status : context.state.status).font(.caption).foregroundStyle(.secondary).lineLimit(1)
                     }
                 }
@@ -59,17 +59,26 @@ struct CraftLiveActivityWidget: Widget {
                     }
                 }
             } compactLeading: {
-                Image(systemName: symbol(context)).foregroundStyle(tint(context))
+                activityIcon(context)
             } compactTrailing: {
-                timer(context).monospacedDigit().frame(maxWidth: 64)
+                timer(context).monospacedDigit().frame(maxWidth: 64, alignment: .trailing)
             } minimal: {
-                Image(systemName: symbol(context)).foregroundStyle(tint(context))
+                activityIcon(context)
             }
             .widgetURL(context.attributes.deepLink.flatMap(URL.init(string:)))
             .keylineTint(tint(context))
         }
     }
 
+    private func activityIcon(_ context: ActivityViewContext<CraftActivityAttributes>) -> some View {
+        // The pause glyph uses the active symbol's footprint, keeping the
+        // title's leading edge steady through state changes.
+        Image(systemName: context.attributes.symbol ?? "timer")
+            .hidden()
+            .overlay { Image(systemName: symbol(context)) }
+            .foregroundStyle(tint(context))
+    }
+
     private func symbol(_ context: ActivityViewContext<CraftActivityAttributes>) -> String {
         context.state.paused == true ? "pause.fill" : context.attributes.symbol ?? "timer"
     }
@@ -82,8 +91,23 @@ struct CraftLiveActivityWidget: Widget {
 
     private func date(_ milliseconds: Double) -> Date { Date(timeIntervalSince1970: milliseconds / 1000) }
 
-    @ViewBuilder
     private func timer(_ context: ActivityViewContext<CraftActivityAttributes>) -> some View {
+        // Measure the hour format in the inherited native font. A widget's
+        // ticking Text is horizontally flexible; an overlay bounds it to this
+        // footprint so names retain the same width when the timer pauses.
+        Text(duration(max(3600, context.state.durationSeconds, context.state.remainingSeconds ?? 0)))
+            .lineLimit(1)
+            .hidden()
+            .overlay(alignment: .trailing) {
+                timerContent(context)
+                    .multilineTextAlignment(.trailing)
+                    .lineLimit(1)
+                    .minimumScaleFactor(0.8)
+            }
+    }
+
+    @ViewBuilder
+    private func timerContent(_ context: ActivityViewContext<CraftActivityAttributes>) -> some View {
         if context.state.paused == true {
             Text(duration(context.state.remainingSeconds ?? context.state.durationSeconds))
         } else if let end = context.state.timerEndsAt {

package/templates/CraftNativeScreen.swift

@@ -4151,6 +4151,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         let appVersion = Self.jsonString(info?["CFBundleShortVersionString"] as? String ?? "")
         let appBuild = Self.jsonString(info?["CFBundleVersion"] as? String ?? "")
         jsContext.evaluateScript("""
+            // JavaScriptCore has no DOM window, but browser-safe SDK bridges
+            // address the host through `window.craft`. Keep native screens
+            // compatible without pretending a document exists.
+            if (typeof globalThis.window === "undefined") { globalThis.window = globalThis; }
             globalThis.__stxNativeCallback = null;
             globalThis.__stxNativeBridge = {
                 platform: "ios",
@@ -4279,7 +4283,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     ///   `craft.secureStorage.set` wrote.
     /// - `craft.navigation.setOptions({ title, largeTitle, hidden, backTitle,
     ///   tabBarHidden, swipeBack, contentSwipeBack, tabSwipeEnabled,
-    ///   backgroundColor, navigationBarSolid, rightButtons })`;
+    ///   backgroundColor, navigationBarSolid, rightButtons, tabAccessory })`;
     ///   a right button's tap is the event `navButton`.
     ///
     /// A runtime that assigns `craft.storage` (or the others) afterwards keeps
@@ -5731,7 +5735,6 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 ? nil : number(props["activeOpacity"]) ?? 0.5
             pressable.pressBaseOpacity = number(style["opacity"]) ?? 1
             pressable.pressUnderlayColor = type == "TouchableHighlight" && !disabled ? color(props["underlayColor"]) : nil
-            pressable.pressBaseBackgroundColor = pressable.backgroundColor
         case "Switch":
             let toggle = result as! UISwitch
             toggle.isOn = props["value"] as? Bool ?? props["checked"] as? Bool ?? false
@@ -6689,6 +6692,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         updateDimension(width, constraint: &node.widthConstraint, anchor: view.widthAnchor)
         updateDimension(height, constraint: &node.heightConstraint, anchor: view.heightAnchor)
         view.backgroundColor = color(style["backgroundColor"]) ?? .clear
+        // Every flow container can receive press feedback, including ordinary
+        // Views. Capture its current authored fill before feedback cleanup or
+        // release restores it; otherwise avatars and button wrappers go clear.
+        (view as? CraftNativeFlowView)?.pressBaseBackgroundColor = view.backgroundColor
         // A field the style dresses itself (`border-0`, a border or a
         // background, as a search field inside its own pill is) draws no
         // system box of its own; a bare one keeps the rounded rectangle.
@@ -6940,7 +6947,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private func textFont(_ style: [String: Any], default fallback: UIFont) -> UIFont {
         let size = number(style["fontSize"]) ?? fallback.pointSize
         let weight: UIFont.Weight
-        switch style["fontWeight"] as? String {
+        switch craftNativeFontWeight(style["fontWeight"]) {
         case "100": weight = .ultraLight
         case "200": weight = .thin
         case "300": weight = .light
@@ -6962,7 +6969,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             ?? .systemFont(ofSize: scaledSize, weight: weight)
         if style["fontStyle"] as? String == "italic",
            let descriptor = font.fontDescriptor.withSymbolicTraits(.traitItalic) {
-            font = UIFont(descriptor: descriptor, size: size)
+            font = UIFont(descriptor: descriptor, size: scaledSize)
         }
         return font
     }
@@ -7162,7 +7169,16 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             || controlledVideo
         view.isAccessibilityElement = !container && role != "none" && (view.accessibilityLabel != nil || role != nil || ["Text", "Button", "Link", "Checkbox", "Image", "ImageBackground", "Video", "TextInput", "Picker", "DatePicker", "Switch", "Slider"].contains(type))
         view.accessibilityContainerType = container && (view.accessibilityLabel != nil || controlledVideo) ? .semanticGroup : .none
+        // Keep the interaction trait native controls expose. Rebuilding this
+        // set from the STX role alone otherwise turns a Slider, Picker,
+        // DatePicker, or Switch into a static VoiceOver item whenever the
+        // screen omits redundant accessibility metadata.
         var traits: UIAccessibilityTraits = []
+        switch type {
+        case "Slider", "Picker", "DatePicker": traits.insert(.adjustable)
+        case "Switch": traits.insert(.button)
+        default: break
+        }
         switch role ?? type.lowercased() {
         case "tablist": traits.insert(.tabBar)
         case "button", "checkbox": traits.insert(.button)

package/templates/testing/DriverTests.swift.template

@@ -167,7 +167,7 @@ final class DriverTests: XCTestCase {
     }
 
     func testScript() throws {
-        continueAfterFailure = true
+        continueAfterFailure = false
         let data: Data?
         if let resource = Bundle(for: DriverTests.self).url(forResource: "journey", withExtension: "txt") {
             bundledJourney = true
@@ -219,7 +219,13 @@ final class DriverTests: XCTestCase {
             check(element(containing: arg, in: springboard) == nil, "systemabsent \(arg)")
         case "systemtap":
             let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
-            if let target = poll(10, { element(containing: arg, in: springboard) }) { press(target); note("systemtap \(arg): ok") }
+            // Widget text lives in a remote accessibility host. Its frame can
+            // be visible while XCTest cannot resolve an activation point. Tap
+            // the containing system button (the actual Live Activity card).
+            let predicate = NSPredicate(format: "label CONTAINS[c] %@ OR identifier == %@", arg, arg)
+            let card = springboard.buttons.containing(predicate).firstMatch
+            if card.exists && card.isHittable { press(card); note("systemtap \(arg): ok") }
+            else if let target = poll(10, { element(containing: arg, in: springboard) }) { press(target); note("systemtap \(arg): ok") }
             else { XCTFail("System element not found"); note("FAIL systemtap \(arg): NOT FOUND") }
         case "systemtree":
             let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")