@seanhogg/builderforce-webcontainers-core 2026.10.0

package/dist/index.js

@@ -0,0 +1,14 @@
+export { VirtualFileSystem } from './vfs.js';
+export { normalizePath, dirname, basename, join, extname } from './paths.js';
+export { DevServer } from './devServer.js';
+export { detectProject } from './detectProject.js';
+export { readProjectConfig, parseLooseJson, parseDotenv } from './projectConfig.js';
+export { createEsmShCdn } from './packageCdn.js';
+export { createEsbuildTransformer, loaderFor } 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvE,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"}

package/dist/mime.d.ts

@@ -0,0 +1,3 @@
+export declare const JS_MIME = "text/javascript; charset=utf-8";
+export declare function mimeFor(ext: string): string;
+//# sourceMappingURL=mime.d.ts.map

package/dist/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,OAAO,mCAAmC,CAAC;AAExD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/mime.js

@@ -0,0 +1,35 @@
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.xml': 'application/xml; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.wasm': 'application/wasm',
+    '.pdf': 'application/pdf',
+};
+export const JS_MIME = 'text/javascript; charset=utf-8';
+export function mimeFor(ext) {
+    return MIME[ext] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=mime.js.map

package/dist/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAA2B;IACnC,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,iCAAiC;IACzC,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,8BAA8B;IACrC,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,gCAAgC,CAAC;AAExD,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACjD,CAAC"}

package/dist/packageCdn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Where a bare import (`react`, `react-dom/client`) is fetched from. A PORT, so a
+ * fork can point at a self-hosted mirror or an offline cache without touching the
+ * rest of the runtime. The default speaks esm.sh's URL scheme.
+ */
+export interface PackageCdn {
+    /** The ES-module URL for `name` + `subpath` (`'' | '/client'`). */
+    urlFor(name: string, subpath: string): string;
+}
+export interface EsmShOptions {
+    /** Defaults to https://esm.sh. Any esm.sh-compatible server works. */
+    origin?: string;
+    /** The project's dependency ranges — pins versions and dedupes shared packages. */
+    dependencies?: Record<string, string>;
+    /** Serve development builds (readable React errors). Default true. */
+    dev?: boolean;
+}
+export declare function createEsmShCdn(options?: EsmShOptions): PackageCdn;
+//# sourceMappingURL=packageCdn.d.ts.map

package/dist/packageCdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageCdn.d.ts","sourceRoot":"","sources":["../src/packageCdn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAOD,wBAAgB,cAAc,CAAC,OAAO,GAAE,YAAiB,GAAG,UAAU,CAuBrE"}

package/dist/packageCdn.js

@@ -0,0 +1,29 @@
+/** A range the CDN can't fetch (`workspace:*`, `file:../x`, `link:`, git URLs). */
+function isRegistryRange(range) {
+    return !/^(workspace|file|link|portal|git\+|git:|github:|https?:)/.test(range) && !range.includes('/');
+}
+export function createEsmShCdn(options = {}) {
+    const origin = (options.origin ?? 'https://esm.sh').replace(/\/+$/, '');
+    const dependencies = options.dependencies ?? {};
+    const dev = options.dev ?? true;
+    // Pin every declared dependency into each package's own graph, so `react-dom`
+    // and the app share ONE `react` — two copies is the classic "invalid hook call".
+    const pinned = Object.entries(dependencies)
+        .filter(([, range]) => isRegistryRange(range))
+        .map(([name, range]) => `${name}@${range}`)
+        .sort();
+    return {
+        urlFor(name, subpath) {
+            const range = dependencies[name];
+            const versioned = range && isRegistryRange(range) ? `${name}@${range}` : name;
+            const params = [];
+            const deps = pinned.filter((entry) => !entry.startsWith(name + '@'));
+            if (deps.length)
+                params.push('deps=' + deps.map(encodeURIComponent).join(','));
+            if (dev)
+                params.push('dev');
+            return `${origin}/${versioned}${subpath}${params.length ? '?' + params.join('&') : ''}`;
+        },
+    };
+}
+//# sourceMappingURL=packageCdn.js.map

package/dist/packageCdn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageCdn.js","sourceRoot":"","sources":["../src/packageCdn.ts"],"names":[],"mappings":"AAmBA,mFAAmF;AACnF,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,CAAC,0DAA0D,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAwB,EAAE;IACvD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;IAEhC,8EAA8E;IAC9E,iFAAiF;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;SAC1C,IAAI,EAAE,CAAC;IAEV,OAAO;QACL,MAAM,CAAC,IAAI,EAAE,OAAO;YAClB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9E,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;YACrE,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/E,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * POSIX path helpers for the virtual file system. Every path the runtime stores is
+ * absolute and normalised (`/src/App.tsx`), so comparisons are plain string equality.
+ */
+/** Absolute, normalised: resolves `.`/`..`, collapses slashes, accepts backslashes. */
+export declare function normalizePath(path: string): string;
+export declare function dirname(path: string): string;
+export declare function basename(path: string): string;
+export declare function join(...segments: string[]): string;
+/** Lower-cased extension including the dot (`.tsx`), or `''`. Dotfiles have none. */
+export declare function extname(path: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAElD;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C"}

package/dist/paths.js

@@ -0,0 +1,36 @@
+/**
+ * POSIX path helpers for the virtual file system. Every path the runtime stores is
+ * absolute and normalised (`/src/App.tsx`), so comparisons are plain string equality.
+ */
+/** Absolute, normalised: resolves `.`/`..`, collapses slashes, accepts backslashes. */
+export function normalizePath(path) {
+    const parts = [];
+    for (const segment of path.replace(/\\/g, '/').split('/')) {
+        if (!segment || segment === '.')
+            continue;
+        if (segment === '..')
+            parts.pop();
+        else
+            parts.push(segment);
+    }
+    return '/' + parts.join('/');
+}
+export function dirname(path) {
+    const normalized = normalizePath(path);
+    const cut = normalized.lastIndexOf('/');
+    return cut <= 0 ? '/' : normalized.slice(0, cut);
+}
+export function basename(path) {
+    const normalized = normalizePath(path);
+    return normalized.slice(normalized.lastIndexOf('/') + 1);
+}
+export function join(...segments) {
+    return normalizePath(segments.join('/'));
+}
+/** Lower-cased extension including the dot (`.tsx`), or `''`. Dotfiles have none. */
+export function extname(path) {
+    const base = basename(path);
+    const dot = base.lastIndexOf('.');
+    return dot <= 0 ? '' : base.slice(dot).toLowerCase();
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAC1C,IAAI,OAAO,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,QAAkB;IACxC,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACvD,CAAC"}

package/dist/projectConfig.d.ts

@@ -0,0 +1,36 @@
+import type { VirtualFileSystem } from './vfs.js';
+/**
+ * What the dev server needs to know about a project, read from its own files:
+ * dependency versions (for the package CDN), tsconfig path aliases and JSX mode,
+ * and `VITE_*` variables from `.env` files.
+ *
+ * Everything here is derived, so it is recomputed whenever one of
+ * {@link CONFIG_FILES} changes and is otherwise read from the cache.
+ */
+export declare const CONFIG_FILES: readonly ["/package.json", "/tsconfig.json", "/jsconfig.json", "/.env", "/.env.local", "/.env.development", "/.env.development.local"];
+export interface PathAlias {
+    /** The specifier prefix, without the trailing `*` (`@/`). Exact when `wildcard` is false. */
+    prefix: string;
+    wildcard: boolean;
+    /** Absolute VFS targets, without the trailing `*`, tried in order. */
+    targets: string[];
+}
+export interface ProjectConfig {
+    /** dependencies + devDependencies, name → version range. */
+    dependencies: Record<string, string>;
+    aliases: PathAlias[];
+    jsx: {
+        runtime: 'automatic' | 'classic';
+        importSource: string;
+    };
+    /** `VITE_*` and `NODE_ENV` style variables from the `.env` files, in load order. */
+    env: Record<string, string>;
+}
+/** JSON that tolerates the comments and trailing commas tsconfig files carry. */
+export declare function parseLooseJson(text: string): unknown;
+/** `KEY=value` lines; quotes stripped, `#` comments and blank lines ignored. */
+export declare function parseDotenv(text: string): Record<string, string>;
+export declare function readProjectConfig(fs: VirtualFileSystem): ProjectConfig;
+/** True when a change to `path` invalidates the derived {@link ProjectConfig}. */
+export declare function isConfigFile(path: string): boolean;
+//# sourceMappingURL=projectConfig.d.ts.map

package/dist/projectConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectConfig.d.ts","sourceRoot":"","sources":["../src/projectConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,wIAQf,CAAC;AAEX,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,GAAG,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBpD;AA0DD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAehE;AAYD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,aAAa,CAQtE;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/projectConfig.js

@@ -0,0 +1,155 @@
+import { join, normalizePath } from './paths.js';
+/**
+ * What the dev server needs to know about a project, read from its own files:
+ * dependency versions (for the package CDN), tsconfig path aliases and JSX mode,
+ * and `VITE_*` variables from `.env` files.
+ *
+ * Everything here is derived, so it is recomputed whenever one of
+ * {@link CONFIG_FILES} changes and is otherwise read from the cache.
+ */
+export const CONFIG_FILES = [
+    '/package.json',
+    '/tsconfig.json',
+    '/jsconfig.json',
+    '/.env',
+    '/.env.local',
+    '/.env.development',
+    '/.env.development.local',
+];
+/** JSON that tolerates the comments and trailing commas tsconfig files carry. */
+export function parseLooseJson(text) {
+    let out = '';
+    let inString = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        const next = text[i + 1];
+        if (inString) {
+            out += ch;
+            if (ch === '\\') {
+                out += next ?? '';
+                i++;
+            }
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            out += ch;
+            continue;
+        }
+        if (ch === '/' && next === '/') {
+            while (i < text.length && text[i] !== '\n')
+                i++;
+            out += '\n';
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            i += 2;
+            while (i < text.length && !(text[i] === '*' && text[i + 1] === '/'))
+                i++;
+            i++;
+            continue;
+        }
+        out += ch;
+    }
+    return JSON.parse(out.replace(/,(\s*[}\]])/g, '$1'));
+}
+function readJson(fs, path) {
+    const text = fs.readText(path);
+    if (text === undefined)
+        return undefined;
+    try {
+        const value = parseLooseJson(text);
+        return value && typeof value === 'object' ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function readDependencies(fs) {
+    const pkg = readJson(fs, '/package.json') ?? {};
+    const out = {};
+    for (const field of ['devDependencies', 'dependencies']) {
+        for (const [name, version] of Object.entries(asRecord(pkg[field]))) {
+            if (typeof version === 'string')
+                out[name] = version;
+        }
+    }
+    return out;
+}
+function readCompilerOptions(fs) {
+    const tsconfig = readJson(fs, '/tsconfig.json') ?? readJson(fs, '/jsconfig.json') ?? {};
+    return asRecord(tsconfig.compilerOptions);
+}
+function readAliases(options) {
+    const baseUrl = typeof options.baseUrl === 'string' ? options.baseUrl : '.';
+    const aliases = [];
+    for (const [pattern, rawTargets] of Object.entries(asRecord(options.paths))) {
+        if (!Array.isArray(rawTargets))
+            continue;
+        const wildcard = pattern.endsWith('*');
+        const targets = rawTargets
+            .filter((t) => typeof t === 'string')
+            .map((t) => {
+            const stripped = wildcard ? t.replace(/\*$/, '') : t;
+            const resolved = join('/', baseUrl, stripped);
+            return stripped.endsWith('/') && resolved !== '/' ? resolved + '/' : resolved;
+        });
+        aliases.push({ prefix: wildcard ? pattern.slice(0, -1) : pattern, wildcard, targets });
+    }
+    // Longest prefix first, so `@/components/*` wins over `@/*`.
+    return aliases.sort((a, b) => b.prefix.length - a.prefix.length);
+}
+function readJsx(options) {
+    const importSource = typeof options.jsxImportSource === 'string' ? options.jsxImportSource : 'react';
+    const runtime = options.jsx === 'react' ? 'classic' : 'automatic';
+    return { runtime, importSource };
+}
+/** `KEY=value` lines; quotes stripped, `#` comments and blank lines ignored. */
+export function parseDotenv(text) {
+    const out = {};
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = line.slice(0, eq).replace(/^export\s+/, '').trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+function readEnv(fs) {
+    const env = {};
+    for (const file of CONFIG_FILES) {
+        if (!file.startsWith('/.env'))
+            continue;
+        const text = fs.readText(file);
+        if (text !== undefined)
+            Object.assign(env, parseDotenv(text));
+    }
+    return env;
+}
+export function readProjectConfig(fs) {
+    const options = readCompilerOptions(fs);
+    return {
+        dependencies: readDependencies(fs),
+        aliases: readAliases(options),
+        jsx: readJsx(options),
+        env: readEnv(fs),
+    };
+}
+/** True when a change to `path` invalidates the derived {@link ProjectConfig}. */
+export function isConfigFile(path) {
+    return CONFIG_FILES.includes(normalizePath(path));
+}
+//# sourceMappingURL=projectConfig.js.map

package/dist/projectConfig.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,19 @@
+import type { VirtualFileSystem } from './vfs.js';
+import type { PathAlias } from './projectConfig.js';
+/** Extensions probed, in order, for an extension-less import — Vite's default order. */
+export declare const RESOLVE_EXTENSIONS: readonly [".tsx", ".ts", ".jsx", ".js", ".mjs", ".cjs", ".json", ".css"];
+/** `foo`, `@scope/foo`, `foo/sub` — not relative, not absolute, not a URL. */
+export declare function isBareSpecifier(specifier: string): boolean;
+/** Split a bare specifier into its package name and subpath (`/client`, or `''`). */
+export declare function splitPackageSpecifier(specifier: string): {
+    name: string;
+    subpath: string;
+};
+/** Resolve a relative or absolute specifier against the importing file's directory. */
+export declare function resolveLocal(fs: VirtualFileSystem, fromDir: string, specifier: string): string | undefined;
+/**
+ * Resolve a specifier through tsconfig `paths` (`@/components/Button` →
+ * `/src/components/Button.tsx`). Undefined when no alias matches or no target exists.
+ */
+export declare function resolveAlias(fs: VirtualFileSystem, aliases: readonly PathAlias[], specifier: string): string | undefined;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,0EAA2E,CAAC;AAE3G,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAI1F;AAoBD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxH"}

package/dist/resolve.js

@@ -0,0 +1,62 @@
+import { extname, join, normalizePath } from './paths.js';
+/** Extensions probed, in order, for an extension-less import — Vite's default order. */
+export const RESOLVE_EXTENSIONS = ['.tsx', '.ts', '.jsx', '.js', '.mjs', '.cjs', '.json', '.css'];
+/** `foo`, `@scope/foo`, `foo/sub` — not relative, not absolute, not a URL. */
+export function isBareSpecifier(specifier) {
+    if (specifier.startsWith('.') || specifier.startsWith('/'))
+        return false;
+    return !/^[a-z][a-z0-9+.-]*:/i.test(specifier);
+}
+/** Split a bare specifier into its package name and subpath (`/client`, or `''`). */
+export function splitPackageSpecifier(specifier) {
+    const parts = specifier.split('/');
+    const take = specifier.startsWith('@') ? 2 : 1;
+    return { name: parts.slice(0, take).join('/'), subpath: parts.length > take ? '/' + parts.slice(take).join('/') : '' };
+}
+function probe(fs, base) {
+    if (fs.isFile(base))
+        return base;
+    for (const ext of RESOLVE_EXTENSIONS)
+        if (fs.isFile(base + ext))
+            return base + ext;
+    // TypeScript ESM convention: `./util.js` written in source names `util.ts`.
+    const ext = extname(base);
+    if (ext === '.js' || ext === '.jsx' || ext === '.mjs') {
+        const stem = base.slice(0, -ext.length);
+        for (const alt of ['.ts', '.tsx'])
+            if (fs.isFile(stem + alt))
+                return stem + alt;
+    }
+    if (fs.isDirectory(base)) {
+        for (const ext2 of RESOLVE_EXTENSIONS) {
+            const index = join(base, 'index' + ext2);
+            if (fs.isFile(index))
+                return index;
+        }
+    }
+    return undefined;
+}
+/** Resolve a relative or absolute specifier against the importing file's directory. */
+export function resolveLocal(fs, fromDir, specifier) {
+    const base = specifier.startsWith('/') ? normalizePath(specifier) : join(fromDir, specifier);
+    return probe(fs, base);
+}
+/**
+ * Resolve a specifier through tsconfig `paths` (`@/components/Button` →
+ * `/src/components/Button.tsx`). Undefined when no alias matches or no target exists.
+ */
+export function resolveAlias(fs, aliases, specifier) {
+    for (const alias of aliases) {
+        const matches = alias.wildcard ? specifier.startsWith(alias.prefix) : specifier === alias.prefix;
+        if (!matches)
+            continue;
+        const rest = alias.wildcard ? specifier.slice(alias.prefix.length) : '';
+        for (const target of alias.targets) {
+            const hit = probe(fs, normalizePath(target + rest));
+            if (hit)
+                return hit;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/rewriteImports.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rewrite every import specifier in an ES module — static `import`/`export … from`,
+ * side-effect `import 'x'`, and string-literal dynamic `import('x')` — through
+ * `map`. A `map` result of `undefined` leaves that specifier untouched, as are
+ * non-literal dynamic imports and `import.meta`.
+ *
+ * Positions come from es-module-lexer rather than a regex, so specifiers inside
+ * strings, comments and template literals are never touched.
+ */
+export declare function rewriteImports(code: string, map: (specifier: string) => string | undefined): Promise<string>;
+//# sourceMappingURL=rewriteImports.d.ts.map

package/dist/rewriteImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteImports.d.ts","sourceRoot":"","sources":["../src/rewriteImports.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAclH"}

package/dist/rewriteImports.js

@@ -0,0 +1,28 @@
+import { init, parse } from 'es-module-lexer';
+/**
+ * Rewrite every import specifier in an ES module — static `import`/`export … from`,
+ * side-effect `import 'x'`, and string-literal dynamic `import('x')` — through
+ * `map`. A `map` result of `undefined` leaves that specifier untouched, as are
+ * non-literal dynamic imports and `import.meta`.
+ *
+ * Positions come from es-module-lexer rather than a regex, so specifiers inside
+ * strings, comments and template literals are never touched.
+ */
+export async function rewriteImports(code, map) {
+    await init;
+    const [imports] = parse(code);
+    let out = '';
+    let cursor = 0;
+    for (const entry of imports) {
+        if (entry.d === -2 || entry.n === undefined)
+            continue; // import.meta, or a non-literal dynamic import
+        const replacement = map(entry.n);
+        if (replacement === undefined || replacement === entry.n)
+            continue;
+        const dynamic = entry.d > -1;
+        out += code.slice(cursor, entry.s) + (dynamic ? JSON.stringify(replacement) : replacement);
+        cursor = entry.e;
+    }
+    return out + code.slice(cursor);
+}
+//# sourceMappingURL=rewriteImports.js.map

package/dist/rewriteImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteImports.js","sourceRoot":"","sources":["../src/rewriteImports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,GAA8C;IAC/F,MAAM,IAAI,CAAC;IACX,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,+CAA+C;QACtG,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC3F,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/styleModules.d.ts

@@ -0,0 +1,12 @@
+import type { VirtualFileSystem } from './vfs.js';
+export declare function rewriteCssUrls(fs: VirtualFileSystem, cssPath: string, css: string, base: string): string;
+/**
+ * The JS module for an imported stylesheet. `.module.css` exports an identity map
+ * (class name → itself): real scoping needs the build API, so for now CSS Modules
+ * render correctly as long as class names don't collide.
+ */
+export declare function cssToModule(path: string, css: string): string;
+export declare function jsonToModule(text: string): string;
+export declare function rawToModule(text: string): string;
+export declare function urlToModule(url: string): string;
+//# sourceMappingURL=styleModules.d.ts.map

package/dist/styleModules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleModules.d.ts","sourceRoot":"","sources":["../src/styleModules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAclD,wBAAgB,cAAc,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASxG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/styleModules.js

@@ -0,0 +1,53 @@
+import { dirname } from './paths.js';
+import { resolveLocal } from './resolve.js';
+/**
+ * CSS handling. A stylesheet imported from JS is served as a JS module that
+ * injects a <style> tag (keyed by path, so a re-import replaces rather than
+ * duplicates). Its relative `url(...)` references are rewritten to absolute
+ * preview URLs, because once the text lives in a <style> tag the browser resolves
+ * them against the DOCUMENT, not the stylesheet's own location.
+ */
+const URL_REF = /url\(\s*(['"]?)([^'")]+)\1\s*\)/g;
+export function rewriteCssUrls(fs, cssPath, css, base) {
+    return css.replace(URL_REF, (match, quote, ref) => {
+        if (/^(data:|https?:|\/\/|#)/i.test(ref))
+            return match;
+        const [pathPart] = ref.split(/[?#]/);
+        if (!pathPart)
+            return match;
+        const resolved = resolveLocal(fs, dirname(cssPath), pathPart);
+        if (!resolved)
+            return match;
+        return `url(${quote}${base}${resolved.slice(1)}${ref.slice(pathPart.length)}${quote})`;
+    });
+}
+/**
+ * The JS module for an imported stylesheet. `.module.css` exports an identity map
+ * (class name → itself): real scoping needs the build API, so for now CSS Modules
+ * render correctly as long as class names don't collide.
+ */
+export function cssToModule(path, css) {
+    const id = JSON.stringify(path);
+    const exportsCssModule = /\.module\.css$/i.test(path);
+    return [
+        `const css = ${JSON.stringify(css)};`,
+        `let el = document.querySelector('style[data-bfwc=' + JSON.stringify(${id}) + ']');`,
+        `if (!el) { el = document.createElement('style'); el.setAttribute('data-bfwc', ${id}); document.head.appendChild(el); }`,
+        `el.textContent = css;`,
+        exportsCssModule
+            ? `export default new Proxy({}, { get: (_, key) => typeof key === 'string' ? key : undefined });`
+            : `export default css;`,
+    ].join('\n');
+}
+export function jsonToModule(text) {
+    // Round-trip so a malformed file fails here with a clear message, not as a
+    // syntax error inside generated code.
+    return `export default ${JSON.stringify(JSON.parse(text))};`;
+}
+export function rawToModule(text) {
+    return `export default ${JSON.stringify(text)};`;
+}
+export function urlToModule(url) {
+    return `export default ${JSON.stringify(url)};`;
+}
+//# sourceMappingURL=styleModules.js.map

package/dist/styleModules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleModules.js","sourceRoot":"","sources":["../src/styleModules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AAEH,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,EAAqB,EAAE,OAAe,EAAE,GAAW,EAAE,IAAY;IAC9F,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAa,EAAE,GAAW,EAAE,EAAE;QAChE,IAAI,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,OAAO,OAAO,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAW;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO;QACL,eAAe,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG;QACrC,uEAAuE,EAAE,WAAW;QACpF,iFAAiF,EAAE,qCAAqC;QACxH,uBAAuB;QACvB,gBAAgB;YACd,CAAC,CAAC,+FAA+F;YACjG,CAAC,CAAC,qBAAqB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,2EAA2E;IAC3E,sCAAsC;IACtC,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AAClD,CAAC"}