NEWS

ggforestplotR 0.2.2

Fixed faceted ggforestplot() output when users add scale_y_discrete(limits = ...), preserving per-facet row filtering while accepting visible term labels.

Simplified the reference-line API in ggforestplot(): ref_line now takes the numeric reference value directly, and NULL hides the line.
Replaced the older reference-line arguments with ref_label, ref_linetype, and ref_color.

Added facet and facet_strip_position as clearer names for grouped plot panels. The older grouping and grouping_strip_position arguments now warn and continue to work.
Added linewidth for confidence interval widths. The older line_size argument now warns and continues to work.
Added deprecation warnings for table-display shortcuts in favor of explicit columns, left_columns, and right_columns selections.

Added stripe_alpha to control row stripe transparency across plots, side tables, and split tables.
Updated table helpers so they inherit custom y-axis ordering and filtering from the trained forest plot scale.
Updated vignettes and tests to use the clearer faceting and geometry argument names.

Added separate table formatting controls for point estimates, confidence interval bounds, and p-values via estimate_digits, interval_digits, and p_digits.
Added ref_line, ref_line_value, and ref_line_label to standardize reference-line naming while keeping zero_line arguments backward compatible.
Added term_labels, a named-vector relabeling helper for displayed model terms.
Expanded add_forest_table(columns = ...) and split-table column selection to support arbitrary preserved data columns in addition to built-in columns.
Added column_labels, a named-vector helper for relabeling displayed table column headers.
Added a built-in ci table column and ci_fmt so users can display point estimates and confidence intervals in separate columns. conf.low and conf.high are accepted as aliases for ci.

Added model-aware default effect labels and scales, including odds ratios for binomial logit models and hazard ratios for Cox models.

Added events column support across ggforestplot(), as_forest_data(), add_forest_table(), and add_split_table(). (Thanks @sritchie73 for the suggestion)
Added table header styling controls for font size, font face, and font family in both table helpers. (Thanks @sritchie73 for the suggestion)
Split table composition code into dedicated source files to simplify maintenance of the public API.
Refined split-table examples and documentation to match the expanded numeric column mapping.

Refined split-table layout logic, including dynamic panel widths from column counts, alignment controls, and cleaner stripe/background handling.
add_forest_table() now allows for custom column ordering via the columns argument.
Converted package documentation to roxygen-generated NAMESPACE and .Rd files.
Reworked package documentation, including pkgdown configuration, README installation guidance, and the vignette set.