@automattic/charts 4.12.0 → 4.14.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.14.0] - 2026-11-02
+### Added
+- Leaderboard chart: Derive bar shares and percentage change from the values when an entry omits them, and add a `negativeBars` option to draw negative values as empty bars. [#54250]
+- Legend: Let an interactive legend item own its pressed state and toggle handler. [#54328]
+
+### Changed
+- Update package dependencies. [#53869]
+
+### Fixed
+- Leaderboard chart: Inset overlay labels from the inline start, so they keep their padding in right-to-left languages, and expose the label inset as a CSS custom property. [#54192]
+
+## [4.13.0] - 2026-10-28
+### Added
+- Conversion funnel chart: Add `getTooltipContent` to set what each step's tooltip shows, which screen readers also read, and show the default tooltip's count and conversion rate as labeled lines. [#53637]
+- Leaderboard Chart: Show negative values as bars extending left of a shared zero point. [#53794]
+
+### Fixed
+- Conversion funnel chart: Select a step and show its tooltip when it takes keyboard focus, move between steps with the arrow keys, and have screen readers read the tooltip as the step's description. [#53637]
+- Leaderboard chart: Line the values up on the right edge and the deltas in a column of their own when a comparison is shown, instead of letting a wide delta push its row's value out of line. [#54162]
+- Read every series at the selected or hovered date in tooltips, so series that skip a date no longer pair points from different dates. [#54132]
+
 ## [4.12.0] - 2026-10-26
 ### Added
 - Bar chart: Add an overlap layout that draws each group inside the one before it, with comparisons in a slot beside them, and expose its bar colors through a `useBarColors` hook. [#53836]
@@ -27,9 +48,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Heatmap chart: Lighten the color scale to 2.5:1 contrast at the lowest step and 6:1 at the highest, and keep the two ends apart when the empty-cell color sits far from the background. [#53450]
 - Heatmap chart: Offset the grid's focus ring by the design system focus width. [#53522]
 - Legend: Set wrapped rows of a horizontal legend closer together than items on one row, and expose both gaps as CSS variables. [#53704]
-- Update package dependencies. [#53004]
-- Update package dependencies. [#53678]
-- Update package dependencies. [#53806]
+- Update package dependencies. [#53004] [#53678] [#53806]
 
 ### Fixed
 - Conversion funnel chart: Show a focus ring on the focused step bar. [#53522]
@@ -141,8 +160,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Heatmap chart: Add `tooltipVariant="dark"`, which draws the tooltip on the package's dark tooltip surface, `tooltipStyle` for inline box overrides, and a `variant="bar"` legend that joins the scale steps into one continuous band. [#52368]
 
 ### Changed
-- Update package dependencies. [#52187]
-- Update package dependencies. [#52401]
+- Update package dependencies. [#52187] [#52401]
 
 ### Fixed
 - Bar chart: Align grid lines with axis ticks (explicit or derived). [#52234]
@@ -381,12 +399,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.4.3] - 2026-05-25
 ### Changed
-- Update dependencies. [#43811]
+- Update dependencies.
 
 ## [1.4.2] - 2026-05-21
 ### Changed
-- Update package dependencies. [#48405]
-- Update package dependencies. [#49012]
+- Update package dependencies. [#48405] [#49012]
 
 ## [1.4.1] - 2026-05-19
 ### Changed
@@ -403,7 +420,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.3.1] - 2026-05-11
 ### Changed
-- Update dependencies. [#43811]
+- Update dependencies.
 
 ## [1.3.0] - 2026-05-04
 ### Added
@@ -583,7 +600,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.54.1] - 2026-01-26
 ### Changed
-- Update dependencies. [#43811]
+- Update dependencies.
 
 ## [0.54.0] - 2026-01-21
 ### Added
@@ -614,8 +631,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Change Geo Chart data format to handle all Google Charts data [#46330]
-- Update package dependencies. [#46362]
-- Update package dependencies. [#46363]
+- Update package dependencies. [#46362] [#46363]
 
 ### Fixed
 - Charts: Add documentation and API references of animation feature. [#46326]
@@ -748,7 +764,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.38.2] - 2025-09-22
 ### Changed
-- Update dependencies. [#43811]
+- Update dependencies.
 
 ## [0.38.1] - 2025-09-19
 ### Changed
@@ -1021,16 +1037,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add dynamic chart margin calculation and improve Y-axis tick formatting [#43679]
 - Refactor BarChart to use @visx/xychart [#43677]
 - Update dependencies. [#43068]
-- Update package dependencies. [#43326]
-- Update package dependencies. [#43354]
-- Update package dependencies. [#43398]
-- Update package dependencies. [#43399]
-- Update package dependencies. [#43400]
-- Update package dependencies. [#43516]
-- Update package dependencies. [#43578]
-- Update package dependencies. [#43718]
-- Update package dependencies. [#43734]
-- Update package dependencies. [#43766]
+- Update package dependencies. [#43326] [#43354] [#43398] [#43399] [#43400] [#43516] [#43578] [#43718] [#43734] [#43766]
 
 ### Removed
 - Removed animation for line and bar charts [#43809]
@@ -1060,8 +1067,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Code: First pass of style coding standards. [#42734]
-- Update package dependencies. [#42762]
-- Update package dependencies. [#42809]
+- Update package dependencies. [#42762] [#42809]
 
 ### Fixed
 - Code: Update stylesheets to use hex instead of named colors. [#42920]
@@ -1077,8 +1083,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Introduce Theme seriesLineStyles property [#42530]
 
 ### Changed
-- Update package dependencies. [#42509]
-- Update package dependencies. [#42511]
+- Update package dependencies. [#42509] [#42511]
 
 ### Fixed
 - Bar chart: fix tickFormat not working issue [#42524]
@@ -1086,8 +1091,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.10.0] - 2025-03-17
 ### Changed
 - Bar chart: align options with line chart [#42448]
-- Update package dependencies. [#42163]
-- Update package dependencies. [#42384]
+- Update package dependencies. [#42163] [#42384]
 
 ## [0.9.0] - 2025-03-02
 ### Added
@@ -1216,6 +1220,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixed lints following ESLint rule changes for TS [#40584]
 - Fixing a bug in Chart storybook data. [#40640]
 
+[4.14.0]: https://github.com/Automattic/charts/compare/v4.13.0...v4.14.0
+[4.13.0]: https://github.com/Automattic/charts/compare/v4.12.0...v4.13.0
 [4.12.0]: https://github.com/Automattic/charts/compare/v4.11.1...v4.12.0
 [4.11.1]: https://github.com/Automattic/charts/compare/v4.11.0...v4.11.1
 [4.11.0]: https://github.com/Automattic/charts/compare/v4.10.0...v4.11.0

package/TOKENS.md

@@ -152,6 +152,7 @@ The palette is resolved per provider, so one `ColorCache` and one group-to-color
 | `--a8c-charts-border-radius-leaderboard-bar` | _(none — pill shape, no WPDS radius fits)_ | `9999px` |
 | `--a8c-charts-dimension-leaderboard-row-gap` | `--wpds-dimension-gap-md` | `12px` |
 | `--a8c-charts-dimension-leaderboard-column-gap` | `--wpds-dimension-gap-xs` | `4px` |
+| `--a8c-charts-dimension-leaderboard-label-inset` | `--wpds-dimension-padding-sm` | `8px` |
 | `--a8c-charts-dimension-legend-column-gap` | `--wpds-dimension-gap-lg` | `16px` |
 | `--a8c-charts-dimension-legend-row-gap` | `--wpds-dimension-gap-sm` | `8px` |
 | `--a8c-charts-elevation-xs` | _(none — `--wpds-elevation-*` removed in theme 1.0.0)_ | `0 1px 1px 0 #00000008, 0 1px 2px 0 #00000005, 0 3px 3px 0 #00000005, 0 4px 4px 0 #00000003` |
@@ -161,6 +162,8 @@ The motion pair carries the one-shot reveal a data mark plays on first paint, ac
 
 `--a8c-charts-border-radius-bar` rounds the conversion funnel's bars. `--a8c-charts-border-radius-bar-chart` rounds the bars of the bar chart and bar list chart; set it to a radius such as `var(--wpds-border-radius-sm)` to opt in. Bar charts apply it as the CSS `rx` property, so it rounds all four corners of a bar. It resolves in CSS at the bar, so an override set anywhere inside the provider tree applies, the chart's own class included; see [Precedence](#precedence) for overrides above the provider.
 
+`--a8c-charts-dimension-leaderboard-label-inset` pads an overlay label at its inline start, inside the `--wpds-border-width-focus` every row reserves for its focus ring. Read both to line up content outside the chart, such as a column header, with the row text.
+
 The legend pair spaces the items of a horizontal legend: the column gap between items on one line, and the smaller row gap between lines once the legend wraps.
 
 The elevation fallbacks hold the values their removed `--wpds-elevation-*` tokens used to resolve to, until a replacement exists.