@mui/x-charts 9.3.0 → 9.4.0

package/ScatterChart/ScatterPlot.js

@@ -17,6 +17,7 @@ var _useScatterSeries = require("../hooks/useScatterSeries");
 var _hooks = require("../hooks");
 var _useZAxis = require("../hooks/useZAxis");
 var _seriesConfig = require("./seriesConfig");
+var _getMarkerSize = _interopRequireDefault(require("./seriesConfig/getMarkerSize"));
 var _BatchScatter = require("./BatchScatter");
 var _scatterClasses = require("./scatterClasses");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -79,14 +80,17 @@ function ScatterPlot(props) {
         id,
         xAxisId,
         yAxisId,
+        colorAxisId,
         zAxisId,
+        sizeAxisId,
         color,
         hidden
       } = series[seriesId];
       if (hidden) {
         return null;
       }
-      const colorGetter = _seriesConfig.scatterSeriesConfig.colorProcessor(series[seriesId], xAxis[xAxisId ?? defaultXAxisId], yAxis[yAxisId ?? defaultYAxisId], zAxis[zAxisId ?? defaultZAxisId]);
+      const colorGetter = _seriesConfig.scatterSeriesConfig.colorProcessor(series[seriesId], xAxis[xAxisId ?? defaultXAxisId], yAxis[yAxisId ?? defaultYAxisId], zAxis[colorAxisId ?? zAxisId ?? defaultZAxisId]);
+      const sizeGetter = (0, _getMarkerSize.default)(series[seriesId], zAxis[sizeAxisId ?? defaultZAxisId]);
       const xScale = xAxis[xAxisId ?? defaultXAxisId].scale;
       const yScale = yAxis[yAxisId ?? defaultYAxisId].scale;
       return /*#__PURE__*/(0, _jsxRuntime.jsx)(ScatterItems, (0, _extends2.default)({
@@ -94,6 +98,7 @@ function ScatterPlot(props) {
         yScale: yScale,
         color: color,
         colorGetter: colorGetter,
+        sizeGetter: sizeGetter,
         series: series[seriesId],
         onItemClick: onItemClick,
         slots: slots,

package/ScatterChart/ScatterPlot.mjs

@@ -10,6 +10,7 @@ import { useScatterSeriesContext } from "../hooks/useScatterSeries.mjs";
 import { useXAxes, useYAxes } from "../hooks/index.mjs";
 import { useZAxes } from "../hooks/useZAxis.mjs";
 import { scatterSeriesConfig } from "./seriesConfig/index.mjs";
+import getMarkerSize from "./seriesConfig/getMarkerSize.mjs";
 import { BatchScatter } from "./BatchScatter.mjs";
 import { useUtilityClasses } from "./scatterClasses.mjs";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -72,14 +73,17 @@ function ScatterPlot(props) {
         id,
         xAxisId,
         yAxisId,
+        colorAxisId,
         zAxisId,
+        sizeAxisId,
         color,
         hidden
       } = series[seriesId];
       if (hidden) {
         return null;
       }
-      const colorGetter = scatterSeriesConfig.colorProcessor(series[seriesId], xAxis[xAxisId ?? defaultXAxisId], yAxis[yAxisId ?? defaultYAxisId], zAxis[zAxisId ?? defaultZAxisId]);
+      const colorGetter = scatterSeriesConfig.colorProcessor(series[seriesId], xAxis[xAxisId ?? defaultXAxisId], yAxis[yAxisId ?? defaultYAxisId], zAxis[colorAxisId ?? zAxisId ?? defaultZAxisId]);
+      const sizeGetter = getMarkerSize(series[seriesId], zAxis[sizeAxisId ?? defaultZAxisId]);
       const xScale = xAxis[xAxisId ?? defaultXAxisId].scale;
       const yScale = yAxis[yAxisId ?? defaultYAxisId].scale;
       return /*#__PURE__*/_jsx(ScatterItems, _extends({
@@ -87,6 +91,7 @@ function ScatterPlot(props) {
         yScale: yScale,
         color: color,
         colorGetter: colorGetter,
+        sizeGetter: sizeGetter,
         series: series[seriesId],
         onItemClick: onItemClick,
         slots: slots,

package/ScatterChart/seriesConfig/extremums.js

@@ -17,6 +17,9 @@ const getExtremumX = params => {
     if (!Object.hasOwn(series, seriesId)) {
       continue;
     }
+    if (axis.domainSeries === 'visible' && series[seriesId].hidden) {
+      continue;
+    }
     const axisId = series[seriesId].xAxisId;
     if (!(axisId === axis.id || axisId === undefined && isDefaultAxis)) {
       continue;
@@ -59,6 +62,9 @@ const getExtremumY = params => {
     if (!Object.hasOwn(series, seriesId)) {
       continue;
     }
+    if (axis.domainSeries === 'visible' && series[seriesId].hidden) {
+      continue;
+    }
     const axisId = series[seriesId].yAxisId;
     if (!(axisId === axis.id || axisId === undefined && isDefaultAxis)) {
       continue;

package/ScatterChart/seriesConfig/extremums.mjs

@@ -11,6 +11,9 @@ export const getExtremumX = params => {
     if (!Object.hasOwn(series, seriesId)) {
       continue;
     }
+    if (axis.domainSeries === 'visible' && series[seriesId].hidden) {
+      continue;
+    }
     const axisId = series[seriesId].xAxisId;
     if (!(axisId === axis.id || axisId === undefined && isDefaultAxis)) {
       continue;
@@ -52,6 +55,9 @@ export const getExtremumY = params => {
     if (!Object.hasOwn(series, seriesId)) {
       continue;
     }
+    if (axis.domainSeries === 'visible' && series[seriesId].hidden) {
+      continue;
+    }
     const axisId = series[seriesId].yAxisId;
     if (!(axisId === axis.id || axisId === undefined && isDefaultAxis)) {
       continue;

package/ScatterChart/seriesConfig/getColor.js

@@ -25,7 +25,7 @@ const getColor = (series, xAxis, yAxis, zAxis) => {
       const color = value === null ? getSeriesColor({
         value,
         dataIndex
-      }) : zColorScale(value.z);
+      }) : zColorScale(value.colorValue ?? value.z);
       if (color === null) {
         return getSeriesColor({
           value,

package/ScatterChart/seriesConfig/getColor.mjs

@@ -19,7 +19,7 @@ const getColor = (series, xAxis, yAxis, zAxis) => {
       const color = value === null ? getSeriesColor({
         value,
         dataIndex
-      }) : zColorScale(value.z);
+      }) : zColorScale(value.colorValue ?? value.z);
       if (color === null) {
         return getSeriesColor({
           value,

package/ScatterChart/seriesConfig/getMarkerSize.d.mts

@@ -0,0 +1,18 @@
+import { type DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.mjs";
+import { type ZAxisDefaultized } from "../../models/z-axis.mjs";
+/**
+ * Returns the marker size of a scatter item given its data index.
+ * @param {number} dataIndex The index of the scatter item.
+ * @returns {number} The marker size in pixels.
+ */
+export type ScatterSizeGetter = (dataIndex: number) => number;
+/**
+ * Builds a getter returning the marker size of each scatter item.
+ *
+ * When the size axis defines a `sizeMap`, the size is computed by mapping a value
+ * through the resulting `sizeScale`. The mapped value is taken from the size axis
+ * `data` when available, otherwise from the `sizeValue` of the scatter point.
+ * It falls back to the series `markerSize` when no size can be computed.
+ */
+declare const getMarkerSize: (series: DefaultizedScatterSeriesType, sizeZAxis?: ZAxisDefaultized) => ScatterSizeGetter;
+export default getMarkerSize;

package/ScatterChart/seriesConfig/getMarkerSize.d.ts

@@ -0,0 +1,18 @@
+import { type DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.js";
+import { type ZAxisDefaultized } from "../../models/z-axis.js";
+/**
+ * Returns the marker size of a scatter item given its data index.
+ * @param {number} dataIndex The index of the scatter item.
+ * @returns {number} The marker size in pixels.
+ */
+export type ScatterSizeGetter = (dataIndex: number) => number;
+/**
+ * Builds a getter returning the marker size of each scatter item.
+ *
+ * When the size axis defines a `sizeMap`, the size is computed by mapping a value
+ * through the resulting `sizeScale`. The mapped value is taken from the size axis
+ * `data` when available, otherwise from the `sizeValue` of the scatter point.
+ * It falls back to the series `markerSize` when no size can be computed.
+ */
+declare const getMarkerSize: (series: DefaultizedScatterSeriesType, sizeZAxis?: ZAxisDefaultized) => ScatterSizeGetter;
+export default getMarkerSize;

package/ScatterChart/seriesConfig/getMarkerSize.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+/**
+ * Returns the marker size of a scatter item given its data index.
+ * @param {number} dataIndex The index of the scatter item.
+ * @returns {number} The marker size in pixels.
+ */
+
+/**
+ * Builds a getter returning the marker size of each scatter item.
+ *
+ * When the size axis defines a `sizeMap`, the size is computed by mapping a value
+ * through the resulting `sizeScale`. The mapped value is taken from the size axis
+ * `data` when available, otherwise from the `sizeValue` of the scatter point.
+ * It falls back to the series `markerSize` when no size can be computed.
+ */
+const getMarkerSize = (series, sizeZAxis) => {
+  const sizeScale = sizeZAxis?.sizeScale;
+  if (!sizeScale) {
+    return () => series.markerSize;
+  }
+  return dataIndex => {
+    if (sizeZAxis?.data?.[dataIndex] !== undefined) {
+      const size = sizeScale(sizeZAxis.data[dataIndex]);
+      if (size != null && !Number.isNaN(size)) {
+        return size;
+      }
+    }
+    const value = series.data[dataIndex];
+    if (value != null) {
+      const size = sizeScale(value.sizeValue);
+      if (size != null && !Number.isNaN(size)) {
+        return size;
+      }
+    }
+    return series.markerSize;
+  };
+};
+var _default = exports.default = getMarkerSize;

package/ScatterChart/seriesConfig/getMarkerSize.mjs

@@ -0,0 +1,37 @@
+/**
+ * Returns the marker size of a scatter item given its data index.
+ * @param {number} dataIndex The index of the scatter item.
+ * @returns {number} The marker size in pixels.
+ */
+
+/**
+ * Builds a getter returning the marker size of each scatter item.
+ *
+ * When the size axis defines a `sizeMap`, the size is computed by mapping a value
+ * through the resulting `sizeScale`. The mapped value is taken from the size axis
+ * `data` when available, otherwise from the `sizeValue` of the scatter point.
+ * It falls back to the series `markerSize` when no size can be computed.
+ */
+const getMarkerSize = (series, sizeZAxis) => {
+  const sizeScale = sizeZAxis?.sizeScale;
+  if (!sizeScale) {
+    return () => series.markerSize;
+  }
+  return dataIndex => {
+    if (sizeZAxis?.data?.[dataIndex] !== undefined) {
+      const size = sizeScale(sizeZAxis.data[dataIndex]);
+      if (size != null && !Number.isNaN(size)) {
+        return size;
+      }
+    }
+    const value = series.data[dataIndex];
+    if (value != null) {
+      const size = sizeScale(value.sizeValue);
+      if (size != null && !Number.isNaN(size)) {
+        return size;
+      }
+    }
+    return series.markerSize;
+  };
+};
+export default getMarkerSize;

package/ScatterChart/seriesConfig/seriesProcessor.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
+var _incompleteDatasetKeysError = require("../../internals/incompleteDatasetKeysError");
 const seriesProcessor = ({
   series,
   seriesOrder
@@ -15,18 +15,33 @@ const seriesProcessor = ({
     const datasetKeys = seriesData?.datasetKeys;
     const missingKeys = ['x', 'y'].filter(key => typeof datasetKeys?.[key] !== 'string');
     if (seriesData?.datasetKeys && missingKeys.length > 0) {
-      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: Scatter series with id="${seriesId}" has incomplete datasetKeys. ` + `Properties ${missingKeys.map(key => `"${key}"`).join(', ')} are missing. ` + 'Scatter plots require both "x" and "y" keys to map dataset values to coordinates. ' + 'Add the missing datasetKeys to the series configuration.' : (0, _formatErrorMessage2.default)(29, seriesId, missingKeys.map(key => `"${key}"`).join(', ')));
+      (0, _incompleteDatasetKeysError.incompleteDatasetKeysError)('Scatter', seriesId, missingKeys);
     }
     let data;
     if (seriesData.valueGetter) {
       data = dataset?.map(seriesData.valueGetter) ?? [];
     } else if (datasetKeys) {
-      data = dataset?.map(d => ({
-        x: d[datasetKeys.x] ?? null,
-        y: d[datasetKeys.y] ?? null,
-        z: datasetKeys.z && d[datasetKeys.z],
-        id: datasetKeys.id && d[datasetKeys.id]
-      })) ?? [];
+      data = dataset?.map(d => {
+        const x = d[datasetKeys.x];
+        const y = d[datasetKeys.y];
+        const rep = {
+          x,
+          y
+        };
+        if (datasetKeys.colorValue !== undefined) {
+          rep.colorValue = d[datasetKeys.colorValue];
+        }
+        if (datasetKeys.sizeValue !== undefined) {
+          rep.sizeValue = d[datasetKeys.sizeValue];
+        }
+        if (datasetKeys.z !== undefined) {
+          rep.z = d[datasetKeys.z];
+        }
+        if (datasetKeys.id !== undefined) {
+          rep.id = d[datasetKeys.id];
+        }
+        return rep;
+      }) ?? [];
     } else {
       data = seriesData.data ?? [];
     }

package/ScatterChart/seriesConfig/seriesProcessor.mjs

@@ -1,5 +1,5 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
-import _formatErrorMessage from "@mui/x-internals/formatErrorMessage";
+import { incompleteDatasetKeysError } from "../../internals/incompleteDatasetKeysError.mjs";
 const seriesProcessor = ({
   series,
   seriesOrder
@@ -8,18 +8,33 @@ const seriesProcessor = ({
     const datasetKeys = seriesData?.datasetKeys;
     const missingKeys = ['x', 'y'].filter(key => typeof datasetKeys?.[key] !== 'string');
     if (seriesData?.datasetKeys && missingKeys.length > 0) {
-      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: Scatter series with id="${seriesId}" has incomplete datasetKeys. ` + `Properties ${missingKeys.map(key => `"${key}"`).join(', ')} are missing. ` + 'Scatter plots require both "x" and "y" keys to map dataset values to coordinates. ' + 'Add the missing datasetKeys to the series configuration.' : _formatErrorMessage(29, seriesId, missingKeys.map(key => `"${key}"`).join(', ')));
+      incompleteDatasetKeysError('Scatter', seriesId, missingKeys);
     }
     let data;
     if (seriesData.valueGetter) {
       data = dataset?.map(seriesData.valueGetter) ?? [];
     } else if (datasetKeys) {
-      data = dataset?.map(d => ({
-        x: d[datasetKeys.x] ?? null,
-        y: d[datasetKeys.y] ?? null,
-        z: datasetKeys.z && d[datasetKeys.z],
-        id: datasetKeys.id && d[datasetKeys.id]
-      })) ?? [];
+      data = dataset?.map(d => {
+        const x = d[datasetKeys.x];
+        const y = d[datasetKeys.y];
+        const rep = {
+          x,
+          y
+        };
+        if (datasetKeys.colorValue !== undefined) {
+          rep.colorValue = d[datasetKeys.colorValue];
+        }
+        if (datasetKeys.sizeValue !== undefined) {
+          rep.sizeValue = d[datasetKeys.sizeValue];
+        }
+        if (datasetKeys.z !== undefined) {
+          rep.z = d[datasetKeys.z];
+        }
+        if (datasetKeys.id !== undefined) {
+          rep.id = d[datasetKeys.id];
+        }
+        return rep;
+      }) ?? [];
     } else {
       data = seriesData.data ?? [];
     }

package/ScatterChart/useScatterItemPosition.d.mts

@@ -2,6 +2,10 @@ import { type DefaultizedScatterSeriesType, type ScatterItemIdentifier, type Sca
 export interface ResolvedScatterItem {
   cx: number;
   cy: number;
+  /**
+   * The resolved marker size of the scatter point, accounting for any size axis.
+   */
+  markerSize: number;
   series: DefaultizedScatterSeriesType;
   scatterPoint: ScatterValueType;
 }

package/ScatterChart/useScatterItemPosition.d.ts

@@ -2,6 +2,10 @@ import { type DefaultizedScatterSeriesType, type ScatterItemIdentifier, type Sca
 export interface ResolvedScatterItem {
   cx: number;
   cy: number;
+  /**
+   * The resolved marker size of the scatter point, accounting for any size axis.
+   */
+  markerSize: number;
   series: DefaultizedScatterSeriesType;
   scatterPoint: ScatterValueType;
 }

package/ScatterChart/useScatterItemPosition.js

@@ -1,10 +1,13 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useScatterItemPosition = useScatterItemPosition;
 var _hooks = require("../hooks");
+var _useZAxis = require("../hooks/useZAxis");
+var _getMarkerSize = _interopRequireDefault(require("./seriesConfig/getMarkerSize"));
 /**
  * Resolves a scatter item identifier to its on-screen position and the owning
  * series. Shared by `FocusedScatterMark`, `HighlightedScatterMark`, and other
@@ -23,6 +26,10 @@ function useScatterItemPosition(item) {
     yAxis,
     yAxisIds
   } = (0, _hooks.useYAxes)();
+  const {
+    zAxis,
+    zAxisIds
+  } = (0, _useZAxis.useZAxes)();
   if (!item || !scatterSeries) {
     return null;
   }
@@ -38,9 +45,11 @@ function useScatterItemPosition(item) {
   const yAxisId = series.yAxisId ?? yAxisIds[0];
   const cx = (0, _hooks.getValueToPositionMapper)(xAxis[xAxisId].scale)(scatterPoint.x);
   const cy = (0, _hooks.getValueToPositionMapper)(yAxis[yAxisId].scale)(scatterPoint.y);
+  const markerSize = (0, _getMarkerSize.default)(series, zAxis[series.sizeAxisId ?? zAxisIds[0]])(item.dataIndex);
   return {
     cx,
     cy,
+    markerSize,
     series,
     scatterPoint
   };

package/ScatterChart/useScatterItemPosition.mjs

@@ -1,4 +1,6 @@
 import { getValueToPositionMapper, useScatterSeriesContext, useXAxes, useYAxes } from "../hooks/index.mjs";
+import { useZAxes } from "../hooks/useZAxis.mjs";
+import getMarkerSize from "./seriesConfig/getMarkerSize.mjs";
 /**
  * Resolves a scatter item identifier to its on-screen position and the owning
  * series. Shared by `FocusedScatterMark`, `HighlightedScatterMark`, and other
@@ -17,6 +19,10 @@ export function useScatterItemPosition(item) {
     yAxis,
     yAxisIds
   } = useYAxes();
+  const {
+    zAxis,
+    zAxisIds
+  } = useZAxes();
   if (!item || !scatterSeries) {
     return null;
   }
@@ -32,9 +38,11 @@ export function useScatterItemPosition(item) {
   const yAxisId = series.yAxisId ?? yAxisIds[0];
   const cx = getValueToPositionMapper(xAxis[xAxisId].scale)(scatterPoint.x);
   const cy = getValueToPositionMapper(yAxis[yAxisId].scale)(scatterPoint.y);
+  const markerSize = getMarkerSize(series, zAxis[series.sizeAxisId ?? zAxisIds[0]])(item.dataIndex);
   return {
     cx,
     cy,
+    markerSize,
     series,
     scatterPoint
   };

package/Toolbar/Toolbar.types.d.mts

@@ -1,15 +1,16 @@
 import type * as React from 'react';
+import type { ToolbarPropsOverrides } from "../models/chartsSlotsComponentsProps.mjs";
 export interface ChartsToolbarProps {}
 export interface ChartsToolbarSlots {
   /**
    * Custom component for the toolbar.
    * @default ChartsToolbar
    */
-  toolbar?: React.ElementType<ChartsToolbarProps>;
+  toolbar?: React.ElementType<ChartsToolbarProps & ToolbarPropsOverrides>;
 }
 export interface ChartsToolbarSlotProps {
   /**
    * Props for the toolbar component.
    */
-  toolbar?: Partial<ChartsToolbarProps>;
+  toolbar?: Partial<ChartsToolbarProps> & ToolbarPropsOverrides;
 }

package/Toolbar/Toolbar.types.d.ts

@@ -1,15 +1,16 @@
 import type * as React from 'react';
+import type { ToolbarPropsOverrides } from "../models/chartsSlotsComponentsProps.js";
 export interface ChartsToolbarProps {}
 export interface ChartsToolbarSlots {
   /**
    * Custom component for the toolbar.
    * @default ChartsToolbar
    */
-  toolbar?: React.ElementType<ChartsToolbarProps>;
+  toolbar?: React.ElementType<ChartsToolbarProps & ToolbarPropsOverrides>;
 }
 export interface ChartsToolbarSlotProps {
   /**
    * Props for the toolbar component.
    */
-  toolbar?: Partial<ChartsToolbarProps>;
+  toolbar?: Partial<ChartsToolbarProps> & ToolbarPropsOverrides;
 }

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v9.3.0
+ * @mui/x-charts v9.4.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v9.3.0
+ * @mui/x-charts v9.4.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/animation/animation.d.mts

@@ -1,4 +1,3 @@
-import BezierEasing from 'bezier-easing';
 export declare const ANIMATION_DURATION_MS = 300;
 export declare const ANIMATION_TIMING_FUNCTION = "cubic-bezier(0.66, 0, 0.34, 1)";
-export declare const ANIMATION_TIMING_FUNCTION_JS: BezierEasing.EasingFunction;
+export declare const ANIMATION_TIMING_FUNCTION_JS: import("bezier-easing").EasingFunction;

package/internals/animation/animation.d.ts

@@ -1,4 +1,3 @@
-import BezierEasing from 'bezier-easing';
 export declare const ANIMATION_DURATION_MS = 300;
 export declare const ANIMATION_TIMING_FUNCTION = "cubic-bezier(0.66, 0, 0.34, 1)";
-export declare const ANIMATION_TIMING_FUNCTION_JS: BezierEasing.EasingFunction;
+export declare const ANIMATION_TIMING_FUNCTION_JS: import("bezier-easing").EasingFunction;

package/internals/commonNextFocusItem.d.mts

@@ -16,7 +16,11 @@ compatibleSeriesTypes: Set<OutSeriesType>,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
+allowCycles?: boolean,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
 export declare function createGetPreviousIndexFocusedItem<InSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>, OutSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'> = InSeriesType>(
 /**
  * The set of series types compatible with this navigation action.
@@ -25,7 +29,11 @@ compatibleSeriesTypes: Set<OutSeriesType>,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
+allowCycles?: boolean,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
 export declare function createGetNextSeriesFocusedItem<InSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>, OutSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'> = InSeriesType>(
 /**
  * The set of series types compatible with this navigation action.

package/internals/commonNextFocusItem.d.ts

@@ -16,7 +16,11 @@ compatibleSeriesTypes: Set<OutSeriesType>,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
+allowCycles?: boolean,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
 export declare function createGetPreviousIndexFocusedItem<InSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>, OutSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'> = InSeriesType>(
 /**
  * The set of series types compatible with this navigation action.
@@ -25,7 +29,11 @@ compatibleSeriesTypes: Set<OutSeriesType>,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
+allowCycles?: boolean,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength?: boolean): (currentItem: FocusedItemIdentifier<InSeriesType> | null, state: StateParameters<InSeriesType>) => ReturnedItem<OutSeriesType>;
 export declare function createGetNextSeriesFocusedItem<InSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>, OutSeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'> = InSeriesType>(
 /**
  * The set of series types compatible with this navigation action.

package/internals/commonNextFocusItem.js

@@ -25,7 +25,11 @@ compatibleSeriesTypes,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles = false) {
+allowCycles = false,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength = false) {
   return function getNextIndexFocusedItem(currentItem, state) {
     const processedSeries = (0, _useChartSeries.selectorChartSeriesProcessed)(state);
     let seriesId = currentItem?.seriesId;
@@ -38,7 +42,7 @@ allowCycles = false) {
       type = nextSeries.type;
       seriesId = nextSeries.seriesId;
     }
-    const maxLength = (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
+    const maxLength = useCurrentSeriesMaxLength ? processedSeries[type]?.series[seriesId]?.data.length ?? 0 : (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
     let dataIndex = currentItem?.dataIndex == null ? 0 : currentItem.dataIndex + 1;
     if (allowCycles) {
       dataIndex = dataIndex % maxLength;
@@ -72,7 +76,11 @@ compatibleSeriesTypes,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles = false) {
+allowCycles = false,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength = false) {
   return function getPreviousIndexFocusedItem(currentItem, state) {
     const processedSeries = (0, _useChartSeries.selectorChartSeriesProcessed)(state);
     let seriesId = currentItem?.seriesId;
@@ -85,7 +93,7 @@ allowCycles = false) {
       type = previousSeries.type;
       seriesId = previousSeries.seriesId;
     }
-    const maxLength = (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
+    const maxLength = useCurrentSeriesMaxLength ? processedSeries[type]?.series[seriesId]?.data.length ?? 0 : (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
     let dataIndex = currentItem?.dataIndex == null ? maxLength - 1 : currentItem.dataIndex - 1;
     if (allowCycles) {
       dataIndex = (maxLength + dataIndex) % maxLength;

package/internals/commonNextFocusItem.mjs

@@ -16,7 +16,11 @@ compatibleSeriesTypes,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles = false) {
+allowCycles = false,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength = false) {
   return function getNextIndexFocusedItem(currentItem, state) {
     const processedSeries = selectorChartSeriesProcessed(state);
     let seriesId = currentItem?.seriesId;
@@ -29,7 +33,7 @@ allowCycles = false) {
       type = nextSeries.type;
       seriesId = nextSeries.seriesId;
     }
-    const maxLength = getMaxSeriesLength(processedSeries, compatibleSeriesTypes);
+    const maxLength = useCurrentSeriesMaxLength ? processedSeries[type]?.series[seriesId]?.data.length ?? 0 : getMaxSeriesLength(processedSeries, compatibleSeriesTypes);
     let dataIndex = currentItem?.dataIndex == null ? 0 : currentItem.dataIndex + 1;
     if (allowCycles) {
       dataIndex = dataIndex % maxLength;
@@ -63,7 +67,11 @@ compatibleSeriesTypes,
 /**
  * If true, allows cycling from the last item to the first one.
  */
-allowCycles = false) {
+allowCycles = false,
+/**
+ * If true, series max index is defined by the current series length and not all series.
+ */
+useCurrentSeriesMaxLength = false) {
   return function getPreviousIndexFocusedItem(currentItem, state) {
     const processedSeries = selectorChartSeriesProcessed(state);
     let seriesId = currentItem?.seriesId;
@@ -76,7 +84,7 @@ allowCycles = false) {
       type = previousSeries.type;
       seriesId = previousSeries.seriesId;
     }
-    const maxLength = getMaxSeriesLength(processedSeries, compatibleSeriesTypes);
+    const maxLength = useCurrentSeriesMaxLength ? processedSeries[type]?.series[seriesId]?.data.length ?? 0 : getMaxSeriesLength(processedSeries, compatibleSeriesTypes);
     let dataIndex = currentItem?.dataIndex == null ? maxLength - 1 : currentItem.dataIndex - 1;
     if (allowCycles) {
       dataIndex = (maxLength + dataIndex) % maxLength;