@craft-native/ios 0.0.204 → 0.0.205

package/README.md

@@ -119,6 +119,9 @@ In Xcode:
 
 Native screens also support `ImageBackground`, which loads an image behind
 ordinary native children while preserving the shared flex layout contract.
+Native image sources accept HTTPS everywhere and loopback HTTP for local
+development (`localhost`, `127.0.0.1`, `::1`, and `*.localhost`); public HTTP
+and unsupported schemes are rejected.
 `KeyboardAvoidingView` also responds to the native keyboard with `padding`,
 `position`, or `height` behavior.
 
@@ -129,10 +132,12 @@ authorization or requiring local notifications to be enabled.
 Keyboard frame changes update the native controller's additional safe area, so
 focused inputs and responsive `onLayout` measurements move with the keyboard.
 
-Shared view transforms, z-order, and view/text shadows are applied by UIKit
-with the same style keys as Android; `elevation` remains Android-specific.
+Shared view transforms, z-order, view/text shadows, per-edge border styles,
+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 and can fit the visible region to their bounds. `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`, `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).
 
 ```bash
 craft ios init NativeDemo --renderer native --output ./ios-native
@@ -195,6 +200,9 @@ screen background (including light/dark trait changes) with
 UIKit's translucent material; set it back to `false` when a screen no longer
 needs a solid bar.
 
+The `backgroundColor` navigation option is shared with the Android native host;
+omitting it or passing `null` returns to the app's dynamic light/dark colour.
+
 The optional Liquid Glass tab-bar styling is compiler-gated for Xcode 26/Swift 6.2 and later. Older SDKs compile the same tab bar with the material fallback, so generated projects remain buildable on Xcode 16.
 
 The iOS host overlays `craft.config.json` on its defaults. Missing or `null` capability flags stay disabled; explicitly set a flag to `true` to enable it. Both the Swift host and Zig bridge reject malformed values and fall back to all capabilities disabled.

package/dist/testing.d.ts

@@ -11,7 +11,7 @@ export interface SimulatorDriverOptions {
 /** Generate the reusable XCUITest shell from package templates. No app-owned Swift. */
 export declare function initSimulatorDriver(options: SimulatorDriverOptions): void;
 export type SimulatorStep = {
-    command: 'launch' | 'activate' | 'terminate' | 'home' | 'back' | 'return' | 'unlabelled';
+    command: 'launch' | 'activate' | 'terminate' | 'home' | 'back' | 'return' | 'unlabelled' | 'notifications';
 } | {
     command: 'background' | 'wait';
     seconds: number;
@@ -45,14 +45,14 @@ export type SimulatorStep = {
     id: string;
     text: string;
 } | {
-    command: 'expect' | 'expectexact' | 'expectid';
+    command: 'expect' | 'expectexact' | 'expectid' | 'systemexpect';
     text: string;
     seconds?: number;
 } | {
-    command: 'tap' | 'tapif' | 'tapid' | 'tapexact' | 'type' | 'absent' | 'absentid' | 'selected' | 'tab' | 'scrollto' | 'dismiss' | 'log';
+    command: 'tap' | 'tapif' | 'tapid' | 'tapexact' | 'type' | 'absent' | 'absentid' | 'selected' | 'tab' | 'scrollto' | 'dismiss' | 'log' | 'systemtap' | 'systemabsent';
     text: string;
 } | {
-    command: 'shot' | 'tree' | 'audit' | 'exec';
+    command: 'shot' | 'tree' | 'audit' | 'exec' | 'systemtree';
     name: string;
 } | {
     command: 'openurl';

package/package.json

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

package/templates/CraftHybrid.swift

@@ -146,8 +146,10 @@ struct CraftHybridRoutes {
         let scheme = (url.scheme ?? "").lowercased()
         guard scheme == "http" || scheme == "https",
               let host = url.host?.lowercased(), !host.isEmpty,
-              let siteHost = site?.host?.lowercased() else { return false }
-        return host == siteHost
+              let siteScheme = site?.scheme?.lowercased(), scheme == siteScheme,
+              let siteHost = site?.host?.lowercased(), host == siteHost,
+              url.port == site?.port else { return false }
+        return true
     }
 
     /// Where a path no native screen draws opens in an app with no web view:
@@ -979,6 +981,17 @@ final class CraftHybridWebSlot: UIViewController {
     /// ready. This belongs to the incoming slot, beyond the push animation.
     private(set) var waitingPageSnapshot: UIView?
 
+    /// A canceled tab swipe may leave this slot hidden after the page has
+    /// already reported its destination. Reconcile that route before the
+    /// WebView is adopted again, so the slot cannot stay transparent forever.
+    @discardableResult
+    func markArrivedIfNeeded(_ currentPath: String?) -> Bool {
+        guard awaitingPage, let currentPath,
+              CraftHybridRoutes.normalize(currentPath) == CraftHybridRoutes.normalize(path) else { return false }
+        awaitingPage = false
+        return true
+    }
+
     func keepPageVisible(_ snapshot: UIView) {
         waitingPageSnapshot?.removeFromSuperview()
         snapshot.frame = view.bounds
@@ -1392,7 +1405,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
 
     /// The entry for a path: its native screen, or a web entry.
     private func entry(for path: String, isTabRoot: Bool, depth: Int?, params extra: [String: Any] = [:]) -> UIViewController {
-        if let match = hybrid.routes.match(path) {
+        if hybrid.isEnabled, let match = hybrid.routes.match(path) {
             var params = self.params(for: path, match)
             extra.forEach { params[$0.key] = $0.value }
             let screen = CraftNativeScreenController(config: config, routeName: match.screen, routeParams: params)
@@ -1441,6 +1454,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
     func adoptWeb(into slot: CraftHybridWebSlot, allowHiddenStack: Bool = false) {
         guard let webHost,
               allowHiddenStack || slot.navigationController === visibleStack || visibleStack == nil else { return }
+        slot.markArrivedIfNeeded(hybrid.pagePath)
         attachWeb()
         moveWeb(to: slot, in: slot.view)
         webHost.view.alpha = slot.awaitingPage ? 0 : 1

package/templates/CraftNativeFlatList.swift

@@ -158,6 +158,8 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
     private var refreshHandler: (() -> Void)?
     private let keyboardTapGesture = UITapGestureRecognizer()
     private var keyboardShouldPersistTaps = "never"
+    private var scrollTargetKey: String?
+    private var pendingScrollTarget: (id: String, animated: Bool, attempts: Int)?
 
     init() {
         let layout = CraftNativeFlatListLayout()
@@ -271,6 +273,37 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
         updateItemEstimate()
         super.layoutSubviews()
         craftApplyCornerRadius()
+        scrollToPendingTarget()
+    }
+
+    /// Scroll to a virtualized row identified by its native testID, id, or key.
+    /// The row need not be mounted yet; the data snapshot is enough to find its
+    /// index, and UIKit will mount it as part of the scroll.
+    func setScrollTarget(_ value: Any?) {
+        var id: String?
+        var animated = true
+        if let text = value as? String {
+            id = text
+        } else if let target = value as? [String: Any] {
+            id = target["id"] as? String
+            animated = target["animated"] as? Bool ?? true
+        }
+        guard let id, !id.isEmpty else {
+            scrollTargetKey = nil
+            pendingScrollTarget = nil
+            return
+        }
+        let key: String
+        if let target = value as? [String: Any],
+           let data = try? JSONSerialization.data(withJSONObject: target, options: [.sortedKeys]) {
+            key = String(decoding: data, as: UTF8.self)
+        } else {
+            key = id
+        }
+        guard key != scrollTargetKey else { return }
+        scrollTargetKey = key
+        pendingScrollTarget = (id, animated, 0)
+        scrollToPendingTarget()
     }
 
     func setContentContainerStyle(_ raw: [String: Any]?) {
@@ -473,6 +506,8 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
         onMomentumScrollBegin = nil
         onMomentumScrollEnd = nil
         pendingThemeRefresh = false
+        scrollTargetKey = nil
+        pendingScrollTarget = nil
     }
 
     func refreshThemeDefaults() {
@@ -543,10 +578,39 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
                 self.refreshThemeDefaults()
                 return
             }
+            self.scrollToPendingTarget()
             self.evaluateEndReached()
         }
     }
 
+    private func targetIndex(for id: String) -> Int? {
+        items.firstIndex { item in
+            let props = item.node["props"] as? [String: Any] ?? [:]
+            return [props["testID"], props["id"], item.node["id"], item.identity]
+                .compactMap { $0 as? String }
+                .contains(id)
+        }
+    }
+
+    private func scrollToPendingTarget() {
+        guard let target = pendingScrollTarget else { return }
+        guard let index = targetIndex(for: target.id), index < numberOfItems(inSection: 0) else {
+            if target.attempts >= 4 {
+                // A diffable snapshot may still be applying. Keep the target
+                // for finishApplyingSnapshot(), but discard an invalid target
+                // once the list is otherwise idle.
+                if !isApplyingSnapshot { pendingScrollTarget = nil }
+                return
+            }
+            pendingScrollTarget = (target.id, target.animated, target.attempts + 1)
+            DispatchQueue.main.async { [weak self] in self?.scrollToPendingTarget() }
+            return
+        }
+        pendingScrollTarget = nil
+        let position: UICollectionView.ScrollPosition = flowLayout.scrollDirection == .horizontal ? .left : .top
+        scrollToItem(at: IndexPath(item: index, section: 0), at: position, animated: target.animated)
+    }
+
     private func clamped(_ offset: CGPoint) -> CGPoint {
         CGPoint(
             x: min(max(-adjustedContentInset.left, offset.x), max(-adjustedContentInset.left, contentSize.width - bounds.width + adjustedContentInset.right)),

package/templates/CraftNativeScreen.swift

@@ -21,6 +21,12 @@ private func number(_ value: Any?) -> CGFloat? {
     return value.isFinite ? value : nil
 }
 
+private func craftNativePickerValue(_ value: Any?) -> String? {
+    if let value = value as? String, !value.isEmpty { return value }
+    if let value = value as? NSNumber, value.doubleValue.isFinite { return String(value.doubleValue) }
+    return nil
+}
+
 private func craftNativeGridColumnCount(_ value: Any?) -> Int {
     if let number = value as? NSNumber { return max(1, number.intValue) }
     guard let text = value as? String else { return 1 }
@@ -751,6 +757,9 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
     private var timeObserver: Any?
     private var loops = false
     private var wasPlaying: Bool?
+    private var playIntent: Bool?
+    private var userPaused = false
+    private var ended = false
     /// This video holds a claim on the audio session (`CraftNativeSounds`).
     private var claimedSession = false
     /// The screen's handlers by event name (`onEnd`, `onPlay`, `onPause`,
@@ -829,9 +838,17 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
 
     func configure(source: Any?, autoplay: Bool, paused: Bool, loop: Bool, muted: Bool, controls: Bool, resizeMode: String?, pictureInPicture: Bool = false) {
         let uri = (source as? String) ?? (source as? [String: Any])?["uri"] as? String ?? ""
+        let nextShouldPlay = autoplay && !paused
+        if playIntent != nextShouldPlay {
+            userPaused = false
+            ended = false
+        }
+        playIntent = nextShouldPlay
         if uri != sourceURI {
             detachPlayer()
             sourceURI = uri
+            userPaused = false
+            ended = false
             loops = false
             // The copy `craft.media.keep` put on the phone plays in place of
             // the address, so a kept video plays with no signal.
@@ -871,7 +888,11 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
             playerController.canStartPictureInPictureAutomaticallyFromInline = floating
         }
         loops = loop
-        if paused || !autoplay { player.pause() } else { player.play() }
+        if nextShouldPlay {
+            if !userPaused && !ended { player.play() }
+        } else {
+            player.pause()
+        }
     }
 
     // MARK: AVPlayerViewControllerDelegate
@@ -915,8 +936,12 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
                 queue: .main
             ) { [weak self, weak player] _ in
                 guard let self else { return }
+                self.ended = !self.loops
                 self.fire("onEnd")
-                if self.loops { player?.seek(to: .zero) { _ in player?.play() } }
+                if self.loops {
+                    self.ended = false
+                    player?.seek(to: .zero) { _ in player?.play() }
+                }
             }
         }
         playingObservation = player.observe(\.timeControlStatus, options: [.new]) { [weak self] player, _ in
@@ -927,6 +952,12 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
                 // Paused before it ever played is where it starts, not news.
                 if self.wasPlaying == nil && !playing { self.wasPlaying = false; return }
                 self.wasPlaying = playing
+                if playing {
+                    self.userPaused = false
+                    self.ended = false
+                } else if self.playIntent == true {
+                    self.userPaused = true
+                }
                 self.fire(playing ? "onPlay" : "onPause")
             }
         }
@@ -940,6 +971,9 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
         detachPlayer()
         playerController.player = nil
         sourceURI = ""
+        playIntent = nil
+        userPaused = false
+        ended = false
         if playerController.parent != nil {
             playerController.willMove(toParent: nil)
             playerController.view.removeFromSuperview()
@@ -956,6 +990,8 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
     private var overlayCoordinatesByID: [String: [CLLocationCoordinate2D]] = [:]
     private var overlayColors: [ObjectIdentifier: UIColor] = [:]
     private var overlayWidths: [ObjectIdentifier: CGFloat] = [:]
+    private var initialCameraKey: String?
+    private var pendingFitKey: String?
     private(set) var markerHandlers: [String: String] = [:]
     var onMarkerTap: ((String) -> Void)?
 
@@ -998,7 +1034,8 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
             if type == "mapmarker" || type == "marker" {
                 guard let point = points.first else { continue }
                 nextMarkers[id] = (point, childProps["title"] as? String)
-                if let handler = childEvents["onPress"] ?? childEvents["onMarkerPress"], !handler.isEmpty {
+                if let handler = nonEmptyHandler(childEvents["onPress"])
+                    ?? nonEmptyHandler(childEvents["onMarkerPress"]) {
                     nextHandlers[id] = handler
                 }
             } else if type == "mappolyline" || type == "polyline" {
@@ -1056,23 +1093,62 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
             addOverlay(overlay)
         }
 
-        if let region = Self.region(props["region"] ?? props["initialRegion"]) {
+        if let region = Self.region(props["region"]) {
+            // `region` is controlled: an authored change is allowed to move
+            // the camera, even when the map itself was already mounted.
+            pendingFitKey = nil
             setRegion(region, animated: false)
+            initialCameraKey = nil
+        } else if let initial = Self.region(props["initialRegion"]) {
+            pendingFitKey = nil
+            let key = "region:\(Self.regionKey(initial))"
+            if initialCameraKey != key {
+                setRegion(initial, animated: false)
+                initialCameraKey = key
+            }
         } else if props["fitToBounds"] as? Bool == true {
-            fitToOverlays()
+            let key = "fit:\(Self.overlayKey(markers: nextMarkers.mapValues { $0.coordinate }, polylines: nextPolylines.mapValues { $0.coordinates }))"
+            if initialCameraKey != key {
+                // A native screen can reconcile before UIKit assigns the map
+                // its final safe-area-constrained bounds. Keep the fit
+                // pending until there is a real viewport, matching Android's
+                // onSizeChanged retry instead of silently accepting a no-op.
+                pendingFitKey = key
+                if fitToOverlays() {
+                    initialCameraKey = key
+                    pendingFitKey = nil
+                }
+            }
+        } else {
+            initialCameraKey = nil
+            pendingFitKey = nil
         }
     }
 
-    private func fitToOverlays() {
+    override func layoutSubviews() {
+        super.layoutSubviews()
+        guard let key = pendingFitKey else { return }
+        pendingFitKey = nil
+        guard fitToOverlays() else {
+            pendingFitKey = key
+            return
+        }
+        initialCameraKey = key
+    }
+
+    @discardableResult
+    private func fitToOverlays() -> Bool {
+        guard bounds.width > 0, bounds.height > 0 else { return false }
         var rect = MKMapRect.null
         for overlay in overlaysByID.values { rect = rect.union(overlay.boundingMapRect) }
         for annotation in annotationsByID.values {
             let point = MKMapPoint(annotation.coordinate)
             rect = rect.union(MKMapRect(x: point.x, y: point.y, width: 0, height: 0))
         }
-        guard !rect.isNull else { return }
+        guard !rect.isNull else { return false }
         let inset = UIEdgeInsets(top: 24, left: 24, bottom: 24, right: 24)
         setVisibleMapRect(rect, edgePadding: inset, animated: false)
+        return true
     }
 
     func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
@@ -1118,6 +1194,25 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
         }
     }
 
+    private static func regionKey(_ region: MKCoordinateRegion) -> String {
+        "\(region.center.latitude),\(region.center.longitude),\(region.span.latitudeDelta),\(region.span.longitudeDelta)"
+    }
+
+    private static func overlayKey(
+        markers: [String: CLLocationCoordinate2D],
+        polylines: [String: [CLLocationCoordinate2D]]
+    ) -> String {
+        let markerKey = markers.keys.sorted().compactMap { id in
+            guard let point = markers[id] else { return nil }
+            return "\(id):\(point.latitude),\(point.longitude)"
+        }.joined(separator: "|")
+        let polylineKey = polylines.keys.sorted().compactMap { id in
+            guard let points = polylines[id] else { return nil }
+            return "\(id):" + points.map { "\($0.latitude),\($0.longitude)" }.joined(separator: ";")
+        }.joined(separator: "|")
+        return "m[\(markerKey)]p[\(polylineKey)]"
+    }
+
     private static func region(_ value: Any?) -> MKCoordinateRegion? {
         guard let value = value as? [String: Any],
               let center = value["center"] as? [String: Any],
@@ -1140,7 +1235,9 @@ private final class CraftNativeMapView: MKMapView, MKMapViewDelegate {
         case "orange": return .systemOrange
         case "purple": return .systemPurple
         case "yellow": return .systemYellow
-        default: return .systemBlue
+        default:
+            guard let value else { return .systemBlue }
+            return UIColor(css: value) ?? UIColor(hex: value) ?? .systemBlue
         }
     }
 
@@ -1371,13 +1468,32 @@ extension UIView {
             let right = sides[1].frame.width
             let bottom = sides[2].frame.height
             let left = sides[3].frame.width
-            sides[0].frame = CGRect(x: 0, y: 0, width: bounds.width, height: top)
-            sides[1].frame = CGRect(x: max(0, bounds.width - right), y: 0, width: right, height: bounds.height)
-            sides[2].frame = CGRect(x: 0, y: max(0, bounds.height - bottom), width: bounds.width, height: bottom)
-            sides[3].frame = CGRect(x: 0, y: 0, width: left, height: bounds.height)
+            let frames = [
+                CGRect(x: 0, y: 0, width: bounds.width, height: top),
+                CGRect(x: max(0, bounds.width - right), y: 0, width: right, height: bounds.height),
+                CGRect(x: 0, y: max(0, bounds.height - bottom), width: bounds.width, height: bottom),
+                CGRect(x: 0, y: 0, width: left, height: bounds.height),
+            ]
+            for (index, side) in sides.enumerated() {
+                side.frame = frames[index]
+                if let shape = side as? CAShapeLayer {
+                    shape.path = craftSideBorderPath(shape.bounds, index: index)
+                }
+            }
         }
     }
 
+    private func craftSideBorderPath(_ bounds: CGRect, index: Int) -> CGPath {
+        let path = UIBezierPath()
+        switch index {
+        case 0: path.move(to: CGPoint(x: bounds.minX, y: bounds.midY)); path.addLine(to: CGPoint(x: bounds.maxX, y: bounds.midY))
+        case 1: path.move(to: CGPoint(x: bounds.midX, y: bounds.minY)); path.addLine(to: CGPoint(x: bounds.midX, y: bounds.maxY))
+        case 2: path.move(to: CGPoint(x: bounds.minX, y: bounds.midY)); path.addLine(to: CGPoint(x: bounds.maxX, y: bounds.midY))
+        default: path.move(to: CGPoint(x: bounds.midX, y: bounds.minY)); path.addLine(to: CGPoint(x: bounds.midX, y: bounds.maxY))
+        }
+        return path.cgPath
+    }
+
     fileprivate func craftApplyBorderStyle(_ style: String?, width: CGFloat, color: UIColor) {
         guard width > 0, style == "dashed" || style == "dotted" else {
             (objc_getAssociatedObject(self, &craftNativeBorderLayerKey) as? CAShapeLayer)?.removeFromSuperlayer()
@@ -1410,6 +1526,7 @@ extension UIView {
         (objc_getAssociatedObject(self, &craftNativeBorderLayerKey) as? CAShapeLayer)?.removeFromSuperlayer()
         objc_setAssociatedObject(self, &craftNativeBorderLayerKey, nil, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
         layer.borderWidth = 0
+        (objc_getAssociatedObject(self, &craftNativeSideBorderLayersKey) as? [CALayer])?.forEach { $0.removeFromSuperlayer() }
         let top = max(0, widths.count > 0 ? widths[0] : 0)
         let right = max(0, widths.count > 1 ? widths[1] : 0)
         let bottom = max(0, widths.count > 2 ? widths[2] : 0)
@@ -1421,9 +1538,25 @@ extension UIView {
             CGRect(x: 0, y: 0, width: left, height: bounds.height),
         ]
         let layers = frames.enumerated().map { index, frame in
-            let side = CALayer()
+            let side: CALayer
+            if style == "dashed" || style == "dotted" {
+                let shape = CAShapeLayer()
+                shape.strokeColor = (colors.count > index ? colors[index] : .clear).cgColor
+                shape.fillColor = nil
+                shape.lineWidth = index % 2 == 0 ? frame.height : frame.width
+                shape.lineCap = style == "dotted" ? .round : .butt
+                shape.lineDashPattern = style == "dotted"
+                    ? [NSNumber(value: Double(shape.lineWidth)), NSNumber(value: Double(shape.lineWidth * 1.5))]
+                    : [NSNumber(value: Double(shape.lineWidth * 3)), NSNumber(value: Double(shape.lineWidth * 2))]
+                shape.contentsScale = window?.screen.scale ?? traitCollection.displayScale
+                shape.frame = frame
+                shape.path = craftSideBorderPath(shape.bounds, index: index)
+                side = shape
+            } else {
+                side = CALayer()
+                side.backgroundColor = (colors.count > index ? colors[index] : .clear).cgColor
+            }
             side.frame = frame
-            side.backgroundColor = (colors.count > index ? colors[index] : .clear).cgColor
             layer.addSublayer(side)
             return side
         }
@@ -1523,6 +1656,8 @@ extension UIView {
 private class CraftNativeFlowView: UIStackView {
     var pressActiveOpacity: CGFloat?
     var pressBaseOpacity: CGFloat = 1
+    var pressUnderlayColor: UIColor?
+    var pressBaseBackgroundColor: UIColor?
     var wrap = false { didSet { if wrap != oldValue { invalidateMeasurements() } } }
     var alignItems = "stretch" { didSet { alignment = alignmentValue; if alignItems != oldValue { invalidateMeasurements() } } }
     var alignContent = "flex-start" { didSet { if alignContent != oldValue { invalidateMeasurements() } } }
@@ -3174,10 +3309,16 @@ private final class CraftNativeSvgView: UIView {
         var strokeWidth: CGFloat = 1
         var color: String? = "#000000"
         var opacity: CGFloat = 1
+        var fillOpacity: CGFloat = 1
+        var strokeOpacity: CGFloat = 1
+        var strokeDashoffset: CGFloat = 0
+        var strokeMiterlimit: CGFloat = 4
+        var fillRule: String = "nonzero"
         var linecap: String?
         var linejoin: String?
         var dashes: [CGFloat]?
         var vectorEffect: String?
+        var dominantBaseline: String?
 
         func merged(_ node: [String: Any]) -> Paint {
             var next = self
@@ -3196,10 +3337,16 @@ private final class CraftNativeSvgView: UIView {
             // Computed style wins over the component prop, matching Android
             // and the browser's cascade when both provide opacity.
             if let opacity = finite(style["opacity"] ?? props["opacity"]) { next.opacity *= opacity }
+            if let opacity = finite(value("fillOpacity")) { next.fillOpacity = opacity }
+            if let opacity = finite(value("strokeOpacity")) { next.strokeOpacity = opacity }
+            if let offset = finite(value("strokeDashoffset")) { next.strokeDashoffset = offset }
+            if let limit = finite(value("strokeMiterlimit")), limit > 0 { next.strokeMiterlimit = limit }
+            if let rule = value("fillRule") as? String { next.fillRule = rule }
             if let cap = value("strokeLinecap") as? String { next.linecap = cap }
             if let join = value("strokeLinejoin") as? String { next.linejoin = join }
             if let dashes = value("strokeDasharray") as? [Any] { next.dashes = dashes.compactMap(finite).filter { $0 >= 0 } }
             if let vectorEffect = value("vectorEffect") as? String { next.vectorEffect = vectorEffect }
+            if let baseline = value("dominantBaseline") as? String { next.dominantBaseline = baseline }
             return next
         }
 
@@ -3257,10 +3404,13 @@ private final class CraftNativeSvgView: UIView {
             default:
                 guard let path = CraftNativeSvgView.path((shape["props"] as? [String: Any])?["geometry"]) else { continue }
                 context.saveGState()
-                context.setAlpha(own.opacity)
+                path.usesEvenOddFillRule = own.fillRule == "evenodd"
                 if let fill = own.resolve(own.fill) {
+                    context.saveGState()
+                    context.setAlpha(max(0, min(1, own.opacity * own.fillOpacity)))
                     fill.setFill()
                     path.fill()
+                    context.restoreGState()
                 }
                 if let stroke = own.resolve(own.stroke), own.strokeWidth > 0 {
                     // `vector-effect="non-scaling-stroke"`: the stroke is in the
@@ -3277,10 +3427,12 @@ private final class CraftNativeSvgView: UIView {
                         line = path
                     }
                     stroke.setStroke()
+                    context.setAlpha(max(0, min(1, own.opacity * own.strokeOpacity)))
                     line.lineWidth = own.strokeWidth
+                    line.miterLimit = own.strokeMiterlimit
                     line.lineCapStyle = own.linecap == "round" ? .round : own.linecap == "square" ? .square : .butt
                     line.lineJoinStyle = own.linejoin == "round" ? .round : own.linejoin == "bevel" ? .bevel : .miter
-                    if let dashes = own.dashes, !dashes.isEmpty { line.setLineDash(dashes, count: dashes.count, phase: 0) }
+                    if let dashes = own.dashes, !dashes.isEmpty { line.setLineDash(dashes, count: dashes.count, phase: own.strokeDashoffset) }
                     line.stroke()
                 }
                 context.restoreGState()
@@ -3295,9 +3447,13 @@ private final class CraftNativeSvgView: UIView {
         let style = node["style"] as? [String: Any] ?? [:]
         let size = number(props["fontSize"]) ?? number(style["fontSize"]) ?? 12
         let weight: UIFont.Weight = (props["fontWeight"] as? String ?? style["fontWeight"] as? String).map { ["500": .medium, "600": .semibold, "700": .bold, "bold": .bold][$0] ?? .regular } ?? .regular
+        let font = UIFont.systemFont(ofSize: size, weight: weight)
+        let resolvedTextColor = paint.resolve(paint.fill) ?? UIColor.label
+        let textAlpha = max(0, min(1, paint.opacity * paint.fillOpacity))
+        let textColor = resolvedTextColor.withAlphaComponent(resolvedTextColor.cgColor.alpha * textAlpha)
         let string = NSAttributedString(string: text, attributes: [
-            .font: UIFont.systemFont(ofSize: size, weight: weight),
-            .foregroundColor: paint.resolve(paint.fill) ?? UIColor.label,
+            .font: font,
+            .foregroundColor: textColor,
         ])
         var x = number(props["x"]) ?? 0
         let y = number(props["y"]) ?? 0
@@ -3306,8 +3462,14 @@ private final class CraftNativeSvgView: UIView {
         case "end": x -= string.size().width
         default: break
         }
-        // y is the baseline, as in SVG.
-        string.draw(at: CGPoint(x: x, y: y - UIFont.systemFont(ofSize: size).ascender))
+        let baseline: CGFloat
+        switch paint.dominantBaseline {
+        case "middle", "central", "mathematical": baseline = y - (font.ascender + font.descender) / 2
+        case "hanging", "text-before-edge", "before-edge": baseline = y + font.ascender
+        case "text-after-edge", "after-edge": baseline = y + font.descender
+        default: baseline = y
+        }
+        string.draw(at: CGPoint(x: x, y: baseline - font.ascender))
     }
 
     static func path(_ value: Any?) -> UIBezierPath? {
@@ -3505,6 +3667,8 @@ private final class CraftNativeIconView: UIImageView {
 
 private final class CraftNativeTextView: UITextView {
     private let placeholderLabel = UILabel()
+    private var nativeTextContainerInset: UIEdgeInsets?
+    private var nativeLineFragmentPadding: CGFloat?
     var placeholder: String? {
         didSet { refreshPlaceholder() }
     }
@@ -3529,6 +3693,20 @@ private final class CraftNativeTextView: UITextView {
         configurePlaceholder()
     }
 
+    func applyAuthoredPadding(_ padding: UIEdgeInsets) {
+        if nativeTextContainerInset == nil {
+            nativeTextContainerInset = textContainerInset
+            nativeLineFragmentPadding = textContainer.lineFragmentPadding
+        }
+        if padding == .zero {
+            textContainerInset = nativeTextContainerInset ?? .zero
+            textContainer.lineFragmentPadding = nativeLineFragmentPadding ?? 0
+        } else {
+            textContainerInset = padding
+            textContainer.lineFragmentPadding = 0
+        }
+    }
+
     override func layoutSubviews() {
         super.layoutSubviews()
         let inset = textContainerInset
@@ -3582,6 +3760,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private var handlers: [ObjectIdentifier: String] = [:]
     private var pressInHandlers: [ObjectIdentifier: String] = [:]
     private var pressOutHandlers: [ObjectIdentifier: String] = [:]
+    private var underlayShowHandlers: [ObjectIdentifier: String] = [:]
+    private var underlayHideHandlers: [ObjectIdentifier: String] = [:]
     private var focusHandlers: [ObjectIdentifier: String] = [:]
     private var blurHandlers: [ObjectIdentifier: String] = [:]
     private var endEditingHandlers: [ObjectIdentifier: String] = [:]
@@ -3607,6 +3787,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private var imageSources: [ObjectIdentifier: String] = [:]
     private var imageTasks: [ObjectIdentifier: URLSessionDataTask] = [:]
     private var imageErrors: [ObjectIdentifier: String] = [:]
+    /// Text inputs retain UIKit's generated accessibility value unless the
+    /// bundle authored one; remember that distinction so removing the prop
+    /// restores the native value instead of leaving stale metadata behind.
+    private var authoredAccessibilityValues = Set<ObjectIdentifier>()
     private var checkboxIndeterminate: [ObjectIdentifier: Bool] = [:]
     private var tintedImages = Set<ObjectIdentifier>()
     private var imageLoadStartHandlers: [ObjectIdentifier: String] = [:]
@@ -5138,6 +5322,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             // reads the node's new layout style on its next pass.
             CraftNativeFlexLayout.invalidateAncestors(of: next.view)
         }
+        if !applied.isEmpty {
+            // A targeted mutation can change geometry without causing UIKit
+            // to call viewDidLayoutSubviews again. Keep onLayout delivery
+            // aligned with Android's post-mutation layout pass.
+            scheduleLayoutEvents()
+        }
         restoreFocus(focused)
         return true
     }
@@ -5406,17 +5596,23 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             }
         case "Picker":
             let picker = result as! UIPickerView
-            let options = children.compactMap { child -> (value: String, label: String)? in
-                guard let node = child as? [String: Any], node["type"] as? String == "Text" else { return nil }
-                let optionProps = node["props"] as? [String: Any] ?? [:]
-                let label = (node["children"] as? [Any] ?? []).compactMap { $0 as? String }.joined()
-                guard !label.isEmpty else { return nil }
-                return (value: optionProps["value"] as? String ?? label, label: label)
-            }
+            let itemOptions = (props["items"] as? [[String: Any]])?.compactMap { item -> (value: String, label: String)? in
+                guard let label = item["label"] as? String, !label.isEmpty else { return nil }
+                return (value: craftNativePickerValue(item["value"]) ?? label, label: label)
+            } ?? []
+            let options = itemOptions.isEmpty
+                ? children.compactMap { child -> (value: String, label: String)? in
+                    guard let node = child as? [String: Any], node["type"] as? String == "Text" else { return nil }
+                    let optionProps = node["props"] as? [String: Any] ?? [:]
+                    let label = (node["children"] as? [Any] ?? []).compactMap { $0 as? String }.joined()
+                    guard !label.isEmpty else { return nil }
+                    return (value: craftNativePickerValue(optionProps["value"]) ?? label, label: label)
+                }
+                : itemOptions
             let pickerID = ObjectIdentifier(picker)
             pickerOptions[pickerID] = options
             picker.reloadAllComponents()
-            if let selected = (props["selectedValue"] as? String) ?? (props["value"] as? String),
+            if let selected = craftNativePickerValue(props["selectedValue"]) ?? craftNativePickerValue(props["value"]),
                let row = options.firstIndex(where: { $0.value == selected }) {
                 picker.selectRow(row, inComponent: 0, animated: false)
             } else if !options.isEmpty {
@@ -5492,9 +5688,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             let pressable = result as! CraftNativeFlowView
             configureStack(pressable, style: style)
             reconcileChildren(children, in: pressable, parent: current, path: path, style: style)
-            pressable.pressActiveOpacity = props["disabled"] as? Bool == true
+            let disabled = props["disabled"] as? Bool == true
+            pressable.pressActiveOpacity = disabled
                 ? 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
@@ -5614,8 +5813,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             )
         case "Map":
             let map = result as! CraftNativeMapView
+            let mapMarkerHandler = nonEmptyHandler(events["onMarkerPress"])
             map.configure(props: props, children: children) { [weak self, weak map] markerID in
-                guard let self, let map, let handler = map.markerHandlers[markerID], !handler.isEmpty else { return }
+                guard let self, let map,
+                      let handler = map.markerHandlers[markerID] ?? mapMarkerHandler else { return }
                 self.send(type: "EVENT", payload: [
                     "handlerName": handler,
                     "nativeEvent": ["id": markerID],
@@ -5649,13 +5850,15 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             let refreshNode = children.compactMap { $0 as? [String: Any] }.first {
                 canonicalType($0["type"] as? String ?? "") == "RefreshControl"
             }
-            let refreshProps = refreshNode?["props"] as? [String: Any] ?? [:]
+            let propRefresh = props["refreshControl"] as? [String: Any] ?? [:]
+            let refreshProps = refreshNode?["props"] as? [String: Any] ?? propRefresh
             let refreshEvents = refreshNode?["events"] as? [String: String] ?? [:]
             let refreshHandlerName = nonEmptyHandler(refreshEvents["onRefresh"])
                 ?? nonEmptyHandler(events["onRefresh"])
+            let refreshing = (refreshProps["refreshing"] ?? props["refreshing"]) as? Bool == true
             scroll.setRefreshHandler(refreshHandlerName.map { [weak self] handler in
                 { self?.send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
-            }, refreshing: (refreshNode == nil ? props["refreshing"] : refreshProps["refreshing"]) as? Bool == true)
+            }, refreshing: refreshing)
             scroll.setRefreshAppearance(refreshProps)
             var contentStyle = style
             if let override = props["contentContainerStyle"] as? [String: Any] {
@@ -5690,6 +5893,11 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 disabled ? nil : nonEmptyHandler(events["onPressOut"]),
                 for: result
             )
+            updateUnderlayHandlers(
+                type == "TouchableHighlight" && !disabled ? nonEmptyHandler(events["onShowUnderlay"]) : nil,
+                type == "TouchableHighlight" && !disabled ? nonEmptyHandler(events["onHideUnderlay"]) : nil,
+                for: result
+            )
             if disabled { result.isUserInteractionEnabled = false }
         }
         applyAccessibility(props, type: type, to: result)
@@ -5993,6 +6201,13 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 { self?.send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
             }
         )
+        let horizontal = props["horizontal"] as? Bool == true
+        list.showsVerticalScrollIndicator = props["showsVerticalScrollIndicator"] as? Bool ?? true
+        list.showsHorizontalScrollIndicator = props["showsHorizontalScrollIndicator"] as? Bool ?? true
+        list.isPagingEnabled = props["pagingEnabled"] as? Bool ?? false
+        list.setScrollTarget(props["scrollTarget"])
+        list.alwaysBounceVertical = props["alwaysBounceVertical"] as? Bool ?? !horizontal
+        list.alwaysBounceHorizontal = props["alwaysBounceHorizontal"] as? Bool ?? horizontal
         parent.children = []
     }
 
@@ -6045,6 +6260,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         transitionIDs.removeValue(forKey: id)
         pressInHandlers.removeValue(forKey: id)
         pressOutHandlers.removeValue(forKey: id)
+        underlayShowHandlers.removeValue(forKey: id)
+        underlayHideHandlers.removeValue(forKey: id)
         layoutHandlers.removeValue(forKey: id)
         lastLayoutFrames.removeValue(forKey: id)
         focusHandlers.removeValue(forKey: id)
@@ -6076,6 +6293,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         imageSources.removeValue(forKey: id)
         imageTasks.removeValue(forKey: id)?.cancel()
         imageErrors.removeValue(forKey: id)
+        authoredAccessibilityValues.remove(id)
         tintedImages.remove(id)
         imageLoadStartHandlers.removeValue(forKey: id)
         imageLoadHandlers.removeValue(forKey: id)
@@ -6117,6 +6335,19 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
 
     private var layoutEventsScheduled = false
 
+    /// UIView.frame is undefined while a transform is applied. onLayout is
+    /// the authored layout in the parent coordinate space, matching Android's
+    /// left/top/right/bottom values rather than the transformed visual bounds.
+    private func layoutFrame(of view: UIView) -> CGRect {
+        guard !view.transform.isIdentity else { return view.frame }
+        return CGRect(
+            x: view.center.x - view.bounds.width / 2,
+            y: view.center.y - view.bounds.height / 2,
+            width: view.bounds.width,
+            height: view.bounds.height
+        )
+    }
+
     /// A view inside the screen moved: report onLayout once the pass that
     /// moved it is over, however deep it was.
     fileprivate func scheduleLayoutEvents() {
@@ -6132,7 +6363,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private func emitLayoutEvents(for node: RenderedNode) {
         let id = ObjectIdentifier(node.view)
         if let handler = layoutHandlers[id], isEffectivelyVisible(node.view) {
-            let frame = node.view.frame
+            let frame = layoutFrame(of: node.view)
             if lastLayoutFrames[id] != frame {
                 lastLayoutFrames[id] = frame
                 send(type: "EVENT", payload: [
@@ -6205,8 +6436,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         let id = ObjectIdentifier(view)
         if let pressIn, !pressIn.isEmpty { pressInHandlers[id] = pressIn } else { pressInHandlers.removeValue(forKey: id) }
         if let pressOut, !pressOut.isEmpty { pressOutHandlers[id] = pressOut } else { pressOutHandlers.removeValue(forKey: id) }
-        guard pressInHandlers[id] != nil || pressOutHandlers[id] != nil else {
+        let hasUnderlay = (view as? CraftNativeFlowView)?.pressUnderlayColor != nil
+        guard pressInHandlers[id] != nil || pressOutHandlers[id] != nil || hasUnderlay else {
             if let recognizer = pressFeedbackRecognizers.removeValue(forKey: id) { view.removeGestureRecognizer(recognizer) }
+            if let pressable = view as? CraftNativeFlowView { pressable.backgroundColor = pressable.pressBaseBackgroundColor }
             if !ownsTouches(view) { view.isUserInteractionEnabled = handlers[id] != nil || linkTargets[id] != nil || longPressHandlers[id] != nil || view is CraftNativeFlowView }
             return
         }
@@ -6222,6 +6455,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         if !ownsTouches(view) { view.isUserInteractionEnabled = true }
     }
 
+    private func updateUnderlayHandlers(_ show: String?, _ hide: String?, for view: UIView) {
+        let id = ObjectIdentifier(view)
+        if let show, !show.isEmpty { underlayShowHandlers[id] = show } else { underlayShowHandlers.removeValue(forKey: id) }
+        if let hide, !hide.isEmpty { underlayHideHandlers[id] = hide } else { underlayHideHandlers.removeValue(forKey: id) }
+    }
+
     private func updateLongPressHandler(_ handler: String?, for view: UIView) {
         let id = ObjectIdentifier(view)
         if let handler, !handler.isEmpty {
@@ -6289,7 +6528,9 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         applyAutofill(to: textView, props: props)
         // The style's padding is where the text starts, as in a web textarea.
         let padding = paddingInsets(style)
-        if padding != .zero {
+        if let craftTextView = textView as? CraftNativeTextView {
+            craftTextView.applyAuthoredPadding(padding)
+        } else if padding != .zero {
             if textView.textContainerInset != padding { textView.textContainerInset = padding }
             textView.textContainer.lineFragmentPadding = 0
         }
@@ -6714,7 +6955,14 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     }
 
     private func updateImage(_ view: UIImageView, source: Any?, defaultSource: Any? = nil) {
-        let uri = (source as? String) ?? (source as? [String: Any])?["uri"] as? String
+        let sourceObject = source as? [String: Any]
+        let uri = (source as? String) ?? sourceObject?["uri"] as? String
+        let headers = (sourceObject?["headers"] as? [String: Any])?.reduce(into: [String: String]()) { result, entry in
+            if let value = entry.value as? String { result[entry.key] = value }
+        } ?? [:]
+        let requestKey = uri.map { value in
+            value + "\u{0}" + headers.sorted { $0.key < $1.key }.map { "\($0.key)=\($0.value)" }.joined(separator: "\u{0}")
+        }
         let id = ObjectIdentifier(view)
         guard let uri, !uri.isEmpty else {
             if imageSources[id] == "" { return }
@@ -6723,9 +6971,9 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             imageFailure(view, uri: nil, message: "Image source is missing")
             return
         }
-        guard imageSources[id] != uri else { return }
+        guard let requestKey, imageSources[id] != requestKey else { return }
         imageTasks.removeValue(forKey: id)?.cancel()
-        imageSources[id] = uri
+        imageSources[id] = requestKey
         imageErrors.removeValue(forKey: id)
         view.image = immediateImage(defaultSource).map { imageForDisplay($0, view: view) }
         imageDidChange(view)
@@ -6746,10 +6994,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             return
         }
         if let url = URL(string: uri), Self.loadsImage(from: url) {
-            let task = URLSession.shared.dataTask(with: url) { [weak self, weak view] data, _, _ in
+            var request = URLRequest(url: url)
+            for (name, value) in headers { request.setValue(value, forHTTPHeaderField: name) }
+            let task = URLSession.shared.dataTask(with: request) { [weak self, weak view] data, _, _ in
                 guard let self, let view else { return }
                 DispatchQueue.main.async {
-                    guard self.imageSources[ObjectIdentifier(view)] == uri else { return }
+                    guard self.imageSources[ObjectIdentifier(view)] == requestKey else { return }
                     self.imageTasks.removeValue(forKey: ObjectIdentifier(view))
                     guard let data, let image = UIImage(data: data) else {
                         self.imageFailure(view, uri: uri, message: "Image download failed")
@@ -6823,11 +7073,17 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     }
 
     private func applyAccessibility(_ props: [String: Any], type: String, to view: UIView) {
+        let id = ObjectIdentifier(view)
         view.accessibilityLabel = (props["accessibilityLabel"] as? String)
             ?? ((type == "Image" || type == "ImageBackground") ? props["alt"] as? String : nil)
         view.accessibilityHint = props["accessibilityHint"] as? String
         if let value = props["accessibilityValue"] {
             view.accessibilityValue = (value as? String) ?? (value as? NSNumber)?.stringValue
+            authoredAccessibilityValues.insert(id)
+        } else if authoredAccessibilityValues.remove(id) != nil {
+            // Clearing an authored value lets UIKit expose the field's live
+            // value again (particularly important for TextInput).
+            view.accessibilityValue = nil
         } else if type != "TextInput" {
             view.accessibilityValue = nil
         }
@@ -7216,13 +7472,21 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         let id = ObjectIdentifier(view)
         switch sender.state {
         case .began:
-            if let pressable = view as? CraftNativeFlowView, let activeOpacity = pressable.pressActiveOpacity {
-                UIView.animate(withDuration: 0.1) { pressable.alpha = pressable.pressBaseOpacity * activeOpacity }
+            if let pressable = view as? CraftNativeFlowView {
+                if let underlayColor = pressable.pressUnderlayColor { pressable.backgroundColor = underlayColor }
+                if let activeOpacity = pressable.pressActiveOpacity {
+                    UIView.animate(withDuration: 0.1) { pressable.alpha = pressable.pressBaseOpacity * activeOpacity }
+                }
             }
             if let handler = pressInHandlers[id] { send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
+            if let handler = underlayShowHandlers[id] { send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
         case .ended, .cancelled, .failed:
-            if let pressable = view as? CraftNativeFlowView { UIView.animate(withDuration: 0.1) { pressable.alpha = pressable.pressBaseOpacity } }
+            if let pressable = view as? CraftNativeFlowView {
+                pressable.backgroundColor = pressable.pressBaseBackgroundColor
+                UIView.animate(withDuration: 0.1) { pressable.alpha = pressable.pressBaseOpacity }
+            }
             if let handler = pressOutHandlers[id] { send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
+            if let handler = underlayHideHandlers[id] { send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": [:]]) }
         default:
             break
         }

package/templates/testing/DriverTests.swift.template

@@ -4,6 +4,10 @@ import XCTest
 /// `/script`), one command a line:
 ///
 ///   launch | activate | terminate | home
+///   notifications          Home, then reveal Notification Center's Lock Screen presentation
+///   systemexpect <text> [| secs] / systemabsent <text> / systemtap <text>
+///                          assert or tap SpringBoard content, including Live Activities
+///   systemtree <name>      SpringBoard accessibility tree → shots/<name>.txt
 ///   background <secs>     Home, wait, back to the app
 ///   wait <seconds>
 ///   net offline|online
@@ -71,9 +75,10 @@ final class DriverTests: XCTestCase {
         XCTAssertTrue(ok, what)
     }
 
-    func element(containing text: String) -> XCUIElement? {
+    func element(containing text: String, in target: XCUIApplication? = nil) -> XCUIElement? {
+        let root = target ?? app
         let predicate = NSPredicate(format: "label CONTAINS[c] %@ OR value CONTAINS[c] %@ OR identifier == %@", text, text, text)
-        for query in [app.buttons, app.links, app.staticTexts, app.otherElements, app.cells, app.textFields] {
+        for query in [root.buttons, root.links, root.staticTexts, root.otherElements, root.cells, root.textFields] {
             let matches = query.matching(predicate)
             let count = min(matches.count, 25)
             for index in 0..<count {
@@ -81,7 +86,7 @@ final class DriverTests: XCTestCase {
                 if candidate.exists && candidate.isHittable { return candidate }
             }
         }
-        let any = app.descendants(matching: .any).matching(predicate).firstMatch
+        let any = root.descendants(matching: .any).matching(predicate).firstMatch
         return any.exists ? any : nil
     }
 
@@ -141,6 +146,9 @@ final class DriverTests: XCTestCase {
     }
 
     func answerOpenPrompt() {
+        // A direct app link has already arrived. Querying an invisible
+        // SpringBoard here can stall its accessibility snapshot on iOS 27.
+        if app.wait(for: .runningForeground, timeout: 2) { return }
         let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
         let open = springboard.buttons["Open"]
         if open.waitForExistence(timeout: 4) { open.tap() }
@@ -172,6 +180,27 @@ final class DriverTests: XCTestCase {
         case "activate": app.activate()
         case "terminate": app.terminate()
         case "home": XCUIDevice.shared.press(.home)
+        case "notifications":
+            XCUIDevice.shared.press(.home)
+            let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
+            let start = springboard.coordinate(withNormalizedOffset: CGVector(dx: 0.1, dy: 0.005))
+            let end = springboard.coordinate(withNormalizedOffset: CGVector(dx: 0.1, dy: 0.85))
+            start.press(forDuration: 0.1, thenDragTo: end)
+            note("notifications: opened")
+        case "systemexpect":
+            let (text, seconds) = split(arg)
+            let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
+            check(poll(seconds, { element(containing: text, in: springboard) }) != nil, "systemexpect \(text)")
+        case "systemabsent":
+            let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
+            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") }
+            else { XCTFail("System element not found"); note("FAIL systemtap \(arg): NOT FOUND") }
+        case "systemtree":
+            let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
+            post("/save?name=\(arg).txt", Data(springboard.debugDescription.utf8))
         case "background":
             XCUIDevice.shared.press(.home)
             Thread.sleep(forTimeInterval: Double(arg) ?? 3)