@pond-ts/charts 0.70.0 → 0.72.0

package/dist/selectors.d.ts

@@ -227,9 +227,8 @@ export interface MultiSelectorProps {
  *
  * - The shared brush band becomes the **resting cursor**, spanning the snap
  *   block under the pointer (the `sequence` bucket, else the layer's own
- *   bin/slot), replacing the container's implicit `'line'` default. An
- *   explicitly chosen cursor — a mounted component, or a legacy `cursor`
- *   string the consumer actually set — still wins the surface.
+ *   bin/slot), when no cursor component is mounted for the row. A mounted
+ *   cursor still wins the surface.
  * - Hover is **block-scoped**: pointing at any one mark of a block lights
  *   (and reports) every mark in it. Rest and drag share one code path — the
  *   same snap buckets, the same layer session — so what the rest previews and

package/dist/selectors.js

@@ -173,9 +173,8 @@ export function Selector({ enabled = true, selected, hovered, onHover, onSelect,
  *
  * - The shared brush band becomes the **resting cursor**, spanning the snap
  *   block under the pointer (the `sequence` bucket, else the layer's own
- *   bin/slot), replacing the container's implicit `'line'` default. An
- *   explicitly chosen cursor — a mounted component, or a legacy `cursor`
- *   string the consumer actually set — still wins the surface.
+ *   bin/slot), when no cursor component is mounted for the row. A mounted
+ *   cursor still wins the surface.
  * - Hover is **block-scoped**: pointing at any one mark of a block lights
  *   (and reports) every mark in it. Rest and drag share one code path — the
  *   same snap buckets, the same layer session — so what the rest previews and

package/dist/tracker.d.ts

@@ -1,11 +1,10 @@
 /**
- * Cursor geometry helpers — pure functions deciding *what* the cursor draws
- * ({@link cursorParts}) and *where* it sits ({@link resolveCursorX}). The marks
+ * Cursor geometry helpers — pure functions deciding *where* the cursor sits
+ * ({@link resolveCursorX}) and which bucket it shades. The marks
  * themselves render as an SVG overlay in `Layers` (no cursor canvas); these
  * helpers stay pure, so they're unit-tested directly.
  */
-import type { Interval } from 'pond-ts';
-import type { CursorMode } from './context.js';
+import { Interval } from 'pond-ts';
 /**
  * The interval in the sorted, non-overlapping `buckets` that contains `t`
  * (`begin ≤ t < end`), or `undefined` if `t` falls in no bucket. Binary search —
@@ -39,30 +38,13 @@ export declare function bandRect(buckets: readonly Interval[], t1: number, xScal
     x0: number;
     x1: number;
 } | null;
-/** Default cursor mode — the synced vertical line (cursor enabled on the
- *  container by default; pair with an off-chart readout via `onTrackerChanged`). */
-export declare const DEFAULT_CURSOR_MODE: CursorMode;
 /**
- * Decompose a {@link CursorMode} into what it draws: the shared vertical line,
- * the per-series dots, and which value chip (if any). The modes are exclusive
- * presets — `line` is line-only, `point` / `inline` / `flag` are dot-based with
- * no line, `none` draws nothing. `flag` raises a staff from each point to a
- * value flag stacked near the top of the row (drawn in `Layers`).
- *
- * **Superseded by the mounted cursor presets** (`cursors.tsx` — each mode's
- * drawing now lives in its component's registered spec): `Layers` no longer
- * reads this. Kept, with its tests, for the life of the `cursor` string-prop
- * deprecation window as the pinned record of what each mode drew; delete both
- * when the modes go.
+ * The unit slots `[i, i+1)` of a category axis, from its band scale's domain
+ * (`[0, n]`) — the buckets a `<RangeCursor>` snaps to there when no bar layer
+ * has published its own (a bar layer's are the same slots). Empty for an
+ * empty axis.
  */
-export declare function cursorParts(mode: CursorMode): {
-    readonly line: boolean;
-    readonly dots: boolean;
-    readonly chip: 'none' | 'inline' | 'flag' | 'axis';
-    /** `region` mode: a shaded **band** over the bucket under the pointer (from
-     *  `cursorSequence`), drawn by `Layers`; no line/dots/chip of its own. */
-    readonly band: boolean;
-};
+export declare function categorySlots(domain: readonly unknown[]): Interval[];
 /**
  * The crosshair's plot-pixel x from the tracker inputs. **A live local pointer
  * always wins:** a chart the user is actively hovering (`hoverX` non-null) shows
@@ -79,8 +61,8 @@ export declare function cursorParts(mode: CursorMode): {
  *
  * `null` and `undefined` are **equivalent** — both mean "no controlled position"
  * (a hovered chart still tracks its pointer; a non-hovered one shows nothing). To
- * force a chart to never show a cursor at all, use `cursor="none"`, not
- * `trackerPosition={null}`.
+ * force a chart to never show a cursor at all, mount no cursor component, rather
+ * than relying on `trackerPosition={null}`.
  */
 export declare function resolveCursorX(trackerPosition: number | null | undefined, hoverX: number | null, xScale: (time: number) => number): number | null;
 //# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.js

@@ -1,9 +1,10 @@
 /**
- * Cursor geometry helpers — pure functions deciding *what* the cursor draws
- * ({@link cursorParts}) and *where* it sits ({@link resolveCursorX}). The marks
+ * Cursor geometry helpers — pure functions deciding *where* the cursor sits
+ * ({@link resolveCursorX}) and which bucket it shades. The marks
  * themselves render as an SVG overlay in `Layers` (no cursor canvas); these
  * helpers stay pure, so they're unit-tested directly.
  */
+import { Interval } from 'pond-ts';
 /**
  * The interval in the sorted, non-overlapping `buckets` that contains `t`
  * (`begin ≤ t < end`), or `undefined` if `t` falls in no bucket. Binary search —
@@ -70,45 +71,21 @@ export function bandRect(buckets, t1, xScale, plotWidth, t2) {
     const x1 = Math.min(plotWidth, xScale(span.end));
     return x1 > x0 ? { x0, x1 } : null;
 }
-/** Default cursor mode — the synced vertical line (cursor enabled on the
- *  container by default; pair with an off-chart readout via `onTrackerChanged`). */
-export const DEFAULT_CURSOR_MODE = 'line';
 /**
- * Decompose a {@link CursorMode} into what it draws: the shared vertical line,
- * the per-series dots, and which value chip (if any). The modes are exclusive
- * presets — `line` is line-only, `point` / `inline` / `flag` are dot-based with
- * no line, `none` draws nothing. `flag` raises a staff from each point to a
- * value flag stacked near the top of the row (drawn in `Layers`).
- *
- * **Superseded by the mounted cursor presets** (`cursors.tsx` — each mode's
- * drawing now lives in its component's registered spec): `Layers` no longer
- * reads this. Kept, with its tests, for the life of the `cursor` string-prop
- * deprecation window as the pinned record of what each mode drew; delete both
- * when the modes go.
+ * The unit slots `[i, i+1)` of a category axis, from its band scale's domain
+ * (`[0, n]`) — the buckets a `<RangeCursor>` snaps to there when no bar layer
+ * has published its own (a bar layer's are the same slots). Empty for an
+ * empty axis.
  */
-export function cursorParts(mode) {
-    const base = { line: false, dots: false, chip: 'none', band: false };
-    switch (mode) {
-        case 'line':
-            return { ...base, line: true };
-        case 'point':
-            return { ...base, dots: true };
-        case 'inline':
-            return { ...base, dots: true, chip: 'inline' };
-        case 'flag':
-            return { ...base, dots: true, chip: 'flag' };
-        case 'crosshair':
-            // A single reticle (not per-series): `Layers` draws the dashed vertical +
-            // full-width horizontal lines, the centre dot, and one value pill itself
-            // (so no generic line/dots here); the x-time pill is on `<XAxis>`.
-            return { ...base, chip: 'axis' };
-        case 'region':
-            // A shaded band over the bucket under the pointer — `Layers` resolves the
-            // bucket from `cursorBuckets` and draws the rect (cropped through xScale).
-            return { ...base, band: true };
-        case 'none':
-            return { ...base };
+export function categorySlots(domain) {
+    const lo = Number(domain[0]);
+    const n = Math.max(0, Math.round(Number(domain[1]) - lo));
+    const out = [];
+    for (let i = 0; i < n; i += 1) {
+        const b = lo + i;
+        out.push(new Interval({ value: b, start: b, end: b + 1 }));
     }
+    return out;
 }
 /**
  * The crosshair's plot-pixel x from the tracker inputs. **A live local pointer
@@ -126,8 +103,8 @@ export function cursorParts(mode) {
  *
  * `null` and `undefined` are **equivalent** — both mean "no controlled position"
  * (a hovered chart still tracks its pointer; a non-hovered one shows nothing). To
- * force a chart to never show a cursor at all, use `cursor="none"`, not
- * `trackerPosition={null}`.
+ * force a chart to never show a cursor at all, mount no cursor component, rather
+ * than relying on `trackerPosition={null}`.
  */
 export function resolveCursorX(trackerPosition, hoverX, xScale) {
     if (hoverX !== null)

package/dist/tradingTimeScale.d.ts

@@ -183,13 +183,13 @@ export interface TradingTimeScale {
      * `02 AM`; a sub-day axis reads date **+** clock). This is the grain-aware
      * default the crosshair pill, marker indicators, and annotation auto-labels
      * use — replacing d3's multi-scale default, which showed local time-of-day
-     * for any off-local-midnight instant. A container `cursorFormat` overrides it.
+     * for any off-local-midnight instant. A cursor's `format` overrides it.
      */
     readoutFormat(count?: number): (value: number) => string;
     /**
      * The axis's resolved **coarse grain** ({@link TimeGrain}) at `count` — the
      * unit the ticks currently sit on (`year` … `second`), strides collapsed. A
-     * `cursorFormat` callback receives this so it can branch on the zoom level
+     * cursor `format` callback receives this so it can branch on the zoom level
      * (return a year when zoomed out, a clock when zoomed in) without
      * re-deriving the ladder the axis already ran.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/charts",
-  "version": "0.70.0",
+  "version": "0.72.0",
   "private": false,
   "description": "Canvas-rendered, streaming-first React time-series charts for pond-ts: line, area, band, bar, scatter, box, candlestick, with cursors, selection and annotations",
   "keywords": [
@@ -62,8 +62,8 @@
     "perf": "PERF_BENCH=1 playwright test perf.spec.ts --workers=1"
   },
   "peerDependencies": {
-    "@pond-ts/react": "^0.70.0",
-    "pond-ts": "^0.70.0",
+    "@pond-ts/react": "^0.72.0",
+    "pond-ts": "^0.72.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {