Struct PositionHistory 

pub struct PositionHistory { /* private fields */ }

Position history manager

This tracks navigation history across the editor, storing positions the user has visited. It maintains a stack with a current index, allowing back/forward navigation.

Movements are coalesced: consecutive MoveCursor events within a short time period are treated as a single “jump” for navigation purposes.

Implementations

impl PositionHistory

pub fn new() -> Self

Create a new position history with default max entries (100)

pub fn with_capacity(max_entries: usize) -> Self

Create a new position history with specified max entries

pub fn record_movement( &mut self, buffer_id: BufferId, position: usize, anchor: Option<usize>, )

Record a cursor movement event

This is called for EVERY MoveCursor event. Consecutive small movements are coalesced into a single history entry. The movement is committed to history when:

• Buffer changes
• Large jump detected (> 50 bytes distance from pending start position)
• User triggers back/forward navigation

pub fn commit_pending_movement(&mut self)

Commit any pending movement to history

This is called when:

• Switching buffers
• Before navigating back/forward

pub fn push(&mut self, entry: PositionEntry)

Push a new position to the history

This is called when the user makes a significant navigation:

• Switching buffers
• Large cursor movements (e.g., search, go-to-definition)
• Opening a file

If we’re not at the end of history (user has gone back), this truncates the forward history and adds the new position.

pub fn back(&mut self) -> Option<&PositionEntry>

Navigate back in history

Commits any pending movement first, then returns the previous position. Returns None if we’re at the beginning of history.

pub fn forward(&mut self) -> Option<&PositionEntry>

Navigate forward in history

Returns the next position, or None if we’re at the end of history.

pub fn can_go_back(&self) -> bool

Check if we can go back

pub fn can_go_forward(&self) -> bool

Check if we can go forward

pub fn current(&self) -> Option<&PositionEntry>

Get the current position entry

pub fn clear(&mut self)

Clear all history

pub fn len(&self) -> usize

Get the number of entries in history

pub fn is_empty(&self) -> bool

Check if history is empty

pub fn current_index(&self) -> Option<usize>

Get current index (for debugging)

Trait Implementations

impl Default for PositionHistory

fn default() -> Self

Returns the “default value” for a type.