@swiftbrowser/native 0.0.0-stage → 0.10.1

package/README.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
+# @swiftbrowser/native
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Runs a [`@swiftbrowser/react`](../react/README.md) app natively: inside an
+iOS app, in JavaScriptCore, drawn by real SwiftUI through the
+[SwiftBrowser Native](../../Native/README.md) Swift package. The package is
+three things:
+
+- **`run(<App />)`**, the entry an app calls: a `@swiftbrowser/react` root
+  whose ops go to the native renderer and whose events come back from it,
+  the native counterpart of `mount`.
+- **The runtime**: the web globals bare JavaScriptCore lacks, built on the
+  bridge's primitives (`setTimeout` and friends, `requestAnimationFrame`,
+  `console`, `performance`, `fetch` with `Headers`, `Request`, `Response`
+  and `AbortController`, `URL`, `URLSearchParams`, `TextEncoder`,
+  `TextDecoder`, `atob`, `btoa`, `crypto.getRandomValues` and `randomUUID`,
+  `localStorage`, `structuredClone`, `navigator`). React's scheduler reads
+  some of these when it loads, so the bundle starts with the runtime.
+- **The bundler**: `swiftbrowser-native build` writes one `app.js` for the
+  Xcode target, and `swiftbrowser-native dev` serves it with rebuild on
+  save for the app's `NativeApp.watch(url:)`.
+
+The design is in [docs/native.md](../../docs/native.md). The package is
+experimental, like `@swiftbrowser/react`.
+
+The package also carries the Swift side: `swift/` is the
+[SwiftBrowser Native](../../Native/README.md) Swift package (its
+`Package.swift` and `Sources`, without the tests), so an Xcode project can
+depend on `node_modules/@swiftbrowser/native/swift` as a local package and
+build against the exact version of the renderer this JavaScript was written
+for. `swiftbrowser native init` lays a project out that way:
+
+```sh
+npx @swiftbrowser/cli native init MyApp   # MyApp.xcodeproj, MyApp/MyAppApp.swift, js/
+cd MyApp/js && npm install                # React, @swiftbrowser/react and this package
+npm run build                             # ../MyApp/app.js, the bundle the app ships
+open ../MyApp.xcodeproj                   # run it on a simulator
+```
+
+For a hand-made project:
+
+```sh
+npm install @swiftbrowser/native @swiftbrowser/react react react-reconciler
+```
+
+## An app
+
+```tsx
+// src/index.tsx
+import { run } from '@swiftbrowser/native';
+import { List, NavigationStack, Section, Text, Toggle } from '@swiftbrowser/react';
+import { useState } from 'react';
+
+function App() {
+  const [on, setOn] = useState(false);
+  return (
+    <NavigationStack>
+      <List navigationTitle="Settings">
+        <Section header="General">
+          <Toggle title="Notifications" isOn={[on, setOn]} />
+          <Text foregroundStyle="secondary">{on ? 'On' : 'Off'}</Text>
+        </Section>
+      </List>
+    </NavigationStack>
+  );
+}
+
+run(<App />);
+```
+
+```sh
+npx swiftbrowser-native build src/index.tsx --out ../MyApp/app.js     # the bundle Xcode ships
+npx swiftbrowser-native dev src/index.tsx --out ../MyApp/app.js       # http://localhost:5173/, Fast Refresh on save
+```
+
+On the Swift side, `NativeApp().load()` runs the bundled `app.js` and
+`NativeRootView(app:)` draws it (see the Swift package's README). The
+examples under `Native/Examples` are complete apps laid out this way.
+
+## What runs where
+
+Every call across the bridge is synchronous. A tap is one call chain:
+SwiftUI's button action calls `__sbDispatch(json)`, the handler runs,
+React flushes the pass, the sink calls `__sbNative.applyOps(json)`, the Swift
+tree mutates, and everything returns. A controlled `TextField` therefore
+never shows a stale frame: when its binding's setter returns, the app's
+state already holds the new text.
+
+There is no `window` and no `document`. Code that checks for them takes its
+headless path, which is right here; `@swiftbrowser/react`'s `Host` (React DOM
+inside the tree) renders nothing, as `react-dom` is aliased to a stub.
+
+`fetch` sends the request over the bridge and `URLSession` performs it;
+bodies are whole (no streams, no `Blob`). `URL` is a small parser, enough for
+absolute and relative URLs and query strings, not the whole WHATWG algorithm.
+
+## The dev loop and Fast Refresh
+
+`swiftbrowser-native dev` serves the bundle in two halves and a manifest:
+
+| path | what |
+|---|---|
+| `/manifest.json` | `{ "vendor": <hash>, "app": <hash> }`, which `NativeApp.watch(url:)` polls every second |
+| `/vendor.js` | the runtime, React Fast Refresh's runtime, React, `@swiftbrowser/react` and this package: evaluated once |
+| `/app.js` | the app's own modules, each run through `react-refresh/babel`, importing React and the packages through shims that read `__sbVendor`: evaluated again on every save |
+
+On a save the app half is evaluated in the running engine: its modules
+register their components with the refresh runtime, and `run`, called again
+at its end, performs the refresh and renders the new tree into the same
+root. A component whose hooks are unchanged keeps its state; one whose
+hooks changed remounts, as React Fast Refresh decides from the signatures
+the transform records. A new vendor half (a dependency changed) starts the
+app over. No module loader or WebSocket is involved, which bare
+JavaScriptCore lacks. `test/fastRefresh.test.ts` runs the loop in Node.
+
+`launchArguments()` reads the process's arguments (`-screen list` from an
+Xcode scheme or `simctl launch`), as the Fidelity example does to open one
+screen.
+
+## The escape hatch
+
+```tsx
+import { Native } from '@swiftbrowser/native';
+
+<Native name="MapView" props={{ region }} onEvent={(value) => console.log('map said', value)}>
+  <Text>Children are SwiftUI views inside the native view</Text>
+</Native>
+```
+
+The Swift app registers the view once:
+
+```swift
+NativeRegistry.register("MapView") { context in
+    MapView(region: context.props["region"]) { context.send(["tapped": true]) }
+}
+```
+
+## Testing without a device
+
+`installRuntime(native, target)` installs the runtime on any object over
+any bridge, and `run(element, { native })` renders through one; the tests
+in `test/` drive both with a fake bridge. `test/bundle.test.ts` builds the
+example apps and runs the bundles in a bare `vm` context with only
+`__sbNative`, as JavaScriptCore runs them, and replays the Todos example's
+snapshot script against the tree the ops build.

package/bin/swiftbrowser-native.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// `swiftbrowser-native build <entry> --out <file>` writes the app bundle (the
+// same as `swiftbrowser native build`, from @swiftbrowser/cli, which also
+// writes a new project with `swiftbrowser native init`);
+// `swiftbrowser-native dev <entry> --out <file> [--port 5173]` serves it with
+// rebuild on save for `NativeApp.watch(url:)`.
+
+import { resolve } from 'node:path';
+import { buildApp, serve } from '../dist/build.js';
+
+const [command, entry, ...rest] = process.argv.slice(2);
+const flags = {};
+for (let i = 0; i < rest.length; i++) {
+  const arg = rest[i];
+  if (arg === '--out' || arg === '--port') flags[arg.slice(2)] = rest[++i];
+  else if (arg.startsWith('--')) flags[arg.slice(2)] = true;
+}
+
+if (!command || !entry || !flags.out || !['build', 'dev'].includes(command)) {
+  console.error('usage: swiftbrowser-native build <entry.tsx> --out <App/app.js> [--minify] [--sourcemap]');
+  console.error('       swiftbrowser-native dev <entry.tsx> --out <App/app.js> [--port 5173] [--sourcemap]');
+  process.exit(2);
+}
+
+const options = {
+  entry: resolve(entry),
+  outfile: resolve(flags.out),
+  minify: Boolean(flags.minify),
+  sourcemap: Boolean(flags.sourcemap),
+};
+
+const kb = (bytes) => `${(bytes / 1024).toFixed(0)} kB`;
+
+if (command === 'build') {
+  const result = await buildApp(options);
+  for (const warning of result.warnings) console.warn(warning);
+  console.log(`${options.outfile}: ${kb(result.bytes)}`);
+} else {
+  const port = flags.port ? Number(flags.port) : 5173;
+  await serve({
+    ...options,
+    port,
+    onBuild: (result) => {
+      if (result instanceof Error) console.error(result.message);
+      else console.log(`${new Date().toLocaleTimeString()} built ${kb(result.bytes)} → ${options.outfile}`);
+    },
+  });
+  console.log(`serving http://localhost:${port}/ (NativeApp.watch(url:) in a Debug build loads vendor.js once and refreshes app.js on every save)`);
+}

package/dist/bridge.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The native side of the bridge, as Swift installs it on `__sbNative`
+ * (Native/Sources/SwiftBrowserNative/Host/HostBridge.swift). Every call is
+ * synchronous; the ones that answer later do so by calling a global this
+ * package defines (`__sbTimerFired`, `__sbFetchResult`).
+ */
+export interface NativeBridge {
+    /** Applies a render pass's ops (a JSON array). Returns an error message, or nothing. */
+    applyOps(json: string): string | null | undefined;
+    log(level: string, message: string): void;
+    /** Milliseconds, monotonic. */
+    now(): number;
+    setTimer(id: number, delayMs: number, repeats: boolean): void;
+    clearTimer(id: number): void;
+    /** Starts a request; the answer arrives at `__sbFetchResult(id, result)`. */
+    fetch(id: number, request: string | NativeFetchRequest): void;
+    storageGet(key: string): string | null;
+    storageSet(key: string, value: string): void;
+    storageRemove(key: string): void;
+    storageKeys(): string[];
+    storageClear(): void;
+    /** Base64 of `count` random bytes. */
+    randomBytes(count: number): string;
+    openURL(url: string): boolean;
+    /** The viewer's locale identifier (`en_US`). */
+    locale(): string;
+    /** The process's launch arguments (`-screen list` from an Xcode scheme or `simctl launch`). */
+    launchArguments?(): string[];
+}
+/** The app's launch arguments, or none outside the native app. */
+export declare function launchArguments(): string[];
+export interface NativeFetchRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    /** Base64, or null. */
+    body: string | null;
+}
+export interface NativeFetchResult {
+    status?: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    url?: string;
+    /** Base64. */
+    body?: string;
+    error?: string;
+}
+/** The host object, or undefined outside the native app (tests, a bundler's dry run). */
+export declare function nativeBridge(g?: typeof globalThis): NativeBridge | undefined;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

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

package/dist/bridge.js

@@ -0,0 +1,10 @@
+/** The app's launch arguments, or none outside the native app. */
+export function launchArguments() {
+    const native = nativeBridge();
+    return native?.launchArguments?.() ?? [];
+}
+/** The host object, or undefined outside the native app (tests, a bundler's dry run). */
+export function nativeBridge(g = globalThis) {
+    return g.__sbNative;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

@@ -0,0 +1,47 @@
+/**
+ * Builds `app.js` for an Xcode target: the runtime first (./runtime, so the
+ * web globals exist before React's scheduler reads them), then the app, as
+ * one script JavaScriptCore evaluates with `NativeApp.load`. `react-dom` is
+ * aliased to stubs (no DOM here); `@swiftbrowser/react` and React are
+ * bundled in. Node only (the CLI in ../bin and build scripts use it).
+ */
+export interface BuildOptions {
+    /** The app's entry module, which calls `run(<App />)`. */
+    entry: string;
+    /** Where to write the bundle (`<App>/app.js` in the Xcode target's folder). */
+    outfile: string;
+    minify?: boolean;
+    sourcemap?: boolean;
+    /** `process.env.NODE_ENV`; `production` when minifying, else `development`. */
+    mode?: 'development' | 'production';
+}
+export interface BuildResult {
+    code: string;
+    bytes: number;
+    warnings: string[];
+}
+/** Builds the two halves and joins them. */
+export declare function bundle(options: BuildOptions): Promise<BuildResult>;
+/** Builds and writes the bundle. */
+export declare function buildApp(options: BuildOptions): Promise<BuildResult>;
+export interface ServeOptions extends BuildOptions {
+    port?: number;
+    /** Called after every build (a log line). */
+    onBuild?: (result: BuildResult | Error) => void;
+}
+/**
+ * The dev loop: serves the dev bundle (devBuild.ts) for `NativeApp.watch(url:)`:
+ *
+ * | path | what |
+ * |---|---|
+ * | `/manifest.json` | `{ "vendor": <hash>, "app": <hash> }`, polled; `Cache-Control: no-store` |
+ * | `/vendor.js` | the vendor half, evaluated once (again when its hash changes) |
+ * | `/app.js` | the app half, evaluated again on every change: Fast Refresh |
+ *
+ * Rebuilds when the sources change (esbuild's watcher over the app's
+ * inputs), and writes the plain single bundle to `outfile` too, so an app
+ * built from Xcode without the server gets the latest. Returns a function
+ * that stops everything.
+ */
+export declare function serve(options: ServeOptions): Promise<() => Promise<void>>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkCD,4CAA4C;AAC5C,wBAAsB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CASxE;AAMD,oCAAoC;AACpC,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAK1E;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuE/E"}

package/dist/build.js

@@ -0,0 +1,156 @@
+/**
+ * Builds `app.js` for an Xcode target: the runtime first (./runtime, so the
+ * web globals exist before React's scheduler reads them), then the app, as
+ * one script JavaScriptCore evaluates with `NativeApp.load`. `react-dom` is
+ * aliased to stubs (no DOM here); `@swiftbrowser/react` and React are
+ * bundled in. Node only (the CLI in ../bin and build scripts use it).
+ */
+import * as esbuild from 'esbuild';
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { createServer } from 'node:http';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+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));
+const reactSources = fileURLToPath(new URL('../../react/src/index.ts', import.meta.url));
+const stubs = {
+    'react-dom/client': fileURLToPath(new URL('../src/stubs/react-dom-client.ts', import.meta.url)),
+    'react-dom': fileURLToPath(new URL('../src/stubs/react-dom.ts', import.meta.url)),
+    // This package from its sources, so a bundle never needs its `dist` built first.
+    '@swiftbrowser/native/runtime': runtimeEntry,
+    '@swiftbrowser/native': fileURLToPath(new URL('../src/index.ts', import.meta.url)),
+    // In this repository, @swiftbrowser/react from its sources too (installed, it is a built package).
+    ...(existsSync(reactSources) ? { '@swiftbrowser/react': reactSources } : {}),
+};
+function common(options) {
+    const mode = options.mode ?? (options.minify ? 'production' : 'development');
+    return {
+        bundle: true,
+        write: false,
+        format: 'iife',
+        platform: 'browser',
+        // JavaScriptCore on iOS 17 has every ES2022 feature.
+        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') },
+        jsx: 'automatic',
+        logLevel: 'silent',
+        absWorkingDir: here,
+    };
+}
+/** Builds the two halves and joins them. */
+export async function bundle(options) {
+    const runtime = await esbuild.build({ ...common(options), entryPoints: [runtimeEntry] });
+    const app = await esbuild.build({ ...common(options), entryPoints: [options.entry], alias: stubs });
+    const code = `${text(runtime)}\n${text(app)}`;
+    return {
+        code,
+        bytes: Buffer.byteLength(code),
+        warnings: [...runtime.warnings, ...app.warnings].map((warning) => warning.text),
+    };
+}
+function text(result) {
+    return result.outputFiles?.map((file) => file.text).join('\n') ?? '';
+}
+/** Builds and writes the bundle. */
+export async function buildApp(options) {
+    const result = await bundle(options);
+    await mkdir(dirname(options.outfile), { recursive: true });
+    await writeFile(options.outfile, result.code);
+    return result;
+}
+/**
+ * The dev loop: serves the dev bundle (devBuild.ts) for `NativeApp.watch(url:)`:
+ *
+ * | path | what |
+ * |---|---|
+ * | `/manifest.json` | `{ "vendor": <hash>, "app": <hash> }`, polled; `Cache-Control: no-store` |
+ * | `/vendor.js` | the vendor half, evaluated once (again when its hash changes) |
+ * | `/app.js` | the app half, evaluated again on every change: Fast Refresh |
+ *
+ * Rebuilds when the sources change (esbuild's watcher over the app's
+ * inputs), and writes the plain single bundle to `outfile` too, so an app
+ * built from Xcode without the server gets the latest. Returns a function
+ * that stops everything.
+ */
+export async function serve(options) {
+    const { buildDev } = await import('./devBuild.js');
+    let vendor = { code: '', hash: '' };
+    let app = { code: '', hash: '' };
+    const rebuild = async () => {
+        try {
+            const dev = await buildDev({ entry: options.entry, sourcemap: options.sourcemap ?? false });
+            vendor = { code: dev.vendor, hash: hash(dev.vendor) };
+            app = { code: dev.app, hash: hash(dev.app) };
+            const full = await buildApp(options);
+            options.onBuild?.({ ...full, warnings: [...full.warnings, ...dev.warnings] });
+        }
+        catch (error) {
+            options.onBuild?.(error instanceof Error ? error : new Error(String(error)));
+        }
+    };
+    await rebuild();
+    // esbuild's watcher over the app build's inputs.
+    const context = await esbuild.context({
+        ...common(options),
+        entryPoints: [options.entry],
+        alias: stubs,
+        plugins: [
+            {
+                name: 'swiftbrowser-native-rebuild',
+                setup(build) {
+                    let first = true;
+                    build.onEnd(() => {
+                        if (first) {
+                            first = false;
+                            return;
+                        }
+                        void rebuild();
+                    });
+                },
+            },
+        ],
+    });
+    await context.watch();
+    const port = options.port ?? 5173;
+    const server = createServer((request, response) => {
+        const url = request.url ?? '/';
+        const send = (body, type, etag) => {
+            response.setHeader('Content-Type', type);
+            response.setHeader('Cache-Control', 'no-store');
+            response.setHeader('ETag', `"${etag}"`);
+            if (request.headers['if-none-match'] === `"${etag}"`) {
+                response.statusCode = 304;
+                response.end();
+                return;
+            }
+            response.end(request.method === 'HEAD' ? undefined : body);
+        };
+        if (url === '/manifest.json' || url === '/') {
+            send(JSON.stringify({ vendor: vendor.hash, app: app.hash }), 'application/json', `${vendor.hash}-${app.hash}`);
+        }
+        else if (url === '/vendor.js') {
+            send(vendor.code, 'text/javascript; charset=utf-8', vendor.hash);
+        }
+        else if (url === '/app.js') {
+            send(app.code, 'text/javascript; charset=utf-8', app.hash);
+        }
+        else {
+            response.statusCode = 404;
+            response.end('not found');
+        }
+    });
+    await new Promise((resolve) => server.listen(port, resolve));
+    return async () => {
+        await context.dispose();
+        await new Promise((resolve) => server.close(() => resolve()));
+    };
+}
+function hash(text) {
+    return createHash('sha1').update(text).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/devBuild.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The dev bundle in two halves, for Fast Refresh (docs/native.md):
+ *
+ * - `vendor.js`: vendor.ts (the runtime, the refresh runtime, React,
+ *   `@swiftbrowser/react`, this package), evaluated once per vendor change.
+ * - `app.js`: the app's own modules, with `react`, `react/jsx-runtime`,
+ *   `@swiftbrowser/react` and `@swiftbrowser/native` resolved to shims that
+ *   read `__sbVendor`, and every module run through `react-refresh/babel`
+ *   so its components register with the refresh runtime. Evaluated again
+ *   on every save; `run` then refreshes the mounted components in place.
+ *
+ * Node only (serve in build.ts uses it).
+ */
+export interface DevBuildOptions {
+    entry: string;
+    sourcemap?: boolean;
+}
+export interface DevBundle {
+    vendor: string;
+    app: string;
+    warnings: string[];
+}
+/** The vendor half: vendor.ts with its dependencies. */
+export declare function buildVendor(options: DevBuildOptions): Promise<{
+    code: string;
+    warnings: string[];
+}>;
+/** The app half: the entry's own modules over the vendor shims, with the refresh transform. */
+export declare function buildApp(options: DevBuildOptions): Promise<{
+    code: string;
+    warnings: string[];
+}>;
+export declare function buildDev(options: DevBuildOptions): Promise<DevBundle>;
+//# sourceMappingURL=devBuild.d.ts.map

package/dist/devBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devBuild.d.ts","sourceRoot":"","sources":["../src/devBuild.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0CD,wDAAwD;AACxD,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAWzG;AAED,+FAA+F;AAC/F,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmDtG;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAG3E"}

package/dist/devBuild.js

@@ -0,0 +1,133 @@
+/**
+ * The dev bundle in two halves, for Fast Refresh (docs/native.md):
+ *
+ * - `vendor.js`: vendor.ts (the runtime, the refresh runtime, React,
+ *   `@swiftbrowser/react`, this package), evaluated once per vendor change.
+ * - `app.js`: the app's own modules, with `react`, `react/jsx-runtime`,
+ *   `@swiftbrowser/react` and `@swiftbrowser/native` resolved to shims that
+ *   read `__sbVendor`, and every module run through `react-refresh/babel`
+ *   so its components register with the refresh runtime. Evaluated again
+ *   on every save; `run` then refreshes the mounted components in place.
+ *
+ * Node only (serve in build.ts uses it).
+ */
+import { transformAsync } from '@babel/core';
+import * as esbuild from 'esbuild';
+import { createRequire } from 'node:module';
+import { dirname, extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const require = createRequire(import.meta.url);
+const here = dirname(fileURLToPath(import.meta.url));
+const vendorEntry = fileURLToPath(new URL('../src/vendor.ts', import.meta.url));
+const ownIndex = fileURLToPath(new URL('../src/index.ts', import.meta.url));
+const reactSources = fileURLToPath(new URL('../../react/src/index.ts', import.meta.url));
+/** The modules the app half takes from the vendor half. */
+const VENDORED = ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime', '@swiftbrowser/react', '@swiftbrowser/native'];
+function common(options) {
+    return {
+        bundle: true,
+        write: false,
+        format: 'iife',
+        platform: 'browser',
+        target: ['safari16'],
+        sourcemap: options.sourcemap ? 'inline' : false,
+        define: { 'process.env.NODE_ENV': '"development"', 'import.meta.env.DEV': 'true' },
+        jsx: 'automatic',
+        logLevel: 'silent',
+        absWorkingDir: here,
+    };
+}
+/** The export names of a module, for a shim with static exports. */
+async function exportNames(name) {
+    if (name === '@swiftbrowser/native')
+        return names(ownIndex);
+    if (name === '@swiftbrowser/react')
+        return names(reactSources);
+    // CommonJS (React): its exports are enumerable once required.
+    return Object.keys(require(name)).filter((key) => key !== 'default' && key !== '__esModule');
+}
+/** The export names of an ES module (its sources), from esbuild's metafile. */
+async function names(entry) {
+    const result = await esbuild.build({
+        entryPoints: [entry],
+        bundle: true,
+        write: false,
+        format: 'esm',
+        metafile: true,
+        platform: 'browser',
+        logLevel: 'silent',
+        absWorkingDir: here,
+        external: ['react', 'react-dom', 'react-dom/client', 'react-reconciler', 'react-reconciler/constants', 'react-refresh/runtime', '@babel/core', 'esbuild', 'node:*'],
+        alias: { '@swiftbrowser/react': reactSources },
+    });
+    return Object.values(result.metafile.outputs).flatMap((output) => output.exports).filter((key) => key !== 'default');
+}
+/** The vendor half: vendor.ts with its dependencies. */
+export async function buildVendor(options) {
+    const result = await esbuild.build({
+        ...common(options),
+        entryPoints: [vendorEntry],
+        alias: {
+            'react-dom/client': fileURLToPath(new URL('../src/stubs/react-dom-client.ts', import.meta.url)),
+            'react-dom': fileURLToPath(new URL('../src/stubs/react-dom.ts', import.meta.url)),
+            '@swiftbrowser/react': reactSources,
+        },
+    });
+    return { code: result.outputFiles.map((file) => file.text).join('\n'), warnings: result.warnings.map((w) => w.text) };
+}
+/** The app half: the entry's own modules over the vendor shims, with the refresh transform. */
+export async function buildApp(options) {
+    const shims = new Map();
+    for (const name of VENDORED) {
+        const exports = await exportNames(name);
+        shims.set(name, [
+            `const m = globalThis.__sbVendor[${JSON.stringify(name)}];`,
+            `if (!m) throw new Error(${JSON.stringify(`vendor.js was not loaded before app.js (no ${name})`)});`,
+            'export default m.default ?? m;',
+            ...exports.map((key) => `export const ${key} = m[${JSON.stringify(key)}];`),
+        ].join('\n'));
+    }
+    const refreshPlugin = require.resolve('react-refresh/babel');
+    const result = await esbuild.build({
+        ...common(options),
+        entryPoints: [options.entry],
+        plugins: [
+            {
+                name: 'swiftbrowser-native-dev',
+                setup(build) {
+                    const filter = new RegExp(`^(${VENDORED.map((name) => name.replace(/[/]/g, '\\/')).join('|')})$`);
+                    build.onResolve({ filter }, (args) => ({ path: args.path, namespace: 'sb-vendor' }));
+                    build.onLoad({ filter: /.*/, namespace: 'sb-vendor' }, (args) => ({ contents: shims.get(args.path), loader: 'js' }));
+                    // The app's own modules: TypeScript and JSX compiled by esbuild, then
+                    // the refresh transform, with the registration functions in scope.
+                    build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
+                        if (args.path.includes('/node_modules/'))
+                            return null;
+                        const { readFile } = await import('node:fs/promises');
+                        const source = await readFile(args.path, 'utf8');
+                        const loader = extname(args.path).slice(1);
+                        const compiled = await esbuild.transform(source, { loader, jsx: 'automatic', format: 'esm', sourcefile: args.path, target: 'es2022' });
+                        const refreshed = await transformAsync(compiled.code, {
+                            filename: args.path,
+                            configFile: false,
+                            babelrc: false,
+                            sourceType: 'module',
+                            plugins: [[refreshPlugin, { skipEnvCheck: true }]],
+                        });
+                        const prelude = [
+                            `const $RefreshReg$ = (type, id) => globalThis.__sbRefresh.register(type, ${JSON.stringify(args.path)} + ' ' + id);`,
+                            'const $RefreshSig$ = globalThis.__sbRefresh.createSignatureFunctionForTransform;',
+                        ].join('\n');
+                        return { contents: `${prelude}\n${refreshed?.code ?? compiled.code}`, loader: 'js' };
+                    });
+                },
+            },
+        ],
+    });
+    return { code: result.outputFiles.map((file) => file.text).join('\n'), warnings: result.warnings.map((w) => w.text) };
+}
+export async function buildDev(options) {
+    const [vendor, app] = await Promise.all([buildVendor(options), buildApp(options)]);
+    return { vendor: vendor.code, app: app.code, warnings: [...vendor.warnings, ...app.warnings] };
+}
+//# sourceMappingURL=devBuild.js.map