Function is_inside_docblock

src/completion/source/comment_position.rs:23–38

Returns `true` if the given position is inside a `/** … */` docblock. Scans backwards from the cursor to find the nearest `/**` that has not been closed by a matching `*/` before the cursor position.

(content: &str, position: Position)

/// Scans backwards from the cursor to find the nearest `/**` that has not
/// been closed by a matching `*/` before the cursor position.
pub fn is_inside_docblock(content: &str, position: Position) -> bool {
    // Convert position to byte offset for easier scanning
    let byte_offset = position_to_byte_offset(content, position);

    let before_cursor = &content[..byte_offset.min(content.len())];

    // Find the last `/**` before the cursor
    let Some(open_pos) = before_cursor.rfind("/**") else {
        return false;
    };

    // Check if there is a `*/` between the `/**` and the cursor
    // (which would mean the docblock is closed)
    let after_open = &before_cursor[open_pos + 3..];
    !after_open.contains("*/")
}

/// Returns `true` if the given position is inside a `//` line comment or
/// a `/* … */` block comment that is **not** a `/** … */` docblock.