Struct PreprocessedText 

pub struct PreprocessedText<'a> {
    pub text: Cow<'a, str>,
    pub original_end: usize,
    pub mappings: Vec<LineMapping>,
}

Result of preprocessing text for multi-line concatenation.

text is a [Cow] so the overwhelmingly common passthrough/identity case (a chunk with no structured-config shape and no multiline concatenation) can BORROW the caller’s chunk bytes with zero allocation instead of paying a full-body to_string() heap copy + memcpy on every chunk. Only the paths that genuinely synthesize NEW bytes — multiline-joined concatenation, structured-config key/value reassembly, homoglyph normalization — own a String via Cow::Owned. Downstream consumers read text as &str via Deref, so the borrow is internal to preprocessing.

Fields

text: Cow<'a, str>

Original text (borrowed for passthrough) plus, for the synthesizing paths, appended multiline-joined / structured segments (owned).

original_end: usize

Byte offset where appended joined segments start.

mappings: Vec<LineMapping>

Mapping from offsets in text to original line numbers.

Implementations

impl<'a> PreprocessedText<'a>

pub fn line_for_offset(&self, offset: usize) -> Option<usize>

Map a byte offset in preprocessed text back to an original line number.

Mappings are stored in start_offset-sorted, contiguous order (the preprocessor appends them as it walks the input), so a partition_point binary search resolves the lookup in O(log L) instead of the prior O(L) linear scan. On a 10 000-line file with ~100 matches that’s 10 000 × 100 = 1 M pointer compares cut to ~1 400.

pub fn passthrough(text: impl Into<Cow<'a, str>>) -> Self

Build a preprocessed representation with a one-line identity mapping.

Takes the text as a [Cow] so a byte-identical passthrough chunk can be carried as Cow::Borrowed (zero allocation — no heap alloc or memcpy of the chunk body) while a normalization-rewritten chunk passes its already- owned String through as Cow::Owned. Only the per-line mappings bookkeeping (size-independent of the body bytes) is allocated either way.

Trait Implementations

impl<'a> Clone for PreprocessedText<'a>

fn clone(&self) -> PreprocessedText<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for PreprocessedText<'a>

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

Formats the value using the given formatter.