miniscript2

KO | EN

gitlite — search

#python #react #nodejs #tailwindcss #java #typescript #reactjs #vue #android #css #php #nextjs

★ 31 Open GitHub ↗

Version 2 of the MiniScript language (including official C# and C++ versions)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MiniScript 2.0

MiniScript 2.0 is complete rewrite of the [MiniScript](https://miniscript.org) language, focused mainly on performance.  It is the cornerstone of the [2026 MiniScript Road Map](https://dev.to/joestrout/miniscript-road-map-for-2026-17mh).  For MiniScript 1.x source code, see [here](https://github.com/JoeStrout/miniscript).

MiniScript 2.0 is developed in C# and transpiled to C++ for production performance. The VM uses 32-bit fixed-width instructions and supports computed-goto dispatch on supported compilers.

## Building

```bash
tools/build.sh cs         # Build C# only
tools/build.sh transpile  # Generate C++ code from C# code
tools/build.sh cpp        # Build C++ only
tools/build.sh all        # Build everything (C#, transpile, C++)
tools/build.sh test       # Run smoke tests
```

## Notes

- [CS_CODING_STANDARDS.md](notes/CS_CODING_STANDARDS.md) — C# coding restrictions required by the C#-to-C++ transpiler.
- [DEV_LOG.md](notes/DEV_LOG.md) — Development log documenting project status and decisions.
- [FROZEN_VALUES.md](notes/FROZEN_VALUES.md) — Design for immutable maps and lists via freeze/isFrozen/frozenCopy.
- [FUNCTION_CALLS.md](notes/FUNCTION_CALLS.md) — Design and considerations for the VM's function call mechanism.
- [GC_USAGE.md](notes/GC_USAGE.md) — Guide to the garbage collection shadow-stack system.
- [LANGUAGE_CHANGES.md](notes/LANGUAGE_CHANGES.md) — Observable language changes in MiniScript 2.0 vs 1.x.
- [MEMORY_SYSTEMS.md](notes/MEMORY_SYSTEMS.md) — Overview of the three memory systems (GC, intern table, etc.).
- [OPCODE_ADDITION.md](notes/OPCODE_ADDITION.md) — Procedure for adding new opcodes to the VM.
- [UNARY_MINUS_QUIRK.md](notes/UNARY_MINUS_QUIRK.md) — Language quirk involving unary minus and call statement syntax.
- [VARIABLES.md](notes/VARIABLES.md) — How variables map to registers and interact with scope maps.
- [VM_DESIGN.md](notes/VM_DESIGN.md) — Architecture of the register-based VM and instruction encoding.
- [miniscript.g4](notes/miniscript.g4) — ANTLR grammar defining MiniScript syntax.

## Sponsor Me!

MiniScript is free, and apart from a small amount of revenue from the [books](https://miniscript.org/books/) and [Unity asset](https://assetstore.unity.com/packages/tools/integration/miniscript-87926), generates no significant income.  Your support is greatly appreciated, and will be used to fund community growth & reward programs like [these](https://miniscript.org/earn.html).

So, [click here to sponsor](https://github.com/sponsors/JoeStrout) -- contributions of any size are greatly appreciated!

## Star History

Click the ⭐️ at the top to help push this graph up!  Every like helps more people discover MiniScript, and keeps me motivated to push it forward every day!

miniscript2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README