euv-core 0.3.28

A declarative, cross-platform UI framework for Rust with virtual DOM, reactive signals, and HTML macros for WebAssembly.
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

use crate::*;

/// Inner state of a RenderEffect, holding the effect closure and dependency tracking.
///
/// Each RenderEffect tracks which signals it depends on, and when any of those
/// signals change, the effect is re-executed automatically. Before each
/// re-execution, old dependencies are cleaned up to prevent listener accumulation.
#[derive(CustomDebug, Data, New)]
pub(crate) struct RenderEffectInner {
    /// The effect closure to re-execute when dependencies change.
    #[debug(skip)]
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) effect_fn: Box<dyn FnMut()>,
    /// Addresses of signals this effect currently depends on.
    ///
    /// Populated during `run_once` by `track_signal`. Before each
    /// `run_once`, these dependencies are cleaned up (the effect's
    /// subscriber entry is removed from each signal's registry entry).
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) dependencies: Vec<usize>,
    /// Re-entrancy guard. Set to `true` while the effect closure is
    /// executing. If `run_once` is called recursively while this is
    /// `true`, the call is skipped to prevent infinite loops caused
    /// by signals being set inside the effect closure.
    #[get(pub(crate), type(copy))]
    #[set(pub(crate))]
    pub(crate) running: bool,
    /// Whether this effect has been disposed and should no longer execute.
    ///
    /// When a `RenderEffect` is disposed, `run_once` becomes a no-op and
    /// `cleanup_effect_dependencies` is called to remove all subscriber
    /// entries from the global registry. This prevents stale effects from
    /// being scheduled or executed after their associated DOM nodes have
    /// been removed (e.g., during match arm switches in routing).
    #[get(pub(crate), type(copy))]
    #[set(pub(crate))]
    pub(crate) disposed: bool,
}

/// A reactive effect that automatically tracks signal dependencies and
/// re-executes when any dependency changes.
///
/// Unlike the global `__euv_signal_update__` mechanism which broadcasts to
/// all DynamicNodes, a RenderEffect only re-runs when signals it actually
/// reads have changed, enabling fine-grained reactive updates.
#[derive(Clone, CustomDebug, Data, New)]
pub struct RenderEffect {
    /// Shared reference to the heap-allocated inner state.
    #[debug(skip)]
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) inner: Rc<RefCell<RenderEffectInner>>,
}

/// A `Sync` wrapper for single-threaded global `HashMap` access.
///
/// SAFETY: This type is only safe to use in single-threaded contexts
/// (e.g., WASM). It implements `Sync` to allow usage as a `static mut`
/// variable, but concurrent access from multiple threads would be
/// undefined behavior.
#[derive(Data, Debug, New)]
pub(crate) struct EffectSubscribersCell(
    /// Interior-mutable storage for the effect subscribers registry.
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) UnsafeCell<Option<HashMap<usize, Vec<usize>>>>,
);

/// A `Sync` wrapper for single-threaded global `Option<usize>` access.
///
/// SAFETY: This type is only safe to use in single-threaded contexts
/// (e.g., WASM). It implements `Sync` to allow usage as a `static mut`
/// variable, but concurrent access from multiple threads would be
/// undefined behavior.
#[derive(Data, Debug, New)]
pub(crate) struct CurrentEffectCell(
    /// Interior-mutable storage for the current effect address.
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) UnsafeCell<Option<usize>>,
);

/// A `Sync` wrapper for single-threaded global `HashMap` access.
///
/// SAFETY: This type is only safe to use in single-threaded contexts
/// (e.g., WASM). It implements `Sync` to allow usage as a `static mut`
/// variable, but concurrent access from multiple threads would be
/// undefined behavior.
#[derive(Data, Debug, New)]
pub(crate) struct RenderEffectRegistryCell(
    /// Interior-mutable storage for the render effect registry.
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) UnsafeCell<Option<HashMap<usize, Rc<RefCell<RenderEffectInner>>>>>,
);