@swiftbrowser/cli 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# @swiftbrowser/cli
+
+Run an iOS SwiftUI app in the browser, from its Xcode project, without a Mac.
+
+```sh
+npx @swiftbrowser/cli doctor --install          # Swift 6.4, the wasm SDK, wasm-opt
+npx @swiftbrowser/cli dev ~/Projects/MyApp      # http://localhost:5173, rebuilds on save
+npx @swiftbrowser/cli build ~/Projects/MyApp    # ./dist: a static site to deploy anywhere
+```
+
+The app's sources compile unchanged against [SwiftBrowser](https://github.com/dabbott/SwiftBrowser)'s
+SwiftUI shim and run as WebAssembly inside an iPhone frame (or full screen on a
+phone: open the dev server's QR code, then Share → Add to Home Screen). What
+the shim does not provide is a compile error, never a wrong rendering.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `doctor [--install]` | Checks Node ≥ 22, Swift 6.4, the Swift SDK for WebAssembly and `wasm-opt`; `--install` fetches the SDK (`swift sdk install`) and Binaryen into `~/.cache/swiftbrowser`. Swift itself comes from [swiftly](https://www.swift.org/install/) (`swiftly install 6.4.0`), or point `SWIFT_TOOLCHAIN_BIN` at a toolchain's `usr/bin`. |
+| `check <path>` | Lists what the app imports (supported / rewritten / unsupported, with the usual way around each), then compiles the app natively against the shim. Seconds, no wasm; every error names your file and line. |
+| `dev <path>` | Builds the app for WebAssembly and serves it with the SwiftBrowser dev server: landing page with a QR code at `/`, the app at `/app/?app=<Name>`; saving a Swift file rebuilds and reloads with the app's state carried over. `--port`, `--host` (expose on the LAN for phones), `--open`. |
+| `build <path> [-o dist]` | A release build, optimized and stripped with `wasm-opt` (about 18 MB for a small app, 4.6 MB with brotli; 4.5 MB and 1.2 MB in lean mode), and a complete static site around it. `--no-optimize` skips wasm-opt. |
+
+`<path>` is an `.xcodeproj`, a folder holding one (directly or one level
+down), or a plain folder of Swift sources. Options for all three:
+`--target <name>` when the project has several app targets, `--config <file>`,
+`--foundation lean|full`, `--verbose`.
+
+## What happens to your project
+
+Nothing, outside `<project>/.swiftbrowser/` (add it to `.gitignore`). The CLI
+reads the Xcode project (`project.pbxproj`, including Xcode 16 synchronized
+folders) for the app target's Swift sources, asset catalogs, display name and
+app icon, then writes a SwiftPM package under `.swiftbrowser/<Name>/` whose one
+executable target is a copy of those sources, adjusted for the shim:
+
+- `import SwiftUI` also imports Foundation and the shim's `FoundationBridge`
+  (Apple's SwiftUI re-exports Foundation and Combine, so `UUID`, `JSONEncoder`,
+  `UserDefaults`, `Timer.publish` are in scope without an import). In lean mode
+  it imports `FoundationEssentials` and `FoundationLite` instead, and
+  `import Foundation` becomes those two (see Foundation below). Both also
+  import Observation, so `@Observable` works in a file that imports only
+  Foundation, as it does under Xcode.
+- A generated `_SwiftBrowserFoundation.swift` settles the names both the shim
+  and Foundation declare (`CGFloat`, `CGPoint`, `CGSize`, `CGRect`, `Timer`,
+  `RunLoop`, `UserDefaults`, `Bundle`) with typealiases, in the shim's favor.
+- The target's Copy Bundle Resources (or `resources` in `swiftbrowser.json`)
+  are served next to the module and mounted at `/bundle` before the app
+  starts, so `Bundle.main.url(forResource:withExtension:)` and
+  `Data(contentsOf:)` read them. Asset catalogs are handled separately
+  (`Image("name")`, `Color("name")`).
+- `#Preview { … }` blocks are blanked (the shim has no preview macro).
+- `SWIFTBROWSER` is defined, so platform-specific code can go behind
+  `#if SWIFTBROWSER` / `#if !SWIFTBROWSER`, like `#if os(iOS)`.
+
+Every change keeps line numbers, so compiler diagnostics point at your files.
+The package depends on `@swiftbrowser/swift` (the shim at the version this CLI
+was released with).
+
+## Foundation
+
+Two modes, measured through the same pipeline (release, `wasm-opt -Os`,
+stripped) on the Counter example:
+
+| Mode | What `import Foundation` means | Module | gzipped | brotli |
+|---|---|---|---|---|
+| `full` (default) | the wasm SDK's Foundation, ICU data trimmed to English | 18.3 MB | 6.7 MB | 4.6 MB |
+| `full`, `"locales": ["*"]` | the same with ICU's whole data package | 47 MB | 19.4 MB | 12.5 MB |
+| `lean` | `FoundationEssentials` + `FoundationLite` | 4.5 MB | 1.7 MB | 1.2 MB |
+
+**Full** links the real Foundation (swift-corelibs-foundation, as the wasm SDK
+ships it): `DateFormatter`, `NumberFormatter`, `NSString`, `Locale`-aware
+`formatted()`, `Measurement`, `NSRegularExpression`, `UserDefaults`, and the
+rest compile as on iOS. The SDK's Foundation carries ICU's complete 34 MB
+locale data package; the CLI pulls that package out of the SDK's archive, keeps
+the locale-independent tables plus the bundles of the languages in `"locales"`
+(default `["en"]`, 4.7 MB; the region part of a tag is ignored, every regional
+variant of a language stays), and links the trimmed package in the original's
+place. Formatting for a language that was dropped falls back to ICU's root
+locale (`11/14/2023, 22:13` and `€ 0.00` for French instead of
+`14/11/2023 22:13` and `0,00 €`); it never fails. Each language adds 100 to
+300 kB, Chinese 1.7 MB (its collation table); `["*"]` keeps everything. The
+trimmed package is cached per SDK and language set under
+`~/.cache/swiftbrowser/icu/`; the SDK itself is not modified. What Foundation
+lacks on WASI, the shim's `FoundationBridge` supplies: `Timer` (corelibs' needs
+a run loop WASI does not have) with `Timer.publish` + `onReceive`, and
+`RunLoop.main` for its signature; `UserDefaults`, which Foundation's cannot
+persist on WASI, saved by the browser per app (localStorage) and restored at
+the next launch; and `Bundle`, whose Foundation counterpart traps, reading the
+app's resources. Known gaps of corelibs Foundation on WASI: `NotificationCenter`'s
+closure observers and `OperationQueue` are missing.
+
+### Locale and time zone
+
+The app runs in the viewer's time zone and, within the languages it ships, the
+viewer's language, as an iOS app follows the device: `Locale.current`,
+`TimeZone.current`, `formatted()`, `DateFormatter` and `Text(_:format:)` all
+follow. The browser's first preferred language whose data the module carries
+(`"locales"`) is used with its region, so a British visitor to an app shipping
+`["en"]` gets `14/11/2023`; a visitor whose language is not shipped gets the
+first shipped language rather than a half-formatted root locale. Add
+`?locale=fr-FR` to the app URL to try a locale without changing the browser
+(an Xcode scheme's "App Language"). The headless harness pins `en_001` and
+GMT unless `SB_LOCALE` / `TZ` are set, so snapshots stay stable. Lean mode
+formats in US English regardless.
+
+The hook behind this: swift-foundation hard-codes `en_001` on WASI, so the
+CLI redirects that one function to FoundationBridge at link time
+(`--wrap`); it depends on the SDK's swift-foundation, which the CLI pins and
+CI checks. Lean mode does not have it.
+
+**Lean** (`--foundation lean`, or `"foundation": "lean"` in `swiftbrowser.json`)
+is for apps that must stay small: `FoundationEssentials` (Date, Calendar, UUID,
+Data, JSON, URL) plus `FoundationLite`, SwiftBrowser's Foundation-compatible
+layer (number and date format styles, `IndexSet`, `CharacterSet`,
+`UserDefaults`, `Timer`). A Foundation API outside it is a compile error naming
+it. Output is fixed to US English conventions.
+
+## swiftbrowser.json (optional)
+
+```json
+{
+  "name": "MyApp",
+  "displayName": "My App",
+  "target": "MyApp",
+  "sources": ["MyApp"],
+  "exclude": ["MyApp/Watch"],
+  "catalogs": ["MyApp/Assets.xcassets"],
+  "resources": ["MyApp/missions.json", "MyApp/Data"],
+  "icon": "MyApp/Assets.xcassets/AppIcon.appiconset/icon-1024.png",
+  "swiftLanguageMode": "5",
+  "foundation": "full",
+  "locales": ["en"],
+  "defines": ["DEMO"]
+}
+```
+
+Everything is optional; `sources`, `catalogs` and `resources` replace what the
+Xcode project says when set (a plain folder has resources only through the
+config); `locales` matters in full Foundation mode only (see above).
+
+## Frameworks
+
+Supported: SwiftUI (the shim's compatibility matrix is in the repository
+README), Observation, Swift Charts, Foundation (full mode), FoundationEssentials
+and FoundationLite (lean mode).
+`check` names the frameworks it knows have no browser counterpart yet (UIKit,
+SwiftData, Core Data, Combine, MapKit, Core ML, AVFoundation, UserNotifications,
+StoreKit, WidgetKit, PhotosUI, WebKit, …) with the usual way out: keep that code
+behind `#if !SWIFTBROWSER` and give the browser a stand-in behind `#if SWIFTBROWSER`.
+
+## Example
+
+Twelve of the nineteen "Hacking with SwiftUI" projects run from their Xcode
+projects without a change (WeSplit, Guess the Flag, Views and Modifiers,
+WordScramble, Animations, iExpense, Moonshot, Navigation, Accessibility,
+Flashzilla, Layout and Geometry, SnowSeeker); `check` names what stops each
+of the others, which all need a framework the browser has no counterpart for
+yet (Core ML, URLSession, SwiftData, Core Image, MapKit):
+
+```sh
+git clone --depth 1 https://github.com/twostraws/HackingWithSwift
+npx @swiftbrowser/cli check HackingWithSwift/SwiftUI/project4    # BetterRest: Core ML
+npx @swiftbrowser/cli dev HackingWithSwift/SwiftUI/project17     # Flashzilla
+```

package/bin/swiftbrowser.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// Entry point of the `swiftbrowser` command (see ../src/cli.ts).
+import { main } from '../dist/cli.js';
+
+main(process.argv.slice(2)).then(
+  (code) => process.exit(code),
+  (error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  },
+);

package/dist/build.d.ts

@@ -0,0 +1,36 @@
+import type { ResolvedApp } from './project.js';
+import { type StagedApp } from './stage.js';
+import { type Toolchain } from './toolchain.js';
+export interface RunResult {
+    status: number;
+    output: string;
+}
+/** Runs a command, capturing stdout+stderr interleaved; `onOutput` streams it as it arrives. */
+export declare function run(command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    onOutput?: (chunk: string) => void;
+}): Promise<RunResult>;
+/** Only the diagnostics and the summary lines of a SwiftPM build log. */
+export declare function stripAnsi(text: string): string;
+export declare function diagnosticsOnly(output: string): string;
+export interface BuildOptions {
+    toolchain: Toolchain;
+    staged: StagedApp;
+    app: ResolvedApp;
+    /** Stream the compiler output while it runs. */
+    verbose?: boolean;
+    onOutput?: (chunk: string) => void;
+}
+/** `swift build` for the host: compile errors only, no module produced that we use. */
+export declare function checkHost(options: BuildOptions): Promise<void>;
+/**
+ * Builds the module for WebAssembly (release) and copies it to `wasmOutput(app)`;
+ * with `wasmOpt` set it is also optimized for size and stripped (the ~2.5×
+ * smaller download of a `build`; `dev` skips it for quick rebuilds).
+ */
+export declare function buildWasm(options: BuildOptions & {
+    wasmOpt?: string | null;
+}): Promise<string>;
+export declare function fileSize(file: string): number;
+export declare function formatBytes(bytes: number): string;

package/dist/build.js

@@ -0,0 +1,124 @@
+// Compiling the staging package: natively for `check` (fast, same
+// diagnostics), for WebAssembly for `dev` and `build`, then wasm-opt.
+import { spawn } from 'node:child_process';
+import { copyFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { CliError } from './log.js';
+import { remapDiagnostics, wasmOutput } from './stage.js';
+import { WASM_SDK, toolchainEnv } from './toolchain.js';
+/** Runs a command, capturing stdout+stderr interleaved; `onOutput` streams it as it arrives. */
+export function run(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { cwd: options.cwd, env: options.env, stdio: ['ignore', 'pipe', 'pipe'] });
+        let output = '';
+        const collect = (chunk) => {
+            const text = chunk.toString('utf8');
+            output += text;
+            options.onOutput?.(text);
+        };
+        child.stdout.on('data', collect);
+        child.stderr.on('data', collect);
+        child.on('error', reject);
+        child.on('close', (status) => resolve({ status: status ?? 1, output }));
+    });
+}
+/** Only the diagnostics and the summary lines of a SwiftPM build log. */
+export function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
+}
+export function diagnosticsOnly(output) {
+    const lines = stripAnsi(output).split('\n');
+    const kept = [];
+    let inDiagnostic = false;
+    for (const line of lines) {
+        // SwiftPM's own summary lines repeat what the compiler already said.
+        if (/^error: (SwiftCompile|Build failed|fatalError)/.test(line) || /^\s+(cd |builtin-)/.test(line)) {
+            inDiagnostic = false;
+            continue;
+        }
+        if (/:\d+:\d+: warning: /.test(line)) {
+            // Warnings (mostly the shim's own, compiled in the same build) are noise next to the errors.
+            inDiagnostic = false;
+            continue;
+        }
+        if (/:\d+:\d+: note: /.test(line)) {
+            // A note explains the diagnostic above it; keep it only after an error.
+            if (inDiagnostic)
+                kept.push(line);
+            continue;
+        }
+        if (/:\d+:\d+: error: /.test(line) || /^error: /.test(line)) {
+            inDiagnostic = true;
+            kept.push(line);
+        }
+        else if (inDiagnostic && (/^\s/.test(line) || line === '')) {
+            // Source excerpts and carets belong to the diagnostic above.
+            kept.push(line);
+            if (line === '')
+                inDiagnostic = false;
+        }
+        else {
+            inDiagnostic = false;
+        }
+    }
+    return kept.join('\n').trim();
+}
+/** `swift build` for the host: compile errors only, no module produced that we use. */
+export async function checkHost(options) {
+    const { toolchain, staged, app } = options;
+    const result = await run(toolchain.swift, ['build', '--product', app.name], {
+        cwd: staged.dir,
+        env: toolchainEnv(toolchain),
+        ...(options.onOutput ? { onOutput: options.onOutput } : {}),
+    });
+    if (result.status !== 0)
+        throw new CliError(remapDiagnostics(diagnosticsOnly(result.output) || result.output, staged));
+}
+/**
+ * Builds the module for WebAssembly (release) and copies it to `wasmOutput(app)`;
+ * with `wasmOpt` set it is also optimized for size and stripped (the ~2.5×
+ * smaller download of a `build`; `dev` skips it for quick rebuilds).
+ */
+export async function buildWasm(options) {
+    const { toolchain, staged, app } = options;
+    const env = toolchainEnv(toolchain);
+    const common = ['--swift-sdk', WASM_SDK, '-c', 'release'];
+    const result = await run(toolchain.swift, ['build', ...common, '--product', app.name], {
+        cwd: staged.dir,
+        env,
+        ...(options.onOutput ? { onOutput: options.onOutput } : {}),
+    });
+    if (result.status !== 0)
+        throw new CliError(remapDiagnostics(diagnosticsOnly(result.output) || result.output, staged));
+    const binPath = await run(toolchain.swift, ['build', ...common, '--show-bin-path'], { cwd: staged.dir, env });
+    if (binPath.status !== 0)
+        throw new CliError(`swift build --show-bin-path failed:\n${binPath.output}`);
+    const built = path.join(binPath.output.trim().split('\n').pop(), `${app.name}.wasm`);
+    if (!existsSync(built))
+        throw new CliError(`expected ${built} after the build`);
+    const out = wasmOutput(app);
+    mkdirSync(path.dirname(out), { recursive: true });
+    if (options.wasmOpt) {
+        // -Os without the slowest -Oz passes; the features come from the module.
+        // --strip-debug drops DWARF and names, --strip-producers the toolchain record.
+        const opt = await run(options.wasmOpt, ['-Os', '--strip-debug', '--strip-producers', built, '-o', out], { cwd: staged.dir, env });
+        if (opt.status !== 0)
+            throw new CliError(`wasm-opt failed:\n${opt.output}`);
+    }
+    else {
+        copyFileSync(built, out);
+    }
+    return out;
+}
+export function fileSize(file) {
+    return statSync(file).size;
+}
+export function formatBytes(bytes) {
+    if (bytes >= 1_000_000)
+        return `${(bytes / 1_000_000).toFixed(1)} MB`;
+    if (bytes >= 1_000)
+        return `${(bytes / 1_000).toFixed(0)} kB`;
+    return `${bytes} B`;
+}
+//# 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/cli.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+export declare function main(argv: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,137 @@
+// `swiftbrowser <command> [path] [options]`: argument parsing and dispatch.
+import { parseArgs } from 'node:util';
+import { CliError, bold, dim, error } from './log.js';
+export const VERSION = '0.1.0';
+const HELP = `${bold('swiftbrowser')} ${VERSION}: run an iOS SwiftUI app in the browser.
+
+${bold('Usage')}
+  swiftbrowser doctor [--install]            check (and install) Swift, the wasm SDK and wasm-opt
+  swiftbrowser check <path> [options]        import report and a native compile against the shim
+  swiftbrowser dev <path> [options]          run the app with rebuild on save
+  swiftbrowser build <path> [-o <dir>]       optimized module and a static site
+
+${bold('<path>')} is an .xcodeproj, a folder holding one, or a folder of Swift sources
+(optionally with a swiftbrowser.json).
+
+${bold('Options')}
+  --target <name>        the Xcode app target to build (when there are several)
+  --config <file>        a swiftbrowser.json other than the project's
+  --foundation <mode>    full (default: the wasm SDK's Foundation, ICU data trimmed to the
+                         project's "locales"; ~19 MB) or lean (import Foundation →
+                         FoundationEssentials + FoundationLite; ~5 MB, smaller API)
+  --port <n>, --host     dev server port (default 5173) and LAN exposure (dev)
+  --open                 open the browser (dev)
+  -o, --out <dir>        output directory (build; default <project>/dist)
+  --no-optimize          skip wasm-opt (build)
+  --verbose              stream the compiler output
+  -h, --help, --version
+`;
+export async function main(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                version: { type: 'boolean' },
+                install: { type: 'boolean' },
+                target: { type: 'string' },
+                config: { type: 'string' },
+                foundation: { type: 'string' },
+                port: { type: 'string' },
+                host: { type: 'string' },
+                open: { type: 'boolean' },
+                out: { type: 'string', short: 'o' },
+                optimize: { type: 'boolean', default: true },
+                'no-optimize': { type: 'boolean' },
+                verbose: { type: 'boolean' },
+            },
+        });
+    }
+    catch (err) {
+        error(err instanceof Error ? err.message : String(err));
+        console.log(HELP);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.version) {
+        console.log(VERSION);
+        return 0;
+    }
+    const [command, input] = positionals;
+    if (values.help || !command) {
+        console.log(HELP);
+        return command ? 0 : 2;
+    }
+    const foundationArg = values.foundation;
+    if (foundationArg !== undefined && foundationArg !== 'lean' && foundationArg !== 'full') {
+        error(`--foundation must be lean or full`);
+        return 2;
+    }
+    const foundation = foundationArg;
+    const appOptions = {
+        ...(values.target ? { target: values.target } : {}),
+        ...(values.config ? { config: values.config } : {}),
+        ...(foundation ? { foundation } : {}),
+    };
+    const needsPath = () => {
+        if (!input)
+            throw new CliError(`${command} needs a path: an .xcodeproj, a folder with one, or a folder of Swift sources`, 2);
+        return input;
+    };
+    try {
+        switch (command) {
+            case 'doctor': {
+                const { doctor } = await import('./commands/doctor.js');
+                const result = await doctor({ ...(values.install ? { install: true } : {}) });
+                return result.toolchain && result.wasmSdk ? 0 : 1;
+            }
+            case 'check': {
+                const { check } = await import('./commands/check.js');
+                await check(needsPath(), { ...appOptions, ...(values.verbose ? { verbose: true } : {}) });
+                return 0;
+            }
+            case 'dev': {
+                const { dev } = await import('./commands/dev.js');
+                const port = values.port !== undefined ? Number(values.port) : undefined;
+                if (port !== undefined && !Number.isInteger(port))
+                    throw new CliError('--port must be a number', 2);
+                await dev(needsPath(), {
+                    ...appOptions,
+                    ...(port !== undefined ? { port } : {}),
+                    ...(values.host !== undefined ? { host: values.host === '' ? true : values.host } : {}),
+                    ...(values.open ? { open: true } : {}),
+                });
+                return 0;
+            }
+            case 'build': {
+                const { build } = await import('./commands/build.js');
+                await build(needsPath(), {
+                    ...appOptions,
+                    ...(values.out ? { outDir: values.out } : {}),
+                    ...(values['no-optimize'] ? { optimize: false } : {}),
+                    ...(values.verbose ? { verbose: true } : {}),
+                });
+                return 0;
+            }
+            default:
+                error(`unknown command: ${command}`);
+                console.log(HELP);
+                return 2;
+        }
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            error(err.message);
+            return err.exitCode;
+        }
+        error(err instanceof Error ? (err.stack ?? err.message) : String(err));
+        return 1;
+    }
+    finally {
+        if (process.stdout.isTTY)
+            process.stdout.write(dim(''));
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/build.d.ts

@@ -0,0 +1,8 @@
+import { type AppOptions } from './shared.js';
+export interface BuildOptions extends AppOptions {
+    outDir?: string;
+    verbose?: boolean;
+    /** Skip wasm-opt even when available. */
+    optimize?: boolean;
+}
+export declare function build(input: string, options: BuildOptions): Promise<void>;

package/dist/commands/build.js

@@ -0,0 +1,33 @@
+// `swiftbrowser build <path> -o <dir>`: an optimized module and a complete
+// static site around it (landing page, app page, catalog, manifest).
+import { mkdirSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { buildSite } from '@swiftbrowser/web';
+import { fileSize, formatBytes } from '../build.js';
+import { bold, dim, info, ok, warn } from '../log.js';
+import { findWasmOpt } from '../toolchain.js';
+import { appSpec, icuDataFor } from './dev.js';
+import { describeApp, describeReport, prepare, requireToolchain } from './shared.js';
+export async function build(input, options) {
+    const { app, report, staged } = await prepare(input, options);
+    describeApp(app);
+    describeReport(report, app);
+    const toolchain = requireToolchain({ wasm: true });
+    const wasmOpt = options.optimize === false ? null : findWasmOpt();
+    if (options.optimize !== false && !wasmOpt) {
+        info(warn('wasm-opt not found; the module is not optimized (`swiftbrowser doctor --install` downloads binaryen)'));
+    }
+    const outDir = path.resolve(options.outDir ?? path.join(app.root, 'dist'));
+    const spec = appSpec(app, staged, toolchain, { wasmOpt, icu: icuDataFor(app, toolchain) });
+    info(dim(`\nbuilding ${app.name} for WebAssembly (release${wasmOpt ? ', wasm-opt -Os' : ''})…`));
+    const started = Date.now();
+    // Re-stages with the ICU data, builds, and optimizes into `spec.wasm`.
+    await spec.build();
+    info(ok(`${bold(app.name)}.wasm ${dim(`${formatBytes(fileSize(spec.wasm))}, ${((Date.now() - started) / 1000).toFixed(1)} s`)}`));
+    rmSync(outDir, { recursive: true, force: true });
+    mkdirSync(outDir, { recursive: true });
+    await buildSite({ apps: [spec], outDir, logLevel: options.verbose ? 'info' : 'warn' });
+    const shown = path.relative(process.cwd(), outDir);
+    info(ok(`site written to ${bold(shown && !shown.startsWith('..') ? shown : outDir)} ${dim(`(serve it from any static host; the app page is /app/?app=${app.name})`)}`));
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,4 @@
+import { type AppOptions } from './shared.js';
+export declare function check(input: string, options: AppOptions & {
+    verbose?: boolean;
+}): Promise<void>;

package/dist/commands/check.js

@@ -0,0 +1,27 @@
+// `swiftbrowser check <path>`: the import report, then a native compile of the
+// staged sources against the shim. Seconds, no wasm; every error names the
+// user's own file and line.
+import { checkHost } from '../build.js';
+import { CliError, bold, dim, info, ok } from '../log.js';
+import { describeApp, describeReport, prepare, requireToolchain } from './shared.js';
+export async function check(input, options) {
+    const { app, report, staged } = await prepare(input, options);
+    describeApp(app);
+    const blocked = describeReport(report, app);
+    const toolchain = requireToolchain({ wasm: false });
+    info(dim(`\ncompiling ${app.name} against the shim (Swift ${toolchain.version}, host build)…`));
+    const started = Date.now();
+    try {
+        await checkHost({ toolchain, staged, app, ...(options.verbose ? { onOutput: (chunk) => process.stdout.write(chunk) } : {}) });
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            info(error.message);
+            const lines = (error.message.match(/: error: /g) ?? []).length;
+            throw new CliError(`\n${bold(`${app.name} does not compile against the shim`)}: ${lines} error${lines === 1 ? '' : 's'}${blocked ? ' (see the unsupported imports above)' : ''}`);
+        }
+        throw error;
+    }
+    info(ok(`${bold(app.name)} compiles against the shim ${dim(`(${((Date.now() - started) / 1000).toFixed(1)} s)`)}`));
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2EAA2E;AAC3E,4BAA4B;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAa,EAAE,OAA2C;IACpF,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9D,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,IAAI,4BAA4B,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAC/D,MAAM,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,oCAAoC,CAAC,KAAK,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACtH,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,19 @@
+import { type AppSpec } from '@swiftbrowser/web';
+import { type ICUData } from '../icu.js';
+import { type ResolvedApp } from '../project.js';
+import { type StagedApp } from '../stage.js';
+import type { Toolchain } from '../toolchain.js';
+import { type AppOptions } from './shared.js';
+export interface DevOptions extends AppOptions {
+    port?: number;
+    host?: string | boolean;
+    open?: boolean;
+}
+/** For a full-Foundation app, the trimmed ICU data (made once per SDK and language set, then cached). */
+export declare function icuDataFor(app: ResolvedApp, toolchain: Toolchain): ICUData | null;
+/** The registry entry the web dev server runs the app from. */
+export declare function appSpec(app: ResolvedApp, staged: StagedApp, toolchain: Toolchain, options: {
+    wasmOpt?: string | null;
+    icu?: ICUData | null;
+}): AppSpec;
+export declare function dev(input: string, options: DevOptions): Promise<void>;