NEWS

---

legendry 0.3.0.9000

legendry 0.3.0

This minor version is a small feature release, introducing several new guides, arguments and changes to keys.

• New guide guide_legend_manual() for user defined keys (#88)
• New guide guide_axis_plot() to place side-plots (#43)
• New guide guide_axis_upset() to place symbols in upset matrices next to axes. Also comes with key_upset() to match (#38).
• New guide guide_axis_symbols() for a more manual version of placing symbols. Also comes with key_symbols() to match (#38).
• New guide guide_axis_annotation() to jot down annotations. Includes the helpers annotate_top/right/bottom/left() for convenience (#89).
• New key key_range_rle() to create a range annotation based on run-length encoding.
• New arguments guide_axis_base(subtitle) and guide_axis_nested(subtitle) make it easier to title custom axes (#102)
• New arguments guide_legend_cross(row_title, col_title, subtitle_position) to display subtitles over dimensions (#79).
• compose_stack(side.titles) also work in non-position guides (#101)
• Changed the margins and inferred justification of the legendry.axis.subtitle and legendry.legend.subtitle theme elements.
• Changed ... argument in many key_*() functions to transfer graphical properties like colour or linewidth to guides. Different parts of guides can be targeted by specifying text_colour/line_colour/rect_colour/point_colour.
• Changed key_group_split() to preserve order of labels better, rather than re-sorting them (#100).
• Updated title mechanism to comply with ggplot2#6200 (#104)
• Updated lifecycle of new_compose(), compose_ontop(), compose_stack() from 'experimental' to 'stable'.
• Fixed a bug where empty titles in legends contributed to spacing. Visual tests depending on legendry may see subtle positioning shifts (#113).
• Fixed a bug where guide_legend_group() struggled to merge different scales (#112).

legendry 0.2.4 (2025-09-14)

This is a patch release fixing a few bugs.

• Fixed an issue detected by CRAN with regards to undeclared imports from S7 (#97)
• scale_x/y_dendro() will no longer fail to lookup guide_axis_dendro() when legendry is not on the search path (#94).

legendry 0.2.3 (2025-08-18)

This is a patch release fixing a few bugs.

• guide_colbar() properly uses legend.key.width/height setting (#81).
• compose_sandwich() and its wrappers now have a suppress_labels argument that controls label rendering (#91).

legendry 0.2.2 (2025-05-30)

This is a patch release without new features, improvements or bug fixes. The patch aims to make legendry forwards-compatible with a planned ggplot2 release.

legendry 0.2.1 (2025-03-04)

This is a patch release with a few bug fixes and a tiny polish.

• Fixed bug in guide_circles() used for multiple layers (#58)
• Fixed bug hindering position = "inside" placement (#42)
• Fixed bug in theme_guide(key.size, key.height, key.width) (#41)
• Complete guides based on a crux composition now render the legend.background element (#50)
• A better attempt to honour ggplot2's mechanism for <AsIs> variables (#45)
• Better alignment of compose_stack(side.titles) (#48)
• Fixed aesthetic standardisation in override.aes arguments (#60)
• Improvements to density and histogram gizmos (#62):
  • The default key now depends on the scale type: continuous scales invoke key_sequence() and binned scales invoke key_bins().
  • When using a binned key in gizmo_histogram(), the default hist(breaks) argument is populated with the key's breaks.
• Fix capping issue with non-canonical rescalers in primitive_line() (#67)

legendry 0.2.0 (2024-12-14)

This is a small feature release introducing dendrogram scales and a size guide.

• Added support for dendrograms (#33):

  • New scale functions scale_x_dendro() and scale_y_dendro().
  • New full guide function: guide_axis_dendro().
  • New primitive guide function: primitive_segments()
  • New key functions: key_segment_manual(), key_segment_map() and key_dendro().

• Added new standalone guide guide_circles() (#14).

  • New supporting theme element legendry.legend.key.margin.

• Fixed bug where guide_axis_nested(key = key_range_auto(...)) produced duplicated labels (#31).

legendry 0.1.0 (2024-11-01)

First release.

Thanks to the following people for catching and reporting early bugs and mistakes:

• @davidhodge931 (#7, #8, #9, #12)
• @luisDVA (#18)
• @mthomas-ketchbrook (#21)