DOCUMENTATION

XCX Technical Documentation Suite

Welcome to the official technical documentation for XCX 4.4.1 and the XCX Compiler.

Language Reference

Comprehensive guides on the XCX language syntax and features.

• Syntax Basics: Comments, identifiers, and blocks.
• Variables & Constants: Declarations, reassignment, and shadowing.
• Data Types: Simple types, complex types, and casting.
• Operators: Arithmetic, string, logic, comparison, and sets.
• Control Flow: Conditionals and loops.
• Functions & Fibers: Subroutines, coroutines, and delegation.
• Collections: Arrays, Sets, Maps, and Tables (Relational).
• JSON & HTTP: Data interchange, networking, and safety.
• Date & Time: Creation, fields, and formatting.
• I/O & Terminal: Input, output, delays, and system commands.
• String Methods: Comprehensive list of string utilities.
• Error Handling: Halt levels (alert, error, fatal).
• Standard Library: Built-in modules (crypto, store, env).

️ Compiler Internals

Technical deep-dives into how the XCX compiler, JIT, and VM work.

• Compiler Architecture Index: Main entry point for the XCX compiler technical documentation.
• Frontend Syntax: Lexing, parsing, and AST specifications.
• Semantic Analysis: Type checking and scoping validators.
• Compiler Code Gen: Register mapping and VM bytecode translation.
• HIR Pipeline: High-level IR lowering, inlining, and compiler passes.
• JIT Engine: Cranelift method (per-function) compilation and NaN-boxing.
• Virtual Machine: Bytecode execution interpreter loop and heap values.
• Runtime Services: Linked collection APIs and FFI linkages.
• Diagnostics Gutter: Spans, Severity types, and formatted errors.
• Interactive Shell: Persistent REPL workspace logic.

Tooling

Guides for the XCX ecosystem tools.

• PAX Manual: Package management and project structure.
• DOC Tool Manual: Offline error code reference utility.

Documentation Version: 4.4.1