@swiftbrowser/native 0.15.0 → 0.17.0

package/README.md

@@ -126,6 +126,16 @@ worker. Drawn in a page (`site`), `createWorker` returns the page's own
 is the same in all three places. The iOS app's `WebAssembly` is the engine's
 interpreter (a third-party app has no JIT), and SIMD in it needs iOS 26.2.
 
+```ts
+const worker = createWorker('satoru', { engine: 'webview' });
+```
+
+`engine: 'webview'` runs the same bundle in a hidden `WKWebView` instead,
+whose web content process does compile JavaScript and WebAssembly with its
+JIT: much faster for heavy WebAssembly, for a process and a web
+view's memory. Its `fetch` still goes through the app's `URLSession`, with
+the app's cookies; a page's own `Worker` ignores the option.
+
 ## URLs the app is opened with
 
 ```ts

package/dist/bridge.d.ts

@@ -27,14 +27,26 @@ export interface NativeBridge {
     locale(): string;
     /** The process's launch arguments (`-screen list` from an Xcode scheme or `simctl launch`). */
     launchArguments?(): string[];
-    /** Starts worker `id` from `<name>.worker.js`; returns an error message, or nothing. Its messages arrive at `__sbWorkerMessage(id, text)`, its errors at `__sbWorkerError(id, message)`. */
-    workerStart?(id: number, name: string): string | null | undefined;
+    /**
+     * Starts worker `id` from `<name>.worker.js` in `engine` (`'context'`
+     * when absent; hosts before 0.16 take no engine); returns an error
+     * message, or nothing. Its messages arrive at `__sbWorkerMessage(id, text)`,
+     * its errors at `__sbWorkerError(id, message)`.
+     */
+    workerStart?(id: number, name: string, engine?: WorkerEngine): string | null | undefined;
     /** Delivers an encoded message (worker.ts) to worker `id`'s `__sbWorkerReceive(text)`. */
     workerPost?(id: number, text: string): void;
     workerTerminate?(id: number): void;
     /** In a worker's context: an encoded message to the app's context. */
     workerPostMessage?(text: string): void;
 }
+/**
+ * Where a native worker runs: `'context'`, a JavaScriptCore context on a
+ * thread of the app's; `'webview'`, a hidden `WKWebView`, whose web content
+ * process has WebKit's JIT (an app's own JavaScriptCore has none on iOS),
+ * for heavy WebAssembly.
+ */
+export type WorkerEngine = 'context' | 'webview';
 /** The app's launch arguments, or none outside the native app. */
 export declare function launchArguments(): string[];
 export interface NativeFetchRequest {

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,GAAG,IAAI,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAC9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,YAAY,IAAI,IAAI,CAAC;IACrB,sCAAsC;IACtC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,gDAAgD;IAChD,MAAM,IAAI,MAAM,CAAC;IACjB,+FAA+F;IAC/F,eAAe,CAAC,IAAI,MAAM,EAAE,CAAC;IAM7B,4LAA4L;IAC5L,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,0FAA0F;IAC1F,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,sEAAsE;IACtE,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,GAAE,OAAO,UAAuB,GAAG,YAAY,GAAG,SAAS,CAExF"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,GAAG,IAAI,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAC9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,YAAY,IAAI,IAAI,CAAC;IACrB,sCAAsC;IACtC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,gDAAgD;IAChD,MAAM,IAAI,MAAM,CAAC;IACjB,+FAA+F;IAC/F,eAAe,CAAC,IAAI,MAAM,EAAE,CAAC;IAM7B;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzF,0FAA0F;IAC1F,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,sEAAsE;IACtE,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,GAAE,OAAO,UAAuB,GAAG,YAAY,GAAG,SAAS,CAExF"}

package/dist/bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AA2CA,kEAAkE;AAClE,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC;AAoBD,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAuB,UAAU;IAC5D,OAAQ,CAA8C,CAAC,UAAU,CAAC;AACpE,CAAC"}
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAwDA,kEAAkE;AAClE,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC;AAoBD,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAuB,UAAU;IAC5D,OAAQ,CAA8C,CAAC,UAAU,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -13,10 +13,10 @@
 export { run, type RunOptions, type Running } from './run';
 export { Native, type NativeProps } from './native';
 export { installRuntime, type InstallOptions } from './runtime';
-export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult } from './bridge';
+export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult, type WorkerEngine } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
-export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
+export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type NativeWorkerOptions, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
 export { onOpenURL } from './openURL';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7H,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjK,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAsE,MAAM,UAAU,CAAC;AAC7H,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAmE,MAAM,UAAU,CAAC;AACjK,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAyF,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6F,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/worker.d.ts

@@ -16,8 +16,13 @@
  * worker.onmessage = (event) => console.log(event.data);
  * worker.postMessage({ draw: 'something' });
  * ```
+ *
+ * `createWorker(name, { engine: 'webview' })` runs the same bundle in a
+ * hidden `WKWebView` instead (WebViewWorkerHost.swift): WebKit's web
+ * content process compiles with its JIT, which an app's own JavaScriptCore
+ * may not on iOS, so heavy WebAssembly runs much faster there.
  */
-import { type NativeBridge } from './bridge';
+import { type NativeBridge, type WorkerEngine } from './bridge';
 /** What `Worker` and a worker's `self` have in common, as an app uses them. */
 export interface WorkerLike {
     postMessage(data: unknown, transfer?: unknown[]): void;
@@ -45,6 +50,14 @@ export interface WorkerErrorEvent {
 export declare function encodeMessage(data: unknown): string;
 /** The value `encodeMessage` encoded. */
 export declare function decodeMessage(text: string): unknown;
+/** How a worker is started. */
+export interface NativeWorkerOptions {
+    /** Where it runs in the native app (bridge.ts): `'context'` (the default) or `'webview'`. A page's own `Worker` ignores it. */
+    engine?: WorkerEngine;
+    /** A page's `Worker` options, accepted and ignored: a bundle is one script. */
+    type?: 'classic' | 'module';
+    name?: string;
+}
 type Listener<E> = (event: E) => void;
 /** `Worker` over the bridge, in the app's context. */
 export declare class NativeWorker implements WorkerLike {
@@ -56,7 +69,7 @@ export declare class NativeWorker implements WorkerLike {
     /** `name` is the bundle's: `<name>.worker.js` next to app.js. A URL's last path segment serves as the name (`render.worker.js` → `render`). */
     constructor(name: string | {
         href: string;
-    } | URL, native?: NativeBridge | undefined);
+    } | URL, options?: NativeWorkerOptions, native?: NativeBridge | undefined);
     postMessage(data: unknown): void;
     terminate(): void;
     addEventListener(type: 'message', listener: Listener<WorkerMessageEvent>): void;
@@ -74,9 +87,9 @@ export declare function workerName(name: string | {
 /**
  * A worker from the bundle `<name>.worker.js`: the page's own `Worker` when
  * the app is drawn in a page (the bundle published with the site), else the
- * host's over the bridge.
+ * host's over the bridge, in `options.engine`.
  */
-export declare function createWorker(name: string): WorkerLike;
+export declare function createWorker(name: string, options?: NativeWorkerOptions): WorkerLike;
 /**
  * A worker's own globals over its bridge: `self`, `postMessage`, `onmessage`
  * and `onerror` as properties the script assigns, `addEventListener`,

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAM9E,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvD,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IACvF,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IACnF,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CACxF;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAWnD;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBnD;AAID,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,+HAA+H;IAC/H,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtC,sDAAsD;AACtD,qBAAa,YAAa,YAAW,UAAU;;IAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAK;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAmC;IAM/D,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAQ;IACtD,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAQ;IAElD,+IAA+I;gBACnI,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,GAAG,EAAE,OAAO,GAAE,mBAAwB,EAAE,MAAM,GAAE,YAAY,GAAG,SAA0B;IAcvI,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKhC,SAAS,IAAI,IAAI;IAOjB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAC/E,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAM3E,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI;IAK/E,kDAAkD;IAClD,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ9C,wFAAwF;IACxF,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAO/C;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,GAAG,MAAM,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAOxF;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CA0BlG"}

package/dist/worker.js

@@ -16,6 +16,11 @@
  * worker.onmessage = (event) => console.log(event.data);
  * worker.postMessage({ draw: 'something' });
  * ```
+ *
+ * `createWorker(name, { engine: 'webview' })` runs the same bundle in a
+ * hidden `WKWebView` instead (WebViewWorkerHost.swift): WebKit's web
+ * content process compiles with its JIT, which an app's own JavaScriptCore
+ * may not on iOS, so heavy WebAssembly runs much faster there.
  */
 import { nativeBridge } from './bridge';
 import { base64Decode, base64Encode } from './encoding';
@@ -91,14 +96,14 @@ export class NativeWorker {
     onmessage = null;
     onerror = null;
     /** `name` is the bundle's: `<name>.worker.js` next to app.js. A URL's last path segment serves as the name (`render.worker.js` → `render`). */
-    constructor(name, native = nativeBridge()) {
+    constructor(name, options = {}, native = nativeBridge()) {
         if (!native?.workerStart || !native.workerPost || !native.workerTerminate) {
             throw new Error('Worker: this host has no workers (SwiftBrowser Native 0.13 or later)');
         }
         this.#native = native;
         this.#id = NativeWorker.nextId++;
         NativeWorker.live.set(this.#id, this);
-        const failure = native.workerStart(this.#id, workerName(name));
+        const failure = native.workerStart(this.#id, workerName(name), options.engine);
         if (failure) {
             NativeWorker.live.delete(this.#id);
             throw new Error(failure);
@@ -158,15 +163,15 @@ export function workerName(name) {
 /**
  * A worker from the bundle `<name>.worker.js`: the page's own `Worker` when
  * the app is drawn in a page (the bundle published with the site), else the
- * host's over the bridge.
+ * host's over the bridge, in `options.engine`.
  */
-export function createWorker(name) {
+export function createWorker(name, options = {}) {
     const base = typeof __SB_WORKER_BASE__ === 'string' ? __SB_WORKER_BASE__ : undefined;
     const PageWorker = globalThis.Worker;
     if (typeof PageWorker === 'function' && base !== undefined)
         return new PageWorker(`${base}${workerName(name)}.worker.js`);
     if (nativeBridge()?.workerStart)
-        return new NativeWorker(name);
+        return new NativeWorker(name, options);
     if (typeof PageWorker === 'function')
         return new PageWorker(`${workerName(name)}.worker.js`);
     throw new Error(`createWorker: no host for "${name}" (not in a SwiftBrowser Native app or a page)`);

package/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAwC,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0BxD,iBAAiB;AAEjB,MAAM,YAAY,GAAG;IACnB,UAAU;IACV,iBAAiB;IACjB,SAAS;IACT,WAAW;IACX,UAAU;IACV,WAAW;IACX,UAAU;IACV,YAAY;IACZ,YAAY;CACJ,CAAC;AAGX;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QAC/E,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACnH,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAI,KAAK,CAAC,WAAiC,CAAC,IAAI,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/E,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QACxG,CAAC;QACD,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,CAAC;QAC1H,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QAC/C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/B,IAAI,IAAI,KAAK,aAAa;oBAAE,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7G,MAAM,WAAW,GAAG,YAAY,CAAE,IAAuB,IAAI,YAAY,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;gBACrH,+DAA+D;gBAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAgB,CAAC;gBACxG,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACjE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAA+D,CAAC;gBAC9F,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC5C,IAAI,IAAI,CAAC,IAAI;oBAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACtC,IAAI,IAAI,CAAC,KAAK;oBAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBACzC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAeD,sDAAsD;AACtD,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,MAAM,CAAU,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtD,GAAG,CAAS;IACZ,OAAO,CAAe;IAC/B,WAAW,GAAG,KAAK,CAAC;IACX,iBAAiB,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC5D,eAAe,GAAG,IAAI,GAAG,EAA8B,CAAC;IACjE,SAAS,GAAwC,IAAI,CAAC;IACtD,OAAO,GAAsC,IAAI,CAAC;IAElD,+IAA+I;IAC/I,YAAY,IAAqC,EAAE,UAA+B,EAAE,EAAE,SAAmC,YAAY,EAAE;QACrI,IAAI,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;QACjC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/E,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,IAAa;QACvB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAW,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,eAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAID,gBAAgB,CAAC,IAAyB,EAAE,QAAyB;QACnE,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAwC,CAAC,CAAC;;YACxF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAsC,CAAC,CAAC;IACxE,CAAC;IAED,mBAAmB,CAAC,IAAyB,EAAE,QAAyB;QACtE,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAwC,CAAC,CAAC;;YAC3F,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAsC,CAAC,CAAC;IAC3E,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,IAAY;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,KAAK,GAAuB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACjF,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,IAAI,CAAC,EAAU,EAAE,OAAe;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC3D,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,eAAe;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;;AAGH,mGAAmG;AACnG,MAAM,UAAU,UAAU,CAAC,IAAqC;IAC9D,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,UAA+B,EAAE;IAC1E,MAAM,IAAI,GAAG,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,UAAU,GAAI,UAA2D,CAAC,MAAM,CAAC;IACvF,IAAI,OAAO,UAAU,KAAK,UAAU,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,UAAU,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1H,IAAI,YAAY,EAAE,EAAE,WAAW;QAAE,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxE,IAAI,OAAO,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,UAAU,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7F,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,gDAAgD,CAAC,CAAC;AACtG,CAAC;AAED,0BAA0B;AAE1B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB,EAAE,MAA+B;IACtF,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAAc,EAAQ,EAAE;QACpD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACtG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgC,CAAC;IACjE,MAAM,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,aAAa,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,kBAAkB,EAAE,CAAC,IAAY,EAAE,QAAyB,EAAE,EAAE;QACrE,IAAI,IAAI,KAAK,SAAS;YAAE,gBAAgB,CAAC,GAAG,CAAC,QAAwC,CAAC,CAAC;aAClF,IAAI,IAAI,KAAK,OAAO;YAAE,cAAc,CAAC,GAAG,CAAC,QAAsC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,qBAAqB,EAAE,CAAC,IAAY,EAAE,QAAyB,EAAE,EAAE;QACxE,IAAI,IAAI,KAAK,SAAS;YAAE,gBAAgB,CAAC,MAAM,CAAC,QAAwC,CAAC,CAAC;aACrF,IAAI,IAAI,KAAK,OAAO;YAAE,cAAc,CAAC,MAAM,CAAC,QAAsC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,mDAAmD,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,mBAAmB,EAAE,CAAC,IAAY,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAuB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACjF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAG,OAAwC,CAAC,KAAK,CAAC,CAAC;QACpF,KAAK,MAAM,QAAQ,IAAI,gBAAgB;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftbrowser/native",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "type": "module",
   "description": "Run a @swiftbrowser/react app natively: the runtime a JavaScriptCore-hosted app needs (timers, console, fetch and the other web globals over the SwiftBrowser Native bridge), the `run` entry that renders into the native SwiftUI renderer, and the bundler that builds app.js for the Xcode target.",
   "repository": {
@@ -59,8 +59,8 @@
   },
   "dependencies": {
     "@babel/core": "^7.29.7",
-    "@swiftbrowser/react": "0.15.0",
-    "@swiftbrowser/web": "0.15.0",
+    "@swiftbrowser/react": "0.17.0",
+    "@swiftbrowser/web": "0.17.0",
     "esbuild": "^0.28.2",
     "react-refresh": "^0.17.0"
   },

package/src/bridge.ts

@@ -32,8 +32,13 @@ export interface NativeBridge {
   // `swiftbrowser-native build --worker <name>=<entry>` wrote next to app.js
   // (`<name>.worker.js`). The app's context has the first three; a worker's
   // context has the last and no `applyOps`.
-  /** Starts worker `id` from `<name>.worker.js`; returns an error message, or nothing. Its messages arrive at `__sbWorkerMessage(id, text)`, its errors at `__sbWorkerError(id, message)`. */
-  workerStart?(id: number, name: string): string | null | undefined;
+  /**
+   * Starts worker `id` from `<name>.worker.js` in `engine` (`'context'`
+   * when absent; hosts before 0.16 take no engine); returns an error
+   * message, or nothing. Its messages arrive at `__sbWorkerMessage(id, text)`,
+   * its errors at `__sbWorkerError(id, message)`.
+   */
+  workerStart?(id: number, name: string, engine?: WorkerEngine): string | null | undefined;
   /** Delivers an encoded message (worker.ts) to worker `id`'s `__sbWorkerReceive(text)`. */
   workerPost?(id: number, text: string): void;
   workerTerminate?(id: number): void;
@@ -41,6 +46,14 @@ export interface NativeBridge {
   workerPostMessage?(text: string): void;
 }
 
+/**
+ * Where a native worker runs: `'context'`, a JavaScriptCore context on a
+ * thread of the app's; `'webview'`, a hidden `WKWebView`, whose web content
+ * process has WebKit's JIT (an app's own JavaScriptCore has none on iOS),
+ * for heavy WebAssembly.
+ */
+export type WorkerEngine = 'context' | 'webview';
+
 /** The app's launch arguments, or none outside the native app. */
 export function launchArguments(): string[] {
   const native = nativeBridge();

package/src/index.ts

@@ -14,9 +14,9 @@
 export { run, type RunOptions, type Running } from './run';
 export { Native, type NativeProps } from './native';
 export { installRuntime, type InstallOptions } from './runtime';
-export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult } from './bridge';
+export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult, type WorkerEngine } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
-export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
+export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type NativeWorkerOptions, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
 export { onOpenURL } from './openURL';

package/src/worker.ts

@@ -16,9 +16,14 @@
  * worker.onmessage = (event) => console.log(event.data);
  * worker.postMessage({ draw: 'something' });
  * ```
+ *
+ * `createWorker(name, { engine: 'webview' })` runs the same bundle in a
+ * hidden `WKWebView` instead (WebViewWorkerHost.swift): WebKit's web
+ * content process compiles with its JIT, which an app's own JavaScriptCore
+ * may not on iOS, so heavy WebAssembly runs much faster there.
  */
 
-import { nativeBridge, type NativeBridge } from './bridge';
+import { nativeBridge, type NativeBridge, type WorkerEngine } from './bridge';
 import { base64Decode, base64Encode } from './encoding';
 
 /** The site's published path for worker bundles (`/native/bundle/App/`), defined by `swiftbrowser-native site`; undefined in an Xcode bundle. */
@@ -107,6 +112,15 @@ export function decodeMessage(text: string): unknown {
 
 // MARK: The app's side
 
+/** How a worker is started. */
+export interface NativeWorkerOptions {
+  /** Where it runs in the native app (bridge.ts): `'context'` (the default) or `'webview'`. A page's own `Worker` ignores it. */
+  engine?: WorkerEngine;
+  /** A page's `Worker` options, accepted and ignored: a bundle is one script. */
+  type?: 'classic' | 'module';
+  name?: string;
+}
+
 type Listener<E> = (event: E) => void;
 
 /** `Worker` over the bridge, in the app's context. */
@@ -122,14 +136,14 @@ export class NativeWorker implements WorkerLike {
   onerror: Listener<WorkerErrorEvent> | null = null;
 
   /** `name` is the bundle's: `<name>.worker.js` next to app.js. A URL's last path segment serves as the name (`render.worker.js` → `render`). */
-  constructor(name: string | { href: string } | URL, native: NativeBridge | undefined = nativeBridge()) {
+  constructor(name: string | { href: string } | URL, options: NativeWorkerOptions = {}, native: NativeBridge | undefined = nativeBridge()) {
     if (!native?.workerStart || !native.workerPost || !native.workerTerminate) {
       throw new Error('Worker: this host has no workers (SwiftBrowser Native 0.13 or later)');
     }
     this.#native = native;
     this.#id = NativeWorker.nextId++;
     NativeWorker.live.set(this.#id, this);
-    const failure = native.workerStart(this.#id, workerName(name));
+    const failure = native.workerStart(this.#id, workerName(name), options.engine);
     if (failure) {
       NativeWorker.live.delete(this.#id);
       throw new Error(failure);
@@ -189,13 +203,13 @@ export function workerName(name: string | { href: string } | URL): string {
 /**
  * A worker from the bundle `<name>.worker.js`: the page's own `Worker` when
  * the app is drawn in a page (the bundle published with the site), else the
- * host's over the bridge.
+ * host's over the bridge, in `options.engine`.
  */
-export function createWorker(name: string): WorkerLike {
+export function createWorker(name: string, options: NativeWorkerOptions = {}): WorkerLike {
   const base = typeof __SB_WORKER_BASE__ === 'string' ? __SB_WORKER_BASE__ : undefined;
   const PageWorker = (globalThis as { Worker?: new (url: string) => WorkerLike }).Worker;
   if (typeof PageWorker === 'function' && base !== undefined) return new PageWorker(`${base}${workerName(name)}.worker.js`);
-  if (nativeBridge()?.workerStart) return new NativeWorker(name);
+  if (nativeBridge()?.workerStart) return new NativeWorker(name, options);
   if (typeof PageWorker === 'function') return new PageWorker(`${workerName(name)}.worker.js`);
   throw new Error(`createWorker: no host for "${name}" (not in a SwiftBrowser Native app or a page)`);
 }

package/swift/Sources/SwiftBrowserNative/Host/HostBridge.swift

@@ -27,7 +27,7 @@ import FoundationBridge // the shim's Foundation stand-ins (ShimAliases.swift)
 /// | `openURL(url)` | the system opener |
 /// | `locale()` | the viewer's locale identifier |
 /// | `launchArguments()` | the process's arguments (`-screen list` from a scheme or `simctl launch`) |
-/// | `workerStart(id, name)`, `workerPost(id, text)`, `workerTerminate(id)` | workers (WorkerHost.swift, JavaScriptCore only); their messages come to `__sbWorkerMessage(id, text)`, their errors to `__sbWorkerError(id, message)` |
+/// | `workerStart(id, name, engine)`, `workerPost(id, text)`, `workerTerminate(id)` | workers (JavaScriptCore only): a `JSContext` on a thread (`"context"`, WorkerHost.swift) or a hidden web view with WebKit's JIT (`"webview"`, WebViewWorkerHost.swift); their messages come to `__sbWorkerMessage(id, text)`, their errors to `__sbWorkerError(id, message)` |
 ///
 /// Everything JavaScript-facing runs on the main thread; work that is not
 /// (a fetch, a worker) hops back before calling in.
@@ -37,7 +37,7 @@ final class HostBridge {
     private let tree: OpTree
     private var timers: [Int: Timer] = [:]
     #if canImport(JavaScriptCore)
-    private var workers: [Int: WorkerHost] = [:]
+    private var workers: [Int: any WorkerEngine] = [:]
     #endif
     private let logger = Logger(subsystem: "swiftbrowser", category: "js")
     private let session = URLSession(configuration: .default)
@@ -180,16 +180,28 @@ final class HostBridge {
             guard let self, let id = arguments[safe: 0]?.int, let name = arguments[safe: 1]?.string else {
                 return .string("workerStart: expected an id and a name")
             }
+            let onMessage: @Sendable (String) -> Void = { [weak self] text in
+                DispatchQueue.main.async {
+                    MainActor.assumeIsolated { self?.callIn("__sbWorkerMessage", [.number(Double(id)), .string(text)]) }
+                }
+            }
+            let onError: @Sendable (String) -> Void = { [weak self] message in
+                DispatchQueue.main.async {
+                    MainActor.assumeIsolated { self?.callIn("__sbWorkerError", [.number(Double(id)), .string(message)]) }
+                }
+            }
             do {
-                let worker = try WorkerHost(name: name, onMessage: { [weak self] text in
-                    DispatchQueue.main.async {
-                        MainActor.assumeIsolated { self?.callIn("__sbWorkerMessage", [.number(Double(id)), .string(text)]) }
-                    }
-                }, onError: { [weak self] message in
-                    DispatchQueue.main.async {
-                        MainActor.assumeIsolated { self?.callIn("__sbWorkerError", [.number(Double(id)), .string(message)]) }
-                    }
-                })
+                let worker: any WorkerEngine
+                switch arguments[safe: 2]?.string ?? "context" {
+                case "context":
+                    worker = try WorkerHost(name: name, onMessage: onMessage, onError: onError)
+                #if canImport(WebKit)
+                case "webview":
+                    worker = try WebViewWorkerHost(name: name, onMessage: onMessage, onError: onError)
+                #endif
+                case let engine:
+                    return .string("workerStart: no \(engine) engine here (\"context\" or \"webview\")")
+                }
                 self.workers[id]?.terminate()
                 self.workers[id] = worker
                 worker.start()

package/swift/Sources/SwiftBrowserNative/Host/WebViewWorkerHost.swift

@@ -0,0 +1,315 @@
+#if canImport(SwiftUI) && canImport(JavaScriptCore) && canImport(WebKit)
+import Foundation
+import os
+import SwiftBrowserProtocol
+import WebKit
+#if canImport(UIKit)
+import UIKit
+#endif
+
+/// A worker in a hidden `WKWebView` (`createWorker(name, { engine: 'webview' })`):
+/// the same `<name>.worker.js` and the same messages as WorkerHost.swift's
+/// `JSContext`, run by WebKit's web content process, which compiles
+/// JavaScript and WebAssembly with its JIT. An app's own JavaScriptCore has
+/// no JIT on iOS (only Apple's processes are allowed one), so heavy
+/// WebAssembly runs much faster here; the cost is a process and a
+/// web view's memory.
+///
+/// The page's `__sbNative` (`bootstrap`, below) is the worker bridge
+/// written in JavaScript over the page's own timers and `crypto`. Its
+/// `workerPostMessage`, `log` and `fetch` come here through the `sbWorker`
+/// message handler, as JSON text. The runtime keeps the page's globals and
+/// installs its own `fetch` family over the bridge, so requests go through
+/// `URLSession`, with the app's cookies, as a `JSContext` worker's do.
+/// Messages in, and fetch answers, go in with `callAsyncJavaScript`.
+///
+/// On iOS the web view sits behind the key window's content, 1×1 and clear:
+/// WebKit suspends the process of a web view outside a window.
+@MainActor
+final class WebViewWorkerHost: NSObject, WorkerEngine, WKNavigationDelegate {
+    let name: String
+    private let script: String
+    private let onMessage: @Sendable (String) -> Void
+    private let onError: @Sendable (String) -> Void
+    private let logger = Logger(subsystem: "swiftbrowser", category: "worker")
+    private let session = URLSession(configuration: .default)
+    private var webView: WKWebView?
+    /// Whether the script ran in the current page; messages wait in `pending` until it has.
+    private var ready = false
+    private var pending: [String] = []
+    private var terminated = false
+    #if os(iOS)
+    private var windowObserver: NSObjectProtocol?
+    #endif
+
+    /// The script is `<name>.worker.js` in `bundle`, as WorkerHost's; throws when it is not there.
+    init(name: String, bundle: Bundle = .main, onMessage: @escaping @Sendable (String) -> Void, onError: @escaping @Sendable (String) -> Void) throws {
+        guard let url = bundle.url(forResource: "\(name).worker", withExtension: "js") else {
+            throw JSError(message: "\(name).worker.js is not in the app bundle (build it with `swiftbrowser-native build --worker \(name)=<entry>`)")
+        }
+        self.name = name
+        script = try String(contentsOf: url, encoding: .utf8) + "\n//# sourceURL=\(name).worker.js"
+        self.onMessage = onMessage
+        self.onError = onError
+    }
+
+    func start() {
+        let configuration = WKWebViewConfiguration()
+        configuration.websiteDataStore = .nonPersistent()
+        let content = configuration.userContentController
+        content.addUserScript(WKUserScript(source: Self.bootstrap, injectionTime: .atDocumentStart, forMainFrameOnly: true))
+        content.add(MessageHandler(host: self), name: "sbWorker")
+        let webView = WKWebView(frame: CGRect(x: 0, y: 0, width: 1, height: 1), configuration: configuration)
+        webView.navigationDelegate = self
+        #if DEBUG
+        webView.isInspectable = true // Safari's Develop menu
+        #endif
+        #if os(iOS)
+        webView.isOpaque = false
+        webView.backgroundColor = .clear
+        webView.scrollView.backgroundColor = .clear
+        webView.isUserInteractionEnabled = false
+        webView.accessibilityElementsHidden = true
+        #endif
+        self.webView = webView
+        attach()
+        load()
+    }
+
+    func post(_ text: String) {
+        guard !terminated else { return }
+        guard ready else {
+            pending.append(text)
+            return
+        }
+        evaluate("__sbWorkerReceive(text)", ["text": text])
+    }
+
+    func terminate() {
+        terminated = true
+        #if os(iOS)
+        if let windowObserver { NotificationCenter.default.removeObserver(windowObserver) }
+        windowObserver = nil
+        #endif
+        guard let webView else { return }
+        webView.configuration.userContentController.removeScriptMessageHandler(forName: "sbWorker")
+        webView.navigationDelegate = nil
+        webView.stopLoading()
+        webView.removeFromSuperview()
+        self.webView = nil
+        ready = false
+        pending = []
+    }
+
+    // MARK: The page
+
+    /// An empty page on an origin of its own (`localStorage` and the like
+    /// need one); nothing is fetched from it.
+    private func load() {
+        ready = false
+        let origin = URL(string: "https://worker.swiftbrowser.invalid/\(name)/")
+        webView?.loadHTMLString("<!doctype html><meta charset=\"utf-8\"><title>\(name)</title>", baseURL: origin)
+    }
+
+    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
+        guard webView === self.webView, !ready else { return }
+        evaluate("__sbWorkerRun(script)", ["script": script])
+        ready = true
+        // In order after the script: WebKit runs the calls as they were sent.
+        let queued = pending
+        pending = []
+        for text in queued { post(text) }
+    }
+
+    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: any Error) {
+        fail("\(name): the worker's page did not load: \(error.localizedDescription)")
+    }
+
+    /// The process ended (memory pressure, a crash): the worker starts over
+    /// in a new one, losing what was in flight.
+    func webViewWebContentProcessDidTerminate(_ webView: WKWebView) {
+        guard webView === self.webView else { return }
+        fail("\(name): the worker's web content process ended; restarting it")
+        load()
+    }
+
+    /// Runs `body` as an async function in the page, its arguments as locals.
+    private func evaluate(_ body: String, _ arguments: [String: Any]) {
+        webView?.callAsyncJavaScript(body, arguments: arguments, in: nil, in: .page) { [weak self] result in
+            guard case .failure(let error) = result else { return }
+            let message = (error as NSError).userInfo["WKJavaScriptExceptionMessage"] as? String ?? error.localizedDescription
+            MainActor.assumeIsolated { self?.fail(message) }
+        }
+    }
+
+    private func fail(_ message: String) {
+        logger.error("\(self.name): \(message, privacy: .public)")
+        onError(message)
+    }
+
+    // MARK: From the page
+
+    fileprivate func receive(_ text: String) {
+        guard let message = try? JSONValue.parse(text) else { return }
+        switch message["kind"].string {
+        case "message":
+            if let text = message["text"].string { onMessage(text) }
+        case "error":
+            fail(message["message"].string ?? "unknown error")
+        case "log":
+            let level = message["level"].string ?? "log"
+            let text = message["message"].string ?? ""
+            switch level {
+            case "error": logger.error("\(self.name): \(text, privacy: .public)")
+            case "warn": logger.warning("\(self.name): \(text, privacy: .public)")
+            case "debug": logger.debug("\(self.name): \(text, privacy: .public)")
+            default: logger.info("\(self.name): \(text, privacy: .public)")
+            }
+            #if DEBUG
+            print("[\(name):\(level)] \(text)")
+            #endif
+        case "fetch":
+            guard let id = message["id"].int else { return }
+            WorkerHost.perform(message["request"], session: session) { [weak self] result in
+                DispatchQueue.main.async {
+                    MainActor.assumeIsolated {
+                        self?.evaluate("__sbFetchResult(id, JSON.parse(result))", ["id": id, "result": result.json])
+                    }
+                }
+            }
+        default:
+            break
+        }
+    }
+
+    // MARK: The window
+
+    #if os(iOS)
+    /// Puts the web view behind the key window's content, or waits for a window.
+    private func attach() {
+        guard let webView, webView.window == nil else { return }
+        let windows = UIApplication.shared.connectedScenes.compactMap { $0 as? UIWindowScene }.flatMap(\.windows)
+        guard let window = windows.first(where: \.isKeyWindow) ?? windows.first else {
+            if windowObserver == nil {
+                windowObserver = NotificationCenter.default.addObserver(forName: UIWindow.didBecomeKeyNotification, object: nil, queue: .main) { [weak self] _ in
+                    MainActor.assumeIsolated { self?.attach() }
+                }
+            }
+            return
+        }
+        window.insertSubview(webView, at: 0)
+        if let windowObserver { NotificationCenter.default.removeObserver(windowObserver) }
+        windowObserver = nil
+    }
+    #else
+    /// A Mac's web view runs outside a window.
+    private func attach() {}
+    #endif
+
+    // MARK: The bridge in the page
+
+    /// The worker bridge (packages/native/src/bridge.ts) over the page, run
+    /// before anything else in it.
+    static var bootstrap: String {
+        let locale = JSONValue.string(Locale.current.identifier).json
+        let arguments = JSONValue.array(ProcessInfo.processInfo.arguments.map(JSONValue.string)).json
+        return """
+        (() => {
+          'use strict';
+          const handler = window.webkit.messageHandlers.sbWorker;
+          const send = (message) => handler.postMessage(JSON.stringify(message));
+          const describe = (error) => {
+            if (!(error instanceof Error)) return String(error);
+            return error.stack ? `${error}\\n${error.stack}` : String(error);
+          };
+          const fail = (error) => send({ kind: 'error', message: describe(error) });
+          addEventListener('error', (event) => fail(event.error ?? event.message));
+          addEventListener('unhandledrejection', (event) => fail(event.reason));
+
+          // The runtime installs its fetch over the bridge in place of these.
+          for (const name of ['fetch', 'Headers', 'Request', 'Response', 'AbortController', 'AbortSignal']) {
+            Object.defineProperty(window, name, { value: undefined, writable: true, configurable: true });
+          }
+
+          // The page's console, and the app's log.
+          const format = (value) => {
+            if (typeof value === 'string') return value;
+            if (value instanceof Error) return describe(value);
+            try {
+              return JSON.stringify(value) ?? String(value);
+            } catch {
+              return String(value);
+            }
+          };
+          for (const level of ['log', 'info', 'warn', 'error', 'debug']) {
+            const write = console[level].bind(console);
+            console[level] = (...values) => {
+              write(...values);
+              send({ kind: 'log', level, message: values.map(format).join(' ') });
+            };
+          }
+
+          const timers = new Map();
+          const clearTimer = (id) => {
+            clearTimeout(timers.get(id));
+            clearInterval(timers.get(id));
+            timers.delete(id);
+          };
+          window.__sbNative = {
+            workerPostMessage: (text) => send({ kind: 'message', text: String(text) }),
+            log: (level, message) => send({ kind: 'log', level: String(level), message: String(message) }),
+            now: () => performance.now(),
+            setTimer: (id, delay, repeats) => {
+              clearTimer(id);
+              const fire = () => {
+                if (!repeats) timers.delete(id);
+                window.__sbTimerFired?.(id);
+              };
+              timers.set(id, repeats ? setInterval(fire, delay) : setTimeout(fire, delay));
+            },
+            clearTimer,
+            fetch: (id, request) => send({ kind: 'fetch', id, request: typeof request === 'string' ? JSON.parse(request) : request }),
+            // No storage of its own, as a JSContext worker.
+            storageGet: () => null,
+            storageSet: () => {},
+            storageRemove: () => {},
+            storageKeys: () => [],
+            storageClear: () => {},
+            randomBytes: (count) => {
+              const bytes = crypto.getRandomValues(new Uint8Array(Math.max(0, Math.min(count | 0, 65536))));
+              let text = '';
+              for (const byte of bytes) text += String.fromCharCode(byte);
+              return btoa(text);
+            },
+            openURL: () => false,
+            locale: () => \(locale),
+            launchArguments: () => \(arguments),
+          };
+
+          // The worker's script, at top level; what it throws is the worker's error.
+          window.__sbWorkerRun = (script) => {
+            try {
+              (0, eval)(script);
+            } catch (error) {
+              fail(error);
+            }
+          };
+        })();
+        """
+    }
+}
+
+/// The page's messages to the host, without the content controller keeping the host alive.
+@MainActor
+private final class MessageHandler: NSObject, WKScriptMessageHandler {
+    private weak var host: WebViewWorkerHost?
+
+    init(host: WebViewWorkerHost) {
+        self.host = host
+    }
+
+    func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
+        if let text = message.body as? String { host?.receive(text) }
+    }
+}
+#endif

package/swift/Sources/SwiftBrowserNative/Host/WorkerHost.swift

@@ -174,8 +174,18 @@ final class WorkerHost: @unchecked Sendable {
 
     /// As HostBridge's, answering on the worker's thread.
     private func fetch(id: Int, request: JSONValue) {
+        Self.perform(request, session: session) { [weak self] result in
+            guard let self else { return }
+            self.thread.perform { [self] in self.call("__sbFetchResult", [.number(Double(id)), result]) }
+        }
+    }
+
+    /// Runs a worker's `fetch` request (`{url, method, headers, body}`, the
+    /// body base64) on `session` and answers with what `__sbFetchResult`
+    /// takes, on the session's queue.
+    static func perform(_ request: JSONValue, session: URLSession, completion: @escaping @Sendable (JSONValue) -> Void) {
         guard let urlString = request["url"].string, let url = URL(string: urlString) else {
-            call("__sbFetchResult", [.number(Double(id)), .object(["error": .string("invalid URL")])])
+            completion(.object(["error": .string("invalid URL")]))
             return
         }
         var urlRequest = URLRequest(url: url)
@@ -186,31 +196,43 @@ final class WorkerHost: @unchecked Sendable {
         if let body = request["body"].string, let data = Data(base64Encoded: body) {
             urlRequest.httpBody = data
         }
-        let task = session.dataTask(with: urlRequest) { [weak self] data, response, error in
-            let result: JSONValue
+        let task = session.dataTask(with: urlRequest) { data, response, error in
             if let error {
-                result = .object(["error": .string(error.localizedDescription)])
-            } else {
-                let http = response as? HTTPURLResponse
-                var headers: JSONObject = [:]
-                for (name, value) in http?.allHeaderFields ?? [:] {
-                    headers[String(describing: name).lowercased()] = .string(String(describing: value))
-                }
-                result = .object([
-                    "status": .number(Double(http?.statusCode ?? 200)),
-                    "statusText": .string(http.map { HTTPURLResponse.localizedString(forStatusCode: $0.statusCode) } ?? ""),
-                    "headers": .object(headers),
-                    "url": .string(response?.url?.absoluteString ?? urlString),
-                    "body": .string((data ?? Data()).base64EncodedString()),
-                ])
+                completion(.object(["error": .string(error.localizedDescription)]))
+                return
             }
-            guard let self else { return }
-            self.thread.perform { [self] in self.call("__sbFetchResult", [.number(Double(id)), result]) }
+            let http = response as? HTTPURLResponse
+            var headers: JSONObject = [:]
+            for (name, value) in http?.allHeaderFields ?? [:] {
+                headers[String(describing: name).lowercased()] = .string(String(describing: value))
+            }
+            completion(.object([
+                "status": .number(Double(http?.statusCode ?? 200)),
+                "statusText": .string(http.map { HTTPURLResponse.localizedString(forStatusCode: $0.statusCode) } ?? ""),
+                "headers": .object(headers),
+                "url": .string(response?.url?.absoluteString ?? urlString),
+                "body": .string((data ?? Data()).base64EncodedString()),
+            ]))
         }
         task.resume()
     }
 }
 
+/// A worker as the app's bridge (HostBridge.swift) drives it: this file's
+/// `JSContext` on a thread, or a hidden web view (WebViewWorkerHost.swift).
+@MainActor
+protocol WorkerEngine: AnyObject {
+    /// Loads the script; messages posted before it ran wait for it.
+    func start()
+    /// Delivers an encoded message to the worker's `__sbWorkerReceive`.
+    func post(_ text: String)
+    func terminate()
+}
+
+// In an extension, so the protocol's actor is not inferred for the class:
+// the host's own work is on its thread.
+extension WorkerHost: WorkerEngine {}
+
 /// A thread with a run loop that runs blocks sent to it, in order, after
 /// the block it started with.
 final class WorkerThread: @unchecked Sendable {

package/swift/Sources/SwiftBrowserNative/Views/ElementView.swift

@@ -26,7 +26,14 @@ struct ElementView: View {
         case "zstack": return ZStackElement(node: node).reportingSize(of: node)
         case "spacer": return AnyView(Spacer(minLength: SpacerProps(props: node.props).minLength.map { CGFloat($0) }))
         case "divider": return AnyView(Divider())
-        case "styled": return node.isSpinner ? AnyView(ProgressView()) : ChildrenView(node: node).styled(node.style, id: node.id)
+        case "styled":
+            if node.isSpinner { return AnyView(ProgressView()) }
+            // Its one child as itself, not through a `ForEach`: a `ForEach`'s
+            // element is the identity a scroll view's targets go by, which
+            // must stay the marked element's (the id the layout's own
+            // `ForEach` gives it), not the innermost element's.
+            if node.children.count == 1 { return ElementView(node: node.children[0]).styled(node.style, id: node.id) }
+            return ChildrenView(node: node).styled(node.style, id: node.id)
         case "decorated": return AnyView(DecoratedElement(node: node))
         case "geometry": return AnyView(GeometryElement(node: node))
         case "scrollview": return AnyView(ScrollViewElement(node: node))

package/swift/Sources/SwiftBrowserNative/Views/Kinds/Lists.swift

@@ -13,9 +13,23 @@ struct ListElement: View {
 
     var body: some View {
         let props = ListProps(props: node.props)
-        let list = List {
-            ListRowsView(children: node.children)
-        }
+        // Selectable rows are the list's selection, as `List(selection:)`
+        // makes them: the whole cell takes the tap and shows the system's
+        // highlight, and choosing a row sends its `tap`. In edit mode a row
+        // keeps its own tap (several may be chosen).
+        let rows = Self.selectableRows(in: node)
+        let selects = !rows.isEmpty && props.editing != true
+        let list: AnyView = selects
+            ? AnyView(List(selection: Binding<Int?>(
+                get: { rows.first { ListRowProps(props: $0.props).selected }?.id },
+                set: { id in if let id { app?.dispatch(.tap(id)) } }
+            )) {
+                ListRowsView(children: node.children)
+            }
+            .environment(\.listSelectsRows, true))
+            : AnyView(List {
+                ListRowsView(children: node.children)
+            })
         let styled: AnyView = {
             switch props.style {
             case "plain": return AnyView(list.listStyle(.plain))
@@ -41,6 +55,31 @@ struct ListElement: View {
         refreshable
         #endif
     }
+
+    /// The list's selectable rows (not those of a list inside it).
+    static func selectableRows(in node: ElementNode) -> [ElementNode] {
+        var rows: [ElementNode] = []
+        func visit(_ element: ElementNode) {
+            for child in element.children where child.kind != "list" {
+                if child.kind == "listrow", ListRowProps(props: child.props).selectable { rows.append(child) }
+                visit(child)
+            }
+        }
+        visit(node)
+        return rows
+    }
+}
+
+private struct ListSelectsRowsKey: EnvironmentKey {
+    static let defaultValue = false
+}
+
+extension EnvironmentValues {
+    /// Whether the list around is a `List(selection:)` over its selectable rows, which are then its tags.
+    var listSelectsRows: Bool {
+        get { self[ListSelectsRowsKey.self] }
+        set { self[ListSelectsRowsKey.self] = newValue }
+    }
 }
 
 /// The rows of a `list` or `section`: sections render as `Section`s, the rest
@@ -126,18 +165,26 @@ struct SectionElement: View {
     }
 }
 
-/// `listrow`: the row's content with its edit-mode hints; a tap on a
-/// selectable row sends `tap`.
+/// `listrow`: the row's content with its edit-mode hints; a selectable
+/// row is the list's selection's tag (`ListElement`), or in edit mode sends
+/// `tap` itself.
 struct ListRowElement: View {
     let node: ElementNode
     @Environment(\.nativeApp) private var app
+    @Environment(\.listSelectsRows) private var listSelects
 
     var body: some View {
         let props = ListRowProps(props: node.props)
         // A row's children are one row: a stack when there are several.
         let content: AnyView = node.children.count == 1 ? AnyView(ElementView(node: node.children[0])) : AnyView(HStack(spacing: 0) { ChildrenView(node: node) })
-        if props.selectable {
+        if props.selectable, listSelects {
+            // The list's selection: the cell is the target, the list highlights it.
+            content.tag(node.id)
+        } else if props.selectable {
+            // The whole row takes the tap, not only its content's width (a
+            // title alone stops short of the trailing edge).
             let tappable = content
+                .frame(maxWidth: .infinity, alignment: .leading)
                 .contentShape(Rectangle())
                 .onTapGesture { app?.dispatch(.tap(node.id)) }
             if props.selected {

package/swift/Sources/SwiftBrowserNative/Views/Kinds/Navigation.swift

@@ -230,15 +230,32 @@ struct ToolbarElement: ToolbarContent {
     }
 }
 
-/// `navlink`: a tap on it sends `tap`, and the app pushes. In a list it is
-/// a row with a chevron, as the native link row is.
+/// `navlink`: a tap on it sends `tap`, and the app pushes. As a list's row
+/// it is a row with a chevron, as the native link row is; inside a row's
+/// content (a stack, a scroll view) it is a plain button, as in the web renderer.
 struct NavigationLinkElement: View {
     let node: ElementNode
     @Environment(\.nativeApp) private var app
 
+    /// The wrappers a row's link may sit in and still be the row (the web
+    /// engine's transparent kinds): any other kind between it and the list
+    /// makes it content of the row.
+    private static let rowWrappers: Set<String> = ["styled", "section", "gesture", "swipeactions", "contextmenu", "listrow", "draggable", "dropdestination"]
+
+    /// Whether the link is a list's row: only row wrappers between it and the list.
+    static func isListRow(_ node: ElementNode) -> Bool {
+        var current = node.parent
+        while let parent = current {
+            if parent.kind == "list" { return true }
+            guard rowWrappers.contains(parent.kind) else { return false }
+            current = parent.parent
+        }
+        return false
+    }
+
     var body: some View {
         let props = NavLinkProps(props: node.props)
-        let inList = node.ancestor(ofKind: "list") != nil
+        let inList = Self.isListRow(node)
         Button {
             app?.dispatch(.tap(node.id))
         } label: {

package/swift/Sources/SwiftBrowserNative/Views/Kinds/Stacks.swift

@@ -11,7 +11,7 @@ struct VStackElement: View {
         VStack(alignment: HorizontalAlignment(name: props.alignment), spacing: props.spacing.map { CGFloat($0) }) {
             ChildrenView(node: node)
         }
-        .scrollTargetLayout(isEnabled: props.scrollTarget)
+        .scrollTargetLayout(when: props.scrollTarget)
     }
 }
 
@@ -33,7 +33,22 @@ struct HStackElement: View {
             HStack(alignment: VerticalAlignment(name: props.alignment), spacing: props.spacing.map { CGFloat($0) }) {
                 ChildrenView(node: node)
             }
-            .scrollTargetLayout(isEnabled: props.scrollTarget)
+            .scrollTargetLayout(when: props.scrollTarget)
+        }
+    }
+}
+
+extension View {
+    /// `.scrollTargetLayout()` on a stack marked `scrollTarget`, and nothing
+    /// on any other: `.scrollTargetLayout(isEnabled: false)` on a stack
+    /// around a scroll view (a list row's) turns off the layout of the
+    /// stack inside it too, and the scroll view neither snaps nor reports.
+    @ViewBuilder
+    func scrollTargetLayout(when enabled: Bool) -> some View {
+        if enabled {
+            scrollTargetLayout()
+        } else {
+            self
         }
     }
 }
@@ -116,16 +131,28 @@ struct GeometryElement: View {
 /// `proxy.scrollTo(x)` arrives as a `scrollTo` hint, with a new serial each
 /// time, on the marked element it names (`scrollID`, `.id(x)`): the view
 /// finds the latest in its content and scrolls to it.
+///
+/// On iOS 18 and later the position is what the view settled on: the
+/// visible target at the anchor once the scroll phase is idle, after a drag
+/// or a `scrollTo` alike (so the app hears where a chevron's scroll ended),
+/// and never mid-gesture. A request on the view's own axes moves only this
+/// view, through its position, so a pager in a list leaves the list where
+/// it is.
 struct ScrollViewElement: View {
     let node: ElementNode
     @Environment(\.nativeApp) private var app
     @State private var position: Int?
     @State private var served: Double = -1
+    /// The targets in view, as the last visibility change listed them.
+    @State private var visible: [Int] = []
+    @State private var idle = true
+    @State private var reported: Int?
 
     var body: some View {
         let props = ScrollViewProps(props: node.props)
         let axes: Axis.Set = props.axes == "horizontal" ? .horizontal : props.axes == "both" ? [.horizontal, .vertical] : .vertical
         let request = Self.scrollRequest(in: node)
+        let anchor = props.positionAnchor.map(UnitPoint.init(spec:))
         ScrollViewReader { proxy in
             let scroll = ScrollView(axes, showsIndicators: props.showsIndicators) {
                 ChildrenView(node: node)
@@ -134,29 +161,92 @@ struct ScrollViewElement: View {
             let snapped: AnyView = props.snap == "paging" ? AnyView(refreshed.scrollTargetBehavior(.paging))
                 : props.snap == "viewAligned" ? AnyView(refreshed.scrollTargetBehavior(.viewAligned)) : refreshed
             let positioned: AnyView = props.reportsPosition
-                ? AnyView(snapped.scrollPosition(id: Binding(get: { position }, set: { next in
+                ? reportingSettled(AnyView(snapped.scrollPosition(id: Binding(get: { position }, set: { next in
                     guard next != position else { return }
                     position = next
-                    if let next { app?.dispatch(.scrollPosition(next)) }
-                }), anchor: props.positionAnchor.map(UnitPoint.init(spec:))))
+                    // Where the settled position is reported, the binding only follows the view.
+                    if !Self.reportsSettled { report(next) }
+                }), anchor: anchor)), anchor: anchor)
                 : snapped
             positioned
-                .onAppear { perform(request, with: proxy) }
-                .onChange(of: request?.serial) { _, _ in perform(request, with: proxy) }
+                .onAppear { perform(request, props: props, with: proxy) }
+                .onChange(of: request?.serial) { _, _ in perform(request, props: props, with: proxy) }
         }
     }
 
-    private func perform(_ request: ScrollRequest?, with proxy: ScrollViewProxy) {
+    private func perform(_ request: ScrollRequest?, props: ScrollViewProps, with proxy: ScrollViewProxy) {
         guard let request, request.serial > served else { return }
         served = request.serial
         position = request.id
+        // On its own axes, at its own anchor, the position binding scrolls this view alone; else the proxy, which scrolls every scroll view around the target.
+        let ownAxes = request.axes == props.axes && props.axes != "both"
+        if props.reportsPosition, ownAxes, request.anchor == nil || request.anchor == props.positionAnchor.map(UnitPoint.init(spec:)) { return }
         proxy.scrollTo(request.id, anchor: request.anchor)
     }
 
+    /// Tells the app the target at the anchor, once per target.
+    private func report(_ id: Int?) {
+        guard let id, id != reported else { return }
+        reported = id
+        app?.dispatch(.scrollPosition(id))
+    }
+
+    /// Whether this OS reports the settled position (`reportingSettled`) rather than the binding's every change.
+    static var reportsSettled: Bool {
+        #if !canImport(FoundationBridge)
+        if #available(iOS 18, macOS 15, *) { return true }
+        #endif
+        return false
+    }
+
+    /// The visible target at the anchor, reported when the view is idle.
+    private func reportingSettled(_ view: AnyView, anchor: UnitPoint?) -> AnyView {
+        #if !canImport(FoundationBridge)
+        if #available(iOS 18, macOS 15, *) {
+            let order = Self.targetOrder(in: node)
+            return AnyView(view
+                .onScrollTargetVisibilityChange(idType: Int.self, threshold: 0.5) { ids in
+                    visible = ids.sorted { (order[$0] ?? .max) < (order[$1] ?? .max) }
+                    if idle { report(Self.target(at: anchor, among: visible)) }
+                }
+                .onScrollPhaseChange { _, phase in
+                    idle = phase == .idle
+                    if idle { report(Self.target(at: anchor, among: visible)) }
+                })
+        }
+        #endif
+        return view
+    }
+
+    /// The target an anchor picks among the visible ones, in order: the first for a leading anchor (and none), the last for a trailing one, else the middle.
+    static func target(at anchor: UnitPoint?, among ids: [Int]) -> Int? {
+        guard !ids.isEmpty else { return nil }
+        let x = anchor?.x ?? 0
+        if x <= 0.25 { return ids.first }
+        if x >= 0.75 { return ids.last }
+        return ids[ids.count / 2]
+    }
+
+    /// The marked targets' places in the scroll target layout, in content order.
+    static func targetOrder(in node: ElementNode) -> [Int: Int] {
+        var order: [Int: Int] = [:]
+        func visit(_ element: ElementNode) {
+            for child in element.children {
+                if child.kind == "scrollview" || child.kind == "list" { continue }
+                if child.kind == "styled", child.style.scrollID { order[child.id] = order.count }
+                visit(child)
+            }
+        }
+        visit(node)
+        return order
+    }
+
     struct ScrollRequest: Equatable {
         var serial: Double
         var id: Int
         var anchor: UnitPoint?
+        /// `horizontal`, `vertical` or `both`.
+        var axes: String
     }
 
     /// The newest `scrollTo` among the content's marked elements (not those of a scroll view nested inside).
@@ -166,7 +256,7 @@ struct ScrollViewElement: View {
             for child in element.children {
                 if child.kind == "scrollview" || child.kind == "list" { continue }
                 if child.kind == "styled", let request = child.style.scrollTo, best == nil || request.serial > best!.serial {
-                    best = ScrollRequest(serial: request.serial, id: child.id, anchor: request.anchor.map(UnitPoint.init(spec:)))
+                    best = ScrollRequest(serial: request.serial, id: child.id, anchor: request.anchor.map(UnitPoint.init(spec:)), axes: request.axes)
                 }
                 visit(child)
             }

package/wasm/SwiftBrowserNative.wasm

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/wasm/SwiftBrowserNative.wasm
-size: 49302313 bytes
-sha256: a2426ea2bd5032a173f7975b94c57b9f331404b419e57e87c5573e7350eac8da
+size: 49328700 bytes
+sha256: 50c0e8b62319e77f83cd71b486e85ddb76025a394c985b883e1b3c9fe7cda5f9