basalt-ui 1.27.0 → 1.28.0

package/dist/charts/index.d.ts

@@ -15,13 +15,14 @@ export type { SeriesKey } from '../register.js';
 export { VxThemeProvider, useVxTheme, type VxTheme } from './theme.js';
 export { ChartCursorScope, type ChartCursorScopeProps, useCursorState } from './cursor/scope.js';
 export { createCursorStore, globalCursorStore, type CursorState, type CursorStore, } from './cursor/store.js';
-export { type SeriesMark, type SeriesDash, type SeriesRole, type LegendPlacement, type ChartLegendConfig, type SeriesStyle, type ChartSeries, deriveLegend, deriveTooltipRows, } from './series.js';
+export { type SeriesMark, type SeriesDash, type SeriesCurve, curveFor, type SeriesRole, type LegendPlacement, type ChartLegendConfig, type SeriesStyle, type ChartSeries, deriveLegend, deriveTooltipRows, } from './series.js';
 export { CartesianChart, resolveAxisDomain, type CartesianChartProps, type CartesianTooltipConfig, type CartesianTooltipRowContext, type AxisConfig, type PlotContext, } from './primitives/CartesianChart.js';
 export { ChartFrame, type ChartFrameProps, type ChartFrameLegend, type PlotRect, resolveLegend, } from './primitives/ChartFrame.js';
-export { ChartCenter, type ChartCenterProps, ChartPending, type ChartPendingProps, } from './primitives/ChartPending.js';
+export { ChartCenter, type ChartCenterProps, ChartPending, type ChartPendingProps, ChartEmpty, type ChartEmptyProps, ChartError, type ChartErrorProps, type ChartState, type ResolvedChartState, resolveChartState, } from './primitives/ChartPending.js';
+export { useChartTier, useChartTierMetrics, chartTierMetrics, resolveChartTier, type ChartTier, type ChartTierMetrics, } from './primitives/chart-tier.js';
 export { Crosshair, SeriesDot } from './primitives/Crosshair.js';
 export { HatchPattern, hatchFill, hatchSizeFor } from './primitives/HatchPattern.js';
-export { ChartCard, type ChartCardProps } from './primitives/ChartCard.js';
+export { ChartCard, type ChartCardProps, type ChartCardSlot } from './primitives/ChartCard.js';
 export { ChartLegend, type LegendEntry } from './primitives/ChartLegend.js';
 export { ChartTooltipFloat, TooltipHeader, TooltipRow, TooltipBody, } from './primitives/ChartTooltip.js';
 export { AxisBottomDate, AxisLeftNumeric, AxisRightNumeric } from './primitives/Axes.js';
@@ -33,8 +34,8 @@ export { useChartCursor, type ChartCursor, type CursorAnchor } from './hooks/use
 export { foldBands, type BandFold, type BandTooltipConfig, type BandTooltipRowContext, } from './hooks/useBandPlot.js';
 export type { CursorResolution, DomainKind } from './cursor/resolve.js';
 export { useChartSize, type UseChartSizeResult, type ChartSize } from './hooks/useChartSize.js';
-export { fmtAxisDate, fmtTooltipDate } from './utils/format.js';
-export { smartTicks, smartTicksEvery } from './utils/ticks.js';
+export { fmtAxisDate, fmtTooltipDate, fmtCompact, type FmtCompactOptions, fmtPercent, type FmtPercentOptions, fmtCurrency, type FmtCurrencyOptions, fmtInt, formatters, } from './utils/format.js';
+export { smartTicks, smartTicksEvery, xLabelPxFor, autoXLabelRotate } from './utils/ticks.js';
 export { autoMargin, probeAxisLabels, type AutoMarginInput } from './layout/auto-margin.js';
 export { measureText, maxTextWidth } from './utils/measure-text.js';
 export { ZonedLine, type ZonedLineProps, type ZonedLineZone, type ZonedLineThreshold, type ZonedLineRefLine, } from './kinds/ZonedLine.js';
@@ -46,11 +47,11 @@ export { DualPanel, type DualPanelProps } from './kinds/DualPanel.js';
 export { Heatmap, type HeatmapProps } from './kinds/Heatmap.js';
 export { BandStrip, type BandStripProps, type BandStripSeries, type BandSpan, } from './kinds/BandStrip.js';
 export { MirroredBars, type MirroredBarsProps, type MirroredBarPane } from './kinds/MirroredBars.js';
-export { LineSparkline, BarSparkline } from './sparklines/index.js';
+export { LineSparkline, type LineSparklineProps, BarSparkline, type BarSparklineProps, } from './sparklines/index.js';
 export { Group } from '@visx/group';
 export { GridRows, GridColumns } from '@visx/grid';
 export { scaleLinear, scaleBand, scalePoint, scaleTime } from '@visx/scale';
 export { LinePath, Bar, AreaClosed, AreaStack, BarStack, BarGroup, Line, Pie } from '@visx/shape';
 export { Threshold } from '@visx/threshold';
-export { curveMonotoneX, curveLinear, curveCatmullRom, curveStepAfter, curveBasis, } from '@visx/curve';
+export { curveMonotoneX, curveLinear, curveCatmullRom, curveStep, curveStepAfter, curveStepBefore, curveBasis, } from '@visx/curve';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/charts/index.js

@@ -14,6 +14,7 @@ import {
   globalCursorStore
 } from "./cursor/store.js";
 import {
+  curveFor,
   deriveLegend,
   deriveTooltipRows
 } from "./series.js";
@@ -27,8 +28,17 @@ import {
 } from "./primitives/ChartFrame.js";
 import {
   ChartCenter,
-  ChartPending
+  ChartPending,
+  ChartEmpty,
+  ChartError,
+  resolveChartState
 } from "./primitives/ChartPending.js";
+import {
+  useChartTier,
+  useChartTierMetrics,
+  chartTierMetrics,
+  resolveChartTier
+} from "./primitives/chart-tier.js";
 import { Crosshair, SeriesDot } from "./primitives/Crosshair.js";
 import { HatchPattern, hatchFill, hatchSizeFor } from "./primitives/HatchPattern.js";
 import { ChartCard } from "./primitives/ChartCard.js";
@@ -49,8 +59,16 @@ import {
   foldBands
 } from "./hooks/useBandPlot.js";
 import { useChartSize } from "./hooks/useChartSize.js";
-import { fmtAxisDate, fmtTooltipDate } from "./utils/format.js";
-import { smartTicks, smartTicksEvery } from "./utils/ticks.js";
+import {
+  fmtAxisDate,
+  fmtTooltipDate,
+  fmtCompact,
+  fmtPercent,
+  fmtCurrency,
+  fmtInt,
+  formatters
+} from "./utils/format.js";
+import { smartTicks, smartTicksEvery, xLabelPxFor, autoXLabelRotate } from "./utils/ticks.js";
 import { autoMargin, probeAxisLabels } from "./layout/auto-margin.js";
 import { measureText, maxTextWidth } from "./utils/measure-text.js";
 import {
@@ -68,7 +86,10 @@ import {
   BandStrip
 } from "./kinds/BandStrip.js";
 import { MirroredBars } from "./kinds/MirroredBars.js";
-import { LineSparkline, BarSparkline } from "./sparklines/index.js";
+import {
+  LineSparkline,
+  BarSparkline
+} from "./sparklines/index.js";
 import { Group } from "@visx/group";
 import { GridRows, GridColumns } from "@visx/grid";
 import { scaleLinear, scaleBand, scalePoint, scaleTime } from "@visx/scale";
@@ -78,7 +99,9 @@ import {
   curveMonotoneX,
   curveLinear,
   curveCatmullRom,
+  curveStep,
   curveStepAfter,
+  curveStepBefore,
   curveBasis
 } from "@visx/curve";
 export {
@@ -98,6 +121,8 @@ export {
   ChartCard,
   ChartCenter,
   ChartCursorScope,
+  ChartEmpty,
+  ChartError,
   ChartFrame,
   ChartLegend,
   ChartPending,
@@ -131,20 +156,30 @@ export {
   alpha,
   areaFillUrl,
   autoMargin,
+  autoXLabelRotate,
   buildPaletteCss,
   chartMargin,
+  chartTierMetrics,
   createCursorStore,
   curveBasis,
   curveCatmullRom,
+  curveFor,
   curveLinear,
   curveMonotoneX,
+  curveStep,
   curveStepAfter,
+  curveStepBefore,
   defineSeries,
   deriveLegend,
   deriveTooltipRows,
   fmtAxisDate,
+  fmtCompact,
+  fmtCurrency,
+  fmtInt,
+  fmtPercent,
   fmtTooltipDate,
   foldBands,
+  formatters,
   globalCursorStore,
   groupTokens,
   hatchFill,
@@ -153,6 +188,8 @@ export {
   measureText,
   probeAxisLabels,
   resolveAxisDomain,
+  resolveChartState,
+  resolveChartTier,
   resolveLegend,
   scaleBand,
   scaleLinear,
@@ -163,6 +200,9 @@ export {
   smartTicksEvery,
   useChartCursor,
   useChartSize,
+  useChartTier,
+  useChartTierMetrics,
   useCursorState,
-  useVxTheme
+  useVxTheme,
+  xLabelPxFor
 };

package/dist/charts/kinds/BandStrip.d.ts

@@ -1,6 +1,8 @@
+import type { BasaltProps } from '../../common/props.js';
 import type { ChartMargin } from '../../tokens/index.js';
 import type { CursorResolution } from '../cursor/resolve.js';
 import type { BandFold, BandTooltipConfig } from '../hooks/useBandPlot.js';
+import type { ChartState } from '../primitives/ChartPending.js';
 import type { ChartLegendConfig, SeriesStyle } from '../series.js';
 /**
  * A state a strip can draw. Extends `SeriesStyle` rather than `ChartSeries` because a band has no
@@ -58,7 +60,7 @@ export type BandSpan = {
         inset?: number;
     };
 };
-export type BandStripProps<T> = {
+export type BandStripProps<T> = BasaltProps & {
     data: readonly T[];
     /** Stable id — identifies this chart as the cursor's source. */
     chartId: string;
@@ -90,8 +92,10 @@ export type BandStripProps<T> = {
     cursorResolution?: CursorResolution;
     tooltip?: BandTooltipConfig<T> | false;
     legend?: ChartLegendConfig | false;
-    /** Colour of the absence hatch. Names a `series` entry, so absence is legended like any other
-     * state — a hatched band is the one mark a reader cannot decode from an axis. Default
+    /** Colour of the absence hatch, AND the state that is absent. Names a `series` entry, so absence
+     * is legended like any other state — a hatched band is the one mark a reader cannot decode from
+     * an axis. A slot in this state hatches across its whole width unless its own `absentFraction`
+     * says otherwise; a slot in any other state hatches only its `absentFraction`. Default
      * `VX.neutral`, unnamed. A key naming no `series` entry throws (a PROP, so a typo can only be a
      * wiring error) rather than falling back to the unnamed default. */
     absentState?: string;
@@ -102,6 +106,9 @@ export type BandStripProps<T> = {
     ariaLabel?: string;
     /** Forwarded to `ChartFrame` — see `ChartPending`'s JSDoc. */
     isPending?: boolean;
+    /** The three "nothing to draw" states in one prop — pending → error → empty. See
+     * `ChartState`; `isPending` stays a supported alias for `state={{ pending: true }}`. */
+    state?: ChartState;
 };
 /**
  * A 1-D categorical band strip: one rect per slot over a shared x axis, no y dimension at all.
@@ -118,10 +125,6 @@ export type BandStripProps<T> = {
  * nothing measured, and a fact that must not be read off the ramp.
  */
 declare function BandStripInner<T>(props: BandStripProps<T>): import("react").JSX.Element;
-/**
- * Hand-memoized: React Compiler does not process the shipped dist, so the hot kind is wrapped in
- * `React.memo` to retain the auto-memoization it had as source (parity with `DualPanel`).
- */
 export declare const BandStrip: typeof BandStripInner;
 export {};
 //# sourceMappingURL=BandStrip.d.ts.map

package/dist/charts/kinds/BandStrip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BandStrip.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/BandStrip.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAYvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG/D;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,GAAG;IAC7C;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IACrB;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QACP,iFAAiF;QACjF,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,uEAAuE;QACvE,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf;yFACqF;IACrF,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;sCACkC;IAClC,MAAM,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACrC,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAA;IAC3B;kEAC8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,mDAAmD;IACnD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAA;IAC/E,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAClB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IACtC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC;;;wEAGoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B;iDAC6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAkDD;;;;;;;;;;;;;GAaG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAgBlD;AAwPD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAA2B,OAAO,cAAc,CAAA"}
+{"version":3,"file":"BandStrip.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/BandStrip.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAYvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAI/D;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,GAAG;IAC7C;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IACrB;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QACP,iFAAiF;QACjF,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,uEAAuE;QACvE,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,WAAW,GAAG;IAC5C,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf;yFACqF;IACrF,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;sCACkC;IAClC,MAAM,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACrC,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAA;IAC3B;kEAC8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,mDAAmD;IACnD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAA;IAC/E,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAClB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IACtC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC;;;;;wEAKoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B;iDAC6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;4FACwF;IACxF,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AA2CD;;;;;;;;;;;;;GAaG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAwBlD;AAwQD,eAAO,MAAM,SAAS,EAAoB,OAAO,cAAc,CAAA"}

package/dist/charts/kinds/BandStrip.js

@@ -1,6 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Group } from "@visx/group";
 import { memo, useMemo } from "react";
+import { assertRequiredProps } from "../../common/validate.js";
 import { VX, alpha } from "../../tokens/index.js";
 import { useBandPlot } from "../hooks/useBandPlot.js";
 import { AxisBottomDate } from "../primitives/Axes.js";
@@ -15,6 +16,7 @@ import { Crosshair } from "../primitives/Crosshair.js";
 import { HatchPattern, hatchFill, hatchSizeFor } from "../primitives/HatchPattern.js";
 import { HoverOverlay } from "../primitives/HoverOverlay.js";
 import { fmtAxisDate } from "../utils/format.js";
+import { isDev } from "../../utils/is-dev.js";
 const DEFAULT_MARKER_INSET = 6;
 const NO_READING = "\u2014";
 const UNKNOWN_MARK = {
@@ -23,9 +25,6 @@ const UNKNOWN_MARK = {
   strokeWidth: 1,
   strokeDasharray: "3 2"
 };
-function isDev() {
-  return process.env["NODE_ENV"] !== "production";
-}
 function unknownStateError(what, key, known) {
   return new Error(
     `BandStrip: ${what} "${key}" names no \`series\` entry (known: ${[...known].join(", ")}) \u2014 so it has no legend entry, no colour and no tooltip row. Add the state to \`series\`, or map the datum onto one that is there.`
@@ -36,7 +35,8 @@ function formatBandValue(style, datum) {
   return style.formatValue(datum) ?? NO_READING;
 }
 function BandStripInner(props) {
-  const { series, chartId, height, fill, legend, ariaLabel, isPending } = props;
+  assertRequiredProps("BandStrip", props, ["data", "getX", "series", "getBand"]);
+  const { series, chartId, height, fill, legend, ariaLabel, isPending, state, className, style } = props;
   return /* @__PURE__ */ jsx(
     ChartFrame,
     {
@@ -46,6 +46,9 @@ function BandStripInner(props) {
       ...fill !== void 0 && { fill },
       ...ariaLabel !== void 0 && { ariaLabel },
       ...isPending !== void 0 && { isPending },
+      ...state !== void 0 && { state },
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
       legend: resolveLegend(legend),
       children: (plot) => /* @__PURE__ */ jsx(BandStripPlot, { ...props, plot })
     }
@@ -115,7 +118,7 @@ function BandStripPlot(props) {
         return;
       }
       if (hidden.has(span.state)) return;
-      const absent = clampFraction(span.absentFraction);
+      const absent = span.state === absentState ? clampFraction(span.absentFraction ?? 1) : clampFraction(span.absentFraction);
       const measuredWidth = bandWidth * (1 - absent);
       const hatchWidth = bandWidth - measuredWidth;
       const markerKey = span.marker?.state ?? span.state;
@@ -166,7 +169,7 @@ function BandStripPlot(props) {
       );
     });
     return out;
-  }, [bands, getBand, getX, styleByKey, hidden, bandWidth, step, stripHeight, hatchId]);
+  }, [bands, getBand, getX, styleByKey, hidden, bandWidth, step, stripHeight, hatchId, absentState]);
   if (plotWidth <= 0 || bands.length === 0) return null;
   const cfg = tooltip === false ? void 0 : tooltip;
   const badge = cfg?.label === void 0 || point === null ? null : cfg.label(point);
@@ -265,7 +268,9 @@ function deriveBandRow(span, styleByKey, hidden, datum) {
     dashed: style.dash === "dashed"
   };
 }
-const BandStrip = memo(BandStripInner);
+const BandStripMemo = memo(BandStripInner);
+BandStripMemo.displayName = "BandStrip";
+const BandStrip = BandStripMemo;
 export {
   BandStrip
 };

package/dist/charts/kinds/Bars.d.ts

@@ -1,8 +1,10 @@
+import type { BasaltProps } from '../../common/props.js';
 import type { CursorResolution } from '../cursor/resolve.js';
 import type { ChartMargin } from '../../tokens/index.js';
 import type { AxisConfig, CartesianTooltipConfig } from '../primitives/CartesianChart.js';
 import type { ZoneSpec } from '../primitives/ZoneRects.js';
-import type { ChartLegendConfig } from '../series.js';
+import type { ChartState } from '../primitives/ChartPending.js';
+import type { ChartLegendConfig, SeriesCurve } from '../series.js';
 /**
  * `T = unknown` is load-bearing, not a shortcut: it keeps a consumer's existing
  * `const bars: BarsBar[] = [...]` compiling (and still assignable to `BarsBar<Row>[]`,
@@ -39,6 +41,8 @@ export type BarsLine<T = unknown> = {
     tooltip?: boolean;
     /** Dims the plotted stroke AND the legend swatch, never the tooltip row (`SeriesStyle.strokeOpacity`). */
     strokeOpacity?: number;
+    /** Interpolation for this overlay. Default `'monotone'` — see `SeriesCurve`. */
+    curve?: SeriesCurve;
 };
 /** @deprecated Use ZoneSpec from primitives/ZoneRects. Kept as an alias. */
 export type BarsZone = ZoneSpec;
@@ -49,7 +53,7 @@ export type BarsRefLine = {
     dashed?: boolean;
     axisSide?: 'left' | 'right';
 };
-export type BarsProps<T> = {
+export type BarsProps<T> = BasaltProps & {
     data: T[];
     /** Fixed height in pixels, forwarded to `CartesianChart`. Default 240. */
     height?: number;
@@ -95,6 +99,9 @@ export type BarsProps<T> = {
     xTickValues?: (keys: readonly string[], xMax: number) => readonly string[];
     /** X tick label formatter. Default `fmtAxisDate` (DD.MM). */
     formatX?: (key: string) => string;
+    /** Tilt the x tick labels 45° or 90°, or `0` to opt out of the phone tier's auto-rotation —
+     * see `CartesianChartProps.xLabelRotate`. */
+    xLabelRotate?: 0 | 45 | 90;
     /**
      * How a sibling chart's broadcast cursor key resolves against this chart's points. Default
      * `'nearest'`. Pass `'leading'` when `getX` returns a bucket's leading edge (a weekly series
@@ -112,6 +119,9 @@ export type BarsProps<T> = {
     ariaLabel?: string;
     /** Forwarded to `CartesianChart` — see `ChartPending`'s JSDoc for the three-state rationale. */
     isPending?: boolean;
+    /** The three "nothing to draw" states in one prop — pending → error → empty. See
+     * `ChartState`; `isPending` stays a supported alias for `state={{ pending: true }}`. */
+    state?: ChartState;
 };
 /**
  * Bars on a categorical x-axis with optional stacked negative series, 0–2 line
@@ -126,10 +136,6 @@ export type BarsProps<T> = {
  * with per-bar nulls (nulls become visual gaps, not domain holes).
  */
 declare function BarsInner<T>(props: BarsProps<T>): import("react").JSX.Element;
-/**
- * Hand-memoized: React Compiler does not process the shipped dist, so we wrap the
- * hot bars kind in `React.memo` to retain the auto-memoization it had as source.
- */
 export declare const Bars: typeof BarsInner;
 export {};
 //# sourceMappingURL=Bars.d.ts.map

package/dist/charts/kinds/Bars.d.ts.map

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

package/dist/charts/kinds/Bars.js

@@ -1,12 +1,14 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { curveMonotoneX } from "@visx/curve";
 import { LinePath } from "@visx/shape";
 import { memo, useMemo } from "react";
+import { assertRequiredProps } from "../../common/validate.js";
 import { VX } from "../../tokens/index.js";
 import { CartesianChart } from "../primitives/CartesianChart.js";
-import { LINE_OVERLAY_STROKE_WIDTH } from "../series.js";
+import { curveFor, LINE_OVERLAY_STROKE_WIDTH } from "../series.js";
 import { padAutoLower } from "../utils/domain.js";
+import { isDev } from "../../utils/is-dev.js";
 function BarsInner(props) {
+  assertRequiredProps("Bars", props, ["data", "getX", "getValue", "positiveBars"]);
   const {
     data,
     height,
@@ -26,13 +28,22 @@ function BarsInner(props) {
     xTicks,
     xTickValues,
     formatX,
+    xLabelRotate,
     cursorResolution,
     tooltip,
     margin,
     legend,
     ariaLabel,
-    isPending
+    isPending,
+    state,
+    className,
+    style
   } = props;
+  if (isDev() && barLayout === "stacked" && y?.scale === "log") {
+    throw new Error(
+      `Bars: stacked bars cannot use a log axis (y.scale: "log") \u2014 the stack sums bar heights, and a log axis has no additive zero to sum from. Use barLayout: 'grouped' instead.`
+    );
+  }
   const barSeries = useMemo(
     () => [...positiveBars, ...negativeBars].map((b) => ({
       key: b.key,
@@ -131,6 +142,7 @@ function BarsInner(props) {
       ...xTicks !== void 0 && { xTicks },
       ...xTickValues !== void 0 && { xTickValues },
       ...formatX !== void 0 && { formatX },
+      ...xLabelRotate !== void 0 && { xLabelRotate },
       ...cursorResolution !== void 0 && { cursorResolution },
       ...zones !== void 0 && { zones },
       ...mappedRefLines !== void 0 && { refLines: mappedRefLines },
@@ -140,6 +152,9 @@ function BarsInner(props) {
       ...margin !== void 0 && { margin },
       ...ariaLabel !== void 0 && { ariaLabel },
       ...isPending !== void 0 && { isPending },
+      ...state !== void 0 && { state },
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
       children: (ctx) => /* @__PURE__ */ jsx(
         BarsMarks,
         {
@@ -172,9 +187,17 @@ function BarsMarks({
   const barGroups = useMemo(() => {
     const scaleForSide2 = (side) => side === "right" && y2Scale ? y2Scale : yScale;
     const dim2 = (key) => highlighted === null || highlighted === key ? 1 : 0.15;
+    const baselineFor = (scale) => {
+      const floor = scale.domain()[0] ?? 0;
+      const at = scale(Math.max(floor, 0));
+      return Number.isFinite(at) ? at : scale(floor);
+    };
     const groupWidth = Math.max(xMax / Math.max(rows.length, 1) * barWidthRatio, 2);
-    const totalWeight = barLayout === "grouped" ? positiveBars.reduce((s, b) => s + (b.weight ?? 1), 0) || 1 : 1;
-    const groupedBarWidths = barLayout === "grouped" ? positiveBars.map((b) => Math.max(groupWidth * ((b.weight ?? 1) / totalWeight), 1)) : [];
+    const groupedBars = barLayout === "grouped" ? positiveBars.filter((b) => !hidden.has(b.key)) : [];
+    const totalWeight = groupedBars.reduce((s, b) => s + (b.weight ?? 1), 0) || 1;
+    const groupedBarWidths = groupedBars.map(
+      (b) => Math.max(groupWidth * ((b.weight ?? 1) / totalWeight), 1)
+    );
     const groupedBarOffsets = [];
     let cursor = 0;
     for (const w of groupedBarWidths) {
@@ -225,19 +248,20 @@ function BarsMarks({
           negOffset = top;
         }
       } else {
-        positiveBars.forEach((b, i) => {
-          if (hidden.has(b.key)) return;
+        groupedBars.forEach((b, i) => {
           const v = getValue(d, b.key);
           if (v === null || Number.isNaN(v) || v <= 0) return;
           const scale = scaleForSide2(b.axisSide);
           const yTop = scale(v);
-          const yBottom = scale(0);
+          const yBottom = baselineFor(scale);
           rects.push({
             key: `${getX(d)}-${b.key}`,
             x: groupLeft + (groupedBarOffsets[i] ?? 0),
             y: yTop,
             width: groupedBarWidths[i] ?? 0,
-            height: yBottom - yTop,
+            // A value below a caller-pinned domain floor sits under the baseline; SVG rejects a
+            // negative height outright, so it clamps to nothing drawn.
+            height: Math.max(yBottom - yTop, 0),
             fill: b.color,
             fillOpacity: (barOpacity?.(d, b.key) ?? 0.85) * dim2(b.key)
           });
@@ -304,7 +328,7 @@ function BarsMarks({
           strokeWidth: ln.strokeWidth ?? LINE_OVERLAY_STROKE_WIDTH,
           strokeDasharray: ln.dashed ? VX.dashArray : void 0,
           strokeOpacity: dim(ln.key) * (ln.strokeOpacity ?? 1),
-          curve: curveMonotoneX
+          curve: curveFor(ln.curve)
         },
         `line-${ln.key}`
       );
@@ -312,7 +336,9 @@ function BarsMarks({
     negativeBars.length > 0 && /* @__PURE__ */ jsx("line", { x1: 0, x2: xMax, y1: yScale(0), y2: yScale(0), stroke: VX.grid, strokeWidth: 1 })
   ] });
 }
-const Bars = memo(BarsInner);
+const BarsMemo = memo(BarsInner);
+BarsMemo.displayName = "Bars";
+const Bars = BarsMemo;
 export {
   Bars
 };

package/dist/charts/kinds/Donut.d.ts

@@ -1,4 +1,6 @@
 import type { ReactNode } from 'react';
+import type { BasaltProps } from '../../common/props.js';
+import type { ChartState } from '../primitives/ChartPending.js';
 import type { SeriesKey } from '../../register.js';
 /**
  * `K` defaults to the registered `SeriesKey` union for ergonomic inference on the common case (one
@@ -9,7 +11,7 @@ export type DonutDatum<K extends string = SeriesKey> = {
     key: K;
     value: number;
 };
-export type DonutProps<K extends string = SeriesKey> = {
+export type DonutProps<K extends string = SeriesKey> = BasaltProps & {
     data: DonutDatum<K>[];
     /** Fixed height in pixels, forwarded to the internal `ChartFrame`. Default 240. */
     height?: number;
@@ -48,6 +50,9 @@ export type DonutProps<K extends string = SeriesKey> = {
     ariaLabel?: string;
     /** Forwarded to `ChartFrame` — see `ChartPending`'s JSDoc for the three-state rationale. */
     isPending?: boolean;
+    /** The three "nothing to draw" states in one prop — pending → error → empty. See
+     * `ChartState`; `isPending` stays a supported alias for `state={{ pending: true }}`. */
+    state?: ChartState;
 };
 /**
  * Radial slice-share chart with a punched-out center label. Composes `ChartFrame` for a
@@ -59,10 +64,6 @@ export type DonutProps<K extends string = SeriesKey> = {
  * category sync (donut ↔ bar, via a generalized key) is a distinct, deliberately deferred feature.
  */
 declare function DonutInner<K extends string = SeriesKey>(props: DonutProps<K>): import("react").JSX.Element;
-/**
- * Hand-memoized: React Compiler does not process the shipped dist, so we wrap the
- * hot donut kind in `React.memo` to retain the auto-memoization it had as source.
- */
 export declare const Donut: typeof DonutInner;
 export {};
 //# sourceMappingURL=Donut.d.ts.map

package/dist/charts/kinds/Donut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Donut.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/Donut.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAA;AAKpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI;IAAE,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI;IACrD,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAA;IAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;;;GAQG;AACH,iBAAS,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,+BAoBrE;AA4JD;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAuB,OAAO,UAAU,CAAA"}
+{"version":3,"file":"Donut.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/Donut.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAA;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAG5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI;IAAE,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI,WAAW,GAAG;IACnE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAA;IAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;4FACwF;IACxF,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,CAAA;AAED;;;;;;;;GAQG;AACH,iBAAS,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,+BAqCrE;AAoKD,eAAO,MAAM,KAAK,EAAgB,OAAO,UAAU,CAAA"}

package/dist/charts/kinds/Donut.js

@@ -2,11 +2,23 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { Group } from "@visx/group";
 import { Pie } from "@visx/shape";
 import { memo, useMemo, useState } from "react";
+import { assertRequiredProps } from "../../common/validate.js";
 import { ChartTooltipFloat, TooltipBody, TooltipRow } from "../primitives/ChartTooltip.js";
 import { ChartFrame } from "../primitives/ChartFrame.js";
 import { VX } from "../../tokens/index.js";
 function DonutInner(props) {
-  const { data, height, colorForKey, seriesLabel = (k) => k, ariaLabel, isPending } = props;
+  assertRequiredProps("Donut", props, ["data", "colorForKey"]);
+  const {
+    data,
+    height,
+    colorForKey,
+    seriesLabel = (k) => k,
+    ariaLabel,
+    isPending,
+    state,
+    className,
+    style
+  } = props;
   const series = data.map((d) => ({
     key: d.key,
     label: seriesLabel(d.key),
@@ -20,6 +32,9 @@ function DonutInner(props) {
       ...height !== void 0 && { height },
       ...ariaLabel !== void 0 && { ariaLabel },
       ...isPending !== void 0 && { isPending },
+      ...state !== void 0 && { state },
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
       children: (plot) => /* @__PURE__ */ jsx(DonutPlot, { ...props, plot })
     }
   );
@@ -160,7 +175,9 @@ function DonutPlot(props) {
     ] }) })
   ] });
 }
-const Donut = memo(DonutInner);
+const DonutMemo = memo(DonutInner);
+DonutMemo.displayName = "Donut";
+const Donut = DonutMemo;
 export {
   Donut
 };

package/dist/charts/kinds/DualPanel.d.ts

@@ -1,7 +1,9 @@
+import type { BasaltProps } from '../../common/props.js';
 import type { ZoneSpec } from '../primitives/ZoneRects.js';
+import type { ChartState } from '../primitives/ChartPending.js';
 import type { CursorResolution } from '../cursor/resolve.js';
 import type { ChartLegendConfig, ChartSeries } from '../series.js';
-export type DualPanelProps<T> = {
+export type DualPanelProps<T> = BasaltProps & {
     data: T[];
     /** Fixed height in pixels, forwarded to the internal `ChartFrame`. Default 240. */
     height?: number;
@@ -83,6 +85,9 @@ export type DualPanelProps<T> = {
     ariaLabel?: string;
     /** Forwarded to `ChartFrame` — see `ChartPending`'s JSDoc for the three-state rationale. */
     isPending?: boolean;
+    /** The three "nothing to draw" states in one prop — pending → error → empty. See
+     * `ChartState`; `isPending` stays a supported alias for `state={{ pending: true }}`. */
+    state?: ChartState;
 };
 /**
  * Dual-pane chart: a top line pane and a bottom signed-histogram pane sharing
@@ -97,10 +102,6 @@ export type DualPanelProps<T> = {
  * when a series has nulls; lines/bars skip null points (visual gaps).
  */
 declare function DualPanelInner<T>(props: DualPanelProps<T>): import("react").JSX.Element;
-/**
- * Hand-memoized: React Compiler does not process the shipped dist, so the hot DualPanel kind is
- * wrapped in `React.memo` to retain the auto-memoization it had as source (parity with ZonedLine).
- */
 export declare const DualPanel: typeof DualPanelInner;
 export {};
 //# sourceMappingURL=DualPanel.d.ts.map