ggformula

• New feature: layer_factory() gains a required_packages argument for

extension-package authors. Naming one or more packages there (e.g.

required_packages = "ggforce") checks, before anything else runs

(including pre), that each is both installed and attached (via

library()), raising an informative error otherwise. This replaces the

hand-written pre-block checks previously used internally, e.g. in

gf_sina(); see the new "Extending ggformula" vignette

(vignette("extending-ggformula")) for details. required_packages is

also recorded in a function's ggformula_spec().

• New feature: layer_factory() also gains installed_packages, a lighter-weight sibling of required_packages that only checks that a package is installed, not that it's attached -- the right fit for functions (built with the layer_fun = pattern) that call an extension package's function directly via pkg::fun(). gf_sf() now uses installed_packages = "sf" instead of its hand-written pre check. Also recorded in ggformula_spec().
• Attaching a package that imports

ggformula (e.g., mosaic) prevents dependencies of

ggformula from being attached, even when ggformula

is subsequently attached with library(ggformula). This

caused some behavior to break with unclear messaging unless the user explicitly attached dependencies of ggformula (e.g., ggiraph). This should now be fixed via a combination of mechanisms.

• Bug fix: inherit = FALSE was silently ignored by gf_*() functions built with an explicit layer_fun naming a geom_*() constructor rather than the default ggplot2::layer() -- most visibly gf_violin(), which adopted layer_fun = ggplot2::geom_violin in 1.1.0. inherit.aes is now forwarded whenever the layer function declares it, so gf_violin(..., inherit = FALSE) again creates a layer that does not inherit the plot's aesthetics. gf_abline(), gf_hline(), and gf_vline() are unaffected: they are built with inherit.aes = FALSE, matching those geoms' own defaults.
• Bug fix: relatedly, inherit = FALSE was ignored by every gf_*_interactive() function, since those are built on layer_interactive() rather than ggplot2::layer(). layer_interactive() now accepts and forwards inherit.aes, so e.g. gf_point_interactive(..., inherit = FALSE) behaves like gf_point(..., inherit = FALSE). When not supplied, inherit.aes is omitted rather than forwarded as NULL, leaving the underlying geom's own default in force.
• The vignette on interactive functions has been moved out of the package and only appears on the pkgdown site to reduce the size of the package.
• The tutorials have been converted to webr.
• Bug fix: gf_hline(), gf_vline(), gf_abline(), and similar functions used with data = NA (i.e., with all values supplied directly rather than from a data frame) could error or silently pass duplicated/incorrect arguments (such as position) down to the underlying geom, because argument names shared with ggplot2's geom_*()/stat_*() constructors (data, mapping, position, show.legend, inherit.aes, geom, stat) were incorrectly treated as generic settable parameters. This also fixed a related failure in some gf_*_interactive() layers (e.g. gf_jitter_interactive(width = ...)) that could error with "Both position and width/height were supplied."
• Bug fix: replaced remaining internal use of the removed/deprecated aes_string() (used only in the data = NA code path above) with a tidy-eval equivalent.
• Internal refactor: the body of the function created by layer_factory() (used to build every gf_* function) has been decomposed into small, individually documented helper functions, one per stage of the "formula -> ggplot2 layer" pipeline. This is intended to make the code easier to read, test, and extend; no behavior changes are intended from this refactor alone.
• Internal: every function created by layer_factory() now records an explicit, documented specification (retrieved with the new ggformula_spec()) of the geom, stat, position, aes_form, extras, pre, aesthetics, inherit.aes, check.aes, required_packages, and installed_packages it was built with. interactive_layer_factory() now reads that single documented record instead of scraping several loosely-related bindings out of a gf_* function's environment, and extension packages can use it too.