Struct Options 

pub struct Options {

    pub tabstop: u32,
    pub shiftwidth: u32,
    pub expandtab: bool,
    pub softtabstop: u32,
    pub iskeyword: String,
    pub ignorecase: bool,
    pub smartcase: bool,
    pub hlsearch: bool,
    pub incsearch: bool,
    pub wrapscan: bool,
    pub autoindent: bool,
    pub smartindent: bool,
    pub timeout_len: Duration,
    pub undo_levels: u32,
    pub undo_break_on_motion: bool,
    pub readonly: bool,
    pub wrap: WrapMode,
    pub textwidth: u32,
    pub number: bool,
    pub relativenumber: bool,
    pub numberwidth: usize,
    pub cursorline: bool,
    pub cursorcolumn: bool,
    pub signcolumn: SignColumnMode,
    pub foldcolumn: u32,
    pub colorcolumn: String,
}

Editor settings surfaced via :set. Per SPEC. Consumed once trait extraction lands; today’s legacy Settings (in [crate::editor]) continues to drive runtime behaviour.

Fields

tabstop: u32

Display width of \t for column math + render. Default 8.

shiftwidth: u32

Spaces per shift step (>>, <<, Ctrl-T, Ctrl-D).

expandtab: bool

Insert spaces (true) or literal \t (false) for the Tab key.

softtabstop: u32

Soft tab stop in spaces. When > 0, the Tab key (with expandtab) inserts spaces to the next softtabstop boundary, and Backspace at the end of a softtabstop-aligned space run deletes the whole run. 0 disables softtabstop semantics. Matches vim’s :set softtabstop.

iskeyword: String

Characters considered part of a “word” for w/b/*/#. Default "@,48-57,_,192-255" (ASCII letters, digits, _, plus extended Latin); host may override per language.

ignorecase: bool

Default false: search is case-sensitive.

smartcase: bool

When true and ignorecase is true, an uppercase letter in the pattern flips back to case-sensitive for that search.

hlsearch: bool

Highlight all matches of the last search.

incsearch: bool

Incrementally highlight matches while typing the search pattern.

wrapscan: bool

Wrap searches around the buffer ends.

autoindent: bool

Copy previous line’s leading whitespace on Enter in insert mode.

smartindent: bool

When true, bump indent by one shiftwidth after a line ending in { / ( / [, and strip one indent unit when the user types the matching } / ) / ] on an otherwise-whitespace-only line. Supersedes autoindent’s plain copy when on. Future: a tree-sitter indents.scm provider will replace the heuristic; see compute_enter_indent in vim.rs for the plug-in point.

timeout_len: Duration

Multi-key sequence timeout (e.g., <C-w>v). Vim’s timeoutlen.

undo_levels: u32

Maximum undo-tree depth. Older entries pruned.

undo_break_on_motion: bool

Break the current undo group on cursor motion in insert mode. Matches vim default; turn off to merge multi-segment edits.

readonly: bool

Reject every edit. :set ro sets this; :w! clears it.

wrap: WrapMode

Soft-wrap behavior for lines that exceed the viewport width. Maps directly to :set wrap / :set linebreak / :set nowrap.

textwidth: u32

Wrap column for gq{motion} text reflow. Vim’s default is 79.

number: bool

Show absolute line numbers in the gutter. Matches :set number. Default true.

relativenumber: bool

Show relative line offsets in the gutter. Combined with number, enables hybrid mode. Matches :set relativenumber. Default false.

numberwidth: usize

Minimum gutter width in cells for the line-number column. Width grows past this to fit the largest displayed number. Matches vim’s :set numberwidth / :set nuw. Default 4. Range 1..=20.

cursorline: bool

Highlight the row where the cursor sits. Matches vim’s :set cursorline. Default true (hjkl diverges from vim’s false — improves visual orientation, matches most modern editor defaults).

cursorcolumn: bool

Highlight the column where the cursor sits. Matches vim’s :set cursorcolumn. Default false.

signcolumn: SignColumnMode

Whether to reserve a 1-cell sign column for diagnostics and git signs. Matches vim’s :set signcolumn. Default SignColumnMode::Auto.

foldcolumn: u32

Number of cells reserved for a fold-marker gutter (0 = none, max 12). Matches vim’s :set foldcolumn. Default 0.

colorcolumn: String

Comma-separated 1-based column indices for vertical rulers. Empty string = no rulers. Matches vim’s :set colorcolumn. Default "".

Implementations

impl Options

pub fn set_by_name( &mut self, name: &str, val: OptionValue, ) -> Result<(), EngineError>

Set an option by name. Vim-flavored option naming. Returns EngineError::Ex for unknown names or type-mismatched values.

Booleans accept OptionValue::Bool(_) directly or OptionValue::Int(0)/Int(non_zero). Integers accept only Int(_). Strings accept only String(_).

pub fn get_by_name(&self, name: &str) -> Option<OptionValue>

Read an option by name. None for unknown names.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.

impl Default for Options

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Options

fn eq(&self, other: &Options) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Options

impl StructuralPartialEq for Options