1pub const KEY_RETURN: u64 = 0x28;
5pub const KEY_ESCAPE: u64 = 0x29;
6pub const KEY_BACKSPACE: u64 = 0x2A;
7pub const KEY_TAB: u64 = 0x2B;
8pub const KEY_SPACE: u64 = 0x2C;
9pub const KEY_DELETE_FORWARD: u64 = 0x4C;
10pub const MOD_CONTROL: u64 = 0xE0;
11pub const MOD_SHIFT: u64 = 0xE1;
12pub const MOD_OPTION: u64 = 0xE2;
13pub const MOD_COMMAND: u64 = 0xE3;
14
15pub fn usage(c: char) -> Option<u64> {
17 Some(match c.to_ascii_lowercase() {
18 c @ 'a'..='z' => 0x04 + (c as u64 - 'a' as u64),
19 c @ '1'..='9' => 0x1E + (c as u64 - '1' as u64),
20 '0' => 0x27,
21 _ => return None,
22 })
23}
24
25fn named(name: &str) -> Option<u64> {
26 Some(match name {
27 "return" | "enter" => KEY_RETURN,
28 "esc" | "escape" => KEY_ESCAPE,
29 "backspace" => KEY_BACKSPACE,
30 "delete" | "forward_delete" => KEY_DELETE_FORWARD,
31 "tab" => KEY_TAB,
32 "space" => KEY_SPACE,
33 "right" => 0x4F,
34 "left" => 0x50,
35 "down" => 0x51,
36 "up" => 0x52,
37 "home" => 0x4A,
38 "end" => 0x4D,
39 "pageup" => 0x4B,
40 "pagedown" => 0x4E,
41 "-" => 0x2D,
42 "=" => 0x2E,
43 "[" => 0x2F,
44 "]" => 0x30,
45 "\\" => 0x31,
46 ";" => 0x33,
47 "'" => 0x34,
48 "`" => 0x35,
49 "," => 0x36,
50 "." => 0x37,
51 "/" => 0x38,
52 _ => return None,
53 })
54}
55
56fn modifier(name: &str) -> Option<u64> {
57 Some(match name {
58 "cmd" | "command" => MOD_COMMAND,
59 "ctrl" | "control" => MOD_CONTROL,
60 "opt" | "option" | "alt" => MOD_OPTION,
61 "shift" => MOD_SHIFT,
62 _ => return None,
63 })
64}
65
66pub fn parse_combo(input: &str) -> Result<(u64, Vec<u64>), String> {
68 let lower = input.trim().to_lowercase();
69 if lower.is_empty() {
70 return Err("empty key".into());
71 }
72 let parts: Vec<&str> = if lower == "+" { vec!["+"] } else { lower.split('+').collect() };
73 let (key, mods) = parts.split_last().unwrap();
74 let mut modifiers = Vec::new();
75 for m in mods {
76 modifiers.push(modifier(m.trim()).ok_or_else(|| {
77 format!("unknown modifier `{m}` (cmd, ctrl, opt, shift)")
78 })?);
79 }
80 let key = key.trim();
81 let usage = if let Some(u) = named(key) {
82 u
83 } else if let Some(hex) = key.strip_prefix("0x") {
84 u64::from_str_radix(hex, 16).map_err(|_| format!("bad key usage `{key}`"))?
85 } else if key.chars().count() == 1 {
86 usage(key.chars().next().unwrap()).ok_or_else(|| format!("unknown key `{key}`"))?
87 } else {
88 return Err(format!(
89 "unknown key `{key}` (return, esc, tab, space, backspace, delete, up, down, left, right, home, end, pageup, pagedown, a letter, a digit, or 0xNN)"
90 ));
91 };
92 if usage == 0 || usage > 0xE7 {
93 return Err(format!("key usage {usage:#x} is out of range"));
94 }
95 Ok((usage, modifiers))
96}
97
98pub fn button(name: &str) -> Result<(u64, u64, u64), String> {
100 Ok(match name.trim().to_lowercase().replace('-', "_").as_str() {
101 "home" => (0x0C, 0x40, 80),
102 "lock" | "power" => (0x0C, 0x30, 200),
103 "volume_up" => (0x0C, 0xE9, 80),
104 "volume_down" => (0x0C, 0xEA, 80),
105 other => {
106 return Err(format!(
107 "unknown button `{other}` (home, lock, volume_up, volume_down)"
108 ));
109 }
110 })
111}
112
113#[cfg(test)]
114mod tests {
115 use super::*;
116
117 #[test]
118 fn combos() {
119 assert_eq!(parse_combo("return").unwrap(), (0x28, vec![]));
120 assert_eq!(parse_combo("Cmd+V").unwrap(), (0x19, vec![MOD_COMMAND]));
121 assert_eq!(
122 parse_combo("cmd+shift+z").unwrap(),
123 (0x1D, vec![MOD_COMMAND, MOD_SHIFT])
124 );
125 assert_eq!(parse_combo("0x28").unwrap(), (0x28, vec![]));
126 assert_eq!(parse_combo("a").unwrap(), (0x04, vec![]));
127 assert!(parse_combo("hyper+a").is_err());
128 assert!(parse_combo("nope").is_err());
129 assert!(parse_combo("").is_err());
130 }
131
132 #[test]
133 fn buttons() {
134 assert_eq!(button("home").unwrap(), (0x0C, 0x40, 80));
135 assert_eq!(button("volume-up").unwrap().1, 0xE9);
136 assert!(button("siri").is_err());
137 }
138}