Struct SymbolReference 

pub struct SymbolReference {
    pub name: String,
    pub kind: SymbolKind,
    pub location: SourceLocation,
    pub scope_id: ScopeId,
    pub is_write: bool,
}

A reference to a symbol with usage context for LSP analysis.

Tracks symbol usage sites for features like find-all-references, rename refactoring, and unused symbol detection with precise scope and context information.

Performance Characteristics

• Memory: ~64 bytes per reference
• Collection: O(n) during AST traversal
• Query time: O(log n) with spatial indexing

LSP Integration

Essential for:

• Find references: Locate all usage sites
• Rename refactoring: Update all references atomically
• Unused detection: Identify unreferenced symbols
• Call hierarchy: Build caller/callee relationships

Fields

name: String

Symbol name (without sigil for variables)

kind: SymbolKind

Symbol type inferred from usage context

location: SourceLocation

Source location of the reference

scope_id: ScopeId

Lexical scope where reference occurs

is_write: bool

Whether this is a write reference (assignment)

Trait Implementations

impl Clone for SymbolReference

fn clone(&self) -> SymbolReference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SymbolReference

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

Formats the value using the given formatter.