Function build_callable_snippet

src/completion/builder.rs:56–75

Build an LSP snippet string for a callable (function, method, or constructor). Required parameters are included as numbered tab stops with their PHP variable name as placeholder text. Optional and variadic parameters are omitted — they can be filled in via signature help. The returned string uses LSP snippet syntax and **must** be paired with `InsertTextFormat::SNIPPET` on the `CompletionItem`.

(name: &str, params: &[ParameterInfo])

/// | `("makeText", &[req($text), opt($long)])`  | `"makeText(${1:\\$text})$0"`        |
/// | `("add", &[req($a), req($b)])`             | `"add(${1:\\$a}, ${2:\\$b})$0"`     |
pub(crate) fn build_callable_snippet(name: &str, params: &[ParameterInfo]) -> String {
    let required: Vec<&ParameterInfo> = params.iter().filter(|p| p.is_required).collect();

    if required.is_empty() {
        format!("{name}()$0")
    } else {
        let placeholders: Vec<String> = required
            .iter()
            .enumerate()
            .map(|(i, p)| {
                // Escape `$` in parameter names so it is treated as a
                // literal character rather than a snippet tab-stop /
                // variable reference.
                let escaped_name = p.name.replace('$', "\\$");
                format!("${{{}:{}}}", i + 1, escaped_name)
            })
            .collect();
        format!("{name}({})$0", placeholders.join(", "))
    }
}

/// Build an LSP snippet string for a PHP attribute constructor.
///