ncoxide 0.4.0

Modal dual-pane file commander with helix-inspired 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

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

pub fn draw_help(f: &mut Frame) {
    let area = f.area();
    // saturating_sub: raw subtraction underflows (panics) on tiny terminals.
    let width = 60u16.min(area.width.saturating_sub(4));
    let height = area.height.saturating_sub(4).min(30);
    let x = area.x + (area.width.saturating_sub(width)) / 2;
    let y = area.y + (area.height.saturating_sub(height)) / 2;
    let rect = Rect::new(x, y, width, height);

    f.render_widget(Clear, rect);

    let key_style = Style::default()
        .fg(Color::Yellow)
        .add_modifier(Modifier::BOLD);

    let lines = vec![
        section("Navigation"),
        key_line("j/k, ↑/↓", "Move cursor up/down", key_style),
        key_line("h, Backspace", "Go to parent directory", key_style),
        key_line("l, Enter", "Enter directory / open file", key_style),
        key_line("gg / G", "Jump to top / bottom", key_style),
        key_line("Ctrl-d/u", "Half-page down/up", key_style),
        key_line("Tab, ←/→", "Switch pane", key_style),
        key_line("J/K", "Move cursor + select", key_style),
        Line::raw(""),
        section("Modes"),
        key_line("v", "Select mode", key_style),
        key_line("Space", "Space menu (file ops)", key_style),
        key_line("g", "Goto mode", key_style),
        key_line(":", "Command mode", key_style),
        key_line("Esc", "Return to Normal mode", key_style),
        Line::raw(""),
        section("Actions"),
        key_line("d", "Delete file(s)", key_style),
        key_line("r", "Rename", key_style),
        key_line("y", "Copy to other pane", key_style),
        key_line("p", "Toggle preview pane", key_style),
        key_line(";", "Clear selection", key_style),
        key_line(".", "Toggle hidden files", key_style),
        key_line("/", "Search/filter", key_style),
        key_line("q", "Quit", key_style),
        key_line("?", "Toggle this help", key_style),
    ];

    let block = Block::default()
        .title(" Help — press ? or Esc to close ")
        .borders(Borders::ALL)
        .border_style(Style::default().fg(Color::Cyan));

    let para = Paragraph::new(lines)
        .block(block)
        .wrap(Wrap { trim: false });
    f.render_widget(para, rect);
}

fn section(title: &str) -> Line<'_> {
    Line::from(Span::styled(
        title,
        Style::default()
            .fg(Color::Cyan)
            .add_modifier(Modifier::BOLD | Modifier::UNDERLINED),
    ))
}

fn key_line<'a>(key: &'a str, desc: &'a str, key_style: Style) -> Line<'a> {
    Line::from(vec![
        Span::styled(format!("  {key:14}"), key_style),
        Span::raw(desc),
    ])
}