@ebowwa/sandbox 0.1.1

package/dist/compilers/typescript.d.ts

@@ -0,0 +1,99 @@
+/**
+ * TypeScript Compiler for @ebowwa/sandbox
+ *
+ * Compiles TypeScript to WASM via JavaScript.
+ * Uses esbuild for fast TypeScript transpilation, then delegates to JavaScript compiler.
+ */
+import { BaseCompiler, type CompileResult, type CompilerOptions, type LanguageCapabilities } from "../core/compiler.js";
+import type { Permissions, Limits } from "../core/types.js";
+/** TypeScript compiler options */
+export interface TypeScriptCompilerOptions extends CompilerOptions {
+    /** TypeScript target */
+    target?: "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "esnext";
+    /** Module format */
+    module?: "esm" | "cjs" | "iife";
+    /** Enable strict type checking */
+    strict?: boolean;
+    /** Emit declaration files */
+    declaration?: boolean;
+    /** Source map generation */
+    sourceMap?: boolean;
+    /** JSX transform */
+    jsx?: "transform" | "preserve" | "automatic";
+    /** JSX factory */
+    jsxFactory?: string;
+    /** JSX fragment factory */
+    jsxFragment?: string;
+    /** Use AssemblyScript for compilation */
+    useAssemblyScript?: boolean;
+    /** Transpiler to use */
+    transpiler?: "esbuild" | "swc" | "tsc";
+}
+/**
+ * TypeScript Compiler
+ *
+ * Transpiles TypeScript to JavaScript, then compiles to WASM.
+ * Supports both standard TypeScript and AssemblyScript syntax.
+ */
+export declare class TypeScriptCompiler extends BaseCompiler {
+    readonly language: "typescript";
+    private jsCompiler;
+    private esbuildAvailable;
+    private swcAvailable;
+    constructor();
+    /**
+     * Check if TypeScript compiler is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Validate TypeScript syntax
+     */
+    validate(source: string): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Compile TypeScript to WASM
+     *
+     * 1. Transpile TypeScript to JavaScript
+     * 2. Use JavaScript compiler for WASM compilation
+     */
+    compile(source: string, permissions: Permissions, limits: Limits, options?: TypeScriptCompilerOptions): Promise<CompileResult>;
+    /**
+     * Get language capabilities
+     */
+    getCapabilities(): LanguageCapabilities;
+    /**
+     * Transpile TypeScript to JavaScript
+     */
+    private transpile;
+    /**
+     * Transpile using esbuild
+     */
+    private transpileWithEsbuild;
+    /**
+     * Transpile using SWC
+     */
+    private transpileWithSwc;
+    /**
+     * Fallback transpilation using regex (basic type stripping)
+     *
+     * Note: This is not a complete TypeScript implementation.
+     * Use esbuild or swc for production code.
+     */
+    private transpileWithRegex;
+    /**
+     * Get the best available transpiler
+     */
+    private getTranspiler;
+    /**
+     * Detect if source uses AssemblyScript-specific types
+     */
+    private detectAssemblyScript;
+    /**
+     * Basic syntax check for TypeScript
+     */
+    private checkBasicSyntax;
+}
+export declare const typescriptCompiler: TypeScriptCompiler;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/compilers/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/compilers/typescript.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG5D,kCAAkC;AAClC,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,wBAAwB;IACxB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1G,oBAAoB;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,GAAG,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wBAAwB;IACxB,UAAU,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;CACxC;AAmBD;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAE1C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,YAAY,CAAwB;;IAO5C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAMrC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC3E;;;;;OAKG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,aAAa,CAAC;IAmDzB;;OAEG;IACH,eAAe,IAAI,oBAAoB;IAWvC;;OAEG;YACW,SAAS;IA0BvB;;OAEG;YACW,oBAAoB;IAiClC;;OAEG;YACW,gBAAgB;IAiC9B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;YACW,aAAa;IAqD3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA2BzB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/compilers/typescript.js

@@ -0,0 +1,323 @@
+/**
+ * TypeScript Compiler for @ebowwa/sandbox
+ *
+ * Compiles TypeScript to WASM via JavaScript.
+ * Uses esbuild for fast TypeScript transpilation, then delegates to JavaScript compiler.
+ */
+import { BaseCompiler, } from "../core/compiler.js";
+import { JavaScriptCompiler } from "./javascript.js";
+/**
+ * TypeScript Compiler
+ *
+ * Transpiles TypeScript to JavaScript, then compiles to WASM.
+ * Supports both standard TypeScript and AssemblyScript syntax.
+ */
+export class TypeScriptCompiler extends BaseCompiler {
+    language = "typescript";
+    jsCompiler;
+    esbuildAvailable = null;
+    swcAvailable = null;
+    constructor() {
+        super();
+        this.jsCompiler = new JavaScriptCompiler();
+    }
+    /**
+     * Check if TypeScript compiler is available
+     */
+    async isAvailable() {
+        // TypeScript compiler is always available (we have built-in support)
+        // But transpilers may vary
+        return true;
+    }
+    /**
+     * Validate TypeScript syntax
+     */
+    async validate(source) {
+        try {
+            const transpiler = await this.getTranspiler("esbuild");
+            if (transpiler?.type === "esbuild") {
+                await transpiler.module.transform(source, {
+                    loader: "ts",
+                    target: "es2020",
+                    tsconfigRaw: {
+                        compilerOptions: {
+                            strict: true,
+                            noEmit: true,
+                        },
+                    },
+                });
+                return { valid: true };
+            }
+            // Fallback: basic regex check for common syntax errors
+            const syntaxErrors = this.checkBasicSyntax(source);
+            if (syntaxErrors) {
+                return { valid: false, error: syntaxErrors };
+            }
+            return { valid: true };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Compile TypeScript to WASM
+     *
+     * 1. Transpile TypeScript to JavaScript
+     * 2. Use JavaScript compiler for WASM compilation
+     */
+    async compile(source, permissions, limits, options) {
+        const opts = {
+            target: "es2020",
+            module: "esm",
+            strict: true,
+            declaration: false,
+            sourceMap: options?.sourceMap ?? false,
+            jsx: "transform",
+            jsxFactory: "React.createElement",
+            jsxFragment: "React.Fragment",
+            useAssemblyScript: false,
+            transpiler: "esbuild",
+            ...options,
+        };
+        // Check if source uses AssemblyScript types
+        const isAssemblyScript = this.detectAssemblyScript(source);
+        const effectiveUseAssemblyScript = opts.useAssemblyScript || isAssemblyScript;
+        // Transpile TypeScript to JavaScript
+        const transpiled = await this.transpile(source, {
+            ...opts,
+            useAssemblyScript: effectiveUseAssemblyScript,
+        });
+        // Delegate to JavaScript compiler
+        const jsOptions = {
+            target: opts.target,
+            module: opts.module,
+            strict: opts.strict,
+            useAssemblyScript: effectiveUseAssemblyScript,
+            optimize: opts.optimize,
+            debug: opts.debug,
+            sourceMap: opts.sourceMap,
+        };
+        const result = await this.jsCompiler.compile(transpiled.code, permissions, limits, jsOptions);
+        // Include source map if generated
+        if (transpiled.map) {
+            result.sourceMap = transpiled.map;
+        }
+        return result;
+    }
+    /**
+     * Get language capabilities
+     */
+    getCapabilities() {
+        return {
+            repl: true,
+            stateful: true,
+            compiled: false, // TS transpiles to JS, which is interpreted
+            gc: true, // JavaScript has garbage collection
+            imports: true,
+            async: true,
+        };
+    }
+    /**
+     * Transpile TypeScript to JavaScript
+     */
+    async transpile(source, options) {
+        // If using AssemblyScript, don't transpile types
+        if (options.useAssemblyScript) {
+            return {
+                code: source,
+                map: undefined,
+            };
+        }
+        const transpiler = await this.getTranspiler(options.transpiler || "esbuild");
+        if (transpiler?.type === "esbuild") {
+            return this.transpileWithEsbuild(source, options, transpiler.module);
+        }
+        if (transpiler?.type === "swc") {
+            return this.transpileWithSwc(source, options, transpiler.module);
+        }
+        // Fallback: strip types using regex (not recommended for production)
+        return this.transpileWithRegex(source);
+    }
+    /**
+     * Transpile using esbuild
+     */
+    async transpileWithEsbuild(source, options, esbuild) {
+        const result = await esbuild.transform(source, {
+            loader: "ts",
+            target: options.target || "es2020",
+            format: options.module === "cjs" ? "cjs" : "esm",
+            minify: options.optimize,
+            sourcemap: options.sourceMap ? "external" : false,
+            jsx: options.jsx === "automatic" ? "automatic" : "transform",
+            jsxFactory: options.jsxFactory,
+            jsxFragment: options.jsxFragment,
+            tsconfigRaw: {
+                compilerOptions: {
+                    strict: options.strict,
+                    target: options.target,
+                    module: options.module?.toUpperCase(),
+                    esModuleInterop: true,
+                    allowSyntheticDefaultImports: true,
+                    resolveJsonModule: true,
+                    declaration: options.declaration,
+                },
+            },
+        });
+        return {
+            code: result.code,
+            map: result.map,
+        };
+    }
+    /**
+     * Transpile using SWC
+     */
+    async transpileWithSwc(source, options, swc) {
+        const result = await swc.transform(source, {
+            jsc: {
+                parser: {
+                    syntax: "typescript",
+                    tsx: options.jsx !== "preserve",
+                },
+                transform: {
+                    react: {
+                        runtime: options.jsx === "automatic" ? "automatic" : "classic",
+                        pragma: options.jsxFactory,
+                        pragmaFrag: options.jsxFragment,
+                    },
+                },
+                target: options.target?.replace("es", "es") || "es2020",
+            },
+            module: {
+                type: options.module === "cjs" ? "commonjs" : "es6",
+            },
+            minify: options.optimize,
+            sourceMaps: options.sourceMap,
+        });
+        return {
+            code: result.code,
+            map: result.map,
+        };
+    }
+    /**
+     * Fallback transpilation using regex (basic type stripping)
+     *
+     * Note: This is not a complete TypeScript implementation.
+     * Use esbuild or swc for production code.
+     */
+    transpileWithRegex(source) {
+        let code = source;
+        // Strip type annotations
+        // This is a simplified implementation
+        const patterns = [
+            // Remove type annotations: : Type
+            /:\s*[A-Z][a-zA-Z0-9_]*(?:<[^>]+>)?(?:\[\])?(?:\s*\|\s*[A-Z][a-zA-Z0-9_]*(?:<[^>]+>)?(?:\[\])?)*/g,
+            // Remove interface declarations
+            /interface\s+[A-Z][a-zA-Z0-9_]*\s*(?:<[^>]+>)?\s*\{[^}]*\}/g,
+            // Remove type declarations
+            /type\s+[A-Z][a-zA-Z0-9_]*\s*(?:<[^>]+>)?\s*=\s*[^;]+;/g,
+            // Remove enum declarations (convert to const objects)
+            /enum\s+([A-Z][a-zA-Z0-9_]*)\s*\{([^}]*)\}/g,
+            // Remove generic type parameters
+            /<[^>]+>/g,
+            // Remove 'as' type assertions
+            /\s+as\s+[A-Z][a-zA-Z0-9_]*(?:<[^>]+>)?/g,
+            // Remove 'satisfies' type assertions
+            /\s+satisfies\s+[A-Z][a-zA-Z0-9_]*(?:<[^>]+>)?/g,
+            // Remove 'declare' statements
+            /declare\s+(?:const|let|var|function|class|interface|type|enum)\s+[^;]+;/g,
+            // Remove 'public', 'private', 'protected', 'readonly' modifiers
+            /\b(?:public|private|protected|readonly)\s+/g,
+            // Remove 'abstract' modifier
+            /\babstract\s+/g,
+            // Remove parameter properties in constructors
+            /constructor\s*\(([^)]*)\)/g,
+        ];
+        for (const pattern of patterns) {
+            code = code.replace(pattern, "");
+        }
+        return {
+            code,
+            map: undefined,
+        };
+    }
+    /**
+     * Get the best available transpiler
+     */
+    async getTranspiler(preferred) {
+        if (preferred === "esbuild" || preferred === "tsc") {
+            if (this.esbuildAvailable === null) {
+                try {
+                    await import("esbuild");
+                    this.esbuildAvailable = true;
+                }
+                catch {
+                    this.esbuildAvailable = false;
+                }
+            }
+            if (this.esbuildAvailable) {
+                const esbuild = await import("esbuild");
+                return { type: "esbuild", module: esbuild };
+            }
+        }
+        if (preferred === "swc") {
+            if (this.swcAvailable === null) {
+                try {
+                    await import("@swc/core");
+                    this.swcAvailable = true;
+                }
+                catch {
+                    this.swcAvailable = false;
+                }
+            }
+            if (this.swcAvailable) {
+                const swc = await import("@swc/core");
+                return { type: "swc", module: swc };
+            }
+        }
+        // Fallback to esbuild if swc was preferred but not available
+        if (preferred === "swc" && this.esbuildAvailable !== false) {
+            return this.getTranspiler("esbuild");
+        }
+        return null;
+    }
+    /**
+     * Detect if source uses AssemblyScript-specific types
+     */
+    detectAssemblyScript(source) {
+        // AssemblyScript uses specific types: i8, i16, i32, i64, f32, f64, usize, etc.
+        const assemblyScriptTypes = /\b(i8|i16|i32|i64|f32|f64|usize|isize|bool)\b/;
+        return assemblyScriptTypes.test(source);
+    }
+    /**
+     * Basic syntax check for TypeScript
+     */
+    checkBasicSyntax(source) {
+        // Check for common syntax errors
+        const errors = [];
+        // Check for unmatched braces
+        const openBraces = (source.match(/\{/g) || []).length;
+        const closeBraces = (source.match(/\}/g) || []).length;
+        if (openBraces !== closeBraces) {
+            errors.push(`Unmatched braces: ${openBraces} open, ${closeBraces} close`);
+        }
+        // Check for unmatched parentheses
+        const openParens = (source.match(/\(/g) || []).length;
+        const closeParens = (source.match(/\)/g) || []).length;
+        if (openParens !== closeParens) {
+            errors.push(`Unmatched parentheses: ${openParens} open, ${closeParens} close`);
+        }
+        // Check for unmatched brackets
+        const openBrackets = (source.match(/\[/g) || []).length;
+        const closeBrackets = (source.match(/\]/g) || []).length;
+        if (openBrackets !== closeBrackets) {
+            errors.push(`Unmatched brackets: ${openBrackets} open, ${closeBrackets} close`);
+        }
+        return errors.length > 0 ? errors.join("; ") : null;
+    }
+}
+// Default instance
+export const typescriptCompiler = new TypeScriptCompiler();
+//# sourceMappingURL=typescript.js.map

package/dist/compilers/typescript.js.map

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

package/dist/core/cell.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Cell Primitive
+ *
+ * Represents a single unit of executable code.
+ * Cells can be combined into notebooks for sequential execution.
+ */
+import type { Cell, Language, ExecutionResult, ExecutionContext } from "./types.js";
+import type { CompileResult } from "./compiler.js";
+/**
+ * Cell metadata
+ */
+export interface CellMetadata {
+    /** Cell display order */
+    index?: number;
+    /** Cell is collapsed */
+    collapsed?: boolean;
+    /** Cell execution count */
+    executionCount?: number;
+    /** Tags for organization */
+    tags?: string[];
+    /** Custom metadata */
+    [key: string]: unknown;
+}
+/**
+ * Cell execution state
+ */
+export type CellState = "idle" | "queued" | "running" | "success" | "error" | "cancelled";
+/**
+ * Extended cell with execution tracking
+ */
+export interface ExecutableCell extends Cell {
+    /** Current state */
+    state: CellState;
+    /** Last execution result */
+    result?: ExecutionResult;
+    /** Execution count (notebook-style) */
+    executionCount?: number;
+    /** Last execution timestamp */
+    lastRun?: Date;
+    /** Dependencies on other cells */
+    dependencies?: string[];
+    /** Exports from this cell */
+    exports?: string[];
+}
+/**
+ * Cell Builder
+ *
+ * Fluent API for creating cells.
+ */
+export declare class CellBuilder {
+    private id;
+    private language;
+    private source;
+    private metadata;
+    setId(id: string): this;
+    setLanguage(lang: Language): this;
+    setSource(code: string): this;
+    addMetadata(key: string, value: unknown): this;
+    setIndex(index: number): this;
+    addTag(tag: string): this;
+    build(): Cell;
+    buildExecutable(): ExecutableCell;
+}
+/**
+ * Cell Executor
+ *
+ * Handles execution of individual cells.
+ */
+export declare class CellExecutor {
+    private compileFn;
+    private executeFn;
+    constructor(compileFn: (cell: Cell) => Promise<CompileResult>, executeFn: (compiled: CompileResult, context: ExecutionContext) => Promise<ExecutionResult>);
+    /**
+     * Execute a cell
+     */
+    execute(cell: ExecutableCell, context: ExecutionContext): Promise<ExecutionResult>;
+}
+/**
+ * Cell Registry
+ *
+ * Tracks cells and their relationships.
+ */
+export declare class CellRegistry {
+    private cells;
+    private dependencies;
+    private dependents;
+    /**
+     * Add a cell
+     */
+    add(cell: ExecutableCell): void;
+    /**
+     * Get a cell by ID
+     */
+    get(id: string): ExecutableCell | undefined;
+    /**
+     * Remove a cell
+     */
+    remove(id: string): void;
+    /**
+     * Get all cells
+     */
+    getAll(): ExecutableCell[];
+    /**
+     * Get cells by language
+     */
+    getByLanguage(language: Language): ExecutableCell[];
+    /**
+     * Get cells by state
+     */
+    getByState(state: CellState): ExecutableCell[];
+    /**
+     * Add dependency between cells
+     */
+    addDependency(cellId: string, dependsOn: string): void;
+    /**
+     * Get dependencies of a cell
+     */
+    getDependencies(cellId: string): string[];
+    /**
+     * Get dependents of a cell (cells that depend on this one)
+     */
+    getDependents(cellId: string): string[];
+    /**
+     * Get execution order (topological sort)
+     */
+    getExecutionOrder(): string[];
+    /**
+     * Check if cell has circular dependencies
+     */
+    hasCircularDependency(cellId: string): boolean;
+    /**
+     * Get cells that need re-execution after a cell changes
+     */
+    getCellsToReexecute(cellId: string): string[];
+    /**
+     * Clear all cells
+     */
+    clear(): void;
+    /**
+     * Get count
+     */
+    get count(): number;
+}
+/**
+ * Create a simple cell
+ */
+export declare function createCell(language: Language, source: string, options?: {
+    id?: string;
+    metadata?: CellMetadata;
+    dependencies?: string[];
+}): ExecutableCell;
+/**
+ * Create cells from code blocks
+ */
+export declare function createCellsFromMarkdown(markdown: string, defaultLanguage?: Language): ExecutableCell[];
+/**
+ * Convert cells to markdown
+ */
+export declare function cellsToMarkdown(cells: ExecutableCell[]): string;
+//# sourceMappingURL=cell.d.ts.map

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

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