craft-native 0.0.424 → 0.0.436

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

@@ -42,7 +42,7 @@ import Darwin
 ///   tabbar shown|hidden   the native tab bar (Today, Calendar, …) can be tapped, or not
 ///   selected <tab>        the tab bar's selected button is this one
 ///   tab <name>            tap a tab bar button
-///   scrollto <text>       swipes up (at most 8 times) until text is hittable
+///   scrollto <text>       at most 12 drags until the target is hittable and visible
 ///   swipe up|down|left|right
 ///   drag x1 y1 x2 y2     slow app-relative drag, held 0.3s before release
 ///   audit <name>          accessibility audit (element descriptions, Dynamic Type, contrast); logs each issue
@@ -143,13 +143,29 @@ final class DriverTests: XCTestCase {
         return any.exists ? any : nil
     }
 
+    /// Where a label is looked for, in order: the topmost presented alert,
+    /// then the topmost sheet, then the whole app. A sheet's "Sign out" and
+    /// the row that opened it share a label, and the row behind the sheet
+    /// is still reported hittable, so the presented one has to win.
+    func searchScopes<Scope>(alerts: [Scope], sheets: [Scope], app: Scope) -> [Scope] {
+        [alerts.last, sheets.last].compactMap { $0 } + [app]
+    }
+
+    func presentedScopes() -> [XCUIElement] {
+        let alerts = app.alerts.allElementsBoundByIndex.filter { $0.exists }
+        let sheets = app.sheets.allElementsBoundByIndex.filter { $0.exists }
+        return searchScopes(alerts: alerts, sheets: sheets, app: app as XCUIElement)
+    }
+
     func exact(_ label: String) -> XCUIElement? {
         let predicate = NSPredicate(format: "label == %@", label)
-        for query in [app.buttons, app.links, app.staticTexts] {
-            let matches = query.matching(predicate)
-            for index in 0..<min(matches.count, 25) {
-                let candidate = matches.element(boundBy: index)
-                if candidate.exists && candidate.isHittable { return candidate }
+        for scope in presentedScopes() {
+            for query in [scope.buttons, scope.links, scope.staticTexts] {
+                let matches = query.matching(predicate)
+                for index in 0..<min(matches.count, 25) {
+                    let candidate = matches.element(boundBy: index)
+                    if candidate.exists && candidate.isHittable { return candidate }
+                }
             }
         }
         return nil
@@ -164,6 +180,27 @@ final class DriverTests: XCTestCase {
         return nil
     }
 
+    /// A short target fits entirely; an oversized target fills the viewport.
+    func visibleScrollFrame(_ target: CGRect, in viewport: CGRect) -> Bool {
+        let visible = target.intersection(viewport)
+        return !target.isEmpty && !viewport.isEmpty && !visible.isNull
+            && visible.width >= min(target.width, viewport.width)
+            && visible.height >= min(target.height, viewport.height)
+    }
+
+    func scrollTargetVisible(_ target: XCUIElement?) -> Bool {
+        guard let target, target.exists, target.isHittable,
+              visibleScrollFrame(target.frame, in: app.frame) else { return false }
+        // Hittable alone accepts controls clipped by the scroll view's edge.
+        // Only an ancestor scroll view clips this target, not its siblings.
+        let identity = NSPredicate(format: "identifier == %@ AND label == %@", target.identifier, target.label)
+        for scroll in app.scrollViews.allElementsBoundByIndex {
+            if scroll.descendants(matching: .any).matching(identity).firstMatch.exists,
+               !visibleScrollFrame(target.frame, in: scroll.frame.intersection(app.frame)) { return false }
+        }
+        return true
+    }
+
     /// About a third of a screen of scrolling, as a held drag.
     ///
     /// `app.swipeUp()` is a flick, and how far a flick throws a scroll view
@@ -248,8 +285,15 @@ final class DriverTests: XCTestCase {
         return (parts[0], parts.count > 1 ? Double(parts[1]) ?? 10 : 10)
     }
 
-    /// A tap that never fails the run: an element covered a moment (the big
-    /// timer coming up) is tapped where it is, and the check after says.
+    /// A switch reports "0" or "1". Any other value is not a switch state to
+    /// wait on, so the tap stands as it would for any other control.
+    func switchFlipped(from before: String?, to after: String?) -> Bool {
+        let states: Set<String> = ["0", "1"]
+        guard let before, let after, states.contains(before), states.contains(after) else { return true }
+        return before != after
+    }
+
+    /// Deliver one gesture; the command's observation determines success.
     func press(_ element: XCUIElement) {
         if element.isHittable { element.tap() }
         else { element.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap() }
@@ -401,8 +445,21 @@ final class DriverTests: XCTestCase {
             else { XCTFail("Element not found"); note("FAIL tapexact \(arg): NOT FOUND") }
         case "tapid":
             let target = identified(arg)
-            if target.waitForExistence(timeout: 10) { press(target); note("tapid \(arg): ok") }
-            else { XCTFail("Element not found"); note("FAIL tapid \(arg): NOT FOUND") }
+            if !target.waitForExistence(timeout: 10) { XCTFail("Element not found"); note("FAIL tapid \(arg): NOT FOUND") }
+            else if target.elementType == .switch {
+                // Observe one physical gesture. Retapping could conceal a
+                // renderer or hit-testing failure (HQ agreement job 7570).
+                let before = target.value as? String
+                press(target)
+                let settle = Date().addingTimeInterval(1.5)
+                var flipped = false
+                repeat {
+                    flipped = switchFlipped(from: before, to: target.value as? String)
+                    if !flipped { Thread.sleep(forTimeInterval: 0.25) }
+                } while !flipped && Date() < settle
+                check(flipped, "tapid \(arg) flips the switch")
+            }
+            else { press(target); note("tapid \(arg): ok") }
         case "longpressid":
             let target = identified(arg)
             guard target.waitForExistence(timeout: 10), target.isHittable else {
@@ -590,13 +647,13 @@ final class DriverTests: XCTestCase {
         case "scrollto":
             var found = element(containing: arg)
             var drags = 0
-            while (found == nil || !(found!.isHittable)) && drags < 12 {
+            while !scrollTargetVisible(found) && drags < 12 {
                 let towardTop = found.map { !$0.frame.isEmpty && $0.frame.midY < app.frame.midY } ?? false
                 scrollPage(towardTop: towardTop)
                 drags += 1
                 found = element(containing: arg)
             }
-            check(found != nil && found!.isHittable, "scrollto \(arg)")
+            check(scrollTargetVisible(found), "scrollto \(arg)")
         case "swipe":
             switch arg {
             case "up": app.swipeUp()
@@ -644,7 +701,9 @@ final class DriverTests: XCTestCase {
             // A system prompt over the app ("Save Password?" → Not Now), wherever iOS shows it.
             let label = arg.isEmpty ? "Not Now" : arg
             let springboard = XCUIApplication(bundleIdentifier: "com.apple.springboard")
-            let candidates = [app.buttons[label], springboard.buttons[label]]
+            // The app's own alert or sheet first (its button can share a
+            // label with the control behind it), then the app, then iOS.
+            let candidates = { self.presentedScopes().map { $0.buttons[label] } + [springboard.buttons[label]] }
             let end = Date().addingTimeInterval(6)
             // A tap is not a dismissal. iOS 26 draws "Save Password?" as a
             // sheet that is in the tree, and hittable, while it still slides
@@ -655,7 +714,7 @@ final class DriverTests: XCTestCase {
             var tapped = false
             var gone = false
             while !gone && Date() < end {
-                guard let button = candidates.first(where: { $0.exists && $0.isHittable }) else {
+                guard let button = candidates().first(where: { $0.exists && $0.isHittable }) else {
                     if tapped { gone = true } else { Thread.sleep(forTimeInterval: 0.5) }
                     continue
                 }

package/dist/macos/src/index.js

@@ -43,9 +43,9 @@ import process from "process";
 var macosToolchain = {
   zig: "0.18.0-dev.252+86dc5ce25",
   sources: {
-    "zig-js": { repository: "zig-utils/zig-js", revision: "a6739721273ae0f13d36fb3422052a588c5079a8", paths: ["src", "include", "tests", "tools", "docs", "bench", "conformance"] },
+    "zig-js": { repository: "zig-utils/zig-js", revision: "44a0a2ba814a911ac701c44073bd8d7d8ff6a22d", paths: ["src", "include", "tests", "tools", "docs", "bench", "conformance"] },
     "zig-regex": { repository: "zig-utils/zig-regex", revision: "fdd9c2e333ea6ac2fd06d080d939ef7f11d61b1b", paths: ["src"] },
-    "zig-gc": { repository: "zig-utils/zig-gc", revision: "0285ef801dd221a4ae8e88b31a09ae31627657a3", paths: ["src"] }
+    "zig-gc": { repository: "zig-utils/zig-gc", revision: "73c802e05768a729614e9c4296abb118aa06faf9", paths: ["src"] }
   }
 };
 var defaultRun = async (args, cwd) => {

package/dist/macos/src/toolchain.d.ts

@@ -9,7 +9,7 @@ export declare const macosToolchain: {
     readonly sources: {
         readonly 'zig-js': {
             readonly repository: 'zig-utils/zig-js';
-            readonly revision: 'a6739721273ae0f13d36fb3422052a588c5079a8';
+            readonly revision: '44a0a2ba814a911ac701c44073bd8d7d8ff6a22d';
             readonly paths: readonly ['src', 'include', 'tests', 'tools', 'docs', 'bench', 'conformance'];
         };
         readonly 'zig-regex': {
@@ -19,7 +19,7 @@ export declare const macosToolchain: {
         };
         readonly 'zig-gc': {
             readonly repository: 'zig-utils/zig-gc';
-            readonly revision: '0285ef801dd221a4ae8e88b31a09ae31627657a3';
+            readonly revision: '73c802e05768a729614e9c4296abb118aa06faf9';
             readonly paths: readonly ['src'];
         };
     };

package/dist/macos/templates/CraftMacApplication.swift

@@ -21,6 +21,8 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
     let trafficLights: CGPoint?
     /// The screen has work to finish before the app quits (`craft.desktop.onQuit`).
     var holdsQuit = false
+    /// The content width the screen last heard, so a resize that changes nothing sends nothing.
+    var reportedViewportWidth: CGFloat = -1
     init(name: String, route: String, options: [String: Any], application: CraftMacApplication) {
         self.name = name
         runtime = CraftMacRuntime(route: route, params: options["params"] as? [String: Any] ?? [:], network: application.network)
@@ -49,9 +51,22 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
         if name == "main" && application.testDirectory == nil { window.setFrameAutosaveName("\(application.appName)NativeMain") }
         window.makeKeyAndOrderFront(nil)
         placeTrafficLights()
+        // The screen starts knowing its width, so `md:`/`lg:` classes and `matchMedia` are right on the first frame.
+        let size = window.contentLayoutRect.size
+        reportedViewportWidth = size.width
+        runtime.context.evaluateScript("__stxNativeBridge.viewportWidth = \(Double(size.width)); __stxNativeBridge.viewportHeight = \(Double(size.height));")
         runtime.load(application.bundle)
     }
 
+    /// Tells the screen its new width (VIEWPORT, as a phone does on rotation): only when the width changed,
+    /// since a live resize lays out every frame.
+    func reportViewport() {
+        let size = window.contentLayoutRect.size
+        guard size.width > 0, abs(size.width - reportedViewportWidth) >= 0.5 else { return }
+        reportedViewportWidth = size.width
+        runtime.send("VIEWPORT", ["width": Double(size.width), "height": Double(size.height)])
+    }
+
     /// AppKit lays the title bar out again on resize, full screen and appearance changes, so this runs after each.
     func placeTrafficLights() {
         guard let inset = trafficLights, let close = window.standardWindowButton(.closeButton), let titlebar = close.superview?.superview else { return }
@@ -64,8 +79,8 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
             window.standardWindowButton(type)?.setFrameOrigin(CGPoint(x: inset.x + CGFloat(index) * (size.width + 6), y: (height - size.height) / 2))
         }
     }
-    func windowDidResize(_ notification: Notification) { placeTrafficLights() }
-    func windowDidExitFullScreen(_ notification: Notification) { placeTrafficLights() }
+    func windowDidResize(_ notification: Notification) { placeTrafficLights(); reportViewport() }
+    func windowDidExitFullScreen(_ notification: Notification) { placeTrafficLights(); reportViewport() }
     func windowShouldClose(_ sender: NSWindow) -> Bool {
         if name == "main" { sender.orderOut(nil); return false }
         return true
@@ -213,6 +228,9 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
         defer { CATransaction.commit() }
         let scheme = CraftMacColor.isDark ? "dark" : "light"
         for scene in scenes.values {
+            // AppKit lays the title bar out again for the new appearance, after this returns.
+            scene.placeTrafficLights()
+            DispatchQueue.main.async { [weak scene] in scene?.placeTrafficLights() }
             scene.runtime.context.evaluateScript("__stxNativeBridge.colorScheme = '\(scheme)';")
             // The protocol's own message: the screen restyles its `dark:` classes and tells `craft.appearance.onChange`.
             scene.runtime.send("APPEARANCE", ["colorScheme": scheme])
@@ -455,7 +473,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
                   let box = scene.renderer.boxes.values.first(where: { ($0.props["testID"] as? String ?? $0.props["testId"] as? String ?? $0.id) == target }) else { return ["ok": false, "error": "No control \(action["target"] ?? "")"] }
             let text = action["text"] as? String ?? ""
             switch kind {
-            case "press": if let button = box.control as? NSButton { button.performClick(nil) } else { box.fire("onPress") }
+            case "press": if let button = box.control as? NSButton { button.performClick(nil) } else if let toggle = box.control as? NSSwitch { toggle.performClick(nil) } else { box.fire("onPress") }
             case "type":
                 if let field = box.control as? NSTextField { field.stringValue = text }
                 else if let view = (box.control as? NSScrollView)?.documentView as? NSTextView { view.string = text }
@@ -500,7 +518,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
             let editor = (target as? NSTextField)?.currentEditor() as? NSTextView ?? target as? NSTextView
             guard let editor else { return ["ok": false, "error": "Not a text input"] }
             editor.doCommand(by: command)
-        case "click": if let button = box.control as? NSButton { button.performClick(nil) } else { box.pressed() }
+        case "click": if let button = box.control as? NSButton { button.performClick(nil) } else if let toggle = box.control as? NSSwitch { toggle.performClick(nil) } else { box.pressed() }
         case "fill":
             let value = action["value"] as? String ?? ""
             if let field = box.control as? NSTextField { field.stringValue = value; box.input(value) }
@@ -536,7 +554,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
                 return node
             }
             func classes(_ view: NSView) -> [String] { [String(describing: type(of: view))] + view.subviews.flatMap(classes) }
-            return ["name": scene.name, "title": scene.window.title, "route": scene.runtime.route, "contextClass": String(describing: type(of: scene.runtime.context)), "nodes": nodes, "viewClasses": classes(scene.renderer.root), "errors": scene.runtime.errors]
+            return ["name": scene.name, "title": scene.window.title, "route": scene.runtime.route, "contextClass": String(describing: type(of: scene.runtime.context)), "nodes": nodes, "viewClasses": classes(scene.renderer.root), "viewportWidth": Double(scene.reportedViewportWidth), "errors": scene.runtime.errors]
         }
         let webViews = windows.reduce(0) { count, window in count + ((window["viewClasses"] as? [String] ?? []).filter { $0.contains("WKWebView") || $0 == "WebView" }.count) }
         return ["renderer": "appkit", "scriptEngine": "zig-js", "appearance": CraftMacColor.isDark ? "dark" : "light", "windows": windows, "webViews": webViews, "menu": testMenu]

package/dist/macos/templates/CraftMacRenderer.swift

@@ -288,6 +288,8 @@ final class CraftMacBox: NSView, NSTextFieldDelegate, NSTextViewDelegate, NSDrag
     static var measuredCount = 0
     private struct MeasureKey: Hashable { let width: CGFloat, stretch: Bool }
     private var measured: [MeasureKey: CGSize] = [:]
+    /// What this box measured is stale: it or something inside it changed (CraftMacRenderer.update).
+    func forgetMeasurements() { measured.removeAll(keepingCapacity: true) }
     private var measuredGeneration = -1
     var componentRoot: CraftMacBox? { props["data-stx-component-wrapper"] != nil && flow?.boxes.count == 1 && flow?.boxes.first?.kind != "Modal" ? flow?.boxes.first : nil }
     var layoutStyle: [String: Any] {
@@ -318,7 +320,10 @@ final class CraftMacBox: NSView, NSTextFieldDelegate, NSTextViewDelegate, NSDrag
         case "Picker":
             let picker = NSPopUpButton(frame: .zero, pullsDown: false)
             picker.target = self; picker.action = #selector(changed); control = picker
-        case "Switch", "Checkbox":
+        case "Switch":
+            // A toggle, as System Settings draws one; a checkbox is the Checkbox primitive's.
+            let toggle = NSSwitch(); toggle.target = self; toggle.action = #selector(changed); control = toggle
+        case "Checkbox":
             let button = NSButton(checkboxWithTitle: "", target: self, action: #selector(changed)); control = button
         case "Icon", "Image":
             let image = NSImageView(); image.imageScaling = .scaleProportionallyUpOrDown; control = image
@@ -407,6 +412,11 @@ final class CraftMacBox: NSView, NSTextFieldDelegate, NSTextViewDelegate, NSDrag
             text.maximumNumberOfLines = (props["numberOfLines"] as? NSNumber)?.intValue ?? 0
             text.lineBreakMode = text.maximumNumberOfLines == 1 ? .byTruncatingTail : .byWordWrapping
         }
+        if let toggle = control as? NSSwitch {
+            toggle.state = (props["value"] as? Bool ?? props["checked"] as? Bool ?? false) ? .on : .off
+            toggle.isEnabled = props["disabled"] as? Bool != true
+            if let label { toggle.setAccessibilityLabel(label) }
+        }
         if let button = control as? NSButton {
             let title = props["title"] as? String ?? nativeText(node)
             button.title = props["iconOnly"] as? Bool == true ? "" : title
@@ -811,7 +821,8 @@ final class CraftMacBox: NSView, NSTextFieldDelegate, NSTextViewDelegate, NSDrag
     func fire(_ name: String, _ payload: [String: Any] = [:]) { renderer?.runtime.event(events[name], payload: payload) }
     @objc func pressed() { fire("onPress") }
     @objc func changed() {
-        let value: Any = (control as? NSPopUpButton)?.selectedItem?.representedObject ?? ((control as? NSButton)?.state == .on)
+        let state: NSControl.StateValue? = (control as? NSSwitch)?.state ?? (control as? NSButton)?.state
+        let value: Any = (control as? NSPopUpButton)?.selectedItem?.representedObject ?? (state == .on)
         fire("onValueChange", ["value": value, "nativeEvent": ["value": value]])
     }
     func controlTextDidChange(_ notification: Notification) { if let field = notification.object as? NSTextField { input(field.stringValue) } }
@@ -957,6 +968,77 @@ final class CraftMacRenderer {
     weak var window: NSWindow?
     var sheets: [String: NSPanel] = [:]
     init(runtime: CraftMacRuntime) { self.runtime = runtime }
+    /// The box for `node`, made or reconfigured, and its children's in order; every id drawn goes into `retained`.
+    func reconcile(_ node: [String: Any], retained: inout Set<String>) -> CraftMacBox {
+        let id = node["id"] as? String ?? "root", kind = node["type"] as? String ?? "View"
+        retained.insert(id)
+        let box = boxes[id] ?? CraftMacBox(id: id, kind: kind, renderer: self)
+        boxes[id] = box; box.configure(node)
+        if let flow = box.flow, kind != "Button" {
+            let children = (node["children"] as? [Any] ?? []).compactMap { $0 as? [String: Any] }.map { reconcile($0, retained: &retained) }
+            for child in flow.boxes where !children.contains(where: { $0 === child }) { child.removeFromSuperview() }
+            flow.boxes = children
+            for child in children where child.superview !== flow && sheets[child.id] == nil { flow.addSubview(child) }
+            // `zIndex` draws a child above its siblings (an overlay over a web page), highest last.
+            let raised = children.filter { (number($0.layoutStyle["zIndex"]) ?? 0) > 0 && $0.superview === flow }
+                .sorted { (number($0.layoutStyle["zIndex"]) ?? 0) < (number($1.layoutStyle["zIndex"]) ?? 0) }
+            if !raised.isEmpty, Array(flow.subviews.suffix(raised.count)) != raised {
+                for child in raised { flow.addSubview(child, positioned: .above, relativeTo: nil) }
+            }
+        }
+        return box
+    }
+
+    /// A batch drawn where it happened rather than across the window: each changed node's subtree
+    /// (or, for a node the batch created, its nearest drawn ancestor's) is reconciled again, and only
+    /// those boxes and the boxes above them measure and lay out again. A hover on one row used to
+    /// reconfigure every view in the window and forget every measurement. False when it cannot be
+    /// done in place (nothing drawn yet, a sheet, a node changing kind): the caller renders the tree.
+    func update(_ ids: [String], parentOf: (String) -> String?, node nodeFor: (String) -> [String: Any]?) -> Bool {
+        guard !boxes.isEmpty else { return false }
+        var targets: [String] = []
+        for id in ids {
+            var current: String? = id
+            while let candidate = current, boxes[candidate] == nil { current = parentOf(candidate) }
+            guard let target = current else { return false }
+            if !targets.contains(target) { targets.append(target) }
+        }
+        // A target inside another is drawn with it.
+        let chosen = targets.filter { target in
+            guard let box = boxes[target] else { return false }
+            return !targets.contains { other in other != target && boxes[other].map { box.isDescendant(of: $0) } == true }
+        }
+        CATransaction.begin(); CATransaction.setDisableActions(true)
+        defer { CATransaction.commit() }
+        for target in chosen {
+            guard let box = boxes[target], box.window === window, sheets[target] == nil, box.kind != "Modal",
+                  let node = nodeFor(target), (node["type"] as? String ?? "View") == box.kind else { return false }
+            var before = Set<String>()
+            collectIds(box, into: &before)
+            var retained = Set<String>()
+            _ = reconcile(node, retained: &retained)
+            for id in before where !retained.contains(id) {
+                guard let gone = boxes.removeValue(forKey: id) else { continue }
+                gone.imageTask?.cancel(); gone.removeFromSuperview()
+            }
+            for id in retained { if let drawn = boxes[id] { drawn.forgetMeasurements(); drawn.needsLayout = true } }
+            var above: NSView? = box.superview
+            while let view = above {
+                (view as? CraftMacBox)?.forgetMeasurements()
+                view.needsLayout = true
+                above = view.superview
+            }
+        }
+        root.needsLayout = true
+        root.layoutSubtreeIfNeeded()
+        return true
+    }
+
+    private func collectIds(_ box: CraftMacBox, into ids: inout Set<String>) {
+        ids.insert(box.id)
+        for child in box.flow?.boxes ?? [] { collectIds(child, into: &ids) }
+    }
+
     func render(_ document: [String: Any]) {
         CATransaction.begin(); CATransaction.setDisableActions(true)
         defer { CATransaction.commit() }
@@ -967,26 +1049,7 @@ final class CraftMacRenderer {
             let bottom = bounds.maxY >= (scroll.documentView?.bounds.height ?? 0) - 8
             scrolls.append((box, bounds.origin, bottom))
         } }
-        func reconcile(_ node: [String: Any]) -> CraftMacBox {
-            let id = node["id"] as? String ?? "root", kind = node["type"] as? String ?? "View"
-            retained.insert(id)
-            let box = boxes[id] ?? CraftMacBox(id: id, kind: kind, renderer: self)
-            boxes[id] = box; box.configure(node)
-            if let flow = box.flow, kind != "Button" {
-                let children = (node["children"] as? [Any] ?? []).compactMap { $0 as? [String: Any] }.map(reconcile)
-                for child in flow.boxes where !children.contains(where: { $0 === child }) { child.removeFromSuperview() }
-                flow.boxes = children
-                for child in children where child.superview !== flow && sheets[child.id] == nil { flow.addSubview(child) }
-                // `zIndex` draws a child above its siblings (an overlay over a web page), highest last.
-                let raised = children.filter { (number($0.layoutStyle["zIndex"]) ?? 0) > 0 && $0.superview === flow }
-                    .sorted { (number($0.layoutStyle["zIndex"]) ?? 0) < (number($1.layoutStyle["zIndex"]) ?? 0) }
-                if !raised.isEmpty, Array(flow.subviews.suffix(raised.count)) != raised {
-                    for child in raised { flow.addSubview(child, positioned: .above, relativeTo: nil) }
-                }
-            }
-            return box
-        }
-        let box = reconcile(document)
+        let box = reconcile(document, retained: &retained)
         // Boxes were reconfigured and children replaced: nothing measured before now holds.
         CraftMacBox.measureGeneration &+= 1
         for (id, box) in boxes where !retained.contains(id) {

package/dist/macos/templates/CraftMacRuntime.swift

@@ -173,7 +173,37 @@ final class CraftMacRuntime {
         """)
     }
 
-    func load(_ bundle: String) { context.evaluateScript(bundle); ZJSContextRunMicrotasks(context) }
+    func load(_ bundle: String) {
+        startProfileIfAsked()
+        context.evaluateScript(bundle); ZJSContextRunMicrotasks(context)
+    }
+
+    /// `CRAFT_JS_PROFILE=<file>`: sample this screen's JavaScript from the moment its bundle loads,
+    /// for `CRAFT_JS_PROFILE_MS` milliseconds (5000, every `CRAFT_JS_PROFILE_INTERVAL_US`, 1000),
+    /// and write it as Chrome's `.cpuprofile` (DevTools and speedscope open it). A window other
+    /// than Main writes beside it, its route in the name.
+    private func startProfileIfAsked() {
+        let env = ProcessInfo.processInfo.environment
+        guard let path = env["CRAFT_JS_PROFILE"], !path.isEmpty, let ref = context.jsGlobalContextRef else { return }
+        guard ZJSContextStartCPUProfile(ref, UInt32(env["CRAFT_JS_PROFILE_INTERVAL_US"] ?? "") ?? 0) else { return }
+        let seconds = (Double(env["CRAFT_JS_PROFILE_MS"] ?? "") ?? 5000) / 1000
+        DispatchQueue.main.asyncAfter(deadline: .now() + seconds) { [weak self] in self?.writeProfile(to: path) }
+    }
+
+    private func writeProfile(to path: String) {
+        guard !disposed, let ref = context.jsGlobalContextRef, let json = ZJSContextStopCPUProfile(ref) else { return }
+        defer { JSStringRelease(json) }
+        let size = JSStringGetMaximumUTF8CStringSize(json)
+        var bytes = [CChar](repeating: 0, count: size)
+        JSStringGetUTF8CString(json, &bytes, size)
+        let url = URL(fileURLWithPath: path)
+        let target = route == "Main" ? url : url.deletingPathExtension().appendingPathExtension("\(route).cpuprofile")
+        do {
+            try String(cString: bytes).write(to: target, atomically: true, encoding: .utf8)
+            fputs("[craft] JavaScript profile written to \(target.path)\n", stderr)
+        }
+        catch { fputs("[craft] could not write the JavaScript profile to \(target.path): \(error)\n", stderr) }
+    }
 
     func dispose() {
         guard !disposed else { return }
@@ -215,7 +245,9 @@ final class CraftMacRuntime {
         case "MUTATE":
             do {
                 let result = try document.apply(payload)
-                if let tree = result.document { scene?.renderer.render(tree) }
+                // Drawn where it changed; the whole tree only when the batch reshaped it.
+                if result.requiresFullRender || scene?.renderer.update(result.affectedNodeIds, parentOf: document.parentId(of:), node: document.node) != true,
+                   let tree = result.document { scene?.renderer.render(tree) }
                 send("MUTATION_ACK", ["version": 1, "batchId": result.batchId, "revision": result.revision])
             } catch let error as CraftNativeMutationFailure {
                 send("MUTATION_ERROR", ["version": 1, "batchId": payload["batchId"] ?? "", "code": error.code, "message": error.message])

package/dist/macos/templates/CraftNativeMutation.swift

@@ -18,10 +18,22 @@ struct CraftNativeMutationFailure: Error, Equatable {
 struct CraftNativeMutationResult {
     let batchId: String
     let revision: Int
-    let document: [String: Any]?
     let updatedNodeIds: [String]
     let affectedNodeIds: [String]
     let requiresFullRender: Bool
+    private let materialize: () -> [String: Any]?
+    /// The committed tree, built when asked for: a host that redraws only the
+    /// nodes a batch touched never needs the whole tree.
+    var document: [String: Any]? { materialize() }
+
+    init(batchId: String, revision: Int, document: @escaping () -> [String: Any]?, updatedNodeIds: [String], affectedNodeIds: [String], requiresFullRender: Bool) {
+        self.batchId = batchId
+        self.revision = revision
+        self.materialize = document
+        self.updatedNodeIds = updatedNodeIds
+        self.affectedNodeIds = affectedNodeIds
+        self.requiresFullRender = requiresFullRender
+    }
 }
 
 /// Validates and applies versioned native-tree mutations without touching UIKit.
@@ -91,6 +103,8 @@ final class CraftNativeMutationDocument {
         var updatedNodeIds: [String] = []
         var affectedNodeIds: [String] = []
         var requiresFullRender = false
+        // Only an operation that adds, moves or removes nodes can leave one unreachable.
+        var reshaped = false
         for (index, value) in operations.enumerated() {
             guard let operation = value as? [String: Any], let name = operation["op"] as? String else {
                 throw CraftNativeMutationFailure(
@@ -99,6 +113,7 @@ final class CraftNativeMutationDocument {
                     operationIndex: index
                 )
             }
+            if name != "updateNode" { reshaped = true }
             do {
                 switch name {
                 case "createNode":
@@ -147,7 +162,7 @@ final class CraftNativeMutationDocument {
             guard let root = candidateNodes[candidateRoot], root.parent == nil else {
                 throw CraftNativeMutationFailure("INVALID_TREE", "root node must not have a parent")
             }
-            guard descendants(of: candidateRoot, nodes: candidateNodes).count + 1 == candidateNodes.count else {
+            guard !reshaped || descendants(of: candidateRoot, nodes: candidateNodes).count + 1 == candidateNodes.count else {
                 throw CraftNativeMutationFailure("INVALID_TREE", "all nodes must be reachable from the root")
             }
         }
@@ -158,7 +173,7 @@ final class CraftNativeMutationDocument {
         return CraftNativeMutationResult(
             batchId: batchId,
             revision: nextRevision,
-            document: candidateRoot.flatMap { materialize($0, nodes: candidateNodes) },
+            document: { [candidateRoot, candidateNodes, weak self] in candidateRoot.flatMap { self?.materialize($0, nodes: candidateNodes) } },
             updatedNodeIds: updatedNodeIds,
             affectedNodeIds: affectedNodeIds,
             requiresFullRender: requiresFullRender

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craft-native",
-  "version": "0.0.424",
+  "version": "0.0.436",
   "type": "module",
   "description": "Build desktop apps with web languages - TypeScript SDK for Craft",
   "author": "Chris Breuer <chris@stacksjs.org>",