initial draft

2026-06-09 17:28:28 +02:00
commit 087fdb45d5
40 changed files with 4371 additions and 0 deletions
@@ -0,0 +1,36 @@
+# brolang
+
+Prototype error-tolerant Brolang compiler written in Odin.
+
+```sh
+odin build . -out:brolang
+./brolang examples/prototype.bro -o /tmp/prototype
+/tmp/prototype
+```
+
+Compilation phases are isolated under `compiler/`:
+
+```text
+source -> lexer -> parser/AST -> checker/HIR -> lower/IR -> opt -> LLVM -> zig cc
+```
+
+Source diagnostics do not block executable generation. When recovery is
+possible, invalid code lowers to runtime diagnostic traps and the compiler
+returns status `1`. Infrastructure or backend failures return status `2`.
+
+Current prototype features:
+
+- Newline-terminated, multiline statements and `#` comments
+- Immutable `::` bindings, mutable function-local `=` bindings, and `_` sinks
+- `i8`, `i16`, `i32`, `i64`, and loose integer-constrained `int`
+- Contextual integer constants and compile-time folding of literal addition trees
+- Demand-monomorphized Brolang and C-ABI functions
+- Checked signed addition
+- Static, eager runtime, and deferred problematic globals
+- Runtime diagnostics followed by `llvm.trap`
+
+Compiler exit statuses:
+
+- `0`: executable produced without source diagnostics
+- `1`: executable produced with source diagnostics and embedded traps
+- `2`: executable could not be produced