tui-canvas 0.8.10

Form/textarea/input for TUI
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

#[cfg(feature = "keybindings")]
use crossterm::event::{KeyCode, KeyEvent, KeyEventKind, KeyModifiers};

#[cfg(feature = "keybindings")]
use crate::{
    DataProvider,
    canvas::modes::AppMode,
    editor::{EditorCore, behavior::KeybindingParadigm},
    keybindings::{CanvasKeyAction, KeyEventOutcome, KeyStroke},
};

#[cfg(feature = "keybindings")]
pub(crate) trait KeybindingProduct {
    type Provider: DataProvider;

    fn core(&self) -> &EditorCore<Self::Provider>;

    fn core_mut(&mut self) -> &mut EditorCore<Self::Provider>;

    fn handle_insert_enter(&mut self) -> KeyEventOutcome;

    fn handle_insert_tab(&mut self) -> KeyEventOutcome;

    fn handle_plain_insert_char(&mut self, ch: char) -> KeyEventOutcome;

    fn dispatch_product_key_action(
        &mut self,
        action: &CanvasKeyAction,
        count: usize,
    ) -> KeyEventOutcome;

    fn take_vim_count(&mut self) -> usize {
        self.core_mut().behavior_state.vim_mut().take_count_or_one()
    }

    fn clear_unmatched_pending(&mut self) {
        self.core_mut()
            .behavior_state
            .vim_mut()
            .clear_pending_operator();
    }
}

#[cfg(feature = "keybindings")]
pub(crate) fn handle_product_key_event<P: KeybindingProduct>(
    product: &mut P,
    evt: KeyEvent,
) -> KeyEventOutcome {
    if evt.kind != KeyEventKind::Press {
        return KeyEventOutcome::NotMatched;
    }

    let mode = product.core().ui_state.mode();

    if mode == AppMode::Ins && matches!(evt.code, KeyCode::Enter) {
        return product.handle_insert_enter();
    }

    if mode != AppMode::Ins && product.core().keybinding_paradigm() == KeybindingParadigm::Vim {
        if let KeyCode::Char(ch) = evt.code {
            if let Some(digit) = ch.to_digit(10) {
                let vim = product.core_mut().behavior_state.vim_mut();
                if digit > 0 || vim.has_count() {
                    vim.push_count_digit(digit as usize);
                    return KeyEventOutcome::Pending;
                }
            }
        }
    }

    let stroke = KeyStroke {
        code: evt.code,
        modifiers: evt.modifiers,
    };

    product.core_mut().seq_tracker.add_key(stroke);

    let (matched, is_prefix) = {
        let core = product.core();
        let Some(keybindings) = core.keybindings.as_ref() else {
            return KeyEventOutcome::NotMatched;
        };
        let (matched, is_prefix) = keybindings.lookup_action(mode, core.seq_tracker.sequence());
        (matched.cloned(), is_prefix)
    };

    if let Some(action) = matched {
        let count = product.take_vim_count();
        product.core_mut().seq_tracker.reset();
        return product.dispatch_product_key_action(&action, count);
    }

    if is_prefix {
        return KeyEventOutcome::Pending;
    }

    product.core_mut().seq_tracker.reset();
    product.core_mut().behavior_state.vim_mut().reset_count();
    product.clear_unmatched_pending();

    if mode == AppMode::Ins {
        match evt.code {
            KeyCode::Tab => {
                return product.handle_insert_tab();
            }
            KeyCode::Char(c) => {
                let m = evt.modifiers;
                let is_plain = m.is_empty() || m == KeyModifiers::SHIFT;
                if is_plain {
                    return product.handle_plain_insert_char(c);
                }
            }
            _ => {}
        }
    }

    KeyEventOutcome::NotMatched
}