basalt-ui 1.27.0 → 1.29.0

package/dist/charts/primitives/ChartPending.js

@@ -1,4 +1,4 @@
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { VX } from "../../tokens/index.js";
 const centerStyle = (width, height) => ({
   width,
@@ -7,17 +7,111 @@ const centerStyle = (width, height) => ({
   alignItems: "center",
   justifyContent: "center"
 });
-function ChartCenter({ width, height, children }) {
-  return /* @__PURE__ */ jsx("div", { style: centerStyle(width, height), children });
+function ChartCenter({
+  width,
+  height,
+  className,
+  style,
+  children
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...className !== void 0 && { className },
+      style: { ...centerStyle(width, height), ...style },
+      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 }) });
+function ChartPending({
+  width,
+  height,
+  label = "Loading\u2026",
+  className,
+  style
+}) {
+  return /* @__PURE__ */ jsx(
+    ChartCenter,
+    {
+      width,
+      height,
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
+      children: /* @__PURE__ */ jsx("span", { style: labelStyle, role: "status", children: label })
+    }
+  );
+}
+function resolveChartState(input) {
+  const { state, isPending } = input;
+  if (isPending === true || state?.pending === true) return "pending";
+  if (state?.error !== void 0 && state.error !== null && state.error !== false) return "error";
+  if (state?.empty) return "empty";
+  return null;
+}
+const stackStyle = {
+  display: "flex",
+  flexDirection: "column",
+  alignItems: "center",
+  gap: 8
+};
+function ChartEmpty({
+  width,
+  height,
+  label = "No data",
+  action,
+  className,
+  style
+}) {
+  return /* @__PURE__ */ jsx(
+    ChartCenter,
+    {
+      width,
+      height,
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
+      children: /* @__PURE__ */ jsxs("span", { style: stackStyle, role: "status", children: [
+        /* @__PURE__ */ jsx("span", { style: labelStyle, children: label }),
+        action
+      ] })
+    }
+  );
+}
+function errorLabel(error) {
+  if (error instanceof Error && error.message !== "") return error.message;
+  if (typeof error === "string" && error !== "") return error;
+  return "Could not load chart";
+}
+function ChartError({
+  width,
+  height,
+  label,
+  error,
+  action,
+  className,
+  style
+}) {
+  return /* @__PURE__ */ jsx(
+    ChartCenter,
+    {
+      width,
+      height,
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
+      children: /* @__PURE__ */ jsxs("span", { style: stackStyle, role: "alert", children: [
+        /* @__PURE__ */ jsx("span", { style: labelStyle, children: label ?? errorLabel(error) }),
+        action
+      ] })
+    }
+  );
 }
 export {
   ChartCenter,
-  ChartPending
+  ChartEmpty,
+  ChartError,
+  ChartPending,
+  resolveChartState
 };

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

@@ -31,6 +31,13 @@ export declare function TooltipBody({ children }: {
  *
  * The box is measured after mount via `useLayoutEffect`, so the first paint of a given tooltip is
  * hidden rather than misplaced — a tooltip that flashes at the wrong corner reads as a bug.
+ *
+ * **It renders NOTHING on the server.** `createPortal` throws outright in `react-dom/server`
+ * ("Portals are not currently supported by the server renderer"), and an unconditional portal made
+ * this the single component in the package that could not be server-rendered. The guard is
+ * {@link useIsClient}, not a `typeof document` check: under a DOM-preloaded test runner `document`
+ * exists while `renderToString` still refuses portals. A tooltip is a hover artifact with nothing
+ * to emit server-side, so rendering nothing is the whole fix, not a degradation.
  */
 export declare function ChartTooltipFloat({ anchor, ariaLive, children, }: {
     anchor: {

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,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,QAAe,EACf,QAAQ,GACT,EAAE;IACD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACvC;;;8CAG0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,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;AAsBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAe,EACf,QAAQ,GACT,EAAE;IACD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACvC;;;8CAG0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB,sCAsDA"}

package/dist/charts/primitives/ChartTooltip.js

@@ -1,8 +1,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useLayoutEffect, useRef, useState } from "react";
+import { useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal } from "react-dom";
 import { VX } from "../../tokens/index.js";
 import { fmtTooltipDate } from "../utils/format.js";
+import { useChartTierMetrics } from "./chart-tier.js";
 const TOOLTIP_STYLES = {
   position: "fixed",
   pointerEvents: "none",
@@ -13,8 +14,7 @@ const TOOLTIP_STYLES = {
   fontSize: VX.text.xs,
   lineHeight: "18px",
   color: VX.ink,
-  boxShadow: VX.shadowCard,
-  minWidth: 140
+  boxShadow: VX.shadowCard
 };
 function TooltipHeader({
   date,
@@ -117,6 +117,11 @@ function TooltipRow({
 function TooltipBody({ children }) {
   return /* @__PURE__ */ jsx("div", { style: { padding: "5px 0" }, children });
 }
+const neverSubscribe = () => () => {
+};
+const onClient = () => true;
+const onServer = () => false;
+const useIsClient = () => useSyncExternalStore(neverSubscribe, onClient, onServer);
 const TOOLTIP_GAP = 12;
 const VIEWPORT_MARGIN = 8;
 function ChartTooltipFloat({
@@ -126,6 +131,8 @@ function ChartTooltipFloat({
 }) {
   const ref = useRef(null);
   const [box, setBox] = useState(null);
+  const isClient = useIsClient();
+  const { tooltipMinWidth } = useChartTierMetrics();
   useLayoutEffect(() => {
     const el = ref.current;
     if (el === null) return;
@@ -135,7 +142,7 @@ function ChartTooltipFloat({
     );
   }, [children, anchor]);
   if (anchor === null) return null;
-  if (typeof document === "undefined") return null;
+  if (!isClient) return null;
   const width = box?.width ?? 0;
   const height = box?.height ?? 0;
   const vw = window.innerWidth;
@@ -153,7 +160,13 @@ function ChartTooltipFloat({
         ref,
         role: "tooltip",
         ...ariaLive && { "aria-live": "polite" },
-        style: { ...TOOLTIP_STYLES, left, top, visibility: box === null ? "hidden" : "visible" },
+        style: {
+          ...TOOLTIP_STYLES,
+          minWidth: tooltipMinWidth,
+          left,
+          top,
+          visibility: box === null ? "hidden" : "visible"
+        },
         children
       }
     ),

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

@@ -13,6 +13,9 @@ export declare function Crosshair({ x, top, bottom, }: {
 /**
  * The punched-out hover marker: a filled circle whose stroke is the chart background color, so it
  * reads as a "hole" cut into the line on both themes. Centralizes the `dotStroke = chart-bg` trick.
+ *
+ * The default radius tracks the ambient chart tier (`docs/CHARTS-SPEC.md` §8) — an explicit `r`
+ * (a `getMarker`'s own radius) still wins.
  */
 export declare function SeriesDot({ cx, cy, color, r, }: {
     cx: number;

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

@@ -1 +1 @@
-{"version":3,"file":"Crosshair.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/Crosshair.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,CAAC,EACD,GAAG,EACH,MAAM,GACP,EAAE;IACD,CAAC,EAAE,MAAM,CAAA;IACT,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,SAAS,CAEZ;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,EAAE,EACF,KAAK,EACL,CAAC,GACF,EAAE;IACD,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,CAAC,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,SAAS,CAIZ"}
+{"version":3,"file":"Crosshair.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/Crosshair.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,CAAC,EACD,GAAG,EACH,MAAM,GACP,EAAE;IACD,CAAC,EAAE,MAAM,CAAA;IACT,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,SAAS,CAEZ;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,EAAE,EACF,KAAK,EACL,CAAC,GACF,EAAE;IACD,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,CAAC,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,SAAS,CAGZ"}

package/dist/charts/primitives/Crosshair.js

@@ -1,5 +1,6 @@
 import { jsx } from "react/jsx-runtime";
 import { VX } from "../../tokens/index.js";
+import { useChartTierMetrics } from "./chart-tier.js";
 function Crosshair({
   x,
   top,
@@ -13,7 +14,8 @@ function SeriesDot({
   color,
   r
 }) {
-  return /* @__PURE__ */ jsx("circle", { cx, cy, r: r ?? VX.dotR, fill: color, stroke: VX.dotStroke, strokeWidth: 2 });
+  const { dotR } = useChartTierMetrics();
+  return /* @__PURE__ */ jsx("circle", { cx, cy, r: r ?? dotR, fill: color, stroke: VX.dotStroke, strokeWidth: 2 });
 }
 export {
   Crosshair,

package/dist/charts/primitives/chart-frame-layout.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Pure, DOM-free layout math behind `ChartFrame`'s plot/legend split — extracted so the arithmetic
+ * is testable without a `ResizeObserver` and `ChartFrame.tsx` stays the measuring/rendering shell.
+ */
+import type { ChartMargin } from '../../tokens/index.js';
+import type { LegendEntry } from './ChartLegend.js';
+/**
+ * The two size tiers a chart resolves to. There are exactly two, and there is no `tablet`: the
+ * tier exists to answer "is there room for full-size chrome around the plot", which is a yes/no
+ * question, and a third rung would need a third calibrated metric set nothing has asked for.
+ */
+export type ChartTier = 'phone' | 'desktop';
+/**
+ * The tier a chart's chrome resolves to, from the width of the box it was MEASURED in — never
+ * from a media query.
+ *
+ * A viewport breakpoint answers the wrong question. A chart in a 2-column grid cell on a 1440px
+ * desktop is exactly as narrow as one filling a phone, and `@media` cannot see that; the
+ * `ResizeObserver` `ChartFrame` already runs can. It also keeps this file (and the whole chart
+ * layer) Mantine-free — `theme.breakpoints` is on the coupled side of the boundary.
+ *
+ * An UNMEASURED box (`containerW <= 0` — SSR, or before the observer's first callback) resolves
+ * to `'desktop'`: the first frame must not paint phone chrome that then re-lays-out one frame
+ * later, and `resolvePlotRect` already treats an unmeasured width as the first-frame case.
+ */
+export declare function resolveChartTier(containerW: number): ChartTier;
+/** Every size a chart's chrome resolves per tier. One object so a new tier-sensitive size is added
+ * in one place and read by name, rather than each primitive branching on the tier itself. */
+export type ChartTierMetrics = {
+    /** Which tier these are, so a consumer of the metrics never needs both values threaded. */
+    tier: ChartTier;
+    /** Axis tick label font size, px. Threaded into BOTH `autoMargin`'s measurement and the painted
+     * axis — measured labels must be the painted labels (`docs/CHARTS-SPEC.md` §1). */
+    axisFont: number;
+    /** Legend label font size, px. */
+    legendFontSize: number;
+    /** Crosshair dot radius, px. */
+    dotR: number;
+    /** Floating tooltip `minWidth`, px. */
+    tooltipMinWidth: number;
+    /** Default entry cap on the legend, or `undefined` for no default cap. An explicit
+     * `legend.maxRows` still wins as the upper bound. */
+    legendMaxRows: number | undefined;
+    /** Per-side margin FLOORS (`VX.margin` is a floor, never a ceiling — §1). */
+    margin: ChartMargin;
+};
+/** The resolved sizes for one tier. Frozen module constants — never a new object per render. */
+export declare function chartTierMetrics(tier: ChartTier): ChartTierMetrics;
+/**
+ * Resolve the plot rect from the measured box and the measured legend band. Pure and exported so
+ * the two floors below are testable without a `ResizeObserver`.
+ *
+ * Two floors, and each is only a floor while it is honest:
+ * - **width** — `minWidth` is a FIRST-FRAME guard, applied only while `containerW` is still 0
+ *   (unmeasured, or SSR, where the observer never fires). Once measured the plot tracks the box
+ *   exactly, floored at 1 so no scale divides by zero: applying a 200px floor forever drew an SVG
+ *   wider than its own container inside any narrower grid cell.
+ * - **height** — the legend band is subtracted first (it always was), but the remainder can no
+ *   longer collapse: eight entries wrapping to five rows at phone width ate a fixed
+ *   `height={240}` toward zero and the body stopped rendering entirely. The plot stops at
+ *   `VX.minPlotHeight` and the frame's own box grows by the difference instead — it is a flex
+ *   column with `height: auto`, so that growth is automatic. Under `fill` the box CANNOT grow, so
+ *   the legend is capped instead ({@link legendEntryCap}). An unmeasured box (`resolvedHeight <=
+ *   0`, i.e. a `fill` frame before its first measurement) stays at 0 and renders nothing, exactly
+ *   as before — the floor must never invent a height for a box nobody has measured.
+ */
+export declare function resolvePlotRect(input: {
+    containerW: number;
+    resolvedHeight: number;
+    minWidth: number;
+    sideLegendWidth: number;
+    topBottomLegendHeight: number;
+}): {
+    width: number;
+    height: number;
+};
+/**
+ * The entry cap a `fill` frame's legend must respect so the plot keeps `VX.minPlotHeight`.
+ *
+ * A fixed-height frame grows to fit its legend; a `fill` frame is pinned to its cell, so the only
+ * remaining lever is `ChartLegend`'s `maxRows` rollup (an ENTRY cap — see its JSDoc). The rows the
+ * legend may take follow from the height left over; how many entries that is follows from
+ * MEASURING the labels, not from assuming one entry per row — otherwise a five-entry legend that
+ * fits on one line would roll up to `+2 more` in every 240px cell, moving rendering for charts
+ * that never had the bug. Returns `undefined` when the whole legend already fits.
+ */
+export declare function legendEntryCap(input: {
+    items: readonly LegendEntry[];
+    containerW: number;
+    /** Frame height the legend may consume — `resolvedHeight - VX.minPlotHeight`. */
+    available: number;
+    /** An explicit caller cap always wins as the upper bound. */
+    callerMaxRows?: number;
+}): number | undefined;
+//# sourceMappingURL=chart-frame-layout.d.ts.map

package/dist/charts/primitives/chart-frame-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-frame-layout.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/chart-frame-layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAUhD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAE9D;AAqBD;6FAC6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2FAA2F;IAC3F,IAAI,EAAE,SAAS,CAAA;IACf;uFACmF;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAA;IACtB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAA;IACvB;yDACqD;IACrD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAA;CACpB,CAAA;AA6BD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAElE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;CAC9B,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOpC;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,MAAM,GAAG,SAAS,CAerB"}

package/dist/charts/primitives/chart-frame-layout.js

@@ -0,0 +1,89 @@
+import { VX } from "../../tokens/index.js";
+import { measureText } from "../utils/measure-text.js";
+const LEGEND_LINE_H = Math.ceil(VX.legendFontSize * 1.35);
+const LEGEND_PAD_Y = 10;
+const LEGEND_SWATCH_W = 24;
+function resolveChartTier(containerW) {
+  return containerW > 0 && containerW < VX.phoneChartWidth ? "phone" : "desktop";
+}
+const PHONE_MARGIN_SCALE = 0.75;
+const PHONE_DOT_R = Math.max(VX.dotR - 1, 2);
+const PHONE_LEGEND_MAX_ROWS = 2;
+const TOOLTIP_MIN_WIDTH = { desktop: 140, phone: 110 };
+const DESKTOP_METRICS = {
+  tier: "desktop",
+  axisFont: VX.axisFont,
+  legendFontSize: VX.legendFontSize,
+  dotR: VX.dotR,
+  tooltipMinWidth: TOOLTIP_MIN_WIDTH.desktop,
+  legendMaxRows: void 0,
+  margin: VX.margin
+};
+const PHONE_METRICS = {
+  tier: "phone",
+  // One step DOWN the shared type ladder, never an arbitrary px value: micro → nano for ticks,
+  // sm → xs for the legend (`TEXT` in tokens/index.ts).
+  axisFont: VX.text.nano,
+  legendFontSize: VX.text.xs,
+  dotR: PHONE_DOT_R,
+  tooltipMinWidth: TOOLTIP_MIN_WIDTH.phone,
+  legendMaxRows: PHONE_LEGEND_MAX_ROWS,
+  margin: {
+    top: Math.round(VX.margin.top * PHONE_MARGIN_SCALE),
+    right: Math.round(VX.margin.right * PHONE_MARGIN_SCALE),
+    bottom: Math.round(VX.margin.bottom * PHONE_MARGIN_SCALE),
+    left: Math.round(VX.margin.left * PHONE_MARGIN_SCALE)
+  }
+};
+function chartTierMetrics(tier) {
+  return tier === "phone" ? PHONE_METRICS : DESKTOP_METRICS;
+}
+function resolvePlotRect(input) {
+  const { containerW, resolvedHeight, minWidth, sideLegendWidth, topBottomLegendHeight } = input;
+  return {
+    width: containerW === 0 ? minWidth : Math.max(containerW - sideLegendWidth, 1),
+    height: resolvedHeight <= 0 ? 0 : Math.max(resolvedHeight - topBottomLegendHeight, VX.minPlotHeight)
+  };
+}
+const legendBandHeight = (rows) => LEGEND_PAD_Y + rows * LEGEND_LINE_H + Math.max(rows - 1, 0) * VX.legendGap;
+const legendEntryWidth = (item) => LEGEND_SWATCH_W + measureText(
+  item.note === void 0 ? item.label : `${item.label} ${item.note}`,
+  VX.legendFontSize
+);
+function entriesWithinRows(items, width, rows) {
+  let row = 1;
+  let x = 0;
+  let fitted = 0;
+  for (const item of items) {
+    const w = legendEntryWidth(item);
+    const next = x === 0 ? w : x + VX.legendGap + w;
+    if (next > width && x > 0) {
+      row += 1;
+      if (row > rows) return fitted;
+      x = w;
+    } else {
+      x = next;
+    }
+    fitted += 1;
+  }
+  return fitted;
+}
+function legendEntryCap(input) {
+  const { items, containerW, available, callerMaxRows } = input;
+  if (containerW <= 0 || items.length === 0) return callerMaxRows;
+  const rows = Math.max(
+    1,
+    Math.floor((available - LEGEND_PAD_Y + VX.legendGap) / (LEGEND_LINE_H + VX.legendGap))
+  );
+  if (legendBandHeight(rows) <= available && entriesWithinRows(items, containerW, rows) >= items.length) {
+    return callerMaxRows;
+  }
+  const fitted = Math.max(1, entriesWithinRows(items, containerW, rows));
+  return callerMaxRows === void 0 ? fitted : Math.min(fitted, callerMaxRows);
+}
+export {
+  chartTierMetrics,
+  legendEntryCap,
+  resolveChartTier,
+  resolvePlotRect
+};

package/dist/charts/primitives/chart-tier.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import { chartTierMetrics, resolveChartTier } from './chart-frame-layout.js';
+import type { ChartTier, ChartTierMetrics } from './chart-frame-layout.js';
+export type ChartTierProviderProps = {
+    tier: ChartTier;
+    children: ReactNode;
+};
+/** Publishes a resolved tier to the subtree. Mounted once, by `ChartFrame`. */
+export declare function ChartTierProvider({ tier, children }: ChartTierProviderProps): ReactNode;
+/** The tier of the nearest measured `ChartFrame`, or `'desktop'` outside one. */
+export declare function useChartTier(): ChartTier;
+/** The resolved sizes for the ambient tier — the form every primitive actually wants. */
+export declare function useChartTierMetrics(): ChartTierMetrics;
+export { chartTierMetrics, resolveChartTier };
+export type { ChartTier, ChartTierMetrics };
+//# sourceMappingURL=chart-tier.d.ts.map

package/dist/charts/primitives/chart-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-tier.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/chart-tier.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAYvE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAEvF;AAED,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;AAC7C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/charts/primitives/chart-tier.js

@@ -0,0 +1,20 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { chartTierMetrics, resolveChartTier } from "./chart-frame-layout.js";
+const ChartTierContext = createContext("desktop");
+function ChartTierProvider({ tier, children }) {
+  return /* @__PURE__ */ jsx(ChartTierContext.Provider, { value: tier, children });
+}
+function useChartTier() {
+  return useContext(ChartTierContext);
+}
+function useChartTierMetrics() {
+  return chartTierMetrics(useContext(ChartTierContext));
+}
+export {
+  ChartTierProvider,
+  chartTierMetrics,
+  resolveChartTier,
+  useChartTier,
+  useChartTierMetrics
+};

package/dist/charts/series.d.ts

@@ -6,6 +6,7 @@
  * every kind. `LegendPlacement` also lives here so `ChartLegend` and the future `ChartFrame`
  * share one definition.
  */
+import { curveMonotoneX } from '@visx/curve';
 import type { LegendEntry } from './primitives/ChartLegend.js';
 /**
  * Default stroke width for plotted line overlays in `DualPanel` / `MultiLine` / `ZonedLine` —
@@ -19,6 +20,30 @@ export declare const LINE_OVERLAY_STROKE_WIDTH = 1.9;
 export type SeriesMark = 'line' | 'bar' | 'area';
 /** Only meaningful for `mark: 'line'`. */
 export type SeriesDash = 'solid' | 'dashed';
+/**
+ * The interpolation between two plotted points. Named rather than a raw d3 `CurveFactory` so the
+ * set is closed, serializable, and identical across every kind — a chart cannot pick a curve the
+ * legend swatch and the sibling chart next to it do not also understand.
+ *
+ * - `monotone` (default, today's behaviour everywhere) — smoothed, overshoot-free.
+ * - `linear` — straight segments. The honest choice when the points are samples, not a signal.
+ * - `step` / `stepAfter` / `stepBefore` — the value HOLDS between samples and changes at one x.
+ *   Reach for these when the quantity is piecewise-constant (a price tier, a config value, a
+ *   discrete state): a smoothed curve through them draws intermediate values that never existed.
+ *   `stepAfter` holds the value forward from its own x, `stepBefore` holds it back from the next,
+ *   `step` changes at the midpoint.
+ */
+export type SeriesCurve = 'monotone' | 'linear' | 'step' | 'stepAfter' | 'stepBefore';
+/** d3's curve-factory shape, taken from a curve we already import rather than from
+ * `@visx/vendor/d3-shape` — that package is a transitive of `@visx/curve`, not one of the nine
+ * exact-pinned peers, so naming it in an import would add an undeclared dependency. */
+type CurveFactory = typeof curveMonotoneX;
+/**
+ * The d3 curve factory for a {@link SeriesCurve}. `undefined` resolves to `curveMonotoneX` — the
+ * value every kind hard-coded before this seam existed, so an omitted `curve` moves nothing.
+ * Exported for a hand-composed plot that draws its own `LinePath` from the same `series` array.
+ */
+export declare function curveFor(curve?: SeriesCurve): CurveFactory;
 /** Drives legend grouping/dividers. */
 export type SeriesRole = 'series' | 'overlay' | 'reference';
 /** Where the derived legend renders relative to the plot. */
@@ -48,6 +73,12 @@ export type SeriesStyle = {
     mark: SeriesMark;
     /** Default 'solid'. */
     dash?: SeriesDash;
+    /**
+     * Interpolation between points for the line/area shapes this series draws. Default `'monotone'`
+     * — today's behaviour, unchanged, everywhere. See {@link SeriesCurve} for when a step curve is
+     * the honest one. Silently no-ops on `mark: 'bar'`, which has nothing to interpolate.
+     */
+    curve?: SeriesCurve;
     /** Default VX.lineWidth (one width, everywhere). */
     strokeWidth?: number;
     /** bar/area: the swatch honors this so it cannot lie. */
@@ -86,7 +117,12 @@ export type SeriesStyle = {
 };
 /** Full descriptor = visual identity + data accessors. Generic over the point type. */
 export type ChartSeries<T> = SeriesStyle & {
-    /** null = line gap + skipped tooltip row. */
+    /**
+     * null = an ABSENCE, never a zero: a real gap in the line/area (`defined`, not a straight
+     * interpolation across the hole) plus a skipped tooltip row and no crosshair dot. In a STACKED
+     * kind the absence is contagious — a band with no value leaves no cumulative total, so the whole
+     * stack gaps at that x (`StackedArea`'s JSDoc has the accounting).
+     */
     getValue: (d: T) => number | null;
     /** 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 ×
@@ -129,4 +165,22 @@ export declare function deriveLegend(series: readonly SeriesStyle[]): LegendEntr
  * 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[];
+/**
+ * Coerces a `ChartSeries.getValue` result into what a plotted point stores as its y: `null`,
+ * `undefined` and `NaN` all collapse to `null`, which downstream `definedOn` reads as a
+ * documented gap rather than a value to plot. Shared by `MultiLine`'s `seriesPoints` and
+ * `ZonedLine`'s `linePoints` — both used to reimplement this coercion independently.
+ */
+export declare function toPlotPoint(v: number | null | undefined): number | null;
+/**
+ * A `defined` predicate for `LinePath`/`AreaClosed`/`Threshold`, bound to one y-scale. A null
+ * `__y` is a documented gap (`ChartSeries.getValue`), and a non-positive value on a log scale maps
+ * to `NaN` via the scale itself — without excluding both, d3's generators either draw an
+ * interpolated straight line across the hole or blank the entire path from that point on (SVG's
+ * `NaN` path-command handling). Shared by `MultiLine` and `ZonedLine`.
+ */
+export declare function definedOn(scale: (y: number) => number): (d: {
+    __y: number | null;
+}) => boolean;
+export {};
 //# sourceMappingURL=series.d.ts.map

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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,cAAc,EAIf,MAAM,aAAa,CAAA;AACpB,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;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAA;AAErF;;uFAEuF;AACvF,KAAK,YAAY,GAAG,OAAO,cAAc,CAAA;AAUzC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY,CAE1D;AAED,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;IAChB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,OAAO,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;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;6FACyF;IACzF,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,wBAAwB;IACxB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;gCAC4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,WAAW,GAAG;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IACjC;;eAEW;IACX,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACzC;sGACkG;IAClG,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAClG,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;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAoB1E;AAED;;;;;GAKG;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,CAkBlB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAK,OAAO,CAE9F"}

package/dist/charts/series.js

@@ -1,4 +1,21 @@
+import {
+  curveLinear,
+  curveMonotoneX,
+  curveStep,
+  curveStepAfter,
+  curveStepBefore
+} from "@visx/curve";
 const LINE_OVERLAY_STROKE_WIDTH = 1.9;
+const CURVES = {
+  monotone: curveMonotoneX,
+  linear: curveLinear,
+  step: curveStep,
+  stepAfter: curveStepAfter,
+  stepBefore: curveStepBefore
+};
+function curveFor(curve) {
+  return curve === void 0 ? curveMonotoneX : CURVES[curve];
+}
 const shapeFor = (mark) => mark === "line" ? "line" : "bar";
 function legendEntryFor(s) {
   return {
@@ -51,8 +68,17 @@ function deriveTooltipRows(series, datum, fallbackFormat) {
   }
   return rows;
 }
+function toPlotPoint(v) {
+  return v === null || v === void 0 || Number.isNaN(v) ? null : v;
+}
+function definedOn(scale) {
+  return (d) => d.__y !== null && Number.isFinite(scale(d.__y));
+}
 export {
   LINE_OVERLAY_STROKE_WIDTH,
+  curveFor,
+  definedOn,
   deriveLegend,
-  deriveTooltipRows
+  deriveTooltipRows,
+  toPlotPoint
 };

package/dist/charts/sparklines/BarSparkline.d.ts

@@ -1,4 +1,5 @@
-type BarSparklineProps = {
+import type { BasaltProps } from '../../common/props.js';
+export type BarSparklineProps = BasaltProps & {
     data: number[];
     width: number;
     height: number;
@@ -32,6 +33,5 @@ type BarSparklineProps = {
 /** Quiet inline bar trend — defaults to `VX.faint`, matching the sparkline family's restrained
  * identity (docs/DESIGN-SPEC.md §5). Every geometry option below defaults to the shipped look, so
  * an existing call site renders byte-identically. */
-export declare function BarSparkline({ data, width, height, color, barGap, barRadius, emphasizeLast, emphasisColor, ariaLabel, }: BarSparklineProps): import("react").JSX.Element;
-export {};
+export declare function BarSparkline({ data, width, height, color, barGap, barRadius, emphasizeLast, emphasisColor, ariaLabel, className, style, }: BarSparklineProps): import("react").JSX.Element;
 //# sourceMappingURL=BarSparkline.d.ts.map

package/dist/charts/sparklines/BarSparkline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BarSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/BarSparkline.tsx"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;qDAEqD;AACrD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,MAAU,EACV,SAAa,EACb,aAAqB,EACrB,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,+BAoCnB"}
+{"version":3,"file":"BarSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/BarSparkline.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGrD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;qDAEqD;AACrD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,MAAU,EACV,SAAa,EACb,aAAqB,EACrB,aAAa,EACb,SAAS,EACT,SAAS,EACT,KAAK,GACN,EAAE,iBAAiB,+BAyCnB"}