sandlot 0.1.4 → 0.2.0

package/dist/browser/preset.d.ts

@@ -0,0 +1,63 @@
+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";
+export interface CreateBrowserSandlotOptions extends Omit<SandlotOptions, "bundler" | "typechecker" | "typesResolver" | "executor"> {
+    /**
+     * Custom bundler options, or a pre-configured bundler instance.
+     */
+    bundler?: EsbuildWasmBundlerOptions | SandlotOptions["bundler"];
+    /**
+     * Custom typechecker options, or a pre-configured typechecker instance.
+     * Set to `false` to disable type checking.
+     */
+    typechecker?: TypecheckerOptions | SandlotOptions["typechecker"] | false;
+    /**
+     * Custom types resolver options, or a pre-configured resolver instance.
+     * Set to `false` to disable type resolution.
+     */
+    typesResolver?: EsmTypesResolverOptions | SandlotOptions["typesResolver"] | false;
+    /**
+     * Custom executor options, or a pre-configured executor instance.
+     * Set to `false` to disable execution (sandbox.run() will throw).
+     * Defaults to MainThreadExecutor.
+     */
+    executor?: MainThreadExecutorOptions | SandlotOptions["executor"] | false;
+}
+/**
+ * Create a Sandlot instance pre-configured for browser environments.
+ *
+ * This is a convenience function that sets up sensible defaults:
+ * - EsbuildWasmBundler for bundling
+ * - Typechecker for type checking
+ * - FetchTypesResolver for npm type resolution
+ *
+ * @example Basic usage
+ * ```ts
+ * const sandlot = await createBrowserSandlot();
+ * const sandbox = await sandlot.createSandbox();
+ * ```
+ *
+ * @example With shared modules
+ * ```ts
+ * import React from "react";
+ * import ReactDOM from "react-dom/client";
+ *
+ * const sandlot = await createBrowserSandlot({
+ *   sharedModules: {
+ *     react: React,
+ *     "react-dom/client": ReactDOM,
+ *   },
+ * });
+ * ```
+ *
+ * @example Disable type checking for faster builds
+ * ```ts
+ * const sandlot = await createBrowserSandlot({
+ *   typechecker: false,
+ * });
+ * ```
+ */
+export declare function createBrowserSandlot(options?: CreateBrowserSandlotOptions): Promise<Sandlot>;
+//# sourceMappingURL=preset.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/index.d.ts

@@ -1,17 +1,26 @@
 /**
- * Command factories for sandbox bash environments.
+ * Command factories for v2 sandbox bash environments.
  *
- * Pure factories that create commands for type checking, bundling,
- * package management, and code execution.
- * No global state - all dependencies are passed in explicitly.
+ * Provides a `sandlot` command with subcommands:
+ *   - sandlot build     Build the project
+ *   - sandlot typecheck Type check without building
+ *   - sandlot install   Install packages
+ *   - sandlot uninstall Remove packages
+ *   - sandlot help      Show help
  */
-export { type CommandDeps, type BuildOutput, type ValidateFn, type RunContext, type RunOptions, type RunResult, formatEsbuildMessages, } from "./types";
-export { createTscCommand, createBuildCommand } from "./compile";
-export { createInstallCommand, createUninstallCommand, createListCommand, } from "./packages";
-export { createRunCommand } from "./run";
-import type { CommandDeps } from "./types";
+import type { SandboxRef } from "./types";
+export type { SandboxRef } from "./types";
+export { formatSize, formatDiagnostics, formatBundleErrors } from "./types";
 /**
- * Create all default sandbox commands
+ * Create the main `sandlot` command with all subcommands.
+ *
+ * The sandlot command is a dispatcher that routes to subcommand handlers.
+ */
+export declare function createSandlotCommand(sandboxRef: SandboxRef): import("just-bash/browser").Command;
+/**
+ * Create all default sandbox commands.
+ *
+ * Currently just the `sandlot` command which dispatches to subcommands.
  */
-export declare function createDefaultCommands(deps: CommandDeps): import("just-bash/browser").Command[];
+export declare function createDefaultCommands(sandboxRef: SandboxRef): import("just-bash/browser").Command[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,yCAStD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,uCAuC1D;AAkdD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,yCAE3D"}

package/dist/commands/types.d.ts

@@ -1,141 +1,40 @@
 /**
- * Types and utilities for sandbox bash commands.
- */
-import type { IFileSystem } from "just-bash/browser";
-import type { BundleResult } from "../bundler";
-import type { TypesCache } from "../packages";
-/**
- * The result of a successful build, including the bundle and loaded module.
- */
-export interface BuildOutput {
-    /**
-     * The compiled bundle (code, metadata, etc.)
-     */
-    bundle: BundleResult;
-    /**
-     * The loaded module exports.
-     * If validation was provided, this is the validated module.
-     */
-    module: Record<string, unknown>;
+ * Types and utilities for v2 sandbox bash commands.
+ *
+ * Commands wrap the sandbox's direct methods to provide a shell interface.
+ * This ensures consistency between `sandbox.build()` and `sandbox.exec('sandlot build')`.
+ */
+import type { Filesystem, InstallResult, UninstallResult, BuildResult, TypecheckResult, SandboxBuildOptions, SandboxTypecheckOptions, RunOptions, RunResult, BundleError, Diagnostic } from "../types";
+/**
+ * Reference to sandbox methods that commands can call.
+ *
+ * Commands receive this interface rather than raw dependencies,
+ * ensuring they use the same logic as direct API calls.
+ */
+export interface SandboxRef {
+    /** The virtual filesystem */
+    readonly fs: Filesystem;
+    /** Install a package */
+    install(packageSpec: string): Promise<InstallResult>;
+    /** Uninstall a package */
+    uninstall(packageName: string): Promise<UninstallResult>;
+    /** Build the project */
+    build(options?: SandboxBuildOptions): Promise<BuildResult>;
+    /** Type check the project */
+    typecheck(options?: SandboxTypecheckOptions): Promise<TypecheckResult>;
+    /** Run code (build + execute) */
+    run(options?: RunOptions): Promise<RunResult>;
 }
 /**
- * Validation function type for module validation.
- * Takes the raw module exports and returns validated exports (or throws).
+ * Format a file size in bytes to a human-readable string
  */
-export type ValidateFn = (module: Record<string, unknown>) => Record<string, unknown>;
+export declare function formatSize(bytes: number): string;
 /**
- * Dependencies required by command factories
+ * Format diagnostics for shell output
  */
-export interface CommandDeps {
-    /**
-     * The virtual filesystem to operate on
-     */
-    fs: IFileSystem;
-    /**
-     * Pre-loaded TypeScript lib files for type checking
-     */
-    libFiles: Map<string, string>;
-    /**
-     * Path to tsconfig.json in the virtual filesystem
-     */
-    tsconfigPath: string;
-    /**
-     * Callback invoked when a build succeeds (after loading and validation).
-     */
-    onBuild?: (result: BuildOutput) => void | Promise<void>;
-    /**
-     * Getter for the current validation function.
-     * Called during build to check if validation should be performed.
-     */
-    getValidation?: () => ValidateFn | null;
-    /**
-     * Cache for package type definitions.
-     * When provided, avoids redundant network fetches for packages
-     * that have already been installed in other sandboxes.
-     */
-    typesCache?: TypesCache;
-    /**
-     * Options for the `run` command
-     */
-    runOptions?: RunOptions;
-    /**
-     * Module IDs that should be resolved from the host's SharedModuleRegistry
-     * instead of esm.sh CDN. The host must have registered these modules.
-     *
-     * Example: ['react', 'react-dom/client']
-     */
-    sharedModules?: string[];
-}
-/**
- * Runtime context passed to the `main()` function when code is executed.
- * This provides sandboxed code with access to sandbox capabilities.
- */
-export interface RunContext {
-    /**
-     * The virtual filesystem - read/write files within the sandbox
-     */
-    fs: IFileSystem;
-    /**
-     * Environment variables (configurable per-sandbox)
-     */
-    env: Record<string, string>;
-    /**
-     * Command-line arguments passed to `run`
-     */
-    args: string[];
-    /**
-     * Explicit logging function (alternative to console.log)
-     */
-    log: (...args: unknown[]) => void;
-    /**
-     * Explicit error logging function (alternative to console.error)
-     */
-    error: (...args: unknown[]) => void;
-}
-/**
- * Options for configuring the `run` command behavior
- */
-export interface RunOptions {
-    /**
-     * Environment variables available via ctx.env
-     */
-    env?: Record<string, string>;
-    /**
-     * Maximum execution time in milliseconds (default: 30000 = 30s)
-     * Set to 0 to disable timeout.
-     */
-    timeout?: number;
-    /**
-     * Whether to skip type checking before running (default: false)
-     */
-    skipTypecheck?: boolean;
-}
-/**
- * Result of running code via the `run` command
- */
-export interface RunResult {
-    /**
-     * Captured console output (log, warn, error)
-     */
-    logs: string[];
-    /**
-     * Return value from main() if present
-     */
-    returnValue?: unknown;
-    /**
-     * Execution time in milliseconds
-     */
-    executionTimeMs: number;
-}
+export declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
 /**
- * Format esbuild messages (warnings/errors) for display
+ * Format bundle errors for shell output
  */
-export declare function formatEsbuildMessages(messages: {
-    text: string;
-    location?: {
-        file?: string;
-        line?: number;
-        column?: number;
-    } | null;
-}[]): string;
+export declare function formatBundleErrors(errors: BundleError[]): string;
 //# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,EAAE,GAChG,MAAM,CAaR"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IAExB,wBAAwB;IACxB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD,0BAA0B;IAC1B,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEzD,wBAAwB;IACxB,KAAK,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3D,6BAA6B;IAC7B,SAAS,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEvE,iCAAiC;IACjC,GAAG,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAanE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA8BhE"}

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

@@ -0,0 +1,142 @@
+/**
+ * Shared bundler utilities used by both browser and node bundlers.
+ *
+ * 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";
+/**
+ * Minimal esbuild types needed for the shared utilities.
+ * These are compatible with both esbuild and esbuild-wasm.
+ */
+export interface EsbuildMessage {
+    text: string;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+        lineText: string;
+    } | null;
+}
+export interface EsbuildPlugin {
+    name: string;
+    setup: (build: EsbuildPluginBuild) => void;
+}
+export interface EsbuildPluginBuild {
+    onResolve: (options: {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: (args: EsbuildResolveArgs) => Promise<EsbuildResolveResult | null | undefined> | EsbuildResolveResult | null | undefined) => void;
+    onLoad: (options: {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: (args: EsbuildLoadArgs) => Promise<EsbuildLoadResult | null | undefined> | EsbuildLoadResult | null | undefined) => void;
+}
+export interface EsbuildResolveArgs {
+    path: string;
+    kind: string;
+    resolveDir: string;
+    importer: string;
+    namespace: string;
+}
+export interface EsbuildResolveResult {
+    path?: string;
+    namespace?: string;
+    external?: boolean;
+    errors?: Array<{
+        text: string;
+    }>;
+}
+export interface EsbuildLoadArgs {
+    path: string;
+}
+export interface EsbuildLoadResult {
+    contents?: string;
+    loader?: string;
+    resolveDir?: string;
+    errors?: Array<{
+        text: string;
+    }>;
+}
+export type EsbuildLoader = "js" | "jsx" | "ts" | "tsx" | "json" | "css" | "text";
+/**
+ * Type guard for esbuild BuildFailure
+ */
+export declare function isEsbuildBuildFailure(err: unknown): err is {
+    errors: EsbuildMessage[];
+    warnings: EsbuildMessage[];
+};
+/**
+ * Convert esbuild Message to our BundleError/BundleWarning format
+ */
+export declare function convertEsbuildMessage(msg: EsbuildMessage): BundleError | BundleWarning;
+export interface VfsPluginOptions {
+    fs: Filesystem;
+    entryPoint: string;
+    installedPackages: Record<string, string>;
+    sharedModules: Set<string>;
+    sharedModuleRegistry: ISharedModuleRegistry | null;
+    cdnBaseUrl: string;
+    includedFiles: Set<string>;
+    /**
+     * If true, CDN imports (http/https URLs) will be bundled by esbuild
+     * rather than marked as external. This is required for Node/Bun
+     * since they cannot resolve HTTP imports at runtime.
+     *
+     * - Browser: false (external) - browser can fetch at runtime
+     * - Node/Bun: true (bundle) - native esbuild fetches during build
+     *
+     * @default false
+     */
+    bundleCdnImports?: boolean;
+}
+/**
+ * Create an esbuild plugin that reads from a virtual filesystem.
+ */
+export declare function createVfsPlugin(options: VfsPluginOptions): EsbuildPlugin;
+/**
+ * Check if a path is a bare import (npm package, not relative/absolute)
+ */
+export declare function isBareImport(path: string): boolean;
+/**
+ * Check if an import matches a shared module.
+ * Handles exact matches and subpath imports.
+ */
+export declare function matchSharedModule(importPath: string, sharedModules: Set<string>): string | null;
+/**
+ * Parse an import path into package name and subpath.
+ */
+export declare function parseImportPath(importPath: string): {
+    packageName: string;
+    subpath?: string;
+};
+/**
+ * Resolve a bare import to an esm.sh CDN URL.
+ */
+export declare function resolveToEsmUrl(importPath: string, installedPackages: Record<string, string>, cdnBaseUrl: string): string | null;
+/**
+ * Resolve a relative or absolute path in the VFS.
+ * Tries extensions and index files as needed.
+ */
+export declare function resolveVfsPath(fs: Filesystem, resolveDir: string, importPath: string): string | null;
+/**
+ * Simple path resolution (handles . and ..)
+ */
+export declare function resolvePath(from: string, to: string): string;
+/**
+ * Normalize a path (remove . and ..)
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Get the directory name of a path
+ */
+export declare function dirname(path: string): string;
+/**
+ * Get the appropriate esbuild loader based on file extension
+ */
+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;
+//# sourceMappingURL=bundler-utils.d.ts.map

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

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

package/dist/core/esm-types-resolver.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Types Resolver - Fetches TypeScript type definitions for npm packages.
+ *
+ * This is a platform-independent implementation that works anywhere with fetch().
+ * (Browser, Node 18+, Bun, Deno, Cloudflare Workers)
+ *
+ * Design principles:
+ * 1. Single responsibility: resolve package → types. No VFS writing.
+ * 2. CDN-agnostic interface with esm.sh implementation
+ * 3. Transparent @types fallback (caller doesn't need to know)
+ * 4. Subpaths resolved on-demand, not pre-fetched
+ * 5. Caching is external/injectable (platform-specific cache implementations)
+ */
+import type { ITypesResolver } from "../types";
+/**
+ * Resolved type definitions for a package.
+ */
+export interface ResolvedTypes {
+    /**
+     * The package name (may differ from request if @types fallback was used)
+     */
+    packageName: string;
+    /**
+     * The resolved version
+     */
+    version: string;
+    /**
+     * Map of relative file paths to content.
+     * Paths are relative to the package root (e.g., "index.d.ts", "utils.d.ts")
+     */
+    files: Record<string, string>;
+    /**
+     * Whether types came from @types/* package
+     */
+    fromTypesPackage: boolean;
+}
+/**
+ * Cache interface for type definitions.
+ * Implementations can be in-memory, IndexedDB, KV store, filesystem, etc.
+ */
+export interface ITypesCache {
+    get(key: string): Promise<ResolvedTypes | null>;
+    set(key: string, value: ResolvedTypes): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Simple in-memory cache implementation.
+ * Works on all platforms.
+ */
+export declare class InMemoryTypesCache implements ITypesCache {
+    private cache;
+    get(key: string): Promise<ResolvedTypes | null>;
+    set(key: string, value: ResolvedTypes): Promise<void>;
+    has(key: string): Promise<boolean>;
+    clear(): void;
+}
+export interface EsmTypesResolverOptions {
+    /**
+     * Base URL for esm.sh (default: "https://esm.sh")
+     */
+    baseUrl?: string;
+    /**
+     * External cache. If not provided, no caching is done.
+     * This allows sharing cache across resolver instances.
+     */
+    cache?: ITypesCache;
+    /**
+     * Whether to try @types/* packages as fallback when main package
+     * doesn't have bundled types. Default: true
+     */
+    tryTypesPackages?: boolean;
+}
+/**
+ * Types resolver using esm.sh CDN.
+ *
+ * Platform-independent - works anywhere with fetch().
+ *
+ * Resolution strategy:
+ * 1. Fetch package from esm.sh, check X-TypeScript-Types header
+ * 2. If no types, try @types/{package} as fallback
+ * 3. Fetch .d.ts files and any /// <reference> dependencies
+ *
+ * @example
+ * ```ts
+ * const resolver = new EsmTypesResolver();
+ *
+ * // Resolve types for a package
+ * const types = await resolver.resolve("lodash", "4.17.21");
+ * // types.files: { "index.d.ts": "...", "common.d.ts": "..." }
+ *
+ * // Resolve subpath types
+ * const clientTypes = await resolver.resolve("react-dom/client", "18.2.0");
+ * ```
+ */
+export declare class EsmTypesResolver implements ITypesResolver {
+    private baseUrl;
+    private cache;
+    private tryTypesPackages;
+    constructor(options?: EsmTypesResolverOptions);
+    /**
+     * Resolve type definitions for a package.
+     *
+     * @param specifier - Package specifier with optional subpath (e.g., "react", "react-dom/client")
+     * @param version - Optional version constraint
+     * @returns Map of file paths to content, or empty object if no types found
+     */
+    resolveTypes(specifier: string, version?: string): Promise<Record<string, string>>;
+    /**
+     * Resolve with full metadata (useful for advanced use cases).
+     */
+    resolve(specifier: string, version?: string): Promise<ResolvedTypes | null>;
+    /**
+     * Attempt to resolve types for a specific package.
+     */
+    private tryResolve;
+    /**
+     * Fetch a .d.ts file and any files it references.
+     */
+    private fetchTypesRecursively;
+    /**
+     * Extract the resolved version from the response.
+     */
+    private extractVersion;
+}
+//# sourceMappingURL=esm-types-resolver.d.ts.map

package/dist/core/esm-types-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-types-resolver.d.ts","sourceRoot":"","sources":["../../src/core/esm-types-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,KAAK,CAAoC;IAE3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,KAAK,IAAI,IAAI;CAGd;AAMD,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,OAAO,GAAE,uBAA4B;IAMjD;;;;;;OAMG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAiBlC;;OAEG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkChC;;OAEG;YACW,UAAU;IA8CxB;;OAEG;YACW,qBAAqB;IAqDnC;;OAEG;IACH,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/core/executor.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Base executor implementation shared by browser and node executors.
+ *
+ * This module provides the core execution logic with console capture,
+ * timeout handling, and export invocation. Platform-specific executors
+ * only need to provide a function to load code as a module.
+ */
+import type { IExecutor } from "../types";
+/**
+ * Function that loads JavaScript code as a module.
+ * Platform-specific implementations convert code to an importable URL.
+ */
+export type ModuleLoader = (code: string) => Promise<Record<string, unknown>>;
+/**
+ * Options for creating a basic executor.
+ */
+export interface BasicExecutorOptions {
+    /**
+     * Default timeout in milliseconds.
+     * @default 30000
+     */
+    defaultTimeout?: number;
+}
+/**
+ * Create an executor using the provided module loader.
+ *
+ * This is the shared implementation used by both browser and node executors.
+ * The only platform-specific part is how code is loaded as a module.
+ *
+ * @param loadModule - Function that loads code as a module
+ * @param options - Executor options
+ * @returns An executor instance
+ */
+export declare function createBasicExecutor(loadModule: ModuleLoader, options?: BasicExecutorOptions): IExecutor;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +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"}