Struct IncrementalEditSet 

pub struct IncrementalEditSet {
    pub edits: Vec<IncrementalEdit>,
}

Collection of incremental edits

Fields

edits: Vec<IncrementalEdit>

Implementations

impl IncrementalEditSet

pub fn new() -> Self

Create a new empty edit set

pub fn add(&mut self, edit: IncrementalEdit)

Add an edit to the set

pub fn normalize_and_validate( &mut self, allow_overlaps: bool, filter_no_ops: bool, ) -> Result<(), IncrementalEditBatchError>

Normalize edit ordering for deterministic reverse-application and validate batch shape.

Normalization behavior:

• removes obvious no-op edits when filter_no_ops is true
• sorts edits in deterministic reverse-application order (highest byte offset first)

Validation behavior:

• rejects backward ranges (start_byte > old_end_byte)
• rejects overlaps after normalization unless allow_overlaps is true

pub fn sort(&mut self)

Sort edits by position (for correct application order)

pub fn sort_reverse(&mut self)

Sort edits in reverse order (for applying from end to start)

pub fn sort_reverse_deterministic(&mut self)

Sort edits in a deterministic reverse-application order.

This keeps behavior stable even when multiple edits share a start byte.

pub fn is_empty(&self) -> bool

Check if the edit set is empty

pub fn total_byte_shift(&self) -> isize

Get the total byte shift for all edits

pub fn apply_to_string(&self, source: &str) -> String

Apply edits to a string using deterministic fallback semantics.

This is intentionally more tolerant than Self::normalize_for_source: the incremental fast path rejects overlapping or unmappable batches, while this fallback applies every edit that still maps safely in reverse byte order and skips edits that cannot be applied without panicking.

pub fn normalize_for_source(&self, source: &str) -> Option<Vec<IncrementalEdit>>

Validate and normalize edits for deterministic reverse-order application.

Returns None when any edit is not safely mappable for the given source (backwards range, out-of-bounds range, or non-UTF-8 boundaries), or when non-empty ranges overlap.

Trait Implementations

impl Clone for IncrementalEditSet

fn clone(&self) -> IncrementalEditSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IncrementalEditSet

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

Formats the value using the given formatter.

impl Default for IncrementalEditSet

fn default() -> IncrementalEditSet

Returns the “default value” for a type.