Struct TreeSitterProcessor 

pub struct TreeSitterProcessor { /* private fields */ }

An incremental Tree-sitter based document processor.

This processor tracks a parse tree and updates it based on TextDelta edits when available. It then produces highlighting and folding edits in editor-core’s derived-state format.

Implementations

impl TreeSitterProcessor

pub fn new(config: TreeSitterProcessorConfig) -> Result<Self, TreeSitterError>

Create a new processor from the given config.

pub fn last_update_mode(&self) -> TreeSitterUpdateMode

Get the last update mode (useful for tests and instrumentation).

pub fn expand_selection_syntax( &self, start: usize, end: usize, ) -> Option<(usize, usize)>

Expand a (start, end) selection to the next enclosing syntax node.

Returns None if the processor has no parsed tree yet (call process()/sync_to() first), or if the selection is already at the root node.

Notes:

• Offsets are Unicode scalar indices (Rust char offsets), matching editor-core APIs.
• The returned range is best-effort and is based on Tree-sitter node byte ranges mapped through the processor’s internal LineIndex.

impl TreeSitterProcessor

pub fn sync_to( &mut self, version: u64, delta: Option<&TextDelta>, full_text: Option<&str>, ) -> Result<TreeSitterUpdateMode, TreeSitterError>

Synchronize the processor’s internal text/tree to the given version.

This updates the parse tree (incrementally when possible), but does not run any Tree-sitter queries. Call Self::compute_processing_edits afterwards to produce editor-core derived-state edits (highlighting + folding).

Notes:

• If full_text is None and a full resync is required, this returns TreeSitterError::DeltaMismatch.

pub fn compute_processing_edits( &mut self, char_range: Option<(usize, usize)>, ) -> Result<Vec<ProcessingEdit>, TreeSitterError>

Compute highlighting/folding edits from the current synchronized parse tree.

• char_range can be used to limit Tree-sitter query execution to a subset of the document (useful as a performance degradation mode for huge files).

Notes:

• When char_range is specified, the returned style intervals and fold regions will be partial (only within the range). Consumers that replace whole layers/regions should treat this as a “best effort visible range” optimization.

pub fn process_text( &mut self, version: u64, delta: Option<&TextDelta>, full_text: Option<&str>, ) -> Result<Vec<ProcessingEdit>, TreeSitterError>

Process a document snapshot represented as:

• a monotonically increasing version,
• an optional TextDelta describing the change from the previous version,
• an optional full_text for (re-)synchronization.

This method is useful for running Tree-sitter processing on a background thread where a full EditorStateManager is not available. Callers can pass full_text only when performing an initial parse or when a delta mismatch requires a full re-sync.

Notes:

• If full_text is None and a full sync is required, this returns TreeSitterError::DeltaMismatch.

Trait Implementations

impl DocumentProcessor for TreeSitterProcessor

type Error = TreeSitterError

The error type returned by DocumentProcessor::process.

fn process( &mut self, state: &EditorStateManager, ) -> Result<Vec<ProcessingEdit>, Self::Error>

Compute derived state updates to apply to the editor.