@swiftbrowser/web 0.1.0

package/node/dist/plugins/bundle-resources.js

@@ -0,0 +1,172 @@
+/**
+ * The app's resource files (the Xcode target's Copy Bundle Resources phase,
+ * or `resources` in swiftbrowser.json) as one manifest at `/bundle/<App>.json`
+ * (`{ files: [{ path, size }] }`) plus the files at `/bundle/<App>/<path>`,
+ * dev server and `vite build` alike. The page fetches them before loading the
+ * module and mounts them at `/bundle` in the WASI filesystem, where the shim's
+ * `Bundle.main` finds them (docs/ops-protocol.md, "Phase 11").
+ *
+ * A resource entry that is a file is published under its base name, like
+ * Xcode copies it; a directory keeps its name and structure (a folder
+ * reference). Asset catalogs are not resources here: plugins/asset-catalogs.ts
+ * turns them into the catalog manifest.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+export const BUNDLE_DIR = 'bundle';
+const PUBLISHED = /^[A-Za-z0-9_.\-]+$/;
+/** URL path of an app's bundle manifest. */
+export function bundleManifestPath(app) {
+    return `/${BUNDLE_DIR}/${app}.json`;
+}
+/** URL path of a file inside an app's bundle. */
+export function bundleFilePath(app, file) {
+    return `/${BUNDLE_DIR}/${app}/${file.split('/').map(encodeURIComponent).join('/')}`;
+}
+function walk(dir, prefix, into) {
+    for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const full = path.join(dir, entry.name);
+        const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            walk(full, relative, into);
+        else if (entry.isFile())
+            into(relative, full);
+    }
+}
+/** Lists the resources of a spec as published paths and sources. */
+export function buildBundle(app, resources) {
+    const files = new Map();
+    const manifest = { files: [] };
+    const warnings = [];
+    const add = (relative, source) => {
+        if (!relative.split('/').every((part) => PUBLISHED.test(part))) {
+            warnings.push(`${relative}: resource names may use letters, digits, ".", "_" and "-" only; skipped`);
+            return;
+        }
+        if (manifest.files.some((f) => f.path === relative)) {
+            warnings.push(`${relative}: two resources publish under the same name; the first one wins`);
+            return;
+        }
+        manifest.files.push({ path: relative, size: statSync(source).size });
+        files.set(`${BUNDLE_DIR}/${app}/${relative}`, source);
+    };
+    for (const resource of resources ?? []) {
+        if (!existsSync(resource)) {
+            warnings.push(`${resource}: not found`);
+            continue;
+        }
+        if (statSync(resource).isDirectory())
+            walk(resource, path.basename(resource), add);
+        else
+            add(path.basename(resource), resource);
+    }
+    return { manifest, files, warnings };
+}
+export function bundleManifestJson(manifest) {
+    return JSON.stringify(manifest, null, 2) + '\n';
+}
+/** The app named by a manifest request URL (`/bundle/<App>.json`), or null. */
+export function bundleRequestApp(url) {
+    const match = new RegExp(`^/${BUNDLE_DIR}/([A-Za-z0-9_-]+)\\.json(?:\\?|$)`).exec(url);
+    return match?.[1] ?? null;
+}
+/** The app and published path of a resource request (`/bundle/<App>/<path>`), or null. */
+export function bundleRequestFile(url) {
+    const match = new RegExp(`^/${BUNDLE_DIR}/([A-Za-z0-9_-]+)/([^?]+)(?:\\?|$)`).exec(url);
+    if (!match?.[1] || !match[2])
+        return null;
+    let relative;
+    try {
+        relative = match[2].split('/').map(decodeURIComponent).join('/');
+    }
+    catch {
+        return null;
+    }
+    if (!relative.split('/').every((part) => PUBLISHED.test(part) && part !== '.' && part !== '..'))
+        return null;
+    return { app: match[1], fileName: `${BUNDLE_DIR}/${match[1]}/${relative}` };
+}
+const CONTENT_TYPES = {
+    '.json': 'application/json',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.csv': 'text/csv; charset=utf-8',
+    '.xml': 'application/xml',
+    '.plist': 'application/xml',
+    '.strings': 'text/plain; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.pdf': 'application/pdf',
+    '.mp3': 'audio/mpeg',
+    '.m4a': 'audio/mp4',
+    '.wav': 'audio/wav',
+    '.mp4': 'video/mp4',
+};
+export function bundleContentType(file) {
+    return CONTENT_TYPES[path.extname(file).toLowerCase()] ?? 'application/octet-stream';
+}
+export function bundleResources(specs) {
+    const byName = new Map(specs.map((spec) => [spec.name, spec]));
+    return {
+        name: 'swiftbrowser:bundle-resources',
+        configureServer(server) {
+            const warned = new Set();
+            const build = (spec) => {
+                const built = buildBundle(spec.name, spec.resources);
+                for (const warning of built.warnings) {
+                    if (warned.has(warning))
+                        continue;
+                    warned.add(warning);
+                    server.config.logger.warn(`[bundle-resources] ${spec.name}: ${warning}`, { timestamp: true });
+                }
+                return built;
+            };
+            server.middlewares.use((req, res, next) => {
+                const url = req.url ?? '';
+                const app = bundleRequestApp(url);
+                if (app !== null) {
+                    const spec = byName.get(app);
+                    if (!spec) {
+                        res.statusCode = 404;
+                        res.end();
+                        return;
+                    }
+                    res.setHeader('Content-Type', 'application/json');
+                    res.setHeader('Cache-Control', 'no-cache');
+                    res.end(bundleManifestJson(build(spec).manifest));
+                    return;
+                }
+                const file = bundleRequestFile(url);
+                if (file === null)
+                    return next();
+                const spec = byName.get(file.app);
+                const source = spec ? build(spec).files.get(file.fileName) : undefined;
+                if (!source) {
+                    res.statusCode = 404;
+                    res.end();
+                    return;
+                }
+                res.setHeader('Content-Type', bundleContentType(source));
+                res.setHeader('Cache-Control', 'no-cache');
+                res.end(readFileSync(source));
+            });
+        },
+        generateBundle() {
+            for (const spec of specs) {
+                const built = buildBundle(spec.name, spec.resources);
+                for (const warning of built.warnings)
+                    this.warn(`${spec.name}: ${warning}`);
+                this.emitFile({ type: 'asset', fileName: `${BUNDLE_DIR}/${spec.name}.json`, source: bundleManifestJson(built.manifest) });
+                for (const [fileName, source] of built.files) {
+                    this.emitFile({ type: 'asset', fileName, source: readFileSync(source) });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=bundle-resources.js.map

package/node/dist/plugins/bundle-resources.js.map

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

package/node/dist/plugins/swift-wasm.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Vite plugin for the registered apps' Wasm modules.
+ *
+ * Dev server:
+ * - Serves `/<name>.wasm` from each spec's `wasm` file (`application/wasm`,
+ *   never cached). When the file is missing, or its sources changed since the
+ *   server started, and the spec has a `build`, the request builds it first.
+ * - Watches every spec's `watch` directories through the dev server's own
+ *   chokidar watcher, debounces changes (300ms) and runs `spec.build()` for
+ *   every app whose sources changed among those the page has requested since
+ *   the server started (`/<name>.wasm` requests register an app). Builds run
+ *   one at a time.
+ * - Sends `sb:build-start` / `sb:build-end` websocket events so the page can
+ *   show a "Rebuilding…" indicator, then a `full-reload` on success or an
+ *   `sb:build-error` with the compiler output on failure. The page stashes the
+ *   app's `@State` snapshot before the reload and feeds it back through the
+ *   `SB_STATE` WASI environment variable (see src/main.ts).
+ *
+ * `vite build`: copies each spec's `wasm` into the output directory as
+ * `<name>.wasm` (building it first when it is missing and the spec can), so
+ * nothing has to ride along in `public/`. Files that are there anyway are
+ * still copied by Vite as before.
+ */
+import type { Plugin } from 'vite';
+import type { AppSpec } from '../node/apps.js';
+export interface SwiftWasmOptions {
+    /** Debounce window for bursts of file changes, in ms. */
+    debounceMs?: number;
+}
+/** The app named by a module request URL (`/<name>.wasm`), or null. */
+export declare function wasmRequestApp(url: string): string | null;
+export declare function swiftWasm(specs: readonly AppSpec[], options?: SwiftWasmOptions): Plugin;
+//# sourceMappingURL=swift-wasm.d.ts.map

package/node/dist/plugins/swift-wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-wasm.d.ts","sourceRoot":"","sources":["../../../plugins/swift-wasm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAcD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CA6M3F"}

package/node/dist/plugins/swift-wasm.js

@@ -0,0 +1,241 @@
+/**
+ * Vite plugin for the registered apps' Wasm modules.
+ *
+ * Dev server:
+ * - Serves `/<name>.wasm` from each spec's `wasm` file (`application/wasm`,
+ *   never cached). When the file is missing, or its sources changed since the
+ *   server started, and the spec has a `build`, the request builds it first.
+ * - Watches every spec's `watch` directories through the dev server's own
+ *   chokidar watcher, debounces changes (300ms) and runs `spec.build()` for
+ *   every app whose sources changed among those the page has requested since
+ *   the server started (`/<name>.wasm` requests register an app). Builds run
+ *   one at a time.
+ * - Sends `sb:build-start` / `sb:build-end` websocket events so the page can
+ *   show a "Rebuilding…" indicator, then a `full-reload` on success or an
+ *   `sb:build-error` with the compiler output on failure. The page stashes the
+ *   app's `@State` snapshot before the reload and feeds it back through the
+ *   `SB_STATE` WASI environment variable (see src/main.ts).
+ *
+ * `vite build`: copies each spec's `wasm` into the output directory as
+ * `<name>.wasm` (building it first when it is missing and the spec can), so
+ * nothing has to ride along in `public/`. Files that are there anyway are
+ * still copied by Vite as before.
+ */
+import { copyFileSync, createReadStream, existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
+import path from 'node:path';
+/** The app named by a module request URL (`/<name>.wasm`), or null. */
+export function wasmRequestApp(url) {
+    const match = /^\/([A-Za-z0-9_-]+)\.wasm(?:\?|$)/.exec(url);
+    return match?.[1] ?? null;
+}
+/** The message of a rejected `build()`: the compiler output. */
+function failureOutput(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export function swiftWasm(specs, options = {}) {
+    const debounceMs = options.debounceMs ?? 300;
+    const byName = new Map(specs.map((spec) => [spec.name, spec]));
+    let config;
+    let server;
+    const log = (message) => {
+        config?.logger.info(`[swift-wasm] ${message}`, { timestamp: true });
+    };
+    // -------------------------------------------------------------------------
+    // Dev server: build queue
+    // -------------------------------------------------------------------------
+    /** Apps requested since the server started; their sources trigger rebuilds. */
+    const tracked = new Set();
+    /** Tracked apps whose sources changed since their last build. */
+    const dirty = new Set();
+    /** Untracked apps whose sources changed: rebuilt before the first request serves them. */
+    const stale = new Set();
+    /** The build in flight or queued for an app, so a request can wait for it instead of starting another. */
+    const queued = new Map();
+    /** Builds run one at a time (SwiftPM shares one `.build` directory). */
+    let queue = Promise.resolve();
+    let timer;
+    const runBatch = async (targets) => {
+        const started = Date.now();
+        log(`building ${targets.join(', ')}…`);
+        server?.ws.send('sb:build-start', { apps: targets });
+        const result = { ok: true };
+        for (const app of targets) {
+            const spec = byName.get(app);
+            if (!spec?.build)
+                continue;
+            try {
+                await spec.build();
+            }
+            catch (error) {
+                const output = failureOutput(error);
+                result.ok = false;
+                result.failure = { app, output };
+                log(`build failed for ${app}`);
+                for (const line of output.split('\n'))
+                    if (line.trim())
+                        log(`  ${line}`);
+                server?.ws.send('sb:build-error', { app, output });
+                break;
+            }
+        }
+        const durationMs = Date.now() - started;
+        server?.ws.send('sb:build-end', { apps: targets, ok: result.ok, durationMs });
+        if (result.ok) {
+            log(`built ${targets.join(', ')} in ${(durationMs / 1000).toFixed(1)}s; reloading`);
+            server?.ws.send({ type: 'full-reload', path: '*' });
+        }
+        return result;
+    };
+    const enqueue = (targets) => {
+        const batch = queue.then(() => runBatch(targets));
+        queue = batch.catch(() => undefined);
+        for (const app of targets) {
+            queued.set(app, batch);
+            void batch.finally(() => {
+                if (queued.get(app) === batch)
+                    queued.delete(app);
+            });
+        }
+        return batch;
+    };
+    /** Waits for the build of `app` if one is queued, else queues one. */
+    const ensureBuilt = (app) => queued.get(app) ?? enqueue([app]);
+    const flushDirty = () => {
+        const targets = Array.from(dirty).filter((app) => !queued.has(app));
+        dirty.clear();
+        if (targets.length === 0)
+            return;
+        void enqueue(targets);
+    };
+    const schedule = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            flushDirty();
+        }, debounceMs);
+    };
+    // -------------------------------------------------------------------------
+    // Dev server: serving `/<name>.wasm`
+    // -------------------------------------------------------------------------
+    const serveWasm = async (spec, res, method) => {
+        if (spec.build && (!existsSync(spec.wasm) || stale.has(spec.name))) {
+            if (!existsSync(spec.wasm))
+                log(`${spec.name}: ${path.basename(spec.wasm)} is missing; building it first`);
+            stale.delete(spec.name);
+            const result = await ensureBuilt(spec.name);
+            if (!result.ok && !existsSync(spec.wasm)) {
+                res.statusCode = 500;
+                res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+                res.end(`Build failed for ${spec.name}:\n${result.failure?.output ?? ''}`);
+                return;
+            }
+        }
+        if (!existsSync(spec.wasm)) {
+            res.statusCode = 404;
+            res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+            res.end(`${spec.name}: ${spec.wasm} does not exist`);
+            return;
+        }
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/wasm');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Content-Length', String(statSync(spec.wasm).size));
+        if (method === 'HEAD') {
+            res.end();
+            return;
+        }
+        createReadStream(spec.wasm).pipe(res);
+    };
+    // -------------------------------------------------------------------------
+    // `vite build`: copy the modules into the bundle
+    // -------------------------------------------------------------------------
+    const copyModules = async (outDir) => {
+        for (const spec of specs) {
+            if (!existsSync(spec.wasm) && spec.build) {
+                log(`${spec.name}: ${spec.wasm} is missing; building it`);
+                await spec.build();
+            }
+            if (!existsSync(spec.wasm)) {
+                if (spec.build)
+                    throw new Error(`[swift-wasm] ${spec.name}: ${spec.wasm} still does not exist after building it`);
+                config?.logger.warn(`[swift-wasm] ${spec.name}: ${spec.wasm} does not exist; the site has no module for it`);
+                continue;
+            }
+            mkdirSync(outDir, { recursive: true });
+            const dest = path.join(outDir, `${spec.name}.wasm`);
+            if (path.resolve(spec.wasm) !== path.resolve(dest))
+                copyFileSync(spec.wasm, dest);
+        }
+        // Modules of apps outside the registry (the examples' `public/*.wasm`,
+        // copied with the public dir) are not part of this site.
+        const known = new Set(specs.map((spec) => `${spec.name}.wasm`));
+        for (const entry of readdirSync(outDir)) {
+            if (entry.endsWith('.wasm') && !known.has(entry))
+                rmSync(path.join(outDir, entry), { force: true });
+        }
+    };
+    return {
+        name: 'swiftbrowser:swift-wasm',
+        configResolved(resolved) {
+            config = resolved;
+        },
+        configureServer(devServer) {
+            server = devServer;
+            const watched = specs.flatMap((spec) => (spec.watch ?? []).map((dir) => ({ app: spec.name, root: path.resolve(dir) })));
+            const appsOf = (file) => file.endsWith('.swift')
+                ? watched.filter(({ root }) => file.startsWith(root + path.sep)).map(({ app }) => app)
+                : [];
+            devServer.middlewares.use((req, res, next) => {
+                const name = wasmRequestApp(req.url ?? '');
+                const spec = name === null ? undefined : byName.get(name);
+                // Unknown names fall through to Vite (a stray file in `public/`, or a 404).
+                if (!spec)
+                    return next();
+                if (!tracked.has(spec.name)) {
+                    tracked.add(spec.name);
+                    log(`tracking ${spec.name} for rebuilds`);
+                }
+                serveWasm(spec, res, req.method).catch((error) => {
+                    config?.logger.error(`[swift-wasm] ${spec.name}: ${failureOutput(error)}`);
+                    if (!res.headersSent)
+                        res.statusCode = 500;
+                    res.end();
+                });
+            });
+            const roots = Array.from(new Set(watched.map(({ root }) => root))).filter((root) => existsSync(root));
+            if (roots.length > 0)
+                devServer.watcher.add(roots);
+            devServer.watcher.on('all', (event, file) => {
+                if (event === 'addDir' || event === 'unlinkDir')
+                    return;
+                const apps = appsOf(file);
+                if (apps.length === 0)
+                    return;
+                log(`${event} ${file}`);
+                for (const app of new Set(apps)) {
+                    if (!byName.get(app)?.build)
+                        continue;
+                    if (tracked.has(app))
+                        dirty.add(app);
+                    else
+                        stale.add(app);
+                }
+                if (dirty.size > 0)
+                    schedule();
+            });
+            if (roots.length > 0) {
+                log(`watching ${roots.join(', ')} for .swift changes (apps: ${specs.map((spec) => spec.name).join(', ')})`);
+            }
+        },
+        async writeBundle(outputOptions) {
+            if (!config)
+                return;
+            const outDir = outputOptions.dir ?? path.resolve(config.root, config.build.outDir);
+            await copyModules(outDir);
+        },
+    };
+}
+//# sourceMappingURL=swift-wasm.js.map

package/node/dist/plugins/swift-wasm.js.map

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

package/node/dist/src/assets.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Asset catalog manifest (docs/ops-protocol.md, "Phase 5 additions").
+ *
+ * An Xcode asset catalog (`Examples/<App>/Assets.xcassets`) holds the images
+ * and colors a SwiftUI app refers to by name (`Image("dough/plain-full")`,
+ * `Color("dough/plain-bg")`). The Swift side only ever sends the name; the
+ * dev server and the build turn every catalog into one JSON manifest plus the
+ * image files (plugins/asset-catalogs.ts), and the page fetches the manifest
+ * before loading the app. The layout engine reads intrinsic sizes from it,
+ * the renderer resolves `src` and color values.
+ *
+ * This module is shared by the browser code and the Node plugin, so it must
+ * stay free of DOM and Node APIs.
+ */
+export type AssetImageKind = 'image' | 'symbol';
+export interface AssetImage {
+    /** Absolute URL path of the image file (`/catalog/<App>/<file>`). */
+    src: string;
+    /** Intrinsic size in points (pixel size ÷ `scale`). Irrelevant for `symbol`. */
+    width: number;
+    height: number;
+    /** Scale of the file the manifest picked (2 for `@2x`), so pixels = points × scale. */
+    scale: number;
+    /** `image` for an `.imageset`; `symbol` for an `.symbolset` (an SVG drawn as a template). */
+    kind: AssetImageKind;
+}
+export interface AssetColor {
+    /** CSS color for the light appearance (`rgba(r, g, b, a)`). */
+    light: string;
+    /** CSS color for the dark appearance; absent when the colorset has none. */
+    dark?: string;
+}
+export interface AssetCatalog {
+    /** Keyed by catalog name, namespaced with `/` (`dough/plain-full`). */
+    images: Record<string, AssetImage>;
+    colors: Record<string, AssetColor>;
+}
+/** The catalog of an app without one (and of the mock app). */
+export declare const EMPTY_CATALOG: Readonly<AssetCatalog>;
+/** URL directory under which manifests and files are served. */
+export declare const CATALOG_DIR = "catalog";
+/** URL path of an app's manifest (`/catalog/<App>.json`). */
+export declare function catalogPath(app: string): string;
+/**
+ * File name an asset is served under: the namespaced name with every `/`
+ * replaced by `__`, plus the extension (`dough__plain-full.png`). Flattening
+ * keeps every file of a catalog in one directory.
+ */
+export declare function assetFileName(name: string, ext: string): string;
+/** URL path of an asset file (`/catalog/<App>/dough__plain-full.png`). */
+export declare function assetFilePath(app: string, name: string, ext: string): string;
+/**
+ * CSS custom property that carries a catalog color: `--sb-asset-color-<slug>`.
+ * The slug keeps letters, digits, `-` and `_`; `/` becomes `__` (like file
+ * names) and anything else `_`.
+ */
+export declare function assetColorVar(name: string): string;
+/** Cheap structural check for a fetched manifest; anything else is treated as empty. */
+export declare function isAssetCatalog(value: unknown): value is AssetCatalog;
+//# sourceMappingURL=assets.d.ts.map

package/node/dist/src/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,+DAA+D;AAC/D,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,YAAY,CAA6C,CAAC;AAE/F,gEAAgE;AAChE,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAIpE"}

package/node/dist/src/assets.js

@@ -0,0 +1,54 @@
+/**
+ * Asset catalog manifest (docs/ops-protocol.md, "Phase 5 additions").
+ *
+ * An Xcode asset catalog (`Examples/<App>/Assets.xcassets`) holds the images
+ * and colors a SwiftUI app refers to by name (`Image("dough/plain-full")`,
+ * `Color("dough/plain-bg")`). The Swift side only ever sends the name; the
+ * dev server and the build turn every catalog into one JSON manifest plus the
+ * image files (plugins/asset-catalogs.ts), and the page fetches the manifest
+ * before loading the app. The layout engine reads intrinsic sizes from it,
+ * the renderer resolves `src` and color values.
+ *
+ * This module is shared by the browser code and the Node plugin, so it must
+ * stay free of DOM and Node APIs.
+ */
+/** The catalog of an app without one (and of the mock app). */
+export const EMPTY_CATALOG = Object.freeze({ images: {}, colors: {} });
+/** URL directory under which manifests and files are served. */
+export const CATALOG_DIR = 'catalog';
+/** URL path of an app's manifest (`/catalog/<App>.json`). */
+export function catalogPath(app) {
+    return `/${CATALOG_DIR}/${app}.json`;
+}
+/**
+ * File name an asset is served under: the namespaced name with every `/`
+ * replaced by `__`, plus the extension (`dough__plain-full.png`). Flattening
+ * keeps every file of a catalog in one directory.
+ */
+export function assetFileName(name, ext) {
+    // `/` becomes `__`; spaces and anything else outside [A-Za-z0-9_.-] become
+    // `_`, so the served path needs no URL encoding and matches the request
+    // pattern the dev middleware accepts.
+    return `${name.replace(/\//g, '__').replace(/[^A-Za-z0-9_.-]/g, '_')}.${ext}`;
+}
+/** URL path of an asset file (`/catalog/<App>/dough__plain-full.png`). */
+export function assetFilePath(app, name, ext) {
+    return `/${CATALOG_DIR}/${app}/${assetFileName(name, ext)}`;
+}
+/**
+ * CSS custom property that carries a catalog color: `--sb-asset-color-<slug>`.
+ * The slug keeps letters, digits, `-` and `_`; `/` becomes `__` (like file
+ * names) and anything else `_`.
+ */
+export function assetColorVar(name) {
+    const slug = name.replace(/\//g, '__').replace(/[^A-Za-z0-9_-]/g, '_');
+    return `--sb-asset-color-${slug}`;
+}
+/** Cheap structural check for a fetched manifest; anything else is treated as empty. */
+export function isAssetCatalog(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const { images, colors } = value;
+    return typeof images === 'object' && images !== null && typeof colors === 'object' && colors !== null;
+}
+//# sourceMappingURL=assets.js.map

package/node/dist/src/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6BH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAA2B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAE/F,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,IAAI,WAAW,IAAI,GAAG,OAAO,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAW;IACrD,2EAA2E;IAC3E,wEAAwE;IACxE,sCAAsC;IACtC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;AAChF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY,EAAE,GAAW;IAClE,OAAO,IAAI,WAAW,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACvE,OAAO,oBAAoB,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAA+C,CAAC;IAC3E,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC;AACxG,CAAC"}

package/node/dist/src/devEvents.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Custom Vite websocket events exchanged between the dev-server plugin
+ * (plugins/swift-wasm.ts) and the page (src/main.ts) for hot reload.
+ *
+ * This file is imported by both sides, so it must stay free of DOM and Node
+ * types.
+ */
+import 'vite/types/customEvent.d.ts';
+export interface BuildStartPayload {
+    /** Products being rebuilt, e.g. `["Counter", "Todos"]`. */
+    apps: string[];
+}
+export interface BuildEndPayload {
+    apps: string[];
+    ok: boolean;
+    durationMs: number;
+}
+export interface BuildErrorPayload {
+    /** The product whose build failed. */
+    app: string;
+    /** Combined stdout + stderr of `scripts/build-wasm.sh`. */
+    output: string;
+}
+declare module 'vite/types/customEvent.d.ts' {
+    interface CustomEventMap {
+        'sb:build-start': BuildStartPayload;
+        'sb:build-end': BuildEndPayload;
+        'sb:build-error': BuildErrorPayload;
+    }
+}
+//# sourceMappingURL=devEvents.d.ts.map

package/node/dist/src/devEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devEvents.d.ts","sourceRoot":"","sources":["../../../src/devEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,6BAA6B,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,QAAQ,6BAA6B,CAAC;IAC3C,UAAU,cAAc;QACtB,gBAAgB,EAAE,iBAAiB,CAAC;QACpC,cAAc,EAAE,eAAe,CAAC;QAChC,gBAAgB,EAAE,iBAAiB,CAAC;KACrC;CACF"}