arct-tui 0.2.2

Terminal UI for Arc Academy Terminal - interactive shell learning interface
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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

//! Help overlay panel

use crate::theme::Theme;
use ratatui::{
    layout::{Alignment, Constraint, Direction, Layout, Rect},
    text::{Line, Span},
    widgets::{Block, Borders, Clear, List, ListItem, Paragraph},
    Frame,
};

/// Help panel
pub struct HelpPanel;

impl HelpPanel {
    pub fn new() -> Self {
        Self
    }

    /// Render the help overlay (centered popup)
    pub fn render(&self, frame: &mut Frame, theme: &Theme) {
        let area = Self::centered_rect(60, 80, frame.size());

        // Clear the background
        frame.render_widget(Clear, area);

        let block = Block::default()
            .title(" Arc Academy Terminal - Help ")
            .title_alignment(Alignment::Center)
            .borders(Borders::ALL)
            .border_style(theme.style_border_focused())
            .style(theme.style_block());  // Set background for light themes

        let inner = block.inner(area);
        frame.render_widget(block, area);

        // Split into sections
        let chunks = Layout::default()
            .direction(Direction::Vertical)
            .constraints([
                Constraint::Length(7),  // Navigation
                Constraint::Length(6),  // Editing
                Constraint::Length(5),  // Actions
                Constraint::Min(1),     // Info
            ])
            .split(inner);

        // Navigation section
        let nav_items = vec![
            ListItem::new(Line::from(vec![
                Span::styled("Navigation", theme.style_header()),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Tab", theme.style_accent()),
                Span::raw(" / "),
                Span::styled("Shift+Tab", theme.style_accent()),
                Span::raw("  →  Switch panels"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Ctrl+↑/↓", theme.style_accent()),
                Span::raw("         →  Scroll output (any panel)"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  ↑/↓", theme.style_accent()),
                Span::raw(" or "),
                Span::styled("j/k", theme.style_accent()),
                Span::raw("       →  Scroll (when Output focused)"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  PgUp/PgDn", theme.style_accent()),
                Span::raw("        →  Page scroll output"),
            ])),
        ];
        frame.render_widget(List::new(nav_items), chunks[0]);

        // Editing section
        let edit_items = vec![
            ListItem::new(Line::from(vec![
                Span::styled("Command Editing", theme.style_header()),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Type", theme.style_accent()),
                Span::raw("              →  Enter command"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Enter", theme.style_accent()),
                Span::raw("            →  Explain command"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Backspace", theme.style_accent()),
                Span::raw("        →  Delete character"),
            ])),
        ];
        frame.render_widget(List::new(edit_items), chunks[1]);

        // Actions section
        let action_items = vec![
            ListItem::new(Line::from(vec![
                Span::styled("Actions", theme.style_header()),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  Ctrl+t", theme.style_accent()),
                Span::raw("           →  Toggle theme"),
            ])),
            ListItem::new(Line::from(vec![
                Span::styled("  q", theme.style_accent()),
                Span::raw(" or "),
                Span::styled("Ctrl+c", theme.style_accent()),
                Span::raw("    →  Quit"),
            ])),
        ];
        frame.render_widget(List::new(action_items), chunks[2]);

        // Info section
        let info = Paragraph::new(vec![
            Line::from(""),
            Line::from(vec![
                Span::styled("Press ", theme.style_dim()),
                Span::styled("?", theme.style_accent()),
                Span::styled(" or ", theme.style_dim()),
                Span::styled("Esc", theme.style_accent()),
                Span::styled(" to close this help", theme.style_dim()),
            ]),
        ])
        .alignment(Alignment::Center);
        frame.render_widget(info, chunks[3]);
    }

    /// Helper function to create a centered rectangle
    fn centered_rect(percent_x: u16, percent_y: u16, r: Rect) -> Rect {
        let popup_layout = Layout::default()
            .direction(Direction::Vertical)
            .constraints([
                Constraint::Percentage((100 - percent_y) / 2),
                Constraint::Percentage(percent_y),
                Constraint::Percentage((100 - percent_y) / 2),
            ])
            .split(r);

        Layout::default()
            .direction(Direction::Horizontal)
            .constraints([
                Constraint::Percentage((100 - percent_x) / 2),
                Constraint::Percentage(percent_x),
                Constraint::Percentage((100 - percent_x) / 2),
            ])
            .split(popup_layout[1])[1]
    }
}

impl Default for HelpPanel {
    fn default() -> Self {
        Self::new()
    }
}