alef 0.83.2

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

//! Post-processing rewriter for flutter_rust_bridge-generated `lib.dart`.
//!
//! flutter_rust_bridge emits sealed-class tagged-union variants with positional
//! parameter names (`field0`, `field1`, ...) when the underlying Rust variant
//! is a tuple variant:
//!
//! ```dart
//! const factory FormatMetadata.pdf({required PdfMetadata field0}) =
//!     FormatMetadata_Pdf;
//! ```
//!
//! These positional names are awkward for callers and inconsistent with the
//! kotlin/swift/etc. binding surface, which derives payload-informed names
//! (`metadata`, `value`, `value0`, ...) using the shared algorithm defined in
//! `alef-backend-kotlin::gen_bindings::shared::kotlin_field_name_with_type`.
//!
//! [`rewrite_frb_sealed_variants`] post-processes the frb-generated source and
//! rewrites variant parameter names to match the payload-derived convention.
//! Other code in the file is left untouched.
//!
//! Algorithm (per variant declaration line(s)):
//! 1. Match the canonical frb sealed-variant signature:
//!    `const factory <Enum>.<variantCamel>({required <PayloadType> field<N>, ...}) = <Enum>_<VariantPascal>;`
//! 2. Recover the `VariantPascal` token from the trailing assignment so that
//!    the variant name is unambiguous (the dotted form is lowerCamel, which
//!    cannot be reliably inverted back to PascalCase for multi-word variants).
//! 3. For each `field<N>` parameter, derive its new name from the payload type
//!    using the payload-derived helper (see [`payload_param_name`]).

#[path = "frb_rewrite/bridge_coverage.rs"]
mod bridge_coverage;
#[path = "frb_rewrite/cfg_gates.rs"]
mod cfg_gates;
#[path = "frb_rewrite/external_library_loader.rs"]
mod external_library_loader;
#[path = "frb_rewrite/imports_helpers.rs"]
mod imports_helpers;
#[path = "frb_rewrite/sealed_variants.rs"]
mod sealed_variants;
#[cfg(test)]
#[path = "frb_rewrite/tests.rs"]
mod tests;
#[path = "frb_rewrite/text_transformations.rs"]
mod text_transformations;

pub use bridge_coverage::{missing_bridge_functions, undeclared_gate_features};
pub use cfg_gates::{carry_lib_rs_cfg_gates_into_frb_generated, cfg_gated_free_functions, inject_frb_cfg_gates};
pub use sealed_variants::rewrite_frb_sealed_variants;
pub use text_transformations::{
    filter_excluded_functions, fix_handler_executor_calls, inject_display_as_text_methods,
    make_struct_fields_with_defaults_optional, strip_trailing_whitespace,
};