Matchbox 0.2.0 Released

Posted on Aug 19, 2025

Matchbox 0.2.0 is the first release in the 0.2 series.

This release provides the Matchbox 0.2 language baseline, including signed 32-bit integers, variables, expressions, user-defined functions, built-in functions, direct source execution, the REPL, bytecode display, and version output.

Added

  • Added user-defined functions with parameters, return values, local variables, calls, and source-order name resolution.
  • Added built-in functions for console output, integer math, runtime inspection, and process exit: print, abs, clamp, min, max, byteorder, and exit.
  • Added bytecode disassembly through the -d command-line option.
  • Added version output through the --version command-line option.
  • Added integer literal support for decimal, binary, octal, and hexadecimal forms.
  • Added the int keyword as the supported source-language type.
  • Added support for top-level statements.
  • Added REPL sessions for interactive expression and statement evaluation.
  • Added stack overflow checks before function execution.

Changed

  • Improved memory use in the compiler and runtime.
  • Strengthened integer type checking across declarations, assignments, expressions, function calls, and returns.
  • Updated reserved keywords to match future syntax reservations.
  • Updated opcode definitions and bytecode emission for the 0.2 instruction set.
  • Updated operator handling for arithmetic, bitwise, shift, unary, comparison, logical, assignment, and compound-assignment forms.
  • Clarified signed integer behavior and the boundary between supported signed values and reserved unsigned syntax.
  • Moved runtime constants and functions into a constant pool used by generated bytecode.
  • Updated the REPL to support variable-length input.

Fixed

  • Fixed the clamp built-in so it enforces both its lower and upper bounds.
  • Fixed function and built-in argument order so arguments are received in the same order in which they are written.
  • Fixed the reserved keyword spellings for double and protocol.

Download

Download Matchbox 0.2.0 for Windows (32-bit).

Matchbox remains early-stage software. Version 0.2.0 supports Windows, uses signed 32-bit integers, and intentionally provides a small language surface.

The source for this release is available under the 0.2.0 tag.