@mui/x-charts 7.19.0 → 7.21.0

package/modern/context/AnimationProvider/AnimationProvider.js

@@ -0,0 +1,55 @@
+'use client';
+
+import { Globals, useIsomorphicLayoutEffect } from '@react-spring/web';
+import * as React from 'react';
+import { AnimationContext } from "./AnimationContext.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+function AnimationProvider(props) {
+  // Part of the behavior was taken from:
+  // https://github.com/pmndrs/react-spring/blob/fd65b605b85c3a24143c4ce9dd322fdfca9c66be/packages/shared/src/hooks/useReducedMotion.ts
+  const {
+    children,
+    skipAnimation: inSkipAnimation
+  } = props;
+
+  // Skip animation test/jsdom
+  const isAnimationDisabledEnvironment = typeof window === 'undefined' || !window?.matchMedia;
+
+  // We use the value of `isAnimationDisabledEnvironment` as the initial value of `skipAnimation` to avoid
+  // re-rendering the component on environments where matchMedia is not supported, hence skipAnimation will always be true.
+  const [skipAnimation, setSkipAnimation] = React.useState(isAnimationDisabledEnvironment || undefined);
+  useIsomorphicLayoutEffect(() => {
+    if (isAnimationDisabledEnvironment) {
+      return undefined;
+    }
+    const handleMediaChange = event => {
+      // This hook can remove animation but never activate it.
+      const inputValue = event.matches || undefined;
+      setSkipAnimation(inputValue);
+      Globals.assign({
+        skipAnimation: inputValue
+      });
+    };
+    const mql = window.matchMedia('(prefers-reduced-motion)');
+    handleMediaChange(mql);
+
+    // MatchMedia is not fully supported in all environments, so we need to check if it exists before calling addEventListener
+    mql?.addEventListener?.('change', handleMediaChange);
+    return () => {
+      mql?.removeEventListener?.('change', handleMediaChange);
+    };
+  }, []);
+  const value = React.useMemo(() => ({
+    isInitialized: true,
+    data: {
+      // If dev sets `skipAnimation` to true, it will skip all animations.
+      // If dev sets `skipAnimation` to false, it will use user's preference.
+      skipAnimation: inSkipAnimation || skipAnimation
+    }
+  }), [skipAnimation, inSkipAnimation]);
+  return /*#__PURE__*/_jsx(AnimationContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+export { AnimationProvider };

package/modern/context/AnimationProvider/index.js

@@ -0,0 +1,4 @@
+export * from "./Animation.types.js";
+export * from "./AnimationContext.js";
+export * from "./AnimationProvider.js";
+export * from "./useSkipAnimation.js";

package/modern/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/modern/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/modern/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/node/BarChart/BarChart.js

@@ -70,7 +70,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.default.shape({
     x: _propTypes.default.oneOf(['band', 'line', 'none']),
@@ -226,7 +226,7 @@ process.env.NODE_ENV !== "production" ? BarChart.propTypes = {
   series: _propTypes.default.arrayOf(_propTypes.default.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.default.bool,
   /**

package/node/BarChart/BarPlot.js

@@ -20,6 +20,7 @@ var _BarClipPath = require("./BarClipPath");
 var _BarLabelPlot = require("./BarLabel/BarLabelPlot");
 var _checkScaleErrors = require("./checkScaleErrors");
 var _useSeries = require("../hooks/useSeries");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["skipAnimation", "onItemClick", "borderRadius", "barLabel"];
 /**
@@ -194,12 +195,13 @@ function BarPlot(props) {
     masksData
   } = useAggregatedData();
   const {
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick,
       borderRadius,
       barLabel
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const skipAnimation = (0, _AnimationProvider.useSkipAnimation)(inSkipAnimation);
   const withoutBorderRadius = !borderRadius || borderRadius <= 0;
   const transition = (0, _web.useTransition)(completedData, {
     keys: bar => `${bar.seriesId}-${bar.dataIndex}`,
@@ -291,7 +293,7 @@ process.env.NODE_ENV !== "production" ? BarPlot.propTypes = {
   onItemClick: _propTypes.default.func,
   /**
    * If `true`, animations are skipped.
-   * @default false
+   * @default undefined
    */
   skipAnimation: _propTypes.default.bool,
   /**

package/node/BarChart/useBarChartProps.js

@@ -82,13 +82,13 @@ 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/node/ChartContainer/ChartContainer.js

@@ -19,6 +19,7 @@ var _ChartsAxesGradients = require("../internals/components/ChartsAxesGradients"
 var _context = require("../context");
 var _PluginProvider = require("../context/PluginProvider");
 var _useChartContainerProps = require("./useChartContainerProps");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _jsxRuntime = require("react/jsx-runtime");
 const ChartContainer = exports.ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(props, ref) {
   const {
@@ -29,7 +30,8 @@ const ChartContainer = exports.ChartContainer = /*#__PURE__*/React.forwardRef(fu
     zAxisContextProps,
     highlightedProviderProps,
     chartsSurfaceProps,
-    pluginProviderProps
+    pluginProviderProps,
+    animationProviderProps
   } = (0, _useChartContainerProps.useChartContainerProps)(props, ref);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_DrawingProvider.DrawingProvider, (0, _extends2.default)({}, drawingProviderProps, {
     children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_PluginProvider.PluginProvider, (0, _extends2.default)({}, pluginProviderProps, {
@@ -39,7 +41,9 @@ const ChartContainer = exports.ChartContainer = /*#__PURE__*/React.forwardRef(fu
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_InteractionProvider.InteractionProvider, {
               children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_context.HighlightedProvider, (0, _extends2.default)({}, highlightedProviderProps, {
                 children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_ChartsSurface.ChartsSurface, (0, _extends2.default)({}, chartsSurfaceProps, {
-                  children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsAxesGradients.ChartsAxesGradients, {}), children]
+                  children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsAxesGradients.ChartsAxesGradients, {}), /*#__PURE__*/(0, _jsxRuntime.jsx)(_AnimationProvider.AnimationProvider, (0, _extends2.default)({}, animationProviderProps, {
+                    children: children
+                  }))]
                 }))
               }))
             })
@@ -112,6 +116,11 @@ process.env.NODE_ENV !== "production" ? ChartContainer.propTypes = {
    * Please refer to the appropriate docs page to learn more about it.
    */
   series: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: _propTypes.default.bool,
   sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object]),
   title: _propTypes.default.string,
   viewBox: _propTypes.default.shape({

package/node/ChartContainer/useChartContainerProps.js

@@ -12,8 +12,7 @@ var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runt
 var React = _interopRequireWildcard(require("react"));
 var _useForkRef = _interopRequireDefault(require("@mui/utils/useForkRef"));
 var _useDefaultizeAxis = require("./useDefaultizeAxis");
-var _useReducedMotion = require("../hooks/useReducedMotion");
-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"];
 const useChartContainerProps = (props, ref) => {
   const {
       width,
@@ -32,13 +31,12 @@ const useChartContainerProps = (props, ref) => {
       highlightedItem,
       onHighlightChange,
       plugins,
-      children
+      children,
+      skipAnimation
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   const svgRef = React.useRef(null);
   const chartSurfaceRef = (0, _useForkRef.default)(ref, svgRef);
-  (0, _useReducedMotion.useReducedMotion)(); // a11y reduce motion (see: https://react-spring.dev/docs/utilities/use-reduced-motion)
-
   const [defaultizedXAxis, defaultizedYAxis] = (0, _useDefaultizeAxis.useDefaultizeAxis)(xAxis, yAxis, dataset);
   const drawingProviderProps = {
     width,
@@ -46,6 +44,9 @@ const useChartContainerProps = (props, ref) => {
     margin,
     svgRef
   };
+  const animationProviderProps = {
+    skipAnimation
+  };
   const pluginProviderProps = {
     plugins
   };
@@ -85,6 +86,7 @@ const useChartContainerProps = (props, ref) => {
     highlightedProviderProps,
     chartsSurfaceProps,
     pluginProviderProps,
+    animationProviderProps,
     xAxis: defaultizedXAxis,
     yAxis: defaultizedYAxis
   };

package/node/LineChart/AreaPlot.js

@@ -19,6 +19,7 @@ var _getCurve = _interopRequireDefault(require("../internals/getCurve"));
 var _constants = require("../constants");
 var _ChartsAxesGradients = require("../internals/components/ChartsAxesGradients");
 var _useSeries = require("../hooks/useSeries");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["slots", "slotProps", "onItemClick", "skipAnimation"];
 const useAggregatedData = () => {
@@ -121,9 +122,10 @@ function AreaPlot(props) {
       slots,
       slotProps,
       onItemClick,
-      skipAnimation
+      skipAnimation: inSkipAnimation
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const skipAnimation = (0, _AnimationProvider.useSkipAnimation)(inSkipAnimation);
   const getGradientId = (0, _ChartsAxesGradients.useChartGradient)();
   const completedData = useAggregatedData();
   return /*#__PURE__*/(0, _jsxRuntime.jsx)("g", (0, _extends2.default)({}, other, {

package/node/LineChart/LineChart.js

@@ -76,7 +76,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.default.shape({

package/node/LineChart/LinePlot.js

@@ -19,6 +19,7 @@ var _getCurve = _interopRequireDefault(require("../internals/getCurve"));
 var _constants = require("../constants");
 var _ChartsAxesGradients = require("../internals/components/ChartsAxesGradients");
 var _useSeries = require("../hooks/useSeries");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["slots", "slotProps", "skipAnimation", "onItemClick"];
 const useAggregatedData = () => {
@@ -101,10 +102,11 @@ function LinePlot(props) {
   const {
       slots,
       slotProps,
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const skipAnimation = (0, _AnimationProvider.useSkipAnimation)(inSkipAnimation);
   const getGradientId = (0, _ChartsAxesGradients.useChartGradient)();
   const completedData = useAggregatedData();
   return /*#__PURE__*/(0, _jsxRuntime.jsx)("g", (0, _extends2.default)({}, other, {

package/node/LineChart/MarkPlot.js

@@ -9,18 +9,19 @@ Object.defineProperty(exports, "__esModule", {
 exports.MarkPlot = MarkPlot;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
-var React = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
+var React = _interopRequireWildcard(require("react"));
+var _constants = require("../constants");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _CartesianProvider = require("../context/CartesianProvider");
-var _MarkElement = require("./MarkElement");
-var _useScale = require("../hooks/useScale");
 var _useChartId = require("../hooks/useChartId");
-var _constants = require("../constants");
-var _cleanId = require("../internals/cleanId");
-var _getColor = _interopRequireDefault(require("./getColor"));
-var _useSeries = require("../hooks/useSeries");
 var _useDrawingArea = require("../hooks/useDrawingArea");
+var _useScale = require("../hooks/useScale");
+var _useSeries = require("../hooks/useSeries");
+var _cleanId = require("../internals/cleanId");
 var _CircleMarkElement = require("./CircleMarkElement");
+var _getColor = _interopRequireDefault(require("./getColor"));
+var _MarkElement = require("./MarkElement");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["slots", "slotProps", "skipAnimation", "onItemClick", "experimentalRendering"];
 /**
@@ -37,11 +38,12 @@ function MarkPlot(props) {
   const {
       slots,
       slotProps,
-      skipAnimation,
+      skipAnimation: inSkipAnimation,
       onItemClick,
       experimentalRendering
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const skipAnimation = (0, _AnimationProvider.useSkipAnimation)(inSkipAnimation);
   const seriesData = (0, _useSeries.useLineSeries)();
   const axisData = (0, _CartesianProvider.useCartesianContext)();
   const chartId = (0, _useChartId.useChartId)();

package/node/LineChart/useLineChartProps.js

@@ -77,7 +77,8 @@ const useLineChartProps = props => {
     highlightedItem,
     onHighlightChange,
     disableAxisListener: tooltip?.trigger !== 'axis' && axisHighlight?.x === 'none' && axisHighlight?.y === 'none' && !onAxisClick,
-    className
+    className,
+    skipAnimation
   });
   const axisClickHandlerProps = {
     onAxisClick
@@ -95,14 +96,12 @@ 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/node/PieChart/PieChart.js

@@ -112,6 +112,7 @@ const PieChart = exports.PieChart = /*#__PURE__*/React.forwardRef(function PieCh
     highlightedItem: highlightedItem,
     onHighlightChange: onHighlightChange,
     className: className,
+    skipAnimation: skipAnimation,
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsAxis.ChartsAxis, {
       topAxis: topAxis,
       leftAxis: leftAxis,
@@ -122,8 +123,7 @@ const PieChart = exports.PieChart = /*#__PURE__*/React.forwardRef(function PieCh
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_PiePlot.PiePlot, {
       slots: slots,
       slotProps: slotProps,
-      onItemClick: onItemClick,
-      skipAnimation: skipAnimation
+      onItemClick: onItemClick
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsOverlay.ChartsOverlay, {
       loading: loading,
       slots: slots,
@@ -144,7 +144,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.default.shape({
@@ -270,7 +270,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
   series: _propTypes.default.arrayOf(_propTypes.default.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.default.bool,
   /**

package/node/PieChart/PiePlot.js

@@ -15,6 +15,7 @@ var _PieArcLabelPlot = require("./PieArcLabelPlot");
 var _getPercentageValue = require("../internals/getPercentageValue");
 var _getPieCoordinates = require("./getPieCoordinates");
 var _useSeries = require("../hooks/useSeries");
+var _AnimationProvider = require("../context/AnimationProvider");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Demos:
@@ -28,7 +29,7 @@ var _jsxRuntime = require("react/jsx-runtime");
  */
 function PiePlot(props) {
   const {
-    skipAnimation,
+    skipAnimation: inSkipAnimation,
     slots,
     slotProps,
     onItemClick
@@ -40,6 +41,7 @@ function PiePlot(props) {
     width,
     height
   } = React.useContext(_DrawingProvider.DrawingContext);
+  const skipAnimation = (0, _AnimationProvider.useSkipAnimation)(inSkipAnimation);
   if (seriesData === undefined) {
     return null;
   }

package/node/ResponsiveChartContainer/ResponsiveChartContainer.js

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

package/node/ResponsiveChartContainer/useResponsiveChartContainerProps.js

@@ -9,7 +9,7 @@ exports.useResponsiveChartContainerProps = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _useChartContainerDimensions = require("./useChartContainerDimensions");
-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"];
 const useResponsiveChartContainerProps = (props, ref) => {
   const {
       width,
@@ -30,7 +30,8 @@ const useResponsiveChartContainerProps = (props, ref) => {
       viewBox,
       xAxis,
       yAxis,
-      zAxis
+      zAxis,
+      skipAnimation
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   const {
@@ -62,6 +63,7 @@ const useResponsiveChartContainerProps = (props, ref) => {
     xAxis,
     yAxis,
     zAxis,
+    skipAnimation,
     width: dWidth,
     height: dHeight,
     ref

package/node/ScatterChart/ScatterChart.js

@@ -69,7 +69,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.default.shape({
@@ -205,6 +205,11 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
    * An array of [[ScatterSeriesType]] objects.
    */
   series: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
+  /**
+   * If `true`, animations are skipped.
+   * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
+   */
+  skipAnimation: _propTypes.default.bool,
   /**
    * The props used for each component slot.
    * @default {}

package/node/ScatterChart/extremums.js

@@ -24,13 +24,13 @@ 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]);
 };
 exports.getExtremumX = getExtremumX;
@@ -51,13 +51,13 @@ 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]);
 };
 exports.getExtremumY = getExtremumY;

package/node/ScatterChart/formatter.js

@@ -1,16 +1,36 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _defaultizeValueFormatter = require("../internals/defaultizeValueFormatter");
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/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, (0, _extends2.default)({}, seriesData, {
+      data,
+      valueFormatter: seriesData.valueFormatter ?? (v => `(${v.x}, ${v.y})`)
+    })];
+  }));
   return {
-    series: (0, _defaultizeValueFormatter.defaultizeValueFormatter)(series, v => `(${v.x}, ${v.y})`),
+    series: completeSeries,
     seriesOrder
   };
 };

package/node/SparkLineChart/SparkLineChart.js

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

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

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/node/context/AnimationProvider/AnimationContext.js

@@ -0,0 +1,17 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AnimationContext = void 0;
+var React = _interopRequireWildcard(require("react"));
+const AnimationContext = exports.AnimationContext = /*#__PURE__*/React.createContext({
+  isInitialized: false,
+  data: {
+    skipAnimation: undefined
+  }
+});
+if (process.env.NODE_ENV !== 'production') {
+  AnimationContext.displayName = 'AnimationContext';
+}