@mui/x-charts 7.0.0-alpha.9 → 7.0.0-beta.1

package/ResponsiveChartContainer/ResponsiveChartContainer.js

@@ -0,0 +1,250 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ResponsiveChartContainer = void 0;
+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 _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedEffect"));
+var _ownerWindow = _interopRequireDefault(require("@mui/utils/ownerWindow"));
+var _styles = require("@mui/material/styles");
+var _ChartContainer = require("../ChartContainer");
+var _jsxRuntime = require("react/jsx-runtime");
+const _excluded = ["width", "height"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const useChartDimensions = (inWidth, inHeight) => {
+  const rootRef = React.useRef(null);
+  const displayError = React.useRef(false);
+  const [width, setWidth] = React.useState(0);
+  const [height, setHeight] = React.useState(0);
+
+  // Adaptation of the `computeSizeAndPublishResizeEvent` from the grid.
+  const computeSize = React.useCallback(() => {
+    const mainEl = rootRef?.current;
+    if (!mainEl) {
+      return;
+    }
+    const win = (0, _ownerWindow.default)(mainEl);
+    const computedStyle = win.getComputedStyle(mainEl);
+    const newHeight = Math.floor(parseFloat(computedStyle.height)) || 0;
+    const newWidth = Math.floor(parseFloat(computedStyle.width)) || 0;
+    setWidth(newWidth);
+    setHeight(newHeight);
+  }, []);
+  React.useEffect(() => {
+    // Ensure the error detection occurs after the first rendering.
+    displayError.current = true;
+  }, []);
+  (0, _useEnhancedEffect.default)(() => {
+    if (inWidth !== undefined && inHeight !== undefined) {
+      return () => {};
+    }
+    computeSize();
+    const elementToObserve = rootRef.current;
+    if (typeof ResizeObserver === 'undefined') {
+      return () => {};
+    }
+    let animationFrame;
+    const observer = new ResizeObserver(() => {
+      // See https://github.com/mui/mui-x/issues/8733
+      animationFrame = requestAnimationFrame(() => {
+        computeSize();
+      });
+    });
+    if (elementToObserve) {
+      observer.observe(elementToObserve);
+    }
+    return () => {
+      if (animationFrame) {
+        window.cancelAnimationFrame(animationFrame);
+      }
+      if (elementToObserve) {
+        observer.unobserve(elementToObserve);
+      }
+    };
+  }, [computeSize, inHeight, inWidth]);
+  if (process.env.NODE_ENV !== 'production') {
+    if (displayError.current && inWidth === undefined && width === 0) {
+      console.error(`MUI X Charts: ChartContainer does not have \`width\` prop, and its container has no \`width\` defined.`);
+      displayError.current = false;
+    }
+    if (displayError.current && inHeight === undefined && height === 0) {
+      console.error(`MUI X Charts: ChartContainer does not have \`height\` prop, and its container has no \`height\` defined.`);
+      displayError.current = false;
+    }
+  }
+  return [rootRef, inWidth ?? width, inHeight ?? height];
+};
+const ResizableContainer = (0, _styles.styled)('div', {
+  name: 'MuiResponsiveChart',
+  slot: 'Container'
+})(({
+  ownerState
+}) => ({
+  width: ownerState.width ?? '100%',
+  height: ownerState.height ?? '100%',
+  display: 'flex',
+  position: 'relative',
+  flexGrow: 1,
+  flexDirection: 'column',
+  alignItems: 'center',
+  justifyContent: 'center',
+  overflow: 'hidden',
+  '&>svg': {
+    width: '100%',
+    height: '100%'
+  }
+}));
+const ResponsiveChartContainer = exports.ResponsiveChartContainer = /*#__PURE__*/React.forwardRef(function ResponsiveChartContainer(props, ref) {
+  const {
+      width: inWidth,
+      height: inHeight
+    } = props,
+    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const [containerRef, width, height] = useChartDimensions(inWidth, inHeight);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(ResizableContainer, {
+    ref: containerRef,
+    ownerState: {
+      width: inWidth,
+      height: inHeight
+    },
+    children: width && height ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartContainer.ChartContainer, (0, _extends2.default)({}, other, {
+      width: width,
+      height: height,
+      ref: ref
+    })) : null
+  });
+});
+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"  |
+  // ----------------------------------------------------------------------
+  children: _propTypes.default.node,
+  className: _propTypes.default.string,
+  /**
+   * Color palette used to colorize multiple series.
+   * @default blueberryTwilightPalette
+   */
+  colors: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.string), _propTypes.default.func]),
+  /**
+   * An array of objects that can be used to populate series and axes data using their `dataKey` property.
+   */
+  dataset: _propTypes.default.arrayOf(_propTypes.default.object),
+  desc: _propTypes.default.string,
+  /**
+   * If `true`, the charts will not listen to the mouse move event.
+   * It might break interactive features, but will improve performance.
+   * @default false
+   */
+  disableAxisListener: _propTypes.default.bool,
+  /**
+   * The height of the chart in px. If not defined, it takes the height of the parent element.
+   * @default undefined
+   */
+  height: _propTypes.default.number,
+  /**
+   * 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.
+   * Accepts an object with the optional properties: `top`, `bottom`, `left`, and `right`.
+   * @default object Depends on the charts type.
+   */
+  margin: _propTypes.default.shape({
+    bottom: _propTypes.default.number,
+    left: _propTypes.default.number,
+    right: _propTypes.default.number,
+    top: _propTypes.default.number
+  }),
+  /**
+   * The array of series to display.
+   * Each type of series has its own specificity.
+   * Please refer to the appropriate docs page to learn more about it.
+   */
+  series: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
+  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({
+    height: _propTypes.default.number,
+    width: _propTypes.default.number,
+    x: _propTypes.default.number,
+    y: _propTypes.default.number
+  }),
+  /**
+   * The width of the chart in px. If not defined, it takes the width of the parent element.
+   * @default undefined
+   */
+  width: _propTypes.default.number,
+  /**
+   * The configuration of the x-axes.
+   * If not provided, a default axis config is used with id set to `DEFAULT_X_AXIS_KEY`.
+   */
+  xAxis: _propTypes.default.arrayOf(_propTypes.default.shape({
+    axisId: _propTypes.default.string,
+    classes: _propTypes.default.object,
+    data: _propTypes.default.array,
+    dataKey: _propTypes.default.string,
+    disableLine: _propTypes.default.bool,
+    disableTicks: _propTypes.default.bool,
+    fill: _propTypes.default.string,
+    hideTooltip: _propTypes.default.bool,
+    id: _propTypes.default.string,
+    label: _propTypes.default.string,
+    labelFontSize: _propTypes.default.number,
+    labelStyle: _propTypes.default.object,
+    max: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
+    min: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
+    position: _propTypes.default.oneOf(['bottom', 'left', 'right', 'top']),
+    scaleType: _propTypes.default.oneOf(['band', 'linear', 'log', 'point', 'pow', 'sqrt', 'time', 'utc']),
+    slotProps: _propTypes.default.object,
+    slots: _propTypes.default.object,
+    stroke: _propTypes.default.string,
+    tickFontSize: _propTypes.default.number,
+    tickInterval: _propTypes.default.oneOfType([_propTypes.default.oneOf(['auto']), _propTypes.default.array, _propTypes.default.func]),
+    tickLabelInterval: _propTypes.default.oneOfType([_propTypes.default.oneOf(['auto']), _propTypes.default.func]),
+    tickLabelStyle: _propTypes.default.object,
+    tickMaxStep: _propTypes.default.number,
+    tickMinStep: _propTypes.default.number,
+    tickNumber: _propTypes.default.number,
+    tickSize: _propTypes.default.number,
+    valueFormatter: _propTypes.default.func
+  })),
+  /**
+   * The configuration of the y-axes.
+   * If not provided, a default axis config is used with id set to `DEFAULT_Y_AXIS_KEY`.
+   */
+  yAxis: _propTypes.default.arrayOf(_propTypes.default.shape({
+    axisId: _propTypes.default.string,
+    classes: _propTypes.default.object,
+    data: _propTypes.default.array,
+    dataKey: _propTypes.default.string,
+    disableLine: _propTypes.default.bool,
+    disableTicks: _propTypes.default.bool,
+    fill: _propTypes.default.string,
+    hideTooltip: _propTypes.default.bool,
+    id: _propTypes.default.string,
+    label: _propTypes.default.string,
+    labelFontSize: _propTypes.default.number,
+    labelStyle: _propTypes.default.object,
+    max: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
+    min: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
+    position: _propTypes.default.oneOf(['bottom', 'left', 'right', 'top']),
+    scaleType: _propTypes.default.oneOf(['band', 'linear', 'log', 'point', 'pow', 'sqrt', 'time', 'utc']),
+    slotProps: _propTypes.default.object,
+    slots: _propTypes.default.object,
+    stroke: _propTypes.default.string,
+    tickFontSize: _propTypes.default.number,
+    tickInterval: _propTypes.default.oneOfType([_propTypes.default.oneOf(['auto']), _propTypes.default.array, _propTypes.default.func]),
+    tickLabelInterval: _propTypes.default.oneOfType([_propTypes.default.oneOf(['auto']), _propTypes.default.func]),
+    tickLabelStyle: _propTypes.default.object,
+    tickMaxStep: _propTypes.default.number,
+    tickMinStep: _propTypes.default.number,
+    tickNumber: _propTypes.default.number,
+    tickSize: _propTypes.default.number,
+    valueFormatter: _propTypes.default.func
+  }))
+} : void 0;

package/ResponsiveChartContainer/index.d.ts

@@ -1,15 +1 @@
-import * as React from 'react';
-import { ChartContainerProps } from '../ChartContainer';
-export interface ResponsiveChartContainerProps extends Omit<ChartContainerProps, 'width' | 'height'> {
-    /**
-     * The width of the chart in px. If not defined, it takes the width of the parent element.
-     * @default undefined
-     */
-    width?: number;
-    /**
-     * The height of the chart in px. If not defined, it takes the height of the parent element.
-     * @default undefined
-     */
-    height?: number;
-}
-export declare const ResponsiveChartContainer: React.ForwardRefExoticComponent<ResponsiveChartContainerProps & React.RefAttributes<unknown>>;
+export * from './ResponsiveChartContainer';

package/ResponsiveChartContainer/index.js

@@ -1,121 +1,16 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ResponsiveChartContainer = void 0;
-var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
-var React = _interopRequireWildcard(require("react"));
-var _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedEffect"));
-var _ownerWindow = _interopRequireDefault(require("@mui/utils/ownerWindow"));
-var _styles = require("@mui/material/styles");
-var _ChartContainer = require("../ChartContainer");
-var _jsxRuntime = require("react/jsx-runtime");
-const _excluded = ["width", "height"];
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-const useChartDimensions = (inWidth, inHeight) => {
-  const rootRef = React.useRef(null);
-  const displayError = React.useRef(false);
-  const [width, setWidth] = React.useState(0);
-  const [height, setHeight] = React.useState(0);
-
-  // Adaptation of the `computeSizeAndPublishResizeEvent` from the grid.
-  const computeSize = React.useCallback(() => {
-    const mainEl = rootRef?.current;
-    if (!mainEl) {
-      return;
-    }
-    const win = (0, _ownerWindow.default)(mainEl);
-    const computedStyle = win.getComputedStyle(mainEl);
-    const newHeight = Math.floor(parseFloat(computedStyle.height)) || 0;
-    const newWidth = Math.floor(parseFloat(computedStyle.width)) || 0;
-    setWidth(newWidth);
-    setHeight(newHeight);
-  }, []);
-  React.useEffect(() => {
-    // Ensure the error detection occurs after the first rendering.
-    displayError.current = true;
-  }, []);
-  (0, _useEnhancedEffect.default)(() => {
-    if (inWidth !== undefined && inHeight !== undefined) {
-      return () => {};
-    }
-    computeSize();
-    const elementToObserve = rootRef.current;
-    if (typeof ResizeObserver === 'undefined') {
-      return () => {};
-    }
-    let animationFrame;
-    const observer = new ResizeObserver(() => {
-      // See https://github.com/mui/mui-x/issues/8733
-      animationFrame = requestAnimationFrame(() => {
-        computeSize();
-      });
-    });
-    if (elementToObserve) {
-      observer.observe(elementToObserve);
-    }
-    return () => {
-      if (animationFrame) {
-        window.cancelAnimationFrame(animationFrame);
-      }
-      if (elementToObserve) {
-        observer.unobserve(elementToObserve);
-      }
-    };
-  }, [computeSize, inHeight, inWidth]);
-  if (process.env.NODE_ENV !== 'production') {
-    if (displayError.current && inWidth === undefined && width === 0) {
-      console.error(`MUI X Charts: ChartContainer does not have \`width\` prop, and its container has no \`width\` defined.`);
-      displayError.current = false;
-    }
-    if (displayError.current && inHeight === undefined && height === 0) {
-      console.error(`MUI X Charts: ChartContainer does not have \`height\` prop, and its container has no \`height\` defined.`);
-      displayError.current = false;
+var _ResponsiveChartContainer = require("./ResponsiveChartContainer");
+Object.keys(_ResponsiveChartContainer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ResponsiveChartContainer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ResponsiveChartContainer[key];
     }
-  }
-  return [rootRef, inWidth ?? width, inHeight ?? height];
-};
-const ResizableContainer = (0, _styles.styled)('div', {
-  name: 'MuiResponsiveChart',
-  slot: 'Container'
-})(({
-  ownerState
-}) => ({
-  width: ownerState.width ?? '100%',
-  height: ownerState.height ?? '100%',
-  display: 'flex',
-  position: 'relative',
-  flexGrow: 1,
-  flexDirection: 'column',
-  alignItems: 'center',
-  justifyContent: 'center',
-  overflow: 'hidden',
-  '&>svg': {
-    width: '100%',
-    height: '100%'
-  }
-}));
-const ResponsiveChartContainer = exports.ResponsiveChartContainer = /*#__PURE__*/React.forwardRef(function ResponsiveChartContainer(props, ref) {
-  const {
-      width: inWidth,
-      height: inHeight
-    } = props,
-    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
-  const [containerRef, width, height] = useChartDimensions(inWidth, inHeight);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(ResizableContainer, {
-    ref: containerRef,
-    ownerState: {
-      width: inWidth,
-      height: inHeight
-    },
-    children: width && height ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartContainer.ChartContainer, (0, _extends2.default)({}, other, {
-      width: width,
-      height: height,
-      ref: ref
-    })) : null
   });
 });

package/ScatterChart/Scatter.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { DefaultizedScatterSeriesType } from '../models/seriesType/scatter';
+import { DefaultizedScatterSeriesType, ScatterItemIdentifier } from '../models/seriesType/scatter';
 import { D3Scale } from '../models/axis';
 export interface ScatterProps {
     series: DefaultizedScatterSeriesType;
@@ -7,6 +7,12 @@ export interface ScatterProps {
     yScale: D3Scale;
     markerSize: number;
     color: string;
+    /**
+     * Callback fired when clicking on a scatter item.
+     * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
+     * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+     */
+    onItemClick?: (event: React.MouseEvent<SVGElement, MouseEvent>, scatterItemIdentifier: ScatterItemIdentifier) => void;
 }
 /**
  * Demos:

package/ScatterChart/Scatter.js

@@ -30,7 +30,8 @@ function Scatter(props) {
     xScale,
     yScale,
     color,
-    markerSize
+    markerSize,
+    onItemClick
   } = props;
   const highlightScope = React.useMemo(() => (0, _extends2.default)({
     highlighted: 'item',
@@ -70,7 +71,8 @@ function Scatter(props) {
           isHighlighted,
           isFaded: !isHighlighted && (0, _useInteractionItemProps.getIsFaded)(item, pointCtx, highlightScope),
           interactionProps: getInteractionItemProps(pointCtx),
-          id: scatterPoint.id
+          id: scatterPoint.id,
+          dataIndex: i
         });
       }
     }
@@ -83,7 +85,13 @@ function Scatter(props) {
       r: (dataPoint.isHighlighted ? 1.2 : 1) * markerSize,
       transform: `translate(${dataPoint.x}, ${dataPoint.y})`,
       fill: color,
-      opacity: dataPoint.isFaded && 0.3 || 1
+      opacity: dataPoint.isFaded && 0.3 || 1,
+      onClick: onItemClick && (event => onItemClick(event, {
+        type: 'scatter',
+        seriesId: series.id,
+        dataIndex: dataPoint.dataIndex
+      })),
+      cursor: onItemClick ? 'pointer' : 'unset'
     }, dataPoint.interactionProps), dataPoint.id))
   });
 }
@@ -94,26 +102,13 @@ process.env.NODE_ENV !== "production" ? Scatter.propTypes = {
   // ----------------------------------------------------------------------
   color: _propTypes.default.string.isRequired,
   markerSize: _propTypes.default.number.isRequired,
-  series: _propTypes.default.shape({
-    color: _propTypes.default.string.isRequired,
-    data: _propTypes.default.arrayOf(_propTypes.default.shape({
-      id: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]).isRequired,
-      x: _propTypes.default.number.isRequired,
-      y: _propTypes.default.number.isRequired
-    })).isRequired,
-    disableHover: _propTypes.default.bool,
-    highlightScope: _propTypes.default.shape({
-      faded: _propTypes.default.oneOf(['global', 'none', 'series']),
-      highlighted: _propTypes.default.oneOf(['item', 'none', 'series'])
-    }),
-    id: _propTypes.default.string.isRequired,
-    label: _propTypes.default.string,
-    markerSize: _propTypes.default.number,
-    type: _propTypes.default.oneOf(['scatter']).isRequired,
-    valueFormatter: _propTypes.default.func.isRequired,
-    xAxisKey: _propTypes.default.string,
-    yAxisKey: _propTypes.default.string
-  }).isRequired,
+  /**
+   * Callback fired when clicking on a scatter item.
+   * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
+   * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+   */
+  onItemClick: _propTypes.default.func,
+  series: _propTypes.default.object.isRequired,
   xScale: _propTypes.default.func.isRequired,
   yScale: _propTypes.default.func.isRequired
 } : void 0;

package/ScatterChart/ScatterChart.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { ScatterPlotSlotProps, ScatterPlotSlots } from './ScatterPlot';
+import { ScatterPlotProps, ScatterPlotSlotProps, ScatterPlotSlots } from './ScatterPlot';
 import { ResponsiveChartContainerProps } from '../ResponsiveChartContainer';
 import { ChartsAxisProps } from '../ChartsAxis';
 import { ScatterSeriesType } from '../models/seriesType/scatter';
@@ -13,7 +13,7 @@ export interface ScatterChartSlots extends ChartsAxisSlots, ScatterPlotSlots, Ch
 }
 export interface ScatterChartSlotProps extends ChartsAxisSlotProps, ScatterPlotSlotProps, ChartsLegendSlotProps, ChartsTooltipSlotProps {
 }
-export interface ScatterChartProps extends Omit<ResponsiveChartContainerProps, 'series'>, Omit<ChartsAxisProps, 'slots' | 'slotProps'>, ChartsVoronoiHandlerProps {
+export interface ScatterChartProps extends Omit<ResponsiveChartContainerProps, 'series'>, Omit<ChartsAxisProps, 'slots' | 'slotProps'>, Omit<ChartsVoronoiHandlerProps, 'onItemClick'> {
     series: MakeOptional<ScatterSeriesType, 'type'>[];
     tooltip?: ChartsTooltipProps;
     axisHighlight?: ChartsAxisHighlightProps;
@@ -36,6 +36,12 @@ export interface ScatterChartProps extends Omit<ResponsiveChartContainerProps, '
      * @default {}
      */
     slotProps?: ScatterChartSlotProps;
+    /**
+     * 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`.
+     * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+     */
+    onItemClick?: ScatterPlotProps['onItemClick'] | ChartsVoronoiHandlerProps['onItemClick'];
 }
 /**
  * Demos:

package/ScatterChart/ScatterChart.js

@@ -47,6 +47,7 @@ const ScatterChart = exports.ScatterChart = /*#__PURE__*/React.forwardRef(functi
     leftAxis,
     rightAxis,
     bottomAxis,
+    onItemClick,
     children,
     slots,
     slotProps
@@ -64,7 +65,8 @@ const ScatterChart = exports.ScatterChart = /*#__PURE__*/React.forwardRef(functi
     yAxis: yAxis,
     sx: sx,
     children: [!disableVoronoi && /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsVoronoiHandler.ChartsVoronoiHandler, {
-      voronoiMaxRadius: voronoiMaxRadius
+      voronoiMaxRadius: voronoiMaxRadius,
+      onItemClick: onItemClick
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsAxis.ChartsAxis, {
       topAxis: topAxis,
       leftAxis: leftAxis,
@@ -74,7 +76,8 @@ const ScatterChart = exports.ScatterChart = /*#__PURE__*/React.forwardRef(functi
       slotProps: slotProps
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ScatterPlot.ScatterPlot, {
       slots: slots,
-      slotProps: slotProps
+      slotProps: slotProps,
+      onItemClick: disableVoronoi ? onItemClick : undefined
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsLegend.ChartsLegend, (0, _extends2.default)({}, legend, {
       slots: slots,
       slotProps: slotProps
@@ -203,6 +206,12 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
     right: _propTypes.default.number,
     top: _propTypes.default.number
   }),
+  /**
+   * 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`.
+   * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+   */
+  onItemClick: _propTypes.default.func,
   /**
    * Indicate which axis to display the right of the charts.
    * Can be a string (the id of the axis) or an object `ChartsYAxisProps`.
@@ -230,26 +239,7 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
     tickNumber: _propTypes.default.number,
     tickSize: _propTypes.default.number
   }), _propTypes.default.string]),
-  series: _propTypes.default.arrayOf(_propTypes.default.shape({
-    color: _propTypes.default.string,
-    data: _propTypes.default.arrayOf(_propTypes.default.shape({
-      id: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]).isRequired,
-      x: _propTypes.default.number.isRequired,
-      y: _propTypes.default.number.isRequired
-    })).isRequired,
-    disableHover: _propTypes.default.bool,
-    highlightScope: _propTypes.default.shape({
-      faded: _propTypes.default.oneOf(['global', 'none', 'series']),
-      highlighted: _propTypes.default.oneOf(['item', 'none', 'series'])
-    }),
-    id: _propTypes.default.string,
-    label: _propTypes.default.string,
-    markerSize: _propTypes.default.number,
-    type: _propTypes.default.oneOf(['scatter']),
-    valueFormatter: _propTypes.default.func,
-    xAxisKey: _propTypes.default.string,
-    yAxisKey: _propTypes.default.string
-  })).isRequired,
+  series: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
   /**
    * The props used for each component slot.
    * @default {}

package/ScatterChart/ScatterPlot.d.ts

@@ -6,7 +6,7 @@ export interface ScatterPlotSlots {
 export interface ScatterPlotSlotProps {
     scatter?: Partial<ScatterProps>;
 }
-export interface ScatterPlotProps {
+export interface ScatterPlotProps extends Pick<ScatterProps, 'onItemClick'> {
     /**
      * Overridable component slots.
      * @default {}

package/ScatterChart/ScatterPlot.js

@@ -27,7 +27,8 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
 function ScatterPlot(props) {
   const {
     slots,
-    slotProps
+    slotProps,
+    onItemClick
   } = props;
   const seriesData = React.useContext(_SeriesContextProvider.SeriesContext).scatter;
   const axisData = React.useContext(_CartesianContextProvider.CartesianContext);
@@ -63,7 +64,8 @@ function ScatterPlot(props) {
         yScale: yScale,
         color: color,
         markerSize: markerSize ?? 4,
-        series: series[seriesId]
+        series: series[seriesId],
+        onItemClick: onItemClick
       }, slotProps?.scatter), id);
     })
   });
@@ -73,6 +75,12 @@ process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes = {
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "yarn proptypes"  |
   // ----------------------------------------------------------------------
+  /**
+   * Callback fired when clicking on a scatter item.
+   * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
+   * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+   */
+  onItemClick: _propTypes.default.func,
   /**
    * The props used for each component slot.
    * @default {}

package/SparkLineChart/SparkLineChart.js

@@ -94,9 +94,11 @@ const SparkLineChart = exports.SparkLineChart = /*#__PURE__*/React.forwardRef(fu
       }
     }), plotType === 'line' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_LineChart.AreaPlot, {
+        skipAnimation: true,
         slots: slots,
         slotProps: slotProps
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_LineChart.LinePlot, {
+        skipAnimation: true,
         slots: slots,
         slotProps: slotProps
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_LineChart.LineHighlightPlot, {

package/context/DrawingProvider.d.ts

@@ -33,7 +33,12 @@ export type DrawingArea = {
      */
     height: number;
 };
-export declare const DrawingContext: React.Context<DrawingArea>;
+export declare const DrawingContext: React.Context<DrawingArea & {
+    /**
+     * A random id used to distinguish each chart on the same page.
+     */
+    chartId: string;
+}>;
 export declare const SVGContext: React.Context<React.RefObject<SVGSVGElement>>;
 /**
  * API: