craft-native 0.0.172 → 0.0.173

package/dist/cli.js

@@ -3303,7 +3303,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.172";
+var version = "0.0.173";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -310,7 +310,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.172";
+var version = "0.0.173";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.js

@@ -58,7 +58,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.172";
+var version = "0.0.173";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/ios/templates/CraftApp.swift

@@ -561,7 +561,13 @@ struct CraftApp: App {
                     .ignoresSafeArea(.keyboard, edges: .bottom)
                 } else if appState.config.renderer == "native" {
                     // One native screen and its stack: no paths, no tabs.
+                    // The screen keeps itself out of the keyboard's way (its
+                    // own bottom safe area, CraftNativeScreen.swift); SwiftUI
+                    // shrinking it as well took the keyboard's height twice,
+                    // and a screen's scroll views and text views were squeezed
+                    // to nothing whenever the keyboard came up.
                     CraftNativeScreen(config: appState.config)
+                        .ignoresSafeArea(.keyboard, edges: .bottom)
                 } else {
                     // The page's own chrome, drawn natively over it: the tab
                     // bar the page asks for, and the splash until it is ready.

package/dist/ios/templates/CraftNativeScreen.swift

@@ -5398,6 +5398,12 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
                 view.accessibilityValue = [current, message].compactMap { $0 }.joined(separator: ", ")
             }
         }
+        // A multiline TextInput is a UITextView, which works out its traits
+        // as it goes: while it has the keyboard they say it is editing, and
+        // that is what UI tests and VoiceOver read focus from. Setting them
+        // froze them, so it read as static text that never had focus ("neither
+        // element nor any descendant has keyboard focus"); it keeps its own.
+        if view is UITextView { return }
         view.accessibilityTraits = traits
     }
 

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

@@ -0,0 +1,16 @@
+export interface MacOSNativeBuildOptions {
+    outdir: string;
+    /** A compiled stx native route bundle, never HTML. */
+    nativeBundle: string;
+    zig?: string;
+    /** zig-js checkout and its public static archive. No system JSC fallback. */
+    zigJS: {
+        source: string;
+        library: string;
+    };
+}
+/** Compile Craft's AppKit host and the shared Zig layout core. No WebKit. */
+export declare function buildMacOSNative(options: MacOSNativeBuildOptions): Promise<{
+    executable: string;
+    bundle: string;
+}>;

package/dist/macos/src/index.js

@@ -0,0 +1,75 @@
+// @bun
+// ../macos/src/index.ts
+import { cp, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+import process from "process";
+async function buildMacOSNative(options) {
+  if (process.platform !== "darwin")
+    throw new Error("The AppKit host must be built on macOS.");
+  const outdir = resolve(options.outdir);
+  const templates = join(import.meta.dir, "../templates");
+  const sourceRoot = join(import.meta.dir, "../..");
+  const layout = existsSync(join(sourceRoot, "zig/src/native_layout.zig")) ? join(sourceRoot, "zig/src/native_layout.zig") : join(templates, "native_layout.zig");
+  const mutation = existsSync(join(sourceRoot, "ios/templates/CraftNativeMutation.swift")) ? join(sourceRoot, "ios/templates/CraftNativeMutation.swift") : join(templates, "CraftNativeMutation.swift");
+  if (!existsSync(options.nativeBundle))
+    throw new Error(`Native STX bundle not found: ${options.nativeBundle}`);
+  await mkdir(outdir, { recursive: true });
+  async function run(args) {
+    const child = Bun.spawn(args, { stdout: "inherit", stderr: "inherit" });
+    if (await child.exited !== 0)
+      throw new Error(`Native build failed: ${args[0]}`);
+  }
+  const zig = options.zig || process.env.CRAFT_ZIG || Bun.which("zig");
+  if (!zig)
+    throw new Error("Install the pinned Craft Zig toolchain or set CRAFT_ZIG.");
+  const layoutLibrary = join(outdir, "libcraft-layout.a");
+  await run([zig, "build-lib", layout, "-O", "ReleaseSafe", "-static", "-lc", `-femit-bin=${layoutLibrary}`]);
+  const executable = join(outdir, "craft-native-macos");
+  const engine = options.zigJS;
+  if (!existsSync(engine.library))
+    throw new Error(`Build zig-js first: ${engine.library}`);
+  if (!existsSync(join(engine.source, "include/module.modulemap")))
+    throw new Error("zig-js must expose its owned ZigJS Swift module.");
+  const bridge = join(outdir, "zig-js-objc.o");
+  const dispatch = join(outdir, "zig-js-dispatch.o");
+  const assembly = join(engine.source, `src/objc_abi_${process.arch === "arm64" ? "aarch64" : "x86_64"}.S`);
+  await run(["xcrun", "clang", "-fobjc-arc", "-fblocks", "-Wno-incomplete-implementation", "-I", join(engine.source, "include"), "-include", join(engine.source, "include/ZigJS.h"), "-c", join(engine.source, "src/objc_bridge.m"), "-o", bridge]);
+  await run([zig, "build-obj", join(engine.source, "src/objc_abi_dispatch.zig"), assembly, "-O", "ReleaseFast", `-femit-bin=${dispatch}`]);
+  await run([
+    "swiftc",
+    "-O",
+    "-swift-version",
+    "5",
+    "-I",
+    join(engine.source, "include"),
+    "-framework",
+    "Cocoa",
+    "-framework",
+    "AVKit",
+    "-framework",
+    "UserNotifications",
+    join(templates, "CraftMacRuntime.swift"),
+    join(templates, "CraftMacRenderer.swift"),
+    join(templates, "CraftMacApplication.swift"),
+    mutation,
+    bridge,
+    dispatch,
+    engine.library,
+    "-Xlinker",
+    "-force_load",
+    "-Xlinker",
+    layoutLibrary,
+    "-Xlinker",
+    "-export_dynamic",
+    "-o",
+    executable
+  ]);
+  const bundle = join(outdir, "native-screen.js");
+  if (resolve(options.nativeBundle) !== bundle)
+    await cp(options.nativeBundle, bundle);
+  return { executable, bundle };
+}
+export {
+  buildMacOSNative
+};

package/dist/macos/templates/CraftMacApplication.swift

@@ -0,0 +1,342 @@
+import AppKit
+import AVKit
+import CoreImage
+import UserNotifications
+import UniformTypeIdentifiers
+
+final class CraftMacScene: NSObject, NSWindowDelegate {
+    let name: String
+    let window: NSWindow
+    let runtime: CraftMacRuntime
+    let renderer: CraftMacRenderer
+    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)
+        renderer = CraftMacRenderer(runtime: runtime)
+        let width = number(options["width"]) ?? 1120, height = number(options["height"]) ?? 740
+        window = NSWindow(contentRect: CGRect(x: 0, y: 0, width: width, height: height), styleMask: [.titled, .closable, .resizable, .miniaturizable], backing: .buffered, defer: false)
+        super.init()
+        runtime.scene = self; renderer.window = window
+        window.title = options["title"] as? String ?? application.appName
+        window.minSize = CGSize(width: number(options["minWidth"]) ?? 640, height: number(options["minHeight"]) ?? 400)
+        window.isReleasedWhenClosed = false
+        renderer.root.autoresizingMask = [.width, .height]
+        window.contentView = renderer.root
+        window.delegate = self; window.center()
+        if name == "main" { window.setFrameAutosaveName("\(application.appName)NativeMain") }
+        window.makeKeyAndOrderFront(nil)
+        runtime.load(application.bundle)
+    }
+    func windowShouldClose(_ sender: NSWindow) -> Bool {
+        if name == "main" { sender.orderOut(nil); return false }
+        return true
+    }
+    func windowWillClose(_ notification: Notification) {
+        runtime.dispose()
+        CraftMacApplication.shared.scenes.removeValue(forKey: name)
+    }
+    func windowDidBecomeKey(_ notification: Notification) { runtime.send("SCREEN_FOCUS", ["focused": true]) }
+    func windowDidResignKey(_ notification: Notification) { runtime.send("SCREEN_FOCUS", ["focused": false]) }
+}
+
+final class CraftMacMenuTarget: NSObject {
+    var chosen: String?
+    @objc func choose(_ item: NSMenuItem) { chosen = item.representedObject as? String }
+}
+
+final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotificationCenterDelegate {
+    static let shared = CraftMacApplication()
+    var appName = "Craft"
+    var bundle = ""
+    var initialRoute = "Main"
+    var network: CraftMacNetwork!
+    var scenes: [String: CraftMacScene] = [:]
+    var panels: [NSWindow] = []
+    var chosenFiles = Set<String>()
+    var testDirectory: URL?
+    var testTimer: Timer?
+    var processedActions = Set<String>()
+    var appearanceObservation: NSKeyValueObservation?
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        installMenus()
+        appearanceObservation = NSApp.observe(\.effectiveAppearance, options: [.new]) { [weak self] _, _ in
+            DispatchQueue.main.async { self?.appearanceChanged() }
+        }
+        NSApp.activate(ignoringOtherApps: true)
+        // The agent issues an HttpOnly cookie. It stays in URLSession, shared
+        // by native windows, and is never handed to the JavaScript context.
+        let request = URLRequest(url: network.base.appendingPathComponent("native/session"))
+        network.session.dataTask(with: request) { [weak self] _, response, error in
+            DispatchQueue.main.async {
+                guard let self else { return }
+                guard error == nil, (response as? HTTPURLResponse)?.statusCode == 200 else {
+                    let alert = NSAlert(); alert.messageText = "Could not connect to the app"; alert.informativeText = error?.localizedDescription ?? "The local agent did not issue a native session."; alert.runModal(); NSApp.terminate(nil); return
+                }
+                self.open(name: "main", route: self.initialRoute, options: ["title": self.appName])
+                self.startTestDriver()
+            }
+        }.resume()
+    }
+    func applicationShouldHandleReopen(_ sender: NSApplication, hasVisibleWindows flag: Bool) -> Bool { scenes["main"]?.window.makeKeyAndOrderFront(nil); return true }
+    func applicationWillTerminate(_ notification: Notification) { scenes.values.forEach { $0.runtime.dispose() }; testTimer?.invalidate() }
+    func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { false }
+    func open(name: String, route: String, options: [String: Any]) {
+        if let scene = scenes[name] { scene.window.makeKeyAndOrderFront(nil); return }
+        scenes[name] = CraftMacScene(name: name, route: route, options: options, application: self)
+    }
+    @objc func command(_ item: NSMenuItem) {
+        guard let id = item.representedObject as? String else { return }
+        broadcast(id)
+    }
+    func broadcast(_ id: String) { for scene in scenes.values { scene.runtime.send("CRAFT_EVENT", ["event": "craftDesktopCommand", "detail": ["id": id]]) } }
+    func appearanceChanged() {
+        let scheme = CraftMacColor.isDark ? "dark" : "light"
+        for scene in scenes.values {
+            scene.runtime.context.evaluateScript("__stxNativeBridge.colorScheme = '\(scheme)';")
+            scene.window.effectiveAppearance.performAsCurrentDrawingAppearance {
+                for box in scene.renderer.boxes.values {
+                    box.layer?.backgroundColor = CraftMacColor.parse(box.style["backgroundColor"], fallback: .clear).cgColor
+                    box.layer?.borderColor = CraftMacColor.parse(box.style["borderColor"], fallback: .separatorColor).cgColor
+                }
+            }
+        }
+        broadcast("appearance")
+    }
+
+    private func installMenus() {
+        let bar = NSMenu()
+        let app = NSMenu(title: appName)
+        app.addItem(withTitle: "About \(appName)", action: #selector(NSApplication.orderFrontStandardAboutPanel(_:)), keyEquivalent: "")
+        app.addItem(.separator())
+        let settings = app.addItem(withTitle: "Settings…", action: #selector(command(_:)), keyEquivalent: ","); settings.target = self; settings.representedObject = "settings"
+        app.addItem(.separator())
+        app.addItem(withTitle: "Hide \(appName)", action: #selector(NSApplication.hide(_:)), keyEquivalent: "h")
+        app.addItem(withTitle: "Quit \(appName)", action: #selector(NSApplication.terminate(_:)), keyEquivalent: "q")
+        addMenu(app, to: bar)
+        let edit = NSMenu(title: "Edit")
+        edit.addItem(withTitle: "Undo", action: Selector(("undo:")), keyEquivalent: "z")
+        edit.addItem(withTitle: "Redo", action: Selector(("redo:")), keyEquivalent: "Z")
+        edit.addItem(.separator())
+        edit.addItem(withTitle: "Cut", action: #selector(NSText.cut(_:)), keyEquivalent: "x")
+        edit.addItem(withTitle: "Copy", action: #selector(NSText.copy(_:)), keyEquivalent: "c")
+        edit.addItem(withTitle: "Paste", action: #selector(NSText.paste(_:)), keyEquivalent: "v")
+        edit.addItem(withTitle: "Select All", action: #selector(NSText.selectAll(_:)), keyEquivalent: "a")
+        addMenu(edit, to: bar)
+        let window = NSMenu(title: "Window")
+        window.addItem(withTitle: "Close", action: #selector(NSWindow.performClose(_:)), keyEquivalent: "w")
+        window.addItem(withTitle: "Minimize", action: #selector(NSWindow.performMiniaturize(_:)), keyEquivalent: "m")
+        window.addItem(withTitle: "Zoom", action: #selector(NSWindow.performZoom(_:)), keyEquivalent: "")
+        addMenu(window, to: bar)
+        NSApp.mainMenu = bar; NSApp.windowsMenu = window
+    }
+    private func addMenu(_ menu: NSMenu, to bar: NSMenu) { let item = NSMenuItem(title: menu.title, action: nil, keyEquivalent: ""); item.submenu = menu; bar.addItem(item) }
+    private func menuItem(_ raw: [String: Any], target: AnyObject, action: Selector) -> NSMenuItem {
+        if raw["separator"] as? Bool == true { return .separator() }
+        let parts = (raw["shortcut"] as? String ?? "").lowercased().split(separator: "+").map(String.init)
+        let key = ["up": "\u{F700}", "down": "\u{F701}", "left": "\u{F702}", "right": "\u{F703}" ][parts.last ?? ""] ?? parts.last ?? ""
+        let item = NSMenuItem(title: raw["label"] as? String ?? raw["title"] as? String ?? "", action: action, keyEquivalent: key)
+        item.target = target; item.representedObject = raw["id"]
+        item.keyEquivalentModifierMask = []
+        if parts.contains("cmd") { item.keyEquivalentModifierMask.insert(.command) }
+        if parts.contains("ctrl") { item.keyEquivalentModifierMask.insert(.control) }
+        if parts.contains("shift") { item.keyEquivalentModifierMask.insert(.shift) }
+        if parts.contains("alt") { item.keyEquivalentModifierMask.insert(.option) }
+        item.isEnabled = raw["disabled"] as? Bool != true
+        item.state = raw["checked"] as? Bool == true ? .on : .off
+        if let symbol = raw["icon"] as? String { item.image = NSImage(systemSymbolName: symbol, accessibilityDescription: nil) }
+        return item
+    }
+    func perform(_ method: String, args: [Any], scene: CraftMacScene?, reply: @escaping (Any) -> Void) {
+        let options = args.first as? [String: Any] ?? [:]
+        switch method {
+        case "openWindow":
+            let name = options["name"] as? String ?? options["route"] as? String ?? "window"
+            let route = options["route"] as? String ?? initialRoute
+            open(name: name, route: route, options: options); reply(["name": name])
+        case "closeWindow": scene?.window.performClose(nil); reply(NSNull())
+        case "focus":
+            if let identifier = args.first as? String, let box = scene?.renderer.boxes.values.first(where: { ($0.props["testID"] as? String ?? $0.props["testId"] as? String ?? $0.id) == identifier }) {
+                scene?.window.makeFirstResponder((box.control as? NSScrollView)?.documentView ?? box.control)
+            }
+            reply(NSNull())
+        case "setMenus":
+            for raw in args.first as? [[String: Any]] ?? [] {
+                guard let title = raw["label"] as? String, ![appName, "Edit", "Window"].contains(title), let bar = NSApp.mainMenu else { continue }
+                if let old = bar.items.first(where: { $0.title == title }) { bar.removeItem(old) }
+                let menu = NSMenu(title: title); menu.autoenablesItems = false
+                for item in raw["items"] as? [[String: Any]] ?? [] { menu.addItem(menuItem(item, target: self, action: #selector(command(_:)))) }
+                addMenu(menu, to: bar)
+            }; reply(true)
+        case "contextMenu":
+            let target = CraftMacMenuTarget(), menu = NSMenu(); menu.autoenablesItems = false
+            for item in args.first as? [[String: Any]] ?? [] { menu.addItem(menuItem(item, target: target, action: #selector(CraftMacMenuTarget.choose(_:)))) }
+            menu.popUp(positioning: nil, at: NSEvent.mouseLocation, in: nil); reply(target.chosen ?? NSNull())
+        case "pickFiles":
+            let panel = NSOpenPanel(); panel.canChooseFiles = true; panel.canChooseDirectories = false; panel.allowsMultipleSelection = true
+            guard panel.runModal() == .OK else { reply([]); return }
+            let files: [[String: String]] = panel.urls.map { url in
+                chosenFiles.insert(url.path)
+                return ["path": url.path, "name": url.lastPathComponent, "type": UTType(filenameExtension: url.pathExtension)?.preferredMIMEType ?? "application/octet-stream"]
+            }; reply(files)
+        case "uploadFiles":
+            upload(args.first as? [[String: String]] ?? [], endpoint: args.count > 1 ? args[1] as? String ?? "" : "", reply: reply)
+        case "preview": preview(options, scene: scene); reply(true)
+        case "exportFile": export(options, reply: reply)
+        case "qrCode":
+            let text = args.first as? String ?? ""
+            let filter = CIFilter(name: "CIQRCodeGenerator")!; filter.setValue(Data(text.utf8), forKey: "inputMessage"); filter.setValue("M", forKey: "inputCorrectionLevel")
+            guard let image = filter.outputImage?.transformed(by: CGAffineTransform(scaleX: 8, y: 8)), let cg = CIContext().createCGImage(image, from: image.extent), let data = NSBitmapImageRep(cgImage: cg).representation(using: .png, properties: [:]) else { reply(NSNull()); return }
+            reply("data:image/png;base64," + data.base64EncodedString())
+        case "setBadge": let count = (args.first as? NSNumber)?.intValue ?? 0; NSApp.dockTile.badgeLabel = count > 0 ? String(count) : nil; reply(true)
+        default: reply(["error": "Unsupported desktop operation: \(method)"])
+        }
+    }
+    private func upload(_ files: [[String: String]], endpoint: String, reply: @escaping (Any) -> Void) {
+        var results: [Any] = []
+        func next(_ index: Int) {
+            guard index < files.count else { reply(results); return }
+            let file = files[index]
+            guard let path = file["path"], chosenFiles.contains(path), let data = try? Data(contentsOf: URL(fileURLWithPath: path)), data.count <= 256 * 1024 * 1024,
+                  var request = network.request(["url": endpoint, "method": "POST", "headers": ["x-filename": file["name"] ?? "Attachment", "content-type": file["type"] ?? "application/octet-stream"]]) else { reply(["error": "Could not read a picked attachment"]); return }
+            request.httpBody = data
+            network.session.dataTask(with: request) { data, response, error in DispatchQueue.main.async {
+                guard error == nil, (response as? HTTPURLResponse)?.statusCode == 200, let data, let value = try? JSONSerialization.jsonObject(with: data) else { reply(["error": error?.localizedDescription ?? "Attachment upload failed"]); return }
+                results.append(value); next(index + 1)
+            } }.resume()
+        }; next(0)
+    }
+    private func preview(_ options: [String: Any], scene: CraftMacScene?) {
+        guard let request = network.request(["url": options["url"] ?? ""]) else { return }
+        let panel = NSPanel(contentRect: CGRect(x: 0, y: 0, width: 760, height: 600), styleMask: [.titled, .closable, .resizable], backing: .buffered, defer: false)
+        panel.title = options["title"] as? String ?? "Preview"; panel.isReleasedWhenClosed = false; panels.append(panel)
+        if options["type"] as? String == "video" || options["type"] as? String == "audio" {
+            let player = AVPlayerView(); player.controlsStyle = .floating; panel.contentView = player
+            let headers = network.session.configuration.httpCookieStorage?.cookies(for: request.url!).map { HTTPCookie.requestHeaderFields(with: $0) } ?? [:]
+            player.player = AVPlayer(playerItem: AVPlayerItem(asset: AVURLAsset(url: request.url!, options: ["AVURLAssetHTTPHeaderFieldsKey": headers])))
+            player.player?.play()
+        } else {
+            let image = NSImageView(); image.imageScaling = .scaleProportionallyUpOrDown; panel.contentView = image
+            network.session.dataTask(with: request) { data, _, _ in DispatchQueue.main.async { image.image = data.flatMap(NSImage.init(data:)) } }.resume()
+        }
+        panel.center(); panel.makeKeyAndOrderFront(nil)
+    }
+    private func export(_ options: [String: Any], reply: @escaping (Any) -> Void) {
+        let panel = NSSavePanel(); panel.nameFieldStringValue = options["name"] as? String ?? "Attachment"
+        guard panel.runModal() == .OK, let destination = panel.url, let request = network.request(["url": options["url"] ?? ""]) else { reply(false); return }
+        network.session.downloadTask(with: request) { location, response, error in
+            var saved = false
+            if error == nil, (response as? HTTPURLResponse)?.statusCode == 200, let location { do { if FileManager.default.fileExists(atPath: destination.path) { try FileManager.default.removeItem(at: destination) }; try FileManager.default.moveItem(at: location, to: destination); saved = true } catch {} }
+            DispatchQueue.main.async { reply(saved) }
+        }.resume()
+    }
+    func notification(_ method: String, options: [String: Any], reply: @escaping (Any) -> Void) {
+        guard method == "schedule" else { reply(false); return }
+        let center = UNUserNotificationCenter.current()
+        let content = UNMutableNotificationContent(); content.title = options["title"] as? String ?? appName; content.body = options["body"] as? String ?? ""
+        let identifier = options["id"] as? String ?? UUID().uuidString
+        center.add(UNNotificationRequest(identifier: identifier, content: content, trigger: nil)) { error in DispatchQueue.main.async { reply(error == nil) } }
+    }
+
+    /// Explicit local test mode. Exercises AppKit controls on the main event
+    /// loop and snapshots actual view classes, never a DOM or an HTTP driver.
+    private func startTestDriver() {
+        guard let directory = testDirectory else { return }
+        try? FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
+        testTimer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { [weak self] _ in
+            guard let self else { return }
+            let files = (try? FileManager.default.contentsOfDirectory(at: directory, includingPropertiesForKeys: nil)) ?? []
+            for file in files where file.lastPathComponent.hasPrefix("action-") && file.pathExtension == "json" && !self.processedActions.contains(file.lastPathComponent) {
+                guard let data = try? Data(contentsOf: file), let action = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else { continue }
+                self.processedActions.insert(file.lastPathComponent)
+                let result = self.testAction(action)
+                if let bytes = try? JSONSerialization.data(withJSONObject: result) { try? bytes.write(to: directory.appendingPathComponent(file.lastPathComponent.replacingOccurrences(of: "action-", with: "result-")), options: .atomic) }
+            }
+            if let data = try? JSONSerialization.data(withJSONObject: self.snapshot()) { try? data.write(to: directory.appendingPathComponent("state.json"), options: .atomic) }
+        }
+    }
+    private func testAction(_ action: [String: Any]) -> [String: Any] {
+        let kind = action["action"] as? String ?? ""
+        if kind == "command", let id = action["id"] as? String { broadcast(id); return ["ok": true] }
+        if kind == "quit" { DispatchQueue.main.async { NSApp.terminate(nil) }; return ["ok": true] }
+        if kind == "appearance" {
+            NSApp.appearance = NSAppearance(named: action["value"] as? String == "dark" ? .darkAqua : .aqua)
+            appearanceChanged(); return ["ok": true]
+        }
+        let scene = scenes[action["window"] as? String ?? "main"]
+        guard let scene else { return ["ok": false, "error": "Window not found"] }
+        if kind == "close" { scene.window.performClose(nil); return ["ok": true] }
+        if kind == "screenshot" {
+            guard let directory = testDirectory, let view = scene.window.contentView?.superview,
+                  let bitmap = view.bitmapImageRepForCachingDisplay(in: view.bounds) else { return ["ok": false, "error": "Window cannot be rendered"] }
+            scene.window.effectiveAppearance.performAsCurrentDrawingAppearance {
+                func invalidate(_ current: NSView) { current.needsDisplay = true; for child in current.subviews { invalidate(child) } }
+                invalidate(view); view.displayIfNeeded()
+                view.cacheDisplay(in: view.bounds, to: bitmap)
+            }
+            guard let png = bitmap.representation(using: .png, properties: [:]) else { return ["ok": false, "error": "PNG encoding failed"] }
+            let destination = directory.appendingPathComponent("screenshot-\(scene.name)-\(CraftMacColor.isDark ? "dark" : "light").png")
+            do { try png.write(to: destination, options: .atomic); return ["ok": true, "path": destination.path] }
+            catch { return ["ok": false, "error": error.localizedDescription] }
+        }
+        guard let identifier = action["target"] as? String,
+              let box = scene.renderer.boxes.values.first(where: { ($0.props["testID"] as? String ?? $0.props["testId"] as? String ?? $0.id) == identifier }) else { return ["ok": false, "error": "Control not found"] }
+        box.scrollToVisible(box.bounds)
+        guard box.window?.isVisible == true, !box.isHidden, box.frame.width > 0, box.frame.height > 0 else { return ["ok": false, "error": "Control is not visible"] }
+        if let control = box.control as? NSControl, !control.isEnabled { return ["ok": false, "error": "Control is disabled"] }
+        switch kind {
+        case "click": if let button = box.control as? NSButton { button.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) }
+            else if let text = (box.control as? NSScrollView)?.documentView as? NSTextView { text.string = value; box.input(value) }
+            else { return ["ok": false, "error": "Not a text input"] }
+        case "pick":
+            if let picker = box.control as? NSPopUpButton, let item = picker.itemArray.first(where: { ($0.representedObject as? String) == action["value"] as? String }) { picker.select(item); box.changed() }
+            else if let sidebar = box.control as? CraftMacSidebar, let id = action["value"] as? String {
+                guard let row = (0..<sidebar.outline.numberOfRows).first(where: { (sidebar.outline.item(atRow: $0) as? CraftMacSidebar.Item)?.id == id }) else { return ["ok": false, "error": "Sidebar item not found"] }
+                sidebar.outline.selectRowIndexes(IndexSet(integer: row), byExtendingSelection: false)
+            } else { return ["ok": false, "error": "Not a picker"] }
+        default: return ["ok": false, "error": "Unsupported test action"]
+        }
+        return ["ok": true]
+    }
+    private func snapshot() -> [String: Any] {
+        let windows: [[String: Any]] = scenes.values.map { scene in
+            let nodes: [[String: Any]] = scene.renderer.boxes.values.map { box in
+                var node: [String: Any] = ["id": box.props["testID"] as? String ?? box.props["testId"] as? String ?? box.id, "type": box.kind,
+                    "nativeClass": box.control.map { String(describing: type(of: $0)) } ?? "NSView", "visible": !box.isHidden && box.window?.isVisible == true && box.frame.width > 0 && box.frame.height > 0,
+                    "frame": [box.frame.minX, box.frame.minY, box.frame.width, box.frame.height]]
+                if let field = box.control as? NSTextField { node["value"] = field.stringValue }
+                if let text = (box.control as? NSScrollView)?.documentView as? NSTextView { node["value"] = text.string; node["editorClass"] = NSStringFromClass(type(of: text)) }
+                if let button = box.control as? NSButton { node["label"] = button.title; node["enabled"] = button.isEnabled }
+                if let picker = box.control as? NSPopUpButton { node["value"] = picker.selectedItem?.representedObject ?? "" }
+                if let sidebar = box.control as? CraftMacSidebar { node["value"] = (sidebar.outline.item(atRow: sidebar.outline.selectedRow) as? CraftMacSidebar.Item)?.id ?? "" }
+                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]
+        }
+        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]
+    }
+}
+
+@main struct CraftMacMain {
+    static func main() throws {
+        func argument(_ flag: String, fallback: String = "") -> String { guard let index = CommandLine.arguments.firstIndex(of: flag), CommandLine.arguments.indices.contains(index + 1) else { return fallback }; return CommandLine.arguments[index + 1] }
+        let application = CraftMacApplication.shared
+        if CommandLine.arguments.contains("--version") { print("craft native macOS renderer 0.0.172 (zig-js)"); return }
+        guard let api = URL(string: argument("--api-url")), ["http", "https"].contains(api.scheme ?? ""), api.host != nil else { throw NSError(domain: "Craft", code: 1, userInfo: [NSLocalizedDescriptionKey: "--api-url must name the application's HTTP agent"] ) }
+        let bundlePath = argument("--native-bundle")
+        guard !bundlePath.isEmpty else { throw NSError(domain: "Craft", code: 2, userInfo: [NSLocalizedDescriptionKey: "--native-bundle must name a compiled STX bundle"] ) }
+        application.bundle = try String(contentsOfFile: bundlePath, encoding: .utf8)
+        application.appName = argument("--title", fallback: "Craft")
+        application.initialRoute = argument("--route", fallback: "Main")
+        application.network = CraftMacNetwork(base: api)
+        let testDirectory = argument("--test-dir")
+        if !testDirectory.isEmpty { application.testDirectory = URL(fileURLWithPath: testDirectory, isDirectory: true) }
+        let app = NSApplication.shared
+        app.setActivationPolicy(.regular); app.delegate = application; app.run()
+    }
+}