@swiftbrowser/cli 0.1.0

package/dist/stage.js

@@ -0,0 +1,344 @@
+// The staging package: a SwiftPM package under `<project>/.swiftbrowser/<App>/`
+// whose one executable target is a copy of the app's sources, adjusted for
+// the shim, depending on the SwiftBrowser package by path. The user's project
+// is never written to outside that folder.
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { ICU_TARGET, icuAssembly } from './icu.js';
+/** Where an app's staging package lives. */
+export function stagingDir(app) {
+    return path.join(app.root, '.swiftbrowser', app.name);
+}
+/** The built module, optimized or not. */
+export function wasmOutput(app) {
+    return path.join(stagingDir(app), `${app.name}.wasm`);
+}
+/**
+ * Adjusts one source for the shim without moving any line, so compiler
+ * diagnostics keep their line numbers:
+ * - `import SwiftUI` also imports the Foundation modules (lean: FoundationEssentials
+ *   + FoundationLite; full: Foundation + FoundationBridge), as Apple's SwiftUI
+ *   re-exports Foundation;
+ * - lean: `import Foundation` → `import FoundationEssentials; import FoundationLite`,
+ *   which is what the SwiftBrowser examples import by hand; in both modes the
+ *   line also imports Observation (Apple's Foundation re-exports it, so
+ *   `@Observable` works in a file that imports Foundation alone);
+ * - full: `import FoundationLite` → `import FoundationBridge` (the examples'
+ *   `#if canImport(FoundationEssentials)` branch, against the real Foundation);
+ * - `#Preview { … }` blocks (and `#Preview("name", traits: …) { … }`) become
+ *   blank lines: the shim has no preview macro and previews are not part of
+ *   the app.
+ */
+export function transformSource(text, options) {
+    let foundationRewrites = 0;
+    let out = text;
+    // On Apple platforms `import SwiftUI` re-exports Foundation (UUID, JSON,
+    // Date, UserDefaults are in scope without an import); the shim's SwiftUI
+    // does not, so the same modules are imported next to it.
+    const companions = options.foundation === 'lean' ? 'import FoundationEssentials; import FoundationLite; import Observation' : 'import Foundation; import FoundationBridge; import Observation';
+    out = out.replace(/^([ \t]*)import SwiftUI[ \t]*(\r?)$/gm, (_, indent, cr) => `${indent}import SwiftUI; ${companions}${cr}`);
+    if (options.foundation === 'lean') {
+        out = out.replace(/^([ \t]*)import Foundation[ \t]*(\r?)$/gm, (_, indent, cr) => {
+            foundationRewrites += 1;
+            return `${indent}import FoundationEssentials; import FoundationLite; import Observation${cr}`;
+        });
+    }
+    else {
+        out = out.replace(/^([ \t]*)import Foundation[ \t]*(\r?)$/gm, (_, indent, cr) => `${indent}import Foundation; import Observation${cr}`);
+        out = out.replace(/^([ \t]*)import FoundationLite[ \t]*(\r?)$/gm, (_, indent, cr) => {
+            foundationRewrites += 1;
+            return `${indent}import FoundationBridge${cr}`;
+        });
+    }
+    const stripped = stripPreviews(out);
+    return { text: stripped.text, previewsStripped: stripped.count, foundationRewrites };
+}
+/** Replaces every `#Preview …{ … }` block with blank lines of the same count. */
+export function stripPreviews(text) {
+    let count = 0;
+    let result = '';
+    let index = 0;
+    const pattern = /^[ \t]*#Preview\b/gm;
+    for (;;) {
+        pattern.lastIndex = index;
+        const match = pattern.exec(text);
+        if (!match)
+            break;
+        const start = match.index;
+        const open = text.indexOf('{', start);
+        if (open < 0)
+            break;
+        const close = matchingBrace(text, open);
+        if (close < 0)
+            break;
+        // Consume the rest of the line after the closing brace (usually nothing).
+        let end = close + 1;
+        while (end < text.length && (text[end] === ' ' || text[end] === '\t'))
+            end += 1;
+        result += text.slice(index, start);
+        const removed = text.slice(start, end);
+        result += removed.replace(/[^\n]/g, '');
+        count += 1;
+        index = end;
+    }
+    result += text.slice(index);
+    return { text: result, count };
+}
+/** Index of the `}` closing the `{` at `open`, skipping strings and comments; -1 when unbalanced. */
+export function matchingBrace(text, open) {
+    let depth = 0;
+    let i = open;
+    while (i < text.length) {
+        const ch = text[i];
+        const next = text[i + 1];
+        if (ch === '/' && next === '/') {
+            i = text.indexOf('\n', i);
+            if (i < 0)
+                return -1;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            const end = text.indexOf('*/', i + 2);
+            if (end < 0)
+                return -1;
+            i = end + 2;
+            continue;
+        }
+        if (ch === '"') {
+            i = skipString(text, i);
+            if (i < 0)
+                return -1;
+            continue;
+        }
+        if (ch === '{')
+            depth += 1;
+        if (ch === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+        i += 1;
+    }
+    return -1;
+}
+/** Index just past a string literal starting at `start` (`"…"`, `"""…"""`, raw `#"…"#`), interpolations included; -1 when unterminated. */
+function skipString(text, start) {
+    const triple = text.startsWith('"""', start);
+    const quote = triple ? '"""' : '"';
+    let i = start + quote.length;
+    while (i < text.length) {
+        if (text[i] === '\\') {
+            if (text[i + 1] === '(') {
+                // Interpolation: skip to its matching parenthesis.
+                let depth = 0;
+                let j = i + 1;
+                while (j < text.length) {
+                    const c = text[j];
+                    if (c === '"') {
+                        j = skipString(text, j);
+                        if (j < 0)
+                            return -1;
+                        continue;
+                    }
+                    if (c === '(')
+                        depth += 1;
+                    if (c === ')') {
+                        depth -= 1;
+                        if (depth === 0)
+                            break;
+                    }
+                    j += 1;
+                }
+                i = j + 1;
+                continue;
+            }
+            i += 2;
+            continue;
+        }
+        if (text.startsWith(quote, i))
+            return i + quote.length;
+        i += 1;
+    }
+    return -1;
+}
+/** The Package.swift of the staging package. */
+export function packageManifest(app, swiftPackagePath) {
+    const languageMode = app.swiftLanguageMode === '6' ? '.v6' : '.v5';
+    const defines = ['SWIFTBROWSER', ...app.defines].map((d) => `.define(${JSON.stringify(d)})`).join(', ');
+    const products = app.foundation === 'lean' ? ['SwiftUI', 'Charts', 'FoundationLite'] : ['SwiftUI', 'Charts', 'FoundationBridge'];
+    const deps = [
+        ...products.map((p) => `.product(name: ${JSON.stringify(p)}, package: "SwiftBrowser")`),
+        ...(app.foundation === 'full' ? [JSON.stringify(ICU_TARGET)] : []),
+    ].join(',\n                ');
+    // Locale.current follows the host's choice (SB_LOCALE): the two functions
+    // that hard-code en_001 in swift-foundation are redirected to FoundationBridge.
+    const localeWrap = app.foundation === 'full'
+        ? `
+    // Full Foundation only: route swift-foundation's hard-coded current locale
+    // (and preferred languages) to FoundationBridge/Locale.swift.
+    + ["-Xlinker", "--wrap=$s20FoundationEssentials11LocaleCacheV11preferencesAA0C11PreferencesV_SbtyF",
+       "-Xlinker", "--wrap=$s20FoundationEssentials6LocaleV18preferredLanguagesSaySSGvgZ"]`
+        : '';
+    const icuTarget = app.foundation === 'full'
+        ? `
+        // Foundation's ICU reads its locale data from a symbol this target
+        // defines, trimmed to the app's languages, ahead of the SDK's 34 MB
+        // original (see @swiftbrowser/cli src/icu.ts).
+        .target(name: ${JSON.stringify(ICU_TARGET)}, path: ${JSON.stringify(ICU_TARGET)}),`
+        : '';
+    return `// swift-tools-version: 6.0
+// Generated by @swiftbrowser/cli for ${app.displayName}. Do not edit: it is
+// rewritten on every build. Sources/ holds the app's sources, adjusted for
+// the shim (see stage.ts); the SwiftBrowser package is referenced by path.
+import PackageDescription
+
+// C-ABI entry points the browser renderer calls; the linker must keep them.
+let wasmExports = ["sb_event", "sb_ops_ptr", "sb_ops_len", "sb_ops_clear",
+                   "sb_alloc", "sb_event_json", "sb_state_ptr", "sb_state_len", "sb_run_jobs"]
+    .flatMap { ["-Xlinker", "--export=\\($0)"] }
+    // The reconciler recurses once per view; 8 MB of stack like a native thread.
+    + ["-Xlinker", "-z", "-Xlinker", "stack-size=8388608"]${localeWrap}
+
+let package = Package(
+    name: ${JSON.stringify(app.name)},
+    platforms: [.macOS(.v14)],
+    products: [.executable(name: ${JSON.stringify(app.name)}, targets: [${JSON.stringify(app.name)}])],
+    dependencies: [.package(name: "SwiftBrowser", path: ${JSON.stringify(swiftPackagePath)})],
+    targets: [
+        .executableTarget(
+            name: ${JSON.stringify(app.name)},
+            dependencies: [
+                ${deps}
+            ],
+            path: "Sources",
+            swiftSettings: [${defines}, .swiftLanguageMode(${languageMode})],
+            linkerSettings: [.unsafeFlags(wasmExports, .when(platforms: [.wasi]))]
+        ),${icuTarget}
+    ]
+)
+`;
+}
+/** The staged file that settles names declared by both the shim and Foundation. */
+export const FULL_FOUNDATION_FILE = '_SwiftBrowserFoundation.swift';
+/**
+ * In full mode the app imports both the shim and the real Foundation, and
+ * both declare a few names (the shim cannot import Foundation itself, which
+ * would link it into every lean app; and a module does not shadow another's
+ * declarations, only the current module's do). A typealias in the app module
+ * does: these point the shared names at the shim's types (what its
+ * `frame(width:)` and friends take) and at FoundationBridge's `Timer` and
+ * `RunLoop`, which Foundation lacks on WASI (`RunLoop` is marked unavailable,
+ * its `Timer` needs CFRunLoop and does not link).
+ */
+export function fullFoundationSource() {
+    return `// Generated by @swiftbrowser/cli; rewritten on every build.
+// The shim and Foundation both declare these names. A typealias in the app
+// module settles each in the shim's favor (SwiftUI's geometry) or on the
+// bridge (Timer and RunLoop, which the SDK's Foundation does not have on WASI).
+import SwiftUI
+import Foundation
+import FoundationBridge
+
+// Public, so the app's own public API may use the names (a public method of
+// a Layout returning CGSize, for one).
+public typealias CGFloat = SwiftUI.CGFloat
+public typealias CGPoint = SwiftUI.CGPoint
+public typealias CGSize = SwiftUI.CGSize
+public typealias CGRect = SwiftUI.CGRect
+public typealias Timer = FoundationBridge.Timer
+public typealias RunLoop = FoundationBridge.RunLoop
+// UserDefaults persists through the browser; Bundle reads the app's resources.
+// Foundation's own cannot persist on WASI, and its Bundle.main traps.
+public typealias UserDefaults = FoundationBridge.UserDefaults
+public typealias Bundle = FoundationBridge.Bundle
+`;
+}
+/** The directory the staged sources keep their layout relative to. */
+export function commonSourceBase(app) {
+    let base = path.dirname(app.sources[0]);
+    for (const file of app.sources) {
+        while (!file.startsWith(`${base}${path.sep}`) && base !== path.dirname(base))
+            base = path.dirname(base);
+    }
+    return base;
+}
+function writeIfChanged(file, content) {
+    if (existsSync(file) && readFileSync(file, 'utf8') === content)
+        return false;
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, content);
+    return true;
+}
+function listFiles(dir, out = []) {
+    if (!existsSync(dir))
+        return out;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            listFiles(full, out);
+        else
+            out.push(full);
+    }
+    return out;
+}
+/**
+ * Writes (or refreshes) the staging package. Files are written only when
+ * their content changed, so SwiftPM's incremental build stays incremental;
+ * staged files whose source is gone are removed.
+ */
+export function stage(app, swiftPackagePath, options = {}) {
+    const dir = stagingDir(app);
+    const sourcesDir = path.join(dir, 'Sources');
+    mkdirSync(sourcesDir, { recursive: true });
+    writeIfChanged(path.join(dir, 'Package.swift'), packageManifest(app, swiftPackagePath));
+    const icuDir = path.join(dir, ICU_TARGET);
+    if (app.foundation === 'full') {
+        writeIfChanged(path.join(icuDir, 'icudt.S'), icuAssembly(options.icu ?? null));
+        // SwiftPM insists on a public headers directory for a C target.
+        writeIfChanged(path.join(icuDir, 'include', `${ICU_TARGET}.h`), '// Nothing to include: the target holds data only.\n');
+    }
+    else {
+        rmSync(icuDir, { recursive: true, force: true });
+    }
+    const base = commonSourceBase(app);
+    const originals = new Map();
+    const keep = new Set();
+    let previewsStripped = 0;
+    for (const file of app.sources) {
+        const relative = path.relative(base, file);
+        const staged = path.join(sourcesDir, relative);
+        const transformed = transformSource(readFileSync(file, 'utf8'), { foundation: app.foundation });
+        previewsStripped += transformed.previewsStripped;
+        writeIfChanged(staged, transformed.text);
+        originals.set(staged, file);
+        keep.add(staged);
+    }
+    if (app.foundation === 'full') {
+        const generated = path.join(sourcesDir, FULL_FOUNDATION_FILE);
+        writeIfChanged(generated, fullFoundationSource());
+        keep.add(generated);
+    }
+    for (const stale of listFiles(sourcesDir)) {
+        if (!keep.has(stale))
+            rmSync(stale, { force: true });
+    }
+    // Drop directories left empty by removals.
+    pruneEmptyDirs(sourcesDir, sourcesDir);
+    return { dir, originals, previewsStripped };
+}
+function pruneEmptyDirs(dir, root) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory())
+            pruneEmptyDirs(path.join(dir, entry.name), root);
+    }
+    if (dir !== root && readdirSync(dir).length === 0 && statSync(dir).isDirectory())
+        rmSync(dir, { recursive: true });
+}
+/** Rewrites staged paths in compiler output back to the user's files. */
+export function remapDiagnostics(output, staged) {
+    let result = output;
+    for (const [stagedPath, original] of staged.originals)
+        result = result.split(stagedPath).join(original);
+    return result;
+}
+//# sourceMappingURL=stage.js.map

package/dist/stage.js.map

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

package/dist/toolchain.d.ts

@@ -0,0 +1,42 @@
+/** The Swift release the shim is built and tested with; the wasm SDK must match it. */
+export declare const SWIFT_VERSION = "6.4.0";
+export declare const WASM_SDK = "swift-6.4.0-RELEASE_wasm";
+export declare const WASM_SDK_URL = "https://download.swift.org/swift-6.4.0-release/wasm-sdk/swift-6.4.0-RELEASE/swift-6.4.0-RELEASE_wasm.artifactbundle.tar.gz";
+export declare const WASM_SDK_CHECKSUM = "f07b7be3c586d92d7a07051fc6d303b87ebea67eadc40640ba59d5a8b79aa86d";
+export declare const BINARYEN_VERSION = "version_123";
+export interface Toolchain {
+    /** Path of the `swift` executable. */
+    swift: string;
+    /** Its `usr/bin` directory, prepended to PATH for child processes. */
+    bin: string;
+    /** `Swift version X.Y.Z` as reported by `swift --version`. */
+    version: string;
+}
+/** The CLI's cache (binaryen lives here). `$SWIFTBROWSER_CACHE` overrides. */
+export declare function cacheDir(): string;
+export declare function swiftVersionOf(swift: string): string | null;
+/** True when `version` is the required release (patch digits may be omitted by the toolchain). */
+export declare function isRequiredVersion(version: string): boolean;
+/** Candidate `swift` executables, most specific first. */
+export declare function swiftCandidates(env?: NodeJS.ProcessEnv): string[];
+/** The first candidate that runs and reports the required version, else the first that runs at all (for diagnostics), else null. */
+export declare function findToolchain(env?: NodeJS.ProcessEnv): {
+    toolchain: Toolchain | null;
+    fallback: Toolchain | null;
+};
+/** Environment for `swift` child processes: the toolchain first on PATH. */
+export declare function toolchainEnv(toolchain: Toolchain, env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Whether `swift sdk list` names the wasm SDK. */
+export declare function hasWasmSdk(toolchain: Toolchain): boolean;
+/** Installs the wasm SDK with `swift sdk install`; returns the command output. */
+export declare function installWasmSdk(toolchain: Toolchain): {
+    ok: boolean;
+    output: string;
+};
+export declare function wasmOptVersionOf(wasmOpt: string): string | null;
+/** The cached binaryen directory for the pinned version. */
+export declare function binaryenDir(): string;
+/** `$BINARYEN_BIN/wasm-opt`, the cached install, or one on PATH. */
+export declare function findWasmOpt(env?: NodeJS.ProcessEnv): string | null;
+/** Downloads the pinned binaryen release into the cache and returns the wasm-opt path. */
+export declare function installBinaryen(): Promise<string>;

package/dist/toolchain.js

@@ -0,0 +1,159 @@
+// Finding (and installing) what a build needs: a Swift toolchain of the
+// release SwiftBrowser is built with, its Swift SDK for WebAssembly, and
+// Binaryen's wasm-opt for optimized `build`s.
+import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import path from 'node:path';
+/** The Swift release the shim is built and tested with; the wasm SDK must match it. */
+export const SWIFT_VERSION = '6.4.0';
+export const WASM_SDK = `swift-${SWIFT_VERSION}-RELEASE_wasm`;
+export const WASM_SDK_URL = `https://download.swift.org/swift-${SWIFT_VERSION}-release/wasm-sdk/swift-${SWIFT_VERSION}-RELEASE/${WASM_SDK}.artifactbundle.tar.gz`;
+export const WASM_SDK_CHECKSUM = 'f07b7be3c586d92d7a07051fc6d303b87ebea67eadc40640ba59d5a8b79aa86d';
+export const BINARYEN_VERSION = 'version_123';
+/** Pinned release tarballs, by `${process.platform}-${process.arch}`. */
+const BINARYEN_BUILDS = {
+    'linux-x64': { platform: 'x86_64-linux', sha256: 'e959f2170af4c20c552e9de3a0253704d6a9d2766e8fdb88e4d6ac4bae9388fe' },
+    'linux-arm64': { platform: 'aarch64-linux', sha256: '4b6bd61ba6cd3b18c993b4657d93426c782f9b91b74be0d38018cd8be1319376' },
+    'darwin-arm64': { platform: 'arm64-macos', sha256: '74428be348c1a09863e7b642a1fa948cabf8ec9561052233d8288e941951725b' },
+    'darwin-x64': { platform: 'x86_64-macos', sha256: 'cc18b14d2b673d9c66bf54f31ff2b0ceb23ba5132455b893965ae2792f9e00dd' },
+};
+/** The CLI's cache (binaryen lives here). `$SWIFTBROWSER_CACHE` overrides. */
+export function cacheDir() {
+    return process.env['SWIFTBROWSER_CACHE'] ?? path.join(process.env['XDG_CACHE_HOME'] ?? path.join(homedir(), '.cache'), 'swiftbrowser');
+}
+export function swiftVersionOf(swift) {
+    const result = spawnSync(swift, ['--version'], { encoding: 'utf8' });
+    if (result.status !== 0)
+        return null;
+    const match = /Swift version (\d+\.\d+(?:\.\d+)?)/.exec(`${result.stdout}\n${result.stderr}`);
+    return match?.[1] ?? null;
+}
+function versionTuple(version) {
+    return version.split('.').map((n) => Number(n) || 0);
+}
+/** True when `version` is the required release (patch digits may be omitted by the toolchain). */
+export function isRequiredVersion(version) {
+    const [major, minor] = versionTuple(version);
+    const [wantMajor, wantMinor] = versionTuple(SWIFT_VERSION);
+    return major === wantMajor && minor === wantMinor;
+}
+/** Candidate `swift` executables, most specific first. */
+export function swiftCandidates(env = process.env) {
+    const out = [];
+    if (env['SWIFT_TOOLCHAIN_BIN'])
+        out.push(path.join(env['SWIFT_TOOLCHAIN_BIN'], 'swift'));
+    const swiftly = path.join(env['SWIFTLY_HOME_DIR'] ?? path.join(homedir(), '.local', 'share', 'swiftly'), 'toolchains');
+    if (existsSync(swiftly)) {
+        for (const name of readdirSync(swiftly).sort().reverse()) {
+            if (name.startsWith(SWIFT_VERSION.split('.').slice(0, 2).join('.')))
+                out.push(path.join(swiftly, name, 'usr', 'bin', 'swift'));
+        }
+    }
+    // macOS toolchains installed from swift.org.
+    const library = '/Library/Developer/Toolchains';
+    if (existsSync(library)) {
+        for (const name of readdirSync(library).sort().reverse()) {
+            if (name.includes(SWIFT_VERSION))
+                out.push(path.join(library, name, 'usr', 'bin', 'swift'));
+        }
+    }
+    for (const dir of (env['PATH'] ?? '').split(path.delimiter)) {
+        if (dir)
+            out.push(path.join(dir, 'swift'));
+    }
+    return out;
+}
+/** The first candidate that runs and reports the required version, else the first that runs at all (for diagnostics), else null. */
+export function findToolchain(env = process.env) {
+    let fallback = null;
+    const seen = new Set();
+    for (const swift of swiftCandidates(env)) {
+        if (seen.has(swift) || !existsSync(swift))
+            continue;
+        seen.add(swift);
+        const version = swiftVersionOf(swift);
+        if (!version)
+            continue;
+        const toolchain = { swift, bin: path.dirname(swift), version };
+        if (isRequiredVersion(version))
+            return { toolchain, fallback };
+        fallback ??= toolchain;
+    }
+    return { toolchain: null, fallback };
+}
+/** Environment for `swift` child processes: the toolchain first on PATH. */
+export function toolchainEnv(toolchain, env = process.env) {
+    return { ...env, PATH: `${toolchain.bin}${path.delimiter}${env['PATH'] ?? ''}` };
+}
+/** Whether `swift sdk list` names the wasm SDK. */
+export function hasWasmSdk(toolchain) {
+    const result = spawnSync(toolchain.swift, ['sdk', 'list'], { encoding: 'utf8', env: toolchainEnv(toolchain) });
+    return result.status === 0 && result.stdout.split('\n').some((line) => line.trim() === WASM_SDK);
+}
+/** Installs the wasm SDK with `swift sdk install`; returns the command output. */
+export function installWasmSdk(toolchain) {
+    const result = spawnSync(toolchain.swift, ['sdk', 'install', WASM_SDK_URL, '--checksum', WASM_SDK_CHECKSUM], {
+        encoding: 'utf8',
+        env: toolchainEnv(toolchain),
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return { ok: result.status === 0, output: `${result.stdout}${result.stderr}` };
+}
+export function wasmOptVersionOf(wasmOpt) {
+    const result = spawnSync(wasmOpt, ['--version'], { encoding: 'utf8' });
+    if (result.status !== 0)
+        return null;
+    return result.stdout.trim() || null;
+}
+/** The cached binaryen directory for the pinned version. */
+export function binaryenDir() {
+    return path.join(cacheDir(), `binaryen-${BINARYEN_VERSION}`);
+}
+/** `$BINARYEN_BIN/wasm-opt`, the cached install, or one on PATH. */
+export function findWasmOpt(env = process.env) {
+    const candidates = [];
+    if (env['BINARYEN_BIN'])
+        candidates.push(path.join(env['BINARYEN_BIN'], 'wasm-opt'));
+    candidates.push(path.join(binaryenDir(), 'bin', 'wasm-opt'));
+    for (const dir of (env['PATH'] ?? '').split(path.delimiter))
+        if (dir)
+            candidates.push(path.join(dir, 'wasm-opt'));
+    for (const candidate of candidates) {
+        if (existsSync(candidate) && wasmOptVersionOf(candidate))
+            return candidate;
+    }
+    return null;
+}
+/** Downloads the pinned binaryen release into the cache and returns the wasm-opt path. */
+export async function installBinaryen() {
+    const key = `${process.platform}-${process.arch}`;
+    const build = BINARYEN_BUILDS[key];
+    if (!build) {
+        throw new Error(`no pinned binaryen build for ${key}; install wasm-opt yourself (https://github.com/WebAssembly/binaryen/releases) and set BINARYEN_BIN`);
+    }
+    const url = `https://github.com/WebAssembly/binaryen/releases/download/${BINARYEN_VERSION}/binaryen-${BINARYEN_VERSION}-${build.platform}.tar.gz`;
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`downloading ${url}: HTTP ${response.status}`);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    const digest = createHash('sha256').update(bytes).digest('hex');
+    if (digest !== build.sha256)
+        throw new Error(`binaryen download checksum mismatch: ${digest} (expected ${build.sha256})`);
+    const scratch = path.join(tmpdir(), `swiftbrowser-binaryen-${process.pid}`);
+    rmSync(scratch, { recursive: true, force: true });
+    mkdirSync(scratch, { recursive: true });
+    const tarball = path.join(scratch, 'binaryen.tar.gz');
+    writeFileSync(tarball, bytes);
+    const tar = spawnSync('tar', ['xzf', tarball, '-C', scratch], { encoding: 'utf8' });
+    if (tar.status !== 0)
+        throw new Error(`extracting binaryen: ${tar.stderr}`);
+    const dest = binaryenDir();
+    mkdirSync(path.dirname(dest), { recursive: true });
+    rmSync(dest, { recursive: true, force: true });
+    renameSync(path.join(scratch, `binaryen-${BINARYEN_VERSION}`), dest);
+    rmSync(scratch, { recursive: true, force: true });
+    return path.join(dest, 'bin', 'wasm-opt');
+}
+//# sourceMappingURL=toolchain.js.map

package/dist/toolchain.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@swiftbrowser/cli",
+  "version": "0.1.0",
+  "description": "Run an iOS SwiftUI app in the browser: doctor, check, dev and build for an Xcode project or a folder of Swift sources.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dabbott/SwiftBrowser.git",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "bin": {
+    "swiftbrowser": "bin/swiftbrowser.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:unit": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@swiftbrowser/web": "0.1.0",
+    "@swiftbrowser/xcodeproj": "0.1.0",
+    "@swiftbrowser/swift": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.4",
+    "typescript": "^5.9.2",
+    "vitest": "^5.0.3"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}