basalt-ui 1.41.0 → 2.0.0

package/dist/charts/kinds/BandStrip.js

@@ -1,241 +0,0 @@
-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 { ChartFrame, resolveLegend } from "../primitives/ChartFrame.js";
-import { TooltipRow } from "../primitives/ChartTooltip.js";
-import { Crosshair } from "../primitives/Crosshair.js";
-import { HatchPattern, hatchFill, hatchSizeFor } from "../primitives/HatchPattern.js";
-import { fmtAxisDate } from "../utils/format.js";
-import { BandAxisOverlay, BandTooltip, clampFraction } from "./band-chrome.js";
-const DEFAULT_MARKER_INSET = 6;
-const NO_READING = "\u2014";
-const UNKNOWN_MARK = {
-  fill: alpha(VX.neutral, 0.2),
-  stroke: VX.neutral,
-  strokeWidth: 1,
-  strokeDasharray: "3 2"
-};
-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.`
-  );
-}
-function formatBandValue(style, datum) {
-  if (style.formatValue === void 0) return "";
-  return style.formatValue(datum) ?? NO_READING;
-}
-function BandStripInner(props) {
-  assertRequiredProps("BandStrip", props, ["data", "getX", "series", "getBand"]);
-  const { series, chartId, height, fill, legend, ariaLabel, isPending, state, className, style } = props;
-  return /* @__PURE__ */ jsx(
-    ChartFrame,
-    {
-      series,
-      chartId,
-      ...height !== void 0 && { height },
-      ...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 })
-    }
-  );
-}
-function BandStripPlot(props) {
-  const {
-    data,
-    chartId,
-    getX,
-    series,
-    getBand,
-    formatX = fmtAxisDate,
-    xTickValues,
-    fold,
-    cursorResolution = "leading",
-    tooltip,
-    absentState,
-    margin: marginOverride,
-    ariaLabel,
-    plot
-  } = props;
-  const { hidden } = plot;
-  const styleByKey = useMemo(() => new Map(series.map((s) => [s.key, s])), [series]);
-  const band = useBandPlot({
-    data,
-    chartId,
-    getX,
-    formatX,
-    width: plot.width,
-    cursorResolution,
-    ...fold !== void 0 && { fold },
-    ...xTickValues !== void 0 && { xTickValues },
-    ...marginOverride !== void 0 && { margin: marginOverride },
-    ...tooltip !== void 0 && { tooltip }
-  });
-  const { bands, margin, plotWidth, point, crosshairX, step, bandWidth } = band;
-  const stripHeight = Math.max(plot.height - margin.top - margin.bottom, 1);
-  const hatchId = `${chartId}-band-absent`;
-  if (absentState !== void 0 && !styleByKey.has(absentState)) {
-    throw unknownStateError("absentState", absentState, styleByKey.keys());
-  }
-  const absentColor = (absentState === void 0 ? void 0 : styleByKey.get(absentState)?.color) ?? VX.neutral;
-  const rects = useMemo(() => {
-    const out = [];
-    bands.forEach((d, i) => {
-      const span = getBand(d);
-      const style = styleByKey.get(span.state);
-      const x = i * step;
-      if (style === void 0) {
-        if (process.env.NODE_ENV !== "production")
-          throw unknownStateError("BandSpan.state", span.state, styleByKey.keys());
-        out.push(
-          /* @__PURE__ */ jsx(
-            "rect",
-            {
-              ...UNKNOWN_MARK,
-              x,
-              y: 0,
-              width: bandWidth,
-              height: stripHeight,
-              rx: 1,
-              pointerEvents: "none"
-            },
-            getX(d)
-          )
-        );
-        return;
-      }
-      if (hidden.has(span.state)) return;
-      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;
-      const markerColor = styleByKey.get(markerKey)?.color;
-      if (span.marker !== void 0 && markerColor === void 0 && process.env.NODE_ENV !== "production") {
-        throw unknownStateError("BandSpan.marker.state", markerKey, styleByKey.keys());
-      }
-      const inset = span.marker?.inset ?? DEFAULT_MARKER_INSET;
-      out.push(
-        /* @__PURE__ */ jsxs("g", { children: [
-          measuredWidth > 0 && /* @__PURE__ */ jsx(
-            "rect",
-            {
-              x,
-              y: 0,
-              width: measuredWidth,
-              height: stripHeight,
-              rx: 1,
-              fill: span.fill ?? alpha(style.color, style.fillOpacity ?? 1),
-              pointerEvents: "none"
-            }
-          ),
-          hatchWidth > 0 && /* @__PURE__ */ jsx(
-            "rect",
-            {
-              x: x + measuredWidth,
-              y: 0,
-              width: hatchWidth,
-              height: stripHeight,
-              rx: 1,
-              fill: hatchFill(hatchId),
-              pointerEvents: "none"
-            }
-          ),
-          span.marker !== void 0 && measuredWidth > 0 && /* @__PURE__ */ jsx(
-            "rect",
-            {
-              ...markerColor === void 0 ? UNKNOWN_MARK : { fill: markerColor },
-              x,
-              y: inset,
-              width: measuredWidth,
-              height: Math.max(stripHeight - 2 * inset, 2),
-              rx: 1,
-              pointerEvents: "none"
-            }
-          )
-        ] }, getX(d))
-      );
-    });
-    return out;
-  }, [bands, getBand, getX, styleByKey, hidden, bandWidth, step, stripHeight, hatchId, absentState]);
-  if (plotWidth <= 0 || bands.length === 0) return null;
-  const row = point === null ? null : deriveBandRow(getBand(point), styleByKey, hidden, point);
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsxs(
-      "svg",
-      {
-        ref: band.svgRef,
-        width: plot.width,
-        height: plot.height,
-        style: { touchAction: "pan-y" },
-        children: [
-          /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsx(
-            HatchPattern,
-            {
-              id: hatchId,
-              color: absentColor,
-              opacity: 0.7,
-              size: hatchSizeFor(bandWidth)
-            }
-          ) }),
-          /* @__PURE__ */ jsxs(Group, { left: margin.left, top: margin.top, children: [
-            rects,
-            crosshairX !== null && /* @__PURE__ */ jsx(Crosshair, { x: crosshairX, top: 0, bottom: stripHeight }),
-            /* @__PURE__ */ jsx(
-              BandAxisOverlay,
-              {
-                band,
-                height: stripHeight,
-                getX,
-                formatX,
-                ariaLabel
-              }
-            )
-          ] })
-        ]
-      }
-    ),
-    /* @__PURE__ */ jsx(BandTooltip, { band, tooltip, getX, hidden, children: row !== null && /* @__PURE__ */ jsx(
-      TooltipRow,
-      {
-        color: row.color,
-        label: row.label,
-        value: row.value,
-        shape: row.shape,
-        dashed: row.dashed
-      }
-    ) })
-  ] });
-}
-function deriveBandRow(span, styleByKey, hidden, datum) {
-  const style = styleByKey.get(span.state);
-  if (style === void 0) {
-    return {
-      color: VX.neutral,
-      label: "Unknown state",
-      value: span.state,
-      shape: "bar",
-      dashed: true
-    };
-  }
-  if (style.tooltip === false || hidden.has(span.state)) return null;
-  return {
-    color: style.color,
-    label: style.label,
-    value: formatBandValue(style, datum),
-    shape: style.mark === "line" ? "line" : "bar",
-    dashed: style.dash === "dashed"
-  };
-}
-const BandStripMemo = memo(BandStripInner);
-BandStripMemo.displayName = "BandStrip";
-const BandStrip = BandStripMemo;
-export {
-  BandStrip
-};

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

@@ -1,141 +0,0 @@
-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 { ResponsiveChartHeight } from '../primitives/ChartFrame.js';
-import type { ZoneSpec } from '../primitives/ZoneRects.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>[]`,
- * contravariantly) even though the type is now generic over the datum.
- */
-export type BarsBar<T = unknown> = {
-    /** Field key — `getValue(d, key)` extracts the number (null = skip this slot, not domain hole). */
-    key: string;
-    /** Tooltip + legend label. */
-    label: string;
-    /** Fill color (a resolved CSS color / token ref). Per `docs/DESIGN-SPEC.md` §5, the primary bar
-     * series should typically resolve to `VX.accent`, a secondary companion to `VX.faint`. */
-    color: string;
-    /** Per-series tooltip value formatter — overrides the left/right axis's own format. Receives the
-     * hovered datum alongside the value. */
-    formatValue?: (v: number, d: T) => string;
-    /** Y axis to plot against. Honored only in grouped layout. Default 'left'. */
-    axisSide?: 'left' | 'right';
-    /** Relative width within the group (only honored in grouped layout). Default 1 — all bars equal. */
-    weight?: number;
-    /** Default true; false = drawn and legended, but never listed as a tooltip row — threads
-     * `SeriesStyle.tooltip` through `Bars`, replacing the removed per-kind `hideBarTooltipRows`. */
-    tooltip?: boolean;
-};
-export type BarsLine<T = unknown> = {
-    key: string;
-    label: string;
-    color: string;
-    axisSide?: 'left' | 'right';
-    strokeWidth?: number;
-    dashed?: boolean;
-    formatValue?: (v: number, d: T) => string;
-    /** Default true; false = drawn and legended, but never listed as a tooltip row. */
-    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;
-};
-export type BarsRefLine = {
-    value: number;
-    color: string;
-    /** Solid by default; set true for a dashed line. */
-    dashed?: boolean;
-    axisSide?: 'left' | 'right';
-};
-export type BarsProps<T> = BasaltProps & {
-    data: T[];
-    /** Height in px, or one per size step (`{ base, sm?, md?, lg? }`). Default 240. Forwarded
-     * unchanged; `ChartFrameProps.height` owns the law — steps resolve off the MEASURED width. */
-    height?: number | ResponsiveChartHeight;
-    chartId: string;
-    getX: (d: T) => string;
-    /** Generic value accessor — given a data point and a bar/line key, returns the value or null. */
-    getValue: (d: T, key: string) => number | null;
-    /** 1+ bar series, stacked when ≥2, plotted above baseline (y >= 0). */
-    positiveBars: BarsBar<T>[];
-    /** Optional bar series stacked below baseline (rendered as flipped negatives). */
-    negativeBars?: BarsBar<T>[];
-    /** 0–2 line overlays, each on left or right axis. */
-    lines?: BarsLine<T>[];
-    /** Horizontal value-range overlays (target zones, optimal bands). */
-    zones?: ZoneSpec[];
-    /** Dashed/solid horizontal reference lines. */
-    refLines?: BarsRefLine[];
-    /** Left axis config — bars always live here. In `barLayout: 'stacked'` (the default), `domain`
-     * defaults to the summed per-point stack total (bars + any left-axis lines), not a per-series
-     * max — the same function-domain seam `StackedArea` uses — unless overridden with a fixed tuple
-     * or a custom function. Optional, like every other kind's — omit it for a plain auto domain. */
-    y?: AxisConfig<T>;
-    /** Right axis config. Passing it is what makes the chart dual-axis: it draws the right axis and
-     * widens the right margin by measurement. Line overlays (and grouped-layout bars) opt in with
-     * `axisSide: 'right'`. */
-    y2?: AxisConfig<T>;
-    /** Bar width as fraction of slot width. Default 0.6. */
-    barWidthRatio?: number;
-    /**
-     * How multiple positive bars are arranged per x slot.
-     * - `stacked` (default): bars stack vertically on the left axis; negativeBars stack below baseline.
-     * - `grouped`: bars sit side-by-side within the slot. Each bar honors its own `axisSide`.
-     *   negativeBars are ignored in grouped layout.
-     */
-    barLayout?: 'stacked' | 'grouped';
-    /** Per-bar opacity override. Receives the data point + bar key. Default 0.85. */
-    barOpacity?: (d: T, key: string) => number;
-    /** Exact number of x ticks. Default: as many as fit. Ignored when `xTickValues` is set. */
-    xTicks?: number;
-    /** Which domain keys get a tick, from the full key list and the resolved plot width. Takes
-     * precedence over `xTicks` — see `CartesianChartProps.xTickValues` for why a count is not
-     * always enough. */
-    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
-     * keyed by its Monday) — see `CursorResolution`.
-     */
-    cursorResolution?: CursorResolution;
-    /** `false` disables the tooltip entirely (and with it the crosshair dots). */
-    tooltip?: CartesianTooltipConfig<T> | false;
-    /** Per-side overrides of the measured margins — the escape hatch, applied last. */
-    margin?: Partial<ChartMargin>;
-    /** Legend config forwarded to `CartesianChart`; `false` disables the legend (sparkline escape).
-     * Default `{ placement: 'bottom' }`. */
-    legend?: ChartLegendConfig | false;
-    /** Accessible text alternative, forwarded as `aria-label` (+ `role="group"`). */
-    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
- * overlays on left/right axes, horizontal zones, and reference lines. Covers
- * diverging-stack + bar+line + any future stacked-bar preset.
- *
- * Composes `CartesianChart` (`docs/CHARTS-SPEC.md` §2) — margin, scales, grid, axes, the shared
- * cursor, the crosshair + per-series dots, and the tooltip are ALL the primitive's job. This file
- * draws only the bar rects, the line overlays, and (for a diverging stack) the zero baseline.
- *
- * X-axis is built from the full `data` array so the calendar is preserved even
- * with per-bar nulls (nulls become visual gaps, not domain holes).
- */
-declare function BarsInner<T>(props: BarsProps<T>): import("react").JSX.Element;
-export declare const Bars: typeof BarsInner;
-export {};
-//# sourceMappingURL=Bars.d.ts.map

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

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