Home

AuroraScript.JIT Documentation

AuroraScript is a lightweight scripting engine for .NET hosts: scripts are compiled to CIL and executed by the CLR/JIT.

Its expressions, objects, arrays, closures, and module syntax are JavaScript-inspired, but AuroraScript is not an ECMAScript implementation and does not promise browser or Node.js compatibility.

Applies to AuroraScript.JIT 4.0.0 · GitHub Repository

Start Here

If you are	Start with	Then read
New to AuroraScript	Getting Started	Language Guide
Writing scripts	Language Guide	Script API Reference
Embedding the engine in C#	Host Integration	.NET Host API Reference
Storing typed configuration or data	Typed Document (TDoc)	TDoc Script API
Connecting AI clients or editors	Tooling	MCP Server
Upgrading an existing integration	Migration to 4.0	Troubleshooting and Security Boundaries

Learn

• Getting Started — install the package, compile a module, run an exported function.
• Language Guide — modules, imports, functions, closures, and syntax rules.
• Typed Document (TDoc) — text format that preserves AuroraScript types.
• Cookbook — short, task-oriented recipes.

Build

• Host Integration — engine options, domains, globals, state, and CLR interop.
• Performance and Benchmarks — compilation modes, optimization settings, measured results.
• Troubleshooting and Security Boundaries — diagnosing failures and understanding sandbox limits.

API Reference

• API Reference — entry point for every public contract.
• Script API Reference — script globals, constructors, static and instance members.
• .NET Host API Reference — host types, options, runtime values, and diagnostics.

Tooling

• Tooling — overview of the language tools shipped with the repository.
• MCP Server — documentation, API lookup, validation, and execution for AI clients.
• Language Server — diagnostics, completion, hover, and navigation for LSP clients.
• Visual Studio Extension — script editing, navigation, and debugging integration.

Project

• Development, Testing, and Contribution — building the solution and running tests.
• Migration to 4.0 — breaking changes and upgrade steps.

Version Information

• This documentation applies to AuroraScript.JIT 4.0.0.
• The package targets net8.0, net9.0, and net10.0.
• The Dynamic and OnlyRun compilation modes are available on all three targets; Persistence requires net9.0 or later.

dotnet add package AuroraScript.JIT --version 4.0.0

Licensed under the MIT License.