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
77
78

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

use super::{Action, InputKind};

/// Tracks multi-key sequences like gg.
#[derive(Debug, Default)]
pub struct NormalState {
    /// True if the previous key was 'g' (waiting for second key).
    pub pending_g: bool,
}

pub fn handle_key(key: KeyEvent, state: &mut NormalState) -> Action {
    // If we have a pending 'g', handle the second key
    if state.pending_g {
        state.pending_g = false;
        return match key.code {
            KeyCode::Char('g') => Action::CursorTop,    // gg → top
            KeyCode::Char('e') => Action::CursorBottom, // ge → end
            KeyCode::Char('h') => Action::GotoHome,
            KeyCode::Char('r') => Action::GotoRoot,
            KeyCode::Char('o') => Action::GotoOtherPane,
            KeyCode::Char('p') => Action::GotoPrevious,
            KeyCode::Char(c @ '1'..='9') => Action::GotoBookmark((c as u8 - b'1') as usize),
            _ => Action::None,
        };
    }

    match key.code {
        // Quit
        KeyCode::Char('q') => Action::Quit,

        // Navigation
        KeyCode::Char('j') | KeyCode::Down => Action::CursorDown,
        KeyCode::Char('k') | KeyCode::Up => Action::CursorUp,
        KeyCode::Char('h') | KeyCode::Backspace => Action::ParentDir,
        KeyCode::Char('l') | KeyCode::Enter => Action::EnterDir,
        KeyCode::Char('G') => Action::CursorBottom,
        KeyCode::Char('g') => {
            state.pending_g = true;
            Action::None
        }
        KeyCode::PageUp => Action::PageUp,
        KeyCode::PageDown => Action::PageDown,
        KeyCode::Char('d') if key.modifiers.contains(KeyModifiers::CONTROL) => Action::HalfPageDown,
        KeyCode::Char('u') if key.modifiers.contains(KeyModifiers::CONTROL) => Action::HalfPageUp,

        // Pane switching
        KeyCode::Tab => Action::SwitchPane,
        KeyCode::Left => Action::FocusLeftPane,
        KeyCode::Right => Action::FocusRightPane,

        // Mode transitions
        KeyCode::Char('v') => Action::EnterSelect,
        KeyCode::Char(' ') => Action::EnterSpace,
        KeyCode::Char(':') => Action::EnterCommand,
        KeyCode::Char('/') => Action::EnterInput(InputKind::Search),

        // Quick actions
        KeyCode::Char('r') => Action::EnterInput(InputKind::Rename),
        KeyCode::Char('d') => Action::DeleteSelected,
        KeyCode::Char('y') => Action::CopyToOther,
        KeyCode::Char('.') => Action::ToggleHidden,
        KeyCode::Char('p') | KeyCode::Char('P') => Action::TogglePreview,
        KeyCode::Char('?') => Action::ShowHelp,

        // Shift+J/K: move + select
        KeyCode::Char('J') => Action::SelectExtendDown,
        KeyCode::Char('K') => Action::SelectExtendUp,

        // Selections persist when leaving Select mode (Helix semantics);
        // ';' is the explicit clear, mirroring Helix's collapse_selection.
        KeyCode::Char(';') => Action::DeselectAll,

        KeyCode::Esc => Action::ExitToNormal,

        _ => Action::None,
    }
}