uzor 1.0.20

Core UI engine — geometry, interaction, input state
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

//! Button state adapter - Contract/Connector for button interaction state
//!
//! **ButtonState is a CONTRACT/CONNECTOR trait** that connects:
//! - Factory rendering functions (`factory/render.rs`)
//! - External state management systems (app state, Redux, ECS, etc.)

/// State adapter for button interaction
///
/// This trait defines the contract for tracking button interaction state.
/// External projects implement this trait to integrate with their state management systems.
pub trait ButtonState {
    // =========================================================================
    // Read State (Immutable)
    // =========================================================================

    /// Check if button is currently hovered
    fn is_hovered(&self, button_id: &str) -> bool;

    /// Check if button is currently pressed
    fn is_pressed(&self, button_id: &str) -> bool;

    /// Check if button is currently focused
    fn is_focused(&self, button_id: &str) -> bool;

    // =========================================================================
    // Write State (Mutable)
    // =========================================================================

    /// Set button hover state
    fn set_hovered(&mut self, button_id: Option<&str>);

    /// Set button pressed state
    fn set_pressed(&mut self, button_id: Option<&str>);

    /// Set button focus state
    fn set_focused(&mut self, button_id: Option<&str>);
}

// =============================================================================
// Default State Implementation
// =============================================================================

/// Simple implementation of ButtonState for prototyping
#[derive(Clone, Debug, Default)]
pub struct SimpleButtonState {
    /// Currently hovered button ID
    pub hovered: Option<String>,

    /// Currently pressed button ID
    pub pressed: Option<String>,

    /// Currently focused button ID
    pub focused: Option<String>,
}

impl SimpleButtonState {
    /// Create new button state
    pub fn new() -> Self {
        Self {
            hovered: None,
            pressed: None,
            focused: None,
        }
    }
}

impl ButtonState for SimpleButtonState {
    fn is_hovered(&self, button_id: &str) -> bool {
        self.hovered.as_deref() == Some(button_id)
    }

    fn is_pressed(&self, button_id: &str) -> bool {
        self.pressed.as_deref() == Some(button_id)
    }

    fn is_focused(&self, button_id: &str) -> bool {
        self.focused.as_deref() == Some(button_id)
    }

    fn set_hovered(&mut self, button_id: Option<&str>) {
        self.hovered = button_id.map(|s| s.to_string());
    }

    fn set_pressed(&mut self, button_id: Option<&str>) {
        self.pressed = button_id.map(|s| s.to_string());
    }

    fn set_focused(&mut self, button_id: Option<&str>) {
        self.focused = button_id.map(|s| s.to_string());
    }
}