Function is_known_deprecated_attr

src/parser/mod.rs:552–592

Check whether an attribute identifier refers to one of the known deprecation attributes (`\Deprecated` or `\JetBrains\PhpStorm\Deprecated`). The matching rules mirror PHP's attribute name resolution: - **Fully-qualified** (`\Deprecated`, `\JetBrains\PhpStorm\Deprecated`): strip the leading `\` and compare against [`DEPRECATED_FQNS`]. - **Qualified** (`JetBrains\PhpStorm\Deprecated`): resolve the

(name: &Identifier<'_>, ctx: &DocblockCtx<'_>)

///   name is in the current namespace. Only matches if the file is in the
///   global namespace (i.e. the bare name equals a known FQN).
fn is_known_deprecated_attr(name: &Identifier<'_>, ctx: &DocblockCtx<'_>) -> bool {
    match name {
        Identifier::FullyQualified(fq) => {
            // Input boundary: AST fully-qualified names include the leading `\`.
            let stripped = strip_fqn_prefix(fq.value);
            DEPRECATED_FQNS.contains(&stripped)
        }
        Identifier::Qualified(q) => {
            // Resolve the first segment via the use-map, then rebuild.
            let first_seg = q.value.split('\\').next().unwrap_or(q.value);
            if let Some(resolved_prefix) = ctx.use_map.get(first_seg) {
                let rest = &q.value[first_seg.len()..]; // includes leading '\'
                let fqn = format!("{}{}", resolved_prefix, rest);
                DEPRECATED_FQNS.contains(&fqn.as_str())
            } else {
                // No use-map entry — prepend file namespace if present.
                let fqn = if let Some(ns) = &ctx.namespace {
                    format!("{}\\{}", ns, q.value)
                } else {
                    q.value.to_string()
                };
                DEPRECATED_FQNS.contains(&fqn.as_str())
            }
        }
        Identifier::Local(local) => {
            // Check use-map first (e.g. `use JetBrains\PhpStorm\Deprecated;`)
            if let Some(fqn) = ctx.use_map.get(local.value) {
                DEPRECATED_FQNS.contains(&fqn.as_str())
            } else {
                // No import — the name lives in the current namespace.
                // Only matches if the file is in the global namespace.
                let fqn = if let Some(ns) = &ctx.namespace {
                    format!("{}\\{}", ns, local.value)
                } else {
                    local.value.to_string()
                };
                DEPRECATED_FQNS.contains(&fqn.as_str())
            }
        }
    }
}

/// Extract the string value from a literal string expression by reading
/// the source text between the expression's span and stripping quotes.