Struct InputHandler 

pub struct InputHandler {
    pub modifiers: Modifiers,
    pub left_option_key_mode: OptionKeyMode,
    pub right_option_key_mode: OptionKeyMode,
    /* private fields */
}

Input handler for converting winit events to terminal input

Fields

modifiers: Modifiers

left_option_key_mode: OptionKeyMode

Option key mode for left Option/Alt key

right_option_key_mode: OptionKeyMode

Option key mode for right Option/Alt key

Implementations

impl InputHandler

pub fn new() -> Self

Create a new input handler

pub fn update_modifiers(&mut self, modifiers: Modifiers)

Update the current modifier state

pub fn update_option_key_modes( &mut self, left: OptionKeyMode, right: OptionKeyMode, )

Update Option/Alt key modes from config

pub fn track_alt_key(&mut self, event: &KeyEvent)

Track Alt key press/release to know which Alt is active

pub fn sync_modifier_from_key_event(&mut self, event: &KeyEvent)

Defensive modifier-state sync from physical key events.

On Windows, WM_NCACTIVATE(false) fires when a notification, popup, or system dialog briefly steals visual focus. Winit responds by emitting ModifiersChanged(empty), which clears our modifier state. Because keyboard focus is never actually lost, no WM_SETFOCUS fires to restore the state. Subsequent WM_KEYDOWN messages should re-trigger update_modifiers inside winit, but in practice there is a window where the state stays zeroed, causing Shift/Ctrl/Alt to stop working until the key is physically released and re-pressed.

To guard against this, we synthesize modifier updates directly from KeyboardInput events for physical modifier keys. This runs after ModifiersChanged has already been applied (winit guarantees ModifiersChanged fires before KeyboardInput for the same key), so it is a no-op in the normal path and only corrects state when winit’s ModifiersChanged is stale or missing.

pub fn handle_key_event(&mut self, event: KeyEvent) -> Option<Vec<u8>>

Convert a keyboard event to terminal input bytes

If modify_other_keys_mode is > 0, keys with modifiers will be reported using the XTerm modifyOtherKeys format: CSI 27 ; modifier ; keycode ~

pub fn handle_key_event_with_mode( &mut self, event: KeyEvent, modify_other_keys_mode: u8, application_cursor: bool, ) -> Option<Vec<u8>>

Convert a keyboard event to terminal input bytes with modifyOtherKeys support

modify_other_keys_mode:

• 0: Disabled (normal key handling)
• 1: Report modifiers for special keys only
• 2: Report modifiers for all keys

application_cursor: When true (DECCKM mode enabled), arrow keys send SS3 sequences (ESC O A) instead of CSI sequences (ESC [ A).

pub fn paste_from_clipboard(&mut self) -> Option<String>

Paste text from clipboard (returns raw text, caller handles terminal conversion)

pub fn clipboard_has_image(&mut self) -> bool

Check if clipboard contains an image (used when text paste returns None to determine if we should forward the paste event to the terminal for image-aware applications like Claude Code)

pub fn copy_to_clipboard(&mut self, text: &str) -> Result<(), String>

Copy text to clipboard

pub fn copy_to_primary_selection(&mut self, text: &str) -> Result<(), String>

Copy text to primary selection (Linux X11 only)

pub fn paste_from_primary_selection(&mut self) -> Option<String>

Paste text from primary selection (Linux X11 only, returns raw text)

Trait Implementations

impl Default for InputHandler

fn default() -> Self

Returns the “default value” for a type.