trail-fm 1.11.2

A terminal-first workspace for navigating, inspecting and acting on the filesystem
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

//! Mode enum: Navigation, Visual, Search, and Command.
//!
//! Determines how keystrokes are dispatched and what the status bar displays.
//! All three variants are defined here so the state shape is complete from
//! Phase 1 onward; only `Navigation` is functionally wired this phase.

/// The current interaction mode of the application.
///
/// - `Navigation` — default; `j`/`k`/`l`/`h` browse the directory tree.
/// - `Search` — entered via `/`; keystrokes build a fuzzy query (Phase 2).
/// - `Command` — entered via `:`; keystrokes build a command line (Phase 3).
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub enum Mode {
    /// Default navigation mode — arrow keys / hjkl move the selection.
    #[default]
    Navigation,

    /// Fuzzy-search mode. `query` is the current filter string; `matches`
    /// holds indices into `AppState::entries` sorted by score.
    ///
    /// Functionally wired in Phase 2; the variant is defined here so
    /// `AppState` carries the correct shape from the start.
    Search {
        /// Current filter query typed by the user.
        query: String,
        /// Indices into `AppState::entries`, ordered by match score.
        matches: Vec<usize>,
    },

    /// Command-line mode. `buffer` is the text typed after `:` or `!`;
    /// `cursor` is the byte offset of the insertion point.
    ///
    /// Functionally wired in Phase 3; the variant is defined here so
    /// `AppState` carries the correct shape from the start.
    Command {
        /// Text content of the command line (excluding the leading `:` or `!`).
        buffer: String,
        /// Byte offset of the cursor within `buffer`.
        cursor: usize,
        /// Index into the command history when scrolling through past commands.
        history_index: Option<usize>,
    },

    /// Visual mode, entered with `v`: moving the selection extends a range
    /// from `anchor` to it, the way Vim's visual mode does. The range is
    /// added to the marks (`Space`, `v`, `h`/`l`), deleted (`dd`) or
    /// abandoned (`Esc`).
    Visual {
        /// The entry the range started on. A path, not a row, so a refresh
        /// that re-orders the listing cannot move it.
        anchor: std::path::PathBuf,
    },
}

impl Mode {
    /// Returns a short, human-readable label for the status bar.
    pub fn label(&self) -> &'static str {
        match self {
            Mode::Navigation => "NORMAL",
            Mode::Search { .. } => "SEARCH",
            Mode::Command { .. } => "COMMAND",
            Mode::Visual { .. } => "VISUAL",
        }
    }
}