Struct ScopeEngine 

pub struct ScopeEngine<'a> { /* private fields */ }

Scope analysis engine backed by tree-sitter locals queries.

Requires locals.scm query files to be present in the grammar search paths (copied there by cargo xtask build-grammars).

Implementations

impl<'a> ScopeEngine<'a>

pub fn new(loader: &'a GrammarLoader) -> Self

pub fn has_locals(&self, lang: &str) -> bool

Returns true if locals.scm is available for this language.

pub fn find_definitions( &self, lang: &str, source: &str, name: &str, ) -> Vec<Definition>

Find all definitions of name in source.

pub fn find_references( &self, lang: &str, source: &str, name: &str, ) -> Vec<Reference>

Find all references to name in source, with definition resolution.

Returns both definition sites and reference sites that resolve to any definition of name in this file.

pub fn all_definitions(&self, lang: &str, source: &str) -> Vec<Definition>

Get all definitions in source.

pub fn find_unused_parameters( &self, lang: &str, source: &str, ) -> Vec<Definition>

Find parameters that are never referenced in their enclosing function body.

Returns definitions whose kind is "parameter" and whose name has no resolved reference in the same file. Underscore-prefixed names (_, _foo) are excluded — those are the conventional way to mark intentionally unused parameters in most languages.

Requires @local.definition.parameter captures in the language’s locals.scm. Languages without that capture produce an empty result.