basalt-ui 1.41.0 → 2.0.0

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

@@ -1,175 +0,0 @@
-import { resolveContainerClass } from "../../tokens/size-classes.js";
-import { VX } from "../../tokens/index.js";
-import { measureText } from "../utils/measure-text.js";
-import {
-  entriesWithinChipRows,
-  entriesWithinDotRows,
-  entriesWithinRows,
-  orderEntries
-} from "./chart-frame-layout.js";
-const HEIGHT_RATIO = { micro: 0.5, compact: 0.62, regular: 0.5, wide: 0.4 };
-const HEIGHT_MIN = 160;
-const HEIGHT_MAX = 420;
-const COARSE_VIEWPORT_SHARE = 0.45;
-const UNMEASURED_WIDTH = { micro: 200, compact: 360, regular: 640, wide: 960 };
-const TICK_SPACING = 44;
-const COMPACT_LABEL_CHARS = 4;
-const X_LABEL_GAP = 8;
-const LEGEND_ROWS = { header: 1, band: 2 };
-const CONTAINER_CLASS_OF_SIZE_CLASS = {
-  compact: "compact",
-  medium: "regular",
-  expanded: "wide"
-};
-function containerClassFromSizeClass(sizeClass) {
-  return CONTAINER_CLASS_OF_SIZE_CLASS[sizeClass];
-}
-const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
-function resolveHeight(input, containerClass) {
-  const override = input.override?.height;
-  const width = input.frameW > 0 ? input.frameW : UNMEASURED_WIDTH[containerClass];
-  const derived = override ?? clamp(Math.round(width * HEIGHT_RATIO[containerClass]), HEIGHT_MIN, HEIGHT_MAX);
-  if (!input.coarse || input.viewportH <= 0) return derived;
-  return Math.min(derived, Math.round(input.viewportH * COARSE_VIEWPORT_SHARE));
-}
-function rollUp(total, fitted) {
-  const visible = total - fitted < 2 ? total : fitted;
-  return { visible, overflow: total - visible };
-}
-function resolveLegend(input, containerClass) {
-  const total = input.legendItems.length;
-  if (containerClass === "micro" || total === 0) return { mode: "none" };
-  const where = input.slotW > 0 ? "header" : "band";
-  const width = where === "header" ? input.slotW : input.frameW;
-  if (width <= 0) return { mode: "chips", where, visible: total, overflow: 0 };
-  const { entries: ordered, dividerAfter } = orderEntries(input.legendItems, input.groups === true);
-  const chipFit = entriesWithinRows(ordered, width, LEGEND_ROWS[where]);
-  const allChipsFit = chipFit >= total;
-  const wantsDots = where === "header" && !allChipsFit && (input.cardShort === true || containerClass === "compact");
-  if (!wantsDots) {
-    const fitted = allChipsFit ? chipFit : entriesWithinChipRows(ordered, width, LEGEND_ROWS[where]);
-    const { visible: visible2, overflow: overflow2 } = rollUp(total, fitted);
-    return { mode: "chips", where, visible: visible2, overflow: overflow2 };
-  }
-  const dotFit = entriesWithinDotRows(ordered, width, LEGEND_ROWS[where], dividerAfter);
-  const { visible, overflow } = rollUp(total, dotFit);
-  return { mode: "dots", where, visible, overflow };
-}
-function isTightClass(containerClass) {
-  return containerClass === "compact" || containerClass === "micro";
-}
-function resolveYPlacement(containerClass, opts = {}) {
-  const { hasLeftAxis = true, marginOverrideLeft } = opts;
-  if (!isTightClass(containerClass) || !hasLeftAxis || marginOverrideLeft !== void 0)
-    return "outside";
-  return containerClass === "micro" ? "none" : "inside";
-}
-const INSIDE_Y_FLOOR = 4;
-function resolveMarginFloor(yPlacement, tierMargin) {
-  return yPlacement === "outside" ? tierMargin : { ...tierMargin, left: INSIDE_Y_FLOOR };
-}
-const COMPACT_UNITS = [
-  [1e12, "T"],
-  [1e9, "B"],
-  [1e6, "M"],
-  [1e3, "k"]
-];
-const roundTenth = (value) => Math.round(value * 10) / 10;
-function compactNumber(value) {
-  const abs = Math.abs(value);
-  if (!Number.isFinite(value) || abs < 1e3) return null;
-  let index = COMPACT_UNITS.findIndex(([unit]) => abs >= unit);
-  let scaled = roundTenth(abs / COMPACT_UNITS[index][0]);
-  if (scaled >= 1e3 && index > 0) {
-    index -= 1;
-    scaled = roundTenth(abs / COMPACT_UNITS[index][0]);
-  }
-  return `${value < 0 ? "-" : ""}${scaled}${COMPACT_UNITS[index][1]}`;
-}
-function shouldCompactYLabels(labels) {
-  return labels.some((label) => label.length > COMPACT_LABEL_CHARS);
-}
-function yTickCount(plotHeight) {
-  if (plotHeight < VX.minPlotHeight) return 2;
-  return clamp(Math.round(plotHeight / TICK_SPACING), 2, 6);
-}
-function wrapLabel(label, maxPx, fontPx) {
-  const words = label.split(/\s+/).filter((word) => word !== "");
-  const lines = [];
-  let current = "";
-  for (const word of words) {
-    const candidate = current === "" ? word : `${current} ${word}`;
-    if (current !== "" && measureText(candidate, fontPx) > maxPx) {
-      lines.push(current);
-      current = word;
-      continue;
-    }
-    current = candidate;
-  }
-  if (current !== "") lines.push(current);
-  return lines.length > 0 ? lines : [label];
-}
-function planXLabels(input) {
-  const { labels, plotWidth, fontPx, categorical } = input;
-  const count = labels.length;
-  const widest = labels.reduce((max, label) => Math.max(max, measureText(label, fontPx)), 0);
-  const flatPx = widest + X_LABEL_GAP;
-  const fit = plotWidth > 0 && widest > 0 ? Math.floor(plotWidth / flatPx) : count;
-  const flat = {
-    wrap: false,
-    rotate: 0,
-    lines: 1,
-    labelPx: flatPx,
-    wrapPx: 0
-  };
-  if (!categorical || count <= fit || plotWidth <= 0) return flat;
-  const widestWord = labels.reduce(
-    (max, label) => Math.max(max, ...label.split(/\s+/).map((word) => measureText(word, fontPx))),
-    0
-  );
-  const wrapPx = Math.min(widest, Math.max(widestWord, Math.floor(plotWidth / count) - X_LABEL_GAP));
-  const wrapped = labels.map((label) => wrapLabel(label, wrapPx, fontPx));
-  const lines = wrapped.reduce((max, parts) => Math.max(max, parts.length), 1);
-  if (lines === 1) {
-    return count > 2 * Math.max(fit, 1) ? { ...flat, rotate: 45 } : flat;
-  }
-  const wrappedWidest = wrapped.reduce(
-    (max, parts) => Math.max(max, ...parts.map((part) => measureText(part, fontPx))),
-    0
-  );
-  const wrappedFit = Math.max(Math.floor(plotWidth / (wrappedWidest + X_LABEL_GAP)), 1);
-  if (wrappedFit >= count) {
-    return {
-      wrap: true,
-      rotate: 0,
-      lines,
-      labelPx: wrappedWidest + X_LABEL_GAP,
-      wrapPx
-    };
-  }
-  return count > 2 * wrappedFit ? { ...flat, rotate: 45 } : flat;
-}
-function resolveFrameClass(input) {
-  return input.frameW > 0 ? resolveContainerClass(input.frameW) : containerClassFromSizeClass(input.sizeClass);
-}
-function resolveChartLayout(input) {
-  const containerClass = resolveFrameClass(input);
-  return {
-    containerClass,
-    height: resolveHeight(input, containerClass),
-    legend: resolveLegend(input, containerClass)
-  };
-}
-export {
-  INSIDE_Y_FLOOR,
-  compactNumber,
-  isTightClass,
-  planXLabels,
-  resolveChartLayout,
-  resolveFrameClass,
-  resolveMarginFloor,
-  resolveYPlacement,
-  shouldCompactYLabels,
-  wrapLabel,
-  yTickCount
-};

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

@@ -1,16 +0,0 @@
-import type { ReactNode } from 'react';
-import type { ContainerClass } from '../../tokens/size-classes.js';
-import type { ChartTierMetrics } from './chart-frame-layout.js';
-export type ChartTierProviderProps = {
-    containerClass: ContainerClass;
-    children: ReactNode;
-};
-/** Publishes a resolved container class to the subtree. Mounted once, by `ChartFrame`. */
-export declare function ChartTierProvider({ containerClass, children }: ChartTierProviderProps): ReactNode;
-/** The ambient container class (`'regular'` outside a `ChartFrame`). Internal. */
-export declare function useChartContainerClass(): ContainerClass;
-/** The resolved sizes for the ambient container class — what every internal primitive wants. */
-export declare function useChartMetrics(): ChartTierMetrics;
-/** Viewport height in px (`0` on the server). Only the coarse-pointer height clamp reads it. */
-export declare function useViewportHeight(): number;
-//# sourceMappingURL=chart-tier.d.ts.map

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

@@ -1 +0,0 @@
-{"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,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAa5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,cAAc,CAAA;IAC9B,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAMjG;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,cAAc,CAEvD;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,gBAAgB,CAElD;AAiCD,gGAAgG;AAChG,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

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

@@ -1,44 +0,0 @@
-import { jsx } from "react/jsx-runtime";
-import { createContext, useContext, useSyncExternalStore } from "react";
-import { chartMetrics } from "./chart-frame-layout.js";
-const ChartContainerClassContext = createContext("regular");
-function ChartTierProvider({ containerClass, children }) {
-  return /* @__PURE__ */ jsx(ChartContainerClassContext.Provider, { value: containerClass, children });
-}
-function useChartContainerClass() {
-  return useContext(ChartContainerClassContext);
-}
-function useChartMetrics() {
-  return chartMetrics(useChartContainerClass());
-}
-const subscribeNothing = () => () => {
-};
-const VIEWPORT_H_STEP = 50;
-const viewportHListeners = /* @__PURE__ */ new Set();
-let viewportHListenerAttached = false;
-function ensureViewportHListener() {
-  if (viewportHListenerAttached || typeof window === "undefined") return;
-  viewportHListenerAttached = true;
-  window.addEventListener("resize", () => {
-    for (const listener of viewportHListeners) listener();
-  });
-}
-function subscribeViewportH(onChange) {
-  if (typeof window === "undefined") return subscribeNothing();
-  ensureViewportHListener();
-  viewportHListeners.add(onChange);
-  return () => viewportHListeners.delete(onChange);
-}
-function readViewportH() {
-  if (typeof window === "undefined") return 0;
-  return Math.round(window.innerHeight / VIEWPORT_H_STEP) * VIEWPORT_H_STEP;
-}
-function useViewportHeight() {
-  return useSyncExternalStore(subscribeViewportH, readViewportH, () => 0);
-}
-export {
-  ChartTierProvider,
-  useChartContainerClass,
-  useChartMetrics,
-  useViewportHeight
-};

package/dist/charts/primitives/legend-disclosure.d.ts

@@ -1,27 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-/**
- * `ChartLegend`'s `All N` disclosure state: which button opened it (the chip, or a dots-mode entry)
- * and where the fixed panel sits. Focus moves into the panel on open and back to that trigger on
- * EVERY close path; a scroll outside the panel or a resize closes it, since it is fixed to where the
- * trigger WAS.
- */
-export declare function useLegendDisclosure(coarse: boolean): {
-    open: boolean;
-    panelId: string;
-    openFrom: (trigger: HTMLButtonElement) => void;
-    close: () => void;
-    panel: {
-        panelRef: import("react").RefObject<HTMLDialogElement | null>;
-        panelId: string;
-        coarse: boolean;
-        placement: CSSProperties | null;
-        close: () => void;
-    };
-};
-/** The portalled panel itself — a popover under the chip on a fine pointer, a docked sheet (over a
- * scrim) on a coarse one. Fixed-position, so opening it never grows the legend band. */
-export declare function LegendDisclosure({ panelRef, panelId, coarse, placement, close, fontSize, children, }: ReturnType<typeof useLegendDisclosure>['panel'] & {
-    fontSize: number;
-    children: ReactNode;
-}): import("react").ReactPortal | null;
-//# sourceMappingURL=legend-disclosure.d.ts.map

package/dist/charts/primitives/legend-disclosure.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"legend-disclosure.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/legend-disclosure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAyDrD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO;;;wBAQtB,iBAAiB;;;;;;;;;EAuD7C;AAED;wFACwF;AACxF,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAO,EACP,MAAM,EACN,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,OAAO,CAAC,GAAG;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,SAAS,CAAA;CACpB,sCAoCA"}

package/dist/charts/primitives/legend-disclosure.js

@@ -1,153 +0,0 @@
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useId, useRef, useState } from "react";
-import { createPortal } from "react-dom";
-import { alpha, VX } from "../../tokens/index.js";
-import { useDismissOnOutside } from "../cursor/touch-pin.js";
-import { LEGEND_ROW_GAP } from "./chart-frame-layout.js";
-const DISCLOSURE_PANEL = {
-  position: "fixed",
-  zIndex: VX.zIndexFloating,
-  display: "flex",
-  flexDirection: "column",
-  gap: LEGEND_ROW_GAP,
-  // theme-allow raw-scroll-container — a fixed floating panel of one legend, not app chrome
-  overflowY: "auto",
-  // `<dialog open>` brings UA chrome (centring margin, border, fit-content box) this resets.
-  margin: 0,
-  border: "none",
-  width: "auto",
-  height: "auto",
-  padding: 10,
-  boxSizing: "border-box",
-  backgroundColor: VX.surface.overlay,
-  boxShadow: VX.shadowOverlay,
-  color: VX.muted,
-  borderRadius: VX.radiusCard
-};
-const DISCLOSURE_MIN_HEIGHT = 96;
-function disclosurePlacement(chip, coarse) {
-  if (coarse) {
-    return {
-      left: 0,
-      right: 0,
-      bottom: 0,
-      maxHeight: "60dvh",
-      borderBottomLeftRadius: 0,
-      borderBottomRightRadius: 0,
-      padding: "12px 16px calc(12px + env(safe-area-inset-bottom, 0px))"
-    };
-  }
-  const below = window.innerHeight - chip.bottom;
-  const left = Math.max(8, Math.min(chip.left, window.innerWidth - 248));
-  const base = { left, right: "auto", minWidth: 200, maxWidth: "calc(100vw - 16px)" };
-  return below >= 200 || below >= chip.top ? { ...base, top: chip.bottom + 4, maxHeight: Math.max(below - 12, DISCLOSURE_MIN_HEIGHT) } : {
-    ...base,
-    bottom: window.innerHeight - chip.top + 4,
-    maxHeight: Math.max(chip.top - 12, DISCLOSURE_MIN_HEIGHT)
-  };
-}
-function useLegendDisclosure(coarse) {
-  const [placement, setPlacement] = useState(null);
-  const triggerRef = useRef(null);
-  const panelRef = useRef(null);
-  const panelId = useId();
-  const wasOpen = useRef(false);
-  const open = placement !== null;
-  const close = useCallback(() => setPlacement(null), []);
-  const openFrom = (trigger) => {
-    triggerRef.current = trigger;
-    setPlacement(disclosurePlacement(trigger.getBoundingClientRect(), coarse));
-  };
-  useEffect(() => {
-    if (open) panelRef.current?.focus();
-    else if (wasOpen.current) triggerRef.current?.focus();
-    wasOpen.current = open;
-  }, [open]);
-  const isInsidePanel = useCallback(
-    (target) => panelRef.current?.contains(target) === true || triggerRef.current?.contains(target) === true,
-    []
-  );
-  useDismissOnOutside({
-    enabled: open,
-    isInside: isInsidePanel,
-    onDismiss: close,
-    dismissOnResize: true,
-    scrollExemptInside: true
-  });
-  useEffect(() => {
-    if (!open || !coarse) return;
-    const panel = panelRef.current;
-    if (panel === null) return;
-    const onKeyDown = (e) => {
-      if (e.key !== "Tab") return;
-      const focusable = panel.querySelectorAll(
-        'button, [tabindex]:not([tabindex="-1"])'
-      );
-      const first = focusable[0];
-      const last = focusable[focusable.length - 1];
-      if (first === void 0 || last === void 0) return;
-      if (e.shiftKey && document.activeElement === first) {
-        e.preventDefault();
-        last.focus();
-      } else if (!e.shiftKey && document.activeElement === last) {
-        e.preventDefault();
-        first.focus();
-      }
-    };
-    panel.addEventListener("keydown", onKeyDown);
-    return () => panel.removeEventListener("keydown", onKeyDown);
-  }, [open, coarse]);
-  return { open, panelId, openFrom, close, panel: { panelRef, panelId, coarse, placement, close } };
-}
-function LegendDisclosure({
-  panelRef,
-  panelId,
-  coarse,
-  placement,
-  close,
-  fontSize,
-  children
-}) {
-  if (placement === null) return null;
-  return createPortal(
-    /* @__PURE__ */ jsxs(Fragment, { children: [
-      coarse && /* @__PURE__ */ jsx(
-        "div",
-        {
-          "aria-hidden": true,
-          onPointerDown: (e) => {
-            e.stopPropagation();
-            close();
-          },
-          style: {
-            position: "fixed",
-            inset: 0,
-            // One below the panel it sits behind — still `VX.zIndexFloating`-derived, never a
-            // second unrelated literal (B14).
-            zIndex: VX.zIndexFloating - 1,
-            backgroundColor: alpha(VX.neutral, 0.35)
-          }
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        "dialog",
-        {
-          ref: panelRef,
-          id: panelId,
-          open: true,
-          tabIndex: -1,
-          "aria-label": "Legend",
-          ...coarse && { "aria-modal": true },
-          "data-basalt-legend-disclosure": coarse ? "sheet" : "popover",
-          style: { ...DISCLOSURE_PANEL, fontSize, ...placement },
-          children
-        }
-      )
-    ] }),
-    document.body
-  );
-}
-export {
-  LegendDisclosure,
-  useLegendDisclosure
-};

package/dist/charts/series.d.ts

@@ -1,189 +0,0 @@
-/**
- * The series descriptor — single source of truth for color + line-style + label + accessor.
- * Legend + tooltip rows are *derived* from it, never hand-authored in parallel. Mantine-free.
- *
- * Generalizes `MultiLineSeries<T>` (`kinds/MultiLine.tsx`) into the shared spine consumed by
- * 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` —
- * thinner than the generic `VX.lineWidth` per the 2026-07 modern-zinc redesign
- * (`docs/DESIGN-SPEC.md` §5, "tertiary/line overlay ... at 1.9px stroke"). `VX.lineWidth` itself
- * stays the "one width everywhere" default for `Bars`' line overlays, legend line swatches, and
- * `TooltipRow`'s generic fallback — this constant only overrides the three kinds it's imported by.
- */
-export declare const LINE_OVERLAY_STROKE_WIDTH = 1.9;
-/** Governs BOTH the plotted mark and the legend swatch shape. */
-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. */
-export type LegendPlacement = 'top' | 'bottom' | 'left' | 'right';
-/**
- * Consumer-facing legend config exposed by every kind's `legend` prop — the subset of
- * `ChartFrame`'s legend object a consumer may set directly. Deliberately excludes
- * `highlighted`/`onHighlight`, which the kind injects itself (its own hover-dim state).
- * `legend={false}` on a kind disables the legend entirely (the sparkline escape).
- */
-export type ChartLegendConfig = {
-    /** Default 'bottom'. */
-    placement?: LegendPlacement;
-    /** Visually separate role: series | overlay | reference. */
-    groups?: boolean;
-    /**
-     * @deprecated Removed in 1.32.0 — the legend fits by measured width and folds overflow into an
-     * `All N` disclosure on its own. An explicit value still wins this release (entry count).
-     */
-    maxRows?: number;
-    /** Clicking an entry hides that series. Default: on whenever there is more than one entry. */
-    toggle?: boolean;
-};
-/** Visual identity of a series — everything the legend + tooltip swatch need. No accessors, no `T`. */
-export type SeriesStyle = {
-    key: string;
-    label: string;
-    /** A --vx-* ref (VX.series.*), never a raw hex. */
-    color: string;
-    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. */
-    fillOpacity?: number;
-    /**
-     * A MARK property — dims the plotted stroke, e.g. a faint moving-average companion line. The
-     * legend swatch honors it too (parity with `fillOpacity`, which it already honors — a swatch
-     * that lies is the thing the derived-legend rule exists to prevent). The TOOLTIP ROW swatch and
-     * the CROSSHAIR DOT deliberately do NOT honor it: those are 12px value-readout chips where a
-     * sub-1 opacity reads as a rendering bug, not as data.
-     *
-     * Applies to STROKES only, so it silently no-ops on a `mark: 'bar'`/`'area'` series — a bar
-     * swatch has no stroke to dim. Dim those with `fillOpacity` instead. This bites the
-     * zone/reference-legend idiom in particular (`mark: 'bar'`, `getValue: () => null`), where
-     * reaching for `strokeOpacity` looks right and does nothing.
-     */
-    strokeOpacity?: number;
-    /** Which y-axis this series is measured against. Default 'left'. `'right'` is what makes a
-     * chart dual-axis — `CartesianChart` reads it for the crosshair dots and the tooltip. */
-    axis?: 'left' | 'right';
-    /** Default 'series'. */
-    role?: SeriesRole;
-    /** Default true; false = companion folded under `parent`. */
-    legend?: boolean;
-    /**
-     * Default true; false = drawn and legended, but NEVER listed as a tooltip row. The replacement
-     * for the per-kind `hideBarTooltipRows` escape the old layer had: it belongs to the series, not to the kind, so
-     * one series can opt out without the kind growing a prop for it.
-     */
-    tooltip?: boolean;
-    /** e.g. an MA line names its parent so hover-dimming keeps the pair. */
-    parent?: string;
-    /** Short qualifier rendered after the label in muted text — e.g. a flat-at-zero series that is
-     * invisible in the plot. */
-    note?: string;
-};
-/** Full descriptor = visual identity + data accessors. Generic over the point type. */
-export type ChartSeries<T> = SeriesStyle & {
-    /**
-     * null = 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 ×
-     * 3)`). */
-    formatValue?: (v: number, d: T) => string;
-    /** PR star / status dot. Return null for no marker at that point. `ring` defaults true (today's
-     * punched-out stroke, unchanged); `false` omits the stroke entirely. `fillOpacity` defaults 1. */
-    getMarker?: (d: T) => {
-        color?: string;
-        r?: number;
-        fillOpacity?: number;
-        ring?: boolean;
-    } | null;
-};
-/** A single derived tooltip row, ready for `TooltipRow`. */
-export type TooltipRowData = {
-    key: string;
-    label: string;
-    color: string;
-    value: string;
-    shape: 'line' | 'bar';
-    dashed: boolean;
-    strokeWidth?: number;
-};
-/**
- * Derive the legend from a series-style array — the enforcement that the legend can never drift
- * from what's plotted. Groups by `role` (series → overlay → reference) via `ChartLegend`'s own
- * `groups` rendering.
- *
- * `legend === false`: dropped entirely, UNLESS `parent` names another series in the array — then
- * it is folded into that parent's `LegendEntry.children` as a subordinate dashed sub-entry (e.g.
- * an MA companion), rather than vanishing. A series with `legend !== false` always renders as a
- * normal top-level entry.
- */
-export declare function deriveLegend(series: readonly SeriesStyle[]): LegendEntry[];
-/**
- * Derive tooltip rows from a series descriptor array + the hovered datum. Skips rows where
- * `getValue(datum) === null` or `tooltip === false`; honors per-series `formatValue` over the
- * shared `fallbackFormat`.
- * Kinds pass `series.toReversed()` for stacked charts so the tooltip stack matches the visual stack.
- */
-export declare function deriveTooltipRows<T>(series: readonly ChartSeries<T>[], datum: T, fallbackFormat: (v: number) => string): TooltipRowData[];
-/**
- * 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 +0,0 @@
-{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../../src/charts/series.ts"],"names":[],"mappings":"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"}