narsil 0.3.1

A terminal-based system resource monitor — GPU-aware, Braille charts, per-char label inversion
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

// Copyright (C) 2026 Raimo Geisel
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.

//! [`SplitGauge`] — a bar gauge with per-character label colour inversion.
//!
//! The label is drawn centred on the bar area. Characters inside the filled
//! region use the bar colour as background with black foreground; characters
//! outside use the bar colour as foreground on the default background.
//! This keeps the percentage text legible at any fill level.

use ratatui::{
    buffer::Buffer,
    layout::Rect,
    style::{Color, Style},
    widgets::{Block, Widget},
};

/// A gauge that inverts the label colour character-by-character at the fill
/// boundary so the percentage text is always readable regardless of fill level.
/// A bar gauge that inverts the label colour at the fill boundary.
///
/// Construct with [`SplitGauge::new`] and optionally attach a titled border
/// block with [`SplitGauge::block`] before passing to `frame.render_widget`.
pub struct SplitGauge<'a> {
    block: Option<Block<'a>>,
    ratio: f64,
    bar_color: Color,
    label: String,
}

impl<'a> SplitGauge<'a> {
    /// Creates a new [`SplitGauge`].
    ///
    /// - `ratio` — fill fraction in `[0.0, 1.0]` (clamped automatically).
    /// - `bar_color` — colour used for both the filled bar and the label text.
    /// - `label` — text centred on the bar (typically a percentage string).
    pub fn new(ratio: f64, bar_color: Color, label: impl Into<String>) -> Self {
        Self {
            block: None,
            ratio: ratio.clamp(0.0, 1.0),
            bar_color,
            label: label.into(),
        }
    }

    /// Wraps the gauge in a [`Block`] (border + optional title).
    pub fn block(mut self, block: Block<'a>) -> Self {
        self.block = Some(block);
        self
    }
}

impl Widget for SplitGauge<'_> {
    fn render(self, area: Rect, buf: &mut Buffer) {
        let inner = match self.block {
            Some(b) => {
                let inner = b.inner(area);
                b.render(area, buf);
                inner
            }
            None => area,
        };

        if inner.width == 0 || inner.height == 0 {
            return;
        }

        let width = inner.width as usize;
        let fill = ((self.ratio * width as f64).round() as usize).min(width);

        let label_chars: Vec<char> = self.label.chars().collect();
        let label_len = label_chars.len();
        let label_start = width.saturating_sub(label_len) / 2;
        let mut chars = vec![' '; width];
        for (i, &c) in label_chars.iter().enumerate() {
            let pos = label_start + i;
            if pos < width {
                chars[pos] = c;
            }
        }

        let y = inner.y + inner.height / 2;
        for col in 0..width {
            let x = inner.x + col as u16;
            let style = if col < fill {
                Style::default().fg(Color::Black).bg(self.bar_color)
            } else {
                Style::default().fg(self.bar_color)
            };
            let mut s = [0u8; 4];
            buf.set_string(x, y, chars[col].encode_utf8(&mut s), style);
        }
    }
}