craft-native 0.0.410 → 0.0.413

package/dist/cli.js

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

package/dist/index.cjs

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

package/dist/index.js

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

package/dist/ios/templates/CraftNativeScreen.swift

@@ -11133,6 +11133,16 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             if self.keyboardScreenFrame != nil { self.insetScrollViewsForKeyboard() }
             guard let scroll = self.enclosingVerticalScroll(of: textView),
                   let rect = self.caretRect(of: textView, in: scroll) else { return }
+            // UIKit's text view scrolls this scroll view itself, animated, when
+            // the keyboard finishes appearing. Arriving after an edit and
+            // before this pass, it aims at the caret of the stale layout (the
+            // input's top), and while it runs it carries any offset set here
+            // back toward that target. This pass measured the current layout:
+            // stop that animation so the caret stays where it can be seen. A
+            // finger's drag or fling is the person's, and is left alone.
+            if !scroll.isTracking && !scroll.isDecelerating {
+                scroll.setContentOffset(scroll.contentOffset, animated: false)
+            }
             let visible = scroll.bounds.inset(by: scroll.adjustedContentInset)
             guard !visible.contains(rect) else { return }
             scroll.scrollRectToVisible(rect, animated: false)

package/dist/macos/templates/CraftMacApplication.swift

@@ -19,6 +19,8 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
     /// Where the close button's top-left corner sits, from the window's top-left (`--traffic-lights 18,18`):
     /// a browser lines the buttons up with its own toolbar row. Nil keeps AppKit's place.
     let trafficLights: CGPoint?
+    /// The screen has work to finish before the app quits (`craft.desktop.onQuit`).
+    var holdsQuit = false
     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)
@@ -38,6 +40,8 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
             window.titleVisibility = .hidden
         }
         window.minSize = CGSize(width: number(options["minWidth"]) ?? 640, height: number(options["minHeight"]) ?? 400)
+        // A small window that stays above others (a link opened from another app, a quick look).
+        if options["floating"] as? Bool == true { window.level = .floating; window.collectionBehavior.insert(.fullScreenAuxiliary) }
         window.isReleasedWhenClosed = false
         renderer.root.autoresizingMask = [.width, .height]
         window.contentView = renderer.root
@@ -69,6 +73,7 @@ final class CraftMacScene: NSObject, NSWindowDelegate {
     func windowWillClose(_ notification: Notification) {
         runtime.dispose()
         CraftMacApplication.shared.scenes.removeValue(forKey: name)
+        CraftMacApplication.shared.quitReady(scene: name)
     }
     func windowDidBecomeKey(_ notification: Notification) { runtime.send("SCREEN_FOCUS", ["focused": true]) }
     func windowDidResignKey(_ notification: Notification) { runtime.send("SCREEN_FOCUS", ["focused": false]) }
@@ -91,6 +96,10 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
     /// endpoint and starts with `--no-session`.
     var requiresSession = true
     var mainWindowOptions: [String: Any] = [:]
+    /// The Dock icon's menu (`craft-app.json` `dockMenu`): each item sends its action as a desktop command.
+    var dockMenu: [[String: Any]] = []
+    /// Links and files other apps opened with this one, waiting for a screen to take them (`takeOpenedURLs`).
+    var openedURLs: [String] = []
     var network: CraftMacNetwork!
     var scenes: [String: CraftMacScene] = [:]
     var panels: [NSWindow] = []
@@ -98,7 +107,13 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
     var testDirectory: URL?
     var testTimer: Timer?
     var processedActions = Set<String>()
+    /// The last context menu a screen asked for, and the entry the next one answers, under the test driver.
+    var testMenu: [[String: Any]] = []
+    var testMenuChoice: String?
     var appearanceObservation: NSKeyValueObservation?
+    /// A quit waiting for screens to finish (`craft.desktop.onQuit`), for at most `quitGrace` seconds.
+    private var pendingQuit: (token: String, waiting: Set<String>, timeout: Timer)?
+    static let quitGrace: TimeInterval = 3
 
     func applicationDidFinishLaunching(_ notification: Notification) {
         installMenus()
@@ -126,8 +141,58 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
         }.resume()
     }
     func applicationShouldHandleReopen(_ sender: NSApplication, hasVisibleWindows flag: Bool) -> Bool { scenes["main"]?.window.makeKeyAndOrderFront(nil); return true }
+    /// Links from other apps (this app as the default browser) and files dropped on the Dock icon.
+    /// A screen hears `craftDesktopOpenURL`; ones that arrive before any screen listens wait for `takeOpenedURLs`.
+    func application(_ application: NSApplication, open urls: [URL]) {
+        let list = urls.map(\.absoluteString)
+        openedURLs.append(contentsOf: list)
+        for scene in scenes.values { scene.runtime.send("CRAFT_EVENT", ["event": "craftDesktopOpenURL", "detail": ["urls": list]]) }
+    }
+    func applicationDockMenu(_ sender: NSApplication) -> NSMenu? {
+        guard !dockMenu.isEmpty else { return nil }
+        let menu = NSMenu()
+        for raw in dockMenu {
+            let item = NSMenuItem(title: raw["title"] as? String ?? "", action: #selector(command(_:)), keyEquivalent: "")
+            item.target = self; item.representedObject = raw["action"] as? String
+            menu.addItem(item)
+        }
+        return menu
+    }
+    /// Is this app the one that opens web links?
+    var isDefaultBrowser: Bool {
+        guard let probe = URL(string: "https://example.com"), let handler = NSWorkspace.shared.urlForApplication(toOpen: probe) else { return false }
+        return handler.standardizedFileURL == Bundle.main.bundleURL.standardizedFileURL
+    }
     func applicationWillTerminate(_ notification: Notification) { scenes.values.forEach { $0.runtime.dispose() }; testTimer?.invalidate() }
     func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { false }
+    /// Screens holding the quit hear `craftDesktopQuit` and answer `quitReady` once their work is saved.
+    /// The main queue keeps running while AppKit waits, so their timers and requests still complete,
+    /// unless `terminate` was called from inside a main-queue block: GCD runs no other main-queue
+    /// block until that one returns. So the host never calls it from one, and the timeout is a run
+    /// loop timer, which fires either way. A second quit while waiting quits at once.
+    func applicationShouldTerminate(_ sender: NSApplication) -> NSApplication.TerminateReply {
+        let holding = scenes.values.filter(\.holdsQuit)
+        guard !holding.isEmpty, pendingQuit == nil else { return .terminateNow }
+        let token = UUID().uuidString
+        let timeout = Timer(timeInterval: Self.quitGrace, repeats: false) { [weak self] _ in self?.finishQuit(token) }
+        RunLoop.main.add(timeout, forMode: .common)
+        pendingQuit = (token, Set(holding.map(\.name)), timeout)
+        for scene in holding { scene.runtime.send("CRAFT_EVENT", ["event": "craftDesktopQuit", "detail": ["token": token]]) }
+        return .terminateLater
+    }
+    /// A screen finished its quit work, or went away. `token` nil matches the quit in progress.
+    func quitReady(scene: String, token: String? = nil) {
+        guard var pending = pendingQuit, token == nil || token == pending.token else { return }
+        pending.waiting.remove(scene)
+        pendingQuit = pending
+        if pending.waiting.isEmpty { finishQuit(pending.token) }
+    }
+    private func finishQuit(_ token: String) {
+        guard let pending = pendingQuit, pending.token == token else { return }
+        pending.timeout.invalidate()
+        pendingQuit = nil
+        NSApp.reply(toApplicationShouldTerminate: true)
+    }
     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)
@@ -233,6 +298,9 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
                 bar.insertItem(item, at: min(index, bar.items.count))
             }; reply(true)
         case "contextMenu":
+            // Under the test driver no menu pops up (it would wait for a click): the items are recorded
+            // and the entry a `menu` action chose comes back.
+            if testDirectory != nil { testMenu = args.first as? [[String: Any]] ?? []; reply(testMenuChoice ?? NSNull()); testMenuChoice = nil; return }
             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())
@@ -252,7 +320,19 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
             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 "takeOpenedURLs": reply(openedURLs); openedURLs.removeAll()
+        case "isDefaultBrowser": reply(isDefaultBrowser)
+        case "setDefaultBrowser":
+            // macOS asks the person to confirm; the answer is whether this app opens links afterwards.
+            let app = Bundle.main.bundleURL
+            NSWorkspace.shared.setDefaultApplication(at: app, toOpenURLsWithScheme: "http") { _ in
+                NSWorkspace.shared.setDefaultApplication(at: app, toOpenURLsWithScheme: "https") { _ in
+                    DispatchQueue.main.async { reply(self.isDefaultBrowser) }
+                }
+            }
         case "setBadge": let count = (args.first as? NSNumber)?.intValue ?? 0; NSApp.dockTile.badgeLabel = count > 0 ? String(count) : nil; reply(true)
+        case "holdQuit": scene?.holdsQuit = args.first as? Bool != false; reply(true)
+        case "quitReady": if let scene { quitReady(scene: scene.name, token: args.first as? String) }; reply(true)
         default: reply(["error": "Unsupported desktop operation: \(method)"])
         }
     }
@@ -322,7 +402,9 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
     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] }
+        // After this result is written, from the run loop rather than a main-queue block (see applicationShouldTerminate).
+        if kind == "quit" { NSApp.perform(#selector(NSApplication.terminate(_:)), with: nil, afterDelay: 0); return ["ok": true] }
+        if kind == "openURL", let url = (action["url"] as? String).flatMap(URL.init(string:)) { application(NSApp, open: [url]); return ["ok": true] }
         if kind == "appearance" {
             NSApp.appearance = NSAppearance(named: action["value"] as? String == "dark" ? .darkAqua : .aqua)
             appearanceChanged(); return ["ok": true]
@@ -336,7 +418,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
             return ["ok": true]
         }
         // A control by its testID, driven the way a person would: pressed, typed into, submitted, a key, the pointer over it.
-        if ["press", "type", "submit", "key", "hover"].contains(kind) {
+        if ["press", "type", "submit", "key", "hover", "menu"].contains(kind) {
             guard let target = action["target"] as? String,
                   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 ?? ""
@@ -348,6 +430,8 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
                 box.input(text)
             case "submit": box.fire("onSubmitEditing", ["text": text, "value": text, "nativeEvent": ["text": text]])
             case "key": box.fire("onKeyPress", ["key": action["key"] as? String ?? "", "shiftKey": action["shift"] as? Bool == true, "text": text])
+            // A right-click, answered with `choose` (or nothing) when the screen opens its context menu.
+            case "menu": testMenuChoice = action["choose"] as? String; box.fire("onLongPress", ["x": 0, "y": 0])
             default:
                 let hovered = action["value"] as? Bool ?? true
                 box.hovering = hovered; box.applyAppearance(animated: false)
@@ -423,7 +507,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
             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]
+        return ["renderer": "appkit", "scriptEngine": "zig-js", "appearance": CraftMacColor.isDark ? "dark" : "light", "windows": windows, "webViews": webViews, "menu": testMenu]
     }
 }
 
@@ -451,6 +535,7 @@ final class CraftMacApplication: NSObject, NSApplicationDelegate, UNUserNotifica
         application.initialRoute = argument("--route", key: "route", fallback: "Main")
         application.titlebarStyle = argument("--titlebar-style", key: "titlebarStyle", fallback: "standard")
         // `18,18` on the command line; `[18, 18]` in craft-app.json.
+        application.dockMenu = packaged["dockMenu"] as? [[String: Any]] ?? []
         let lights = argument("--traffic-lights", key: "trafficLights").split(separator: ",").compactMap { Double($0.trimmingCharacters(in: CharacterSet(charactersIn: " []"))) }
         if lights.count == 2 { application.trafficLights = lights }
         application.requiresSession = !CommandLine.arguments.contains("--no-session") && packaged["session"] as? Bool != false

package/dist/macos/templates/CraftMacRenderer.swift

@@ -280,7 +280,7 @@ final class CraftMacBox: NSView, NSTextFieldDelegate, NSTextViewDelegate, NSDrag
     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] {
         guard let child = componentRoot else { return style }
-        let keys = ["width", "height", "minWidth", "minHeight", "maxWidth", "maxHeight", "flex", "flexGrow", "flexShrink", "flexBasis", "alignSelf", "position", "left", "right", "top", "bottom", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "marginHorizontal", "marginVertical"]
+        let keys = ["width", "height", "minWidth", "minHeight", "maxWidth", "maxHeight", "flex", "flexGrow", "flexShrink", "flexBasis", "alignSelf", "position", "zIndex", "left", "right", "top", "bottom", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "marginHorizontal", "marginVertical"]
         var result = style
         for key in keys where result[key] == nil { result[key] = child.layoutStyle[key] }
         return result
@@ -952,6 +952,12 @@ final class CraftMacRenderer {
                 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
         }

package/dist/macos/templates/CraftMacWebView.swift

@@ -1,6 +1,7 @@
 #if CRAFT_WEBKIT
 import AppKit
 import CryptoKit
+import UniformTypeIdentifiers
 import WebKit
 
 // Web content for the AppKit host: one WKWebView per tab, for apps built with
@@ -66,8 +67,11 @@ final class CraftMacTab: NSObject, WKNavigationDelegate, WKUIDelegate {
     private var statePending = false
     private var lastFavicon = ""
 
-    init(id: String, profile: String, ephemeral: Bool, configuration: WKWebViewConfiguration, owner: CraftMacRuntime?) {
+    init(id: String, profile: String, ephemeral: Bool, configuration: WKWebViewConfiguration, owner: CraftMacRuntime?, ownContent: Bool = true) {
         self.id = id; self.profile = profile; self.ephemeral = ephemeral; self.owner = owner
+        // Its own content controller, so a site allowed past the blockers is allowed in this tab only.
+        // A `window.open` child must take WebKit's configuration as given, and shares its opener's.
+        if ownContent { configuration.userContentController = WKUserContentController() }
         view = WKWebView(frame: .zero, configuration: configuration)
         super.init()
         view.navigationDelegate = self
@@ -86,8 +90,15 @@ final class CraftMacTab: NSObject, WKNavigationDelegate, WKUIDelegate {
             view.observe(\.hasOnlySecureContent, changeHandler: report), view.observe(\.themeColor, changeHandler: report),
             view.observe(\.cameraCaptureState, changeHandler: report), view.observe(\.microphoneCaptureState, changeHandler: report),
         ]
+        if ownContent {
+            CraftMacContentRules.shared.apply(to: self, host: nil)
+            CraftMacUserScripts.shared.apply(to: view.configuration.userContentController)
+        }
     }
 
+    /// The site on screen is allowed past the content blockers (or no longer is).
+    private(set) var blockingHost: String?
+
     var state: [String: Any] {
         var state: [String: Any] = [
             "tab": id, "profile": profile, "private": ephemeral,
@@ -139,6 +150,11 @@ final class CraftMacTab: NSObject, WKNavigationDelegate, WKUIDelegate {
             decisionHandler(.cancel); return
         }
         if action.shouldPerformDownload { decisionHandler(.download); return }
+        // The blockers follow the site in the main frame: a site the person allowed loads without them.
+        if action.targetFrame?.isMainFrame ?? true, let host = url.host?.lowercased(), host != blockingHost {
+            blockingHost = host
+            CraftMacContentRules.shared.apply(to: self, host: host)
+        }
         // ⌘-click (and middle click) opens the link in a new tab, as every browser does; the screen decides where.
         if action.navigationType == .linkActivated, action.targetFrame?.isMainFrame ?? true,
            action.modifierFlags.contains(.command) || action.buttonNumber == 2 {
@@ -197,7 +213,7 @@ final class CraftMacTab: NSObject, WKNavigationDelegate, WKUIDelegate {
     /// `window.open` and `target=_blank`. WebKit needs the new view right now, so the tab is
     /// created here and announced; the screen adopts it by id like any other tab.
     func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for action: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
-        let child = CraftMacWebTabs.shared.make(profile: profile, ephemeral: ephemeral, configuration: configuration, owner: owner)
+        let child = CraftMacWebTabs.shared.make(profile: profile, ephemeral: ephemeral, configuration: configuration, owner: owner, ownContent: false)
         let popup = windowFeatures.width != nil || windowFeatures.height != nil
         var detail: [String: Any] = ["child": child.id, "url": action.request.url?.absoluteString ?? "", "popup": popup, "reason": "script"]
         if popup { detail["width"] = windowFeatures.width?.doubleValue ?? 0; detail["height"] = windowFeatures.height?.doubleValue ?? 0 }
@@ -235,6 +251,112 @@ final class CraftMacTab: NSObject, WKNavigationDelegate, WKUIDelegate {
         guard let window = view.window else { completionHandler(panel.runModal() == .OK ? panel.urls : nil); return }
         panel.beginSheetModal(for: window) { response in completionHandler(response == .OK ? panel.urls : nil) }
     }
+
+    // MARK: permissions
+
+    /// A site asks for the camera or microphone. The screen decides (`permission`, answered with
+    /// `answerPermission`), so it can remember a site's answer; macOS still asks for the app once.
+    func webView(_ webView: WKWebView, requestMediaCapturePermissionFor origin: WKSecurityOrigin, initiatedByFrame frame: WKFrameInfo, type: WKMediaCaptureType, decisionHandler: @escaping (WKPermissionDecision) -> Void) {
+        let kind: String
+        switch type {
+        case .camera: kind = "camera"
+        case .microphone: kind = "microphone"
+        default: kind = "camera+microphone"
+        }
+        let request = CraftMacWebTabs.shared.ask(tab: self, decide: decisionHandler)
+        emit("permission", ["request": request, "kind": kind, "origin": origin.host, "protocol": origin.protocol, "port": origin.port, "mainFrame": frame.isMainFrame])
+    }
+}
+
+/// Content blockers (an ad blocker's lists): compiled once by WebKit, kept on disk by identifier and
+/// version, and applied to every tab except on the sites the person allowed.
+final class CraftMacContentRules {
+    static let shared = CraftMacContentRules()
+    private(set) var lists: [String: WKContentRuleList] = [:]
+    /// Sites where no list applies; a host here covers its subdomains.
+    var allowed: Set<String> = []
+
+    func isAllowed(_ host: String?) -> Bool {
+        guard var host = host?.lowercased() else { return false }
+        while true {
+            if allowed.contains(host) { return true }
+            guard let dot = host.firstIndex(of: ".") else { return false }
+            host = String(host[host.index(after: dot)...])
+        }
+    }
+
+    func apply(to tab: CraftMacTab, host: String?) {
+        let controller = tab.view.configuration.userContentController
+        controller.removeAllContentRuleLists()
+        guard !isAllowed(host ?? tab.view.url?.host) else { return }
+        for list in lists.values { controller.add(list) }
+    }
+
+    func reapply() { for tab in CraftMacWebTabs.shared.tabs.values { apply(to: tab, host: tab.blockingHost) } }
+
+    /// A list by identifier and version: the compiled copy on disk when there is one, else compiled
+    /// from `json` (WebKit's content-blocker format). Without `json` and nothing on disk, `missing`.
+    func set(_ identifier: String, version: String, json: String?, answer: @escaping (Any) -> Void, fail: @escaping (String, String) -> Void) {
+        guard let store = WKContentRuleListStore.default() else { fail("UNAVAILABLE", "WebKit has no content rule list store"); return }
+        let key = "\(identifier)@\(version)"
+        store.lookUpContentRuleList(forIdentifier: key) { [weak self] found, _ in
+            guard let self else { return }
+            if let found {
+                self.lists[identifier] = found; self.reapply(); answer(["identifier": identifier, "cached": true]); return
+            }
+            guard let json, !json.isEmpty else { answer(["identifier": identifier, "missing": true]); return }
+            store.compileContentRuleList(forIdentifier: key, encodedContentRuleList: json) { list, error in
+                guard let list else { fail("COMPILE_FAILED", error?.localizedDescription ?? "WebKit did not compile \(identifier)"); return }
+                self.lists[identifier] = list; self.reapply()
+                // Older versions of the same list are only disk space now.
+                store.getAvailableContentRuleListIdentifiers { keys in
+                    for old in keys ?? [] where old.hasPrefix("\(identifier)@") && old != key { store.removeContentRuleList(forIdentifier: old) { _ in } }
+                }
+                answer(["identifier": identifier, "cached": false])
+            }
+        }
+    }
+
+    func remove(_ identifier: String) { lists.removeValue(forKey: identifier); reapply() }
+}
+
+/// Scripts and styles for sites: a person's Boosts, or an ad blocker's page scripts. Each names the
+/// hosts it runs on (a host covers its subdomains; none, or `*`, is every site). By default they run in
+/// an isolated world the page's scripts cannot see; `world: 'page'` runs one in the page's own world,
+/// for a script that must wrap the page's `fetch` before the site does. CSS lands at document start,
+/// JS at document end unless `at: 'start'`.
+final class CraftMacUserScripts {
+    static let shared = CraftMacUserScripts()
+    private var scripts: [WKUserScript] = []
+
+    func set(_ entries: [[String: Any]]) {
+        scripts = entries.flatMap { entry -> [WKUserScript] in
+            let hosts = (entry["hosts"] as? [String] ?? []).map { $0.lowercased() }.filter { !$0.isEmpty }
+            let everySite = hosts.isEmpty || hosts.contains("*")
+            guard let hostsJSON = try? JSONSerialization.data(withJSONObject: hosts), let hostList = String(data: hostsJSON, encoding: .utf8) else { return [] }
+            let guardLine = everySite ? "" : "if (!\(hostList).some(h => location.hostname === h || location.hostname.endsWith('.' + h))) return;"
+            let world: WKContentWorld = entry["world"] as? String == "page" ? .page : .defaultClient
+            let scriptTime: WKUserScriptInjectionTime = entry["at"] as? String == "start" ? .atDocumentStart : .atDocumentEnd
+            let allFrames = entry["allFrames"] as? Bool == true
+            var made: [WKUserScript] = []
+            if let css = entry["css"] as? String, !css.isEmpty, let cssJSON = try? JSONSerialization.data(withJSONObject: [css]), let cssLiteral = String(data: cssJSON, encoding: .utf8) {
+                let id = (entry["id"] as? String ?? "boost").replacingOccurrences(of: "\"", with: "")
+                let source = "(() => { \(guardLine) const s = document.createElement('style'); s.dataset.craftBoost = \"\(id)\"; s.textContent = \(cssLiteral)[0]; (document.head || document.documentElement).appendChild(s) })()"
+                made.append(WKUserScript(source: source, injectionTime: .atDocumentStart, forMainFrameOnly: !allFrames, in: world))
+            }
+            if let js = entry["js"] as? String, !js.isEmpty {
+                made.append(WKUserScript(source: "(() => { \(guardLine)\n\(js)\n})()", injectionTime: scriptTime, forMainFrameOnly: !allFrames, in: world))
+            }
+            return made
+        }
+        // Pages pick the new set up on their next load.
+        for tab in CraftMacWebTabs.shared.tabs.values { apply(to: tab.view.configuration.userContentController) }
+    }
+
+    func apply(to controller: WKUserContentController) {
+        controller.removeAllUserScripts()
+        scripts.forEach(controller.addUserScript)
+    }
 }
 
 /// Downloads started by any tab, saved to ~/Downloads under a name that never overwrites.
@@ -242,10 +364,12 @@ final class CraftMacDownloads: NSObject, WKDownloadDelegate {
     static let shared = CraftMacDownloads()
     private struct Entry { let id: String; weak var tab: CraftMacTab?; var path: String; var observation: NSKeyValueObservation? }
     private var entries: [ObjectIdentifier: Entry] = [:]
+    private var downloads: [WKDownload] = []
     private var lastReport: [String: CFAbsoluteTime] = [:]
 
     func adopt(_ download: WKDownload, tab: CraftMacTab) {
         download.delegate = self
+        downloads.append(download)
         let id = UUID().uuidString
         var entry = Entry(id: id, tab: tab, path: "")
         entry.observation = download.progress.observe(\.fractionCompleted) { [weak self, weak download] _, _ in
@@ -288,7 +412,25 @@ final class CraftMacDownloads: NSObject, WKDownloadDelegate {
         entry.tab?.emit("download", detail)
     }
 
+    /// Stop a download that is still running; what arrived is kept as resume data no one uses yet.
+    func cancel(_ id: String) -> Bool {
+        guard let download = downloads.first(where: { entries[ObjectIdentifier($0)]?.id == id }) else { return false }
+        download.cancel { _ in }
+        report(download, state: "failed", extra: ["message": "Cancelled", "cancelled": true])
+        finish(download)
+        return true
+    }
+
+    /// A file in ~/Downloads (after resolving links), or nil: the screen may only point at downloads.
+    static func downloadedFile(_ path: String) -> URL? {
+        let folder = FileManager.default.urls(for: .downloadsDirectory, in: .userDomainMask)[0].resolvingSymlinksInPath().standardizedFileURL.path
+        let file = URL(fileURLWithPath: path).resolvingSymlinksInPath().standardizedFileURL
+        guard file.path.hasPrefix(folder + "/"), FileManager.default.fileExists(atPath: file.path) else { return nil }
+        return file
+    }
+
     private func finish(_ download: WKDownload) {
+        downloads.removeAll { $0 === download }
         if let entry = entries.removeValue(forKey: ObjectIdentifier(download)) { entry.observation?.invalidate(); lastReport.removeValue(forKey: entry.id) }
     }
 }
@@ -300,11 +442,11 @@ final class CraftMacWebTabs {
     private let hosts = NSHashTable<CraftMacWebHost>.weakObjects()
 
     @discardableResult
-    func make(id: String? = nil, profile: String = "default", ephemeral: Bool = false, configuration: WKWebViewConfiguration? = nil, owner: CraftMacRuntime?) -> CraftMacTab {
+    func make(id: String? = nil, profile: String = "default", ephemeral: Bool = false, configuration: WKWebViewConfiguration? = nil, owner: CraftMacRuntime?, ownContent: Bool = true) -> CraftMacTab {
         let id = id.flatMap { $0.isEmpty ? nil : $0 } ?? UUID().uuidString.lowercased()
         if let existing = tabs[id] { return existing }
         let tab = CraftMacTab(id: id, profile: profile, ephemeral: ephemeral,
-            configuration: configuration ?? CraftMacWebProfiles.shared.configuration(profile: profile, ephemeral: ephemeral), owner: owner)
+            configuration: configuration ?? CraftMacWebProfiles.shared.configuration(profile: profile, ephemeral: ephemeral), owner: owner, ownContent: ownContent)
         tabs[id] = tab
         // A `<WebView>` may have named this tab before it existed (the render and the create cross).
         for host in hosts.allObjects where host.wanted == id { host.show(id) }
@@ -313,7 +455,44 @@ final class CraftMacWebTabs {
 
     func register(_ host: CraftMacWebHost) { hosts.add(host) }
 
-    func close(_ id: String) { tabs.removeValue(forKey: id)?.close() }
+    /// Permission requests waiting for the screen, by request id. Unanswered ones are denied after two minutes.
+    private var pending: [String: (tab: String, decide: (WKPermissionDecision) -> Void)] = [:]
+    func ask(tab: CraftMacTab, decide: @escaping (WKPermissionDecision) -> Void) -> String {
+        let request = UUID().uuidString
+        pending[request] = (tab.id, decide)
+        DispatchQueue.main.asyncAfter(deadline: .now() + 120) { [weak self] in self?.answer(request, .deny) }
+        return request
+    }
+    @discardableResult
+    func answer(_ request: String, _ decision: WKPermissionDecision) -> Bool {
+        guard let waiting = pending.removeValue(forKey: request) else { return false }
+        waiting.decide(decision); return true
+    }
+
+    func close(_ id: String) {
+        for (request, waiting) in pending where waiting.tab == id { answer(request, .deny) }
+        tabs.removeValue(forKey: id)?.close()
+    }
+
+    /// Cookies, storage and caches of a profile: one site's (`host`, matched by its registrable
+    /// domain as WebKit names records) or everything.
+    func clearData(_ options: [String: Any], answer: @escaping (Any) -> Void) {
+        let store = CraftMacWebProfiles.shared.store(profile: options["profile"] as? String ?? "default", ephemeral: options["private"] as? Bool == true)
+        let kinds: [String: [String]] = [
+            "cookies": [WKWebsiteDataTypeCookies],
+            "storage": [WKWebsiteDataTypeLocalStorage, WKWebsiteDataTypeSessionStorage, WKWebsiteDataTypeIndexedDBDatabases, WKWebsiteDataTypeServiceWorkerRegistrations],
+            "cache": [WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache, WKWebsiteDataTypeFetchCache, WKWebsiteDataTypeOfflineWebApplicationCache],
+        ]
+        let asked = options["types"] as? [String] ?? Array(kinds.keys)
+        let types = Set(asked.flatMap { kinds[$0] ?? [] })
+        guard let host = (options["host"] as? String)?.lowercased(), !host.isEmpty else {
+            store.removeData(ofTypes: types, modifiedSince: .distantPast) { answer(["cleared": true]) }; return
+        }
+        store.fetchDataRecords(ofTypes: types) { records in
+            let matching = records.filter { host == $0.displayName || host.hasSuffix("." + $0.displayName) }
+            store.removeData(ofTypes: types, for: matching) { answer(["cleared": true, "records": matching.count]) }
+        }
+    }
 
     /// A closed window takes its tabs with it.
     func closeAll(owner: CraftMacRuntime) {
@@ -332,6 +511,30 @@ final class CraftMacWebTabs {
             answer(tab.state); return
         }
         if method == "list" { answer(tabs.values.map(\.state)); return }
+        switch method {
+        case "setContentRules":
+            guard let identifier = args.first as? String, !identifier.isEmpty else { fail("INVALID_ARGUMENT", "setContentRules needs an identifier"); return }
+            let list = args.dropFirst().first as? [String: Any] ?? [:]
+            CraftMacContentRules.shared.set(identifier, version: list["version"] as? String ?? "1", json: list["json"] as? String, answer: answer, fail: fail); return
+        case "removeContentRules": CraftMacContentRules.shared.remove(args.first as? String ?? ""); answer(true); return
+        case "allowContent":
+            CraftMacContentRules.shared.allowed = Set((args.first as? [String] ?? []).map { $0.lowercased() })
+            CraftMacContentRules.shared.reapply(); answer(true); return
+        case "setUserScripts": CraftMacUserScripts.shared.set(args.first as? [[String: Any]] ?? []); answer(true); return
+        case "answerPermission":
+            let decision: WKPermissionDecision = { switch args.dropFirst().first as? String { case "grant": return .grant; case "prompt": return .prompt; default: return .deny } }()
+            answer(self.answer(args.first as? String ?? "", decision)); return
+        case "clearData": clearData(options, answer: answer); return
+        case "cancelDownload": answer(CraftMacDownloads.shared.cancel(args.first as? String ?? "")); return
+        case "revealDownload", "openDownload":
+            guard let file = CraftMacDownloads.downloadedFile(args.first as? String ?? "") else { fail("NOT_FOUND", "Not a file in Downloads"); return }
+            // An app or a script is revealed, never run: opening it is the person's call in Finder.
+            let runnable = (try? file.resourceValues(forKeys: [.contentTypeKey]))?.contentType.map { $0.conforms(to: .application) || $0.conforms(to: .executable) || $0.conforms(to: .script) } ?? true
+            if method == "openDownload" && !runnable { answer(NSWorkspace.shared.open(file)) }
+            else { NSWorkspace.shared.activateFileViewerSelecting([file]); answer(true) }
+            return
+        default: break
+        }
         guard let id = args.first as? String, let tab = tabs[id] else { fail("NOT_FOUND", "No tab \(String(describing: args.first ?? ""))"); return }
         let view = tab.view
         switch method {
@@ -368,6 +571,11 @@ final class CraftMacWebTabs {
             configuration.caseSensitive = options["caseSensitive"] as? Bool == true
             configuration.wraps = options["wraps"] as? Bool ?? true
             view.find(text, configuration: configuration) { result in answer(["found": result.matchFound]) }
+        case "print":
+            let operation = view.printOperation(with: .shared)
+            operation.view?.frame = view.bounds
+            if let window = view.window { operation.runModal(for: window, delegate: nil, didRun: nil, contextInfo: nil) } else { operation.run() }
+            answer(true)
         case "snapshot":
             let configuration = WKSnapshotConfiguration()
             if let width = number((args.dropFirst().first as? [String: Any])?["width"]) { configuration.snapshotWidth = NSNumber(value: Double(width)) }

package/package.json

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