Tsonic.JSRuntime 0.0.9

Tsonic.JSRuntime

JavaScript/TypeScript runtime implementation for the Tsonic compiler - provides exact JavaScript semantics in C#.

Overview

Tsonic.JSRuntime is a C# library that implements JavaScript semantics, enabling TypeScript code compiled by Tsonic to behave exactly like it would in a JavaScript runtime. This includes:

• JavaScript Arrays - Sparse arrays with JS semantics (length, holes, etc.)
• String manipulation - JS string methods and behavior
• Type coercion - Automatic type conversions matching JS rules
• Structural typing - Duck typing and object shape compatibility
• Console API - console.log, console.error, etc.
• JSON support - JSON.stringify, JSON.parse
• Math - JavaScript Math object (abs, floor, ceil, round, random, etc.)
• Global functions - parseInt, parseFloat, encodeURIComponent, etc.
• Map/Set - ES6 Map and Set collections
• WeakMap/WeakSet - Weak reference collections
• ArrayBuffer - Fixed-length binary data buffer
• Typed Arrays - Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, Float32Array, Float64Array
• Date - Date object with timezone support
• RegExp - Regular expression support with JavaScript flags

For Tsonic Users

Install and enable the bindings package:

# new project
npx --yes tsonic@latest init --surface @tsonic/js

# existing project
npx --yes tsonic@latest add npm @tsonic/js

Then write natural JS (no explicit @tsonic/js imports required when the workspace surface is @tsonic/js):

export function main(): void {
  const value = JSON.parse<{ x: number }>('{"x": 1}');
  console.log(JSON.stringify(value));
}

Direct imports from @tsonic/js/index.js remain supported when you want explicit symbols like JSArray or Timers.

Documentation:

• docs/README.md
• https://tsonic.org/js/

Building

dotnet build

Testing

dotnet test

All 500+ tests verify that the runtime matches JavaScript behavior exactly.

NativeAOT Compatibility

This library is fully compatible with .NET NativeAOT, enabling TypeScript code to be compiled to native executables with zero runtime dependencies and fast startup times.

Package

Published as Tsonic.JSRuntime on NuGet.

License

MIT License - see LICENSE file for details.