Struct EditorSnapshot 

pub struct EditorSnapshot<'a> {
    pub lines: Cow<'a, [String]>,
    pub cursor: (usize, usize),
    pub content_revision: NonZeroU64,
}

Atomic view of the editor’s (lines, cursor, content_revision) tuple at a single point in time. Producers (today TextEditorComponent::view_snapshot) own the construction-time invariant: the cursor’s row is in-bounds for lines. Consumers (view.rs, click_to_logical_u16, the autocomplete host, etc.) take a &EditorSnapshot<'_> and skip the per-leaf .get() guards that previously defended against drift between cursor and lines.

The Cow lets the Textarea backend borrow its lines directly (zero clone) while the Nvim backend clones out from behind its Mutex (the lines must outlive the MutexGuard, which is dropped before the snapshot is returned).

Fields

lines: Cow<'a, [String]>

cursor: (usize, usize)

(row, col) with row < lines.len() (clamped at construction when the producer’s source was stale) UNLESS lines.is_empty(), in which case the snapshot represents an empty buffer and cursor is (0, 0).

content_revision: NonZeroU64

Content identity at construction. Stable across cursor moves; bumps on real text changes only (see [[decouple-text-revision]]).

Implementations

impl<'a> EditorSnapshot<'a>

pub fn borrowed( lines: &'a [String], cursor: (usize, usize), content_revision: NonZeroU64, ) -> Self

Borrow-mode constructor for the Textarea backend and tests.

pub fn owned( lines: Vec<String>, cursor: (usize, usize), content_revision: NonZeroU64, ) -> EditorSnapshot<'static>

Owned-mode constructor for the Nvim backend (lines cloned out from behind the Mutex) and for tests that don’t have a long-lived borrow.

pub fn cursor_in_bounds(&self) -> bool

true when the cursor row is a valid index into lines. false only when lines is empty (in which case both row 0 and any other row are out of bounds).

pub fn cursor_row_clamped(&self) -> usize

Cursor row guaranteed in-bounds for lines. Returns 0 on an empty buffer (the only case where the producer cannot clamp to a valid index).

pub fn cursor_line(&self) -> &str

Cursor row’s logical line. Returns the empty slice when lines is empty.

pub fn cursor_byte_offset(&self) -> usize

Global byte offset of the cursor across lines.join("\n"). Mirrors autocomplete_glue::row_char_col_to_byte but consumes the snapshot directly so callers (e.g. the autocomplete controller) don’t need to depend on the editor’s glue module. Clamps the char column to the row’s char count, then returns the byte position of the char-column within the joined buffer.