@mui/x-charts 7.5.0 → 7.6.0

package/esm/PieChart/PieArc.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["classes", "color", "cornerRadius", "dataIndex", "endAngle", "highlightScope", "id", "innerRadius", "isFaded", "isHighlighted", "onClick", "outerRadius", "paddingAngle", "startAngle"];
+const _excluded = ["classes", "color", "cornerRadius", "dataIndex", "endAngle", "id", "innerRadius", "isFaded", "isHighlighted", "onClick", "outerRadius", "paddingAngle", "startAngle", "highlightScope"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { arc as d3Arc } from 'd3-shape';
@@ -45,7 +45,6 @@ function PieArc(props) {
       cornerRadius,
       dataIndex,
       endAngle,
-      highlightScope,
       id,
       innerRadius,
       isFaded,
@@ -65,7 +64,7 @@ function PieArc(props) {
     isHighlighted
   };
   const classes = useUtilityClasses(ownerState);
-  const getInteractionItemProps = useInteractionItemProps(highlightScope);
+  const getInteractionItemProps = useInteractionItemProps();
   return /*#__PURE__*/_jsx(PieArcRoot, _extends({
     d: to([startAngle, endAngle, paddingAngle, innerRadius, outerRadius, cornerRadius], (sA, eA, pA, iR, oR, cR) => d3Arc().cornerRadius(cR)({
       padAngle: pA,
@@ -87,12 +86,17 @@ function PieArc(props) {
 process.env.NODE_ENV !== "production" ? PieArc.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   classes: PropTypes.object,
   dataIndex: PropTypes.number.isRequired,
+  /**
+   * @deprecated Use the `isFaded` or `isHighlighted` props instead.
+   */
   highlightScope: PropTypes.shape({
+    fade: PropTypes.oneOf(['global', 'none', 'series']),
     faded: PropTypes.oneOf(['global', 'none', 'series']),
+    highlight: PropTypes.oneOf(['item', 'none', 'series']),
     highlighted: PropTypes.oneOf(['item', 'none', 'series'])
   }),
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,

package/esm/PieChart/PieArcLabel.js

@@ -95,7 +95,7 @@ function PieArcLabel(props) {
 process.env.NODE_ENV !== "production" ? PieArcLabel.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   classes: PropTypes.object,
   color: PropTypes.string.isRequired,

package/esm/PieChart/PieArcLabelPlot.js

@@ -1,6 +1,6 @@
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
-const _excluded = ["arcLabel", "arcLabelMinAngle", "arcLabelRadius", "cornerRadius", "data", "faded", "highlighted", "highlightScope", "id", "innerRadius", "outerRadius", "paddingAngle", "skipAnimation", "slotProps", "slots"],
+const _excluded = ["arcLabel", "arcLabelMinAngle", "arcLabelRadius", "cornerRadius", "data", "faded", "highlighted", "id", "innerRadius", "outerRadius", "paddingAngle", "skipAnimation", "slotProps", "slots"],
   _excluded2 = ["startAngle", "endAngle", "paddingAngle", "innerRadius", "outerRadius", "arcLabelRadius", "cornerRadius"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
@@ -43,7 +43,6 @@ function PieArcLabelPlot(props) {
         additionalRadius: -5
       },
       highlighted,
-      highlightScope,
       id,
       innerRadius,
       outerRadius,
@@ -60,7 +59,6 @@ function PieArcLabelPlot(props) {
     cornerRadius,
     paddingAngle,
     id,
-    highlightScope,
     highlighted,
     faded,
     data
@@ -105,7 +103,7 @@ function PieArcLabelPlot(props) {
 process.env.NODE_ENV !== "production" ? PieArcLabelPlot.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * The label displayed into the arc.
@@ -162,10 +160,6 @@ process.env.NODE_ENV !== "production" ? PieArcLabelPlot.propTypes = {
     outerRadius: PropTypes.number,
     paddingAngle: PropTypes.number
   }),
-  highlightScope: PropTypes.shape({
-    faded: PropTypes.oneOf(['global', 'none', 'series']),
-    highlighted: PropTypes.oneOf(['item', 'none', 'series'])
-  }),
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
    * The radius between circle center and the beginning of the arc.

package/esm/PieChart/PieArcPlot.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["slots", "slotProps", "innerRadius", "outerRadius", "cornerRadius", "paddingAngle", "id", "highlightScope", "highlighted", "faded", "data", "onItemClick", "skipAnimation"],
+const _excluded = ["slots", "slotProps", "innerRadius", "outerRadius", "cornerRadius", "paddingAngle", "id", "highlighted", "faded", "data", "onItemClick", "skipAnimation"],
   _excluded2 = ["startAngle", "endAngle", "paddingAngle", "innerRadius", "arcLabelRadius", "outerRadius", "cornerRadius"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
@@ -8,6 +8,7 @@ import { useTransition } from '@react-spring/web';
 import { PieArc } from './PieArc';
 import { defaultTransitionConfig } from './dataTransform/transition';
 import { useTransformData } from './dataTransform/useTransformData';
+import { useHighlighted } from '../context';
 import { jsx as _jsx } from "react/jsx-runtime";
 function PieArcPlot(props) {
   const {
@@ -18,7 +19,6 @@ function PieArcPlot(props) {
       cornerRadius = 0,
       paddingAngle = 0,
       id,
-      highlightScope,
       highlighted,
       faded = {
         additionalRadius: -5
@@ -34,7 +34,6 @@ function PieArcPlot(props) {
     cornerRadius,
     paddingAngle,
     id,
-    highlightScope,
     highlighted,
     faded,
     data
@@ -42,6 +41,9 @@ function PieArcPlot(props) {
   const transition = useTransition(transformedData, _extends({}, defaultTransitionConfig, {
     immediate: skipAnimation
   }));
+  const {
+    highlightScope
+  } = useHighlighted();
   if (data.length === 0) {
     return null;
   }
@@ -85,7 +87,7 @@ function PieArcPlot(props) {
 process.env.NODE_ENV !== "production" ? PieArcPlot.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * The radius between circle center and the arc label in px.
@@ -133,10 +135,6 @@ process.env.NODE_ENV !== "production" ? PieArcPlot.propTypes = {
     outerRadius: PropTypes.number,
     paddingAngle: PropTypes.number
   }),
-  highlightScope: PropTypes.shape({
-    faded: PropTypes.oneOf(['global', 'none', 'series']),
-    highlighted: PropTypes.oneOf(['item', 'none', 'series'])
-  }),
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
    * The radius between circle center and the beginning of the arc.

package/esm/PieChart/PieChart.js

@@ -61,7 +61,9 @@ function PieChart(props) {
     slots,
     slotProps,
     onItemClick,
-    loading
+    loading,
+    highlightedItem,
+    onHighlightChange
   } = props;
   const isRTL = useIsRTL();
   const margin = _extends({}, isRTL ? defaultRTLMargin : defaultMargin, marginProps);
@@ -88,6 +90,8 @@ function PieChart(props) {
     colors: colors,
     sx: sx,
     disableAxisListener: tooltip?.trigger !== 'axis' && axisHighlight?.x === 'none' && axisHighlight?.y === 'none',
+    highlightedItem: highlightedItem,
+    onHighlightChange: onHighlightChange,
     children: [/*#__PURE__*/_jsx(ChartsAxis, {
       topAxis: topAxis,
       leftAxis: leftAxis,
@@ -116,7 +120,7 @@ function PieChart(props) {
 process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * The configuration of axes highlight.
@@ -155,6 +159,13 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
   height: PropTypes.number,
+  /**
+   * The item currently highlighted. Turns highlighting into a controlled prop.
+   */
+  highlightedItem: PropTypes.shape({
+    dataIndex: PropTypes.number,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
   /**
    * Indicate which axis to display the left of the charts.
    * Can be a string (the id of the axis) or an object `ChartsYAxisProps`.
@@ -194,6 +205,12 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   }),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {HighlightItemData | null} highlightedItem  The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func,
   /**
    * Callback fired when a pie arc is clicked.
    */

package/esm/PieChart/PiePlot.js

@@ -49,8 +49,7 @@ function PiePlot(props) {
         cx: cxParam,
         cy: cyParam,
         highlighted,
-        faded,
-        highlightScope
+        faded
       } = series[seriesId];
       const {
         cx,
@@ -75,7 +74,6 @@ function PiePlot(props) {
           id: seriesId,
           data: data,
           skipAnimation: skipAnimation,
-          highlightScope: highlightScope,
           highlighted: highlighted,
           faded: faded,
           onItemClick: onItemClick,
@@ -94,8 +92,7 @@ function PiePlot(props) {
         arcLabelMinAngle,
         data,
         cx: cxParam,
-        cy: cyParam,
-        highlightScope
+        cy: cyParam
       } = series[seriesId];
       const {
         cx,
@@ -124,7 +121,6 @@ function PiePlot(props) {
           skipAnimation: skipAnimation,
           arcLabel: arcLabel,
           arcLabelMinAngle: arcLabelMinAngle,
-          highlightScope: highlightScope,
           slots: slots,
           slotProps: slotProps
         })
@@ -135,7 +131,7 @@ function PiePlot(props) {
 process.env.NODE_ENV !== "production" ? PiePlot.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * Callback fired when a pie item is clicked.

package/esm/PieChart/dataTransform/useTransformData.js

@@ -1,11 +1,9 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
-import { InteractionContext } from '../../context/InteractionProvider';
-import { getIsHighlighted, getIsFaded } from '../../hooks/useInteractionItemProps';
+import { useHighlighted } from '../../context';
 export function useTransformData(series) {
   const {
     id: seriesId,
-    highlightScope,
     data,
     faded,
     highlighted,
@@ -16,29 +14,16 @@ export function useTransformData(series) {
     cornerRadius: baseCornerRadius = 0
   } = series;
   const {
-    item: highlightedItem
-  } = React.useContext(InteractionContext);
-  const getHighlightStatus = React.useCallback(dataIndex => {
-    const isHighlighted = getIsHighlighted(highlightedItem, {
-      type: 'pie',
-      seriesId,
-      dataIndex
-    }, highlightScope);
-    const isFaded = !isHighlighted && getIsFaded(highlightedItem, {
-      type: 'pie',
+    isFaded: isItemFaded,
+    isHighlighted: isItemHighlighted
+  } = useHighlighted();
+  const dataWithHighlight = React.useMemo(() => data.map((item, itemIndex) => {
+    const currentItem = {
       seriesId,
-      dataIndex
-    }, highlightScope);
-    return {
-      isHighlighted,
-      isFaded
+      dataIndex: itemIndex
     };
-  }, [highlightScope, highlightedItem, seriesId]);
-  const dataWithHighlight = React.useMemo(() => data.map((item, itemIndex) => {
-    const {
-      isHighlighted,
-      isFaded
-    } = getHighlightStatus(itemIndex);
+    const isHighlighted = isItemHighlighted(currentItem);
+    const isFaded = !isHighlighted && isItemFaded(currentItem);
     const attributesOverride = _extends({
       additionalRadius: 0
     }, isFaded && faded || isHighlighted && highlighted || {});
@@ -56,6 +41,6 @@ export function useTransformData(series) {
       cornerRadius,
       arcLabelRadius
     });
-  }), [baseCornerRadius, baseInnerRadius, baseOuterRadius, basePaddingAngle, baseArcLabelRadius, data, faded, getHighlightStatus, highlighted]);
+  }), [baseCornerRadius, baseInnerRadius, baseOuterRadius, basePaddingAngle, baseArcLabelRadius, data, faded, highlighted, isItemFaded, isItemHighlighted, seriesId]);
   return dataWithHighlight;
 }

package/esm/ResponsiveChartContainer/ResponsiveChartContainer.js

@@ -50,7 +50,7 @@ const ResponsiveChartContainer = /*#__PURE__*/React.forwardRef(function Responsi
 process.env.NODE_ENV !== "production" ? ResponsiveChartContainer.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   children: PropTypes.node,
   className: PropTypes.string,
@@ -74,6 +74,13 @@ process.env.NODE_ENV !== "production" ? ResponsiveChartContainer.propTypes = {
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
   height: PropTypes.number,
+  /**
+   * The item currently highlighted. Turns highlighting into a controlled prop.
+   */
+  highlightedItem: PropTypes.shape({
+    dataIndex: PropTypes.number,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
   /**
    * The margin between the SVG and the drawing area.
    * It's used for leaving some space for extra information such as the x- and y-axis or legend.
@@ -86,6 +93,12 @@ process.env.NODE_ENV !== "production" ? ResponsiveChartContainer.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   }),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {HighlightItemData | null} highlightedItem  The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func,
   /**
    * The array of series to display.
    * Each type of series has its own specificity.

package/esm/ScatterChart/Scatter.js

@@ -2,8 +2,9 @@ import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { getValueToPositionMapper } from '../hooks/useScale';
-import { getIsFaded, getIsHighlighted, useInteractionItemProps } from '../hooks/useInteractionItemProps';
+import { useInteractionItemProps } from '../hooks/useInteractionItemProps';
 import { InteractionContext } from '../context/InteractionProvider';
+import { useHighlighted } from '../context';
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Demos:
@@ -25,16 +26,15 @@ function Scatter(props) {
     markerSize,
     onItemClick
   } = props;
-  const highlightScope = React.useMemo(() => _extends({
-    highlighted: 'item',
-    faded: 'global'
-  }, series.highlightScope), [series.highlightScope]);
   const {
-    item,
     useVoronoiInteraction
   } = React.useContext(InteractionContext);
   const skipInteractionHandlers = useVoronoiInteraction || series.disableHover;
-  const getInteractionItemProps = useInteractionItemProps(highlightScope, skipInteractionHandlers);
+  const getInteractionItemProps = useInteractionItemProps(skipInteractionHandlers);
+  const {
+    isFaded,
+    isHighlighted
+  } = useHighlighted();
   const cleanData = React.useMemo(() => {
     const getXPosition = getValueToPositionMapper(xScale);
     const getYPosition = getValueToPositionMapper(yScale);
@@ -56,12 +56,16 @@ function Scatter(props) {
         dataIndex: i
       };
       if (isInRange) {
-        const isHighlighted = getIsHighlighted(item, pointCtx, highlightScope);
+        const currentItem = {
+          seriesId: pointCtx.seriesId,
+          dataIndex: pointCtx.dataIndex
+        };
+        const isItemHighlighted = isHighlighted(currentItem);
         temp.push({
           x,
           y,
-          isHighlighted,
-          isFaded: !isHighlighted && getIsFaded(item, pointCtx, highlightScope),
+          isHighlighted: isItemHighlighted,
+          isFaded: !isItemHighlighted && isFaded(currentItem),
           interactionProps: getInteractionItemProps(pointCtx),
           id: scatterPoint.id,
           dataIndex: i,
@@ -70,7 +74,7 @@ function Scatter(props) {
       }
     }
     return temp;
-  }, [xScale, yScale, series.data, series.id, item, highlightScope, getInteractionItemProps, color, colorGetter]);
+  }, [xScale, yScale, series.data, series.id, getInteractionItemProps, color, colorGetter, isFaded, isHighlighted]);
   return /*#__PURE__*/_jsx("g", {
     children: cleanData.map(dataPoint => /*#__PURE__*/_jsx("circle", _extends({
       cx: 0,
@@ -91,7 +95,7 @@ function Scatter(props) {
 process.env.NODE_ENV !== "production" ? Scatter.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   color: PropTypes.string.isRequired,
   colorGetter: PropTypes.func,

package/esm/ScatterChart/ScatterChart.js

@@ -47,7 +47,9 @@ const ScatterChart = /*#__PURE__*/React.forwardRef(function ScatterChart(props,
     children,
     slots,
     slotProps,
-    loading
+    loading,
+    highlightedItem,
+    onHighlightChange
   } = props;
   return /*#__PURE__*/_jsx(ResponsiveChartContainer, {
     ref: ref,
@@ -61,6 +63,8 @@ const ScatterChart = /*#__PURE__*/React.forwardRef(function ScatterChart(props,
     xAxis: xAxis,
     yAxis: yAxis,
     sx: sx,
+    highlightedItem: highlightedItem,
+    onHighlightChange: onHighlightChange,
     children: /*#__PURE__*/_jsxs(ZAxisContextProvider, {
       zAxis: zAxis,
       children: [!disableVoronoi && /*#__PURE__*/_jsx(ChartsVoronoiHandler, {
@@ -99,7 +103,7 @@ const ScatterChart = /*#__PURE__*/React.forwardRef(function ScatterChart(props,
 process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * The configuration of axes highlight.
@@ -150,6 +154,13 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
   height: PropTypes.number,
+  /**
+   * The item currently highlighted. Turns highlighting into a controlled prop.
+   */
+  highlightedItem: PropTypes.shape({
+    dataIndex: PropTypes.number,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
   /**
    * Indicate which axis to display the left of the charts.
    * Can be a string (the id of the axis) or an object `ChartsYAxisProps`.
@@ -187,6 +198,12 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   }),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {HighlightItemData | null} highlightedItem  The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func,
   /**
    * Callback fired when clicking on a scatter item.
    * @param {MouseEvent} event The mouse event recorded on the `<svg/>` element if using Voronoi cells. Or the Mouse event from the scatter element, when `disableVoronoi=true`.

package/esm/ScatterChart/ScatterPlot.js

@@ -74,7 +74,7 @@ function ScatterPlot(props) {
 process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * Callback fired when clicking on a scatter item.

package/esm/SparkLineChart/SparkLineChart.js

@@ -105,7 +105,7 @@ const SparkLineChart = /*#__PURE__*/React.forwardRef(function SparkLineChart(pro
 process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
-  // | To update them edit the TypeScript types and run "yarn proptypes"  |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
   /**
    * Set to `true` to fill spark line area.
@@ -147,6 +147,13 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
   height: PropTypes.number,
+  /**
+   * The item currently highlighted. Turns highlighting into a controlled prop.
+   */
+  highlightedItem: PropTypes.shape({
+    dataIndex: PropTypes.number,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
   /**
    * The margin between the SVG and the drawing area.
    * It's used for leaving some space for extra information such as the x- and y-axis or legend.
@@ -164,6 +171,12 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   }),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {HighlightItemData | null} highlightedItem  The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func,
   /**
    * Type of plot used.
    * @default 'line'

package/esm/context/HighlightedProvider/HighlightedContext.js

@@ -0,0 +1,29 @@
+import * as React from 'react';
+
+/**
+ * The data of the highlighted item.
+ * To highlight an item, you need to provide the series id and the item id.
+ * If targeting the whole series, you can omit the item id.
+ * To clear the highlight, set the value to an empty object.
+ *
+ * @example
+ * // Highlight the item with the series id 'london' and the item id 0.
+ * { seriesId: 'london', dataIndex: 0 }
+ *
+ * // Highlight the whole series with the series id 'london'.
+ * { seriesId: 'london' }
+ *
+ * // Clear the highlight.
+ * {}
+ */
+
+export const HighlightedContext = /*#__PURE__*/React.createContext({
+  highlightedItem: null,
+  setHighlighted: () => {},
+  clearHighlighted: () => {},
+  isHighlighted: () => false,
+  isFaded: () => false
+});
+if (process.env.NODE_ENV !== 'production') {
+  HighlightedContext.displayName = 'HighlightedContext';
+}

package/esm/context/HighlightedProvider/HighlightedProvider.js

@@ -0,0 +1,89 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["highlighted", "faded"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import useControlled from '@mui/utils/useControlled';
+import { HighlightedContext } from './HighlightedContext';
+import { createIsFaded } from './createIsFaded';
+import { createIsHighlighted } from './createIsHighlighted';
+import { useSeries } from '../../hooks/useSeries';
+import { jsx as _jsx } from "react/jsx-runtime";
+const mergeDeprecatedOptions = options => {
+  const _ref = options ?? {},
+    {
+      highlighted,
+      faded
+    } = _ref,
+    rest = _objectWithoutPropertiesLoose(_ref, _excluded);
+  return _extends({
+    highlight: highlighted,
+    fade: faded
+  }, rest);
+};
+function HighlightedProvider({
+  children,
+  highlightedItem: highlightedItemProps,
+  onHighlightChange
+}) {
+  const [highlightedItem, setHighlightedItem] = useControlled({
+    controlled: highlightedItemProps,
+    default: null,
+    name: 'HighlightedProvider',
+    state: 'highlightedItem'
+  });
+  const series = useSeries();
+  const seriesById = React.useMemo(() => {
+    const map = new Map();
+    Object.keys(series).forEach(seriesType => {
+      const seriesData = series[seriesType];
+      Object.keys(seriesData?.series ?? {}).forEach(seriesId => {
+        const seriesItem = seriesData?.series[seriesId];
+        map.set(seriesId, mergeDeprecatedOptions(seriesItem?.highlightScope));
+      });
+    });
+    return map;
+  }, [series]);
+  const highlightScope = highlightedItem && highlightedItem.seriesId ? seriesById.get(highlightedItem.seriesId) ?? undefined : undefined;
+  const providerValue = React.useMemo(() => {
+    return {
+      highlightScope,
+      highlightedItem,
+      setHighlighted: itemData => {
+        setHighlightedItem(itemData);
+        onHighlightChange?.(itemData);
+      },
+      clearHighlighted: () => {
+        setHighlightedItem(null);
+        onHighlightChange?.(null);
+      },
+      isHighlighted: createIsHighlighted(highlightScope, highlightedItem),
+      isFaded: createIsFaded(highlightScope, highlightedItem)
+    };
+  }, [highlightedItem, highlightScope, setHighlightedItem, onHighlightChange]);
+  return /*#__PURE__*/_jsx(HighlightedContext.Provider, {
+    value: providerValue,
+    children: children
+  });
+}
+process.env.NODE_ENV !== "production" ? HighlightedProvider.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  children: PropTypes.node,
+  /**
+   * The item currently highlighted. Turns highlighting into a controlled prop.
+   */
+  highlightedItem: PropTypes.shape({
+    dataIndex: PropTypes.number,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {HighlightItemData | null} highlightedItem  The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func
+} : void 0;
+export { HighlightedProvider };

package/esm/context/HighlightedProvider/createIsFaded.js

@@ -0,0 +1,12 @@
+export const createIsFaded = (highlightScope, highlightedItem) => input => {
+  if (!highlightScope) {
+    return false;
+  }
+  if (highlightScope.fade === 'series') {
+    return input.seriesId === highlightedItem?.seriesId && input.dataIndex !== highlightedItem?.dataIndex;
+  }
+  if (highlightScope.fade === 'global') {
+    return input.seriesId !== highlightedItem?.seriesId || input.dataIndex !== highlightedItem?.dataIndex;
+  }
+  return false;
+};