Architecture

Architecture | معماری

source (.px)
  -> lexer
  -> parser / AST
  -> type checker
  -> ownership checker
  -> interpreter OR Cranelift backend
  -> embedded runtime
  -> observable output / native executable

src/ contains the CLI, front end, interpreter, checker, and native code generator. rt/ contains the embedded runtime. tests/ contains language suites, parity guards, and fuzzing. docs/ contains user and contributor documentation.

The interpreter is the fast feedback path. The native path lowers checked programs through Cranelift and links runtime services. Release tests compare normalized observable output between both paths.