vexil-lang 0.4.3

Compiler library for the Vexil schema definition language — lexer, parser, IR, and type checker
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# vexil-lang

Compiler library for [Vexil](https://github.com/vexil-lang/vexil), a typed schema definition language with first-class encoding semantics.

Parses `.vexil` source, type-checks it, and produces a `CompiledSchema` that codegen backends consume. Handles single-file and multi-file projects with transitive import resolution. Includes the `compat` module for schema evolution and breaking change detection.

## Pipeline

```
source -> Lexer -> Parser -> AST -> Lower -> IR -> TypeCheck -> CompiledSchema
```

## Single-file compilation

```rust
use vexil_lang::{compile, Severity};

let result = compile(source);
if result.diagnostics.iter().any(|d| d.severity == Severity::Error) {
    // diagnostics carry file, line, column, and a structured ErrorClass
}
if let Some(compiled) = result.compiled {
    let hash = vexil_lang::canonical::schema_hash(&compiled);
    // pass compiled to a CodegenBackend
}
```

## Multi-file projects

```rust
use vexil_lang::{compile_project, resolve::FilesystemLoader};

let loader = FilesystemLoader::new(vec!["./schemas".into()]);
let project = compile_project(&root_source, &root_path, &loader)?;
// project: Vec<(String, CompiledSchema)> in topological order
```

## Code generation

Pass a `CompiledSchema` or `ProjectResult` to any `CodegenBackend`:

```rust
use vexil_codegen_rust::RustBackend;
use vexil_lang::codegen::CodegenBackend;

// single file
let code: String = RustBackend.generate(&compiled)?;

// multi-file project
let files: Vec<(PathBuf, String)> = RustBackend.generate_project(&project)?;
```

## Workspace crates

| Crate | Role |
|-------|------|
| `vexil-lang` | This crate -- compiler library |
| [`vexil-codegen-rust`](https://crates.io/crates/vexil-codegen-rust) | Rust code generation |
| [`vexil-codegen-ts`](https://crates.io/crates/vexil-codegen-ts) | TypeScript code generation |
| [`vexil-codegen-go`](https://crates.io/crates/vexil-codegen-go) | Go code generation |
| [`vexil-runtime`](https://crates.io/crates/vexil-runtime) | Rust runtime for generated code |
| [`vexil-store`](https://crates.io/crates/vexil-store) | `.vx` text and `.vxb` binary file formats |
| [`vexilc`](https://crates.io/crates/vexilc) | CLI compiler |

## License

Licensed under either of [MIT](../../LICENSE-MIT) or [Apache-2.0](../../LICENSE-APACHE) at your option.