euv-cli 0.3.18

use crate::*;

/// Formats a single Rust source file by reformatting all euv macro invocations.
///
/// Scans the source code for `html!`, `class!`, `css_vars!`, and `watch!`
/// macro calls, then applies formatting rules to their token bodies:
///
/// - Tag name and `{` separated by exactly one space
/// - Attribute name immediately followed by `:`, then one space before the value
/// - `if { expr }` with single spaces around each token
/// - `match { expr }` with proper alignment
/// - `for pattern in { expr }` with proper alignment
/// - `=>` in watch! macros with proper spacing
///
/// # Arguments
///
/// - `&str` - The Rust source code content.
///
/// # Returns
///
/// - `FmtResult` - The formatting result indicating whether changes were made.
pub(crate) fn format_source(source: &str) -> FmtResult {
    let formatted: String = format_euv_macros(source);
    let changed: bool = formatted != source;
    FmtResult {
        changed,
        output: formatted,
    }
}

/// Finds and reformats all euv macro invocations in the source text.
///
/// Uses a character-level scanner to locate macro calls (e.g., `html! { ... }`),
/// tracks brace depth to find the complete macro body, then formats the body
/// using `format_macro_body`.
///
/// # Arguments
///
/// - `&str` - The Rust source code content.
///
/// # Returns
///
/// - `String` - The source with all euv macros reformatted.
fn format_euv_macros(source: &str) -> String {
    let mut result: String = String::new();
    let chars: Vec<char> = source.chars().collect();
    let len: usize = chars.len();
    let mut i: usize = 0;
    while i < len {
        if is_euv_macro_start(&chars, i, len) {
            let macro_name_end: usize = find_macro_name_end(&chars, i, len);
            let name: String = chars[i..macro_name_end].iter().collect::<String>();
            result.push_str(&name);
            i = macro_name_end;
            i = skip_whitespace_and_comments(&chars, i, len, &mut result);
            if i < len && chars[i] == '!' {
                result.push('!');
                i += 1;
                i = skip_whitespace_and_comments(&chars, i, len, &mut result);
                if i < len && chars[i] == '{' {
                    let (body_content, end_pos) = extract_brace_content(&chars, i);
                    let formatted_body: String = format_macro_body(&body_content);
                    result.push('{');
                    result.push_str(&formatted_body);
                    result.push('}');
                    i = end_pos;
                    continue;
                }
            }
            continue;
        }
        if chars[i] == '"' || chars[i] == '\'' {
            let (literal, end_pos) = extract_string_literal(&chars, i, len);
            result.push_str(&literal);
            i = end_pos;
            continue;
        }
        if i + 1 < len && chars[i] == '/' && chars[i + 1] == '/' {
            let (comment, end_pos) = extract_line_comment(&chars, i, len);
            result.push_str(&comment);
            i = end_pos;
            continue;
        }
        if i + 1 < len && chars[i] == '/' && chars[i + 1] == '*' {
            let (comment, end_pos) = extract_block_comment(&chars, i, len);
            result.push_str(&comment);
            i = end_pos;
            continue;
        }
        result.push(chars[i]);
        i += 1;
    }
    result
}

/// Checks whether the current position starts a known euv macro name.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length of the source.
///
/// # Returns
///
/// - `bool` - Whether a euv macro name starts at the given position.
fn is_euv_macro_start(chars: &[char], pos: usize, len: usize) -> bool {
    for name in EUV_MACRO_NAMES {
        let name_len: usize = name.len();
        if pos + name_len > len {
            continue;
        }
        let candidate: String = chars[pos..pos + name_len].iter().collect::<String>();
        if candidate != *name {
            continue;
        }
        if pos > 0 && is_ident_char(chars[pos - 1]) {
            continue;
        }
        if pos + name_len < len && is_ident_char(chars[pos + name_len]) {
            continue;
        }
        return true;
    }
    false
}

/// Finds the end position of a macro name starting at the given position.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The start position of the macro name.
/// - `usize` - The total length of the source.
///
/// # Returns
///
/// - `usize` - The end position (exclusive) of the macro name.
fn find_macro_name_end(chars: &[char], pos: usize, _len: usize) -> usize {
    let mut end: usize = pos;
    while end < chars.len() && is_ident_char(chars[end]) {
        end += 1;
    }
    end
}

/// Checks if a character can be part of a Rust identifier.
///
/// # Arguments
///
/// - `char` - The character to check.
///
/// # Returns
///
/// - `bool` - Whether the character is an identifier character.
fn is_ident_char(ch: char) -> bool {
    ch.is_alphanumeric() || ch == '_'
}

/// Skips whitespace and comments, preserving them in the output.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
/// - `&mut String` - The output string to append preserved whitespace/comments to.
///
/// # Returns
///
/// - `usize` - The new position after skipping whitespace and comments.
fn skip_whitespace_and_comments(
    chars: &[char],
    mut pos: usize,
    len: usize,
    result: &mut String,
) -> usize {
    while pos < len {
        if chars[pos].is_whitespace() {
            result.push(chars[pos]);
            pos += 1;
        } else if pos + 1 < len && chars[pos] == '/' && chars[pos + 1] == '/' {
            let (comment, end_pos) = extract_line_comment(chars, pos, len);
            result.push_str(&comment);
            pos = end_pos;
        } else if pos + 1 < len && chars[pos] == '/' && chars[pos + 1] == '*' {
            let (comment, end_pos) = extract_block_comment(chars, pos, len);
            result.push_str(&comment);
            pos = end_pos;
        } else {
            break;
        }
    }
    pos
}

/// Extracts a brace-enclosed block verbatim (including the braces).
///
/// Assumes `chars[start]` is `{`. Returns the full content (including the
/// outer `{` and `}`) and the position after the closing `}`.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The position of the opening `{`.
///
/// # Returns
///
/// - `(String, usize)` - The content including braces and the position after the closing `}`.
fn extract_brace_block(chars: &[char], start: usize) -> (String, usize) {
    let mut depth: i32 = 0;
    let mut i: usize = start;
    while i < chars.len() {
        if chars[i] == '"' || chars[i] == '\'' {
            let (_, end) = extract_string_literal(chars, i, chars.len());
            i = end;
            continue;
        }
        if i + 1 < chars.len() && chars[i] == '/' && chars[i + 1] == '/' {
            let (_, end) = extract_line_comment(chars, i, chars.len());
            i = end;
            continue;
        }
        if i + 1 < chars.len() && chars[i] == '/' && chars[i + 1] == '*' {
            let (_, end) = extract_block_comment(chars, i, chars.len());
            i = end;
            continue;
        }
        if chars[i] == '{' {
            depth += 1;
        } else if chars[i] == '}' {
            depth -= 1;
            if depth == 0 {
                let content: String = chars[start..=i].iter().collect();
                return (content, i + 1);
            }
        }
        i += 1;
    }
    let content: String = chars[start..].iter().collect();
    (content, chars.len())
}

/// Extracts the content inside a brace-delimited block (without the outer braces).
///
/// Assumes `chars[start]` is `{`. Returns the inner content (without the
/// outer braces) and the position after the closing `}`.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The position of the opening `{`.
///
/// # Returns
///
/// - `(String, usize)` - The content inside the braces and the position after the closing `}`.
fn extract_brace_content(chars: &[char], start: usize) -> (String, usize) {
    let mut depth: i32 = 0;
    let mut i: usize = start;
    let mut content_start: usize = start + 1;
    while i < chars.len() {
        if chars[i] == '"' || chars[i] == '\'' {
            let (_, end) = extract_string_literal(chars, i, chars.len());
            i = end;
            continue;
        }
        if i + 1 < chars.len() && chars[i] == '/' && chars[i + 1] == '/' {
            let (_, end) = extract_line_comment(chars, i, chars.len());
            i = end;
            continue;
        }
        if i + 1 < chars.len() && chars[i] == '/' && chars[i + 1] == '*' {
            let (_, end) = extract_block_comment(chars, i, chars.len());
            i = end;
            continue;
        }
        if chars[i] == '{' {
            if depth == 0 {
                content_start = i + 1;
            }
            depth += 1;
        } else if chars[i] == '}' {
            depth -= 1;
            if depth == 0 {
                let content: String = chars[content_start..i].iter().collect();
                return (content, i + 1);
            }
        }
        i += 1;
    }
    let content: String = chars[content_start..].iter().collect();
    (content, chars.len())
}

/// Extracts a string literal (single-quoted or double-quoted) from the source.
///
/// Handles escape sequences (`\"`, `\'`, `\\`).
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The start position (at the opening quote).
/// - `usize` - The total length.
///
/// # Returns
///
/// - `(String, usize)` - The literal text and the position after the closing quote.
fn extract_string_literal(chars: &[char], start: usize, len: usize) -> (String, usize) {
    let quote: char = chars[start];
    let mut i: usize = start + 1;
    let mut result: String = String::new();
    result.push(quote);
    while i < len {
        if chars[i] == '\\' && i + 1 < len {
            result.push(chars[i]);
            result.push(chars[i + 1]);
            i += 2;
            continue;
        }
        result.push(chars[i]);
        if chars[i] == quote {
            return (result, i + 1);
        }
        i += 1;
    }
    (result, i)
}

/// Extracts a line comment (`// ...`) from the source.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The start position (at the first `/`).
/// - `usize` - The total length.
///
/// # Returns
///
/// - `(String, usize)` - The comment text and the position after the newline.
fn extract_line_comment(chars: &[char], start: usize, len: usize) -> (String, usize) {
    let mut i: usize = start;
    let mut result: String = String::new();
    while i < len && chars[i] != '\n' {
        result.push(chars[i]);
        i += 1;
    }
    if i < len {
        result.push('\n');
        i += 1;
    }
    (result, i)
}

/// Extracts a block comment (`/* ... */`) from the source.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The start position (at the first `/`).
/// - `usize` - The total length.
///
/// # Returns
///
/// - `(String, usize)` - The comment text and the position after the closing `*/`.
fn extract_block_comment(chars: &[char], start: usize, len: usize) -> (String, usize) {
    let mut i: usize = start + 2;
    let mut result: String = String::from("/*");
    while i + 1 < len {
        result.push(chars[i]);
        if chars[i] == '*' && chars[i + 1] == '/' {
            result.push('/');
            return (result, i + 2);
        }
        i += 1;
    }
    while i < len {
        result.push(chars[i]);
        i += 1;
    }
    (result, i)
}

/// Formats the body of a euv macro invocation.
///
/// Uses a single-pass scanner that tracks context to apply formatting rules:
///
/// - Tag name and `{` separated by exactly one space
/// - Attribute name immediately followed by `:`, then one space before the value
/// - `if { expr }` / `match { expr }` / `for pattern in { expr }` with proper spacing
/// - `=>` in watch macros with proper spacing
///
/// Content inside expression braces `{ expr }` is preserved verbatim.
/// Only template-level whitespace is normalized.
///
/// # Arguments
///
/// - `&str` - The raw macro body text (without outer braces).
///
/// # Returns
///
/// - `String` - The formatted macro body text.
fn format_macro_body(body: &str) -> String {
    let chars: Vec<char> = body.chars().collect();
    let len: usize = chars.len();
    let mut result: String = String::new();
    let mut i: usize = 0;
    while i < len {
        if chars[i] == '"' || chars[i] == '\'' {
            let (literal, end) = extract_string_literal(&chars, i, len);
            result.push_str(&literal);
            i = end;
            continue;
        }
        if i + 1 < len && chars[i] == '/' && chars[i + 1] == '/' {
            let (comment, end) = extract_line_comment(&chars, i, len);
            result.push_str(&comment);
            i = end;
            continue;
        }
        if i + 1 < len && chars[i] == '/' && chars[i + 1] == '*' {
            let (comment, end) = extract_block_comment(&chars, i, len);
            result.push_str(&comment);
            i = end;
            continue;
        }
        if is_if_keyword(&chars, i, len) {
            result.push_str("if");
            i += 2;
            let after_if: usize = skip_spaces_on_same_line(&chars, i, len);
            if i < len && chars[after_if] == '{' {
                result.push(' ');
                let (block, end) = extract_brace_block(&chars, after_if);
                result.push_str(&block);
                i = end;
                i = skip_spaces_on_same_line(&chars, i, len);
                if i < len && chars[i] == '{' {
                    result.push(' ');
                }
            } else {
                result.push(' ');
                i = after_if;
            }
            continue;
        }
        if is_else_keyword(&chars, i, len) {
            if !result.ends_with(' ') && !result.ends_with('\n') && !result.ends_with('\t') {
                result.push(' ');
            }
            result.push_str("else");
            i += 4;
            i = skip_spaces_on_same_line(&chars, i, len);
            if is_if_keyword(&chars, i, len) {
                result.push(' ');
                continue;
            }
            if i < len && chars[i] == '{' {
                result.push(' ');
            }
            continue;
        }
        if is_match_keyword(&chars, i, len) {
            result.push_str("match");
            i += 5;
            let after_match: usize = skip_spaces_on_same_line(&chars, i, len);
            if after_match < len && chars[after_match] == '{' {
                result.push(' ');
                let (block, end) = extract_brace_block(&chars, after_match);
                result.push_str(&block);
                i = end;
                i = skip_spaces_on_same_line(&chars, i, len);
                if i < len && chars[i] == '{' {
                    result.push(' ');
                }
            } else {
                result.push(' ');
                i = after_match;
            }
            continue;
        }
        if is_for_keyword(&chars, i, len) {
            result.push_str("for");
            i += 3;
            i = skip_spaces_on_same_line(&chars, i, len);
            if i < len && !is_in_keyword(&chars, i, len) {
                result.push(' ');
            }
            while i < len && !is_in_keyword(&chars, i, len) {
                if chars[i] == '{' {
                    let (block, end) = extract_brace_block(&chars, i);
                    result.push_str(&block);
                    i = end;
                    continue;
                }
                if chars[i] == '"' || chars[i] == '\'' {
                    let (literal, end) = extract_string_literal(&chars, i, len);
                    result.push_str(&literal);
                    i = end;
                    continue;
                }
                result.push(chars[i]);
                i += 1;
            }
            if result.ends_with(' ') {
                result.truncate(result.len() - 1);
            }
            i = skip_spaces_on_same_line(&chars, i, len);
            if is_in_keyword(&chars, i, len) {
                result.push(' ');
                result.push_str("in");
                i += 2;
                i = skip_spaces_on_same_line(&chars, i, len);
                if i < len && chars[i] == '{' {
                    result.push(' ');
                    let (block, end) = extract_brace_block(&chars, i);
                    result.push_str(&block);
                    i = end;
                    i = skip_spaces_on_same_line(&chars, i, len);
                    if i < len && chars[i] == '{' {
                        result.push(' ');
                    }
                }
            }
            continue;
        }
        if chars[i] == ':' && i + 1 < len && chars[i + 1] != ':' {
            if result.ends_with(':') {
                result.push(':');
                i += 1;
                continue;
            }
            let colon_prefix: String = find_ident_before(&result);
            if !colon_prefix.is_empty() {
                let before_colon: String = remove_trailing_spaces(&result, colon_prefix.len());
                result = before_colon;
                result.push_str(&colon_prefix);
            }
            result.push(':');
            i += 1;
            while i < len && (chars[i] == ' ' || chars[i] == '\t') {
                i += 1;
            }
            if i < len && chars[i] != '\n' && chars[i] != '\r' {
                result.push(' ');
            }
            continue;
        }
        if i + 1 < len && chars[i] == '=' && chars[i + 1] == '>' {
            let trailing: String = find_trailing_spaces(&result);
            if !trailing.is_empty() {
                result.truncate(result.len() - trailing.len());
            }
            result.push(' ');
            result.push_str("=>");
            i += 2;
            while i < len && (chars[i] == ' ' || chars[i] == '\t') {
                i += 1;
            }
            result.push(' ');
            continue;
        }
        if is_ident_char(chars[i]) {
            let start: usize = i;
            while i < len && is_ident_char(chars[i]) {
                i += 1;
            }
            let ident: String = chars[start..i].iter().collect();
            result.push_str(&ident);
            let ws_start: usize = i;
            while i < len && (chars[i] == ' ' || chars[i] == '\t') {
                i += 1;
            }
            let had_whitespace: bool = i > ws_start;
            if i < len && chars[i] == '{' {
                result.push(' ');
            } else if had_whitespace {
                let ws: String = chars[ws_start..i].iter().collect();
                result.push_str(&ws);
            }
            continue;
        }
        result.push(chars[i]);
        i += 1;
    }
    result
}

/// Checks if the current position is the start of the `if` keyword.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `bool` - Whether `if` starts at the given position.
fn is_if_keyword(chars: &[char], pos: usize, len: usize) -> bool {
    if pos + 2 > len {
        return false;
    }
    chars[pos] == 'i'
        && chars[pos + 1] == 'f'
        && (pos + 2 >= len || !is_ident_char(chars[pos + 2]))
        && (pos == 0 || !is_ident_char(chars[pos - 1]))
}

/// Checks if the current position is the start of the `else` keyword.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `bool` - Whether `else` starts at the given position.
fn is_else_keyword(chars: &[char], pos: usize, len: usize) -> bool {
    if pos + 4 > len {
        return false;
    }
    chars[pos] == 'e'
        && chars[pos + 1] == 'l'
        && chars[pos + 2] == 's'
        && chars[pos + 3] == 'e'
        && (pos + 4 >= len || !is_ident_char(chars[pos + 4]))
        && (pos == 0 || !is_ident_char(chars[pos - 1]))
}

/// Checks if the current position is the start of the `match` keyword.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `bool` - Whether `match` starts at the given position.
fn is_match_keyword(chars: &[char], pos: usize, len: usize) -> bool {
    if pos + 5 > len {
        return false;
    }
    chars[pos] == 'm'
        && chars[pos + 1] == 'a'
        && chars[pos + 2] == 't'
        && chars[pos + 3] == 'c'
        && chars[pos + 4] == 'h'
        && (pos + 5 >= len || !is_ident_char(chars[pos + 5]))
        && (pos == 0 || !is_ident_char(chars[pos - 1]))
}

/// Checks if the current position is the start of the `for` keyword.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `bool` - Whether `for` starts at the given position.
fn is_for_keyword(chars: &[char], pos: usize, len: usize) -> bool {
    if pos + 3 > len {
        return false;
    }
    chars[pos] == 'f'
        && chars[pos + 1] == 'o'
        && chars[pos + 2] == 'r'
        && (pos + 3 >= len || !is_ident_char(chars[pos + 3]))
        && (pos == 0 || !is_ident_char(chars[pos - 1]))
}

/// Checks if the current position is the start of the `in` keyword.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `bool` - Whether `in` starts at the given position.
fn is_in_keyword(chars: &[char], pos: usize, len: usize) -> bool {
    if pos + 2 > len {
        return false;
    }
    chars[pos] == 'i'
        && chars[pos + 1] == 'n'
        && (pos + 2 >= len || !is_ident_char(chars[pos + 2]))
        && (pos == 0 || !is_ident_char(chars[pos - 1]))
}

/// Skips spaces (but not newlines) on the same line.
///
/// # Arguments
///
/// - `&[char]` - The source character slice.
/// - `usize` - The current position.
/// - `usize` - The total length.
///
/// # Returns
///
/// - `usize` - The position after skipping same-line spaces.
fn skip_spaces_on_same_line(chars: &[char], mut pos: usize, len: usize) -> usize {
    while pos < len && (chars[pos] == ' ' || chars[pos] == '\t') {
        pos += 1;
    }
    pos
}

/// Finds the identifier immediately before the current position in the result string.
///
/// # Arguments
///
/// - `&str` - The result string built so far.
///
/// # Returns
///
/// - `String` - The identifier found before the current position, or empty if none.
fn find_ident_before(result: &str) -> String {
    let chars: Vec<char> = result.chars().collect();
    let mut end: usize = chars.len();
    while end > 0 && chars[end - 1] == ' ' {
        end -= 1;
    }
    let mut start: usize = end;
    while start > 0 && is_ident_char(chars[start - 1]) {
        start -= 1;
    }
    if start < end {
        chars[start..end].iter().collect()
    } else {
        String::new()
    }
}

/// Removes trailing spaces and the identified prefix from the result string.
///
/// # Arguments
///
/// - `&str` - The result string built so far.
/// - `usize` - The length of the prefix to remove.
///
/// # Returns
///
/// - `String` - The string with trailing spaces and prefix removed.
fn remove_trailing_spaces(result: &str, prefix_len: usize) -> String {
    let chars: Vec<char> = result.chars().collect();
    let total_len: usize = chars.len();
    let mut end: usize = total_len;
    while end > 0 && chars[end - 1] == ' ' {
        end -= 1;
    }
    if prefix_len > end {
        return result.to_string();
    }
    let new_end: usize = end - prefix_len;
    chars[..new_end].iter().collect()
}

/// Finds trailing spaces in the result string.
///
/// # Arguments
///
/// - `&str` - The result string.
///
/// # Returns
///
/// - `String` - The trailing spaces.
fn find_trailing_spaces(result: &str) -> String {
    let mut spaces: String = String::new();
    for ch in result.chars().rev() {
        if ch == ' ' || ch == '\t' {
            spaces.push(ch);
        } else {
            break;
        }
    }
    spaces.chars().rev().collect()
}

/// Formats all Rust source files in the given directory that contain euv macros.
///
/// Recursively walks the directory tree, finds `.rs` files, and formats
/// any euv macro invocations found within them.
///
/// # Arguments
///
/// - `&Path` - The root directory to search.
/// - `FmtMode` - Whether to check or write formatting.
///
/// # Returns
///
/// - `Result<()>` - Indicates success or failure.
pub(crate) async fn format_dir(path: &Path, mode: FmtMode) -> Result<()> {
    if path.is_file() {
        let changed: bool = format_file(path, &mode).await?;
        match mode {
            FmtMode::Check => {
                if changed {
                    bail!("{} needs formatting.", path.display());
                }
                log::info!("{} is properly formatted.", path.display());
            }
            FmtMode::Write => {
                if changed {
                    log::info!("Formatted: {}", path.display());
                } else {
                    log::info!("Already formatted: {}", path.display());
                }
            }
        }
        return Ok(());
    }
    let mut entries: Vec<PathBuf> = collect_rs_files(path).await?;
    entries.sort();
    let mut changed_count: usize = 0;
    let mut unchanged_count: usize = 0;
    for entry in entries {
        match format_file(&entry, &mode).await {
            Ok(changed) => {
                if changed {
                    changed_count += 1;
                } else {
                    unchanged_count += 1;
                }
            }
            Err(error) => {
                log::warn!("Failed to format {}: {}", entry.display(), error);
            }
        }
    }
    match mode {
        FmtMode::Check => {
            if changed_count > 0 {
                bail!(
                    "{} file(s) need formatting. Run `euv fmt` to fix.",
                    changed_count
                );
            }
            log::info!("All {} file(s) are properly formatted.", unchanged_count);
        }
        FmtMode::Write => {
            log::info!(
                "Formatted {} file(s), {} unchanged.",
                changed_count,
                unchanged_count
            );
        }
    }
    Ok(())
}

/// Collects all `.rs` files in a directory recursively.
///
/// # Arguments
///
/// - `&Path` - The directory to search.
///
/// # Returns
///
/// - `Result<Vec<PathBuf>>` - The list of `.rs` file paths.
async fn collect_rs_files(path: &Path) -> Result<Vec<PathBuf>> {
    let mut result: Vec<PathBuf> = Vec::new();
    let mut stack: Vec<PathBuf> = vec![path.to_path_buf()];
    while let Some(dir) = stack.pop() {
        let mut entries: tokio::fs::ReadDir = tokio::fs::read_dir(&dir)
            .await
            .map_err(|error| anyhow!("Failed to read directory '{}': {}", dir.display(), error))?;
        while let Some(entry) = entries
            .next_entry()
            .await
            .map_err(|error| anyhow!("Failed to read entry in '{}': {}", dir.display(), error))?
        {
            let entry_path: PathBuf = entry.path();
            if entry_path.is_dir() {
                let file_name: String = entry_path
                    .file_name()
                    .unwrap_or_default()
                    .to_string_lossy()
                    .to_string();
                if file_name != "target" && file_name != "node_modules" {
                    stack.push(entry_path);
                }
            } else if entry_path.extension().is_some_and(|ext| ext == "rs") {
                result.push(entry_path);
            }
        }
    }
    Ok(result)
}

/// Formats a single Rust source file.
///
/// # Arguments
///
/// - `&Path` - The file path.
/// - `&FmtMode` - Whether to check or write formatting.
///
/// # Returns
///
/// - `Result<bool>` - Whether the file was changed.
async fn format_file(path: &Path, mode: &FmtMode) -> Result<bool> {
    let content: String = tokio::fs::read_to_string(path)
        .await
        .map_err(|error| anyhow!("Failed to read '{}': {}", path.display(), error))?;
    let fmt_result: FmtResult = format_source(&content);
    if fmt_result.changed {
        match mode {
            FmtMode::Write => {
                tokio::fs::write(path, &fmt_result.output)
                    .await
                    .map_err(|error| anyhow!("Failed to write '{}': {}", path.display(), error))?;
                log::info!("Formatted: {}", path.display());
            }
            FmtMode::Check => {
                log::warn!("Needs formatting: {}", path.display());
            }
        }
    }
    Ok(fmt_result.changed)
}