alef 0.23.35

Opinionated polyglot binding generator for Rust libraries
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

/// For a variant-wrapper opaque type (one whose `is_variant_wrapper` flag is set),
/// emit a `#[napi(constructor)] pub fn new_constructor(...)` on the prefixed binding
/// struct so that `new WrapperType(args)` JS constructor-syntax resolves at runtime.
///
/// napi-rs allows multiple `#[napi] impl` blocks. The static `new` is already
/// emitted by `gen_opaque_struct_methods` as a `#[napi]` static method; this
/// companion uses a distinct Rust fn name (`new_constructor`) to avoid the
/// duplicate-`fn new` conflict while mapping to the same JS `new Class()` path
/// via `#[napi(constructor)]`.
///
/// Returns `None` when the wrapper has no `new` method in the IR (or its receiver
/// is not `None`), silently skipping rather than panicking.
pub(super) fn napi_variant_wrapper_constructor(
    typ: &crate::core::ir::TypeDef,
    mapper: &crate::backends::napi::type_map::NapiMapper,
    core_import: &str,
    prefix: &str,
) -> Option<String> {
    use crate::codegen::type_mapper::TypeMapper as _;
    let ctor = typ.methods.iter().find(|m| m.name == "new" && m.receiver.is_none())?;
    let map_fn = |t: &crate::core::ir::TypeRef| mapper.map_type(t);
    let sig_params = crate::codegen::shared::function_params(&ctor.params, &map_fn);

    // Build call_args with type conversions where needed.
    // If the mapped type (NAPI) differs from the core type name, apply .into().
    // This handles cases like JsMethod -> Method where a From<JsMethod> impl exists.
    let call_args = ctor
        .params
        .iter()
        .map(|p| {
            let mapped_type = map_fn(&p.ty);

            // Get the core type name. For TypeRef::Named, it's just the name.
            // For other types, the mapped type should match the core type.
            let core_type_name = match &p.ty {
                crate::core::ir::TypeRef::Named(name) => name.as_str(),
                _ => "",
            };

            // If NAPI added a prefix (e.g., "JsMethod" != "Method"), we need to convert.
            // This happens when a custom type is mapped with the prefix.
            let needs_conversion =
                !core_type_name.is_empty() && mapped_type.starts_with(&mapper.prefix) && !mapped_type.contains("::");

            if needs_conversion {
                format!("{}.into()", p.name)
            } else {
                p.name.to_string()
            }
        })
        .collect::<Vec<_>>()
        .join(", ");

    let struct_name = format!("{prefix}{}", typ.name);
    let core_path = crate::codegen::conversions::core_type_path(typ, core_import);
    let body = if call_args.is_empty() {
        format!("Self {{ inner: std::sync::Arc::new({core_path}::new()) }}")
    } else {
        format!("Self {{ inner: std::sync::Arc::new({core_path}::new({call_args})) }}")
    };
    let fn_sig = if sig_params.is_empty() {
        "pub fn new_constructor() -> Self".to_string()
    } else {
        format!("pub fn new_constructor({sig_params}) -> Self")
    };
    Some(format!(
        "#[napi]\nimpl {struct_name} {{\n    #[napi(constructor)]\n    {fn_sig} {{\n        {body}\n    }}\n}}\n",
    ))
}

/// For an explicitly-opaque type with `has_default` that is treated as opaque in NAPI,
/// emit a `#[napi(constructor)] pub fn new() -> Self` to enable JS `new ClassName()` syntax.
/// This is a simple wrapper around the Rust `new()` method that returns a default instance.
pub(super) fn napi_default_constructor(
    typ: &crate::core::ir::TypeDef,
    _mapper: &crate::backends::napi::type_map::NapiMapper,
    core_import: &str,
    prefix: &str,
) -> Option<String> {
    // Only emit constructor if type has a parameterless `new()` method.
    typ.methods
        .iter()
        .find(|m| m.name == "new" && m.receiver.is_none() && m.params.is_empty())?;

    let struct_name = format!("{prefix}{}", typ.name);
    let core_path = crate::codegen::conversions::core_type_path(typ, core_import);

    let constructor = format!(
        "#[napi]\nimpl {struct_name} {{\n    #[napi(constructor)]\n    pub fn new() -> Self {{\n        Self {{ inner: std::sync::Arc::new({core_path}::new()) }}\n    }}\n}}\n"
    );

    Some(constructor)
}