sandlot 0.1.0 → 0.1.2

package/dist/internal.js

@@ -1081,12 +1081,35 @@ function formatDiagnosticsForAgent(diagnostics) {
 }
 
 // src/bundler.ts
-import * as esbuild from "esbuild-wasm";
+var esbuild = null;
+async function getEsbuild() {
+  if (esbuild)
+    return esbuild;
+  const cdnUrl = `https://esm.sh/esbuild-wasm@${ESBUILD_VERSION}`;
+  const mod = await import(cdnUrl);
+  esbuild = mod.default ?? mod;
+  if (typeof esbuild?.initialize !== "function") {
+    console.error("esbuild-wasm module structure:", mod);
+    throw new Error("Failed to load esbuild-wasm: initialize function not found");
+  }
+  return esbuild;
+}
+var ESBUILD_VERSION = "0.27.2";
 var initialized = false;
 var initPromise = null;
 function getWasmUrl() {
-  const version = "0.27.2";
-  return `https://unpkg.com/esbuild-wasm@${version}/esbuild.wasm`;
+  return `https://unpkg.com/esbuild-wasm@${ESBUILD_VERSION}/esbuild.wasm`;
+}
+function checkCrossOriginIsolation() {
+  if (typeof window === "undefined")
+    return;
+  if (!window.crossOriginIsolated) {
+    console.warn(`[sandlot] Cross-origin isolation is not enabled. esbuild-wasm may have reduced performance or fail on some browsers.
+To enable, add these headers to your dev server:
+  Cross-Origin-Embedder-Policy: require-corp
+  Cross-Origin-Opener-Policy: same-origin
+In Vite, add a plugin to configureServer. See sandlot README for details.`);
+  }
 }
 async function initBundler() {
   if (initialized)
@@ -1095,9 +1118,13 @@ async function initBundler() {
     await initPromise;
     return;
   }
-  initPromise = esbuild.initialize({
-    wasmURL: getWasmUrl()
-  });
+  checkCrossOriginIsolation();
+  initPromise = (async () => {
+    const es = await getEsbuild();
+    await es.initialize({
+      wasmURL: getWasmUrl()
+    });
+  })();
   await initPromise;
   initialized = true;
 }
@@ -1148,8 +1175,8 @@ function createVfsPlugin(options) {
   } = options;
   return {
     name: "virtual-fs",
-    setup(build2) {
-      build2.onResolve({ filter: /.*/ }, async (args) => {
+    setup(build) {
+      build.onResolve({ filter: /.*/ }, async (args) => {
         if (args.kind === "entry-point") {
           return { path: entryPoint, namespace: "vfs" };
         }
@@ -1205,28 +1232,18 @@ function createVfsPlugin(options) {
         }
         return { errors: [{ text: `Cannot resolve: ${args.path} from ${args.resolveDir}` }] };
       });
-      build2.onLoad({ filter: /.*/, namespace: "sandlot-shared" }, (args) => {
-        const contents = `export default ${getSharedModuleRuntimeCode(args.path)};
-export * from ${JSON.stringify(args.path)};
-// Re-export all named exports by importing from registry
-const __mod__ = ${getSharedModuleRuntimeCode(args.path)};
-for (const __k__ in __mod__) {
-  if (__k__ !== 'default') Object.defineProperty(exports, __k__, { 
-    enumerable: true, 
-    get: function() { return __mod__[__k__]; } 
-  });
-}`;
-        const esmContents = `
+      build.onLoad({ filter: /.*/, namespace: "sandlot-shared" }, (args) => {
+        const contents = `
 const __sandlot_mod__ = ${getSharedModuleRuntimeCode(args.path)};
 export default __sandlot_mod__.default ?? __sandlot_mod__;
 ${generateNamedExports(args.path)}
 `;
         return {
-          contents: esmContents.trim(),
+          contents: contents.trim(),
           loader: "js"
         };
       });
-      build2.onLoad({ filter: /.*/, namespace: "vfs" }, async (args) => {
+      build.onLoad({ filter: /.*/, namespace: "vfs" }, async (args) => {
         try {
           const contents = await fs.readFile(args.path);
           includedFiles.add(args.path);
@@ -1325,7 +1342,8 @@ async function bundle(options) {
     includedFiles,
     sharedModuleIds
   });
-  const result = await esbuild.build({
+  const es = await getEsbuild();
+  const result = await es.build({
     entryPoints: [normalizedEntry],
     bundle: true,
     write: false,
@@ -1876,6 +1894,42 @@ function createDefaultCommands(deps) {
     createListCommand(deps)
   ];
 }
+// src/build-emitter.ts
+class BuildEmitter {
+  listeners = new Set;
+  lastResult = null;
+  emit = async (result) => {
+    this.lastResult = result;
+    const promises = [];
+    for (const listener of this.listeners) {
+      const ret = listener(result);
+      if (ret instanceof Promise) {
+        promises.push(ret);
+      }
+    }
+    await Promise.all(promises);
+  };
+  on(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+  waitFor() {
+    if (this.lastResult) {
+      const result = this.lastResult;
+      this.lastResult = null;
+      return Promise.resolve(result);
+    }
+    return new Promise((resolve) => {
+      const unsub = this.on((result) => {
+        unsub();
+        this.lastResult = null;
+        resolve(result);
+      });
+    });
+  }
+}
 export {
   revokeModuleUrl,
   resolveToEsmUrl,
@@ -1893,5 +1947,6 @@ export {
   createModuleUrl,
   SharedModuleRegistry,
   LibCache,
-  InMemoryTypesCache
+  InMemoryTypesCache,
+  BuildEmitter
 };

package/dist/sandbox-manager.d.ts

@@ -26,13 +26,6 @@ import { type IndexedDbFsOptions } from "./fs";
 import { type BundleResult } from "./bundler";
 import { type SharedResources, type SharedResourcesOptions } from "./shared-resources";
 import type { Sandbox } from "./sandbox";
-export type { BundleResult } from "./bundler";
-export type { TypecheckResult } from "./typechecker";
-export type { SharedResources, TypesCache } from "./shared-resources";
-export type { PackageManifest, InstallResult } from "./packages";
-export { installPackage, uninstallPackage, listPackages, getPackageManifest } from "./packages";
-export { InMemoryTypesCache } from "./shared-resources";
-export { loadModule, loadExport, loadDefault, getExportNames, hasExport, createModuleUrl, revokeModuleUrl, ModuleLoadError, ExportNotFoundError, } from "./loader";
 /**
  * Options for creating a sandbox via the manager
  */
@@ -216,11 +209,6 @@ export declare class SandboxManager {
      * Get the shared resources (for advanced use cases)
      */
     getResources(): SharedResources | null;
-    /**
-     * Get the shared lib files (for advanced use cases)
-     * @deprecated Use getResources().libFiles instead
-     */
-    getLibFiles(): Map<string, string>;
 }
 /**
  * Create a new SandboxManager instance.

package/dist/sandbox-manager.d.ts.map

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

package/dist/sandbox.d.ts

@@ -2,14 +2,6 @@ import { Bash, defineCommand } from "just-bash/browser";
 import { IndexedDbFs, type IndexedDbFsOptions } from "./fs";
 import { type BundleResult } from "./bundler";
 import { type SharedResources } from "./shared-resources";
-export type { BundleResult } from "./bundler";
-export type { TypecheckResult } from "./typechecker";
-export type { SharedResources, TypesCache } from "./shared-resources";
-export type { PackageManifest, InstallResult } from "./packages";
-export type { RunContext, RunOptions, RunResult } from "./commands";
-export { installPackage, uninstallPackage, listPackages, getPackageManifest } from "./packages";
-export { InMemoryTypesCache } from "./shared-resources";
-export { loadModule, loadExport, loadDefault, getExportNames, hasExport, createModuleUrl, revokeModuleUrl, ModuleLoadError, ExportNotFoundError, } from "./loader";
 /**
  * Options for creating a sandbox environment
  */

package/dist/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG/E,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAuDlB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAAE,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;;;;;;;;;OAUG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgElF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACL,OAAO,CAAC,OAAO,CAAC,CA8DlB"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAAE,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;;;;;;;;;OAUG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgElF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACL,OAAO,CAAC,OAAO,CAAC,CA8DlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandlot",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Browser-based TypeScript sandbox with esbuild bundling and type checking",
   "author": "blindmansion",
   "license": "MIT",
@@ -22,11 +22,6 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js",
-      "default": "./dist/react.js"
-    },
     "./internal": {
       "types": "./dist/internal.d.ts",
       "import": "./dist/internal.js",
@@ -39,7 +34,7 @@
   ],
   "scripts": {
     "build": "bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/index.ts ./src/react.tsx ./src/internal.ts --outdir ./dist --format esm --packages external",
+    "build:js": "bun build ./src/index.ts ./src/internal.ts --outdir ./dist --format esm --packages external",
     "build:types": "tsc --emitDeclarationOnly",
     "prepublishOnly": "bun run build"
   },

package/src/build-emitter.ts

@@ -0,0 +1,61 @@
+/**
+ * Build event emitter for sandbox environments.
+ *
+ * Simple typed event emitter for build results.
+ * Caches the last result so waitFor() can be called after build completes.
+ */
+
+import type { BundleResult } from "./bundler";
+
+/**
+ * Simple typed event emitter for build results.
+ * Caches the last result so waitFor() can be called after build completes.
+ */
+export class BuildEmitter {
+  private listeners = new Set<(result: BundleResult) => void | Promise<void>>();
+  private lastResult: BundleResult | null = null;
+
+  /**
+   * Emit a build result to all listeners and cache it
+   */
+  emit = async (result: BundleResult): Promise<void> => {
+    this.lastResult = result;
+    const promises: Promise<void>[] = [];
+    for (const listener of this.listeners) {
+      const ret = listener(result);
+      if (ret instanceof Promise) {
+        promises.push(ret);
+      }
+    }
+    await Promise.all(promises);
+  };
+
+  /**
+   * Subscribe to build events. Returns an unsubscribe function.
+   */
+  on(callback: (result: BundleResult) => void | Promise<void>): () => void {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+
+  /**
+   * Get the last build result, or wait for the next one if none exists.
+   * Clears the cached result after returning, so subsequent calls wait for new builds.
+   */
+  waitFor(): Promise<BundleResult> {
+    if (this.lastResult) {
+      const result = this.lastResult;
+      this.lastResult = null;
+      return Promise.resolve(result);
+    }
+    return new Promise((resolve) => {
+      const unsub = this.on((result) => {
+        unsub();
+        this.lastResult = null;
+        resolve(result);
+      });
+    });
+  }
+}

package/src/bundler.ts

@@ -1,8 +1,33 @@
 import type { IFileSystem } from "just-bash/browser";
-import * as esbuild from "esbuild-wasm";
+import type * as EsbuildTypes from "esbuild-wasm";
 import { getPackageManifest, resolveToEsmUrl } from "./packages";
 import { getSharedModuleRuntimeCode } from "./shared-modules";
 
+// Lazily loaded esbuild module - loaded from CDN to avoid bundler issues
+let esbuild: typeof EsbuildTypes | null = null;
+
+async function getEsbuild(): Promise<typeof EsbuildTypes> {
+  if (esbuild) return esbuild;
+  
+  // Load esbuild-wasm from esm.sh CDN to avoid bundler transformation issues
+  // esm.sh provides proper ESM wrappers for npm packages
+  const cdnUrl = `https://esm.sh/esbuild-wasm@${ESBUILD_VERSION}`;
+  
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const mod: any = await import(/* @vite-ignore */ cdnUrl);
+  
+  // esm.sh typically provides both default and named exports
+  esbuild = mod.default ?? mod;
+  
+  // Verify we have the initialize function
+  if (typeof esbuild?.initialize !== 'function') {
+    console.error('esbuild-wasm module structure:', mod);
+    throw new Error('Failed to load esbuild-wasm: initialize function not found');
+  }
+  
+  return esbuild;
+}
+
 /**
  * How to handle npm package imports (bare imports like "react").
  * 
@@ -96,7 +121,7 @@ export interface BundleResult {
   /**
    * Any warnings from esbuild
    */
-  warnings: esbuild.Message[];
+  warnings: EsbuildTypes.Message[];
 
   /**
    * List of files that were included in the bundle
@@ -104,6 +129,11 @@ export interface BundleResult {
   includedFiles: string[];
 }
 
+/**
+ * esbuild-wasm version - MUST match the version in package.json dependencies
+ */
+const ESBUILD_VERSION = "0.27.2";
+
 // Track initialization state
 let initialized = false;
 let initPromise: Promise<void> | null = null;
@@ -112,9 +142,27 @@ let initPromise: Promise<void> | null = null;
  * Get the esbuild-wasm binary URL based on the installed version
  */
 function getWasmUrl(): string {
-  // Use unpkg CDN to fetch the WASM binary matching our installed version
-  const version = "0.27.2"; // Match installed version
-  return `https://unpkg.com/esbuild-wasm@${version}/esbuild.wasm`;
+  return `https://unpkg.com/esbuild-wasm@${ESBUILD_VERSION}/esbuild.wasm`;
+}
+
+/**
+ * Check if the browser environment supports cross-origin isolation.
+ * This is needed for SharedArrayBuffer which esbuild-wasm may use.
+ */
+function checkCrossOriginIsolation(): void {
+  if (typeof window === "undefined") return; // Not in browser
+  
+  // crossOriginIsolated is true when COOP/COEP headers are set correctly
+  if (!window.crossOriginIsolated) {
+    console.warn(
+      "[sandlot] Cross-origin isolation is not enabled. " +
+      "esbuild-wasm may have reduced performance or fail on some browsers.\n" +
+      "To enable, add these headers to your dev server:\n" +
+      "  Cross-Origin-Embedder-Policy: require-corp\n" +
+      "  Cross-Origin-Opener-Policy: same-origin\n" +
+      "In Vite, add a plugin to configureServer. See sandlot README for details."
+    );
+  }
 }
 
 /**
@@ -129,9 +177,14 @@ export async function initBundler(): Promise<void> {
     return;
   }
 
-  initPromise = esbuild.initialize({
-    wasmURL: getWasmUrl(),
-  });
+  checkCrossOriginIsolation();
+
+  initPromise = (async () => {
+    const es = await getEsbuild();
+    await es.initialize({
+      wasmURL: getWasmUrl(),
+    });
+  })();
 
   await initPromise;
   initialized = true;
@@ -147,7 +200,7 @@ function isBareImport(path: string): boolean {
 /**
  * Get the appropriate loader based on file extension
  */
-function getLoader(path: string): esbuild.Loader {
+function getLoader(path: string): EsbuildTypes.Loader {
   const ext = path.split(".").pop()?.toLowerCase();
   switch (ext) {
     case "ts":
@@ -207,7 +260,7 @@ function matchesSharedModule(importPath: string, sharedModuleIds: Set<string>):
 /**
  * Create an esbuild plugin that reads from a virtual filesystem
  */
-function createVfsPlugin(options: VfsPluginOptions): esbuild.Plugin {
+function createVfsPlugin(options: VfsPluginOptions): EsbuildTypes.Plugin {
   const {
     fs,
     entryPoint,
@@ -303,27 +356,14 @@ function createVfsPlugin(options: VfsPluginOptions): esbuild.Plugin {
 
       // Load shared modules from the registry
       build.onLoad({ filter: /.*/, namespace: "sandlot-shared" }, (args) => {
-        // Generate code that looks up the module from the global registry
-        const contents = `export default ${getSharedModuleRuntimeCode(args.path)};
-export * from ${JSON.stringify(args.path)};
-// Re-export all named exports by importing from registry
-const __mod__ = ${getSharedModuleRuntimeCode(args.path)};
-for (const __k__ in __mod__) {
-  if (__k__ !== 'default') Object.defineProperty(exports, __k__, { 
-    enumerable: true, 
-    get: function() { return __mod__[__k__]; } 
-  });
-}`;
-
-        // For ESM format, we need a different approach
-        // Generate a simple module that re-exports from registry
-        const esmContents = `
+        // Generate ESM code that re-exports from the shared module registry
+        const contents = `
 const __sandlot_mod__ = ${getSharedModuleRuntimeCode(args.path)};
 export default __sandlot_mod__.default ?? __sandlot_mod__;
 ${generateNamedExports(args.path)}
 `;
         return {
-          contents: esmContents.trim(),
+          contents: contents.trim(),
           loader: 'js'
         };
       });
@@ -445,7 +485,8 @@ export async function bundle(options: BundleOptions): Promise<BundleResult> {
     sharedModuleIds,
   });
 
-  const result = await esbuild.build({
+  const es = await getEsbuild();
+  const result = await es.build({
     entryPoints: [normalizedEntry],
     bundle: true,
     write: false,

package/src/fs.ts

@@ -23,9 +23,12 @@ interface ReadFileOptions {
 }
 
 /**
- * Options for writing files
+ * Options for writing files.
+ * Note: In this browser-based filesystem, content is stored as-is.
+ * The encoding option is accepted for API compatibility but not used.
  */
 interface WriteFileOptions {
+  /** Accepted for API compatibility but not used - content is stored as-is */
   encoding?: BufferEncoding;
 }
 
@@ -276,7 +279,7 @@ export class IndexedDbFs implements IFileSystem {
   async writeFile(
     path: string,
     content: FileContent,
-    options?: WriteFileOptions | BufferEncoding
+    _options?: WriteFileOptions | BufferEncoding
   ): Promise<void> {
     const normalizedPath = this.normalizePath(path);
     this.checkSizeLimit(content);
@@ -926,10 +929,20 @@ export class IndexedDbFs implements IFileSystem {
 }
 
 /**
- * Factory function matching the FileSystemFactory type
+ * Synchronous factory function for creating an in-memory filesystem.
+ * 
+ * Note: For IndexedDB-backed persistence, use `IndexedDbFs.create()` instead.
+ * This function exists for compatibility with sync factory patterns.
+ * 
+ * @param initialFiles - Optional initial files to populate the filesystem
+ * @returns An in-memory filesystem (no persistence)
  */
-export function createIndexedDbFs(initialFiles?: InitialFiles): IFileSystem {
-  // For sync factory usage, return in-memory version
-  // Use IndexedDbFs.create() for async with persistence
+export function createInMemoryFs(initialFiles?: InitialFiles): IFileSystem {
   return IndexedDbFs.createInMemory({ initialFiles });
 }
+
+/**
+ * @deprecated Use `createInMemoryFs` for in-memory filesystems or 
+ * `IndexedDbFs.create()` for IndexedDB-backed persistence.
+ */
+export const createIndexedDbFs = createInMemoryFs;

package/src/index.ts

@@ -1,3 +1,20 @@
+// =============================================================================
+// Browser polyfills - inject before anything else loads
+// =============================================================================
+
+// Some dependencies (like just-bash) reference Node.js globals.
+// Provide shims so they work in the browser without user configuration.
+if (typeof window !== "undefined" && typeof globalThis.process === "undefined") {
+  (globalThis as Record<string, unknown>).process = {
+    env: {},
+    platform: "browser",
+    version: "v20.0.0",
+    browser: true,
+    cwd: () => "/",
+    nextTick: (fn: () => void) => setTimeout(fn, 0),
+  };
+}
+
 // =============================================================================
 // CORE API - Most users only need these
 // =============================================================================
@@ -115,7 +132,7 @@ export {
 
 export {
   IndexedDbFs,
-  createIndexedDbFs,
+  createInMemoryFs,
   type IndexedDbFsOptions,
 } from "./fs";
 

package/src/internal.ts

@@ -112,5 +112,8 @@ export { formatEsbuildMessages } from "./commands";
 // BuildEmitter (for custom build event handling)
 // =============================================================================
 
-// Note: BuildEmitter is currently defined inline in sandbox.ts and sandbox-manager.ts
-// If needed externally, it should be extracted to a separate module.
+/**
+ * Build event emitter for sandbox environments.
+ * Use this for custom build event handling in advanced use cases.
+ */
+export { BuildEmitter } from "./build-emitter";

package/src/sandbox-manager.ts

@@ -32,82 +32,9 @@ import {
   type SharedResourcesOptions,
 } from "./shared-resources";
 import { createDefaultCommands, type CommandDeps } from "./commands";
+import { BuildEmitter } from "./build-emitter";
 import type { Sandbox } from "./sandbox";
 
-/**
- * Simple typed event emitter for build results.
- * Caches the last result so waitFor() can be called after build completes.
- */
-class BuildEmitter {
-  private listeners = new Set<(result: BundleResult) => void | Promise<void>>();
-  private lastResult: BundleResult | null = null;
-
-  /**
-   * Emit a build result to all listeners and cache it
-   */
-  emit = async (result: BundleResult): Promise<void> => {
-    this.lastResult = result;
-    const promises: Promise<void>[] = [];
-    for (const listener of this.listeners) {
-      const ret = listener(result);
-      if (ret instanceof Promise) {
-        promises.push(ret);
-      }
-    }
-    await Promise.all(promises);
-  };
-
-  /**
-   * Subscribe to build events. Returns an unsubscribe function.
-   */
-  on(callback: (result: BundleResult) => void | Promise<void>): () => void {
-    this.listeners.add(callback);
-    return () => {
-      this.listeners.delete(callback);
-    };
-  }
-
-  /**
-   * Get the last build result, or wait for the next one if none exists.
-   * Clears the cached result after returning, so subsequent calls wait for new builds.
-   */
-  waitFor(): Promise<BundleResult> {
-    if (this.lastResult) {
-      const result = this.lastResult;
-      this.lastResult = null;
-      return Promise.resolve(result);
-    }
-    return new Promise((resolve) => {
-      const unsub = this.on((result) => {
-        unsub();
-        this.lastResult = null;
-        resolve(result);
-      });
-    });
-  }
-}
-
-// Re-export for convenience
-export type { BundleResult } from "./bundler";
-export type { TypecheckResult } from "./typechecker";
-export type { SharedResources, TypesCache } from "./shared-resources";
-export type { PackageManifest, InstallResult } from "./packages";
-export { installPackage, uninstallPackage, listPackages, getPackageManifest } from "./packages";
-export { InMemoryTypesCache } from "./shared-resources";
-
-// Loader utilities
-export {
-  loadModule,
-  loadExport,
-  loadDefault,
-  getExportNames,
-  hasExport,
-  createModuleUrl,
-  revokeModuleUrl,
-  ModuleLoadError,
-  ExportNotFoundError,
-} from "./loader";
-
 /**
  * Options for creating a sandbox via the manager
  */
@@ -447,14 +374,6 @@ export class SandboxManager {
   getResources(): SharedResources | null {
     return this.resources;
   }
-
-  /**
-   * Get the shared lib files (for advanced use cases)
-   * @deprecated Use getResources().libFiles instead
-   */
-  getLibFiles(): Map<string, string> {
-    return this.resources?.libFiles ?? new Map();
-  }
 }
 
 /**