NEWS

doconv 0.4.0 (2026-02-14)

New exported function run_in_shiny_app() to run an arbitrary command against a live Shiny application. Manages the app lifecycle (start, wait for HTTP readiness, stop) via processx; the command to execute is passed through ... to processx::run().
New exported functions expect_snapshot_ggplots() and expect_snapshot_flextables() for visual regression testing of ggplot2 plots and flextable objects within testthat test suites.
New exported helper skip_if_not_snapshot_png() to skip tests when snapshot dependencies (ragg, gdtools) are not available.
to_miniature() gains ncol and ncol_landscape parameters for easier page layout. ncol groups pages N-per-row; adding ncol_landscape enables orientation-aware layout where portrait and landscape pages use different column counts.

Forward slashes in file paths are now converted to backslashes before injection into PowerShell scripts, fixing failures when paths contain spaces (#5).
PowerShell scripts now use try/finally to guarantee Word.Quit() and PowerPoint.Quit() are called even when an error occurs, preventing orphan COM processes on Windows.
Word.Visible = $False is now set before opening the document in PowerShell scripts, eliminating the brief window flash on startup.
PowerPoint's Presentations.Open() now uses WithWindow=$false to open presentations without a visible window.
AppleScript scripts now use try/on error blocks to ensure cleanup (close document + conditional quit) runs even when an error occurs, and the error is re-raised so that processx::run() sees a non-zero exit status.
File paths are now sanitized before injection into script templates: sprintf() replaced by sub() to handle % in paths, and special characters (", `, $, \) are escaped for PowerShell and AppleScript respectively.

Fail with informative error message if PowerShell (PS) execution strategy does not allow running PS scripts. PS scripts are required for certain actions on Windows (#2).

For 'Windows' users, figure resolution should now remain the same when exporting 'Word' to 'PDF'.

new function expect_snapshot_html() for visual testing HTML documents.
new function msoffice_available() to test if 'Word' and 'PowerPoint' are available.

Export functions init_working_directory, rm_working_directory and working_directory to let users manage docx2pdf working directory and comply with CRAN policy.
Use tempfile() to make libreoffice write in a temporary directory instead of using and managing working_directory().
fix for working_directory() so that when deleted, no empty directory is left.