@automattic/charts 0.57.0 → 0.59.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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).
 
+## [0.59.0] - 2026-03-23
+### Added
+- ChartLayout: Add component for shared chart and legend layout. [#47554]
+
+### Changed
+- Move tooltip portal containerRef from ChartLayout to inner svg-wrapper in pie charts. [#47619]
+- Remove internal hooks, utilities, and types from public exports to reduce API surface. [#47703]
+- Remove `percentage` from DataPointPercentage interface. [#47668]
+- Standardize legend stories and documentation across all chart types. [#47545]
+- Update package dependencies. [#47684] [#47719]
+
+### Removed
+- Remove individual chart entry point exports in favor of the main package entry point for v1. [#47673]
+
+### Fixed
+- Derive default legend shape from chart type in composition API. [#47671]
+- Fix broken story references and simplify legend sections in Storybook docs. [#47663]
+- Fix empty-state text wrapping when all legend items are hidden. [#47620]
+
+## [0.58.0] - 2026-03-16
+### Security
+- Fix ReDoS vulnerability in date parsing timezone detection. [#47524]
+
+### Changed
+- Breaking: Consolidate flat legend props into a nested legend configuration object on BaseChartProps. [#47506]
+- Charts: Fix Legend position prop in the composition API so that legends render in the correct top or bottom slot. [#47478]
+- Remove useHasLegendChild hook from @automattic/charts/hooks (charts now derive legend presence from useChartChildren). [#47478]
+- Update dependencies. [#47472]
+
+### Fixed
+- Bundle fast-deep-equal as a non-external dependency to fix compatibility with webpack strict ESM mode. [#47372]
+
 ## [0.57.0] - 2026-03-09
 ### Added
 - Add identity-obj-proxy to enable CSS module class assertions in tests. [#47476]
@@ -16,8 +48,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Update package dependencies. [#47496]
 
 ### Fixed
-- Charts: Fix leaderboard chart height calculation to include legend layout and keep responsive sizing by default. [#47369]
-- Charts: Fix zero-value bars not visible in small chart heights by ensuring minimum pixel-based value. [#47477]
+- Fix leaderboard chart height calculation to include legend layout and keep responsive sizing by default. [#47369]
+- Fix zero-value bars not visible in small chart heights by ensuring minimum pixel-based value. [#47477]
 - Legend: Fix value rendering for falsy values (e.g. 0), guard against empty string spans, make value optional in types, and use index-based lookup for better performance. [#47459]
 
 ## [0.56.7] - 2026-03-02
@@ -728,6 +760,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]
 
+[0.59.0]: https://github.com/Automattic/charts/compare/v0.58.0...v0.59.0
+[0.58.0]: https://github.com/Automattic/charts/compare/v0.57.0...v0.58.0
 [0.57.0]: https://github.com/Automattic/charts/compare/v0.56.7...v0.57.0
 [0.56.7]: https://github.com/Automattic/charts/compare/v0.56.6...v0.56.7
 [0.56.6]: https://github.com/Automattic/charts/compare/v0.56.5...v0.56.6

package/README.md

@@ -23,53 +23,19 @@ yarn add @automattic/charts
 
 ### Importing Components
 
-You can import charts from the package in several ways depending on your needs:
-
-#### Option 1: Import everything from the main entry (includes all styles)
+Import chart components from the main entry point:
 
 ```javascript
 import { LineChart, BarChart, PieChart } from '@automattic/charts';
-import '@automattic/charts/style.css'; // Import all styles
-```
-
-#### Option 2: Import individual components (tree-shaking friendly)
-
-For better bundle optimization, you can import components individually:
-
-```javascript
-// Import individual components
-import { LineChart } from '@automattic/charts/line-chart';
-import { BarChart } from '@automattic/charts/bar-chart';
-import { PieChart } from '@automattic/charts/pie-chart';
-import { GeoChart } from '@automattic/charts/geo-chart';
-import { Sparkline } from '@automattic/charts/sparkline';
-
-// Import individual component styles
-import '@automattic/charts/line-chart/style.css';
-import '@automattic/charts/bar-chart/style.css';
-import '@automattic/charts/pie-chart/style.css';
-import '@automattic/charts/geo-chart/style.css';
-import '@automattic/charts/sparkline/style.css';
+import '@automattic/charts/style.css';
 ```
 
-Individual entry exports also provide easier access to chart-specific types and helpers when available. This makes it simpler to find and leverage TypeScript types, utility functions, and other chart-specific tools that are exported alongside the main component.
+Modern bundlers tree-shake unused JavaScript automatically, so only the chart components you import are included in your bundle. Note that `style.css` includes styles for all charts.
 
-#### Available Components and Entry Points
+#### Additional Entry Points
 
-The following components can be imported individually:
+For utilities and auxiliary components, separate entry points are available:
 
-- `@automattic/charts/bar-chart` - Bar Chart component
-- `@automattic/charts/bar-list-chart` - Bar List Chart component
-- `@automattic/charts/conversion-funnel-chart` - Conversion Funnel Chart component
-- `@automattic/charts/geo-chart` - Geo Chart component
-- `@automattic/charts/leaderboard-chart` - Leaderboard Chart component
-- `@automattic/charts/legend` - Legend component
-- `@automattic/charts/line-chart` - Line Chart component
-- `@automattic/charts/pie-chart` - Pie Chart component
-- `@automattic/charts/pie-semi-circle-chart` - Pie Semi-Circle Chart component
-- `@automattic/charts/sparkline` - Sparkline component
-- `@automattic/charts/tooltip` - Tooltip component
-- `@automattic/charts/trend-indicator` - Trend Indicator component
 - `@automattic/charts/hooks` - React hooks
 - `@automattic/charts/providers` - Context providers
 - `@automattic/charts/utils` - Shared chart utility functions
@@ -79,27 +45,14 @@ The following components can be imported individually:
 
 #### Available Style Imports
 
-Each component has its own CSS file that can be imported individually:
-
-- `@automattic/charts/bar-chart/style.css`
-- `@automattic/charts/bar-list-chart/style.css`
-- `@automattic/charts/conversion-funnel-chart/style.css`
-- `@automattic/charts/geo-chart/style.css`
-- `@automattic/charts/leaderboard-chart/style.css`
-- `@automattic/charts/legend/style.css`
-- `@automattic/charts/line-chart/style.css`
-- `@automattic/charts/pie-chart/style.css`
-- `@automattic/charts/pie-semi-circle-chart/style.css`
-- `@automattic/charts/sparkline/style.css`
-- `@automattic/charts/tooltip/style.css`
-- `@automattic/charts/trend-indicator/style.css`
+- `@automattic/charts/style.css` - All chart styles
 
 ### Basic Usage Example
 
 ```javascript
 import React from 'react';
 import { LineChart } from '@automattic/charts';
-import '@automattic/charts/line-chart/style.css';
+import '@automattic/charts/style.css';
 
 const data = [
 	{ date: new Date( '2024-01-01' ), value: 10 },