big_code_analysis/metrics/

loc.rs

// Per-language metric and AST modules deliberately consume the macro-
// generated tree-sitter token enums via `use crate::*` and `use Foo::*`
// inside match expressions — explicit imports would list dozens of
// variants per arm and obscure the per-language token sets that are the
// point of these files. Allowed at the module level rather than per
// function so the per-language impl blocks stay readable.
#![allow(
    clippy::enum_glob_use,
    clippy::match_same_arms,
    clippy::struct_field_names,
    clippy::wildcard_imports
)]
// Metric counts (token, function, branch, argument, etc.) are stored as
// `usize` and crossed with `f64` averages, ratios, and Halstead scores
// across the cyclomatic / MI / Halstead computations. The `usize as f64`
// and `f64 as usize` casts are intentional and snapshot-anchored — every
// site is bounded by the count it came from. Allowing the lints at the
// module level keeps the metric arithmetic legible.
#![allow(
    clippy::cast_precision_loss,
    clippy::cast_possible_truncation,
    clippy::cast_sign_loss
)]

use std::collections::HashSet;

use crate::checker::Checker;
use crate::metrics::npa::python_is_block;
use std::fmt;

use crate::macros::implement_metric_trait;
use crate::*;

// Collapse the `usize::MAX` sentinel that `*_min` fields are
// initialised to on `Default` into `0`, so a never-observed space
// serializes to a meaningful number rather than `18446744073709551615`.
// Mirrors `tokens::Stats::tokens_min`'s guard.
#[inline]
fn min_or_zero(v: usize) -> u64 {
    if v == usize::MAX { 0 } else { v as u64 }
}

/// The `SLoc` metric suite.
#[derive(Debug, Clone, PartialEq)]
pub struct Sloc {
    start: usize,
    end: usize,
    unit: bool,
    // Physical lines removed from this space's span by `exclude_tests`
    // pruning. `sloc` is the lone loc sub-metric computed by span
    // subtraction rather than node-by-node accumulation, so a pruned
    // subtree (which a `continue` in the walk suppresses for every
    // accumulated metric) leaves the span untouched. We accumulate the
    // inclusive row count of each pruned subtree here and subtract it
    // in `sloc()` so SLOC drops in step with `ploc`/`cloc`/`lloc`
    // (issue #722).
    excluded_lines: usize,
    sloc_min: usize,
    sloc_max: usize,
}

impl Default for Sloc {
    fn default() -> Self {
        Self {
            start: 0,
            end: 0,
            unit: false,
            excluded_lines: 0,
            sloc_min: usize::MAX,
            sloc_max: 0,
        }
    }
}

impl Sloc {
    /// The `SLOC` metric value for this space (source lines, including blanks and comments).
    #[inline]
    #[must_use]
    pub fn sloc(&self) -> u64 {
        // This metric counts the number of lines in a file
        // The if construct is needed to count the line of code that represents
        // the function signature in a function space
        let span = if self.unit {
            self.end - self.start
        } else {
            (self.end - self.start) + 1
        };
        // Subtract the lines belonging to `exclude_tests`-pruned subtrees
        // (issue #722). `saturating_sub` is defensive: `excluded_lines`
        // can never exceed the span (each pruned subtree is contained in
        // it), but a future caller that double-records a span must not
        // wrap to `u64::MAX`.
        span.saturating_sub(self.excluded_lines) as u64
    }

    /// Records a pruned (`exclude_tests`) subtree's inclusive row span so
    /// that `sloc()` drops in step with the node-accumulated loc
    /// sub-metrics. `start_row`/`end_row` are the pruned node's
    /// `start_row()`/`end_row()`; both endpoints are real source rows, so
    /// the line count is `end_row - start_row + 1`.
    ///
    /// Pruned subtrees are whole Rust items (`mod`/`fn`/`impl`/…) that
    /// rustfmt places on dedicated rows, so they share no physical line
    /// with a retained sibling and their spans are pairwise disjoint (the
    /// walk `continue`s on a pruned node, never descending, so a nested
    /// pruned item is never recorded twice). The counts therefore add
    /// without an interval merge (issue #722).
    #[inline]
    pub(crate) fn exclude_span(&mut self, start_row: usize, end_row: usize) {
        self.excluded_lines += (end_row - start_row) + 1;
    }

    /// The `Sloc` metric minimum value. See `min_or_zero` for the
    /// `usize::MAX` sentinel guard.
    #[inline]
    #[must_use]
    pub fn sloc_min(&self) -> u64 {
        min_or_zero(self.sloc_min)
    }

    /// The `Sloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn sloc_max(&self) -> u64 {
        self.sloc_max as u64
    }

    /// Folds `other` into `self`, updating the min/max accumulators and
    /// accumulating the child's `exclude_tests`-pruned line count.
    #[inline]
    pub fn merge(&mut self, other: &Sloc) {
        // Fold the child's own min/max (not its aggregate `sloc()`), so the
        // granularity of deeply nested function spaces propagates to the
        // root. This matches every sibling metric (cyclomatic, cognitive,
        // exit, nargs, nom, tokens, abc) and fixed issue #437.
        self.sloc_min = self.sloc_min.min(other.sloc_min);
        self.sloc_max = self.sloc_max.max(other.sloc_max);

        // Propagate the child's pruned line count upward so an ancestor's
        // span-based `sloc()` drops by the same lines, mirroring how `Ploc`
        // unions its line-set upward (`Ploc::merge`). The prune hook records
        // each pruned subtree's span only on its innermost enclosing
        // func-space; without this fold a `#[test] fn` inside a retained
        // `impl`/`trait`/closure would shrink only that space's `sloc`,
        // leaving every enclosing space (including the unit, which feeds
        // MI's SLOC term) inflated (issue #741, #722 follow-up). Each
        // ancestor's span already includes the pruned rows exactly once, so
        // subtracting the accumulated count once per level cannot
        // double-count: pruned subtrees never descend, so a nested pruned
        // item is recorded on a single space and folded up one altitude at
        // a time.
        self.excluded_lines += other.excluded_lines;
    }

    #[inline]
    pub(crate) fn compute_minmax(&mut self) {
        // Fold this space's own span unconditionally so containers (Unit,
        // classes) participate in min/max, matching the sibling metrics'
        // convention. Each space runs this before being merged upward, so
        // the guarded form previously here dropped nested leaves (#437).
        self.sloc_min = self.sloc_min.min(self.sloc() as usize);
        self.sloc_max = self.sloc_max.max(self.sloc() as usize);
    }
}

/// The `PLoc` metric suite.
#[derive(Debug, Clone, PartialEq)]
pub struct Ploc {
    lines: HashSet<usize>,
    ploc_min: usize,
    ploc_max: usize,
}

impl Default for Ploc {
    fn default() -> Self {
        Self {
            lines: HashSet::default(),
            ploc_min: usize::MAX,
            ploc_max: 0,
        }
    }
}

impl Ploc {
    /// The `PLOC` metric value for this space (physical lines of code, excluding blanks and comments).
    #[inline]
    #[must_use]
    pub fn ploc(&self) -> u64 {
        // This metric counts the number of instruction lines in a code
        // https://en.wikipedia.org/wiki/Source_lines_of_code
        self.lines.len() as u64
    }

    /// The `Ploc` metric minimum value. See `min_or_zero` for the
    /// `usize::MAX` sentinel guard.
    #[inline]
    #[must_use]
    pub fn ploc_min(&self) -> u64 {
        min_or_zero(self.ploc_min)
    }

    /// The `Ploc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn ploc_max(&self) -> u64 {
        self.ploc_max as u64
    }

    /// Folds `other` into `self`, unioning the line set and updating min/max.
    #[inline]
    pub fn merge(&mut self, other: &Ploc) {
        // Merge ploc lines
        for l in &other.lines {
            self.lines.insert(*l);
        }

        // Fold the child's own min/max so nested spaces propagate (#437).
        self.ploc_min = self.ploc_min.min(other.ploc_min);
        self.ploc_max = self.ploc_max.max(other.ploc_max);
    }

    #[inline]
    pub(crate) fn compute_minmax(&mut self) {
        // Fold this space's own value unconditionally so containers
        // participate, matching the sibling metrics' convention (#437).
        self.ploc_min = self.ploc_min.min(self.ploc() as usize);
        self.ploc_max = self.ploc_max.max(self.ploc() as usize);
    }
}

/// The `CLoc` metric suite.
#[derive(Debug, Clone, PartialEq)]
pub struct Cloc {
    // Physical lines that are comment-only (no code). Feeds both
    // `cloc()` and the `blank` metric (`sloc - ploc - only.len()`).
    // A set rather than a counter so two standalone block comments on
    // one physical line (`/*a*/ /*b*/`) contribute a single comment
    // line, not one per node (issue #461 follow-up). Each spanned row
    // of a genuine multi-line block comment is a distinct key, so it
    // still counts once per line.
    only_comment_line_starts: HashSet<usize>,
    // Physical lines carrying both code and comment (`int x; /*c*/`).
    // A line with several inline block comments (`f(int /*a*/, int
    // /*b*/)`) must contribute a single comment line, not one per
    // node, otherwise cloc can exceed sloc/ploc and push the MI
    // comments_percentage above 100% (issue #461). Mirrors `Ploc`'s
    // per-line de-dup via `Ploc::lines`; disjoint from
    // `only_comment_line_starts` by construction.
    code_comment_line_starts: HashSet<usize>,
    comment_line_end: Option<usize>,
    cloc_min: usize,
    cloc_max: usize,
}

impl Default for Cloc {
    fn default() -> Self {
        Self {
            only_comment_line_starts: HashSet::default(),
            code_comment_line_starts: HashSet::default(),
            comment_line_end: Option::default(),
            cloc_min: usize::MAX,
            cloc_max: 0,
        }
    }
}

impl Cloc {
    /// The `CLOC` metric value for this space (comment lines, standalone + trailing).
    #[inline]
    #[must_use]
    pub fn cloc(&self) -> u64 {
        // Comments are counted regardless of their placement
        // https://en.wikipedia.org/wiki/Source_lines_of_code
        //
        // Derive from the per-physical-line sets rather than summed
        // counters so co-located comments (standalone or inline) count
        // their shared line once and a comment line shared across
        // merged spaces is not double-counted (issue #461). The two
        // sets are disjoint by construction, but a union is used
        // defensively so a stray overlap cannot inflate the count.
        self.only_comment_line_starts
            .union(&self.code_comment_line_starts)
            .count() as u64
    }

    /// The `Cloc` metric minimum value. See `min_or_zero` for the
    /// `usize::MAX` sentinel guard.
    #[inline]
    #[must_use]
    pub fn cloc_min(&self) -> u64 {
        min_or_zero(self.cloc_min)
    }

    /// The `Cloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn cloc_max(&self) -> u64 {
        self.cloc_max as u64
    }

    /// Folds `other` into `self`, summing comment counts and updating min/max.
    #[inline]
    pub fn merge(&mut self, other: &Cloc) {
        // Union both per-line sets so a comment line shared across
        // merged spaces is counted once (mirrors `Ploc`'s line union).
        self.only_comment_line_starts
            .extend(&other.only_comment_line_starts);
        self.code_comment_line_starts
            .extend(&other.code_comment_line_starts);

        // Fold the child's own min/max so nested spaces propagate (#437).
        self.cloc_min = self.cloc_min.min(other.cloc_min);
        self.cloc_max = self.cloc_max.max(other.cloc_max);
    }

    #[inline]
    pub(crate) fn compute_minmax(&mut self) {
        // Fold this space's own value unconditionally so containers
        // participate, matching the sibling metrics' convention (#437).
        self.cloc_min = self.cloc_min.min(self.cloc() as usize);
        self.cloc_max = self.cloc_max.max(self.cloc() as usize);
    }
}

/// The `LLoc` metric suite.
#[derive(Debug, Clone, PartialEq)]
pub struct Lloc {
    logical_lines: usize,
    lloc_min: usize,
    lloc_max: usize,
}

impl Default for Lloc {
    fn default() -> Self {
        Self {
            logical_lines: 0,
            lloc_min: usize::MAX,
            lloc_max: 0,
        }
    }
}

impl Lloc {
    /// The `LLOC` metric value for this space (logical statements).
    #[inline]
    #[must_use]
    pub fn lloc(&self) -> u64 {
        // This metric counts the number of statements in a code
        // https://en.wikipedia.org/wiki/Source_lines_of_code
        self.logical_lines as u64
    }

    /// The `Lloc` metric minimum value. See `min_or_zero` for the
    /// `usize::MAX` sentinel guard.
    #[inline]
    #[must_use]
    pub fn lloc_min(&self) -> u64 {
        min_or_zero(self.lloc_min)
    }

    /// The `Lloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn lloc_max(&self) -> u64 {
        self.lloc_max as u64
    }

    /// Folds `other` into `self`, summing statement counts and updating min/max.
    #[inline]
    pub fn merge(&mut self, other: &Lloc) {
        // Merge lloc lines
        self.logical_lines += other.logical_lines;
        // Fold the child's own min/max so nested spaces propagate (#437).
        self.lloc_min = self.lloc_min.min(other.lloc_min);
        self.lloc_max = self.lloc_max.max(other.lloc_max);
    }

    #[inline]
    pub(crate) fn compute_minmax(&mut self) {
        // Fold this space's own value unconditionally so containers
        // participate, matching the sibling metrics' convention (#437).
        self.lloc_min = self.lloc_min.min(self.lloc() as usize);
        self.lloc_max = self.lloc_max.max(self.lloc() as usize);
    }
}

/// The `Loc` metric suite.
#[derive(Debug, Clone, PartialEq)]
#[non_exhaustive]
pub struct Stats {
    sloc: Sloc,
    ploc: Ploc,
    cloc: Cloc,
    lloc: Lloc,
    space_count: usize,
    blank_min: usize,
    blank_max: usize,
}

impl Default for Stats {
    fn default() -> Self {
        Self {
            sloc: Sloc::default(),
            ploc: Ploc::default(),
            cloc: Cloc::default(),
            lloc: Lloc::default(),
            space_count: 1,
            blank_min: usize::MAX,
            blank_max: 0,
        }
    }
}

impl fmt::Display for Stats {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(
            f,
            "sloc: {}, ploc: {}, lloc: {}, cloc: {}, blank: {}, sloc_average: {}, ploc_average: {}, lloc_average: {}, cloc_average: {}, blank_average: {}, sloc_min: {}, sloc_max: {}, cloc_min: {}, cloc_max: {}, ploc_min: {}, ploc_max: {}, lloc_min: {}, lloc_max: {}, blank_min: {}, blank_max: {}",
            self.sloc(),
            self.ploc(),
            self.lloc(),
            self.cloc(),
            self.blank(),
            self.sloc_average(),
            self.ploc_average(),
            self.lloc_average(),
            self.cloc_average(),
            self.blank_average(),
            self.sloc_min(),
            self.sloc_max(),
            self.cloc_min(),
            self.cloc_max(),
            self.ploc_min(),
            self.ploc_max(),
            self.lloc_min(),
            self.lloc_max(),
            self.blank_min(),
            self.blank_max(),
        )
    }
}

impl Stats {
    /// Test-only constructor that forces a degenerate `cloc`/`sloc`
    /// pair (here `cloc > sloc`) so callers in other metric modules can
    /// exercise downstream clamps without depending on the parsing
    /// pipeline. `cloc <= sloc` always holds for parsed input after
    /// issue #461, so this state is unreachable through normal use.
    #[cfg(test)]
    pub(crate) fn with_cloc_sloc(code_comment_lines: usize, sloc_end_row: usize) -> Self {
        let mut stats = Stats::default();
        stats.sloc.unit = false;
        stats.sloc.start = 0;
        stats.sloc.end = sloc_end_row;
        // Inject `code_comment_lines` distinct synthetic code-comment
        // rows. An offset past `sloc_end_row` keeps them disjoint from
        // any real span row, so `cloc()` (the set's cardinality) equals
        // the requested count without colliding with sloc attribution.
        let synthetic_base = sloc_end_row + 1;
        stats
            .cloc
            .code_comment_line_starts
            .extend(synthetic_base..synthetic_base + code_comment_lines);
        stats
    }

    /// Merges a second `Loc` metric suite into the first one
    pub fn merge(&mut self, other: &Stats) {
        self.sloc.merge(&other.sloc);
        self.ploc.merge(&other.ploc);
        self.cloc.merge(&other.cloc);
        self.lloc.merge(&other.lloc);

        // Count spaces
        self.space_count += other.space_count;

        // Fold the child's own min/max so nested spaces propagate (#437).
        self.blank_min = self.blank_min.min(other.blank_min);
        self.blank_max = self.blank_max.max(other.blank_max);
    }

    /// Records an `exclude_tests`-pruned subtree spanning rows
    /// `start_row..=end_row` so this space's `sloc()` excludes those
    /// physical lines, matching the node-accumulated loc sub-metrics that
    /// the pruning already drops (issue #722). Called from the walker for
    /// the space enclosing each skipped subtree.
    #[inline]
    pub(crate) fn exclude_test_span(&mut self, start_row: usize, end_row: usize) {
        self.sloc.exclude_span(start_row, end_row);
    }

    /// The `Sloc` metric.
    ///
    /// Counts the number of lines in a scope
    #[inline]
    #[must_use]
    pub fn sloc(&self) -> u64 {
        self.sloc.sloc()
    }

    /// The `Ploc` metric.
    ///
    /// Counts the number of instruction lines in a scope
    #[inline]
    #[must_use]
    pub fn ploc(&self) -> u64 {
        self.ploc.ploc()
    }

    /// The `Lloc` metric.
    ///
    /// Counts the number of statements in a scope
    #[inline]
    #[must_use]
    pub fn lloc(&self) -> u64 {
        self.lloc.lloc()
    }

    /// The `Cloc` metric.
    ///
    /// Counts the number of comments in a scope
    #[inline]
    #[must_use]
    pub fn cloc(&self) -> u64 {
        self.cloc.cloc()
    }

    /// The `Blank` metric.
    ///
    /// Counts the number of blank lines in a scope
    #[inline]
    #[must_use]
    pub fn blank(&self) -> u64 {
        // `sloc - ploc - only_comment_lines` can go negative when a space's
        // physical and comment line attribution overlaps the span row count
        // (e.g. single-line bodies). `saturating_sub` clamps at 0 (matching
        // the prior `.max(0.0)` on the f64 form) so the serialized value is
        // never negative (#437).
        self.sloc()
            .saturating_sub(self.ploc())
            .saturating_sub(self.cloc.only_comment_line_starts.len() as u64)
    }

    /// The `Sloc` metric average value.
    ///
    /// This value is computed dividing the `Sloc` value for the number of spaces
    #[inline]
    #[must_use]
    pub fn sloc_average(&self) -> f64 {
        crate::metrics::average(self.sloc() as f64, self.space_count)
    }

    /// The `Ploc` metric average value.
    ///
    /// This value is computed dividing the `Ploc` value for the number of spaces
    #[inline]
    #[must_use]
    pub fn ploc_average(&self) -> f64 {
        crate::metrics::average(self.ploc() as f64, self.space_count)
    }

    /// The `Lloc` metric average value.
    ///
    /// This value is computed dividing the `Lloc` value for the number of spaces
    #[inline]
    #[must_use]
    pub fn lloc_average(&self) -> f64 {
        crate::metrics::average(self.lloc() as f64, self.space_count)
    }

    /// The `Cloc` metric average value.
    ///
    /// This value is computed dividing the `Cloc` value for the number of spaces
    #[inline]
    #[must_use]
    pub fn cloc_average(&self) -> f64 {
        crate::metrics::average(self.cloc() as f64, self.space_count)
    }

    /// The `Blank` metric average value.
    ///
    /// This value is computed dividing the `Blank` value for the number of spaces
    #[inline]
    #[must_use]
    pub fn blank_average(&self) -> f64 {
        crate::metrics::average(self.blank() as f64, self.space_count)
    }

    /// The `Sloc` metric minimum value.
    #[inline]
    #[must_use]
    pub fn sloc_min(&self) -> u64 {
        self.sloc.sloc_min()
    }

    /// The `Sloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn sloc_max(&self) -> u64 {
        self.sloc.sloc_max()
    }

    /// The `Cloc` metric minimum value.
    #[inline]
    #[must_use]
    pub fn cloc_min(&self) -> u64 {
        self.cloc.cloc_min()
    }

    /// The `Cloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn cloc_max(&self) -> u64 {
        self.cloc.cloc_max()
    }

    /// The `Ploc` metric minimum value.
    #[inline]
    #[must_use]
    pub fn ploc_min(&self) -> u64 {
        self.ploc.ploc_min()
    }

    /// The `Ploc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn ploc_max(&self) -> u64 {
        self.ploc.ploc_max()
    }

    /// The `Lloc` metric minimum value.
    #[inline]
    #[must_use]
    pub fn lloc_min(&self) -> u64 {
        self.lloc.lloc_min()
    }

    /// The `Lloc` metric maximum value.
    #[inline]
    #[must_use]
    pub fn lloc_max(&self) -> u64 {
        self.lloc.lloc_max()
    }

    /// The `Blank` metric minimum value. See `min_or_zero` for the
    /// `usize::MAX` sentinel guard.
    #[inline]
    #[must_use]
    pub fn blank_min(&self) -> u64 {
        min_or_zero(self.blank_min)
    }

    /// The `Blank` metric maximum value.
    #[inline]
    #[must_use]
    pub fn blank_max(&self) -> u64 {
        self.blank_max as u64
    }

    #[inline]
    pub(crate) fn compute_minmax(&mut self) {
        self.sloc.compute_minmax();
        self.ploc.compute_minmax();
        self.cloc.compute_minmax();
        self.lloc.compute_minmax();

        // Fold this space's own blank value unconditionally so containers
        // participate, matching the sibling metrics' convention (#437).
        // `blank()` returns a `u64` already clamped at 0 by `saturating_sub`,
        // so the widening `as usize` cast is lossless (64-bit) and cannot
        // introduce a spurious value here.
        self.blank_min = self.blank_min.min(self.blank() as usize);
        self.blank_max = self.blank_max.max(self.blank() as usize);
    }

    pub(crate) fn init_unit_span(&mut self, start: usize, end: usize) {
        self.sloc.start = start;
        self.sloc.end = end;
        self.sloc.unit = true;
    }
}

#[doc(hidden)]
/// Per-language computation of the lines-of-code metrics.
pub(crate) trait Loc
where
    Self: Checker,
{
    /// Walk `node` and update `stats` with this metric for the language
    /// implementing the trait.
    fn compute(node: &Node, stats: &mut Stats, is_func_space: bool, is_unit: bool);
}

mod shared;
pub(crate) use shared::*;

// Real defaults — Loc counts on these "languages" would conflate
// comments / preproc directives with executable code; treating them
// as 0 is the documented behaviour. Audited in #188.
implement_metric_trait!(Loc, PreprocCode, CcommentCode);

mod bash;
mod c;
mod cpp;
mod csharp;
mod elixir;
mod go;
mod groovy;
mod irules;
mod java;
mod javascript;
mod kotlin;
mod lua;
mod mozcpp;
mod mozjs;
mod objc;
mod perl;
mod php;
mod python;
mod ruby;
mod rust;
mod tcl;
mod tsx;
mod typescript;

#[cfg(test)]
#[allow(
    clippy::float_cmp,
    clippy::cast_precision_loss,
    clippy::cast_possible_truncation,
    clippy::cast_sign_loss,
    clippy::similar_names,
    clippy::doc_markdown,
    clippy::needless_raw_string_hashes,
    clippy::too_many_lines
)]
mod tests {
    use crate::tools::check_metrics;

    use super::*;

    /// A `Stats::default()` that never sees an observation must not leak
    /// the `usize::MAX` sentinel for any of the LOC `_min` accumulators
    /// (`sloc_min`, `ploc_min`, `lloc_min`, `cloc_min`, `blank_min`).
    /// The getters collapse the sentinel to `0.0` so JSON never emits
    /// `1.8446744e19`.
    #[test]
    fn loc_empty_file_min_is_zero() {
        let stats = Stats::default();
        assert_eq!(stats.sloc_min(), 0);
        assert_eq!(stats.ploc_min(), 0);
        assert_eq!(stats.lloc_min(), 0);
        assert_eq!(stats.cloc_min(), 0);
        assert_eq!(stats.blank_min(), 0);
    }

    /// Parses `source` with `PerlParser` and asserts the resulting tree has
    /// no `ERROR` nodes. Use alongside metric assertions whose expected
    /// values would happen to match what an error tree produces — a parse
    /// regression in tree-sitter-perl could otherwise leave such tests
    /// silently green.
    #[cfg(test)]
    fn assert_perl_parses_cleanly(source: &str) {
        use crate::traits::ParserTrait;
        // Mirror the trailing-newline normalisation `check_func_space` does
        // before handing input to the parser, so this helper sees the same
        // bytes the metric tests do.
        let path = std::path::PathBuf::from("foo.pl");
        let mut bytes = source.trim_end_matches('\n').as_bytes().to_vec();
        bytes.push(b'\n');
        let parser = PerlParser::new(bytes, &path, None);
        assert!(
            !parser.root().has_error(),
            "tree-sitter-perl returned an error tree for snippet:\n{source}"
        );
    }

    #[test]
    fn python_sloc() {
        check_metrics::<PythonParser>(
            "

            a = 42

            ",
            "foo.py",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 1,
                  "ploc": 1,
                  "lloc": 1,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 1.0,
                  "ploc_average": 1.0,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 1,
                  "sloc_max": 1,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_blank() {
        check_metrics::<PythonParser>(
            "
            a = 42

            b = 43

            ",
            "foo.py",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_blank() {
        check_metrics::<RustParser>(
            "

            let a = 42;

            let b = 43;

            ",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );

        check_metrics::<RustParser>("fn func() { /* comment */ }", "foo.rs", |metric| {
            // Spaces: 2
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 0,
              "cloc": 1,
              "blank": 0,
              "sloc_average": 0.5,
              "ploc_average": 0.5,
              "lloc_average": 0.0,
              "cloc_average": 0.5,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 1,
              "cloc_max": 1,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 0,
              "lloc_max": 0,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn c_blank() {
        check_metrics::<CParser>(
            "

            int a = 42;

            int b = 43;

            ",
            "foo.c",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_no_zero_blank() {
        // Checks that the blank metric is not equal to 0 when there are some
        // comments next to code lines.
        check_metrics::<PythonParser>(
            "def ConnectToUpdateServer():
                 pool = 4

                 updateServer = -42
                 isConnected = False
                 currTry = 0
                 numRetries = 10 # Number of IPC connection retries before
                                 # giving up.
                 numTries = 20 # Number of IPC connection tries before
                               # giving up.",
            "foo.py",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 10,
                  "ploc": 7,
                  "lloc": 6,
                  "cloc": 4,
                  "blank": 1,
                  "sloc_average": 5.0,
                  "ploc_average": 3.5,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.5,
                  "sloc_min": 10,
                  "sloc_max": 10,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 7,
                  "ploc_max": 7,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_no_blank() {
        // Checks that the blank metric is equal to 0 when there are no blank
        // lines and there are comments next to code lines.
        check_metrics::<PythonParser>(
            "def ConnectToUpdateServer():
                 pool = 4
                 updateServer = -42
                 isConnected = False
                 currTry = 0
                 numRetries = 10 # Number of IPC connection retries before
                                 # giving up.
                 numTries = 20 # Number of IPC connection tries before
                               # giving up.",
            "foo.py",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 9,
                  "ploc": 7,
                  "lloc": 6,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 4.5,
                  "ploc_average": 3.5,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.0,
                  "sloc_min": 9,
                  "sloc_max": 9,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 7,
                  "ploc_max": 7,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_no_zero_blank_more_comments() {
        // Checks that the blank metric is not equal to 0 when there are more
        // comments next to code lines compared to the previous tests.
        check_metrics::<PythonParser>(
            "def ConnectToUpdateServer():
                 pool = 4

                 updateServer = -42
                 isConnected = False
                 currTry = 0 # Set this variable to 0
                 numRetries = 10 # Number of IPC connection retries before
                                 # giving up.
                 numTries = 20 # Number of IPC connection tries before
                               # giving up.",
            "foo.py",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 10,
                  "ploc": 7,
                  "lloc": 6,
                  "cloc": 5,
                  "blank": 1,
                  "sloc_average": 5.0,
                  "ploc_average": 3.5,
                  "lloc_average": 3.0,
                  "cloc_average": 2.5,
                  "blank_average": 0.5,
                  "sloc_min": 10,
                  "sloc_max": 10,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 7,
                  "ploc_max": 7,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_no_zero_blank() {
        // Checks that the blank metric is not equal to 0 when there are some
        // comments next to code lines.
        check_metrics::<RustParser>(
            "fn ConnectToUpdateServer() {
              let pool = 0;

              let updateServer = -42;
              let isConnected = false;
              let currTry = 0;
              let numRetries = 10;  // Number of IPC connection retries before
                                    // giving up.
              let numTries = 20;    // Number of IPC connection tries before
                                    // giving up.
            }",
            "foo.rs",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 4,
                  "blank": 1,
                  "sloc_average": 5.5,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.5,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn javascript_no_zero_blank() {
        // Checks that the blank metric is not equal to 0 when there are some
        // comments next to code lines.
        check_metrics::<JavascriptParser>(
            "function ConnectToUpdateServer() {
              var pool = 0;

              var updateServer = -42;
              var isConnected = false;
              var currTry = 0;
              var numRetries = 10;  // Number of IPC connection retries before
                                    // giving up.
              var numTries = 20;    // Number of IPC connection tries before
                                    // giving up.
            }",
            "foo.js",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 8,
                  "lloc": 0,
                  "cloc": 4,
                  "blank": 1,
                  "sloc_average": 5.5,
                  "ploc_average": 4.0,
                  "lloc_average": 0.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.5,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 0,
                  "lloc_max": 0,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_no_zero_blank() {
        // Checks that the blank metric is not equal to 0 when there are some
        // comments next to code lines.
        check_metrics::<CppParser>(
            "void ConnectToUpdateServer() {
              int pool;

              int updateServer = -42;
              bool isConnected = false;
              int currTry = 0;
              const int numRetries = 10; // Number of IPC connection retries before
                                         // giving up.
              const int numTries = 20; // Number of IPC connection tries before
                                       // giving up.
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 4,
                  "blank": 1,
                  "sloc_average": 5.5,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.5,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_code_line_start_block_blank() {
        // Checks that the blank metric is equal to 1 when there are
        // block comments starting next to code lines.
        check_metrics::<CppParser>(
            "void ConnectToUpdateServer() {
              int pool;

              int updateServer = -42;
              bool isConnected = false;
              int currTry = 0;
              const int numRetries = 10; /* Number of IPC connection retries
              before
              giving up. */
              const int numTries = 20; // Number of IPC connection tries before
                                       // giving up.
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 12,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 5,
                  "blank": 1,
                  "sloc_average": 6.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.5,
                  "blank_average": 0.5,
                  "sloc_min": 12,
                  "sloc_max": 12,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_block_comment_blank() {
        // Checks that the blank metric is equal to 1 when there are
        // block comments on independent lines.
        check_metrics::<CppParser>(
            "void ConnectToUpdateServer() {
              int pool;

              int updateServer = -42;
              bool isConnected = false;
              int currTry = 0;
              /* Number of IPC connection retries
              before
              giving up. */
              const int numRetries = 10;
              const int numTries = 20; // Number of IPC connection tries before
                                       // giving up.
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 13,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 5,
                  "blank": 1,
                  "sloc_average": 6.5,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.5,
                  "blank_average": 0.5,
                  "sloc_min": 13,
                  "sloc_max": 13,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_code_line_block_one_line_blank() {
        // Checks that the blank metric is equal to 1 when there are
        // block comments before the same code line.
        check_metrics::<CppParser>(
            "void ConnectToUpdateServer() {
              int pool;

              int updateServer = -42;
              bool isConnected = false;
              int currTry = 0;
              /* Number of IPC connection retries before giving up. */ const int numRetries = 10;
              const int numTries = 20; // Number of IPC connection tries before
                                       // giving up.
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 10,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 5.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 1.5,
                  "blank_average": 0.5,
                  "sloc_min": 10,
                  "sloc_max": 10,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_code_line_end_block_blank() {
        // Checks that the blank metric is equal to 1 when there are
        // block comments ending next to code lines.
        check_metrics::<CppParser>(
            "void ConnectToUpdateServer() {
              int pool;

              int updateServer = -42;
              bool isConnected = false;
              int currTry = 0;
              /* Number of IPC connection retries
              before
              giving up. */ const int numRetries = 10;
              const int numTries = 20; // Number of IPC connection tries before
                                       // giving up.
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 12,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 5,
                  "blank": 1,
                  "sloc_average": 6.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.5,
                  "blank_average": 0.5,
                  "sloc_min": 12,
                  "sloc_max": 12,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_cloc() {
        check_metrics::<PythonParser>(
            "\"\"\"Block comment
            Block comment
            \"\"\"
            # Line Comment
            a = 42 # Line Comment",
            "foo.py",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 1,
                  "lloc": 2,
                  "cloc": 5,
                  "blank": 0,
                  "sloc_average": 5.0,
                  "ploc_average": 1.0,
                  "lloc_average": 2.0,
                  "cloc_average": 5.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_cloc() {
        check_metrics::<RustParser>(
            "/*Block comment
            Block Comment*/
            //Line Comment
            /*Block Comment*/ let a = 42; // Line Comment",
            "foo.rs",
            |metric| {
                // Spaces: 1
                // expected: cloc = 4 — the 2-line block (lines 1-2) and
                // the standalone `//Line Comment` (line 3) give 3
                // only-comment lines; line 4 carries a leading block
                // comment AND a trailing line comment but is one
                // physical code line, so it adds a single code-comment
                // line, not two (issue #461). Pre-fix this reported 5,
                // violating cloc <= sloc (sloc = 4).
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 1,
                  "lloc": 1,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 1.0,
                  "lloc_average": 1.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn c_cloc() {
        check_metrics::<CParser>(
            "/*Block comment
            Block Comment*/
            //Line Comment
            /*Block Comment*/ int a = 42; // Line Comment",
            "foo.c",
            |metric| {
                // Spaces: 1
                // expected: cloc = 4 — see `rust_cloc`; line 4's leading
                // block comment and trailing line comment share one
                // physical code line and add a single code-comment line
                // (issue #461). Pre-fix reported 5 (cloc > sloc = 4).
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 1,
                  "lloc": 1,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 1.0,
                  "lloc_average": 1.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_lloc() {
        check_metrics::<PythonParser>(
            "for x in range(0,42):
                if x % 2 == 0:
                    print(x)",
            "foo.py",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_lloc() {
        check_metrics::<RustParser>(
            "for x in 0..42 {
                if x % 2 == 0 {
                    println!(\"{}\", x);
                }
             }",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 5.0,
                  "ploc_average": 5.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );

        // LLOC returns three because there is an empty Rust statement
        check_metrics::<RustParser>(
            "let a = 42;
             if true {
                42
             } else {
                43
             };",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 6,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 6.0,
                  "ploc_average": 6.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 6,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn c_lloc() {
        check_metrics::<CParser>(
            "for (;;)
                break;",
            "foo.c",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 2,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 2,
                  "sloc_max": 2,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_lloc() {
        check_metrics::<CppParser>(
            "nsTArray<xpcGCCallback> callbacks(extraGCCallbacks.Clone());
             for (uint32_t i = 0; i < callbacks.Length(); ++i) {
                 callbacks[i](status);
             }",
            "foo.cpp",
            |metric| {
                // Spaces: 1
                // lloc: nsTArray, for, callbacks
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_return_lloc() {
        check_metrics::<CppParser>(
            "uint8_t* pixel_data = frame.GetFrameDataAtPos(DesktopVector(x, y));
             return RgbaColor(pixel_data) == blank_pixel_;",
            "foo.cpp",
            |metric| {
                // Spaces: 1
                // lloc: pixel_data, return
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 2,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 2,
                  "sloc_max": 2,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_for_lloc() {
        check_metrics::<CppParser>(
            "for (; start != end; ++start) {
                 const unsigned char idx = *start;
                 if (idx > 127 || !kValidTokenMap[idx]) return false;
             }",
            "foo.cpp",
            |metric| {
                // Spaces: 1
                // lloc: for, idx, if, return
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 4,
                  "lloc": 4,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 4.0,
                  "lloc_average": 4.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_while_lloc() {
        check_metrics::<CppParser>(
            "while (sHeapAtoms) {
                 HttpHeapAtom* next = sHeapAtoms->next;
                 free(sHeapAtoms);
            }",
            "foo.cpp",
            |metric| {
                // Spaces: 1
                // lloc: while, next, free
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_string_on_new_line() {
        // More lines of the same instruction were counted as blank lines
        check_metrics::<PythonParser>(
            "capabilities[\"goog:chromeOptions\"][\"androidPackage\"] = \\
                \"org.chromium.weblayer.shell\"",
            "foo.py",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 2,
                  "ploc": 2,
                  "lloc": 1,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.0,
                  "ploc_average": 2.0,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 2,
                  "sloc_max": 2,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_multiline_string_assignment_ploc() {
        // Regression test for issue #415: interior rows of a multi-line,
        // non-docstring string literal were mis-counted as blank lines.
        check_metrics::<PythonParser>(
            "QUERY = \"\"\"
SELECT id, name
FROM users
WHERE active = 1
ORDER BY name
\"\"\"",
            "foo.py",
            |metric| {
                // Spaces: 1. Six physical lines, all code, no blanks.
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 6,
                  "lloc": 1,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 6.0,
                  "ploc_average": 6.0,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 6,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_multiline_string_argument_ploc() {
        // Regression test for issue #415: a multi-line string passed as a call
        // argument must have all its rows counted as code, not blank.
        check_metrics::<PythonParser>(
            "print(\"\"\"
line one
line two
\"\"\")",
            "foo.py",
            |metric| {
                // Spaces: 1. Four physical lines, all code, no blanks.
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn python_single_line_string_assignment_ploc() {
        // Single-line, non-docstring string: behaviour must be unchanged by
        // the issue #415 fix (start == end means no extra rows are inserted).
        check_metrics::<PythonParser>("QUERY = \"SELECT 1\"", "foo.py", |metric| {
            // Spaces: 1.
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
        });
    }

    #[test]
    fn python_multiline_docstring_still_cloc() {
        // The fix for issue #415 must leave docstring classification unchanged:
        // a bare triple-quoted string statement is still counted as comments.
        check_metrics::<PythonParser>(
            "def f():
    \"\"\"Docstring line one
    Docstring line two
    \"\"\"
    return 1",
            "foo.py",
            |metric| {
                // Spaces: 2 (module + function). The three docstring rows are
                // comment lines, not code or blank lines.
                assert_eq!(metric.loc.cloc(), 3);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn rust_no_field_expression_lloc() {
        check_metrics::<RustParser>(
            "struct Foo {
                field: usize,
             }
             let foo = Foo { 42 };
             foo.field;",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 5.0,
                  "ploc_average": 5.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_no_parenthesized_expression_lloc() {
        check_metrics::<RustParser>("let a = (42 + 0);", "foo.rs", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn rust_no_array_expression_lloc() {
        check_metrics::<RustParser>("let a = [0; 42];", "foo.rs", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn rust_no_tuple_expression_lloc() {
        check_metrics::<RustParser>("let a = (0, 42);", "foo.rs", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn rust_no_unit_expression_lloc() {
        check_metrics::<RustParser>("let a = ();", "foo.rs", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn rust_call_function_lloc() {
        check_metrics::<RustParser>(
            "let a = foo(); // +1
             foo(); // +1
             k!(foo()); // +1",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 3,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 3.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_macro_invocation_lloc() {
        check_metrics::<RustParser>(
            "let a = foo!(); // +1
             foo!(); // +1
             k(foo!()); // +1",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 3,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 3.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_function_in_loop_lloc() {
        check_metrics::<RustParser>(
            "for (a, b) in c.iter().enumerate() {} // +1
             while (a, b) in c.iter().enumerate() {} // +1
             while let Some(a) = c.strip_prefix(\"hi\") {} // +1",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 3,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 3.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_function_in_if_lloc() {
        check_metrics::<RustParser>(
            "if foo() {} // +1
             if let Some(a) = foo() {} // +1",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 2,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 0,
                  "sloc_average": 2.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.0,
                  "sloc_min": 2,
                  "sloc_max": 2,
                  "cloc_min": 2,
                  "cloc_max": 2,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_function_in_return_lloc() {
        check_metrics::<RustParser>(
            "return foo();
             await foo();",
            "foo.rs",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 2,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 2,
                  "sloc_max": 2,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn rust_closure_expression_lloc() {
        check_metrics::<RustParser>(
            "let a = |i: i32| -> i32 { i + 1 }; // +1
             a(42); // +1
             k(b.iter().map(|n| n.parse.ok().unwrap_or(42))); // +1",
            "foo.rs",
            |metric| {
                // Spaces: 3
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 3,
                  "blank": 0,
                  "sloc_average": 1.0,
                  "ploc_average": 1.0,
                  "lloc_average": 1.0,
                  "cloc_average": 1.0,
                  "blank_average": 0.0,
                  "sloc_min": 1,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 3,
                  "ploc_min": 1,
                  "ploc_max": 3,
                  "lloc_min": 0,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_general_loc() {
        check_metrics::<PythonParser>(
            "def func(a,
                      b,
                      c):
                 print(a)
                 print(b)
                 print(c)",
            "foo.py",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 6,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 1.5,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 6,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn python_real_loc() {
        check_metrics::<PythonParser>(
            "def web_socket_transfer_data(request):
                while True:
                    line = request.ws_stream.receive_message()
                    if line is None:
                        return
                    code, reason = line.split(' ', 1)
                    if code is None or reason is None:
                        return
                    request.ws_stream.close_connection(int(code), reason)
                    # close_connection() initiates closing handshake. It validates code
                    # and reason. If you want to send a broken close frame for a test,
                    # following code will be useful.
                    # > data = struct.pack('!H', int(code)) + reason.encode('UTF-8')
                    # > request.connection.write(stream.create_close_frame(data))
                    # > # Suppress to re-respond client responding close frame.
                    # > raise Exception(\"customized server initiated closing handshake\")",
            "foo.py",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 16,
                  "ploc": 9,
                  "lloc": 8,
                  "cloc": 7,
                  "blank": 0,
                  "sloc_average": 8.0,
                  "ploc_average": 4.5,
                  "lloc_average": 4.0,
                  "cloc_average": 3.5,
                  "blank_average": 0.0,
                  "sloc_min": 16,
                  "sloc_max": 16,
                  "cloc_min": 7,
                  "cloc_max": 7,
                  "ploc_min": 9,
                  "ploc_max": 9,
                  "lloc_min": 8,
                  "lloc_max": 8,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn javascript_real_loc() {
        check_metrics::<JavascriptParser>(
            "assert.throws(Test262Error, function() {
               for (let { poisoned: x = ++initEvalCount } = poisonedProperty; ; ) {
                 return;
               }
             });",
            "foo.js",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 4,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.5,
                  "ploc_average": 2.5,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 3,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn mozjs_real_loc() {
        check_metrics::<MozjsParser>(
            "assert.throws(Test262Error, function() {
               for (let { poisoned: x = ++initEvalCount } = poisonedProperty; ; ) {
                 return;
               }
             });",
            "foo.js",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 4,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.5,
                  "ploc_average": 2.5,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 3,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn mozjs_blank_and_comment_loc() {
        check_metrics::<MozjsParser>(
            "// a comment
             function f() {

                 var x = 1;

             }",
            "foo.js",
            |metric| {
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 3,
                  "lloc": 0,
                  "cloc": 1,
                  "blank": 2,
                  "sloc_average": 3.0,
                  "ploc_average": 1.5,
                  "lloc_average": 0.0,
                  "cloc_average": 0.5,
                  "blank_average": 1.0,
                  "sloc_min": 5,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 1,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 0,
                  "lloc_max": 0,
                  "blank_min": 2,
                  "blank_max": 2
                }
                "#
                );
            },
        );
    }

    #[test]
    fn cpp_namespace_loc() {
        check_metrics::<CppParser>(
            "namespace mozilla::dom::quota {} // namespace mozilla::dom::quota",
            "foo.cpp",
            |metric| {
                // Spaces: 2
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 1,
                  "ploc": 1,
                  "lloc": 0,
                  "cloc": 1,
                  "blank": 0,
                  "sloc_average": 0.5,
                  "ploc_average": 0.5,
                  "lloc_average": 0.0,
                  "cloc_average": 0.5,
                  "blank_average": 0.0,
                  "sloc_min": 1,
                  "sloc_max": 1,
                  "cloc_min": 0,
                  "cloc_max": 1,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 0,
                  "lloc_max": 0,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_comments() {
        check_metrics::<JavaParser>(
            "for (int i = 0; i < 100; i++) { \
               // Print hello
               System.out.println(\"hello\"); \
               // Print world
               System.out.println(\"hello\"); \
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 2,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 2,
                  "cloc_max": 2,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_blank() {
        check_metrics::<JavaParser>(
            "int x = 1;


            int y = 2;",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 2,
                  "sloc_average": 4.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 2.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 2,
                  "blank_max": 2
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_sloc() {
        check_metrics::<JavaParser>(
            "for (int i = 0; i < 100; i++) {
               System.out.println(i);
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_module_sloc() {
        check_metrics::<JavaParser>(
            "module helloworld{
              exports com.test;
            }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 0,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 0.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 0,
                  "lloc_max": 0,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_single_ploc() {
        check_metrics::<JavaParser>("int x = 1;", "foo.java", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn java_simple_ploc() {
        check_metrics::<JavaParser>(
            "for (int i = 0; i < 100; i = i++) {
               System.out.println(i);
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_multi_ploc() {
        check_metrics::<JavaParser>(
            "int x = 1;
            for (int i = 0; i < 100; i++) {
               System.out.println(i);
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_single_statement_lloc() {
        check_metrics::<JavaParser>("int max = 10;", "foo.java", |metric| {
            // Spaces: 1
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
            {
              "sloc": 1,
              "ploc": 1,
              "lloc": 1,
              "cloc": 0,
              "blank": 0,
              "sloc_average": 1.0,
              "ploc_average": 1.0,
              "lloc_average": 1.0,
              "cloc_average": 0.0,
              "blank_average": 0.0,
              "sloc_min": 1,
              "sloc_max": 1,
              "cloc_min": 0,
              "cloc_max": 0,
              "ploc_min": 1,
              "ploc_max": 1,
              "lloc_min": 1,
              "lloc_max": 1,
              "blank_min": 0,
              "blank_max": 0
            }
            "#
            );
        });
    }

    #[test]
    fn java_for_lloc() {
        check_metrics::<JavaParser>(
            "for (int i = 0; i < 100; i++) { // + 1
               System.out.println(i); // + 1
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 2.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 2,
                  "cloc_max": 2,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_foreach_lloc() {
        check_metrics::<JavaParser>(
            "
            int arr[]={12,13,14,44}; // +1
            for (int i:arr) { // +1
               System.out.println(i); // +1
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 4,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 3,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 3.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_while_lloc() {
        check_metrics::<JavaParser>(
            "
            int i=0; // +1
            while(i < 10) { // +1
                i++; // +1
                System.out.println(i); // +1
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 4,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 5.0,
                  "ploc_average": 5.0,
                  "lloc_average": 4.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_do_while_lloc() {
        check_metrics::<JavaParser>(
            "
            int i=0; // +1
            do { // +1
                i++; // +1
                System.out.println(i); // +1
             } while(i < 10)",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 4,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 5.0,
                  "ploc_average": 5.0,
                  "lloc_average": 4.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_switch_lloc() {
        check_metrics::<JavaParser>(
            "switch(grade) { // +1
                case 'A' :
                   System.out.println(\"Pass with distinction\"); // +1
                   break; // +1
                case 'B' :
                case 'C' :
                   System.out.println(\"Pass\"); // +1
                   break; // +1
                case 'D' :
                   System.out.println(\"At risk\"); // +1
                case 'F' :
                   System.out.println(\"Fail\"); // +1
                   break; // +1
                default :
                   System.out.println(\"Invalid grade\"); // +1
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 16,
                  "ploc": 16,
                  "lloc": 9,
                  "cloc": 9,
                  "blank": 0,
                  "sloc_average": 16.0,
                  "ploc_average": 16.0,
                  "lloc_average": 9.0,
                  "cloc_average": 9.0,
                  "blank_average": 0.0,
                  "sloc_min": 16,
                  "sloc_max": 16,
                  "cloc_min": 9,
                  "cloc_max": 9,
                  "ploc_min": 16,
                  "ploc_max": 16,
                  "lloc_min": 9,
                  "lloc_max": 9,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_continue_lloc() {
        check_metrics::<JavaParser>(
            "int max = 10; // +1

            for (int i = 0; i < max; i++) { // +1
                if(i % 2 == 0) { continue;} + 2
                System.out.println(i); // +1
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 5,
                  "lloc": 5,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 6.0,
                  "ploc_average": 5.0,
                  "lloc_average": 5.0,
                  "cloc_average": 3.0,
                  "blank_average": 1.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 3,
                  "cloc_max": 3,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 5,
                  "lloc_max": 5,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_try_lloc() {
        check_metrics::<JavaParser>(
            "try { // +1
                int[] myNumbers = {1, 2, 3}; // +1
                System.out.println(myNumbers[10]); // +1
              } catch (Exception e) {
                System.out.println(e.getMessage()); // +1
                throw e; // +1
              }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 7,
                  "ploc": 7,
                  "lloc": 5,
                  "cloc": 5,
                  "blank": 0,
                  "sloc_average": 7.0,
                  "ploc_average": 7.0,
                  "lloc_average": 5.0,
                  "cloc_average": 5.0,
                  "blank_average": 0.0,
                  "sloc_min": 7,
                  "sloc_max": 7,
                  "cloc_min": 5,
                  "cloc_max": 5,
                  "ploc_min": 7,
                  "ploc_max": 7,
                  "lloc_min": 5,
                  "lloc_max": 5,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_class_loc() {
        check_metrics::<JavaParser>(
            "
            public class Person {
              private String name;
              public Person(String name){
                this.name = name; // +1
              }
              public String getName() {
                return name; // +1
              }
            }",
            "foo.java",
            |metric| {
                // Spaces: 4
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 9,
                  "ploc": 9,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 0,
                  "sloc_average": 2.25,
                  "ploc_average": 2.25,
                  "lloc_average": 0.5,
                  "cloc_average": 0.5,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 9,
                  "cloc_min": 1,
                  "cloc_max": 2,
                  "ploc_min": 3,
                  "ploc_max": 9,
                  "lloc_min": 1,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_expressions_lloc() {
        check_metrics::<JavaParser>(
            "int x = 10;                                                            // +1 local var declaration
            x=+89;                                                                  // +1 expression statement
            int y = x * 2;                                                          // +1 local var declaration
            IntFunction double = (n) -> n*2;                                        // +1 local var declaration
            int y2 = double(x);                                                     // +1 local var declaration
            System.out.println(\"double \" + x + \" = \" + y2);                     // +1 expression statement
            String message = (x % 2) == 0 ? \"Evenly done.\" : \"Oddly done.\";     // +1 local var declaration
            Object done = (Runnable) () -> { System.out.println(\"Done!\"); };      // +2 local var declaration + expression statement
            String s = \"string\";                                                  // +1 local var declaration
            boolean isS = (s instanceof String);                                    // +1 local var declaration
            done.run();                                                             // +1 expression statement
            ",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 11,
                  "lloc": 12,
                  "cloc": 11,
                  "blank": 0,
                  "sloc_average": 11.0,
                  "ploc_average": 11.0,
                  "lloc_average": 12.0,
                  "cloc_average": 11.0,
                  "blank_average": 0.0,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 11,
                  "cloc_max": 11,
                  "ploc_min": 11,
                  "ploc_max": 11,
                  "lloc_min": 12,
                  "lloc_max": 12,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_statement_inline_loc() {
        check_metrics::<JavaParser>(
            "for (int i = 0; i < 100; i++) { System.out.println(\"hello\"); }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 1,
                  "ploc": 1,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 1.0,
                  "ploc_average": 1.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 1,
                  "sloc_max": 1,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_general_loc() {
        check_metrics::<JavaParser>(
            "int max = 100;

            /*
              Loop through and print
                from: 0
                to: max
            */
            for (int i = 0; i < max; i++) {
               // Print the value
               System.out.println(i);
             }",
            "foo.java",
            |metric| {
                // Spaces: 1
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 6,
                  "blank": 1,
                  "sloc_average": 11.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 6.0,
                  "blank_average": 1.0,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 6,
                  "cloc_max": 6,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn java_main_class_loc() {
        check_metrics::<JavaParser>(
            "package com.company;
             /**
             * The HelloWorldApp class implements an application that
             * simply prints \"Hello World!\" to standard output.
             */

            class HelloWorldApp {
              public void main(String[] args) {
                String message = args.length == 0 ? \"Hello empty world\" : \"Hello world\"; // +1 lloc : 1 var assignment
                System.out.println(message); // Display the string. +1 lloc
              }
            }",
            "foo.java",
            |metric| {
                // Spaces: 3
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 12,
                  "ploc": 7,
                  "lloc": 2,
                  "cloc": 6,
                  "blank": 1,
                  "sloc_average": 4.0,
                  "ploc_average": 2.3333333333333335,
                  "lloc_average": 0.6666666666666666,
                  "cloc_average": 2.0,
                  "blank_average": 0.3333333333333333,
                  "sloc_min": 4,
                  "sloc_max": 12,
                  "cloc_min": 2,
                  "cloc_max": 6,
                  "ploc_min": 4,
                  "ploc_max": 7,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_general_loc() {
        check_metrics::<GoParser>(
            "package main

            // entrypoint
            func main() {
                /* loop body */
                for i := 0; i < 10; i++ {
                    fmt.Println(i)
                }
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + main).
                // lloc: for_statement (+1), fmt.Println expression (+1).
                //       `i := 0` and `i++` inside the for-clause are gated.
                // cloc: 2 comments (line + block).
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 9,
                  "ploc": 6,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 1,
                  "sloc_average": 4.5,
                  "ploc_average": 3.0,
                  "lloc_average": 1.0,
                  "cloc_average": 1.0,
                  "blank_average": 0.5,
                  "sloc_min": 6,
                  "sloc_max": 9,
                  "cloc_min": 1,
                  "cloc_max": 2,
                  "ploc_min": 5,
                  "ploc_max": 6,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_for_clause_does_not_double_count_lloc() {
        // Bare `for` body has only a return; the `for_statement` itself is the
        // single logical line. Confirms ShortVarDeclaration in a for-clause
        // does not add an extra lloc.
        check_metrics::<GoParser>(
            "package main
            func f(n int) int {
                for i := 0; i < n; i++ {
                    return i
                }
                return 0
            }",
            "foo.go",
            |metric| {
                // Expected lloc: for (+1), return (+1), return (+1) = 3.
                // Without the gate, ShortVarDeclaration would add an extra (+1).
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn go_blank() {
        check_metrics::<GoParser>(
            "package main

            func foo() {
                x := 1

                y := 2
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // blank: 2 (lines 2 and 5 are empty).
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 7,
                  "ploc": 5,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 2,
                  "sloc_average": 3.5,
                  "ploc_average": 2.5,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 5,
                  "sloc_max": 7,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 5,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 2
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_cloc_line_comments() {
        check_metrics::<GoParser>(
            "package main

            // helper adds two numbers.
            // It returns their sum.
            func add(a, b int) int {
                // compute the result
                return a + b
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + add).
                // cloc: 3 lines with `//` comments.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 8,
                  "ploc": 4,
                  "lloc": 1,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 4.0,
                  "ploc_average": 2.0,
                  "lloc_average": 0.5,
                  "cloc_average": 1.5,
                  "blank_average": 0.5,
                  "sloc_min": 4,
                  "sloc_max": 8,
                  "cloc_min": 1,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 4,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_cloc_block_comments() {
        check_metrics::<GoParser>(
            "package main

            /* block comment
               spanning two lines */
            func foo() {
                x := 1 /* inline block */
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // cloc: 2-line block comment + inline block = 3 comment lines.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 7,
                  "ploc": 4,
                  "lloc": 1,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 3.5,
                  "ploc_average": 2.0,
                  "lloc_average": 0.5,
                  "cloc_average": 1.5,
                  "blank_average": 0.5,
                  "sloc_min": 3,
                  "sloc_max": 7,
                  "cloc_min": 1,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 4,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_lloc_if_for_switch() {
        check_metrics::<GoParser>(
            "package main

            func foo(n int) int {
                if n > 0 {
                    for i := 0; i < n; i++ {
                        switch i {
                        }
                    }
                }
                return n
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // lloc: if (+1), for (+1), switch (+1), return (+1) = 4.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 10,
                  "lloc": 4,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 5.5,
                  "ploc_average": 5.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 9,
                  "sloc_max": 11,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 9,
                  "ploc_max": 10,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_lloc_go_defer() {
        check_metrics::<GoParser>(
            "package main

            func foo() {
                go run()
                defer cleanup()
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // lloc: go (+1), defer (+1) = 2.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 5,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.5,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 4,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 4,
                  "ploc_max": 5,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_lloc_var_const_declarations() {
        check_metrics::<GoParser>(
            "package main

            func foo() {
                var x int
                var y = 10
                const z = 42
                a := 3
                a = 4
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // lloc: var (+1), var (+1), const (+1),
                //       short_var_decl (+1), assignment (+1) = 5.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 9,
                  "ploc": 8,
                  "lloc": 5,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 4.5,
                  "ploc_average": 4.0,
                  "lloc_average": 2.5,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 7,
                  "sloc_max": 9,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 7,
                  "ploc_max": 8,
                  "lloc_min": 5,
                  "lloc_max": 5,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_lloc_select() {
        check_metrics::<GoParser>(
            "package main

            func foo(ch chan int) {
                select {
                case v := <-ch:
                    _ = v
                }
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // lloc: select (+1), assignment `_ = v` (+1) = 2.
                // `case v := <-ch:` is a receive_statement inside a
                // communication_case, not a ShortVarDeclaration.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 8,
                  "ploc": 7,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 4.0,
                  "ploc_average": 3.5,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 6,
                  "sloc_max": 8,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 7,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_sloc_multiline_function() {
        check_metrics::<GoParser>(
            "package main

            func add(
                a int,
                b int,
            ) int {
                return a + b
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + add).
                // The multi-line signature should count each line as sloc.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 8,
                  "ploc": 7,
                  "lloc": 1,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 4.0,
                  "ploc_average": 3.5,
                  "lloc_average": 0.5,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 6,
                  "sloc_max": 8,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 7,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn go_code_comment_same_line() {
        check_metrics::<GoParser>(
            "package main

            func foo() {
                x := 1 // initialize x
                y := 2 // initialize y
            }",
            "foo.go",
            |metric| {
                // Spaces: 2 (unit + foo).
                // cloc: 2 (inline comments on code lines).
                // blank: 1 (line between package and func).
                // The code+comment lines should count for both ploc and cloc.
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 5,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.5,
                  "lloc_average": 1.0,
                  "cloc_average": 1.0,
                  "blank_average": 0.5,
                  "sloc_min": 4,
                  "sloc_max": 6,
                  "cloc_min": 2,
                  "cloc_max": 2,
                  "ploc_min": 4,
                  "ploc_max": 5,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn perl_grammar_smoke() {
        // Pin the contract that tree-sitter-perl 1.1.2 cleanly parses every
        // Perl construct exercised by the rest of the `perl_*` test suite.
        // If a future grammar bump turns one of these into an error tree,
        // the metric assertions might still pass numerically by coincidence;
        // this test fails loudly instead.
        assert_perl_parses_cleanly(
            "use strict;
use warnings;

# line comment

=pod
multi-line POD
=cut

sub factorial {
    my ($n) = @_;
    return 1 if $n <= 1;
    return $n * factorial($n - 1);
}

my @arr = (1, 2, 3);
my %hash = (a => 1, b => 2);
my $closure = sub { return $_[0] + 1; };

for my $i (1..3) {
    if ($i % 2 == 0) {
        print \"even\\n\";
    } elsif ($i == 1) {
        print \"one\\n\";
    } else {
        print \"odd\\n\";
    }
}

while ($x > 0) {
    last if $x == 0;
    $x--;
}

unless ($done) {
    next;
}

my $heredoc = <<END;
hello
END
",
        );
    }

    #[test]
    fn perl_blank() {
        check_metrics::<PerlParser>(
            "

my $a = 42;

my $b = 43;

",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<PerlParser>(
            "my $a = 1;
my $b = 2;

my $c = 3; # trailing
my $d = 4; # trailing
my $e = 5;",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn perl_blank_zero_sanity() {
        // Sanity check: blank must report 0, never go negative, when the
        // input has no blank lines.
        check_metrics::<PerlParser>(
            "my $a = 1;
my $b = 2;",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn perl_cloc_line_comments() {
        check_metrics::<PerlParser>(
            "# top comment
my $a = 1; # trailing
my $b = 2;",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 2,
                  "cloc": 2,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 2.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 2,
                  "cloc_max": 2,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_cloc_pod_block() {
        check_metrics::<PerlParser>(
            "my $x = 1;
=pod
multi-line
pod block
=cut
my $y = 2;",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 6,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 6.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_lloc_simple_statements() {
        check_metrics::<PerlParser>(
            "my $a = 1;
my $b = 2;
my $c = 3;",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_lloc_compound_statements() {
        check_metrics::<PerlParser>(
            "if ($x) {
    print 'a';
}
while ($n > 0) {
    $n--;
}",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 6,
                  "ploc": 6,
                  "lloc": 4,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 6.0,
                  "ploc_average": 6.0,
                  "lloc_average": 4.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 6,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 6,
                  "ploc_max": 6,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_lloc_postfix_form_counts_once() {
        // `do_thing() if cond;` is one logical line — wrapped in
        // single_line_statement; the inner if_simple_statement does not
        // add a second LLOC.
        check_metrics::<PerlParser>(
            "sub f {
    return 1 if $_[0];
}",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn perl_lloc_use_statement() {
        check_metrics::<PerlParser>(
            "use strict;
use warnings;
my $x = 1;",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn perl_lloc_for_loop() {
        check_metrics::<PerlParser>(
            "for my $i (1..3) {
    print $i;
}",
            "foo.pl",
            |metric| {
                // `for_statement_2` (+1) and `print …;` SEMI in block (+1) → 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn perl_lloc_loop_control_statement() {
        check_metrics::<PerlParser>(
            "while (1) {
    last if $done;
}",
            "foo.pl",
            |metric| {
                // while_statement (+1) + loop_control_statement (+1) = 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn perl_lloc_no_double_count_inside_single_line_statement() {
        // SEMI inside a single_line_statement (postfix form) is a child of
        // if_simple_statement, not Block — so it must not add a second LLOC.
        check_metrics::<PerlParser>(
            "sub f {
    print 'a' unless $_[0];
}",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn perl_lloc_function_definition_not_counted() {
        // `sub f { ... }` itself is a function space, not an LLOC; only its
        // body statements count.
        check_metrics::<PerlParser>(
            "sub f {
    my $x = 1;
}",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn perl_lloc_anonymous_function() {
        // `my $f = sub { return 1; };` — the assignment is one LLOC at the
        // top level (the SEMI after `};`); the `return 1;` inside the
        // anonymous function block is a second LLOC inside the closure.
        check_metrics::<PerlParser>("my $f = sub { return 1; };", "foo.pl", |metric| {
            assert_eq!(metric.loc.lloc(), 2);
        });
    }

    #[test]
    fn perl_multiline_string_assignment_ploc() {
        // Regression test for issue #778: interior rows of a multi-line string
        // literal are real code, not blank lines, and must be credited to PLOC
        // exactly as Python does (#415). Previously Perl no-op'd its string
        // kinds, so row 1 reached neither PLOC nor CLOC and `blank =
        // sloc - ploc - cloc` mislabelled it as blank (ploc was 2, blank 1).
        // Row 0 holds `my $s = "line1`, row 1 `line2`, row 2 `line3";`.
        check_metrics::<PerlParser>(
            "my $s = \"line1
line2
line3\";",
            "foo.pl",
            |metric| {
                // Three physical rows, all code, no blanks — matching Python.
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn multiline_string_ploc_consistent_across_languages() {
        // Cross-language parity for issue #778: the SAME 3-line string
        // assignment must report identical ploc / blank in every language
        // that has a multi-line string literal. The canonical value is
        // Python's #415 decision: all three rows are code, none are blank.
        // `check_metrics` takes a plain `fn(CodeMetrics)`, so the shared
        // assertion is a named function rather than a capturing closure and
        // must take its argument by value to match that pointer type.
        #[allow(clippy::needless_pass_by_value)]
        fn assert_three_code_rows(metric: crate::CodeMetrics) {
            assert_eq!(metric.loc.sloc(), 3);
            assert_eq!(metric.loc.ploc(), 3);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
        }
        check_metrics::<PythonParser>(
            "s = \"\"\"line1\nline2\nline3\"\"\"",
            "foo.py",
            assert_three_code_rows,
        );
        check_metrics::<PerlParser>(
            "my $s = \"line1\nline2\nline3\";",
            "foo.pl",
            assert_three_code_rows,
        );
        check_metrics::<RubyParser>(
            "s = \"line1\nline2\nline3\"",
            "foo.rb",
            assert_three_code_rows,
        );
    }

    #[test]
    fn perl_lloc_unless_until() {
        check_metrics::<PerlParser>(
            "unless ($x) {
    print 'a';
}
until ($n == 0) {
    $n--;
}",
            "foo.pl",
            |metric| {
                // unless_statement (+1) + print SEMI (+1) + until_statement (+1)
                // + $n-- SEMI (+1) = 4
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    #[test]
    fn perl_lloc_heredoc_body_not_counted() {
        // Heredoc body content is data, not code: the body lines should not
        // contribute LLOC or PLOC.
        check_metrics::<PerlParser>(
            "my $s = <<END;
line1
line2
END
my $x = 1;",
            "foo.pl",
            |metric| {
                // Two top-level statements: the heredoc-using `my $s = …;`
                // and `my $x = 1;`.
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
        // Independent confirmation that the snippet is a valid heredoc and
        // not silently parsed as an error tree (which could otherwise yield
        // the same `lloc == 2.0` and mask a grammar regression).
        assert_perl_parses_cleanly(
            "my $s = <<END;
line1
line2
END
my $x = 1;",
        );
    }

    #[test]
    fn perl_lloc_package_and_require() {
        check_metrics::<PerlParser>(
            "package Foo;
require 5.010;
my $x = 1;",
            "foo.pl",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 3,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.0,
                  "ploc_average": 3.0,
                  "lloc_average": 3.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 3,
                  "ploc_max": 3,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn lua_blank() {
        check_metrics::<LuaParser>(
            "local x = 1

local y = 2",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<LuaParser>(
            "local a = 1
local b = 2

local c = 3 -- trailing
local d = 4 -- trailing
local e = 5",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_blank_zero_sanity() {
        // Sanity check: blank must report 0, never go negative, when the
        // input has no blank lines.
        check_metrics::<LuaParser>(
            "local x = 1
local y = 2",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn lua_cloc() {
        check_metrics::<LuaParser>(
            "-- single line comment
local x = 1
--[[
  block comment
  second line
]]",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 1);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 5);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_lloc() {
        check_metrics::<LuaParser>(
            "local function f(x)
  if x > 0 then
    local y = x + 1
    return y
  end
  return 0
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_no_string_lloc() {
        // Long strings spanning multiple lines must not inflate lloc.
        check_metrics::<LuaParser>(
            "local s = [[
  line one
  line two
]]",
            "foo.lua",
            |metric| {
                // #778: a multi-line long-bracket string credits every spanned
                // row to PLOC (matching Python's #415 decision), so all four
                // rows are code and none are blank. It still contributes a
                // single lloc — the assignment statement.
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_no_functiondefinition_lloc() {
        // Anonymous function definition is an expression, not a statement.
        // The containing variable_declaration counts as lloc; FunctionDefinition must not.
        check_metrics::<LuaParser>(
            "local f = function(x)
  return x + 1
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_no_elseif_lloc() {
        // elseif_statement must not add lloc; only if_statement does.
        check_metrics::<LuaParser>(
            "local function f(x)
  if x > 0 then
    return 1
  elseif x < 0 then
    return -1
  else
    return 0
  end
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 9);
                assert_eq!(metric.loc.ploc(), 9);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_no_else_lloc() {
        // else_statement must not add lloc.
        check_metrics::<LuaParser>(
            "local function f(x)
  if x > 0 then
    return 1
  else
    return 0
  end
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_functiondeclaration_lloc() {
        // Named function declaration counts as one lloc.
        check_metrics::<LuaParser>(
            "function f()
  return 1
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_local_function_lloc() {
        // local function declaration is also a function_declaration node → one lloc.
        check_metrics::<LuaParser>(
            "local function g()
  return 2
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_for_numeric_lloc() {
        check_metrics::<LuaParser>(
            "for i = 1, 10 do
  print(i)
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_for_generic_lloc() {
        check_metrics::<LuaParser>(
            "for k, v in pairs(t) do
  print(k, v)
end",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_repeat_lloc() {
        check_metrics::<LuaParser>(
            "local i = 0
repeat
  i = i + 1
until i >= 10",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_local_decl_lloc() {
        check_metrics::<LuaParser>(
            "local x = 1
local y, z = 2, 3",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_function_call_lloc() {
        // Standalone function calls have no expression_statement wrapper in Lua.
        // They fall to the `_` branch → counted as ploc, not lloc.
        check_metrics::<LuaParser>(
            "print(\"hello\")
local x = 1",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_toplevel_assignment_lloc() {
        // Bare `x = 1` at chunk level: parent is Chunk, not VariableDeclaration,
        // so the parent-guard correctly counts it as 1 lloc.
        check_metrics::<LuaParser>(
            "x = 1
y, z = 2, 3",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_basic_loc() {
        check_metrics::<TsxParser>(
            "// A simple utility function
            function add(a: number, b: number): number {
                /* multi-line
                   comment */
                return a + b;
            }

            const greet = (name: string) => {
                return `Hello, ${name}`;
            };",
            "foo.tsx",
            |metric| {
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 10,
                  "ploc": 6,
                  "lloc": 2,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 3.3333333333333335,
                  "ploc_average": 2.0,
                  "lloc_average": 0.6666666666666666,
                  "cloc_average": 1.0,
                  "blank_average": 0.3333333333333333,
                  "sloc_min": 3,
                  "sloc_max": 10,
                  "cloc_min": 0,
                  "cloc_max": 3,
                  "ploc_min": 3,
                  "ploc_max": 6,
                  "lloc_min": 1,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn typescript_basic_loc() {
        check_metrics::<TypescriptParser>(
            "// Line comment
            /* Block
               comment */
            function greet(name: string): string {
                return `Hello, ${name}`;
            }

            const add = (a: number, b: number): number => a + b;",
            "foo.ts",
            |metric| {
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 8,
                  "ploc": 4,
                  "lloc": 1,
                  "cloc": 3,
                  "blank": 1,
                  "sloc_average": 2.6666666666666665,
                  "ploc_average": 1.3333333333333333,
                  "lloc_average": 0.3333333333333333,
                  "cloc_average": 1.0,
                  "blank_average": 0.3333333333333333,
                  "sloc_min": 1,
                  "sloc_max": 8,
                  "cloc_min": 0,
                  "cloc_max": 3,
                  "ploc_min": 1,
                  "ploc_max": 4,
                  "lloc_min": 0,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn csharp_comments() {
        check_metrics::<CsharpParser>(
            "for (int i = 0; i < 100; i++) {
               // Print hello
               System.Console.WriteLine(\"hello\");
               /// XML doc comment
               System.Console.WriteLine(\"hello\");
             }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_blank() {
        check_metrics::<CsharpParser>(
            "int x = 1;


            int y = 2;",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_sloc() {
        check_metrics::<CsharpParser>(
            "for (int i = 0; i < 100; i++) {
               System.Console.WriteLine(i);
             }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_module_sloc() {
        check_metrics::<CsharpParser>(
            "namespace HelloWorld {
              class Program { }
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 0);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_single_ploc() {
        check_metrics::<CsharpParser>("int x = 1;", "foo.cs", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn csharp_simple_ploc() {
        check_metrics::<CsharpParser>(
            "for (int i = 0; i < 100; i++) {
               System.Console.WriteLine(i);
             }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_multi_ploc() {
        check_metrics::<CsharpParser>(
            "int x = 1;
            for (int i = 0; i < 100; i++) {
               System.Console.WriteLine(i);
             }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_single_statement_lloc() {
        check_metrics::<CsharpParser>("int max = 10;", "foo.cs", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn csharp_for_lloc() {
        check_metrics::<CsharpParser>(
            "for (int i = 0; i < 10; i++) {
                System.Console.WriteLine(i);
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_foreach_lloc() {
        check_metrics::<CsharpParser>(
            "foreach (var item in items) {
                System.Console.WriteLine(item);
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_while_lloc() {
        check_metrics::<CsharpParser>(
            "int i = 0;
            while (i < 10) {
                i++;
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_do_while_lloc() {
        check_metrics::<CsharpParser>(
            "int i = 0;
            do {
                i++;
            } while (i < 10);",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_switch_lloc() {
        check_metrics::<CsharpParser>(
            "switch (x) {
                case 1: System.Console.WriteLine(1); break;
                case 2: System.Console.WriteLine(2); break;
                default: System.Console.WriteLine(0); break;
            }
            string s = x switch { 1 => \"one\", _ => \"other\" };",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 8);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_continue_lloc() {
        check_metrics::<CsharpParser>(
            "for (int i = 0; i < 10; i++) {
                if (i == 5) continue;
                System.Console.WriteLine(i);
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_try_lloc() {
        check_metrics::<CsharpParser>(
            "try {
                System.Console.WriteLine(\"try\");
            } catch (System.Exception e) {
                throw new System.Exception(\"caught\");
            } finally {
                System.Console.WriteLine(\"done\");
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_class_loc() {
        check_metrics::<CsharpParser>(
            "class A {
                int x;
                public void M() {
                    System.Console.WriteLine(x);
                }
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_expressions_lloc() {
        check_metrics::<CsharpParser>(
            "int a = 1;
            int b = 2;
            int c = a + b;
            System.Console.WriteLine(c);",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_statement_inline_loc() {
        check_metrics::<CsharpParser>(
            "if (x > 0) System.Console.WriteLine(x);",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 1);
                assert_eq!(metric.loc.ploc(), 1);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_general_loc() {
        check_metrics::<CsharpParser>(
            "using System;
            namespace Demo {
                class A {
                    public void M() {
                        Console.WriteLine(\"hi\");
                    }
                }
                class B {
                    public int N() { return 0; }
                }
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 11);
                assert_eq!(metric.loc.ploc(), 11);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_using_lloc() {
        // EC11 — `using_directive` does not bump LLOC; `using_statement`
        // (block form) and the C# 8 simple-using local-declaration
        // (`using var x = ...;`) both do, the latter via the standard
        // `LocalDeclarationStatement` path.
        check_metrics::<CsharpParser>(
            "using System;
            using System.IO;
            class A {
                public void M() {
                    using (var s = File.OpenRead(\"x\")) {
                        Console.WriteLine(s);
                    }
                    using var t = File.OpenRead(\"y\");
                    Console.WriteLine(t);
                }
            }",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 11);
                assert_eq!(metric.loc.ploc(), 11);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_basic() {
        check_metrics::<KotlinParser>(
            "// A simple function
            fun greet(name: String): String {
                val greeting = \"Hello, \" + name
                if (name.isEmpty()) {
                    return \"Hello, World!\"
                }
                return greeting
            }",
            "foo.kt",
            |metric| {
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 8,
                  "ploc": 7,
                  "lloc": 4,
                  "cloc": 1,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 3.5,
                  "lloc_average": 2.0,
                  "cloc_average": 0.5,
                  "blank_average": 0.0,
                  "sloc_min": 7,
                  "sloc_max": 8,
                  "cloc_min": 0,
                  "cloc_max": 1,
                  "ploc_min": 7,
                  "ploc_max": 7,
                  "lloc_min": 4,
                  "lloc_max": 4,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn kotlin_loc_bare_expression() {
        check_metrics::<KotlinParser>(
            "fun main() {
                val x = 42
                println(x)
                listOf(1, 2, 3).forEach { println(it) }
            }",
            "foo.kt",
            |metric| {
                // lloc should count: val x = 42 (PropertyDeclaration, +1)
                // + println(x) (CallExpression, parent=Block, +1)
                // + listOf(1, 2, 3).forEach { ... } (CallExpression, parent=Block, +1) = 3
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 5,
                  "ploc": 5,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.5,
                  "ploc_average": 2.5,
                  "lloc_average": 1.5,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 5,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#
                );
            },
        );
    }

    #[test]
    fn bash_loc() {
        check_metrics::<BashParser>(
            "#!/bin/bash
# This is a comment
f() {
    echo 'hello'
}

# Another comment
f",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 3);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    // CRLF regression tests: metrics must be identical regardless of line ending style.
    // These also serve as canaries for tree-sitter row-counting behaviour with \r bytes.

    #[test]
    fn python_cloc_crlf_matches_lf() {
        check_metrics::<PythonParser>("# comment\nx = 1", "foo.py", |m| {
            assert_eq!(m.loc.cloc(), 1);
            assert_eq!(m.loc.ploc(), 1);
            assert_eq!(m.loc.sloc(), 2);
            assert_eq!(m.loc.blank(), 0);
        });
        check_metrics::<PythonParser>("# comment\r\nx = 1", "foo.py", |m| {
            assert_eq!(m.loc.cloc(), 1);
            assert_eq!(m.loc.ploc(), 1);
            assert_eq!(m.loc.sloc(), 2);
            assert_eq!(m.loc.blank(), 0);
        });
        // Lone-CR (old Mac line endings) is the true canary: without CR normalisation,
        // tree-sitter 0.26.8 only advances its row counter on \n, collapsing all content
        // onto row 0 and producing wrong sloc/cloc metrics.
        check_metrics::<PythonParser>("# comment\rx = 1", "foo.py", |m| {
            assert_eq!(m.loc.cloc(), 1);
            assert_eq!(m.loc.ploc(), 1);
            assert_eq!(m.loc.sloc(), 2);
            assert_eq!(m.loc.blank(), 0);
        });
    }

    #[test]
    fn python_blank_crlf_matches_lf() {
        check_metrics::<PythonParser>("# comment\n\nx = 1", "foo.py", |m| {
            assert_eq!(m.loc.blank(), 1);
        });
        check_metrics::<PythonParser>("# comment\r\n\r\nx = 1", "foo.py", |m| {
            assert_eq!(m.loc.blank(), 1);
        });
        // Lone-CR: without normalisation the blank \r line stays on row 0 and is not counted.
        check_metrics::<PythonParser>("# comment\r\rx = 1", "foo.py", |m| {
            assert_eq!(m.loc.blank(), 1);
        });
    }

    #[test]
    fn rust_cloc_crlf_matches_lf() {
        check_metrics::<RustParser>(
            "fn f() {\n    // comment\n    let x = 1;\n}",
            "foo.rs",
            |m| {
                assert_eq!(m.loc.cloc(), 1);
                assert_eq!(m.loc.sloc(), 4);
            },
        );
        check_metrics::<RustParser>(
            "fn f() {\r\n    // comment\r\n    let x = 1;\r\n}",
            "foo.rs",
            |m| {
                assert_eq!(m.loc.cloc(), 1);
                assert_eq!(m.loc.sloc(), 4);
            },
        );
        // Lone-CR: without normalisation, tree-sitter 0.26.8 only advances its row counter on
        // \n, so all content collapses onto row 0 and sloc becomes 1 instead of 4.
        check_metrics::<RustParser>(
            "fn f() {\r    // comment\r    let x = 1;\r}",
            "foo.rs",
            |m| {
                assert_eq!(m.loc.cloc(), 1);
                assert_eq!(m.loc.sloc(), 4);
            },
        );
    }

    #[test]
    fn tcl_blank() {
        check_metrics::<TclParser>("set x 1\n\nset y 2", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 3);
            assert_eq!(metric.loc.ploc(), 2);
            assert_eq!(metric.loc.lloc(), 2);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 1);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // ensures the `blank = sloc - (ploc ∪ cloc lines)` union math holds
        // when code and comment lines coincide.
        check_metrics::<TclParser>(
            "set a 1\nset b 2\n\nset c 3 ;# trailing\nset d 4 ;# trailing\nset e 5",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
            },
        );
    }

    #[test]
    fn tcl_cloc() {
        check_metrics::<TclParser>("# This is a comment\nset x 1", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 2);
            assert_eq!(metric.loc.ploc(), 2);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 1);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_lloc() {
        check_metrics::<TclParser>(
            "proc f {x} {
    while {$x > 0} {
        if {$x > 10} {
            set x [expr {$x - 1}]
        }
    }
}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_no_command_substitution_lloc() {
        // `string toupper` inside [...] is a sub-expression; only `puts` is top-level.
        check_metrics::<TclParser>("puts [string toupper x]", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_procedure_lloc() {
        check_metrics::<TclParser>("proc foo {} {\n    puts hello\n}", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 3);
            assert_eq!(metric.loc.ploc(), 3);
            assert_eq!(metric.loc.lloc(), 2);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_if_lloc() {
        check_metrics::<TclParser>("if {1} {\n    puts hello\n}", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 3);
            assert_eq!(metric.loc.ploc(), 3);
            assert_eq!(metric.loc.lloc(), 2);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_elseif_lloc() {
        // if=1 lloc, elseif=1 lloc, else adds 0 lloc
        check_metrics::<TclParser>(
            "if {$x > 10} {
    puts big
} elseif {$x > 5} {
    puts medium
} else {
    puts small
}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_while_lloc() {
        check_metrics::<TclParser>(
            "while {$x > 0} {\n    set x [expr {$x - 1}]\n}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_foreach_lloc() {
        check_metrics::<TclParser>(
            "foreach item {a b c} {\n    puts $item\n}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_set_lloc() {
        check_metrics::<TclParser>("set x 42", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_global_lloc() {
        check_metrics::<TclParser>("global x", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_try_catch_lloc() {
        // try=1 lloc; catch command=1 lloc; commands inside bodies count separately
        check_metrics::<TclParser>(
            "catch {
    set x 1
} result
try {
    set y 2
} on error {msg} {
    puts $msg
}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_namespace_lloc() {
        check_metrics::<TclParser>(
            "namespace eval myns {\n    set x 1\n}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_regexp_lloc() {
        check_metrics::<TclParser>("regexp {^[0-9]+$} $x", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_expr_cmd_lloc() {
        check_metrics::<TclParser>("expr {1 + 2}", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_no_expr_cmd_substitution_lloc() {
        // `expr` inside [...] is a sub-expression, not a statement; only `set` counts.
        check_metrics::<TclParser>("set x [expr {1 + 2}]", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_nested_commands_lloc() {
        // Commands inside proc body are recursively parsed; verify each counts.
        check_metrics::<TclParser>(
            "proc f {x} {
    set y [expr {$x * 2}]
    puts $y
}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_command_lloc() {
        check_metrics::<TclParser>("puts hello", "foo.tcl", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn tcl_no_else_lloc() {
        // `else` block does not add a logical line.
        check_metrics::<TclParser>(
            "if {1} {\n    puts yes\n} else {\n    puts no\n}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_no_finally_lloc() {
        // `finally` block, like `else`, does not add a logical line.
        // proc(1) + try(1) + puts_hi(1) + puts_done(1) + finally(0) = 4.
        check_metrics::<TclParser>(
            "proc f {} {\n    try {\n        puts hi\n    } finally {\n        puts done\n    }\n}",
            "foo.tcl",
            |metric| {
                assert_eq!(
                    metric.loc.lloc(),
                    4,
                    "finally adds 0 lloc; would be 5 if finally counted"
                );
            },
        );
    }

    #[test]
    fn tcl_multiline_block() {
        check_metrics::<TclParser>(
            "proc f {x} {
    set a 1

    set b 2
    return [expr {$a + $b}]
}",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_no_string_lloc() {
        // Multi-line double-quoted strings must not inflate lloc — only the
        // surrounding command should count. Mirrors lua_no_string_lloc and
        // elixir_no_string_content_lloc; pins the heredoc-shaped invariant
        // for Tcl quoted_word bodies.
        check_metrics::<TclParser>(
            "set s \"line one\nline two\nline three\"",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn javascript_blank() {
        check_metrics::<JavascriptParser>(
            "// header comment
        function f() {

            var x = 1;

            var y = 2;
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 0);
                assert_eq!(metric.loc.cloc(), 1);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn javascript_cloc() {
        check_metrics::<JavascriptParser>(
            "// line comment
        /* block
           comment */
        function f() {
            return 1; // inline
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn javascript_cloc_html_comment() {
        // The Annex-B `<!-- -->` `html_comment` must count as CLOC, not
        // fall to the `_` arm and inflate PLOC (#697). Pre-fix this
        // fixture measured cloc 0 / ploc 4.
        check_metrics::<JavascriptParser>(
            "<!-- header comment -->
function f() {
  return 1;
}",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 1);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn mozjs_blank() {
        check_metrics::<MozjsParser>(
            "function f() {

            var x = 1;

        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 0);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_cloc() {
        check_metrics::<MozjsParser>(
            "// header
        /* block comment */
        function f() {
            return 42;
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<MozjsParser>(
            "function f() {
  var a = 1;

  var b = 2; // trailing
  var c = 3; // trailing
}",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_arrow_function_loc() {
        check_metrics::<MozjsParser>(
            "const add = (a, b) => a + b;
        const greet = name => {
            return 'Hello ' + name;
        };",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_multiple_functions_loc() {
        check_metrics::<MozjsParser>(
            "function f() {
            return 1;
        }
        function g() {
            return 2;
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_nested_function_loc() {
        check_metrics::<MozjsParser>(
            "function outer() {
            function inner() {
                return 1;
            }
            return inner();
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn mozjs_if_lloc() {
        check_metrics::<MozjsParser>(
            "function f(x) {
            if (x > 0) {
                return 1;
            } else {
                return -1;
            }
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                // lloc = 3: the `if` statement plus the two `return`
                // statements. The three `{ … }` brace blocks (function
                // body, `if` consequent, `else` alternative) are syntactic
                // groupings, not logical statements, and contribute 0 —
                // matching C/Rust/Java for the equivalent code (#777).
                // Pre-#777 this asserted 6 (every StatementBlock counted).
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    // Cross-language parity (#777): the same if/else function body yields
    // identical lloc across the JS family and the C-family / Rust baselines.
    // Removing `StatementBlock` from the JS-family lloc arms restored this
    // invariant — every brace block now contributes 0 lloc, as it always
    // had elsewhere. Pre-#777 the JS variants reported lloc 6 (three brace
    // blocks over-counted) against C's and Rust's 3.
    #[test]
    fn js_family_if_lloc_matches_c_and_rust() {
        const JS_SRC: &str = "function f(x) {
            if (x > 0) {
                return 1;
            } else {
                return -1;
            }
        }";
        const C_SRC: &str = "int f(int x) {
            if (x > 0) {
                return 1;
            } else {
                return -1;
            }
        }";
        const RUST_SRC: &str = "fn f(x: i32) -> i32 {
            if x > 0 {
                return 1;
            } else {
                return -1;
            }
        }";

        // The logical-statement count is grammar-independent: one `if`
        // plus two `return`s, regardless of brace style or language.
        const EXPECTED_LLOC: usize = 3;

        check_metrics::<CppParser>(C_SRC, "f.c", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
        check_metrics::<RustParser>(RUST_SRC, "f.rs", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
        check_metrics::<MozjsParser>(JS_SRC, "f.js", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
        check_metrics::<JavascriptParser>(JS_SRC, "f.js", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
        check_metrics::<TypescriptParser>(JS_SRC, "f.ts", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
        check_metrics::<TsxParser>(JS_SRC, "f.tsx", |m| {
            assert_eq!(m.loc.lloc() as usize, EXPECTED_LLOC);
        });
    }

    #[test]
    fn mozjs_for_lloc() {
        check_metrics::<MozjsParser>(
            "function f(n) {
            var s = 0;
            for (var i = 0; i < n; i++) {
                s += i;
            }
            return s;
        }",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_blank() {
        check_metrics::<BashParser>(
            "#!/bin/bash

        f() {

            echo hello

        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 1);
                assert_eq!(metric.loc.blank(), 3);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_cloc() {
        check_metrics::<BashParser>(
            "# header comment
        f() {
            # body comment
            echo hello
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<BashParser>(
            "f() {
  echo a

  echo b # trailing
  echo c # trailing
}",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_comment_before_code_line_reclassified() {
        // Regression for #547: a standalone `#` comment sitting on a line
        // that the grammar *also* anchors a zero-width code leaf to (the
        // empty `word` tree-sitter-bash emits inside a `$(...)` command
        // substitution that contains only a comment) must reclassify that
        // row from comment-only to code-comment. The Bash `Loc` leaf arm
        // previously omitted `check_comment_ends_on_code_line` (unlike
        // Elixir and every other impl), so the row was credited to BOTH
        // `ploc` and the comment-only set and `blank` was undercounted by
        // one.
        //
        // Source rows: 0 `echo a`, 1 blank, 2 `echo "$(`, 3 `  # c`,
        // 4 `)"`. expected: sloc=5 (every physical row),
        // ploc=4 (rows 0/2/3/4 — row 3 carries the phantom code leaf),
        // lloc=3, cloc=1 (row 3, now a code-comment line, not comment-only),
        // blank=1 (row 1). Without the fix `blank` collapses to 0 because
        // row 3 is double-counted. Verified fail-on-revert per
        // .claude/rules/testing.md.
        check_metrics::<BashParser>("echo a\n\necho \"$(\n  # c\n)\"\n", "foo.sh", |metric| {
            assert_eq!(metric.loc.sloc(), 5);
            assert_eq!(metric.loc.ploc(), 4);
            assert_eq!(metric.loc.lloc(), 3);
            assert_eq!(metric.loc.cloc(), 1);
            assert_eq!(metric.loc.blank(), 1);
            insta::assert_json_snapshot!(
                metric.loc,
                @r#"
                {
                  "sloc": 5,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 1,
                  "blank": 1,
                  "sloc_average": 5.0,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 1.0,
                  "blank_average": 1.0,
                  "sloc_min": 5,
                  "sloc_max": 5,
                  "cloc_min": 1,
                  "cloc_max": 1,
                  "ploc_min": 4,
                  "ploc_max": 4,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
            );
        });
    }

    #[test]
    fn bash_if_lloc() {
        check_metrics::<BashParser>(
            "f() {
            if [ $1 -gt 0 ]; then
                echo positive
            else
                echo negative
            fi
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_for_lloc() {
        check_metrics::<BashParser>(
            "f() {
            for i in 1 2 3; do
                echo $i
            done
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_while_lloc() {
        check_metrics::<BashParser>(
            "f() {
            local n=5
            while [ $n -gt 0 ]; do
                echo $n
                n=$((n - 1))
            done
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_case_lloc() {
        check_metrics::<BashParser>(
            "f() {
            case $1 in
                start) echo starting ;;
                stop)  echo stopping ;;
                *)     echo unknown  ;;
            esac
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_multiple_functions_loc() {
        check_metrics::<BashParser>(
            "f() {
            echo hello
        }
        g() {
            echo world
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_nested_function_loc() {
        check_metrics::<BashParser>(
            "outer() {
            inner() {
                echo inner
            }
            inner
            echo outer
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn bash_heredoc_loc() {
        check_metrics::<BashParser>(
            "f() {
            cat <<EOF
line1
line2
EOF
        }",
            "foo.sh",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_blank() {
        check_metrics::<KotlinParser>(
            "fun f(): Int {

            val x = 1

            return x
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_cloc() {
        check_metrics::<KotlinParser>(
            "// header comment
        /* block
           comment */
        fun f(): Int {
            return 42 // inline
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_no_zero_blank() {
        // Checks that the blank metric is not equal to 0 when there are some
        // comments next to code lines. Mirrors rust_no_zero_blank.
        check_metrics::<KotlinParser>(
            "fun connectToUpdateServer() {
              val pool = 0

              val updateServer = -42
              val isConnected = false
              val currTry = 0
              val numRetries = 10  // Number of IPC connection retries before
                                    // giving up.
              val numTries = 20    // Number of IPC connection tries before
                                    // giving up.
            }",
            "foo.kt",
            |metric| {
                // Anchor the headline integer values; in particular
                // `blank() > 0` is the contract this test's name advertises.
                assert_eq!(metric.loc.sloc(), 11);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 11,
                  "ploc": 8,
                  "lloc": 6,
                  "cloc": 4,
                  "blank": 1,
                  "sloc_average": 5.5,
                  "ploc_average": 4.0,
                  "lloc_average": 3.0,
                  "cloc_average": 2.0,
                  "blank_average": 0.5,
                  "sloc_min": 11,
                  "sloc_max": 11,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 8,
                  "ploc_max": 8,
                  "lloc_min": 6,
                  "lloc_max": 6,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#
                );
            },
        );
    }

    #[test]
    fn kotlin_loc_blank_zero_sanity() {
        // Sanity: when the source has no blank lines, blank() must be 0.
        // Preserves the no-blank coverage previously held by
        // kotlin_loc_no_zero_blank before it was rewritten to assert the
        // positive case its name advertises.
        check_metrics::<KotlinParser>(
            "fun f(): Int {
            val x = 1 // x
            val y = 2 // y
            return x + y
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn kotlin_loc_if_lloc() {
        check_metrics::<KotlinParser>(
            "fun classify(n: Int): String {
            if (n > 0) {
                return \"positive\"
            } else if (n < 0) {
                return \"negative\"
            }
            return \"zero\"
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_for_lloc() {
        check_metrics::<KotlinParser>(
            "fun sum(n: Int): Int {
            var s = 0
            for (i in 1..n) {
                s += i
            }
            return s
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_when_lloc() {
        check_metrics::<KotlinParser>(
            "fun describe(x: Int): String {
            return when (x) {
                1 -> \"one\"
                2 -> \"two\"
                else -> \"other\"
            }
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_lambda_lloc() {
        check_metrics::<KotlinParser>(
            "fun f(list: List<Int>): List<Int> {
            return list.filter { it > 0 }
                       .map { it * 2 }
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_class_loc() {
        check_metrics::<KotlinParser>(
            "class Counter {
            private var count = 0
            fun increment() { count++ }
            fun get(): Int = count
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_multiple_functions_loc() {
        check_metrics::<KotlinParser>(
            "fun f(): Int {
            return 1
        }
        fun g(): Int {
            return 2
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_loc_while_lloc() {
        check_metrics::<KotlinParser>(
            "fun countdown(n: Int) {
            var i = n
            while (i > 0) {
                println(i)
                i--
            }
        }",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_blank() {
        check_metrics::<TypescriptParser>(
            "function f(): void {

            const x = 1;

        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 0);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_cloc() {
        check_metrics::<TypescriptParser>(
            "// header
        /* block
           comment */
        function f(): number {
            return 42; // inline
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<TypescriptParser>(
            "function f(): void {
  const a = 1;

  const b = 2; // trailing
  const c = 3; // trailing
}",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_if_lloc() {
        check_metrics::<TypescriptParser>(
            "function classify(n: number): string {
            if (n > 0) {
                return 'positive';
            } else {
                return 'non-positive';
            }
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_for_lloc() {
        check_metrics::<TypescriptParser>(
            "function sum(n: number): number {
            let s = 0;
            for (let i = 0; i < n; i++) {
                s += i;
            }
            return s;
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_while_lloc() {
        check_metrics::<TypescriptParser>(
            "function countdown(n: number): void {
            let i = n;
            while (i > 0) {
                console.log(i);
                i--;
            }
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_switch_lloc() {
        check_metrics::<TypescriptParser>(
            "function describe(x: number): string {
            switch (x) {
                case 1: return 'one';
                case 2: return 'two';
                default: return 'other';
            }
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_class_loc() {
        check_metrics::<TypescriptParser>(
            "class Counter {
            private count: number = 0;
            increment(): void { this.count++; }
            get(): number { return this.count; }
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_arrow_function_loc() {
        check_metrics::<TypescriptParser>(
            "const add = (a: number, b: number): number => a + b;
        const greet = (name: string): string => {
            return `Hello, ${name}`;
        };",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_interface_loc() {
        check_metrics::<TypescriptParser>(
            "interface Shape {
            area(): number;
            perimeter(): number;
        }
        function describe(s: Shape): string {
            return `area=${s.area()}`;
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_multiple_functions_loc() {
        check_metrics::<TypescriptParser>(
            "function f(): number {
            return 1;
        }
        function g(): number {
            return 2;
        }
        function h(): number {
            return 3;
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 9);
                assert_eq!(metric.loc.ploc(), 9);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_try_catch_lloc() {
        check_metrics::<TypescriptParser>(
            "function safe(x: number): number {
            try {
                return 1 / x;
            } catch (e) {
                return 0;
            }
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_nested_functions_loc() {
        check_metrics::<TypescriptParser>(
            "function outer(x: number): number {
            function inner(y: number): number {
                return y * 2;
            }
            return inner(x) + 1;
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn typescript_generic_function_loc() {
        check_metrics::<TypescriptParser>(
            "function identity<T>(value: T): T {
            return value;
        }
        function first<T>(arr: T[]): T | undefined {
            return arr[0];
        }",
            "foo.ts",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_blank() {
        check_metrics::<TsxParser>(
            "function f(): void {

            const x = 1;

        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 0);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_cloc() {
        check_metrics::<TsxParser>(
            "// header
        /* block
           comment */
        function f(): number {
            return 42; // inline
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<TsxParser>(
            "function f(): void {
  const a = 1;

  const b = 2; // trailing
  const c = 3; // trailing
}",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_if_lloc() {
        check_metrics::<TsxParser>(
            "function classify(n: number): string {
            if (n > 0) {
                return 'positive';
            } else {
                return 'non-positive';
            }
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_for_lloc() {
        check_metrics::<TsxParser>(
            "function sum(n: number): number {
            let s = 0;
            for (let i = 0; i < n; i++) {
                s += i;
            }
            return s;
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_while_lloc() {
        check_metrics::<TsxParser>(
            "function countdown(n: number): void {
            let i = n;
            while (i > 0) {
                console.log(i);
                i--;
            }
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_switch_lloc() {
        check_metrics::<TsxParser>(
            "function describe(x: number): string {
            switch (x) {
                case 1: return 'one';
                case 2: return 'two';
                default: return 'other';
            }
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_class_loc() {
        check_metrics::<TsxParser>(
            "class Counter {
            private count: number = 0;
            increment(): void { this.count++; }
            get(): number { return this.count; }
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_arrow_function_loc() {
        check_metrics::<TsxParser>(
            "const add = (a: number, b: number): number => a + b;
        const greet = (name: string): string => {
            return `Hello, ${name}`;
        };",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_multiple_functions_loc() {
        check_metrics::<TsxParser>(
            "function f(): number {
            return 1;
        }
        function g(): number {
            return 2;
        }
        function h(): number {
            return 3;
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 9);
                assert_eq!(metric.loc.ploc(), 9);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_try_catch_lloc() {
        check_metrics::<TsxParser>(
            "function safe(x: number): number {
            try {
                return 1 / x;
            } catch (e) {
                return 0;
            }
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_nested_functions_loc() {
        check_metrics::<TsxParser>(
            "function outer(x: number): number {
            function inner(y: number): number {
                return y * 2;
            }
            return inner(x) + 1;
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_interface_loc() {
        check_metrics::<TsxParser>(
            "interface Shape {
            area(): number;
            perimeter(): number;
        }
        function describe(s: Shape): string {
            return `area=${s.area()}`;
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tsx_generic_function_loc() {
        check_metrics::<TsxParser>(
            "function identity<T>(value: T): T {
            return value;
        }
        function first<T>(arr: T[]): T | undefined {
            return arr[0];
        }",
            "foo.tsx",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_blank() {
        check_metrics::<PhpParser>(
            "<?php

$a = 1;

$b = 2;

",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<PhpParser>(
            "<?php
$a = 1;

$b = 2; // trailing
$c = 3; // trailing
",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_cloc_double_slash() {
        check_metrics::<PhpParser>(
            "<?php
// first
// second
$a = 1; // trailing",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 3);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_cloc_hash() {
        check_metrics::<PhpParser>(
            "<?php
# first
# second
$a = 1;",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_cloc_block() {
        check_metrics::<PhpParser>(
            "<?php
/*
 * block
 * comment
 */
$a = 1;",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 4);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_lloc() {
        // Three statements: assignment, if (with body), echo.
        check_metrics::<PhpParser>(
            "<?php
$a = 1;
if ($a > 0) {
    echo $a;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_parenthesized_expression_lloc() {
        // Parenthesized expression should not add an extra LLOC over the
        // surrounding expression_statement.
        check_metrics::<PhpParser>(
            "<?php
$a = (1 + 2);",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_compound_statement_lloc() {
        // Block wrappers (`{ … }`) are not LLOC themselves.
        check_metrics::<PhpParser>(
            "<?php
function f(): void {
    $a = 1;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_colon_block_lloc() {
        // Alternative syntax (`if: … endif;`) uses ColonBlock instead of
        // CompoundStatement; it is also not LLOC.
        check_metrics::<PhpParser>(
            "<?php
if (true):
    $a = 1;
endif;",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_else_clause_lloc() {
        // ElseClause and ElseIfClause are sub-parts of IfStatement.
        check_metrics::<PhpParser>(
            "<?php
if ($x) {
    $a = 1;
} elseif ($y) {
    $a = 2;
} else {
    $a = 3;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_case_statement_lloc() {
        // CaseStatement / DefaultStatement are switch arms, not separate
        // statements.
        check_metrics::<PhpParser>(
            "<?php
switch ($x) {
    case 1:
        $a = 1;
        break;
    case 2:
        $a = 2;
        break;
    default:
        $a = 0;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 11);
                assert_eq!(metric.loc.ploc(), 11);
                assert_eq!(metric.loc.lloc(), 6);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_match_arm_lloc() {
        // MatchConditionalExpression / MatchDefaultExpression are arms;
        // only the surrounding expression_statement counts.
        check_metrics::<PhpParser>(
            "<?php
$a = match ($x) {
    1 => 'one',
    2 => 'two',
    default => 'other',
};",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_throw_in_expression_lloc() {
        // PHP 8 `throw` as expression: only the surrounding statement
        // counts (the `??` in this example), not the throw_expression.
        check_metrics::<PhpParser>(
            "<?php
$x = $y ?? throw new \\Exception('nope');",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_no_closure_in_assignment_lloc() {
        // Anonymous function as RHS does not add an LLOC; only the
        // expression_statement counts. The closure body's statements are
        // counted in its own FuncSpace.
        check_metrics::<PhpParser>(
            "<?php
$f = function (): int {
    return 42;
};",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_for_lloc() {
        // The for_statement contributes 1 LLOC; init/cond/update are NOT
        // separate statements in PHP's grammar.
        check_metrics::<PhpParser>(
            "<?php
for ($i = 0; $i < 10; $i++) {
    echo $i;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_foreach_lloc() {
        check_metrics::<PhpParser>(
            "<?php
foreach ($items as $k => $v) {
    echo $v;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_try_lloc() {
        check_metrics::<PhpParser>(
            "<?php
try {
    $a = 1;
} catch (\\Exception $e) {
    $a = 0;
} finally {
    $b = 2;
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_class_loc() {
        check_metrics::<PhpParser>(
            "<?php
class A {
    public int $x = 0;
    private const Y = 1;
    public function f(): int {
        return $this->x;
    }
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_namespace_use_lloc() {
        check_metrics::<PhpParser>(
            "<?php
namespace App;
use App\\Foo;
use App\\Bar;
$a = 1;",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_general_loc() {
        check_metrics::<PhpParser>(
            "<?php
// header
namespace App;
use App\\Foo;

class Bar {
    public int $n = 0;

    public function add(int $x): int {
        if ($x > 0) {
            return $this->n + $x;
        }
        return $this->n;
    }
}",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 15);
                assert_eq!(metric.loc.ploc(), 12);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 1);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_match_in_expression_lloc() {
        // Match inside another expression (e.g. assignment RHS) — the
        // outer expression_statement counts, the inner match arms do not.
        check_metrics::<PhpParser>(
            "<?php
$y = 10 + match ($x) { 1 => 2, default => 0 };",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_html_island_ploc() {
        // Embedded HTML between PHP tags ("text interpolation"). HTML
        // rows must contribute to PLOC (they are not blank and not a
        // PHP comment); this test locks that behavior so a future
        // grammar bump or impl tweak that excludes `text` nodes from
        // the default PLOC branch is caught.
        check_metrics::<PhpParser>(
            "<?php if ($cond): ?>
<div>hello</div>
<p>world</p>
<?php endif; ?>",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_short_echo_tag_ploc() {
        // `<?=` is the same `php_tag` kind as `<?php` per
        // tree-sitter-php 0.24.2. A regression that re-classified `<?=`
        // would shift PLOC; this test pins the current behavior.
        check_metrics::<PhpParser>("<p><?= $name ?></p>", "foo.php", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.lloc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
            assert_eq!(metric.loc.blank(), 0);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn elixir_blank() {
        // Two blank lines separate three top-level expressions.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n\n  def a, do: :a\n\n  def b, do: :b\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
                insta::assert_json_snapshot!(
                    metric.loc,
                    @r#"
                {
                  "sloc": 6,
                  "ploc": 4,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 2,
                  "sloc_average": 1.5,
                  "ploc_average": 1.0,
                  "lloc_average": 0.75,
                  "cloc_average": 0.0,
                  "blank_average": 0.5,
                  "sloc_min": 1,
                  "sloc_max": 6,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 1,
                  "ploc_max": 4,
                  "lloc_min": 1,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 2
                }
                "#
                );
            },
        );
    }

    #[test]
    fn elixir_no_zero_blank() {
        // Blank line interleaved with code that carries trailing comments —
        // stresses the `blank = sloc - (ploc ∪ cloc lines)` union math.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f, do: :ok\n\n  def g, do: :ok # trailing\n  def h, do: :ok # trailing\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.blank(), 1);
            },
        );
    }

    #[test]
    fn elixir_blank_zero_sanity() {
        // Sanity check: blank must report 0, never go negative, when the
        // input has no blank lines.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f, do: :ok\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn elixir_cloc() {
        // Mix of standalone comments and a comment on the same line as
        // code. Elixir has no block comment syntax — only `#` lines.
        check_metrics::<ElixirParser>(
            "# top\ndefmodule Foo do\n  # body\n  def f, do: :ok # trailing\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.cloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_lloc() {
        // Two statements at the top level of the module body — the
        // `defmodule` call itself counts as one statement (since its
        // parent is `Source`), and each `def` inside its `do_block`
        // counts too: 1 + 2 = 3.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def a, do: 1\n  def b, do: 2\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_no_nested_call_lloc() {
        // Calls nested inside another call's arguments are NOT direct
        // children of a statement container, so they do not bump LLOC.
        // Three syntactic calls (`defmodule`, `def`, `IO.puts`) → 3.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f do\n    IO.puts(Enum.join([1, 2, 3], \", \"))\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_no_binary_operator_inside_call_lloc() {
        // Binary operators inside call arguments are sub-expressions,
        // not statements. A single `def` body containing `IO.puts(a + b)`
        // produces 3 LLOC (defmodule, def, IO.puts) — the `a + b`
        // binary_operator is not a direct child of any statement
        // container.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f(a, b) do\n    IO.puts(a + b)\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_stab_clause_counts_lloc() {
        // Each `stab_clause` arm in a `case do ... end` is a direct
        // child of the inner `do_block`, so each one is its own LLOC.
        // defmodule + def + case + 3 arms = 6 logical lines.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f(x) do\n    case x do\n      1 -> :a\n      2 -> :b\n      _ -> :c\n    end\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 6);
            },
        );
    }

    #[test]
    fn elixir_no_comment_lloc() {
        // Comments are direct children of a statement container but
        // are routed through the dedicated `Comment` arm in `compute`,
        // so they MUST NOT bump LLOC. Only `defmodule` and `def`
        // contribute LLOC here.
        check_metrics::<ElixirParser>(
            "# leading\ndefmodule Foo do\n  # inside\n  def f, do: :ok\n  # trailing\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn elixir_no_do_token_lloc() {
        // The `do` and `end` keyword tokens are unnamed leaves inside a
        // `do_block`; they must not be counted as statements. A body
        // with one expression produces exactly 2 LLOC (defmodule and
        // the inner expression).
        check_metrics::<ElixirParser>("defmodule Foo do\n  :ok\nend\n", "foo.ex", |metric| {
            // `:ok` is an `Atom` whose parent is the module-call's
            // `do_block`; that counts. Plus the `defmodule` call.
            assert_eq!(metric.loc.lloc(), 2);
        });
    }

    #[test]
    fn elixir_no_keyword_pair_lloc() {
        // `key: value` keyword pairs inside an argument list (`def f,
        // do: :ok`) are children of an `arguments` / `keywords` node,
        // not a statement container, so they don't bump LLOC.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def add(a, b), do: a + b\nend\n",
            "foo.ex",
            |metric| {
                // defmodule (1) + def (1) = 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn elixir_no_string_content_lloc() {
        // `quoted_content` chunks inside a heredoc / regular string are
        // structural and don't represent statements. A `@moduledoc`
        // attribute call with a multi-line string contributes exactly
        // one LLOC (the `@moduledoc` call), not one per content line.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  @moduledoc \"\"\"\n  line one\n  line two\n  \"\"\"\n  def f, do: :ok\nend\n",
            "foo.ex",
            |metric| {
                // defmodule + @moduledoc + def = 3
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_rescue_arm_counts_lloc() {
        // Each rescue arm's body has a single expression (e.g. `:bad`)
        // that counts as one LLOC; the `stab_clause` header itself is
        // skipped. The rescue_block named node is also a direct child
        // of try's do_block, so it contributes one LLOC too.
        // Total: defmodule + def + try + do_it() + rescue_block
        //        + 2 arm bodies = 7.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def safe do\n    try do\n      do_it()\n    rescue\n      ArgumentError -> :bad\n      RuntimeError -> :worse\n    end\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 7);
            },
        );
    }

    #[test]
    fn elixir_no_arg_punctuation_lloc() {
        // Function-call arguments (`a, b` inside `def add(a, b)`) are
        // children of an `arguments` node, not of a statement container.
        // They MUST NOT inflate LLOC.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def add(a, b, c, d) do\n    a + b + c + d\n  end\nend\n",
            "foo.ex",
            |metric| {
                // defmodule + def + (a+b+c+d) = 3
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_no_list_element_lloc() {
        // List literal elements live under a `list` node, not a
        // statement container — they must not bump LLOC.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f do\n    [:a, :b, :c, :d]\n  end\nend\n",
            "foo.ex",
            |metric| {
                // defmodule + def + the list expression = 3
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_no_map_field_lloc() {
        // Map `pair`s live under `map`, not a statement container.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f do\n    %{a: 1, b: 2, c: 3}\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn elixir_anonymous_fn_body_lloc() {
        // `lloc()` on the Unit space returns the aggregate (own +
        // nested-space) count. Even though the anonymous_function is
        // its own function space, the merge step pulls its `lloc` back
        // into the parent. Counts:
        //   Unit own: defmodule, def, `add = fn ...`, final `add` = 4
        //   anon-fn:  `x + 1` body expression                       = 1
        //   aggregated total                                        = 5
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def f do\n    add = fn x -> x + 1 end\n    add\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.lloc(), 5);
            },
        );
    }

    #[test]
    fn ruby_blank() {
        // The parser's root span starts at the first non-blank line, so
        // a blank line must sit BETWEEN code lines to be counted.
        // expected: line 3 is blank → blank = 1.
        check_metrics::<RubyParser>("def foo\n  a = 1\n\n  a + 1\nend\n", "foo.rb", |metric| {
            assert_eq!(metric.loc.blank(), 1);
        });
    }

    #[test]
    fn ruby_no_zero_blank() {
        // Mirrors `rust_no_zero_blank`: the blank counter must stay
        // non-zero when blank lines sit between code lines that carry
        // trailing comments. Catches regressions in the SLOC −
        // (PLOC ∪ CLOC) union math when PLOC and CLOC line-sets
        // overlap.
        check_metrics::<RubyParser>(
            "def foo  # entry\n  pool = 0\n\n  server = -42  # negative\n\n  ok = false\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.blank(), 2);
            },
        );
    }

    #[test]
    fn ruby_cloc() {
        // 3 comment lines.
        check_metrics::<RubyParser>(
            "# one\n# two\n# three\ndef foo\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.cloc(), 3);
            },
        );
    }

    #[test]
    fn ruby_lloc() {
        // expected: 3 logical lines = `def` (Method) + `if` (If) +
        // `while` (While). Bare expression-statements (assignments,
        // calls) are intentionally NOT counted.
        check_metrics::<RubyParser>(
            "def foo(a)\n  if a\n    a += 1\n  end\n  while a > 0\n    a -= 1\n  end\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn ruby_no_call_lloc() {
        // expected: 1 logical line (the surrounding `def`). The bare
        // method calls `puts 'hello'` and `puts 'world'` are
        // intentionally NOT counted — there is no expression_statement
        // wrapper to disambiguate them from sub-expressions.
        check_metrics::<RubyParser>(
            "def foo\n  puts 'hello'\n  puts 'world'\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn ruby_no_assignment_lloc() {
        // Same rationale as `ruby_no_call_lloc`. expected: 1 lloc
        // (the `def`); raw assignments aren't counted.
        check_metrics::<RubyParser>(
            "def foo\n  a = 1\n  b = 2\n  c = a + b\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn ruby_modifier_lloc() {
        // Postfix modifier forms each count as one logical line. A
        // `return … if …` parses as an `IfModifier` wrapping a `Return`;
        // both fire the LLOC arm so the modifier line contributes +2.
        // expected: def(1) + if_modifier(1) + inner return(1)
        // + while_modifier(1) + rescue_modifier(1) = 5.
        check_metrics::<RubyParser>(
            "def foo(a)\n  return a if a.nil?\n  a -= 1 while a > 0\n  parse(a) rescue nil\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 5);
            },
        );
    }

    #[test]
    fn ruby_class_lloc() {
        // expected: 1 class + 1 module + 2 methods = 4.
        check_metrics::<RubyParser>(
            "module M\n  class C\n    def foo\n    end\n    def bar\n    end\n  end\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    #[test]
    fn ruby_begin_rescue_lloc() {
        // expected: 1 def + 1 begin = 2. Rescue clauses are part of
        // the begin construct and not separately counted; the bare
        // expression body lines are not statements.
        check_metrics::<RubyParser>(
            "def foo\n  begin\n    risky\n  rescue StandardError\n    nil\n  end\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn ruby_nested_defs_lloc() {
        // Each `Method` declaration contributes one logical line.
        // expected: outer `def` + inner `def` = 2.
        check_metrics::<RubyParser>(
            "def outer\n  def inner\n    1\n  end\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn ruby_no_block_body_lloc() {
        // A top-level `[1,2,3].each do |x| puts x end` produces zero
        // logical lines: the surrounding `.each` is a `Call` (not in
        // the LLOC arm), the `DoBlock` is a closure (also not a
        // statement), and the `puts x` inside is another call. This
        // pins the documented expression-statement exclusion.
        check_metrics::<RubyParser>(
            "[1, 2, 3].each do |x|\n  puts x\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 0);
            },
        );
    }

    #[test]
    fn ruby_no_lambda_body_lloc() {
        // `add = ->(a, b) { a + b }` produces zero logical lines for
        // the same reason as `ruby_no_block_body_lloc`: assignments,
        // calls, and lambda bodies are intentionally not statements
        // in this impl.
        check_metrics::<RubyParser>("add = ->(a, b) {\n  a + b\n}\n", "foo.rb", |metric| {
            assert_eq!(metric.loc.lloc(), 0);
        });
    }

    #[test]
    fn ruby_heredoc_lloc_and_blank() {
        // A `<<~TXT` heredoc contributes: SLOC = every line in the file
        // (including the heredoc body); LLOC = just the surrounding `def`.
        // #778: the heredoc-body rows (`one`, `two`) hold real string text,
        // so they are credited to PLOC like Python's multi-line strings
        // (#415) rather than mislabelled as blank. Every row is now code.
        // expected: sloc = 7, ploc = 7, lloc = 1, blank = 0.
        check_metrics::<RubyParser>(
            "def foo\n  msg = <<~TXT\n    one\n    two\n  TXT\n  msg\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.sloc(), 7);
                assert_eq!(metric.loc.ploc(), 7);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    #[test]
    fn ruby_semicolon_multistatement_lloc_undercount() {
        // Documented limitation: Ruby has no `expression_statement`
        // wrapper, so `;`-separated multi-statement lines collapse to
        // a single LLOC bump (the surrounding `def`). A future
        // statement-counter that walks BlockBody children would
        // change this — pin the current behaviour so the regression
        // is visible.
        check_metrics::<RubyParser>(
            "def foo\n  a = 1; b = 2; a + b\nend\n",
            "foo.rb",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn ruby_ploc_skips_comments_and_blanks() {
        // PLOC counts physical instruction lines: code-bearing lines
        // only. Comments and blanks are excluded.
        check_metrics::<RubyParser>("# header\n\ndef foo\n  a = 1\nend\n", "foo.rb", |metric| {
            assert_eq!(metric.loc.ploc(), 3);
            assert_eq!(metric.loc.cloc(), 1);
            assert_eq!(metric.loc.blank(), 1);
        });
    }

    // -----------------------------------------------------------------
    // Issue #195: nested-function/closure LLOC tests across languages.
    // Mirrors the prior art for Rust (`rust_function_in_loop_lloc`,
    // `rust_closure_expression_lloc`), Mozjs (`mozjs_nested_function_loc`),
    // Bash (`bash_nested_function_loc`), and TypeScript
    // (`typescript_nested_functions_loc`, `tsx_nested_functions_loc`).
    // -----------------------------------------------------------------

    #[test]
    fn python_nested_def_lloc() {
        // Nested `def`: the inner function declaration plus the outer
        // body's `return inner()` are both LLOC; the outer `def` header
        // and the inner `return 1` belong to their own function spaces.
        check_metrics::<PythonParser>(
            "def outer():\n    def inner():\n        return 1\n    return inner()\n",
            "foo.py",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn python_lambda_in_def_lloc() {
        // `lambda x: x + 1` is an expression, not a Python `function_definition`,
        // so it does not start a new function space. The two LLOC come from
        // the assignment `f = lambda ...` and the `return f(2)` statement.
        check_metrics::<PythonParser>(
            "def outer():\n    f = lambda x: x + 1\n    return f(2)\n",
            "foo.py",
            |metric| {
                assert_eq!(metric.loc.sloc(), 3);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn python_match_statement_lloc() {
        // `match` (PEP 634) is a control-flow statement that must add one
        // LLOC like `if`/`try`, plus each `return` in a case body (#462).
        // Its `case_clause` children add nothing, mirroring how
        // `elif_clause`/`else_clause` are absent from the LLOC arm: the
        // construct counts once and the statements inside count via their
        // own arms. Here: match(1) + two `return`s = 3.
        check_metrics::<PythonParser>(
            "def f(x):\n    match x:\n        case 1: return 1\n        case _: return 0\n",
            "foo.py",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn python_match_lloc_matches_if_else() {
        // Parity with the equivalent two-branch `if`/`else`: both have the
        // construct keyword (1) plus two `return` bodies (2), so each must
        // report an identical LLOC of 3. The match form previously
        // undercounted (2) because `match_statement` was absent from the
        // LLOC arm (#462). `check_metrics` takes a non-capturing `fn`, so
        // the shared expectation is pinned to the same literal in both
        // closures rather than threaded through a captured variable.
        check_metrics::<PythonParser>(
            "def f(x):\n    if x == 1: return 1\n    else: return 0\n",
            "foo.py",
            |metric| assert_eq!(metric.loc.lloc(), 3),
        );
        check_metrics::<PythonParser>(
            "def f(x):\n    match x:\n        case 1: return 1\n        case _: return 0\n",
            "foo.py",
            |metric| assert_eq!(metric.loc.lloc(), 3),
        );
    }

    #[test]
    fn python_type_alias_lloc() {
        // A `type` alias (PEP 695) is a leaf statement, counted like an
        // assignment. `type Alias = int` followed by `x = 1` is two LLOC;
        // before #462 the alias fell through to the `_` arm and the file
        // reported only 1.
        check_metrics::<PythonParser>("type Alias = int\nx = 1\n", "foo.py", |metric| {
            assert_eq!(metric.loc.lloc(), 2);
            insta::assert_json_snapshot!(metric.loc);
        });
    }

    #[test]
    fn java_local_class_in_method_lloc() {
        // A `class` declared inside a method body produces its own function
        // space, so the outer method's LLOC only sees `return new Local().v();`
        // and the body of `v()` contributes the second LLOC.
        check_metrics::<JavaParser>(
            "class Foo {\n    int bar() {\n        class Local {\n            int v() { return 1; }\n        }\n        return new Local().v();\n    }\n}\n",
            "foo.java",
            |metric| {
                assert_eq!(metric.loc.sloc(), 8);
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn java_lambda_in_method_lloc() {
        // Java lambdas are expressions; the two LLOC come from the
        // `IntUnaryOperator f = x -> x + 1;` declaration and the
        // `f.applyAsInt(3);` expression statement.
        check_metrics::<JavaParser>(
            "class Foo {\n    void bar() {\n        java.util.function.IntUnaryOperator f = x -> x + 1;\n        f.applyAsInt(3);\n    }\n}\n",
            "foo.java",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn groovy_blank() {
        // Blank lines + simple statements. Newlines act as the
        // statement terminator; PLOC counts the two declaration lines.
        check_metrics::<GroovyParser>("int x = 1\n\n\nint y = 2", "foo.groovy", |metric| {
            assert_eq!(metric.loc.sloc(), 4);
            assert_eq!(metric.loc.ploc(), 2);
            assert_eq!(metric.loc.lloc(), 2);
            assert_eq!(metric.loc.blank(), 2);
        });
    }

    #[test]
    fn groovy_no_zero_blank() {
        // A single line with no blanks: blank() == 0.
        check_metrics::<GroovyParser>("int x = 1", "foo.groovy", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.blank(), 0);
        });
    }

    #[test]
    fn groovy_cloc_line_comments() {
        check_metrics::<GroovyParser>(
            "// first comment
            int x = 1
            // second comment
            int y = 2",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.cloc(), 2);
                assert_eq!(metric.loc.ploc(), 2);
            },
        );
    }

    #[test]
    fn groovy_cloc_block_comment() {
        check_metrics::<GroovyParser>(
            "/* multi
               line
               comment */
            int x = 1",
            "foo.groovy",
            |metric| {
                // Block comment spans 3 lines → cloc == 3.
                assert_eq!(metric.loc.cloc(), 3);
            },
        );
    }

    #[test]
    fn groovy_cloc_groovydoc_comment() {
        // Groovy `/** … */` `groovydoc_comment` counts as CLOC. The
        // `Loc` arm already handled it; this pins it alongside the
        // restored `is_comment` parity (#697).
        check_metrics::<GroovyParser>(
            "/** groovydoc */
class A {
  int x = 1
}",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.cloc(), 1);
                assert_eq!(metric.loc.ploc(), 3);
            },
        );
    }

    #[test]
    fn groovy_simple_lloc() {
        // One LLOC per simple expression statement.
        check_metrics::<GroovyParser>(
            "int a = 1
            int b = 2
            int c = 3",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn groovy_no_local_variable_declaration_in_for_lloc() {
        // The variable declaration inside a classic `for` init slot
        // does NOT count as an LLOC (it's an expression part of the
        // for-loop). Same gating as Java's `java_for_lloc`.
        check_metrics::<GroovyParser>(
            "for (int i = 0; i < 10; i++) {
                println(i)
            }",
            "foo.groovy",
            |metric| {
                // for-statement (1) + expression-statement `println(i)` (1) = 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn groovy_lambda_in_method_lloc() {
        // Closures contain a statement list — the dekobon grammar wraps
        // a single-expression body in `expression_statement` rather than
        // emitting the expression directly (as Java's `lambda_expression`
        // does), so a one-line closure body counts as its own LLOC.
        // Declaration `def f = …` (1) + closure body `x + 1` (1) +
        // call `f(3)` (1) = 3.
        check_metrics::<GroovyParser>(
            "class Foo {
                void bar() {
                    def f = { x -> x + 1 }
                    f(3)
                }
            }",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn groovy_try_lloc() {
        // try-statement counts as one LLOC; the catch body's
        // statements count separately.
        check_metrics::<GroovyParser>(
            "void f() {
                try {
                    risky()
                } catch (Exception e) {
                    handle(e)
                }
            }",
            "foo.groovy",
            |metric| {
                // try(1) + risky() expr-stmt(1) + handle() expr-stmt(1) = 3
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn groovy_class_loc() {
        // Source-file-level totals across multiple methods.
        check_metrics::<GroovyParser>(
            "class A {
                void f() {
                    int x = 1
                }
                void g() {
                    int y = 2
                }
            }",
            "foo.groovy",
            |metric| {
                // 8 lines of non-comment content: `class A {`, two
                // `void` headers, two `int … = …` body statements,
                // three closing braces.
                assert_eq!(metric.loc.ploc(), 8);
                assert_eq!(metric.loc.cloc(), 0);
                // Two expression-statement LLOCs (`int x = 1`,
                // `int y = 2`).
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn groovy_partial_parse_recovers_unit() {
        // Malformed input parses with ERROR but still emits a Unit
        // root via `spaces.rs` fallback (lesson 9). The single
        // source line is counted as SLOC even when the parse fails
        // mid-expression.
        check_metrics::<GroovyParser>("def x = (((", "foo.groovy", |metric| {
            assert_eq!(metric.loc.sloc(), 1);
            assert_eq!(metric.loc.blank(), 0);
        });
    }

    #[test]
    fn groovy_sloc() {
        // Mirrors `java_sloc`: basic per-line count across a mix of
        // statements and a blank line.
        check_metrics::<GroovyParser>(
            "int a = 1
            int b = 2

            int c = 3",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 3);
                assert_eq!(metric.loc.blank(), 1);
            },
        );
    }

    #[test]
    fn groovy_single_ploc() {
        // Mirrors `java_single_ploc`: one non-blank, non-comment
        // line of code => ploc == 1.
        check_metrics::<GroovyParser>("int x = 42", "foo.groovy", |metric| {
            assert_eq!(metric.loc.ploc(), 1);
            assert_eq!(metric.loc.cloc(), 0);
        });
    }

    #[test]
    fn groovy_multi_ploc() {
        // Multiple statements on separate lines all contribute to
        // PLOC. Mirrors `java_multi_ploc`.
        check_metrics::<GroovyParser>(
            "int a = 1
            int b = 2
            int c = 3
            int d = 4",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    #[test]
    fn groovy_single_statement_lloc() {
        // A single expression statement contributes one LLOC.
        // Mirrors `java_single_statement_lloc`.
        check_metrics::<GroovyParser>("println 'hi'", "foo.groovy", |metric| {
            assert_eq!(metric.loc.lloc(), 1);
        });
    }

    #[test]
    fn groovy_for_lloc() {
        // The classical `for` statement itself counts as one LLOC;
        // the body's `println(i)` adds another. The init-slot
        // var-decl is suppressed by the LocalVariableDeclaration
        // ancestor-check (same rule as `java_for_lloc`).
        check_metrics::<GroovyParser>(
            "for (int i = 0; i < 100; i++) {
                println(i)
            }",
            "foo.groovy",
            |metric| {
                // ForStatement(1) + println-expr(1) = 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn groovy_foreach_lloc() {
        // `for (item in list)` parses as `enhanced_for_statement` —
        // counts as one LLOC.
        check_metrics::<GroovyParser>(
            "for (item in items) {
                println(item)
            }",
            "foo.groovy",
            |metric| {
                // EnhancedForStatement(1) + println(1) = 2
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    #[test]
    fn groovy_while_lloc() {
        // `while` itself is one LLOC; each body statement adds
        // another. Mirrors `java_while_lloc`.
        check_metrics::<GroovyParser>(
            "int i = 0
            while (i < 10) {
                i++
                println(i)
            }",
            "foo.groovy",
            |metric| {
                // int i = 0 (1) + while (1) + i++ (1) + println (1) = 4
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    #[test]
    fn groovy_do_while_lloc() {
        // `do…while` is one LLOC plus its body. Mirrors
        // `java_do_while_lloc`.
        check_metrics::<GroovyParser>(
            "int i = 0
            do {
                i++
            } while (i < 5)",
            "foo.groovy",
            |metric| {
                // int i = 0 (1) + do (1) + i++ (1) = 3
                assert_eq!(metric.loc.lloc(), 3);
            },
        );
    }

    #[test]
    fn groovy_continue_lloc() {
        // `continue` is an LLOC. Same gating as `java_continue_lloc`.
        check_metrics::<GroovyParser>(
            "for (int i = 0; i < 10; i++) {
                if (i == 5) {
                    continue
                }
                println(i)
            }",
            "foo.groovy",
            |metric| {
                // for(1) + if(1) + continue(1) + println(1) = 4
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    #[test]
    fn groovy_expressions_lloc() {
        // A bag of expression statements: each independent
        // expr-stmt is one LLOC. Mirrors `java_expressions_lloc`.
        check_metrics::<GroovyParser>(
            "int a = 1
            a = 2
            a += 3
            println(a)
            doSomething()",
            "foo.groovy",
            |metric| {
                // 5 expression-statement lines.
                assert_eq!(metric.loc.lloc(), 5);
            },
        );
    }

    #[test]
    fn groovy_throw_lloc() {
        // `throw` is one LLOC via the `ThrowStatement` arm.
        check_metrics::<GroovyParser>(
            "throw new RuntimeException('bad')",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.lloc(), 1);
            },
        );
    }

    #[test]
    fn groovy_general_loc() {
        // Comprehensive mix: class + method + control flow.
        // Mirrors `java_general_loc`'s coverage shape.
        //
        // LLOC = 4, fully attributable:
        //   IfStatement (the outer if/else):     +1
        //   `println(x)`     (JuxtFunctionCall):  +1
        //   `println 'neg'` (JuxtFunctionCall):  +1
        //   `return`        (ReturnStatement):   +1
        // The else-branch's `expression_statement (closure)`
        // wrapper does NOT count — see the bare-Closure carve-out
        // in `impl Loc for GroovyCode::compute`.
        check_metrics::<GroovyParser>(
            "class A {
                void f(int x) {
                    if (x > 0) {
                        println(x)
                    } else {
                        println 'neg'
                    }
                    return
                }
            }",
            "foo.groovy",
            |metric| {
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
            },
        );
    }

    #[test]
    fn csharp_local_function_in_method_lloc() {
        // C# local functions (`int Inner(int x) { ... }` inside `Bar()`)
        // open their own function space, so the outer method sees only
        // `return Inner(2);` plus the inner body's `return x + 1;`.
        check_metrics::<CsharpParser>(
            "class Foo {\n    int Bar() {\n        int Inner(int x) { return x + 1; }\n        return Inner(2);\n    }\n}\n",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn csharp_lambda_in_method_lloc() {
        // C# lambdas are expressions: the two LLOC come from the
        // `Func<int,int> f = x => x + 1;` declaration and the `f(3);` call.
        check_metrics::<CsharpParser>(
            "class Foo {\n    void Bar() {\n        System.Func<int, int> f = x => x + 1;\n        f(3);\n    }\n}\n",
            "foo.cs",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn cpp_lambda_in_function_lloc() {
        // C++11 lambdas are expressions. The outer function `bar()` produces
        // two LLOC for the body: `auto f = [](int x) { return x + 1; };` and
        // `return f(2);`. The lambda's inner `return x + 1;` is part of the
        // lambda body inside the same function space (lambdas do not open a
        // new FuncSpace in this implementation), so it adds a third LLOC.
        // Closes the parity gap with #195 (which covered 11 other
        // languages but omitted C++).
        check_metrics::<CppParser>(
            "int bar() {\n    auto f = [](int x) { return x + 1; };\n    return f(2);\n}\n",
            "foo.cpp",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn javascript_nested_function_lloc() {
        // Nested function_declaration: 4 LLOC = outer's `return inner();`,
        // inner's `return 1;`, plus the two function declarations
        // themselves (the JS Checker counts function declarations as LLOC).
        check_metrics::<JavascriptParser>(
            "function outer() {\n    function inner() {\n        return 1;\n    }\n    return inner();\n}\n",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn javascript_arrow_function_lloc() {
        // The arrow function `(x) => x + 1` is an expression: the LLOC
        // come from `const inner = ...;` and `return inner(2);`.
        check_metrics::<JavascriptParser>(
            "function outer() {\n    const inner = (x) => x + 1;\n    return inner(2);\n}\n",
            "foo.js",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_lambda_literal_in_fun_lloc() {
        // A lambda literal (`{ x -> x + 1 }`) assigned to a `val` plus the
        // following call yields two LLOC at the outer function.
        check_metrics::<KotlinParser>(
            "fun outer() {\n    val f: (Int) -> Int = { x -> x + 1 }\n    f(3)\n}\n",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_local_fun_in_fun_lloc() {
        // Kotlin's local `fun inner(...)` is also a function_declaration,
        // so it opens its own space; the outer LLOC reduces to `inner(3)`,
        // and the inner body contributes the second LLOC.
        check_metrics::<KotlinParser>(
            "fun outer() {\n    fun inner(x: Int): Int { return x + 1 }\n    inner(3)\n}\n",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn kotlin_object_expression_in_fun_lloc() {
        // An `object : Runnable { ... }` expression with an overridden
        // method whose body invokes `println("hi")`. LLOC: `val r = ...`,
        // the override's body call, and the outer `r.run()` call = 3.
        check_metrics::<KotlinParser>(
            "fun outer() {\n    val r = object : Runnable { override fun run() { println(\"hi\") } }\n    r.run()\n}\n",
            "foo.kt",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn go_function_literal_initializer_lloc() {
        // `inner := func(x int) int { return x + 1 }` — the function
        // literal opens its own space; LLOC visible on the outer space:
        // the assignment + `return inner(2)` = 2, plus the literal's
        // `return x + 1` body = 3 aggregated.
        check_metrics::<GoParser>(
            "package main\nfunc outer() int {\n    inner := func(x int) int { return x + 1 }\n    return inner(2)\n}\n",
            "foo.go",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_anonymous_function_in_function_lloc() {
        // Anonymous function `function ($x) { return $x + 1; }`: outer
        // sees the assignment + `return $f(2);`, the closure body adds
        // `return $x + 1;` for 3 LLOC aggregated.
        check_metrics::<PhpParser>(
            "<?php\nfunction outer() {\n    $f = function ($x) { return $x + 1; };\n    return $f(2);\n}\n",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn php_arrow_function_in_function_lloc() {
        // The `fn ($x) => $x + 1` arrow function is an expression; the
        // outer function sees only its assignment and the `return $f(2);`.
        check_metrics::<PhpParser>(
            "<?php\nfunction outer() {\n    $f = fn ($x) => $x + 1;\n    return $f(2);\n}\n",
            "foo.php",
            |metric| {
                assert_eq!(metric.loc.sloc(), 5);
                assert_eq!(metric.loc.ploc(), 5);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_nested_local_function_lloc() {
        // Two nested `local function` declarations: outer + inner both
        // count as `function_declaration` LLOC, plus the two `return`
        // statements = 4 aggregated.
        check_metrics::<LuaParser>(
            "local function outer()\n    local function inner()\n        return 1\n    end\n    return inner()\nend\n",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn lua_function_expression_in_local_decl_lloc() {
        // `local f = function (x) return x + 1 end` — the function
        // expression is its own space; aggregated LLOC: outer
        // declaration, the inner expression's declaration, the inner
        // `return x + 1`, and the outer `return f(2)` = 4.
        check_metrics::<LuaParser>(
            "local function outer()\n    local f = function (x) return x + 1 end\n    return f(2)\nend\n",
            "foo.lua",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn tcl_apply_closure_lloc() {
        // `apply $f 2` is a regular Tcl command, not a separate function
        // space — tree-sitter-tcl does not model `apply { ... }` as a
        // closure construct distinct from any other command. We assert
        // the observed LLOC (proc, set, apply, plus the nested `expr`
        // command substitution inside the lambda body) so any future
        // change to lambda-body counting is caught here.
        check_metrics::<TclParser>(
            "proc outer {} {\n    set f [list x {return [expr {$x + 1}]}]\n    apply $f 2\n}\n",
            "foo.tcl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 4);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn perl_anonymous_sub_in_sub_lloc() {
        // Anonymous sub `sub { ... }` opens its own function space; the
        // outer LLOC counts the `my $f = ...;` declaration plus
        // `return $f->(2);`, and the anonymous sub contributes
        // `return $_[0] + 1;` for 2 LLOC.
        //
        // NOTE: a prior LLOC for this construct exists as
        // `perl_lloc_anonymous_function` (top-level form) — this test
        // asserts the same shape *inside* another sub, exercising space
        // nesting.
        check_metrics::<PerlParser>(
            "sub outer {\n    my $f = sub { return $_[0] + 1 };\n    return $f->(2);\n}\n",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 2);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn perl_named_sub_in_sub_lloc() {
        // Perl `sub` declarations are not LLOC (see
        // `perl_lloc_function_definition_not_counted`); inside `outer`,
        // only `return inner();` is LLOC, and `inner`'s `return 1` is in
        // its own space contributing one more aggregated LLOC.
        // Total aggregated LLOC: 1.
        //
        // Observation: lloc=1, not 2. Perl LLOC is anchored on `;`
        // tokens whose parent is `SourceFile` or `Block` (see
        // `PerlCode::compute` in this file). The bare `return 1` inside
        // `sub inner { ... }` has no trailing `;`, so it does not bump
        // LLOC. The outer `return inner();` carries the only SEMI.
        // This is intentional Perl behaviour and not a bug — Perl
        // requires `;` between statements; a single trailing statement
        // before `}` is syntactically optional. Asserted as-is.
        check_metrics::<PerlParser>(
            "sub outer {\n    sub inner { return 1 }\n    return inner();\n}\n",
            "foo.pl",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 1);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    #[test]
    fn elixir_fn_inside_def_lloc() {
        // `fn x -> x + 1 end` inside a `def`: defmodule + def +
        // `f = fn ...` + `f.(2)` = 4 own LLOC for the Unit space, plus
        // the anonymous fn body `x + 1` = 1 nested, aggregated 5.
        check_metrics::<ElixirParser>(
            "defmodule Foo do\n  def outer do\n    f = fn x -> x + 1 end\n    f.(2)\n  end\nend\n",
            "foo.ex",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 6);
                assert_eq!(metric.loc.lloc(), 5);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 0);
                insta::assert_json_snapshot!(metric.loc);
            },
        );
    }

    /// Regression for #437: `Loc` min/max must fold each nested function
    /// space's *own* min/max, not its aggregate value, so the smallest
    /// (and largest) leaf function propagates to the root. Before the fix,
    /// merge folded `other.sloc()` and a guarded `compute_minmax` skipped
    /// containers, so `sloc_min` reflected only top-level spaces.
    ///
    /// Layout: Unit (whole file) -> class C -> two methods of *different*
    /// sizes. The smaller method is the global minimum; the file/class
    /// spans are larger; `sloc_min` must be the small leaf, not the class
    /// or unit span. Verified against the pre-fix code by reverting the
    /// merge/compute_minmax change (it reports the unit span instead).
    #[test]
    fn rust_nested_min_max_propagates() {
        check_metrics::<RustParser>(
            "struct C;\nimpl C {\n    fn small(&self) {\n        let _ = 1;\n    }\n    fn big(&self) {\n        let _ = 1;\n        let _ = 2;\n        let _ = 3;\n    }\n}\n",
            "c.rs",
            |metric| {
                // Spaces: Unit + impl C + small() + big().
                // small() spans 3 rows (signature .. closing brace),
                // big() spans 5 rows. The Unit/impl spans are larger
                // still. sloc_min must be the smallest leaf (3), not the
                // top-level span; sloc_max must be the largest space.
                let loc = &metric.loc;
                assert!(
                    loc.sloc_min() <= loc.sloc(),
                    "sloc_min {} must not exceed unit sloc {}",
                    loc.sloc_min(),
                    loc.sloc()
                );
                assert_eq!(loc.sloc_min(), 3, "smallest leaf method span");
                assert_eq!(loc.sloc_max(), loc.sloc(), "largest space is the unit");
                // The smallest leaf has one statement; min must reflect it.
                assert_eq!(loc.lloc_min(), 1);
            },
        );
    }

    /// Java sibling of `rust_nested_min_max_propagates` (#437). The
    /// `java_class_loc` snapshot above showed the bug directly: a class
    /// with methods reported `sloc_min == sloc` (the unit span). Here we
    /// assert the smallest method propagates.
    #[test]
    fn java_nested_min_max_propagates() {
        check_metrics::<JavaParser>(
            "public class C {\n  void small() {\n    int x = 1;\n  }\n  void big() {\n    int a = 1;\n    int b = 2;\n    int c = 3;\n  }\n}\n",
            "C.java",
            |metric| {
                // Spaces: Unit + class C + small() + big().
                let loc = &metric.loc;
                assert!(loc.sloc_min() <= loc.sloc());
                assert_eq!(loc.sloc_min(), 3, "smallest leaf method span");
                assert_eq!(loc.sloc_max(), loc.sloc());
                assert_eq!(loc.lloc_min(), 1);
            },
        );
    }

    /// Python sibling of `rust_nested_min_max_propagates` (#437). Python
    /// nesting is class -> method, mirroring the worked example in the
    /// issue (file -> class C -> method m).
    #[test]
    fn python_nested_min_max_propagates() {
        check_metrics::<PythonParser>(
            "class C:\n    def small(self):\n        x = 1\n    def big(self):\n        a = 1\n        b = 2\n        c = 3\n",
            "c.py",
            |metric| {
                // Spaces: Unit + class C + small() + big().
                let loc = &metric.loc;
                assert!(loc.sloc_min() <= loc.sloc());
                assert_eq!(loc.sloc_min(), 2, "smallest leaf method span");
                assert_eq!(loc.sloc_max(), loc.sloc());
                assert_eq!(loc.lloc_min(), 1);
            },
        );
    }

    /// `blank()` is `sloc - ploc - only_comment_lines`, an f64 subtraction
    /// that can go negative when a space's physical and comment line
    /// attribution overlaps its span row count. It must clamp at 0 so the
    /// serialized value is never negative (#437).
    ///
    /// Built from a synthetic [`Stats`] rather than a parsed fixture: the
    /// current grammars do not emit a parsed space whose root `sloc` is
    /// smaller than `ploc + only_comment_lines`, so a source fixture cannot
    /// drive the subtraction negative and would pass against the pre-clamp
    /// code (proving nothing). Setting `sloc = ploc = only_comment_lines = 1`
    /// yields a pre-clamp `blank` of `1 - 1 - 1 = -1`; reverting the
    /// `.max(0.0)` makes this assertion fail with `-1`.
    #[test]
    fn blank_clamps_negative_to_zero() {
        let mut stats = Stats::default();
        // sloc() for a non-unit span is `end - start + 1` => 1 row.
        stats.sloc.unit = false;
        stats.sloc.start = 0;
        stats.sloc.end = 0;
        // ploc() is the cardinality of the physical-line set => 1.
        stats.ploc.lines.insert(0);
        // One comment-only line on the same single row.
        stats.cloc.only_comment_line_starts.insert(0);

        // Pre-clamp this is 1 - 1 - 1 = -1.
        assert_eq!(stats.sloc(), 1);
        assert_eq!(stats.ploc(), 1);
        assert_eq!(
            stats.blank(),
            0,
            "blank() must clamp the negative subtraction to 0"
        );
    }

    /// Two inline block comments on a single code line must count as a
    /// single comment line, not one per comment node. Pre-fix this
    /// reported `cloc = 2` (one increment per node) for a one-line
    /// construct, violating `cloc <= sloc`/`cloc <= ploc` and pushing
    /// the MI comments_percentage above 100% (issue #461). Reverting
    /// the per-line de-dup in `add_code_comment_line` makes the
    /// `cloc == 1` assertions fail with `2`.
    #[test]
    fn cloc_multiple_block_comments_one_line_cpp() {
        check_metrics::<CppParser>(
            "int f(int /*a*/, int /*b*/) { return 1; }",
            "foo.cpp",
            |metric| {
                assert_eq!(metric.loc.cloc(), 1, "two inline comments => 1 cloc");
                assert!(
                    metric.loc.cloc() <= metric.loc.sloc(),
                    "cloc must not exceed sloc"
                );
                assert!(
                    metric.loc.cloc() <= metric.loc.ploc(),
                    "cloc must not exceed ploc for a single-line construct"
                );
            },
        );
    }

    /// Sibling-language coverage: `add_cloc_lines` is shared across
    /// every block-comment language, so the Rust path must behave
    /// identically to C++ (issue #461).
    #[test]
    fn cloc_multiple_block_comments_one_line_rust() {
        check_metrics::<RustParser>(
            "fn f(/*a*/ x: i32, /*b*/ y: i32) -> i32 { 1 }",
            "foo.rs",
            |metric| {
                assert_eq!(metric.loc.cloc(), 1, "two inline comments => 1 cloc");
                assert!(
                    metric.loc.cloc() <= metric.loc.sloc(),
                    "cloc must not exceed sloc"
                );
            },
        );
    }

    /// Guard against over-de-dup: a single multi-line block comment
    /// must still contribute one comment line per physical line it
    /// spans. The de-dup keys on the start row only, so the three
    /// independent continuation lines are unaffected (issue #461).
    #[test]
    fn cloc_multiline_block_comment_counts_each_line() {
        check_metrics::<CppParser>(
            "int g() {\n  /* l1\n     l2\n     l3 */\n  return 0;\n}",
            "foo.cpp",
            |metric| {
                assert_eq!(
                    metric.loc.cloc(),
                    3,
                    "a 3-line block comment counts 3 comment lines"
                );
            },
        );
    }

    /// Two *standalone* block comments on a single physical line (no
    /// code) must count as one comment line, not one per node. #461
    /// deduped only inline co-located comments via the code-comment
    /// path; the standalone path bumped `only_comment_lines` per node,
    /// so `/*a*/ /*b*/` reported `cloc = 2` for a single line —
    /// violating `cloc <= sloc`. Reverting the per-line set in
    /// `add_only_comment_lines` makes the `cloc == 1` assertion fail
    /// with `2` (verified by reverting to `only_comment_lines += …`).
    #[test]
    fn cloc_multiple_standalone_block_comments_one_line_cpp() {
        check_metrics::<CppParser>("/*a*/ /*b*/", "foo.cpp", |metric| {
            assert_eq!(
                metric.loc.cloc(),
                1,
                "two standalone comments on one line => 1 cloc"
            );
            assert_eq!(metric.loc.sloc(), 1);
            assert!(
                metric.loc.cloc() <= metric.loc.sloc(),
                "cloc must not exceed sloc"
            );
        });
    }

    /// Sibling-language coverage: the standalone de-dup lives in the
    /// shared `add_only_comment_lines` helper, so Rust must match C++
    /// (issue #461 follow-up).
    #[test]
    fn cloc_multiple_standalone_block_comments_one_line_rust() {
        check_metrics::<RustParser>("/*a*/ /*b*/", "foo.rs", |metric| {
            assert_eq!(
                metric.loc.cloc(),
                1,
                "two standalone comments on one line => 1 cloc"
            );
            assert_eq!(metric.loc.sloc(), 1);
            assert!(
                metric.loc.cloc() <= metric.loc.sloc(),
                "cloc must not exceed sloc"
            );
        });
    }

    /// File-level guard: a comment-only physical line followed by a
    /// real code line still counts the comment line once and never
    /// exceeds sloc, even after the per-space merge that previously
    /// summed `code_comment_lines` (and double-counted a boundary line)
    /// rather than reading the per-line set. Three standalone comments
    /// share line 1, so the whole file has exactly one comment line.
    #[test]
    fn cloc_standalone_comments_then_code_no_double_count() {
        check_metrics::<CppParser>("/*a*/ /*b*/ /*c*/\nint x = 1;\n", "foo.cpp", |metric| {
            assert_eq!(metric.loc.sloc(), 2);
            assert_eq!(
                metric.loc.cloc(),
                1,
                "only line 1 carries comments => 1 cloc"
            );
            assert!(
                metric.loc.cloc() <= metric.loc.sloc(),
                "cloc must not exceed sloc"
            );
        });
    }

    /// Interior blank lines are counted as BLANK and excluded from PLOC.
    /// sloc 6 (every line) / ploc 4 (4 code lines) / lloc 3 (handler + 2
    /// `set`s) / cloc 0 / blank 2.
    #[test]
    fn irules_blank() {
        check_metrics::<IrulesParser>(
            "when X {\n\n    set x 1\n\n    set y 2\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.sloc(), 6);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.cloc(), 0);
                assert_eq!(metric.loc.blank(), 2);
            },
        );
    }

    /// A handler body with no blank lines reports zero BLANK. lloc 3 =
    /// handler + `set` + `log` command.
    #[test]
    fn irules_no_zero_blank() {
        check_metrics::<IrulesParser>(
            "when HTTP_REQUEST {\n    set x 1\n    log local0. $x\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.sloc(), 4);
                assert_eq!(metric.loc.ploc(), 4);
                assert_eq!(metric.loc.lloc(), 3);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    /// `#`-prefixed comment lines are counted as CLOC (iRules has no block
    /// comments, so each comment node spans exactly one line).
    #[test]
    fn irules_cloc() {
        check_metrics::<IrulesParser>(
            "# a\n# b\n# c\nwhen X { set x 1 }\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.cloc(), 3);
                assert_eq!(metric.loc.blank(), 0);
            },
        );
    }

    /// LLOC counts each statement once: handler header, `if`, `set`, and the
    /// generic `log` command = 4. The `switch_arm` headers are not counted
    /// (their bodies' commands are), verified in `irules_switch_lloc`.
    #[test]
    fn irules_lloc() {
        check_metrics::<IrulesParser>(
            "when X {\n    if { $a } {\n        set x 1\n    }\n    log local0. done\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    /// A command inside `[...]` (`command_substitution`) is a sub-expression,
    /// not a top-level statement, so it does not add to LLOC. Here lloc 2 =
    /// handler + `set`; the inner `expr` is NOT counted. Removing the
    /// `CommandSubstitution` guard would push lloc to 3 — this is the loc
    /// gating-decision regression test.
    #[test]
    fn irules_no_command_substitution_lloc() {
        check_metrics::<IrulesParser>(
            "when X {\n    set y [expr { 1 + 2 }]\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    /// `switch` counts once; each arm's *body* command counts, but the
    /// `switch_arm` pattern/body pair itself is not a logical line. lloc 4 =
    /// handler + `switch` + two `set`s (one per arm body).
    #[test]
    fn irules_switch_lloc() {
        check_metrics::<IrulesParser>(
            "when X {\n    switch $h {\n        a { set r 1 }\n        b { set r 2 }\n    }\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.lloc(), 4);
            },
        );
    }

    /// A `proc` definition and its `return` command are each one logical
    /// line: lloc 2.
    #[test]
    fn irules_proc_lloc() {
        check_metrics::<IrulesParser>(
            "proc f { a } {\n    return $a\n}\n",
            "foo.irule",
            |metric| {
                assert_eq!(metric.loc.lloc(), 2);
            },
        );
    }

    /// Objective-C blank-line accounting: two code lines separated by
    /// blank lines.
    #[test]
    fn objc_blank() {
        check_metrics::<ObjcParser>(
            "

            int a = 42;

            int b = 43;

            ",
            "foo.m",
            |metric| {
                assert_eq!(metric.loc.blank(), 1);
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 3,
                  "ploc": 2,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 1,
                  "sloc_average": 3.0,
                  "ploc_average": 2.0,
                  "lloc_average": 2.0,
                  "cloc_average": 0.0,
                  "blank_average": 1.0,
                  "sloc_min": 3,
                  "sloc_max": 3,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 2,
                  "ploc_max": 2,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 1,
                  "blank_max": 1
                }
                "#);
            },
        );
    }

    /// Objective-C comment accounting: a block comment and a line
    /// comment each contribute to `cloc`.
    #[test]
    fn objc_cloc() {
        check_metrics::<ObjcParser>(
            "/* Block comment
            still the block */
            // Line comment
            int a = 42; // trailing",
            "foo.m",
            |metric| {
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 4,
                  "ploc": 1,
                  "lloc": 1,
                  "cloc": 4,
                  "blank": 0,
                  "sloc_average": 4.0,
                  "ploc_average": 1.0,
                  "lloc_average": 1.0,
                  "cloc_average": 4.0,
                  "blank_average": 0.0,
                  "sloc_min": 4,
                  "sloc_max": 4,
                  "cloc_min": 4,
                  "cloc_max": 4,
                  "ploc_min": 1,
                  "ploc_max": 1,
                  "lloc_min": 1,
                  "lloc_max": 1,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    /// Objective-C logical-line accounting: a method whose body has three
    /// statements. The `method_definition` opens a function space but is
    /// not itself a logical line; each statement adds one.
    #[test]
    fn objc_lloc() {
        check_metrics::<ObjcParser>(
            "@implementation Foo
- (int)bar {
    int a = 1;
    int b = 2;
    return a + b;
}
@end
",
            "foo.m",
            |metric| {
                // expected: decl `int a` (1) + decl `int b` (1) +
                // `return` (1) = 3.
                assert_eq!(metric.loc.lloc(), 3);
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 7,
                  "ploc": 7,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.3333333333333335,
                  "ploc_average": 2.3333333333333335,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 7,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 7,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    /// Objective-C for-header gating: the `int i = 0` declaration in a
    /// classic `for` init slot is part of the `for` statement's logical
    /// line and must NOT add a second one (mirrors the C / C++ gate).
    /// Reverting the `count_specific_ancestors` gate would push lloc from
    /// 2 to 3.
    #[test]
    fn objc_no_declaration_in_for_header_lloc() {
        check_metrics::<ObjcParser>(
            "@implementation Foo
- (void)bar {
    for (int i = 0; i < 10; ++i) {
        [self use:i];
    }
}
@end
",
            "foo.m",
            |metric| {
                // expected: for-statement (1) + body expression
                // `[self use:i]` (1) = 2. The header `int i = 0`
                // declaration is gated out; without the gate this is 3.
                assert_eq!(metric.loc.lloc(), 2);
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 7,
                  "ploc": 7,
                  "lloc": 2,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 2.3333333333333335,
                  "ploc_average": 2.3333333333333335,
                  "lloc_average": 0.6666666666666666,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 5,
                  "sloc_max": 7,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 5,
                  "ploc_max": 7,
                  "lloc_min": 2,
                  "lloc_max": 2,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }

    #[test]
    fn objc_at_directives_lloc() {
        // The only ObjC-specific LLOC work the impl does beyond the C
        // inheritance: `@synchronized` is a dedicated `synchronized_statement`
        // node (counts as a logical line), but `@autoreleasepool` emits
        // only a keyword token with no wrapping node, so its *header* adds
        // nothing and only its inner statements count.
        check_metrics::<ObjcParser>(
            "@implementation Foo
- (void)bar {
    @synchronized (self) {
        [self use];
    }
    @autoreleasepool {
        [self use];
    }
}
@end
",
            "foo.m",
            |metric| {
                // expected: @synchronized statement (1) + its body
                // `[self use]` (1) + the @autoreleasepool body `[self use]`
                // (1) = 3. The `@autoreleasepool` header contributes no
                // logical line (it has no node); if it did, this would be 4.
                assert_eq!(metric.loc.lloc(), 3);
                insta::assert_json_snapshot!(metric.loc, @r#"
                {
                  "sloc": 10,
                  "ploc": 10,
                  "lloc": 3,
                  "cloc": 0,
                  "blank": 0,
                  "sloc_average": 3.3333333333333335,
                  "ploc_average": 3.3333333333333335,
                  "lloc_average": 1.0,
                  "cloc_average": 0.0,
                  "blank_average": 0.0,
                  "sloc_min": 8,
                  "sloc_max": 10,
                  "cloc_min": 0,
                  "cloc_max": 0,
                  "ploc_min": 8,
                  "ploc_max": 10,
                  "lloc_min": 3,
                  "lloc_max": 3,
                  "blank_min": 0,
                  "blank_max": 0
                }
                "#);
            },
        );
    }
}