boxlang-runtime-matchboxlisted

# MatchBox — BoxLang Without the JVM ## Overview **MatchBox** is a native Rust implementation of the BoxLang runtime. It compiles BoxLang source code to a custom bytecode and executes it without any JVM required. MatchBox is ideal for environments where the JVM is unavailable, cold-start time matters, or binary size must be minimal. > MatchBox code is a **strict subset** of JVM BoxLang. Code written for MatchBox runs on JVM BoxLang, but not vice versa — some JVM-specific APIs are unavailable in MatchBox. --- ## Installation ```bash # Install via the official install script (macOS, Linux) curl -sSL https://raw.githubusercontent.com/ortus-boxlang/matchbox/master/install/install.sh | bash # Verify matchbox --version ``` --- ## Architecture | Component | Technology | Description | |-----------|-----------|-------------| | Parser | Pest PEG (Rust) | Parses BoxLang source to AST | | Compiler | Rust | Compiles AST to MatchBox bytecode | | VM | Stack-based bytecode VM (Rust) | Executes bytecode at runtime | | Targets | `native`, `wasm`, `js`, `esp32` | Output deployment formats | --- ## Compilation Targets | Target | Command | Output | Use Case | |--------|---------|--------|----------| | `native` | `matchbox --target native app.bxs` | Executable binary | CLI tools, microservices | | `wasm` | `matchbox --target wasm app.bxs` | `.wasm` file | Edge/FaaS, Wasmtime, containers | | `js` | `matchbox --target js app.bxs` | `.js` + `.wasm` ES module | Web browsers, Node.js | | `