A high-performance Ahead-Of-Time (AOT) compiler compiling TypeScript to native standalone executables and WebAssembly (WASI) modules with Node.js core subset parity.
ScriptGo is a high-performance native compiler that runs TypeScript and JavaScript with Node.js-compatible semantics while compiling eligible code directly to standalone native binaries or WebAssembly modules. It combines the official TypeScript (Go implementation) compiler frontend for parsing, type-checking, and diagnostics with an independent Typed IR system and an LLVM IR / Native Machine Code backend.
Highlights & Features
- High-Performance AOT Compilation: Compiles TypeScript directly to native machine code (Mach-O, ELF, PE) and WebAssembly (
.wasm) via LLVM.
- Node.js Core Subset Parity: All 437 regression corpus cases match their expected output; 435/437 also match Node.js v22 (two decorator-metadata cases differ only because Node's type stripping emits no metadata).
- test262 Tracking:
cmd/test262 measures a 25k-test ECMAScript subset (4,154 pass, 23.6% of attempted); the core subset is curated, so most of test262 is still rejected or unsupported (see the parity report). CI runs a recorded passing baseline as a regression gate.
- WebAssembly / WASI Target: First-class Ahead-Of-Time compilation to standalone
.wasm executables with --target wasm32-wasi, validated on Node.js WASI and Wasmtime.
- Zero-Dependency Native Builds: Automatically uses system
clang or auto-detects zig cc for hassle-free out-of-the-box compilation and seamless cross-compilation (macOS, Linux, Windows, WASM).
- Fast Execution: Instantly compiles and runs scripts directly or produces optimized standalone binary builds.
- Modern TypeScript & ECMAScript (ES2022 - ES2025):
- Explicit Resource Management: Full
using and await using resource disposal with Symbol.dispose and Symbol.asyncDispose.
- ES2024 Set Methods:
union(), intersection(), difference(), symmetricDifference(), isSubsetOf(), isSupersetOf(), isDisjointFrom().
- ES2024 Utilities:
Promise.withResolvers(), Object.groupBy(), Map.groupBy(), Array.fromAsync().
- ES2025 Iterator Helpers:
Iterator.from(), map(), filter(), take(), drop(), flatMap(), reduce(), toArray(), forEach(), some(), every(), find().
- Types & Primitives:
number (IEEE-754), bigint, string (UTF-8), boolean, symbol (with Symbol Registry), null, undefined, unknown (with type narrowing), Tuples, Enums (numeric, string, reverse mappings), Union types (T | null | undefined), Monomorphized Generics.
- Control Flow:
if/else, switch/case (with fallthrough), while, do..while, for, for..of, for..in, for await..of, Labeled statements (break label, continue label), try/catch/finally, throw, Array & Object destructuring, Spread/Rest (...), Tagged template literals, Optional chaining & calls (?., fn?.()).
- Functions & Closures: Lexical closures, arrow functions, default/optional/rest parameters, Generators (
function*, yield, yield*), Async Generators.
- OOP & Classes: Constructors, properties, static fields/methods, Class Static Blocks (), Getters/Setters, Inheritance (, ), Polymorphic VTables, .
Documentation
docs/typescript-parity-report.md - Core subset feature matrix, corpus parity, and test262 conformance results.docs/native-subset.md - Native static subset definition and compatibility constraints.docs/compilation-tiers.md - Static, Dynamic (QuickJS-ng island), and Unsupported compilation policy.docs/application-structure.md - Repository architecture, package ownership, and dependency direction.docs/typescript-to-native.md - Pipeline boundaries, IR verification invariants, and LLVM lowering.docs/stdlib.md - Standard library API scope and Node.js runtime emulation policy.docs/roadmap.md - Project roadmap, milestones, and acceptance criteria.
Installation
Install the latest GitHub release on macOS or Linux:
curl -fsSL https://raw.githubusercontent.com/pilotworks/scriptgo/main/install.sh | sh
Install a specific release or choose another destination:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
