uzor 1.2.2

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

//! Read-only snapshot of LM state — wire format for `GET` endpoints.

use serde::Serialize;

#[derive(Debug, Clone, Serialize)]
pub struct AgentSnapshot {
    pub root: RootSnapshot,
    pub windows: Vec<BranchSnapshot>,
    pub sync_nodes: Vec<NodeSyncSnapshot>,
    pub frame_time_ms: f64,
    pub frame_count: u64,
    pub fps_ema: f32,
}

#[derive(Debug, Clone, Serialize)]
pub struct RootSnapshot {
    pub current_window: Option<String>,
    pub window_count: usize,
    pub style_preset: Option<String>,
}

#[derive(Debug, Clone, Serialize)]
pub struct BranchSnapshot {
    pub key: String,
    pub rect: RectSnap,
    pub initialised: bool,
    pub tick_count: u64,
    /// Resolved baseline `TickRate` as a short label
    /// (`"dirty"`, `"60"`, `"uncapped"`).
    pub tick_rate: String,

    pub chrome_visible: bool,
    pub edge_count: usize,
    pub dock_leaves: usize,
    pub overlay_count: usize,

    pub modal_count: usize,
    pub popup_count: usize,
    pub dropdown_count: usize,
    pub toolbar_count: usize,
    pub sidebar_count: usize,
    pub context_menu_count: usize,

    pub hovered_widget: Option<String>,
    pub pressed_widget: Option<String>,
    pub last_click: Option<ClickSnap>,
    pub pointer_pos: Option<[f64; 2]>,

    /// Full docking tree: hierarchical split / leaf nodes with layout
    /// kind, raw proportions, and (for leaves) the active panel
    /// `type_id`.  Lets agents see the actual structure instead of
    /// guessing from `dock_leaves` count.
    pub dock_tree: DockNodeSnap,
}

/// One node of the docking tree as exposed via the agent snapshot.
#[derive(Debug, Clone, Serialize)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum DockNodeSnap {
    /// A panel-bearing leaf.  `panel_id` is the active panel's
    /// `type_id()` — same string `lm::panel(slot_id, ...)` resolves on.
    Leaf {
        leaf_id:  u64,
        panel_id: Option<String>,
        rect:     RectSnap,
    },
    /// A split / grid container.  `layout` is the lowercase debug
    /// label of `WindowLayout` (e.g. `"split_horizontal"`).
    /// `proportions` are the raw weights as stored — solver
    /// normalises them on read.
    Branch {
        branch_id:   u64,
        layout:      String,
        proportions: Vec<f64>,
        children:    Vec<DockNodeSnap>,
    },
}

#[derive(Debug, Clone, Copy, Serialize)]
pub struct RectSnap {
    pub x: f64,
    pub y: f64,
    pub w: f64,
    pub h: f64,
}

#[derive(Debug, Clone, Serialize)]
pub struct ClickSnap {
    pub widget: String,
    pub pos: [f64; 2],
}

#[derive(Debug, Clone, Serialize)]
pub struct NodeSyncSnapshot {
    pub node_id: String,
    pub mode: String,
    pub group_id: Option<u64>,
}

#[derive(Debug, Clone, Serialize)]
pub struct WidgetSnapshot {
    pub window: String,
    pub id:     String,
    pub kind:   String,
    pub rect:   RectSnap,
    /// Layer name resolved through `LM::compute_layer_for`.  Empty for
    /// widgets whose layer cannot be determined from the tree alone.
    pub layer:  String,
    /// Human-readable text the L3 builder attached (button text, label
    /// content).  Lets agents address widgets by visible label
    /// instead of having to know their stable id.
    pub label:  Option<String>,
}