Generator

pub struct Generator<'a> { /* private fields */ }

impl<'a> Generator<'a> {
    pub fn new(ast: &'a Ast, options: GeneratorOptions) -> Self;

    pub fn generate(self) -> Result<CodeResult, CompileError>;
}

Generator is the builtin generator used by the pipeline as the terminal fallback after every generate hook defers. It never runs the plugin chain. Use generate when plugins should be able to replace the generated result.

Generator::newCopy Anchor Link

Creates a generator over ast and its resolved GeneratorOptions.

The AST is borrowed because hook arguments are read-only.

GeneratorOptionsCopy Anchor Link

Every field is required. In a generate hook, the stage options are available as args.options.

Generator::generateCopy Anchor Link

Generates code from the fixed AST and composes the AST's input map into the produced map.

The builtin generator always returns a map. Output delivery modes (Inline, External, and Both) are applied by the pipeline, not by Generator::generate.

CodeResult is { code: String, map: Option<SourceMap> }.

ExampleCopy Anchor Link

use std::path::PathBuf;

use telarel::{
    parse, AstResult, CodeResult, Generator, GeneratorOptions, ParseOptions,
    SourceMapOptions,
};

let parsed: AstResult = parse(
    String::from("const x: number = 1;"),
    ParseOptions::default(),
    vec![],
).await?;

let result: CodeResult = Generator::new(
    &parsed.ast,
    GeneratorOptions {
        cwd: PathBuf::from("."),
        file: String::from("index.ts"),
        source_map: SourceMapOptions::default(),
    },
)
.generate()?;