w-gui 0.21.7

A lightweight immediate-mode debug GUI served over localhost
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

use std::sync::Arc;

use serde::{Deserialize, Serialize};

pub type ElementId = String;

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[serde(tag = "type", content = "data")]
pub enum Value {
    Float(f64),
    Bool(bool),
    Color3([f32; 3]),
    Color4([f32; 4]),
    Vec2([f32; 2]),
    Vec3([f32; 3]),
    Int(i64),
    String(String),
    Enum {
        selected: usize,
        options: Vec<String>,
    },
    /// Transient: true for one frame when clicked
    Button(bool),
    /// Progress value (0.0 to 1.0)
    Progress(f64),
    /// Stat card value with optional subvalue
    StatValue {
        value: String,
        subvalue: Option<String>,
    },
    /// Status indicator state
    StatusValue {
        active: bool,
        #[serde(skip_serializing_if = "Option::is_none")]
        active_text: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        inactive_text: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        active_color: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        inactive_color: Option<String>,
    },
    /// Mini chart data
    ChartValue {
        values: Vec<f32>,
        #[serde(skip_serializing_if = "Option::is_none")]
        current: Option<f32>,
        #[serde(skip_serializing_if = "Option::is_none")]
        unit: Option<String>,
    },
    /// Grid container data
    GridValue {
        cols: usize,
        children: Vec<String>,
    },
    /// Plot data for larger charts
    PlotValue {
        series: Vec<PlotSeries>,
        #[serde(skip_serializing_if = "Option::is_none")]
        x_label: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        y_label: Option<String>,
    },
    /// Null value for container elements
    Null,
}

/// A data series for plotting
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct PlotSeries {
    pub name: String,
    pub values: Vec<f32>,
    pub color: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[serde(tag = "type", content = "data")]
pub enum ElementKind {
    Slider,
    Checkbox,
    ColorPicker3,
    ColorPicker4,
    TextInput,
    Dropdown,
    Button,
    Label,
    Separator,
    /// Section header for grouping
    Section,
    /// Progress bar with percentage
    ProgressBar,
    /// Stat card display
    Stat,
    /// Status indicator with colored dot
    Status,
    /// Mini sparkline chart
    MiniChart,
    /// Grid layout container
    Grid,
    /// Larger plot/chart for data visualization
    Plot,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize, PartialEq)]
pub struct ElementMeta {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub step: Option<f64>,
    /// Accent color for the element (coral, teal, blue, green, purple, orange, yellow, red)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub accent: Option<String>,
    /// Subtitle or secondary text
    #[serde(skip_serializing_if = "Option::is_none")]
    pub subtitle: Option<String>,
    /// Number of columns for grid layout
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cols: Option<usize>,
    /// Child element IDs for grid layout
    #[serde(skip_serializing_if = "Option::is_none")]
    pub children: Option<Vec<String>>,
}

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElementDecl {
    pub id: ElementId,
    pub kind: ElementKind,
    pub label: String,
    pub value: Value,
    pub meta: ElementMeta,
    pub window: Arc<str>,
}

/// Accent colors available for UI elements
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AccentColor {
    Coral,
    Teal,
    Blue,
    Green,
    Purple,
    Orange,
    Yellow,
    Red,
}

impl AccentColor {
    pub fn as_str(&self) -> &'static str {
        match self {
            AccentColor::Coral => "coral",
            AccentColor::Teal => "teal",
            AccentColor::Blue => "blue",
            AccentColor::Green => "green",
            AccentColor::Purple => "purple",
            AccentColor::Orange => "orange",
            AccentColor::Yellow => "yellow",
            AccentColor::Red => "red",
        }
    }
}