basalt-ui 1.41.0 → 2.0.0

package/dist/charts/hooks/useBandPlot.js

@@ -1,178 +0,0 @@
-import { scaleBand } from "@visx/scale";
-import { useCallback, useMemo, useRef } from "react";
-import { autoMargin } from "../layout/auto-margin.js";
-import {
-  isTightClass,
-  planXLabels,
-  resolveMarginFloor,
-  resolveYPlacement
-} from "../primitives/chart-layout.js";
-import { useChartContainerClass, useChartMetrics } from "../primitives/chart-tier.js";
-import { maxTextWidth } from "../utils/measure-text.js";
-import { smartTicks, xLabelPxFor } from "../utils/ticks.js";
-import { useChartCursor } from "./useChartCursor.js";
-const DEFAULT_MIN_BAND_PX = 3;
-const TERMINAL_GUTTER_MAX_FRACTION = { left: 0.14, right: 0.12 };
-function foldBands(data, cap, merge) {
-  if (cap <= 0) return [];
-  if (data.length <= cap) return [...data];
-  const groupSize = Math.ceil(data.length / cap);
-  const out = [];
-  for (let i = 0; i < data.length; i += groupSize) out.push(merge(data.slice(i, i + groupSize)));
-  return out;
-}
-function useBandPlot(input) {
-  const {
-    data,
-    chartId,
-    getX,
-    formatX,
-    width,
-    fold,
-    cursorResolution,
-    xTickValues,
-    leftLabels,
-    margin: marginOverride,
-    tooltip
-  } = input;
-  const tier = useChartMetrics();
-  const containerClass = useChartContainerClass();
-  const tight = isTightClass(containerClass);
-  const hasLeftAxis = leftLabels !== void 0 && leftLabels.length > 0;
-  const yPlacement = resolveYPlacement(containerClass, {
-    hasLeftAxis,
-    marginOverrideLeft: marginOverride?.left
-  });
-  const xLabelsAll = useMemo(() => data.map((d) => formatX(getX(d))), [data, getX, formatX]);
-  const xPlan = useMemo(
-    () => planXLabels({
-      labels: xLabelsAll,
-      plotWidth: width - tier.margin.left - tier.margin.right,
-      fontPx: tier.axisFont,
-      categorical: tight
-    }),
-    [xLabelsAll, width, tier.margin, tier.axisFont, tight]
-  );
-  const xWrapWidth = xPlan.wrap ? xPlan.wrapPx : void 0;
-  const margin = useMemo(() => {
-    const measured = autoMargin({
-      ...leftLabels !== void 0 && { left: yPlacement === "outside" ? leftLabels : [] },
-      bottom: xLabelsAll,
-      fontPx: tier.axisFont,
-      // An inside-placed left axis paints IN the plot, so the outside label-width floor is dead
-      // space there — same law as `CartesianChart`'s `marginInput.floor`.
-      floor: resolveMarginFloor(yPlacement, tier.margin),
-      anchorTerminals: tight,
-      bottomLines: xPlan.lines,
-      ...marginOverride !== void 0 && { override: marginOverride }
-    });
-    if (marginOverride?.left !== void 0 && marginOverride.right !== void 0) return measured;
-    const halfXLabel = Math.ceil(maxTextWidth(xLabelsAll, tier.axisFont) / 2);
-    const left = hasLeftAxis || tight ? measured.left : Math.max(measured.left, halfXLabel);
-    return {
-      ...measured,
-      ...marginOverride?.left === void 0 && {
-        left: hasLeftAxis || tight ? left : capTerminalGutter(left, width, TERMINAL_GUTTER_MAX_FRACTION.left, tier.margin.left)
-      },
-      ...marginOverride?.right === void 0 && {
-        right: tight ? measured.right : capTerminalGutter(
-          measured.right,
-          width,
-          TERMINAL_GUTTER_MAX_FRACTION.right,
-          tier.margin.right
-        )
-      }
-    };
-  }, [
-    leftLabels,
-    xLabelsAll,
-    marginOverride,
-    hasLeftAxis,
-    width,
-    tier.axisFont,
-    tier.margin,
-    tight,
-    yPlacement,
-    xPlan.lines
-  ]);
-  const plotWidth = Math.max(width - margin.left - margin.right, 0);
-  const minBandPx = fold?.minBandPx ?? DEFAULT_MIN_BAND_PX;
-  const merge = fold?.merge;
-  const bands = useMemo(
-    () => merge === void 0 ? [...data] : foldBands(data, Math.floor(plotWidth / minBandPx), merge),
-    [data, plotWidth, minBandPx, merge]
-  );
-  const keys = useMemo(() => bands.map(getX), [bands, getX]);
-  const scale = useMemo(
-    () => scaleBand({ domain: keys, range: [0, plotWidth] }),
-    [keys, plotWidth]
-  );
-  const bandCenter = useCallback(
-    (key) => {
-      const v = scale(key);
-      return v === void 0 ? void 0 : v + scale.bandwidth() / 2;
-    },
-    [scale]
-  );
-  const svgRef = useRef(null);
-  const cursor = useChartCursor({
-    data: bands,
-    chartId,
-    getKey: getX,
-    xScale: bandCenter,
-    marginLeft: margin.left,
-    // Both callers (`BandStrip`, `MirroredBars`) mount exactly one `<svg ref={band.svgRef}>`, so
-    // it doubles as the tap-outside boundary (`docs/CHARTS-SPEC.md` §4, Tooltip) with no separate
-    // passthrough option — reusing the ref this hook already returns, not a new one.
-    boundaryRef: svgRef,
-    ...cursorResolution !== void 0 && { resolution: cursorResolution }
-  });
-  const xLabelPx = useMemo(
-    () => xWrapWidth === void 0 ? xLabelPxFor(keys.map(formatX), tier.axisFont) : xPlan.labelPx,
-    [keys, formatX, tier.axisFont, xWrapWidth, xPlan.labelPx]
-  );
-  const tickValues = useMemo(() => {
-    if (xTickValues !== void 0) return [...xTickValues(keys, plotWidth)];
-    if (containerClass === "micro")
-      return keys.length > 1 ? [keys[0], keys[keys.length - 1]] : [...keys];
-    return [...smartTicks(keys, plotWidth, xLabelPx, tight)];
-  }, [keys, plotWidth, xTickValues, xLabelPx, containerClass, tight]);
-  const point = cursor.point;
-  const crosshairX = point === null ? null : bandCenter(getX(point)) ?? null;
-  const cfg = tooltip === false ? void 0 : tooltip;
-  const isFollowerRender = !cursor.isSource && cfg?.onFollow === true;
-  const showTooltip = tooltip !== false && point !== null && (cursor.isSource || isFollowerRender);
-  const useAnchored = cfg?.follow === false || cfg?.follow === void 0 && cursor.isTouch || isFollowerRender;
-  const anchorX = useAnchored ? crosshairX : null;
-  const svgRect = anchorX === null ? void 0 : svgRef.current?.getBoundingClientRect();
-  const tooltipAnchor = svgRect === void 0 || anchorX === null ? cursor.anchor : { x: svgRect.left + margin.left + anchorX, y: svgRect.top + margin.top };
-  const step = bands.length > 0 ? plotWidth / bands.length : 0;
-  const bandWidth = Math.max(step - 1, 1);
-  return {
-    bands,
-    keys,
-    margin,
-    plotWidth,
-    scale,
-    cursor,
-    point,
-    crosshairX,
-    step,
-    bandWidth,
-    tickValues,
-    yPlacement,
-    xAnchorTerminals: tight,
-    xWrapWidth,
-    svgRef,
-    tooltipAnchor,
-    showTooltip,
-    ariaLive: cursor.isSource
-  };
-}
-function capTerminalGutter(gutter, width, fraction, floor) {
-  return Math.min(gutter, Math.max(floor, Math.round(width * fraction)));
-}
-export {
-  foldBands,
-  useBandPlot
-};

package/dist/charts/hooks/useChartCursor.d.ts

@@ -1,75 +0,0 @@
-import type { KeyboardEvent, PointerEvent, RefObject } from 'react';
-import type { CursorResolution } from '../cursor/resolve.js';
-/** Viewport-space pointer anchor the tooltip positions against. */
-export type CursorAnchor = {
-    x: number;
-    y: number;
-};
-export type ChartCursor<T> = {
-    /** The point this chart paints its crosshair + dots at — own hover, or a resolved sibling key. */
-    point: T | null;
-    /** True when the pointer is over THIS chart. Only the source chart shows the floating tooltip. */
-    isSource: boolean;
-    /** Latest pointer position in viewport coords, or null when not hovered. */
-    anchor: CursorAnchor | null;
-    /**
-     * True when the interaction that most recently placed THIS chart's cursor had
-     * `event.pointerType !== 'mouse'` (touch or pen). Callers fold it into the anchored-tooltip
-     * condition (`tooltip.follow` defaulting to `false` on touch, docs/CHARTS-SPEC.md §4) — a follower's own
-     * anchoring is unaffected, since a follower is never the one whose pointer set this flag.
-     */
-    isTouch: boolean;
-    onPointerMove: (event: PointerEvent<SVGRectElement>) => void;
-    /** Coarse-pointer equivalent of hover: resolves the nearest point and shows the tooltip
-     * immediately, with no preceding `pointermove` — a plain tap otherwise fires only
-     * `pointerdown`/`pointerup`. The press is PROVISIONAL: it shows the tooltip but does not commit a
-     * pin, which only `onPointerUp` does. Also what MOVES an existing touch pin to a new tap elsewhere
-     * in the same chart (fine pointers ignore it; `onPointerMove` already covers hover for them). */
-    onPointerDown: (event: PointerEvent<SVGRectElement>) => void;
-    /** Commits the provisional touch press — the same `pointerId` as the matching `onPointerDown` —
-     * so the pin survives the lift. A `pointerup` for any other pointer is ignored. */
-    onPointerUp: (event: PointerEvent<SVGRectElement>) => void;
-    /** `pointerleave`/`pointercancel`, sharing one handler. A still-UNCOMMITTED touch press cancelled
-     * here is the browser taking the gesture (a scroll) and clears; once committed, touch no-ops so a
-     * stray `pointercancel` cannot undo the pin. A fine pointer always clears. */
-    onPointerLeave: (event: PointerEvent<SVGRectElement>) => void;
-    onKeyDown: (event: KeyboardEvent<SVGRectElement>) => void;
-    onBlur: () => void;
-};
-/**
- * Wires a chart into the ambient cursor store: snaps the pointer to the nearest own point,
- * broadcasts it, and reads back a sibling's broadcast through domain-aware resolution — automatic,
- * no `resolveKey` escape hatch.
- *
- * The tooltip anchor is coalesced through `requestAnimationFrame` (one local write per frame on a
- * fast scrub); the BROADCAST is deduped instead, so a within-bucket scrub costs nothing and a real
- * bucket change reaches siblings on the same tick.
- *
- * Touch model (`docs/CHARTS-SPEC.md` §4): a fine pointer keeps hovering. A coarse pointer
- * (`onPointerDown`) resolves and shows the tooltip immediately, drag-scrubs via `onPointerMove`,
- * and COMMITS a pin on `onPointerUp` — `onPointerLeave` (also wired to `pointercancel`) no-ops once
- * committed. A press the browser turns into a scroll clears instead. The pin moves on a fresh tap,
- * clears on a `document` tap outside `boundaryRef`, on any scroll, or on Escape.
- */
-export declare function useChartCursor<T>({ data, chartId, getKey, xScale, marginLeft, resolution, boundaryRef, }: {
-    data: readonly T[];
-    chartId: string;
-    getKey: (d: T) => string;
-    /** Own x scale — maps a domain key to a plot-local x offset. */
-    xScale: (key: string) => number | undefined;
-    marginLeft: number;
-    /**
-     * How a sibling's broadcast key resolves against this chart's own points. Default `'nearest'`
-     * (point domains). Pass `'leading'` when `getKey` returns a bucket's leading edge (a weekly
-     * series keyed by its Monday, a monthly series keyed by its 1st) — see {@link CursorResolution}.
-     */
-    resolution?: CursorResolution;
-    /**
-     * Element a touch tap OUTSIDE dismisses the pin against (`docs/CHARTS-SPEC.md` §4). One
-     * capture-phase `document` `pointerdown` listener clears the pin when the target falls outside
-     * this ref — added on pinning, removed on unpin/unmount. Omit to skip outside-dismiss (a tap
-     * elsewhere in the chart and Escape still work); never throws for a missing ref.
-     */
-    boundaryRef?: RefObject<Element | null>;
-}): ChartCursor<T>;
-//# sourceMappingURL=useChartCursor.d.ts.map

package/dist/charts/hooks/useChartCursor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useChartCursor.d.ts","sourceRoot":"","sources":["../../../src/charts/hooks/useChartCursor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAMzD,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,kGAAkG;IAClG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACf,kGAAkG;IAClG,QAAQ,EAAE,OAAO,CAAA;IACjB,4EAA4E;IAC5E,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC5D;;;;qGAIiG;IACjG,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC5D;uFACmF;IACnF,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC1D;;kFAE8E;IAC9E,cAAc,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC7D,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IACzD,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAsB,EACtB,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACxB,gEAAgE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CACxC,GAAG,WAAW,CAAC,CAAC,CAAC,CAuRjB"}

package/dist/charts/hooks/useChartCursor.js

@@ -1,200 +0,0 @@
-import { localPoint } from "@visx/event";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { buildDomainIndex, classifyDomain, resolveCursorPoint } from "../cursor/resolve.js";
-import { useCursorState, useCursorStore } from "../cursor/scope.js";
-import { useDismissOnOutside, useTouchPin } from "../cursor/touch-pin.js";
-function useChartCursor({
-  data,
-  chartId,
-  getKey,
-  xScale,
-  marginLeft,
-  resolution = "nearest",
-  boundaryRef
-}) {
-  const store = useCursorStore();
-  const cursor = useCursorState();
-  const [anchor, setAnchor] = useState(null);
-  const [isTouch, setIsTouch] = useState(false);
-  const pinnedRef = useRef(false);
-  useEffect(() => {
-    if (cursor.source !== chartId) pinnedRef.current = false;
-  }, [cursor.source, chartId]);
-  const getKeyRef = useRef(getKey);
-  getKeyRef.current = getKey;
-  const xScaleRef = useRef(xScale);
-  xScaleRef.current = xScale;
-  const index = useMemo(
-    () => buildDomainIndex(data, getKeyRef.current, resolution),
-    [data, resolution]
-  );
-  const kind = useMemo(() => classifyDomain(data.map((d) => getKeyRef.current(d))), [data]);
-  const frameRef = useRef(null);
-  const pendingRef = useRef(null);
-  const moveFrameRef = useRef(null);
-  const pendingMoveRef = useRef(
-    null
-  );
-  useEffect(
-    () => () => {
-      if (frameRef.current !== null) cancelAnimationFrame(frameRef.current);
-      if (moveFrameRef.current !== null) cancelAnimationFrame(moveFrameRef.current);
-      if (store.get().source === chartId) store.set(null, null, null);
-    },
-    [store, chartId]
-  );
-  const scheduleAnchor = useCallback((next) => {
-    pendingRef.current = next;
-    if (frameRef.current !== null) return;
-    frameRef.current = requestAnimationFrame(() => {
-      frameRef.current = null;
-      setAnchor(pendingRef.current);
-    });
-  }, []);
-  const touchPin = useTouchPin({
-    getCommitted: () => store.get(),
-    setCommitted: (v) => store.set(v.key, v.source, v.kind)
-  });
-  const resolveNearestAt = useCallback(
-    (px, anchor2, pointerType) => {
-      if (data.length === 0) return;
-      if (pointerType === "mouse" && pinnedRef.current && store.get().source === chartId) return;
-      let closest = data[0];
-      let minDist = Infinity;
-      for (const d of data) {
-        const x = xScaleRef.current(getKeyRef.current(d)) ?? 0;
-        const dist = Math.abs(x - px);
-        if (dist < minDist) {
-          minDist = dist;
-          closest = d;
-        }
-      }
-      setIsTouch(pointerType !== "mouse");
-      scheduleAnchor(anchor2);
-      store.set(getKeyRef.current(closest), chartId, kind);
-    },
-    [data, chartId, store, scheduleAnchor, kind]
-  );
-  const localX = useCallback(
-    (event) => {
-      const local = localPoint(event.currentTarget, event.nativeEvent);
-      return local === null ? null : local.x - marginLeft;
-    },
-    [marginLeft]
-  );
-  const resolveImmediate = useCallback(
-    (event) => {
-      const px = localX(event);
-      if (px === null) return;
-      resolveNearestAt(px, { x: event.clientX, y: event.clientY }, event.pointerType);
-    },
-    [localX, resolveNearestAt]
-  );
-  const onPointerMove = useCallback(
-    (event) => {
-      const px = localX(event);
-      if (px === null) return;
-      pendingMoveRef.current = {
-        px,
-        anchor: { x: event.clientX, y: event.clientY },
-        pointerType: event.pointerType
-      };
-      if (moveFrameRef.current !== null) return;
-      moveFrameRef.current = requestAnimationFrame(() => {
-        moveFrameRef.current = null;
-        const pending = pendingMoveRef.current;
-        pendingMoveRef.current = null;
-        if (pending !== null) resolveNearestAt(pending.px, pending.anchor, pending.pointerType);
-      });
-    },
-    [localX, resolveNearestAt]
-  );
-  const onPointerDown = useCallback(
-    (event) => {
-      if (event.pointerType !== "mouse") touchPin.begin(event.pointerId);
-      resolveImmediate(event);
-    },
-    [resolveImmediate, touchPin]
-  );
-  const onPointerUp = useCallback(
-    (event) => {
-      if (event.pointerType === "mouse") return;
-      if (touchPin.commit(event.pointerId)) pinnedRef.current = true;
-    },
-    [touchPin]
-  );
-  const clear = useCallback(() => {
-    if (frameRef.current !== null) {
-      cancelAnimationFrame(frameRef.current);
-      frameRef.current = null;
-    }
-    if (moveFrameRef.current !== null) {
-      cancelAnimationFrame(moveFrameRef.current);
-      moveFrameRef.current = null;
-    }
-    pendingRef.current = null;
-    pendingMoveRef.current = null;
-    touchPin.reset();
-    pinnedRef.current = false;
-    setAnchor(null);
-    if (store.get().source === chartId) store.set(null, null, null);
-  }, [store, chartId, touchPin]);
-  const onPointerLeave = useCallback(
-    (event) => {
-      if (touchPin.cancel(event.pointerId)) return;
-      if (isTouch) return;
-      clear();
-    },
-    [isTouch, clear, touchPin]
-  );
-  const onKeyDown = useCallback(
-    (event) => {
-      if (data.length === 0) return;
-      if (event.key === "Escape") {
-        clear();
-        return;
-      }
-      const delta = event.key === "ArrowRight" ? 1 : event.key === "ArrowLeft" ? -1 : 0;
-      if (delta === 0) return;
-      event.preventDefault();
-      const current = store.get().key;
-      const currentIndex = data.findIndex((d) => getKeyRef.current(d) === current);
-      const nextIndex = Math.min(
-        Math.max((currentIndex === -1 ? delta > 0 ? -1 : data.length : currentIndex) + delta, 0),
-        data.length - 1
-      );
-      const next = data[nextIndex];
-      const rect = event.currentTarget.getBoundingClientRect();
-      const x = xScaleRef.current(getKeyRef.current(next)) ?? 0;
-      scheduleAnchor({ x: rect.left + x, y: rect.top });
-      store.set(getKeyRef.current(next), chartId, kind);
-    },
-    [data, store, chartId, clear, scheduleAnchor, kind]
-  );
-  const point = cursor.key === null || cursor.kind !== kind ? null : resolveCursorPoint(index, cursor.key);
-  const isSource = cursor.source === chartId;
-  const isInsideBoundary = useCallback(
-    (target) => boundaryRef?.current?.contains(target) === true,
-    [boundaryRef]
-  );
-  useDismissOnOutside({
-    enabled: isTouch && isSource && boundaryRef !== void 0,
-    isInside: isInsideBoundary,
-    onDismiss: clear
-  });
-  return {
-    point,
-    isSource,
-    anchor,
-    isTouch,
-    onPointerMove,
-    onPointerDown,
-    onPointerUp,
-    onPointerLeave,
-    onKeyDown,
-    onBlur: clear
-  };
-}
-export {
-  useChartCursor
-};

package/dist/charts/hooks/useChartSize.d.ts

@@ -1,29 +0,0 @@
-export type ChartSize = {
-    width: number;
-    height: number;
-};
-export type UseChartSizeResult = ChartSize & {
-    /** Attach to the container element to measure its dimensions. */
-    ref: (node: HTMLDivElement | null) => void;
-};
-/**
- * Measures the width and height of a container element via a ResizeObserver.
- * A thin basalt wrapper over `@visx/responsive`'s `useParentSize` — keeps the
- * `@visx/*` import inside `src/charts/**` per the Mantine-free boundary rule.
- *
- * Charts do not call this directly — `ChartFrame` (and `CartesianChart` above it) measure for
- * them, including the legend band. Reach for it when something OUTSIDE the chart system needs a
- * measured box, e.g. sizing a sparkline to its table cell.
- *
- * @example
- * function CellSparkline({ points }: { points: number[] }) {
- *   const { ref, width } = useChartSize()
- *   return (
- *     <div ref={ref} style={{ width: '100%', height: 24 }}>
- *       {width > 0 && <LineSparkline data={points} width={width} height={24} />}
- *     </div>
- *   )
- * }
- */
-export declare function useChartSize(debounceMs?: number): UseChartSizeResult;
-//# sourceMappingURL=useChartSize.d.ts.map

package/dist/charts/hooks/useChartSize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useChartSize.d.ts","sourceRoot":"","sources":["../../../src/charts/hooks/useChartSize.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG;IAC3C,iEAAiE;IACjE,GAAG,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3C,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,SAAI,GAAG,kBAAkB,CAG/D"}

package/dist/charts/hooks/useChartSize.js

@@ -1,8 +0,0 @@
-import { useParentSize } from "@visx/responsive";
-function useChartSize(debounceMs = 0) {
-  const { parentRef, width, height } = useParentSize({ debounceTime: debounceMs });
-  return { ref: parentRef, width, height };
-}
-export {
-  useChartSize
-};

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

@@ -1,132 +0,0 @@
-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 { ResponsiveChartHeight } from '../primitives/ChartFrame.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
- * numeric value to plot — `formatValue` reads the datum directly.
- */
-export type BandStripSeries<T> = SeriesStyle & {
-    /**
-     * The derived tooltip row's value for a band in this state.
-     *
-     * Return `null` for a datum in this state whose reading is ABSENT — the row renders
-     * {@link NO_READING} instead, which is the escape `ChartSeries.getValue` has and this shape did
-     * not: with no value accessor, an absent reading had to come back as `''` and render as a label
-     * with an empty value, indistinguishable from a state whose name is the whole reading.
-     *
-     * Omit the function entirely for a state whose NAME *is* the whole reading ("Not measured").
-     */
-    formatValue?: (d: T) => string | null;
-};
-/** One drawn band — which state it is in, and the three ways a state can be qualified. */
-export type BandSpan = {
-    /**
-     * Series key naming this band's state: the tie to its legend entry, its fill, and its derived
-     * tooltip row.
-     *
-     * A key not present in `series` is a bug TypeScript cannot catch (this is a `string`), and it
-     * used to draw NOTHING — which on a strip whose vocabulary is measured/not-measured is
-     * indistinguishable from a real coverage gap, so a typo silently asserted "not measured". It now
-     * throws in development and draws an explicit unknown band in production; see
-     * {@link unknownStateError} for why the two differ.
-     */
-    state: string;
-    /**
-     * Overrides the fill derived from the state's series entry — the seam for an intensity ramp
-     * WITHIN one state (5% loss vs 0.5% loss are the same state at different strengths). Build it
-     * with `alpha(VX.*, …)`, never a raw hex.
-     */
-    fill?: string;
-    /**
-     * 0..1 of this band's width that no source sample covers, drawn hatched from the band's right.
-     *
-     * This is what a fold owes the reader. A 1-of-3-measured slot whose merge reports the one
-     * measured member's reading paints, without this, as a fully-measured band — a reading asserted
-     * over two slots that reported nothing either way.
-     */
-    absentFraction?: number;
-    /**
-     * A shorter, inset bar drawn over the band — for a fact that must NOT be readable off the fill
-     * ramp (a renegotiation, a restart, a config change). Its colour comes from a `series` entry, so
-     * it cannot be drawn in a hue the legend does not name.
-     */
-    marker?: {
-        /** Series key naming the marker's colour. Defaults to the band's own `state`. */
-        state?: string;
-        /** Vertical inset from the band's top and bottom, in px. Default 6. */
-        inset?: number;
-    };
-};
-export type BandStripProps<T> = BasaltProps & {
-    data: readonly T[];
-    /** Stable id — identifies this chart as the cursor's source. */
-    chartId: string;
-    /** Extracts the x-domain key. On a band strip this is a SLOT START, so `cursorResolution`
-     * defaults to `'leading'` (see below) rather than `CartesianChart`'s `'nearest'`. */
-    getX: (d: T) => string;
-    /** The states this strip can draw — the single source of truth for legend entries, band fills,
-     * and the derived tooltip row. */
-    series: readonly BandStripSeries<T>[];
-    /** Which state each datum is in. */
-    getBand: (d: T) => BandSpan;
-    /** Height in px, or one per size step (`{ base, sm?, md?, lg? }`), forwarded to `ChartFrame`.
-     * The band row gets whatever the measured margins and legend band leave. Default 240.
-     * `ChartFrameProps.height` owns the law — steps resolve off the MEASURED width. */
-    height?: number | ResponsiveChartHeight;
-    /** Fill the parent flex/grid cell's measured height instead of a fixed one. */
-    fill?: boolean;
-    /** X tick label formatter. Default `fmtAxisDate` (DD.MM). */
-    formatX?: (key: string) => string;
-    /** Which keys get a tick. Default `smartTicks`. */
-    xTickValues?: (keys: readonly string[], plotWidth: number) => readonly string[];
-    /** Collapse adjacent data at widths where one band per datum sub-pixels. */
-    fold?: BandFold<T>;
-    /**
-     * How a sibling's broadcast cursor key resolves against this strip's slots. Default
-     * `'leading'` — strict containment, "the slot that swallowed this key" — because a band IS a
-     * span keyed by its leading edge, and it stays correct at every fold width. `'nearest'` puts
-     * the crosshair one slot right for every source key in the back half of a slot.
-     */
-    cursorResolution?: CursorResolution;
-    tooltip?: BandTooltipConfig<T> | false;
-    legend?: ChartLegendConfig | false;
-    /** 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;
-    /** Per-side overrides of the measured margins — applied last. */
-    margin?: Partial<ChartMargin>;
-    /** Accessible text alternative, forwarded to `ChartFrame` (+ `role="group"`) and to the
-     * focusable hover overlay's slider label. */
-    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.
- *
- * `CartesianChart` cannot host this. It renders `AxisLeftNumeric` unconditionally, so composing it
- * would draw a numeric axis over a chart that measures nothing vertically — and its `scalePoint` x
- * scale has positions but no widths, which is the whole content of a strip. This is the
- * non-single-plot escape `docs/CHARTS-SPEC.md` § "The contract" describes, assembled from the same
- * parts every other chart gets (`ChartFrame`, `autoMargin`, `useChartCursor`, `ChartTooltipFloat`)
- * via `useBandPlot`, never re-implemented.
- *
- * The three qualifications on {@link BandSpan} — `fill`, `absentFraction`, `marker` — are the ones
- * a state strip cannot do without: an intensity ramp inside a state, the share of a folded slot
- * nothing measured, and a fact that must not be read off the ramp.
- */
-declare function BandStripInner<T>(props: BandStripProps<T>): import("react").JSX.Element;
-export declare const BandStrip: typeof BandStripInner;
-export {};
-//# sourceMappingURL=BandStrip.d.ts.map

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

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