Struct ParsedDocument 

pub struct ParsedDocument<D: Doc> {
    pub ast_root: Root<D>,
    pub file_path: PathBuf,
    pub language: SupportLang,
    pub content_fingerprint: Fingerprint,
    pub metadata: DocumentMetadata,
    /* private fields */
}

A parsed document that wraps ast-grep Root with additional codebase-level metadata.

This type preserves all ast-grep functionality while adding context needed for cross-file analysis and graph intelligence. It acts as the bridge between file-level AST operations and codebase-level relational analysis.

Fields

ast_root: Root<D>

The underlying ast-grep Root - preserves all ast-grep functionality

file_path: PathBuf

Source file path for this document

language: SupportLang

Language of this document

content_fingerprint: Fingerprint

Content fingerprint for deduplication and change detection (blake3 hash)

metadata: DocumentMetadata

Codebase-level metadata (symbols, imports, exports, etc.)

Implementations

impl<D: Doc> ParsedDocument<D>

pub fn new( ast_root: Root<D>, file_path: PathBuf, language: SupportLang, content_fingerprint: Fingerprint, ) -> Self

Create a new ParsedDocument wrapping an ast-grep Root

pub fn root(&self) -> Node<'_, D>

Get the root node - preserves ast-grep API

pub fn ast_grep_root(&self) -> &Root<D>

Get the underlying ast-grep Root for full access to capabilities

pub fn ast_grep_root_mut(&mut self) -> &mut Root<D>

Get mutable access to ast-grep Root for replacements

pub fn pin_for_threading(&self) -> PinnedNodeResult<D>

Create a pinned version for cross-thread/FFI usage

pub fn generate(&self) -> String

Generate the source code (preserves ast-grep replacement functionality)

pub fn metadata(&self) -> &DocumentMetadata

Get document metadata for codebase-level analysis

pub fn metadata_mut(&mut self) -> &mut DocumentMetadata

Get mutable document metadata

Trait Implementations

impl<D: Debug + Doc> Debug for ParsedDocument<D>

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

Formats the value using the given formatter.