@mui/x-charts 7.19.0 → 7.21.0

package/context/AnimationProvider/useSkipAnimation.js

@@ -0,0 +1,20 @@
+'use client';
+
+import * as React from 'react';
+import { AnimationContext } from "./AnimationContext.js";
+
+/**
+ * A hook to get if chart animations should be skipped.
+ *
+ * @returns {boolean|undefined} whether to skip animations
+ */
+export function useSkipAnimation(skipAnimation) {
+  const {
+    isInitialized,
+    data
+  } = React.useContext(AnimationContext);
+  if (!isInitialized) {
+    throw new Error(['MUI X: Could not find the animation ref context.', 'It looks like you rendered your component outside of a ChartsContainer parent component.'].join('\n'));
+  }
+  return skipAnimation || data.skipAnimation;
+}

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v7.19.0
+ * @mui/x-charts v7.21.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/defaultizeColor.d.ts

@@ -62,12 +62,18 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     stackOrder?: import("..").StackOrderType;
 } | {
     type: "scatter";
-    data: import("..").ScatterValueType[];
+    data?: import("..").ScatterValueType[];
     markerSize?: number;
     label?: string | ((location: "tooltip" | "legend") => string);
     disableHover?: boolean;
     zAxisKey?: string;
     zAxisId?: string;
+    datasetKeys?: {
+        x: string;
+        y: string;
+        z?: string;
+        id: string;
+    };
     id?: import(".").SeriesId;
     color: string;
     valueFormatter?: import(".").SeriesValueFormatter<import("..").ScatterValueType> | undefined;

package/internals/index.d.ts

@@ -1,7 +1,6 @@
 export * from './components/ChartsAxesGradients';
 export * from '../ResponsiveChartContainer/useChartContainerDimensions';
 export * from '../ResponsiveChartContainer/ResizableContainer';
-export { useReducedMotion } from '../hooks/useReducedMotion';
 export { useSeries } from '../hooks/useSeries';
 export { useInteractionItemProps } from '../hooks/useInteractionItemProps';
 export { useDrawingArea } from '../hooks/useDrawingArea';
@@ -24,6 +23,7 @@ export * from '../context/InteractionProvider';
 export * from '../context/SeriesProvider';
 export * from '../context/ZAxisContextProvider';
 export * from '../context/PluginProvider';
+export * from '../context/AnimationProvider';
 export type * from '../context/context.types';
 export { getAxisExtremum } from '../context/CartesianProvider/getAxisExtremum';
 export * from '../models/seriesType/config';

package/internals/index.js

@@ -4,7 +4,6 @@ export * from "../ResponsiveChartContainer/useChartContainerDimensions.js";
 export * from "../ResponsiveChartContainer/ResizableContainer.js";
 
 // hooks
-export { useReducedMotion } from "../hooks/useReducedMotion.js";
 export { useSeries } from "../hooks/useSeries.js";
 export { useInteractionItemProps } from "../hooks/useInteractionItemProps.js";
 export { useDrawingArea } from "../hooks/useDrawingArea.js";
@@ -32,6 +31,7 @@ export * from "../context/InteractionProvider.js";
 export * from "../context/SeriesProvider/index.js";
 export * from "../context/ZAxisContextProvider.js";
 export * from "../context/PluginProvider/index.js";
+export * from "../context/AnimationProvider/index.js";
 export { getAxisExtremum } from "../context/CartesianProvider/getAxisExtremum.js";
 
 // series configuration

package/models/seriesType/scatter.d.ts

@@ -11,7 +11,7 @@ export type ScatterValueType = {
 };
 export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType>, CartesianSeriesType {
     type: 'scatter';
-    data: ScatterValueType[];
+    data?: ScatterValueType[];
     markerSize?: number;
     /**
      * The label to display on the tooltip or the legend. It can be a string or a function.
@@ -31,6 +31,30 @@ export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType>, C
      * The id of the z-axis used to render the series.
      */
     zAxisId?: string;
+    /**
+     * The keys used to retrieve data from the dataset.
+     *
+     * When this prop is provided, all of `x`, `y`, and `id` must be provided.
+     * While `z` is optional.
+     */
+    datasetKeys?: {
+        /**
+         * The key used to retrieve data from the dataset for the X axis.
+         */
+        x: string;
+        /**
+         * The key used to retrieve data from the dataset for the Y axis.
+         */
+        y: string;
+        /**
+         * The key used to retrieve data from the dataset for the Z axis.
+         */
+        z?: string;
+        /**
+         * The key used to retrieve data from the dataset for the id.
+         */
+        id: string;
+    };
 }
 /**
  * An object that allows to identify a single scatter item.

package/modern/BarChart/BarChart.js

@@ -63,7 +63,7 @@ process.env.NODE_ENV !== "production" ? BarChart.propTypes = {
    * The configuration of axes highlight.
    * Default is set to 'band' in the bar direction.
    * Depends on `layout` prop.
-   * @see See {@link https://mui.com/x/react-charts/tooltip/#highlights highlight docs} for more details.
+   * @see See {@link https://mui.com/x/react-charts/highlighting highlighting docs} for more details.
    */
   axisHighlight: PropTypes.shape({
     x: PropTypes.oneOf(['band', 'line', 'none']),
@@ -219,7 +219,7 @@ process.env.NODE_ENV !== "production" ? BarChart.propTypes = {
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
   /**
    * If `true`, animations are skipped.
-   * @default false
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
    */
   skipAnimation: PropTypes.bool,
   /**

package/modern/BarChart/BarPlot.js

@@ -14,7 +14,8 @@ import { BarClipPath } from "./BarClipPath.js";
 import { BarLabelPlot } from "./BarLabel/BarLabelPlot.js";
 import { checkScaleErrors } from "./checkScaleErrors.js";
 import { useBarSeries } from "../hooks/useSeries.js";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSkipAnimation } from "../context/AnimationProvider/index.js";
+
 /**
  * Solution of the equations
  * W = barWidth * N + offset * (N-1)
@@ -24,6 +25,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * @param gapRatio The ratio of the gap between bars over the bar width.
  * @returns The bar width and the offset between bars.
  */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 function getBandSize({
   bandWidth: W,
   numberOfGroups: N,
@@ -187,12 +189,13 @@ function BarPlot(props) {
     masksData
   } = useAggregatedData();
   const {
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick,
       borderRadius,
       barLabel
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
+  const skipAnimation = useSkipAnimation(inSkipAnimation);
   const withoutBorderRadius = !borderRadius || borderRadius <= 0;
   const transition = useTransition(completedData, {
     keys: bar => `${bar.seriesId}-${bar.dataIndex}`,
@@ -284,7 +287,7 @@ process.env.NODE_ENV !== "production" ? BarPlot.propTypes = {
   onItemClick: PropTypes.func,
   /**
    * If `true`, animations are skipped.
-   * @default false
+   * @default undefined
    */
   skipAnimation: PropTypes.bool,
   /**

package/modern/BarChart/useBarChartProps.js

@@ -76,13 +76,13 @@ export const useBarChartProps = props => {
     highlightedItem,
     onHighlightChange,
     disableAxisListener: tooltip?.trigger !== 'axis' && axisHighlight?.x === 'none' && axisHighlight?.y === 'none' && !onAxisClick,
-    className
+    className,
+    skipAnimation
   });
   const barPlotProps = {
     onItemClick,
     slots,
     slotProps,
-    skipAnimation,
     borderRadius,
     barLabel
   };

package/modern/ChartContainer/ChartContainer.js

@@ -12,6 +12,7 @@ import { ChartsAxesGradients } from "../internals/components/ChartsAxesGradients
 import { HighlightedProvider, ZAxisContextProvider } from "../context/index.js";
 import { PluginProvider } from "../context/PluginProvider/index.js";
 import { useChartContainerProps } from "./useChartContainerProps.js";
+import { AnimationProvider } from "../context/AnimationProvider/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(props, ref) {
   const {
@@ -22,7 +23,8 @@ const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(pro
     zAxisContextProps,
     highlightedProviderProps,
     chartsSurfaceProps,
-    pluginProviderProps
+    pluginProviderProps,
+    animationProviderProps
   } = useChartContainerProps(props, ref);
   return /*#__PURE__*/_jsx(DrawingProvider, _extends({}, drawingProviderProps, {
     children: /*#__PURE__*/_jsx(PluginProvider, _extends({}, pluginProviderProps, {
@@ -32,7 +34,9 @@ const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(pro
             children: /*#__PURE__*/_jsx(InteractionProvider, {
               children: /*#__PURE__*/_jsx(HighlightedProvider, _extends({}, highlightedProviderProps, {
                 children: /*#__PURE__*/_jsxs(ChartsSurface, _extends({}, chartsSurfaceProps, {
-                  children: [/*#__PURE__*/_jsx(ChartsAxesGradients, {}), children]
+                  children: [/*#__PURE__*/_jsx(ChartsAxesGradients, {}), /*#__PURE__*/_jsx(AnimationProvider, _extends({}, animationProviderProps, {
+                    children: children
+                  }))]
                 }))
               }))
             })
@@ -105,6 +109,11 @@ process.env.NODE_ENV !== "production" ? ChartContainer.propTypes = {
    * Please refer to the appropriate docs page to learn more about it.
    */
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: PropTypes.bool,
   sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
   title: PropTypes.string,
   viewBox: PropTypes.shape({

package/modern/ChartContainer/useChartContainerProps.js

@@ -2,11 +2,10 @@
 
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["width", "height", "series", "margin", "xAxis", "yAxis", "zAxis", "colors", "dataset", "sx", "title", "desc", "disableAxisListener", "highlightedItem", "onHighlightChange", "plugins", "children"];
+const _excluded = ["width", "height", "series", "margin", "xAxis", "yAxis", "zAxis", "colors", "dataset", "sx", "title", "desc", "disableAxisListener", "highlightedItem", "onHighlightChange", "plugins", "children", "skipAnimation"];
 import * as React from 'react';
 import useForkRef from '@mui/utils/useForkRef';
 import { useDefaultizeAxis } from "./useDefaultizeAxis.js";
-import { useReducedMotion } from "../hooks/useReducedMotion.js";
 export const useChartContainerProps = (props, ref) => {
   const {
       width,
@@ -25,13 +24,12 @@ export const useChartContainerProps = (props, ref) => {
       highlightedItem,
       onHighlightChange,
       plugins,
-      children
+      children,
+      skipAnimation
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const svgRef = React.useRef(null);
   const chartSurfaceRef = useForkRef(ref, svgRef);
-  useReducedMotion(); // a11y reduce motion (see: https://react-spring.dev/docs/utilities/use-reduced-motion)
-
   const [defaultizedXAxis, defaultizedYAxis] = useDefaultizeAxis(xAxis, yAxis, dataset);
   const drawingProviderProps = {
     width,
@@ -39,6 +37,9 @@ export const useChartContainerProps = (props, ref) => {
     margin,
     svgRef
   };
+  const animationProviderProps = {
+    skipAnimation
+  };
   const pluginProviderProps = {
     plugins
   };
@@ -78,6 +79,7 @@ export const useChartContainerProps = (props, ref) => {
     highlightedProviderProps,
     chartsSurfaceProps,
     pluginProviderProps,
+    animationProviderProps,
     xAxis: defaultizedXAxis,
     yAxis: defaultizedYAxis
   };

package/modern/LineChart/AreaPlot.js

@@ -13,6 +13,7 @@ import getCurveFactory from "../internals/getCurve.js";
 import { DEFAULT_X_AXIS_KEY } from "../constants/index.js";
 import { useChartGradient } from "../internals/components/ChartsAxesGradients/index.js";
 import { useLineSeries } from "../hooks/useSeries.js";
+import { useSkipAnimation } from "../context/AnimationProvider/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const useAggregatedData = () => {
   const seriesData = useLineSeries();
@@ -114,9 +115,10 @@ function AreaPlot(props) {
       slots,
       slotProps,
       onItemClick,
-      skipAnimation
+      skipAnimation: inSkipAnimation
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
+  const skipAnimation = useSkipAnimation(inSkipAnimation);
   const getGradientId = useChartGradient();
   const completedData = useAggregatedData();
   return /*#__PURE__*/_jsx("g", _extends({}, other, {

package/modern/LineChart/LineChart.js

@@ -69,7 +69,7 @@ process.env.NODE_ENV !== "production" ? LineChart.propTypes = {
   // ----------------------------------------------------------------------
   /**
    * The configuration of axes highlight.
-   * @see See {@link https://mui.com/x/react-charts/tooltip/#highlights highlight docs} for more details.
+   * @see See {@link https://mui.com/x/react-charts/highlighting highlighting docs} for more details.
    * @default { x: 'line' }
    */
   axisHighlight: PropTypes.shape({

package/modern/LineChart/LinePlot.js

@@ -13,6 +13,7 @@ import getCurveFactory from "../internals/getCurve.js";
 import { DEFAULT_X_AXIS_KEY } from "../constants/index.js";
 import { useChartGradient } from "../internals/components/ChartsAxesGradients/index.js";
 import { useLineSeries } from "../hooks/useSeries.js";
+import { useSkipAnimation } from "../context/AnimationProvider/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const useAggregatedData = () => {
   const seriesData = useLineSeries();
@@ -94,10 +95,11 @@ function LinePlot(props) {
   const {
       slots,
       slotProps,
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
+  const skipAnimation = useSkipAnimation(inSkipAnimation);
   const getGradientId = useChartGradient();
   const completedData = useAggregatedData();
   return /*#__PURE__*/_jsx("g", _extends({}, other, {

package/modern/LineChart/MarkPlot.js

@@ -3,18 +3,19 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 const _excluded = ["slots", "slotProps", "skipAnimation", "onItemClick", "experimentalRendering"];
-import * as React from 'react';
 import PropTypes from 'prop-types';
+import * as React from 'react';
+import { DEFAULT_X_AXIS_KEY } from "../constants/index.js";
+import { useSkipAnimation } from "../context/AnimationProvider/index.js";
 import { useCartesianContext } from "../context/CartesianProvider/index.js";
-import { MarkElement } from "./MarkElement.js";
-import { getValueToPositionMapper } from "../hooks/useScale.js";
 import { useChartId } from "../hooks/useChartId.js";
-import { DEFAULT_X_AXIS_KEY } from "../constants/index.js";
-import { cleanId } from "../internals/cleanId.js";
-import getColor from "./getColor.js";
-import { useLineSeries } from "../hooks/useSeries.js";
 import { useDrawingArea } from "../hooks/useDrawingArea.js";
+import { getValueToPositionMapper } from "../hooks/useScale.js";
+import { useLineSeries } from "../hooks/useSeries.js";
+import { cleanId } from "../internals/cleanId.js";
 import { CircleMarkElement } from "./CircleMarkElement.js";
+import getColor from "./getColor.js";
+import { MarkElement } from "./MarkElement.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Demos:
@@ -30,11 +31,12 @@ function MarkPlot(props) {
   const {
       slots,
       slotProps,
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick,
       experimentalRendering
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
+  const skipAnimation = useSkipAnimation(inSkipAnimation);
   const seriesData = useLineSeries();
   const axisData = useCartesianContext();
   const chartId = useChartId();

package/modern/LineChart/useLineChartProps.js

@@ -71,7 +71,8 @@ export const useLineChartProps = props => {
     highlightedItem,
     onHighlightChange,
     disableAxisListener: tooltip?.trigger !== 'axis' && axisHighlight?.x === 'none' && axisHighlight?.y === 'none' && !onAxisClick,
-    className
+    className,
+    skipAnimation
   });
   const axisClickHandlerProps = {
     onAxisClick
@@ -89,14 +90,12 @@ export const useLineChartProps = props => {
   const areaPlotProps = {
     slots,
     slotProps,
-    onItemClick: onAreaClick,
-    skipAnimation
+    onItemClick: onAreaClick
   };
   const linePlotProps = {
     slots,
     slotProps,
-    onItemClick: onLineClick,
-    skipAnimation
+    onItemClick: onLineClick
   };
   const markPlotProps = {
     slots,

package/modern/PieChart/PieChart.js

@@ -105,6 +105,7 @@ const PieChart = /*#__PURE__*/React.forwardRef(function PieChart(inProps, ref) {
     highlightedItem: highlightedItem,
     onHighlightChange: onHighlightChange,
     className: className,
+    skipAnimation: skipAnimation,
     children: [/*#__PURE__*/_jsx(ChartsAxis, {
       topAxis: topAxis,
       leftAxis: leftAxis,
@@ -115,8 +116,7 @@ const PieChart = /*#__PURE__*/React.forwardRef(function PieChart(inProps, ref) {
     }), /*#__PURE__*/_jsx(PiePlot, {
       slots: slots,
       slotProps: slotProps,
-      onItemClick: onItemClick,
-      skipAnimation: skipAnimation
+      onItemClick: onItemClick
     }), /*#__PURE__*/_jsx(ChartsOverlay, {
       loading: loading,
       slots: slots,
@@ -137,7 +137,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
   // ----------------------------------------------------------------------
   /**
    * The configuration of axes highlight.
-   * @see See {@link https://mui.com/x/react-charts/tooltip/#highlights highlight docs} for more details.
+   * @see See {@link https://mui.com/x/react-charts/highlighting highlighting docs} for more details.
    * @default { x: 'none', y: 'none' }
    */
   axisHighlight: PropTypes.shape({
@@ -263,7 +263,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
   /**
    * If `true`, animations are skipped.
-   * @default false
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
    */
   skipAnimation: PropTypes.bool,
   /**

package/modern/PieChart/PiePlot.js

@@ -8,6 +8,7 @@ import { PieArcLabelPlot } from "./PieArcLabelPlot.js";
 import { getPercentageValue } from "../internals/getPercentageValue.js";
 import { getPieCoordinates } from "./getPieCoordinates.js";
 import { usePieSeries } from "../hooks/useSeries.js";
+import { useSkipAnimation } from "../context/AnimationProvider/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Demos:
@@ -21,7 +22,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 function PiePlot(props) {
   const {
-    skipAnimation,
+    skipAnimation: inSkipAnimation,
     slots,
     slotProps,
     onItemClick
@@ -33,6 +34,7 @@ function PiePlot(props) {
     width,
     height
   } = React.useContext(DrawingContext);
+  const skipAnimation = useSkipAnimation(inSkipAnimation);
   if (seriesData === undefined) {
     return null;
   }

package/modern/ResponsiveChartContainer/ResponsiveChartContainer.js

@@ -90,6 +90,11 @@ process.env.NODE_ENV !== "production" ? ResponsiveChartContainer.propTypes = {
    * Please refer to the appropriate docs page to learn more about it.
    */
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: PropTypes.bool,
   sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
   title: PropTypes.string,
   viewBox: PropTypes.shape({

package/modern/ResponsiveChartContainer/useResponsiveChartContainerProps.js

@@ -2,7 +2,7 @@
 
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["width", "height", "resolveSizeBeforeRender", "margin", "children", "series", "colors", "dataset", "desc", "disableAxisListener", "highlightedItem", "onHighlightChange", "plugins", "sx", "title", "viewBox", "xAxis", "yAxis", "zAxis"];
+const _excluded = ["width", "height", "resolveSizeBeforeRender", "margin", "children", "series", "colors", "dataset", "desc", "disableAxisListener", "highlightedItem", "onHighlightChange", "plugins", "sx", "title", "viewBox", "xAxis", "yAxis", "zAxis", "skipAnimation"];
 import { useChartContainerDimensions } from "./useChartContainerDimensions.js";
 export const useResponsiveChartContainerProps = (props, ref) => {
   const {
@@ -24,7 +24,8 @@ export const useResponsiveChartContainerProps = (props, ref) => {
       viewBox,
       xAxis,
       yAxis,
-      zAxis
+      zAxis,
+      skipAnimation
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const {
@@ -56,6 +57,7 @@ export const useResponsiveChartContainerProps = (props, ref) => {
     xAxis,
     yAxis,
     zAxis,
+    skipAnimation,
     width: dWidth,
     height: dHeight,
     ref

package/modern/ScatterChart/ScatterChart.js

@@ -62,7 +62,7 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
   // ----------------------------------------------------------------------
   /**
    * The configuration of axes highlight.
-   * @see See {@link https://mui.com/x/react-charts/tooltip/#highlights highlight docs} for more details.
+   * @see See {@link https://mui.com/x/react-charts/highlighting highlighting docs} for more details.
    * @default { x: 'none', y: 'none' }
    */
   axisHighlight: PropTypes.shape({
@@ -198,6 +198,11 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
    * An array of [[ScatterSeriesType]] objects.
    */
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: PropTypes.bool,
   /**
    * The props used for each component slot.
    * @default {}

package/modern/ScatterChart/extremums.js

@@ -18,13 +18,13 @@ export const getExtremumX = params => {
       seriesXAxisId: series[seriesId].xAxisId ?? series[seriesId].xAxisKey,
       seriesYAxisId: series[seriesId].yAxisId ?? series[seriesId].yAxisKey
     });
-    const seriesMinMax = series[seriesId].data.reduce((accSeries, d, dataIndex) => {
+    const seriesMinMax = series[seriesId].data?.reduce((accSeries, d, dataIndex) => {
       if (filter && !filter(d, dataIndex)) {
         return accSeries;
       }
       return mergeMinMax(accSeries, [d.x, d.x]);
     }, [Infinity, -Infinity]);
-    return mergeMinMax(acc, seriesMinMax);
+    return mergeMinMax(acc, seriesMinMax ?? [Infinity, -Infinity]);
   }, [Infinity, -Infinity]);
 };
 export const getExtremumY = params => {
@@ -44,12 +44,12 @@ export const getExtremumY = params => {
       seriesXAxisId: series[seriesId].xAxisId ?? series[seriesId].xAxisKey,
       seriesYAxisId: series[seriesId].yAxisId ?? series[seriesId].yAxisKey
     });
-    const seriesMinMax = series[seriesId].data.reduce((accSeries, d, dataIndex) => {
+    const seriesMinMax = series[seriesId].data?.reduce((accSeries, d, dataIndex) => {
       if (filter && !filter(d, dataIndex)) {
         return accSeries;
       }
       return mergeMinMax(accSeries, [d.y, d.y]);
     }, [Infinity, -Infinity]);
-    return mergeMinMax(acc, seriesMinMax);
+    return mergeMinMax(acc, seriesMinMax ?? [Infinity, -Infinity]);
   }, [Infinity, -Infinity]);
 };

package/modern/ScatterChart/formatter.js

@@ -1,10 +1,29 @@
-import { defaultizeValueFormatter } from "../internals/defaultizeValueFormatter.js";
+import _extends from "@babel/runtime/helpers/esm/extends";
 const formatter = ({
   series,
   seriesOrder
-}) => {
+}, dataset) => {
+  const completeSeries = Object.fromEntries(Object.entries(series).map(([seriesId, seriesData]) => {
+    const datasetKeys = seriesData?.datasetKeys;
+    const missingKeys = ['x', 'y', 'id'].filter(key => typeof datasetKeys?.[key] !== 'string');
+    if (seriesData?.datasetKeys && missingKeys.length > 0) {
+      throw new Error([`MUI X: scatter series with id='${seriesId}' has incomplete datasetKeys.`, `Properties ${missingKeys.map(key => `"${key}"`).join(', ')} are missing.`].join('\n'));
+    }
+    const data = !datasetKeys ? seriesData.data ?? [] : dataset?.map(d => {
+      return {
+        x: d[datasetKeys.x],
+        y: d[datasetKeys.y],
+        z: datasetKeys.z && d[datasetKeys.z],
+        id: d[datasetKeys.id]
+      };
+    }) ?? [];
+    return [seriesId, _extends({}, seriesData, {
+      data,
+      valueFormatter: seriesData.valueFormatter ?? (v => `(${v.x}, ${v.y})`)
+    })];
+  }));
   return {
-    series: defaultizeValueFormatter(series, v => `(${v.x}, ${v.y})`),
+    series: completeSeries,
     seriesOrder
   };
 };

package/modern/SparkLineChart/SparkLineChart.js

@@ -215,6 +215,11 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    * @default false
    */
   showTooltip: PropTypes.bool,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: PropTypes.bool,
   /**
    * The props used for each component slot.
    * @default {}

package/modern/context/AnimationProvider/Animation.types.js

@@ -0,0 +1 @@
+export {};

package/modern/context/AnimationProvider/AnimationContext.js

@@ -0,0 +1,10 @@
+import * as React from 'react';
+export const AnimationContext = /*#__PURE__*/React.createContext({
+  isInitialized: false,
+  data: {
+    skipAnimation: undefined
+  }
+});
+if (process.env.NODE_ENV !== 'production') {
+  AnimationContext.displayName = 'AnimationContext';
+}