basalt-ui 1.14.0 → 1.16.0

package/dist/charts/primitives/ChartTooltip.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useLayoutEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { VX } from "../../tokens/index.js";
 import { fmtTooltipDate } from "../utils/format.js";
@@ -15,22 +16,6 @@ const TOOLTIP_STYLES = {
   boxShadow: VX.shadowCard,
   minWidth: 140
 };
-function useTooltipStyles() {
-  return TOOLTIP_STYLES;
-}
-function ChartTooltip({
-  tip,
-  tooltipRef,
-  styles,
-  children
-}) {
-  if (!tip) return null;
-  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,
   label,
@@ -131,10 +116,51 @@ function TooltipRow({
 function TooltipBody({ children }) {
   return /* @__PURE__ */ jsx("div", { style: { padding: "5px 0" }, children });
 }
+const TOOLTIP_GAP = 12;
+const VIEWPORT_MARGIN = 8;
+function ChartTooltipFloat({
+  anchor,
+  children
+}) {
+  const ref = useRef(null);
+  const [box, setBox] = useState(null);
+  useLayoutEffect(() => {
+    const el = ref.current;
+    if (el === null) return;
+    const { offsetWidth, offsetHeight } = el;
+    setBox(
+      (prev) => prev !== null && prev.width === offsetWidth && prev.height === offsetHeight ? prev : { width: offsetWidth, height: offsetHeight }
+    );
+  }, [children, anchor]);
+  if (anchor === null) return null;
+  if (typeof document === "undefined") return null;
+  const width = box?.width ?? 0;
+  const height = box?.height ?? 0;
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  const flipsLeft = anchor.x + TOOLTIP_GAP + width + VIEWPORT_MARGIN > vw;
+  const left = flipsLeft ? Math.max(VIEWPORT_MARGIN, anchor.x - TOOLTIP_GAP - width) : anchor.x + TOOLTIP_GAP;
+  const top = Math.min(
+    Math.max(VIEWPORT_MARGIN, anchor.y - TOOLTIP_GAP),
+    Math.max(VIEWPORT_MARGIN, vh - height - VIEWPORT_MARGIN)
+  );
+  return createPortal(
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        role: "tooltip",
+        "aria-live": "polite",
+        style: { ...TOOLTIP_STYLES, left, top, visibility: box === null ? "hidden" : "visible" },
+        children
+      }
+    ),
+    document.body
+  );
+}
 export {
-  ChartTooltip,
+  ChartTooltipFloat,
   TooltipBody,
   TooltipHeader,
-  TooltipRow,
-  useTooltipStyles
+  TooltipRow
 };

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

@@ -1,10 +1,25 @@
-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, }: {
+import type { FocusEventHandler, KeyboardEventHandler, PointerEventHandler } from 'react';
+/**
+ * Transparent <rect> that captures pointer events (mouse + touch + pen) for tooltip + crosshair
+ * sync.
+ *
+ * With `onKeyDown` it also becomes the chart's keyboard affordance: the rect takes focus and
+ * ←/→ scrub the cursor, so a chart's values are reachable without a pointer.
+ */
+export declare function HoverOverlay({ width, height, onMove, onLeave, onKeyDown, onBlur, ariaLabel, valueNow, valueMax, valueText, }: {
     width: number;
     height: number;
     onMove: PointerEventHandler<SVGRectElement>;
     onLeave: PointerEventHandler<SVGRectElement>;
+    /** Present = the overlay is focusable and scrubs on ←/→. */
+    onKeyDown?: KeyboardEventHandler<SVGRectElement>;
+    onBlur?: FocusEventHandler<SVGRectElement>;
+    ariaLabel?: string;
+    /** Index of the focused point — announced as the slider position. */
+    valueNow?: number;
+    /** Last index of the domain. */
+    valueMax?: number;
+    /** Human-readable label for the focused point (the formatted x key). */
+    valueText?: string;
 }): 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,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"}
+{"version":3,"file":"HoverOverlay.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/HoverOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAEzF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,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;IAC5C,4DAA4D;IAC5D,SAAS,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAA;IAChD,MAAM,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAA;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BA8BA"}

package/dist/charts/primitives/HoverOverlay.js

@@ -3,7 +3,13 @@ function HoverOverlay({
   width,
   height,
   onMove,
-  onLeave
+  onLeave,
+  onKeyDown,
+  onBlur,
+  ariaLabel,
+  valueNow,
+  valueMax,
+  valueText
 }) {
   return /* @__PURE__ */ jsx(
     "rect",
@@ -11,6 +17,21 @@ function HoverOverlay({
       width,
       height,
       fill: "transparent",
+      ...onKeyDown !== void 0 && {
+        tabIndex: 0,
+        // `slider`, not `application`: `application` would drop this node out of the screen
+        // reader's normal browse mode entirely, which is a far bigger hammer than an arrow-key
+        // scrub needs. A slider announces both the affordance and the focused point.
+        role: "slider",
+        "aria-label": ariaLabel ?? "Chart data \u2014 use arrow keys to scrub",
+        "aria-orientation": "horizontal",
+        "aria-valuemin": 0,
+        ...valueMax !== void 0 && { "aria-valuemax": valueMax },
+        ...valueNow !== void 0 && { "aria-valuenow": valueNow },
+        ...valueText !== void 0 && { "aria-valuetext": valueText },
+        onKeyDown,
+        ...onBlur !== void 0 && { onBlur }
+      },
       style: { touchAction: "pan-y" },
       onPointerMove: onMove,
       onPointerLeave: onLeave,

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

@@ -0,0 +1,54 @@
+import type { scalePoint } from '@visx/scale';
+/**
+ * The point-scale instance type, derived from `@visx/scale`'s own `scalePoint` return type.
+ * Equivalent to d3's `ScalePoint<string>` but resolved through `@visx/scale` (an installed dep) so
+ * it needs no `@types/d3-scale` and stays inside the visx-only-in-charts boundary.
+ */
+type PointScale = ReturnType<typeof scalePoint<string>>;
+export type XZoneSpec = {
+    /** Left edge — a domain key produced by the kind's `getX`. Omit for "start of the plot area". */
+    from?: string;
+    /** 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.
+ *
+ * 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, 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. 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[];
+    /** Plot-area height (yMax); rects span from 0 to this. */
+    height: number;
+    xScale: PointScale;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=XZoneRects.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,65 @@
+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,
+  xScale
+}) {
+  return /* @__PURE__ */ jsx(Fragment, { children: zones.map((z, i) => {
+    const [rangeStart, rangeEnd] = xScale.range();
+    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(
+      "rect",
+      {
+        x: xFrom,
+        y: 0,
+        width: xTo - xFrom,
+        height,
+        fill: z.fill
+      },
+      `xzone-${i}`
+    );
+  }) });
+}
+export {
+  XZoneRects
+};

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

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

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

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

package/dist/charts/series.d.ts

@@ -36,6 +36,8 @@ export type ChartLegendConfig = {
     groups?: boolean;
     /** Wrap cap → "+N more" rollup at high cardinality. */
     maxRows?: number;
+    /** Clicking an entry hides that series. Default: on whenever there is more than one entry. */
+    toggle?: boolean;
 };
 /** Visual identity of a series — everything the legend + tooltip swatch need. No accessors, no `T`. */
 export type SeriesStyle = {
@@ -50,19 +52,41 @@ 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';
     /** Default 'series'. */
     role?: SeriesRole;
     /** Default true; false = companion folded under `parent`. */
     legend?: boolean;
+    /**
+     * Default true; false = drawn and legended, but NEVER listed as a tooltip row. The replacement
+     * for the per-kind `hideBarTooltipRows` escape the old layer had: it belongs to the series, not to the kind, so
+     * one series can opt out without the kind growing a prop for it.
+     */
+    tooltip?: boolean;
     /** e.g. an MA line names its parent so hover-dimming keeps the pair. */
     parent?: string;
+    /** Short qualifier rendered after the label in muted text — e.g. a flat-at-zero series that is
+     * invisible in the plot. */
+    note?: string;
 };
 /** Full descriptor = visual identity + data accessors. Generic over the point type. */
 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;
+    /** 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. */
     getMarker?: (d: T) => {
         color?: string;
@@ -92,7 +116,8 @@ export type TooltipRowData = {
 export declare function deriveLegend(series: readonly SeriesStyle[]): LegendEntry[];
 /**
  * Derive tooltip rows from a series descriptor array + the hovered datum. Skips rows where
- * `getValue(datum) === null`; honors per-series `formatValue` over the shared `fallbackFormat`.
+ * `getValue(datum) === null` or `tooltip === false`; honors per-series `formatValue` over the
+ * shared `fallbackFormat`.
  * Kinds pass `series.toReversed()` for stacked charts so the tooltip stack matches the visual stack.
  */
 export declare function deriveTooltipRows<T>(series: readonly ChartSeries<T>[], datum: T, fallbackFormat: (v: number) => string): TooltipRowData[];

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

@@ -1 +1 @@
-{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../../src/charts/series.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAEhD,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3C,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAE3D,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wBAAwB;IACxB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,uBAAuB;IACvB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,WAAW,GAAG;IACzC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IACjC,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC5D,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,GAAG,KAAK,CAAA;IACrB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAoB1E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EACjC,KAAK,EAAE,CAAC,EACR,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GACpC,cAAc,EAAE,CAiBlB"}
+{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../../src/charts/series.ts"],"names":[],"mappings":"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"}

package/dist/charts/series.js

@@ -9,7 +9,9 @@ function legendEntryFor(s) {
     dashed: s.dash === "dashed",
     ...s.strokeWidth !== void 0 && { strokeWidth: s.strokeWidth },
     ...s.fillOpacity !== void 0 && { fillOpacity: s.fillOpacity },
-    ...s.role !== void 0 && { role: s.role }
+    ...s.strokeOpacity !== void 0 && { strokeOpacity: s.strokeOpacity },
+    ...s.role !== void 0 && { role: s.role },
+    ...s.note !== void 0 && { note: s.note }
   };
 }
 function deriveLegend(series) {
@@ -33,6 +35,7 @@ function deriveLegend(series) {
 function deriveTooltipRows(series, datum, fallbackFormat) {
   const rows = [];
   for (const s of series) {
+    if (s.tooltip === false) continue;
     const value = s.getValue(datum);
     if (value === null) continue;
     const format = s.formatValue ?? fallbackFormat;
@@ -40,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/series.test.d.ts

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

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

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

package/dist/charts/utils/measure-text.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Text measurement for chart layout — the input to {@link autoMargin}.
+ *
+ * A static margin token cannot know how wide a tick label is, which is why charts used to have to be
+ * hand-nudged whenever a label grew (`docs/CHARTS-SPEC.md` §1). This measures the strings that
+ * will actually be painted, via an OFFSCREEN canvas 2D context: no element is attached, so there
+ * is no layout thrash and no reflow — unlike an SVG `getBBox()` probe.
+ *
+ * Mantine-free and dependency-free by construction (`charts/**` boundary).
+ */
+/**
+ * The resolved value of `--basalt-font-mono` — canvas needs a concrete family list, it cannot
+ * resolve a CSS custom property. Read once from the document element.
+ */
+export declare function monoFontFamily(): string;
+/**
+ * Width in px of `text` at `fontPx` in the chart tick font. Memoized per `font|text` — a chart
+ * re-measures the same ~10 tick labels on every resize, and the cache turns that into a Map hit.
+ */
+export declare function measureText(text: string, fontPx: number, fontFamily?: string): number;
+/** Widest of `texts` at `fontPx`. Returns 0 for an empty list. */
+export declare function maxTextWidth(texts: readonly string[], fontPx: number, fontFamily?: string): number;
+/** Test seam — drops the memo table (and the resolved family) so a test can change fonts. */
+export declare function resetTextMetrics(): void;
+//# sourceMappingURL=measure-text.d.ts.map

package/dist/charts/utils/measure-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-text.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/measure-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuCH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBrF;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAOR;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/dist/charts/utils/measure-text.js

@@ -0,0 +1,64 @@
+const FALLBACK_CHAR_RATIO = 0.6;
+const FALLBACK_MONO = "ui-monospace, SFMono-Regular, Menlo, monospace";
+const CACHE_LIMIT = 2e3;
+const cache = /* @__PURE__ */ new Map();
+let ctx;
+let monoFamily;
+function canvasContext() {
+  if (ctx !== void 0) return ctx;
+  if (typeof document === "undefined") {
+    ctx = null;
+    return ctx;
+  }
+  ctx = document.createElement("canvas").getContext("2d");
+  document.fonts?.ready?.then?.(() => cache.clear()).catch(() => {
+  });
+  return ctx;
+}
+function monoFontFamily() {
+  if (monoFamily !== void 0) return monoFamily;
+  if (typeof document === "undefined" || typeof getComputedStyle !== "function") {
+    monoFamily = FALLBACK_MONO;
+    return monoFamily;
+  }
+  const value = getComputedStyle(document.documentElement).getPropertyValue("--basalt-font-mono").trim();
+  monoFamily = value.length > 0 ? value : FALLBACK_MONO;
+  return monoFamily;
+}
+function measureText(text, fontPx, fontFamily) {
+  const family = fontFamily ?? monoFontFamily();
+  const font = `${fontPx}px ${family}`;
+  const key = `${font}|${text}`;
+  const hit = cache.get(key);
+  if (hit !== void 0) return hit;
+  const c = canvasContext();
+  let width;
+  if (c === null) {
+    width = text.length * fontPx * FALLBACK_CHAR_RATIO;
+  } else {
+    c.font = font;
+    width = c.measureText(text).width;
+  }
+  if (cache.size >= CACHE_LIMIT) cache.clear();
+  cache.set(key, width);
+  return width;
+}
+function maxTextWidth(texts, fontPx, fontFamily) {
+  let max = 0;
+  for (const text of texts) {
+    const width = measureText(text, fontPx, fontFamily);
+    if (width > max) max = width;
+  }
+  return max;
+}
+function resetTextMetrics() {
+  cache.clear();
+  ctx = void 0;
+  monoFamily = void 0;
+}
+export {
+  maxTextWidth,
+  measureText,
+  monoFontFamily,
+  resetTextMetrics
+};

package/dist/charts/utils/measure-text.test.d.ts

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

package/dist/charts/utils/measure-text.test.d.ts.map

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

package/dist/content/fence-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fence-block.d.ts","sourceRoot":"","sources":["../../src/content/fence-block.tsx"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oGAAoG;IACpG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,SAAS,CAAA;AAElE,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAYpE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEhE;AAED,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,EAAE,cAEtC,CAAA;AAiBD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;CACpC,CAAA;AA2HD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,eAAe,sCA2BvE"}
+{"version":3,"file":"fence-block.d.ts","sourceRoot":"","sources":["../../src/content/fence-block.tsx"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oGAAoG;IACpG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,SAAS,CAAA;AAElE,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAYpE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEhE;AAED,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,EAAE,cAEtC,CAAA;AAiBD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;CACpC,CAAA;AA0HD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,eAAe,sCA2BvE"}

package/dist/surfaces.d.ts

@@ -141,7 +141,7 @@ export declare const SURFACES: {
         readonly rule: "charts";
         readonly skill: readonly ["basalt-charts"];
         readonly guardKinds: readonly ["raw-hex", "raw-color-fn", "raw-visx-axis", "unframed-chart"];
-        readonly description: "visx chart primitives, sparklines, hooks, and token re-exports (Mantine-free)";
+        readonly description: "CartesianChart + visx chart primitives, kinds, sparklines, hooks, and token re-exports (Mantine-free)";
         readonly globs: {
             readonly shipped: readonly ["**/charts/**"];
             readonly repo: readonly ["packages/basalt-ui/src/charts/**"];

package/dist/surfaces.d.ts.map

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

package/dist/surfaces.js

@@ -47,7 +47,7 @@ const SURFACES = {
     rule: "charts",
     skill: ["basalt-charts"],
     guardKinds: ["raw-hex", "raw-color-fn", "raw-visx-axis", "unframed-chart"],
-    description: "visx chart primitives, sparklines, hooks, and token re-exports (Mantine-free)",
+    description: "CartesianChart + visx chart primitives, kinds, sparklines, hooks, and token re-exports (Mantine-free)",
     globs: {
       shipped: ["**/charts/**"],
       repo: ["packages/basalt-ui/src/charts/**"]

package/dist/tokens/chart-margin.test.d.ts

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

package/dist/tokens/chart-margin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-margin.test.d.ts","sourceRoot":"","sources":["../../src/tokens/chart-margin.test.ts"],"names":[],"mappings":""}

package/dist/tokens/index.d.ts

@@ -114,6 +114,35 @@ export declare const VX: {
     };
     readonly minPxPerTick: 55;
 };
+/** Resolved chart plot-area margins — the return shape of {@link chartMargin}. */
+export type ChartMargin = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+/**
+ * Chart plot-area margins — `VX.margin` widened for an `AxisRightNumeric`'s tick labels, and/or
+ * overridden per side. A token can't express "only when a right axis is rendered", so this is a
+ * function, not a second static token — also the seam that could one day track `density`
+ * (`VX.margin` itself is frozen at the level-0 snapshot; see `deriveSpacing`'s JSDoc).
+ *
+ * Law, applied in this order: start from `VX.margin`; when `rightAxis` is true, widen `right` to
+ * `Math.max(VX.margin.right, <right-axis minimum>)` (`SPACE_STEP.chartMarginRightAxis`); then any
+ * explicitly passed side wins last (including overriding `rightAxis`'s widened `right`).
+ * `chartMargin()` with no args deep-equals `VX.margin`.
+ *
+ * Returns a NEW object every call — memoize at the call site (`useMemo`), the same way `Bars`
+ * already memoizes its own margin.
+ */
+export declare function chartMargin(opts?: {
+    /** Reserve room for an `AxisRightNumeric`'s tick labels. */
+    rightAxis?: boolean;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}): ChartMargin;
 /**
  * A px number expressed as the plain rem STRING literal (16px base: `pxRem(6)` → `'0.375rem'`) —
  * NOT Mantine's own `rem()` helper, which instead emits a `calc(...)` expression bound to

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

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

package/dist/tokens/index.js

@@ -158,6 +158,15 @@ const VX = {
   },
   minPxPerTick: 55
 };
+function chartMargin(opts) {
+  const widenedRight = opts?.rightAxis ? Math.max(VX.margin.right, SPACE_STEP.chartMarginRightAxis) : VX.margin.right;
+  return {
+    top: opts?.top ?? VX.margin.top,
+    right: opts?.right ?? widenedRight,
+    bottom: opts?.bottom ?? VX.margin.bottom,
+    left: opts?.left ?? VX.margin.left
+  };
+}
 const decl = (name, value) => `  --vx-${name}: ${value};`;
 function pxRem(px) {
   return `${px / 16}rem`;
@@ -553,6 +562,7 @@ export {
   buildFontsCss,
   buildPaletteCss,
   buildRadiusCss,
+  chartMargin,
   defineSeries,
   deriveRadius,
   deriveSpacing,