@mui/x-charts 7.5.0 → 7.6.0

package/esm/BarChart/BarElement.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["id", "dataIndex", "classes", "color", "highlightScope", "slots", "slotProps", "style", "onClick"];
+const _excluded = ["id", "dataIndex", "classes", "color", "slots", "slotProps", "style", "onClick"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import composeClasses from '@mui/utils/composeClasses';
@@ -10,8 +10,8 @@ import { styled } from '@mui/material/styles';
 import { color as d3Color } from 'd3-color';
 import generateUtilityClasses from '@mui/utils/generateUtilityClasses';
 import { animated } from '@react-spring/web';
-import { getIsFaded, getIsHighlighted, useInteractionItemProps } from '../hooks/useInteractionItemProps';
-import { InteractionContext } from '../context/InteractionProvider';
+import { useInteractionItemProps } from '../hooks/useInteractionItemProps';
+import { useItemHighlighted } from '../context';
 import { jsx as _jsx } from "react/jsx-runtime";
 export function getBarElementUtilityClass(slot) {
   return generateUtilityClass('MuiBarElement', slot);
@@ -45,27 +45,20 @@ function BarElement(props) {
       dataIndex,
       classes: innerClasses,
       color,
-      highlightScope,
       slots,
       slotProps,
       style,
       onClick
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
-  const getInteractionItemProps = useInteractionItemProps(highlightScope);
+  const getInteractionItemProps = useInteractionItemProps();
   const {
-    item
-  } = React.useContext(InteractionContext);
-  const isHighlighted = getIsHighlighted(item, {
-    type: 'bar',
-    seriesId: id,
-    dataIndex
-  }, highlightScope);
-  const isFaded = !isHighlighted && getIsFaded(item, {
-    type: 'bar',
+    isFaded,
+    isHighlighted
+  } = useItemHighlighted({
     seriesId: id,
     dataIndex
-  }, highlightScope);
+  });
   const ownerState = {
     id,
     dataIndex,
@@ -97,14 +90,10 @@ function BarElement(props) {
 process.env.NODE_ENV !== "production" ? BarElement.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,
-  highlightScope: PropTypes.shape({
-    faded: PropTypes.oneOf(['global', 'none', 'series']),
-    highlighted: PropTypes.oneOf(['item', 'none', 'series'])
-  }),
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
    * The props used for each component slot.

package/esm/BarChart/BarLabel/BarLabel.js

@@ -0,0 +1,51 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _extends from "@babel/runtime/helpers/esm/extends";
+const _excluded = ["seriesId", "dataIndex", "color", "isFaded", "isHighlighted", "classes"];
+import * as React from 'react';
+import { styled, useThemeProps } from '@mui/material/styles';
+import { animated } from '@react-spring/web';
+import PropTypes from 'prop-types';
+import { barLabelClasses } from './barLabelClasses';
+import { jsx as _jsx } from "react/jsx-runtime";
+export const BarLabelComponent = styled(animated.text, {
+  name: 'MuiBarLabel',
+  slot: 'Root',
+  overridesResolver: (_, styles) => [{
+    [`&.${barLabelClasses.faded}`]: styles.faded
+  }, {
+    [`&.${barLabelClasses.highlighted}`]: styles.highlighted
+  }, styles.root]
+})(({
+  theme
+}) => _extends({}, theme?.typography?.body2, {
+  stroke: 'none',
+  fill: (theme.vars || theme)?.palette?.text?.primary,
+  transition: 'opacity 0.2s ease-in, fill 0.2s ease-in',
+  textAnchor: 'middle',
+  dominantBaseline: 'central',
+  pointerEvents: 'none',
+  opacity: 1,
+  [`&.${barLabelClasses.faded}`]: {
+    opacity: 0.3
+  }
+}));
+function BarLabel(props) {
+  const themeProps = useThemeProps({
+    props,
+    name: 'MuiBarLabel'
+  });
+  const otherProps = _objectWithoutPropertiesLoose(themeProps, _excluded);
+  return /*#__PURE__*/_jsx(BarLabelComponent, _extends({}, otherProps));
+}
+process.env.NODE_ENV !== "production" ? BarLabel.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  classes: PropTypes.object,
+  dataIndex: PropTypes.number.isRequired,
+  isFaded: PropTypes.bool.isRequired,
+  isHighlighted: PropTypes.bool.isRequired,
+  seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired
+} : void 0;
+export { BarLabel };

package/esm/BarChart/BarLabel/BarLabel.types.js

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

package/esm/BarChart/BarLabel/BarLabelItem.js

@@ -0,0 +1,119 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["seriesId", "classes", "color", "style", "dataIndex", "barLabel", "slots", "slotProps", "height", "width", "value"],
+  _excluded2 = ["ownerState"];
+import * as React from 'react';
+import { useSlotProps } from '@mui/base/utils';
+import PropTypes from 'prop-types';
+import { useUtilityClasses } from './barLabelClasses';
+import { getBarLabel } from './getBarLabel';
+import { BarLabel } from './BarLabel';
+import { useItemHighlighted } from '../../context';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @ignore - internal component.
+ */
+function BarLabelItem(props) {
+  const {
+      seriesId,
+      classes: innerClasses,
+      color,
+      style,
+      dataIndex,
+      barLabel,
+      slots,
+      slotProps,
+      height,
+      width,
+      value
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const {
+    isFaded,
+    isHighlighted
+  } = useItemHighlighted({
+    seriesId,
+    dataIndex
+  });
+  const ownerState = {
+    seriesId,
+    classes: innerClasses,
+    color,
+    isFaded,
+    isHighlighted,
+    dataIndex
+  };
+  const classes = useUtilityClasses(ownerState);
+  const Component = slots?.barLabel ?? BarLabel;
+  const _useSlotProps = useSlotProps({
+      elementType: Component,
+      externalSlotProps: slotProps?.barLabel,
+      additionalProps: _extends({}, other, {
+        style,
+        className: classes.root
+      }),
+      ownerState
+    }),
+    {
+      ownerState: barLabelOwnerState
+    } = _useSlotProps,
+    barLabelProps = _objectWithoutPropertiesLoose(_useSlotProps, _excluded2);
+  if (!barLabel) {
+    return null;
+  }
+  const formattedLabelText = getBarLabel({
+    barLabel,
+    value,
+    dataIndex,
+    seriesId,
+    height,
+    width
+  });
+  if (!formattedLabelText) {
+    return null;
+  }
+  return /*#__PURE__*/_jsx(Component, _extends({}, barLabelProps, barLabelOwnerState, {
+    children: formattedLabelText
+  }));
+}
+process.env.NODE_ENV !== "production" ? BarLabelItem.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * If provided, the function will be used to format the label of the bar.
+   * It can be set to 'value' to display the current value.
+   * @param {BarItem} item The item to format.
+   * @param {BarLabelContext} context data about the bar.
+   * @returns {string} The formatted label.
+   */
+  barLabel: PropTypes.oneOfType([PropTypes.oneOf(['value']), PropTypes.func]),
+  classes: PropTypes.object,
+  color: PropTypes.string.isRequired,
+  dataIndex: PropTypes.number.isRequired,
+  /**
+   * The height of the bar.
+   */
+  height: PropTypes.number.isRequired,
+  seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+  /**
+   * The props used for each component slot.
+   * @default {}
+   */
+  slotProps: PropTypes.object,
+  /**
+   * Overridable component slots.
+   * @default {}
+   */
+  slots: PropTypes.object,
+  /**
+   * The value of the data point.
+   */
+  value: PropTypes.number,
+  /**
+   * The width of the bar.
+   */
+  width: PropTypes.number.isRequired
+} : void 0;
+export { BarLabelItem };

package/esm/BarChart/BarLabel/BarLabelPlot.js

@@ -0,0 +1,98 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _extends from "@babel/runtime/helpers/esm/extends";
+const _excluded = ["bars", "skipAnimation"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useTransition } from '@react-spring/web';
+import { BarLabelItem } from './BarLabelItem';
+import { jsx as _jsx } from "react/jsx-runtime";
+const leaveStyle = ({
+  layout,
+  yOrigin,
+  x,
+  width,
+  y,
+  xOrigin,
+  height
+}) => _extends({}, layout === 'vertical' ? {
+  y: yOrigin,
+  x: x + width / 2,
+  height: 0,
+  width
+} : {
+  y: y + height / 2,
+  x: xOrigin,
+  height,
+  width: 0
+});
+const enterStyle = ({
+  x,
+  width,
+  y,
+  height
+}) => ({
+  x: x + width / 2,
+  y: y + height / 2,
+  height,
+  width
+});
+/**
+ * @ignore - internal component.
+ */
+function BarLabelPlot(props) {
+  const {
+      bars,
+      skipAnimation
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const barLabelTransition = useTransition(bars, {
+    keys: bar => `${bar.seriesId}-${bar.dataIndex}`,
+    from: leaveStyle,
+    leave: null,
+    enter: enterStyle,
+    update: enterStyle,
+    immediate: skipAnimation
+  });
+  return /*#__PURE__*/_jsx(React.Fragment, {
+    children: barLabelTransition((style, {
+      seriesId,
+      dataIndex,
+      color,
+      value,
+      width,
+      height
+    }) => /*#__PURE__*/_jsx(BarLabelItem, _extends({
+      seriesId: seriesId,
+      dataIndex: dataIndex,
+      value: value,
+      color: color,
+      width: width,
+      height: height
+    }, other, {
+      style: style
+    })))
+  });
+}
+process.env.NODE_ENV !== "production" ? BarLabelPlot.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  barLabel: PropTypes.oneOfType([PropTypes.oneOf(['value']), PropTypes.func]),
+  bars: PropTypes.arrayOf(PropTypes.shape({
+    color: PropTypes.string.isRequired,
+    dataIndex: PropTypes.number.isRequired,
+    height: PropTypes.number.isRequired,
+    layout: PropTypes.oneOf(['horizontal', 'vertical']),
+    maskId: PropTypes.string.isRequired,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    value: PropTypes.number,
+    width: PropTypes.number.isRequired,
+    x: PropTypes.number.isRequired,
+    xOrigin: PropTypes.number.isRequired,
+    y: PropTypes.number.isRequired,
+    yOrigin: PropTypes.number.isRequired
+  })).isRequired,
+  skipAnimation: PropTypes.bool
+} : void 0;
+export { BarLabelPlot };

package/esm/BarChart/BarLabel/barLabelClasses.js

@@ -0,0 +1,19 @@
+import generateUtilityClass from '@mui/utils/generateUtilityClass';
+import generateUtilityClasses from '@mui/utils/generateUtilityClasses';
+import composeClasses from '@mui/utils/composeClasses';
+export function getBarLabelUtilityClass(slot) {
+  return generateUtilityClass('MuiBarLabel', slot);
+}
+export const barLabelClasses = generateUtilityClasses('MuiBarLabel', ['root', 'highlighted', 'faded']);
+export const useUtilityClasses = ownerState => {
+  const {
+    classes,
+    seriesId,
+    isFaded,
+    isHighlighted
+  } = ownerState;
+  const slots = {
+    root: ['root', `series-${seriesId}`, isHighlighted && 'highlighted', isFaded && 'faded']
+  };
+  return composeClasses(slots, getBarLabelUtilityClass, classes);
+};

package/esm/BarChart/BarLabel/getBarLabel.js

@@ -0,0 +1,24 @@
+export const getBarLabel = options => {
+  const {
+    barLabel,
+    value,
+    dataIndex,
+    seriesId,
+    height,
+    width
+  } = options;
+  if (barLabel === 'value') {
+    // We don't want to show the label if the value is 0
+    return value ? value?.toString() : null;
+  }
+  return barLabel({
+    seriesId,
+    dataIndex,
+    value
+  }, {
+    bar: {
+      height,
+      width
+    }
+  });
+};

package/esm/BarChart/BarLabel/index.js

@@ -0,0 +1,2 @@
+export { BarLabel } from './BarLabel';
+export { barLabelClasses, getBarLabelUtilityClass } from './barLabelClasses';

package/esm/BarChart/BarPlot.js

@@ -1,17 +1,17 @@
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
-const _excluded = ["skipAnimation", "onItemClick", "borderRadius"];
+const _excluded = ["skipAnimation", "onItemClick", "borderRadius", "barLabel"];
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { useTransition } from '@react-spring/web';
 import { SeriesContext } from '../context/SeriesContextProvider';
 import { CartesianContext } from '../context/CartesianContextProvider';
 import { BarElement } from './BarElement';
-import { isBandScaleConfig, isPointScaleConfig } from '../models/axis';
-import { DEFAULT_X_AXIS_KEY, DEFAULT_Y_AXIS_KEY } from '../constants';
 import getColor from './getColor';
 import { useChartId } from '../hooks';
 import { BarClipPath } from './BarClipPath';
+import { BarLabelPlot } from './BarLabel/BarLabelPlot';
+import { checkScaleErrors } from './checkScaleErrors';
 
 /**
  * Solution of the equations
@@ -71,30 +71,8 @@ const useAggregatedData = () => {
       const xAxisConfig = xAxis[xAxisKey];
       const yAxisConfig = yAxis[yAxisKey];
       const verticalLayout = series[seriesId].layout === 'vertical';
-      let baseScaleConfig;
-      if (verticalLayout) {
-        if (!isBandScaleConfig(xAxisConfig)) {
-          throw new Error(`MUI X Charts: ${xAxisKey === DEFAULT_X_AXIS_KEY ? 'The first `xAxis`' : `The x-axis with id "${xAxisKey}"`} should be of type "band" to display the bar series of id "${seriesId}".`);
-        }
-        if (xAxis[xAxisKey].data === undefined) {
-          throw new Error(`MUI X Charts: ${xAxisKey === DEFAULT_X_AXIS_KEY ? 'The first `xAxis`' : `The x-axis with id "${xAxisKey}"`} should have data property.`);
-        }
-        baseScaleConfig = xAxisConfig;
-        if (isBandScaleConfig(yAxisConfig) || isPointScaleConfig(yAxisConfig)) {
-          throw new Error(`MUI X Charts: ${yAxisKey === DEFAULT_Y_AXIS_KEY ? 'The first `yAxis`' : `The y-axis with id "${yAxisKey}"`} should be a continuous type to display the bar series of id "${seriesId}".`);
-        }
-      } else {
-        if (!isBandScaleConfig(yAxisConfig)) {
-          throw new Error(`MUI X Charts: ${yAxisKey === DEFAULT_Y_AXIS_KEY ? 'The first `yAxis`' : `The y-axis with id "${yAxisKey}"`} should be of type "band" to display the bar series of id "${seriesId}".`);
-        }
-        if (yAxis[yAxisKey].data === undefined) {
-          throw new Error(`MUI X Charts: ${yAxisKey === DEFAULT_Y_AXIS_KEY ? 'The first `yAxis`' : `The y-axis with id "${yAxisKey}"`} should have data property.`);
-        }
-        baseScaleConfig = yAxisConfig;
-        if (isBandScaleConfig(xAxisConfig) || isPointScaleConfig(xAxisConfig)) {
-          throw new Error(`MUI X Charts: ${xAxisKey === DEFAULT_X_AXIS_KEY ? 'The first `xAxis`' : `The x-axis with id "${xAxisKey}"`} should be a continuous type to display the bar series of id "${seriesId}".`);
-        }
-      }
+      checkScaleErrors(verticalLayout, seriesId, xAxisKey, xAxis, yAxisKey, yAxis);
+      const baseScaleConfig = verticalLayout ? xAxisConfig : yAxisConfig;
       const xScale = xAxisConfig.scale;
       const yScale = yAxisConfig.scale;
       const colorGetter = getColor(series[seriesId], xAxis[xAxisKey], yAxis[yAxisKey]);
@@ -127,7 +105,6 @@ const useAggregatedData = () => {
           height: verticalLayout ? maxValueCoord - minValueCoord : barWidth,
           width: verticalLayout ? barWidth : maxValueCoord - minValueCoord,
           color: colorGetter(dataIndex),
-          highlightScope: series[seriesId].highlightScope,
           value: series[seriesId].data[dataIndex],
           maskId: `${chartId}_${stackId || seriesId}_${groupIndex}_${dataIndex}`
         };
@@ -211,7 +188,8 @@ function BarPlot(props) {
   const {
       skipAnimation,
       onItemClick,
-      borderRadius
+      borderRadius,
+      barLabel
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const transition = useTransition(completedData, {
@@ -249,14 +227,12 @@ function BarPlot(props) {
       seriesId,
       dataIndex,
       color,
-      highlightScope,
       maskId
     }) => {
       const barElement = /*#__PURE__*/_jsx(BarElement, _extends({
         id: seriesId,
         dataIndex: dataIndex,
-        color: color,
-        highlightScope: highlightScope
+        color: color
       }, other, {
         onClick: onItemClick && (event => {
           onItemClick(event, {
@@ -274,14 +250,26 @@ function BarPlot(props) {
         clipPath: `url(#${maskId})`,
         children: barElement
       });
-    })]
+    }), barLabel && /*#__PURE__*/_jsx(BarLabelPlot, _extends({
+      bars: completedData,
+      skipAnimation: skipAnimation,
+      barLabel: barLabel
+    }, other))]
   });
 }
 process.env.NODE_ENV !== "production" ? BarPlot.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"  |
   // ----------------------------------------------------------------------
+  /**
+   * If provided, the function will be used to format the label of the bar.
+   * It can be set to 'value' to display the current value.
+   * @param {BarItem} item The item to format.
+   * @param {BarLabelContext} context data about the bar.
+   * @returns {string} The formatted label.
+   */
+  barLabel: PropTypes.oneOfType([PropTypes.oneOf(['value']), PropTypes.func]),
   /**
    * Defines the border radius of the bar element.
    */

package/esm/BarChart/checkScaleErrors.js

@@ -0,0 +1,27 @@
+import { DEFAULT_X_AXIS_KEY, DEFAULT_Y_AXIS_KEY } from '../constants';
+import { isBandScaleConfig, isPointScaleConfig } from '../models/axis';
+const getAxisMessage = (axisDirection, axisKey) => {
+  const axisName = `${axisDirection}-axis`;
+  const axisKeyName = `${axisDirection}Axis`;
+  const axisDefaultKey = axisDirection === 'x' ? DEFAULT_X_AXIS_KEY : DEFAULT_Y_AXIS_KEY;
+  return axisKey === axisDefaultKey ? `The first \`${axisKeyName}\`` : `The ${axisName} with id "${axisKey}"`;
+};
+export function checkScaleErrors(verticalLayout, seriesId, xAxisKey, xAxis, yAxisKey, yAxis) {
+  const xAxisConfig = xAxis[xAxisKey];
+  const yAxisConfig = yAxis[yAxisKey];
+  const discreteAxisConfig = verticalLayout ? xAxisConfig : yAxisConfig;
+  const continuousAxisConfig = verticalLayout ? yAxisConfig : xAxisConfig;
+  const discreteAxisKey = verticalLayout ? xAxisKey : yAxisKey;
+  const continuousAxisKey = verticalLayout ? yAxisKey : xAxisKey;
+  const discreteAxisDirection = verticalLayout ? 'x' : 'y';
+  const continuousAxisDirection = verticalLayout ? 'y' : 'x';
+  if (!isBandScaleConfig(discreteAxisConfig)) {
+    throw new Error(`MUI X Charts: ${getAxisMessage(discreteAxisDirection, discreteAxisKey)} should be of type "band" to display the bar series of id "${seriesId}".`);
+  }
+  if (discreteAxisConfig.data === undefined) {
+    throw new Error(`MUI X Charts: ${getAxisMessage(discreteAxisDirection, discreteAxisKey)} should have data property.`);
+  }
+  if (isBandScaleConfig(continuousAxisConfig) || isPointScaleConfig(continuousAxisConfig)) {
+    throw new Error(`MUI X Charts: ${getAxisMessage(continuousAxisDirection, continuousAxisKey)} should be a continuous type to display the bar series of id "${seriesId}".`);
+  }
+}

package/esm/BarChart/index.js

@@ -1,3 +1,4 @@
 export * from './BarChart';
 export * from './BarPlot';
-export * from './BarElement';
+export * from './BarElement';
+export * from './BarLabel';

package/esm/ChartContainer/ChartContainer.js

@@ -7,8 +7,8 @@ import { InteractionProvider } from '../context/InteractionProvider';
 import { useReducedMotion } from '../hooks/useReducedMotion';
 import { ChartsSurface } from '../ChartsSurface';
 import { CartesianContextProvider } from '../context/CartesianContextProvider';
-import { HighlightProvider } from '../context/HighlightProvider';
 import { ChartsAxesGradients } from '../internals/components/ChartsAxesGradients';
+import { HighlightedProvider } from '../context';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(props, ref) {
   const {
@@ -24,6 +24,8 @@ const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(pro
     title,
     desc,
     disableAxisListener,
+    highlightedItem,
+    onHighlightChange,
     children
   } = props;
   const svgRef = React.useRef(null);
@@ -44,7 +46,9 @@ const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(pro
         yAxis: yAxis,
         dataset: dataset,
         children: /*#__PURE__*/_jsx(InteractionProvider, {
-          children: /*#__PURE__*/_jsx(HighlightProvider, {
+          children: /*#__PURE__*/_jsx(HighlightedProvider, {
+            highlightedItem: highlightedItem,
+            onHighlightChange: onHighlightChange,
             children: /*#__PURE__*/_jsxs(ChartsSurface, {
               width: width,
               height: height,
@@ -64,7 +68,7 @@ const ChartContainer = /*#__PURE__*/React.forwardRef(function ChartContainer(pro
 process.env.NODE_ENV !== "production" ? ChartContainer.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,
@@ -88,6 +92,13 @@ process.env.NODE_ENV !== "production" ? ChartContainer.propTypes = {
    * The height of the chart in px.
    */
   height: PropTypes.number.isRequired,
+  /**
+   * 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.
@@ -100,6 +111,12 @@ process.env.NODE_ENV !== "production" ? ChartContainer.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/ChartsAxis/ChartsAxis.js

@@ -91,7 +91,7 @@ function ChartsAxis(props) {
 process.env.NODE_ENV !== "production" ? ChartsAxis.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"  |
   // ----------------------------------------------------------------------
   /**
    * Indicate which axis to display the bottom of the charts.

package/esm/ChartsAxisHighlight/ChartsAxisHighlight.js

@@ -97,7 +97,7 @@ function ChartsAxisHighlight(props) {
 process.env.NODE_ENV !== "production" ? ChartsAxisHighlight.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"  |
   // ----------------------------------------------------------------------
   x: PropTypes.oneOf(['band', 'line', 'none']),
   y: PropTypes.oneOf(['band', 'line', 'none'])

package/esm/ChartsClipPath/ChartsClipPath.js

@@ -38,7 +38,7 @@ function ChartsClipPath(props) {
 process.env.NODE_ENV !== "production" ? ChartsClipPath.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"  |
   // ----------------------------------------------------------------------
   id: PropTypes.string.isRequired,
   offset: PropTypes.shape({

package/esm/ChartsGrid/ChartsGrid.js

@@ -113,7 +113,7 @@ function ChartsGrid(props) {
 process.env.NODE_ENV !== "production" ? ChartsGrid.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"  |
   // ----------------------------------------------------------------------
   /**
    * Override or extend the styles applied to the component.

package/esm/ChartsLegend/ChartsLegend.js

@@ -69,7 +69,7 @@ function ChartsLegend(inProps) {
 process.env.NODE_ENV !== "production" ? ChartsLegend.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"  |
   // ----------------------------------------------------------------------
   /**
    * Override or extend the styles applied to the component.

package/esm/ChartsLegend/DefaultChartsLegend.js

@@ -204,7 +204,7 @@ function DefaultChartsLegend(props) {
 process.env.NODE_ENV !== "production" ? DefaultChartsLegend.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"  |
   // ----------------------------------------------------------------------
   /**
    * Override or extend the styles applied to the component.