zero-tui 0.1.2

Terminal UI widgets and app state for supervising ZERO.
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

//! The five modes (ADR-015). `Calibration`, `Scars`, `Risk`, and
//! `Network` are overlays dispatched by `zero-commands`, not modes.

use std::fmt;

#[derive(Debug, Default, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Mode {
    #[default]
    Conversation,
    Positions,
    Decisions,
    Heat,
    Cockpit,
}

impl Mode {
    /// Short label for the status bar: `CONV`, `POS`, `DEC`, `HEAT`, `LIVE`.
    #[must_use]
    pub const fn short(self) -> &'static str {
        match self {
            Self::Conversation => "CONV",
            Self::Positions => "POS",
            Self::Decisions => "DEC",
            Self::Heat => "HEAT",
            Self::Cockpit => "LIVE",
        }
    }

    /// Full label used in overlays and docs.
    #[must_use]
    pub const fn full(self) -> &'static str {
        match self {
            Self::Conversation => "conversation",
            Self::Positions => "positions",
            Self::Decisions => "decisions",
            Self::Heat => "heat",
            Self::Cockpit => "cockpit",
        }
    }

    /// Decode a `Ctrl+N` digit (1..=5). `Ctrl+0` returns
    /// [`Mode::Conversation`]. Returns `None` for Ctrl+6..9 —
    /// those bindings are deliberately unbound (ADR-015).
    #[must_use]
    pub const fn from_digit(d: u8) -> Option<Self> {
        match d {
            0 | 1 => Some(Self::Conversation),
            2 => Some(Self::Positions),
            3 => Some(Self::Decisions),
            4 => Some(Self::Heat),
            5 => Some(Self::Cockpit),
            _ => None,
        }
    }
}

impl fmt::Display for Mode {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.full())
    }
}

#[cfg(test)]
mod tests {
    use super::Mode;

    #[test]
    fn digit_mapping() {
        assert_eq!(Mode::from_digit(0), Some(Mode::Conversation));
        assert_eq!(Mode::from_digit(1), Some(Mode::Conversation));
        assert_eq!(Mode::from_digit(2), Some(Mode::Positions));
        assert_eq!(Mode::from_digit(3), Some(Mode::Decisions));
        assert_eq!(Mode::from_digit(4), Some(Mode::Heat));
        assert_eq!(Mode::from_digit(5), Some(Mode::Cockpit));
        for d in 6..=9u8 {
            assert_eq!(Mode::from_digit(d), None, "Ctrl+{d} must be unbound");
        }
    }
}