docs: Integrate charts demonstrating performance improvement in release post

Author: ntucker

website/blog/.cursor/rules/blog-posts.mdc

@@ -104,6 +104,36 @@ Note: Some imports (like `PkgTabs`) may appear after truncate if only used in Mi
 
 **Embedded demos:** Use `<StackBlitz app="app-name" file="path/to/file.tsx" />`
 
+## Performance Improvements
+
+When documenting performance gains:
+
+1. **Lead with narrative context** - Briefly explain *what* was optimized (caching, code paths, algorithms)
+2. **Quantify with multipliers** - Use concrete metrics like "2x" or "16x improvement"
+3. **Link evidence** - Reference the PR implementing the optimization and relevant docs
+4. **Visualize with mermaid chart** - Use `xychart-beta` bar chart comparing operations:
+
+```mermaid
+xychart-beta
+    title "Performance vs vX.Y"
+    x-axis ["operation1", "operation2", "operation3"]
+    y-axis "Percentage gain" 0 --> MAX_VALUE
+    bar [new_values]
+    bar [baseline_100s]
+```
+
+5. **Include benchmark links** - End with centered links to live benchmarks and source:
+
+```md
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+```
+
+Keep the baseline bar at 100 for each operation to show relative improvement clearly.
+
 ## Conventions
 
 - **Each change must include:** a link to the PR (or commit if no PR) and relevant doc links

website/blog/2024-01-15-v0.9-release-announcement.md

@@ -43,7 +43,7 @@ const UserResource = createResource({
 import DiffEditor from '@site/src/components/DiffEditor';
 import PkgTabs from '@site/src/components/PkgTabs';
 
-## Resource.extend() <small>(since 0.5)</small>
+## Resource.extend() <small>(since 0.5)</small> {#resourceextend}
 
 [Resource.extend()](/rest/api/resource#extend) provides three powerful ways to customize resources.
 [51b4b0d](https://github.com/reactive/data-client/commit/51b4b0d188)
@@ -84,7 +84,7 @@ const IssueResource = createResource({
 
 ## Controller Methods
 
-### controller.expireAll() <small>(since 0.3)</small>
+### controller.expireAll() <small>(since 0.3)</small> {#controllerexpireall}
 
 Sets all matching responses to *stale*, triggering background refetch while showing existing data.
 [#2802](https://github.com/reactive/data-client/pull/2802)
@@ -97,7 +97,7 @@ controller.expireAll(ArticleResource.getList);
 This differs from `invalidateAll()` which removes the data entirely. `expireAll()` keeps showing
 the cached data while fetching fresh data in the background.
 
-### controller.fetchIfStale() <small>(since 0.4)</small>
+### controller.fetchIfStale() <small>(since 0.4)</small> {#controllerfetchifstale}
 
 Fetches only if data is considered stale; otherwise returns the cached data.
 [#2804](https://github.com/reactive/data-client/pull/2804)
@@ -150,7 +150,7 @@ Endpoint properties are now fully visible in the devtool inspector.
 
 ## Collection Enhancements
 
-### FormData argument filtering <small>(since 0.4)</small>
+### FormData argument filtering <small>(since 0.4)</small> {#formdataargumentfiltering}
 
 [Collections](/rest/api/Collection) can now filter based on FormData arguments. [f95dbc6](https://github.com/reactive/data-client/commit/f95dbc64d1)
 
@@ -161,7 +161,7 @@ ctrl.fetch(getPosts.push, { group: 'react' }, new FormData(e.currentTarget));
 If the FormData contains an `author` field, the newly created item will be properly added to
 collections filtered by that author.
 
-### paginationField <small>(since 0.7)</small>
+### paginationField <small>(since 0.7)</small> {#paginationfield}
 
 Use [paginationField](/rest/api/RestEndpoint#paginationfield) for easy pagination support.
 [c8c557](https://github.com/reactive/data-client/commit/c8c5575e5a)

website/blog/2024-07-13-v0.14-release-announcement.md

@@ -207,6 +207,21 @@ Internal schema interface changes provide a **10% normalization performance boos
 
 Using `Map` instead of plain objects for entity storage provides up to **32% faster lookups** for large datasets. [#3390](https://github.com/reactive/data-client/pull/3390)
 
+```mermaid
+xychart-beta
+    title "Performance vs v0.13"
+    x-axis ["normalize", "denormalize (large)", "denormalize (small)"]
+    y-axis "Percentage gain" 0 --> 140
+    bar [110, 132, 115]
+    bar [100, 100, 100]
+```
+
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+
 ## Schema/Data Modeling
 
 Schema APIs reduce boilerplate for common patterns while enabling more advanced use cases. Client-side joins now work across arbitrary entities (not just nested relationships), dynamic invalidation handles server-only deletion logic, and sensible defaults like `Entity.pk()` using `id` eliminate repetitive code.

website/blog/2025-01-XX-v0.15-vue-support-collection-remove.md

@@ -19,7 +19,7 @@ import Link from '@docusaurus/Link';
 - [mockInitialState()](/blog/2025/01/XX/v0.15-vue-support-collection-remove#mockinitialstate) for simpler test setup
 
 **Performance:**
-- 10-20% improvement for get/denormalize operations
+- [10-20% improvement](/blog/2025/01/XX/v0.15-vue-support-collection-remove#performance) for get/denormalize operations
 
 **[Breaking Changes:](/blog/2025/01/XX/v0.15-vue-support-collection-remove#migration-guide)**
 
@@ -224,6 +224,25 @@ import {
 - `collapseFixture` - Resolves fixture responses (handles function responses)
 - `createFixtureMap` - Separates fixtures into static map and interceptors
 
+## Performance
+
+Removing ImmutableJS auto-detection overhead and optimizing denormalization code paths provides a **10-20% improvement** for get/denormalize operations. [#3421](https://github.com/reactive/data-client/pull/3421), [#3468](https://github.com/reactive/data-client/pull/3468)
+
+```mermaid
+xychart-beta
+    title "Performance vs v0.14"
+    x-axis ["get large", "get small", "denormalize"]
+    y-axis "Percentage gain" 0 --> 125
+    bar [120, 115, 110]
+    bar [100, 100, 100]
+```
+
+<center>
+
+[Benchmarks over time](https://reactive.github.io/data-client/dev/bench/) | [View benchmark](https://github.com/reactive/data-client/tree/master/examples/benchmark)
+
+</center>
+
 ## Other Improvements
 
 - Fix `getPage` types when paginationField is in body