Language Reference

The language reference is a precise, detailed description of every lexical token, syntactic form, operator, keyword and type in Karkain. It is meant for implementors and developers who need authoritative answers — not a tutorial.

For a tutorial-oriented introduction, see Karkain Language Guide.


How the reference is organized

  • Syntax Reference — lexical structure and statements: identifiers, literals, comments, keywords and the full statement and expression grammar.

  • Operators — every built-in operator, its precedence and known semantics.

  • Keywords — the complete list of reserved words and type-keywords.

  • Type Reference — the built-in type system: representation, inference and conversion.

  • Diagnostics — the error-code contract, JSON schema and exit codes.

  • Engine Compatibility — engine parity matrix between the Go front end and the self-hosted kcc engine.