club-kdl-codegen 0.11.1

Generate Rust / TypeScript / Zod / SurrealQL code from KDL schema files
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

//! # club-kdl-codegen
//!
//! Generate type / schema definitions in multiple languages from a single
//! KDL schema file (KDL-first). Targets: **Rust**, **TypeScript**, **Zod**,
//! and **SurrealQL**.
//!
//! ## Pipeline
//!
//! ```text
//! *.kdl  ──parser──▶  Schema IR  ──emitter──▶  Rust / TypeScript / Zod / SurrealQL
//! ```
//!
//! The intermediate [`ir::Schema`] representation decouples parsing from
//! emission: the parser is written once, and each target is one [`Emitter`]
//! implementation.
//!
//! See the design memory `mem_1Cb5mWnMTdzXfJVoNGFwup` and `ROADMAP.md`
//! (Phase 1) for the full plan.

pub mod emit;
pub mod ir;
pub mod parser;

/// A code generation target. Each language emitter ([`emit::RustEmitter`] /
/// [`emit::TypeScriptEmitter`] / [`emit::ZodEmitter`] /
/// [`emit::SurrealQlEmitter`]) implements this trait against the shared
/// [`ir::Schema`].
pub trait Emitter {
    /// Render the given schema into target-language source text.
    fn emit(&self, schema: &ir::Schema) -> String;
}