Function docstring_from_preceding_comments

src/extraction/common.rs:77–104

(
    source: &[u8],
    node: TsNode<'_>,
    clean: fn(&str) -> String,
)

/// preceding `node`, cleaning each comment with `clean`.
#[allow(dead_code)]
pub(crate) fn docstring_from_preceding_comments(
    source: &[u8],
    node: TsNode<'_>,
    clean: fn(&str) -> String,
) -> Option<String> {
    let mut comments = Vec::new();
    let mut current = node.prev_named_sibling();
    while let Some(sibling) = current {
        if sibling.kind() == "comment" {
            comments.push(node_text(source, sibling));
            current = sibling.prev_named_sibling();
        } else {
            break;
        }
    }
    if comments.is_empty() {
        return None;
    }
    // Comments are collected in reverse order (closest first).
    comments.reverse();
    let cleaned: Vec<String> = comments.iter().map(|c| clean(c)).collect();
    let result = cleaned.join("\n").trim().to_string();
    if result.is_empty() {
        None
    } else {
        Some(result)
    }
}

/// Extract a docstring from the run of `#` comment siblings immediately
/// preceding `node`.