basalt-ui 1.8.0 → 1.9.0

package/dist/charts/primitives/Axes.js

@@ -52,7 +52,8 @@ function AxisRightNumeric({
 function AxisBottomDate({
   scale,
   top,
-  tickValues
+  tickValues,
+  tickFormat = fmtAxisDate
 }) {
   return /* @__PURE__ */ jsx(
     AxisBottom,
@@ -60,7 +61,7 @@ function AxisBottomDate({
       top,
       scale,
       tickValues,
-      tickFormat: fmtAxisDate,
+      tickFormat,
       tickLabelProps: {
         fill: VX.faint,
         fontFamily: TICK_FONT_FAMILY,

package/dist/charts/primitives/ChartFrame.d.ts

@@ -28,6 +28,13 @@ export type ChartFrameProps = {
     chartId?: string;
     /** `false` only for the sparkline exemption — every other chart gets a legend by default. */
     legend?: ChartFrameLegend | false;
+    /**
+     * The query behind this chart hasn't resolved yet. Renders `ChartPending` (see its JSDoc for the
+     * three-state "nothing to draw" rationale) over the full plot rect in place of `children`,
+     * suppresses the legend entirely (a legend naming a series with nothing yet to point at is its
+     * own small lie), and marks the outer container `aria-busy="true"`.
+     */
+    isPending?: boolean;
     /**
      * Accessible text alternative for the chart, applied as `aria-label` (+ `role="img"`) on the
      * outer container so screen readers announce something other than an unlabeled graphic. Every
@@ -66,5 +73,5 @@ export declare function resolveLegend(config: ChartLegendConfig | false | undefi
  * Layout-only: it does not know lines from bars (that stays in the kind), so it is not a
  * Recharts god-component. Render the child only when the resolved plot rect is non-empty.
  */
-export declare function ChartFrame({ series, height, aspectRatio, fill, minWidth, chartId, legend, ariaLabel, children, }: ChartFrameProps): ReactNode;
+export declare function ChartFrame({ series, height, aspectRatio, fill, minWidth, chartId, legend, ariaLabel, isPending, children, }: ChartFrameProps): ReactNode;
 //# sourceMappingURL=ChartFrame.d.ts.map

package/dist/charts/primitives/ChartFrame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartFrame.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAMhF;0EAC0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,uGAAuG;IACvG,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAA;IACjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAA;CACjE,CAAA;AAcD;oFACoF;AACpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC1C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,EAC7C,KAAK,CAAC,EAAE,qBAAqB,GAC5B,gBAAgB,GAAG,KAAK,CAQ1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,WAAW,EACX,IAAY,EACZ,QAA4B,EAC5B,OAAO,EACP,MAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,GAAG,SAAS,CA+C7B"}
+{"version":3,"file":"ChartFrame.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAOhF;0EAC0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,uGAAuG;IACvG,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAA;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAA;CACjE,CAAA;AAcD;oFACoF;AACpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC1C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,EAC7C,KAAK,CAAC,EAAE,qBAAqB,GAC5B,gBAAgB,GAAG,KAAK,CAQ1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,WAAW,EACX,IAAY,EACZ,QAA4B,EAC5B,OAAO,EACP,MAAW,EACX,SAAS,EACT,SAAiB,EACjB,QAAQ,GACT,EAAE,eAAe,GAAG,SAAS,CAmD7B"}

package/dist/charts/primitives/ChartFrame.js

@@ -2,6 +2,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useChartSize } from "../hooks/useChartSize.js";
 import { deriveLegend } from "../series.js";
 import { ChartLegend } from "./ChartLegend.js";
+import { ChartPending } from "./ChartPending.js";
 const DEFAULT_HEIGHT = 240;
 const DEFAULT_MIN_WIDTH = 200;
 const outerStyle = (fill, vertical) => ({
@@ -32,20 +33,22 @@ function ChartFrame({
   chartId,
   legend = {},
   ariaLabel,
+  isPending = false,
   children
 }) {
   const { ref: containerRef, width: containerW, height: containerH } = useChartSize();
   const { ref: legendRef, width: legendW, height: legendH } = useChartSize();
   const placement = legend === false ? "bottom" : legend.placement ?? "bottom";
   const vertical = placement === "left" || placement === "right";
+  const legendVisible = legend !== false && !isPending;
   const resolvedHeight = fill ? containerH : aspectRatio !== void 0 ? Math.round(containerW / aspectRatio) : height ?? DEFAULT_HEIGHT;
-  const sideLegendWidth = legend !== false && vertical ? legendW : 0;
-  const topBottomLegendHeight = legend !== false && !vertical ? legendH : 0;
+  const sideLegendWidth = legendVisible && vertical ? legendW : 0;
+  const topBottomLegendHeight = legendVisible && !vertical ? legendH : 0;
   const plot = {
     width: Math.max(containerW - sideLegendWidth, minWidth),
     height: resolvedHeight - topBottomLegendHeight
   };
-  const legendNode = legend === false ? null : /* @__PURE__ */ jsx("div", { ref: legendRef, style: legendWrapperStyle(vertical), children: /* @__PURE__ */ jsx(
+  const legendNode = legend === false || isPending ? null : /* @__PURE__ */ jsx("div", { ref: legendRef, style: legendWrapperStyle(vertical), children: /* @__PURE__ */ jsx(
     ChartLegend,
     {
       items: deriveLegend(series),
@@ -63,9 +66,10 @@ function ChartFrame({
       ref: containerRef,
       style: outerStyle(fill, vertical),
       ...ariaLabel !== void 0 && { role: "img", "aria-label": ariaLabel },
+      ...isPending && { "aria-busy": "true" },
       children: [
         legendNode !== null && (placement === "top" || placement === "left") && legendNode,
-        plot.width > 0 && plot.height > 0 ? children(plot) : null,
+        plot.width > 0 && plot.height > 0 && (isPending ? /* @__PURE__ */ jsx(ChartPending, { width: plot.width, height: plot.height }) : children(plot)),
         legendNode !== null && (placement === "bottom" || placement === "right") && legendNode
       ]
     }

package/dist/charts/primitives/ChartPending.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+export type ChartCenterProps = {
+    width: number;
+    height: number;
+    children: ReactNode;
+};
+/**
+ * Minimal layout primitive: centers `children` inside a `width` × `height` box. Exists because
+ * `src/charts/**` cannot import Mantine's `Flex`/`Group`/`Center` (the Mantine-free boundary), so
+ * there was previously nothing to reach for when a chart file needed to center something. Not a
+ * general layout system — width, height, children, nothing else.
+ */
+export declare function ChartCenter({ width, height, children }: ChartCenterProps): ReactNode;
+export type ChartPendingProps = {
+    width: number;
+    height: number;
+    /** Default `'Loading…'`. */
+    label?: string;
+};
+/**
+ * The placeholder for a chart whose data hasn't arrived yet — the third "nothing to draw" state
+ * alongside measured-and-empty and measured-and-absent (a real gap in coverage). Collapsing an
+ * in-flight query into either of those (the `data ?? []` idiom) densifies it into a fully-hatched
+ * "not measured" window: a positive claim that the series WAS watched and carried nothing, when in
+ * fact it was never asked. `ChartPending` makes "not asked yet" its own rendered state instead of
+ * borrowing one of the other two.
+ *
+ * Reserves exactly the plot's footprint and draws NOTHING that could be mistaken for a
+ * measurement — no axes, no gridlines, no hatching, no data marks — just a faint, static, centered
+ * label. No animation: the package's motion doctrine bans looping/pulsing idle motion, so a static
+ * reserved box is the correct answer here, not a compromise.
+ */
+export declare function ChartPending({ width, height, label }: ChartPendingProps): ReactNode;
+//# sourceMappingURL=ChartPending.d.ts.map

package/dist/charts/primitives/ChartPending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartPending.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartPending.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAUD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAEpF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAkB,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAMhG"}

package/dist/charts/primitives/ChartPending.js

@@ -0,0 +1,23 @@
+import { jsx } from "react/jsx-runtime";
+import { VX } from "../../tokens/index.js";
+const centerStyle = (width, height) => ({
+  width,
+  height,
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center"
+});
+function ChartCenter({ width, height, children }) {
+  return /* @__PURE__ */ jsx("div", { style: centerStyle(width, height), children });
+}
+const labelStyle = {
+  color: VX.faint,
+  fontSize: VX.text.sm
+};
+function ChartPending({ width, height, label = "Loading\u2026" }) {
+  return /* @__PURE__ */ jsx(ChartCenter, { width, height, children: /* @__PURE__ */ jsx("span", { style: labelStyle, children: label }) });
+}
+export {
+  ChartCenter,
+  ChartPending
+};

package/dist/charts/primitives/ChartTooltip.d.ts

@@ -1,7 +1,10 @@
 import type { CSSProperties, ReactNode, RefObject } from 'react';
 /** Theme-aware tooltip container styles — use with useChartTooltip(). */
 export declare function useTooltipStyles(): CSSProperties;
-/** Outer tooltip shell. Renders nothing when tip is null. */
+/**
+ * Outer tooltip shell. Renders nothing when tip is null. Renders to `document.body` via a
+ * portal, so it may be authored anywhere in the tree, including inside `<svg>`.
+ */
 export declare function ChartTooltip({ tip, tooltipRef, styles, children, }: {
     tip: {
         x: number;
@@ -10,7 +13,7 @@ export declare function ChartTooltip({ tip, tooltipRef, styles, children, }: {
     tooltipRef?: RefObject<HTMLDivElement | null>;
     styles: CSSProperties;
     children: ReactNode;
-}): import("react").JSX.Element | null;
+}): import("react").ReactPortal | null;
 /** Tooltip header — shows formatted date + optional right-aligned label with color. */
 export declare function TooltipHeader({ date, label, labelColor, }: {
     date: string;

package/dist/charts/primitives/ChartTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartTooltip.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAqBhE,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE;IACD,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpC,UAAU,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC7C,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;CACpB,sCAOA;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,UAAU,GACX,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,+BAoCA;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,GACP,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,+BA0CA;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEhE"}
+{"version":3,"file":"ChartTooltip.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAsBhE,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE;IACD,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpC,UAAU,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC7C,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;CACpB,sCAeA;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,UAAU,GACX,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,+BAoCA;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,GACP,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,+BA0CA;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEhE"}

package/dist/charts/primitives/ChartTooltip.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { createPortal } from "react-dom";
 import { VX } from "../../tokens/index.js";
 import { fmtTooltipDate } from "../utils/format.js";
 const TOOLTIP_STYLES = {
@@ -24,7 +25,11 @@ function ChartTooltip({
   children
 }) {
   if (!tip) return null;
-  return /* @__PURE__ */ jsx("div", { ref: tooltipRef, style: { ...styles, left: tip.x, top: tip.y }, children });
+  if (typeof document === "undefined") return null;
+  return createPortal(
+    /* @__PURE__ */ jsx("div", { ref: tooltipRef, style: { ...styles, left: tip.x, top: tip.y }, children }),
+    document.body
+  );
 }
 function TooltipHeader({
   date,

package/dist/charts/primitives/HoverOverlay.d.ts

@@ -1,9 +1,10 @@
-import type { MouseEventHandler } from 'react';
-/** Transparent <rect> that captures mouse events for tooltip + crosshair sync. */
+import type { PointerEventHandler } from 'react';
+/** Transparent <rect> that captures pointer events (mouse + touch + pen) for tooltip + crosshair
+ * sync. */
 export declare function HoverOverlay({ width, height, onMove, onLeave, }: {
     width: number;
     height: number;
-    onMove: MouseEventHandler<SVGRectElement>;
-    onLeave: MouseEventHandler<SVGRectElement>;
+    onMove: PointerEventHandler<SVGRectElement>;
+    onLeave: PointerEventHandler<SVGRectElement>;
 }): import("react").JSX.Element;
 //# sourceMappingURL=HoverOverlay.d.ts.map

package/dist/charts/primitives/HoverOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoverOverlay.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/HoverOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAE9C,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAA;CAC3C,+BAUA"}
+{"version":3,"file":"HoverOverlay.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/HoverOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAEhD;WACW;AACX,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAA;IAC3C,OAAO,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAA;CAC7C,+BAeA"}

package/dist/charts/primitives/HoverOverlay.js

@@ -11,8 +11,10 @@ function HoverOverlay({
       width,
       height,
       fill: "transparent",
-      onMouseMove: onMove,
-      onMouseLeave: onLeave
+      style: { touchAction: "pan-y" },
+      onPointerMove: onMove,
+      onPointerLeave: onLeave,
+      onPointerCancel: onLeave
     }
   );
 }

package/dist/cli/index.d.ts

@@ -205,8 +205,29 @@ type PeerFlags = {
     hasRouter: boolean;
     hasQuery: boolean;
 };
+/**
+ * Where the seed engine is running relative to the consumer's git repo — decides which
+ * repo-root-shaped seeds are safe to write. `init`/`sync` compute it once per run via
+ * `resolvePlacement` and print the matching skip notices themselves; `managedFiles` only reads it.
+ */
+type PlacementFlags = {
+    /** True when the package directory IS the detected repo root, or no `.git` exists anywhere above
+     *  it (a consumer not using git keeps today's behaviour exactly). False means the package lives
+     *  in a subdirectory of the repo (a monorepo's `web/`, say) — lefthook and GitHub Actions both
+     *  only read config at the repo root, so seeding either one there is worse than not seeding at
+     *  all. */
+    isPackageRepoRoot: boolean;
+    /** Absolute path of the detected repo root. Meaningful only when `isPackageRepoRoot` is false —
+     *  otherwise it equals the package dir and is never read. */
+    repoRoot: string;
+    /** Absolute path of a `query-client.ts` already present elsewhere under the package's `src/` (the
+     *  consumer relocated it — e.g. to `src/lib/query-client.ts`), or null. The seed's OWN
+     *  destination is deliberately excluded here — that exact-path case is handled by the ordinary
+     *  skip-if-exists logic every seed file already goes through, unchanged. */
+    relocatedQueryClient: string | null;
+};
 /** The full managed-file manifest. Stable, declarative — the single source of truth for init/sync. */
-declare function managedFiles(peers: PeerFlags): ManagedFile[];
+declare function managedFiles(peers: PeerFlags, placement?: PlacementFlags): ManagedFile[];
 type Manifest = {
     version: 1;
     /** The basalt-ui version that last wrote this manifest — `doctor`'s one reconciliation axis. */

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -285,7 +285,59 @@ function resolvePeerFlags(cwd, flags) {
     hasQuery: flags.withQuery === true || hasDependency(cwd, "@tanstack/react-query")
   };
 }
-function managedFiles(peers) {
+const ROOT_PLACEMENT = {
+  isPackageRepoRoot: true,
+  repoRoot: "",
+  relocatedQueryClient: null
+};
+function findRepoRoot(dir) {
+  let current = dir;
+  for (; ; ) {
+    if (existsSync(resolve(current, ".git"))) return current;
+    const parent = dirname(current);
+    if (parent === current) return dir;
+    current = parent;
+  }
+}
+function findFileNamed(dir, filename) {
+  let entries;
+  try {
+    entries = readdirSync(dir);
+  } catch {
+    return null;
+  }
+  for (const name of entries) {
+    if (name === "node_modules" || name === ".git" || name === "dist") continue;
+    const abs = resolve(dir, name);
+    let isDir;
+    try {
+      isDir = statSync(abs).isDirectory();
+    } catch {
+      continue;
+    }
+    if (isDir) {
+      const found = findFileNamed(abs, filename);
+      if (found !== null) return found;
+    } else if (name === filename) {
+      return abs;
+    }
+  }
+  return null;
+}
+function findRelocatedQueryClient(cwd) {
+  const seedAbs = resolve(cwd, "src/query-client.ts");
+  const found = findFileNamed(resolve(cwd, "src"), "query-client.ts");
+  return found !== null && found !== seedAbs ? found : null;
+}
+function resolvePlacement(cwd) {
+  const repoRoot = findRepoRoot(cwd);
+  return {
+    isPackageRepoRoot: repoRoot === cwd,
+    repoRoot,
+    relocatedQueryClient: findRelocatedQueryClient(cwd)
+  };
+}
+function managedFiles(peers, placement = ROOT_PLACEMENT) {
   const rules = RULE_NAMES.map((name) => ({
     dest: `.claude/rules/basalt-${name}.md`,
     mode: "managed",
@@ -370,9 +422,10 @@ function managedFiles(peers) {
     }
   };
   const scaffolds = [];
-  if (peers.hasQuery) scaffolds.push(queryClient);
+  if (peers.hasQuery && placement.relocatedQueryClient === null) scaffolds.push(queryClient);
   if (peers.hasRouter && peers.hasQuery) scaffolds.push(rootRoute);
-  return [...rules, ...skills, claudeBlock, design, oxfmt, lefthook, ci, oxlintrc, ...scaffolds];
+  const rootTooling = placement.isPackageRepoRoot ? [lefthook, ci] : [];
+  return [...rules, ...skills, claudeBlock, design, oxfmt, ...rootTooling, oxlintrc, ...scaffolds];
 }
 function readManifest(cwd) {
   const raw = readIfExists(resolve(cwd, MANIFEST_PATH));
@@ -462,7 +515,8 @@ function init(cwd = process.cwd(), scaffoldFlags = {}) {
   const manifest = readManifest(cwd);
   migrateLegacyOxfmt(cwd, ctx.pkgRoot, manifest);
   const peers = resolvePeerFlags(cwd, scaffoldFlags);
-  const files = managedFiles(peers);
+  const placement = resolvePlacement(cwd);
+  const files = managedFiles(peers, placement);
   let written = 0;
   let skipped = 0;
   const missingSources = [];
@@ -492,6 +546,19 @@ function init(cwd = process.cwd(), scaffoldFlags = {}) {
       `basalt-ui init: ${missingSources.length} shipped asset(s) not present, skipped: ${missingSources.join(", ")}`
     );
   }
+  if (!placement.isPackageRepoRoot) {
+    console.log(
+      `basalt-ui init: skipped lefthook.yml (this package is not the repo root \u2014 repo root detected at ${placement.repoRoot}) \u2014 lefthook only reads config at the repo root; extend node_modules/basalt-ui/configs/lefthook.yml from your root lefthook.yml instead.`
+    );
+    console.log(
+      `basalt-ui init: skipped .github/workflows/check.yml (this package is not the repo root \u2014 repo root detected at ${placement.repoRoot}) \u2014 GitHub Actions only reads .github/ at the repo root; extend node_modules/basalt-ui/configs/check.yml from your root CI workflow instead.`
+    );
+  }
+  if (placement.relocatedQueryClient !== null) {
+    console.log(
+      `basalt-ui init: skipped src/query-client.ts (found an existing query client at ${relative(cwd, placement.relocatedQueryClient)}) \u2014 import it from there instead of re-seeding at the original path.`
+    );
+  }
   if (!peers.hasQuery) {
     console.log(
       "basalt-ui init: skipped src/query-client.ts (no @tanstack/react-query dependency detected) \u2014 install it, or re-run with --with-query, to scaffold it."
@@ -524,7 +591,8 @@ function sync(opts = {}, cwd = process.cwd()) {
   const manifest = readManifest(cwd);
   if (!opts.check) migrateLegacyOxfmt(cwd, ctx.pkgRoot, manifest);
   const peers = resolvePeerFlags(cwd, {});
-  const files = managedFiles(peers);
+  const placement = resolvePlacement(cwd);
+  const files = managedFiles(peers, placement);
   let updated = 0;
   let recreated = 0;
   let skippedDrift = 0;
@@ -561,6 +629,19 @@ function sync(opts = {}, cwd = process.cwd()) {
     if (kind === "missing") recreated++;
     else updated++;
   }
+  if (!placement.isPackageRepoRoot) {
+    console.log(
+      `basalt-ui sync: skipped lefthook.yml (this package is not the repo root \u2014 repo root detected at ${placement.repoRoot}) \u2014 lefthook only reads config at the repo root; extend node_modules/basalt-ui/configs/lefthook.yml from your root lefthook.yml instead.`
+    );
+    console.log(
+      `basalt-ui sync: skipped .github/workflows/check.yml (this package is not the repo root \u2014 repo root detected at ${placement.repoRoot}) \u2014 GitHub Actions only reads .github/ at the repo root; extend node_modules/basalt-ui/configs/check.yml from your root CI workflow instead.`
+    );
+  }
+  if (placement.relocatedQueryClient !== null) {
+    console.log(
+      `basalt-ui sync: skipped src/query-client.ts (found an existing query client at ${relative(cwd, placement.relocatedQueryClient)}) \u2014 import it from there instead of re-seeding at the original path.`
+    );
+  }
   if (opts.check) {
     if (driftLines.length > 0) {
       console.error("basalt-ui sync --check: locally-drifted managed files:");

package/dist/dashboard/stat-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stat-card.d.ts","sourceRoot":"","sources":["../../src/dashboard/stat-card.tsx"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,sGAAsG;AACtG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAYlD,MAAM,MAAM,aAAa,GAAG;IAC1B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;kGAC8F;IAC9F,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;+EAG2E;IAC3E,IAAI,CAAC,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,IAAI,EACJ,IAAI,GACL,EAAE,aAAa,+BAyFf"}
+{"version":3,"file":"stat-card.d.ts","sourceRoot":"","sources":["../../src/dashboard/stat-card.tsx"],"names":[],"mappings":"AAsDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,sGAAsG;AACtG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAYlD,MAAM,MAAM,aAAa,GAAG;IAC1B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;kGAC8F;IAC9F,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;+EAG2E;IAC3E,IAAI,CAAC,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,IAAI,EACJ,IAAI,GACL,EAAE,aAAa,+BAyFf"}

package/dist/guard/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;AAoP9D,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,EAAE,WAoBlC,CAAA;AAuTD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;gCA0BL,WAAW;;;;;;;gCAcX,WAAW;;;;;gCAMX,WAAW;;;;;;;gCAaX,WAAW;;;;;;;gCAQX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCASX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCASX,WAAW;;;;;;gCAMX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCAUX,WAAW;;;;CAOmB,CAAA;AAUjD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,EAAE,CA2PtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;AAoP9D,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,EAAE,WAoBlC,CAAA;AA0TD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;gCA0BL,WAAW;;;;;;;gCAcX,WAAW;;;;;gCAMX,WAAW;;;;;;;gCAaX,WAAW;;;;;;;gCAQX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCASX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCAaX,WAAW;;;;;;gCAMX,WAAW;;;;;;;gCAaX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCAUX,WAAW;;;;CAOmB,CAAA;AAUjD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,EAAE,CA2PtF"}

package/dist/guard/index.js

@@ -78,7 +78,7 @@ const DEFAULT_GUARD_CONFIG = {
   severity: {}
 };
 const GRACE_PERIOD_KINDS = {
-  "mantine-shade-index": "introduced 1.7.0 \u2014 promote to error in 1.9.0"
+  "mantine-shade-index": "introduced 1.7.0 \u2014 promote to error in 1.10.0"
 };
 function severityOf(kind, cfg) {
   return cfg.severity?.[kind] ?? (kind in GRACE_PERIOD_KINDS ? "warn" : "error");
@@ -339,8 +339,12 @@ const GUARD_RULES = {
     pattern: RAW_HTML_TAG,
     // handled inline (3-condition conjunction); entry keeps registry complete
     enabled: (cfg) => cfg.rawHtmlLayout,
-    // JSX-tag-shaped (`<div style={{...}}>`) — never appears in CSS text.
-    appliesTo: (relPath) => !relPath.endsWith(".css"),
+    // JSX-tag-shaped (`<div style={{...}}>`) — never appears in CSS text. Also excluded from
+    // chart files: the remedy (Box/Flex/Grid/Stack/Group) is `@mantine/*`, and src/charts/** is a
+    // lint-enforced Mantine-free layer (basalt/token-layer-boundary) — so inside a chart file the
+    // finding is unactionable, not merely inconvenient, and the only "fix" would be a theme-allow
+    // comment written inside the very directory this rule protects.
+    appliesTo: (relPath) => !isChartFile(relPath) && !relPath.endsWith(".css"),
     message: "Raw HTML element with inline layout/surface styling \u2014 use a Mantine layout primitive (Box/Flex/Grid/Stack/Group)."
   },
   "inline-spacing": {
@@ -354,8 +358,12 @@ const GUARD_RULES = {
     pattern: INLINE_DISPLAY,
     enabled: (cfg) => cfg.inlineDisplay,
     // JSX-object-shaped (`display: 'flex'`, quoted value) — CSS never quotes a keyword value
-    // (`display: flex;` is bare), so the pattern's quote anchor can never match real CSS.
-    appliesTo: (relPath) => !relPath.endsWith(".css"),
+    // (`display: flex;` is bare), so the pattern's quote anchor can never match real CSS. Also
+    // excluded from chart files: the remedy (Flex/Grid/Group) is `@mantine/*`, and src/charts/**
+    // is a lint-enforced Mantine-free layer (basalt/token-layer-boundary) — so inside a chart file
+    // the finding is unactionable, not merely inconvenient, and the only "fix" would be a
+    // theme-allow comment written inside the very directory this rule protects.
+    appliesTo: (relPath) => !isChartFile(relPath) && !relPath.endsWith(".css"),
     message: "Use <Flex>/<Grid>/<Group> instead of an inline display:flex/grid."
   },
   "raw-visx-axis": {

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.8.0
+# basalt-ui v1.9.0
 # Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets
 #
 # basalt-ui is an opinionated framework for Mantine-based React apps.
@@ -19,7 +19,7 @@
 # ./tokens.css subpath. Guide: docs/FRAMEWORK-FREE.md in the repo.
 
 Package: basalt-ui
-Version: 1.8.0
+Version: 1.9.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets",
   "keywords": [
     "charts",
@@ -342,12 +342,10 @@
         "primitives"
       ],
       "inline-display": [
-        "agent",
-        "primitives"
+        "agent"
       ],
       "raw-html-layout": [
-        "agent",
-        "primitives"
+        "agent"
       ]
     }
   }

package/src/charts/hooks/useHoverSync.ts

@@ -24,12 +24,29 @@ export function useHoverSync<T>({
   getKey,
   xScale,
   marginLeft,
+  resolveKey,
 }: {
   data: T[]
   chartId: string
   getKey: (d: T) => string
   xScale: XScale
   marginLeft: number
+  /**
+   * Overrides how a SIBLING's broadcast key resolves to one of THIS chart's own points. Only
+   * affects reading another chart's hover — this chart's own hover (via `getKey`/`xScale`) is
+   * untouched.
+   *
+   * Cross-chart sync is exact string match by default (`pointByKey.get(ctx.key)`), so two charts
+   * share a cursor only if they emit identical key strings. A chart that downsamples/folds its
+   * domain to fit a narrow viewport (e.g. ~288 buckets folded into ~97 columns at 390px) no longer
+   * owns most of the keys its unfolded siblings broadcast — the shared crosshair then appears on
+   * roughly one hover in three, with no rule a reader can infer, which is worse than no shared
+   * cursor at all. Pass `resolveKey` to map a foreign key onto whichever of this chart's own points
+   * swallowed it (e.g. the folded bucket the key falls into).
+   *
+   * Omit it and behaviour is byte-identical to today.
+   */
+  resolveKey?: (key: string) => T | null
 }) {
   const ctx = useContext(HoverContext)
   // Latest context in a ref so the mouse callbacks stay referentially stable: the provider's value
@@ -53,13 +70,26 @@ export function useHoverSync<T>({
 
   const { tip, show, hide, tooltipRef, lastDateRef } = useChartTooltip<T>()
 
+  // Latest accessors in refs, same reasoning as `ctxRef` above: the natural call style is an
+  // inline arrow for `getKey`/`xScale`, which is fresh on every render, and this file already
+  // pays for that hazard once (see the comment above `ctxRef`) without applying the fix here — a
+  // several-hundred-entry `pointByKey` Map was rebuilding on every render of a page that
+  // re-renders on a heartbeat. Trade-off: because `getKey` is read through a ref, changing key
+  // SEMANTICS without changing `data` will NOT rebuild the map. That's the intended trade — a
+  // `getKey` that changes meaning for the same data is pathological; a `getKey` that changes
+  // identity every render is the normal case.
+  const getKeyRef = useRef(getKey)
+  getKeyRef.current = getKey
+  const xScaleRef = useRef(xScale)
+  xScaleRef.current = xScale
+
   // O(1) lookup of a point by its key. Under a provider every sibling resolves the broadcast
   // key each frame; an O(n) `data.find` per sibling per move is N×O(M). This makes it N×O(1).
   const pointByKey = useMemo(() => {
     const m = new Map<string, T>()
-    for (const d of data) m.set(getKey(d), d)
+    for (const d of data) m.set(getKeyRef.current(d), d)
     return m
-  }, [data, getKey])
+  }, [data])
 
   const handleMouse = useCallback(
     (event: React.MouseEvent<SVGRectElement>) => {
@@ -69,7 +99,7 @@ export function useHoverSync<T>({
       let closest: T = data[0] as T
       let minDist = Infinity
       for (const d of data) {
-        const sx = xScale(getKey(d)) ?? 0
+        const sx = xScaleRef.current(getKeyRef.current(d)) ?? 0
         const dist = Math.abs(sx - px)
         if (dist < minDist) {
           minDist = dist
@@ -77,13 +107,13 @@ export function useHoverSync<T>({
         }
       }
       show(closest, event)
-      const key = getKey(closest)
+      const key = getKeyRef.current(closest)
       if (lastDateRef.current !== key) {
         lastDateRef.current = key
         ctxRef.current.setHover(key, chartId)
       }
     },
-    [data, xScale, getKey, chartId, marginLeft, show, lastDateRef],
+    [data, chartId, marginLeft, show, lastDateRef],
   )
 
   const handleLeave = useCallback(() => {
@@ -97,8 +127,14 @@ export function useHoverSync<T>({
   // The point the crosshair + synced dots track. Inside a <ChartHoverSync> this follows the
   // broadcast key (so every sibling paints a ghost crosshair at the same x). WITHOUT a provider the
   // chart is standalone, so it falls back to THIS chart's own hovered point (`tip.data`) — otherwise
-  // a chart outside a provider would never draw a crosshair/dots at all.
-  const syncedPoint = ctx.key ? (pointByKey.get(ctx.key) ?? null) : (tip?.data ?? null)
+  // a chart outside a provider would never draw a crosshair/dots at all. When `resolveKey` is
+  // supplied it replaces the default exact-match lookup for reading a SIBLING's broadcast key (see
+  // its doc comment above) — this chart's own hover is unaffected either way.
+  const syncedPoint = ctx.key
+    ? resolveKey
+      ? resolveKey(ctx.key)
+      : (pointByKey.get(ctx.key) ?? null)
+    : (tip?.data ?? null)
   // Which chart owns the floating tooltip. Inside a provider the hovered chart is the one whose id
   // matches the broadcast source (siblings show a ghost crosshair only). Standalone, its own local
   // hover (`tip`) drives the tooltip.