saros

• **Added DOCX table types**: New cat_table_docx and chr_table_docx output types for creating Word document tables. These types use officer::body_add_table() to embed tables in Word documents. Like HTML table types, they return data.frames when docx_return_object=TRUE, enabling flexible table composition
• Added docx_return_object parameter to makeme() to control return type for DOCX outputs. When TRUE, returns the underlying object (mschart for plots, data.frame for tables) instead of embedding it in an rdocx document, enabling more flexible composition of Word documents
• **Refactored fig_height_h_barchart2() to S3 generic**: Now supports both ggplot2 objects (from type="cat_plot_html") and mschart objects (from type="cat_plot_docx", docx_return_object=TRUE). This enables automatic height calculation for Word charts, making it easier to size charts consistently across output formats
• **Refactored n_range2() to S3 generic**: Now supports both ggplot2 objects and mschart objects, similar to fig_height_h_barchart2(). This enables consistent sample size reporting across both HTML and Word chart outputs, making it easier to annotate charts with N ranges regardless of output format

Bug Fixes

• Updated make_link() tests to use dynamic rlang::hash() values instead of hardcoded hashes, preventing fragile failures when hash representations change across environments or versions (#587)
• crowd_plots_as_tabset() now gives an informative error when passed table output (e.g. from type = "cat_table_html") instead of plot output, directing users to crowd_tables_as_tabset() (#515)
• txt_from_cat_mesos_plots() now gives an informative error when passed table output instead of plot output, instead of failing with a cryptic .category_order column-not-found error (#515)
• Fixed girafe() to return a static ggplot object instead of a girafe object when rendering in non-HTML knitr documents (e.g. PDF, Word). Previously the interactive widget was returned unconditionally, causing rendering failures in non-HTML output formats (#551)
• Fixed cat_plot_html data labels being left-aligned instead of centered. The hjust value for geom_label was corrected from 0 to 0.5 (#553)
• Fixed txt_from_cat_mesos_plots() for checkbox variables to compare on the checked category (or the first non-NA category as fallback) rather than always using the first category. This ensures the correct proportion is highlighted when the variable uses checked/not_checked encoding (#556)
• Fixed txt_from_cat_mesos_plots() color legend inconsistency across mesos groups. Category color assignment now only computes full factor levels for factor/ordered variables, preventing spurious extra colors from appearing in legends for non-factor variables (#552, #555)
• Fixed txt_from_cat_mesos_plots() showing zero proportions due to .variable_label_original being overwritten by the N-suffix mutation in add_n_to_label() before it could be used for joining. The original column is now preserved before any label mutation (#554)
• Fixed int_plot_html to always hide the fill legend (previously shown for single dep without indep), and to correctly respect hide_axis_text_if_single_variable (previously ignored for int_plot_html, only applied to cat_plot_html) (#557)
• Fixed cat_plot_docx percentage plots to show consistent axis breaks at 0%, 25%, 50%, 75%, and 100% by setting axis limits (0-1) and major unit (0.25; experimental) for the y-axis. This improves readability and consistency across Word document charts
• Fixed default font sizes for cat_plot_docx: increased label_font_size and main_font_size defaults from 6 to 9 for better readability in Word documents
• Fixed hide_axis_text_if_single_variable parameter not being respected in cat_plot_docx output. The function now properly hides axis labels for single-variable plots when this parameter is TRUE, matching the behavior of cat_plot_html
• Fixed colour_palette parameter not being applied in cat_plot_docx output. The mschart library requires colour palettes to be named vectors where names match category levels, and the length must match the number of categories. The function now: (1) names the colour palette vector with category levels, (2) expands the palette with generated colours if user provides fewer colours than categories, and (3) trims the palette if user provides more colours than needed
• Fixed set_pdf_metadata_title() corrupting non-ASCII characters (e.g. æøå) in PDF metadata titles. The pdfmark title is now encoded as a UTF-16BE hex string with BOM instead of a plain PostScript literal, avoiding locale/codepage-dependent byte interpretation by Ghostscript
• Fixed fig_height_h_barchart2() where hide_axis_text_if_single_variable=TRUE was paradoxically giving larger heights than FALSE. Now correctly detects when axis text has been hidden (via .variable_label_original column) and applies a reduction factor (default 0.6 via multiplier_hide_axis_single_var parameter) plus reduced minimum height, resulting in appropriately smaller plots when axis text is hidden
• Fixed fig_height_h_barchart2() for int_plot_html plots: previously always returned max (12) regardless of plot complexity, and errored with "only supports a single indep variable" when an indep variable was present (because .value was falsely detected as a second indep column). Height now scales properly with n_y and n_cats_x via fig_height_h_barchart() with n_cats_y = 1 and n_legend_lines = 0
• Fixed n_range2() for int_plot_html plots to report N range per dependent variable instead of total count across all variables. Now correctly calculates sample size separately for each variable and reports the range (e.g., [250-299] when variables have different amounts of missing data)
• Fixed guess_legend_ncols() in girafe() to properly handle fill aesthetics using expressions like fill = factor(cyl). The function now uses get_fill_levels() to evaluate expressions in data context instead of direct column access, preventing "no non-missing arguments to max; returning -Inf" warnings
• makeme() now gives an informative error message when the requested output type is incompatible with the dependent variable types (e.g., using type = "cat_table_html" with numeric variables, or type = "int_plot_html" with factor variables). Previously this produced a cryptic error about setting an attribute on NULL.

Internal Improvements

• **Optimized fig_height_h_barchart2() ggplot height estimation**: The function now extracts information directly from the ggplot object for more accurate height calculations:
• Reads the actual font size from the ggplot theme (base_size) instead of using a fixed default, so heights scale correctly when users change the global ggplot2 theme (e.g., theme_gray(base_size = 14))
• Detects legend position from the theme — when the legend is at the sides ("right", "left") or hidden ("none"), no vertical space is allocated for it, producing more compact figures
• Simulates actual text wrapping (via count_max_wrapped_lines()) to count the true number of lines labels wrap to, instead of estimating from character counts
• Fixed fig_height_h_barchart() strip angle condition to use abs(strip_angle), so negative angles (e.g., -90° from default ggplot2 strip themes) are handled identically to their positive counterparts
• Extracted shared color resolution logic into resolve_category_colors() helper, removing duplication across make_content.cat_plot_html(), make_content.cat_plot_docx(), and related functions (#548)
• **Major refactoring of validation infrastructure** (implements refactoring opportunities #1 and #4):
• All validation functions now use consistent validate_* prefix for better discoverability via auto-complete (e.g., validate_bool(), validate_integerish(), validate_double(), validate_string())
• Added validate_params() helper function that consolidates multiple parameter validations into a single declarative call, reducing code duplication from 30+ lines to ~5 lines in fig_height_h_barchart()
• Created validation rule builders (validate_integerish_rule(), validate_double_rule(), validate_bool_rule(), validate_string_rule()) for more expressive and maintainable validation specifications in validate_makeme_options()
• Maintained backwards compatibility with check_* aliases for existing code
• Improved code maintainability and readability across validation-heavy functions
• Added is_int_plot_html() helper function to centralize detection logic for int_plot_html data structures, improving code maintainability and consistency across fig_height_h_barchart2() and n_rng2()