termi 0.1.6

A modal terminal code editor written in Rust
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

//! # Editor modes
//!
//! **Purpose:** describe which modal state the editor is in.
//!
//! **Responsibility:** owns the [`Mode`] enum and the small amount of behaviour
//! that is derived purely from the mode (display name, cursor shape, whether a
//! selection is being extended). It deliberately knows nothing about keys,
//! buffers or rendering — those modules ask the mode, the mode never asks them.
//!
//! **Public API:** [`Mode`].

/// The modal state of the editor.
///
/// Modes are a plain `Copy` enum rather than a state machine object: transitions
/// are always driven by input handling, so there is nothing to encapsulate here.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum Mode {
    /// Keys are commands; text is navigated and manipulated.
    #[default]
    Normal,
    /// Keys insert text at every cursor.
    Insert,
    /// Character-wise selection is extended by movement.
    Visual,
    /// Line-wise selection is extended by movement.
    VisualLine,
    /// The command bar is focused and accumulating an ex-style command line.
    Command,
    /// The search prompt is focused; the document scrolls as the query is typed.
    Search,
    /// The file tree panel has the keyboard.
    Tree,
}

impl Mode {
    /// Short uppercase label shown in the status bar.
    #[must_use]
    pub const fn name(self) -> &'static str {
        match self {
            Self::Normal => "NORMAL",
            Self::Insert => "INSERT",
            Self::Visual => "VISUAL",
            Self::VisualLine => "V-LINE",
            Self::Command => "COMMAND",
            Self::Search => "SEARCH",
            Self::Tree => "TREE",
        }
    }

    /// Whether movement in this mode should extend the selection instead of
    /// collapsing it.
    #[must_use]
    pub const fn is_visual(self) -> bool {
        matches!(self, Self::Visual | Self::VisualLine)
    }

    /// Whether printable keys should be inserted as text.
    #[must_use]
    pub const fn is_insert(self) -> bool {
        matches!(self, Self::Insert)
    }

    /// Whether the command bar owns the keyboard.
    #[must_use]
    pub const fn is_command(self) -> bool {
        matches!(self, Self::Command)
    }

    /// Whether the search prompt owns the keyboard.
    #[must_use]
    pub const fn is_search(self) -> bool {
        matches!(self, Self::Search)
    }

    /// In insert mode the cursor sits *between* characters, so it is drawn as a
    /// bar; every other mode selects a character and uses a block.
    #[must_use]
    pub const fn uses_bar_cursor(self) -> bool {
        matches!(self, Self::Insert | Self::Command | Self::Search)
    }
}