//! Input handling — translates crossterm key/mouse events into state mutations. use bytes::Bytes; use crossterm::event::{KeyCode, KeyEvent, MouseButton, MouseEvent, MouseEventKind}; use ratatui::layout::Direction; use tracing::warn; use crate::layout::{NavDirection, PaneInfo, SplitBorder}; use crate::selection::Selection; use super::state::{key_matches, AppState, ContextMenuState, DragState, Mode, CONTEXT_MENU_ITEMS}; use super::App; // --------------------------------------------------------------------------- // Key handling // --------------------------------------------------------------------------- impl App { pub(super) async fn handle_key(&mut self, key: KeyEvent) { match self.state.mode { Mode::Onboarding => self.handle_onboarding_key(key), Mode::Navigate => handle_navigate_key(&mut self.state, key), Mode::Terminal => self.handle_terminal_key(key).await, Mode::RenameSession => handle_rename_key(&mut self.state, key), Mode::Resize => handle_resize_key(&mut self.state, key), Mode::ConfirmClose => handle_confirm_close_key(&mut self.state, key), Mode::ContextMenu => handle_context_menu_key(&mut self.state, key), } } pub(super) async fn handle_paste(&mut self, text: String) { if self.state.mode != Mode::Terminal { return; } if let Some(ws) = self.state.active.and_then(|i| self.state.workspaces.get(i)) { if let Some(rt) = ws.focused_runtime() { let bracketed = rt .parser .read() .map(|p| p.screen().bracketed_paste()) .unwrap_or(false); let payload = if bracketed { format!("\x1b[200~{text}\x1b[201~") } else { text }; let _ = rt.sender.send(Bytes::from(payload)).await; } } } fn handle_onboarding_key(&mut self, key: KeyEvent) { match self.state.onboarding_step { 0 => match key.code { KeyCode::Enter | KeyCode::Right | KeyCode::Char('l') => { self.state.onboarding_step = 1; } KeyCode::Char('q') => self.state.should_quit = true, _ => {} }, _ => match key.code { KeyCode::Up | KeyCode::Char('k') => { if self.state.onboarding_selected > 0 { self.state.onboarding_selected -= 1; } } KeyCode::Down | KeyCode::Char('j') => { if self.state.onboarding_selected < 3 { self.state.onboarding_selected += 1; } } KeyCode::Left | KeyCode::Esc | KeyCode::Char('h') => { self.state.onboarding_step = 0; } KeyCode::Char(c) if ('1'..='4').contains(&c) => { self.state.onboarding_selected = (c as usize) - ('1' as usize); } KeyCode::Enter => self.complete_onboarding(), KeyCode::Char('q') => self.state.should_quit = true, _ => {} }, } } async fn handle_terminal_key(&mut self, key: KeyEvent) { self.state.clear_selection(); self.state.update_dismissed = true; if self.state.is_prefix(&key) { self.state.mode = Mode::Navigate; return; } if let Some(ws) = self.state.active.and_then(|i| self.state.workspaces.get(i)) { if let Some(rt) = ws.focused_runtime() { rt.scroll_reset(); let kitty = rt.kitty_keyboard.load(std::sync::atomic::Ordering::Relaxed); let bytes = crate::input::encode_key(key, kitty); if bytes.is_empty() { warn!(code = ?key.code, mods = ?key.modifiers, state = ?key.state, "key produced empty encoding"); } else { let _ = rt.sender.send(Bytes::from(bytes)).await; } } } } } fn handle_navigate_key(state: &mut AppState, key: KeyEvent) { state.update_dismissed = true; if state.is_prefix(&key) || key.code == KeyCode::Esc { leave_navigate_mode(state); return; } if let Some(action) = navigate_action_for_key(state, &key) { execute_navigate_action(state, action); return; } match key.code { KeyCode::Char('q') => state.should_quit = true, KeyCode::Enter => { if !state.workspaces.is_empty() { state.switch_workspace(state.selected); leave_navigate_mode(state); } } KeyCode::Char(c @ '1'..='9') => { let idx = (c as usize) - ('1' as usize); if idx < state.workspaces.len() { state.switch_workspace(idx); leave_navigate_mode(state); } } KeyCode::Up => { if state.selected > 0 { state.selected -= 1; } } KeyCode::Down => { if !state.workspaces.is_empty() && state.selected < state.workspaces.len() - 1 { state.selected += 1; } } KeyCode::Char('h') | KeyCode::Left => state.navigate_pane(NavDirection::Left), KeyCode::Char('j') => state.navigate_pane(NavDirection::Down), KeyCode::Char('k') => state.navigate_pane(NavDirection::Up), KeyCode::Char('l') | KeyCode::Right => state.navigate_pane(NavDirection::Right), KeyCode::Tab => state.cycle_pane(false), KeyCode::BackTab => state.cycle_pane(true), _ => {} } } #[derive(Debug, Clone, Copy)] enum NavigateAction { NewWorkspace, RenameWorkspace, CloseWorkspace, SplitVertical, SplitHorizontal, ClosePane, Fullscreen, EnterResizeMode, ToggleSidebar, } fn navigate_action_for_key(state: &AppState, key: &KeyEvent) -> Option { let kb = &state.keybinds; if key_matches(key, kb.new_workspace.0, kb.new_workspace.1) { return Some(NavigateAction::NewWorkspace); } if key_matches(key, kb.rename_workspace.0, kb.rename_workspace.1) { return Some(NavigateAction::RenameWorkspace); } if key_matches(key, kb.close_workspace.0, kb.close_workspace.1) { return Some(NavigateAction::CloseWorkspace); } if key_matches(key, kb.split_vertical.0, kb.split_vertical.1) { return Some(NavigateAction::SplitVertical); } if key_matches(key, kb.split_horizontal.0, kb.split_horizontal.1) { return Some(NavigateAction::SplitHorizontal); } if key_matches(key, kb.close_pane.0, kb.close_pane.1) { return Some(NavigateAction::ClosePane); } if key_matches(key, kb.fullscreen.0, kb.fullscreen.1) { return Some(NavigateAction::Fullscreen); } if key_matches(key, kb.resize_mode.0, kb.resize_mode.1) { return Some(NavigateAction::EnterResizeMode); } if key_matches(key, kb.toggle_sidebar.0, kb.toggle_sidebar.1) { return Some(NavigateAction::ToggleSidebar); } None } fn execute_navigate_action(state: &mut AppState, action: NavigateAction) { match action { NavigateAction::NewWorkspace => { state.request_new_workspace = true; leave_navigate_mode(state); } NavigateAction::RenameWorkspace => { if !state.workspaces.is_empty() { state.name_input = state.workspaces[state.selected].display_name(); state.mode = Mode::RenameSession; } } NavigateAction::CloseWorkspace => { if !state.workspaces.is_empty() { if state.confirm_close { state.mode = Mode::ConfirmClose; } else { state.close_selected_workspace(); leave_navigate_mode(state); } } } NavigateAction::SplitVertical => { state.split_pane(Direction::Horizontal); leave_navigate_mode(state); } NavigateAction::SplitHorizontal => { state.split_pane(Direction::Vertical); leave_navigate_mode(state); } NavigateAction::ClosePane => { state.close_pane(); leave_navigate_mode(state); } NavigateAction::Fullscreen => { state.toggle_fullscreen(); leave_navigate_mode(state); } NavigateAction::EnterResizeMode => state.mode = Mode::Resize, NavigateAction::ToggleSidebar => { state.sidebar_collapsed = !state.sidebar_collapsed; leave_navigate_mode(state); } } } fn leave_navigate_mode(state: &mut AppState) { if state.active.is_some() { state.mode = Mode::Terminal; } } fn handle_rename_key(state: &mut AppState, key: KeyEvent) { match key.code { KeyCode::Enter => { let new_name = if state.name_input.trim().is_empty() { state.name_input.clone() } else { state.name_input.trim().to_string() }; if !new_name.is_empty() && !state.workspaces.is_empty() { state.workspaces[state.selected].set_custom_name(new_name); } state.name_input.clear(); state.mode = Mode::Navigate; } KeyCode::Esc => { state.name_input.clear(); state.mode = Mode::Navigate; } KeyCode::Backspace => { state.name_input.pop(); } KeyCode::Char(c) => { state.name_input.push(c); } _ => {} } } fn handle_resize_key(state: &mut AppState, key: KeyEvent) { if key.code == KeyCode::Esc || key.code == KeyCode::Enter || key_matches( &key, state.keybinds.resize_mode.0, state.keybinds.resize_mode.1, ) { if state.active.is_some() { state.mode = Mode::Terminal; } else { state.mode = Mode::Navigate; } return; } match key.code { KeyCode::Char('h') | KeyCode::Left => state.resize_pane(NavDirection::Left), KeyCode::Char('l') | KeyCode::Right => state.resize_pane(NavDirection::Right), KeyCode::Char('j') | KeyCode::Down => state.resize_pane(NavDirection::Down), KeyCode::Char('k') | KeyCode::Up => state.resize_pane(NavDirection::Up), _ => {} } } fn handle_confirm_close_key(state: &mut AppState, key: KeyEvent) { match key.code { KeyCode::Char('y') | KeyCode::Enter => { state.close_selected_workspace(); if state.workspaces.is_empty() { state.mode = Mode::Navigate; } else { state.mode = Mode::Terminal; } } _ => { state.mode = Mode::Navigate; } } } fn handle_context_menu_key(state: &mut AppState, key: KeyEvent) { match key.code { KeyCode::Esc => { state.context_menu = None; state.mode = Mode::Navigate; } KeyCode::Up => { if let Some(menu) = &mut state.context_menu { if menu.selected > 0 { menu.selected -= 1; } } } KeyCode::Down => { if let Some(menu) = &mut state.context_menu { if menu.selected < CONTEXT_MENU_ITEMS.len() - 1 { menu.selected += 1; } } } KeyCode::Enter => { if let Some(menu) = state.context_menu.take() { match CONTEXT_MENU_ITEMS[menu.selected] { "Rename" => { state.selected = menu.ws_idx; state.name_input = state.workspaces[menu.ws_idx].display_name(); state.mode = Mode::RenameSession; } "Close" => { state.selected = menu.ws_idx; if state.confirm_close { state.mode = Mode::ConfirmClose; } else { state.close_selected_workspace(); state.mode = Mode::Navigate; } } _ => state.mode = Mode::Navigate, } } } _ => {} } } // --------------------------------------------------------------------------- // Mouse handling // --------------------------------------------------------------------------- impl AppState { fn onboarding_full_area(&self) -> ratatui::layout::Rect { self.view.sidebar_rect.union(self.view.terminal_area) } fn onboarding_modal_inner(&self, popup_w: u16, popup_h: u16) -> Option { let area = self.onboarding_full_area(); let popup_w = popup_w.min(area.width.saturating_sub(4)); let popup_h = popup_h.min(area.height.saturating_sub(2)); if popup_w < 4 || popup_h < 4 { return None; } let popup_x = area.x + (area.width.saturating_sub(popup_w)) / 2; let popup_y = area.y + (area.height.saturating_sub(popup_h)) / 2; let popup = ratatui::layout::Rect::new(popup_x, popup_y, popup_w, popup_h); let block = ratatui::widgets::Block::default().borders(ratatui::widgets::Borders::ALL); Some(block.inner(popup)) } fn handle_onboarding_mouse(&mut self, mouse: MouseEvent) { if mouse.kind != MouseEventKind::Down(MouseButton::Left) { return; } match self.onboarding_step { 0 => { let Some(inner) = self.onboarding_modal_inner(64, 15) else { return; }; let footer_y = inner.y + 9; let button_x = inner.x; let button_w = 14; if mouse.row == footer_y && mouse.column >= button_x && mouse.column < button_x + button_w { self.onboarding_step = 1; } } _ => { let Some(inner) = self.onboarding_modal_inner(52, 10) else { return; }; let options_start_y = inner.y + 2; if mouse.row >= options_start_y && mouse.row < options_start_y + 4 { self.onboarding_selected = (mouse.row - options_start_y) as usize; return; } let footer_y = inner.y + 6; let back_x = inner.x; let back_w = 10; let save_x = inner.x + 12; let save_w = 10; if mouse.row == footer_y { if mouse.column >= back_x && mouse.column < back_x + back_w { self.onboarding_step = 0; } else if mouse.column >= save_x && mouse.column < save_x + save_w { self.request_complete_onboarding = true; } } } } } pub(crate) fn handle_mouse(&mut self, mouse: MouseEvent) { if self.mode == Mode::Onboarding { self.handle_onboarding_mouse(mouse); return; } let sidebar = self.view.sidebar_rect; let in_sidebar = mouse.column >= sidebar.x && mouse.column < sidebar.x + sidebar.width && mouse.row >= sidebar.y && mouse.row < sidebar.y + sidebar.height; match mouse.kind { MouseEventKind::Down(MouseButton::Left) => { self.selection = None; if self.mode == Mode::ContextMenu { if let Some(menu) = &self.context_menu { let item_idx = self.context_menu_item_at(mouse.column, mouse.row); if let Some(idx) = item_idx { let ws_idx = menu.ws_idx; self.context_menu = None; match CONTEXT_MENU_ITEMS[idx] { "Rename" => { self.selected = ws_idx; self.name_input = self.workspaces[ws_idx].display_name(); self.mode = Mode::RenameSession; } "Close" => { self.selected = ws_idx; if self.confirm_close { self.mode = Mode::ConfirmClose; } else { self.close_selected_workspace(); self.mode = Mode::Navigate; } } _ => self.mode = Mode::Navigate, } } else { self.context_menu = None; self.mode = Mode::Navigate; } } return; } if !in_sidebar { if let Some(border) = self.find_border_at(mouse.column, mouse.row) { self.drag = Some(DragState { path: border.path.clone(), direction: border.direction, area: border.area, }); return; } } if in_sidebar { let bottom_y = sidebar.y + sidebar.height.saturating_sub(1); let new_row_y = bottom_y.saturating_sub(1); if mouse.row == bottom_y { self.sidebar_collapsed = !self.sidebar_collapsed; return; } if !self.sidebar_collapsed && mouse.row == new_row_y { self.request_new_workspace = true; return; } let inner_y = sidebar.y; if mouse.row >= inner_y && mouse.row < new_row_y { let idx = ((mouse.row - inner_y) / 2) as usize; if idx < self.workspaces.len() { self.switch_workspace(idx); self.mode = Mode::Terminal; } } } else if let Some(info) = self.pane_at(mouse.column, mouse.row).cloned() { let (row, col) = ( mouse.row - info.inner_rect.y, mouse.column - info.inner_rect.x, ); self.selection = Some(Selection::anchor(info.id, row, col, info.inner_rect)); if let Some(ws) = self.active.and_then(|i| self.workspaces.get_mut(i)) { if ws.layout.focused() != info.id { ws.layout.focus_pane(info.id); } } if self.mode != Mode::Terminal { self.mode = Mode::Terminal; } } else { if let Some(info) = self.view.pane_infos.iter().find(|p| { mouse.column >= p.rect.x && mouse.column < p.rect.x + p.rect.width && mouse.row >= p.rect.y && mouse.row < p.rect.y + p.rect.height }) { let id = info.id; if let Some(ws) = self.active.and_then(|i| self.workspaces.get_mut(i)) { if ws.layout.focused() != id { ws.layout.focus_pane(id); } } if self.mode != Mode::Terminal { self.mode = Mode::Terminal; } } } } MouseEventKind::Drag(MouseButton::Left) => { if let Some(drag) = &self.drag { let ratio = match drag.direction { Direction::Horizontal => { (mouse.column.saturating_sub(drag.area.x)) as f32 / drag.area.width.max(1) as f32 } Direction::Vertical => { (mouse.row.saturating_sub(drag.area.y)) as f32 / drag.area.height.max(1) as f32 } }; let ratio = ratio.clamp(0.1, 0.9); let path = drag.path.clone(); if let Some(ws) = self.active.and_then(|i| self.workspaces.get_mut(i)) { ws.layout.set_ratio_at(&path, ratio); } } else if let Some(sel) = &mut self.selection { sel.drag(mouse.column, mouse.row); } } MouseEventKind::Up(MouseButton::Left) => { if self.drag.take().is_some() { // Drag ended } else { let was_click = self.selection.as_ref().is_some_and(|s| s.was_just_click()); if was_click { self.selection = None; } else { self.copy_selection(); } } } MouseEventKind::ScrollUp if !in_sidebar => { self.selection = None; if let Some(ws) = self.active.and_then(|i| self.workspaces.get(i)) { if let Some(rt) = ws.focused_runtime() { rt.scroll_up(3); } } } MouseEventKind::ScrollDown if !in_sidebar => { self.selection = None; if let Some(ws) = self.active.and_then(|i| self.workspaces.get(i)) { if let Some(rt) = ws.focused_runtime() { rt.scroll_down(3); } } } MouseEventKind::ScrollUp if in_sidebar => { if self.selected > 0 { self.selected -= 1; } } MouseEventKind::ScrollDown if in_sidebar => { if !self.workspaces.is_empty() && self.selected < self.workspaces.len() - 1 { self.selected += 1; } } MouseEventKind::Down(MouseButton::Right) if in_sidebar => { let inner_y = sidebar.y; let bottom_y = sidebar.y + sidebar.height.saturating_sub(1); let new_row_y = bottom_y.saturating_sub(1); if mouse.row >= inner_y && mouse.row < new_row_y { let idx = ((mouse.row - inner_y) / 2) as usize; if idx < self.workspaces.len() { self.selected = idx; self.context_menu = Some(ContextMenuState { ws_idx: idx, x: mouse.column, y: mouse.row, selected: 0, }); self.mode = Mode::ContextMenu; } } } _ => {} } } fn context_menu_item_at(&self, col: u16, row: u16) -> Option { let menu = self.context_menu.as_ref()?; let menu_w = 14u16; let inner_x = menu.x; let inner_y = menu.y + 1; if col >= inner_x && col < inner_x + menu_w && row >= inner_y && row < inner_y + CONTEXT_MENU_ITEMS.len() as u16 { Some((row - inner_y) as usize) } else { None } } fn find_border_at(&self, col: u16, row: u16) -> Option<&SplitBorder> { self.view.split_borders.iter().find(|b| match b.direction { Direction::Horizontal => { (col as i32 - b.pos as i32).unsigned_abs() <= 1 && row >= b.area.y && row < b.area.y + b.area.height } Direction::Vertical => { (row as i32 - b.pos as i32).unsigned_abs() <= 1 && col >= b.area.x && col < b.area.x + b.area.width } }) } fn pane_at(&self, col: u16, row: u16) -> Option<&PaneInfo> { self.view.pane_infos.iter().find(|p| { col >= p.inner_rect.x && col < p.inner_rect.x + p.inner_rect.width && row >= p.inner_rect.y && row < p.inner_rect.y + p.inner_rect.height }) } } // Note: split_pane needs runtime (event_tx for PTY spawn), so it lives on App impl AppState { pub(crate) fn split_pane(&mut self, direction: Direction) { // Actual PTY spawning happens in Workspace::split_focused // which needs events channel — this is called from navigate_key // where we don't have async context, so the workspace handles it let (rows, cols) = self.estimate_pane_size(); let new_rows = (rows / 2).max(4); let new_cols = (cols / 2).max(10); let cwd = self .active .and_then(|i| self.workspaces.get(i)) .and_then(|ws| ws.focused_runtime()) .and_then(|rt| rt.cwd()); if let Some(ws) = self.active.and_then(|i| self.workspaces.get_mut(i)) { if let Ok(new_id) = ws.split_focused(direction, new_rows, new_cols, cwd) { ws.layout.focus_pane(new_id); self.mode = Mode::Terminal; } } } } #[cfg(test)] mod tests { use super::*; use crate::workspace::Workspace; use crossterm::event::KeyModifiers; fn state_with_workspaces(names: &[&str]) -> AppState { let mut state = AppState::test_new(); state.workspaces = names.iter().map(|name| Workspace::test_new(name)).collect(); if !state.workspaces.is_empty() { state.active = Some(0); state.selected = 0; state.mode = Mode::Navigate; } state } #[test] fn custom_rename_key_enters_rename_mode() { let mut state = state_with_workspaces(&["test"]); state.keybinds.rename_workspace = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.rename_workspace_label = "g".into(); handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert_eq!(state.mode, Mode::RenameSession); assert_eq!(state.name_input, "test"); } #[test] fn custom_new_workspace_key_requests_and_exits_navigate() { let mut state = state_with_workspaces(&["test"]); state.keybinds.new_workspace = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.new_workspace_label = "g".into(); handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert!(state.request_new_workspace); assert_eq!(state.mode, Mode::Terminal); } #[test] fn custom_sidebar_toggle_key_toggles_and_exits_navigate() { let mut state = state_with_workspaces(&["test"]); state.keybinds.toggle_sidebar = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.toggle_sidebar_label = "g".into(); assert!(!state.sidebar_collapsed); handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert!(state.sidebar_collapsed); assert_eq!(state.mode, Mode::Terminal); } #[test] fn custom_resize_key_enters_resize_mode() { let mut state = state_with_workspaces(&["test"]); state.keybinds.resize_mode = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.resize_mode_label = "g".into(); handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert_eq!(state.mode, Mode::Resize); } #[test] fn movement_action_stays_in_navigate_mode() { let mut state = state_with_workspaces(&["a", "b"]); state.selected = 0; handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Down, KeyModifiers::empty()), ); assert_eq!(state.selected, 1); assert_eq!(state.mode, Mode::Navigate); } #[test] fn fullscreen_action_exits_navigate_mode() { let mut state = state_with_workspaces(&["test"]); state.workspaces[0].test_split(Direction::Horizontal); state.keybinds.fullscreen = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.fullscreen_label = "g".into(); handle_navigate_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert!(state.workspaces[0].zoomed); assert_eq!(state.mode, Mode::Terminal); } #[test] fn custom_resize_key_exits_resize_mode() { let mut state = state_with_workspaces(&["test"]); state.mode = Mode::Resize; state.keybinds.resize_mode = (KeyCode::Char('g'), KeyModifiers::empty()); state.keybinds.resize_mode_label = "g".into(); handle_resize_key( &mut state, KeyEvent::new(KeyCode::Char('g'), KeyModifiers::empty()), ); assert_eq!(state.mode, Mode::Terminal); } }