evault-tui 0.1.0

Terminal user interface for evault.
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

//! Error modal — focused popup that surfaces an action failure with
//! an explanatory hint. Replaces the bottom-bar toast for cases
//! where the user just initiated the failing action and a quiet
//! toast would be too easy to miss.

use ratatui::layout::{Constraint, Layout, Rect};
use ratatui::style::{Modifier, Style};
use ratatui::text::{Line, Span};
use ratatui::widgets::{Block, Clear, Paragraph, Wrap};
use ratatui::Frame;

use crate::app::AppState;
use crate::theme::Theme;

pub fn render(frame: &mut Frame<'_>, area: Rect, app: &AppState, theme: &Theme) {
    let Some(modal) = app.current_error_modal() else {
        return;
    };
    frame.render_widget(Clear, area);

    // Bordered block in the error palette + a clear "Error" title.
    let block = Block::bordered()
        .title(Line::from(vec![
            Span::raw(" "),
            Span::styled(
                "\u{2716}",
                Style::new().fg(theme.error).add_modifier(Modifier::BOLD),
            ),
            Span::raw(" "),
            Span::styled(
                modal.title.clone(),
                Style::new().fg(theme.error).add_modifier(Modifier::BOLD),
            ),
            Span::raw(" "),
        ]))
        .border_style(Style::new().fg(theme.error));
    let inner = block.inner(area);
    frame.render_widget(block, area);

    // Layout: top spacer · message · spacer · hint · spacer · dismiss.
    // The message row is a FIXED 3 lines (enough for the typical
    // backend message wrapped to the modal's width) so the hint
    // sits flush below it rather than getting pushed to the
    // bottom of an expanded message row.
    let rows = Layout::vertical([
        Constraint::Length(1), // top spacer
        Constraint::Length(3), // message — fixed; up to 3 wrapped lines
        Constraint::Length(1), // small spacer (kept for readability)
        Constraint::Min(3),    // hint — fills remaining
        Constraint::Length(1), // bottom spacer
        Constraint::Length(1), // dismiss hint
    ])
    .split(inner);

    // Message — leading error icon then the raw backend message,
    // wrapped so long messages don't get truncated.
    if let Some(&r) = rows.get(1) {
        let lines = vec![Line::from(vec![
            Span::styled(
                " \u{2716} ",
                Style::new().fg(theme.error).add_modifier(Modifier::BOLD),
            ),
            Span::styled(modal.message.clone(), Style::new().fg(theme.error)),
        ])];
        frame.render_widget(Paragraph::new(lines).wrap(Wrap { trim: false }), r);
    }

    // Optional hint — rendered as one Line per `\n`-separated chunk
    // so bullet lists and paragraph breaks survive intact. Each
    // line is then wrapped independently if it overflows the modal
    // width. Empty lines (from blank `\n\n`) become spacers.
    if let (Some(&r), Some(hint)) = (rows.get(3), modal.hint.as_deref()) {
        let lines: Vec<Line<'_>> = hint
            .split('\n')
            .map(|chunk| {
                Line::from(vec![
                    Span::raw(" "),
                    Span::styled(chunk.to_owned(), theme.dim_cell()),
                ])
            })
            .collect();
        let para = Paragraph::new(lines).wrap(Wrap { trim: false });
        frame.render_widget(para, r);
    }

    if let Some(&r) = rows.get(5) {
        let hint = Line::from(vec![
            Span::styled(" Enter ", Style::new().fg(theme.accent)),
            Span::styled("acknowledge  \u{00b7}  ", theme.dim_cell()),
            Span::styled("Esc ", Style::new().fg(theme.accent)),
            Span::styled("dismiss", theme.dim_cell()),
        ]);
        frame.render_widget(Paragraph::new(hint), r);
    }
}