Enum FocusMode 

#[repr(u8)]
pub enum FocusMode {
    Foreground = 0,
    Background = 1,
}

How a native-input action delivers its event relative to app focus.

Foreground is the historical CEL behavior: the dispatcher brings the target app to the front (activate_app / ensure_target_app_focus) and then posts a session-wide CGEvent at whatever is frontmost. Robust, but it steals the user’s focus and is the root cause of the focus-sensitive hybrid-suite constraint.

Background posts the event directly to the target process via CGEventPostToPid without activating it (see cel_input::background), so the user’s active window keeps focus. Not every macOS app honors background-delivered events, so the dispatcher falls back to Foreground when no target PID resolves or the background post is rejected.

Defaults to Foreground so existing plans and serialized payloads are unchanged. WS1 of the Peekaboo-parity plan.

Variants

Foreground = 0

Activate the target app, then post input. Steals focus. Default.

Background = 1

Post input to the target PID without activating it. Non-focus-stealing.

Trait Implementations

impl Clone for FocusMode

fn clone(&self) -> FocusMode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for FocusMode

impl Debug for FocusMode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FocusMode

fn default() -> FocusMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FocusMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FocusMode

impl PartialEq for FocusMode

fn eq(&self, other: &FocusMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for FocusMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FocusMode