sandlot 0.2.1 → 0.2.3

package/dist/browser/preset.d.ts

@@ -2,7 +2,8 @@ import { type EsmTypesResolverOptions } from "../core/esm-types-resolver";
 import type { Sandlot, SandlotOptions } from "../types";
 import { type EsbuildWasmBundlerOptions } from "./bundler";
 import { type TypecheckerOptions } from "../core/typechecker";
-import { type MainThreadExecutorOptions } from "./executor";
+import { type MainThreadExecutorOptions } from "./main-thread-executor";
+import { type IframeExecutorOptions } from "./iframe-executor";
 export interface CreateBrowserSandlotOptions extends Omit<SandlotOptions, "bundler" | "typechecker" | "typesResolver" | "executor"> {
     /**
      * Custom bundler options, or a pre-configured bundler instance.
@@ -21,9 +22,13 @@ export interface CreateBrowserSandlotOptions extends Omit<SandlotOptions, "bundl
     /**
      * Custom executor options, or a pre-configured executor instance.
      * Set to `false` to disable execution (sandbox.run() will throw).
+     * Set to `"iframe"` to use IframeExecutor with default options.
      * Defaults to MainThreadExecutor.
+     *
+     * Note: IframeExecutor does NOT support shared modules. Use MainThreadExecutor
+     * (the default) if you need shared modules like React.
      */
-    executor?: MainThreadExecutorOptions | SandlotOptions["executor"] | false;
+    executor?: MainThreadExecutorOptions | IframeExecutorOptions | SandlotOptions["executor"] | "iframe" | false;
 }
 /**
  * Create a Sandlot instance pre-configured for browser environments.

package/dist/browser/preset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/browser/preset.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IACtF;;OAEG;IACH,OAAO,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAEhE;;;OAGG;IACH,WAAW,CAAC,EACV,kBAAkB,GAClB,cAAc,CAAC,aAAa,CAAC,GAC7B,KAAK,CAAC;IAER;;;OAGG;IACH,aAAa,CAAC,EACZ,uBAAuB,GACvB,cAAc,CAAC,eAAe,CAAC,GAC/B,KAAK,CAAC;IAER;;;;OAIG;IACH,QAAQ,CAAC,EACP,yBAAyB,GACzB,cAAc,CAAC,UAAU,CAAC,GAC1B,KAAK,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,OAAO,CAAC,CAgDlB"}
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/browser/preset.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IACtF;;OAEG;IACH,OAAO,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAEhE;;;OAGG;IACH,WAAW,CAAC,EACV,kBAAkB,GAClB,cAAc,CAAC,aAAa,CAAC,GAC7B,KAAK,CAAC;IAER;;;OAGG;IACH,aAAa,CAAC,EACZ,uBAAuB,GACvB,cAAc,CAAC,eAAe,CAAC,GAC/B,KAAK,CAAC;IAER;;;;;;;;OAQG;IACH,QAAQ,CAAC,EACP,yBAAyB,GACzB,qBAAqB,GACrB,cAAc,CAAC,UAAU,CAAC,GAC1B,QAAQ,GACR,KAAK,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,OAAO,CAAC,CAoDlB"}

package/dist/core/bundler-utils.d.ts

@@ -4,7 +4,7 @@
  * This module contains the VFS plugin, path resolution, and shared module
  * code generation logic that is common to both esbuild and esbuild-wasm.
  */
-import type { ISharedModuleRegistry, BundleWarning, BundleError, Filesystem } from "../types";
+import type { ISharedModuleRegistry, BundleOptions, BundleResult, BundleWarning, BundleError, Filesystem } from "../types";
 /**
  * Minimal esbuild types needed for the shared utilities.
  * These are compatible with both esbuild and esbuild-wasm.
@@ -139,4 +139,46 @@ export declare function getLoader(path: string): EsbuildLoader;
  * Generate JavaScript code that accesses a shared module at runtime.
  */
 export declare function generateSharedModuleCode(moduleId: string, registry: ISharedModuleRegistry | null): string;
+/**
+ * Minimal esbuild interface needed for bundling.
+ * Compatible with both esbuild and esbuild-wasm.
+ *
+ * Uses a loose `Record<string, unknown>` for build options to avoid
+ * type conflicts between the various esbuild module signatures.
+ */
+export interface EsbuildInstance {
+    build(options: Record<string, unknown>): Promise<{
+        outputFiles?: Array<{
+            text: string;
+        }>;
+        warnings: EsbuildMessage[];
+    }>;
+}
+/**
+ * Options for the shared bundle execution helper.
+ */
+export interface ExecuteBundleOptions {
+    /** The esbuild instance to use */
+    esbuild: EsbuildInstance;
+    /** Bundle options from the IBundler interface */
+    bundleOptions: BundleOptions;
+    /** Base URL for CDN imports */
+    cdnBaseUrl: string;
+    /**
+     * Whether to bundle CDN imports inline.
+     * - Browser: false (external) - browser can fetch at runtime
+     * - Node/Bun: true (bundle) - esbuild fetches during build
+     */
+    bundleCdnImports: boolean;
+}
+/**
+ * Execute a bundle using esbuild with the VFS plugin.
+ *
+ * This is the shared implementation used by both browser and node WASM bundlers.
+ * It handles entry point normalization, VFS plugin creation, and error handling.
+ *
+ * @param options - Bundle execution options
+ * @returns Bundle result with code or errors
+ */
+export declare function executeBundleWithEsbuild(options: ExecuteBundleOptions): Promise<BundleResult>;
 //# sourceMappingURL=bundler-utils.d.ts.map

package/dist/core/bundler-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler-utils.d.ts","sourceRoot":"","sources":["../../src/core/bundler-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,WAAW,EAEX,UAAU,EACX,MAAM,UAAU,CAAC;AAMlB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,CACT,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAC/H,IAAI,CAAC;IACV,MAAM,EAAE,CACN,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,iBAAiB,GAAG,IAAI,GAAG,SAAS,KACtH,IAAI,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,CAAC;AAMX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAOjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,GAClB,WAAW,GAAG,aAAa,CAgB7B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAUD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA6LxE;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,MAAM,GAAG,IAAI,CAmBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAsBA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,UAAU,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAkCf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAsB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAelD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAqBrD;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GACrC,MAAM,CAyCR"}
+{"version":3,"file":"bundler-utils.d.ts","sourceRoot":"","sources":["../../src/core/bundler-utils.ts"],"names":[],"mappings":"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"}

package/dist/core/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,UAAU,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,YAAY,EACxB,OAAO,GAAE,oBAAyB,GACjC,SAAS,CAwHX"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,UAAU,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,YAAY,EACxB,OAAO,GAAE,oBAAyB,GACjC,SAAS,CAyHX"}

package/dist/core/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/core/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,OAAO,EACP,cAAc,EAYf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAA6B,MAAM,MAAM,CAAC;AA2J7D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CA2ZlB"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/core/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,OAAO,EACP,cAAc,EAYf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAA6B,MAAM,MAAM,CAAC;AA2J7D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CA6elB"}

package/dist/core/sandlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandlot.d.ts","sourceRoot":"","sources":["../../src/core/sandlot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EAIf,MAAM,UAAU,CAAC;AAKlB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAsC9D"}
+{"version":3,"file":"sandlot.d.ts","sourceRoot":"","sources":["../../src/core/sandlot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EAIf,MAAM,UAAU,CAAC;AAKlB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CA6C9D"}

package/dist/index.js

@@ -1283,6 +1283,64 @@ async function createSandboxImpl(fs, options, context) {
   if (!fs.exists(TSCONFIG_PATH)) {
     fs.writeFile(TSCONFIG_PATH, JSON.stringify(DEFAULT_TSCONFIG, null, 2));
   }
+  if (sharedModuleRegistry && typesResolver) {
+    const sharedModuleIds = sharedModuleRegistry.list();
+    const typesFetches = sharedModuleIds.map(async (moduleId) => {
+      try {
+        const typeFiles = await typesResolver.resolveTypes(moduleId);
+        return { moduleId, typeFiles, error: null };
+      } catch (err) {
+        console.warn(`[sandlot] Failed to fetch types for shared module "${moduleId}":`, err);
+        return { moduleId, typeFiles: {}, error: err };
+      }
+    });
+    const results = await Promise.all(typesFetches);
+    for (const { moduleId, typeFiles } of results) {
+      if (Object.keys(typeFiles).length === 0)
+        continue;
+      let packageName = moduleId;
+      let subpath;
+      if (moduleId.startsWith("@")) {
+        const parts = moduleId.split("/");
+        if (parts.length >= 2) {
+          packageName = `${parts[0]}/${parts[1]}`;
+          subpath = parts.length > 2 ? parts.slice(2).join("/") : undefined;
+        }
+      } else {
+        const slashIndex = moduleId.indexOf("/");
+        if (slashIndex !== -1) {
+          packageName = moduleId.slice(0, slashIndex);
+          subpath = moduleId.slice(slashIndex + 1);
+        }
+      }
+      const packageDir = `/node_modules/${packageName}`;
+      let typesEntry = null;
+      let fallbackEntry = null;
+      for (const [filePath, content] of Object.entries(typeFiles)) {
+        const fullPath = filePath.startsWith("/") ? filePath : `${packageDir}/${filePath}`;
+        const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
+        ensureDir(fs, dir);
+        fs.writeFile(fullPath, content);
+        const relativePath = fullPath.replace(`${packageDir}/`, "");
+        if (relativePath === "index.d.ts") {
+          typesEntry = "index.d.ts";
+        } else if (!fallbackEntry && relativePath.endsWith(".d.ts") && !relativePath.includes("/")) {
+          fallbackEntry = relativePath;
+        }
+      }
+      const finalTypesEntry = typesEntry ?? fallbackEntry ?? "index.d.ts";
+      const pkgJsonPath = `${packageDir}/package.json`;
+      if (!fs.exists(pkgJsonPath)) {
+        const pkgJson = {
+          name: packageName,
+          version: "shared",
+          types: finalTypesEntry,
+          main: finalTypesEntry.replace(/\.d\.ts$/, ".js")
+        };
+        fs.writeFile(pkgJsonPath, JSON.stringify(pkgJson, null, 2));
+      }
+    }
+  }
   async function install(packageSpec) {
     const { name, version } = parsePackageSpec(packageSpec);
     let resolvedVersion = version ?? "latest";
@@ -1550,6 +1608,11 @@ function createSandlot(options) {
     },
     get sharedModules() {
       return sharedModuleRegistry;
+    },
+    async dispose() {
+      if (bundler.dispose) {
+        await bundler.dispose();
+      }
     }
   };
 }

package/dist/node/bundler.d.ts

@@ -39,6 +39,11 @@ export declare class EsbuildNativeBundler implements IBundler {
      */
     initialize(): Promise<void>;
     private getEsbuild;
+    /**
+     * Dispose of the esbuild service.
+     * This stops the esbuild child process and allows the Node.js process to exit.
+     */
+    dispose(): Promise<void>;
     bundle(options: BundleOptions): Promise<BundleResult>;
 }
 /**

package/dist/node/bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/node/bundler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EAGb,MAAM,UAAU,CAAC;AAOlB,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,OAAO,CAAoC;gBAEvC,OAAO,GAAE,2BAAgC;IAOrD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,OAAO,CAAC,UAAU;IAOZ,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA0G5D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,oBAAoB,CAEtB"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/node/bundler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGtE,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,OAAO,CAAoC;gBAEvC,OAAO,GAAE,2BAAgC;IAOrD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAY5D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,oBAAoB,CAEtB"}

package/dist/node/index.d.ts

@@ -1,5 +1,7 @@
 export { EsbuildNativeBundler, createEsbuildNativeBundler } from "./bundler";
 export type { EsbuildNativeBundlerOptions } from "./bundler";
+export { EsbuildWasmNodeBundler, createEsbuildWasmNodeBundler, } from "./wasm-bundler";
+export type { EsbuildWasmNodeBundlerOptions } from "./wasm-bundler";
 export { Typechecker, createTypechecker } from "../core/typechecker";
 export type { TypecheckerOptions } from "../core/typechecker";
 export { NodeExecutor, createNodeExecutor } from "./executor";

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAM7D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAM7D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAMpE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}

package/dist/node/index.js

@@ -319,6 +319,78 @@ function generateSharedModuleCode(moduleId, registry) {
   }
   return code;
 }
+async function executeBundleWithEsbuild(options) {
+  const { esbuild, bundleOptions, cdnBaseUrl, bundleCdnImports } = options;
+  const {
+    fs,
+    entryPoint,
+    installedPackages = {},
+    sharedModules = [],
+    sharedModuleRegistry,
+    external = [],
+    format = "esm",
+    minify = false,
+    sourcemap = false,
+    target = ["es2020"]
+  } = bundleOptions;
+  const normalizedEntry = entryPoint.startsWith("/") ? entryPoint : `/${entryPoint}`;
+  if (!fs.exists(normalizedEntry)) {
+    return {
+      success: false,
+      errors: [{ text: `Entry point not found: ${normalizedEntry}` }],
+      warnings: []
+    };
+  }
+  const includedFiles = new Set;
+  const plugin = createVfsPlugin({
+    fs,
+    entryPoint: normalizedEntry,
+    installedPackages,
+    sharedModules: new Set(sharedModules),
+    sharedModuleRegistry: sharedModuleRegistry ?? null,
+    cdnBaseUrl,
+    includedFiles,
+    bundleCdnImports
+  });
+  try {
+    const result = await esbuild.build({
+      entryPoints: [normalizedEntry],
+      bundle: true,
+      write: false,
+      format,
+      minify,
+      sourcemap: sourcemap ? "inline" : false,
+      target,
+      external,
+      plugins: [plugin],
+      jsx: "automatic"
+    });
+    const code = result.outputFiles?.[0]?.text ?? "";
+    const warnings = result.warnings.map((w) => convertEsbuildMessage(w));
+    return {
+      success: true,
+      code,
+      warnings,
+      includedFiles: Array.from(includedFiles)
+    };
+  } catch (err) {
+    if (isEsbuildBuildFailure(err)) {
+      const errors = err.errors.map((e) => convertEsbuildMessage(e));
+      const warnings = err.warnings.map((w) => convertEsbuildMessage(w));
+      return {
+        success: false,
+        errors,
+        warnings
+      };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      success: false,
+      errors: [{ text: message }],
+      warnings: []
+    };
+  }
+}
 
 // src/node/bundler.ts
 class EsbuildNativeBundler {
@@ -342,83 +414,97 @@ class EsbuildNativeBundler {
     }
     return this.esbuild;
   }
+  async dispose() {
+    if (this.esbuild) {
+      await this.esbuild.stop();
+      this.esbuild = null;
+    }
+  }
   async bundle(options) {
     await this.initialize();
-    const esbuild = this.getEsbuild();
-    const {
-      fs,
-      entryPoint,
-      installedPackages = {},
-      sharedModules = [],
-      sharedModuleRegistry,
-      external = [],
-      format = "esm",
-      minify = false,
-      sourcemap = false,
-      target = ["es2020"]
-    } = options;
-    const normalizedEntry = entryPoint.startsWith("/") ? entryPoint : `/${entryPoint}`;
-    if (!fs.exists(normalizedEntry)) {
-      return {
-        success: false,
-        errors: [{ text: `Entry point not found: ${normalizedEntry}` }],
-        warnings: []
-      };
-    }
-    const includedFiles = new Set;
-    const plugin = createVfsPlugin({
-      fs,
-      entryPoint: normalizedEntry,
-      installedPackages,
-      sharedModules: new Set(sharedModules),
-      sharedModuleRegistry: sharedModuleRegistry ?? null,
+    return executeBundleWithEsbuild({
+      esbuild: this.getEsbuild(),
+      bundleOptions: options,
       cdnBaseUrl: this.options.cdnBaseUrl,
-      includedFiles,
       bundleCdnImports: true
     });
-    try {
-      const result = await esbuild.build({
-        entryPoints: [normalizedEntry],
-        bundle: true,
-        write: false,
-        format,
-        minify,
-        sourcemap: sourcemap ? "inline" : false,
-        target,
-        external,
-        plugins: [plugin],
-        jsx: "automatic"
-      });
-      const code = result.outputFiles?.[0]?.text ?? "";
-      const warnings = result.warnings.map((w) => convertEsbuildMessage(w));
-      return {
-        success: true,
-        code,
-        warnings,
-        includedFiles: Array.from(includedFiles)
-      };
-    } catch (err) {
-      if (isEsbuildBuildFailure(err)) {
-        const errors = err.errors.map((e) => convertEsbuildMessage(e));
-        const warnings = err.warnings.map((w) => convertEsbuildMessage(w));
-        return {
-          success: false,
-          errors,
-          warnings
-        };
-      }
-      const message = err instanceof Error ? err.message : String(err);
-      return {
-        success: false,
-        errors: [{ text: message }],
-        warnings: []
-      };
-    }
   }
 }
 function createEsbuildNativeBundler(options) {
   return new EsbuildNativeBundler(options);
 }
+// src/node/wasm-bundler.ts
+var GLOBAL_KEY = "__sandlot_esbuild_wasm_node__";
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) {
+    g[GLOBAL_KEY] = {
+      esbuild: null,
+      initialized: false,
+      initPromise: null
+    };
+  }
+  return g[GLOBAL_KEY];
+}
+
+class EsbuildWasmNodeBundler {
+  options;
+  constructor(options = {}) {
+    this.options = {
+      cdnBaseUrl: "https://esm.sh",
+      ...options
+    };
+  }
+  async initialize() {
+    const state = getGlobalState();
+    if (state.initialized && state.esbuild) {
+      return;
+    }
+    if (state.initPromise) {
+      await state.initPromise;
+      return;
+    }
+    state.initPromise = this.doInitialize(state);
+    await state.initPromise;
+  }
+  async doInitialize(state) {
+    const esbuild = await import("esbuild-wasm");
+    if (typeof esbuild?.initialize !== "function") {
+      throw new Error("Failed to load esbuild-wasm: initialize function not found");
+    }
+    await esbuild.initialize({});
+    state.esbuild = esbuild;
+    state.initialized = true;
+  }
+  getEsbuild() {
+    const state = getGlobalState();
+    if (!state.esbuild) {
+      throw new Error("esbuild not initialized - call initialize() first");
+    }
+    return state.esbuild;
+  }
+  async dispose() {
+    const state = getGlobalState();
+    if (state.esbuild) {
+      await state.esbuild.stop();
+      state.esbuild = null;
+      state.initialized = false;
+      state.initPromise = null;
+    }
+  }
+  async bundle(options) {
+    await this.initialize();
+    return executeBundleWithEsbuild({
+      esbuild: this.getEsbuild(),
+      bundleOptions: options,
+      cdnBaseUrl: this.options.cdnBaseUrl,
+      bundleCdnImports: true
+    });
+  }
+}
+function createEsbuildWasmNodeBundler(options) {
+  return new EsbuildWasmNodeBundler(options);
+}
 // src/core/typechecker.ts
 import ts from "typescript";
 var TS_VERSION = "5.9.3";
@@ -771,23 +857,18 @@ function createBasicExecutor(loadModule, options = {}) {
       const formatArgs = (...args) => args.map((v) => typeof v === "object" ? JSON.stringify(v) : String(v)).join(" ");
       const captureLog = (...args) => {
         logs.push(formatArgs(...args));
-        originalConsole.log.apply(console, args);
       };
       const captureWarn = (...args) => {
         logs.push(`[warn] ${formatArgs(...args)}`);
-        originalConsole.warn.apply(console, args);
       };
       const captureError = (...args) => {
         logs.push(`[error] ${formatArgs(...args)}`);
-        originalConsole.error.apply(console, args);
       };
       const captureInfo = (...args) => {
         logs.push(`[info] ${formatArgs(...args)}`);
-        originalConsole.info.apply(console, args);
       };
       const captureDebug = (...args) => {
         logs.push(`[debug] ${formatArgs(...args)}`);
-        originalConsole.debug.apply(console, args);
       };
       const restoreConsole = () => {
         console.log = originalConsole.log;
@@ -814,10 +895,16 @@ function createBasicExecutor(loadModule, options = {}) {
           }
         };
         if (timeout > 0) {
+          let timeoutId;
           const timeoutPromise = new Promise((_, reject) => {
-            setTimeout(() => reject(new Error(`Execution timed out after ${timeout}ms`)), timeout);
+            timeoutId = setTimeout(() => reject(new Error(`Execution timed out after ${timeout}ms`)), timeout);
           });
-          await Promise.race([executeExport(), timeoutPromise]);
+          try {
+            await Promise.race([executeExport(), timeoutPromise]);
+          } finally {
+            if (timeoutId)
+              clearTimeout(timeoutId);
+          }
         } else {
           await executeExport();
         }
@@ -2148,6 +2235,64 @@ async function createSandboxImpl(fs, options, context) {
   if (!fs.exists(TSCONFIG_PATH)) {
     fs.writeFile(TSCONFIG_PATH, JSON.stringify(DEFAULT_TSCONFIG, null, 2));
   }
+  if (sharedModuleRegistry && typesResolver) {
+    const sharedModuleIds = sharedModuleRegistry.list();
+    const typesFetches = sharedModuleIds.map(async (moduleId) => {
+      try {
+        const typeFiles = await typesResolver.resolveTypes(moduleId);
+        return { moduleId, typeFiles, error: null };
+      } catch (err) {
+        console.warn(`[sandlot] Failed to fetch types for shared module "${moduleId}":`, err);
+        return { moduleId, typeFiles: {}, error: err };
+      }
+    });
+    const results = await Promise.all(typesFetches);
+    for (const { moduleId, typeFiles } of results) {
+      if (Object.keys(typeFiles).length === 0)
+        continue;
+      let packageName = moduleId;
+      let subpath;
+      if (moduleId.startsWith("@")) {
+        const parts = moduleId.split("/");
+        if (parts.length >= 2) {
+          packageName = `${parts[0]}/${parts[1]}`;
+          subpath = parts.length > 2 ? parts.slice(2).join("/") : undefined;
+        }
+      } else {
+        const slashIndex = moduleId.indexOf("/");
+        if (slashIndex !== -1) {
+          packageName = moduleId.slice(0, slashIndex);
+          subpath = moduleId.slice(slashIndex + 1);
+        }
+      }
+      const packageDir = `/node_modules/${packageName}`;
+      let typesEntry = null;
+      let fallbackEntry = null;
+      for (const [filePath, content] of Object.entries(typeFiles)) {
+        const fullPath = filePath.startsWith("/") ? filePath : `${packageDir}/${filePath}`;
+        const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
+        ensureDir(fs, dir);
+        fs.writeFile(fullPath, content);
+        const relativePath = fullPath.replace(`${packageDir}/`, "");
+        if (relativePath === "index.d.ts") {
+          typesEntry = "index.d.ts";
+        } else if (!fallbackEntry && relativePath.endsWith(".d.ts") && !relativePath.includes("/")) {
+          fallbackEntry = relativePath;
+        }
+      }
+      const finalTypesEntry = typesEntry ?? fallbackEntry ?? "index.d.ts";
+      const pkgJsonPath = `${packageDir}/package.json`;
+      if (!fs.exists(pkgJsonPath)) {
+        const pkgJson = {
+          name: packageName,
+          version: "shared",
+          types: finalTypesEntry,
+          main: finalTypesEntry.replace(/\.d\.ts$/, ".js")
+        };
+        fs.writeFile(pkgJsonPath, JSON.stringify(pkgJson, null, 2));
+      }
+    }
+  }
   async function install(packageSpec) {
     const { name, version } = parsePackageSpec(packageSpec);
     let resolvedVersion = version ?? "latest";
@@ -2415,6 +2560,11 @@ function createSandlot(options) {
     },
     get sharedModules() {
       return sharedModuleRegistry;
+    },
+    async dispose() {
+      if (bundler.dispose) {
+        await bundler.dispose();
+      }
     }
   };
 }
@@ -2608,7 +2758,7 @@ function escapeRegex(str) {
 // src/node/preset.ts
 async function createNodeSandlot(options = {}) {
   const { bundler, typechecker, typesResolver, executor, ...rest } = options;
-  const bundlerInstance = isBundler(bundler) ? bundler : new EsbuildNativeBundler(bundler);
+  const bundlerInstance = createBundlerInstance(bundler);
   await bundlerInstance.initialize();
   const typecheckerInstance = typechecker === false ? undefined : isTypechecker(typechecker) ? typechecker : new Typechecker(typechecker);
   const typesResolverInstance = typesResolver === false ? undefined : isTypesResolver(typesResolver) ? typesResolver : new EsmTypesResolver(typesResolver);
@@ -2621,6 +2771,22 @@ async function createNodeSandlot(options = {}) {
     executor: executorInstance
   });
 }
+function createBundlerInstance(bundler) {
+  if (isBundler(bundler)) {
+    return bundler;
+  }
+  if (bundler === "wasm") {
+    return new EsbuildWasmNodeBundler;
+  }
+  if (isWasmBundlerOptions(bundler)) {
+    const { wasm: _, ...wasmOptions } = bundler;
+    return new EsbuildWasmNodeBundler(wasmOptions);
+  }
+  return new EsbuildNativeBundler(bundler);
+}
+function isWasmBundlerOptions(value) {
+  return typeof value === "object" && value !== null && "wasm" in value && value.wasm === true;
+}
 function isBundler(value) {
   return typeof value === "object" && value !== null && "bundle" in value && typeof value.bundle === "function";
 }
@@ -2637,8 +2803,10 @@ export {
   createTypechecker,
   createNodeSandlot,
   createNodeExecutor,
+  createEsbuildWasmNodeBundler,
   createEsbuildNativeBundler,
   Typechecker,
   NodeExecutor,
+  EsbuildWasmNodeBundler,
   EsbuildNativeBundler
 };

package/dist/node/preset.d.ts

@@ -1,13 +1,21 @@
 import { type EsmTypesResolverOptions } from "../core/esm-types-resolver";
 import type { Sandlot, SandlotOptions } from "../types";
 import { type EsbuildNativeBundlerOptions } from "./bundler";
+import { type EsbuildWasmNodeBundlerOptions } from "./wasm-bundler";
 import { type TypecheckerOptions } from "../core/typechecker";
 import { type NodeExecutorOptions } from "./executor";
 export interface CreateNodeSandlotOptions extends Omit<SandlotOptions, "bundler" | "typechecker" | "typesResolver" | "executor"> {
     /**
      * Custom bundler options, or a pre-configured bundler instance.
+     *
+     * Set to `"wasm"` to use the WASM bundler (for testing consistency with browser).
+     * You can also pass `{ wasm: true, ...options }` for WASM bundler with custom options.
+     *
+     * @default EsbuildNativeBundler (fastest, uses native esbuild binary)
      */
-    bundler?: EsbuildNativeBundlerOptions | SandlotOptions["bundler"];
+    bundler?: EsbuildNativeBundlerOptions | (EsbuildWasmNodeBundlerOptions & {
+        wasm: true;
+    }) | SandlotOptions["bundler"] | "wasm";
     /**
      * Custom typechecker options, or a pre-configured typechecker instance.
      * Set to `false` to disable type checking.
@@ -57,6 +65,13 @@ export interface CreateNodeSandlotOptions extends Omit<SandlotOptions, "bundler"
  *   typechecker: false,
  * });
  * ```
+ *
+ * @example Use WASM bundler for testing consistency with browser
+ * ```ts
+ * const sandlot = await createNodeSandlot({
+ *   bundler: "wasm",
+ * });
+ * ```
  */
 export declare function createNodeSandlot(options?: CreateNodeSandlotOptions): Promise<Sandlot>;
 //# sourceMappingURL=preset.d.ts.map