NEWS

---

wbCorr 0.3.2 (2026-07-23)

Statistical correctness

• Reimplemented the one-way random-effects, single-measure ICC(1,1) with the ANOVA method-of-moments formula for unequal cluster sizes. Negative sample ICCs are retained, and non-estimable cases now return explicit diagnostics.
• Corrected Pearson analytic degrees of freedom and Fisher-z confidence intervals. Intervals are bounded by -1 and 1, and inference that is not supported by the available analysis units is reported as unavailable.
• Clarified that the Spearman option is a descriptive correlation of mean-centered scores within clusters and of cluster means between clusters. Unsupported analytic, row-jackknife, and cluster-size-weighted Spearman inference has been removed; whole-cluster bootstrap intervals remain available.

Inputs, diagnostics, and output

• Strengthened validation for data, cluster identifiers, method, confidence levels, bootstrap settings, weighting, and centering choices.
• Logical variables and declared two-level factors are supported with explicit 0/1 orientation. Other categorical inputs are rejected with guidance, and non-finite numeric values are treated as missing.
• Detailed tables now retain every requested variable pair, including pairs whose coefficient or inference cannot be estimated. Pair-specific observation counts, cluster counts, coefficient status, inference status, reasons, and bootstrap yield diagnostics are reported.
• Correlation-matrix diagonals are 1 only for variables with positive variance at the relevant level; otherwise they are NA.
• Added positive-semidefinite diagnostics for the unrounded within- and between-cluster matrices. Pairwise matrices that are not positive semidefinite now trigger a targeted warning, and missing_data = "listwise" provides an optional common-row analysis.
• get_matrix(..., numeric = TRUE) now returns unrounded numeric within, between, and merged matrices, including unrounded ICC diagonals.
• print() now provides concise, executable guidance for inspecting summaries and extracting full tables, numeric matrices, and ICCs.
• Plot panels now use the exact pair-specific rows, centering rule, method, and between-cluster weights used by the fitted object. Annotations come from the stored coefficient and p-value, and significance legends are omitted when p-values were not requested or are unavailable.
• to_excel() now accepts a data frame or matrix directly, supports mixed lists of tabular objects, errors clearly when there is nothing to write, and invisibly returns the supplied output path.

Development and release preparation

• Added reference tests against psych::statsBy() for within- and between-cluster correlations and ICC(1,1), and expanded automated regression-test coverage.
• Added a pkgdown website workflow and a vignette introducing the distinction between within- and between-cluster correlations.
• Removed obsolete self-generated test fixtures, a generated plot file, and tracked R session history. Added safeguards against including regenerated session or graphics artifacts in the repository and source package.
• Corrected the bundled-data documentation to report 5,000 observations from 100 participants measured over 50 days.
• Added repository citation metadata and a DOI badge that use the permanent Zenodo concept DOI, 10.5281/zenodo.20357592, rather than a release-specific DOI.