Skip to main content

aver/codegen/
mod.rs

1/// Aver → target language transpilation.
2///
3/// The codegen module transforms a type-checked Aver AST into source code
4/// for a target language. Current backends: Rust and Lean (WIP).
5pub(crate) mod common;
6pub mod lean;
7pub mod rust;
8
9use std::collections::{HashMap, HashSet};
10
11use crate::ast::{FnDef, TopLevel, TypeDef};
12use crate::types::checker::TypeCheckResult;
13
14/// Information about a dependent module loaded for codegen.
15pub struct ModuleInfo {
16    /// Qualified module path, e.g. "Examples.Fibonacci".
17    pub prefix: String,
18    /// Type definitions from the module.
19    pub type_defs: Vec<TypeDef>,
20    /// Function definitions from the module (excluding `main`).
21    pub fn_defs: Vec<FnDef>,
22}
23
24/// Collected context from the Aver program, shared across all backends.
25pub struct CodegenContext {
26    /// All top-level items (post-TCO transform, post-typecheck).
27    pub items: Vec<TopLevel>,
28    /// Function signatures: name → (param_types, return_type, effects).
29    pub fn_sigs: HashMap<String, (Vec<crate::types::Type>, crate::types::Type, Vec<String>)>,
30    /// Functions eligible for auto-memoization.
31    pub memo_fns: HashSet<String>,
32    /// Set of type names whose values are memo-safe.
33    pub memo_safe_types: HashSet<String>,
34    /// User-defined type definitions (for struct/enum generation).
35    pub type_defs: Vec<TypeDef>,
36    /// User-defined function definitions.
37    pub fn_defs: Vec<FnDef>,
38    /// Project/binary name.
39    pub project_name: String,
40    /// Dependent modules loaded for inlining.
41    pub modules: Vec<ModuleInfo>,
42    /// Set of module prefixes for qualified name resolution (e.g. "Examples.Fibonacci").
43    pub module_prefixes: HashSet<String>,
44    /// Runtime policy from `aver.toml` (baked into generated code).
45    pub policy: Option<crate::config::ProjectConfig>,
46}
47
48/// Output files from a codegen backend.
49pub struct ProjectOutput {
50    /// Files to write: (relative_path, content).
51    pub files: Vec<(String, String)>,
52}
53
54/// Build a CodegenContext from parsed + type-checked items.
55pub fn build_context(
56    items: Vec<TopLevel>,
57    tc_result: &TypeCheckResult,
58    memo_fns: HashSet<String>,
59    project_name: String,
60    modules: Vec<ModuleInfo>,
61) -> CodegenContext {
62    let type_defs: Vec<TypeDef> = items
63        .iter()
64        .filter_map(|item| {
65            if let TopLevel::TypeDef(td) = item {
66                Some(td.clone())
67            } else {
68                None
69            }
70        })
71        .collect();
72
73    let fn_defs: Vec<FnDef> = items
74        .iter()
75        .filter_map(|item| {
76            if let TopLevel::FnDef(fd) = item {
77                Some(fd.clone())
78            } else {
79                None
80            }
81        })
82        .collect();
83
84    let module_prefixes: HashSet<String> = modules.iter().map(|m| m.prefix.clone()).collect();
85
86    CodegenContext {
87        items,
88        fn_sigs: tc_result.fn_sigs.clone(),
89        memo_fns,
90        memo_safe_types: tc_result.memo_safe_types.clone(),
91        type_defs,
92        fn_defs,
93        project_name,
94        modules,
95        module_prefixes,
96        policy: None,
97    }
98}