XXML Tools

XXML provides a suite of development tools including the compiler CLI, VS Code extension with language server support, and a modular import system.

Quick Start

bash
# Compile an XXML program
xxml Hello.XXML -o hello.exe

# Run the executable
./hello.exe

Available Tools

CLI Reference

Command-line interface for compiling XXML programs to native executables or LLVM IR.

Import System

File-based module system for code organization and reuse with automatic discovery.

VS Code Extension

Full IDE support with syntax highlighting, diagnostics, code navigation, and ownership visualization.

Compiler Architecture

Multi-stage compiler internals: lexer, parser, semantic analysis, and LLVM code generation.

Compilation Pipeline

text
Source (.XXML)
    ↓
Lexical Analysis
    ↓
Syntax Analysis (AST)
    ↓
Semantic Analysis
    ↓
LLVM IR Generation (.ll)
    ↓
LLVM Compilation (.obj)
    ↓
Linking (.exe / .dll)

Environment Setup

The XXML toolchain requires:

  • Standard Library: Language/ directory relative to compiler location
  • LLVM Tools: llc, lld-link in PATH for executable generation
  • Visual Studio Build Tools: For Windows linking

Project Structure

text
xxml/
├── xxml.exe              # Compiler executable
└── Language/             # Standard library
    ├── Core/
    │   ├── String.XXML
    │   ├── Integer.XXML
    │   ├── Bool.XXML
    │   └── Console.XXML
    └── Concurrent/
        └── Thread.XXML

MyProject/
├── Main.XXML             # Your code
└── Utils/
    └── Helpers.XXML      # Your modules

Next Steps

Start with the CLI Reference to learn compilation options, or set up your editor with the VS Code Extension.