mirror of
https://github.com/vercel-labs/scriptc.git
synced 2026-10-23 06:10:02 +08:00
99 KiB
99 KiB
Changelog
All notable changes to scriptc will be documented in this file.
Unreleased
0.3.5
Features
node:fsadds read and write streams, includingfs.createReadStreamandfs.createWriteStream.util.promisifyworks overchild_process.execand the fs callback functions that have anfs/promisescounterpart.node:netaddssocket.address(),socket.resetAndDestroy()andserver.dropMaxConnection, andnode:dgramsupports the socket options anddisconnect().node:tlsaddsgetProtocol,getCipher,alpnProtocolandtls.DEFAULT_MIN_VERSION/DEFAULT_MAX_VERSION.events.onceworks onEventEmitterinstances.- Checked JSON records keep keys they do not declare, and compound assignment with untyped operands compiles.
Performance
MapandSetheaders and small entry arrays are smaller: an empty map takes 100 bytes instead of 188.- Released lifetime regions are freed without a pass over the whole heap.
- The cycle collector frees its large work vectors after a pass, and intact parsed JSON documents skip cycle collection.
- Classes keep a property bag only when something stores into it, and class and record views without dynamic stores emit no commit adapters.
- Integer arithmetic is proven through calls and module-level code, pure number recursion runs on integer clones, and array lengths load with the range of a JS array length.
- Closed virtual calls are dispatched directly, read-modify-write operations reuse their
Maplookup, and never-reassigned bindings are read as values. - Generators, user iterators and awaits cost less per value, and promises use a smaller block allocated inline.
- SHA-1 and SHA-256 use the SHA extensions on x86-64, about 4 to 5 times faster than before.
- Regex exec results,
parseIntof captures, UTF-8 file reads, string-and-number concatenation and smallBufferallocation are cheaper, andJSON.parsestorage fits its length. - The main thread leaves its heap to the operating system at exit.
Fixes
- Sockets read ahead without a consumer, so a peer's close reaches them.
- Publication walkers with more than ten pushes keep distinct value names, and int32 field storage survives reflection reads through
unknown. - Native program objects use runtime ABI v22. External object consumers must link the matching v0.3.5 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.3.4
Features
InternTablein@scriptc/experimentalis a shared, append-only table of published values that every thread can read and add to, with string, number and array keys.node:zlibadds the stream classes, andnode:cryptosupportscreateCipherivandcreateDecipheriv.node:streamadds the Readable operators,stream.compose,Readable.fromover generators and theReadable.fromoptions, plus async generator stages, source functions, promise destinations and{ signal }inpipeline.node:testaddsTestContexthooks,plan,fullName, Node'stodoandonlyrules,mock.fnandt.mock.fn.node:assertaddsAssertionError,deepEqual,partialDeepStrictEqualand theAssertclass.node:httpmatches Node's keep-alive, header and framing behavior, andnode:netadds socket address fields,writeandendcallbacks and server connection limits.dns.lookupsupports Node's forms, along withlookupService,getServersand the result order.fs.opendirSync,fs.promises.opendirandfs.Dirare supported, and the fs option checks follow Node's.util.formatsupports%f, andtimers/promisesresolve values andsetIntervalwork under@types/node.
Performance
Atomicsrun without a lock on shared storage and compile to inline atomic instructions.- Lifetime regions are cheaper. Programs that never create a region no longer pay for region counting, a kept region is retried only when its counted references change, and owned objects with a single reference are released without a table entry.
- Publishing large object graphs is faster, and dropped cyclic graphs are collected while they are still in cache.
- fs callbacks and worker-pool completions wake the event loop directly instead of waiting for a timer turn.
- Number-keyed
MapandSetoperations are faster: lookups are probed inline, andsetandaddafter a read store into the entry they found. - Named property reads of unknown values take one receiver retain, dyn array elements and lengths are read by number, and cyclic dyn values convert to recursive shapes.
- Small exact arrays have room for one append.
- Large wasm32 programs are partitioned like native ones.
Fixes
process.nextTickcallbacks drain before promise jobs after every callback, as in Node.- wasm32 array lengths past 2^31 and the exit codes of pending top-level
awaitare correct, and typed-array indices stay integral through the shared-buffer check. - The npm case fixtures run natively, and the issues they found are fixed.
0.3.3
Features
- scriptc targets Node 24.22.0. Compatibility tables, tests and behavior follow Node 24.22.0.
node:cryptocovers more of Node 24: every digest increateHash,createHmac,crypto.hash,pbkdf2andhkdf, every Hash and Hmac encoding and option, secretKeyObjects (createSecretKey,generateKey,generateKeySync),randomFill,randomIntcallbacks,randomUUIDoptions,randomUUIDv7, andtimingSafeEqualover any view orArrayBuffer.node:fsaddsglob,globSyncandfs/promisesglob, the remainingfs/promisesfunctions with Node's argument checks, completefs.Statsin both lanes, and results frommkdir,readFileandwritecallbacks.readdirlists entries in byte order on POSIX hosts, and dynamicDirentvalues have Node's prototype and inspect form.BlobandFileare supported.readline/promises,stream.addAbortSignaland thestream/promisesoptions are supported, and stream chunks made from strings reach user code asBuffers.- The legacy
urlAPI,url.domainToASCIIandurl.domainToUnicodeare supported. process.memoryUsage, process identity members, andperformancemarks and measures are supported.EventTargetandEventcan be subclassed.- Sockets and servers support
ref()andunref(). The HTTP server enforces Node's header field limits, andutil.typeshas Node 24's keys. util.inspectprints class names and dynamic Maps and Sets as Node does.localeComparematches Node's collation forl·, U+0130, ligatures, combining Latin letters and vulgar fractions.
Performance
- Comparator sorts use V8's TimSort, and typed-array
sortandtoSortedare lowered natively. - The allocator has 8-byte size classes below 128 bytes, so small objects waste less memory.
- Interface calls are faster. Class methods are called directly through interfaces, interface dispatch is inlined and borrows array elements, and arrays of interface values are stored natively with direct field reads.
- Strings append in place for fields, concatenation chains and character codes, and string retains are inlined in release builds.
- Records are leaner. Scalar-union fields are stored inline, record parameters and returns widen by flow class, nullable records use widened record slots, result-slot entries are inlined, and conversions from typed records to
unknownare cheaper. - Typed
JSON.parsematches member names against the text and reads scalar members inline, and typedJSON.stringifywrites arrays from their slots. - Map and Set iteration steps are inlined, and
Object.valuesis built natively when its result is only iterated or read. - Array searches over objects and strings run inline, and array headers stay out of loops.
localeCompareis faster: it compares without building element lists and checks ASCII strings eight bytes at a time.- Remainders by powers of two skip
fmod, number and string dynamic boxes are freed without the destroy queue, and VT control characters are stripped in one pass.
Fixes
parseIntrounds as Node does on each architecture.- New runtime globals are defined with initializers, so library localization hides them.
- Native program objects use runtime ABI v21. Array, record and allocator layouts changed, so external object consumers must link the matching v0.3.3 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.3.2
Features
EventTarget,EventandCustomEventare supported, with Node's dispatch order,once/passive/signaloptions and listener error reporting.AbortSignaluses the same implementation, andevents.errorMonitorandevents.addAbortListenerare supported.Promise.allSettledandPromise.anyare supported in typed and JavaScript code, with Node's microtask order,AggregateError, andPromiseSettledResultrecords. JavaScript combinators adopt thenables.yield*delegates to arrays, strings, Sets and Maps, forwards typednextvalues,return()andthrow(), and a finished generator's.valuereads asundefined.- The global console is complete:
assert,count/countReset,dir/dirxml,group*,table,time/timeLog/timeEnd,clearandprofile/timeStampprint Node's output. node:osis complete, andpath.parse,path.formatandpath.matchesGlobare supported for the posix and win32 families.util.inherits,util.deprecate,util.callbackifyandutil.debuglogfollow Node 24, includingNODE_DEBUG,process.noDeprecationandprocess.throwDeprecation.LifetimeRegionin@scriptc/experimentalfreesProgramLifetimeinstances one generation at a time. A watch-style compiler benchmark stays at 190 MB after 10 builds.
Performance
- Short-lived number records and objects live in the function's frame. Records and small class instances with number and boolean fields that are only read, updated by their own methods, or returned unchanged are not heap-allocated, including results of functions that return a fresh object.
- Maybe-missing number reads stay unboxed, and directly called functions returning
number | undefinedreturn the tag and payload in registers. - Arrays and objects use less memory.
boolean[]stores one byte per element, small appended arrays keep their first elements in the array's own block, and cycle-capable objects carry an 8-byte header instead of 16 bytes. - Sorting with a recognized numeric comparator sorts by key without calling the comparator, for
number[]and arrays of records or class instances. - Regex
replace,matchand capture reads are faster. Compiled matchers write replacements directly, and captures that are only compared or converted to numbers are not copied into strings. for...in,Object.keysandObject.entriesover values typedunknownoranybuild native arrays from the record layout or the object's own keys.- Calls through function-typed class fields box the receiver only when the callee reads
this. - Indexed non-ASCII string scans,
split(""), template literals andjoinare faster.
Fixes
- Strings keep lone UTF-16 surrogates. Strings are stored as canonical WTF-8, so lone surrogates survive literals,
split(""),charAt,slice,fromCharCodeandJSON.parse, and output streams write them as U+FFFD as Node does. - A
varread before its first store readsundefined, and classes used before their declaration runs throw aReferenceError. - Reflection over typed values seen as
unknownmatches Node:insees prototype members,for...inwalks class instances, typed records work as prototypes, andJSON.stringifyaccepts array replacers. - Microtask and event order match Node for
Promise.all,Promise.race, async generator returns, and fork IPCexit,disconnectandcloseevents. - Module initializers that only
++or--a binding run. - Native program objects use runtime ABI v20. Array and object layouts changed, so external object consumers must link the matching v0.3.2 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.3.1
Features
node:consoleConsoleinstances write toprocess.stdout,process.stderror other writable streams, with Node'signoreErrorshandling.stream/consumersarrayBuffer()is supported, andArrayBufferandSharedArrayBuffervalues print like Node.- Compound assignment and
++/--work on bigint locals and fields.
Performance
- Integer code stays in integer registers. Locals proven to stay within 32 bits are stored as 32-bit integers, int32 parameters and results pass in integer registers on direct calls, integer sums that feed bitwise conversions wrap in 32 bits, and loop accumulators keep uint32 ranges.
- Array callback chains run as single loops.
filter,map,flatMapandslicechains feedingreduce,some,every,findIndex,forEach,lengthor a final array no longer build intermediate arrays when the callbacks' effects allow it. - Array element access does less work. Arrays track a hole-free prefix whose reads and writes skip per-slot state, compound element updates are native, dense arrays sort without a snapshot, and typed-array reads compared with numbers stay unboxed.
- Calls and closures retain less. Calls are devirtualized by the classes a program constructs, closure bodies borrow unchanged reference parameters, the comparator sort lends its slots, and unchanged captures are read in place.
- Async calls and generators are cheaper. Awaiting a direct async call that completes without suspending creates no promise, and synchronous generators run as stackless coroutines.
- Strings and regular expressions are faster. Comparisons and
switchagainst string literals run inline, regex literals compile to native matchers at build time, literal sites reuse their compiled pattern, and plain-text patterns and stringreplace/replaceAllscan directly. - BigInt arithmetic and text conversion are much faster, with limb-based division, chunked radix conversion and Karatsuba multiplication; literals are constants, and small-value expressions run in 64-bit registers.
- Reflective reads of typed values (
for...in,Object.keys/values/entries,in, spread andJSON.stringifyof typed records seen asunknown) read native fields instead of copying the record. - The cycle collector frees young garbage sooner and teardown is direct. Types the collector bypasses are measured again in probe windows, and typed children are torn down without the generic release path.
- The compiler is faster, because its own analyses walk the IR through typed fields.
Fixes
return pin an async function takes Node's microtask turns, and a rejection of the returned promise reaches the caller instead of the function's owncatch.- Core dumps leave out the allocator's untouched reservation, so crashing programs no longer write gigabytes of empty memory, and glibc's heap is left to the huge-page policy.
- Native program objects use runtime ABI v17. Array, closure and regex layouts changed, so external object consumers must link the matching v0.3.1 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.3.0
Breaking changes
- Compilation is native-only. The
--dynamicoption and embedded JavaScript execution runtime have been removed. Eligible dependencies compile natively by default; unsupported packages receive build diagnostics. QuickJS remains only in the native compiler's isolatedcomptimehelper and as standalone regex/Unicode libraries.
Features
process.constrainedMemory()andprocess.availableMemory()read the process's own cgroup limits, as Node.js does through libuv.
Performance
- Map and string lookups do less work. Absent string keys are rejected before the map is probed, and multi-byte substring searches no longer call
memchrfor every first-byte hit. - Class property bags are read without being created.
- Runtime packs for Linux musl, Windows and WASI are much smaller. Their dev runtime objects no longer carry undefined-behavior checks, matching the glibc and macOS packs.
Fixes
- Native program objects use runtime ABI v14. The embedded JavaScript runtime's symbols were removed, so external object consumers must link the matching v0.3.0 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.2.10
Features
- Contract types check extra promises at compile time. The new types-only
@scriptc/typespackage addsNoThrow<T>,Int32,Immutable<T>,AcyclicandProgramLifetime. They mean nothing to TypeScript or Node.js, but scriptc proves each one or fails the build with a diagnostic that names the throwing path, the non-int32 store, the write that breaks immutability or the reference cycle. ProvenInt32slots are stored as native integers, immutable module constants take no reference counts, and program-lifetime classes skip reference counting and cycle collection. Outside worker programs, a surroundingtry/catchdischargesNoThrow.
Performance
- Construction and narrowed reads do less work. Private constructor stores drop publication guards, construction-only fields are borrowed, string-keyed
Mapreads retain inline, and narrowed member reads are rechecked only when a call can invalidate them. - Indexed reads and integer code are cheaper.
charCodeAtat proven integer indices skips the double round trip, literalswitchstatements dispatch without range tests, indexed-read helpers are inlined, identity bitwise forms over proven int32 operands return the operand, and array counters use signed conversions. - Allocation is faster and smaller. Small arrays are sized exactly, map storage stays on the runtime allocator, array element reference-count entry points live in one shared descriptor per element type, glibc's large blocks use transparent huge pages, and Linux pre-faults allocator memory on a helper thread.
- Runtime throw paths stay out of line, so hot code around checks that rarely fail stays smaller.
Fixes
- Published object graphs stay immutable in more cases. A constructor that stores
thisinto its own field keeps its publication guards, and calls that may replace a field keep their own reference to arguments read from it. - Native program objects use runtime ABI v13. Array headers changed, so external object consumers must link the matching v0.2.10 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.2.9
Features
os.availableParallelism()works in static programs.--detached-exitfrees the address space afterprocess.exitoff the critical path, so large programs exit sooner.
Performance
- Cycle-capable objects are smaller. A 16-byte collector header, typed rest spreads, leaf capture boxes, rarely used array storage moved out of line, and tracing only types that can actually lie on a cycle.
- The heap and cycle collector scale better. Busy small-object slices use transparent huge pages, the collector's growth fraction widens further on large live heaps, and
Map/Setclearanddeletecost O(live) rather than O(peak). - Indexed reads are cheaper. Typed-array reads stay plain numbers where
undefinedacts likeNaN, unproven indexes are checked with a signed round trip, lengths and in-range indexes convert to doubles without the unsigned sequence, nullable-union array elements are read inline, and counted loops that start from an unproven value run on integer counters. - Worker programs pay less overhead. Fewer termination polls, an exact per-thread pending word, a call-free macOS stack guard, and exiting worker threads return their free pages to the system.
- More receivers and fields stay native. Optional-chain receivers are borrowed,
int32fields surviveErrorsubclasses that forward constructor arguments, and method calls stay native when only an unrelated callback field shares the name. - Compiler-scale programs compile without hitting V8's string limit. Serialized IR is streamed.
Fixes
- More values behave as in Node.js. Missing array and typed-array reads stay
undefinedthrough number arguments, narrowed slots and lambda results, andnullstays distinct from the temporal dead zone in forward-captured bindings. - Union class fields work in more shapes. Optional base-class receivers are narrowed before shared field access, and fields declared with different types across a union can be read and written.
- Workers share descriptor tables safely, and live array references are accessed one element at a time.
- Native program objects use runtime ABI v12. Runtime object layouts changed, so external object consumers must link the matching v0.2.9 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.2.8
Features
- Workers can share immutable object graphs without copying. The new
@scriptc/threadspackage addspublish(value), which makes a graph read-only so native executables hand the same objects to every worker by reference; Node.js runs its JavaScript implementation. Deeply frozen plain data sent to workers is also shared rather than cloned. - Deep recursion throws a catchable
RangeError. Recursive functions check the native stack on Linux and macOS and throwRangeError: Maximum call stack size exceededon the main thread, in workers, and inside async functions and generators, which now run on 512 KiB stacks. - Compile blockers and Node.js differences are easier to act on. Diagnostics explain what stopped a compile and where native behavior differs, and a rejected declaration now reports its own diagnostic instead of only a follow-on error.
Performance
- Large executables compile faster and rebuild incrementally. Code is divided into partitions that are optimized and compiled in parallel, with small functions imported across partitions for inlining, and rebuilds reuse the partitions an edit does not touch.
- Native code does less reference-count and allocation work. Nullable references are stored as plain pointers, release fast paths are inlined without cycle-color writes, more parameters, receivers and locals are borrowed, provably 32-bit integer fields and values use native integers, and temporary arrays are avoided.
- Strings, collections, loops and exceptions use more direct paths. Strings cache a proven-ASCII flag and read elements inline, number-keyed Maps and Sets index directly, loops over arrays without holes read elements directly, and exception checks run inline.
- Programs that create workers pay far less overhead. A per-thread allocator, initial-exec thread-local storage and a single exception alert word keep single-threaded code in worker programs close to its non-worker speed.
Fixes
- More values behave as in Node.js. Out-of-range typed array reads, holes in
for...ofloops, object literals built from missing array elements, and class fields read before assignment all produceundefined. Optional values keep their state through callbacks, captures,pop()and initialization order. - Weak collections accept more keys. Records and arrays reached through unions and empty object literals work as
WeakMapandWeakSetkeys. - Debuggers stop only at user code. Shared helpers no longer appear on user source lines, so a breakpoint on a line stops only at that line's code.
- Native program objects use runtime ABI v9. External object consumers must link the matching v0.2.8 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.2.7
Features
- Supported import cycles initialize in module evaluation order. Compiled modules preserve shared instances, hoisted function calls, and temporal-dead-zone checks across cyclic imports.
- Typed returns carry more native values. Optional values, never-returning calls, and native collection iterators retain their supported behavior across typed function boundaries.
- Native terminal and filesystem metadata expands. Standard terminal stream properties and filesystem error fields are available in supported static workflows.
- An opt-in speed mode trades executable size and build time for runtime performance.
--optimization=speedenables runtime inlining, inline reference counting, and x86-64 runtime alignment while preserving the default release mode.
Performance
- Native allocation and cycle collection do less work. A small-object allocator serves strings, arrays, and records; safe allocations and releases are emitted inline, and cycle scans back off for long-lived graphs while keeping static executables small.
- Arrays, collections, and callbacks avoid repeated work. Large dense arrays avoid the former sparse-storage cliff, direct element access and callback calls reduce boxing, and string-keyed Maps reuse cached hashes. Optional element reads and captured parameters avoid temporary wrappers where safe.
- JSON, numbers, and regular expressions use more direct native paths. Supported typed JSON parses directly into records, common number conversions use specialized paths, and regular expressions reuse compiled patterns and subject decoding with a native matcher for supported ASCII subjects.
- Async execution and native I/O reduce overhead. Supported await-free async functions avoid fibers, fiber switches save only required registers, HTTP responses coalesce headers and bodies, and console and process streams write directly to descriptors.
Fixes
- Class, record, and callback values preserve more JavaScript behavior. Class references retain identity through unions and collections, adapted callbacks remain the same function, and record field presence stays distinct from an explicit undefined value. Data-property writes no longer incorrectly mark unrelated class methods as replaced.
- Console line buffers account for concatenated string parts. Long template literals and string concatenations reserve sufficient space before output.
- Native program objects use runtime ABI v8. External object consumers must link the matching v0.2.7 runtime pack; the versioned marker rejects incompatible runtime objects at link time.
0.2.6
Features
- Native worker threads run statically compiled entry points in parallel. Supported
node:worker_threadsworkflows include worker data, structured messages, lifecycle events, and cooperative termination, with isolated module state and heaps. - Shared buffers and integer Atomics enable worker coordination. Supported shared views preserve backing storage across messages and provide atomic integer operations plus Int32 wait/notify.
- More generic class and interface patterns compile natively. Concrete generic inheritance, forward references, nullable substitutions, checked class assertions, and live interface receivers preserve type and object identity.
- Native library calls cover more text workflows. Synchronous file reads accept supported runtime encodings, and regular-expression replacement supports callbacks.
Performance
- Text, collections, and byte processing avoid repeated work. Structured output, streamed split loops, keyed storage, primitive array sorting, scalar string access, and proved numeric operations reduce intermediate allocation and conversions.
- Reference handling does less ownership work. Stable loop references and synchronous callbacks borrow safe inputs, while cycle collection adapts to mature graphs.
- Compilation reuses source and type information and parallelizes large native builds. Source discovery, checker metadata, semantic queries, and AST traversal avoid repeated work.
Fixes
- Deep reference chains clean up with bounded stack use. Native teardown preserves ownership across generated objects and runtime containers.
- Generic limits and diagnostics better match the failing source. Independent concrete instantiations no longer share a global specialization cap; recursive demand remains bounded, and diagnostics retain source-file identity.
0.2.5
Features
- Buffer.from accepts runtime string encodings. Native string conversion preserves encoding defaults and aliases, with catchable validation errors.
Performance
- Filesystem reads and typed-array processing do less copying. File reads use owned storage directly, while typed-array conversion, copying, and filling avoid unnecessary intermediate work.
- Collections and object properties use storage more efficiently. Array construction and mutation, stable sorting, string-keyed Maps and Sets, and wide object lookup reduce repeated allocation and traversal.
- JSON, regular expressions, and string operations scan and allocate less. Shared scans, batched output, and reused byte and character positions streamline parsing, serialization, replacement, normalization, and navigation.
- Native values and compiler queries avoid repeated work. Safe borrowing, local tagged storage, direct collection reads, reused source metadata, and batched checker requests reduce temporary wrappers and ownership traffic.
Internal improvements
- Compiler code has clearer responsibilities and consistent source tooling. Builtin, conversion, function, container, and native build code is organized into focused modules, with shared contracts and oxlint/oxfmt checks for normal JavaScript and TypeScript sources.
0.2.4
Features
- Native Maps and Sets accept boolean, bigint, and mixed-value keys. Collection construction and storage preserve identity, insertion order, and iteration behavior.
Performance
- Numeric loops and byte access need less runtime work. Integer facts flow through loops and typed-array access, while Buffer and DataView numeric operations avoid redundant conversions and proven bounds checks.
- Native text, collection, and checked-value paths reduce ownership and allocation overhead. String construction writes directly to final storage, and safe input borrowing, value reuse, and cycle cleanup reduce intermediate work.
Fixes
- Windows toolchain assets resolve through linked packages. Native launches locate installed assets from the physical package manifest path.
0.2.3
Features
- Node 24 filesystem and URL coverage expands. Filesystem support adds capacity queries, link handling, timestamps, and file URL byte conversion with platform options; URL handling adds authority, protocol, and mutation behavior.
- Web Streams support covers more workflows. Writable and readable streams add controller and reader operations,
tee, pipelines, and streaming encoding. - Embedded Node compatibility adds module and utility APIs. CommonJS and ESM metadata, diagnostics channels, deep equality,
util.types,util.styleText, text and system error utilities, MIME utilities, and no-error assertions gain support. - Native Set construction accepts supported collection iterators.
Performance
- Compiler analysis avoids repeated metadata and tree work. AST child lookups, class and record metadata, graph propagation, and exception analysis are reused or streamlined.
- Native array iteration does less work. Optimized loops preserve live tuple iteration behavior.
Fixes
- Native values keep valid lifetimes across helper and collection operations. Array borrowing, map reads, string concatenation, and helper calls preserve values for their full use.
- TypeScript runtime package sources emit consistently.
0.2.2
Features
- More Three.js CPU workflows compile natively and to WASI. Support expands across procedural geometry, curves, animation blending, mesh deformation, material and texture data, in-memory model loading, and CPU node graphs. Compiled libraries can send geometry, material state, and resource lifecycle notifications to an external rendering host.
- Stored Map and Set iterators compile statically. Native cursors support
next(), function arguments,for...of, spreads, and mapper-lessArray.fromwhile preserving live collection behavior and reference identity. - Native filesystem and crypto support expands. Descriptor I/O and FileHandle vector and control operations compile statically, alongside scrypt, HKDF, and additional SHA-2 algorithms. Embedded packages gain the corresponding Node 24 behavior.
- Node 24 URL, environment, and text utilities gain native support.
URL.canParse,URL.parse, URL JSON serialization,util.parseEnv,process.loadEnvFile,TextEncoder.encodeInto, and buffer validation and transcoding compile without an embedded JavaScript engine. - Embedded packages support more asynchronous event and timer flows.
events.onadds buffered iteration, cancellation, close events, backpressure, and listener cleanup;events.onceaccepts EventTarget inputs and cancellation, and abort listeners support disposal. Promise timers and scheduler operations add cancellation and reference controls, with buffered interval iteration and native timer-handle lifecycle behavior.
Performance
- Compilation avoids repeated queries, scans, and allocations. Frontend type queries and JavaScript binding analysis, native IR traversal, union transformations, artifact dependency collection, and serialization do less repeated work.
- Native build preparation overlaps independent work. Compiler fingerprinting and native-driver discovery run concurrently, with more bounded parallel fingerprint reads while preserving cache identity and invalidation behavior.
Fixes
- Static JavaScript workflows preserve more class and callable behavior. Inferred class fields, inherited members, method dispatch, callable identity, collections, and async values retain their supported state across compiled package boundaries.
- Integer-boundary inference accounts for both zero signs. Division and powers involving zero no longer produce unsafe integer proofs for negative-zero inputs; safely clamped results retain their supported proofs.
- Embedded Node utilities preserve more input and lifecycle behavior. Argument parsing and callback/promise adapters handle more Node 24 validation, metadata, and error cases. EventEmitter preserves once-listener reentrancy, symbol names, and error-monitor ordering, while StringDecoder handles more input views and split encoding boundaries.
0.2.1
Features
- More Effect 3 and Effect 4 programs compile statically. Support expands across tested async and concurrent flows, services and layers, resource management, streams, schemas, and collections in the published packages.
- Three.js CPU workloads cover more geometry and animation. Geometry merging, instancing, and keyframe interpolation compile without an embedded JavaScript engine.
- Typed-array constructors and prototype methods preserve more JavaScript behavior. Native compilation supports constructor aliases, shared backing storage, chained indexed assignments, and mutable prototype methods with receiver dispatch.
Fixes
- Native installs are smaller and more portable. GNU/Linux compiler distributions support glibc 2.34 or newer and use statically linked LLVM helpers. The compiler bundles its host runtime; cross-target runtime packs are optional project dependencies pinned to the compiler version.
- Native values retain identity across more typed and untyped boundaries. Collections, class instances, inferred arrays, and mixed JavaScript return values preserve their supported storage and dispatch behavior.
- Effect platform callbacks and native streams preserve their state. Expanded lowering retains callback behavior, and promise storage keeps the layout required by cycle collection.
0.2.0
Breaking changes
- LLVM is the only code generation backend. C emission, the debugging C backend, and automatic C fallback have been removed. Replace
--backend=cwith the default backend, use--emit=llvmto inspect generated code, and change library profiles with"emission": "c"to"emission": "llvm".--emit=cis no longer accepted. - The installed CLI is a native executable. npm installs the matching platform package on supported macOS, Linux, and Windows hosts. Native compilation, compile-time evaluation, and native execution no longer require Node. Node 24 or newer is still required for npm installation, the JavaScript compiler API, source development, and
scriptc runof WASI modules. Executable linking still requires the target's linker and SDK or sysroot; Zig remains required for the targets that use it.
Features
- scriptc ships a self-hosted native compiler. The CLI bundles the native TypeScript 7 parser and checker, LLVM helper, precompiled C runtime pack, declarations, and compile-time evaluator. Standalone compiler archives are available alongside npm packages.
- Published Effect generators compile statically. With
--npm-static=effect, the testedEffect.gen,Effect.succeed,Effect.log, andEffect.runPromiseflow compiles from the unmodified package without an embedded JavaScript engine. Unsupported reachable Effect code still produces diagnostics. - Three.js CPU workloads compile natively and to WASI. Static package compilation supports math, scene graphs, cameras, geometry, meshes, materials, and tested raycasting and collision queries. WebGL rendering, DOM integration, and native graphics windows remain unsupported.
- WebAssembly libraries expose callable exports and host imports. WASI Preview 1 reactors support library profiles, synchronous host callbacks, explicit memory ownership, and independent module instances. Browser hosts supply their own WASI adapter and rendering integration.
- Native FFI supports more library interfaces. Static
node:ffibindings add exact 64-bit and pointer ABIs, native memory views, reusable callback pools, and Darwin framework linking. - More ordinary JavaScript stays native. Support expands across identity collections, numeric typed arrays, property descriptors, local class factories, callable properties, inherited fields and accessors, generator and async methods, and runtime-length argument spreads into supported signatures.
Performance
- Compilation does less repeated frontend work. Syntax metadata, property lookups, library signatures, and recursive class analysis are reused, while optional-value analysis and lowering avoid redundant traversal and copying.
- LLVM output shares recursive value converters. Deduplicated helpers reduce generated code and the work needed to produce native objects.
- Startup avoids unnecessary work, and release artifacts are smaller. Host libc detection is cached, the JavaScript API loads TypeScript 5 only when needed, and release runtime packs omit development debug payloads.
Fixes
- Untyped JavaScript boundaries preserve more native values. Class state, shared arrays, nullable fields, constructor results, collection identity, and typed-array backing storage retain their supported semantics across calls and storage.
- Static library builds honor explicit package selections. Packages named in a library profile's
npm_staticlist are attempted even when they do not ship declarations. - Terminal and process integration handles more native behavior. Stored process streams, terminal signals, and exception handlers that resume queued work are supported across the tested native paths.
0.1.7
Features
- Development builds support native source debugging.
--optimization=devadds TypeScript and JavaScript source locations across the C and LLVM backends, with source-named variables in LLVM builds. - More Math operations compile statically. Additional constants and methods include hyperbolic functions,
clz32,fround,imul,expm1, andlog1p. - Static Promise handling supports rejection callbacks.
Promise.prototype.thenaccepts both fulfillment and optional rejection handlers, including returned promises. - Static compilation accepts more package layouts. Installed entries can compile their own TypeScript and JavaScript imports, and CommonJS packages with safe export prologues remain eligible for static compilation.
- Fixed tuple spreads compile in tuple literals. Const tuple inference is preserved when checked with
satisfies. - Dynamic
globalThisexposes Node host globals. Escaping through the global object initializes the same Node globals used by embedded modules.
Performance
- Async and generator fibers commit stack memory on demand. They retain their existing stack capacity while using less committed memory.
- Development builds compute compiler fingerprints faster. Parallel fingerprint reads preserve the existing cache identity and invalidation behavior.
Fixes
- Caught and rejected values preserve JavaScript object classification. Native exception handling distinguishes objects from primitive values across catch and promise paths.
- TypeScript project settings and Node declarations are preserved. Built-in default imports honor effective project options, and
RequestInforemains available across imported sources. - Optional chains and dynamic option records retain supported values. Array callbacks inside optional chains, narrowed optional receivers, and records containing abort handles compile correctly.
- Compiler analysis handles more edge cases safely. Deep or shared type graphs no longer overwhelm diagnostics, and property names spelled
argumentsare not treated as reads of the special binding.
0.1.6
Features
- Static Array behavior covers construction, mutation, indexing, flattening, splicing, and joining. Array construction and iterable conversion,
fill,copyWithin, relative-index coercion,flat, splice insertion, and join coercion now compile with JavaScript semantics. - Static Object and String operations expand. Own-property checks, prototype tags,
String.prototype.at,codePointAt, andsplitcoercions now compile with Node-compatible behavior.
Performance
- Array, string, and terminal operations use fewer resources. Array comparisons and string operations allocate less, fibers reuse stacks and release cached memory while idle, and terminal dimensions come directly from native streams.
0.1.5
Features
- Static HTTP support covers more client and server behavior. The
node:httpsurface adds request and response controls, timeout and event handling, connection shutdown behavior, and stricter header validation. - Static numeric APIs expand.
Float64Array, indexed compound assignments, and additional analytic and remainingMathfunctions compile natively. - Array and string search calls handle more JavaScript inputs. Static
includes,lastIndexOf, and positioned string methods accept omitted and primitive search values while preserving position coercion. - Published Effect modules can compile statically. The npm-static path follows reachable exports through package modules and prunes unused package code.
- Executable stripping is available as an opt-in build option.
Performance
- LLVM emits faster numeric operations. Proven integer arithmetic and numeric remainder use direct operations, and numeric array reads avoid redundant boxing, retains, and temporary records.
Fixes
- Static JavaScript coercions preserve Node behavior across more call forms. String padding and search,
Numberconversion, and narrowed string and buffer calls now handle unions, wrappers, objects, nullish values, and omitted arguments correctly. - Dynamic islands load more legacy packages. Redis 6 entry points and callable
EventEmitterusage work with the island runtime. - Published LLVM helpers retain executable permissions.
- Switching build modes preserves reusable artifacts.
0.1.4
Features
- Static module interoperability expands.
node:modulecoverage, CommonJS factory exports, and statically analyzable literal dynamic imports compile through the native module graph. - Node built-in functions work as values. Supported
node:path,node:fs, and other built-in functions can be stored and passed around while preserving static calls. - Static call lowering handles more JavaScript shapes. Overloaded callable specialization, fixed-tuple argument spreads, union receiver calls, and loose equality now compile natively.
- Compression APIs expand. One-shot and callback-based zlib codecs compile statically.
- Child-process APIs gain IPC and callback coverage.
forksupports parent-child messaging,execFilesupports inline UTF-8 callback options, and shell output can be captured. - Static HTTP servers enforce Node's Host rules and support trailers. HTTP/1.1 requests require
Hostby default and return Node-compatible 400 responses, with opt-out and HTTP/1.0 handling preserved; incoming chunk trailers expose raw and distinct values, while outgoing trailers support framing and streaming. - Filesystem and URL support expands. Static filesystem support adds synchronous buffer overloads, async
realpath,lstatmetadata,readdirwithDirent, and descriptor operations; URLs add credential, origin, port, and hash behavior. - Date, process, and event APIs gain static behavior.
Date.parse, writableprocess.exitCode, and scoped computedEventEmitternames compile with Node behavior. - Static Set construction accepts readonly tuple seeds. Supported readonly tuples initialize native Sets while preserving single evaluation and insertion order.
Performance
- LLVM bitwise operations use native integer instructions. Numeric JavaScript bitwise operators now lower to
i32operations on the LLVM backend.
Fixes
- Windows and Linux runtime builds cover more host details. Windows executables support GUI subsystem selection and installed CMake generators, Windows runtimes include native clock and sleep shims, and GNU runtime packs preserve glibc 2.36 compatibility.
- Static npm resolution follows package import maps. Package-scoped imports use edge-specific conditions, and fallback Node declarations include
RequestInfowithout widening supported fetch inputs. - HTTP request parsing bounds and validates trailers. Header and trailer parsing enforce byte and field-count limits, and trailer data is safely discarded when handlers respond before the request body finishes.
0.1.3
Features
- BigInt compiles natively. BigInt literals, arithmetic, comparisons, conversions, storage, byte-buffer and
DataViewoperations, and width boundaries now preserve Node behavior across the C and LLVM backends. - Static crypto utilities expand. Hashes, HMACs, PBKDF2, random fills and integers, timing-safe equality, and one-shot hashing compile through the native
node:cryptosurface with Node-compatible errors. - Child-process stdin is writable.
child.stdinsupports native writes, backpressure, ending, destruction, and lifecycle and error events across the C and LLVM backends. - Commander 15 compiles statically. The npm-static path now preserves the declaration and runtime behavior needed by Commander 15 command actions.
- TypeScript workspace sources compile statically. Source-only workspace package entries now resolve through the program module graph while retaining the existing JavaScript package boundary.
Performance
- WASI release binaries are smaller. Release links strip debug sections while development output retains its metadata.
Fixes
- Generated JSON record keys are valid. Escaped and terminating property names now emit correctly in both native backends.
- Windows console output preserves UTF-8. Attached consoles use UTF-8 without changing redirected byte output.
- Nested recursion and discarded conditionals lower correctly. Mutual nested function references are initialized before capture, and discarded conditional expressions retain lazy control flow.
- Library archives retain section granularity. Per-function and per-data sections now allow consumers to garbage-collect unreferenced archive members.
0.1.2
Features
- CommonJS module graphs compile statically.
require,module.exports,exports, module metadata, caching, cycles, resolution, and failure eviction now follow Node semantics across compiled CommonJS graphs. - Async iteration parity expands. Async generators support queued
next/return/throwrequests, promised yields, cleanup, and class, object, and private methods;for awaitcloses custom async iterators and WHATWG readable streams correctly. - Explicit resource management compiles natively.
using,await using,for using, disposable Node handles, and suppressed disposal errors preserve JavaScript cleanup ordering. - Node module resolution introspection is supported.
import.meta.resolve,require.resolve,require.resolve.paths, andmodule.createRequirehandle supported static requests with Node-compatible resolution and errors. - Static npm declarations preserve overloads.
--npm-statickeeps overload groups from shipped declaration files while compiling package implementations, including Commander command actions. - Unknown values preserve native handles. Class and child handles can round-trip through
unknownwhile private fields remain hidden.
Fixes
- TypeScript compatibility is more faithful. Branded primitive types, leading BOM literals, TypeScript 7 project resolution, and Node type-link behavior now retain their expected semantics.
- Dynamic operations and runtime arguments are more reliable. Dynamic
any-local operators lower correctly, executable-path arguments remain intact, and URLSearchParams sorting scales without quadratic behavior.
0.1.1
Fixes
- Native package releases are more reliable. Musl LLVM helpers build as portable static executables, downloaded helper artifacts retain executable permissions, and npm publishing reconciles asynchronous staged versions on retry.
0.0.37
Features
- Sparse arrays preserve JavaScript missing-value semantics. Native arrays now distinguish holes from explicit
undefinedacross reads, writes, callbacks, searches, sorting, serialization, destructuring, spreads, and nested consumers, with differential coverage across the C and LLVM backends. - Static ESM modules expose import metadata.
import.meta.url,import.meta.filename,import.meta.dirname, andimport.meta.mainlower to module-local constants for static ESM programs, including imported modules and WASI paths. - LLVM native output covers additional host and cross targets. Matching helpers and runtime packs now support macOS x64, Linux glibc and musl, Windows x64, and WASI alongside macOS arm64.
- Native linking is separated from C compilation. LLVM builds can use a platform linker with program objects and precompiled runtime packs, while explicit C, fallback, and sanitizer builds retain their existing compiler path.
- Node.js compatibility has a generated v24 matrix. Static-native and dynamic-island support are tracked separately in a machine-readable inventory and interactive documentation.
Math.PIandMath.Elower to constants. These standard library values now compile statically in programs and library profiles.
Performance
- Array sorting uses stable merge sort.
sortandtoSortedpreserve stable ties while avoiding quadratic comparator behavior on large inputs.
0.0.36
Fixes
- Library host-callback re-entry now traps deterministically. Entering an export or library control/registration ABI symbol while a synchronous host callback is active delivers the structured
SC4026diagnostic to the existing panic sink, attributes the attempted inner symbol, and poisons only that library instance.
Features
- macOS arm64 executables use release-built runtime packs. LLVM-tier builds now emit the program object through the bundled helper and link feature-selected, hashed runtime/vendor artifacts without compiling C on the user's machine. Explicit C, LLVM fallback, and sanitizer builds retain the external C-toolchain path.
- Builds can stop at typed IR, readable C, or textual LLVM IR.
scriptc build --emit=ir|c|llvmwrites one primary source artifact with stable default suffixes and requires only Node—no external compiler, archiver, linker, or executable cache.--emit=exeremains the default, and executable builds retain the former additive--emit-irflag for one release with a deprecation warning; library mode keeps its additive--emit-iroption.
0.0.35
Performance
- Development builds reach native output sooner. Exact executable cache hits route through the lightweight CLI before loading the compiler, while uncached dev builds use
-O0and split large LLVM programs and libraries into stable, parallel, independently cached objects. npm installation also warms toolchain-specific runtime, TLS, and dynamic-engine artifacts for later builds. - The TypeScript frontend asks the checker for less work. Lowering batches structure, reachable-body, call, receiver, and implicit-instance queries by phase, memoizes immutable type constituents, and avoids querying dead bodies or visibly non-object array candidates.
Fixes
- Unsupported
Array.fromelement shapes refuse cleanly. Mapper results that the backends cannot represent are diagnosed or deferred before emission instead of reaching a C emitter crash. - JSDoc record equality reads preserve dynamic property behavior. Dot and bracket reads used by strict-equality and missing-key probes now route through checked-dynamic lookup, preserving absent properties and object identity.
0.0.34
Performance
- Library builds reuse more validated work. Unchanged frontends, comment-only edits, lowered IR, and emitted C or LLVM translation units can be restored from the persistent cache while semantic, configuration, package-resolution, toolchain, and source-annotation changes still invalidate safely; volatile library identity is refreshed independently.
- Reachable library code is lowered once. Module assembly reuses retained lowering output without re-lowering function bodies, preserving reached-only artifact filtering, coverage remainder behavior, and output ordering while reducing repeated compiler work.
- Same-shape record spreads emit smaller code. Reusable clone helpers and outlined large-record copies reduce generated C and LLVM code while preserving ownership, integer proofs, and runtime behavior.
0.0.33
Features
- Foreign-thread native callbacks are marshalled to the event loop. FFI format 5 adds
invoke: "foreign"for retained, context-bearing,voidcallbacks. Thread-safe generated trampolines copy scalar/string/byte arguments into plain staging memory, wake the process loop, and return immediately; the loop delivers one callback per turn on the script thread with ref'd registration liveness, concurrent-producer FIFO safety, explicit release, throw propagation, and clean shutdown across both backends. - Native callbacks can be retained and explicitly released. FFI format 4 adds
lifetime: "retained"registrations and pairedreleasedescriptors that reuse the original function-pointer trampoline. Registrations pin captured closures until the same function value is released, count duplicate registrations, support multiple context-bearing registrations and raw single-slot replacement, defer callback throws through later FFI pump calls, and clean up live registrations at process exit across both backends. - Native callbacks copy in strings and byte spans. FFI format 3 adds callback-only
cstringparameters plus length-delimitedstringandbytesparameters. Trampolines in both backends copy native memory into owned scriptc values, decode malformed UTF-8 with U+FFFD replacement, preserve embedded NUL bytes in spans, and trap precise invalid null pointers before invoking the closure. Array.prototype.filteraccepts JavaScript-truthy predicate results. Static predicates may return strings, numbers, references, or supported unions and now keep elements according to JavaScript'sToBooleanrules instead of requiring a boolean result. Checked-dynamic calls without a predicate reach the runtime's callback error, while predicates whose return value was erased tovoidrefuse rather than producing the wrong array.
Performance
- Repeated builds avoid redundant compiler work. Validated native-toolchain metadata and same-output artifacts persist across CLI processes with dependency and content checks that preserve cache invalidation; Node 24's bytecode cache reduces CLI startup work, frontend type lowering is memoized and checker prefetch avoids unused AST queries, and library profiles gain a fast
optimization: "dev"posture plusSCRIPTC_TIMING=1phase diagnostics. The compiler CLI now requires Node 24 or newer.
0.0.32
Features
- Cross-compilation targets ARM64 Alpine Linux.
SCRIPTC_TARGET=aarch64-linux-muslproduces statically linked executables and library archives through both backends, including async and generator fibers, runtime localization, multi-instance libraries, and the full portable differential contract. Cross-tool failures also retain the compiler's useful stderr or stdout diagnostics instead of losing the underlying error.
Fixes
- Windows TLS trusts the native system certificate stores. TLS and HTTPS clients now load, policy-filter, and deduplicate server-auth roots and intermediates from the applicable user and machine stores;
tls.getCACertificates("system")exposes the same live trust source. - Library integer proofs preserve JavaScript's NaN comparison behavior. Failed ordered comparisons no longer narrow a value when either operand may be NaN, preventing an unsafe integer-boundary proof, while the false edge of
!==correctly proves equality and clears the NaN alternative.
0.0.31
Fixes
Array.isArrayrecognizes fixed tuples. Readonly tuple arms now retain JavaScript array identity and their runtime-tag narrowing throughArray.isArray, so Native SDK-style values such asModel | readonly [Model, Command]compile and preserve tuple indexing,.length,slice, andmapbehavior.
0.0.30
Features
- Library archives call back into their host. A profile's
callbacksarray declares named channels over the marshalling classes (bytes, string, f64, bool, and the u8/u32/i32 plumbing classes; scalar returns), andabi.callback_register_symbolnames the registration entry point: the host supplies a function pointer and an opaque context per channel, and compiled code reaches a channel as a signature-only ambient function whose direct calls deliver synchronously on the calling thread, buffers borrowed for the duration of the call. Registrations are per instance, matching the panic sink underabi.localize_runtimeandabi.instance_per_thread. Calling an unregistered channel is a structuredSC4025trap through the sink naming the channel and the entry; a call the profile's channels cannot serve refuses at compile time withSC4024. Profiles without acallbackssection produce unchanged output.
0.0.29
Features
- Library archives build for iOS and Android.
SCRIPTC_TARGET=aarch64-apple-ios,aarch64-apple-ios-simulator, andaarch64-linux-androidproduce library-mode static archives for an embedding app to link — Xcode projects on the Apple side, Gradle/NDK builds on the Android side. iOS archives compile against the selected Xcode SDK with an iOS 15.0 minimum (stamped into every object'sLC_BUILD_VERSION) and localize with the macOS host linker; Android archives compile against the NDK's bionic headers at API level 26 and use the same in-process ELF localization as the Linux cross targets. Multi-instance (abi.localize_runtime) and thread-instanced (abi.instance_per_thread) profiles carry over unchanged, verified by simulator- and emulator-executed probes; standalone executable builds refuse these targets with a pointer to--lib.
0.0.28
Features
- Runtime-localized library archives build for Windows and cross targets.
abi.localize_runtimenow follows the target object format: COFF localization runs in process for native and cross Windows builds, ELF cross builds use Zig plus in-process symbol demotion, and macOS cross builds work from Darwin hosts. The existing independent-instance and per-thread composition contracts now carry across the supported Windows and Linux targets; unsupported host-target pairings still refuse before emission.
0.0.27
Features
- Library archives support independent instances in one process.
abi.localize_runtimecombines an archive's reached program, runtime, and vendor objects and hides every definition except its profile-declared ABI, so archives with distinct symbol prefixes link together without collisions or shared mutable runtime state. Each instance owns its allocator, collector, result arena, and panic sink, and a trap poisons only the instance that raised it. Localization is available for host-native Darwin and Linux builds and refuses cross-target builds before emission. - One library archive can serve an independent instance per embedder thread.
abi.instance_per_threadmoves mutable program and runtime state into thread-local storage while keeping immutable interned data shared, preserving the existing entry family with the calling thread as the instance selector. Each thread initializes and owns its instance for its lifetime, including its collector, result arena, panic sink, and poison state. Thread instancing composes with runtime localization, remains opt-in, and leaves classic archives unchanged.
0.0.26
Features
- WebAssembly is a production target.
SCRIPTC_TARGET=wasm32-wasiemits a standalone WASI Preview 1 module through the LLVM backend, andscriptc runhosts it with inherited stdio and environment plus preopened working and temporary directories. The full portable language tier includes checked dynamic values, async/await, promises, generators, timers, filesystem work, and--dynamic; APIs whose capabilities WASI does not provide refuse before linking with a targeted diagnostic instead of producing a broken module. - Cross-compilation targets Alpine Linux directly.
SCRIPTC_TARGET=x86_64-linux-muslproduces a statically linked executable with Zig, backed by musl-specific runtime shims for randomness, fibers, and child-process working directories. Executables and library archives are validated against Alpine alongside the existing glibc targets. - Native FFI accepts C function-pointer callbacks. Format 2 describes callback pointers and opaque contexts as independently positioned ABI entries, adapts ordinary capturing TypeScript closures through both backends, and preserves scalar C conversion and catchable callback throws. Raw callbacks without userdata use a binding-specific same-thread trampoline. The initial lifetime policy is explicit and bounded: callbacks are valid only during the native call; retained and foreign-thread callbacks remain rejected by contract.
- HTTP and HTTPS servers expose Node's timeout configuration statically.
timeout,keepAliveTimeout,keepAliveTimeoutBuffer,headersTimeout, andrequestTimeoutretain Node's defaults and independent per-server storage through typed and dynamic reads and writes. The HTTP and HTTPS constructors also accept and validatekeepAliveTimeoutBuffer; this surface configures the values, while deadline enforcement remains a separate server behavior.
0.0.25
Fixes
- Busy sockets no longer starve the native event loop. Readable wakes now yield after a bounded batch, allowing timers and other descriptors to keep progressing even while upgraded connections are continuously flooded.
0.0.24
Features
- Everyday filesystem work stays static across more of the file lifecycle.
fs.rename,fs.renameSync, andfs/promises.renamelower with Node's callback, promise, replacement, and platform error behavior;fs.writeSynccovers the Buffer-window and UTF-8 string overloads with current-offset and positioned writes; andfs/promises.openreturns a nativeFileHandlewithfd,read,write,readFile,writeFile,appendFile,stat, and idempotentclose. The three-argumentfs/promises.writeFileaccepts the supported UTF-8 and creation-mode options, while filesystem stats exposeblocks,nlink, andatimeMsthrough path, promise, file-handle, and dynamic-bridge results. - Native text decoding covers the WHATWG encoding families. A statically labelled
TextDecoderrecognizes the standard aliases for the legacy single-byte, UTF-16, Chinese, Japanese, and Korean encodings, including BOM handling and malformed-input recovery matching the pinned Node runtime. Runtime-valuedBufferEncodingarguments also work inBuffer.toString, with case-insensitive aliases, optional defaults, range behavior, and Node's unknown-encoding errors. util.parseArgscompiles statically. Boolean and string options, short and clustered spellings, repeated values, defaults, negative options, positionals, token output, permissive parsing, the live defaultprocess.argv, and Node's coded validation errors lower through both backends.- Array mutation and bounded string splitting grow their static surface.
Array.prototype.unshiftandreversepreserve mutation, spread, evaluation order, and reference identity, whileString.prototype.splitaccepts JavaScript limits for string and literal-RegExp separators withToUint32semantics. process.stdout.writeandprocess.stderr.writeaccept encoding and completion arguments. String chunks honor supported encoding aliases, byte chunks retain their bytes, and successful completion callbacks join the next-tick queue in Node's order on both backends.
Performance
- Canonical typed-array loops use native integer induction. Both backends recognize semantics-safe byte loops and emit integer counters and direct byte indexes, avoiding repeated floating-point index conversion while preserving the general fallback whenever the loop shape cannot prove the rewrite.
0.0.23
Features
- Read-only
Datevalues compile statically. Zero-argument and single-value construction, storage and passing,getTime/valueOf,toISOString, UTC and host-local calendar getters, andgetTimezoneOffsetlower through both backends. Construction applies ECMAScript TimeClip behavior, the supported ISO and certificate-date strings parse without an embedded engine, and valid extreme years retain calendar answers even beyond a platform CRT's native range. - The native web surface grows response construction and fetch cancellation.
new Response(body, init)covers the supportedBodyInit,ResponseInit, header mutation, conversion, validation, and stream-error semantics, whileAbortControllersupplies shared native signal state, abort events and reasons, and preflight or in-flightfetchcancellation across the static and dynamic tiers. fs.readSyncaccepts positioned reads. A numeric position reads without advancing the descriptor, while omitted,null, and-1positions preserve current-offset behavior; validation order, zero-length reads, EOF, and partial Windows reads match Node.
Fixes
- Top-level
awaitmarks an implicit ES module. TypeScript and JavaScript files without an explicit import or export now follow Node 24's syntax detection, package-type precedence, module scoping, andrequirediagnostics instead of being misclassified as CommonJS. - Cycle collection stays fast on large live heaps. The runtime now collects cycles generationally, promotes survivors, and schedules bounded mature passes, avoiding repeated whole-heap walks while retaining full sweeps for cross-generation garbage and shutdown auditing.
- Typed-array reads, writes, and lengths use specialized native lowering. Both backends emit operations directly from the IR element kind while preserving numeric coercion, bounds behavior, and receiver lifetime across side-effecting index and value expressions.
0.0.22
Features
- Coverage can analyze projects with embedder-provided module surfaces. Repeatable
--external-types <specifier=file.d.ts>mappings give the checker a local declaration for an otherwise unresolvable bare specifier, so project-owned statements remain measurable. The mapping is coverage-only and never invents execution semantics: value imports and uses stay explicit SC1010 external-host blockers, while type-only structural use can remain fully static. - Production and library builds persist compilation work. A bounded content-addressed cache is enabled by default: unchanged executables and library archives skip native code generation/linking, while source edits reuse separately keyed runtime objects (including library mode's
-DSCR_LIBflavor) and rebuild only the program translation unit. Identities include resolved system-header dependency bytes plus linker/assembler identities, and checksums protect complete artifacts as well as runtime objects. The compiler remains required so every cache-enabled invocation rediscovers dependency selection; metadata-probe failures fall back to an ordinary build, and the configured size cap is enforced after writes. FFI builds with archive/object inputs or ambientsystem_librariesdeliberately relink on every invocation so a transitive or in-place native rebuild cannot return stale code; their runtime objects remain cached. Mutable compiler input paths such asCPATHandSDKROOT, and opaque compiler wrappers, conservatively bypass persistent artifacts and objects; opaque archiver wrappers rebuild library program members and archives while retaining runtime-object reuse. Direct Clang, Apple's system Clang shim,zig cc, trusted platform archivers, andzig arretain their applicable persistent tiers. Complete binary hits are checked before any missing vendor prerequisite is rebuilt. Library graphs with no npm package to opt in also retain the auto-detection frontend instead of loading the same graph twice.SCRIPTC_CACHE_DIRoverrides the platform cache root, andSCRIPTC_NO_CACHE=1preserves a fully uncached path.
0.0.21
Fixes
- Contract integer attestations cover synthesized tagged-record payloads. Integer slots declared on lowered payload paths such as
TextInputEvent_set_composition.cursorandMsg_audio_event.atnow carry compile-time write obligations, so fractional writes refuse instead of surviving until runtime encoding. Distinct inline records whose underscore-joined synthesized names collide now refuse instead of reusing the wrong table entry and dropping an obligation. - Same-shaped contract integer slots with the same declared class now share one lowered proof obligation while retaining every source slot path in refusals. Differing-class collisions remain SC4009 until arm provenance can keep their assumptions distinct.
0.0.20
Features
- Contract sidecars accept TypeScript's read-only and named scalar vocabulary.
readonly T[]andReadonlyArray<T>project as the same mutability-neutral slice asT[], while aliases ofnumber,string,boolean, andUint8Arraydissolve recursively to their primitive wire types across models, messages, helpers, and integer slots without adding phantom type-table entries.
Fixes
- A local declaration, import, or type parameter named
Array,ReadonlyArray, orUint8Arrayremains the user's type instead of being mistaken for the same-spelled global and publishing the wrong slice or bytes contract.
0.0.19
Fixes
- Library integer slots compose with optional numbers. A declared
number | nullor optional-number slot projects asoptional<i64>and proves only its present numeric values across records, tagged-message payloads, and helper parameters/returns. When two sidecar paths collapse to the same structurally interned record field, the build now refuses with both paths instead of overwriting one proof obligation without a diagnostic.
0.0.18
Features
- Top-level
awaitcompiles across the program's ESM graph. Module evaluation follows Node 24's dependency ordering, one-time promise caching, cycle rooting, rejection precedence, and unsettled-module exit status 13 in both the LLVM and C backends. Dynamic imports of compiled modules await the same evaluation verdict.
Fixes
https.request(options, responseCallback)compiles on the LLVM backend. The options-object row now lowers the TLS verification and CA arguments through the same runtime ABI as the C backend, including response-callback ownership and event-loop liveness. The already-supportedhttp.request(options, responseCallback)row is pinned alongside it.
0.0.17
Fixes
- The CLI builds and runs programs on Windows. TypeScript's virtual filesystem now sees consistently slash-normalized Windows paths, default executable names carry the required
.exesuffix for both native and cross-target Windows builds, and the workspace build command survives Windows shell quoting. A Windows CI lane pins the path regressions and drivesscriptc runend to end.
0.0.16
Fixes
- Console output is visible promptly.
console.log,process.stdout.write, readline prompts, and writes from dynamic islands now submit their bytes before returning instead of retaining piped stdout until a later flush or normal exit. Live consumers see output as it happens, and output written immediately beforeSIGKILLmatches Node instead of disappearing. - Native Linux builds link with host clang. Linux host builds now expose the glibc declarations the runtime uses and place
libmafter every link input, fixing compile failures from missing declarations and link failures from GNU ld's left-to-right archive resolution. A native Ubuntu clang lane pins the complete static build.
0.0.15
Features
- Outbound native FFI.
scriptc build --ffi <manifest>binds exact signature-only TypeScript declarations to C ABI symbols and links the manifest's archives, objects, and system libraries into the executable — no runtime symbol lookup and no dynamic engine at the boundary. The strict versioned manifest covers numeric, boolean, UTF-8 string, and byte-span parameters plus scalar and void returns; both backends lower the calls, andscriptc coveragerecognizes the same bindings.
Fixes
- FFI profiles validate every configured binding before emit, including unused and shadowed declarations, and reject uninhabited
neverslots instead of letting TypeScript's control-flow assumptions disagree with a returning native function. A same-named local function remains ordinary TypeScript, while missing symbols and other native link failures surface as bounded SC5004 diagnostics rather than internal compiler errors.
0.0.14
Fixes
- Clients resolve hostnames. The http, https, TLS and HTTP/2 clients resolved nothing before dialing, so a request to any name came back ENOTFOUND and only literal addresses worked. Only the dial takes the resolved address — the original name stays on the request, which is what the Host header carries and what SNI and certificate verification see.
net.connect(port, hostname)still refuses to resolve: Node's async lookup semantics on that surface are their own piece of work. - The URL-string form of the http and https clients compiles, along with the URL-object form, which reads as its href through the same parse. The declarations only described the options record, so
http.get("http://host/path")— the first thing a client written from scratch reaches for — was a type error rather than a request. An unparsable input is the WHATWGInvalid URLTypeError and a scheme that is not the calling module's isERR_INVALID_PROTOCOL, both catchable, both matching Node instead of upgrading the dial to another scheme. Both rows run on the LLVM backend, as do the TLS CA-store entries, which moves the CA-store corpus off the C lane with identical output. scriptc -vprints the version instead of crashing on an attempt to read-vas an entry file, and an unknown flag or a missing flag value prints one line naming what was wrong followed by usage, in place of a Node stack trace.
0.0.13
Features
- Dyn values run the engine's own operations: a value held in
unknownthat came from the embedded engine now answers keyed reads and writes, calls and method dispatch, theObjectstatics, and??by running them in the engine — so it answers exactly what Node answers instead of meeting a fence. Scalars normalize at the wrap, composites stay engine values by reference, and a value that crosses into the checked-dynamic tree and back is the same value it was. http.Agentandhttps.Agentcompile, with real connection accounting: literal option parsing,getName,destroy, thesockets/requests/freeSocketssnapshots, a settabledefaultPort, andmaxSocketsthat actually holds — over-limit requests defer their dial and queue. The request path threads the agent on both emissions.keepAlive: truerefuses with the pooling fence named.- The HTTP and socket compatibility surface widens:
flushHeaders,getHeaders,setTimeout,cork/uncorkwith a realwritableCorkedcounter and coalescing flush,writeHead's raw-array form,write/endencodings and deferred callbacks,pause/resumewith buffered drain,destroySoon,end(cb),setNoDelay, and thedestroyed/readable/bytesWritten/res.reqreads — on both the typed lane and dyn receivers. Strict equality over runtime handles is pointer identity, as it is in JS. - Crypto introspection, the TLS CA store, and the http2 tail:
getFipsand the cipher/hash/curve name lists bake at the call site;getCACertificates/rootCertificates/setDefaultCACertificatesland in their own unit behind their own link gate, so a binary that only reads the trust anchors never pulls mbedTLS;http2.createSecureServergrows the eager request handler and the runtime options record;process.on/offcoverunhandledRejectionandrejectionHandled. - Library archives are verified across targets (
SCRIPTC_CROSS=1): every library profile cross-builds for aarch64-linux, x86_64-linux, x86_64-windows, and x86_64-macos on both emissions, and each archive is checked for symbol exactness, the ambient audit in both spellings, and probe linkability against the target's libc.
Fixes
process.env.PORT || 3000compiled and then threw at runtime. tsc builds a logical operator's result by dropping the left's falsy arms, so coercing the left into that result before the truthiness test retagged an arm the test was about to rule out;||now tests the left in its own type and retags only on the truthy branch, where those arms are gone. The left still evaluates exactly once and the right stays lazy.- Windows library archives carried undefined references no embedder link could resolve — the win32 libc shim unit now joins the archive for windows triples. Host archives are unchanged.
- Bytes written to a socket whose dial had not started — the agent's
maxSocketsqueue, or a caller lookup still in flight — were dropped without an error, hanging the exchange. They buffer and flush at establishment. - The CA-store surfaces demote the determinism attestation and can now be denied by a profile: three rows, one per Node spelling, since denying a read of the trust anchors is a different decision from denying their replacement.
0.0.12
Features
- Engine-held values iterate:
for-of, destructuring, and spread over values born in the embedded engine ride the engine's own iterator protocol with V8's exact error spellings, andfor-ofover any dynamic value lowers generally. Compiled promises cross into the engine as thenables;Promise.allover mixed compiled-and-engine entries runs the engine's own combinator, and engine-array fulfillments settle by reference. - Bare
moduleresolves the builtin exactly likenode:module— the builtin wins over any same-named installed package, matching Node.
Fixes
stream.pipelineargument validation throws Node's synchronousERR_INVALID_ARG_TYPEfor provably-invalid stages in every position instead of crashing the compiler on an internal marker; accepted-but-uncompiled sources refuse naming what Node accepts.- Integer-slot attestations record
u64asu64(the wire-format flattening now applies only where the frozen schema requires it), and declared model-field classes obligate every write — init, update arms, helpers — to the same prove-or-refuse check as export slots. - The 0.0.11 restore's written-binding decline was wider than its rationale, and two carve-outs bring the lost shapes back: a written binding whose declared type has no static mapping keeps the compiling no-storage trap claim, and a statement-position assignment whose right side provably throws before the write no longer counts against the claim.
- A class extending a base the compiler itself rejected now fails the build eagerly with the base's real blocker — the deferred fence compiled a binary that refused at startup where Node runs on. Leaf rejected classes keep the runtime-deferral story.
- A stale remnant of the island-literal fence answered
typeofand.lengthwrongly for poisoned members; reads now fail with the captured diagnostic.
0.0.11
Features
- Profiles declare integer boundary slots: library exports may class parameters and returns
i64/u64, and the compiler proves integrality and range for every value that can reach them — or refuses with the slot path, the failed obligation with evidence, and the concrete fix. Proven returns cross as exact machine integers; a bounded counter loop proves its exact range;x | 0is a proof by the ToInt32 contract. Semantics stay f64 everywhere inside the program. - Library fences cover the whole ambient surface: the Date, performance, and process families join the surface manifest as fenceable ids, so a profile can deny every surface the determinism attestation knows — full fences now imply a deterministic attestation by construction. The attestation itself tightened: six live ambient reads it previously missed now demote it. Profile roots refuse unknown keys.
- Subclasses override
emit: the wrap-and-forward pattern (emit(event, ...args)delegating tosuper.emit) compiles with Node's dispatch, error-event, and super-chain semantics, monomorphized per event. - Stream timing matches Node's tick order: stream emissions interleave with
process.nextTickin enqueue order — Node's order — instead of draining after user ticks; stream emitters model the event-key shape that governseventNames()order;push(string)honorsdefaultEncodingwith Node's unknown-encoding errors. node:stream/consumerscompiles statically (text/json/bufferwith Node's settle timing and rejection set), andcreateRequireerases at compile time — builtin specs become static imports, relative JSON bakes as the validated document, npm packages resolve their CJS arms under--dynamic, and unresolvable names throw Node's catchableMODULE_NOT_FOUND.
Fixes
- The two 0.0.10 crash classes are fixed and its seven behavior regressions restored: collect-phase probes recover from rejected constructs instead of crashing, and the no-storage binding families claim statement declarators only.
Buffer.slice/subarrayandTypedArray.subarrayare true aliasing views — mutating through a view previously computed wrong bytes.- Math.trunc and Math.ceil compile statically.
0.0.10
Features
- Engine-held values flow through dynamic code: values born in the embedded engine now cross into
unknown/object-typed slots and back —typeof, strict equality,String(), keyed reads and writes, calls, and method dispatch route through the engine (its own prototypes run, JS-exact), with reference-preserving identity on the round trip. Unions likestring | objectcompile wholesale into the checked-dynamic representation, and nullish coalescing and optional chains work on every dynamic value. Operations not yet routed throw an error that names them, and the boundary's previous wrong answers (typeofmisreporting, phantom.length) are fixed. Object.create(null), arrayentries()/keys(), and variadicObject.assign: real null-prototype dictionaries with Node's inspect/toString/comparison behavior (the dynamic tier delegates to the engine's ownObject.createfor live prototypes); live index-walking pair iterators;Object.assign(target, ...sources)with JavaScript's exact evaluation order and V8's position-dependent error texts.- Erased ambient declarations behave like Node: chains rooted in
declared values compile and throw the catchableReferenceErrorNode produces at first touch; never-read unmappable bindings vanish; nullish-cast bindings answer Node's exactTypeErroron member access; assertion-shaped generic signatures monomorphize per call. - Misuse of fs, net, dgram, tls, and stream APIs throws Node's validation ladders: argument checks run in Node's order with
ERR_*codes and message-exact texts;fs.existsis genuinely async (including its no-error-argument wart), andmkdtempSyncandlchmodare real. - Keyed writes land on dynamic receivers (
bag[key] = valueon objects built up dynamically, withToPropertyKey-exact key handling), and array destructuring walks dynamic sources with V8's exact non-iterable error wordings. - Library mode: profiles deny surfaces by manifest id — a
fencesarray refuses fenced surfaces reached by the compiled graph, with the profile's guidance attached as a visibly-attributed note; teachings generalize to any refusal; fence evaluation reads the same dead-stripped graph as the determinism attestation, so full fences imply a deterministic attestation by construction.
Fixes
- Mixed engine-vs-native
deepStrictEqualcomparisons are refused with an error instead of fabricating a failure result. - The LLVM code generator marshals dynamic values in
jsMarshalpositions identically to the C backend (a latent gap). - Concurrent plain and sanitized test-suite runs no longer race each other's scratch directories (a test-infrastructure fix).
0.0.9
Features
- API misuse throws Node's exact errors: argument-validation ladders on Buffer (
compare/equals/constructors), URLSearchParams (WHATWG brand checks, arity, ToPrimitive coercion running usertoString/valueOf), the max-listeners family, and range checks across bytes/fs —ERR_INVALID_ARG_TYPE,ERR_OUT_OF_RANGE, andERR_MISSING_ARGSwith Node's message texts, catchable and assertable. - Strings destructure: array patterns over strings split by code point (positions, holes, defaults, rest, nesting, for-of heads); destructured built-in globals (
const { subtle } = globalThis.crypto) bind with Node-agreeing identity. - Spread arguments land anywhere:
f(...args)outside typed rest slots builds the argument list with JavaScript's exact evaluation order on both backends, including under--dynamic, with V8's spread-TypeError texts for non-iterable sources. - Record shapes widen further: hybrid declared-plus-index-signature records width-coerce in both directions; index signatures carry function, Map, and Set values (the command-registry pattern); per-field lifts cover
unknowndestinations, upcasts, and function adapters. - DataView setters,
Object.is, and an exact Intl slice: the full DataView setter family; fresh ArrayBuffers erase into zero-filled views;Object.iswith the spec's SameValue;new Intl.NumberFormat("en-US").format()andtoLocaleString("en-US")print byte-identically to Node without linking ICU. stream/promisescompiles statically, and out-of-scope modules (v8,domain,node:sqlite, Node's underscore-internals) refuse with reasons instead of a generic unsupported-module message.- Bundler interop: esbuild's
__toESM(require(...))external-dependency wrapper compiles statically under--npm-static, with build-time.defaultsemantics matching Node's interop rules; unrecognizable variants degrade to the embedded engine with the construct named. - Library mode: runtime-detected traps deliver the structured teaching encoding unconditionally (code, trapping symbol, optional profile remediation); bare npm specifiers compile statically when eligible or refuse with the failed bar named.
Fixes
- The C code generator compiles with strict aliasing disabled: the refcounted object header is accessed through base- and derived-typed views by design, and optimizer type-based alias analysis could elide refcount updates, freeing objects still in use. The LLVM lane was unaffected.
Promise.rejectwith an untyped reason no longer crashes the LLVM code generator; rest-parameter arrows forwarding their rest via spread no longer trip an internal error.- Two readable-stream lifecycle bugs: the
emittedReadableflag now clears at Node's moment, and absent-size reads clear pending state correctly. - String-typed
'data'listeners (thesetEncodingshape) received raw byte headers as string content on sockets, http requests, and http2 streams; they now decode UTF-8 correctly.
0.0.8
Features
- Destructuring completes its static surface: nested patterns and property/element targets in assignment position (
[c.x, c.y] = arr,({ a: rec.f } = o)) with JavaScript's exact evaluation order, destructuring from class instances (getters called once per element), rest over class instances packing the inheritance chain in Node's key order, and defaults on destructured accessor results. - The monomorphization frontier widens:
keyof-constrained generics specialize per literal key (pick<T, K extends keyof T>and keyed writes), generic methods called through interface-typed receivers compile against the proven class, and generic-signature annotations, aliases of generic functions, and generic arrow initializers all monomorphize per pinned signature. #privatestatics resolve through class values:X.#m()calls, const-bound class expressions with static initializers, decorated class names, and aliases of the class all reach static private members when the receiver provably holds the declaring class.- Named type-shape diagnostics: the former catch-all "unsupported type" diagnostic splits into SC2005 (generic call signatures), SC2006 (index-signature shapes), SC2007 (overloaded function types), SC2008 (unresolved intersections), and SC2009 (a supported shape whose named component is the blocker — the message points at the exact offending piece).
- Library builds speak the structured trap encoding: trap messages carry a diagnostic code, the trapping export's symbol, and optional profile-supplied remediation inside the frozen sink signature, degrading gracefully to plain text; contract sidecars refuse order-ambiguous type declarations (multi-site merging, conditional/mapped types) with teachings naming every site, and spread-composed unions pin depth-first declaration order.
- Broader dynamic-tier interop:
Object.hasOwn/Object.assignon records and engine values, runtime-keyed writes to fixed shapes, regex union arms withinstanceof RegExpnarrowing, tagged templates receiving a realTemplateStringsArray, getters and spreads in island object literals, and JavaScript variadics binding the engine's arguments array.
Fixes
- Arrays that grow from an empty
any[]no longer break compilation under--dynamicwhen they flow into typed array methods (map/filter/forEachand family). - A latent double-getter-call in destructuring defaults over accessor results is fixed.
0.0.7
Features
- Library builds emit a contract sidecar: a profile that declares a sidecar path gets a deterministic
*.contract.jsonbeside the archive — exported symbols with marshalled signatures, record/union type tables in declaration order, and a 64-bit build id that is also readable from the archive itself through synthesized constant getters (safe to call before init and after a trap). Two builds of the same tree produce byte-identical sidecars, so embedder tooling can diff contracts mechanically.
Fixes
- Comparing a union value against
nullorundefinedwhen the union has no such arm now answers the constant the type system already knows (falsefor===,truefor!==) instead of trapping at runtime;switchcases on absent unit arms fold the same way. The scrutinee is still evaluated exactly once. - Programs using
netauto-select-family timeouts no longer fail at link on the default backend: the code generator's symbol table spelled two runtime symbols differently than the runtime defines them. The ABI audit now verifies every runtime symbol the code generator can emit against the runtime header, so this class of skew fails in CI rather than at a user's link step.
0.0.6
Features
- Recursive types compile statically: self-referential interfaces (
interface TreeNode { label: string; children: TreeNode[] }), mutually recursive types, and recursive unions — the AST/tree/linked-list class — now map to native representations. Cyclic values are collected by the cycle collector;JSON.stringifyon a cyclic value throws V8's exact circular-structure error;console.logprints Node's circular reference markers;JSON.parse(x) as Tvalidates recursive shapes with path-exact failures.
0.0.5
Features
- Library mode:
scriptc build --lib --profile <profile.json>compiles a TypeScript module set into a linkable static archive exporting profile-declared C symbols — marshalled scalar/string/bytes signatures, a re-runnable init entry, panic-to-sink routing instead of aborts, and a cycle-collection entry. The emitted archive links against nothing but libSystem, creates no threads, and installs no signal handlers; conformance fixtures drive both code generators from a real C host. - Bundler-emitted CommonJS packages work with
--npm-static: getter-table and star re-export plumbing now types its named exports from the same name set Node's lexer sees, and a package whose shipped code still breaks the typecheck falls back to the embedded engine with a note naming why — never a failed build.
Fixes
- Two compile-time crashes on unusual shipped-JavaScript shapes (probe reads that mutated locals, captures through non-lifted functions) now compile or fence with a named diagnostic.
0.0.4
Features
console.logprints every inspectable shape: arrays, records, Maps/Sets, class instances,undefined/null, Buffers, and unions — each non-scalar argument renders through the same machinery asutil.inspect, matching Node's console semantics exactly (string union arms print raw, format-string first arguments keeputil.formatbehavior).- The
#privatemembers chain: private fields, instance and static methods, accessors, generator methods, and#x in objbrand checks all compile, with Node's lexical binding and brand semantics. node:querystringcompiles statically: the full legacy surface (parse,stringify,escape,unescape) with Node's exact separator,maxKeys, and malformed-escape behavior.- Command-table and generic-member patterns:
as constoption tables withString/Number/Booleanconstructor values, generic arrow instance fields, async generic methods and statics, and definite-assignment (field!) declarations all lower. - Object literals widen per-field into union arms: the reducer-action pattern — a literal whose fields fit exactly one arm of a contextual union — now compiles.
- The
performanceglobal,Response.headers/arrayBuffer()/bytes(), andMath.max/Math.minat any arity. - Workspace members install-agnostic: monorepo siblings classify identically whether the package manager symlinks or copies them into
node_modules.
Fixes
- Whole-program IR validation over large mixed static/dynamic graphs no longer surfaces internal errors: island values entering typed intrinsic slots are validated at the boundary, and
any-typed values dispatch through the checked-dynamic machinery. JSON.stringifyof a dynamic value holdingundefinednow prints identically on both backends.- Loose equality between same-kind operands lowers as strict equality.
- The limitations page documents the type surface: where scriptc's ambient world is narrower than stock TypeScript's, and what diagnostics point at instead.
0.0.3
Features
- Surface manifest: each release now ships a machine-readable
surface-manifest.json— the language and stdlib surface the static tier compiles at that version, with stable per-entry ids so tooling can diff two releases mechanically. Every non-static entry carries the diagnostic code the compiler raises for it. Attached to the GitHub release and shipped inside@scriptc/compileras@scriptc/compiler/surface-manifest.json; regenerate withpnpm manifest.
0.0.2
Features
Number(aString)compiles statically: the full ECMAScript ToNumber string grammar (whitespace forms, hex/octal/binary literals,Infinity, exponents, trailing-garbage →NaN), verified bit-exact against Node on one million fuzzed strings. Unary+on strings and%dformatting over strings ride the same lowering;parseFloat(aString)compiles statically with its own longest-prefix grammar.Array.from(aString)and[...aString]compile statically: strings split by code points, so astral characters stay whole — exactly the string iterator's walk.- Bare
'.'and'..'import specifiers resolve as relative directory imports, and default imports of supported Node builtins (import fs from "node:fs") pass type checking under the project's own interop settings. - Workspace-linked packages register before the type-check gate, so pnpm-workspace monorepos analyze without their sibling packages' shipped JavaScript gating the build.
Fixes
scriptc coveragenow renders the same diagnostics a build prints — code frames included — when analysis stops on type errors or import fences, instead of a bare summary line.- The LLVM backend's runtime declarations are now mechanically checked against the C runtime's prototypes at test time; two latent signature mismatches were found and fixed.
- Import-cycle admission accepts declaration-only initialization windows whose calls resolve entirely to declaration files, widening the set of legal ESM cycles that compile statically.
0.0.1
Features
- The CLI:
scriptc buildcompiles a TypeScript or JavaScript entry point into a self-contained native executable,scriptc runbuilds and runs it in one step, andscriptc coveragereports statement by statement what compiles statically and which specific constructs block, each with a diagnostic code. - The static tier: programs compile to native code with no JavaScript engine in the binary. Type checking is the real TypeScript compiler; what compiles produces the same output as Node, enforced by a differential test corpus.
--dynamic: an embedded JavaScript engine (quickjs-ng) executes what cannot compile statically. Values crossing back into static code are validated at runtime, so a mismatched type throws a catchableTypeError. Static remains the default; a binary includes the engine only when--dynamicis passed.- npm dependencies (with
--dynamic): packages resolve with Node's own resolution algorithm, typecheck against their shipped.d.ts, and their JavaScript is embedded into the binary at build time. Binaries never readnode_modulesat runtime. - Platforms: macOS arm64 is the primary platform; Linux and Windows binaries build by cross-compilation, each verified by its own differential test lane.