Function attribute_placeholder

src/completion/builder.rs:143–188

Choose a sensible placeholder value for an attribute constructor parameter. Returns `(prefix, placeholder, suffix)` where `prefix` and `suffix` are literal characters that surround the snippet tab stop. For string parameters this produces `'${n:methodName}'` so that typing replaces only the inner text while preserving the quotes. If the parameter has an explicit default value in source code, th

(param: &ParameterInfo)

/// is used directly as the placeholder with no wrapping.  Otherwise,
/// the type hint is inspected to produce a valid PHP literal.
fn attribute_placeholder(param: &ParameterInfo) -> (String, String, String) {
    // Use the explicit default when available.
    if let Some(ref default) = param.default_value {
        return (String::new(), default.clone(), String::new());
    }

    // Infer from the type hint.  Prefer the native hint over the
    // docblock hint, and unwrap nullable wrappers (`?string` or
    // `string|null` both yield `string`) via `PhpType::non_null_type()`
    // instead of manual `?`-prefix stripping on strings.
    let hint = param.native_type_hint.as_ref().or(param.type_hint.as_ref());
    let base_type = match hint {
        Some(t) => match t.non_null_type() {
            Some(inner) => inner,
            None => t.clone(),
        },
        None => {
            // No type hint — use the bare parameter name.
            let name = param.name.strip_prefix('$').unwrap_or(&*param.name);
            return (String::new(), name.to_string(), String::new());
        }
    };

    if base_type.is_string_type() {
        // Use the parameter name (without $) as a descriptive
        // placeholder.  Quotes sit outside the tab stop so typing
        // replaces only the inner text: `'${1:methodName}'`.
        let name = param.name.strip_prefix('$').unwrap_or(&*param.name);
        return ("'".to_string(), name.to_string(), "'".to_string());
    }
    if base_type.is_bool() {
        return (String::new(), "false".to_string(), String::new());
    }
    if base_type.is_int() {
        return (String::new(), "0".to_string(), String::new());
    }
    if base_type.is_float() {
        return (String::new(), "0.0".to_string(), String::new());
    }
    if base_type.is_bare_array() {
        return (String::new(), "[]".to_string(), String::new());
    }
    // Unknown or complex type — use the bare parameter name.
    let name = param.name.strip_prefix('$').unwrap_or(&*param.name);
    (String::new(), name.to_string(), String::new())
}

// Re-export use-statement helpers so existing `use crate::completion::builder::{…}`
// imports continue to work.