sandlot 0.2.1 → 0.2.3

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

@@ -1 +1 @@
-{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/node/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,EAAwB,KAAK,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IACtF;;OAEG;IACH,OAAO,CAAC,EAAE,2BAA2B,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAElE;;;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,mBAAmB,GACnB,cAAc,CAAC,UAAU,CAAC,GAC1B,KAAK,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,CAgDlB"}
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/node/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,EAAwB,KAAK,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IACtF;;;;;;;OAOG;IACH,OAAO,CAAC,EACJ,2BAA2B,GAC3B,CAAC,6BAA6B,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,GAChD,cAAc,CAAC,SAAS,CAAC,GACzB,MAAM,CAAC;IAEX;;;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,mBAAmB,GACnB,cAAc,CAAC,UAAU,CAAC,GAC1B,KAAK,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,CA8ClB"}

package/dist/node/wasm-bundler.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Node/Bun/Deno bundler implementation using esbuild-wasm.
+ *
+ * This bundler uses the same WebAssembly-based esbuild as the browser bundler,
+ * but runs in Node.js/Bun/Deno environments. It's primarily useful for:
+ *
+ * 1. Testing consistency with the browser bundler
+ * 2. Ensuring identical import resolution behavior
+ * 3. Validating that bundled output matches between browser and server
+ *
+ * For production use, prefer EsbuildNativeBundler which is ~3-5x faster.
+ */
+import type { IBundler, BundleOptions, BundleResult } from "../types";
+export interface EsbuildWasmNodeBundlerOptions {
+    /**
+     * Base URL for CDN imports.
+     * npm imports like "lodash" are rewritten to "{cdnBaseUrl}/lodash@{version}".
+     * @default "https://esm.sh"
+     */
+    cdnBaseUrl?: string;
+}
+/**
+ * Bundler implementation using esbuild-wasm for Node.js/Bun/Deno.
+ *
+ * Uses the same WebAssembly-based esbuild as the browser bundler,
+ * making it ideal for testing consistency between browser and server builds.
+ *
+ * @example
+ * ```ts
+ * const bundler = new EsbuildWasmNodeBundler();
+ * await bundler.initialize();
+ *
+ * const result = await bundler.bundle({
+ *   fs: myFilesystem,
+ *   entryPoint: "/src/index.ts",
+ * });
+ * ```
+ *
+ * @example Testing consistency with native bundler
+ * ```ts
+ * const native = new EsbuildNativeBundler();
+ * const wasm = new EsbuildWasmNodeBundler();
+ *
+ * await native.initialize();
+ * await wasm.initialize();
+ *
+ * const nativeResult = await native.bundle(options);
+ * const wasmResult = await wasm.bundle(options);
+ *
+ * // Results should be equivalent (modulo minor formatting differences)
+ * ```
+ */
+export declare class EsbuildWasmNodeBundler implements IBundler {
+    private options;
+    constructor(options?: EsbuildWasmNodeBundlerOptions);
+    /**
+     * Initialize the esbuild WASM module.
+     * Called automatically on first bundle() if not already initialized.
+     *
+     * Uses a global singleton pattern since esbuild-wasm can only be
+     * initialized once per process.
+     */
+    initialize(): Promise<void>;
+    private doInitialize;
+    /**
+     * Get the initialized esbuild instance.
+     */
+    private getEsbuild;
+    /**
+     * Dispose of the esbuild WASM service.
+     * This stops the esbuild service and allows the process to exit.
+     *
+     * Note: Since esbuild-wasm uses a global singleton, this affects all
+     * instances. After dispose(), you'll need to create a new bundler.
+     */
+    dispose(): Promise<void>;
+    bundle(options: BundleOptions): Promise<BundleResult>;
+}
+/**
+ * Create an esbuild-wasm bundler for Node.js/Bun/Deno.
+ *
+ * This is primarily useful for testing consistency with the browser bundler.
+ * For production use, prefer createEsbuildNativeBundler() which is ~3-5x faster.
+ */
+export declare function createEsbuildWasmNodeBundler(options?: EsbuildWasmNodeBundlerOptions): EsbuildWasmNodeBundler;
+//# sourceMappingURL=wasm-bundler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-bundler.d.ts","sourceRoot":"","sources":["../../src/node/wasm-bundler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAgCtE,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,sBAAuB,YAAW,QAAQ;IACrD,OAAO,CAAC,OAAO,CAAgC;gBAEnC,OAAO,GAAE,6BAAkC;IAOvD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBnB,YAAY;IAoB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAY5D;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CAExB"}

package/dist/types.d.ts

@@ -11,6 +11,11 @@ export interface IBundler {
      * Bundle source files from a filesystem into a single output
      */
     bundle(options: BundleOptions): Promise<BundleResult>;
+    /**
+     * Dispose of resources held by the bundler (optional).
+     * Called by Sandlot.dispose() to clean up background services.
+     */
+    dispose?(): Promise<void>;
 }
 export interface BundleOptions {
     fs: Filesystem;
@@ -524,5 +529,25 @@ export interface Sandlot {
      * The shared module registry (if shared modules were provided)
      */
     readonly sharedModules: ISharedModuleRegistry | null;
+    /**
+     * Dispose of resources held by this Sandlot instance.
+     *
+     * This should be called when you're done using Sandlot to allow
+     * the process to exit cleanly. It stops any background services
+     * like the esbuild child process.
+     *
+     * After calling dispose(), this instance should not be used.
+     *
+     * @example
+     * ```ts
+     * const sandlot = await createNodeSandlot();
+     * const sandbox = await sandlot.createSandbox();
+     *
+     * // ... do work ...
+     *
+     * await sandlot.dispose(); // Allow process to exit
+     * ```
+     */
+    dispose(): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandlot",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "TypeScript sandbox with esbuild bundling and type checking for browser and server",
   "author": "blindmansion",
   "repository": {

package/src/browser/bundler.ts

@@ -6,18 +6,8 @@
  */
 
 import type * as EsbuildTypes from "esbuild-wasm";
-import type {
-  IBundler,
-  BundleOptions,
-  BundleResult,
-  BundleWarning,
-  BundleError,
-} from "../types";
-import {
-  createVfsPlugin,
-  isEsbuildBuildFailure,
-  convertEsbuildMessage,
-} from "../core/bundler-utils";
+import type { IBundler, BundleOptions, BundleResult } from "../types";
+import { executeBundleWithEsbuild } from "../core/bundler-utils";
 
 /**
  * esbuild-wasm version - should match what's in package.json
@@ -177,6 +167,23 @@ export class EsbuildWasmBundler implements IBundler {
     return state.esbuild;
   }
 
+  /**
+   * Dispose of the esbuild WASM service.
+   * This stops the esbuild service and allows the process to exit.
+   * 
+   * Note: Since esbuild-wasm uses a global singleton, this affects all
+   * instances. After dispose(), you'll need to create a new bundler.
+   */
+  async dispose(): Promise<void> {
+    const state = getGlobalState();
+    if (state.esbuild) {
+      await state.esbuild.stop();
+      state.esbuild = null;
+      state.initialized = false;
+      state.initPromise = null;
+    }
+  }
+
   private checkCrossOriginIsolation(): void {
     if (typeof window === "undefined") return;
 
@@ -194,101 +201,11 @@ export class EsbuildWasmBundler implements IBundler {
   async bundle(options: BundleOptions): Promise<BundleResult> {
     await this.initialize();
 
-    const esbuild = this.getEsbuild();
-
-    const {
-      fs,
-      entryPoint,
-      installedPackages = {},
-      sharedModules = [],
-      sharedModuleRegistry,
-      external = [],
-      format = "esm",
-      minify = false,
-      sourcemap = false,
-      target = ["es2020"],
-    } = options;
-
-    // Normalize entry point to absolute path
-    const normalizedEntry = entryPoint.startsWith("/")
-      ? entryPoint
-      : `/${entryPoint}`;
-
-    // Verify entry point exists
-    if (!fs.exists(normalizedEntry)) {
-      return {
-        success: false,
-        errors: [{ text: `Entry point not found: ${normalizedEntry}` }],
-        warnings: [],
-      };
-    }
-
-    // Track files included in the bundle
-    const includedFiles = new Set<string>();
-
-    // Create the VFS plugin
-    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: false, // Browser can fetch CDN imports at runtime
     });
-
-    try {
-      // Run esbuild
-      const result = await esbuild.build({
-        entryPoints: [normalizedEntry],
-        bundle: true,
-        write: false,
-        format,
-        minify,
-        sourcemap: sourcemap ? "inline" : false,
-        target,
-        external,
-        // Cast to esbuild's Plugin type since our minimal interface is compatible
-        plugins: [plugin as EsbuildTypes.Plugin],
-        jsx: "automatic",
-      });
-
-      const code = result.outputFiles?.[0]?.text ?? "";
-
-      // Convert esbuild warnings to our format
-      const warnings: BundleWarning[] = result.warnings.map((w) =>
-        convertEsbuildMessage(w)
-      );
-
-      return {
-        success: true,
-        code,
-        warnings,
-        includedFiles: Array.from(includedFiles),
-      };
-    } catch (err) {
-      // esbuild throws BuildFailure with .errors array
-      if (isEsbuildBuildFailure(err)) {
-        const errors: BundleError[] = err.errors.map((e) =>
-          convertEsbuildMessage(e)
-        );
-        const warnings: BundleWarning[] = err.warnings.map((w) =>
-          convertEsbuildMessage(w)
-        );
-        return {
-          success: false,
-          errors,
-          warnings,
-        };
-      }
-
-      // Unknown error - wrap it
-      const message = err instanceof Error ? err.message : String(err);
-      return {
-        success: false,
-        errors: [{ text: message }],
-        warnings: [],
-      };
-    }
   }
 }

package/src/browser/iframe-executor.ts

@@ -0,0 +1,320 @@
+/**
+ * Iframe executor for browser environments.
+ *
+ * This executor runs code in a sandboxed iframe, providing DOM isolation
+ * and configurable security policies via the sandbox attribute.
+ *
+ * Key characteristics:
+ * - Per-execution lifecycle: fresh iframe for each execute() call
+ * - Configurable sandbox attributes (default: allow-scripts only)
+ * - No shared module support (use MainThreadExecutor for that)
+ * - Communication via postMessage
+ */
+
+import type { IExecutor, ExecuteOptions, ExecuteResult } from "../types";
+
+/**
+ * Options for creating an IframeExecutor.
+ */
+export interface IframeExecutorOptions {
+  /**
+   * Sandbox attributes for the iframe.
+   * @default ["allow-scripts"]
+   *
+   * Common options:
+   * - "allow-scripts": Required for code execution
+   * - "allow-same-origin": Enables localStorage, cookies (reduces isolation)
+   * - "allow-modals": Enables alert/confirm/prompt
+   *
+   * Security note: "allow-scripts" + "allow-same-origin" together allows
+   * the iframe code to potentially remove the sandbox via script.
+   */
+  sandbox?: string[];
+
+  /**
+   * Default timeout in milliseconds.
+   * @default 30000
+   */
+  defaultTimeout?: number;
+
+  /**
+   * Container element for iframes.
+   * Iframes are created hidden (display: none).
+   * @default document.body
+   */
+  container?: HTMLElement;
+}
+
+/**
+ * Message types for parent -> iframe communication.
+ */
+interface ExecuteMessage {
+  type: "execute";
+  code: string;
+  entryExport: "main" | "default";
+  context: Record<string, unknown>;
+}
+
+/**
+ * Message types for iframe -> parent communication.
+ */
+interface LogMessage {
+  type: "log";
+  level: "log" | "warn" | "error" | "info" | "debug";
+  args: string;
+}
+
+interface ResultMessage {
+  type: "result";
+  success: boolean;
+  returnValue?: unknown;
+  error?: string;
+}
+
+interface ReadyMessage {
+  type: "ready";
+}
+
+type IframeMessage = LogMessage | ResultMessage | ReadyMessage;
+
+/**
+ * Bootstrap HTML that runs inside the iframe.
+ * This is injected via srcdoc and handles:
+ * 1. Console capture and forwarding
+ * 2. Code execution via Blob URL import
+ * 3. Result reporting back to parent
+ */
+const BOOTSTRAP_HTML = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+</head>
+<body>
+<script type="module">
+// Capture console methods and forward to parent
+function formatArgs(...args) {
+  return args
+    .map(v => typeof v === "object" ? JSON.stringify(v) : String(v))
+    .join(" ");
+}
+
+function createLogger(level) {
+  return (...args) => {
+    parent.postMessage({ type: "log", level, args: formatArgs(...args) }, "*");
+  };
+}
+
+console.log = createLogger("log");
+console.warn = createLogger("warn");
+console.error = createLogger("error");
+console.info = createLogger("info");
+console.debug = createLogger("debug");
+
+// Handle unhandled promise rejections
+window.addEventListener("unhandledrejection", (event) => {
+  const message = event.reason instanceof Error 
+    ? event.reason.message 
+    : String(event.reason);
+  parent.postMessage({ 
+    type: "result", 
+    success: false, 
+    error: "Unhandled promise rejection: " + message 
+  }, "*");
+});
+
+// Handle uncaught errors
+window.addEventListener("error", (event) => {
+  parent.postMessage({ 
+    type: "result", 
+    success: false, 
+    error: event.message || "Unknown error" 
+  }, "*");
+});
+
+// Listen for execute messages from parent
+window.addEventListener("message", async (event) => {
+  if (event.data?.type !== "execute") return;
+
+  const { code, entryExport, context } = event.data;
+
+  try {
+    // Create Blob URL and import as ESM module
+    const blob = new Blob([code], { type: "application/javascript" });
+    const url = URL.createObjectURL(blob);
+    
+    let module;
+    try {
+      module = await import(url);
+    } finally {
+      URL.revokeObjectURL(url);
+    }
+
+    // Execute the appropriate export
+    let returnValue;
+
+    if (entryExport === "main" && typeof module.main === "function") {
+      returnValue = await module.main(context);
+    } else if (entryExport === "default" && typeof module.default === "function") {
+      returnValue = await module.default();
+    } else if (entryExport === "default" && module.default !== undefined) {
+      returnValue = module.default;
+    }
+    // If neither export exists, top-level code already ran on import
+
+    parent.postMessage({ type: "result", success: true, returnValue }, "*");
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    parent.postMessage({ type: "result", success: false, error: message }, "*");
+  }
+});
+
+// Signal that we're ready to receive code
+parent.postMessage({ type: "ready" }, "*");
+<\/script>
+</body>
+</html>`;
+
+/**
+ * Executor that runs code in a sandboxed iframe.
+ *
+ * Each execute() call creates a fresh iframe, runs the code, and destroys
+ * the iframe. This provides clean isolation between executions.
+ *
+ * Note: This executor does NOT support shared modules. The iframe runs
+ * in complete isolation. Use MainThreadExecutor if you need shared modules.
+ *
+ * @example
+ * ```ts
+ * // Default: strict sandboxing (allow-scripts only)
+ * const executor = createIframeExecutor();
+ *
+ * // With additional permissions
+ * const executor = createIframeExecutor({
+ *   sandbox: ["allow-scripts", "allow-same-origin"],
+ * });
+ *
+ * const result = await executor.execute(bundledCode, {
+ *   entryExport: 'main',
+ *   context: { args: ['--verbose'] },
+ *   timeout: 5000,
+ * });
+ * console.log(result.logs);
+ * ```
+ */
+export class IframeExecutor implements IExecutor {
+  private options: Required<Omit<IframeExecutorOptions, "container">> & {
+    container?: HTMLElement;
+  };
+
+  constructor(options: IframeExecutorOptions = {}) {
+    this.options = {
+      sandbox: options.sandbox ?? ["allow-scripts"],
+      defaultTimeout: options.defaultTimeout ?? 30000,
+      container: options.container,
+    };
+  }
+
+  async execute(code: string, options: ExecuteOptions = {}): Promise<ExecuteResult> {
+    const {
+      entryExport = "main",
+      context = {},
+      timeout = this.options.defaultTimeout,
+    } = options;
+
+    const startTime = performance.now();
+    const logs: string[] = [];
+
+    // Get container (default to document.body)
+    const container = this.options.container ?? document.body;
+
+    // Create iframe
+    const iframe = document.createElement("iframe");
+    iframe.style.display = "none";
+    iframe.sandbox.add(...this.options.sandbox);
+    iframe.srcdoc = BOOTSTRAP_HTML;
+
+    // Track whether we've received a result
+    let resolved = false;
+
+    return new Promise<ExecuteResult>((resolve) => {
+      const cleanup = () => {
+        if (iframe.parentNode) {
+          iframe.parentNode.removeChild(iframe);
+        }
+        window.removeEventListener("message", handleMessage);
+        if (timeoutId) clearTimeout(timeoutId);
+      };
+
+      const finish = (result: ExecuteResult) => {
+        if (resolved) return;
+        resolved = true;
+        cleanup();
+        resolve(result);
+      };
+
+      // Handle messages from iframe
+      const handleMessage = (event: MessageEvent) => {
+        // Verify message is from our iframe
+        if (event.source !== iframe.contentWindow) return;
+
+        const data = event.data as IframeMessage;
+
+        if (data.type === "log") {
+          const prefix =
+            data.level === "log" ? "" : `[${data.level}] `;
+          logs.push(prefix + data.args);
+        } else if (data.type === "result") {
+          const executionTimeMs = performance.now() - startTime;
+          finish({
+            success: data.success,
+            logs,
+            returnValue: data.returnValue,
+            error: data.error,
+            executionTimeMs,
+          });
+        } else if (data.type === "ready") {
+          // Iframe is ready, send the code to execute
+          const message: ExecuteMessage = {
+            type: "execute",
+            code,
+            entryExport,
+            context,
+          };
+          iframe.contentWindow?.postMessage(message, "*");
+        }
+      };
+
+      // Set up timeout
+      let timeoutId: ReturnType<typeof setTimeout> | undefined;
+      if (timeout > 0) {
+        timeoutId = setTimeout(() => {
+          const executionTimeMs = performance.now() - startTime;
+          finish({
+            success: false,
+            logs,
+            error: `Execution timed out after ${timeout}ms`,
+            executionTimeMs,
+          });
+        }, timeout);
+      }
+
+      // Listen for messages
+      window.addEventListener("message", handleMessage);
+
+      // Append iframe to DOM (this starts loading the srcdoc)
+      container.appendChild(iframe);
+    });
+  }
+}
+
+/**
+ * Create an iframe executor.
+ *
+ * @param options - Executor options
+ * @returns A new IframeExecutor instance
+ */
+export function createIframeExecutor(
+  options?: IframeExecutorOptions
+): IframeExecutor {
+  return new IframeExecutor(options);
+}

package/src/browser/index.ts

@@ -46,8 +46,15 @@ export type { EsbuildWasmBundlerOptions } from "./bundler";
 // Executor (browser-specific: runs in main thread)
 // -----------------------------------------------------------------------------
 
-export { MainThreadExecutor, createMainThreadExecutor } from "./executor";
-export type { MainThreadExecutorOptions } from "./executor";
+export { MainThreadExecutor, createMainThreadExecutor } from "./main-thread-executor";
+export type { MainThreadExecutorOptions } from "./main-thread-executor";
+
+// -----------------------------------------------------------------------------
+// Iframe Executor (browser-specific: runs in sandboxed iframe)
+// -----------------------------------------------------------------------------
+
+export { IframeExecutor, createIframeExecutor } from "./iframe-executor";
+export type { IframeExecutorOptions } from "./iframe-executor";
 
 // -----------------------------------------------------------------------------
 // Convenience Preset