Struct MultiCursorState 

pub struct MultiCursorState {
    pub selections: Vec<IdentifiedSelection>,
    pub node_id: DomNodeId,
    pub contenteditable_key: u64,
}

Multi-cursor state for a contenteditable element (Sublime Text style).

Replaces the split CursorManager + SelectionManager pattern for text editing. Supports multiple simultaneous cursors/selections, each with a stable ID.

Invariants

• selections is sorted by position and non-overlapping.
• The primary selection is the last one added (highest index).
• After any mutation, merge_overlapping() is called to maintain invariants.

Fields

selections: Vec<IdentifiedSelection>

Sorted by position, non-overlapping. Primary = last added (highest index).

node_id: DomNodeId

The DOM node this multi-cursor state applies to.

contenteditable_key: u64

Stable key that survives DOM rebuilds (from calculate_contenteditable_key).

Implementations

impl MultiCursorState

pub fn new_with_cursor( cursor: TextCursor, node_id: DomNodeId, contenteditable_key: u64, ) -> Self

Create a new MultiCursorState with a single cursor.

pub fn add_cursor(&mut self, cursor: TextCursor) -> SelectionId

Add a cursor, merging if it overlaps with existing selections. Returns the SelectionId of the new (or merged) cursor.

pub fn add_selection(&mut self, range: SelectionRange) -> SelectionId

Add a selection range, merging if it overlaps. Returns the SelectionId of the new (or merged) selection.

pub fn remove_selection(&mut self, id: SelectionId) -> bool

Remove a selection by its stable ID. Returns true if found and removed.

pub fn get_primary(&self) -> Option<&IdentifiedSelection>

Get the primary selection (last added = highest index).

pub fn get_primary_mut(&mut self) -> Option<&mut IdentifiedSelection>

Get a mutable reference to the primary selection.

pub fn get_primary_cursor(&self) -> Option<TextCursor>

Get the primary cursor position (for scroll-into-view, IME, etc.)

pub fn to_selections(&self) -> Vec<Selection>

Convert to a Vec for passing to edit_text().

pub fn update_from_edit_result(&mut self, new_selections: &[Selection])

Update selections from the result of edit_text().

Preserves existing IDs where possible (by index), assigns new IDs for extras.

pub fn set_single_cursor(&mut self, cursor: TextCursor)

Set all selections to a single cursor (e.g., on plain click without Ctrl).

pub fn set_single_range(&mut self, range: SelectionRange)

Set all selections to a single range.

pub fn len(&self) -> usize

Number of active cursors/selections.

pub fn is_empty(&self) -> bool

Whether there are no selections (should not normally happen).

pub fn merge_overlapping(&mut self)

Sort selections by position and merge any that overlap.

pub fn move_all_cursors( &mut self, extend_selection: bool, move_fn: impl Fn(&TextCursor) -> TextCursor, )

Move all cursors using a movement function. Merges collisions afterward.

move_fn takes a TextCursor and returns the new TextCursor after movement. If extend_selection is true, the anchor stays and only the focus moves, creating or extending a range.

pub fn remap_node_ids( &mut self, dom_id: DomId, node_id_map: &BTreeMap<NodeId, NodeId>, )

Remap the NodeId in node_id after DOM reconciliation.

If the node was removed (not in the map), the multi-cursor state is cleared.

Trait Implementations

impl Clone for MultiCursorState

fn clone(&self) -> MultiCursorState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MultiCursorState

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

Formats the value using the given formatter.

impl PartialEq for MultiCursorState

fn eq(&self, other: &MultiCursorState) -> 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 StructuralPartialEq for MultiCursorState