sandlot 0.1.0

package/dist/ts-libs.d.ts

@@ -0,0 +1,98 @@
+/**
+ * TypeScript standard library fetcher and cache.
+ *
+ * Fetches TypeScript's lib.*.d.ts files from jsDelivr CDN and caches
+ * them in IndexedDB for reuse. 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 IndexedDB-backed caching for TypeScript lib files.
+ *
+ * Usage:
+ * ```ts
+ * const cache = await LibCache.create();
+ * const libs = await cache.getOrFetch(getDefaultBrowserLibs());
+ * ```
+ */
+export declare class LibCache {
+    private db;
+    private constructor();
+    /**
+     * Create and initialize a LibCache instance.
+     */
+    static create(): Promise<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(): Promise<Map<string, string> | null>;
+    /**
+     * Store libs in the cache.
+     */
+    set(libs: Map<string, string>): Promise<void>;
+    /**
+     * Clear all cached libs.
+     */
+    clear(): Promise<void>;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+/**
+ * Convenience function to fetch and cache libs in one call.
+ * Creates a temporary LibCache, fetches libs, and returns the result.
+ *
+ * For repeated use, prefer creating a LibCache instance directly.
+ *
+ * @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

@@ -0,0 +1 @@
+{"version":3,"file":"ts-libs.d.ts","sourceRoot":"","sources":["../src/ts-libs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH;;;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;AA+CD;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAc;IAExB,OAAO;IAIP;;OAEG;WACU,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC;IAKxC;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAwB9D;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAmBhD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,MAAM,EAA4B,GACvC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAO9B"}

package/dist/typechecker.d.ts

@@ -0,0 +1,127 @@
+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 = IndexedDbFs.createInMemory({
+ *   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

@@ -0,0 +1 @@
+{"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/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "sandlot",
+  "version": "0.1.0",
+  "description": "Browser-based TypeScript sandbox with esbuild bundling and type checking",
+  "author": "blindmansion",
+  "license": "MIT",
+  "keywords": [
+    "sandbox",
+    "typescript",
+    "esbuild",
+    "browser",
+    "bundler",
+    "playground",
+    "agent"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js",
+      "default": "./dist/internal.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun build ./src/index.ts ./src/react.tsx ./src/internal.ts --outdir ./dist --format esm --packages external",
+    "build:types": "tsc --emitDeclarationOnly",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "esbuild-wasm": "^0.27.2",
+    "just-bash": "^2.6.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19",
+    "react": "^19.2.3"
+  }
+}