alef_codegen/conversions/
mod.rs

1mod binding_to_core;
2mod core_to_binding;
3mod enums;
4pub(crate) mod helpers;
5
6use ahash::AHashSet;
7
8/// Backend-specific configuration for From/field conversion generation.
9/// Enables shared code to handle all backend differences via parameters.
10#[derive(Default, Clone)]
11pub struct ConversionConfig<'a> {
12    /// Prefix for binding type names ("Js" for NAPI/WASM, "" for others).
13    pub type_name_prefix: &'a str,
14    /// U64/Usize/Isize need `as i64` casts (NAPI, PHP — JS/PHP lack native u64).
15    pub cast_large_ints_to_i64: bool,
16    /// Enum names mapped to String in the binding layer (PHP only).
17    /// Named fields referencing these use `format!("{:?}")` in core→binding.
18    pub enum_string_names: Option<&'a AHashSet<String>>,
19    /// Map types use JsValue in the binding layer (WASM only).
20    /// When true, Map fields use `serde_wasm_bindgen` for conversion instead of
21    /// iterator-based collect patterns (JsValue is not iterable).
22    pub map_uses_jsvalue: bool,
23    /// When true, f32 is mapped to f64 (NAPI only — JS has no f32).
24    pub cast_f32_to_f64: bool,
25    /// When true, non-optional fields on defaultable types are wrapped in Option<T>
26    /// in the binding struct and need `.unwrap_or_default()` in binding→core From.
27    /// Used by NAPI to make JS-facing structs fully optional.
28    pub optionalize_defaults: bool,
29    /// When true, Json (serde_json::Value) fields are mapped to String in the binding layer.
30    /// Core→binding uses `.to_string()`, binding→core uses `Default::default()` (lossy).
31    /// Used by PHP where serde_json::Value can't cross the extension boundary.
32    pub json_to_string: bool,
33    /// When true, add synthetic metadata field conversion for ConversionResult.
34    /// Only NAPI backend sets this (it adds metadata field to the struct).
35    pub include_cfg_metadata: bool,
36    /// When true, non-optional Duration fields on `has_default` types are stored as
37    /// `Option<u64>` in the binding struct.  The From conversion uses the builder
38    /// pattern so that `None` falls back to the core type's `Default` implementation
39    /// (giving the real default, e.g. `Duration::from_secs(30)`) instead of `Duration::ZERO`.
40    /// Used by PyO3 to prevent validation failures when `request_timeout` is unset.
41    pub option_duration_on_defaults: bool,
42    /// When true, binding enums include data variant fields (Magnus).
43    /// When false (default), binding enums are unit-only and data is lost in conversion.
44    pub binding_enums_have_data: bool,
45    /// Type names excluded from the binding layer. Fields referencing these types
46    /// are skipped in the binding struct and defaulted in From conversions.
47    /// Used by WASM to handle types excluded due to native dependency requirements.
48    pub exclude_types: &'a [String],
49}
50
51// Re-export all public items so callers continue to use `conversions::foo`.
52pub use binding_to_core::{
53    field_conversion_to_core, field_conversion_to_core_cfg, gen_from_binding_to_core, gen_from_binding_to_core_cfg,
54};
55pub use core_to_binding::{
56    field_conversion_from_core, field_conversion_from_core_cfg, gen_from_core_to_binding, gen_from_core_to_binding_cfg,
57};
58pub use enums::{
59    gen_enum_from_binding_to_core, gen_enum_from_binding_to_core_cfg, gen_enum_from_core_to_binding,
60    gen_enum_from_core_to_binding_cfg,
61};
62pub use helpers::{
63    binding_to_core_match_arm, build_type_path_map, can_generate_conversion, can_generate_enum_conversion,
64    can_generate_enum_conversion_from_core, convertible_types, core_enum_path, core_to_binding_convertible_types,
65    core_to_binding_match_arm, core_type_path, field_references_excluded_type, has_sanitized_fields, input_type_names,
66    is_tuple_variant, resolve_named_path,
67};
68
69#[cfg(test)]
70mod tests {
71    use super::*;
72    use alef_core::ir::*;
73
74    fn simple_type() -> TypeDef {
75        TypeDef {
76            name: "Config".to_string(),
77            rust_path: "my_crate::Config".to_string(),
78            fields: vec![
79                FieldDef {
80                    name: "name".into(),
81                    ty: TypeRef::String,
82                    optional: false,
83                    default: None,
84                    doc: String::new(),
85                    sanitized: false,
86                    is_boxed: false,
87                    type_rust_path: None,
88                    cfg: None,
89                    typed_default: None,
90                    core_wrapper: CoreWrapper::None,
91                    vec_inner_core_wrapper: CoreWrapper::None,
92                    newtype_wrapper: None,
93                },
94                FieldDef {
95                    name: "timeout".into(),
96                    ty: TypeRef::Primitive(PrimitiveType::U64),
97                    optional: true,
98                    default: None,
99                    doc: String::new(),
100                    sanitized: false,
101                    is_boxed: false,
102                    type_rust_path: None,
103                    cfg: None,
104                    typed_default: None,
105                    core_wrapper: CoreWrapper::None,
106                    vec_inner_core_wrapper: CoreWrapper::None,
107                    newtype_wrapper: None,
108                },
109                FieldDef {
110                    name: "backend".into(),
111                    ty: TypeRef::Named("Backend".into()),
112                    optional: true,
113                    default: None,
114                    doc: String::new(),
115                    sanitized: false,
116                    is_boxed: false,
117                    type_rust_path: None,
118                    cfg: None,
119                    typed_default: None,
120                    core_wrapper: CoreWrapper::None,
121                    vec_inner_core_wrapper: CoreWrapper::None,
122                    newtype_wrapper: None,
123                },
124            ],
125            methods: vec![],
126            is_opaque: false,
127            is_clone: true,
128            is_trait: false,
129            has_default: false,
130            has_stripped_cfg_fields: false,
131            is_return_type: false,
132            serde_rename_all: None,
133            has_serde: false,
134            doc: String::new(),
135            cfg: None,
136        }
137    }
138
139    fn simple_enum() -> EnumDef {
140        EnumDef {
141            name: "Backend".to_string(),
142            rust_path: "my_crate::Backend".to_string(),
143            variants: vec![
144                EnumVariant {
145                    name: "Cpu".into(),
146                    fields: vec![],
147                    doc: String::new(),
148                    is_default: false,
149                    serde_rename: None,
150                },
151                EnumVariant {
152                    name: "Gpu".into(),
153                    fields: vec![],
154                    doc: String::new(),
155                    is_default: false,
156                    serde_rename: None,
157                },
158            ],
159            doc: String::new(),
160            cfg: None,
161            serde_tag: None,
162            serde_rename_all: None,
163        }
164    }
165
166    #[test]
167    fn test_from_binding_to_core() {
168        let typ = simple_type();
169        let result = gen_from_binding_to_core(&typ, "my_crate");
170        assert!(result.contains("impl From<Config> for my_crate::Config"));
171        assert!(result.contains("name: val.name"));
172        assert!(result.contains("timeout: val.timeout"));
173        assert!(result.contains("backend: val.backend.map(Into::into)"));
174    }
175
176    #[test]
177    fn test_from_core_to_binding() {
178        let typ = simple_type();
179        let result = gen_from_core_to_binding(&typ, "my_crate", &AHashSet::new());
180        assert!(result.contains("impl From<my_crate::Config> for Config"));
181    }
182
183    #[test]
184    fn test_enum_from_binding_to_core() {
185        let enum_def = simple_enum();
186        let result = gen_enum_from_binding_to_core(&enum_def, "my_crate");
187        assert!(result.contains("impl From<Backend> for my_crate::Backend"));
188        assert!(result.contains("Backend::Cpu => Self::Cpu"));
189        assert!(result.contains("Backend::Gpu => Self::Gpu"));
190    }
191
192    #[test]
193    fn test_enum_from_core_to_binding() {
194        let enum_def = simple_enum();
195        let result = gen_enum_from_core_to_binding(&enum_def, "my_crate");
196        assert!(result.contains("impl From<my_crate::Backend> for Backend"));
197        assert!(result.contains("my_crate::Backend::Cpu => Self::Cpu"));
198        assert!(result.contains("my_crate::Backend::Gpu => Self::Gpu"));
199    }
200}
alef_codegen/conversions/mod.rs

alef_codegen/conversions/
mod.rs
