basalt-ui 1.30.2 → 1.32.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/primitives/legend-disclosure.d.ts

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1 @@
+{"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;AAwDrD;;;;;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

@@ -0,0 +1,153 @@
+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

@@ -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