cairo-language-server 2.18.0

use cairo_lang_defs::db::DefsGroup;
use cairo_lang_defs::ids::{LanguageElementId, MacroCallId, ModuleId};
use cairo_lang_filesystem::db::get_originating_location;
use cairo_lang_filesystem::ids::SpanInFile;
use cairo_lang_semantic::diagnostic::{NotFoundItemType, SemanticDiagnostics};
use cairo_lang_semantic::expr::inference::InferenceId;
use cairo_lang_semantic::resolve::{
    ResolutionContext, ResolvedConcreteItem, ResolvedGenericItem, Resolver, ResolverData,
};
use cairo_lang_syntax::node::db::SyntaxGroup;
use cairo_lang_syntax::node::ids::SyntaxStablePtrId;
use cairo_lang_syntax::node::kind::SyntaxKind;
use cairo_lang_syntax::node::{TypedSyntaxNode, ast};
use cairo_language_common::CommonGroup;

pub use self::finder::ResolvedItem;
pub use self::finder::{find_declaration, find_definition};
pub use self::generic_param::GenericParamDef;
pub use self::item::ItemDef;
pub use self::member::MemberDef;
pub use self::module::ModuleDef;
pub use self::variable::VariableDef;
pub use self::variant::VariantDef;
use crate::lang::db::{AnalysisDatabase, LsSemanticGroup};
use crate::lang::usages::FindUsages;
use crate::lang::usages::search_scope::SearchScope;

mod finder;
mod generic_param;
mod item;
mod member;
mod module;
mod variable;
mod variant;

pub use module::NonMacroModuleId;

/// Keeps information about the symbol that is being searched for/inspected.
///
/// This is an ephemeral data structure.
/// Do not store it in any kind of state.
#[derive(Eq, PartialEq, Debug, Clone)]
pub enum SymbolDef<'db> {
    Item(ItemDef<'db>),
    Variable(VariableDef<'db>),
    PluginInlineMacro(String),
    Member(MemberDef<'db>),
    Variant(VariantDef<'db>),
    Module(ModuleDef<'db>),
    GenericParam(GenericParamDef<'db>),
}

/// An instance of Search (for definition or declaration).
/// Keeps result (def) and context information about the conducted search.
pub struct SymbolSearch<'db> {
    /// Result of the search
    pub def: SymbolDef<'db>,
    /// Intermediate result, used to construct `def`
    pub resolved_item: ResolvedItem<'db>,
    /// State of the resolver after this search
    pub resolver_data: Option<ResolverData<'db>>,
}

impl<'db> SymbolSearch<'db> {
    /// Finds definition of the symbol referred to by the given identifier.
    /// Gets you to the "nearest" point upwards in terms of top-down code breakdown
    /// (most likely you would use it to get this: usage -> impl)
    pub fn find_definition(
        db: &'db AnalysisDatabase,
        identifier: &ast::TerminalIdentifier<'db>,
    ) -> Option<Self> {
        // Get the resolved item info and the syntax node of the definition.
        let lookup_items =
            db.collect_lookup_items_with_parent_files(identifier.as_syntax_node())?;
        let mut resolver_data = None;
        let resolved_item = find_definition(db, identifier, lookup_items, &mut resolver_data)?;

        Self::from_resolved_item(db, resolved_item, resolver_data)
    }

    /// Finds declaration of the symbol referred to by given identifier.
    /// This is always the same as definition except for any identifier referring to an impl item
    /// - for which it will return a corresponding item in the definition of a trait.
    pub fn find_declaration(
        db: &'db AnalysisDatabase,
        identifier: &ast::TerminalIdentifier<'db>,
    ) -> Option<Self> {
        // Get the resolved item info and the syntax node of the definition.
        let lookup_items =
            db.collect_lookup_items_with_parent_files(identifier.as_syntax_node())?;
        let mut resolver_data = None;
        let resolved_item = find_declaration(db, identifier, lookup_items, &mut resolver_data)?;

        Self::from_resolved_item(db, resolved_item, resolver_data)
    }

    fn from_resolved_item(
        db: &'db AnalysisDatabase,
        resolved_item: ResolvedItem<'db>,
        resolver_data: Option<ResolverData<'db>>,
    ) -> Option<Self> {
        match resolved_item {
            ResolvedItem::Generic(ResolvedGenericItem::GenericConstant(_))
            | ResolvedItem::Generic(ResolvedGenericItem::GenericFunction(_))
            | ResolvedItem::Generic(ResolvedGenericItem::GenericType(_))
            | ResolvedItem::Generic(ResolvedGenericItem::GenericTypeAlias(_))
            | ResolvedItem::Generic(ResolvedGenericItem::GenericImplAlias(_))
            | ResolvedItem::Generic(ResolvedGenericItem::Trait(_))
            | ResolvedItem::Generic(ResolvedGenericItem::Impl(_))
            | ResolvedItem::Generic(ResolvedGenericItem::TraitItem(_))
            | ResolvedItem::Generic(ResolvedGenericItem::Macro(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Constant(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Function(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Type(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Trait(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Impl(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::SelfTrait(_))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Macro(_))
            | ResolvedItem::ImplItem(_) => {
                ItemDef::new(db, resolved_item.definition_node(db)?).map(SymbolDef::Item)
            }

            // An item should never be resolved to this but better safe than sorry.
            ResolvedItem::Generic(ResolvedGenericItem::Module(ModuleId::MacroCall {
                id, ..
            }))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Module(ModuleId::MacroCall {
                id,
                ..
            })) => {
                let resolved_item = resolve_macro_call_module(db, id)?;
                ItemDef::new(db, resolved_item.definition_node(db)?).map(SymbolDef::Item)
            }

            ResolvedItem::Generic(ResolvedGenericItem::Module(id))
            | ResolvedItem::Concrete(ResolvedConcreteItem::Module(id)) => Some(SymbolDef::Module(
                ModuleDef::new(db, id.try_into().unwrap(), resolved_item.definition_node(db)?),
            )),

            ResolvedItem::Generic(ResolvedGenericItem::Variable(var_id)) => {
                Some(SymbolDef::Variable(VariableDef::new(
                    db,
                    var_id,
                    resolved_item.definition_node(db)?,
                )))
            }

            ResolvedItem::Member(member_id) => {
                MemberDef::new(db, member_id, resolved_item.definition_node(db)?)
                    .map(SymbolDef::Member)
            }

            ResolvedItem::Generic(ResolvedGenericItem::Variant(ref variant)) => {
                VariantDef::new(db, variant.id, resolved_item.definition_node(db)?)
                    .map(SymbolDef::Variant)
            }

            ResolvedItem::Concrete(ResolvedConcreteItem::Variant(ref concrete_variant)) => {
                VariantDef::new(db, concrete_variant.id, resolved_item.definition_node(db)?)
                    .map(SymbolDef::Variant)
            }

            ResolvedItem::PluginInlineMacro(inline_macro) => {
                Some(SymbolDef::PluginInlineMacro(inline_macro.to_string(db)))
            }

            ResolvedItem::GenericParam(ref generic_param) => {
                Some(SymbolDef::GenericParam(GenericParamDef::new(db, generic_param)?))
            }
        }
        .map(|def| Self { def, resolved_item, resolver_data })
    }

    /// Starts a find-usages search for this symbol.
    pub fn usages<'a>(self, db: &'a AnalysisDatabase) -> FindUsages<'a>
    where
        'db: 'a,
    {
        FindUsages::new(self.def, self.resolved_item, db)
    }
}

impl<'db> SymbolDef<'db> {
    /// Gets the [`FileId`] and [`TextSpan`] of symbol's definition node's originating location.
    pub fn definition_originating_location(
        &self,
        db: &'db AnalysisDatabase,
    ) -> Option<SpanInFile<'db>> {
        let stable_ptr = self.definition_stable_ptr(db)?;
        let node = stable_ptr.lookup(db);
        let found_file = stable_ptr.file_id(db);
        let span = node.span_without_trivia(db);
        let span_in_file =
            get_originating_location(db, SpanInFile { file_id: found_file, span }, None);
        Some(get_originating_location(db, span_in_file, None))
    }

    /// Gets the [`FileId`] and [`TextSpan`] of symbol's definition node's non-translated location.
    pub fn definition_location(&self, db: &'db AnalysisDatabase) -> Option<SpanInFile<'db>> {
        let stable_ptr = self.definition_stable_ptr(db)?;
        let node = stable_ptr.lookup(db);
        let found_file = stable_ptr.file_id(db);
        let span = node.span_without_trivia(db);
        Some(SpanInFile { file_id: found_file, span })
    }

    /// Gets the name of the symbol.
    pub fn name(&self, db: &'db AnalysisDatabase) -> String {
        match self {
            Self::Item(it) => it.name(db),
            Self::Variable(it) => it.name(db),
            Self::PluginInlineMacro(name) => name.clone(),
            Self::Member(it) => it.name(db),
            Self::Variant(it) => it.name(db),
            Self::Module(it) => it.name(db),
            Self::GenericParam(it) => it.name(db).to_string(),
        }
    }

    /// Builds a search scope for finding usages of this symbol.
    #[tracing::instrument(skip_all)]
    pub fn search_scope(&self, db: &'db AnalysisDatabase) -> SearchScope<'db> {
        match &self {
            Self::Variable(var) => {
                if let Some(owning_function) = var.definition_node().ancestor_of_kinds(
                    db,
                    &[SyntaxKind::FunctionWithBody, SyntaxKind::TraitItemFunction],
                ) {
                    // Add generated virtual files to the search scope if such files could be
                    // generated from this function;
                    // i.e. if there is an attribute on the function or an inline macro inside it.
                    // Otherwise, search only the function scope.
                    if owning_function
                        .ancestor_of_kinds(
                            db,
                            &[SyntaxKind::AttributeList, SyntaxKind::ExprInlineMacro],
                        )
                        .is_some()
                    {
                        let file_id = owning_function.stable_ptr(db).file_id(db);
                        if let Some((subfiles, _)) =
                            db.file_and_subfiles_with_corresponding_modules(file_id)
                        {
                            let files_spans = subfiles
                                .iter()
                                .copied()
                                .map(|f| {
                                    if f == file_id {
                                        (f, Some(owning_function.span(db)))
                                    } else {
                                        (f, None)
                                    }
                                })
                                .collect();

                            SearchScope::files_spans(files_spans)
                        } else {
                            SearchScope::empty()
                        }
                    } else {
                        SearchScope::file_span(
                            owning_function.stable_ptr(db).file_id(db),
                            owning_function.span(db),
                        )
                    }
                } else {
                    SearchScope::file(var.definition_stable_ptr(db).file_id(db))
                }
            }

            // TODO(#195): Use visibility information to narrow down search scopes.
            _ => SearchScope::everything(db),
        }
    }

    /// Gets a stable pointer to the "most interesting" syntax node of the symbol.
    ///
    /// Typically, this is this symbol's name node.
    pub fn definition_stable_ptr(
        &self,
        db: &'db dyn SyntaxGroup,
    ) -> Option<SyntaxStablePtrId<'db>> {
        match self {
            Self::Item(d) => Some(d.definition_stable_ptr()),
            Self::Variable(d) => Some(d.definition_stable_ptr(db)),
            Self::PluginInlineMacro(_) => None,
            Self::Member(d) => Some(d.definition_stable_ptr()),
            Self::Variant(d) => Some(d.definition_stable_ptr()),
            Self::Module(d) => Some(d.definition_stable_ptr()),
            Self::GenericParam(d) => Some(d.definition_stable_ptr()),
        }
    }
}

fn resolve_macro_call_module<'db>(
    db: &'db AnalysisDatabase,
    id: MacroCallId<'db>,
) -> Option<ResolvedItem<'db>> {
    let macro_call_path = db.module_macro_call_by_id(id).ok()?.path(db);
    let inference_id = InferenceId::MacroCall(id);
    let module_id = id.parent_module(db);
    let mut resolver = Resolver::new(db, module_id, inference_id);

    match resolver.resolve_generic_path(
        &mut SemanticDiagnostics::new(module_id),
        &macro_call_path,
        NotFoundItemType::Macro,
        ResolutionContext::Default,
    ) {
        Ok(ResolvedGenericItem::Macro(declaration_id)) => {
            Some(ResolvedItem::Generic(ResolvedGenericItem::Macro(declaration_id)))
        }

        Ok(_) | Err(_) => None,
    }
}