Map scancode to Keymap

helix-term/Cargo.toml

@@ -17,6 +17,7 @@ default = ["git"]
 unicode-lines = ["helix-core/unicode-lines", "helix-view/unicode-lines"]
 integration = ["helix-event/integration_test"]
 git = ["helix-vcs/git"]
+scancode = ["helix-view/scancode"]
 
 [[bin]]
 name = "hx"
@@ -72,6 +73,7 @@ serde = { version = "1.0", features = ["derive"] }
 grep-regex = "0.1.13"
 grep-searcher = "0.1.14"
 
+
 [target.'cfg(not(windows))'.dependencies]  # https://github.com/vorner/signal-hook/issues/100
 signal-hook-tokio = { version = "0.3", features = ["futures-v0_3"] }
 libc = "0.2.164"

helix-term/src/commands.rs

@@ -6252,6 +6252,8 @@ fn jump_to_label(cx: &mut Context, labels: Vec<Range>, behaviour: Movement) {
     let view = view.id;
     let doc = doc.id();
     cx.on_next_key(move |cx, event| {
+        #[cfg(feature = "scancode")]
+        let event = cx.editor.scancode_apply(event);
         let alphabet = &cx.editor.config().jump_label_alphabet;
         let Some(i) = event
             .char()
@@ -6268,6 +6270,8 @@ fn jump_to_label(cx: &mut Context, labels: Vec<Range>, behaviour: Movement) {
         }
         cx.on_next_key(move |cx, event| {
             doc_mut!(cx.editor, &doc).remove_jump_labels(view);
+            #[cfg(feature = "scancode")]
+            let event = cx.editor.scancode_apply(event);
             let alphabet = &cx.editor.config().jump_label_alphabet;
             let Some(inner) = event
                 .char()

helix-term/src/ui/editor.rs

@@ -941,6 +941,8 @@ fn insert_mode(&mut self, cx: &mut commands::Context, event: KeyEvent) {
     }
 
     fn command_mode(&mut self, mode: Mode, cxt: &mut commands::Context, event: KeyEvent) {
+        #[cfg(feature = "scancode")]
+        let event = cxt.editor.scancode_apply(event);
         match (event, cxt.editor.count) {
             // If the count is already started and the input is a number, always continue the count.
             (key!(i @ '0'..='9'), Some(count)) => {

helix-view/Cargo.toml

@@ -14,6 +14,7 @@ homepage.workspace = true
 default = []
 term = ["crossterm"]
 unicode-lines = []
+scancode = ["keyboard_query"]
 
 [dependencies]
 helix-stdx = { path = "../helix-stdx" }
@@ -52,6 +53,8 @@ log = "~0.4"
 parking_lot = "0.12.3"
 thiserror.workspace = true
 
+keyboard_query = { version = "0.1.0", optional = true }
+
 [target.'cfg(windows)'.dependencies]
 clipboard-win = { version = "5.4", features = ["std"] }
 

helix-view/src/editor.rs

@@ -19,6 +19,10 @@
 use futures_util::stream::select_all::SelectAll;
 use futures_util::{future, StreamExt};
 use helix_lsp::{Call, LanguageServerId};
+
+#[cfg(feature = "scancode")]
+use crate::scancode::{deserialize_scancode, KeyboardState, ScanCodeMap};
+
 use tokio_stream::wrappers::UnboundedReceiverStream;
 
 use std::{
@@ -350,6 +354,9 @@ pub struct Config {
     pub end_of_line_diagnostics: DiagnosticFilter,
     // Set to override the default clipboard provider
     pub clipboard_provider: ClipboardProvider,
+    #[cfg(feature = "scancode")]
+    #[serde(skip_serializing, deserialize_with = "deserialize_scancode")]
+    pub scancode: ScanCodeMap,
 }
 
 #[derive(Debug, Clone, PartialEq, Deserialize, Serialize, Eq, PartialOrd, Ord)]
@@ -917,6 +924,7 @@ fn from(line_ending: LineEndingConfig) -> Self {
             LineEndingConfig::Crlf => LineEnding::Crlf,
             #[cfg(feature = "unicode-lines")]
             LineEndingConfig::FF => LineEnding::FF,
+
             #[cfg(feature = "unicode-lines")]
             LineEndingConfig::CR => LineEnding::CR,
             #[cfg(feature = "unicode-lines")]
@@ -989,6 +997,8 @@ fn default() -> Self {
             inline_diagnostics: InlineDiagnosticsConfig::default(),
             end_of_line_diagnostics: DiagnosticFilter::Disable,
             clipboard_provider: ClipboardProvider::default(),
+            #[cfg(feature = "scancode")]
+            scancode: ScanCodeMap::default(),
         }
     }
 }
@@ -1088,6 +1098,8 @@ pub struct Editor {
 
     pub mouse_down_range: Option<Range>,
     pub cursor_cache: CursorCache,
+    #[cfg(feature = "scancode")]
+    pub keyboard_state: KeyboardState,
 }
 
 pub type Motion = Box<dyn Fn(&mut Editor)>;
@@ -1208,6 +1220,8 @@ pub fn new(
             handlers,
             mouse_down_range: None,
             cursor_cache: CursorCache::default(),
+            #[cfg(feature = "scancode")]
+            keyboard_state: KeyboardState::new(),
         }
     }
 
@@ -2174,6 +2188,13 @@ pub fn get_synced_view_id(&mut self, id: DocumentId) -> ViewId {
             current_view.id
         }
     }
+
+    #[cfg(feature = "scancode")]
+    pub fn scancode_apply(&mut self, event: KeyEvent) -> KeyEvent {
+        self.config()
+            .scancode
+            .apply(event, &mut self.keyboard_state)
+    }
 }
 
 fn try_restore_indent(doc: &mut Document, view: &mut View) {

helix-view/src/input.rs

@@ -1,11 +1,10 @@
 //! Input event handling, currently backed by crossterm.
+pub use crate::keyboard::{KeyCode, KeyModifiers, MediaKeyCode, ModifierKeyCode};
 use anyhow::{anyhow, Error};
 use helix_core::unicode::{segmentation::UnicodeSegmentation, width::UnicodeWidthStr};
 use serde::de::{self, Deserialize, Deserializer};
 use std::fmt;
 
-pub use crate::keyboard::{KeyCode, KeyModifiers, MediaKeyCode, ModifierKeyCode};
-
 #[derive(Debug, PartialOrd, PartialEq, Eq, Clone, Hash)]
 pub enum Event {
     FocusGained,
@@ -325,7 +324,43 @@ impl std::str::FromStr for KeyEvent {
 
     fn from_str(s: &str) -> Result<Self, Self::Err> {
         let mut tokens: Vec<_> = s.split('-').collect();
-        let mut code = match tokens.pop().ok_or_else(|| anyhow!("Missing key code"))? {
+        let mut code = KeyCode::from_str(tokens.pop().ok_or_else(|| anyhow!("Missing key code"))?)?;
+        let mut modifiers = KeyModifiers::empty();
+        for token in tokens {
+            let flag = match token {
+                "S" => KeyModifiers::SHIFT,
+                "A" => KeyModifiers::ALT,
+                "C" => KeyModifiers::CONTROL,
+                _ => return Err(anyhow!("Invalid key modifier '{}-'", token)),
+            };
+
+            if modifiers.contains(flag) {
+                return Err(anyhow!("Repeated key modifier '{}-'", token));
+            }
+            modifiers.insert(flag);
+        }
+
+        // Normalize character keys so that characters like C-S-r and C-R
+        // are represented by equal KeyEvents.
+        match code {
+            KeyCode::Char(ch)
+                if ch.is_ascii_lowercase() && modifiers.contains(KeyModifiers::SHIFT) =>
+            {
+                code = KeyCode::Char(ch.to_ascii_uppercase());
+                modifiers.remove(KeyModifiers::SHIFT);
+            }
+            _ => (),
+        }
+
+        Ok(KeyEvent { code, modifiers })
+    }
+}
+
+impl std::str::FromStr for KeyCode {
+    type Err = Error;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        Ok(match s {
             keys::BACKSPACE => KeyCode::Backspace,
             keys::ENTER => KeyCode::Enter,
             keys::LEFT => KeyCode::Left,
@@ -388,36 +423,7 @@ fn from_str(s: &str) -> Result<Self, Self::Err> {
                     .ok_or_else(|| anyhow!("Invalid function key '{}'", function))?
             }
             invalid => return Err(anyhow!("Invalid key code '{}'", invalid)),
-        };
+        })
-
-        let mut modifiers = KeyModifiers::empty();
-        for token in tokens {
-            let flag = match token {
-                "S" => KeyModifiers::SHIFT,
-                "A" => KeyModifiers::ALT,
-                "C" => KeyModifiers::CONTROL,
-                _ => return Err(anyhow!("Invalid key modifier '{}-'", token)),
-            };
-
-            if modifiers.contains(flag) {
-                return Err(anyhow!("Repeated key modifier '{}-'", token));
-            }
-            modifiers.insert(flag);
-        }
-
-        // Normalize character keys so that characters like C-S-r and C-R
-        // are represented by equal KeyEvents.
-        match code {
-            KeyCode::Char(ch)
-                if ch.is_ascii_lowercase() && modifiers.contains(KeyModifiers::SHIFT) =>
-            {
-                code = KeyCode::Char(ch.to_ascii_uppercase());
-                modifiers.remove(KeyModifiers::SHIFT);
-            }
-            _ => (),
-        }
-
-        Ok(KeyEvent { code, modifiers })
     }
 }
 

helix-view/src/lib.rs

@@ -14,6 +14,8 @@
 pub mod input;
 pub mod keyboard;
 pub mod register;
+#[cfg(feature = "scancode")]
+pub mod scancode;
 pub mod theme;
 pub mod tree;
 pub mod view;

helix-view/src/scancode.rs

@@ -0,0 +1,341 @@
+use crate::input::KeyEvent;
+use crate::keyboard::{KeyCode, ModifierKeyCode};
+use anyhow;
+use serde::{Deserialize, Deserializer};
+use std::collections::HashMap;
+
+use keyboard_query::{DeviceQuery, DeviceState};
+
+type ScanCodeKeyCodeMap = HashMap<u16, (KeyCode, Option<KeyCode>)>;
+
+pub struct KeyboardState {
+    device_state: DeviceState,
+    previous_codes: Vec<u16>,
+}
+
+#[derive(Debug, Default, PartialEq, Eq, Clone)]
+pub struct ScanCodeMap {
+    // {<name>: {<code>: (char, shifted char)}}
+    map: ScanCodeKeyCodeMap,
+    modifiers: Vec<u16>,
+    shift_modifiers: Vec<u16>,
+}
+
+impl Default for KeyboardState {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+
+impl KeyboardState {
+    pub fn new() -> Self {
+        Self {
+            previous_codes: Vec::new(),
+            device_state: DeviceState::new(),
+        }
+    }
+
+    pub fn get_keys(&mut self) -> (Vec<u16>, Vec<u16>) {
+        // detect new pressed keys to sync with crossterm sequential key parsing
+        let codes = self.device_state.get_keys();
+        let new_codes = if codes.len() <= 1 {
+            codes.clone()
+        } else {
+            codes
+                .clone()
+                .into_iter()
+                .filter(|c| !self.previous_codes.contains(c))
+                .collect()
+        };
+        self.previous_codes = codes.clone();
+        (codes, new_codes)
+    }
+}
+
+impl ScanCodeMap {
+    pub fn new(map: HashMap<u16, (KeyCode, Option<KeyCode>)>) -> Self {
+        let modifiers = map
+            .iter()
+            .filter_map(|(code, (key, _))| {
+                if matches!(key, KeyCode::Modifier(_)) {
+                    Some(*code)
+                } else {
+                    None
+                }
+            })
+            .collect();
+
+        let shift_modifiers = map
+            .iter()
+            .filter_map(|(code, (key, _))| {
+                if matches!(
+                    key,
+                    KeyCode::Modifier(ModifierKeyCode::LeftShift)
+                        | KeyCode::Modifier(ModifierKeyCode::RightShift)
+                ) {
+                    Some(*code)
+                } else {
+                    None
+                }
+            })
+            .collect();
+        Self {
+            map,
+            modifiers,
+            shift_modifiers,
+        }
+    }
+
+    pub fn apply(&self, event: KeyEvent, keyboard: &mut KeyboardState) -> KeyEvent {
+        let (scancodes, new_codes) = keyboard.get_keys();
+        if new_codes.is_empty() {
+            return event;
+        }
+
+        // get fist non modifier key code
+        let Some(scancode) = new_codes
+            .iter()
+            .find(|c| !self.modifiers.contains(c))
+            .cloned()
+        else {
+            return event;
+        };
+
+        let Some((key, shifted_key)) = self.map.get(&scancode) else {
+            return event;
+        };
+
+        let event_before = event;
+
+        let mut is_shifted = false;
+        for c in &self.shift_modifiers {
+            if scancodes.contains(c) {
+                is_shifted = true;
+                break;
+            }
+        }
+
+        let event = KeyEvent {
+            code: match key {
+                KeyCode::Char(c) => {
+                    if is_shifted | c.is_ascii_uppercase() {
+                        (*shifted_key).unwrap_or(*key)
+                    } else {
+                        *key
+                    }
+                }
+                _ => *key,
+            },
+            ..event
+        };
+
+        log::trace!(
+            "Scancodes: {scancodes:?} Scancode: {scancode:?} (key: {key:?}, shifted key: {shifted_key:?}) Is shifted: {is_shifted} Event source {event_before:?} New Event {event:?}"
+        );
+
+        event
+    }
+}
+
+pub fn deserialize_scancode<'de, D>(deserializer: D) -> Result<ScanCodeMap, D::Error>
+where
+    D: Deserializer<'de>,
+{
+    use serde::de::Error;
+
+    #[derive(Deserialize)]
+    struct ScanCodeRawConfig {
+        layout: String,
+        map: Option<HashMap<String, Vec<(u16, Vec<String>)>>>,
+    }
+
+    let value = ScanCodeRawConfig::deserialize(deserializer)?;
+
+    // load only specified in user settings layout
+    let map = if let Some(map) = value
+        .map
+        .and_then(|m| m.into_iter().find(|(k, _)| k == &value.layout))
+    {
+        HashMap::from_iter(
+            map.1
+                .into_iter()
+                .map(|(scancode, chars)| {
+                    if chars.is_empty() {
+                        anyhow::bail!(
+                            "Invalid scancode. Empty map for scancode: {scancode} on layout: {}",
+                            value.layout
+                        );
+                    }
+                    if chars.len() > 2 {
+                        anyhow::bail!(
+                        "Invalid scancode. To many variants for scancode: {scancode} on layout: {}",
+                        value.layout
+                    );
+                    }
+                    let keycode = str::parse::<KeyCode>(&chars[0]).map_err(|e| {
+                        anyhow::anyhow!(
+                            "On parse scancode: {scancode} on layout: {} - {e}",
+                            value.layout
+                        )
+                    })?;
+                    let shifted_keycode = if let Some(c) = chars.get(1) {
+                        Some(str::parse::<KeyCode>(c).map_err(|e| {
+                            anyhow::anyhow!(
+                                "On parse scancode: {scancode} on layout: {} - {e}",
+                                value.layout
+                            )
+                        })?)
+                    } else {
+                        None
+                    };
+                    Ok((scancode, (keycode, shifted_keycode)))
+                })
+                .collect::<anyhow::Result<Vec<_>>>()
+                .map_err(|e| <D::Error as Error>::custom(e))?,
+        )
+    } else {
+        log::debug!("User defined scancode layout not found: {}", value.layout);
+
+        // lookup in hardcoded defaults
+        let Some(map) = defaults::LAYOUTS.get(value.layout.as_str()) else {
+            return Err(<D::Error as Error>::custom(format!(
+                "Scancode layout not found for: {}",
+                value.layout
+            )));
+        };
+
+        map.to_owned()
+    };
+
+    Ok(ScanCodeMap::new(map))
+}
+
+mod defaults {
+
+    use super::ScanCodeKeyCodeMap;
+    use crate::keyboard::KeyCode;
+    use std::collections::HashMap;
+    use std::str::FromStr;
+
+    macro_rules! entry {
+        ($scancode:expr, $keycode:literal) => {
+            (
+                $scancode,
+                (
+                    KeyCode::from_str($keycode).expect("Failed to parse {$keycode} as KeyCode"),
+                    None,
+                ),
+            )
+        };
+        ($scancode:expr, $keycode:literal, $shifted_keycode:literal) => {
+            (
+                $scancode,
+                (
+                    KeyCode::from_str($keycode).expect("Failed to parse {$keycode} as KeyCode"),
+                    Some(
+                        KeyCode::from_str($shifted_keycode)
+                            .expect("Failed to parse {$shifted_keycode} as KeyCode"),
+                    ),
+                ),
+            )
+        };
+    }
+
+    pub static LAYOUTS: once_cell::sync::Lazy<HashMap<&'static str, ScanCodeKeyCodeMap>> =
+        once_cell::sync::Lazy::new(init);
+
+    fn init() -> HashMap<&'static str, ScanCodeKeyCodeMap> {
+        HashMap::from_iter([qwerty()])
+    }
+
+    fn qwerty() -> (&'static str, ScanCodeKeyCodeMap) {
+        (
+            "qwerty",
+            HashMap::from_iter([
+                entry!(1, "esc"),
+                entry!(2, "1", "!"),
+                entry!(3, "2", "@"),
+                entry!(4, "3", "#"),
+                entry!(5, "4", "$"),
+                entry!(5, "4", "$"),
+                entry!(6, "5", "%"),
+                entry!(7, "6", "^"),
+                entry!(8, "7", "&"),
+                entry!(9, "8", "*"),
+                entry!(10, "9", "("),
+                entry!(11, "0", ")"),
+                entry!(12, "-", "_"),
+                entry!(13, "=", "+"),
+                entry!(14, "backspace"),
+                entry!(15, "tab"),
+                entry!(16, "q", "Q"),
+                entry!(17, "w", "W"),
+                entry!(18, "e", "E"),
+                entry!(19, "r", "R"),
+                entry!(20, "t", "T"),
+                entry!(21, "y", "Y"),
+                entry!(22, "u", "U"),
+                entry!(23, "i", "I"),
+                entry!(24, "o", "O"),
+                entry!(25, "p", "P"),
+                entry!(26, "[", "{"),
+                entry!(27, "]", "}"),
+                entry!(28, "ret"),
+                entry!(29, "leftcontrol"),
+                entry!(30, "a", "A"),
+                entry!(31, "s", "S"),
+                entry!(32, "d", "D"),
+                entry!(33, "f", "F"),
+                entry!(34, "g", "G"),
+                entry!(35, "h", "H"),
+                entry!(36, "j", "J"),
+                entry!(37, "k", "K"),
+                entry!(38, "l", "L"),
+                entry!(39, ";", ":"),
+                entry!(40, "'", "\""),
+                entry!(41, "`", "~"),
+                entry!(42, "leftshift"),
+                entry!(43, "\\", "|"),
+                entry!(44, "z", "Z"),
+                entry!(45, "x", "X"),
+                entry!(46, "c", "C"),
+                entry!(47, "v", "V"),
+                entry!(48, "b", "B"),
+                entry!(49, "n", "N"),
+                entry!(50, "m", "M"),
+                entry!(51, ",", "<"),
+                entry!(52, ".", ">"),
+                entry!(53, "/", "|"),
+                entry!(54, "rightshift"),
+                entry!(55, "printscreen"),
+                entry!(56, "leftalt"),
+                entry!(57, "space"),
+                entry!(58, "capslock"),
+                entry!(59, "F1"),
+                entry!(60, "F2"),
+                entry!(61, "F3"),
+                entry!(62, "F4"),
+                entry!(63, "F5"),
+                entry!(64, "F6"),
+                entry!(65, "F7"),
+                entry!(66, "F8"),
+                entry!(67, "F9"),
+                entry!(68, "F10"),
+                // entry!(69, "numlock"),
+                // entry!(70, "scrolllock"),
+                // entry!(71, "home"),
+                // entry!(72, "up"),
+                // entry!(73, "pageup"),
+                entry!(74, "-"),
+                // entry!(75, "left"),
+                // entry!(77, "right"),
+                entry!(78, "+"),
+                // entry!(79, "end"),
+                // entry!(80, "down"),
+                // entry!(81, "pagedown"),
+                // entry!(82, "ins"),
+                // entry!(83, "del"),
+            ]),
+        )
+    }
+}