Method find_references

src/references/mod.rs:47–111

Entry point for `textDocument/references`. Returns all locations where the symbol under the cursor is referenced. When `include_declaration` is true the declaration site itself is included in the results.

(
        &self,
        uri: &str,
        content: &str,
        position: Position,
        include_declaration: bool,
    )

    /// referenced.  When `include_declaration` is true the declaration
    /// site itself is included in the results.
    pub fn find_references(
        &self,
        uri: &str,
        content: &str,
        position: Position,
        include_declaration: bool,
    ) -> Option<Vec<Location>> {
        let start_total = std::time::Instant::now();
        tracing::info!(
            "Find References: starting at {} line {} char {}",
            uri,
            position.line,
            position.character
        );

        // Consult the precomputed symbol map for the current file
        // (retries one byte earlier for end-of-token edge cases).
        let symbol = self.lookup_symbol_at_position(uri, content, position);

        // When the cursor is on a symbol span, dispatch by kind.
        if let Some(ref sym) = symbol {
            tracing::info!(
                "Find References: found symbol kind {:?} at offset {}",
                sym.kind,
                sym.start
            );
            let locations = self.dispatch_symbol_references(
                &sym.kind,
                uri,
                content,
                sym.start,
                include_declaration,
            );
            tracing::info!(
                "Find References: total time for {:?}: {:?}",
                sym.kind,
                start_total.elapsed()
            );
            if !locations.is_empty() {
                return Some(locations);
            }
        }

        // Fallback for declaration sites in config/*.php
        let start_laravel = std::time::Instant::now();
        if let Some(locations) =
            laravel::find_config_references(self, uri, content, position, include_declaration)
        {
            tracing::info!(
                "Find References: found Laravel config references in {:?}",
                start_laravel.elapsed()
            );
            tracing::info!(
                "Find References: total time (fallback path): {:?}",
                start_total.elapsed()
            );
            return Some(locations);
        }