next-rs-macros 0.3.0

Procedural macros for next.rs - #[server_component], #[client_component], #[server_action]
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
94

use proc_macro::TokenStream;
use quote::quote;
use syn::{parse_macro_input, ItemFn};

/// Marks a function as a server component.
///
/// Server components run only on the server and can access databases,
/// file systems, and other server-only resources directly.
///
/// ```rust,ignore
/// #[server_component]
/// fn article_list() -> Element {
///     div().child(h1().text("Articles"))
/// }
/// ```
#[proc_macro_attribute]
pub fn server_component(_attr: TokenStream, item: TokenStream) -> TokenStream {
    let input = parse_macro_input!(item as ItemFn);
    let fn_name = &input.sig.ident;
    let fn_name_str = fn_name.to_string();
    let vis = &input.vis;
    let block = &input.block;
    let output = &input.sig.output;

    let expanded = quote! {
        #vis fn #fn_name() #output {
            next_rs_rsc::global_registry().register_server(module_path!(), #fn_name_str);
            (|| #block)()
        }
    };

    expanded.into()
}

/// Marks a function as a client component.
///
/// Client components are shipped to the browser as WASM and can use
/// interactive features like event handlers and reactive state.
///
/// ```rust,ignore
/// #[client_component]
/// fn counter() -> Element {
///     let (count, set_count) = create_signal(0);
///     div().child(button().text("+").on_click(move |_| set_count.update(|n| *n += 1)))
/// }
/// ```
#[proc_macro_attribute]
pub fn client_component(_attr: TokenStream, item: TokenStream) -> TokenStream {
    let input = parse_macro_input!(item as ItemFn);
    let fn_name = &input.sig.ident;
    let fn_name_str = fn_name.to_string();
    let vis = &input.vis;
    let block = &input.block;
    let output = &input.sig.output;

    let expanded = quote! {
        #vis fn #fn_name() #output {
            next_rs_rsc::global_registry().register_client(module_path!(), #fn_name_str);
            (|| #block)()
        }
    };

    expanded.into()
}

/// Marks an async function as a server action.
///
/// Server actions can be called from client components and are
/// automatically serialized/deserialized across the network boundary.
///
/// ```rust,ignore
/// #[server_action]
/// async fn create_todo(title: String) -> Result<Todo, ActionError> {
///     db::insert_todo(&title).await
/// }
/// ```
#[proc_macro_attribute]
pub fn server_action(_attr: TokenStream, item: TokenStream) -> TokenStream {
    let input = parse_macro_input!(item as ItemFn);
    let fn_name = &input.sig.ident;
    let fn_name_str = fn_name.to_string();
    let vis = &input.vis;
    let sig = &input.sig;
    let block = &input.block;

    let expanded = quote! {
        #vis #sig {
            next_rs_rsc::global_registry().register_server(module_path!(), #fn_name_str);
            #block
        }
    };

    expanded.into()
}