canonrs-interactions-core 0.1.0

CanonRS interactions core types and traits
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

//! RuntimeContext — typed context passed to component mount functions
//!
//! Replaces raw Element passing with a governed context object.
//! Provides access to all runtime services with uid binding.

use web_sys::Element;
use super::lifecycle::LifecycleState;

/// Runtime context passed to component mount/init functions
/// Binds all runtime services to the component's uid
pub struct RuntimeContext {
    /// Component root element
    pub root: Element,
    /// Component uid (data-rs-uid)
    pub uid:  String,
    /// Interaction group
    pub group: String,
}

impl RuntimeContext {
    pub fn new(root: Element, uid: String, group: String) -> Self {
        Self { root, uid, group }
    }

    /// Try to create from element — returns None if uid missing
    pub fn from_element(el: Element) -> Option<Self> {
        let uid   = el.get_attribute("data-rs-uid")?;
        let group = el.get_attribute("data-rs-interaction").unwrap_or_default();
        Some(Self::new(el, uid, group))
    }

    /// Register a listener owned by this component
    pub fn listen<F>(&self, event: &str, cb: F) -> usize
    where F: FnMut(web_sys::Event) + 'static
    {
        let id = super::listeners::listen(&self.uid, &self.root, event, cb);
        super::ownership::track_listener(&self.uid);
        id
    }

    /// Register a document listener owned by this component
    pub fn listen_document<F>(&self, event: &str, cb: F) -> usize
    where F: FnMut(web_sys::Event) + 'static
    {
        let id = super::listeners::listen_document(&self.uid, event, cb);
        super::ownership::track_listener(&self.uid);
        id
    }

    /// Register a window listener owned by this component
    pub fn listen_window<F>(&self, event: &str, cb: F) -> usize
    where F: FnMut(web_sys::Event) + 'static
    {
        let id = super::listeners::listen_window(&self.uid, event, cb);
        super::ownership::track_listener(&self.uid);
        id
    }

    /// Schedule RAF work coalesced by key
    pub fn raf<F>(&self, key: &str, work: F)
    where F: FnOnce() + 'static
    {
        let raf_key = format!("{}:{}", self.uid, key);
        super::scheduler::raf(&raf_key, work);
    }

    /// Schedule batched work
    pub fn batch<F>(&self, key: &str, work: F)
    where F: FnOnce() + 'static
    {
        let batch_key = format!("{}:{}", self.uid, key);
        super::scheduler::batch(&batch_key, work);
    }

    /// Cleanup all resources owned by this component
    pub fn cleanup(&self) {
        super::cleanup::cleanup_uid(&self.uid);
        super::lifecycle::set_state(&self.uid, LifecycleState::Destroy);
        super::ownership::release(&self.uid);
    }

    /// Transition lifecycle state
    pub fn transition(&self, state: LifecycleState) -> bool {
        super::lifecycle::transition(&self.uid, state)
    }

    /// Current lifecycle state
    pub fn state(&self) -> Option<LifecycleState> {
        super::lifecycle::state(&self.uid)
    }
}