@automattic/charts 1.1.0 → 1.2.0

package/AGENTS.md

@@ -20,6 +20,15 @@ jp changelog add js-packages/charts -s patch -t changed -e "Charts: <user-facing
 - Accessibility behavior (keyboard navigation, accessible tooltips) is core chart behavior, not optional polish.
 - Charts are responsive by default — do not add external responsive wrappers that conflict with built-in sizing semantics.
 
+## WordPress UI + Theme Integration
+
+The package is migrating to WordPress UI and Theme as its defaults. When adding or changing code, follow these defaults unless the task explicitly says otherwise:
+
+- **Design tokens (WPDS).** In SCSS, use `var(--wpds-dimension-*, <fallback>)`, `var(--wpds-border-*, <fallback>)`, and `var(--wpds-typography-*, <fallback>)` instead of hardcoded px values for spacing, padding, margins, border radius, border width, font size, and font weight. Fallbacks must match the WPDS spec value for that token — do not invent fallback values.
+- **UI primitives.** Prefer `Stack` and the stable `Text` from `@wordpress/ui` over ad-hoc flexbox or raw `<span>`/`<div>` for layout and text. Do not use `__experimental*` exports from `@wordpress/components` (e.g. `__experimentalText`, `__experimentalHStack`) — use the stable `@wordpress/ui` equivalents. Exception: `__experimentalGrid` has no stable alternative yet and is acceptable to use for now.
+- **Theming.** Theming flows through `@wordpress/theme`'s `ThemeProvider` (unlocked via private APIs in Storybook; see `src/stories/chart-decorator.tsx`). Do not manually override DS tokens in stories or components to achieve theming — pass a color through `ThemeProvider` instead.
+- **Chart element styles.** Read chart element styles via `getElementStyles` from `GlobalChartsProvider`, not directly from `theme`. This is the supported path for color/style resolution across themes.
+
 ## Documentation Workflow
 
 - For docs tasks agents should use the skill at `.agents/skills/charts-docs.md`.
@@ -43,8 +52,12 @@ jp changelog add js-packages/charts -s patch -t changed -e "Charts: <user-facing
 - Documenting props or behavior not present in stories and implementation.
 - Refactoring core composition/provider patterns as if they are accidental complexity.
 - Defining new chart prop interfaces that diverge from established base chart contracts (for example, not aligning with `BaseChartProps` when appropriate).
-- Using ad-hoc flexbox layouts where established layout primitives (e.g. `Stack`) should be preferred.
+- Using ad-hoc flexbox layouts where established layout primitives (e.g. `Stack` from `@wordpress/ui`) should be preferred.
 - Accessing colors/styles directly from `theme` rather than using `getElementStyles` from `GlobalChartsProvider`.
+- Hardcoding px values in SCSS for spacing, borders, or typography where a WPDS token (`--wpds-dimension-*`, `--wpds-border-*`, `--wpds-typography-*`) exists.
+- CSS variable fallback values that diverge from the WPDS spec for that token.
+- Using `__experimental*` exports from `@wordpress/components` (e.g. `__experimentalText`, `__experimentalHStack`) instead of the stable `@wordpress/ui` equivalents. (`__experimentalGrid` is excepted — no stable alternative exists yet.)
+- Manually overriding DS tokens in stories or components to achieve theming instead of passing a color through `@wordpress/theme`'s `ThemeProvider`.
 - Responsive wrappers that conflict with component sizing semantics (fixed-height charts, resize behavior, aspect-ratio assumptions).
 - Updating `.docs.mdx` without the corresponding `.api.mdx` when API docs are affected.
 - Not checking CSF file references in `.docs.mdx` when changing or removing stories.

package/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [1.2.0] - 2026-04-20
+### Changed
+- Charts: Replace hardcoded spacing and border values in module SCSS with WPDS dimension and border design tokens. [#48019]
+- Update package dependencies. [#48106] [#48126] [#48141]
+
+## [1.1.1] - 2026-04-15
+### Changed
+- Charts: Document WordPress UI + Theme integration defaults. [#48020]
+- Charts: Replace ad-hoc flexbox layouts with @wordpress/ui Stack across legend, conversion funnel, line chart, geo chart, conversion funnel tooltip, and donut story. [#47981]
+- Update package dependencies. [#47907]
+
 ## [1.1.0] - 2026-04-10
 ### Changed
 - Replace hardcoded typography values with WPDS design tokens for font family, size, weight, and line height. [#47989]
@@ -794,6 +805,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]
 
+[1.2.0]: https://github.com/Automattic/charts/compare/v1.1.1...v1.2.0
+[1.1.1]: https://github.com/Automattic/charts/compare/v1.1.0...v1.1.1
 [1.1.0]: https://github.com/Automattic/charts/compare/v1.0.2...v1.1.0
 [1.0.2]: https://github.com/Automattic/charts/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/Automattic/charts/compare/v1.0.0...v1.0.1