@automattic/charts 1.11.0 → 2.0.0

package/CHANGELOG.md

@@ -5,12 +5,32 @@ 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).
 
+## [2.0.0] - 2026-08-10
+### Added
+- Time axis: Accept a tickResolution hint on the x-axis options so callers that know the data's bucket size can set tick formats directly instead of relying on inference. [#51017]
+
+### Changed
+- Time axis: Pick tick formats by bucket resolution as well as span — hour ticks (with the date at midnight boundaries) for sub-daily series spanning up to a week, and month ticks (with the year at January) instead of full dates for month-or-coarser buckets. [#51010]
+- Update package dependencies. [#50509]
+- Zoom: Expose the reset button's shadow as `--a8c-charts-elevation-xs`, replacing the `--wpds-elevation-xs` token removed in `@wordpress/theme` 1.0.0. [#50509]
+- Zoom: Restore the accessible tooltip on the reset control. `@wordpress/ui` is no longer bundled into the package output, so each consumer's bundler now resolves it. It remains a dependency and resolves from node_modules by default, but a bundler that externalizes `@wordpress/*` to `window.wp.*` must bundle `@wordpress/ui` instead — `window.wp.ui` does not exist. [#51016]
+
+### Fixed
+- Time axis: Show date ticks rather than hour ticks for a daily-bucket pair spanning exactly one day. [#51013]
+
+## [1.12.0] - 2026-08-03
+### Added
+- New `legend.collapseGroups` option folds series that share a `group` into a single legend item, labelled by the group's primary series; with `legend.interactive` that item toggles the whole group in one click. Off by default, so legends keep one item per series unless you opt in. Available on the bar, line and area charts. The line chart gains a `rescaleYOnVisibilityChange` prop (matching the area chart) to pin the value axis to the full data range while series are hidden; and when every series is hidden, the grid and axes are dropped so the empty state stands on its own. The area chart's `rescaleYOnLegendToggle` prop is deprecated in favour of `rescaleYOnVisibilityChange` (still honoured as an alias). [#50194]
+
+### Changed
+- Zoom: Render the reset control with the WordPress UI Button, fix keyboard activation, expose the selection rectangle's colors as `--a8c-charts-color-zoom-selection` and `--a8c-charts-color-zoom-selection-stroke`, and document the `zoomable` prop for the line and area charts. [#50796]
+
 ## [1.11.0] - 2026-07-27
 ### Added
-- Charts: add a `fitRows` prop to LeaderboardChart so a chart in a fixed-height container shows only the rows that fit instead of scrolling. [#50688]
+- Add a `fitRows` prop to LeaderboardChart so a chart in a fixed-height container shows only the rows that fit instead of scrolling. [#50688]
 
 ### Changed
-- Charts: standardise package CSS custom properties on the --a8c-charts-{category}-{name} naming convention and document the token catalog; existing public override variables keep working via deprecated aliases. [#50656]
+- Standardize CSS custom properties on the `--a8c-charts-{category}-{name}` naming convention; existing override variables keep working via deprecated aliases. [#50656]
 
 ### Fixed
 - Leaderboard: Distinguish unavailable percentage changes from missing comparison data. [#50690]
@@ -945,6 +965,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]
 
+[2.0.0]: https://github.com/Automattic/charts/compare/v1.12.0...v2.0.0
+[1.12.0]: https://github.com/Automattic/charts/compare/v1.11.0...v1.12.0
 [1.11.0]: https://github.com/Automattic/charts/compare/v1.10.3...v1.11.0
 [1.10.3]: https://github.com/Automattic/charts/compare/v1.10.2...v1.10.3
 [1.10.2]: https://github.com/Automattic/charts/compare/v1.10.1...v1.10.2

package/TOKENS.md

@@ -49,7 +49,25 @@ Instance styling knobs, on the same convention but not shared semantic roles:
 `--a8c-charts-border-radius-leaderboard-bar`,
 `--a8c-charts-dimension-leaderboard-bar-hover-inset`,
 `--a8c-charts-color-heatmap-*`, `--a8c-charts-dimension-heatmap-*`,
-`--a8c-charts-heatmap-cell-intensity`.
+`--a8c-charts-heatmap-cell-intensity`,
+`--a8c-charts-color-zoom-selection`, `--a8c-charts-color-zoom-selection-stroke`,
+`--a8c-charts-elevation-xs`.
+
+| Role | Maps to `--wpds-*` | Fallback |
+|---|---|---|
+| `--a8c-charts-color-zoom-selection` | `--wpds-color-background-interactive-brand-strong` | `#3858e9` |
+| `--a8c-charts-color-zoom-selection-stroke` | `--wpds-color-stroke-interactive-brand` | `#3858e9` |
+| `--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` |
+
+The zoom selection roles carry the drag-to-zoom rectangle's fill and border. Their
+translucency is not part of the role: it lives in the `fill-opacity` /
+`stroke-opacity` properties, so overriding either role sets an opaque colour and
+keeps the intended transparency.
+
+`--a8c-charts-elevation-xs` carries the zoom reset button's shadow. It has no
+`--wpds-*` mapping: `@wordpress/theme` 1.0.0 removed the whole
+`--wpds-elevation-*` group without a replacement, so the fallback holds the value
+`--wpds-elevation-xs` used to resolve to.
 
 `--a8c-charts-heatmap-cell-intensity` is the one variable without a `{category}`
 segment: it holds a unitless 0–1 scalar consumed inside `color-mix()`, not a colour.