Interface LanguageParser

atomic-semantic/src/parsers/mod.rs:184–217

Trait for language-specific AST entity extraction. Each language parser implements this trait, providing entity extraction (functions, classes, interfaces, etc.) and optionally reference extraction (function calls, variable usages). # Implementation Notes - Parsers are **stateful** (they hold a `tree_sitter::Parser` instance). Create one per thread or per request, not globally. - `extract()` sh

/// - Entity names should be the *simple* name (e.g., `greet`, not `module.greet`).
/// - Line numbers are 1-based (matching editor conventions).
pub trait LanguageParser: Send {
    /// The language this parser handles.
    fn language(&self) -> Language;

    /// Extract AST entities (functions, classes, etc.) from source code.
    ///
    /// # Arguments
    ///
    /// * `source` - The source code text.
    /// * `file_path` - The file path (for Entity.file field).
    ///
    /// # Returns
    ///
    /// A list of entities found in the source code.
    fn extract(&mut self, source: &str, file_path: &str) -> Vec<Entity>;

    /// Extract references (function calls, variable usages) from source code.
    ///
    /// The default implementation returns an empty list. Languages that
    /// support reference extraction should override this.
    ///
    /// # Arguments
    ///
    /// * `source` - The source code text.
    /// * `file_path` - The file path (for Reference.file field).
    ///
    /// # Returns
    ///
    /// A list of references found in the source code.
    fn extract_references(&mut self, source: &str, file_path: &str) -> Vec<Reference> {
        let _ = (source, file_path);
        Vec::new()
    }
}

// ═══════════════════════════════════════════════════════════════════════
// ParserRegistry — unified entry point for all languages