Struct SelectionSet 

pub struct SelectionSet { /* private fields */ }

A selection set. Always non-empty. Index primary points at the primary selection; in v1 the set has exactly one entry and primary == 0.

The fields are private so the invariant cannot be broken: every constructor yields at least one selection and an in-range primary, so Self::primary never panics.

Examples

use lattice_protocol::{Position, Selection, SelectionSet};

let mut set = SelectionSet::default(); // one cursor at the origin
assert_eq!(set.all().len(), 1);
assert_eq!(set.primary().head, Position::ZERO);

set.replace_primary(Selection::cursor(Position::new(3, 0)));
assert_eq!(set.primary().head.line, 3);

// Rebuilding from parts repairs what would break the invariant.
let repaired = SelectionSet::from_parts(vec![], 5);
assert_eq!(repaired, SelectionSet::cursor_at_origin());
let clamped = SelectionSet::from_parts(vec![Selection::cursor(Position::ZERO)], 5);
assert_eq!(clamped.primary_index(), 0);

Implementations

impl SelectionSet

pub fn single(selection: Selection) -> Self

A set holding just selection, which is primary.

pub fn cursor_at_origin() -> Self

One plain cursor at Position::ZERO — also the Default.

pub fn from_parts(selections: Vec<Selection>, primary: usize) -> Self

Reconstruct a set from its parts — the counterpart to Self::all + Self::primary_index, used to rebuild a SelectionSet that was projected into an owned form (e.g. the plugin-host WIT boundary). The non-empty invariant is preserved: an empty selections collapses to a single origin cursor, and primary is clamped into range.

pub fn primary(&self) -> &Selection

The primary selection — the one single-cursor code acts on.

pub fn primary_mut(&mut self) -> &mut Selection

Mutable access to the primary selection.

pub fn all(&self) -> &[Selection]

Every selection, in stored order (never empty).

pub fn primary_index(&self) -> usize

Index of the primary within Self::all.

pub fn replace_primary(&mut self, selection: Selection)

Overwrite the primary selection in place; the others are untouched.

Trait Implementations

impl Clone for SelectionSet

fn clone(&self) -> SelectionSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SelectionSet

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

Formats the value using the given formatter.

impl Default for SelectionSet

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SelectionSet

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SelectionSet

impl PartialEq for SelectionSet

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SelectionSet

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SelectionSet