Function is_preceding_docblock_removed

src/stubs.rs:168–217

Shared helper: check if the docblock immediately preceding the declaration at `decl_pos` contains `@removed X.Y` where `php_version >= X.Y`.

(
    source: &str,
    decl_pos: usize,
    php_version: crate::types::PhpVersion,
)

/// declaration at `decl_pos` contains `@removed X.Y` where
/// `php_version >= X.Y`.
fn is_preceding_docblock_removed(
    source: &str,
    decl_pos: usize,
    php_version: crate::types::PhpVersion,
) -> bool {
    let before = &source[..decl_pos];
    let Some(doc_end) = before.rfind("*/") else {
        return false;
    };

    // Make sure there is no intervening declaration between the
    // docblock end and our target — otherwise the docblock belongs
    // to a different element.
    let between = &source[doc_end + 2..decl_pos];
    if between.contains("function ") || between.contains("class ") || between.contains("interface ")
    {
        return false;
    }

    let Some(doc_start) = source[..doc_end].rfind("/**") else {
        return false;
    };

    let docblock = &source[doc_start..doc_end + 2];

    // Simple line-by-line scan for `@removed X.Y` instead of a full
    // docblock parse.  This is called for every stub entry during
    // `set_php_version`, so avoiding the mago-docblock parser here
    // saves significant startup time.
    for line in docblock.lines() {
        let trimmed = line.trim().trim_start_matches('*').trim();
        let rest = if let Some(r) = trimmed.strip_prefix("@removed") {
            r
        } else {
            continue;
        };
        // The version string follows the tag, separated by whitespace.
        let rest = rest.trim_start();
        if rest.is_empty() {
            continue;
        }
        if let Some(ver) = crate::types::PhpVersion::from_composer_constraint(rest)
            && php_version >= ver
        {
            return true;
        }
    }

    false
}

/// Quick byte-level check whether a stub constant has been
/// `@removed` at or before the given PHP version.