Struct BuffrHost 

pub struct BuffrHost {
    pub last_cursor_shape: CursorShape,
    /* private fields */
}

Host adapter consumed by hjkl_engine::Editor once edit-mode is active.

Fields

last_cursor_shape: CursorShape

Last cursor shape requested by the engine. Drained by the host renderer per frame.

Implementations

impl BuffrHost

pub fn new() -> Self

pub fn set_viewport_size(&mut self, width: u16, height: u16)

Publish the current canvas size into the viewport. Called from the host’s resize event handler (winit WindowEvent::Resized in apps/buffr). width / height are in cells, not pixels — buffr will divide pixel dimensions by font metrics before calling this once edit-mode rendering lands.

Currently unwired: buffr’s main loop drives CEF + softbuffer chrome and doesn’t yet route resizes into edit-mode. When the edit-mode overlay is plumbed, hook this in.

pub fn set_clipboard_cache(&mut self, text: Option<String>)

Update the cached clipboard. Host calls this on focus events or when an OSC52 read reply arrives.

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

Drain pending clipboard writes. Host’s tick loop calls this and dispatches each to the platform clipboard backend.

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

Drain queued intents. Host calls this once per render frame.

Trait Implementations

impl Debug for BuffrHost

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

Formats the value using the given formatter.

impl Default for BuffrHost

fn default() -> Self

Returns the “default value” for a type.

impl Host for BuffrHost

type Intent = BuffrEditIntent

Custom intent type. Hosts that don’t fan out actions back to themselves can use the unit type via the default impl approach (set associated type explicitly).

fn write_clipboard(&mut self, text: String)

Fire-and-forget clipboard write. Engine never blocks; the host queues internally and flushes on its own task (OSC52, wl-copy, pbcopy, …).

fn read_clipboard(&mut self) -> Option<String>

Returns the last-known cached clipboard value. May be stale — matches the OSC52/wl-paste model neovim and helix both ship.

fn now(&self) -> Duration

Monotonic time. Multi-key timeout (timeoutlen) resolution reads this; engine never reads Instant::now() directly so macro replay stays deterministic.

fn prompt_search(&mut self) -> Option<String>

Synchronously prompt the user for a search pattern. Returning None aborts the search.

fn emit_cursor_shape(&mut self, shape: CursorShape)

Engine emits this on every mode transition. Hosts repaint the cursor in the requested shape.

fn emit_intent(&mut self, intent: Self::Intent)

Host-defined event the engine raises (LSP request, fold op, buffer switch, …).

fn viewport(&self) -> &Viewport

Borrow the host’s viewport. The host writes width/height/ text_width/wrap per render frame; the engine reads/writes top_row / top_col to scroll. 0.0.34 (Patch C-δ.1) moved this off hjkl_buffer::Buffer onto Host.

fn viewport_mut(&mut self) -> &mut Viewport

Mutable viewport access. Engine motion + scroll code routes here when scrolloff math advances top_row.

fn should_cancel(&self) -> bool

Cooperative cancellation. Engine polls during long search / regex / multi-cursor edit loops. Default returns false.

fn display_line_for(&self, pos: Pos) -> u32

Map a logical position to its display line for gj/gk. Hosts without wrapping may use the default identity impl.

fn pos_for_display(&self, line: u32, col: u32) -> Pos

Inverse of [display_line_for]. Default identity.

fn syntax_highlights(&self, range: Range<Pos>) -> Vec<Highlight>

Host-supplied syntax highlights for range. Empty by default; hosts wire tree-sitter or LSP semantic tokens here.