Function build_use_edit

src/completion/use_edit.rs:358–388

Build an `additional_text_edits` entry that inserts a `use` statement for the given fully-qualified class name at the alphabetically correct position in the file's existing use block. When the FQN has no namespace separator (e.g. `PDO`, `DateTime`), an import is only needed if the current file declares a namespace — otherwise we are already in the global namespace and no `use` statement is requir

(
    fqn: &str,
    use_block: &UseBlockInfo,
    file_namespace: &Option<String>,
)

/// namespace, a blank line (`\n`) is prepended to separate the new
/// import from the `namespace` declaration.
pub(crate) fn build_use_edit(
    fqn: &str,
    use_block: &UseBlockInfo,
    file_namespace: &Option<String>,
) -> Option<Vec<TextEdit>> {
    // No namespace separator → this is a global class (e.g. `PDO`, `DateTime`).
    // Only needs an import when the current file declares a namespace;
    // otherwise we're already in the global namespace.
    if !fqn.contains('\\') && file_namespace.is_none() {
        return None;
    }

    let insert_pos = use_block.insert_position_for(fqn);

    // When there are no existing imports and the file has a namespace,
    // prepend a blank line to separate the namespace declaration from
    // the use block.
    let prefix = if use_block.existing.is_empty() && use_block.has_namespace {
        "\n"
    } else {
        ""
    };

    Some(vec![TextEdit {
        range: Range {
            start: insert_pos,
            end: insert_pos,
        },
        new_text: format!("{}use {};\n", prefix, fqn),
    }])
}

/// Build an `additional_text_edits` entry that inserts a `use function`
/// statement for the given fully-qualified function name at the