Struct SourceDocument 

pub struct SourceDocument { /* private fields */ }

A source document retained independently from canonical semantic nodes.

Whitespace and other non-comment trivia remain in Self::text. Comments are indexed as a convenience for stable span-based attachment; callers should use SourceEdit for local changes and reparse the edited text to obtain updated semantic spans.

Implementations

impl SourceDocument

pub fn new(text: impl Into<String>) -> Self

Retain source text and index supported line comments (// ...).

pub fn text(&self) -> &str

The exact authored source text.

pub fn comments(&self) -> Iter<'_, SourceComment>

All indexed comments in authored source order.

pub fn comments_for(&self, span: Span) -> impl Iterator<Item = &SourceComment>

Comments whose complete source range is inside a semantic span.

This is the attachment rule for the supported slice. Comments outside a node span remain document-level preserved source and are never guessed into a neighboring node.

pub fn byte_range(&self, span: Span) -> Option<Range<usize>>

Convert a line/column span into a UTF-8 byte range in this document.

pub fn edit( &self, range: Range<usize>, replacement: impl Into<String>, ) -> Result<SourceEdit, SourceEditError>

Create a checked replacement for a UTF-8 byte range.

pub fn edit_span( &self, span: Span, replacement: impl Into<String>, ) -> Result<SourceEdit, SourceEditError>

Create a checked replacement for a semantic span.

pub fn apply(&self, edits: &[SourceEdit]) -> Result<Self, SourceEditError>

Apply non-overlapping edits against this exact document.

Trait Implementations

impl Clone for SourceDocument

fn clone(&self) -> SourceDocument

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceDocument

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

Formats the value using the given formatter.

impl Eq for SourceDocument

impl PartialEq for SourceDocument

fn eq(&self, other: &SourceDocument) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SourceDocument