Function build_class_snippet

src/completion/phpdoc/generation.rs:1624–1670

Build a docblock snippet for a class, interface, trait, or enum. Generates `@extends` / `@implements` tags with tab-stop placeholders when the parent or interface has `@template` parameters.

(
    sym: &SymbolInfo,
    _indent: &str,
    class_loader: &dyn Fn(&str) -> Option<Arc<ClassInfo>>,
)

/// Generates `@extends` / `@implements` tags with tab-stop placeholders
/// when the parent or interface has `@template` parameters.
fn build_class_snippet(
    sym: &SymbolInfo,
    _indent: &str,
    class_loader: &dyn Fn(&str) -> Option<Arc<ClassInfo>>,
) -> String {
    let mut tag_lines = Vec::new();
    let mut tab_stop = 1u32;

    for parent in &sym.extends_names {
        if let Some(cls) = class_loader(parent)
            && !cls.template_params.is_empty()
        {
            let mut parts = Vec::new();
            for tp in &cls.template_params {
                parts.push(format!("${{{}:{}}}", tab_stop, tp));
                tab_stop += 1;
            }
            tag_lines.push(format!(" * @extends {}<{}>", parent, parts.join(", ")));
        }
    }

    for iface in &sym.implements_names {
        if let Some(cls) = class_loader(iface)
            && !cls.template_params.is_empty()
        {
            let mut parts = Vec::new();
            for tp in &cls.template_params {
                parts.push(format!("${{{}:{}}}", tab_stop, tp));
                tab_stop += 1;
            }
            tag_lines.push(format!(" * @implements {}<{}>", iface, parts.join(", ")));
        }
    }

    let mut lines = Vec::new();
    lines.push("/**".to_string());

    if tag_lines.is_empty() {
        // No template tags — emit a summary-only skeleton.
        lines.push(" * ${1}".to_string());
    } else {
        lines.extend(tag_lines);
    }

    lines.push(" */".to_string());
    lines.join("\n")
}

/// Build a docblock snippet for a property.
///