@swiftbrowser/native 0.11.0 → 0.13.0

package/dist/worker.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Workers for a JavaScriptCore app: a second context on its own thread, as
+ * a page has Web Workers. The host (Native/Sources/SwiftBrowserNative/Host/WorkerHost.swift)
+ * runs each one in a `JSVirtualMachine` of its own with a run loop, the
+ * runtime's globals (timers, `fetch`, `console`, `TextDecoder`) and the
+ * bundle `swiftbrowser-native build --worker <name>=<entry>` wrote next to
+ * app.js (`<name>.worker.js`). Messages cross as text: JSON, with typed
+ * arrays, `ArrayBuffer`s and `Error`s encoded (`encodeMessage`), since
+ * values cannot be shared between virtual machines. Drawn in a page
+ * (`swiftbrowser-native site`), the same app code gets the page's own
+ * `Worker` over the same bundle, published with the site.
+ *
+ * ```ts
+ * import { createWorker } from '@swiftbrowser/native';
+ * const worker = createWorker('render'); // render.worker.js
+ * worker.onmessage = (event) => console.log(event.data);
+ * worker.postMessage({ draw: 'something' });
+ * ```
+ */
+import { type NativeBridge } 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;
+    terminate(): void;
+    onmessage: ((event: WorkerMessageEvent) => void) | null;
+    onerror: ((event: WorkerErrorEvent) => void) | null;
+    addEventListener(type: 'message', listener: (event: WorkerMessageEvent) => void): void;
+    addEventListener(type: 'error', listener: (event: WorkerErrorEvent) => void): void;
+    removeEventListener(type: 'message' | 'error', listener: (event: never) => void): void;
+}
+export interface WorkerMessageEvent {
+    type: 'message';
+    data: unknown;
+}
+export interface WorkerErrorEvent {
+    type: 'error';
+    message: string;
+}
+/**
+ * A message as text: JSON, with a typed array or `ArrayBuffer` as
+ * `{ $sbBytes, $sbType }` (base64) and an `Error` as `{ $sbError }`. What
+ * JSON drops (functions, `undefined` in an object, a `Map`) is dropped here
+ * too; a `Date` arrives as its ISO string.
+ */
+export declare function encodeMessage(data: unknown): string;
+/** The value `encodeMessage` encoded. */
+export declare function decodeMessage(text: string): unknown;
+type Listener<E> = (event: E) => void;
+/** `Worker` over the bridge, in the app's context. */
+export declare class NativeWorker implements WorkerLike {
+    #private;
+    private static nextId;
+    private static readonly live;
+    onmessage: Listener<WorkerMessageEvent> | null;
+    onerror: Listener<WorkerErrorEvent> | 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);
+    postMessage(data: unknown): void;
+    terminate(): void;
+    addEventListener(type: 'message', listener: Listener<WorkerMessageEvent>): void;
+    addEventListener(type: 'error', listener: Listener<WorkerErrorEvent>): void;
+    removeEventListener(type: 'message' | 'error', listener: Listener<never>): void;
+    /** The bridge's `__sbWorkerMessage(id, text)`. */
+    static receive(id: number, text: string): void;
+    /** The bridge's `__sbWorkerError(id, message)`: an uncaught exception in the worker. */
+    static fail(id: number, message: string): void;
+}
+/** The bundle name a worker was asked for: `render`, or the `render` of `.../render.worker.js`. */
+export declare 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.
+ */
+export declare function createWorker(name: string): WorkerLike;
+/**
+ * A worker's own globals over its bridge: `self`, `postMessage`, `onmessage`
+ * and `onerror` as properties the script assigns, `addEventListener`,
+ * `close`, and `__sbWorkerReceive`, which the host calls with each message.
+ */
+export declare function installWorkerScope(native: NativeBridge, target: Record<string, unknown>): string[];
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}

package/dist/worker.js

@@ -0,0 +1,213 @@
+/**
+ * Workers for a JavaScriptCore app: a second context on its own thread, as
+ * a page has Web Workers. The host (Native/Sources/SwiftBrowserNative/Host/WorkerHost.swift)
+ * runs each one in a `JSVirtualMachine` of its own with a run loop, the
+ * runtime's globals (timers, `fetch`, `console`, `TextDecoder`) and the
+ * bundle `swiftbrowser-native build --worker <name>=<entry>` wrote next to
+ * app.js (`<name>.worker.js`). Messages cross as text: JSON, with typed
+ * arrays, `ArrayBuffer`s and `Error`s encoded (`encodeMessage`), since
+ * values cannot be shared between virtual machines. Drawn in a page
+ * (`swiftbrowser-native site`), the same app code gets the page's own
+ * `Worker` over the same bundle, published with the site.
+ *
+ * ```ts
+ * import { createWorker } from '@swiftbrowser/native';
+ * const worker = createWorker('render'); // render.worker.js
+ * worker.onmessage = (event) => console.log(event.data);
+ * worker.postMessage({ draw: 'something' });
+ * ```
+ */
+import { nativeBridge } from './bridge';
+import { base64Decode, base64Encode } from './encoding';
+// MARK: Messages
+const TYPED_ARRAYS = {
+    Uint8Array,
+    Uint8ClampedArray,
+    Int8Array,
+    Uint16Array,
+    Int16Array,
+    Uint32Array,
+    Int32Array,
+    Float32Array,
+    Float64Array,
+};
+/**
+ * A message as text: JSON, with a typed array or `ArrayBuffer` as
+ * `{ $sbBytes, $sbType }` (base64) and an `Error` as `{ $sbError }`. What
+ * JSON drops (functions, `undefined` in an object, a `Map`) is dropped here
+ * too; a `Date` arrives as its ISO string.
+ */
+export function encodeMessage(data) {
+    return JSON.stringify(data === undefined ? null : data, (_key, value) => {
+        if (value instanceof ArrayBuffer)
+            return { $sbBytes: base64Encode(new Uint8Array(value)), $sbType: 'ArrayBuffer' };
+        if (ArrayBuffer.isView(value)) {
+            const name = value.constructor.name;
+            const bytes = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+            return { $sbBytes: base64Encode(bytes), $sbType: name && name in TYPED_ARRAYS ? name : 'Uint8Array' };
+        }
+        if (value instanceof Error)
+            return { $sbError: { name: value.name, message: value.message, stack: value.stack ?? null } };
+        return value;
+    });
+}
+/** The value `encodeMessage` encoded. */
+export function decodeMessage(text) {
+    return JSON.parse(text, (_key, value) => {
+        if (value && typeof value === 'object') {
+            const record = value;
+            if (typeof record['$sbBytes'] === 'string') {
+                const bytes = base64Decode(record['$sbBytes']);
+                const type = record['$sbType'];
+                if (type === 'ArrayBuffer')
+                    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+                const Constructor = TYPED_ARRAYS[type in TYPED_ARRAYS ? type : 'Uint8Array'];
+                // A view over the decoded bytes, aligned for the element size.
+                const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+                return new Constructor(buffer);
+            }
+            if (record['$sbError'] && typeof record['$sbError'] === 'object') {
+                const spec = record['$sbError'];
+                const error = new Error(spec.message ?? '');
+                if (spec.name)
+                    error.name = spec.name;
+                if (spec.stack)
+                    error.stack = spec.stack;
+                return error;
+            }
+        }
+        return value;
+    });
+}
+/** `Worker` over the bridge, in the app's context. */
+export class NativeWorker {
+    static nextId = 1;
+    static live = new Map();
+    #id;
+    #native;
+    #terminated = false;
+    #messageListeners = new Set();
+    #errorListeners = new Set();
+    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()) {
+        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));
+        if (failure) {
+            NativeWorker.live.delete(this.#id);
+            throw new Error(failure);
+        }
+    }
+    postMessage(data) {
+        if (this.#terminated)
+            return;
+        this.#native.workerPost(this.#id, encodeMessage(data));
+    }
+    terminate() {
+        if (this.#terminated)
+            return;
+        this.#terminated = true;
+        NativeWorker.live.delete(this.#id);
+        this.#native.workerTerminate(this.#id);
+    }
+    addEventListener(type, listener) {
+        if (type === 'message')
+            this.#messageListeners.add(listener);
+        else
+            this.#errorListeners.add(listener);
+    }
+    removeEventListener(type, listener) {
+        if (type === 'message')
+            this.#messageListeners.delete(listener);
+        else
+            this.#errorListeners.delete(listener);
+    }
+    /** The bridge's `__sbWorkerMessage(id, text)`. */
+    static receive(id, text) {
+        const worker = NativeWorker.live.get(id);
+        if (!worker)
+            return;
+        const event = { type: 'message', data: decodeMessage(text) };
+        worker.onmessage?.(event);
+        for (const listener of worker.#messageListeners)
+            listener(event);
+    }
+    /** The bridge's `__sbWorkerError(id, message)`: an uncaught exception in the worker. */
+    static fail(id, message) {
+        const worker = NativeWorker.live.get(id);
+        if (!worker)
+            return;
+        const event = { type: 'error', message };
+        worker.onerror?.(event);
+        for (const listener of worker.#errorListeners)
+            listener(event);
+    }
+}
+/** The bundle name a worker was asked for: `render`, or the `render` of `.../render.worker.js`. */
+export function workerName(name) {
+    const text = typeof name === 'string' ? name : name.href;
+    const last = text.split('/').pop() ?? text;
+    return last.replace(/\.(m?[jt]sx?)$/, '').replace(/\.worker$/, '');
+}
+/**
+ * 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.
+ */
+export function createWorker(name) {
+    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);
+    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)`);
+}
+// MARK: The worker's side
+/**
+ * A worker's own globals over its bridge: `self`, `postMessage`, `onmessage`
+ * and `onerror` as properties the script assigns, `addEventListener`,
+ * `close`, and `__sbWorkerReceive`, which the host calls with each message.
+ */
+export function installWorkerScope(native, target) {
+    const installed = [];
+    const define = (name, value) => {
+        Object.defineProperty(target, name, { value, writable: true, configurable: true, enumerable: false });
+        installed.push(name);
+    };
+    const messageListeners = new Set();
+    const errorListeners = new Set();
+    define('self', target);
+    define('postMessage', (data) => native.workerPostMessage(encodeMessage(data)));
+    define('addEventListener', (type, listener) => {
+        if (type === 'message')
+            messageListeners.add(listener);
+        else if (type === 'error')
+            errorListeners.add(listener);
+    });
+    define('removeEventListener', (type, listener) => {
+        if (type === 'message')
+            messageListeners.delete(listener);
+        else if (type === 'error')
+            errorListeners.delete(listener);
+    });
+    define('close', () => native.log('warn', 'close(): a worker ends when the app terminates it'));
+    define('__sbWorkerReceive', (text) => {
+        const event = { type: 'message', data: decodeMessage(text) };
+        const handler = target['onmessage'];
+        if (typeof handler === 'function')
+            handler(event);
+        for (const listener of messageListeners)
+            listener(event);
+    });
+    return installed;
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftbrowser/native",
-  "version": "0.11.0",
+  "version": "0.13.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.11.0",
-    "@swiftbrowser/web": "0.11.0",
+    "@swiftbrowser/react": "0.13.0",
+    "@swiftbrowser/web": "0.13.0",
     "esbuild": "^0.28.2",
     "react-refresh": "^0.17.0"
   },

package/src/bridge.ts

@@ -26,6 +26,18 @@ export interface NativeBridge {
   locale(): string;
   /** The process's launch arguments (`-screen list` from an Xcode scheme or `simctl launch`). */
   launchArguments?(): string[];
+
+  // Workers (worker.ts): a second context on its own thread, from a bundle
+  // `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;
+  /** 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;
 }
 
 /** The app's launch arguments, or none outside the native app. */

package/src/build.ts

@@ -23,14 +23,31 @@ export interface BuildOptions {
   sourcemap?: boolean;
   /** `process.env.NODE_ENV`; `production` when minifying, else `development`. */
   mode?: 'development' | 'production';
+  /**
+   * Worker bundles by name (`{ render: 'src/render.worker.ts' }`): each a
+   * script of its own, the runtime first, written as `<name>.worker.js` next
+   * to the app bundle, which `createWorker(name)` runs on a thread of its own
+   * (worker.ts).
+   */
+  workers?: Record<string, string>;
+  /**
+   * Where the worker bundles are published when the app is drawn in a page
+   * (`/native/bundle/App/`), as `createWorker` finds them there; absent in an
+   * Xcode bundle, whose host loads them by name.
+   */
+  workerBase?: string;
 }
 
 export interface BuildResult {
   code: string;
   bytes: number;
   warnings: string[];
+  /** The worker bundles, by name. */
+  workers: Record<string, { code: string; bytes: number }>;
 }
 
+const WORKER_NAME = /^[A-Za-z0-9_-]+$/;
+
 const here = dirname(fileURLToPath(import.meta.url));
 /** The runtime's source; the package ships `src` so this resolves from `dist` too. */
 const runtimeEntry = fileURLToPath(new URL('../src/runtime.ts', import.meta.url));
@@ -68,34 +85,49 @@ function common(options: BuildOptions): esbuild.BuildOptions {
     target: ['safari16'],
     minify: options.minify ?? false,
     sourcemap: options.sourcemap ? 'inline' : false,
-    define: { 'process.env.NODE_ENV': JSON.stringify(mode), 'import.meta.env.DEV': JSON.stringify(mode === 'development') },
+    define: {
+      'process.env.NODE_ENV': JSON.stringify(mode),
+      'import.meta.env.DEV': JSON.stringify(mode === 'development'),
+      __SB_WORKER_BASE__: options.workerBase === undefined ? 'undefined' : JSON.stringify(options.workerBase),
+    },
     jsx: 'automatic',
     logLevel: 'silent',
     absWorkingDir: here,
   };
 }
 
-/** Builds the two halves and joins them. */
+/** Builds the two halves and joins them, and each worker the same way. */
 export async function bundle(options: BuildOptions): Promise<BuildResult> {
   const runtime = await esbuild.build({ ...common(options), entryPoints: [runtimeEntry] });
   const app = await esbuild.build({ ...common(options), entryPoints: [options.entry], alias: aliases(options.entry) });
   const code = `${text(runtime)}\n${text(app)}`;
-  return {
-    code,
-    bytes: Buffer.byteLength(code),
-    warnings: [...runtime.warnings, ...app.warnings].map((warning) => warning.text),
-  };
+  const warnings = [...runtime.warnings, ...app.warnings].map((warning) => warning.text);
+  const workers: BuildResult['workers'] = {};
+  for (const [name, entry] of Object.entries(options.workers ?? {})) {
+    if (!WORKER_NAME.test(name)) throw new Error(`worker names are letters, digits, "_" and "-": ${name}`);
+    const worker = await esbuild.build({ ...common(options), entryPoints: [resolve(entry)], alias: aliases(entry) });
+    const workerCode = `${text(runtime)}\n${text(worker)}`;
+    workers[name] = { code: workerCode, bytes: Buffer.byteLength(workerCode) };
+    warnings.push(...worker.warnings.map((warning) => warning.text));
+  }
+  return { code, bytes: Buffer.byteLength(code), warnings, workers };
+}
+
+/** Where a worker bundle goes: `<name>.worker.js` beside the app bundle. */
+export function workerOutfile(outfile: string, name: string): string {
+  return resolve(dirname(outfile), `${name}.worker.js`);
 }
 
 function text(result: esbuild.BuildResult): string {
   return result.outputFiles?.map((file) => file.text).join('\n') ?? '';
 }
 
-/** Builds and writes the bundle. */
+/** Builds and writes the bundle, and the worker bundles beside it. */
 export async function buildApp(options: BuildOptions): Promise<BuildResult> {
   const result = await bundle(options);
   await mkdir(dirname(options.outfile), { recursive: true });
   await writeFile(options.outfile, result.code);
+  for (const [name, worker] of Object.entries(result.workers)) await writeFile(workerOutfile(options.outfile, name), worker.code);
   return result;
 }
 

package/src/index.ts

@@ -18,3 +18,4 @@ export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchReque
 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';

package/src/runtime.ts

@@ -11,15 +11,20 @@
  * `atob`, `btoa`, `fetch` with `Headers`, `Request`, `Response`,
  * `AbortController` and `AbortSignal`, `URL`, `URLSearchParams`, `crypto`
  * (`getRandomValues`, `randomUUID`), `localStorage`, `structuredClone`,
- * `navigator`, and the bridge's callbacks `__sbTimerFired` and
- * `__sbFetchResult`. `window` and `document` are not defined: code that
- * checks for them takes its headless path, as it should here.
+ * `navigator`, `Worker` (worker.ts) with the bridge's `__sbWorkerMessage`
+ * and `__sbWorkerError`, and the bridge's callbacks `__sbTimerFired` and
+ * `__sbFetchResult`. In a worker's own context (its bridge has
+ * `workerPostMessage`), `self`, `postMessage`, `addEventListener` and
+ * `__sbWorkerReceive` instead of `Worker`. `window` and `document` are not
+ * defined: code that checks for them takes its headless path, as it should
+ * here.
  */
 
 import { nativeBridge, type NativeBridge } from './bridge';
 import { atobPolyfill, base64Decode, btoaPolyfill, SimpleTextDecoder, SimpleTextEncoder } from './encoding';
 import { createFetch } from './fetch';
 import { SimpleURL, SimpleURLSearchParams } from './url';
+import { installWorkerScope, NativeWorker } from './worker';
 
 type AnyGlobal = Record<string, unknown>;
 
@@ -199,6 +204,14 @@ export function installRuntime(native: NativeBridge, target: AnyGlobal = globalT
     hardwareConcurrency: 1,
   });
 
+  if (native.workerPostMessage) {
+    installed.push(...installWorkerScope(native, target));
+  } else if (native.workerStart) {
+    define('Worker', NativeWorker);
+    define('__sbWorkerMessage', NativeWorker.receive);
+    define('__sbWorkerError', NativeWorker.fail);
+  }
+
   return installed;
 }
 

package/src/site.ts

@@ -36,6 +36,12 @@ export interface SiteOptions extends Omit<BuildOptions, 'outfile'> {
   module?: string;
   /** The path the site is served under when it is not a host's root (`/native/`); `/` by default. */
   base?: string;
+  /**
+   * Asset catalogs (`*.xcassets` directories) the app's named images and
+   * colors come from, served as the site's catalog; the Xcode target's, or
+   * one kept for the site (a `.symbolset` holding any SVG draws as a symbol).
+   */
+  catalogs?: string[];
   /** Vite's log level while building the site; `warn` by default. */
   logLevel?: 'info' | 'warn' | 'error' | 'silent';
 }
@@ -46,6 +52,8 @@ export interface SiteResult {
   module: string;
   moduleBytes: number;
   bundleBytes: number;
+  /** The worker bundles' sizes, by name. */
+  workers: Record<string, number>;
   warnings: string[];
 }
 
@@ -74,28 +82,46 @@ export async function buildNativeSite(options: SiteOptions): Promise<SiteResult>
     );
   }
   if (options.base !== undefined && !/^\/([^/].*\/)?$/.test(options.base)) throw new Error(`site: --base must start and end with "/": ${options.base}`);
-  const { outDir, name: _name, displayName, module: _module, base, logLevel, ...bundleOptions } = options;
+  const { outDir, name: _name, displayName, module: _module, base, logLevel, catalogs, ...bundleOptions } = options;
+  for (const catalog of catalogs ?? []) {
+    if (!existsSync(catalog)) throw new Error(`site: no asset catalog at ${catalog}`);
+  }
   // The bundle is the app's one resource: published at `/bundle/<name>/app.js`
   // and mounted at `/bundle/app.js`, where the module's launch reads it.
   const resources = mkdtempSync(path.join(tmpdir(), 'swiftbrowser-native-site-'));
   try {
-    const built = await bundle({ ...bundleOptions, outfile: path.join(resources, 'app.js') });
+    // The worker bundles are resources beside it, where the page's `Worker` loads them from.
+    const built = await bundle({ ...bundleOptions, outfile: path.join(resources, 'app.js'), workerBase: `${base ?? '/'}bundle/${name}/` });
     writeFileSync(path.join(resources, 'app.js'), built.code);
+    const files = [path.join(resources, 'app.js')];
+    for (const [workerName, worker] of Object.entries(built.workers)) {
+      const file = path.join(resources, `${workerName}.worker.js`);
+      writeFileSync(file, worker.code);
+      files.push(file);
+    }
     await buildSite({
       apps: [{
         name,
         displayName: displayName ?? name,
         description: 'A SwiftBrowser Native app in the browser',
         wasm: module,
-        catalogs: [],
-        resources: [path.join(resources, 'app.js')],
+        catalogs: (catalogs ?? []).map((catalog) => path.resolve(catalog)),
+        resources: files,
       }],
       layout: 'app',
       outDir: path.resolve(outDir),
       ...(base !== undefined ? { base } : {}),
       logLevel: logLevel ?? 'warn',
     });
-    return { name, outDir: path.resolve(outDir), module, moduleBytes: statSync(module).size, bundleBytes: built.bytes, warnings: built.warnings };
+    return {
+      name,
+      outDir: path.resolve(outDir),
+      module,
+      moduleBytes: statSync(module).size,
+      bundleBytes: built.bytes,
+      workers: Object.fromEntries(Object.entries(built.workers).map(([workerName, worker]) => [workerName, worker.bytes])),
+      warnings: built.warnings,
+    };
   } finally {
     rmSync(resources, { recursive: true, force: true });
   }