basalt-ui 1.15.0 → 1.17.0

package/dist/charts/primitives/CartesianChart.js

@@ -7,7 +7,7 @@ import { VX } from "../../tokens/index.js";
 import { useChartCursor } from "../hooks/useChartCursor.js";
 import { autoMargin, probeAxisLabels } from "../layout/auto-margin.js";
 import { deriveTooltipRows } from "../series.js";
-import { padAutoLower } from "../utils/domain.js";
+import { padAutoLower, padAutoUpper } from "../utils/domain.js";
 import { fmtAxisDate } from "../utils/format.js";
 import { smartTicks, smartTicksEvery } from "../utils/ticks.js";
 import { AxisBottomDate, AxisLeftNumeric, AxisRightNumeric } from "./Axes.js";
@@ -41,8 +41,7 @@ function resolveAxisDomain(cfg, data, series, extraBounds = []) {
   if (min === Infinity) return [0, cfg?.autoMaxFloor ?? 1];
   const pad = cfg?.autoPad ?? DEFAULT_AUTO_PAD;
   const ceil = cfg?.autoMinCeil ?? 0;
-  const paddedMax = max > 0 ? max * pad : max < 0 ? max / pad : 0;
-  const upper = Math.max(paddedMax, cfg?.autoMaxFloor ?? -Infinity);
+  const upper = padAutoUpper(Math.max(max, cfg?.autoMaxFloor ?? -Infinity), pad);
   const lower = padAutoLower(Math.min(min, ceil), pad);
   if (lower === upper) return [Math.min(lower, 0), upper === 0 ? 1 : upper * pad];
   return [lower, upper];
@@ -66,6 +65,7 @@ function CartesianChart({
   tooltip,
   margin: marginOverride,
   cursorValue,
+  cursorResolution,
   ariaLabel,
   isPending,
   children
@@ -99,6 +99,7 @@ function CartesianChart({
           ...tooltip !== void 0 && { tooltip },
           ...marginOverride !== void 0 && { marginOverride },
           ...cursorValue !== void 0 && { cursorValue },
+          ...cursorResolution !== void 0 && { cursorResolution },
           ...ariaLabel !== void 0 && { ariaLabel },
           plot,
           highlighted,
@@ -123,6 +124,7 @@ function CartesianPlot({
   tooltip,
   marginOverride,
   cursorValue,
+  cursorResolution,
   ariaLabel,
   plot,
   highlighted,
@@ -154,17 +156,19 @@ function CartesianPlot({
     () => probeAxisLabels({
       domain: leftDomain,
       ticks: leftTicks,
+      nice: y?.nice ?? false,
       ...y?.format !== void 0 && { format: y.format }
     }),
-    [leftDomain, leftTicks, y?.format]
+    [leftDomain, leftTicks, y?.format, y?.nice]
   );
   const { labels: rightLabels, format: rightFormat } = useMemo(
     () => rightDomain === null ? { labels: [], format: (v) => String(v) } : probeAxisLabels({
       domain: rightDomain,
       ticks: rightTicks,
+      nice: y2?.nice ?? false,
       ...y2?.format !== void 0 && { format: y2.format }
     }),
-    [rightDomain, rightTicks, y2?.format]
+    [rightDomain, rightTicks, y2?.format, y2?.nice]
   );
   const xLabels = useMemo(() => keys.map(formatX), [keys, formatX]);
   const margin = useMemo(
@@ -183,12 +187,20 @@ function CartesianPlot({
     [keys, xMax]
   );
   const yScale = useMemo(
-    () => scaleLinear({ domain: leftDomain, range: [yMax, 0] }),
-    [leftDomain, yMax]
+    () => scaleLinear({
+      domain: leftDomain,
+      range: [yMax, 0],
+      ...y?.nice === true && { nice: true }
+    }),
+    [leftDomain, yMax, y?.nice]
   );
   const y2Scale = useMemo(
-    () => rightDomain === null ? null : scaleLinear({ domain: rightDomain, range: [yMax, 0] }),
-    [rightDomain, yMax]
+    () => rightDomain === null ? null : scaleLinear({
+      domain: rightDomain,
+      range: [yMax, 0],
+      ...y2?.nice === true && { nice: true }
+    }),
+    [rightDomain, yMax, y2?.nice]
   );
   const tickValues = useMemo(
     () => xTicks === void 0 ? smartTicks(keys, xMax) : smartTicksEvery(keys, xTicks),
@@ -199,7 +211,8 @@ function CartesianPlot({
     chartId,
     getKey: getX,
     xScale,
-    marginLeft: margin.left
+    marginLeft: margin.left,
+    ...cursorResolution !== void 0 && { resolution: cursorResolution }
   });
   const svgRef = useRef(null);
   const tooltipEnabled = tooltip !== false;
@@ -207,6 +220,7 @@ function CartesianPlot({
   const point = cursor.point;
   const cursorX = point === null ? null : xScale(getX(point)) ?? null;
   const badge = tooltipCfg?.label === void 0 || point === null ? null : tooltipCfg.label(point);
+  const formatHeader = tooltipCfg?.formatHeader;
   const tooltipSeries = useMemo(
     () => visible.map(
       (s) => s.formatValue === void 0 ? { ...s, formatValue: s.axis === "right" ? rightFormat : leftFormat } : s
@@ -321,11 +335,14 @@ function CartesianPlot({
         TooltipHeader,
         {
           date: getX(point),
+          ...formatHeader !== void 0 && {
+            format: (key) => formatHeader(key, point)
+          },
           ...badge !== null && { label: badge.text, labelColor: badge.color }
         }
       ),
       /* @__PURE__ */ jsxs(TooltipBody, { children: [
-        tooltipCfg?.prependRows?.(point),
+        tooltipCfg?.prependRows?.(point, { visible, hidden }),
         rows.map((row) => /* @__PURE__ */ jsx(
           TooltipRow,
           {
@@ -338,7 +355,7 @@ function CartesianPlot({
           },
           row.key
         )),
-        tooltipCfg?.extraRows?.(point)
+        tooltipCfg?.extraRows?.(point, { visible, hidden })
       ] })
     ] })
   ] });

package/dist/charts/primitives/CartesianChart.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CartesianChart.test.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/CartesianChart.test.ts"],"names":[],"mappings":""}
+{"version":3,"file":"CartesianChart.test.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/CartesianChart.test.tsx"],"names":[],"mappings":""}

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

@@ -43,9 +43,16 @@ export type ChartFrameProps = {
      */
     isPending?: boolean;
     /**
-     * Accessible text alternative for the chart, applied as `aria-label` (+ `role="img"`) on the
+     * Accessible text alternative for the chart, applied as `aria-label` (+ `role="group"`) on the
      * outer container so screen readers announce something other than an unlabeled graphic. Every
      * kind composing `ChartFrame` should accept and forward this from its own props.
+     *
+     * MUST stay `role="group"`, never `role="img"`. Per the ARIA spec, every descendant of an
+     * `role="img"` element is presentational, which erases the `HoverOverlay`'s `role="slider"` from
+     * the accessibility tree entirely — a screen reader announces the label and then the
+     * keyboard-scrubbable slider underneath it is simply unreachable, silently, with no error
+     * anywhere. `role="group"` announces the same label while keeping descendants exposed. Do not
+     * "simplify" this back to `img` — it looks like a no-op refactor and it is not.
      */
     ariaLabel?: string;
     /** Draw the SVG marks given the plot rect that already excludes the legend band, plus the set

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;AAIrD,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;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,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;oDACgD;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAA;CACxC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC5B,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,CAS1B;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,CAsE7B"}
+{"version":3,"file":"ChartFrame.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrD,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;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,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;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;oDACgD;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAA;CACxC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC5B,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,CAS1B;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,CAsE7B"}

package/dist/charts/primitives/ChartFrame.js

@@ -80,7 +80,7 @@ function ChartFrame({
     {
       ref: containerRef,
       style: outerStyle(fill, vertical),
-      ...ariaLabel !== void 0 && { role: "img", "aria-label": ariaLabel },
+      ...ariaLabel !== void 0 && { role: "group", "aria-label": ariaLabel },
       ...isPending && { "aria-busy": "true" },
       children: [
         legendNode !== null && (placement === "top" || placement === "left") && legendNode,

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

@@ -10,6 +10,9 @@ export type LegendEntry = {
     dashed?: boolean;
     /** bar swatch opacity — honored instead of a hardcoded value, so it cannot lie about the fill. */
     fillOpacity?: number;
+    /** line/splitLine swatch stroke opacity — parity with `fillOpacity` above, so a dimmed
+     * companion line's swatch cannot lie about its own opacity either. */
+    strokeOpacity?: number;
     /** Drives `groups` rendering (series → hairline divider → overlay → reference). */
     role?: SeriesRole;
     /** Companions folded under this entry via `parent` (`deriveLegend`) — rendered as compact,

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

@@ -1 +1 @@
-{"version":3,"file":"ChartLegend.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartLegend.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE5D,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAA;IAC9C,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mFAAmF;IACnF,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;iFAC6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;gCAC4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AA4ND;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,WAAkB,EAClB,WAAW,EACX,MAAkB,EAClB,QAAQ,EACR,OAAY,EACZ,SAAoB,EACpB,MAAc,EACd,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC1C,kCAAkC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,+BAmEA"}
+{"version":3,"file":"ChartLegend.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartLegend.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE5D,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAA;IAC9C,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;0EACsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mFAAmF;IACnF,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;iFAC6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;gCAC4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAgOD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,WAAkB,EAClB,WAAW,EACX,MAAkB,EAClB,QAAQ,EACR,OAAY,EACZ,SAAoB,EACpB,MAAc,EACd,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC1C,kCAAkC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,+BAmEA"}

package/dist/charts/primitives/ChartLegend.js

@@ -70,6 +70,7 @@ function LegendSwatch({ item, idPrefix }) {
           y2: 7,
           stroke: item.color,
           strokeWidth: item.strokeWidth ?? 2.5,
+          strokeOpacity: item.strokeOpacity ?? 1,
           strokeDasharray: item.dashed ? VX.dashArray : void 0
         }
       ),
@@ -82,6 +83,7 @@ function LegendSwatch({ item, idPrefix }) {
           y2: 7,
           stroke: item.secondColor,
           strokeWidth: item.strokeWidth ?? 2.5,
+          strokeOpacity: item.strokeOpacity ?? 1,
           strokeDasharray: item.dashed ? VX.dashArray : void 0
         }
       )
@@ -124,6 +126,7 @@ function LegendSwatch({ item, idPrefix }) {
       y2: 3,
       stroke: item.color,
       strokeWidth: item.strokeWidth ?? 3,
+      strokeOpacity: item.strokeOpacity ?? 1,
       strokeLinecap: "round",
       strokeDasharray: item.dashed ? VX.dashArray : void 0
     }
@@ -166,6 +169,7 @@ function LegendChildSwatch({ item }) {
       y2: 5,
       stroke: item.color,
       strokeWidth: item.strokeWidth ?? 2,
+      strokeOpacity: item.strokeOpacity ?? 1,
       strokeDasharray: item.dashed ? VX.dashArray : void 0
     }
   ) });

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

@@ -1,9 +1,14 @@
 import type { ReactNode } from 'react';
 /** Tooltip header — shows formatted date + optional right-aligned label with color. */
-export declare function TooltipHeader({ date, label, labelColor, }: {
+export declare function TooltipHeader({ date, label, labelColor, format, }: {
     date: string;
     label?: string;
     labelColor?: string;
+    /** Overrides `fmtTooltipDate` for the header text. Default: today's `fmtTooltipDate` behavior,
+     * unchanged. The seam exists because `fmtTooltipDate` regexes `YYYY-MM-DD` out of the key and
+     * builds a LOCAL `Date`, so a UTC ISO domain key names the wrong day next to `formatX`/the
+     * tooltip badge, which both resolve locally — a caller with a UTC key needs to supply its own. */
+    format?: (date: string) => string;
 }): import("react").JSX.Element;
 /** Tooltip row — swatch + label + value. */
 export declare function TooltipRow({ color, label, value, valueColor, shape, strokeWidth, dashed, }: {

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,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAuBrD,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;AAOD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACvC,QAAQ,EAAE,SAAS,CAAA;CACpB,sCA4CA"}
+{"version":3,"file":"ChartTooltip.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAuBrD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,MAAuB,GACxB,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;sGAGkG;IAClG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC,+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;AAOD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACvC,QAAQ,EAAE,SAAS,CAAA;CACpB,sCA4CA"}

package/dist/charts/primitives/ChartTooltip.js

@@ -19,7 +19,8 @@ const TOOLTIP_STYLES = {
 function TooltipHeader({
   date,
   label,
-  labelColor
+  labelColor,
+  format = fmtTooltipDate
 }) {
   return /* @__PURE__ */ jsxs(
     "div",
@@ -42,7 +43,7 @@ function TooltipHeader({
               fontFamily: "var(--basalt-font-mono)",
               color: VX.ink
             },
-            children: fmtTooltipDate(date)
+            children: format(date)
           }
         ),
         label !== void 0 && /* @__PURE__ */ jsx(

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChartTooltip.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartTooltip.test.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartTooltip.test.tsx"],"names":[],"mappings":""}

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

@@ -11,24 +11,38 @@ export type XZoneSpec = {
     /** Right edge — a domain key produced by the kind's `getX`. Omit for "end of the plot area". */
     to?: string;
     fill: string;
+    /**
+     * `'center'` (default, unchanged behaviour) resolves a present bound to `xScale(key)` — the
+     * point's own center, so a band reads "from this sample to that sample" rather than
+     * edge-to-edge. `'edge'` resolves a present `from` to `xScale(from) - step/2` and a present `to`
+     * to `xScale(to) + step/2` (`step` read from `xScale.step()`), so the band covers both terminal
+     * slots in full — a two-key band widens by exactly one step, and `from === to` renders one step
+     * wide instead of being skipped as degenerate. An omitted `from`/`to` still resolves to the plot
+     * edge (`xScale.range()[0]`/`[1]`) in both modes, unshifted — omission means "the plot's own
+     * edge", not "the first/last sample's edge". A resolved `'edge'` bound is clamped into the plot
+     * range so a band anchored at the first or last sample cannot paint outside the plot area.
+     */
+    align?: 'center' | 'edge';
 };
 /**
  * Vertical zone backgrounds (x-range overlays — twilight bands, a shaded time window) — one
  * <rect> per zone, spanning y=[0, height] and x=[scale(from), scale(to)]. The x analog of
  * `ZoneRects`, for a `scalePoint` x-axis instead of a `scaleLinear` y-axis.
  *
- * An omitted `from` resolves to `0` (start of the plot area); an omitted `to` resolves to
- * `xScale.range()[1]` (the plot's right edge). A present key resolves to `xScale(key)` — the
- * POINT CENTER, so a band reads as "from this sample to that sample", not edge-to-edge.
+ * Bound resolution depends on `XZoneSpec.align` (see its JSDoc for the full `'center'`/`'edge'`
+ * contract) — default `'center'` resolves a present key to the point's own center; `'edge'`
+ * widens by half a step at each present bound so the band covers the terminal slots in full.
  *
  * A key that is not in the scale's domain skips that band entirely (renders nothing for it) —
- * it is NEVER clamped to a plot edge. Clamping would silently paint a band across the whole
- * chart for a typo'd or stale key, which is the exact class of quiet lie the repo's "nothing to
- * draw is two different states" doctrine rejects: an unknown key must read as "not drawn", not
- * as "the whole plot".
+ * it is NEVER clamped to a plot edge, in either mode. Clamping an unknown key would silently
+ * paint a band across the whole chart for a typo'd or stale key, which is the exact class of
+ * quiet lie the repo's "nothing to draw is two different states" doctrine rejects: an unknown key
+ * must read as "not drawn", not as "the whole plot".
  *
  * A degenerate resolved range (right edge <= left edge, e.g. an inverted `from`/`to` pair) is
- * also skipped — no negative-width rect.
+ * also skipped — no negative-width rect. In `'center'` mode `from === to` is degenerate (skipped,
+ * today's behaviour); in `'edge'` mode it is NOT — the half-step widening on each side always
+ * produces a positive-width, one-step-wide rect.
  */
 export declare function XZoneRects({ zones, height, xScale, }: {
     zones: XZoneSpec[];

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

@@ -1 +1 @@
-{"version":3,"file":"XZoneRects.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/XZoneRects.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AACH,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE;IACD,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;CACnB,+BAsBA"}
+{"version":3,"file":"XZoneRects.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/XZoneRects.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AACH,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CAC1B,CAAA;AAkCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE;IACD,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;CACnB,+BAyCA"}

package/dist/charts/primitives/XZoneRects.js

@@ -1,4 +1,22 @@
 import { Fragment, jsx } from "react/jsx-runtime";
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function resolveBound({
+  key,
+  omittedEdge,
+  xScale,
+  align,
+  edgeSign,
+  rangeMin,
+  rangeMax
+}) {
+  if (key === void 0) return omittedEdge;
+  const center = xScale(key);
+  if (center === void 0) return void 0;
+  if (align === "center") return center;
+  return clamp(center + edgeSign * (xScale.step() / 2), rangeMin, rangeMax);
+}
 function XZoneRects({
   zones,
   height,
@@ -6,8 +24,27 @@ function XZoneRects({
 }) {
   return /* @__PURE__ */ jsx(Fragment, { children: zones.map((z, i) => {
     const [rangeStart, rangeEnd] = xScale.range();
-    const xFrom = z.from === void 0 ? rangeStart : xScale(z.from);
-    const xTo = z.to === void 0 ? rangeEnd : xScale(z.to);
+    const rangeMin = Math.min(rangeStart, rangeEnd);
+    const rangeMax = Math.max(rangeStart, rangeEnd);
+    const align = z.align ?? "center";
+    const xFrom = resolveBound({
+      key: z.from,
+      omittedEdge: rangeStart,
+      xScale,
+      align,
+      edgeSign: -1,
+      rangeMin,
+      rangeMax
+    });
+    const xTo = resolveBound({
+      key: z.to,
+      omittedEdge: rangeEnd,
+      xScale,
+      align,
+      edgeSign: 1,
+      rangeMin,
+      rangeMax
+    });
     if (xFrom === void 0 || xTo === void 0) return null;
     if (xTo <= xFrom) return null;
     return /* @__PURE__ */ jsx(

package/dist/charts/series.d.ts

@@ -52,6 +52,14 @@ export type SeriesStyle = {
     strokeWidth?: number;
     /** bar/area: the swatch honors this so it cannot lie. */
     fillOpacity?: number;
+    /**
+     * A MARK property — dims the plotted stroke, e.g. a faint moving-average companion line. The
+     * legend swatch honors it too (parity with `fillOpacity`, which it already honors — a swatch
+     * that lies is the thing the derived-legend rule exists to prevent). The TOOLTIP ROW swatch and
+     * the CROSSHAIR DOT deliberately do NOT honor it: those are 12px value-readout chips where a
+     * sub-1 opacity reads as a rendering bug, not as data.
+     */
+    strokeOpacity?: number;
     /** Which y-axis this series is measured against. Default 'left'. `'right'` is what makes a
      * chart dual-axis — `CartesianChart` reads it for the crosshair dots and the tooltip. */
     axis?: 'left' | 'right';
@@ -75,12 +83,17 @@ export type SeriesStyle = {
 export type ChartSeries<T> = SeriesStyle & {
     /** null = line gap + skipped tooltip row. */
     getValue: (d: T) => number | null;
-    /** Per-series override of the shared tooltip/value formatter. */
-    formatValue?: (v: number) => string;
-    /** PR star / status dot. Return null for no marker at that point. */
+    /** Per-series override of the shared tooltip/value formatter. Receives the hovered datum
+     * alongside the value so a row can read fields beyond the plotted number (e.g. `97.5 kg (92.5 ×
+     * 3)`). */
+    formatValue?: (v: number, d: T) => string;
+    /** PR star / status dot. Return null for no marker at that point. `ring` defaults true (today's
+     * punched-out stroke, unchanged); `false` omits the stroke entirely. `fillOpacity` defaults 1. */
     getMarker?: (d: T) => {
         color?: string;
         r?: number;
+        fillOpacity?: number;
+        ring?: boolean;
     } | null;
 };
 /** A single derived tooltip row, ready for `TooltipRow`. */

package/dist/charts/series.d.ts.map

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

package/dist/charts/series.js

@@ -9,6 +9,7 @@ function legendEntryFor(s) {
     dashed: s.dash === "dashed",
     ...s.strokeWidth !== void 0 && { strokeWidth: s.strokeWidth },
     ...s.fillOpacity !== void 0 && { fillOpacity: s.fillOpacity },
+    ...s.strokeOpacity !== void 0 && { strokeOpacity: s.strokeOpacity },
     ...s.role !== void 0 && { role: s.role },
     ...s.note !== void 0 && { note: s.note }
   };
@@ -42,7 +43,7 @@ function deriveTooltipRows(series, datum, fallbackFormat) {
       key: s.key,
       label: s.label,
       color: s.color,
-      value: format(value),
+      value: format(value, datum),
       shape: shapeFor(s.mark),
       dashed: s.dash === "dashed",
       ...s.strokeWidth !== void 0 && { strokeWidth: s.strokeWidth }

package/dist/charts/utils/domain.d.ts

@@ -17,4 +17,19 @@
  *    pre-existing, still-correct behavior for genuinely negative-swinging metrics.
  */
 export declare function padAutoLower(candidate: number, pad: number): number;
+/**
+ * Auto y-domain upper-bound padding — the exact mirror of {@link padAutoLower}, sharing its
+ * sign-safety: pad AWAY from zero (`upper >= candidate`), never toward it. `candidate` is the
+ * caller's `Math.max(dataMax, floor)` — the `autoMaxFloor` clamp has already been applied, so
+ * padding runs AFTER the floor, not before it. Applying the floor post-pad (the pre-existing bug)
+ * lands a floored axis top exactly on the floor value with zero headroom — a target line pinned to
+ * that floor then sits glued to the plot edge instead of getting the same breathing room every
+ * other bound gets.
+ *
+ *  - `candidate === 0` stays exactly 0 — never pushed positive.
+ *  - `candidate > 0` multiplies by `pad`, moving the ceiling further UP (away from zero).
+ *  - `candidate < 0` divides by `pad`, moving the ceiling UP toward (and past) zero — the mirror of
+ *    `padAutoLower`'s `candidate > 0` branch.
+ */
+export declare function padAutoUpper(candidate: number, pad: number): number;
 //# sourceMappingURL=domain.d.ts.map

package/dist/charts/utils/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE"}

package/dist/charts/utils/domain.js

@@ -2,6 +2,11 @@ function padAutoLower(candidate, pad) {
   if (candidate === 0) return 0;
   return candidate > 0 ? candidate / pad : candidate * pad;
 }
+function padAutoUpper(candidate, pad) {
+  if (candidate === 0) return 0;
+  return candidate > 0 ? candidate * pad : candidate / pad;
+}
 export {
-  padAutoLower
+  padAutoLower,
+  padAutoUpper
 };

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.15.0
+# basalt-ui v1.17.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.15.0
+Version: 1.17.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets",
   "keywords": [
     "charts",

package/src/charts/cursor/resolve.test.ts

@@ -59,3 +59,65 @@ describe('resolveCursorPoint', () => {
     expect(resolveCursorPoint(i, '2026-08-02')).toBeNull()
   })
 })
+
+describe("resolveCursorPoint — 'leading' resolution (bucket-keyed domains)", () => {
+  const weekly = (days: string[]) => buildDomainIndex(daily(days), (p) => p.date, 'leading')
+
+  test('resolves an exact key, same as nearest', () => {
+    const i = weekly(['01', '08', '15'])
+    expect(resolveCursorPoint(i, '2026-08-08')?.date).toBe('2026-08-08')
+  })
+
+  test("a target anywhere inside a bucket resolves to that bucket's LEADING key, not the nearest one", () => {
+    // The bug this replaces: a weekly chart keyed by the Monday of each week (step 7 days),
+    // hovered from a daily sibling landing in the back half of the bucket, used to resolve to the
+    // FOLLOWING week under nearest-match. Every back-half day must resolve to the bucket it is
+    // actually inside.
+    const i = weekly(['01', '08', '15'])
+    expect(resolveCursorPoint(i, '2026-08-02')?.date).toBe('2026-08-01')
+    expect(resolveCursorPoint(i, '2026-08-05')?.date).toBe('2026-08-01')
+    expect(resolveCursorPoint(i, '2026-08-07')?.date).toBe('2026-08-01')
+    expect(resolveCursorPoint(i, '2026-08-09')?.date).toBe('2026-08-08')
+    expect(resolveCursorPoint(i, '2026-08-14')?.date).toBe('2026-08-08')
+  })
+
+  test('a key BEFORE the first bucket resolves to null — no bucket contains it', () => {
+    // Deliberately NOT 'nearest''s one-step tolerance. The first key is the leading edge of the
+    // first bucket, so anything earlier is outside every bucket; snapping it onto the first one
+    // would paint a crosshair on a bucket that provably does not contain the hovered key.
+    const i = weekly(['02', '09', '16'])
+    expect(resolveCursorPoint(i, '2026-08-01')).toBeNull()
+    expect(resolveCursorPoint(i, '2026-08-02')?.date).toBe('2026-08-02')
+  })
+
+  test('the final bucket ends at last + step — that instant is already outside it', () => {
+    const i = weekly(['01', '08', '15']) // step = 7, so the last bucket covers [Aug 15, Aug 22)
+    expect(resolveCursorPoint(i, '2026-08-21')?.date).toBe('2026-08-15') // last day inside
+    expect(resolveCursorPoint(i, '2026-08-22')).toBeNull() // exactly last + step, exclusive
+    expect(resolveCursorPoint(i, '2026-08-23')).toBeNull()
+  })
+
+  test('returns null well beyond the domain, so unrelated charts never sync', () => {
+    const i = weekly(['01', '08', '15'])
+    expect(resolveCursorPoint(i, '2026-09-30')).toBeNull()
+  })
+
+  test('categorical domains fall back to exact match only, same as nearest', () => {
+    const points = [{ date: 'Direct' }, { date: 'Referral' }]
+    const i = buildDomainIndex(points, (p) => p.date, 'leading')
+    expect(resolveCursorPoint(i, 'Direct')?.date).toBe('Direct')
+    expect(resolveCursorPoint(i, 'Organic')).toBeNull()
+  })
+
+  test('a single-point chart resolves only its own key', () => {
+    const i = weekly(['01'])
+    expect(resolveCursorPoint(i, '2026-08-01')?.date).toBe('2026-08-01')
+    expect(resolveCursorPoint(i, '2026-08-02')).toBeNull()
+  })
+
+  test('an explicit resolution argument overrides the index-built default', () => {
+    // Built as 'nearest', resolved as 'leading' — the per-call argument wins.
+    const i = index(daily(['01', '08', '15']))
+    expect(resolveCursorPoint(i, '2026-08-05', 'leading')?.date).toBe('2026-08-01')
+  })
+})