leviath-cli 0.3.8

Command-line interface for Leviath agent framework
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

//! Centered popup geometry and the standard cleared, bordered popup frame.
//!
//! Every overlay in every surface starts the same way: compute a centered
//! rectangle, `Clear` what's underneath, draw a bordered block, and render
//! content into the block's inner area. This module is that shared start.

use ratatui::Frame;
use ratatui::layout::{Constraint, Direction, Layout, Rect};
use ratatui::style::{Color, Style};
use ratatui::widgets::{Block, Borders, Clear};

/// A centred rectangle covering `percent_x`/`percent_y` of `area`.
pub(crate) fn centered(percent_x: u16, percent_y: u16, area: Rect) -> Rect {
    let vertical = Layout::default()
        .direction(Direction::Vertical)
        .constraints([
            Constraint::Percentage((100 - percent_y) / 2),
            Constraint::Percentage(percent_y),
            Constraint::Percentage((100 - percent_y) / 2),
        ])
        .split(area);
    Layout::default()
        .direction(Direction::Horizontal)
        .constraints([
            Constraint::Percentage((100 - percent_x) / 2),
            Constraint::Percentage(percent_x),
            Constraint::Percentage((100 - percent_x) / 2),
        ])
        .split(vertical[1])[1]
}

/// Clear `area`, draw a bordered block titled ` {title} ` in `border_color`,
/// and return the inner rect for the caller's content.
pub(crate) fn popup_frame(frame: &mut Frame, area: Rect, title: &str, border_color: Color) -> Rect {
    frame.render_widget(Clear, area);
    let block = Block::default()
        .borders(Borders::ALL)
        .border_style(Style::default().fg(border_color))
        .title(format!(" {title} "));
    let inner = block.inner(area);
    frame.render_widget(block, area);
    inner
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::tui::test_terminal;
    use crate::tui::theme::C_WARN;

    #[test]
    fn centered_produces_a_rect_inside_the_area() {
        let area = Rect::new(0, 0, 100, 40);
        let popup = centered(60, 50, area);

        assert!(popup.width <= 60);
        assert!(popup.height <= 20);
        assert!(popup.x >= 20);
        assert!(popup.y >= 10);
        assert!(popup.right() <= area.right());
        assert!(popup.bottom() <= area.bottom());
    }

    #[test]
    fn popup_frame_draws_the_title_and_returns_the_inner_rect() {
        let mut terminal = test_terminal();
        let mut inner = Rect::default();
        terminal
            .draw(|frame| {
                let popup = centered(60, 50, frame.area());
                inner = popup_frame(frame, popup, "Confirm", C_WARN);
            })
            .unwrap();

        let text = terminal.backend().text();
        assert!(text.contains(" Confirm "));
        // The inner rect sits strictly inside the bordered popup.
        assert!(inner.width > 0 && inner.height > 0);
    }
}