basalt-ui 1.24.0 → 1.26.0

package/configs/oxlint.json

@@ -27,11 +27,19 @@
     "basalt/raw-size-literal": "error",
     "basalt/card-inset": "error",
     "basalt/chart-in-raw-surface": "error",
-    "basalt/hand-rolled-plot": "warn",
-    "basalt/chart-legend-literal": "warn",
+    "basalt/hand-rolled-plot": "error",
+    "basalt/chart-legend-literal": "error",
     "basalt/shadow-basalt-export": "warn",
-    "basalt/hand-rolled-shell": "warn",
+    "basalt/hand-rolled-shell": "error",
     "basalt/raw-scroll-container": "error",
+    "basalt/hand-rolled-filter": "error",
+    "basalt/control-outside-home": "warn",
+    "basalt/control-size-literal": "warn",
+    "basalt/page-bar-budget": "error",
+    "basalt/in-body-page-title": "warn",
+    "basalt/responsive-twin": "warn",
+    "basalt/search-literal-link": "warn",
+    "basalt/use-search-from-literal": "warn",
     "basalt/visx-boundary": "error",
     "basalt/visx-tooltip": "error",
     "basalt/agent-resume-guard": "error",

package/dist/charts/cursor/resolve.d.ts

@@ -13,6 +13,24 @@
  * since "nearest category" is meaningless.
  */
 export declare function parseKey(key: string): number | null;
+/** The x-domain families the shared cursor partitions on, derived from a chart's own keys — never
+ * a prop, never `ChartCursorScope`. A chart's kind is stamped on every broadcast it makes, and a
+ * receiving chart ignores any broadcast whose kind differs from its own — so a category chart can
+ * never be mistaken for a time chart just because both domains happen to parse. */
+export type DomainKind = 'time' | 'linear' | 'band';
+/**
+ * Classify a domain by the SAME parse precedence `parseKey` applies to each key, so a domain can
+ * never be classified one way and resolved another:
+ *
+ * - empty domain → `'band'` (nothing to share).
+ * - every key numeric (same test `parseKey` tries first) → `'linear'`.
+ * - otherwise every key `Date.parse`-able (same test `parseKey` falls back to) → `'time'`.
+ * - otherwise → `'band'` (categories, or a mixed domain).
+ *
+ * Ordering matters and mirrors `parseKey` exactly: a domain of bare years like `"2026"` is numeric
+ * FIRST, so it classifies `'linear'`, not `'time'`, even though every value is also a valid date.
+ */
+export declare function classifyDomain(keys: readonly string[]): DomainKind;
 /**
  * How a foreign key maps onto a chart's own points.
  *

package/dist/charts/cursor/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAA;AAEpD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACrB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,mCAAmC;IACnC,MAAM,EAAE,CAAC,EAAE,CAAA;IACX,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,UAAU,EAAE,gBAAgB,CAAA;CAC7B,CAAA;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACxB,UAAU,GAAE,gBAA4B,GACvC,WAAW,CAAC,CAAC,CAAC,CA8BhB;AAoBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,gBAAmC,GAC9C,CAAC,GAAG,IAAI,CA0CV"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED;;;mFAGmF;AACnF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAKlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAA;AAEpD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACrB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,mCAAmC;IACnC,MAAM,EAAE,CAAC,EAAE,CAAA;IACX,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,UAAU,EAAE,gBAAgB,CAAA;CAC7B,CAAA;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACxB,UAAU,GAAE,gBAA4B,GACvC,WAAW,CAAC,CAAC,CAAC,CA8BhB;AAoBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,gBAAmC,GAC9C,CAAC,GAAG,IAAI,CA0CV"}

package/dist/charts/cursor/resolve.js

@@ -1,10 +1,18 @@
+function isNumericString(key) {
+  return /^[-+]?\d*\.?\d+$/.test(key) && Number.isFinite(Number(key));
+}
+function isDateParseableString(key) {
+  return !Number.isNaN(Date.parse(key));
+}
 function parseKey(key) {
-  if (/^[-+]?\d*\.?\d+$/.test(key)) {
-    const n = Number(key);
-    return Number.isFinite(n) ? n : null;
-  }
-  const t = Date.parse(key);
-  return Number.isNaN(t) ? null : t;
+  if (isNumericString(key)) return Number(key);
+  return isDateParseableString(key) ? Date.parse(key) : null;
+}
+function classifyDomain(keys) {
+  if (keys.length === 0) return "band";
+  if (keys.every(isNumericString)) return "linear";
+  if (keys.every(isDateParseableString)) return "time";
+  return "band";
 }
 function buildDomainIndex(data, getKey, resolution = "nearest") {
   const byKey = /* @__PURE__ */ new Map();
@@ -77,6 +85,7 @@ function resolveCursorPoint(index, key, resolution = index.resolution) {
 }
 export {
   buildDomainIndex,
+  classifyDomain,
   parseKey,
   resolveCursorPoint
 };

package/dist/charts/cursor/scope.d.ts

@@ -5,9 +5,12 @@ export type ChartCursorScopeProps = {
 };
 /**
  * ISOLATES its subtree onto a private cursor store — the inverse of the removed `ChartHoverSync`, which
- * had to be mounted to enable sharing at all. Charts share a cursor by default now; wrap a group
- * in this only when it must NOT follow the rest of the page (e.g. two independent dashboards
- * rendered side by side over the same calendar).
+ * had to be mounted to enable sharing at all. Charts share a cursor by default now, AND the shared
+ * cursor partitions automatically by x-domain kind (`DomainKind`, derived from each chart's own
+ * data in `useChartCursor`) — a categorical chart never follows a date chart just because both
+ * happen to be on the page, with nothing to configure. `ChartCursorScope` is no longer the tool for
+ * that case. What it is still for: isolating two charts that share the same domain KIND but are
+ * semantically unrelated — two different tenants' date ranges rendered side by side on one page.
  */
 export declare function ChartCursorScope({ children }: ChartCursorScopeProps): import("react").JSX.Element;
 /** The cursor store this chart belongs to — the nearest `ChartCursorScope`, else the global one. */

package/dist/charts/cursor/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/scope.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAKvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAGnE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,mFAAmF;AACnF,wBAAgB,cAAc,IAAI,WAAW,CAG5C"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/scope.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAKvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAGnE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,mFAAmF;AACnF,wBAAgB,cAAc,IAAI,WAAW,CAG5C"}

package/dist/charts/cursor/store.d.ts

@@ -11,16 +11,20 @@
  * charts subscribed to it, instead of every descendant of a provider whose value object is new
  * on each pointer frame.
  */
+import type { DomainKind } from './resolve.js';
 /** Broadcast cursor position: an opaque domain key plus the chart that owns it. */
 export type CursorState = {
     /** The hovered x-domain key (a date/category string), or null when nothing is hovered. */
     key: string | null;
     /** `chartId` of the chart the pointer is actually over — the one that owns the tooltip. */
     source: string | null;
+    /** The broadcaster's own x-domain kind. `null` only in the empty state — the store itself does
+     * not police this, it just carries it; the partition is enforced by the reading hook. */
+    kind: DomainKind | null;
 };
 export type CursorStore = {
     get: () => CursorState;
-    set: (key: string | null, source: string | null) => void;
+    set: (key: string | null, source: string | null, kind?: DomainKind | null) => void;
     subscribe: (onChange: () => void) => () => void;
 };
 /** Stable identity for "nothing hovered" — also the SSR snapshot, so it must never be recreated. */

package/dist/charts/cursor/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IACxB,0FAA0F;IAC1F,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,2FAA2F;IAC3F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,WAAW,CAAA;IACtB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,YAAY,EAAE,WAAyC,CAAA;AAEpE,wBAAgB,iBAAiB,IAAI,WAAW,CAkB/C;AAED,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,WAAiC,CAAA"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/charts/cursor/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IACxB,0FAA0F;IAC1F,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,2FAA2F;IAC3F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;6FACyF;IACzF,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,WAAW,CAAA;IACtB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAClF,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,YAAY,EAAE,WAAqD,CAAA;AAEhF,wBAAgB,iBAAiB,IAAI,WAAW,CAkB/C;AAED,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,WAAiC,CAAA"}

package/dist/charts/cursor/store.js

@@ -1,12 +1,12 @@
-const EMPTY_CURSOR = { key: null, source: null };
+const EMPTY_CURSOR = { key: null, source: null, kind: null };
 function createCursorStore() {
   let state = EMPTY_CURSOR;
   const listeners = /* @__PURE__ */ new Set();
   return {
     get: () => state,
-    set: (key, source) => {
-      if (state.key === key && state.source === source) return;
-      state = key === null && source === null ? EMPTY_CURSOR : { key, source };
+    set: (key, source, kind = null) => {
+      if (state.key === key && state.source === source && state.kind === kind) return;
+      state = key === null && source === null ? EMPTY_CURSOR : { key, source, kind };
       for (const listener of listeners) listener();
     },
     subscribe: (onChange) => {

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

@@ -1 +1 @@
-{"version":3,"file":"useChartCursor.d.ts","sourceRoot":"","sources":["../../../src/charts/hooks/useChartCursor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,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,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC5D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IACzD,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAsB,GACvB,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;CAC9B,GAAG,WAAW,CAAC,CAAC,CAAC,CAsHjB"}
+{"version":3,"file":"useChartCursor.d.ts","sourceRoot":"","sources":["../../../src/charts/hooks/useChartCursor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,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,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAC5D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IACzD,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAsB,GACvB,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;CAC9B,GAAG,WAAW,CAAC,CAAC,CAAC,CA8HjB"}

package/dist/charts/hooks/useChartCursor.js

@@ -1,6 +1,6 @@
 import { localPoint } from "@visx/event";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { buildDomainIndex, resolveCursorPoint } from "../cursor/resolve.js";
+import { buildDomainIndex, classifyDomain, resolveCursorPoint } from "../cursor/resolve.js";
 import { useCursorState, useCursorStore } from "../cursor/scope.js";
 function useChartCursor({
   data,
@@ -21,12 +21,13 @@ function useChartCursor({
     () => 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);
   useEffect(
     () => () => {
       if (frameRef.current !== null) cancelAnimationFrame(frameRef.current);
-      if (store.get().source === chartId) store.set(null, null);
+      if (store.get().source === chartId) store.set(null, null, null);
     },
     [store, chartId]
   );
@@ -55,9 +56,9 @@ function useChartCursor({
         }
       }
       scheduleAnchor({ x: event.clientX, y: event.clientY });
-      store.set(getKeyRef.current(closest), chartId);
+      store.set(getKeyRef.current(closest), chartId, kind);
     },
-    [data, marginLeft, chartId, store, scheduleAnchor]
+    [data, marginLeft, chartId, store, scheduleAnchor, kind]
   );
   const clear = useCallback(() => {
     if (frameRef.current !== null) {
@@ -66,7 +67,7 @@ function useChartCursor({
     }
     pendingRef.current = null;
     setAnchor(null);
-    if (store.get().source === chartId) store.set(null, null);
+    if (store.get().source === chartId) store.set(null, null, null);
   }, [store, chartId]);
   const onKeyDown = useCallback(
     (event) => {
@@ -88,11 +89,11 @@ function useChartCursor({
       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);
+      store.set(getKeyRef.current(next), chartId, kind);
     },
-    [data, store, chartId, clear, scheduleAnchor]
+    [data, store, chartId, clear, scheduleAnchor, kind]
   );
-  const point = cursor.key === null ? null : resolveCursorPoint(index, cursor.key);
+  const point = cursor.key === null || cursor.kind !== kind ? null : resolveCursorPoint(index, cursor.key);
   return {
     point,
     isSource: cursor.source === chartId,

package/dist/charts/index.d.ts

@@ -21,7 +21,7 @@ export { ChartFrame, type ChartFrameProps, type ChartFrameLegend, type PlotRect,
 export { ChartCenter, type ChartCenterProps, ChartPending, type ChartPendingProps, } from './primitives/ChartPending.js';
 export { Crosshair, SeriesDot } from './primitives/Crosshair.js';
 export { HatchPattern, hatchFill, hatchSizeFor } from './primitives/HatchPattern.js';
-export { ChartCard } from './primitives/ChartCard.js';
+export { ChartCard, type ChartCardProps } from './primitives/ChartCard.js';
 export { ChartLegend, type LegendEntry } from './primitives/ChartLegend.js';
 export { ChartTooltipFloat, TooltipHeader, TooltipRow, TooltipBody, } from './primitives/ChartTooltip.js';
 export { AxisBottomDate, AxisLeftNumeric, AxisRightNumeric } from './primitives/Axes.js';
@@ -31,7 +31,7 @@ export { XZoneRects, type XZoneSpec } from './primitives/XZoneRects.js';
 export { AreaGradient, areaFillUrl } from './primitives/AreaGradient.js';
 export { useChartCursor, type ChartCursor, type CursorAnchor } from './hooks/useChartCursor.js';
 export { foldBands, type BandFold, type BandTooltipConfig, type BandTooltipRowContext, } from './hooks/useBandPlot.js';
-export type { CursorResolution } from './cursor/resolve.js';
+export type { CursorResolution, DomainKind } from './cursor/resolve.js';
 export { useChartSize, type UseChartSizeResult, type ChartSize } from './hooks/useChartSize.js';
 export { fmtAxisDate, fmtTooltipDate } from './utils/format.js';
 export { smartTicks, smartTicksEvery } from './utils/ticks.js';

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

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

package/dist/charts/primitives/ChartCard.d.ts

@@ -1,14 +1,39 @@
-import type { ReactNode } from 'react';
 /**
- * Standard wrapper for every visx chart — card with info-tooltip title + optional
- * subtitle (the question the chart answers) + optional extra slot (current value
- * badge etc.). Do not wrap visx charts in bare divs.
+ * Standard wrapper for every visx chart (docs/CONTROLS-SPEC.md §2.2) — card with a `WidgetHeader
+ * tier="widget"` title row (icon/info/value/delta/count/actions) plus an optional subtitle, over a
+ * clipped chart body. Do not wrap visx charts in bare divs.
+ *
+ * `WidgetHeader` lives in `src/widget-header/` and is itself Mantine-free, so composing it here
+ * keeps `./charts` resolving with no `@mantine/*` installed (`check-dist-layering.mjs`,
+ * `basalt/token-layer-boundary`). The `actions` slot cannot mount `CtlSlot` (Mantine-coupled) for
+ * the same reason — it carries only `data-basalt-tier="widget"`; a basalt control placed there
+ * sizes itself (`size="ctl"` internally), and a raw Mantine element is not auto-tiered.
+ *
+ * The header renders only when at least one of title/info/value/actions/icon/count is set — ending
+ * the `''`-as-hidden-header sentinel a consumer used to reach for otherwise.
  */
-export declare function ChartCard({ title, subtitle, tooltip, extra, children, }: {
-    title: string;
+import type { ReactNode } from 'react';
+export type ChartCardProps = {
+    /** Optional — the header renders only when this or one of info/value/actions/icon/count is set. */
+    title?: string;
+    /** Optional leading icon, forwarded to `WidgetHeader`. */
+    icon?: ReactNode;
+    /** Optional muted line rendered below the title row — does NOT by itself trigger the header. */
     subtitle?: string;
-    tooltip: string;
-    extra?: ReactNode;
+    /** Renders `WidgetHeader`'s info glyph beside the title — a `More information` button whose
+     * bubble opens on hover, focus and click. Never part of the heading's accessible name. */
+    info?: string;
+    /** Pre-formatted metric value, on the hero-metric row with `delta`. */
+    value?: string;
+    /** Signed delta rendered via `DeltaBadge`, alongside `value`. */
+    delta?: number;
+    /** Comparison timeframe forwarded to `DeltaBadge` (e.g. `MoM`). */
+    deltaPeriod?: string;
+    /** Mono count tag after the title. */
+    count?: number;
+    /** Right-aligned slot — carries `data-basalt-tier="widget"` (no `CtlSlot`; see module doc). */
+    actions?: ReactNode;
     children: ReactNode;
-}): import("react").JSX.Element;
+};
+export declare function ChartCard({ title, icon, subtitle, info, value, delta, deltaPeriod, count, actions, children, }: ChartCardProps): import("react").JSX.Element;
 //# sourceMappingURL=ChartCard.d.ts.map

package/dist/charts/primitives/ChartCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartCard.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAkJrD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAgBA"}
+{"version":3,"file":"ChartCard.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAuCrD,MAAM,MAAM,cAAc,GAAG;IAC3B,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;8FAC0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,WAAW,EACX,KAAK,EACL,OAAO,EACP,QAAQ,GACT,EAAE,cAAc,+BAgChB"}

package/dist/charts/primitives/ChartCard.js

@@ -1,76 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useId, useRef, useState } from "react";
 import { VX } from "../../tokens/index.js";
-const infoWrapStyle = {
-  position: "relative",
-  display: "inline-flex",
-  alignItems: "center",
-  marginLeft: 5
-};
-const infoTriggerStyle = {
-  appearance: "none",
-  background: "none",
-  border: "none",
-  padding: 0,
-  margin: 0,
-  cursor: "help",
-  display: "inline-flex",
-  alignItems: "center"
-};
-const bubbleStyle = {
-  position: "absolute",
-  top: "calc(100% + 7px)",
-  left: 0,
-  zIndex: 10,
-  maxWidth: 260,
-  width: "max-content",
-  padding: "7px 10px",
-  borderRadius: VX.radiusCard,
-  backgroundColor: VX.surface.panel,
-  boxShadow: VX.shadowCard,
-  color: VX.muted,
-  fontSize: VX.text.sm,
-  fontWeight: 400,
-  lineHeight: 1.4,
-  whiteSpace: "normal",
-  pointerEvents: "none"
-};
-function InfoIcon({ title }) {
-  const [open, setOpen] = useState(false);
-  const tipId = useId();
-  const triggerRef = useRef(null);
-  useEffect(() => {
-    if (!open) return;
-    const handlePointerDown = (event) => {
-      if (triggerRef.current?.contains(event.target)) return;
-      setOpen(false);
-    };
-    document.addEventListener("pointerdown", handlePointerDown);
-    return () => document.removeEventListener("pointerdown", handlePointerDown);
-  }, [open]);
-  return /* @__PURE__ */ jsxs("span", { style: infoWrapStyle, children: [
-    /* @__PURE__ */ jsx(
-      "button",
-      {
-        ref: triggerRef,
-        type: "button",
-        "aria-label": "More information",
-        "aria-describedby": open ? tipId : void 0,
-        onMouseEnter: () => setOpen(true),
-        onMouseLeave: () => setOpen(false),
-        onFocus: () => setOpen(true),
-        onBlur: () => setOpen(false),
-        onClick: () => setOpen(true),
-        onKeyDown: (event) => {
-          if (event.key === "Escape") setOpen(false);
-        },
-        style: { ...infoTriggerStyle, color: open ? VX.muted : VX.faint },
-        children: /* @__PURE__ */ jsx("svg", { width: 11, height: 11, viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M12 0C5.373 0 0 5.373 0 12s5.373 12 12 12 12-5.373 12-12S18.627 0 12 0zm0 4a1.5 1.5 0 1 1 0 3 1.5 1.5 0 0 1 0-3zm0 5a1 1 0 0 1 1 1v7a1 1 0 1 1-2 0v-7a1 1 0 0 1 1-1z" }) })
-      }
-    ),
-    open && /* @__PURE__ */ jsx("span", { id: tipId, role: "tooltip", style: bubbleStyle, children: title })
-  ] });
-}
+import { WidgetHeader } from "../../widget-header/index.js";
 const cardStyle = {
   borderRadius: VX.radiusCard,
   boxShadow: VX.shadowCard,
@@ -85,57 +15,42 @@ const bodyClipStyle = {
   borderBottomLeftRadius: VX.radiusCard,
   borderBottomRightRadius: VX.radiusCard,
   overflow: "hidden",
-  padding: "2px var(--mantine-spacing-sm, 0.75rem) var(--mantine-spacing-xs, 0.625rem)"
-};
-const headerStyle = {
-  display: "flex",
-  justifyContent: "space-between",
-  alignItems: "center",
-  // Card inset = spacing xs (vertical) / sm (horizontal). The `--mantine-spacing-*` vars carry
-  // basalt's OWNED scale (theme.spacing.xs 0.625rem / sm 0.75rem); the rem fallbacks keep a
-  // Mantine-free `./charts`-only consumer (no MantineProvider vars) padded identically. No
-  // header/body divider — the title block and the plot read as one continuous surface; a rule here
-  // only doubled the card's shadow-embedded ring and made the header feel heavier.
-  padding: "var(--mantine-spacing-xs, 0.625rem) var(--mantine-spacing-sm, 0.75rem) 4px"
-};
-const titleColumnStyle = {
-  display: "inline-flex",
-  flexDirection: "column",
-  lineHeight: 1.15
+  padding: "2px var(--mantine-spacing-sm, 0.8125rem) var(--mantine-spacing-xs, 0.6875rem)"
 };
-const titleStyle = {
-  display: "inline-flex",
-  alignItems: "center",
-  fontFamily: "var(--basalt-font-head)",
-  fontStretch: "88%",
-  fontWeight: 550,
-  fontSize: VX.text.md,
-  color: VX.ink
-};
-const subtitleStyle = {
-  fontSize: VX.text.sm,
-  fontWeight: 400,
-  color: VX.muted,
-  marginTop: 1
+const headerWrapStyle = {
+  padding: "var(--mantine-spacing-xs, 0.6875rem) var(--mantine-spacing-sm, 0.8125rem) 4px"
 };
 function ChartCard({
   title,
+  icon,
   subtitle,
-  tooltip,
-  extra,
+  info,
+  value,
+  delta,
+  deltaPeriod,
+  count,
+  actions,
   children
 }) {
+  const hasHeader = title !== void 0 || info !== void 0 || value !== void 0 || actions !== void 0 || icon !== void 0 || count !== void 0;
   return /* @__PURE__ */ jsxs("div", { style: cardStyle, children: [
-    /* @__PURE__ */ jsxs("div", { style: headerStyle, children: [
-      /* @__PURE__ */ jsxs("span", { style: titleColumnStyle, children: [
-        /* @__PURE__ */ jsxs("span", { style: titleStyle, children: [
-          title,
-          /* @__PURE__ */ jsx(InfoIcon, { title: tooltip })
-        ] }),
-        subtitle !== void 0 && /* @__PURE__ */ jsx("span", { style: subtitleStyle, children: subtitle })
-      ] }),
-      extra !== void 0 && /* @__PURE__ */ jsx("span", { children: extra })
-    ] }),
+    hasHeader && /* @__PURE__ */ jsx("div", { style: headerWrapStyle, children: /* @__PURE__ */ jsx(
+      WidgetHeader,
+      {
+        tier: "widget",
+        title: title ?? "",
+        ...icon !== void 0 && { icon },
+        ...subtitle !== void 0 && { subtitle },
+        ...info !== void 0 && { info },
+        ...value !== void 0 && { value },
+        ...delta !== void 0 && { delta },
+        ...deltaPeriod !== void 0 && { deltaPeriod },
+        ...count !== void 0 && { count },
+        ...actions !== void 0 && {
+          actions: /* @__PURE__ */ jsx("span", { "data-basalt-tier": "widget", children: actions })
+        }
+      }
+    ) }),
     /* @__PURE__ */ jsx("div", { style: bodyClipStyle, children })
   ] });
 }

package/dist/charts/primitives/ChartCard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChartCard.test.d.ts.map

package/dist/charts/primitives/ChartCard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartCard.test.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartCard.test.tsx"],"names":[],"mappings":""}

package/dist/charts/sparklines/BarSparkline.d.ts

@@ -3,11 +3,35 @@ type BarSparklineProps = {
     width: number;
     height: number;
     color?: string;
+    /**
+     * Gap between two bars, in px. `1` is the shipped look; `2` at ~10 bars reads as a discrete series
+     * rather than a histogram, which is the KPI-card treatment.
+     *
+     * @default 1
+     */
+    barGap?: number;
+    /**
+     * Bar corner radius, in px. `0` is the shipped look.
+     *
+     * @default 0
+     */
+    barRadius?: number;
+    /**
+     * Paints the LAST bar in `emphasisColor` at full opacity — "this is where the series ends", the
+     * one reading a trend beside a KPI value is actually for. Off by default: a chart that means
+     * something by its final point must say so.
+     *
+     * @default false
+     */
+    emphasizeLast?: boolean;
+    /** The emphasised bar's fill. @default `VX.accent` */
+    emphasisColor?: string;
     /** Accessible text alternative, applied as `aria-label` (+ `role="img"`) on the `<svg>`. */
     ariaLabel?: string;
 };
 /** Quiet inline bar trend — defaults to `VX.faint`, matching the sparkline family's restrained
- * identity (docs/DESIGN-SPEC.md §5). */
-export declare function BarSparkline({ data, width, height, color, ariaLabel }: BarSparklineProps): import("react").JSX.Element;
+ * identity (docs/DESIGN-SPEC.md §5). Every geometry option below defaults to the shipped look, so
+ * an existing call site renders byte-identically. */
+export declare function BarSparkline({ data, width, height, color, barGap, barRadius, emphasizeLast, emphasisColor, ariaLabel, }: BarSparklineProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=BarSparkline.d.ts.map

package/dist/charts/sparklines/BarSparkline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BarSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/BarSparkline.tsx"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;wCACwC;AACxC,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iBAAiB,+BAgCxF"}
+{"version":3,"file":"BarSparkline.d.ts","sourceRoot":"","sources":["../../../src/charts/sparklines/BarSparkline.tsx"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;qDAEqD;AACrD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,MAAU,EACV,SAAa,EACb,aAAqB,EACrB,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,+BAoCnB"}

package/dist/charts/sparklines/BarSparkline.js

@@ -2,8 +2,19 @@ import { jsx } from "react/jsx-runtime";
 import { scaleLinear } from "@visx/scale";
 import { useMemo } from "react";
 import { VX } from "../../tokens/index.js";
-function BarSparkline({ data, width, height, color, ariaLabel }) {
+function BarSparkline({
+  data,
+  width,
+  height,
+  color,
+  barGap = 1,
+  barRadius = 0,
+  emphasizeLast = false,
+  emphasisColor,
+  ariaLabel
+}) {
   const fillColor = color ?? VX.faint;
+  const lastColor = emphasisColor ?? VX.accent;
   const a11yProps = ariaLabel !== void 0 ? { role: "img", "aria-label": ariaLabel } : {};
   const yScale = useMemo(() => {
     const max = Math.max(...data.filter((v) => isFinite(v)), 1);
@@ -11,9 +22,11 @@ function BarSparkline({ data, width, height, color, ariaLabel }) {
   }, [data, height]);
   if (!data.length) return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps });
   const step = width / data.length;
-  const barWidth = Math.max(step - 1, 1);
+  const barWidth = Math.max(step - barGap, 1);
+  const lastIndex = data.length - 1;
   return /* @__PURE__ */ jsx("svg", { width, height, ...a11yProps, children: data.map((v, i) => {
     const bh = Math.max(yScale(Math.max(v, 0)), 0);
+    const isLast = emphasizeLast && i === lastIndex;
     return /* @__PURE__ */ jsx(
       "rect",
       {
@@ -21,8 +34,9 @@ function BarSparkline({ data, width, height, color, ariaLabel }) {
         y: height - bh,
         width: barWidth,
         height: bh,
-        fill: fillColor,
-        fillOpacity: 0.75
+        ...barRadius > 0 && { rx: barRadius },
+        fill: isLast ? lastColor : fillColor,
+        fillOpacity: isLast ? 1 : 0.75
       },
       i
     );

package/dist/cli/check-coverage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-coverage.test.d.ts.map

package/dist/cli/check-coverage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-coverage.test.d.ts","sourceRoot":"","sources":["../../src/cli/check-coverage.test.ts"],"names":[],"mappings":""}