kanata 1.11.0

Multi-layer keyboard customization
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166

use super::*;

#[test]
fn override_with_unmod() {
    let result = simulate(
        "
(defoverrides
 (a) (b)
 (b) (a)
)

(defalias
 b (unshift b)
 a (unshift a)
)
(defsrc a b)
(deflayer base @a @b)
        ",
        "d:lsft t:50 d:a t:50 u:a t:50 d:b t:50 u:b t:50",
    )
    .to_ascii()
    .no_time();
    assert_eq!(
        "dn:LShift up:LShift dn:B up:B dn:LShift up:LShift dn:A up:A dn:LShift",
        result
    );
}

#[test]
fn override_release_mod_change_key() {
    let cfg = "
(defsrc)
(deflayer base)
(defoverrides
  (lsft a) (lsft 9)
  (lsft 1) (lctl 2))
        ";
    let result = simulate(cfg, "d:lsft t:10 d:a t:10 u:lsft t:10 u:a t:10").to_ascii();
    assert_eq!("dn:LShift t:10ms dn:Kb9 t:10ms up:LShift up:Kb9", result);
    let result = simulate(cfg, "d:lsft t:10 d:a t:10 u:a t:10 u:lsft t:10").to_ascii();
    assert_eq!(
        "dn:LShift t:10ms dn:Kb9 t:10ms up:Kb9 t:10ms up:LShift",
        result
    );
    let result = simulate(cfg, "d:lsft t:10 d:a t:10 d:c t:10").to_ascii();
    assert_eq!("dn:LShift t:10ms dn:Kb9 t:10ms up:Kb9 dn:C", result);
    let result = simulate(cfg, "d:lsft t:10 d:1 t:10 d:c t:10").to_ascii();
    assert_eq!(
        "dn:LShift t:10ms up:LShift dn:LCtrl dn:Kb2 t:10ms up:LCtrl up:Kb2 dn:LShift dn:C",
        result
    );
}

#[test]
fn override_eagerly_releases() {
    let result = simulate(
        "
(defcfg override-release-on-activation yes)
(defsrc)
(deflayer base)
(defoverrides (lsft a) (lsft 9))
        ",
        "d:lsft t:10 d:a t:10 u:lsft t:10 u:a t:10",
    )
    .to_ascii();
    assert_eq!(
        "dn:LShift t:10ms dn:Kb9 t:1ms up:Kb9 t:9ms up:LShift",
        result
    );
}

#[test]
#[should_panic]
fn config_with_both_overrides() {
    simulate(
        "
(defcfg override-release-on-activation yes)
(defsrc)
(deflayer base)
(defoverrides (lsft a) (lsft 9))
(defoverridesv2 (lsft a) (lsft 9) () ())
        ",
        "",
    );
}

#[test]
#[should_panic]
fn config_with_two_overrides() {
    simulate(
        "
(defcfg override-release-on-activation yes)
(defsrc)
(deflayer base)
(defoverrides (lsft a) (lsft 9))
(defoverrides (lsft a) (lsft 9))
        ",
        "",
    );
}

#[test]
#[should_panic]
fn config_with_both_overridesv2() {
    simulate(
        "
(defcfg override-release-on-activation yes)
(defsrc)
(deflayer base)
(defoverridesv2 (lsft a) (lsft 9) () ())
(defoverridesv2 (lsft a) (lsft 9) () ())
        ",
        "",
    );
}

#[test]
fn config_with_overridev2() {
    let cfg = "
(defsrc)
(deflayermap (l1) b (layer-switch l2))
(deflayermap (l2) b (layer-switch l1))
(defoverridesv2 (lsft a) (lsft 9) (lctl) (l2))
        ";

    // Override works.
    let result = simulate(cfg, "d:lctl d:lsft d:a t:10 u:a u:lsft u:lctl t:10").to_ascii();
    assert_eq!(
        "dn:LCtrl t:1ms dn:LShift t:1ms dn:A t:8ms up:A t:1ms up:LShift t:1ms up:LCtrl",
        result
    );

    // Override doesn't apply while lctl is held
    let result = simulate(cfg, "d:lctl d:lsft d:a u:a t:10 u:lctl t:10 u:lsft t:10").to_ascii();
    assert_eq!(
        "dn:LCtrl t:1ms dn:LShift t:1ms dn:A t:1ms up:A t:7ms up:LCtrl t:10ms up:LShift",
        result
    );
    let result = simulate(cfg, "d:lctl d:lsft d:a t:10 u:lctl t:10 u:lsft u:a t:10").to_ascii();
    assert_eq!(
        // Note that this may not be desirable...
        // One could imagine that the desired behavior is that A is released, or that A remains
        // held, so that irrespective of which key is released first, the 9 never activates.
        //
        // Doing the latter not-implemented behaviour is more complicated in code though, so for
        // now stick to "worse is better" and keep it as-is.
        // The user workaround is to always release the A before releasing modifiers.
        "dn:LCtrl t:1ms dn:LShift t:1ms dn:A t:8ms up:LCtrl up:A dn:Kb9 t:10ms up:LShift up:Kb9",
        result
    );

    // Override doesn't apply while on disabled layer is held
    let result = simulate(
        cfg,
        "d:b u:b \
         t:10 d:lsft d:a t:10 u:lsft t:10 u:a t:10 \
         d:b u:b \
         t:10 d:lsft d:a t:10 u:lsft t:10 u:a t:10",
    )
    .to_ascii();
    assert_eq!(
        "t:10ms dn:LShift t:1ms dn:A t:9ms up:LShift t:10ms up:A \
         t:20ms dn:LShift t:1ms dn:Kb9 t:9ms up:LShift up:Kb9",
        result
    );
}