Merge pull request #55 from TanStack/taren/add-crosshair

Add crosshair and shared cursor primitives

Author: tannerlinsley

.changeset/brave-tooltips-expand.md

@@ -15,7 +15,7 @@ Tooltip `format` and `formatGroup` now receive the same content context as
 legend, and spatial-index extension callbacks move their supporting values
 into named context objects.
 
-`ruleX` and `ruleY` now expose presentation-only focus points, so
+`ruleX` and `ruleY` now expose axis-specific presentation-only focus anchors, so
 `whenFocused(..., { match: 'x' })` and `whenFocused(..., { match: 'y' })` can
 reveal focused guide rules without making them interaction or tooltip targets.
 

.changeset/bright-cursors-cross.md

@@ -0,0 +1,5 @@
+---
+'@tanstack/charts': minor
+---
+
+Add renderer-native crosshair rules, categorical cursor bands, labels, and optional intersection markers plus shared focus/free cursor controllers across SVG, Canvas, motion, and React Native rendering. Focus-filtered rule marks now use non-interactive semantic anchors, built-in axis focus modes select the painted mark under the pointer before grouping or snapping, and keyed motion guides remain active through scene updates.

API-FRICTION.md

@@ -3,44 +3,44 @@
   "policy": "Exact minified and gzip output for entries that optional features must not affect. Review every change before updating.",
   "bundles": {
     "D3-scale line scene": {
-      "bytes": 43460,
-      "gzip": 16624
+      "bytes": 43679,
+      "gzip": 16692
     },
     "D3-scale line + static SVG": {
-      "bytes": 47882,
-      "gzip": 18219
+      "bytes": 48140,
+      "gzip": 18322
     },
     "Representative marks": {
-      "bytes": 64027,
-      "gzip": 23441
+      "bytes": 64215,
+      "gzip": 23509
     },
     "TanStack DOM host": {
-      "bytes": 52638,
-      "gzip": 18983
+      "bytes": 61658,
+      "gzip": 21742
     },
     "React adapter": {
-      "bytes": 54837,
-      "gzip": 19813
+      "bytes": 63858,
+      "gzip": 22527
     },
     "React line consumer": {
-      "bytes": 77572,
-      "gzip": 28813
+      "bytes": 86604,
+      "gzip": 31511
     },
     "Compact-scale line scene": {
-      "bytes": 25919,
-      "gzip": 9529
+      "bytes": 26139,
+      "gzip": 9605
     },
     "React compact-scale line consumer": {
-      "bytes": 60079,
-      "gzip": 21717
+      "bytes": 69102,
+      "gzip": 24527
     },
     "Custom-scale line scene": {
-      "bytes": 24103,
-      "gzip": 8801
+      "bytes": 24323,
+      "gzip": 8875
     },
     "D3 linear-scale line scene": {
-      "bytes": 43392,
-      "gzip": 16588
+      "bytes": 43611,
+      "gzip": 16655
     }
   }
 }

benchmarks/bundle-size/universal-baseline.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 3,
-  "generatedAt": "2026-08-05T17:26:11.302Z",
+  "generatedAt": "2026-08-05T18:27:54.234Z",
   "packageVersions": {
     "tanstack": "0.6.5",
     "chartjs": "4.5.1",
@@ -11,7 +11,7 @@
   "sources": {
     "tanstack": {
       "kind": "workspace",
-      "revision": "2688b431ae10fe42a9132a2e1f7c88d58cb0cd28"
+      "revision": "b261d4575b37e1fe7d50183434c1d976205af378"
     },
     "chartjs": {
       "kind": "package",
@@ -44,88 +44,88 @@
   },
   "bundles": {
     "tanstack-line-basic": {
-      "minifiedBytes": 86395,
-      "gzipBytes": 32291,
-      "brotliBytes": 28544,
-      "incrementalGzipBytes": 32291,
-      "incrementalBrotliBytes": 28544
+      "minifiedBytes": 95427,
+      "gzipBytes": 34986,
+      "brotliBytes": 30971,
+      "incrementalGzipBytes": 34986,
+      "incrementalBrotliBytes": 30971
     },
     "tanstack-line-interactive": {
-      "minifiedBytes": 91597,
-      "gzipBytes": 33900,
-      "brotliBytes": 29976,
-      "incrementalGzipBytes": 33900,
-      "incrementalBrotliBytes": 29976
+      "minifiedBytes": 100629,
+      "gzipBytes": 36602,
+      "brotliBytes": 32368,
+      "incrementalGzipBytes": 36602,
+      "incrementalBrotliBytes": 32368
     },
     "tanstack-line-advanced": {
-      "minifiedBytes": 98780,
-      "gzipBytes": 36151,
-      "brotliBytes": 31926,
-      "incrementalGzipBytes": 36151,
-      "incrementalBrotliBytes": 31926
+      "minifiedBytes": 107817,
+      "gzipBytes": 38978,
+      "brotliBytes": 34363,
+      "incrementalGzipBytes": 38978,
+      "incrementalBrotliBytes": 34363
     },
     "tanstack-bar-basic": {
-      "minifiedBytes": 93405,
-      "gzipBytes": 34862,
-      "brotliBytes": 30778,
-      "incrementalGzipBytes": 34862,
-      "incrementalBrotliBytes": 30778
+      "minifiedBytes": 102438,
+      "gzipBytes": 37627,
+      "brotliBytes": 33228,
+      "incrementalGzipBytes": 37627,
+      "incrementalBrotliBytes": 33228
     },
     "tanstack-bar-interactive": {
-      "minifiedBytes": 97462,
-      "gzipBytes": 36077,
-      "brotliBytes": 31824,
-      "incrementalGzipBytes": 36077,
-      "incrementalBrotliBytes": 31824
+      "minifiedBytes": 106495,
+      "gzipBytes": 38864,
+      "brotliBytes": 34253,
+      "incrementalGzipBytes": 38864,
+      "incrementalBrotliBytes": 34253
     },
     "tanstack-bar-advanced": {
-      "minifiedBytes": 97801,
-      "gzipBytes": 36224,
-      "brotliBytes": 31969,
-      "incrementalGzipBytes": 36224,
-      "incrementalBrotliBytes": 31969
+      "minifiedBytes": 106834,
+      "gzipBytes": 39006,
+      "brotliBytes": 34349,
+      "incrementalGzipBytes": 39006,
+      "incrementalBrotliBytes": 34349
     },
     "tanstack-area-basic": {
-      "minifiedBytes": 90206,
-      "gzipBytes": 33673,
-      "brotliBytes": 29886,
-      "incrementalGzipBytes": 33673,
-      "incrementalBrotliBytes": 29886
+      "minifiedBytes": 99241,
+      "gzipBytes": 36475,
+      "brotliBytes": 32283,
+      "incrementalGzipBytes": 36475,
+      "incrementalBrotliBytes": 32283
     },
     "tanstack-area-interactive": {
-      "minifiedBytes": 95412,
-      "gzipBytes": 35303,
-      "brotliBytes": 31191,
-      "incrementalGzipBytes": 35303,
-      "incrementalBrotliBytes": 31191
+      "minifiedBytes": 104447,
+      "gzipBytes": 38120,
+      "brotliBytes": 33634,
+      "incrementalGzipBytes": 38120,
+      "incrementalBrotliBytes": 33634
     },
     "tanstack-area-advanced": {
-      "minifiedBytes": 102780,
-      "gzipBytes": 37708,
-      "brotliBytes": 33313,
-      "incrementalGzipBytes": 37708,
-      "incrementalBrotliBytes": 33313
+      "minifiedBytes": 111816,
+      "gzipBytes": 40510,
+      "brotliBytes": 35667,
+      "incrementalGzipBytes": 40510,
+      "incrementalBrotliBytes": 35667
     },
     "tanstack-scatter-basic": {
-      "minifiedBytes": 86057,
-      "gzipBytes": 32196,
-      "brotliBytes": 28492,
-      "incrementalGzipBytes": 32196,
-      "incrementalBrotliBytes": 28492
+      "minifiedBytes": 95089,
+      "gzipBytes": 34851,
+      "brotliBytes": 30881,
+      "incrementalGzipBytes": 34851,
+      "incrementalBrotliBytes": 30881
     },
     "tanstack-scatter-interactive": {
-      "minifiedBytes": 91259,
-      "gzipBytes": 33790,
-      "brotliBytes": 29828,
-      "incrementalGzipBytes": 33790,
-      "incrementalBrotliBytes": 29828
+      "minifiedBytes": 100291,
+      "gzipBytes": 36504,
+      "brotliBytes": 32243,
+      "incrementalGzipBytes": 36504,
+      "incrementalBrotliBytes": 32243
     },
     "tanstack-scatter-advanced": {
-      "minifiedBytes": 91275,
-      "gzipBytes": 33795,
-      "brotliBytes": 29824,
-      "incrementalGzipBytes": 33795,
-      "incrementalBrotliBytes": 29824
+      "minifiedBytes": 100307,
+      "gzipBytes": 36510,
+      "brotliBytes": 32281,
+      "incrementalGzipBytes": 36510,
+      "incrementalBrotliBytes": 32281
     },
     "chartjs-line-basic": {
       "minifiedBytes": 137909,

benchmarks/comparison/bundle-baseline.json

@@ -251,7 +251,7 @@ comparison.
 
 ## Current scope
 
-The executable corpus contains 109 paired cases: 75 sourced from Observable
+The executable corpus contains 110 paired cases: 76 sourced from Observable
 Plot, 23 from Recharts, and 11 from Apache ECharts. It spans the common
 cartesian vocabulary plus the high-value catalog beyond it:
 
@@ -289,7 +289,7 @@ pointer, native horizontal resource scrolling, streaming-window preservation,
 synchronized multi-view cursors, a free two-dimensional cursor, continuous
 brush selection, wheel zoom and pan, timeline scrubbing, and editable event
 ranges. Focus-plus-context uses Plot as its reference. Together with the
-original tooltip cases, 16 cases carry executable interaction scenarios.
+original tooltip cases, 19 cases carry executable interaction scenarios.
 
 All declared interaction scenarios and the prior 79-case full-corpus visual
 matrix pass across both renderers, initial/revised data, 320/640/960 px, and

benchmarks/conformance/README.md

@@ -70,7 +70,7 @@
     "url": "https://motion.dev/docs/animate"
   },
   "ai": {
-    "create": "Create a grouped line chart where the primary datum, its shared-x group, the focused series, unmatched marks, and an external crosshair with axis labels all animate distinctly.",
+    "create": "Create a grouped line chart where the primary datum, its shared-x group, the focused series, unmatched marks, and a renderer-native crosshair with axis labels all animate distinctly.",
     "maintain": "Keep focus semantics in mark states, preserve spring velocity and label alignment during rapid pointer retargeting, and support the same focus movement from the keyboard."
   }
 }