//! Native Linux X11 Input Injection Engine via XTest #[cfg(target_os = "linux")] extern "C" { fn x11_mouse_move(x: libc::c_int, y: libc::c_int) -> libc::c_int; fn x11_mouse_relative(dx: libc::c_int, dy: libc::c_int) -> libc::c_int; fn x11_mouse_button(button: libc::c_int, is_press: libc::c_int) -> libc::c_int; fn x11_pointer_state(x:*mut libc::c_int,y:*mut libc::c_int,mask:*mut libc::c_uint)->libc::c_int; fn x11_key_symbol(symbol: libc::c_ulong, is_press: libc::c_int) -> libc::c_int; fn x11_key_event(keycode: libc::c_int, is_press: libc::c_int) -> libc::c_int; fn x11_release_all() -> libc::c_int; fn x11_terminal_shortcut_state() -> libc::c_int; } #[cfg(not(target_os = "linux"))] unsafe fn x11_terminal_shortcut_state() -> libc::c_int { 0 } #[cfg(not(target_os = "linux"))] unsafe fn x11_mouse_move(_: libc::c_int, _: libc::c_int) -> libc::c_int { 0 } #[cfg(not(target_os = "linux"))] unsafe fn x11_mouse_button(_: libc::c_int, _: libc::c_int) -> libc::c_int { 0 } #[cfg(not(target_os = "linux"))] unsafe fn x11_key_event(_: libc::c_int, _: libc::c_int) -> libc::c_int { 0 } #[cfg(not(target_os = "linux"))] unsafe fn x11_key_symbol(_: libc::c_ulong, _: libc::c_int) -> libc::c_int { 0 } #[cfg(not(target_os = "linux"))] unsafe fn x11_mouse_relative(_: libc::c_int, _: libc::c_int) -> libc::c_int {0} #[cfg(not(target_os="linux"))] unsafe fn x11_release_all()->i32 {0} #[derive(Default)] struct PendingPointer { absolute: Option<(i32,i32)>, relative: (i64,i64), scroll: (i64,i64), } #[cfg(not(target_os = "linux"))] unsafe fn x11_pointer_state(_: *mut libc::c_int,_:*mut libc::c_int,_:*mut libc::c_uint)->libc::c_int {-1} #[derive(Default)] struct HeldInput { buttons: std::collections::BTreeSet, keys: std::collections::BTreeSet } /// Held modifier VKs (bit 0 Ctrl, 1 Shift, 2 Alt, 3 Win) and keys that got a synthetic Shift. #[derive(Default)] struct Shortcuts { modifiers: u8, shifted: std::collections::BTreeSet } /// Mac viewer with 「使用 macOS 快捷键」 off sends Cmd as VK_LWIN (verified: Cmd 0x5B, Option 0xA4, /// Ctrl 0xA2). Cmd is held back until we know whether it starts a Mac shortcut. #[derive(Default)] struct CmdState { held: bool, pending: bool, passthrough: bool, combos: std::collections::BTreeMap } pub struct InputInjector { mac_controller: std::sync::atomic::AtomicBool, cmd: std::sync::Mutex, serial:std::sync::Mutex<()>, owner:std::sync::Mutex, shortcuts: std::sync::Mutex, uinput: Option, screen: std::sync::Mutex<(u32,u32)>, portal_failures: std::sync::atomic::AtomicUsize, portal_outcomes: [std::sync::atomic::AtomicUsize; 3], portal:std::sync::Mutex>>, backend: crate::desktop_backend::DesktopBackend, pending: std::sync::Mutex, held: std::sync::Mutex } impl InputInjector { pub fn new() -> Self { let backend = crate::desktop_backend::detect().unwrap_or(crate::desktop_backend::DesktopBackend::X11); let uinput = if crate::uinput::wanted(backend) { match crate::uinput::Devices::open() { Ok(devices) => { log::info!("Input backend: uinput (kernel virtual keyboard/pointer)"); Some(devices) } Err(e) => { log::warn!("uinput unavailable ({}); using the desktop input path. See README for the udev rule.", e.kind()); None } } } else { None }; Self { mac_controller: std::sync::atomic::AtomicBool::new(false), cmd: std::sync::Mutex::new(CmdState::default()), serial:std::sync::Mutex::new(()), owner:std::sync::Mutex::new(DesktopOwner::default()), shortcuts: std::sync::Mutex::new(Shortcuts::default()), uinput, screen: std::sync::Mutex::new((0,0)), portal_failures: std::sync::atomic::AtomicUsize::new(0), portal_outcomes: std::array::from_fn(|_| std::sync::atomic::AtomicUsize::new(0)), portal:std::sync::Mutex::new(None), backend:crate::desktop_backend::detect().unwrap_or(crate::desktop_backend::DesktopBackend::X11), pending: std::sync::Mutex::new(PendingPointer::default()), held:std::sync::Mutex::new(HeldInput::default()) } } pub fn bind_portal(&self,session:Option>) { log::info!("Desktop portal input binding updated: bound={}", session.is_some()); *self.portal.lock().unwrap()=session; } pub fn mouse_move(&self, x: i32, y: i32) { let _serial=self.serial.lock().unwrap(); self.inject_move(x,y,false); } pub fn mouse_absolute_normalized(&self, x: f64, y: f64, size: (u32,u32)) { *self.screen.lock().unwrap() = size; if let Some(position) = crate::input_mapping::normalized_pointer(x,y,size.0,size.1) { let mut pending = self.pending.lock().unwrap(); pending.absolute = Some(position); pending.relative = (0,0); } } pub fn mouse_relative(&self, dx: i32, dy: i32) { if dx.unsigned_abs() <= 65535 && dy.unsigned_abs() <= 65535 { let mut pending = self.pending.lock().unwrap(); pending.relative.0 = (pending.relative.0 + i64::from(dx)).clamp(-65535,65535); pending.relative.1 = (pending.relative.1 + i64::from(dy)).clamp(-65535,65535); } } pub fn mouse_scroll(&self, dx: i32, dy: i32) { // Official Mac normal wheel=120; precise trackpads use smaller values. let mut pending = self.pending.lock().unwrap(); pending.scroll.0 = (pending.scroll.0 + i64::from(dx)).clamp(-12000,12000); pending.scroll.1 = (pending.scroll.1 + i64::from(dy)).clamp(-12000,12000); } pub fn start_pointer_worker(self: &std::sync::Arc) -> tokio::task::JoinHandle<()> { let input = self.clone(); tokio::spawn(async move { let mut tick = tokio::time::interval(std::time::Duration::from_millis(4)); tick.set_missed_tick_behavior(tokio::time::MissedTickBehavior::Skip); loop { tick.tick().await; input.flush_pointer(); } }) } pub fn discard_pointer(&self) { *self.pending.lock().unwrap() = PendingPointer::default(); } pub fn flush_pointer(&self) { let _serial=self.serial.lock().unwrap(); self.flush_pointer_locked(); } fn flush_pointer_locked(&self) { // Hold the queue lock through injection so an older timer tick cannot // overwrite a newer position flushed before a button transition. let mut pending = self.pending.lock().unwrap(); let motion = std::mem::take(&mut *pending); pending.scroll = (motion.scroll.0 % 120, motion.scroll.1 % 120); if let Some((x,y)) = motion.absolute { self.inject_move(x,y,false); } if motion.relative != (0,0) { self.inject_move(motion.relative.0 as i32,motion.relative.1 as i32,true); } for (value, positive, negative) in [(motion.scroll.1,4,5),(motion.scroll.0,7,6)] { let count = value / 120; let button = if count > 0 { positive } else { negative }; for _ in 0..count.unsigned_abs().min(100) { self.inject_button(button,true); self.inject_button(button,false); } } } pub fn wire_mouse_button(&self, button: i32, is_press: bool) { if let Some(mapped) = crate::input_mapping::mouse_button_to_x11(button) { self.mouse_button(mapped,is_press); } else { static UNKNOWN: std::sync::atomic::AtomicUsize = std::sync::atomic::AtomicUsize::new(0); if UNKNOWN.fetch_add(1, std::sync::atomic::Ordering::Relaxed) < 16 { log::warn!("Unsupported desktop wire mouse button: {}", button); } } } pub fn mouse_button(&self, button: i32, is_press: bool) { let _serial=self.serial.lock().unwrap(); self.flush_pointer_locked(); let result = self.inject_button(button,is_press); if result == 0 { let mut held = self.held.lock().unwrap(); if is_press { held.buttons.insert(button); } else { held.buttons.remove(&button); } } else if self.backend != crate::desktop_backend::DesktopBackend::Portal { log::warn!("Desktop mouse injection failed: {}",result); } static BUTTON_AUDIT:std::sync::atomic::AtomicUsize=std::sync::atomic::AtomicUsize::new(0); if self.backend==crate::desktop_backend::DesktopBackend::X11 && BUTTON_AUDIT.fetch_add(1,std::sync::atomic::Ordering::Relaxed)<24 { let (mut x,mut y,mut mask)=(0,0,0); let query=unsafe {x11_pointer_state(&mut x,&mut y,&mut mask)}; log::info!("Pointer button audit: button={} down={} result={} query={} x={} y={} mask={}",button,is_press,result,query,x,y,mask); } } /// Mac viewers send Cmd+V as Ctrl+V (verified: Cmd and Ctrl both arrive as VK_LCONTROL), which in /// a Linux terminal quotes the next key instead of pasting. In a focused terminal Ctrl+V becomes /// Ctrl+Shift+V. Ctrl+C is never translated: it must always interrupt, and copy is Cmd+Shift+C /// (= Ctrl+Shift+C). X11 only; `UU_TERMINAL_SHORTCUTS=0` disables. fn terminal_shift(&self, key: i32, is_press: bool) -> bool { let bit = match key { 0x11 | 0xa2 | 0xa3 => 1, 0x10 | 0xa0 | 0xa1 => 2, 0x12 | 0xa4 | 0xa5 => 4, 0x5b | 0x5c => 8, _ => 0 }; let mut shortcuts = self.shortcuts.lock().unwrap(); if bit != 0 { if is_press { shortcuts.modifiers |= bit } else { shortcuts.modifiers &= !bit } return false; } if !is_press { return shortcuts.shifted.remove(&key); } if key != 0x56 || shortcuts.modifiers != 1 { return false; } if std::env::var("UU_TERMINAL_SHORTCUTS").is_ok_and(|v| v == "0") || std::env::var_os("DISPLAY").is_none() { return false; } let shift = unsafe { x11_terminal_shortcut_state() } & 1 != 0; if shift { shortcuts.shifted.insert(key); static NOTED: std::sync::atomic::AtomicUsize = std::sync::atomic::AtomicUsize::new(0); if NOTED.fetch_add(1, std::sync::atomic::Ordering::Relaxed) < 4 { log::info!("Terminal shortcut: Ctrl+V sent as Ctrl+Shift+V"); } } shift } /// The current desktop controller is the macOS viewer (connect header controller_platform). pub fn set_mac_controller(&self, mac: bool) { self.mac_controller.store(mac, std::sync::atomic::Ordering::Relaxed); *self.cmd.lock().unwrap() = CmdState::default(); } fn terminal_focused(&self) -> bool { self.backend == crate::desktop_backend::DesktopBackend::X11 && std::env::var_os("DISPLAY").is_some() && !std::env::var("UU_TERMINAL_SHORTCUTS").is_ok_and(|v| v == "0") && unsafe { x11_terminal_shortcut_state() } & 1 != 0 } /// Mac habits for a Mac viewer with 「使用 macOS 快捷键」 off: Cmd+C/V/A/F/X/Z (the keys that option /// lists) become Ctrl+key, and in a focused terminal Cmd+C/V become Ctrl+Shift+C/V (copy/paste) /// while Ctrl+C still interrupts. Other Cmd combos, and Cmd alone, stay Super. Returns true when handled. fn mac_cmd(&self, key: i32, is_press: bool) -> bool { const SUPER_L: u64 = 0xffeb; const CONTROL_L: u64 = 0xffe3; const SHIFT_L: u64 = 0xffe1; let mut st = self.cmd.lock().unwrap(); if matches!(key, 0x5b | 0x5c) { if is_press { st.held = true; st.pending = true; st.passthrough = false; } else { if st.passthrough { self.inject_key(SUPER_L, false); } else if st.pending { self.inject_key(SUPER_L, true); self.inject_key(SUPER_L, false); } st.held = false; st.pending = false; st.passthrough = false; } return true; } if !is_press { let Some(shifted) = st.combos.remove(&key) else { return false }; self.key_symbol_event(key, false); if shifted { self.inject_key(SHIFT_L, false); } self.inject_key(CONTROL_L, false); return true; } if !st.held { return false; } // Shift/Option/Ctrl pressed with Cmd (e.g. Cmd+Shift+Z) must not decide the combo yet. if matches!(key, 0x10..=0x12 | 0xa0..=0xa5) { return false; } if st.combos.contains_key(&key) { self.key_symbol_event(key, true); return true; } // autorepeat if matches!(key, 0x41 | 0x43 | 0x46 | 0x56 | 0x58 | 0x5a) && !st.passthrough { st.pending = false; let shifted = matches!(key, 0x43 | 0x56) && self.terminal_focused(); self.inject_key(CONTROL_L, true); if shifted { self.inject_key(SHIFT_L, true); } self.key_symbol_event(key, true); st.combos.insert(key, shifted); static NOTED: std::sync::atomic::AtomicUsize = std::sync::atomic::AtomicUsize::new(0); if NOTED.fetch_add(1, std::sync::atomic::Ordering::Relaxed) < 4 { log::info!("Mac shortcut: Cmd combo sent as Ctrl{}", if shifted { "+Shift (terminal)" } else { "" }); } return true; } if st.pending { self.inject_key(SUPER_L, true); st.pending = false; st.passthrough = true; } false } pub fn windows_key_event(&self, key: i32, is_press: bool) { let _serial=self.serial.lock().unwrap(); if self.mac_controller.load(std::sync::atomic::Ordering::Relaxed) && self.mac_cmd(key, is_press) { return; } if self.terminal_shift(key, is_press) { const SHIFT_L: u64 = 0xffe1; if is_press { self.inject_key(SHIFT_L, true); self.key_symbol_event(key, true); } else { self.key_symbol_event(key, false); self.inject_key(SHIFT_L, false); } return; } self.key_symbol_event(key, is_press); } fn key_symbol_event(&self, key: i32, is_press: bool) { if let Some(symbol) = crate::input_mapping::windows_vk_to_keysym(key) { let result = self.inject_key(symbol,is_press); static AUDIT: std::sync::atomic::AtomicUsize = std::sync::atomic::AtomicUsize::new(0); if AUDIT.fetch_add(1,std::sync::atomic::Ordering::Relaxed) < 8 { log::info!("Desktop keyboard injection outcome: result={result}"); } if result == 0 { let mut held=self.held.lock().unwrap(); if is_press {held.keys.insert(symbol);} else {held.keys.remove(&symbol);} } } } pub fn release_held(&self) { let _serial=self.serial.lock().unwrap(); self.discard_pointer(); let mut held=self.held.lock().unwrap(); if let Some(uinput)=&self.uinput { Self::uinput_result(uinput.release_all()); } else if self.backend==crate::desktop_backend::DesktopBackend::X11 { unsafe {x11_release_all();} } else if self.backend==crate::desktop_backend::DesktopBackend::Wayland && self.portal.lock().unwrap().is_none() { crate::wayland::release_all(); } else if self.backend==crate::desktop_backend::DesktopBackend::Portal && self.portal.lock().unwrap().is_none() { // Nothing is bound yet (e.g. the first locked connection): no input can be held. } else { // Portal/Wayland cannot query global state. Sweep every key/button // that this host can emit through the currently bound session. let keys:std::collections::BTreeSet<_>=(0..=255).filter_map(crate::input_mapping::windows_vk_to_keysym) .chain(held.keys.iter().copied()).collect(); // A dead Portal bus can time out per call. Stop on the first // failure rather than blocking teardown for hundreds of calls; // the next connected session retries the complete sweep. let buttons_ok=[1,2,3,8,9].into_iter().all(|button|self.inject_button(button,false)==0); let keys_ok=buttons_ok && keys.into_iter().all(|key|self.inject_key(key,false)==0); if !keys_ok {log::warn!("Desktop input reset incomplete: backend unavailable");} } *held=HeldInput::default(); *self.shortcuts.lock().unwrap()=Shortcuts::default(); *self.cmd.lock().unwrap()=CmdState::default(); } // Per-injector budgets cover missing bindings, locked sessions, stale handles // and D-Bus errors. Never include keys, coordinates, text or portal tokens. fn portal_result(&self, operation: &str, result: Result<(), String>) -> i32 { use std::sync::atomic::Ordering::Relaxed; let slot = match operation { "motion" => 0, "button" => 1, _ => 2 }; if self.portal_outcomes[slot].fetch_add(1, Relaxed) < 16 { log::info!("Portal input outcome: operation={} success={}", operation, result.is_ok()); } match result { Ok(()) => 0, Err(reason) => { let index = self.portal_failures.fetch_add(1, Relaxed); if index < 16 { log::warn!("Portal input injection failed: operation={} reason={} failure={}/16{}", operation, reason, index + 1, if index == 15 { " (further failures suppressed)" } else { "" }); } -1 } } } fn uinput_result(result: std::io::Result<()>) -> i32 { match result { Ok(()) => 0, Err(e) => { static FAILURES: std::sync::atomic::AtomicUsize = std::sync::atomic::AtomicUsize::new(0); if FAILURES.fetch_add(1, std::sync::atomic::Ordering::Relaxed) < 8 { log::warn!("uinput injection failed: {}", e.kind()); } -1 } } } fn inject_move(&self,x:i32,y:i32,relative:bool)->i32 { if let Some(uinput)=&self.uinput { if relative { return Self::uinput_result(uinput.move_relative(x,y)); } let (w,h)=*self.screen.lock().unwrap(); if w > 1 && h > 1 { let scale = |v: i32, extent: u32| (i64::from(v) * i64::from(crate::uinput::ABS_MAX) / i64::from(extent - 1)) as i32; return Self::uinput_result(uinput.move_absolute(scale(x,w),scale(y,h))); } } if self.backend==crate::desktop_backend::DesktopBackend::Kms { return -1; } if let Some(portal)=self.portal.lock().unwrap().as_ref() { return self.portal_result("motion", portal.move_pointer(f64::from(x),f64::from(y),relative)); } if self.backend==crate::desktop_backend::DesktopBackend::Portal {return self.portal_result("motion", Err("Portal input session is not bound".into()));} if self.backend==crate::desktop_backend::DesktopBackend::Wayland { crate::wayland::move_pointer(x,y,relative) } else if relative { unsafe { x11_mouse_relative(x,y) } } else { unsafe { x11_mouse_move(x,y) } } } fn inject_button(&self,button:i32,pressed:bool)->i32 { if let Some(uinput)=&self.uinput { if let Some((v,h))=crate::uinput::wheel_step(button) { return if pressed { Self::uinput_result(uinput.wheel(v,h)) } else { 0 }; } if let Some(code)=crate::uinput::button_code(button) { return Self::uinput_result(uinput.button(code,pressed)); } } if self.backend==crate::desktop_backend::DesktopBackend::Kms { return -1; } if let Some(portal)=self.portal.lock().unwrap().as_ref() { return self.portal_result("button", portal.button(button,pressed)); } if self.backend==crate::desktop_backend::DesktopBackend::Portal {return self.portal_result("button", Err("Portal input session is not bound".into()));} if self.backend==crate::desktop_backend::DesktopBackend::Wayland { crate::wayland::button(button,pressed) } else { unsafe { x11_mouse_button(button,i32::from(pressed)) } } } fn inject_key(&self,symbol:u64,pressed:bool)->i32 { if let Some(uinput)=&self.uinput { if let Some(code)=crate::uinput::keysym_to_evdev(symbol) { return Self::uinput_result(uinput.key(code,pressed)); } } if self.backend==crate::desktop_backend::DesktopBackend::Kms { return -1; } if let Some(portal)=self.portal.lock().unwrap().as_ref() { return self.portal_result("keyboard", portal.key(symbol,pressed)); } if self.backend==crate::desktop_backend::DesktopBackend::Portal {return self.portal_result("keyboard", Err("Portal input session is not bound".into()));} if self.backend==crate::desktop_backend::DesktopBackend::Wayland { crate::wayland::key(symbol,pressed) } else { unsafe { x11_key_symbol(symbol as libc::c_ulong,i32::from(pressed)) } } } pub fn key_event(&self, keycode: i32, is_press: bool) { let _serial=self.serial.lock().unwrap(); if self.backend!=crate::desktop_backend::DesktopBackend::X11 { return; } unsafe { x11_key_event(keycode, if is_press { 1 } else { 0 }) }; } } #[cfg(test)] mod motion_tests { use super::*; #[test] fn coalesces_absolute_history_to_latest_position() { let input = InputInjector::new(); input.mouse_absolute_normalized(0.1,0.1,(1920,1080)); input.mouse_absolute_normalized(0.9,0.9,(1920,1080)); assert_eq!(input.pending.lock().unwrap().absolute,Some((1727,971))); } #[test] fn preserves_relative_distance_after_latest_absolute() { let input = InputInjector::new(); input.mouse_relative(10,20); input.mouse_absolute_normalized(0.5,0.5,(1920,1080)); input.mouse_relative(3,-2); input.mouse_relative(4,5); let state = input.pending.lock().unwrap(); assert_eq!(state.absolute,Some((960,540))); assert_eq!(state.relative,(7,3)); } #[test] fn button_transition_flushes_motion_and_teardown_discards_pending() { let input = InputInjector::new(); input.mouse_absolute_normalized(0.5,0.5,(1920,1080)); input.mouse_button(1,true); assert!(input.pending.lock().unwrap().absolute.is_none()); input.mouse_relative(1,2); input.discard_pointer(); assert_eq!(input.pending.lock().unwrap().relative,(0,0)); } } #[cfg(test)] mod shortcut_tests { use super::*; #[test] fn modifiers_are_tracked_and_non_terminal_keys_pass_through() { let input = InputInjector::new(); assert!(!input.terminal_shift(0x11, true)); assert_eq!(input.shortcuts.lock().unwrap().modifiers, 1); // No X display in tests: Ctrl+V is not translated. assert!(!input.terminal_shift(0x56, true)); assert!(!input.terminal_shift(0x56, false)); assert!(!input.terminal_shift(0x11, false)); assert_eq!(input.shortcuts.lock().unwrap().modifiers, 0); // A translated key keeps its synthetic Shift until its own release. input.shortcuts.lock().unwrap().shifted.insert(0x56); assert!(input.terminal_shift(0x56, false)); assert!(!input.terminal_shift(0x56, false)); // Ctrl+C is never translated. input.terminal_shift(0x11, true); assert!(!input.terminal_shift(0x43, true)); } } #[cfg(test)] mod scroll_tests { use super::*; #[test] fn precise_scroll_accumulates_sub_notch_remainder() { let input = InputInjector::new(); input.mouse_scroll(0, 2); input.flush_pointer(); assert_eq!(input.pending.lock().unwrap().scroll,(0,2)); input.mouse_scroll(0,118); input.flush_pointer(); assert_eq!(input.pending.lock().unwrap().scroll,(0,0)); input.mouse_scroll(-125,-125); input.flush_pointer(); assert_eq!(input.pending.lock().unwrap().scroll,(-5,-5)); } } /// Only the newest desktop lease may inject or release input. Tool peers never /// obtain a lease; delayed callbacks from an old desktop cannot clear a new one. #[derive(Default)] struct DesktopOwner { next:u64, current:u64, active:bool, stopped:bool } impl DesktopOwner { fn replace(&mut self)->u64 {self.next+=1;self.current=self.next;self.active=false;self.current} fn owns(&self,id:u64)->bool {id!=0 && self.current==id} } pub struct DesktopInputSession {input:std::sync::Arc,id:u64} impl InputInjector { pub fn shutdown(&self) { let mut owner=self.owner.lock().unwrap(); owner.current=0;owner.active=false;owner.stopped=true; self.release_held(); } pub fn desktop_session(self:&std::sync::Arc)->std::sync::Arc { let mut owner=self.owner.lock().unwrap(); let id=if owner.stopped {0} else {self.release_held();owner.replace()}; std::sync::Arc::new(DesktopInputSession {input:self.clone(),id}) } } impl DesktopInputSession { pub fn is_current(&self) -> bool { let owner = self.input.owner.lock().unwrap(); owner.owns(self.id) } /// Call only inside with_current or with_input, so a superseded peer cannot change bindings. pub fn bind_portal(&self, portal: Option>) { self.input.bind_portal(portal); } pub fn release_input(&self) { self.input.release_held(); } pub fn connected(&self) { let mut owner=self.input.owner.lock().unwrap(); if owner.owns(self.id) && !owner.active {self.input.release_held();owner.active=true;} } pub fn disconnected(&self) { let mut owner=self.input.owner.lock().unwrap(); if owner.owns(self.id) && owner.active {owner.active=false;self.input.release_held();} } /// Lifecycle updates survive a transient disconnect, but serialize with replacement and shutdown. pub fn with_current(&self, action:impl FnOnce()) { let owner=self.input.owner.lock().unwrap(); if owner.owns(self.id) {action();} } pub fn with_input(&self, action:impl FnOnce()) { let owner=self.input.owner.lock().unwrap(); if owner.owns(self.id) && owner.active {action();} } } impl Drop for DesktopInputSession {fn drop(&mut self) {self.disconnected();}} #[cfg(test)] impl InputInjector { pub fn without_desktop() -> Self { Self { mac_controller:std::sync::atomic::AtomicBool::new(false), cmd:std::sync::Mutex::new(CmdState::default()), serial:std::sync::Mutex::new(()), owner:std::sync::Mutex::new(DesktopOwner::default()), shortcuts:std::sync::Mutex::new(Shortcuts::default()), uinput:None, screen:std::sync::Mutex::new((0,0)), portal_failures:std::sync::atomic::AtomicUsize::new(0), portal_outcomes:std::array::from_fn(|_|std::sync::atomic::AtomicUsize::new(0)), portal:std::sync::Mutex::new(None), backend:crate::desktop_backend::DesktopBackend::Portal, pending:std::sync::Mutex::new(PendingPointer::default()), held:std::sync::Mutex::new(HeldInput::default()) } } } #[cfg(test)] mod lifecycle_tests { use super::*; use std::sync::{Arc,atomic::{AtomicUsize,Ordering}}; #[test] fn current_owner_can_publish_while_disconnected_but_cannot_inject() { let input=Arc::new(InputInjector::without_desktop()); let session=input.desktop_session(); session.connected();session.disconnected(); let publications=AtomicUsize::new(0); session.with_current(||{publications.fetch_add(1,Ordering::Relaxed);}); session.with_input(||panic!("disconnected owner must not inject")); assert_eq!(publications.load(Ordering::Relaxed),1); session.connected(); session.with_input(||{publications.fetch_add(1,Ordering::Relaxed);}); let next=input.desktop_session(); session.with_current(||panic!("replaced owner must not publish")); next.with_current(||{publications.fetch_add(1,Ordering::Relaxed);}); input.shutdown(); next.with_current(||panic!("shutdown must reject lifecycle updates")); assert_eq!(publications.load(Ordering::Relaxed),3); } #[test] fn current_owner_gate_holds_ownership_through_publication() { let input=Arc::new(InputInjector::without_desktop()); let session=input.desktop_session(); let (started,ready)=std::sync::mpsc::channel(); let (finish,resume)=std::sync::mpsc::channel(); let worker=session.clone(); let publication=std::thread::spawn(move ||worker.with_current(|| { started.send(()).unwrap();resume.recv().unwrap(); })); ready.recv_timeout(std::time::Duration::from_secs(2)).unwrap(); assert!(input.owner.try_lock().is_err()); let replacing=input.clone(); let replacement=std::thread::spawn(move ||replacing.desktop_session()); finish.send(()).unwrap(); publication.join().unwrap(); let next=replacement.join().unwrap(); assert!(next.is_current()); session.with_current(||panic!("late publication after replacement")); } #[test] fn cleanup_discards_motion_shortcuts_and_untracked_input_ledger() { let input=Arc::new(InputInjector::new()); input.held.lock().unwrap().keys.insert(0xffe1); input.held.lock().unwrap().buttons.insert(1); input.shortcuts.lock().unwrap().modifiers=2; input.shortcuts.lock().unwrap().shifted.insert(0x56); input.mouse_relative(32,0); input.mouse_scroll(0,1); input.release_held(); assert!(input.held.lock().unwrap().keys.is_empty()); assert!(input.held.lock().unwrap().buttons.is_empty()); assert_eq!(input.pending.lock().unwrap().relative,(0,0)); assert_eq!(input.pending.lock().unwrap().scroll,(0,0)); assert_eq!(input.shortcuts.lock().unwrap().modifiers,0); assert!(input.shortcuts.lock().unwrap().shifted.is_empty()); input.release_held(); // idempotent even with an empty ledger } #[test] fn disconnected_or_replaced_desktop_cannot_inject_or_clear_new_input() { let input=Arc::new(InputInjector::new()); let count=AtomicUsize::new(0); let old=input.desktop_session(); old.with_input(||{count.fetch_add(1,Ordering::Relaxed);}); assert_eq!(count.load(Ordering::Relaxed),0); old.connected(); old.with_input(||{count.fetch_add(1,Ordering::Relaxed);}); old.disconnected(); old.with_input(||{count.fetch_add(1,Ordering::Relaxed);}); assert_eq!(count.load(Ordering::Relaxed),1); input.held.lock().unwrap().buttons.insert(2); old.disconnected(); // repeated close states must not release later local activity assert!(input.held.lock().unwrap().buttons.contains(&2)); old.connected(); // same peer can reconnect assert!(input.held.lock().unwrap().buttons.is_empty()); let new=input.desktop_session(); new.connected(); input.held.lock().unwrap().buttons.insert(1); old.disconnected();old.connected();drop(old); assert!(input.held.lock().unwrap().buttons.contains(&1)); new.with_input(||{count.fetch_add(1,Ordering::Relaxed);}); assert_eq!(count.load(Ordering::Relaxed),2); drop(new); assert!(input.held.lock().unwrap().buttons.is_empty()); let last=input.desktop_session();last.connected(); input.shutdown();last.connected(); last.with_input(||panic!("shutdown cannot be undone by a stale callback")); let later=input.desktop_session();later.connected(); later.with_input(||panic!("shutdown must reject newly arriving offers too")); } #[test] fn input_gate_serializes_disconnect_against_inflight_event() { let input=Arc::new(InputInjector::new()); let session=input.desktop_session();session.connected(); let (started,ready)=std::sync::mpsc::channel(); let (finish,resume)=std::sync::mpsc::channel(); let worker=session.clone(); let event=std::thread::spawn(move ||worker.with_input(|| { started.send(()).unwrap();resume.recv().unwrap(); worker.input.held.lock().unwrap().buttons.insert(1); })); ready.recv().unwrap(); let ending=session.clone(); let teardown=std::thread::spawn(move ||ending.disconnected()); finish.send(()).unwrap();event.join().unwrap();teardown.join().unwrap(); assert!(input.held.lock().unwrap().buttons.is_empty()); session.with_input(||panic!("late event after disconnect")); } }