@cascivo/charts 0.3.14 → 0.4.1

package/dist/index.d.ts

@@ -227,6 +227,13 @@ interface BarChartSeries<Datum> {
   label: string;
   data: readonly Datum[];
   color?: string;
+  /**
+   * Per-series Y accessor. Overrides the chart-level `y` for this series only —
+   * use it to plot two series from one shared `data` row against different fields
+   * (e.g. `y: (d) => d.requests` on one series, `y: (d) => d.errors` on another).
+   * Defaults to the chart-level `y`.
+   */
+  y?: (d: Datum) => number;
 }
 interface BarChartProps<Datum = {
   x: string;
@@ -234,6 +241,11 @@ interface BarChartProps<Datum = {
 }> {
   series: readonly BarChartSeries<Datum>[];
   x: (d: Datum) => string;
+  /**
+   * Y-value accessor, applied to **every** series' data unless a series provides
+   * its own `y`. There is one category (x) domain per chart, so `x` is chart-level
+   * only; to plot multiple fields from one row, give each series its own `y`.
+   */
   y: (d: Datum) => number;
   title: string;
   description?: string;
@@ -1124,6 +1136,13 @@ interface LineChartSeries<Datum> {
   color?: string;
   /** Which y-axis this series is measured against. Default 'left'. */
   axis?: 'left' | 'right';
+  /**
+   * Per-series Y accessor. Overrides the chart-level `y` for this series only —
+   * use it to plot two series from one shared `data` row against different fields
+   * (e.g. `y: (d) => d.requests` on one series, `y: (d) => d.errors` on another).
+   * Defaults to the chart-level `y`.
+   */
+  y?: (d: Datum) => number;
 }
 interface LineChartProps<Datum = {
   x: number;
@@ -1131,6 +1150,11 @@ interface LineChartProps<Datum = {
 }> {
   series: readonly LineChartSeries<Datum>[];
   x: (d: Datum) => number | Date;
+  /**
+   * Y-value accessor, applied to **every** series' data unless a series provides
+   * its own `y`. There is one x-domain per chart, so `x` is chart-level only; to
+   * plot multiple fields from one row, give each series its own `y`.
+   */
   y: (d: Datum) => number;
   title: string;
   description?: string;
@@ -1235,6 +1259,13 @@ interface AreaChartSeries<Datum> {
   color?: string;
   /** Which y-axis this series is measured against (ignored when `stacked`). Default 'left'. */
   axis?: 'left' | 'right';
+  /**
+   * Per-series Y accessor. Overrides the chart-level `y` for this series only —
+   * use it to plot two series from one shared `data` row against different fields
+   * (e.g. `y: (d) => d.requests` on one series, `y: (d) => d.errors` on another).
+   * Defaults to the chart-level `y`.
+   */
+  y?: (d: Datum) => number;
 }
 interface AreaChartProps<Datum = {
   x: number;
@@ -1242,6 +1273,11 @@ interface AreaChartProps<Datum = {
 }> {
   series: readonly AreaChartSeries<Datum>[];
   x: (d: Datum) => number;
+  /**
+   * Y-value accessor, applied to **every** series' data unless a series provides
+   * its own `y`. There is one x-domain per chart, so `x` is chart-level only; to
+   * plot multiple fields from one row, give each series its own `y`.
+   */
   y: (d: Datum) => number;
   title: string;
   description?: string;