sandlot 0.1.4 → 0.2.1

package/dist/browser/bundler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Browser bundler implementation using esbuild-wasm.
+ *
+ * This module handles WASM initialization and provides a bundler that
+ * works entirely in the browser.
+ */
+import type { IBundler, BundleOptions, BundleResult } from "../types";
+export interface EsbuildWasmBundlerOptions {
+    /**
+     * URL to the esbuild WASM file.
+     * @default "https://unpkg.com/esbuild-wasm@{version}/esbuild.wasm"
+     */
+    wasmUrl?: string;
+    /**
+     * URL to load esbuild-wasm module from.
+     * @default "https://esm.sh/esbuild-wasm@{version}"
+     */
+    esbuildUrl?: string;
+    /**
+     * Base URL for CDN imports.
+     * npm imports like "lodash" are rewritten to "{cdnBaseUrl}/lodash@{version}".
+     * @default "https://esm.sh"
+     */
+    cdnBaseUrl?: string;
+    /**
+     * Whether to initialize immediately on construction.
+     * If false, initialization happens lazily on first bundle() call.
+     * @default false
+     */
+    eagerInit?: boolean;
+}
+/**
+ * Browser bundler implementation using esbuild-wasm.
+ *
+ * Handles WASM initialization internally. The first bundle() call
+ * will wait for initialization if not already complete.
+ *
+ * @example
+ * ```ts
+ * const bundler = new EsbuildWasmBundler();
+ * await bundler.initialize();
+ *
+ * const result = await bundler.bundle({
+ *   fs: myFilesystem,
+ *   entryPoint: "/src/index.ts",
+ * });
+ * ```
+ */
+export declare class EsbuildWasmBundler implements IBundler {
+    private options;
+    constructor(options?: EsbuildWasmBundlerOptions);
+    /**
+     * 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 page.
+     */
+    initialize(): Promise<void>;
+    private doInitialize;
+    /**
+     * Get the initialized esbuild instance.
+     */
+    private getEsbuild;
+    private checkCrossOriginIsolation;
+    bundle(options: BundleOptions): Promise<BundleResult>;
+}
+//# sourceMappingURL=bundler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/browser/bundler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EAGb,MAAM,UAAU,CAAC;AAuClB,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,GAAE,yBAA8B;IAWnD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBnB,YAAY;IA8B1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,yBAAyB;IAc3B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAoG5D"}

package/dist/browser/executor.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Main thread executor for browser environments.
+ *
+ * This executor runs code directly in the main thread. It provides no
+ * isolation from the host environment - use only for trusted code.
+ *
+ * For untrusted code, consider using a Worker or iframe-based executor
+ * that provides proper sandboxing.
+ */
+import type { IExecutor } from "../types";
+import { type BasicExecutorOptions } from "../core/executor";
+/**
+ * Options for creating a MainThreadExecutor.
+ */
+export type MainThreadExecutorOptions = BasicExecutorOptions;
+/**
+ * Executor that runs code in the main browser thread.
+ *
+ * WARNING: This executor provides NO isolation. The executed code has
+ * full access to the page's DOM, global variables, and network.
+ * Only use for trusted code (e.g., code you're developing).
+ *
+ * @example
+ * ```ts
+ * const executor = createMainThreadExecutor();
+ * const result = await executor.execute(bundledCode, {
+ *   entryExport: 'main',
+ *   context: { args: ['--verbose'] },
+ *   timeout: 5000,
+ * });
+ * console.log(result.logs);
+ * ```
+ */
+export declare class MainThreadExecutor implements IExecutor {
+    private executor;
+    constructor(options?: MainThreadExecutorOptions);
+    execute: IExecutor["execute"];
+}
+/**
+ * Create a main thread executor.
+ *
+ * @param options - Executor options
+ * @returns A new MainThreadExecutor instance
+ */
+export declare function createMainThreadExecutor(options?: MainThreadExecutorOptions): MainThreadExecutor;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/browser/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAgB7D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,QAAQ,CAAY;gBAEhB,OAAO,GAAE,yBAA8B;IAInD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAA+C;CAC7E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,yBAAyB,GAClC,kBAAkB,CAEpB"}

package/dist/browser/index.d.ts

@@ -0,0 +1,9 @@
+export { Typechecker, createTypechecker } from "../core/typechecker";
+export type { TypecheckerOptions } from "../core/typechecker";
+export { EsbuildWasmBundler } from "./bundler";
+export type { EsbuildWasmBundlerOptions } from "./bundler";
+export { MainThreadExecutor, createMainThreadExecutor } from "./executor";
+export type { MainThreadExecutorOptions } from "./executor";
+export { createBrowserSandlot } from "./preset";
+export type { CreateBrowserSandlotOptions } from "./preset";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAM3D,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC"}