Method resolve_add_throws

src/code_actions/phpstan/add_throws.rs:162–225

Resolve the "Add @throws" code action by computing the full workspace edit. Phase 2**: called from [`resolve_code_action`](Self::resolve_code_action) when the user picks this action. Recomputes the docblock edit and (optionally) the import edit from the data payload.

(
        &self,
        data: &CodeActionData,
        content: &str,
    )

    /// picks this action.  Recomputes the docblock edit and (optionally)
    /// the import edit from the data payload.
    pub(crate) fn resolve_add_throws(
        &self,
        data: &CodeActionData,
        content: &str,
    ) -> Option<WorkspaceEdit> {
        let uri = &data.uri;

        // Parse the extra data to recover the diagnostic message.
        let diagnostic_message = data.extra.get("diagnostic_message")?.as_str()?;
        let diagnostic_line = data.extra.get("diagnostic_line")?.as_u64()? as usize;

        // Extract the exception FQN from the message.
        let exception_fqn = extract_exception_fqn(diagnostic_message)?;
        let short_name = crate::util::short_name(&exception_fqn);

        // Look up the use_map and namespace_map for the URI.
        let file_use_map: HashMap<String, String> = self.file_use_map(uri);
        let file_namespace: Option<String> = self.first_file_namespace(uri);

        // Determine if an import is needed.
        let already_imported = file_use_map.iter().any(|(alias, fqn)| {
            alias.eq_ignore_ascii_case(short_name) && fqn.eq_ignore_ascii_case(&exception_fqn)
        });

        let same_namespace = match &file_namespace {
            Some(ns) => {
                let ns_prefix = format!("{}\\", ns);
                let stripped = exception_fqn.strip_prefix(&ns_prefix);
                stripped.is_some_and(|rest| !rest.contains('\\'))
            }
            None => !exception_fqn.contains('\\'),
        };

        let needs_import = !already_imported && !same_namespace;

        // Find the enclosing docblock.
        let docblock_info = find_enclosing_docblock(content, diagnostic_line)?;

        // Build edits.
        let mut edits = Vec::new();

        // 1. Docblock edit: insert @throws tag.
        let throws_edit = build_throws_edit(content, &docblock_info, short_name);
        edits.push(throws_edit);

        // 2. Import edit (if needed).
        if needs_import {
            let use_block = analyze_use_block(content);
            if let Some(import_edits) = build_use_edit(&exception_fqn, &use_block, &file_namespace)
            {
                edits.extend(import_edits);
            }
        }

        let doc_uri: Url = uri.parse().ok()?;
        let mut changes = HashMap::new();
        changes.insert(doc_uri, edits);