gitkraft-tui 0.9.1

GitKraft — Git IDE terminal application (Ratatui TUI)
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

use ratatui::style::Color;

use gitkraft_core::{AppTheme, Rgb};

/// All the colour slots the UI needs.  Every view file should obtain a
/// `UiTheme` via `app.theme()` and use these fields instead of hard-coding
/// `Color::*` values.
pub struct UiTheme {
    pub border_active: Color,
    pub border_inactive: Color,
    pub text_primary: Color,
    pub text_secondary: Color,
    pub text_muted: Color,
    pub accent: Color,
    pub success: Color,
    pub warning: Color,
    pub error: Color,
    pub diff_add: Color,
    pub diff_del: Color,
    pub diff_context: Color,
    pub diff_hunk: Color,
    pub sel_bg: Color,
    pub bg: Color,
    /// Eight colours cycled across branch lanes in the commit graph.
    pub graph_colors: [Color; 8],
}

impl UiTheme {
    /// Convert from the core's platform-agnostic theme.
    pub fn from_core(t: &AppTheme) -> Self {
        let gc = &t.graph_colors;
        Self {
            border_active: rgb_to_color(t.accent),
            border_inactive: rgb_to_color(t.border),
            text_primary: rgb_to_color(t.text_primary),
            text_secondary: rgb_to_color(t.text_secondary),
            text_muted: rgb_to_color(t.text_muted),
            accent: rgb_to_color(t.accent),
            success: rgb_to_color(t.success),
            warning: rgb_to_color(t.warning),
            error: rgb_to_color(t.error),
            diff_add: rgb_to_color(t.diff_add),
            diff_del: rgb_to_color(t.diff_del),
            diff_context: rgb_to_color(t.diff_context),
            diff_hunk: rgb_to_color(t.diff_hunk),
            sel_bg: rgb_to_color(t.selection),
            bg: rgb_to_color(t.background),
            graph_colors: [
                rgb_to_color(gc[0]),
                rgb_to_color(gc[1]),
                rgb_to_color(gc[2]),
                rgb_to_color(gc[3]),
                rgb_to_color(gc[4]),
                rgb_to_color(gc[5]),
                rgb_to_color(gc[6]),
                rgb_to_color(gc[7]),
            ],
        }
    }
}

/// Convert a core [`Rgb`] to a ratatui [`Color`].
fn rgb_to_color(rgb: Rgb) -> Color {
    Color::Rgb(rgb.r, rgb.g, rgb.b)
}

/// Map a theme index (0–26) to a concrete `UiTheme` by delegating to the
/// canonical definitions in `gitkraft_core`.
pub fn theme_for_index(index: usize) -> UiTheme {
    UiTheme::from_core(&gitkraft_core::theme_by_index(index))
}

// ── Tests ─────────────────────────────────────────────────────────────────────

#[cfg(test)]
mod tests {
    use super::*;
    use gitkraft_core::THEME_COUNT;

    #[test]
    fn all_27_themes_resolve() {
        for i in 0..THEME_COUNT {
            let theme = theme_for_index(i);
            // Just verify it doesn't panic and returns distinct active/inactive borders
            assert_ne!(
                format!("{:?}", theme.border_active),
                format!("{:?}", theme.border_inactive),
                "theme index {i} has identical active and inactive border colors"
            );
        }
    }

    #[test]
    fn out_of_range_returns_default() {
        let d = theme_for_index(0);
        let oob = theme_for_index(999);
        assert_eq!(
            format!("{:?}", d.border_active),
            format!("{:?}", oob.border_active)
        );
    }

    #[test]
    fn from_core_round_trips_rgb() {
        let core_theme = gitkraft_core::theme_by_index(8); // Dracula
        let ui = UiTheme::from_core(&core_theme);
        assert_eq!(
            ui.bg,
            Color::Rgb(
                core_theme.background.r,
                core_theme.background.g,
                core_theme.background.b
            )
        );
        assert_eq!(
            ui.accent,
            Color::Rgb(
                core_theme.accent.r,
                core_theme.accent.g,
                core_theme.accent.b
            )
        );
    }
}