ggplot2 4.0.0

User facing

Breaking changes

• The S3 parts of ggplot2 have been replaced with S7 bits (#6352).
• (breaking) geom_violin(quantiles) now has actual quantiles based on
  the data, rather than inferred quantiles based on the computed density. The
  quantiles parameter that replaces draw_quantiles now belongs to
  stat_ydensity() instead of geom_violin() (@teunbrand, #4120).
• (Breaking) The defaults for all geoms can be set at one in the theme.
  (@teunbrand based on pioneering work by @dpseidel, #2239)
  • A new theme(geom) argument is used to track these defaults.
  • The element_geom() function can be used to populate that argument.
  • The from_theme() function allows access to the theme default fields from
    inside the aes() function.
• Moved the following packages in the description. If your package depended on
  ggplot2 to install these dependencies, you may need to list these in your
  own DESCRIPTION file now (#5986).
  • Moved mgcv from Imports to Suggests
  • Moved tibble from Imports to Suggests
  • Removed glue dependency
• Default labels are derived in build_ggplot() (previously ggplot_build())
  rather than in the layer method of update_ggplot()
  (previously ggplot_add.Layer()). This may affect code that accessed the
  plot$labels property (@teunbrand, #5894).
• In binning stats, the default boundary is now chosen to better adhere to
  the nbin argument. This may affect plots that use default binning
  (@teunbrand, #5882, #5036)

Lifecycle changes

• Deprecated functions and arguments prior to ggplot2 3.0.0 throw errors instead
  of warnings.

• Functions and arguments that were soft-deprecated up to ggplot2 3.4.0 now
  throw warnings.

• annotation_borders() replaces the now-deprecated borders()
  (@teunbrand, #6392)

• Turned off fallback for size to linewidth translation in
  geom_bar()/geom_col() (#4848).

• The fatten argument has been deprecated in geom_boxplot(),
  geom_crossbar() and geom_pointrange() (@teunbrand, #4881).

• The following methods have been deprecated: fortify.lm(), fortify.glht(),
  fortify.confint.glht(), fortify.summary.glht() and fortify.cld(). It
  is recommend to use broom::augment() and broom::tidy() instead
  (@teunbrand, #3816).

• geom_errorbarh() is deprecated in favour of
  geom_errorbar(orientation = "y") (@teunbrand, #5961).

• Special getter and setter functions have been renamed for consistency, allowing
  for better tab-completion with get_*- and set_*-prefixes. The old names
  remain available for backward compatibility (@teunbrand, #5568).

  New name	Old name
  get_theme()	theme_get()
  set_theme()	theme_set()
  replace_theme()	theme_replace()
  update_theme()	theme_update()
  get_last_plot()	last_plot()
  get_layer_data()	layer_data()
  get_layer_grob()	layer_grob()
  get_panel_scales()	layer_scales()

• facet_wrap() has new options for the dir argument for additional control
  over panel directions. They absorb interactions with the now-deprecated
  as.table argument. Internally dir = "h" or dir = "v" is deprecated
  (@teunbrand, #5212).

• coord_trans() was renamed to coord_transform() (@nmercadeb, #5825).

Improvements

Themes

• The theme() function offers new arguments:
  • geom to set defaults for layer aesthetics (#2239).
  • spacing/margins as root elements that are inherited by all other
    spacings and (non-text) margins (@teunbrand, #5622).
  • palette.{aes}.discrete and palette.{aes}.continuous which determine
    the palettes used when scales have palette = NULL. This is the new
    default for generic scales like scale_colour_discrete() or
    scale_fill_continuous(), see also the 'Scales' section (#4696).
  • panel.widths and panel.heights to control the (absolute) size of the
    panels (#5338, @teunbrand).
  • legend.key.justification to control the alignment of legend keys
    (@teunbrand, #3669)
• Built-in theme_*() functions have new arguments:
  • ink/paper/accent to control foreground, background and highlight
    colours respectively of the whole plot (@teunbrand, #6063, @EvaMaeRey, #6438).
  • header_family to easily set the font for headers and titles (#5886)
    • To accommodate, plot.subtitle, plot.caption and plot.tag now
      inherit from the root text element instead of the title element.
• New function family for setting parts of a theme. For example, you can now use
  theme_sub_axis(line, text, ticks, ticks.length, line) as a substitute for
  theme(axis.line, axis.text, axis.ticks, axis.ticks.length, axis.line). This
  should allow slightly terser and more organised theme declarations
  (@teunbrand, #5301).
• Adjustments to margins (#6115):
  • They can have NA-units, which indicate that the value should be inherited
    from the parent element.
  • New margin_part() function that comes pre-populated with NA-units, so
    you can change a single margin without worrying that the others look off.
  • New margin_auto() that recycles arguments in a CSS like fashion.
• The fill of the panel.border theme setting is ignored and forced to be
  transparent (#5782).
• theme_classic() has the following changes (@teunbrand, #5978 & #6320):
  • Axis ticks are now black (ink-coloured) instead of dark gray.
  • Axis line ends are now "square".
  • The panel grid is now blank at the panel.grid hierarchy level instead of
    the panel.grid.major and panel.grid.minor levels.
• The theme(legend.spacing.{x/y}) setting now accepts null-units
  (@teunbrand, #6417).

Scales

• The default colour and fill scales have a new palette argument. The default,
  palette = NULL will retrieve palettes from the theme (see the Themes section).
  This replaces the old options-based type system, with some limited backward
  compatibility (@teunbrand, #6064).
• All scales now expose the aesthetics parameter (@teunbrand, #5841)
• All position scales now use the same definition of x and y aesthetics.
  This lets uncommon aesthetics like xintercept expand scales as usual.
  (#3342, #4966, @teunbrand)
• In continuous scales, when breaks is a function and n.breaks is set, the
  n.breaks will be passed to the breaks function. Previously, n.breaks
  only applied to the default break calculation (@teunbrand, #5972).
• Changes in discrete scales:
  • Added palette argument, which can be used to customise spacings between
    levels (@teunbrand, #5770)
  • Added continuous.limits argument to control the display range
    (@teunbrand, #4174, #6259).
  • Added minor_breaks argument. This only makes sense in position scales,
    where it affects the placement of minor ticks and minor gridlines (#5434).
  • Added sec.axis argument. Discrete scales don't support transformations
    so it is recommended to use dup_axis() to set custom breaks or labels.
    Secondary discrete axes work with the continuous analogues of discrete
    breaks (@teunbrand, #3171)
  • When breaks yields a named vector, the names will be used as labels
    by default (@teunbrand, #6147).
• Changes in date/time scales:
  • is silently cast to in date scales. Vice versa,
    is cast to in datetime scales (@laurabrianna, #3533)
  • Bare numeric provided to date or datetime scales get inversely transformed
    (i.e. cast to /) with a warning (@teunbrand)
  • The date_breaks, date_minor_breaks and date_labels arguments have
    been copied over to scale_{x/y}_time() (@teunbrand, #4335).
• More stability for vctrs-based palettes (@teunbrand, #6117).
• Scale names, guide titles and aesthetic labels can now accept functions
  (@teunbrand, #4313)

Coords

• Reversal of a dimension, typically 'x' or 'y', is now controlled by the
  reverse argument in coord_cartesian(), coord_fixed(), coord_radial()
  and coord_sf(). In coord_radial(), this replaces the older direction
  argument (#4021, @teunbrand).
• coord_*(expand) can now take a logical vector to control expansion at any
  side of the panel (top, right, bottom, left) (@teunbrand, #6020)
• New coord_cartesian(ratio) argument that absorbs the aspect ratio
  functionality from coord_equal() and coord_fixed(), which are now
  wrappers for coord_cartesian().
• In non-orthogonal coordinate systems (coord_sf(), coord_polar() and
  coord_radial()), using 'AsIs' variables escape transformation when
  both x and y is an 'AsIs' variable (@teunbrand, #6205).
• Axis labels are now preserved better when using coord_sf(expand = TRUE) and
  graticule lines are straight but do not meet the edge (@teunbrand, #2985).
• coord_radial(clip = "on") clips to the panel area when the graphics device
  supports clipping paths (@teunbrand, #5952).
• coord_radial(r.axis.inside) can now take a numeric value to control
  placement of internally placed radius axes (@teunbrand, #5805).
• Munching in coord_polar() and coord_radial() now adds more detail,
  particularly for data-points with a low radius near the center
  (@teunbrand, #5023).

Layers

• Position adjustments can now have auxiliary aesthetics (@teunbrand).
  • position_nudge() gains nudge_x and nudge_y aesthetics (#3026, #5445).
  • position_dodge() gains order aesthetic (#3022, #3345)
• New stat_connect() to connect points via steps or other shapes
  (@teunbrand, #6228)
• New stat: stat_manual() for arbitrary computations (@teunbrand, #3501)
• geom_boxplot() gains additional arguments to style the colour, linetype and
  linewidths of the box, whiskers, med...

ggplot2 3.5.2

This is a small release focusing on providing infrastructure for other packages
to gracefully prepare for changes in the next major release.

Improvements

• Standardised test functions for important classes: is_ggproto(),
  is_ggplot(), is_mapping(), is_layer(), is_geom(), is_stat(),
  is_position(), is_coord(), is_facet(), is_scale(), is_guide(),
  is_guides(), is_margin(), is_theme_element() and is_theme().
• New get_labs() function for retrieving completed plot labels
  (@teunbrand, #6008).
• New get_geom_defaults() for retrieving resolved default aesthetics.
• A new ggplot_build() S3 method for <ggplot_built> classes was added, which
  returns input unaltered (@teunbrand, #5800).

ggplot2 3.5.1

This is a small release focusing on fixing regressions from 3.5.0 and
documentation updates.

Bug fixes

• Fixed bug where discrete scales could not map aesthetics only consisting of
  NAs (#5623)
• Fixed spurious warnings from sec_axis() with breaks = NULL (#5713).
• Patterns and gradients are now also enabled in geom_sf()
  (@teunbrand, #5716).
• The default behaviour of resolution() has been reverted to pre-3.5.0
  behaviour. Whether mapped discrete vectors should be treated as having
  resolution of 1 is controlled by the new discrete argument.
• Fixed bug in guide_bins() and guide_coloursteps() where discrete breaks,
  such as the levels produced by cut(), were ordered incorrectly
  (@teunbrand, #5757).

Improvements

• When facets coerce the faceting variables to factors, the 'ordered' class
  is dropped (@teunbrand, #5666).
• coord_map() and coord_polar() throw informative warnings when used
  with the guide system (#5707).
• When passing a function to stat_contour(breaks), that function is used to
  calculate the breaks even if bins and binwidth are missing
  (@teunbrand, #5686).
• geom_step() now supports lineend, linejoin and linemitre parameters
  (@teunbrand, #5705).
• Fixed performance loss when the .data pronoun is used in aes() (#5730).
• Facet evaluation is better at dealing with inherited errors
  (@teunbrand, #5670).
• stat_bin() deals with non-finite breaks better (@teunbrand, #5665).
• While axes in coord_radial() don't neatly fit the top/right/bottom/left
  organisation, specifying position = "top" or position = "right"
  in the scale will flip the placement of the radial axis (#5735)
• Theme elements that do not exist now throw warnings instead of errors (#5719).
• Fixed bug in coord_radial() where full circles were not treated as such
  (@teunbrand, #5750).
• When legends detect the presence of values in a layer, NA is now detected
  if the data contains values outside the given breaks (@teunbrand, #5749).
• annotate() now warns about stat or position arguments (@teunbrand, #5151)
• guide_coloursteps(even.steps = FALSE) now works with discrete data that has
  been formatted by cut() (@teunbrand, #3877).

ggplot2 3.5.0

This is a minor release that turned out quite beefy. It is focused on
overhauling the guide system: the system responsible for displaying information
from scales in the guise of axes and legends. As part of that overhaul, new
guides have been implemented and existing guides have been refined. The look
and feel of guides has been mostly preserved, but their internals and
styling options have changed drastically.

Briefly summarising other highlights, we also welcome coord_radial() as a
successor of coord_polar(). Initial support for newer graphical features,
such as pattern fills has been added. The API has changed how I()/<AsIs>
vectors interact with the scale system, namely: not at all.

Breaking changes

• The guide system. As a whole. See 'new features' for more information.
  While the S3 guide generics are still in place, the S3 methods for
  guide_train(), guide_merge(), guide_geom(), guide_transform(),
  guide_gengrob() have been superseded by the respective ggproto methods.
  In practice, this will mean that NextMethod() or sub-classing ggplot2's
  guides with the S3 system will no longer work.

• By default, guide_legend() now only draws a key glyph for a layer when
  the value is in the layer's data. To revert to the old behaviour, you
  can still set show.legend = c({aesthetic} = TRUE) (@teunbrand, #3648).

• In the scale_{colour/fill}_gradient2() and
  scale_{colour/fill}_steps2() functions, the midpoint argument is
  transformed by the scale transformation (#3198).

• The legend.key theme element is set to inherit from the panel.background
  theme element. The default themes no longer set the legend.key element.
  This causes a visual change with the default theme_gray() (#5549).

• The scale_name argument in continuous_scale(), discrete_scale() and
  binned_scale() is soft-deprecated. If you have implemented custom scales,
  be advised to double-check that unnamed arguments ends up where they should
  (@teunbrand, #1312).

• The legend.text.align and legend.title.align arguments in theme() are
  deprecated. The hjust setting of the legend.text and legend.title
  elements continues to fulfill the role of text alignment (@teunbrand, #5347).

• 'lines' units in geom_label(), often used in the label.padding argument,
  are now are relative to the text size. This causes a visual change, but fixes
  a misalignment issue between the textbox and text (@teunbrand, #4753)

• coord_flip() has been marked as superseded. The recommended alternative is
  to swap the x and y aesthetic and/or using the orientation argument in
  a layer (@teunbrand, #5130).

• The trans argument in scales and secondary axes has been renamed to
  transform. The trans argument itself is deprecated. To access the
  transformation from the scale, a new get_transformation() method is
  added to Scale-classes (#5558).

• Providing a numeric vector to theme(legend.position) has been deprecated.
  To set the default legend position inside the plot use
  theme(legend.position = "inside", legend.position.inside = c(...)) instead.

New features

• Plot scales now ignore AsIs objects constructed with I(x), instead of
  invoking the identity scale. This allows these columns to co-exist with other
  layers that need a non-identity scale for the same aesthetic. Also, it makes
  it easy to specify relative positions (@teunbrand, #5142).

• The fill aesthetic in many geoms now accepts grid's patterns and gradients.
  For developers of layer extensions, this feature can be enabled by switching
  from fill = alpha(fill, alpha) to fill = fill_alpha(fill, alpha) when
  providing fills to grid::gpar() (@teunbrand, #3997).

• New function check_device() for testing the availability of advanced
  graphics features introduced in R 4.1.0 onward (@teunbrand, #5332).

• coord_radial() is a successor to coord_polar() with more customisation
  options. coord_radial() can:

  • integrate with the new guide system via a dedicated guide_axis_theta() to
    display the angle coordinate.
  • in addition to drawing full circles, also draw circle sectors by using the
    end argument.
  • avoid data vanishing in the center of the plot by setting the donut
    argument.
  • adjust the angle aesthetic of layers, such as geom_text(), to align
    with the coordinate system using the rotate_angle argument.

The guide system

The guide system encompassing axes and legends, as the last remaining chunk of
ggplot2, has been rewritten to use the <ggproto> system instead of the S3
system. This change was a necessary step to officially break open the guide
system for extension package developers. The axes and legends now inherit from
a <Guide> class, which makes them extensible in the same manner as geoms,
stats, facets and coords (#3329, @teunbrand)

• The most user-facing change is that the styling of guides is rewired through
  the theme system. Guides now have a theme argument that can style
  individual guides, while theme() has gained additional arguments to style
  guides. Theme elements declared in the guide override theme elements set
  through the plot. The new theme elements for guides are:
  legend.key.spacing{.x/.y}, legend.frame, legend.axis.line,
  legend.ticks, legend.ticks.length, legend.text.position and
  legend.title.position. Previous style options in the arguments of
  guide_*() functions are soft-deprecated.

• Unfortunately, we could not fully preserve the function of pre-existing
  guide extensions written in the S3 system. A fallback for these old guides
  is encapsulated in the <GuideOld> class, which calls the old S3 generics.
  The S3 methods have been removed as part of cleaning up, so the old guides
  will still work if the S3 methods are reimplemented, but we encourage to
  switch to the new system (#2728).

• The order argument of guides now strictly needs to be a length-1
  integer (#4958).

Axes

• New guide_axis_stack() to combine other axis guides on top of one another.

• New guide_axis_theta() to draw an axis in a circular arc in
  coord_radial(). The guide can be controlled by adding
  guides(theta = guide_axis_theta(...)) to a plot.

• New guide_axis_logticks() can be used to draw logarithmic tick marks as
  an axis. It supersedes the annotation_logticks() function
  (@teunbrand, #5325).

• guide_axis() gains a minor.ticks argument to draw minor ticks (#4387).

• guide_axis() gains a cap argument that can be used to trim the
  axis line to extreme breaks (#4907).

• Primary axis titles are now placed at the primary guide, so that
  guides(x = guide_axis(position = "top")) will display the title at the
  top by default (#4650).

• The default vjust for the axis.title.y.right element is now 1 instead of
  0.

• Unknown secondary axis guide positions are now inferred as the opposite
  of the primary axis guide when the latter has a known position (#4650).

Legends

• New guide_custom() function for drawing custom graphical objects (grobs)
  unrelated to scales in legend positions (#5416).

• All legends have acquired a position argument, that allows individual guides
  to deviate from the legend.position set in the theme() function. This
  means that legends can now be placed at multiple sides of the plot (#5488).

• The spacing between legend keys and their labels, in addition to legends
  and their titles, is now controlled by the text's margin setting. Not
  specifying margins will automatically add appropriate text margins. To
  control the spacing within a legend between keys, the new
  legend.key.spacing.{x/y} argument can be used in theme(). This leaves the
  legend.spacing theme setting dedicated to solely controlling the spacing
  between different guides (#5455).

• guide_colourbar() and guide_coloursteps() gain an alpha argument to
  set the transparency of the bar (#5085).

• New display argument in guide_colourbar() supplants the raster argument.
  In R 4.1.0 and above, display = "gradient" will draw a gradient.

• Legend keys that can draw arrows have their size adjusted for arrows.

• When legend titles are larger than the legend, title justification extends
  to the placement of keys and labels (#1903).

• Glyph drawing functions of the draw_key_*() family can now set "width"
  and "height" attributes (in centimetres) to the produced keys to control
  their displayed size in the legend.

• coord_sf() now uses customisable guides provided in the scales or
  guides() function (@teunbrand).

Improvements

• guide_coloursteps(even.steps = FALSE) now draws one rectangle per interval
  instead of many small ones (#5481).

• draw_key_label() now better reflects the appearance of labels (#5561).

• position_stack() no longer silently removes missing data, which is now
  handled by the geom instead of position (#3532).

• The minor_breaks function argument in scales can now also take a function
  with two arguments: the scale's limits and the scale's major breaks (#3583).

• Failing to fit or predict in stat_smooth() now gives a warning and omits
  the failed group, instead of throwing an error (@teunbrand, #5352).

• labeller() now handles unspecified entries from lookup tables
  (@92amartins, #4599).

• fortify.default() now accepts a data-frame-like object granted the object
  exhibits healthy dim(), colnames(), and as.data.frame() behaviours
  (@hpages, #5390).

• geom_violin() gains a bounds argument analogous to geom_density()s
  (@eliocamp, #5493).

• To apply dodging more consistently in violin plots, stat_ydensity() now
  has a drop argument to keep or discard groups with 1 observation.

• geom_boxplot() gains a new argument, staplewidth that can...

ggplot2 3.4.4

This hotfix release adapts to a change in r-devel's base::is.atomic() and
the upcoming retirement of maptools.

• fortify() for sp objects (e.g., SpatialPolygonsDataFrame) is now deprecated
  and will be removed soon in support of the upcoming retirement of rproj, rgeos,
  and maptools. In advance
  of the whole removal, fortify(<SpatialPolygonsDataFrame>, region = ...)
  no longer works as of this version (@yutannihilation, #5244).

ggplot2 3.4.3

This hotfix release addresses a version comparison change in r-devel. There are
no user-facing or breaking changes.

ggplot2 3.4.2

This is a hotfix release anticipating changes in r-devel, but folds in upkeep
changes and a few bug fixes as well.

Minor improvements

• Various type checks and their messages have been standardised
  (@teunbrand, #4834).

• ggplot2 now uses scales::DiscreteRange and scales::ContinuousRange, which
  are available to write scale extensions from scratch (@teunbrand, #2710).

• The layer_data(), layer_scales() and layer_grob() now have the default
  plot = last_plot() (@teunbrand, #5166).

• The datetime_scale() scale constructor is now exported for use in extension
  packages (@teunbrand, #4701).

Bug fixes

• update_geom_defaults() and update_stat_defaults() now return properly
  classed objects and have updated docs (@dkahle, #5146).

• For the purposes of checking required or non-missing aesthetics, character
  vectors are no longer considered non-finite (@teunbrand, @4284).

• annotation_logticks() skips drawing ticks when the scale range is non-finite
  instead of throwing an error (@teunbrand, #5229).

• Fixed spurious warnings when the weight was used in stat_bin_2d(),
  stat_boxplot(), stat_contour(), stat_bin_hex() and stat_quantile()
  (@teunbrand, #5216).

• To prevent changing the plotting order, stat_sf() is now computed per panel
  instead of per group (@teunbrand, #4340).

• Fixed bug in coord_sf() where graticule lines didn't obey
  panel.grid.major's linewidth setting (@teunbrand, #5179).

• geom_text() drops observations where angle = NA instead of throwing an
  error (@teunbrand, #2757).

ggplot2 3.4.1

This is a small release focusing on fixing regressions in the 3.4.0 release
and minor polishes.

Breaking changes

• The computed variable y in stat_ecdf() has been superseded by ecdf to
  prevent incorrect scale transformations (@teunbrand, #5113 and #5112).

New features

• Added scale_linewidth_manual() and scale_linewidth_identity() to support
  the linewidth aesthetic (@teunbrand, #5050).

• ggsave() warns when multiple filenames are given, and only writes to the
  first file (@teunbrand, #5114).

Bug fixes

• Fixed a regression in geom_hex() where aesthetics were replicated across
  bins (@thomasp85, #5037 and #5044).

• Using two ordered factors as facetting variables in
  facet_grid(..., as.table = FALSE) now throws a warning instead of an
  error (@teunbrand, #5109).

• Fixed misbehaviour of draw_key_boxplot() and draw_key_crossbar() with
  skewed key aspect ratio (@teunbrand, #5082).

• Fixed spurious warning when weight aesthetic was used in stat_smooth()
  (@teunbrand based on @clauswilke's suggestion, #5053).

• The lwd alias is now correctly replaced by linewidth instead of size
  (@teunbrand based on @clauswilke's suggestion #5051).

• Fixed a regression in Coord$train_panel_guides() where names of guides were
  dropped (@maxsutton, #5063).

In binned scales:

• Automatic breaks should no longer be out-of-bounds, and automatic limits are
  adjusted to include breaks (@teunbrand, #5082).

• Zero-range limits no longer throw an error and are treated akin to continuous
  scales with zero-range limits (@teunbrand, #5066).

• The trans = "date" and trans = "time" transformations were made compatible
  (@teunbrand, #4217).

ggplot2 3.4.0

This is a minor release focusing on tightening up the internals and ironing out
some inconsistencies in the API. The biggest change is the addition of the
linewidth aesthetic that takes of sizing the width of any line from size.
This change, while attempting to be as non-breaking as possible, has the
potential to change the look of some of your plots.

Other notable changes is a complete redo of the error and warning messaging in
ggplot2 using the cli package. Messaging is now better contextualised and it
should be easier to identify which layer an error is coming from. Last, we have
now made the switch to using the vctrs package internally which means that
support for vctrs classes as variables should improve, along with some small
gains in rendering speed.

Breaking changes

• A linewidth aesthetic has been introduced and supersedes the size
  aesthetic for scaling the width of lines in line based geoms. size will
  remain functioning but deprecated for these geoms and it is recommended to
  update all code to reflect the new aesthetic. For geoms that have both point
  sizing and linewidth sizing (geom_pointrange() and geom_sf) size now
  only refers to sizing of points which can leads to a visual change in old
  code (@thomasp85, #3672)

• The default line width for polygons in geom_sf() have been decreased to 0.2
  to reflect that this is usually used for demarking borders where a thinner
  line is better suited. This change was made since we already induced a
  visual change in geom_sf() with the introduction of the linewidth
  aesthetic.

• The dot-dot notation (..var..) and stat(), which have been superseded by
  after_stat(), are now formally deprecated (@yutannihilation, #3693).

• qplot() is now formally deprecated (@yutannihilation, #3956).

• stage() now properly refers to the values without scale transformations for
  the stage of after_stat. If your code requires the scaled version of the
  values for some reason, you have to apply the same transformation by yourself,
  e.g. sqrt() for scale_{x,y}_sqrt() (@yutannihilation and @teunbrand, #4155).

• Use rlang::hash() instead of digest::digest(). This update may lead to
  changes in the automatic sorting of legends. In order to enforce a specific
  legend order use the order argument in the guide. (@thomasp85, #4458)

• referring to x in backquoted expressions with label_bquote() is no longer
  possible.

• The ticks.linewidth and frame.linewidth parameters of guide_colourbar()
  are now multiplied with .pt like elsewhere in ggplot2. It can cause visual
  changes when these arguments are not the defaults and these changes can be
  restored to their previous behaviour by adding / .pt (@teunbrand #4314).

• scale_*_viridis_b() now uses the full range of the viridis scales
  (@gregleleu, #4737)

New features

• geom_col() and geom_bar() gain a new just argument. This is set to 0.5
  by default; use just = 0/just = 1 to place columns on the left/right
  of the axis breaks.
  (@wurli, #4899)

• geom_density() and stat_density() now support bounds argument
  to estimate density with boundary correction (@echasnovski, #4013).

• ggplot now checks during statistical transformations whether any data
  columns were dropped and warns about this. If stats intend to drop
  data columns they can declare them in the new field dropped_aes.
  (@clauswilke, #3250)

• ... supports rlang::list2 dynamic dots in all public functions.
  (@mone27, #4764)

• theme() now has a strip.clip argument, that can be set to "off" to
  prevent the clipping of strip text and background borders (@teunbrand, #4118)

• geom_contour() now accepts a function in the breaks argument
  (@eliocamp, #4652).

Minor improvements and bug fixes

• Fix a bug in position_jitter() where infinity values were dropped (@javlon,
  #4790).

• geom_linerange() now respects the na.rm argument (#4927, @thomasp85)

• Improve the support for guide_axis() on coord_trans()
  (@yutannihilation, #3959)

• Added stat_align() to align data without common x-coordinates prior to
  stacking. This is now the default stat for geom_area() (@thomasp85, #4850)

• Fix a bug in stat_contour_filled() where break value differences below a
  certain number of digits would cause the computations to fail (@thomasp85,
  #4874)

• Secondary axis ticks are now positioned more precisely, removing small visual
  artefacts with alignment between grid and ticks (@thomasp85, #3576)

• Improve stat_function documentation regarding xlim argument.
  (@92amartins, #4474)

• Fix various issues with how labels, breaks, limits, and show.limits
  interact in the different binning guides (@thomasp85, #4831)

• Automatic break calculation now squishes the scale limits to the domain
  of the transformation. This allows scale_{x/y}_sqrt() to find breaks at 0
  when appropriate (@teunbrand, #980).

• Using multiple modified aesthetics correctly will no longer trigger warnings.
  If used incorrectly, the warning will now report the duplicated aesthetic
  instead of NA (@teunbrand, #4707).

• aes() now supports the !!! operator in its first two arguments
  (#2675). Thanks to @yutannihilation and @teunbrand for draft
  implementations.

• Require rlang >= 1.0.0 (@billybarc, #4797)

• geom_violin() no longer issues "collapsing to unique 'x' values" warning
  (@bersbersbers, #4455)

• annotate() now documents unsupported geoms (geom_abline(), geom_hline()
  and geom_vline()), and warns when they are requested (@mikmart, #4719)

• presidential dataset now includes Trump's presidency (@bkmgit, #4703).

• position_stack() now works fully with geom_text() (@thomasp85, #4367)

• geom_tile() now correctly recognises missing data in xmin, xmax, ymin,
  and ymax (@thomasp85 and @sigmapi, #4495)

• geom_hex() will now use the binwidth from stat_bin_hex() if present,
  instead of deriving it (@thomasp85, #4580)

• geom_hex() now works on non-linear coordinate systems (@thomasp85)

• Fixed a bug throwing errors when trying to render an empty plot with secondary
  axes (@thomasp85, #4509)

• Axes are now added correctly in facet_wrap() when as.table = FALSE
  (@thomasp85, #4553)

• Better compatibility of custom device functions in ggsave()
  (@thomasp85, #4539)

• Binning scales are now more resilient to calculated limits that ends up being
  NaN after transformations (@thomasp85, #4510)

• Strip padding in facet_grid() is now only in effect if
  strip.placement = "outside" and an axis is present between the strip and
  the panel (@thomasp85, #4610)

• Aesthetics of length 1 are now recycled to 0 if the length of the data is 0
  (@thomasp85, #4588)

• Setting size = NA will no longer cause guide_legend() to error
  (@thomasp85, #4559)

• Setting stroke to NA in geom_point() will no longer impair the sizing of
  the points (@thomasp85, #4624)

• stat_bin_2d() now correctly recognises the weight aesthetic
  (@thomasp85, #4646)

• All geoms now have consistent exposure of linejoin and lineend parameters, and
  the guide keys will now respect these settings (@thomasp85, #4653)

• geom_sf() now respects arrow parameter for lines (@JakeRuss, #4659)

• Updated documentation for print.ggplot to reflect that it returns
  the original plot, not the result of ggplot_build(). (@r2evans, #4390)

• scale_*_manual() no longer displays extra legend keys, or changes their
  order, when a named values argument has more items than the data. To display
  all values on the legend instead, use
  scale_*_manual(values = vals, limits = names(vals)). (@teunbrand, @banfai,
  #4511, #4534)

• Updated documentation for geom_contour() to correctly reflect argument
  precedence between bins and binwidth. (@eliocamp, #4651)

• Dots in geom_dotplot() are now correctly aligned to the baseline when
  stackratio != 1 and stackdir != "up" (@mjskay, #4614)

• Key glyphs for geom_boxplot(), geom_crossbar(), geom_pointrange(), and
  geom_linerange() are now orientation-aware (@mjskay, #4732)

• Updated documentation for geom_smooth() to more clearly describe effects of
  the fullrange parameter (@thoolihan, #4399).

ggplot2 3.3.6

This is a very small release only applying an internal change to comply with
R 4.2 and its deprecation of default.stringsAsFactors(). There are no user
facing changes and no breaking changes.