basalt-ui 1.27.0 → 1.28.0

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

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"}

package/dist/charts/sparklines/BarSparkline.js

@@ -11,7 +11,9 @@ function BarSparkline({
   barRadius = 0,
   emphasizeLast = false,
   emphasisColor,
-  ariaLabel
+  ariaLabel,
+  className,
+  style
 }) {
   const fillColor = color ?? VX.faint;
   const lastColor = emphasisColor ?? VX.accent;
@@ -20,11 +22,15 @@ function BarSparkline({
     const max = Math.max(...data.filter((v) => isFinite(v)), 1);
     return scaleLinear({ domain: [0, max], range: [0, height] });
   }, [data, height]);
-  if (!data.length) return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps });
+  const rootProps = {
+    ...className !== void 0 && { className },
+    ...style !== void 0 && { style }
+  };
+  if (!data.length) return /* @__PURE__ */ jsx("svg", { width, height, ...rootProps, ...a11yProps });
   const step = width / data.length;
   const barWidth = Math.max(step - barGap, 1);
   const lastIndex = data.length - 1;
-  return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps, children: data.map((v, i) => {
+  return /* @__PURE__ */ jsx("svg", { width, height, ...rootProps, ...a11yProps, children: data.map((v, i) => {
     const bh = Math.max(yScale(Math.max(v, 0)), 0);
     const isLast = emphasizeLast && i === lastIndex;
     return /* @__PURE__ */ jsx(

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

@@ -1,4 +1,5 @@
-type LineSparklineProps = {
+import type { BasaltProps } from '../../common/props.js';
+export type LineSparklineProps = BasaltProps & {
     data: number[];
     width: number;
     height: number;
@@ -10,6 +11,5 @@ type LineSparklineProps = {
  * Quiet single-hue trend line (docs/DESIGN-SPEC.md §5: "single 1.6px faint line, no fill, no
  * axes, no dots"). Sparklines default to `VX.faint`, not the bolder `VX.line` used by full charts.
  */
-export declare function LineSparkline({ data, width, height, color, ariaLabel }: LineSparklineProps): import("react").JSX.Element;
-export {};
+export declare function LineSparkline({ data, width, height, color, ariaLabel, className, style, }: LineSparklineProps): import("react").JSX.Element;
 //# sourceMappingURL=LineSparkline.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"LineSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/LineSparkline.tsx"],"names":[],"mappings":"AAOA,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,kBAAkB,+BAoC1F"}
+{"version":3,"file":"LineSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/LineSparkline.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,SAAS,EACT,SAAS,EACT,KAAK,GACN,EAAE,kBAAkB,+BAyCpB"}

package/dist/charts/sparklines/LineSparkline.js

@@ -5,7 +5,15 @@ import { scaleLinear } from "@visx/scale";
 import { LinePath } from "@visx/shape";
 import { useMemo } from "react";
 import { VX } from "../../tokens/index.js";
-function LineSparkline({ data, width, height, color, ariaLabel }) {
+function LineSparkline({
+  data,
+  width,
+  height,
+  color,
+  ariaLabel,
+  className,
+  style
+}) {
   const strokeColor = color ?? VX.faint;
   const a11yProps = ariaLabel !== void 0 ? { role: "img", "aria-label": ariaLabel } : {};
   const xScale = useMemo(
@@ -20,9 +28,13 @@ function LineSparkline({ data, width, height, color, ariaLabel }) {
     const pad = (max - min) * 0.1 || 1;
     return scaleLinear({ domain: [min - pad, max + pad], range: [height, 0] });
   }, [data, height]);
-  if (data.length < 2) return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps });
+  const rootProps = {
+    ...className !== void 0 && { className },
+    ...style !== void 0 && { style }
+  };
+  if (data.length < 2) return /* @__PURE__ */ jsx("svg", { width, height, ...rootProps, ...a11yProps });
   const indexed = data.map((v, i) => ({ v, i }));
-  return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps, children: /* @__PURE__ */ jsx(Group, { children: /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx("svg", { width, height, ...rootProps, ...a11yProps, children: /* @__PURE__ */ jsx(Group, { children: /* @__PURE__ */ jsx(
     LinePath,
     {
       data: indexed,

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

@@ -1,3 +1,3 @@
-export { LineSparkline } from './LineSparkline.js';
-export { BarSparkline } from './BarSparkline.js';
+export { LineSparkline, type LineSparklineProps } from './LineSparkline.js';
+export { BarSparkline, type BarSparklineProps } from './BarSparkline.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -1,5 +1,95 @@
-/** Axis-friendly short date: DD.MM */
+/**
+ * What EVERY formatter here prints for input it cannot represent — `NaN`, `±Infinity`, an
+ * `Invalid Date`. An em dash (U+2014), the same glyph the tooltip already uses for a missing value.
+ *
+ * The rule is one rule on purpose. `Intl.NumberFormat` renders `NaN` as the literal string `"NaN"`
+ * and `Infinity` as `"∞"`, so a y axis whose domain collapsed (an empty series, a 0/0 rate, a log
+ * scale reaching zero) painted its own arithmetic accident as a tick label and a tooltip read
+ * `NaN%`. A chart may say it does not know; it may not print a number that is not one.
+ */
+export declare const NON_FINITE = "\u2014";
+/** Axis-friendly short date: DD.MM. A non-finite or invalid date prints {@link NON_FINITE}. */
 export declare function fmtAxisDate(value: unknown): string;
-/** Tooltip-friendly long date: "Mon Apr 21 2026" */
+/** Tooltip-friendly long date: "Mon Apr 21 2026". A non-finite or invalid date prints
+ * {@link NON_FINITE}. */
 export declare function fmtTooltipDate(date: unknown): string;
+/**
+ * The number-format law.
+ *
+ * `format.ts` shipped two date formatters and nothing else, so every axis and every tooltip in
+ * every demo and consumer hand-rolled its own `` `$${v}k` `` — a template literal that is not
+ * locale-aware, not compact-aware, and different in each of the places it was written. These four
+ * are `Intl.NumberFormat` with the arguments already decided, so a chart states WHAT a number is
+ * rather than how to punctuate it.
+ *
+ * `locale` defaults to `undefined`, which is `Intl`'s own "use the runtime's locale" — the correct
+ * default for an app whose reader is the person looking at it. Pass it explicitly (`'en-US'`) when
+ * the output must be stable regardless of where it runs, which is what the tests here do.
+ *
+ * Every one of them returns {@link NON_FINITE} for input that is not a finite number — see its
+ * JSDoc for why that is a law of this module rather than a per-call-site guard.
+ */
+/** Options every formatter here accepts. */
+type LocaleOption = {
+    /** BCP-47 tag. Default `undefined` — the runtime's own locale. */
+    locale?: string;
+};
+export type FmtCompactOptions = LocaleOption & {
+    /** Significant-ish fraction digits on the compacted number. Default 1 (`1.2k`, `3.4M`). */
+    digits?: number;
+};
+/**
+ * Compact notation: `1.2k`, `3.4M`, `-820`. The axis formatter for any count whose range spans
+ * more than three digits — a y axis reading `1,200,000` spends a third of the plot width on a
+ * gutter. A non-finite value prints {@link NON_FINITE}.
+ *
+ * Note `Intl`'s compact notation is LOCALE text, not a suffix table: `en` gives `1.2K`, and this
+ * lowercases the `K` to match the package's own numeral style while leaving every other locale's
+ * word (`1,2 Mio.`) untouched. Only a `K` attached to the DIGITS is touched — `HK$1.2K` must keep
+ * its currency prefix, which a bare `replace('K', 'k')` ate.
+ */
+export declare function fmtCompact(value: number, options?: FmtCompactOptions): string;
+export type FmtPercentOptions = LocaleOption & {
+    /** Fraction digits. Default 0 (`42%`). */
+    digits?: number;
+    /**
+     * What the incoming number MEANS. `'ratio'` (default) is `0.42 → 42%`; `'percent'` is
+     * `42 → 42%`. Required as an explicit option rather than guessed from magnitude: a ratio of 1.2
+     * and a percentage of 1.2 are both perfectly ordinary numbers, and a heuristic would silently
+     * render one of them 100× wrong.
+     */
+    input?: 'ratio' | 'percent';
+};
+/** Percentages, from either a ratio or an already-scaled percentage. A non-finite value prints
+ * {@link NON_FINITE} — a rate is the commonest source of a 0/0. */
+export declare function fmtPercent(value: number, options?: FmtPercentOptions): string;
+export type FmtCurrencyOptions = LocaleOption & {
+    /** ISO 4217 code — required. There is no default currency; a wrong symbol is worse than a
+     * verbose call site. */
+    currency: string;
+    /** Compact notation for the amount (`$1.2k`). Default false. */
+    compact?: boolean;
+    /** Fraction digits. Default 0 compacted, else the currency's own default (`undefined`). */
+    digits?: number;
+};
+/** Money. `fmtCurrency(1234, { currency: 'USD' })` → `$1,234`. A non-finite amount prints
+ * {@link NON_FINITE}. */
+export declare function fmtCurrency(value: number, options: FmtCurrencyOptions): string;
+/** Grouped integer: `12,480`. Rounds — an integer formatter that printed `12,480.4` would be
+ * lying about its own name. A non-finite value prints {@link NON_FINITE}. */
+export declare function fmtInt(value: number, options?: LocaleOption): string;
+/**
+ * Every shipped formatter under one name, so a chart can be handed the whole set
+ * (`format={formatters.compact}`) and a consumer has one import to reach for instead of four.
+ * Same members as the named exports — this is a convenience, never a second implementation.
+ */
+export declare const formatters: {
+    readonly compact: typeof fmtCompact;
+    readonly percent: typeof fmtPercent;
+    readonly currency: typeof fmtCurrency;
+    readonly int: typeof fmtInt;
+    readonly axisDate: typeof fmtAxisDate;
+    readonly tooltipDate: typeof fmtTooltipDate;
+};
+export {};
 //# sourceMappingURL=format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/format.ts"],"names":[],"mappings":"AAGA,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CASpD"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/format.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,WAAW,CAAA;AAElC,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYlD;AAED;yBACyB;AACzB,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED;;;;;;;;;;;;;;;GAeG;AAEH,4CAA4C;AAC5C,KAAK,YAAY,GAAG;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAyBD,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAUjF;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B,CAAA;AAED;mEACmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAQjF;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C;4BACwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;yBACyB;AACzB,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAa9E;AAED;6EAC6E;AAC7E,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAGxE;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAA"}