Skip to contents

Changelog

Source: NEWS.md

sumExtras 1.0.0 (2026-02-09)

CRAN release: 2026-02-11

Breaking Changes

  • Removed apply_labels_from_dictionary(). Use attr(data$var, "label") <- "Label" directly, or the labelled package for bulk attribute labeling.

New Features

  • extras() auto-labeling via options(sumExtras.auto_labels = TRUE) and (recommended) options(sumExtras.prefer_dictionary = TRUE). See vignette("options").
  • extras() now bolds significant p-values (bold_p()) automatically when p-values are added.
  • New header parameter in extras() controls the label column header text (default "").
  • New symbol parameter in clean_table() and extras() controls the missing value replacement string (default "---").
  • add_group_colors() now accepts a vector of colors (one per group) in addition to a single color for all groups.

Improvements

  • Data dictionaries now use lowercase column names (variable, description) by convention. Title-case names (Variable, Description) still work — column matching is case-insensitive.
  • extras() now handles tbl_regression gracefully: overall and pval are silently ignored (regression tables already have model p-values), and bold_p() is applied automatically. No more warnings when using extras() with default arguments on regression tables.
  • Removed startup message. The package now loads silently.
  • Dropped purrr from Imports (4 dependencies instead of 5).
  • New vignettes: vignette("options") and vignette("themes").

sumExtras 0.3.1 (2026-01-22)

Improvements

  • Added quiet = TRUE default to use_jama_theme() to suppress messages from {gtsummary} and {sumExtras}. Resolves issue #12 (thank you @RaymondBalise).

  • extras() no longer warns when called with default arguments on non-stratified tables. Previously, calling extras(tbl) on a table without a by argument would warn even though the user didn’t explicitly request overall or pval features. Now warnings only fire when users explicitly request features that can’t be applied:

    • extras(non_stratified_tbl) - Silent (applies basic formatting)
    • extras(non_stratified_tbl, overall = TRUE) - Warns (user explicitly requested)
    • extras(non_stratified_tbl, pval = TRUE) - Warns (user explicitly requested)

sumExtras 0.3.0 (2026-01-15)

CRAN release: 2026-01-22

New Features

  • New .add_p_args argument to extras() allows for passing gtsummary::add_p() arguments, such as:
    • test for specifying statistical tests for each variable (i.e., "t.test", "fisher.test"). Thank you, Daniel Maya.
    • pvalue_fun for formatting p-values
    • group, include, etc.
    • See ?gtsummary::add_p.tbl_summary for more information of proper usage.

Improvements

  • Extended list of zero or NA value recognition used by clean_table. This fixes the function previously not recognizing 0 (0) for Mean (SD).

sumExtras 0.2.0 (2026-01-05)

CRAN release: 2026-01-19

Breaking Changes

  • group_styling() renamed to add_group_styling() to follow gtsummary’s add_*() naming convention

New Features

  • New add_group_colors() function provides a clean, pipeable way to add background colors to group headers
    • Combines text formatting, gt conversion, and color application in one step
    • Eliminates need for manual get_group_rows() and as_gt() calls
    • Reduces typical styling code from 20+ lines to ~11 lines

Documentation

  • Updated all examples and vignettes to use new function names
  • Improved README with cleaner side-by-side comparison showcasing the new API
  • Added add_group_colors() section to styling vignette with side-by-side manual vs. convenience pattern comparison
  • Updated all function references across documentation

sumExtras 0.1.1 (2025-11-15)

Bug Fixes

  • clean_table() now correctly handles additional percentage formats including 0% (0.000) and 0.00% (0.00), which were previously not being converted to dashes
  • apply_labels_from_dictionary() improved with clearer implementation using traditional for-loop instead of confusing <<- side-effect assignment

Improvements

  • Removed stringr dependency by replacing str_detect() with base R grepl(..., perl = TRUE), reducing package dependency footprint
  • Replaced purrr::walk2() with traditional for-loop in apply_labels_from_dictionary() for improved code clarity and maintainability

Documentation

  • Added package-level documentation (sumExtras-package) with notes about dependency on gtsummary internal structures and minimum version requirements
  • Enhanced add_auto_labels() documentation with implementation notes about gtsummary internals
  • Added Fisher test documentation in extras() explaining why Monte Carlo simulation is used
  • Created CITATION file for proper package attribution

Testing

  • Added unicode and emoji test to verify label handling of special characters (emoji, Greek letters, symbols)
  • Updated all regex tests to use base R grepl() instead of stringr

sumExtras 0.1.0 (2025-11-15)

Breaking Changes

  • Removed automatic JAMA compact theme setting on package load to comply with CRAN policies
  • Package no longer modifies global gtsummary theme automatically when loaded
  • create_labels() has been deprecated and removed. Users should migrate to add_auto_labels() instead. Migration example: Instead of tbl_summary(label = create_labels(data, dict)), use tbl_summary() |> add_auto_labels(dict).

New Features

  • Added use_jama_theme() function for explicit JAMA compact theme application
  • Users can now opt-in to the recommended JAMA theme by calling use_jama_theme()
  • add_auto_labels() now supports tbl_regression and tbl_uvregression objects in addition to tbl_summary objects (55bc540)
  • add_auto_labels() now automatically searches the calling environment for a dictionary object when no dictionary is explicitly provided
  • add_auto_labels() can now read label attributes directly from data as a fallback when no dictionary is found, so it works with {haven}, {labelled}, and other packages that set label attributes
  • add_auto_labels() uses a fixed label priority: manual labels (from label = list()) take precedence, then attribute labels, then dictionary labels, then variable names
  • Added apply_labels_from_dictionary() function to set label attributes on data from a dictionary for use with ggplot2 4.0+, gt, and other label-aware packages
  • Label priority is fixed: manual labels > attribute labels > dictionary labels
  • group_styling() gains an indent_labels parameter (default 0L) to control indentation of variable labels under group headers. Set to 4L to preserve gtsummary’s default group indentation behavior
  • extras() gains a last parameter to control Overall column position (default FALSE aligns with gtsummary::add_overall() behavior)
  • extras() gains a .args parameter to accept a list of arguments, allowing programmatic control of pval, overall, and last parameters

Minor Improvements and Bug Fixes

  • add_auto_labels() now falls back to label attributes when no dictionary is found instead of erroring
  • Fixed missing import of gtsummary::all_tests() in extras() function
  • Improved regex pattern in clean_table() to avoid false positives (e.g., matching "..." or " ")
  • extras() now warns when add_overall() or add_p() fail instead of silently continuing
  • Fixed modify_indent() column parameter in group_styling() - column name now properly quoted as “label” to ensure correct indentation when rendering vignettes in pkgdown
  • extras() now warns when called with unsupported table types (tbl_regression, tbl_strata, non-stratified tables) instead of silently skipping features
  • Fixed clean_table() handling of tbl_strata objects by detecting when var_type column is missing

Performance Improvements

  • Optimized add_auto_labels() to avoid double iteration when extracting variable names and labels

Documentation

  • Updated README with use_jama_theme() usage in Quick Start
  • Updated vignette with new theme management section
  • Added use_jama_theme() to function reference list
  • Improved documentation formatting across all functions

sumExtras 0.0.0.9000 (development version)

  • Initial development release of sumExtras
  • Added extras() function for one-call gtsummary table styling
  • Added clean_table() for standardized missing value display
  • Added add_auto_labels() and create_labels() for automatic variable labeling
  • Added theme_gt_compact() for JAMA-style gt table themes
  • Added group_styling() for group header formatting