craft-native 0.0.251 → 0.0.262

package/dist/ios/templates/CraftNativeScreen.swift

@@ -1090,6 +1090,8 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
     private var playingObservation: NSKeyValueObservation?
     private var timeObserver: Any?
     private var loops = false
+    private var requestedTime: Double?
+    private var pendingSeek: Double?
     private var wasPlaying: Bool?
     private var playIntent: Bool?
     private var userPaused = false
@@ -1097,7 +1099,8 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
     /// This video holds a claim on the audio session (`CraftNativeSounds`).
     private var claimedSession = false
     /// The screen's handlers by event name (`onEnd`, `onPlay`, `onPause`,
-    /// `onProgress`, `onLoad`, `onError`), and how an event reaches them.
+    /// `onProgress`, `onLoadStart`, `onLoad`, `onLoadEnd`, `onError`), and how
+    /// an event reaches them.
     var handlers: [String: String] = [:]
     var emit: ((_ handler: String, _ nativeEvent: [String: Any]) -> Void)?
 
@@ -1170,8 +1173,21 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
         CraftNativeSounds.releaseSession()
     }
 
-    func configure(source: Any?, autoplay: Bool, paused: Bool, loop: Bool, muted: Bool, controls: Bool, resizeMode: String?, pictureInPicture: Bool = false) {
+    private func applyPendingSeek() {
+        guard let target = pendingSeek, let player, let item = player.currentItem, item.status == .readyToPlay else { return }
+        let current = seconds(player.currentTime())
+        pendingSeek = nil
+        guard abs(current - target) > 0.25 else { return }
+        player.seek(to: CMTime(seconds: target, preferredTimescale: 600))
+    }
+
+    func configure(source: Any?, autoplay: Bool, paused: Bool, loop: Bool, muted: Bool, currentTime: Any?, controls: Bool, resizeMode: String?, pictureInPicture: Bool = false) {
         let uri = (source as? String) ?? (source as? [String: Any])?["uri"] as? String ?? ""
+        let nextTime = number(currentTime).map(Double.init).map { max(0, $0) }
+        if nextTime != requestedTime {
+            requestedTime = nextTime
+            pendingSeek = nextTime
+        }
         let nextShouldPlay = autoplay && !paused
         if playIntent != nextShouldPlay {
             userPaused = false
@@ -1184,6 +1200,7 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
             userPaused = false
             ended = false
             loops = false
+            pendingSeek = requestedTime
             // The copy `craft.media.keep` put on the phone plays in place of
             // the address, so a kept video plays with no signal.
             let kept = CraftNativeMedia.local(uri)
@@ -1200,11 +1217,13 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
                 return
             }
             let next = AVPlayer(url: url)
+            fire("onLoadStart")
             player = next
             playerController.player = next
             observe(next)
         }
         guard let player else { return }
+        applyPendingSeek()
         player.isMuted = muted
         // A muted video makes no sound, so it leaves the session as it is.
         if muted { releaseSession() } else { claimSession() }
@@ -1258,7 +1277,10 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
                 DispatchQueue.main.async {
                     guard let self, self.player?.currentItem === item else { return }
                     switch item.status {
-                    case .readyToPlay: self.fire("onLoad", ["duration": self.seconds(item.duration)])
+                    case .readyToPlay:
+                        self.applyPendingSeek()
+                        self.fire("onLoad", ["duration": self.seconds(item.duration)])
+                        self.fire("onLoadEnd")
                     case .failed: self.fire("onError", ["message": item.error?.localizedDescription ?? "The video could not be played"])
                     default: break
                     }
@@ -1306,6 +1328,8 @@ private final class CraftNativeVideoView: UIView, AVPlayerViewControllerDelegate
         playerController.player = nil
         playerController.delegate = nil
         sourceURI = ""
+        requestedTime = nil
+        pendingSeek = nil
         playIntent = nil
         userPaused = false
         ended = false
@@ -2022,6 +2046,8 @@ private struct CraftNativeLayoutStyle {
     let bottom: CGFloat?
     let left: CGFloat?
     let alignSelf: String?
+    /// CSS/Yoga order; equal values retain source order.
+    let order: Int
     let flexGrow: CGFloat
     /// Nil when the style does not say: the parent picks the default for the
     /// kind of view (text shrinks along a row, a box does not).
@@ -2059,6 +2085,7 @@ private struct CraftNativeLayoutStyle {
         left = number(raw["left"])
         let align = raw["alignSelf"] as? String
         alignSelf = align == "auto" ? nil : align
+        order = number(raw["order"]).map { Int($0.rounded(.towardZero)) } ?? 0
         // `flex: n` is the web's and React Native's shorthand: a positive
         // number grows by n, shrinks, and starts from nothing, so `flex-1`
         // siblings share a row equally whatever their content.
@@ -2516,6 +2543,7 @@ final class CraftNativeCelebration {
             group.duration = 2.2 + Double(spread) * 0.45
             group.beginTime = now + Double(index % 7) * 0.018
             group.fillMode = .backwards
+            group.atDisplayRate()
             piece.add(group, forKey: "craft.celebration.particle")
         }
 
@@ -2529,6 +2557,7 @@ final class CraftNativeCelebration {
         entrance.stiffness = 160
         entrance.mass = 1
         entrance.duration = 0.95
+        entrance.atDisplayRate()
         view.layer.add(entrance, forKey: "craft.celebration.entrance")
 
         let sheen = CAGradientLayer()
@@ -2554,6 +2583,7 @@ final class CraftNativeCelebration {
         shine.animations = [sweep, light]
         shine.duration = 1.15
         shine.beginTime = now + 0.55
+        shine.atDisplayRate()
         sheen.add(shine, forKey: "craft.celebration.sweep")
         let cleanup = DispatchWorkItem { [weak self] in self?.stop() }
         self.cleanup = cleanup
@@ -2886,7 +2916,15 @@ private class CraftNativeFlowView: UIStackView {
 
     /// Children that take part in the flow: shown, not a modal overlay.
     private var visibleChildren: [UIView] {
-        flowChildren.filter { $0.superview === self && !$0.isHidden && !($0 is CraftNativeModalView) }
+        flowChildren.enumerated()
+            .filter { $0.element.superview === self && !$0.element.isHidden && !($0.element is CraftNativeModalView) }
+            .sorted {
+                if $0.element.craftLayoutStyle.order != $1.element.craftLayoutStyle.order {
+                    return $0.element.craftLayoutStyle.order < $1.element.craftLayoutStyle.order
+                }
+                return $0.offset < $1.offset
+            }
+            .map(\.element)
     }
 
     /// Builds the eligible portion of this container for the host-neutral
@@ -3088,7 +3126,8 @@ private class CraftNativeFlowView: UIStackView {
                 frames: &frames
             )
         }
-        if place, flow.count == children.count, let sharedTree = sharedTreeFrames(flow, width: width, height: height), (sharedTree.nodes.count > flow.count + 1 || grid) {
+        if place, flow.count == children.count, let sharedTree = sharedTreeFrames(flow, width: width, height: height),
+           (sharedTree.nodes.count > flow.count + 1 || grid || reverse || wrapReverse || gridAutoRows != nil || gridRows != nil) {
             frames = []
             for index in 1..<sharedTree.nodes.count {
                 guard let view = sharedTree.nodes[index].view else { continue }
@@ -3795,6 +3834,17 @@ private final class CraftNativeModalView: UIView, UIGestureRecognizerDelegate {
         didSet { blocker.backgroundColor = transparent ? .clear : UIColor.black.withAlphaComponent(0.32) }
     }
 
+    /// Existing Modal nodes block by default. A non-modal popup keeps the
+    /// screen-level overlay but lets hit testing fall through outside its
+    /// interactive content.
+    var blocksBackground = true {
+        didSet { blocker.isUserInteractionEnabled = blocksBackground }
+    }
+    /// An opt-in non-modal dismissal policy. The default popup remains
+    /// pass-through; when enabled, an outside tap is consumed and routed to
+    /// onRequestClose instead of reaching the view below.
+    var dismissOnOutsideTap = false
+
     override init(frame: CGRect) {
         super.init(frame: frame)
         isUserInteractionEnabled = true
@@ -3876,10 +3926,13 @@ private final class CraftNativeModalView: UIView, UIGestureRecognizerDelegate {
         transform = .identity
         alpha = 0
         isUserInteractionEnabled = true
+        blocksBackground = true
+        dismissOnOutsideTap = false
         onRequestClose = nil
     }
 
     func requestClose(reason: String = "backdrop") {
+        guard blocksBackground || dismissOnOutsideTap else { return }
         guard let onRequestClose else { return }
         isUserInteractionEnabled = false
         onRequestClose(reason)
@@ -3912,6 +3965,14 @@ private final class CraftNativeModalView: UIView, UIGestureRecognizerDelegate {
                 candidate = view.superview
             }
         }
+        if !blocksBackground {
+            // A dismissible popup consumes its outside hit so the close event
+            // cannot also activate the screen below. Otherwise it owns the
+            // hit only when a blocking modal is underneath it; with no modal
+            // below, the screen remains pass-through.
+            if dismissOnOutsideTap { return self }
+            return craftScreenController?.hasBlockingModalBelow(self) == true ? self : nil
+        }
         return blocker.hitTest(blocker.convert(point, from: self), with: event)
     }
 
@@ -3954,6 +4015,23 @@ func craftScrollGesture(_ gesture: UIGestureRecognizer, runsWith other: UIGestur
     return false
 }
 
+/// Scroll containers observe taps without cancelling native input focus or
+/// selection. Text views are not UIControls, and their selection subviews may
+/// have recognizers of their own, so inspect the whole ancestor chain.
+func craftHandleKeyboardTap(in container: UIView, hit: UIView?, persistTaps: String, forgetFocus: () -> Void) {
+    guard persistTaps != "always" else { return }
+    var candidate = hit
+    var onControl = false
+    while let view = candidate, view !== container {
+        if view is UITextField || view is UITextView || view is UIButton { return }
+        if view is UIControl || !(view.gestureRecognizers ?? []).isEmpty { onControl = true }
+        candidate = view.superview
+    }
+    if persistTaps == "handled", onControl { return }
+    if !onControl { forgetFocus() }
+    container.window?.endEditing(true)
+}
+
 private final class CraftNativeScrollView: UIScrollView, UIGestureRecognizerDelegate {
     let contentStack = CraftNativeFlowView()
     private let keyboardTapGesture = UITapGestureRecognizer()
@@ -4226,24 +4304,9 @@ private final class CraftNativeScrollView: UIScrollView, UIGestureRecognizerDele
     @objc private func keyboardTap() {
         guard keyboardShouldPersistTaps != "always" else { return }
         let point = keyboardTapGesture.location(in: self)
-        var hit = hitTest(point, with: nil)
-        var onControl = false
-        var onButton = false
-        while let view = hit, view !== self {
-            if view is UIButton { onButton = true }
-            if view is UIControl || !(view.gestureRecognizers ?? []).isEmpty { onControl = true; break }
-            hit = view.superview
-        }
-        if keyboardShouldPersistTaps == "handled", onControl { return }
-        // A button keeps the keyboard: its press gives the focus straight
-        // back. Ending editing first only let the keyboard's inset go while
-        // the finger was down, the button moved out from under it, and the
-        // press was lost.
-        if onButton { return }
-        // Otherwise the keyboard goes; after a tap on nothing, for good (the
-        // next render must not bring the last input back).
-        if !onControl { craftScreenController?.forgetFocusedInput() }
-        window?.endEditing(true)
+        craftHandleKeyboardTap(in: self, hit: hitTest(point, with: nil), persistTaps: keyboardShouldPersistTaps) {
+            self.craftScreenController?.forgetFocusedInput()
+        }
     }
 
     func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
@@ -4822,6 +4885,62 @@ enum CraftNativeScriptThread {
     }
 }
 
+extension CAAnimation {
+    /// Asks for the display's full rate, up to 120Hz on ProMotion. Core
+    /// Animation otherwise picks a rate for the motion and often stays at 60;
+    /// a transition or a spring the eye follows reads smoother at 120.
+    func atDisplayRate() {
+        if #available(iOS 15.0, *) { preferredFrameRateRange = CAFrameRateRange(minimum: 80, maximum: 120, preferred: 120) }
+    }
+}
+
+/// `requestAnimationFrame` for native screens: one display link, at the
+/// display's own rate (up to 120Hz on a ProMotion iPhone, which the app
+/// allows with `CADisableMinimumFrameDurationOnPhone`), running only while a
+/// screen on display is waiting for a frame. Each frame hands every waiting
+/// screen one `__craftNativeFireFrame`, where its script runs; a screen asks
+/// again for the frame after, as a browser's page does. A screen out of sight
+/// waits until it is shown, as a browser pauses a hidden tab's frames, and as
+/// Craft's Android host does (Choreographer). Main thread only.
+final class CraftNativeFrameClock: NSObject {
+    static let shared = CraftNativeFrameClock()
+
+    private var waiting: [ObjectIdentifier: () -> Void] = [:]
+    private var link: CADisplayLink?
+
+    /// How many screens wait for the next frame.
+    var waitingCount: Int { waiting.count }
+    /// Whether the display link is counting frames now.
+    var isRunning: Bool { link.map { !$0.isPaused } ?? false }
+
+    /// `deliver` on the next frame, once. Asking again before it comes keeps one.
+    func request(_ owner: AnyObject, _ deliver: @escaping () -> Void) {
+        waiting[ObjectIdentifier(owner)] = deliver
+        if link == nil {
+            let link = CADisplayLink(target: self, selector: #selector(frame(_:)))
+            if #available(iOS 15.0, *) {
+                link.preferredFrameRateRange = CAFrameRateRange(minimum: 30, maximum: 120, preferred: 120)
+            }
+            link.add(to: .main, forMode: .common)
+            self.link = link
+        }
+        link?.isPaused = false
+    }
+
+    /// `owner` no longer waits: it went out of sight or away.
+    func cancel(_ owner: AnyObject) {
+        waiting.removeValue(forKey: ObjectIdentifier(owner))
+        if waiting.isEmpty { link?.isPaused = true }
+    }
+
+    @objc private func frame(_ link: CADisplayLink) {
+        let due = waiting
+        waiting.removeAll()
+        if waiting.isEmpty { link.isPaused = true }
+        due.values.forEach { $0() }
+    }
+}
+
 /// The native screens' JavaScript. A screen is a JavaScriptCore context of
 /// its own and evaluates the whole file it is given, so each route has a file
 /// of its own when stx wrote one (`dist/native-screens/<route>.js`, stx's
@@ -4898,6 +5017,25 @@ enum CraftNativeBundle {
     }
 }
 
+private final class CraftNativeScreenRootView: UIView {
+    weak var controller: CraftNativeScreenController?
+
+    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        // A popup's host frame is only its authored card, so UIKit would not
+        // ask it about an outside point. Shield that point at the screen root
+        // only when a blocking modal is underneath; ordinary non-modal
+        // overlays remain pass-through.
+        if let controller {
+            for modal in controller.view.subviews.compactMap({ $0 as? CraftNativeModalView }).reversed()
+                where !modal.blocksBackground && !modal.isHidden && modal.alpha > 0.01 {
+                let local = modal.convert(point, from: self)
+                if !modal.bounds.contains(local) && (modal.dismissOnOutsideTap || controller.hasBlockingModalBelow(modal)) { return modal }
+            }
+        }
+        return super.hitTest(point, with: event)
+    }
+}
+
 final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate, UITextFieldDelegate, UITextViewDelegate, UIPickerViewDataSource, UIPickerViewDelegate {
     private final class RenderedNode {
         /// A recycled list row's root takes the identity of the row it shows next.
@@ -4950,6 +5088,10 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private var scrollMomentumEndHandlers: [ObjectIdentifier: String] = [:]
     private var sliderCompleteHandlers: [ObjectIdentifier: String] = [:]
     private var sliderSteps: [ObjectIdentifier: Float] = [:]
+    /// A controlled switch can be reconciled while UIKit is still animating
+    /// the user's tap. Remember that native value briefly so the echo does not
+    /// interrupt the animation and leave the thumb painted at its old edge.
+    private var switchUserValues: [ObjectIdentifier: Bool] = [:]
     private var pickerOptions: [ObjectIdentifier: [(value: String, label: String)]] = [:]
     private var modalVisibility: [ObjectIdentifier: Bool] = [:]
     private var modalFocusRestore: [ObjectIdentifier: UIView] = [:]
@@ -5024,6 +5166,9 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         var pending: [Int: DispatchWorkItem] = [:]
     }
     private let timers = Timers()
+    /// The script asked for an animation frame it has not had yet
+    /// (`requestAnimationFrame`, CraftNativeFrameClock). Main thread only.
+    private var frameWanted = false
     private var lifecycleObservers: [NSObjectProtocol] = []
     private var deepLinkListener: UUID?
     private var keyboardSafeAreaInset: CGFloat = 0
@@ -5054,6 +5199,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         fatalError("init(coder:) has not been implemented")
     }
 
+    override func loadView() {
+        let root = CraftNativeScreenRootView()
+        root.controller = self
+        view = root
+    }
+
     deinit {
         disposeRuntime()
         imageTasks.values.forEach { $0.cancel() }
@@ -5200,6 +5351,23 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         CraftChrome.shared.updateTabAccessory(tabAccessory, owner: self)
     }
 
+    /// `requestAnimationFrame`: the next display frame, for a screen on display
+    /// (or the app script, which is never shown). One out of sight keeps the
+    /// request until it is shown again (screenVisibilityChanged).
+    private func requestFrame() {
+        guard !runtimeDisposed, !frameWanted else { return }
+        frameWanted = true
+        guard isAppScript || reportedVisible != false else { return }
+        CraftNativeFrameClock.shared.request(self) { [weak self] in self?.fireFrame() }
+    }
+
+    private func fireFrame() {
+        guard frameWanted, !runtimeDisposed else { return }
+        frameWanted = false
+        let context = jsContext
+        CraftNativeScriptThread.run { context.objectForKeyedSubscript("__craftNativeFireFrame")?.call(withArguments: []) }
+    }
+
     /// The screen came on screen or went off it: a screen pushed over it was
     /// popped, or the hybrid shell switched to or away from its tab (which
     /// hides a stack rather than moving it, so UIKit says nothing). The first
@@ -5214,6 +5382,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         // preview also restores a screen that never lost focus, so restore its
         // chrome even when no new SCREEN_FOCUS event is needed.
         if visible { restoreShellChrome() }
+        if visible, frameWanted { CraftNativeFrameClock.shared.request(self) { [weak self] in self?.fireFrame() } }
+        if !visible { CraftNativeFrameClock.shared.cancel(self) }
         guard visible != reportedVisible else { return }
         let first = reportedVisible == nil
         reportedVisible = visible
@@ -5240,6 +5410,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     private func disposeRuntime() {
         guard !runtimeDisposed else { return }
         runtimeDisposed = true
+        frameWanted = false
+        CraftNativeFrameClock.shared.cancel(self)
         disposeRenderedTree()
         let context = jsContext
         CraftNativeScriptThread.run { context.objectForKeyedSubscript("__stxNativeUnmount")?.call(withArguments: []) }
@@ -5310,9 +5482,58 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             if bar.intersects(view.bounds) { insets.top = max(insets.top, bar.maxY) }
         }
         for modal in modals {
-            if modal.frame != view.bounds { modal.frame = view.bounds }
-            modal.contentInsets = insets
+            guard !modal.blocksBackground else {
+                if modal.frame != view.bounds { modal.frame = view.bounds }
+                modal.contentInsets = insets
+                continue
+            }
+
+            // Non-modal overlays are viewport children, not full-screen
+            // scrims. Their absolute style uses the same full screenViewport
+            // origin that View.measure returns. Safe-area-aware placement is
+            // owned by the caller (for example, STX's anchor/clamp logic), so
+            // an authored left/top is never shifted by an implicit inset.
+            let viewport = view.bounds
+            let style = modal.craftLayoutStyle
+            let width = style.left != nil && style.right != nil
+                ? max(0, viewport.width - (style.left ?? 0) - (style.right ?? 0))
+                : style.width?.resolve(viewport.width)
+                    ?? min(viewport.width, modal.contentStack.sizeThatFits(viewport.size).width)
+            let height = style.top != nil && style.bottom != nil
+                ? max(0, viewport.height - (style.top ?? 0) - (style.bottom ?? 0))
+                : style.height?.resolve(viewport.height)
+                    ?? min(viewport.height, modal.contentStack.sizeThatFits(viewport.size).height)
+            let x = viewport.minX + (style.left ?? (style.right.map { viewport.width - $0 - width } ?? 0))
+            let y = viewport.minY + (style.top ?? (style.bottom.map { viewport.height - $0 - height } ?? 0))
+            let frame = CGRect(x: x, y: y, width: width, height: height)
+            if modal.frame != frame { modal.frame = frame }
+            // The frame already excludes the safe area; inset the content no
+            // further or authored top/left coordinates would be shifted twice.
+            modal.contentInsets = .zero
+        }
+    }
+
+    /// A non-modal popup above a blocking modal must not leak its outside tap
+    /// to the modal's scrim and dismiss the wrong layer.
+    fileprivate func hasBlockingModalBelow(_ modal: CraftNativeModalView) -> Bool {
+        guard let index = view.subviews.firstIndex(where: { $0 === modal }) else { return false }
+        return view.subviews[..<index].contains { candidate in
+            guard let other = candidate as? CraftNativeModalView else { return false }
+            return other.blocksBackground && !other.isHidden && other.alpha > 0.01
+        }
+    }
+
+    /// The native route's Back button dismisses the top presented modal before
+    /// it pops the route, matching Android's activity back callback.
+    @discardableResult
+    func handleBackForModal() -> Bool {
+        let modal = view.subviews.reversed().compactMap { $0 as? CraftNativeModalView }.first {
+            !$0.isHidden && $0.alpha > 0.01 && ($0.blocksBackground || $0.dismissOnOutsideTap)
         }
+        guard let modal else { return false }
+        let hasHandler = modal.onRequestClose != nil
+        modal.requestClose(reason: "back")
+        return hasHandler
     }
 
     private static func safeJavaScriptString(_ value: JSValue?) -> String? {
@@ -5413,6 +5634,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         }
         jsContext.setObject(scheduleTimer, forKeyedSubscript: "craftNativeScheduleTimer" as NSString)
         jsContext.setObject(cancelTimer, forKeyedSubscript: "craftNativeCancelTimer" as NSString)
+        // The next display frame, from the script's thread; the frame itself
+        // comes back there as `__craftNativeFireFrame`.
+        let requestFrame: @convention(block) () -> Void = { [weak self] in
+            CraftNativeScriptThread.toMain { self?.requestFrame() }
+        }
+        jsContext.setObject(requestFrame, forKeyedSubscript: "craftNativeRequestFrame" as NSString)
         let capabilityJSON = inputs.capabilityJSON
         // The app's site and build, as JSON strings: the site an all-native
         // app's paths and links belong to (`devServerURL`), and the version a
@@ -5448,6 +5675,41 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         jsContext.evaluateScript(Self.nativeWebAPICompatibilityPrelude)
         installHostAPIs()
         jsContext.evaluateScript("""
+            // requestAnimationFrame on the display's frames (CraftNativeFrameClock),
+            // at its own rate, 120 a second on ProMotion: a timer guessing at 60
+            // would cap every animation a screen draws itself. One request covers
+            // every callback for the frame; a callback that throws does not stop
+            // the others, and is reported after them.
+            if (typeof globalThis.requestAnimationFrame !== 'function') {
+                (function() {
+                    var frames = [];
+                    var cancelled = new Set();
+                    var nextFrame = 0;
+                    globalThis.requestAnimationFrame = function(callback) {
+                        if (typeof callback !== 'function') return 0;
+                        var id = ++nextFrame;
+                        frames.push({ id: id, callback: callback });
+                        if (frames.length === 1) craftNativeRequestFrame();
+                        return id;
+                    };
+                    globalThis.cancelAnimationFrame = function(id) {
+                        if (frames.some(function(frame) { return frame.id === id; })) cancelled.add(id);
+                    };
+                    globalThis.__craftNativeFireFrame = function() {
+                        var due = frames;
+                        var skip = cancelled;
+                        frames = [];
+                        cancelled = new Set();
+                        var now = globalThis.performance && typeof globalThis.performance.now === 'function' ? globalThis.performance.now() : Date.now();
+                        var failures = [];
+                        for (var i = 0; i < due.length; i++) {
+                            if (skip.has(due[i].id)) continue;
+                            try { due[i].callback(now); } catch (error) { failures.push(error); }
+                        }
+                        failures.forEach(function(error) { globalThis.setTimeout(function() { throw error; }, 0); });
+                    };
+                })();
+            }
             if (typeof globalThis.setTimeout !== 'function') {
                 (function() {
                     var timers = new Map();
@@ -7326,6 +7588,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             let modal = result as! CraftNativeModalView
             let focusBeforeContent = firstResponder(in: rootStack) ?? lastFocusedInput
             modal.transparent = props["transparent"] as? Bool == true
+            modal.blocksBackground = props["nonModal"] as? Bool != true
+            modal.dismissOnOutsideTap = props["dismissOnOutsideTap"] as? Bool == true
             let visible: Bool
             if let propVisible = props["visible"] as? Bool {
                 // An explicit visible prop owns modal visibility. The
@@ -7383,7 +7647,13 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 // UIKit has already changed the value before emitting the
                 // event. Echoing it through the script must not restart its
                 // native animation.
-                if toggle.isOn != value { toggle.isOn = value }
+                let id = ObjectIdentifier(toggle)
+                if switchUserValues[id] != value, toggle.isOn != value {
+                    // Programmatic changes should settle immediately. A
+                    // native tap is handled above without touching UIKit
+                    // while its own thumb animation is in flight.
+                    toggle.setOn(value, animated: false)
+                }
             }
             toggle.isEnabled = props["disabled"] as? Bool != true
             if let track = props["trackColor"] as? [String: Any] {
@@ -7510,6 +7780,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 paused: (props["paused"] as? Bool) == true,
                 loop: (props["loop"] as? Bool) == true,
                 muted: (props["muted"] as? Bool) == true,
+                currentTime: props["currentTime"],
                 controls: (props["controls"] as? Bool) == true,
                 resizeMode: style["resizeMode"] as? String ?? props["resizeMode"] as? String,
                 pictureInPicture: (props["pictureInPicture"] as? Bool) == true
@@ -8102,6 +8373,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         imageLoadEndHandlers.removeValue(forKey: id)
         imageErrorHandlers.removeValue(forKey: id)
         checkboxIndeterminate.removeValue(forKey: id)
+        switchUserValues.removeValue(forKey: id)
         if let video = node.view as? CraftNativeVideoView { video.stop() }
         if let map = node.view as? CraftNativeMapView { map.destroy() }
         for child in node.children { forgetHandlers(child, preservingInputDrafts: preservingInputDrafts) }
@@ -9084,7 +9356,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         let hasLinkTarget = ["href", "to"].contains { !(props[$0] as? String ?? "").isEmpty }
         let linkedControl = ["Link", "TouchableOpacity", "TouchableHighlight", "Pressable"].contains(type) && hasLinkTarget
         let touchable = ["TouchableOpacity", "TouchableHighlight", "Pressable"].contains(type)
-        let role = (props["accessibilityRole"] as? String) ?? (linkedControl ? "link" : touchable ? "button" : nil)
+        let role = (props["accessibilityRole"] as? String)
+            ?? (linkedControl ? "link" : touchable ? "button" : ["FlatList", "SectionList"].contains(type) ? "list" : nil)
         // A scroll view, a list or a group of controls holds what VoiceOver
         // reads: its label names the group, as a tab strip or a pager's
         // name, and never stands in for its content. As an element of its
@@ -9279,7 +9552,13 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     }
 
     @objc private func switchChanged(_ sender: UISwitch) {
-        guard let handler = handlers[ObjectIdentifier(sender)] else { return }
+        let id = ObjectIdentifier(sender)
+        switchUserValues[id] = sender.isOn
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.35) { [weak self, weak sender] in
+            guard let self, let sender, self.switchUserValues[id] == sender.isOn else { return }
+            self.switchUserValues.removeValue(forKey: id)
+        }
+        guard let handler = handlers[id] else { return }
         send(type: "EVENT", payload: ["handlerName": handler, "nativeEvent": ["value": sender.isOn]])
     }
 
@@ -9960,6 +10239,7 @@ extension CraftNativeScreenController {
             }
             animation.fromValue = from
             let key = "\(CraftNativeRunningAnimation.key).\(keyPath)"
+            animation.atDisplayRate()
             layer.add(animation, forKey: key)
             running.layers.append((layer, key))
         }

package/dist/ios/templates/testing/DriverTests.swift.template

@@ -68,6 +68,26 @@ final class DriverTests: XCTestCase {
         return result
     }
 
+    /// The journey, from the runner's control server, asked for again
+    /// until a minute has passed.
+    ///
+    /// The server is up before the test starts, but a freshly created
+    /// simulator's first request can outlast one wait: the first journey of
+    /// a CI run spent 15s on it and failed before doing anything. XCTWaiter
+    /// reports a timeout instead of failing the test, so a slow first answer
+    /// is retried rather than fatal.
+    func remoteScript(seconds: Double = 60) -> Data? {
+        let end = Date().addingTimeInterval(seconds)
+        repeat {
+            var result: Data?
+            let done = XCTestExpectation(description: "/script")
+            URLSession.shared.dataTask(with: URL(string: control + "/script")!) { data, _, _ in result = data; done.fulfill() }.resume()
+            if XCTWaiter().wait(for: [done], timeout: 15) == .completed, let result, !result.isEmpty { return result }
+            Thread.sleep(forTimeInterval: 1)
+        } while Date() < end
+        return nil
+    }
+
     func post(_ path: String, _ body: Data) {
         if bundledJourney {
             guard path.hasPrefix("/save?"),
@@ -246,7 +266,7 @@ final class DriverTests: XCTestCase {
             bundledJourney = true
             data = try Data(contentsOf: resource)
         } else {
-            data = get("/script")
+            data = remoteScript()
         }
         guard let data, let script = String(data: data, encoding: .utf8) else {
             XCTFail("no script")

package/dist/mobile-media-testing.d.ts

@@ -11,6 +11,8 @@ export interface MobileMediaCacheTestOptions {
     online?: boolean;
     log?: (line: string) => void;
 }
+/** Keep the probe on the complete shipped downloader, including its durable worker. */
+export declare function androidMediaProbeSource(shell: string): string;
 /** Real ENOSPC, cache cleanup, retry, coalescing and offline video decode on an isolated native probe. */
 export declare function verifyMobileMediaCache(options: MobileMediaCacheTestOptions): Promise<{
     platform: string;