NEWS

gtExtras 0.6.1 (2025-10-10)

Handle interquartile range of zero in gt_plt_summary() - #104
Experimentally handle multiple types of plots in gt_plt_dist() - #102
Resolve issues with gt_plt_summary() - #148 and 146
Address test issues with svglite - #147
Remove deprecated fontawesome functions gt_fa_repeats(), and gt_fa_column() in favor of gt native functions.
Address CRAN issues

Refactor NA handling in gt_fa_ functions - thanks to @areckenrode via #78
Allow for all negative values in gt_plt_bar() - thanks to @paspvik via #75
Respect max and negative range of target and column values in gt_plt_bullet() - thanks to @zdenall via #79
Improve gt_theme_538() to better align with FiveThirtyEight style, namely improved font choices ("Cairo")
Address NAs properly in gt_fa_rank_change() - thanks to @moodymudskipper via #80
Refactor fmt_symbol_first() to work correctly with any font, not just monospace fonts.
Add an experimental gt_render_reprex() thanks to @mrcaseb suggestion on Twitter
Allow for entire NA columns in gt_plt_bar() and gt_plt_bar_pct() - #86
Accommodate small values in gt_plt_bullet() - #87
Address some small bugs #94 and #95
Add an expandable tag to gt_plt_summary()
Add a labelling feature to gt_plt_bar_pct() - thanks to @andreweatherman and PR

Refactor many functions to account for upstream changes in gt v0.8.0
Add a palette_col argument to gt_plt_bullet() to accept a named column of palette colors as present in the data. Fixed #72
Fix internals of gt_theme_pff() to use table.font.size inside tab_options() rather than tab_style(). Fixed #74
Fix a few instances of geom_line() and geom_v/hline() that were throwing warnings for ggplot2 v3.4.0
Refactor internals of fmt_pad_num to align with @mrcaseb implementation https://gist.github.com/mrcaseb/f0f85b48df7957c27c4205cafccbc5a2
Refactor many functions that use lines with size parameter, to avoid ggplot2 v.3.4.0 deprecation warnings (affects gt_plt_bar, gt_pct_bar, gt_plt_dist, gt_plt_conf_int, gt_plt_percentile_dot, gt_plt_point, gt_plt_sparkline, gt_win_loss)

Modify internals of gt_fa_column() to accept factors with levels not present in the data, ignoring unneeded levels. Thank you to @mikedolanfliss for the suggestion.
Add gt_merge_stack_color() to create a merge/stack with background color - per @mrcaseb and issue #71
Add gt_alert_icon() to create a colored circle based on the range of values in the column.
Fix a CRAN extra check

Rebuild docs with latest roxygen2 to fix HTML documentation issues on CRAN
Add gt_img_multi_rows() courtesy of Ryan Timpe per #63
Add "alt" argument to man_get_image_tag() helper - solves CRAN HTML issues for missing alt-text
Use alt-text on gt_plt_summary() and gt_plt_winloss()

Add explicit height argument to gt_fa_column()
Add get_row_index() to assist in applying styles to specific rows visually
Refactor last_row_id() to use get_row_index() internally.
Refactor gt_index() to respect multiple groups - closes Issue #58 - thanks @jmbarbone !
Refactor tab_style_by_grp() to respect multiple groups
Add NA handling to gt_plt_conf_int() - closes #52
Update readme content to reflect latest documentation
Remove use_paletteer argument from documentation (inline operation in function)
Convert &nbsp to   in fmt_symbol_first() and fmt_pad_num(), convert tests to match
Update documentation for gt_img_circle()
Add gt_theme_pff() for Pro Football Focus style tables
Add a "pff" palette option to gt_color_box()
Add new arguments to gt_merge_stack() per issue 53
Bulk update of examples sections and updated images
Remove background color from label in gt_plt_conf_int() - closes #54
Add gt_index() to internals of gt_merge_stack() to prevent incorrect arrangement when grouping data - closes issue #55
Corrected gt_plt_sparkline() where in some cases inline plots weren't respecting shared limits.

Renamed colors argument in gt_win_loss() to palette
Added NA handling to all fontawesome::fa() functions, ie gt_fa_rank_change(), gt_fa_repeats(), gt_fa_column()
Add missing data handling to more plotting functions
Refactor testing to use webshot2::webshot() over webshot::webshot()
Remove gt_sparkline() - functions separated into gt_plt_sparkline() and gt_plt_dist()

Remove use_paletteer arg from gt_color_rows() in favor of a hopefully more user friendly detection of ::
Convert gt_color_rows() 'type' argument to 'pal_type' to prevent an edge-case where a column named type conflicts with the paletteer "type" argument per issue #50

Add initial version of a gt_plt_summary() function, as inspired by the Observable/SummaryTable function.
gt_sparkline() will be removed soon now that bstfun/gtsummary are no longer depending on it. gt_plt_dist() and gt_plt_sparkline() will be the new preferred and enhanced versions of gt_sparkline().
Add tests for gt_plt_summary()

Remove scales::scales_label_si() in favor of scales::label_number(scale_cut = cut_scale_short()) as the previous function was deprecated. Thanks to @mrcaseb for pointing out in Issue 48

Add Daniel Sjoberg as a contributor in honor of their major assistance with preparation towards CRAN
Move past 0.2 release into a "next stop CRAN"... hopefully
Vendor additional unexported functions from {gt} with attribution

Bring in webshot2 as a remote dependency suggest and minor changes to clean up some R checks, thanks to a PR from the great Daniel Sjoberg.
Correct an internal bug in gt_plt_dist() which was failing for plotting integers.

Exchange webshot for webshot2 to enhance capabilities. Note that webshot2 is GitHub only, install via: remotes::install_github("rstudio/webshot2"). This solves issue #42.

Use gt_index to prevent incorrect ordering of rows with gt_plt_bar_pct() per StackOverflow report
Remove keep_column argument for gt_plt_bullet, this functionality is able to be achieved with gt_duplicate_column() upstream. This also solves naming confusion as seen in issue 37