Struct EditSession 

pub struct EditSession { /* private fields */ }

One active edit-mode session bound to a single text field.

Owns the engine Editor generic over BuffrHost. The host (clipboard / time / intent fan-out) lives inside the editor as of hjkl 0.1.0 — Editor<hjkl_buffer::Buffer, BuffrHost>. Pull-model: per render frame the host calls EditSession::take_content_change and forwards any new content to the DOM.

Implementations

impl EditSession

pub fn new(initial: &str) -> Self

Boot the session with the field’s current value.

pub fn handle_key(&mut self, key: KeyEvent) -> bool

Feed one keystroke. Returns true when the keystroke was consumed by the engine; false means the caller should let the page see it (<Esc> in normal mode, etc.).

pub fn feed_planned(&mut self, input: PlannedInput) -> bool

Feed a hjkl_engine::PlannedInput directly. Bypasses the crossterm conversion layer — used by the winit event path which constructs PlannedInput from winit’s KeyEvent directly so the two crates never need a shared crossterm version.

pub fn type_char(&mut self, ch: char) -> bool

Convenience: type a literal character with no modifiers. Used by tests and by the JS bridge when forwarding plain printable keys.

pub fn press(&mut self, code: KeyCode) -> bool

Convenience: send a special key (Esc, Enter, etc.) with no modifiers.

pub fn type_str(&mut self, s: &str)

Type a string in insert mode. Caller must already have entered insert mode (type_char('i')); panics if asked to type while not in insert.

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

Pull-model change drain. Returns the new content if anything changed since the last call; None if nothing did. Host forwards Some to the DOM.

pub fn content(&self) -> String

Current full content. Useful for first-frame rendering.

pub fn vim_mode(&self) -> VimMode

Mode for the status-line summary.

pub fn drain_clipboard_outbox(&mut self) -> Vec<String>

Drain queued clipboard writes the engine has accumulated. Host’s tick loop dispatches each to CEF.

pub fn drain_intents(&mut self) -> Vec<BuffrEditIntent>

Drain queued intents (RequestAutocomplete, SwitchBuffer, etc.). Host fans each out to its CEF / browser-action layer.

pub fn host_mut(&mut self) -> &mut BuffrHost

Mutable access to the host. Production callers reach for this to refresh the clipboard cache on focus events / OSC52 reply.