@seanhogg/builderforce-webcontainers-core 2026.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sean Hogg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @seanhogg/builderforce-webcontainers-core
+
+The runtime-agnostic dev server behind
+[BuilderForce WebContainers](https://github.com/SeanHogg/builderforce-webcontainers).
+It turns a project held in a `VirtualFileSystem` into browser-ready responses:
+compiled ES modules, CSS/JSON/asset wrappers and the HTML document. It never
+listens on anything; you call `handle(path, search)`.
+
+```ts
+import * as esbuild from 'esbuild';
+import { VirtualFileSystem, DevServer, createEsbuildTransformer } from '@seanhogg/builderforce-webcontainers-core';
+
+const fs = new VirtualFileSystem();
+fs.mount({ 'index.html': '...', 'src/main.tsx': '...' });
+const server = new DevServer({ fs, transformer: createEsbuildTransformer(esbuild), base: '/preview/' });
+const res = await server.handle('/src/main.tsx'); // { status, headers, body }
+```
+
+For the in-browser runtime, use
+[`@seanhogg/builderforce-webcontainers`](../browser). MIT licensed.

package/dist/attribution.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The "Built with Builderforce.ai" badge, on by default in every preview.
+ *
+ * It is a DEFAULT, not a licence condition: the project stays MIT, and a host turns
+ * it off with `attribution: false`. Keeping it on is how this runtime pays for
+ * itself, and the README asks forks to leave it.
+ *
+ * The badge lives in a shadow root, so the previewed app's CSS can't restyle or hide
+ * it by accident and the badge's styles can't leak into the app. It follows the
+ * system light/dark preference and sits in the bottom-right corner, small enough
+ * not to cover app UI on a phone-width screen.
+ */
+export declare const ATTRIBUTION_URL = "https://builderforce.ai/?utm_source=webcontainers&utm_medium=badge&utm_campaign=preview";
+export declare const ATTRIBUTION_LABEL = "Built with Builderforce.ai";
+export interface AttributionOptions {
+    href?: string;
+    label?: string;
+}
+export declare function attributionScript(options?: AttributionOptions): string;
+/** Append the badge before `</body>` (or at the end of a fragment). */
+export declare function injectAttribution(html: string, options?: AttributionOptions): string;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,eAAe,4FAA4F,CAAC;AACzH,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CA6B1E;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAGpF"}

package/dist/attribution.js

@@ -0,0 +1,50 @@
+/**
+ * The "Built with Builderforce.ai" badge, on by default in every preview.
+ *
+ * It is a DEFAULT, not a licence condition: the project stays MIT, and a host turns
+ * it off with `attribution: false`. Keeping it on is how this runtime pays for
+ * itself, and the README asks forks to leave it.
+ *
+ * The badge lives in a shadow root, so the previewed app's CSS can't restyle or hide
+ * it by accident and the badge's styles can't leak into the app. It follows the
+ * system light/dark preference and sits in the bottom-right corner, small enough
+ * not to cover app UI on a phone-width screen.
+ */
+export const ATTRIBUTION_URL = 'https://builderforce.ai/?utm_source=webcontainers&utm_medium=badge&utm_campaign=preview';
+export const ATTRIBUTION_LABEL = 'Built with Builderforce.ai';
+export function attributionScript(options = {}) {
+    const href = JSON.stringify(options.href ?? ATTRIBUTION_URL);
+    const label = JSON.stringify(options.label ?? ATTRIBUTION_LABEL);
+    const css = [
+        ':host{all:initial;position:fixed;right:8px;bottom:8px;z-index:2147483647}',
+        'a{display:inline-flex;align-items:center;gap:6px;padding:4px 10px;border-radius:999px;',
+        'font:500 12px/1.4 system-ui,-apple-system,Segoe UI,sans-serif;text-decoration:none;',
+        'background:rgba(255,255,255,.92);color:#1f2328;border:1px solid rgba(31,35,40,.15);',
+        'box-shadow:0 1px 3px rgba(0,0,0,.12)}',
+        'a:hover{text-decoration:underline}',
+        '@media (prefers-color-scheme:dark){a{background:rgba(22,27,34,.92);color:#e6edf3;border-color:rgba(230,237,243,.18)}}',
+        '@media print{:host{display:none}}',
+    ].join('');
+    return `<script>(function(){
+  if (document.getElementById('bfwc-attribution')) return;
+  var mount = function () {
+    var host = document.createElement('bfwc-attribution');
+    host.id = 'bfwc-attribution';
+    var root = host.attachShadow({ mode: 'closed' });
+    var style = document.createElement('style');
+    style.textContent = ${JSON.stringify(css)};
+    var a = document.createElement('a');
+    a.href = ${href}; a.target = '_blank'; a.rel = 'noopener';
+    a.textContent = ${label};
+    root.appendChild(style); root.appendChild(a);
+    document.body.appendChild(host);
+  };
+  if (document.body) mount(); else addEventListener('DOMContentLoaded', mount);
+})();</script>`;
+}
+/** Append the badge before `</body>` (or at the end of a fragment). */
+export function injectAttribution(html, options) {
+    const badge = attributionScript(options);
+    return /<\/body>/i.test(html) ? html.replace(/<\/body>(?![\s\S]*<\/body>)/i, `${badge}\n</body>`) : html + badge;
+}
+//# sourceMappingURL=attribution.js.map

package/dist/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,yFAAyF,CAAC;AACzH,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAO9D,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG;QACV,2EAA2E;QAC3E,wFAAwF;QACxF,qFAAqF;QACrF,qFAAqF;QACrF,uCAAuC;QACvC,oCAAoC;QACpC,uHAAuH;QACvH,mCAAmC;KACpC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,OAAO;;;;;;;0BAOiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;;eAE9B,IAAI;sBACG,KAAK;;;;;eAKZ,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAA4B;IAC1E,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;AACnH,CAAC"}

package/dist/compileScript.d.ts

@@ -0,0 +1,31 @@
+import type { VirtualFileSystem } from './vfs.js';
+import type { ProjectConfig } from './projectConfig.js';
+import type { PackageCdn } from './packageCdn.js';
+import type { Transformer } from './transformer.js';
+export interface CompileContext {
+    fs: VirtualFileSystem;
+    config: ProjectConfig;
+    cdn: PackageCdn;
+    transformer: Transformer;
+    /** Preview base URL, ending in `/`. */
+    base: string;
+}
+/** Vite-style import queries this runtime honours. */
+export type ImportQuery = 'import' | 'raw' | 'url';
+/**
+ * The URL a resolved VFS file is imported by. Scripts are served as-is; CSS and
+ * JSON need the `?import` JS wrapper; anything else imported from JS (images,
+ * fonts) exports its URL, as in Vite.
+ */
+export declare function moduleUrl(base: string, path: string, query?: ImportQuery): string;
+/**
+ * Map one import specifier to the URL the browser should fetch. Undefined leaves
+ * it unchanged: URLs, `node:` builtins, and local paths that do not resolve (the
+ * browser's 404 then surfaces through the error bridge).
+ */
+export declare function mapSpecifier(ctx: CompileContext, fromDir: string, specifier: string): string | undefined;
+/** Compile-time constants: Vite's `import.meta.env` and CRA's `process.env.REACT_APP_*`. */
+export declare function buildDefine(config: ProjectConfig, base: string): Record<string, string>;
+/** TS/JSX → an ES module whose imports point at preview and CDN URLs. */
+export declare function compileScript(ctx: CompileContext, path: string): Promise<string>;
+//# sourceMappingURL=compileScript.d.ts.map

package/dist/compileScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileScript.d.ts","sourceRoot":"","sources":["../src/compileScript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CAOjF;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYxG;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASvF;AAED,yEAAyE;AACzE,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtF"}

package/dist/compileScript.js

@@ -0,0 +1,75 @@
+import { loaderFor } from './transformer.js';
+import { dirname, extname } from './paths.js';
+import { isBareSpecifier, resolveAlias, resolveLocal, splitPackageSpecifier } from './resolve.js';
+import { rewriteImports } from './rewriteImports.js';
+/**
+ * The URL a resolved VFS file is imported by. Scripts are served as-is; CSS and
+ * JSON need the `?import` JS wrapper; anything else imported from JS (images,
+ * fonts) exports its URL, as in Vite.
+ */
+export function moduleUrl(base, path, query) {
+    const url = base + path.slice(1);
+    if (query === 'raw' || query === 'url')
+        return `${url}?${query}`;
+    const ext = extname(path);
+    if (loaderFor(ext))
+        return url;
+    if (ext === '.css' || ext === '.json')
+        return `${url}?import`;
+    return `${url}?url`;
+}
+function splitQuery(specifier) {
+    const at = specifier.indexOf('?');
+    if (at < 0)
+        return { path: specifier };
+    const query = specifier.slice(at + 1);
+    return { path: specifier.slice(0, at), query: query === 'raw' || query === 'url' ? query : undefined };
+}
+/**
+ * Map one import specifier to the URL the browser should fetch. Undefined leaves
+ * it unchanged: URLs, `node:` builtins, and local paths that do not resolve (the
+ * browser's 404 then surfaces through the error bridge).
+ */
+export function mapSpecifier(ctx, fromDir, specifier) {
+    if (/^(https?:|data:|blob:|node:)/i.test(specifier))
+        return undefined;
+    const { path, query } = splitQuery(specifier);
+    if (isBareSpecifier(path)) {
+        const aliased = resolveAlias(ctx.fs, ctx.config.aliases, path);
+        if (aliased)
+            return moduleUrl(ctx.base, aliased, query);
+        const { name, subpath } = splitPackageSpecifier(path);
+        return ctx.cdn.urlFor(name, subpath);
+    }
+    const resolved = resolveLocal(ctx.fs, fromDir, path);
+    return resolved ? moduleUrl(ctx.base, resolved, query) : undefined;
+}
+/** Compile-time constants: Vite's `import.meta.env` and CRA's `process.env.REACT_APP_*`. */
+export function buildDefine(config, base) {
+    const env = { MODE: 'development', DEV: true, PROD: false, SSR: false, BASE_URL: base };
+    const define = { 'process.env.NODE_ENV': '"development"' };
+    for (const [key, value] of Object.entries(config.env)) {
+        if (key.startsWith('VITE_'))
+            env[key] = value;
+        if (key.startsWith('VITE_') || key.startsWith('REACT_APP_'))
+            define[`process.env.${key}`] = JSON.stringify(value);
+    }
+    define['import.meta.env'] = JSON.stringify(env);
+    return define;
+}
+/** TS/JSX → an ES module whose imports point at preview and CDN URLs. */
+export async function compileScript(ctx, path) {
+    const loader = loaderFor(extname(path));
+    if (!loader)
+        throw new Error(`Not a script: ${path}`);
+    const source = ctx.fs.readText(path) ?? '';
+    const { code } = await ctx.transformer.transform(source, {
+        loader,
+        sourcefile: path,
+        define: buildDefine(ctx.config, ctx.base),
+        jsx: ctx.config.jsx,
+    });
+    const fromDir = dirname(path);
+    return rewriteImports(code, (specifier) => mapSpecifier(ctx, fromDir, specifier));
+}
+//# sourceMappingURL=compileScript.js.map

package/dist/compileScript.js.map

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

package/dist/detectProject.d.ts

@@ -0,0 +1,16 @@
+import type { VirtualFileSystem } from './vfs.js';
+export type ProjectKind = 'vite' | 'cra' | 'static';
+export interface ProjectProfile {
+    supported: boolean;
+    kind?: ProjectKind;
+    /** The HTML document served at `/`. */
+    htmlPath?: string;
+    /** Script injected when the HTML has no module entry of its own (CRA). */
+    entry?: string;
+    /** Files served from the site root, Vite/CRA `public/` convention. */
+    publicDir: string;
+    /** Why the project needs a full Node runtime instead — shown to the user. */
+    reason?: string;
+}
+export declare function detectProject(fs: VirtualFileSystem): ProjectProfile;
+//# sourceMappingURL=detectProject.d.ts.map

package/dist/detectProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectProject.d.ts","sourceRoot":"","sources":["../src/detectProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkCD,wBAAgB,aAAa,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,CAenE"}

package/dist/detectProject.js

@@ -0,0 +1,49 @@
+import { RESOLVE_EXTENSIONS } from './resolve.js';
+/**
+ * Frameworks that need a server or a compiler this runtime does not have yet.
+ * Data, not branches: supporting one later means deleting its row.
+ */
+const NEEDS_NODE = [
+    { dependency: 'next', reason: 'Next.js needs its Node server.' },
+    { dependency: 'nuxt', reason: 'Nuxt needs its Node server.' },
+    { dependency: '@remix-run/dev', reason: 'Remix needs its Node server.' },
+    { dependency: '@sveltejs/kit', reason: 'SvelteKit needs its Node server.' },
+    { dependency: 'astro', reason: 'Astro needs its build pipeline.' },
+    { dependency: 'svelte', reason: 'Svelte components need the Svelte compiler.' },
+    { dependency: 'vue', reason: 'Vue single-file components need the Vue compiler.' },
+];
+const SERVER_ONLY = ['express', 'fastify', 'koa', '@nestjs/core', '@hapi/hapi'];
+function readDependencyNames(fs) {
+    try {
+        const pkg = JSON.parse(fs.readText('/package.json') ?? '{}');
+        return new Set([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
+    }
+    catch {
+        return new Set();
+    }
+}
+function findEntry(fs) {
+    for (const stem of ['/src/index', '/src/main']) {
+        for (const ext of RESOLVE_EXTENSIONS)
+            if (fs.isFile(stem + ext))
+                return stem + ext;
+    }
+    return undefined;
+}
+export function detectProject(fs) {
+    const deps = readDependencyNames(fs);
+    const blocker = NEEDS_NODE.find((row) => deps.has(row.dependency));
+    if (blocker)
+        return { supported: false, publicDir: '/public', reason: blocker.reason };
+    if (fs.isFile('/index.html')) {
+        return { supported: true, kind: deps.has('vite') ? 'vite' : 'static', htmlPath: '/index.html', publicDir: '/public' };
+    }
+    if (fs.isFile('/public/index.html')) {
+        return { supported: true, kind: 'cra', htmlPath: '/public/index.html', entry: findEntry(fs), publicDir: '/public' };
+    }
+    if (SERVER_ONLY.some((name) => deps.has(name))) {
+        return { supported: false, publicDir: '/public', reason: 'This is a Node server app with no browser entry page.' };
+    }
+    return { supported: false, publicDir: '/public', reason: 'No index.html found at the project root or in public/.' };
+}
+//# sourceMappingURL=detectProject.js.map

package/dist/detectProject.js.map

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

package/dist/devServer.d.ts

@@ -0,0 +1,46 @@
+import type { VirtualFileSystem } from './vfs.js';
+import type { Transformer } from './transformer.js';
+import type { PackageCdn } from './packageCdn.js';
+import { type ProjectProfile } from './detectProject.js';
+export interface ServedFile {
+    status: number;
+    headers: Record<string, string>;
+    body: string | Uint8Array;
+}
+export interface DevServerOptions {
+    fs: VirtualFileSystem;
+    transformer: Transformer;
+    /** The URL the preview is served under, ending in `/` (`/__bfwc/<id>/`). */
+    base: string;
+    /** Package CDN factory, given the project's dependency ranges. Default: esm.sh. */
+    cdn?: (dependencies: Record<string, string>) => PackageCdn;
+    /** The "Built with Builderforce.ai" badge in served pages. Default true. */
+    attribution?: boolean;
+}
+/**
+ * The dev server: request path in, response out. It does not listen on anything —
+ * the host decides how requests arrive (a service worker in the browser, a plain
+ * function call in tests), which is what keeps it runtime-agnostic.
+ *
+ * Responses are cached per (file, query) and validated against the file's VFS
+ * version. Edits to an existing file evict only that file; creating or deleting a
+ * file, or touching a config file, clears everything, since either can change how
+ * OTHER files' imports resolve.
+ */
+export declare class DevServer {
+    private readonly options;
+    private config?;
+    private cdn?;
+    private profileCache?;
+    private readonly cache;
+    private readonly unwatch;
+    constructor(options: DevServerOptions);
+    dispose(): void;
+    profile(): ProjectProfile;
+    handle(requestPath: string, search?: string): Promise<ServedFile>;
+    private produce;
+    private serveDocument;
+    private context;
+    private onChange;
+}
+//# sourceMappingURL=devServer.d.ts.map

package/dist/devServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../src/devServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQxE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,iBAAiB,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC;IAC3D,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAqBD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAOR,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAC,CAAa;IACzB,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4D;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAER,OAAO,EAAE,gBAAgB;IAKtD,OAAO,IAAI,IAAI;IAKf,OAAO,IAAI,cAAc;IAInB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,UAAU,CAAC;YA0BrD,OAAO;IAsBrB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/devServer.js

@@ -0,0 +1,136 @@
+import { createEsmShCdn } from './packageCdn.js';
+import { isConfigFile, readProjectConfig } from './projectConfig.js';
+import { detectProject } from './detectProject.js';
+import { compileScript } from './compileScript.js';
+import { transformHtml } from './html.js';
+import { cssToModule, jsonToModule, rawToModule, rewriteCssUrls, urlToModule } from './styleModules.js';
+import { loaderFor } from './transformer.js';
+import { extname, join, normalizePath } from './paths.js';
+import { JS_MIME, mimeFor } from './mime.js';
+const NO_STORE = { 'cache-control': 'no-store' };
+function reply(status, contentType, body) {
+    return { status, headers: { 'content-type': contentType, ...NO_STORE }, body };
+}
+/** A module that throws — evaluated in the preview, it reaches the error bridge. */
+function errorModule(message) {
+    return reply(200, JS_MIME, `throw new Error(${JSON.stringify(message)});`);
+}
+function parseQuery(search) {
+    const params = new URLSearchParams(search.startsWith('?') ? search.slice(1) : search);
+    if (params.has('raw'))
+        return 'raw';
+    if (params.has('url'))
+        return 'url';
+    if (params.has('import'))
+        return 'import';
+    return undefined;
+}
+/**
+ * The dev server: request path in, response out. It does not listen on anything —
+ * the host decides how requests arrive (a service worker in the browser, a plain
+ * function call in tests), which is what keeps it runtime-agnostic.
+ *
+ * Responses are cached per (file, query) and validated against the file's VFS
+ * version. Edits to an existing file evict only that file; creating or deleting a
+ * file, or touching a config file, clears everything, since either can change how
+ * OTHER files' imports resolve.
+ */
+export class DevServer {
+    options;
+    config;
+    cdn;
+    profileCache;
+    cache = new Map();
+    unwatch;
+    constructor(options) {
+        this.options = options;
+        if (!options.base.endsWith('/'))
+            throw new Error('DevServer base must end with "/"');
+        this.unwatch = options.fs.watch((change) => this.onChange(change));
+    }
+    dispose() {
+        this.unwatch();
+        this.cache.clear();
+    }
+    profile() {
+        return (this.profileCache ??= detectProject(this.options.fs));
+    }
+    async handle(requestPath, search = '') {
+        const { fs } = this.options;
+        const path = normalizePath(decodeURIComponent(requestPath));
+        const query = parseQuery(search);
+        const profile = this.profile();
+        if (path === '/' || path === '/index.html' || path === profile.htmlPath)
+            return this.serveDocument(profile);
+        const publicPath = join(profile.publicDir, path);
+        const file = fs.isFile(path) ? path : fs.isFile(publicPath) ? publicPath : undefined;
+        if (!file) {
+            // An extension-less path is a client-side route: serve the app (SPA fallback).
+            if (!extname(path) && !query)
+                return this.serveDocument(profile);
+            return query || loaderFor(extname(path)) ? errorModule(`Cannot find module ${path}`) : reply(404, 'text/plain; charset=utf-8', `Not found: ${path}`);
+        }
+        const key = `${file}?${query ?? ''}`;
+        const version = fs.version(file) ?? 0;
+        const hit = this.cache.get(key);
+        if (hit && hit.version === version)
+            return hit.file;
+        const served = await this.produce(file, query);
+        this.cache.set(key, { version, file: served });
+        return served;
+    }
+    async produce(file, query) {
+        const { fs, base } = this.options;
+        const ext = extname(file);
+        try {
+            if (query === 'raw')
+                return reply(200, JS_MIME, rawToModule(fs.readText(file) ?? ''));
+            if (query === 'url')
+                return reply(200, JS_MIME, urlToModule(base + file.slice(1)));
+            if (ext === '.css') {
+                const css = rewriteCssUrls(fs, file, fs.readText(file) ?? '', base);
+                return query === 'import' ? reply(200, JS_MIME, cssToModule(file, css)) : reply(200, mimeFor(ext), css);
+            }
+            if (ext === '.json' && query === 'import')
+                return reply(200, JS_MIME, jsonToModule(fs.readText(file) ?? ''));
+            if (loaderFor(ext))
+                return reply(200, JS_MIME, await compileScript(this.context(), file));
+            if (ext === '.html' || ext === '.htm') {
+                return reply(200, mimeFor(ext), transformHtml(fs.readText(file) ?? '', { base, attribution: this.options.attribution }));
+            }
+            return reply(200, mimeFor(ext), fs.readFile(file) ?? '');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return query || loaderFor(ext) ? errorModule(`${file}: ${message}`) : reply(500, 'text/plain; charset=utf-8', message);
+        }
+    }
+    serveDocument(profile) {
+        if (!profile.supported || !profile.htmlPath) {
+            return reply(501, 'text/html; charset=utf-8', `<!doctype html><meta charset="utf-8"><p>${profile.reason ?? 'Unsupported project.'}</p>`);
+        }
+        const html = this.options.fs.readText(profile.htmlPath) ?? '';
+        const { base, attribution } = this.options;
+        return reply(200, 'text/html; charset=utf-8', transformHtml(html, { base, entry: profile.entry, attribution }));
+    }
+    context() {
+        const { fs, transformer, base } = this.options;
+        this.config ??= readProjectConfig(fs);
+        this.cdn ??= (this.options.cdn ?? ((dependencies) => createEsmShCdn({ dependencies })))(this.config.dependencies);
+        return { fs, config: this.config, cdn: this.cdn, transformer, base };
+    }
+    onChange(change) {
+        const structural = change.type === 'remove' || change.created === true || isConfigFile(change.path) || extname(change.path) === '.html';
+        if (!structural) {
+            for (const key of [...this.cache.keys()])
+                if (key.startsWith(change.path + '?'))
+                    this.cache.delete(key);
+            return;
+        }
+        this.cache.clear();
+        this.config = undefined;
+        this.cdn = undefined;
+        this.profileCache = undefined;
+    }
+}
+//# sourceMappingURL=devServer.js.map

package/dist/devServer.js.map

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

package/dist/html.d.ts

@@ -0,0 +1,17 @@
+export declare const ERROR_MESSAGE_TYPE = "bfwc:error";
+/**
+ * Runs first in the preview. Forwards uncaught errors and rejections to the host
+ * page (`window.parent`), which is how an editor — or an agent — learns the app
+ * crashed without scraping the iframe.
+ */
+export declare function errorBridgeScript(): string;
+export interface HtmlOptions {
+    /** Preview base URL, ending in `/`. */
+    base: string;
+    /** Entry injected when the page has no module script. */
+    entry?: string;
+    /** The "Built with Builderforce.ai" badge. On unless explicitly `false`. */
+    attribution?: boolean;
+}
+export declare function transformHtml(html: string, options: HtmlOptions): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAKD,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAgBxE"}

package/dist/html.js

@@ -0,0 +1,46 @@
+/**
+ * Prepare the project's HTML for the preview:
+ *   • absolute `src`/`href` paths (`/src/main.tsx`) are re-rooted under the preview
+ *     base, since the preview is served from a sub-path, not the origin root;
+ *   • CRA's `%PUBLIC_URL%` placeholder is filled;
+ *   • a page with no module script (CRA) gets its entry injected;
+ *   • the error bridge is prepended, so runtime errors reach the host;
+ *   • the attribution badge is appended unless the host turned it off.
+ */
+import { injectAttribution } from './attribution.js';
+export const ERROR_MESSAGE_TYPE = 'bfwc:error';
+/**
+ * Runs first in the preview. Forwards uncaught errors and rejections to the host
+ * page (`window.parent`), which is how an editor — or an agent — learns the app
+ * crashed without scraping the iframe.
+ */
+export function errorBridgeScript() {
+    return `<script>(function(){
+  var send = function (message, stack) {
+    try { parent.postMessage({ type: ${JSON.stringify(ERROR_MESSAGE_TYPE)}, message: String(message), stack: stack ? String(stack) : undefined, href: location.href }, '*'); } catch (_) {}
+  };
+  addEventListener('error', function (e) { send(e.message, e.error && e.error.stack); });
+  addEventListener('unhandledrejection', function (e) { var r = e.reason; send(r && r.message ? r.message : r, r && r.stack); });
+  window.process = window.process || { env: { NODE_ENV: 'development' } };
+})();</script>`;
+}
+const ABSOLUTE_ATTR = /(\s(?:src|href)\s*=\s*)(["'])\/(?!\/)([^"']*)\2/gi;
+const MODULE_SCRIPT = /<script\b[^>]*type\s*=\s*["']module["'][^>]*>/i;
+export function transformHtml(html, options) {
+    const { base } = options;
+    // `%PUBLIC_URL%/logo.png` becomes root-absolute here and is re-rooted once below;
+    // filling in the base directly would let the re-rooting prefix it a second time.
+    let out = html.replace(/%PUBLIC_URL%/g, '');
+    out = out.replace(ABSOLUTE_ATTR, (_m, attr, quote, rest) => `${attr}${quote}${base}${rest}${quote}`);
+    if (options.entry && !MODULE_SCRIPT.test(out)) {
+        const tag = `<script type="module" src="${base}${options.entry.slice(1)}"></script>`;
+        out = /<\/body>/i.test(out) ? out.replace(/<\/body>/i, `${tag}\n</body>`) : out + tag;
+    }
+    if (options.attribution !== false)
+        out = injectAttribution(out);
+    const bridge = errorBridgeScript();
+    if (/<head[^>]*>/i.test(out))
+        return out.replace(/<head[^>]*>/i, (head) => `${head}\n${bridge}`);
+    return bridge + out;
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;uCAE8B,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC;;;;;eAK1D,CAAC;AAChB,CAAC;AAED,MAAM,aAAa,GAAG,mDAAmD,CAAC;AAC1E,MAAM,aAAa,GAAG,gDAAgD,CAAC;AAWvE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAoB;IAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,kFAAkF;IAClF,iFAAiF;IACjF,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC5C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;IAE7H,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,8BAA8B,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;QACrF,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK;QAAE,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;IACjG,OAAO,MAAM,GAAG,GAAG,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { VirtualFileSystem } from './vfs.js';
+export type { FileContent, FileSystemTree, FlatFiles, FsChange } from './vfs.js';
+export { normalizePath, dirname, basename, join, extname } from './paths.js';
+export { DevServer } from './devServer.js';
+export type { DevServerOptions, ServedFile } from './devServer.js';
+export { detectProject } from './detectProject.js';
+export type { ProjectKind, ProjectProfile } from './detectProject.js';
+export { readProjectConfig, parseLooseJson, parseDotenv } from './projectConfig.js';
+export type { ProjectConfig, PathAlias } from './projectConfig.js';
+export { createEsmShCdn } from './packageCdn.js';
+export type { PackageCdn, EsmShOptions } from './packageCdn.js';
+export { createEsbuildTransformer, loaderFor } from './transformer.js';
+export type { Transformer, TransformRequest, Loader, EsbuildLike } from './transformer.js';
+export { rewriteImports } from './rewriteImports.js';
+export { resolveLocal, resolveAlias, isBareSpecifier, splitPackageSpecifier, RESOLVE_EXTENSIONS } from './resolve.js';
+export { compileScript, mapSpecifier, moduleUrl, buildDefine } from './compileScript.js';
+export { transformHtml, errorBridgeScript, ERROR_MESSAGE_TYPE } from './html.js';
+export { mimeFor } from './mime.js';
+export { attributionScript, injectAttribution, ATTRIBUTION_URL, ATTRIBUTION_LABEL } from './attribution.js';
+export type { AttributionOptions } from './attribution.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}