Function parse_declaration_info

src/completion/phpdoc/generation.rs:601–690

Parse the declaration after the trigger to extract parameter names, type hints, return types, etc.

(text: &str)

/// Parse the declaration after the trigger to extract parameter names,
/// type hints, return types, etc.
fn parse_declaration_info(text: &str) -> SymbolInfo {
    // Reuse the existing parser from the context module, but we need
    // to work from the raw text directly.
    let mut info = SymbolInfo::default();

    // Collect the declaration — may span multiple lines until `{` or `;`.
    let mut decl = String::new();
    let mut attr_depth = 0i32;
    for line in text.lines() {
        let trimmed = line.trim();
        if trimmed.is_empty() {
            continue;
        }
        if trimmed.starts_with('*') || trimmed.starts_with("/**") {
            continue;
        }
        // Skip PHP 8 attribute lines (#[...]).  Track bracket nesting
        // depth so that array literals inside attributes don't
        // prematurely end tracking.
        if attr_depth > 0 || trimmed.starts_with("#[") {
            for ch in trimmed.chars() {
                match ch {
                    '[' => attr_depth += 1,
                    ']' => attr_depth -= 1,
                    _ => {}
                }
            }
            continue;
        }
        decl.push(' ');
        decl.push_str(trimmed);
        if trimmed.contains('{') || trimmed.contains(';') {
            break;
        }
    }

    let decl = decl.trim();
    if decl.is_empty() {
        return info;
    }

    // Check if it's a function/method.
    if let Some(func_pos) = find_keyword_pos(decl, "function") {
        let after_func = &decl[func_pos + 8..].trim_start();

        // Extract the method/function name (skip leading `&` for references).
        let name_src = after_func
            .strip_prefix('&')
            .unwrap_or(after_func)
            .trim_start();
        let name: String = name_src
            .chars()
            .take_while(|c| c.is_alphanumeric() || *c == '_')
            .collect();
        if !name.is_empty() {
            info.method_name = Some(name);
        }