Struct CursorPosition 

pub struct CursorPosition {
    pub row: usize,
    pub col: usize,
}

Represents the current cursor coordinates in the active Window.

Row is 1-based (Nvim convention) and column is 0-based (byte index inside the line per Nvim API). These are kept verbatim to avoid off-by-one bugs. Call sites converting to Rust slice indices subtract 1 from row as needed.

Assumptions

• Constructed through CursorPosition::get_current; manual construction should respect coordinate conventions.

Rationale

Preserving raw Nvim values centralizes conversion logic at usage points (e.g. buffer line indexing) instead of embedding heuristics here.

Fields

row: usize

col: usize

Implementations

impl CursorPosition

pub fn get_current() -> Option<Self>

Obtains the current cursor position from the active Window.

Queries Nvim for the (row, col) of the active window cursor and returns a CursorPosition reflecting those raw coordinates.

Assumptions

• Row is 1-based (Nvim convention); column is 0-based. Callers needing 0-based row for Rust indexing must subtract 1 explicitly.
• The active window is the intended source of truth for cursor location.

Rationale

Returning Option (instead of Result) simplifies common call sites that treat absence as a soft failure (e.g. skipping an insertion). Detailed error context is still surfaced to the user through notify_error.

pub const fn adjusted_col(&self) -> usize

Returns 1-based column index for rendering purposes.

Converts the raw 0-based Nvim column stored in CursorPosition::col into a human-friendly 1-based column suitable for statusline / UI output.

Assumptions

• CursorPosition::col is the unmodified 0-based byte offset provided by Nvim.

Rationale

Nvim exposes a 0-based column while rows are 1-based. Normalizing to 1-based for display avoids mixed-base confusion in user-facing components (e.g. status line) and clarifies intent at call sites.

Performance

Constant time. Uses saturating_add defensively (overflow is unrealistic given line length).

Trait Implementations

impl Debug for CursorPosition

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

Formats the value using the given formatter.

impl From<CursorPosition> for PointWrap

fn from(cursor_position: CursorPosition) -> Self

Converts a Nvim cursor position (1-based row, 0-based column) to a PointWrap.