tree-tui 0.1.2

An interactive terminal UI for visualizing directories: code, size, and git stats.
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

//! Keyboard actions and the key → action mapping.
//!
//! Mapping is kept separate from the `App::update` reducer so the dispatch
//! table stays legible and the reducer stays focused on state transitions.

use crossterm::event::{KeyCode, KeyEvent, KeyModifiers};

/// A semantic action produced from a key press.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Action {
    None,
    Quit,
    Up,
    Down,
    First,
    Last,
    PageUp,
    PageDown,
    /// Expand a collapsed dir, or descend into an expanded one.
    Expand,
    /// Activate the selection: expand/descend a dir, or view a file in $PAGER.
    Open,
    /// Edit the selected file in $EDITOR (Shift+Enter, or `e`).
    Edit,
    /// Collapse an expanded dir, or move to the parent.
    Collapse,
    /// Toggle expansion of the selected dir.
    Toggle,
    ExpandAll,
    CollapseAll,
    CycleSort,
    ReverseSort,
    /// Toggle the side-by-side preview pane.
    TogglePreview,
    /// Switch to the next available lens.
    CycleLens,
    /// Jump directly to a lens by 1-based index (digit keys).
    JumpLens(u8),
    /// Toggle hiding rows that are zero under the active lens.
    ToggleZeros,
    /// Move focus between the tree and the preview pane.
    CycleFocus,
    /// Copy the focused pane's text (preview) or the selected path (tree).
    Yank,
    /// Toggle mouse capture so the terminal's native selection works.
    ToggleMouseCapture,
}

/// Translate a key press into an [`Action`].
pub fn map_key(key: KeyEvent) -> Action {
    let ctrl = key.modifiers.contains(KeyModifiers::CONTROL);
    let shift = key.modifiers.contains(KeyModifiers::SHIFT);
    match key.code {
        KeyCode::Char('c') if ctrl => Action::Quit,
        KeyCode::Char('d') if ctrl => Action::PageDown,
        KeyCode::Char('u') if ctrl => Action::PageUp,
        KeyCode::Char('q') => Action::Quit,
        KeyCode::Char('j') | KeyCode::Down => Action::Down,
        KeyCode::Char('k') | KeyCode::Up => Action::Up,
        KeyCode::Char('g') | KeyCode::Home => Action::First,
        KeyCode::Char('G') | KeyCode::End => Action::Last,
        KeyCode::PageDown => Action::PageDown,
        KeyCode::PageUp => Action::PageUp,
        KeyCode::Char('l') | KeyCode::Right => Action::Expand,
        KeyCode::Enter if shift => Action::Edit,
        KeyCode::Enter => Action::Open,
        KeyCode::Char('e') => Action::Edit,
        KeyCode::Char('h') | KeyCode::Left => Action::Collapse,
        KeyCode::Char(' ') => Action::Toggle,
        KeyCode::Char('E') => Action::ExpandAll,
        KeyCode::Char('C') => Action::CollapseAll,
        KeyCode::Char('s') => Action::CycleSort,
        KeyCode::Char('r') => Action::ReverseSort,
        KeyCode::Char('p') => Action::TogglePreview,
        KeyCode::Char('m') => Action::CycleLens,
        KeyCode::Char(c @ '1'..='9') => Action::JumpLens(c as u8 - b'0'),
        KeyCode::Char('z') => Action::ToggleZeros,
        KeyCode::Char('w') => Action::CycleFocus,
        KeyCode::Char('y') => Action::Yank,
        KeyCode::Char('S') => Action::ToggleMouseCapture,
        _ => Action::None,
    }
}