basalt-ui 1.30.2 → 1.31.0

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

@@ -0,0 +1,175 @@
+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 +1,18 @@
 import type { ReactNode } from 'react';
-import { chartTierMetrics, resolveChartTier } from './chart-frame-layout.js';
-import type { ChartTier, ChartTierMetrics } from './chart-frame-layout.js';
+import type { ContainerClass } from '../../tokens/size-classes.js';
+import type { ChartTierMetrics } from './chart-frame-layout.js';
 export type ChartTierProviderProps = {
-    tier: ChartTier;
+    containerClass: ContainerClass;
     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 };
+/** 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;
+/** Whether the primary pointer is coarse. Server snapshot `false`: hydration agrees, then updates. */
+export declare function useCoarsePointer(): boolean;
+/** 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 +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"}
+{"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;AAEtC,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;AAID,sGAAsG;AACtG,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AA+BD,gGAAgG;AAChG,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

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

@@ -1,20 +1,49 @@
 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 });
+import { createContext, useContext, useSyncExternalStore } from "react";
+import { useMediaQuery } from "../../common/use-media-query.js";
+import { chartMetrics } from "./chart-frame-layout.js";
+const ChartContainerClassContext = createContext("regular");
+function ChartTierProvider({ containerClass, children }) {
+  return /* @__PURE__ */ jsx(ChartContainerClassContext.Provider, { value: containerClass, children });
 }
-function useChartTier() {
-  return useContext(ChartTierContext);
+function useChartContainerClass() {
+  return useContext(ChartContainerClassContext);
 }
-function useChartTierMetrics() {
-  return chartTierMetrics(useContext(ChartTierContext));
+function useChartMetrics() {
+  return chartMetrics(useChartContainerClass());
+}
+const subscribeNothing = () => () => {
+};
+function useCoarsePointer() {
+  return useMediaQuery("(pointer: coarse)", false);
+}
+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,
-  chartTierMetrics,
-  resolveChartTier,
-  useChartTier,
-  useChartTierMetrics
+  useChartContainerClass,
+  useChartMetrics,
+  useCoarsePointer,
+  useViewportHeight
 };

package/dist/charts/series.d.ts

@@ -59,7 +59,10 @@ export type ChartLegendConfig = {
     placement?: LegendPlacement;
     /** Visually separate role: series | overlay | reference. */
     groups?: boolean;
-    /** Wrap cap → "+N more" rollup at high cardinality. */
+    /**
+     * @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;

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

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

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

@@ -6,27 +6,46 @@ import type { ChartTier } from '../primitives/chart-frame-layout.js';
  * `useBandPlot` and `DualPanel` — the three call sites that used to reimplement this formula.
  *
  * `fontPx` defaults to `VX.axisFont`; a phone-tier chart passes its own smaller tick font
- * (`chartTierMetrics().axisFont`) so the spacing is derived from the size actually painted.
+ * (`chartMetrics().axisFont`) so the spacing is derived from the size actually painted.
  */
 export declare function xLabelPxFor(labels: string[], fontPx?: number): number;
+/**
+ * The horizontal room one 45°-rotated x label takes: its projected box (`cos 45°` of the width plus
+ * one line box) plus the gap. A tilted label still competes with its neighbour for this much, so
+ * thinning by the bare `VX.minPxPerTick` floor let two of them touch as soon as the plot widened.
+ */
+export declare function rotatedXLabelPx(labels: string[], fontPx?: number): number;
 /**
  * Pick evenly-spaced tick values that fit the available width.
  *
  * `labelPx` is the width one formatted label actually needs (measured, plus the gap it wants from
- * its neighbour) and overrides the `VX.minPxPerTick` floor whenever it is wider. Without it the
- * spacing came from that constant alone regardless of what was painted, so a `formatX` returning
- * `Mar 08 14:00` overlapped at every width — the one side of the chart that did not follow §1's
- * "measure what you paint" law. Omit it and nothing moves.
+ * its neighbour) and REPLACES the `VX.minPxPerTick` constant whenever it is supplied, in either
+ * direction — a wide label needs more room than the constant assumed (a `formatX` returning
+ * `Mar 08 14:00` used to overlap at every width, the one side of the chart that did not follow
+ * §1's "measure what you paint" law), and a narrow one (single-digit band labels) can pack in
+ * MORE ticks than the constant would allow, which the floor used to suppress (R2C-11). Omit it and
+ * the constant is what governs, same as before.
  *
  * The final key is still appended when the step misses the last index — a thinned axis would
  * otherwise paint no label at the right edge at all — but it no longer prints ON TOP of its
  * neighbour. An appended tick lands a PARTIAL step from the last one on the grid, so at any tick
  * count wide enough labels overlap there; measured at `/charts-stress` block (f1), `Mar 13 14:00`
  * and `Mar 14 14:00` printed over each other at 1440px. When that gap is narrower than one label,
- * the grid tick before it is dropped instead. Index 0 is never dropped: the left edge is the one
- * label a reader orients from.
+ * the grid tick before it is dropped instead.
+ *
+ * `anchorTerminals` (default false) mirrors the SAME flag `autoMargin`/`Axes.tsx` take: when the
+ * axis anchors index 0 and the last index at their TEXT edge rather than their centre
+ * (`terminalAnchor`), each reaches a FULL label's width toward its neighbour instead of half, so
+ * the plain per-tick pitch above (sized for two centred labels) isn't enough at either boundary —
+ * `Bars` with 30 daily "Jan DD HH:MM" keys overlapped there at phone width even though the interior
+ * pitch was fine (R2C-6). The SAME rule then applies, symmetrically, to the tick right after
+ * index 0. 1.5× is a deliberately generous (cheap, simple) stand-in for "one label plus half a
+ * label" rather than measuring the split precisely; it's skipped when `labelPx` is only the bare
+ * `VX.minPxPerTick` floor, which has no relationship to how wide a label actually is. Index 0
+ * always survives (never the one dropped here) and `last` is always (re-)added below, so dropping
+ * any OTHER index never breaks the "at least 2 ticks" floor.
  */
-export declare function smartTicks(dates: string[], xMax: number, labelPx?: number): string[];
+export declare function smartTicks(dates: string[], xMax: number, labelPx?: number, anchorTerminals?: boolean): string[];
 /**
  * Which of a BAND axis's category labels may be painted so that no two neighbours overlap — the
  * same measured law {@link smartTicks} applies to a point axis, for a chart that lays its labels

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

@@ -1 +1 @@
-{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/ticks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAMjE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBpF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,CAAC,CAkBb;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxE;AAaD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf;qEACiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,CAAC,GAAG,EAAE,CAST"}
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/ticks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAMjE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,MAAM,CAItF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,UAAQ,GACtB,MAAM,EAAE,CAoEV;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,CAAC,CAkBb;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxE;AAaD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf;qEACiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,CAAC,GAAG,EAAE,CAST"}

package/dist/charts/utils/ticks.js

@@ -4,21 +4,44 @@ const X_TICK_LABEL_GAP = 8;
 function xLabelPxFor(labels, fontPx = VX.axisFont) {
   return maxTextWidth(labels, fontPx) + X_TICK_LABEL_GAP;
 }
-function smartTicks(dates, xMax, labelPx) {
+function rotatedXLabelPx(labels, fontPx = VX.axisFont) {
+  return Math.ceil(COS_45 * (maxTextWidth(labels, fontPx) + Math.ceil(fontPx * 1.35))) + X_TICK_LABEL_GAP;
+}
+function smartTicks(dates, xMax, labelPx, anchorTerminals = false) {
   if (dates.length === 0) return [];
-  const perTick = Math.max(VX.minPxPerTick, labelPx ?? 0);
+  const perTick = labelPx !== void 0 && labelPx > 0 ? labelPx : VX.minPxPerTick;
   const maxTicks = Math.max(2, Math.floor(xMax / perTick));
-  if (dates.length <= maxTicks) return dates;
-  const step = Math.ceil(dates.length / maxTicks);
   const last = dates.length - 1;
+  const pxPerIndex = dates.length > 0 ? xMax / dates.length : 0;
+  const anchored = anchorTerminals && labelPx !== void 0 && labelPx > 0;
   const keep = /* @__PURE__ */ new Set();
-  for (let i = 0; i <= last; i += step) keep.add(i);
-  const lastOnGrid = Math.floor(last / step) * step;
-  if (lastOnGrid !== last) {
-    const pxPerIndex = dates.length > 0 ? xMax / dates.length : 0;
-    const gapPx = (last - lastOnGrid) * pxPerIndex;
-    if (lastOnGrid > 0 && gapPx > 0 && gapPx < perTick) keep.delete(lastOnGrid);
-    keep.add(last);
+  if (dates.length <= maxTicks) {
+    for (let i = 0; i <= last; i += 1) keep.add(i);
+  } else {
+    const step = Math.ceil(dates.length / maxTicks);
+    for (let i = 0; i <= last; i += step) keep.add(i);
+    const BOUNDARY_FACTOR = 1.5;
+    const boundaryPx = anchored ? perTick * BOUNDARY_FACTOR : perTick;
+    const lastOnGrid = Math.floor(last / step) * step;
+    if (lastOnGrid !== last) {
+      const gapPx = (last - lastOnGrid) * pxPerIndex;
+      if (lastOnGrid > 0 && gapPx > 0 && gapPx < boundaryPx) keep.delete(lastOnGrid);
+      keep.add(last);
+    }
+  }
+  if (anchored && keep.size > 1) {
+    const BOUNDARY_FACTOR = 1.5;
+    const boundaryPx = perTick * BOUNDARY_FACTOR;
+    const sorted = [...keep].toSorted((a, b) => a - b);
+    const second = sorted[1];
+    if (second !== void 0 && second !== last && second * pxPerIndex < boundaryPx) {
+      keep.delete(second);
+    }
+    const afterHead = [...keep].toSorted((a, b) => a - b);
+    const secondLast = afterHead[afterHead.length - 2];
+    if (secondLast !== void 0 && secondLast !== 0 && (last - secondLast) * pxPerIndex < boundaryPx) {
+      keep.delete(secondLast);
+    }
   }
   return dates.filter((_, i) => keep.has(i));
 }
@@ -61,6 +84,7 @@ function autoXLabelRotate(input) {
 }
 export {
   autoXLabelRotate,
+  rotatedXLabelPx,
   smartTicks,
   smartTicksEvery,
   thinLabels,

package/dist/common/errors.d.ts

@@ -22,7 +22,7 @@ export declare function oneOf(component: string, prop: string, allowed: readonly
  * A prop still shipped and still working, with a named successor and the version it goes away in.
  * Majors are banned here, so the deprecation notice IS the migration channel.
  */
-export declare function deprecatedProp(component: string, oldProp: string, newProp: string, removeIn: string): string;
+export declare function deprecatedProp(component: string, oldProp: string, newProp: string, removeIn: string, note?: string): string;
 /**
  * A prop the component ACCEPTS, reads nothing from, and cannot report as wrong — because a SECOND
  * prop it was passed alongside decides the same thing and won.
@@ -34,6 +34,12 @@ export declare function deprecatedProp(component: string, oldProp: string, newPr
  * constants and a whole `compact` branch changed no pixel.
  */
 export declare function ignoredProp(component: string, prop: string, because: string): string;
+/**
+ * A numeric `height` the caller stated that, once the legend band is taken out, leaves the plot
+ * under the floor. The frame keeps the plot at the floor and grows past the number, so the chart
+ * is taller than the caller asked for and nothing else says why.
+ */
+export declare function plotBelowFloor(component: string, height: number, floor: number): string;
 /**
  * An imperative call needs a layer that is not there — the optional peer is not installed, or the
  * mount that subscribes to its event bus is disabled. Both halves are named because the remedy
@@ -42,6 +48,10 @@ export declare function ignoredProp(component: string, prop: string, because: st
 export declare function missingLayer(component: string, layer: string, remedy: string): string;
 /** A single-mount component found a second instance alive (`BasaltProvider`, `Notifications`). */
 export declare function duplicateMount(component: string): string;
+/** Two frames inside one `ChartCard` both want the header legend slot (`docs/waves/PLAN.md` wave
+ * 3, P2-9) — only the first to mount keeps it, every later one falls back to its own band legend
+ * rather than silently overwriting the portal. */
+export declare function legendSlotContention(component: string): string;
 /**
  * The HTTP status behind a thrown envelope (Eden Treaty's `{ status, value }`, a `Response`-shaped
  * throw), when there is one. Use it to BRANCH — 404 → "not found" copy — rather than to build a

package/dist/common/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/common/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yDAAyD;AACzD,eAAO,MAAM,aAAa,aAAa,CAAA;AAMvC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,oEAAoE;AACpE,wBAAgB,KAAK,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,OAAO,GACX,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAOD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI5D;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAwB,GAAG,MAAM,CAKrF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/common/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yDAAyD;AACzD,eAAO,MAAM,aAAa,aAAa,CAAA;AAMvC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,oEAAoE;AACpE,wBAAgB,KAAK,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,OAAO,GACX,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;kDAEkD;AAClD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK9D;AAOD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI5D;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAwB,GAAG,MAAM,CAKrF"}

package/dist/common/errors.js

@@ -11,15 +11,21 @@ function oneOf(component, prop, allowed, got) {
     `prop "${prop}" must be one of ${allowed.map((value) => `'${value}'`).join(" | ")} \u2014 got ${JSON.stringify(got)}.`
   );
 }
-function deprecatedProp(component, oldProp, newProp, removeIn) {
+function deprecatedProp(component, oldProp, newProp, removeIn, note) {
   return message(
     component,
-    `prop "${oldProp}" is deprecated \u2014 use "${newProp}" instead. "${oldProp}" is removed in ${removeIn}.`
+    `prop "${oldProp}" is deprecated \u2014 use "${newProp}" instead. "${oldProp}" is removed in ${removeIn}.${note === void 0 ? "" : ` ${note}`}`
   );
 }
 function ignoredProp(component, prop, because) {
   return message(component, `prop "${prop}" is ignored because ${because}`);
 }
+function plotBelowFloor(component, height, floor) {
+  return message(
+    component,
+    `prop "height" (${height}) leaves less than the ${floor}px plot floor once the legend band is subtracted, so the frame grows past it. Raise the height or drop the legend.`
+  );
+}
 function missingLayer(component, layer, remedy) {
   return message(component, `needs ${layer}, which is not available \u2014 ${remedy}.`);
 }
@@ -29,6 +35,12 @@ function duplicateMount(component) {
     "more than one instance is mounted at once \u2014 mount exactly one, at the app root."
   );
 }
+function legendSlotContention(component) {
+  return message(
+    component,
+    "more than one chart in this ChartCard wants the header legend slot \u2014 only the first keeps it, the rest fall back to their own band legend."
+  );
+}
 function errorStatus(err) {
   if (err === null || typeof err !== "object") return void 0;
   const status = err.status;
@@ -61,8 +73,10 @@ export {
   duplicateMount,
   errorStatus,
   ignoredProp,
+  legendSlotContention,
   missingLayer,
   oneOf,
+  plotBelowFloor,
   requiredProp,
   toErrorMessage
 };

package/dist/common/hit-floor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The pointer-tier hit floors, in px — WCAG 2.5.8 Target Size Minimum (24) and 2.5.5 Target Size
+ * Enhanced (44). One home for the number `--vx-hit` resolves to under `(pointer: coarse)` and for
+ * the components that compare a MEASURED px against it (a virtual list's row height, a column-fold
+ * toggle's width, the chart legend's dot pitch). Deliberately not re-exported through
+ * `common/index.ts`: a CSS-var's numeric value is not a public symbol.
+ */
+export declare const HIT_FINE = 24;
+export declare const HIT_COARSE = 44;
+//# sourceMappingURL=hit-floor.d.ts.map

package/dist/common/hit-floor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-floor.d.ts","sourceRoot":"","sources":["../../src/common/hit-floor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,KAAK,CAAA;AAC1B,eAAO,MAAM,UAAU,KAAK,CAAA"}

package/dist/common/hit-floor.js

@@ -0,0 +1,6 @@
+const HIT_FINE = 24;
+const HIT_COARSE = 44;
+export {
+  HIT_COARSE,
+  HIT_FINE
+};

package/dist/{shell → common}/isomorphic-layout-effect.d.ts

@@ -5,9 +5,10 @@
  * nothing on the server" warning. The branch reads a global that cannot change between renders, so
  * the hook identity is stable across every render of every caller.
  *
- * One module rather than one `const` per file: `page-bar.tsx` and `page-aside.tsx` declared the
- * same line with the same doc, and the second copy's doc already said "see `page-bar.tsx`'s copy".
- * Not exported from any barrel — this is a shell-internal utility, not a published hook.
+ * Lives in `common/` rather than beside the shell because both halves use it — the shell chrome, the
+ * provider, and the Mantine-free measured-fold core — and `common/` is the one module both may
+ * import from. One module rather than one `const` per file. Not exported from any barrel; import it
+ * by path.
  */
 import { useEffect } from 'react';
 export declare const useIsomorphicLayoutEffect: typeof useEffect;

package/dist/common/isomorphic-layout-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isomorphic-layout-effect.d.ts","sourceRoot":"","sources":["../../src/common/isomorphic-layout-effect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAmB,MAAM,OAAO,CAAA;AAElD,eAAO,MAAM,yBAAyB,kBAA8D,CAAA"}

package/dist/common/use-measured-widths.d.ts

@@ -0,0 +1,37 @@
+import type { MutableRefObject } from 'react';
+/** One measured element's box, cached while it was still visible (a folded child is gone from the DOM). */
+export type MeasuredBox = {
+    width: number;
+    height: number;
+};
+export interface UseMeasuredWidthsOptions {
+    /** The box to observe, resolved on each effect run. */
+    resolveRoot: () => HTMLElement | null;
+    /** Change this string to drop every cached box — a folded child cannot report its unfolded width. */
+    signature: string;
+    /** Skip measuring entirely (the feature is off). Default true. */
+    enabled?: boolean;
+    /** Bump to re-measure on demand beyond a resize (a post-reset commit). */
+    nonce?: number;
+    /** Extra descendants to observe besides the root (an inner table whose min-content can move). */
+    extra?: (root: HTMLElement) => (Element | null)[];
+    /** Read the current boxes from `root`, fill the cache, and plan — runs on every measure. */
+    onMeasure: (root: HTMLElement, boxes: MutableRefObject<Map<string, MeasuredBox>>) => void;
+}
+export interface UseMeasuredWidthsResult {
+    boxes: MutableRefObject<Map<string, MeasuredBox>>;
+    /** Re-run the measurement by hand (a web font settling changes every width without a resize). */
+    remeasure: () => void;
+}
+/**
+ * The measured-fold core every fold planner shares: caches each measured box while it is visible,
+ * re-reads on a `ResizeObserver` of the root (plus {@link UseMeasuredWidthsOptions.extra}), and
+ * clears the cache when the {@link UseMeasuredWidthsOptions.signature} changes. The caller keeps its
+ * own element reading and pure plan function in `onMeasure`.
+ *
+ * A folded child is gone from the DOM but its cached box survives, so a resize never needs it back
+ * on screen; the caller's `onMeasure` decides which boxes to cache (e.g. skip an item that is
+ * currently folded, whose painted width is the collapsed one).
+ */
+export declare function useMeasuredWidths(options: UseMeasuredWidthsOptions): UseMeasuredWidthsResult;
+//# sourceMappingURL=use-measured-widths.d.ts.map

package/dist/common/use-measured-widths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-measured-widths.d.ts","sourceRoot":"","sources":["../../src/common/use-measured-widths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAG7C,2GAA2G;AAC3G,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3D,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACrC,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iGAAiG;IACjG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAA;IACjD,4FAA4F;IAC5F,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,KAAK,IAAI,CAAA;CAC1F;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACjD,iGAAiG;IACjG,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAiD5F"}