rpi-extensions 0.5.0

Rust-native (cdylib) plugin loader + AgentTool adapter for rpi — libloading + spawn_blocking ABI bridge
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

//! Internal text component layout used by the TUI renderer.
use serde::{Deserialize, Serialize};

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "kebab-case")]
pub enum PanelAnchor {
    TopLeft,
    TopCenter,
    #[default]
    TopRight,
    LeftCenter,
    Center,
    RightCenter,
    BottomLeft,
    BottomCenter,
    BottomRight,
}

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "kebab-case")]
pub enum PanelLayout {
    #[default]
    Overlay,
    Sidebar,
    Footer,
}

/// Theme colors for literal text highlights; terminal escapes are never accepted.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "kebab-case")]
pub enum PanelHighlightColor {
    Warning,
    Error,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
pub struct PanelHighlight {
    pub text: String,
    pub color: PanelHighlightColor,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ExtensionPanel {
    pub version: u32,
    #[serde(default)]
    pub order: i32,
    #[serde(default)]
    pub layout: PanelLayout,
    #[serde(default)]
    pub anchor: PanelAnchor,
    #[serde(default)]
    pub offset_x: i32,
    #[serde(default)]
    pub offset_y: i32,
    #[serde(default = "default_width")]
    pub width: usize,
    #[serde(default = "default_height")]
    pub max_height: usize,
    #[serde(default)]
    pub min_screen_width: usize,
    #[serde(default = "default_border")]
    pub border: bool,
    #[serde(default)]
    pub title: String,
    pub lines: Vec<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub highlights: Vec<PanelHighlight>,
}
fn default_width() -> usize {
    44
}
fn default_height() -> usize {
    16
}
fn default_border() -> bool {
    true
}
impl ExtensionPanel {
    pub fn validate(&self) -> Result<(), String> {
        if self.version != 1 {
            return Err("unsupported panel version (expected 1)".into());
        }
        if !(4..=240).contains(&self.width)
            || !(1..=80).contains(&self.max_height)
            || self.min_screen_width > 1000
            || self.offset_x.unsigned_abs() > 1000
            || self.offset_y.unsigned_abs() > 1000
        {
            return Err("panel geometry is out of range".into());
        }
        if self.lines.len() > 64
            || self.lines.iter().any(|line| line.len() > 2048)
            || self.title.len() > 256
        {
            return Err("panel content exceeds limits".into());
        }
        if self.highlights.len() > 32
            || self.highlights.iter().any(|h| {
                h.text.is_empty() || h.text.len() > 256 || h.text.chars().any(char::is_control)
            })
        {
            return Err("invalid panel highlights".into());
        }
        Ok(())
    }
    /// Content updates retain the same overlay and its stacking position.
    pub fn same_geometry(&self, other: &Self) -> bool {
        self.layout == other.layout
            && self.anchor == other.anchor
            && self.offset_x == other.offset_x
            && self.offset_y == other.offset_y
            && self.width == other.width
            && self.max_height == other.max_height
    }
}