TanStack · tannerlinsley · Aug 26, 2026 · Aug 26, 2026
diff --git a/.changeset/official-alpha.md b/.changeset/official-alpha.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,106 @@
 # Changelog
 
+## 0.16.0
+
+### @tanstack/charts
+
+#### Minor Changes
+
+- [#115](https://github.com/TanStack/charts/pull/115) [`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a) - Move TanStack Charts into official Alpha on the regular `0.x` release line.
+
+  Chart definitions now require Cartesian scales under `scales.x` and `scales.y`.
+  Polar definitions require `scales.angle` and `scales.radius`. The temporary
+  pre-Alpha root properties, runtime adapters, and development warnings have been
+  removed. Custom mark types should replace `ChartMarkX` and `ChartMarkY` with
+  `ChartMarkPointX` and `ChartMarkPointY`, imported from
+  `@tanstack/charts/mark/scale-values`. Polar layout callbacks should read the
+  reserved mappings from `layout.scales`.
+
+  Reserved scale entries are checked against the marks that use them at the
+  precise authored type boundary. A materialized dimension requires a configured
+  scale, while an unused dimension requires an explicit `null` entry. Runtime
+  validation still checks required reserved entries and channels that actually
+  materialize, but type-only scale ownership cannot be recovered after a custom
+  mark or stored definition has been erased.
+
+  Fresh built-in mark option literals now reject unsupported properties while
+  preserving typed channels, named scale IDs, and generic mark wrappers.
+
+  Exact-zero cells in diverging stacks now stay on their running positive or
+  negative baseline instead of drawing false spikes through lower area layers.
+  Pinned tooltips now dismiss when the pointer is pressed outside the chart and
+  tooltip, so pointer inspection resumes after focus leaves the chart.
+
+### @tanstack/react-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/react-native-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/octane-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/preact-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/vue-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/solid-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/svelte-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/angular-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/lit-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
+### @tanstack/alpine-charts
+
+#### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
 ## 0.15.0
 
 ### @tanstack/charts

diff --git a/MARKETING.md b/MARKETING.md
@@ -5,7 +5,7 @@ Last updated: 2026-08-26
 ## Status
 
 TanStack Charts is in official Alpha on `main`. The latest public release is
-`0.15.0`. Repository docs, examples, and the catalog may include contracts not
+`0.16.0`. Repository docs, examples, and the catalog may include contracts not
 available in that release, so documentation at the verified release source
 revision remains the release record. Alpha is not a production-readiness claim,
 and marketing must keep the compatibility limits in
@@ -590,7 +590,7 @@ production case study.
 
 ### Official Alpha
 
-- Conversion: Install `0.15.0`, read its release-source docs, explore the
+- Conversion: Install `0.16.0`, read its release-source docs, explore the
   catalog, and report friction.
 - Publish architecture, benchmarks, and working examples with limitations.
 - Recruit a small number of chart-heavy TanStack users.
@@ -628,7 +628,7 @@ tracked in [`PLAN.md`](./PLAN.md):
 foundation for data-rich TanStack applications and a credible choice for
 frontend teams whose visualizations need to grow beyond standard chart types.
 
-**Primary conversion today:** Install `0.15.0` and complete the first chart.
+**Primary conversion today:** Install `0.16.0` and complete the first chart.
 
 **Primary conversion after stable release:** Install the package and complete
 the first chart.

diff --git a/README.md b/README.md
@@ -40,8 +40,8 @@ server-rendered application charts.
 
 > [!IMPORTANT]
 > This README follows unreleased `main`, the official Alpha line. The latest
-> published release is TanStack Charts `0.15.0`; use its
-> [release-source documentation](https://github.com/TanStack/charts/tree/v0.15.0/docs).
+> published release is TanStack Charts `0.16.0`; use its
+> [release-source documentation](https://github.com/TanStack/charts/tree/v0.16.0/docs).
 > Alpha releases use regular `0.x` versions and may contain breaking changes
 > between minor releases. Pin an exact version for production use and read the
 > [Alpha stability policy](./docs/stability.md) before upgrading.

diff --git a/docs/comparison.md b/docs/comparison.md
@@ -3,7 +3,7 @@ title: Compare Libraries
 description: Compare TanStack Charts with measured and documentation-reviewed charting libraries.
 ---
 
-The latest published TanStack Charts release is `0.15.0`, while this page
+The latest published TanStack Charts release is `0.16.0`, while this page
 measures unreleased workspace source against pinned competitor packages. This
 comparison records architectural differences and reproducible evidence without
 turning untested behavior into a checkmark.
@@ -170,11 +170,11 @@ Canvas composition while keeping D3 and state ownership explicit.
 
 ## Evidence and reproduction
 
-- [Standard comparison protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/README.md)
+- [Standard comparison protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/README.md)
 - [Current tracked bundle baseline](https://github.com/TanStack/charts/blob/main/benchmarks/comparison/bundle-baseline.json)
-- [Pinned release-source bundle baseline](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/bundle-baseline.json)
-- [Stress protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/stress/README.md)
-- [Catalog conformance protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/conformance/README.md)
+- [Pinned release-source bundle baseline](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/bundle-baseline.json)
+- [Stress protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/stress/README.md)
+- [Catalog conformance protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/conformance/README.md)
 
 ```sh
 pnpm benchmark:size

diff --git a/docs/installation.md b/docs/installation.md
@@ -4,8 +4,8 @@ description: Install TanStack Charts with compact scales, framework adapters, an
 ---
 
 These docs follow unreleased `main`, the official Alpha line. The latest
-published release is TanStack Charts `0.15.0`; use its
-[release-source docs](https://github.com/TanStack/charts/tree/v0.15.0/docs)
+published release is TanStack Charts `0.16.0`; use its
+[release-source docs](https://github.com/TanStack/charts/tree/v0.16.0/docs)
 for the exact surface. Alpha releases use regular `0.x` versions and may break
 APIs between minor releases. Install TanStack Charts in each application that
 authors chart definitions:

diff --git a/docs/overview.md b/docs/overview.md
@@ -4,7 +4,7 @@ description: Learn what TanStack Charts provides, how its grammar works, and whe
 ---
 
 These docs follow unreleased `main`, the official Alpha line. The latest
-published TanStack Charts release is `0.15.0`. Alpha uses regular `0.x`
+published TanStack Charts release is `0.16.0`. Alpha uses regular `0.x`
 versions, and APIs may change between minor releases. See
 [Alpha stability](./stability.md) for the release contract.
 

diff --git a/packages/alpine-charts/CHANGELOG.md b/packages/alpine-charts/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/alpine-charts
 
+## 0.16.0
+
+### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
 ## 0.15.0
 
 ### Patch Changes

diff --git a/packages/alpine-charts/package.json b/packages/alpine-charts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/alpine-charts",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "private": false,
   "license": "MIT",
   "repository": {

diff --git a/packages/angular-charts/CHANGELOG.md b/packages/angular-charts/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/angular-charts
 
+## 0.16.0
+
+### Patch Changes
+
+- Updated dependencies [[`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a)]:
+  - @tanstack/charts@0.16.0
+
 ## 0.15.0
 
 ### Patch Changes

diff --git a/packages/angular-charts/package.json b/packages/angular-charts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/angular-charts",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "private": false,
   "license": "MIT",
   "repository": {

diff --git a/packages/charts-core/CHANGELOG.md b/packages/charts-core/CHANGELOG.md
@@ -1,5 +1,34 @@
 # @tanstack/charts
 
+## 0.16.0
+
+### Minor Changes
+
+- [#115](https://github.com/TanStack/charts/pull/115) [`3df87d7`](https://github.com/TanStack/charts/commit/3df87d71f0305e5a450c10b66940f76f3e14259a) - Move TanStack Charts into official Alpha on the regular `0.x` release line.
+
+  Chart definitions now require Cartesian scales under `scales.x` and `scales.y`.
+  Polar definitions require `scales.angle` and `scales.radius`. The temporary
+  pre-Alpha root properties, runtime adapters, and development warnings have been
+  removed. Custom mark types should replace `ChartMarkX` and `ChartMarkY` with
+  `ChartMarkPointX` and `ChartMarkPointY`, imported from
+  `@tanstack/charts/mark/scale-values`. Polar layout callbacks should read the
+  reserved mappings from `layout.scales`.
+
+  Reserved scale entries are checked against the marks that use them at the
+  precise authored type boundary. A materialized dimension requires a configured
+  scale, while an unused dimension requires an explicit `null` entry. Runtime
+  validation still checks required reserved entries and channels that actually
+  materialize, but type-only scale ownership cannot be recovered after a custom
+  mark or stored definition has been erased.
+
+  Fresh built-in mark option literals now reject unsupported properties while
+  preserving typed channels, named scale IDs, and generic mark wrappers.
+
+  Exact-zero cells in diverging stacks now stay on their running positive or
+  negative baseline instead of drawing false spikes through lower area layers.
+  Pinned tooltips now dismiss when the pointer is pressed outside the chart and
+  tooltip, so pointer inspection resumes after focus leaves the chart.
+
 ## 0.15.0
 
 ### Minor Changes

diff --git a/packages/charts-core/docs/comparison.md b/packages/charts-core/docs/comparison.md
@@ -3,7 +3,7 @@ title: Compare Libraries
 description: Compare TanStack Charts with measured and documentation-reviewed charting libraries.
 ---
 
-The latest published TanStack Charts release is `0.15.0`, while this page
+The latest published TanStack Charts release is `0.16.0`, while this page
 measures unreleased workspace source against pinned competitor packages. This
 comparison records architectural differences and reproducible evidence without
 turning untested behavior into a checkmark.
@@ -170,11 +170,11 @@ Canvas composition while keeping D3 and state ownership explicit.
 
 ## Evidence and reproduction
 
-- [Standard comparison protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/README.md)
+- [Standard comparison protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/README.md)
 - [Current tracked bundle baseline](https://github.com/TanStack/charts/blob/main/benchmarks/comparison/bundle-baseline.json)
-- [Pinned release-source bundle baseline](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/bundle-baseline.json)
-- [Stress protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/comparison/stress/README.md)
-- [Catalog conformance protocol](https://github.com/TanStack/charts/blob/v0.15.0/benchmarks/conformance/README.md)
+- [Pinned release-source bundle baseline](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/bundle-baseline.json)
+- [Stress protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/comparison/stress/README.md)
+- [Catalog conformance protocol](https://github.com/TanStack/charts/blob/v0.16.0/benchmarks/conformance/README.md)
 
 ```sh
 pnpm benchmark:size

diff --git a/packages/charts-core/docs/installation.md b/packages/charts-core/docs/installation.md
@@ -4,8 +4,8 @@ description: Install TanStack Charts with compact scales, framework adapters, an
 ---
 
 These docs follow unreleased `main`, the official Alpha line. The latest
-published release is TanStack Charts `0.15.0`; use its
-[release-source docs](https://github.com/TanStack/charts/tree/v0.15.0/docs)
+published release is TanStack Charts `0.16.0`; use its
+[release-source docs](https://github.com/TanStack/charts/tree/v0.16.0/docs)
 for the exact surface. Alpha releases use regular `0.x` versions and may break
 APIs between minor releases. Install TanStack Charts in each application that
 authors chart definitions:

diff --git a/packages/charts-core/docs/overview.md b/packages/charts-core/docs/overview.md
@@ -4,7 +4,7 @@ description: Learn what TanStack Charts provides, how its grammar works, and whe
 ---
 
 These docs follow unreleased `main`, the official Alpha line. The latest
-published TanStack Charts release is `0.15.0`. Alpha uses regular `0.x`
+published TanStack Charts release is `0.16.0`. Alpha uses regular `0.x`
 versions, and APIs may change between minor releases. See
 [Alpha stability](./stability.md) for the release contract.
 

diff --git a/packages/charts-core/package.json b/packages/charts-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/charts",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "private": false,
   "license": "MIT",
   "keywords": [

diff --git a/packages/charts-core/skills/build-chart-interactions/SKILL.md b/packages/charts-core/skills/build-chart-interactions/SKILL.md
@@ -8,7 +8,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/charts'
-  library_version: '0.15.0'
+  library_version: '0.16.0'
 sources:
   - 'TanStack/charts:docs/guides/tooltips-and-focus.md'
   - 'TanStack/charts:docs/guides/interactions-and-selections.md'

diff --git a/packages/charts-core/skills/compose-marks-and-views/SKILL.md b/packages/charts-core/skills/compose-marks-and-views/SKILL.md
@@ -8,7 +8,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/charts'
-  library_version: '0.15.0'
+  library_version: '0.16.0'
 sources:
   - 'TanStack/charts:docs/concepts/grammar-of-graphics.md'
   - 'TanStack/charts:docs/concepts/marks-and-layering.md'

diff --git a/packages/charts-core/skills/configure-scales-guides-color/SKILL.md b/packages/charts-core/skills/configure-scales-guides-color/SKILL.md
@@ -8,7 +8,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/charts'
-  library_version: '0.15.0'
+  library_version: '0.16.0'
 sources:
   - 'TanStack/charts:docs/concepts/scales-and-d3.md'
   - 'TanStack/charts:docs/reference/scales-guides-and-color.md'

diff --git a/packages/charts-core/skills/coordinate-charts-with-tanstack/SKILL.md b/packages/charts-core/skills/coordinate-charts-with-tanstack/SKILL.md
@@ -10,7 +10,7 @@ description: >
 metadata:
   type: composition
   library: '@tanstack/charts'
-  library_version: '0.15.0'
+  library_version: '0.16.0'
 sources:
   - 'TanStack/charts:docs/guides/interactions-and-selections.md'
   - 'TanStack/charts:docs/guides/transforms-and-reactivity.md'

diff --git a/packages/charts-core/skills/debug-and-verify-charts/SKILL.md b/packages/charts-core/skills/debug-and-verify-charts/SKILL.md
@@ -8,7 +8,7 @@ description: >
 metadata:
   type: lifecycle
   library: '@tanstack/charts'
-  library_version: '0.15.0'
+  library_version: '0.16.0'
 sources:
   - 'TanStack/charts:docs/guides/testing-and-debugging.md'
   - 'TanStack/charts:docs/guides/typescript.md'