fret-ui 0.1.0

Mechanism-layer UI engine for Fret with tree, layout, focus, routing, and interaction contracts.
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

use super::*;

impl<H: UiHost> UiTree<H> {
    pub(crate) fn request_redraw_coalesced(&mut self, app: &mut H) {
        let Some(window) = self.window else {
            return;
        };
        let tick = app.tick_id();
        if self.last_redraw_request_tick == Some(tick) {
            return;
        }
        self.last_redraw_request_tick = Some(tick);
        app.request_redraw(window);
    }

    /// Resolve the live attached node currently associated with `element` in this tree.
    ///
    /// This is the authoritative element-to-node query when callers already have access to the
    /// current `UiTree` and need a node that is still attached to an active layer tree.
    pub fn live_attached_node_for_element(
        &self,
        app: &mut H,
        element: GlobalElementId,
    ) -> Option<NodeId> {
        self.resolve_live_attached_node_for_element(app, self.window, element)
    }

    pub(crate) fn node_bounds(&self, node: NodeId) -> Option<Rect> {
        self.nodes.get(node).map(|n| n.bounds)
    }

    pub(crate) fn node_needs_layout(&self, node: NodeId) -> bool {
        self.nodes.get(node).is_some_and(|n| n.invalidation.layout)
    }

    pub(crate) fn node_exists(&self, node: NodeId) -> bool {
        self.nodes.contains_key(node)
    }

    pub(crate) fn set_node_element(&mut self, node: NodeId, element: Option<GlobalElementId>) {
        if let Some(n) = self.nodes.get_mut(node) {
            n.element = element;
        }
    }

    pub(crate) fn node_element(&self, node: NodeId) -> Option<GlobalElementId> {
        self.nodes.get(node).and_then(|n| n.element)
    }

    pub(crate) fn node_layout_invalidated(&self, node: NodeId) -> bool {
        self.nodes
            .get(node)
            .map(|n| n.invalidation.layout)
            .unwrap_or(false)
    }

    pub(crate) fn node_measured_size(&self, node: NodeId) -> Option<Size> {
        self.nodes.get(node).map(|n| n.measured_size)
    }

    pub(crate) fn node_text_wrap_none_measure_cache(&self, node: NodeId) -> Option<(u64, Size)> {
        self.nodes.get(node).and_then(|n| {
            n.text_wrap_none_measure_cache
                .map(|cache| (cache.fingerprint, cache.size))
        })
    }
}