Struct NvimBackend 

pub struct NvimBackend { /* private fields */ }

Implementations

impl NvimBackend

pub fn snapshot(&self) -> MutexGuard<'_, NvimSnapshot>

Locked view of the mirrored nvim state (cursor, lines, mode, dirty…). Poison-recovering: a panicked refresh task never wedges the UI.

pub fn is_dead(&self) -> bool

Whether the nvim process / IO loop has died (the host falls back to the textarea backend when it has).

pub fn mark_clean(&self)

Clear the mirrored dirty flag — the buffer was just persisted.

pub fn new(nvim_path: Option<&PathBuf>) -> Result<Self, String>

pub fn set_text(&self, text: &str)

Load content into the nvim buffer and pre-populate the snapshot.

Contract: the synchronous snapshot pre-populate (lines + cursor + dirty=false + content_gen bump) happens BEFORE in_flight is set and the buf_set_lines RPC is spawned. A keystroke arriving between the synchronous return of set_text and the spawned task actually reaching nvim ends up routed via handle_key, and the refresh task will skip snapshot updates while in_flight=true (see apply_lua_state). Once the spawned RPC completes and in_flight flips back to false, the refresh task will observe whatever buffer state nvim has — including both the loaded content AND any keys the user pressed in the interim. snap.lines != new_lines will then re-set dirty=true. The window where dirty=false after a concurrent keystroke is bounded by one refresh cycle (~30 ms). Do NOT move the in_flight.store(true) earlier or clear it before the RPC actually completes — both invariants are load-bearing.

pub fn maybe_resize(&self, width: u16, height: u16)

Notify nvim of a terminal resize, but only when the dimensions actually change.

pub fn paste(&self, text: &str, tx: AppTx)

Insert text at nvim’s current cursor position via nvim_paste. Honours nvim’s current mode (insert/normal/visual) — visual replaces the selection, normal/insert insert at cursor — so it works as a drop-in for the textarea backend’s insert/replace flow.

pub fn handle_key(&self, key: &KeyEvent, tx: AppTx)

Forward a keystroke to nvim.

Trait Implementations

impl Drop for NvimBackend

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.