Files
waozi 6d7ddadb72 Document only current Ziran behavior
Remove obsolete migration, roadmap and research documentation. Describe the current native/ZX/Wasm pipeline, manual safety and offline learning. Refresh current guides and remove historical website prose while preserving unpublished audio work.
2026-11-16 21:40:58 -03:00

2.4 KiB

Ziran

Ziran 0.6.0 is a general-purpose language with direct native, WebAssembly, portable ZX, C and Go output. Master includes Unreleased work.

Website and playground · Compiler guide · Current support

Quick start

Build with Make, a C11 compiler and GNU binutils:

make
build/bin/ziran check examples/hello.zi
build/bin/ziran run examples/hello.zi
build/bin/ziran build examples/hello.zi

run checks and executes main; build defaults to a direct native binary. make install-user installs the tools in ~/.local/bin.

main :: () { print("Hello, World!\n") }

Tools and formats

Source → ZIR → LIR → optimized LIR → ZX → native (ELF/PE, x86-64/AArch64/ARMv7). WebAssembly lowers from verified ZX through zx2wasm. C and Go export from ZIR through zi2c and zi2go.

Command Purpose
check Validate source and imports.
build Build native output, or select --target=c, go, wasm or zx.
ir / inspect Save checked .zir modules and inspect artifacts.
bundle / run Link .zx executables and run source or ZX.
learn Control native-build corpus recording and offline C-teacher verification/training.
fmt Format source.
guide / features / capabilities Query syntax and target limits.
api Query checked public declarations.

Safety is manual by default, as in C. --checks opts a build into runtime checks; #checks keeps bounds checks in selected source regions. See checks for target-specific behavior.

Documentation

Kryon is a separate UI library imported by applications. Console programs have no graphics dependency. Release history lives in CHANGELOG.md.

Development

Run make check for the retained local suite and make check-bootstrap for bootstrap reproducibility. CHECK_FILTER=text selects matching tests. The compiler uses maintained Ziran and C sources; bootstrap seeds live in bootstrap/. Refresh affected seeds with make update-bootstrap after compiler changes.