Struct OverlayManager 

pub struct OverlayManager { /* private fields */ }

Manages overlays for a buffer Overlays are sorted by priority for efficient rendering

Implementations

impl OverlayManager

pub fn new() -> Self

Create a new empty overlay manager

pub fn add(&mut self, overlay: Overlay) -> OverlayHandle

Add an overlay and return its handle for later removal

pub fn remove_by_handle( &mut self, handle: &OverlayHandle, marker_list: &mut MarkerList, ) -> bool

Remove an overlay by its handle

pub fn clear_namespace( &mut self, namespace: &OverlayNamespace, marker_list: &mut MarkerList, )

Remove all overlays in a namespace

pub fn replace_range_in_namespace( &mut self, namespace: &OverlayNamespace, range: &Range<usize>, new_overlays: Vec<Overlay>, marker_list: &mut MarkerList, )

Replace overlays in a namespace that overlap a range with new overlays.

This preserves overlays outside the range, which helps avoid flicker and unnecessary marker churn during viewport-only updates.

pub fn remove_in_range( &mut self, range: &Range<usize>, marker_list: &mut MarkerList, )

Remove all overlays in a range and clean up their markers

pub fn clear(&mut self, marker_list: &mut MarkerList)

Clear all overlays and their markers

pub fn at_position( &self, position: usize, marker_list: &MarkerList, ) -> Vec<&Overlay>

Get all overlays at a specific position, sorted by priority

pub fn in_range( &self, range: &Range<usize>, marker_list: &MarkerList, ) -> Vec<&Overlay>

Get all overlays that overlap with a range, sorted by priority

pub fn query_viewport( &self, start: usize, end: usize, marker_list: &MarkerList, ) -> Vec<(&Overlay, Range<usize>)>

Query overlays in a viewport range efficiently using the marker interval tree

This is much faster than calling at_position() for every character in the range. Returns overlays with their resolved byte ranges.

Performance

• Old approach: O(N * M) where N = positions to check, M = overlay count
• This approach: O(log M + k) where k = overlays in viewport (typically 2-10)

pub fn get_by_handle(&self, handle: &OverlayHandle) -> Option<&Overlay>

Get overlay by handle

pub fn get_by_handle_mut( &mut self, handle: &OverlayHandle, ) -> Option<&mut Overlay>

Get mutable overlay by handle

pub fn len(&self) -> usize

Get total number of overlays

pub fn is_empty(&self) -> bool

Check if there are any overlays

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

Get all overlays (for rendering)

Trait Implementations

impl Clone for OverlayManager

fn clone(&self) -> OverlayManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OverlayManager

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

Formats the value using the given formatter.

impl Default for OverlayManager

fn default() -> Self

Returns the “default value” for a type.