resuma 0.4.6

Resuma - SSR + Resumability + Islands + Server Actions + JS Bridge for Rust
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! Component trait & helpers.

use serde::Serialize;

use super::signal::Signal;
use super::store::Store;
use super::view::{Child, Dynamic, View};

/// Trait implemented by every renderable unit. The `#[component]` macro
/// generates an implementation pointing at the component's render fn.
///
/// Components receive their props by value; reactive state lives in signals
/// captured inside the body. Components are *only* invoked on the server.
pub trait Component {
    type Props: Clone + Send + Sync + 'static;

    fn name() -> &'static str;
    fn render(props: Self::Props) -> View;
}

/// Anything that can be turned into a `View` for child interpolation in the
/// `view!{}` macro. The trait takes `&self` so interpolating `{count}` does
/// not move `count` out of the surrounding scope — important because the
/// same signal is typically referenced from multiple event handlers.
#[allow(clippy::wrong_self_convention)]
pub trait IntoView {
    fn into_view(&self) -> View;
}

impl IntoView for View {
    fn into_view(&self) -> View {
        self.clone()
    }
}

impl IntoView for str {
    fn into_view(&self) -> View {
        View::text(self)
    }
}

impl IntoView for String {
    fn into_view(&self) -> View {
        View::text(self.clone())
    }
}

impl IntoView for &str {
    fn into_view(&self) -> View {
        View::text(*self)
    }
}

macro_rules! impl_into_view_display {
    ($($t:ty),*) => {
        $(
            impl IntoView for $t {
                fn into_view(&self) -> View { View::text(self.to_string()) }
            }
        )*
    }
}

impl_into_view_display!(
    i8, i16, i32, i64, i128, isize, u8, u16, u32, u64, u128, usize, f32, f64, bool, char
);

impl<T: IntoView> IntoView for Option<T> {
    fn into_view(&self) -> View {
        match self {
            Some(v) => v.into_view(),
            None => View::empty(),
        }
    }
}

impl<T: IntoView> IntoView for Vec<T> {
    fn into_view(&self) -> View {
        let children: Vec<Child> = self.iter().map(|v| Child::View(v.into_view())).collect();
        View::fragment(children)
    }
}

/// `Signal<T>` interpolated inside `view!{ {count} }` becomes a reactive
/// `<resuma-dyn>` node bound to the signal id.
impl<T: Clone + Serialize + 'static> IntoView for Signal<T> {
    fn into_view(&self) -> View {
        let snapshot = serde_json::to_value(self.peek()).unwrap_or(serde_json::Value::Null);
        View::Dynamic(Dynamic {
            signal: self.id(),
            format: None,
            snapshot,
        })
    }
}

impl<T: Clone + Serialize + 'static> IntoView for &Signal<T> {
    fn into_view(&self) -> View {
        (*self).into_view()
    }
}

impl<T: Clone + Serialize + for<'de> serde::Deserialize<'de> + 'static> IntoView for Store<T> {
    fn into_view(&self) -> View {
        self.signal().into_view()
    }
}

impl<T: Clone + Serialize + for<'de> serde::Deserialize<'de> + 'static> IntoView for &Store<T> {
    fn into_view(&self) -> View {
        self.signal().into_view()
    }
}