basalt-ui 1.16.0 → 1.18.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.18.0](https://github.com/jkrumm/basalt-ui/compare/v1.17.0...v1.18.0) (2026-08-19)
+
+
+### Features
+
+* render tooltips on cursor followers, and gate managed-doc drift ([6b46613](https://github.com/jkrumm/basalt-ui/commit/6b466136e1b1dbd88934d339420179768b3e9f8b)), closes [#52](https://github.com/jkrumm/basalt-ui/issues/52)
+
+# [1.17.0](https://github.com/jkrumm/basalt-ui/compare/v1.16.0...v1.17.0) (2026-08-18)
+
+
+### Features
+
+* fix seven chart defects, six of them found by consumers ([c3df0b8](https://github.com/jkrumm/basalt-ui/commit/c3df0b8439c51effaf425c54644cd9a15328ef12))
+
 # [1.16.0](https://github.com/jkrumm/basalt-ui/compare/v1.15.0...v1.16.0) (2026-08-18)
 
 

package/agent/rules/basalt-charts.md

@@ -137,7 +137,26 @@ ships no map kind.
    `tickFormat` (`TickFormatter<string>`, defaults to `fmtAxisDate` — `DD.MM`) — the only supported
    exit for a sub-day window, where the default collapses every tick to the same label and a raw
    `<AxisBottom>` isn't an option. `CartesianChart`'s own `formatX` prop is the higher-level way to
-   set this without touching the axis component at all.
+   set this without touching the axis component at all — and every cartesian kind (`Bars`/
+   `MultiLine`/`StackedArea`/`ZonedLine`/`DualPanel`) forwards its own `formatX?: (key) => string`
+   now too, not just `CartesianChart` itself. Without it, the only route to a custom x label was
+   pre-formatting it into the domain key, which makes one string serve as display value, scale
+   identity, AND cursor key simultaneously — and a truncating formatter then collapses two points
+   onto one domain value, silently dropping one from the plot (see #6 below for why that's the
+   cursor's problem too). `Heatmap` is deliberately excluded: its existing `colLabel`/`rowLabel`
+   already are that seam, and a second prop over one concern would fork them.
+   **The x axis is CATEGORICAL, and this is not inferable from the API.** `CartesianChart` builds
+   its x scale as `scalePoint<string>`, so N points are N evenly spaced positions whatever the
+   values behind the keys — there is no linear or time x scale. Correct and invisible for a domain
+   that is already a regular grid (five-minute buckets ARE evenly spaced); wrong for an event-shaped
+   series (speed-test runs, deploys, sessions). Two silent consequences: on a page sharing one
+   cursor, event points draw at equal spacing, so the crosshair marks the right point at a different
+   screen x than a regularly-sampled sibling — the correlation stays legible in the numbers and not
+   in the geometry; and because the domain value must be unique, two events at the same instant
+   collapse onto one position and one stops being drawn. `getX` returning a date string reads like a
+   time axis and is not one. Tracked as issue #52; a chart whose x is a measured quantity currently
+   needs a `basalt/hand-rolled-plot` exemption.
+
 6. **The cursor is shared by default.** No provider needed — `useChartCursor` reads a module-level
    external store (`useSyncExternalStore`), so every `CartesianChart`/`ChartFrame`-composed chart on
    the page shares one cursor out of the box. `ChartCursorScope` **isolates** a subtree onto a
@@ -160,10 +179,26 @@ ships no map kind.
    into weekly buckets still tracks a hover from a sibling plotting daily points, with no extra
    wiring — `resolveKey` no longer exists because there is nothing left for it to patch.
 
+   `CursorResolution = 'nearest' | 'leading'` (exported from `basalt-ui/charts`) picks WHICH own
+   point wins that resolution, reachable as `cursorResolution` on `CartesianChart`/every cartesian
+   kind/`DualPanel` and as `useChartCursor`'s `resolution` option — default `'nearest'`, unchanged.
+   Reach for `'leading'` when `getX` returns a bucket's LEADING EDGE (a weekly series keyed by its
+   Monday, a monthly series keyed by its 1st): under `'nearest'`, a hover landing in the back half
+   of a bucket resolves to the FOLLOWING bucket instead of the one it's actually inside, so the
+   shared crosshair sits one column right of the data being pointed at — reproducibly, for every
+   back-half hover.
+
 7. **Keyboard-operable by construction.** The hover overlay `CartesianChart` renders is focusable;
    `←`/`→` scrub the shared cursor one point at a time, `Escape` clears it. The tooltip is
    `aria-live="polite"`. This comes for free from composing `CartesianChart`/`ChartFrame` — nothing
-   to wire per chart.
+   to wire per chart. That's exactly why `ChartFrame`'s outer container uses `role="group"` on its
+   `ariaLabel`, **never** `role="img"`: per the ARIA spec every descendant of a `role="img"`
+   element is presentational, which would erase the hover overlay's `role="slider"` from the
+   accessibility tree entirely — the label still announces, but the keyboard-scrubbable control
+   underneath it becomes unreachable, silently, with no error anywhere. jsdom does not implement
+   that pruning, so no `getByRole` test can ever catch this regression; it is a structural rule, not
+   a test-covered one. Do not "simplify" `ChartFrame`'s container role back to `img` — it looks like
+   a no-op refactor and it is not.
 8. **Theme-aware colors** via `VX.*` tokens + `alpha()`. **Never** a raw hex literal in a chart file.
    **Never** `localStorage.getItem('theme')` — the scheme resolves via CSS vars (see Dark/light
    below).
@@ -197,6 +232,13 @@ and its crosshair dots entirely):
   the crosshair at the plot's top edge instead, which reads better across a column of charts sharing
   one cursor (every tooltip lines up on the same x). Anchoring costs one `getBoundingClientRect` per
   hovered frame, which is why following is the default.
+- `formatHeader?: (key, d) => string` — overrides the tooltip header's date text (also
+  `TooltipHeader`'s own `format` prop directly, and the identical seam on `DualPanel`'s
+  `formatHeader`, so the two never diverge). Default: today's `fmtTooltipDate` behavior, unchanged.
+  The seam exists because `fmtTooltipDate` regexes `YYYY-MM-DD` out of the domain key and builds a
+  LOCAL `Date` from it — a UTC ISO key then names a different day than `formatX`, the tooltip badge,
+  and every sibling chart, all of which resolve locally; the only prior workaround was carrying a
+  local-offset ISO key. Receives the raw `getX` key alongside the hovered datum.
 
 Per-series, `SeriesStyle.tooltip: false` means "draw the mark and legend it, but never give it a
 tooltip row" — it lives on the series, not on the kind. `ChartSeries.formatValue` is
@@ -261,7 +303,10 @@ per-series `getValue` accessors on `ChartSeries<T>`):
 - **`MultiLine`** — N series on a shared y-axis (or two, via `y2`): legend-hover dimming, per-series
   synced dots, dashed companion (MA) lines, per-point markers (PR stars / status dots), zones +
   refLines, fixed or auto domain (covers z-score/σ via a fixed symmetric domain + zero refLine).
-  Composes `CartesianChart`.
+  Composes `CartesianChart`. `ChartSeries.getMarker` returns `{ color?, r?, fillOpacity?, ring? }`
+  — `ring` defaults `true` (today's punched-out stroke, unchanged), `ring: false` omits the stroke
+  entirely, `fillOpacity` defaults `1`. Existed because a consumer's plain `fillOpacity: 0.7` dots
+  were unreproducible after moving their chart onto the kind — the old shape had no seam for either.
 - **`DualPanel`** — top line-pane + bottom signed-histogram pane sharing one x-scale and one cursor;
   optional fill-between two top lines, zones, refLines, per-point markers on the top pane
   (`ChartSeries.getMarker`). Composes `ChartFrame` directly (two panes, not one plot rect). The
@@ -311,7 +356,7 @@ One object per axis on `CartesianChart` and every kind that composes it — this
 ```tsx
 y={{
   domain: 'auto',        // 'auto' (default) | [min, max] | (data, visible) => [min, max]
-  autoMaxFloor: 100,      // when 'auto': upper bound is at least this
+  autoMaxFloor: 100,      // when 'auto': raw upper bound is at least this, clamped BEFORE padding
   autoMinCeil: 0,         // when 'auto': lower bound is at most this (Infinity = pad from raw min)
   autoPad: 1.1,           // when 'auto': padding multiplier away from the data
   ticks: 5,
@@ -321,6 +366,15 @@ y={{
 }}
 ```
 
+**Behavior change (2026-08-19) — the one item in this doc that can move an existing chart's
+rendering:** `autoMaxFloor` now clamps the raw upper bound BEFORE padding, mirroring `autoMinCeil`,
+which has always clamped first and padded second — two different laws used to live in one function.
+The old order padded the raw max, then applied the floor last, so when the floor won it landed
+exactly on the axis top with zero headroom: a target line sitting at precisely the floor value was
+glued to the plot edge. Measured case: dataMax 3.2, pad 1.1, floor 6 → axis top was 6.0, is now
+6.6. A consumer relying on the old ordering will see their axis top move — lower the floor or pin
+`domain` explicitly to opt back out.
+
 `nice` defaults `false` deliberately: flipping the default would move the domain of every
 already-migrated chart, so it's opt-in per axis.
 

package/agent/skills/basalt-design/SKILL.md

@@ -227,7 +227,7 @@ Every chart composes the shipped primitives — never hand-rolled equivalents:
 
 - **`ChartCard`** wrapper (title + info-tooltip + extra slot, consistent margin).
 - **`ChartLegend`** (`line | bar | split | splitLine` shapes) — never hand-rolled legend markup.
-- **`ChartTooltip`** + `TooltipHeader` / `TooltipRow` / `TooltipBody` — never import `@visx/tooltip`
+- **`ChartTooltipFloat`** + `TooltipHeader` / `TooltipRow` / `TooltipBody` — never import `@visx/tooltip`
   directly (oxlint bans it in chart files).
 - **`AxisBottomDate`** / **`AxisLeftNumeric`** / **`AxisRightNumeric`** — never raw
   `<AxisLeft>`/`<AxisBottom>` (they miss theme tokens + smart ticks). Now lint-enforced:
@@ -262,7 +262,7 @@ resolve/render with no `@mantine/*` installed — CI-tested, repo-local only, no
 - Every color comes from a token (`VX.*` / palette) — `basalt-ui check-theme` green, zero raw hex.
 - One hue per metric; categorical multi-color only where the data is genuinely categorical.
 - Neutral line/axis/grid; soft `AreaGradient` on plain metric lines, opaque stacked-area bands.
-- Tooltip = `ChartCard` / `ChartTooltip` primitives, one swatch per row — no hand-rolled markup.
+- Tooltip = `ChartCard` / `ChartTooltipFloat` primitives, one swatch per row — no hand-rolled markup.
 - Looks right in BOTH schemes (toggled and checked: glow on dark, contrast on light).
 - New colors landed as `{ light, dark }` pairs in the palette, not inline.
 - Nothing reads `localStorage.getItem('theme')`.

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

@@ -13,6 +13,26 @@
  * since "nearest category" is meaningless.
  */
 export declare function parseKey(key: string): number | null;
+/**
+ * How a foreign key maps onto a chart's own points.
+ *
+ * `'nearest'` (default) treats every key as a POINT — the foreign key resolves to whichever own
+ * point sits closest to it. Correct when a chart's x-domain is a set of instants.
+ *
+ * `'leading'` treats every key as the LEADING EDGE of a bucket covering `[key, nextKey)` — the
+ * foreign key resolves to the LAST own key `<=` it. Use this when a chart's keys are bucket
+ * starts (a weekly series keyed by the Monday of each week, a monthly series keyed by the 1st):
+ * under `'nearest'`, a target landing in the back half of a bucket resolves to the FOLLOWING
+ * bucket instead of the one it's actually inside, and the shared crosshair lands one column off
+ * for every back-half hover.
+ *
+ * The two modes differ at the DOMAIN EDGES too, and deliberately: `'nearest'` tolerates one step
+ * past each end (the target is an instant, so the closest point is still a defensible answer),
+ * while `'leading'` bounds strictly to `[first, last + step)` — outside that range no bucket
+ * CONTAINS the key, and answering with the nearest one would paint a crosshair on a bucket that
+ * provably excludes it.
+ */
+export type CursorResolution = 'nearest' | 'leading';
 export type DomainIndex<T> = {
     byKey: Map<string, T>;
     /** Parsed positions, ascending. Empty when the domain isn't parseable. */
@@ -21,13 +41,17 @@ export type DomainIndex<T> = {
     points: T[];
     /** Median spacing — the tolerance within which a foreign key still resolves. */
     step: number;
+    /** The resolution strategy this index was built for. */
+    resolution: CursorResolution;
 };
 /** Build the lookup structure once per `data` identity. */
-export declare function buildDomainIndex<T>(data: readonly T[], getKey: (d: T) => string): DomainIndex<T>;
+export declare function buildDomainIndex<T>(data: readonly T[], getKey: (d: T) => string, resolution?: CursorResolution): DomainIndex<T>;
 /**
- * The own point a broadcast `key` maps to: exact match first, else the nearest parsed position
- * within one domain step. Out of range → null, so charts over unrelated domains never paint a
- * cursor for each other — which is what makes "shared by default" safe.
+ * The own point a broadcast `key` maps to: exact match first, else — per `index.resolution` — the
+ * nearest parsed position or the last position at/before the target, both within one domain step.
+ * Out of range → null, so charts over unrelated domains never paint a cursor for each other —
+ * which is what makes "shared by default" safe. A categorical (unparseable) domain falls back to
+ * exact-match-only in BOTH resolutions, since "nearest"/"leading" over a category is meaningless.
  */
-export declare function resolveCursorPoint<T>(index: DomainIndex<T>, key: string): T | null;
+export declare function resolveCursorPoint<T>(index: DomainIndex<T>, key: string, resolution?: CursorResolution): T | null;
 //# sourceMappingURL=resolve.d.ts.map

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,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;CACb,CAAA;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CA4BhG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA+BlF"}
+{"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"}

package/dist/charts/cursor/resolve.js

@@ -6,7 +6,7 @@ function parseKey(key) {
   const t = Date.parse(key);
   return Number.isNaN(t) ? null : t;
 }
-function buildDomainIndex(data, getKey) {
+function buildDomainIndex(data, getKey, resolution = "nearest") {
   const byKey = /* @__PURE__ */ new Map();
   const parsed = [];
   let parseable = true;
@@ -17,7 +17,9 @@ function buildDomainIndex(data, getKey) {
     if (value === null) parseable = false;
     else parsed.push({ value, point: d });
   }
-  if (!parseable || parsed.length < 2) return { byKey, values: [], points: [], step: 0 };
+  if (!parseable || parsed.length < 2) {
+    return { byKey, values: [], points: [], step: 0, resolution };
+  }
   parsed.sort((a, b) => a.value - b.value);
   const values = parsed.map((p) => p.value);
   const points = parsed.map((p) => p.point);
@@ -26,15 +28,34 @@ function buildDomainIndex(data, getKey) {
     diffs.push(values[i] - values[i - 1]);
   }
   diffs.sort((a, b) => a - b);
-  return { byKey, values, points, step: diffs[Math.floor(diffs.length / 2)] ?? 0 };
+  return { byKey, values, points, step: diffs[Math.floor(diffs.length / 2)] ?? 0, resolution };
+}
+function resolveLeading(index, target) {
+  let lo = 0;
+  let hi = index.values.length - 1;
+  let result = 0;
+  while (lo <= hi) {
+    const mid = lo + hi >> 1;
+    if (index.values[mid] <= target) {
+      result = mid;
+      lo = mid + 1;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  return index.points[result];
 }
-function resolveCursorPoint(index, key) {
+function resolveCursorPoint(index, key, resolution = index.resolution) {
   const exact = index.byKey.get(key);
   if (exact !== void 0) return exact;
   const target = parseKey(key);
   if (target === null || index.values.length === 0) return null;
   const first = index.values[0];
   const last = index.values[index.values.length - 1];
+  if (resolution === "leading") {
+    if (target < first || target >= last + index.step) return null;
+    return resolveLeading(index, target);
+  }
   if (target < first - index.step || target > last + index.step) return null;
   let lo = 0;
   let hi = index.values.length - 1;

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

@@ -1,4 +1,5 @@
 import type { KeyboardEvent, PointerEvent } from 'react';
+import type { CursorResolution } from '../cursor/resolve.js';
 /** Viewport-space pointer anchor the tooltip positions against. */
 export type CursorAnchor = {
     x: number;
@@ -28,12 +29,18 @@ export type ChartCursor<T> = {
  * costs nothing while a real bucket change reaches siblings on the same tick rather than a frame
  * late.
  */
-export declare function useChartCursor<T>({ data, chartId, getKey, xScale, marginLeft, }: {
+export declare function useChartCursor<T>({ data, chartId, getKey, xScale, marginLeft, resolution, }: {
     data: readonly T[];
     chartId: string;
     getKey: (d: T) => string;
     /** Own x scale — maps a domain key to a plot-local x offset. */
     xScale: (key: string) => number | undefined;
     marginLeft: number;
+    /**
+     * How a sibling's broadcast key resolves against this chart's own points. Default `'nearest'`
+     * (point domains). Pass `'leading'` when `getKey` returns a bucket's leading edge (a weekly
+     * series keyed by its Monday, a monthly series keyed by its 1st) — see {@link CursorResolution}.
+     */
+    resolution?: CursorResolution;
 }): ChartCursor<T>;
 //# sourceMappingURL=useChartCursor.d.ts.map

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;AAIxD,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,GACX,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;CACnB,GAAG,WAAW,CAAC,CAAC,CAAC,CAmHjB"}
+{"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"}

package/dist/charts/hooks/useChartCursor.js

@@ -7,7 +7,8 @@ function useChartCursor({
   chartId,
   getKey,
   xScale,
-  marginLeft
+  marginLeft,
+  resolution = "nearest"
 }) {
   const store = useCursorStore();
   const cursor = useCursorState();
@@ -16,7 +17,10 @@ function useChartCursor({
   getKeyRef.current = getKey;
   const xScaleRef = useRef(xScale);
   xScaleRef.current = xScale;
-  const index = useMemo(() => buildDomainIndex(data, getKeyRef.current), [data]);
+  const index = useMemo(
+    () => buildDomainIndex(data, getKeyRef.current, resolution),
+    [data, resolution]
+  );
   const frameRef = useRef(null);
   const pendingRef = useRef(null);
   useEffect(

package/dist/charts/index.d.ts

@@ -29,6 +29,7 @@ export { ZoneRects, type ZoneSpec } from './primitives/ZoneRects.js';
 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 type { CursorResolution } 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/kinds/Bars.d.ts

@@ -1,3 +1,4 @@
+import type { CursorResolution } from '../cursor/resolve.js';
 import type { ChartMargin } from '../../tokens/index.js';
 import type { AxisConfig, CartesianTooltipConfig } from '../primitives/CartesianChart.js';
 import type { ZoneSpec } from '../primitives/ZoneRects.js';
@@ -88,6 +89,14 @@ export type BarsProps<T> = {
     barOpacity?: (d: T, key: string) => number;
     /** X tick count override. Default: as many as fit. */
     xTicks?: number;
+    /** X tick label formatter. Default `fmtAxisDate` (DD.MM). */
+    formatX?: (key: string) => string;
+    /**
+     * How a sibling chart's broadcast cursor key resolves against this chart's points. Default
+     * `'nearest'`. Pass `'leading'` when `getX` returns a bucket's leading edge (a weekly series
+     * keyed by its Monday) — see `CursorResolution`.
+     */
+    cursorResolution?: CursorResolution;
     /** `false` disables the tooltip entirely (and with it the crosshair dots). */
     tooltip?: CartesianTooltipConfig<T> | false;
     /** Per-side overrides of the measured margins — the escape hatch, applied last. */

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

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

package/dist/charts/kinds/Bars.js

@@ -24,6 +24,8 @@ function BarsInner(props) {
     barLayout = "stacked",
     barOpacity,
     xTicks,
+    formatX,
+    cursorResolution,
     tooltip,
     margin,
     legend,
@@ -126,6 +128,8 @@ function BarsInner(props) {
       y: yConfig,
       ...y2 !== void 0 && { y2 },
       ...xTicks !== void 0 && { xTicks },
+      ...formatX !== void 0 && { formatX },
+      ...cursorResolution !== void 0 && { cursorResolution },
       ...zones !== void 0 && { zones },
       ...mappedRefLines !== void 0 && { refLines: mappedRefLines },
       ...height !== void 0 && { height },

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

@@ -1,4 +1,5 @@
 import type { ZoneSpec } from '../primitives/ZoneRects.js';
+import type { CursorResolution } from '../cursor/resolve.js';
 import type { ChartLegendConfig, ChartSeries } from '../series.js';
 export type DualPanelProps<T> = {
     data: T[];
@@ -6,6 +7,15 @@ export type DualPanelProps<T> = {
     height?: number;
     chartId: string;
     getX: (d: T) => string;
+    /** X tick label formatter. Default `fmtAxisDate` (DD.MM) — same default `CartesianChart` uses,
+     * so omitting it is byte-identical to today's rendering. */
+    formatX?: (key: string) => string;
+    /**
+     * How a sibling chart's broadcast cursor key resolves against this chart's points. Default
+     * `'nearest'`. Pass `'leading'` when `getX` returns a bucket's leading edge (a weekly series
+     * keyed by its Monday) — see `CursorResolution`.
+     */
+    cursorResolution?: CursorResolution;
     /** 1+ line series in the top pane — the single source of truth for color, dash, legend, and
      * tooltip rows. E.g. acute (solid) / chronic (dashed). */
     series: ChartSeries<T>[];
@@ -52,6 +62,20 @@ export type DualPanelProps<T> = {
         text: string;
         color: string;
     } | null;
+    /**
+     * Overrides the tooltip header's date text — the same seam `CartesianChart`'s
+     * `CartesianTooltipConfig.formatHeader` exposes, so the two don't diverge. Default:
+     * `TooltipHeader`'s own `fmtTooltipDate` behavior, unchanged. Receives the raw `getX` key
+     * alongside the hovered datum.
+     */
+    formatHeader?: (key: string, d: T) => string;
+    /**
+     * Render this chart's tooltip when it is a cursor FOLLOWER, not only when it is the SOURCE —
+     * same seam and same anchored-positioning behaviour as `CartesianTooltipConfig.onFollow`. Default
+     * false (today's behaviour). Only the SOURCE's tooltip is `aria-live`; a follower's is visual
+     * only.
+     */
+    onFollow?: boolean;
     /** Legend config forwarded to `ChartFrame`; `false` disables the legend (sparkline escape).
      * Default `{ placement: 'bottom' }`. */
     legend?: ChartLegendConfig | false;

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

@@ -1 +1 @@
-{"version":3,"file":"DualPanel.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/DualPanel.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAIvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAe,MAAM,WAAW,CAAA;AAK5E,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;8DAC0D;IAC1D,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACtC,2EAA2E;IAC3E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxD,wGAAwG;IACxG,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAClE,oDAAoD;IACpD,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,8DAA8D;IAC9D,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,+FAA+F;IAC/F,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC;;yFAEqF;IACrF,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACzC;iGAC6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kEAAkE;IAClE,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/D;4CACwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAmClD;AAsdD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAA2B,OAAO,cAAc,CAAA"}
+{"version":3,"file":"DualPanel.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/DualPanel.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAe,MAAM,WAAW,CAAA;AAK5E,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;gEAC4D;IAC5D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;8DAC0D;IAC1D,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACtC,2EAA2E;IAC3E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxD,wGAAwG;IACxG,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAClE,oDAAoD;IACpD,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,8DAA8D;IAC9D,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,+FAA+F;IAC/F,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC;;yFAEqF;IACrF,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACzC;iGAC6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kEAAkE;IAClE,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/D;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;4CACwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAmClD;AAggBD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAA2B,OAAO,cAAc,CAAA"}

package/dist/charts/kinds/DualPanel.js

@@ -5,7 +5,7 @@ import { Group } from "@visx/group";
 import { scaleLinear, scalePoint } from "@visx/scale";
 import { Bar, LinePath } from "@visx/shape";
 import { Threshold } from "@visx/threshold";
-import { memo, useMemo } from "react";
+import { memo, useMemo, useRef } from "react";
 import { AxisBottomDate, AxisLeftNumeric } from "../primitives/Axes.js";
 import {
   ChartTooltipFloat,
@@ -55,6 +55,9 @@ function DualPanelPlot(props) {
     data,
     chartId,
     getX,
+    formatX = fmtAxisDate,
+    cursorResolution,
+    ariaLabel,
     series,
     topYDomain = "auto",
     fillBetween,
@@ -71,6 +74,8 @@ function DualPanelPlot(props) {
     bottomYDomain = "auto",
     bottomMaxAbsFloor,
     tooltipLabel,
+    formatHeader,
+    onFollow,
     plot
   } = props;
   const { hidden } = plot;
@@ -126,7 +131,7 @@ function DualPanelPlot(props) {
     }).labels,
     [bottomDomain, formatBottom, useNiceBottom]
   );
-  const xLabelsAll = useMemo(() => data.map((d) => fmtAxisDate(getX(d))), [data, getX]);
+  const xLabelsAll = useMemo(() => data.map((d) => formatX(getX(d))), [data, getX, formatX]);
   const margin = useMemo(
     () => autoMargin({ left: [...topLabels, ...bottomLabels], bottom: xLabelsAll }),
     [topLabels, bottomLabels, xLabelsAll]
@@ -162,7 +167,8 @@ function DualPanelPlot(props) {
     chartId,
     getKey: getX,
     xScale,
-    marginLeft: margin.left
+    marginLeft: margin.left,
+    ...cursorResolution !== void 0 && { resolution: cursorResolution }
   });
   const tickValues = useMemo(() => smartTicks(data.map(getX), xMax), [data, xMax, getX]);
   const barWidth = data.length > 0 ? Math.max(xMax / data.length * 0.6, 2) : 2;
@@ -234,6 +240,7 @@ function DualPanelPlot(props) {
         if (m === null) continue;
         const cx = xScale(getX(p.__d)) ?? 0;
         const cy = topYScale(p.__y);
+        const ring = m.ring ?? true;
         markers.push(
           /* @__PURE__ */ jsx(
             "circle",
@@ -242,8 +249,8 @@ function DualPanelPlot(props) {
               cy,
               r: m.r ?? VX.dotR,
               fill: m.color ?? s.color,
-              stroke: VX.dotStroke,
-              strokeWidth: 2
+              fillOpacity: m.fillOpacity ?? 1,
+              ...ring && { stroke: VX.dotStroke, strokeWidth: 2 }
             },
             `mk-${s.key}-${getX(p.__d)}`
           )
@@ -253,11 +260,17 @@ function DualPanelPlot(props) {
     }),
     [visibleSeries, lineValid, xScale, topYScale, getX]
   );
+  const svgRef = useRef(null);
   const point = cursor.point;
   const sx = point !== null ? xScale(getX(point)) ?? 0 : 0;
   const syncedBar = point !== null ? getBar(point) : null;
+  const isFollowerRender = !cursor.isSource && onFollow === true;
+  const showTooltip = point !== null && (cursor.isSource || isFollowerRender);
+  const anchorX = isFollowerRender && point !== null ? sx : null;
+  const svgRect = anchorX === null ? void 0 : svgRef.current?.getBoundingClientRect();
+  const tooltipAnchor = svgRect === void 0 || anchorX === null ? cursor.anchor : { x: svgRect.left + margin.left + anchorX, y: svgRect.top + margin.top };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsxs("svg", { width: plot.width, height: plot.height, children: [
+    /* @__PURE__ */ jsxs("svg", { ref: svgRef, width: plot.width, height: plot.height, children: [
       /* @__PURE__ */ jsxs(Group, { left: margin.left, top: margin.top, children: [
         /* @__PURE__ */ jsx(GridRows, { scale: topYScale, width: xMax, stroke: VX.grid, numTicks: 4 }),
         /* @__PURE__ */ jsx(ZoneRects, { zones: topZones, width: xMax, leftScale: topYScale }),
@@ -321,7 +334,13 @@ function DualPanelPlot(props) {
             onMove: cursor.onPointerMove,
             onLeave: cursor.onPointerLeave,
             onKeyDown: cursor.onKeyDown,
-            onBlur: cursor.onBlur
+            onBlur: cursor.onBlur,
+            valueMax: Math.max(data.length - 1, 0),
+            ...point !== null && {
+              valueNow: data.indexOf(point),
+              valueText: formatX(getX(point))
+            },
+            ...ariaLabel !== void 0 && { ariaLabel }
           }
         )
       ] }),
@@ -359,7 +378,15 @@ function DualPanelPlot(props) {
           }
         ),
         /* @__PURE__ */ jsx(AxisLeftNumeric, { scale: bottomYScale, numTicks: 3, tickFormat: formatBottom }),
-        /* @__PURE__ */ jsx(AxisBottomDate, { top: bottomH, scale: xScale, tickValues }),
+        /* @__PURE__ */ jsx(
+          AxisBottomDate,
+          {
+            top: bottomH,
+            scale: xScale,
+            tickValues,
+            tickFormat: formatX
+          }
+        ),
         /* @__PURE__ */ jsx(
           HoverOverlay,
           {
@@ -372,11 +399,14 @@ function DualPanelPlot(props) {
       ] }),
       point !== null && /* @__PURE__ */ jsx(Group, { left: margin.left, top: margin.top, children: /* @__PURE__ */ jsx(Crosshair, { x: sx, top: 0, bottom: innerH }) })
     ] }),
-    cursor.isSource && point !== null && /* @__PURE__ */ jsxs(ChartTooltipFloat, { anchor: cursor.anchor, children: [
+    showTooltip && /* @__PURE__ */ jsxs(ChartTooltipFloat, { anchor: tooltipAnchor, ariaLive: cursor.isSource, children: [
       /* @__PURE__ */ jsx(
         TooltipHeader,
         {
           date: getX(point),
+          ...formatHeader !== void 0 && {
+            format: (key) => formatHeader(key, point)
+          },
           ...(() => {
             const lbl = tooltipLabel?.(point) ?? null;
             return lbl !== null ? { label: lbl.text, labelColor: lbl.color } : {};

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

@@ -1,3 +1,4 @@
+import type { CursorResolution } from '../cursor/resolve.js';
 import type { CartesianTooltipConfig, AxisConfig } from '../primitives/CartesianChart.js';
 import type { XZoneSpec } from '../primitives/XZoneRects.js';
 import type { ZoneSpec } from '../primitives/ZoneRects.js';
@@ -31,6 +32,14 @@ export type MultiLineProps<T> = {
     }[];
     /** Exact number of x ticks. Default: as many as fit. */
     xTicks?: number;
+    /** X tick label formatter. Default `fmtAxisDate` (DD.MM). */
+    formatX?: (key: string) => string;
+    /**
+     * How a sibling chart's broadcast cursor key resolves against this chart's points. Default
+     * `'nearest'`. Pass `'leading'` when `getX` returns a bucket's leading edge (a weekly series
+     * keyed by its Monday) — see `CursorResolution`.
+     */
+    cursorResolution?: CursorResolution;
     /** Tooltip config — `label` for a right-aligned header badge, `extraRows` for rows appended
      * after the derived per-series rows. `false` disables the tooltip entirely. */
     tooltip?: CartesianTooltipConfig<T> | false;

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

@@ -1 +1 @@
-{"version":3,"file":"MultiLine.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/MultiLine.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAe,MAAM,8BAA8B,CAAA;AAEnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG/D,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;mFAC+E;IAC/E,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxB;gEAC4D;IAC5D,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACjB;kEAC8D;IAC9D,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAClB,iFAAiF;IACjF,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB;sBACkB;IAClB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAC/D,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;mFAC+E;IAC/E,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IAC3C,4DAA4D;IAC5D,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC/B;4CACwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AA4BD;;;;;;;;;;;;GAYG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAgDlD;AAqHD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAA2B,OAAO,cAAc,CAAA"}
+{"version":3,"file":"MultiLine.d.ts","sourceRoot":"","sources":["../../../src/charts/kinds/MultiLine.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAe,MAAM,8BAA8B,CAAA;AAEnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG/D,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;IACtB;mFAC+E;IAC/E,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxB;gEAC4D;IAC5D,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACjB;kEAC8D;IAC9D,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAClB,iFAAiF;IACjF,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB;sBACkB;IAClB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAC/D,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;mFAC+E;IAC/E,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IAC3C,4DAA4D;IAC5D,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC/B;4CACwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAA;IAClC,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AA4BD;;;;;;;;;;;;GAYG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,+BAoDlD;AAmHD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAA2B,OAAO,cAAc,CAAA"}