abstracttui 0.5.0

A reactive, compositor-grade terminal UI engine: fine-grained signals, layered rendering with damage tracking, images (kitty/iTerm2/sixel/mosaic), software-rasterized 3D (GLB), themes and animation.
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
119
120
121
122
123
124
125

//! The spelling table, pinned. Each case names the terminal that sends
//! it — a row that changes should be a deliberate decision about a real
//! emulator, not an accident.

use super::*;

/// `CSI 1;3D` / `CSI 1;3C` — kitty, WezTerm, ghostty, foot, xterm.
#[test]
fn alt_arrows_are_word_motion() {
    assert_eq!(
        word_intent(Key::Left, Mods::ALT),
        Some(WordIntent::Left),
        "Alt+Left"
    );
    assert_eq!(word_intent(Key::Right, Mods::ALT), Some(WordIntent::Right));
}

/// `CSI 1;5D` / `CSI 1;5C` — the Linux/Windows convention.
#[test]
fn ctrl_arrows_are_word_motion() {
    assert_eq!(word_intent(Key::Left, Mods::CTRL), Some(WordIntent::Left));
    assert_eq!(word_intent(Key::Right, Mods::CTRL), Some(WordIntent::Right));
}

/// `ESC b` / `ESC f` — macOS Terminal.app and iTerm2's Natural Text
/// Editing preset, the readline binding they both borrow.
#[test]
fn readline_letters_are_word_motion() {
    assert_eq!(
        word_intent(Key::Char('b'), Mods::ALT),
        Some(WordIntent::Left)
    );
    assert_eq!(
        word_intent(Key::Char('f'), Mods::ALT),
        Some(WordIntent::Right)
    );
}

/// Shift rides along so "extend selection by word" is the same gesture
/// (`CSI 1;4D` = Shift+Alt+Left).
#[test]
fn shift_extends_rather_than_disqualifying() {
    assert_eq!(
        word_intent(Key::Left, Mods::ALT | Mods::SHIFT),
        Some(WordIntent::Left)
    );
    assert_eq!(
        word_intent(Key::Right, Mods::CTRL | Mods::SHIFT),
        Some(WordIntent::Right)
    );
}

/// Option+Backspace (`ESC DEL`), Ctrl+W (readline `unix-word-rubout`),
/// Alt+D (`ESC d`), Ctrl+Delete (`CSI 3;5~`).
#[test]
fn delete_word_family() {
    assert_eq!(
        word_intent(Key::Backspace, Mods::ALT),
        Some(WordIntent::DeleteBack)
    );
    assert_eq!(
        word_intent(Key::Char('w'), Mods::CTRL),
        Some(WordIntent::DeleteBack)
    );
    assert_eq!(
        word_intent(Key::Char('d'), Mods::ALT),
        Some(WordIntent::DeleteForward)
    );
    assert_eq!(
        word_intent(Key::Delete, Mods::CTRL),
        Some(WordIntent::DeleteForward)
    );
}

/// Unmodified keys are ordinary input — the classifier must never claim
/// a plain arrow, a plain letter, or a bare Backspace.
#[test]
fn bare_keys_are_never_word_gestures() {
    for key in [
        Key::Left,
        Key::Right,
        Key::Backspace,
        Key::Delete,
        Key::Char('b'),
        Key::Char('f'),
        Key::Char('d'),
        Key::Char('w'),
    ] {
        assert_eq!(word_intent(key, Mods::NONE), None, "{key:?} unmodified");
        assert_eq!(
            word_intent(key, Mods::SHIFT),
            None,
            "{key:?} with Shift alone"
        );
    }
}

/// The letters are claimed on ONE modifier only. `Ctrl+B`/`Ctrl+F` are
/// readline's character steps and `Ctrl+D` is delete-forward/EOF —
/// claiming them here would contradict the convention being quoted, and
/// would eat chords apps legitimately bind (abstractcode-tui binds
/// Ctrl+D today).
#[test]
fn letters_do_not_answer_to_the_other_modifier() {
    assert_eq!(word_intent(Key::Char('b'), Mods::CTRL), None);
    assert_eq!(word_intent(Key::Char('f'), Mods::CTRL), None);
    assert_eq!(word_intent(Key::Char('d'), Mods::CTRL), None);
    assert_eq!(word_intent(Key::Char('w'), Mods::ALT), None);
    // ...and neither answers to BOTH held together. AltGr is reported
    // as Ctrl+Alt on Windows/Linux, so this guard applies to every row
    // in the table, not only the printable-letter spellings.
    assert_eq!(word_intent(Key::Char('b'), Mods::ALT | Mods::CTRL), None);
    assert_eq!(word_intent(Key::Char('w'), Mods::ALT | Mods::CTRL), None);
    assert_eq!(word_intent(Key::Left, Mods::ALT | Mods::CTRL), None);
    assert_eq!(word_intent(Key::Backspace, Mods::ALT | Mods::CTRL), None);
}

/// Letters outside the table stay the app's (Alt+X, Ctrl+L, …).
#[test]
fn unrelated_chords_fall_through() {
    for ch in ['a', 'c', 'e', 'l', 'q', 't', 'x', 'z'] {
        assert_eq!(word_intent(Key::Char(ch), Mods::ALT), None, "Alt+{ch}");
        assert_eq!(word_intent(Key::Char(ch), Mods::CTRL), None, "Ctrl+{ch}");
    }
}