fob-gen 0.5.0

Ergonomic JavaScript code generation using OXC AST builders
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

//! Internal AST utility traits for fob-core
//!
//! These utilities are marked as internal and may change without notice.
//! They're intended for use within the fob ecosystem, not as public API.

#[cfg(feature = "fob_internal")]
mod internal_impl {
    use crate::ProgramBuilder;
    use oxc_ast::ast::*;

    /// Trait for manipulating imports in AST
    pub trait ImportManipulation<'a> {
        /// Rename an import from one name to another
        fn rename_import(&mut self, from: &str, to: &str);

        /// Ensure a default export exists with the given identifier
        fn ensure_default_export(&mut self, ident: &str);

        /// Add a side-effect import
        fn add_side_effect_import(&mut self, source: &str);
    }

    /// Trait for injecting development helpers
    pub trait DevInjection<'a> {
        /// Inject reload client script reference
        fn inject_reload_client(&mut self, entry_ident: &str);

        /// Wrap exports with development boundary
        fn wrap_with_dev_boundary(&mut self, builder: &ProgramBuilder<'a>);
    }

    /// Trait for common AST mutations
    pub trait AstMutations<'a> {
        /// Rename all references to an identifier
        fn rename_identifier(&mut self, old_name: &str, new_name: &str);

        /// Wrap a function call with error handling
        fn wrap_call_with_error_handling(
            &mut self,
            builder: &ProgramBuilder<'a>,
            call: &CallExpression<'a>,
        );
    }
}

#[cfg(feature = "fob_internal")]
pub use internal_impl::*;