sandlot 0.1.4 → 0.2.0

package/dist/shared-resources.d.ts

@@ -1,102 +0,0 @@
-/**
- * Shared resources for sandbox environments.
- *
- * Provides centralized management of expensive shared resources:
- * - TypeScript lib files (~5MB) - loaded once, shared across all sandboxes
- * - esbuild WASM (~10MB) - singleton bundler initialization
- * - Types cache - avoids redundant network fetches when multiple sandboxes
- *   install the same packages
- */
-import { type TypesCache } from "./packages";
-export type { TypesCache } from "./packages";
-export { InMemoryTypesCache } from "./packages";
-/**
- * Shared resources that can be reused across multiple sandboxes
- */
-export interface SharedResources {
-    /**
-     * Pre-loaded TypeScript lib files for type checking
-     */
-    libFiles: Map<string, string>;
-    /**
-     * Promise that resolves when the bundler is ready
-     */
-    bundlerReady: Promise<void>;
-    /**
-     * Cache for package type definitions.
-     * Avoids redundant network fetches when multiple sandboxes
-     * install the same packages.
-     */
-    typesCache: TypesCache;
-}
-/**
- * Options for creating shared resources
- */
-export interface SharedResourcesOptions {
-    /**
-     * TypeScript libs to load. Defaults to browser libs (ES2020 + DOM).
-     */
-    libs?: string[];
-    /**
-     * If true, skip fetching TypeScript libs.
-     * libFiles will be an empty Map.
-     * Default: false
-     */
-    skipLibs?: boolean;
-    /**
-     * If true, skip pre-initializing the bundler.
-     * bundlerReady will resolve immediately.
-     * Default: false
-     */
-    skipBundler?: boolean;
-}
-/**
- * Create a new SharedResources instance.
- *
- * Use this when you want to manage resource lifecycle explicitly,
- * or when you need custom libs configuration.
- *
- * @example
- * ```ts
- * // Create resources with custom libs
- * const resources = await createSharedResources({
- *   libs: ['es2022', 'dom', 'webworker'],
- * });
- *
- * // Pass to sandbox creation
- * const sandbox = await createSandbox({
- *   resources,
- *   fsOptions: { ... },
- * });
- * ```
- */
-export declare function createSharedResources(options?: SharedResourcesOptions): Promise<SharedResources>;
-/**
- * Get the default shared resources singleton.
- *
- * Loads resources once and returns the same instance for all callers.
- * This is the recommended way to get shared resources for most use cases.
- *
- * @example
- * ```ts
- * // Get default resources (creates on first call)
- * const resources = await getDefaultResources();
- *
- * // Create multiple sandboxes sharing the same resources
- * const sandbox1 = await createSandbox({ resources, ... });
- * const sandbox2 = await createSandbox({ resources, ... });
- * ```
- */
-export declare function getDefaultResources(): Promise<SharedResources>;
-/**
- * Clear the default resources singleton (for testing).
- *
- * Note: This doesn't unload the bundler WASM - that stays in memory
- * until page reload. This only clears the cached lib files reference.
- */
-export declare function clearDefaultResources(): void;
-/**
- * Check if the default resources have been initialized.
- */
-export declare function hasDefaultResources(): boolean;
-//# sourceMappingURL=shared-resources.d.ts.map

package/dist/shared-resources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-resources.d.ts","sourceRoot":"","sources":["../src/shared-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGjE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC,CAqB1B;AAWD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,CAAC,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/ts-libs.d.ts

@@ -1,85 +0,0 @@
-/**
- * TypeScript standard library fetcher and cache.
- *
- * Fetches TypeScript's lib.*.d.ts files from jsDelivr CDN and caches
- * them in memory. These files provide types for built-in JavaScript APIs
- * (Array, Number, String) and browser APIs (console, window, document).
- */
-/**
- * Default libs for browser environment with ES2020 target.
- * These provide types for console, DOM APIs, and modern JS features.
- */
-export declare function getDefaultBrowserLibs(): string[];
-/**
- * Parse `/// <reference lib="..." />` directives from a lib file.
- * These directives indicate dependencies on other lib files.
- *
- * @param content - The content of a lib.*.d.ts file
- * @returns Array of lib names referenced (without "lib." prefix or ".d.ts" suffix)
- */
-export declare function parseLibReferences(content: string): string[];
-/**
- * Convert a lib name to its filename.
- * e.g., "es2020" -> "lib.es2020.d.ts"
- */
-export declare function libNameToFileName(name: string): string;
-/**
- * Extract lib name from a file path.
- * e.g., "/node_modules/typescript/lib/lib.es2020.d.ts" -> "es2020"
- *       "lib.dom.d.ts" -> "dom"
- */
-export declare function extractLibName(filePath: string): string | null;
-/**
- * Fetch a single lib file from the CDN.
- *
- * @param name - The lib name (e.g., "es2020", "dom")
- * @returns The content of the lib file
- * @throws Error if the fetch fails
- */
-export declare function fetchLibFile(name: string): Promise<string>;
-/**
- * Recursively fetch all lib files needed for the given libs.
- * Parses `/// <reference lib="..." />` directives and fetches dependencies.
- *
- * @param libs - Initial lib names to fetch (e.g., ["es2020", "dom"])
- * @returns Map of lib name to content
- */
-export declare function fetchAllLibs(libs: string[]): Promise<Map<string, string>>;
-/**
- * LibCache provides in-memory caching for TypeScript lib files.
- *
- * Usage:
- * ```ts
- * const cache = new LibCache();
- * const libs = await cache.getOrFetch(getDefaultBrowserLibs());
- * ```
- */
-export declare class LibCache {
-    /**
-     * Get cached libs if available, otherwise fetch from CDN and cache.
-     *
-     * @param libs - Lib names to fetch (e.g., ["es2020", "dom"])
-     * @returns Map of lib name to content (includes all transitive dependencies)
-     */
-    getOrFetch(libs: string[]): Promise<Map<string, string>>;
-    /**
-     * Get cached libs if available.
-     */
-    get(): Map<string, string> | null;
-    /**
-     * Store libs in the cache.
-     */
-    set(libs: Map<string, string>): void;
-    /**
-     * Clear all cached libs.
-     */
-    clear(): void;
-}
-/**
- * Convenience function to fetch and cache libs in one call.
- *
- * @param libs - Lib names to fetch (defaults to getDefaultBrowserLibs())
- * @returns Map of lib name to content
- */
-export declare function fetchAndCacheLibs(libs?: string[]): Promise<Map<string, string>>;
-//# sourceMappingURL=ts-libs.d.ts.map

package/dist/ts-libs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ts-libs.d.ts","sourceRoot":"","sources":["../src/ts-libs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAY5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA6C/E;AAQD;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAuB9D;;OAEG;IACH,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,MAAM,EAA4B,GACvC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAG9B"}

package/dist/typechecker.d.ts

@@ -1,127 +0,0 @@
-import type { IFileSystem } from "just-bash/browser";
-/**
- * Options for type checking
- */
-export interface TypecheckOptions {
-    /**
-     * The virtual filesystem to read source files from
-     */
-    fs: IFileSystem;
-    /**
-     * Entry point path (absolute path in the virtual filesystem).
-     * TypeScript will discover all imported files from this root.
-     */
-    entryPoint: string;
-    /**
-     * Path to tsconfig.json in the virtual filesystem.
-     * Default: "/tsconfig.json"
-     */
-    tsconfigPath?: string;
-    /**
-     * Pre-loaded TypeScript lib files (e.g., lib.dom.d.ts, lib.es2020.d.ts).
-     * Map from lib name (e.g., "dom", "es2020") to file content.
-     * If provided, enables proper type checking for built-in APIs.
-     * Use fetchAndCacheLibs() from ts-libs to fetch these.
-     */
-    libFiles?: Map<string, string>;
-}
-/**
- * A single diagnostic message from type checking
- */
-export interface Diagnostic {
-    /**
-     * File path where the error occurred (null for global errors)
-     */
-    file: string | null;
-    /**
-     * 1-based line number (null if not applicable)
-     */
-    line: number | null;
-    /**
-     * 1-based column number (null if not applicable)
-     */
-    column: number | null;
-    /**
-     * TypeScript error code (e.g., 2322 for type mismatch)
-     */
-    code: number;
-    /**
-     * Severity category
-     */
-    category: "error" | "warning" | "suggestion" | "message";
-    /**
-     * Human-readable error message
-     */
-    message: string;
-}
-/**
- * Result of type checking
- */
-export interface TypecheckResult {
-    /**
-     * All diagnostics from type checking
-     */
-    diagnostics: Diagnostic[];
-    /**
-     * True if there are any errors (not just warnings)
-     */
-    hasErrors: boolean;
-    /**
-     * List of files that were checked
-     */
-    checkedFiles: string[];
-}
-/**
- * Type check TypeScript files from a virtual filesystem
- *
- * @example
- * ```ts
- * const fs = Filesystem.create({
- *   initialFiles: {
- *     "/tsconfig.json": JSON.stringify({
- *       compilerOptions: {
- *         target: "ES2020",
- *         module: "ESNext",
- *         strict: true
- *       }
- *     }),
- *     "/src/index.ts": `
- *       const x: number = "hello"; // Type error!
- *       export { x };
- *     `,
- *   }
- * });
- *
- * const result = await typecheck({
- *   fs,
- *   entryPoint: "/src/index.ts",
- * });
- *
- * console.log(result.hasErrors); // true
- * console.log(result.diagnostics[0].message); // Type 'string' is not assignable...
- * ```
- */
-export declare function typecheck(options: TypecheckOptions): Promise<TypecheckResult>;
-/**
- * Format diagnostics as a human-readable string
- *
- * @example
- * ```ts
- * const result = await typecheck({ fs, entryPoint: "/src/index.ts" });
- * console.log(formatDiagnostics(result.diagnostics));
- * // /src/index.ts:3:7 - error TS2322: Type 'string' is not assignable to type 'number'.
- * ```
- */
-export declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
-/**
- * Format diagnostics in a concise format suitable for AI agents
- *
- * @example
- * ```ts
- * const result = await typecheck({ fs, entryPoint: "/src/index.ts" });
- * console.log(formatDiagnosticsForAgent(result.diagnostics));
- * // Error in /src/index.ts at line 3: Type 'string' is not assignable to type 'number'. (TS2322)
- * ```
- */
-export declare function formatDiagnosticsForAgent(diagnostics: Diagnostic[]): string;
-//# sourceMappingURL=typechecker.d.ts.map

package/dist/typechecker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typechecker.d.ts","sourceRoot":"","sources":["../src/typechecker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAkZD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2DnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CASnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAwB3E"}

package/src/build-emitter.ts

@@ -1,64 +0,0 @@
-/**
- * Build event emitter for sandbox environments.
- *
- * Simple typed event emitter for successful build results.
- * Used internally by the sandbox to notify listeners when a build succeeds.
- */
-
-import type { BuildOutput } from "./commands/types";
-
-/**
- * Simple typed event emitter for build results.
- *
- * Only emits on successful builds—build failures are communicated via
- * the bash command's exit code and stderr.
- *
- * For most use cases, prefer using `createBuilder()` which handles
- * build result capture automatically.
- */
-export class BuildEmitter {
-  private listeners = new Set<(result: BuildOutput) => void | Promise<void>>();
-
-  /**
-   * Emit a build result to all listeners.
-   * Called internally when a build command succeeds.
-   */
-  emit = async (result: BuildOutput): Promise<void> => {
-    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.
-   *
-   * The callback is invoked each time a build succeeds, receiving
-   * the BuildOutput with the bundle and loaded module.
-   *
-   * @example
-   * ```ts
-   * let lastBuild: BuildOutput | null = null;
-   * const unsubscribe = sandbox.onBuild((result) => {
-   *   lastBuild = result;
-   * });
-   *
-   * await sandbox.bash.exec('build /src/index.ts');
-   * unsubscribe();
-   *
-   * if (lastBuild) {
-   *   const App = lastBuild.module.App as React.ComponentType;
-   * }
-   * ```
-   */
-  on(callback: (result: BuildOutput) => void | Promise<void>): () => void {
-    this.listeners.add(callback);
-    return () => {
-      this.listeners.delete(callback);
-    };
-  }
-}