Tsonic.Runtime

TypeScript language runtime primitives for the Tsonic compiler - provides Union types, structural typing, and other TypeScript language features in C#.

Overview

Tsonic.Runtime contains mode-independent TypeScript language primitives that are used in all Tsonic compilation modes. This library provides:

• Union Types - Union<T1, T2, ...> for TypeScript unions like string | number
• Structural Typing - Structural.Clone<T>() and DictionaryAdapter<T> for duck typing
• Dynamic Objects - DynamicObject for TypeScript's keyof and indexed access patterns
• Operators - typeof and instanceof operator support

When to Use

This library is referenced by all Tsonic projects, regardless of mode:

• mode = "dotnet" (default) - Uses only Tsonic.Runtime
• mode = "js" - Uses both Tsonic.Runtime and Tsonic.JSRuntime

What's NOT Here

JavaScript built-in semantics are in a separate package (Tsonic.JSRuntime):

• Array methods (push, pop, map, filter, etc.)
• String methods (toUpperCase, slice, includes, etc.)
• Math, console, JSON, global functions

Building

dotnet build

Testing

dotnet test

NativeAOT Compatibility

This library is fully compatible with .NET NativeAOT, enabling TypeScript code to be compiled to native executables.

Package

Published as Tsonic.Runtime on NuGet.

License

MIT License - see LICENSE file for details.