@mui/x-charts 8.11.3 → 8.13.0

package/RadarChart/RadarDataProvider/RadarDataProvider.d.ts

@@ -1,12 +1,12 @@
 import * as React from 'react';
 import { MakeOptional } from '@mui/x-internals/types';
-import { RadarChartPluginsSignatures } from "../RadarChart.plugins.js";
+import { RadarChartPluginSignatures } from "../RadarChart.plugins.js";
 import { RadarSeriesType } from "../../models/seriesType/radar.js";
 import { ChartDataProviderProps } from "../../ChartDataProvider/index.js";
 import { RadarConfig } from "./radar.types.js";
 import { ChartAnyPluginSignature } from "../../internals/plugins/models/plugin.js";
 export type RadarSeries = MakeOptional<RadarSeriesType, 'type'>;
-export type RadarDataProviderProps<TSignatures extends readonly ChartAnyPluginSignature[] = RadarChartPluginsSignatures> = Omit<ChartDataProviderProps<'radar', TSignatures>, 'series' | 'rotationAxis' | 'radiusAxis' | 'dataset' | 'experimentalFeatures'> & {
+export type RadarDataProviderProps<TSignatures extends readonly ChartAnyPluginSignature[] = RadarChartPluginSignatures> = Omit<ChartDataProviderProps<'radar', TSignatures>, 'series' | 'rotationAxis' | 'radiusAxis' | 'dataset' | 'experimentalFeatures'> & {
   /**
    * The series to display in the bar chart.
    * An array of [[RadarSeries]] objects.
@@ -22,5 +22,5 @@ export type RadarDataProviderProps<TSignatures extends readonly ChartAnyPluginSi
    */
   highlight?: 'axis' | 'series' | 'none';
 };
-declare function RadarDataProvider<TSignatures extends readonly ChartAnyPluginSignature[] = RadarChartPluginsSignatures>(props: RadarDataProviderProps<TSignatures>): React.JSX.Element;
+declare function RadarDataProvider<TSignatures extends readonly ChartAnyPluginSignature[] = RadarChartPluginSignatures>(props: RadarDataProviderProps<TSignatures>): React.JSX.Element;
 export { RadarDataProvider };

package/RadarChart/index.d.ts

@@ -15,4 +15,5 @@ export * from "./RadarGrid/index.js";
 export * from "./RadarAxis/index.js";
 export * from "./RadarAxisHighlight/index.js";
 export * from "./RadarMetricLabels/index.js";
-export * from "./RadarSeriesPlot/index.js";
+export * from "./RadarSeriesPlot/index.js";
+export * from "./RadarChart.plugins.js";

package/RadarChart/index.js

@@ -84,6 +84,18 @@ Object.keys(_RadarSeriesPlot).forEach(function (key) {
     }
   });
 });
+var _RadarChart2 = require("./RadarChart.plugins");
+Object.keys(_RadarChart2).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _RadarChart2[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _RadarChart2[key];
+    }
+  });
+});
 /**
  * @deprecated radar chart is now stable, import `RadarChart` instead
  */

package/RadarChart/useRadarChartProps.d.ts

@@ -5,7 +5,7 @@ import type { ChartsWrapperProps } from "../ChartsWrapper/index.js";
 import { RadarDataProviderProps } from "./RadarDataProvider/RadarDataProvider.js";
 import { ChartsSurfaceProps } from "../ChartsSurface/index.js";
 import { RadarGridProps } from "./RadarGrid/index.js";
-import { RadarChartPluginsSignatures } from "./RadarChart.plugins.js";
+import { RadarChartPluginSignatures } from "./RadarChart.plugins.js";
 import { RadarSeriesAreaProps, RadarSeriesMarksProps } from "./RadarSeriesPlot/index.js";
 /**
  * A helper function that extracts RadarChartProps from the input props
@@ -18,7 +18,7 @@ export declare const useRadarChartProps: (props: RadarChartProps) => {
   highlight: "none" | "series" | "axis";
   chartsWrapperProps: Omit<ChartsWrapperProps, "children">;
   chartsSurfaceProps: ChartsSurfaceProps;
-  radarDataProviderProps: RadarDataProviderProps<RadarChartPluginsSignatures>;
+  radarDataProviderProps: RadarDataProviderProps<RadarChartPluginSignatures>;
   radarGrid: RadarGridProps;
   radarSeriesAreaProps: RadarSeriesAreaProps;
   radarSeriesMarksProps: RadarSeriesMarksProps;

package/ScatterChart/BatchScatter.d.ts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import { DefaultizedScatterSeriesType } from "../models/seriesType/scatter.js";
+import { D3Scale } from "../models/axis.js";
+import { ScatterClasses } from "./scatterClasses.js";
+import { ColorGetter } from "../internals/plugins/models/seriesConfig/index.js";
+export interface BatchScatterProps {
+  series: DefaultizedScatterSeriesType;
+  xScale: D3Scale;
+  yScale: D3Scale;
+  color: string;
+  colorGetter?: ColorGetter<'scatter'>;
+  classes?: Partial<ScatterClasses>;
+}
+export interface BatchScatterPathsProps {
+  series: DefaultizedScatterSeriesType;
+  xScale: D3Scale;
+  yScale: D3Scale;
+  color: string;
+  colorGetter?: ColorGetter<'scatter'>;
+  markerSize: number;
+}
+/**
+ * @internal
+ * A batch version of the Scatter component that uses SVG paths to render points.
+ * This component is optimized for performance and is suitable for rendering large datasets, but has limitations. Some of the limitations include:
+ * - Limited CSS styling;
+ * - Overriding the `marker` slot is not supported;
+ * - Highlight style must not contain opacity.
+ *
+ * You can read about all the limitations [here](https://mui.com/x/react-charts/scatter/#performance).
+ */
+export declare function BatchScatter(props: BatchScatterProps): React.JSX.Element;

package/ScatterChart/BatchScatter.js

@@ -0,0 +1,171 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BatchScatter = BatchScatter;
+var React = _interopRequireWildcard(require("react"));
+var _styles = require("@mui/material/styles");
+var _scatterClasses = require("./scatterClasses");
+var _ChartProvider = require("../context/ChartProvider");
+var _useScale = require("../hooks/useScale");
+var _useSelector = require("../internals/store/useSelector");
+var _useChartHighlight = require("../internals/plugins/featurePlugins/useChartHighlight");
+var _jsxRuntime = require("react/jsx-runtime");
+const MAX_POINTS_PER_PATH = 1000;
+/* In an SVG arc, if the arc starts and ends at the same point, it is not rendered, so we add a tiny
+ * value to one of the coordinates to ensure that the arc is rendered. */
+const ALMOST_ZERO = 0.01;
+function appendAtKey(map, key, value) {
+  let bucket = map.get(key);
+  if (!bucket) {
+    bucket = [value];
+    map.set(key, bucket);
+  } else {
+    bucket.push(value);
+  }
+  return bucket;
+}
+function createPath(x, y, markerSize) {
+  return `M${x - markerSize} ${y} a${markerSize} ${markerSize} 0 1 1 0 ${ALMOST_ZERO}`;
+}
+function useCreatePaths(seriesData, markerSize, xScale, yScale, color, colorGetter) {
+  const {
+    instance
+  } = (0, _ChartProvider.useChartContext)();
+  const getXPosition = (0, _useScale.getValueToPositionMapper)(xScale);
+  const getYPosition = (0, _useScale.getValueToPositionMapper)(yScale);
+  const paths = new Map();
+  const temporaryPaths = new Map();
+  for (let i = 0; i < seriesData.length; i += 1) {
+    const scatterPoint = seriesData[i];
+    const x = getXPosition(scatterPoint.x);
+    const y = getYPosition(scatterPoint.y);
+    if (!instance.isPointInside(x, y)) {
+      continue;
+    }
+    const path = createPath(x, y, markerSize);
+    const fill = colorGetter ? colorGetter(i) : color;
+    const tempPath = appendAtKey(temporaryPaths, fill, path);
+    if (tempPath.length >= MAX_POINTS_PER_PATH) {
+      appendAtKey(paths, fill, tempPath.join(''));
+      temporaryPaths.delete(fill);
+    }
+  }
+  for (const [fill, tempPath] of temporaryPaths.entries()) {
+    if (tempPath.length > 0) {
+      appendAtKey(paths, fill, tempPath.join(''));
+    }
+  }
+  return paths;
+}
+function BatchScatterPaths(props) {
+  const {
+    series,
+    xScale,
+    yScale,
+    color,
+    colorGetter,
+    markerSize
+  } = props;
+  const paths = useCreatePaths(series.data, markerSize, xScale, yScale, color, colorGetter);
+  const children = [];
+  let i = 0;
+  for (const [fill, dArray] of paths.entries()) {
+    for (const d of dArray) {
+      children.push(/*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
+        fill: fill,
+        d: d
+      }, i));
+      i += 1;
+    }
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(React.Fragment, {
+    children: children
+  });
+}
+const MemoBatchScatterPaths = /*#__PURE__*/React.memo(BatchScatterPaths);
+if (process.env.NODE_ENV !== "production") MemoBatchScatterPaths.displayName = "MemoBatchScatterPaths";
+const Group = (0, _styles.styled)('g')({
+  '&[data-faded="true"]': {
+    opacity: 0.3
+  },
+  '& path': {
+    /* The browser must do hit testing to know which element a pointer is interacting with.
+     * With many data points, we create many paths causing significant time to be spent in the hit test phase.
+     * To fix this issue, we disable pointer events for the descendant paths.
+     *
+     * Ideally, users should be able to override this in case they need pointer events to be enabled,
+     * but it can affect performance negatively, especially with many data points. */
+    pointerEvents: 'none'
+  }
+});
+
+/**
+ * @internal
+ * A batch version of the Scatter component that uses SVG paths to render points.
+ * This component is optimized for performance and is suitable for rendering large datasets, but has limitations. Some of the limitations include:
+ * - Limited CSS styling;
+ * - Overriding the `marker` slot is not supported;
+ * - Highlight style must not contain opacity.
+ *
+ * You can read about all the limitations [here](https://mui.com/x/react-charts/scatter/#performance).
+ */
+function BatchScatter(props) {
+  const {
+    series,
+    xScale,
+    yScale,
+    color,
+    colorGetter,
+    classes: inClasses
+  } = props;
+  const {
+    store
+  } = (0, _ChartProvider.useChartContext)();
+  const isSeriesHighlighted = (0, _useSelector.useSelector)(store, _useChartHighlight.selectorChartIsSeriesHighlighted, [series.id]);
+  const isSeriesFaded = (0, _useSelector.useSelector)(store, _useChartHighlight.selectorChartIsSeriesFaded, [series.id]);
+  const seriesHighlightedItem = (0, _useSelector.useSelector)(store, _useChartHighlight.selectorChartSeriesHighlightedItem, [series.id]);
+  const seriesUnfadedItem = (0, _useSelector.useSelector)(store, _useChartHighlight.selectorChartSeriesUnfadedItem, [series.id]);
+  const highlightedModifier = 1.2;
+  const markerSize = series.markerSize * (isSeriesHighlighted ? highlightedModifier : 1);
+  const classes = (0, _scatterClasses.useUtilityClasses)(inClasses);
+  const siblings = [];
+  if (seriesHighlightedItem != null) {
+    const datum = series.data[seriesHighlightedItem];
+    const getXPosition = (0, _useScale.getValueToPositionMapper)(xScale);
+    const getYPosition = (0, _useScale.getValueToPositionMapper)(yScale);
+    siblings.push(/*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
+      fill: colorGetter ? colorGetter(seriesHighlightedItem) : color,
+      "data-highlighted": true,
+      d: createPath(getXPosition(datum.x), getYPosition(datum.y), markerSize * highlightedModifier)
+    }, `highlighted-${series.id}`));
+  }
+  if (seriesUnfadedItem != null) {
+    const datum = series.data[seriesUnfadedItem];
+    const getXPosition = (0, _useScale.getValueToPositionMapper)(xScale);
+    const getYPosition = (0, _useScale.getValueToPositionMapper)(yScale);
+    siblings.push(/*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
+      fill: colorGetter ? colorGetter(seriesUnfadedItem) : color,
+      d: createPath(getXPosition(datum.x), getYPosition(datum.y), markerSize)
+    }, `unfaded-${series.id}`));
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(Group, {
+      className: classes.root,
+      "data-series": series.id,
+      "data-faded": isSeriesFaded || undefined,
+      "data-highlighted": isSeriesHighlighted || undefined,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(MemoBatchScatterPaths, {
+        series: series,
+        xScale: xScale,
+        yScale: yScale,
+        color: color,
+        colorGetter: colorGetter,
+        markerSize: markerSize
+      })
+    }), siblings]
+  });
+}

package/ScatterChart/Scatter.js

@@ -16,11 +16,12 @@ var _useInteractionItemProps = require("../hooks/useInteractionItemProps");
 var _useStore = require("../internals/store/useStore");
 var _useSelector = require("../internals/store/useSelector");
 var _useItemHighlightedGetter = require("../hooks/useItemHighlightedGetter");
-var _useChartVoronoi = require("../internals/plugins/featurePlugins/useChartVoronoi");
+var _useChartClosestPoint = require("../internals/plugins/featurePlugins/useChartClosestPoint");
 var _ScatterMarker = require("./ScatterMarker");
 var _scatterClasses = require("./scatterClasses");
 var _useScatterPlotData = require("./useScatterPlotData");
 var _ChartProvider = require("../context/ChartProvider");
+var _useIsItemFocusedGetter = require("../hooks/useIsItemFocusedGetter");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["ownerState"];
 /**
@@ -49,12 +50,13 @@ function Scatter(props) {
     instance
   } = (0, _ChartProvider.useChartContext)();
   const store = (0, _useStore.useStore)();
-  const isVoronoiEnabled = (0, _useSelector.useSelector)(store, _useChartVoronoi.selectorChartsVoronoiIsVoronoiEnabled);
+  const isVoronoiEnabled = (0, _useSelector.useSelector)(store, _useChartClosestPoint.selectorChartsIsVoronoiEnabled);
   const skipInteractionHandlers = isVoronoiEnabled || series.disableHover;
   const {
     isFaded,
     isHighlighted
   } = (0, _useItemHighlightedGetter.useItemHighlightedGetter)();
+  const isFocused = (0, _useIsItemFocusedGetter.useIsItemFocusedGetter)();
   const scatterPlotData = (0, _useScatterPlotData.useScatterPlotData)(series, xScale, yScale, instance.isPointInside);
   const Marker = slots?.marker ?? _ScatterMarker.ScatterMarker;
   const _useSlotProps = (0, _useSlotProps2.default)({
@@ -71,12 +73,17 @@ function Scatter(props) {
   return /*#__PURE__*/(0, _jsxRuntime.jsx)("g", {
     "data-series": series.id,
     className: classes.root,
-    children: scatterPlotData.map((dataPoint, i) => {
+    children: scatterPlotData.map(dataPoint => {
       const isItemHighlighted = isHighlighted(dataPoint);
       const isItemFaded = !isItemHighlighted && isFaded(dataPoint);
+      const isItemFocused = isFocused({
+        seriesType: 'scatter',
+        seriesId: series.id,
+        dataIndex: dataPoint.dataIndex
+      });
       return /*#__PURE__*/(0, _jsxRuntime.jsx)(Marker, (0, _extends2.default)({
         dataIndex: dataPoint.dataIndex,
-        color: colorGetter ? colorGetter(i) : color,
+        color: colorGetter ? colorGetter(dataPoint.dataIndex) : color,
         isHighlighted: isItemHighlighted,
         isFaded: isItemFaded,
         x: dataPoint.x,
@@ -87,7 +94,8 @@ function Scatter(props) {
           dataIndex: dataPoint.dataIndex
         })),
         "data-highlighted": isItemHighlighted || undefined,
-        "data-faded": isItemFaded || undefined
+        "data-faded": isItemFaded || undefined,
+        "data-focused": isItemFocused || undefined
       }, skipInteractionHandlers ? undefined : (0, _useInteractionItemProps.getInteractionItemProps)(instance, dataPoint), markerProps), dataPoint.id ?? dataPoint.dataIndex);
     })
   });

package/ScatterChart/ScatterChart.d.ts

@@ -13,8 +13,8 @@ import { ChartsOverlayProps, ChartsOverlaySlotProps, ChartsOverlaySlots } from "
 import { ChartsAxisHighlightProps } from "../ChartsAxisHighlight/index.js";
 import { ChartsAxisSlots, ChartsAxisSlotProps } from "../models/axis.js";
 import { ChartsGridProps } from "../ChartsGrid/index.js";
-import { UseChartVoronoiSignature } from "../internals/plugins/featurePlugins/useChartVoronoi/index.js";
-import { ScatterChartPluginsSignatures } from "./ScatterChart.plugins.js";
+import { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";
+import { ScatterChartPluginSignatures } from "./ScatterChart.plugins.js";
 export interface ScatterChartSlots extends ChartsAxisSlots, ScatterPlotSlots, ChartsLegendSlots, ChartsOverlaySlots, ChartsTooltipSlots, ChartsToolbarSlots, Partial<ChartsSlots> {}
 export interface ScatterChartSlotProps extends ChartsAxisSlotProps, ScatterPlotSlotProps, ChartsLegendSlotProps, ChartsOverlaySlotProps, Omit<ChartsTooltipSlotProps, 'tooltip'>, ChartsToolbarSlotProps, Partial<ChartsSlotProps> {
   /**
@@ -24,7 +24,7 @@ export interface ScatterChartSlotProps extends ChartsAxisSlotProps, ScatterPlotS
   tooltip?: Partial<ChartsTooltipProps<'item' | 'none'>>;
 }
 export type ScatterSeries = MakeOptional<ScatterSeriesType, 'type'>;
-export interface ScatterChartProps extends Omit<ChartContainerProps<'scatter', ScatterChartPluginsSignatures>, 'series' | 'plugins' | 'onItemClick' | 'experimentalFeatures' | 'highlightedAxis' | 'onHighlightedAxisChange'>, Omit<ChartsAxisProps, 'slots' | 'slotProps'>, Omit<ChartsOverlayProps, 'slots' | 'slotProps'> {
+export interface ScatterChartProps extends Omit<ChartContainerProps<'scatter', ScatterChartPluginSignatures>, 'series' | 'plugins' | 'onItemClick' | 'experimentalFeatures' | 'highlightedAxis' | 'onHighlightedAxisChange'>, Omit<ChartsAxisProps, 'slots' | 'slotProps'>, Omit<ChartsOverlayProps, 'slots' | 'slotProps'>, Pick<ScatterPlotProps, 'renderer'> {
   /**
    * The series to display in the scatter chart.
    * An array of [[ScatterSeries]] objects.
@@ -69,7 +69,7 @@ export interface ScatterChartProps extends Omit<ChartContainerProps<'scatter', S
    * @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'] | UseChartVoronoiSignature['params']['onItemClick'];
+  onItemClick?: ScatterPlotProps['onItemClick'] | UseChartClosestPointSignature['params']['onItemClick'];
 }
 /**
  * Demos:

package/ScatterChart/ScatterChart.js

@@ -110,6 +110,7 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
    * @default false
    */
   disableVoronoi: _propTypes.default.bool,
+  enableKeyboardNavigation: _propTypes.default.bool,
   /**
    * Option to display a cartesian grid in the background.
    */
@@ -178,6 +179,15 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
    * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
    */
   onItemClick: _propTypes.default.func,
+  /**
+   * The type of renderer to use for the scatter plot.
+   * - `svg-single`: Renders every scatter item in a `<circle />` element.
+   * - `svg-batch`: Batch renders scatter items in `<path />` elements for better performance with large datasets, at the cost of some limitations.
+   *                Read more: https://mui.com/x/react-charts/scatter/#performance
+   *
+   * @default 'svg-single'
+   */
+  renderer: _propTypes.default.oneOf(['svg-batch', 'svg-single']),
   /**
    * The series to display in the scatter chart.
    * An array of [[ScatterSeries]] objects.
@@ -207,10 +217,11 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
   theme: _propTypes.default.oneOf(['dark', 'light']),
   title: _propTypes.default.string,
   /**
-   * Defines the maximal distance between a scatter point and the pointer that triggers the interaction.
+   * Defines the maximum distance between a scatter point and the pointer that triggers the interaction.
+   * If set to `'item'`, the radius is the `markerSize`.
    * If `undefined`, the radius is assumed to be infinite.
    */
-  voronoiMaxRadius: _propTypes.default.number,
+  voronoiMaxRadius: _propTypes.default.oneOfType([_propTypes.default.oneOf(['item']), _propTypes.default.number]),
   /**
    * The width of the chart in px. If not defined, it takes the width of the parent element.
    */

package/ScatterChart/ScatterChart.plugins.d.ts

@@ -3,6 +3,7 @@ import { UseChartCartesianAxisSignature } from "../internals/plugins/featurePlug
 import { UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.js";
 import { UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.js";
 import { ConvertSignaturesIntoPlugins } from "../internals/plugins/models/helpers.js";
-import { UseChartVoronoiSignature } from "../internals/plugins/featurePlugins/useChartVoronoi/index.js";
-export type ScatterChartPluginsSignatures = [UseChartZAxisSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartVoronoiSignature];
-export declare const SCATTER_CHART_PLUGINS: ConvertSignaturesIntoPlugins<ScatterChartPluginsSignatures>;
+import { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";
+import { UseChartKeyboardNavigationSignature } from "../internals/plugins/featurePlugins/useChartKeyboardNavigation/index.js";
+export type ScatterChartPluginSignatures = [UseChartZAxisSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
+export declare const SCATTER_CHART_PLUGINS: ConvertSignaturesIntoPlugins<ScatterChartPluginSignatures>;

package/ScatterChart/ScatterChart.plugins.js

@@ -8,5 +8,6 @@ var _useChartZAxis = require("../internals/plugins/featurePlugins/useChartZAxis"
 var _useChartCartesianAxis = require("../internals/plugins/featurePlugins/useChartCartesianAxis");
 var _useChartInteraction = require("../internals/plugins/featurePlugins/useChartInteraction");
 var _useChartHighlight = require("../internals/plugins/featurePlugins/useChartHighlight");
-var _useChartVoronoi = require("../internals/plugins/featurePlugins/useChartVoronoi");
-const SCATTER_CHART_PLUGINS = exports.SCATTER_CHART_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartCartesianAxis.useChartCartesianAxis, _useChartInteraction.useChartInteraction, _useChartHighlight.useChartHighlight, _useChartVoronoi.useChartVoronoi];
+var _useChartClosestPoint = require("../internals/plugins/featurePlugins/useChartClosestPoint");
+var _useChartKeyboardNavigation = require("../internals/plugins/featurePlugins/useChartKeyboardNavigation");
+const SCATTER_CHART_PLUGINS = exports.SCATTER_CHART_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartCartesianAxis.useChartCartesianAxis, _useChartInteraction.useChartInteraction, _useChartHighlight.useChartHighlight, _useChartClosestPoint.useChartClosestPoint, _useChartKeyboardNavigation.useChartKeyboardNavigation];

package/ScatterChart/ScatterPlot.d.ts

@@ -6,6 +6,7 @@ export interface ScatterPlotSlots extends ScatterSlots {
 export interface ScatterPlotSlotProps extends ScatterSlotProps {
   scatter?: Partial<ScatterProps>;
 }
+export type RendererType = 'svg-single' | 'svg-batch';
 export interface ScatterPlotProps extends Pick<ScatterProps, 'onItemClick'> {
   /**
    * Overridable component slots.
@@ -17,6 +18,15 @@ export interface ScatterPlotProps extends Pick<ScatterProps, 'onItemClick'> {
    * @default {}
    */
   slotProps?: ScatterPlotSlotProps;
+  /**
+   * The type of renderer to use for the scatter plot.
+   * - `svg-single`: Renders every scatter item in a `<circle />` element.
+   * - `svg-batch`: Batch renders scatter items in `<path />` elements for better performance with large datasets, at the cost of some limitations.
+   *                Read more: https://mui.com/x/react-charts/scatter/#performance
+   *
+   * @default 'svg-single'
+   */
+  renderer?: RendererType;
 }
 /**
  * Demos:

package/ScatterChart/ScatterPlot.js

@@ -15,6 +15,7 @@ var _useScatterSeries = require("../hooks/useScatterSeries");
 var _hooks = require("../hooks");
 var _useZAxis = require("../hooks/useZAxis");
 var _seriesConfig = require("./seriesConfig");
+var _BatchScatter = require("./BatchScatter");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Demos:
@@ -30,7 +31,8 @@ function ScatterPlot(props) {
   const {
     slots,
     slotProps,
-    onItemClick
+    onItemClick,
+    renderer
   } = props;
   const seriesData = (0, _useScatterSeries.useScatterSeriesContext)();
   const {
@@ -55,7 +57,8 @@ function ScatterPlot(props) {
   const defaultXAxisId = xAxisIds[0];
   const defaultYAxisId = yAxisIds[0];
   const defaultZAxisId = zAxisIds[0];
-  const ScatterItems = slots?.scatter ?? _Scatter.Scatter;
+  const DefaultScatterItems = renderer === 'svg-batch' ? _BatchScatter.BatchScatter : _Scatter.Scatter;
+  const ScatterItems = slots?.scatter ?? DefaultScatterItems;
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(React.Fragment, {
     children: seriesOrder.map(seriesId => {
       const {
@@ -92,6 +95,15 @@ process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes = {
    * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
    */
   onItemClick: _propTypes.default.func,
+  /**
+   * The type of renderer to use for the scatter plot.
+   * - `svg-single`: Renders every scatter item in a `<circle />` element.
+   * - `svg-batch`: Batch renders scatter items in `<path />` elements for better performance with large datasets, at the cost of some limitations.
+   *                Read more: https://mui.com/x/react-charts/scatter/#performance
+   *
+   * @default 'svg-single'
+   */
+  renderer: _propTypes.default.oneOf(['svg-batch', 'svg-single']),
   /**
    * The props used for each component slot.
    * @default {}

package/ScatterChart/index.d.ts

@@ -3,5 +3,6 @@ export * from "./ScatterPlot.js";
 export * from "./Scatter.js";
 export * from "./ScatterMarker.types.js";
 export * from "./ScatterMarker.js";
+export * from "./ScatterChart.plugins.js";
 export type { ScatterClasses } from "./scatterClasses.js";
 export { scatterClasses } from "./scatterClasses.js";

package/ScatterChart/index.js

@@ -72,4 +72,16 @@ Object.keys(_ScatterMarker2).forEach(function (key) {
     }
   });
 });
+var _ScatterChart2 = require("./ScatterChart.plugins");
+Object.keys(_ScatterChart2).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _ScatterChart2[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ScatterChart2[key];
+    }
+  });
+});
 var _scatterClasses = require("./scatterClasses");

package/ScatterChart/useScatterChartProps.d.ts

@@ -8,7 +8,7 @@ import { ChartContainerProps } from "../ChartContainer/index.js";
 import type { ScatterChartProps } from "./ScatterChart.js";
 import type { ScatterPlotProps } from "./ScatterPlot.js";
 import type { ChartsWrapperProps } from "../ChartsWrapper/index.js";
-import { ScatterChartPluginsSignatures } from "./ScatterChart.plugins.js";
+import { ScatterChartPluginSignatures } from "./ScatterChart.plugins.js";
 /**
  * A helper function that extracts ScatterChartProps from the input props
  * and returns an object with props for the children components of ScatterChart.
@@ -18,7 +18,7 @@ import { ScatterChartPluginsSignatures } from "./ScatterChart.plugins.js";
  */
 export declare const useScatterChartProps: (props: ScatterChartProps) => {
   chartsWrapperProps: Omit<ChartsWrapperProps, "children">;
-  chartContainerProps: ChartContainerProps<"scatter", ScatterChartPluginsSignatures>;
+  chartContainerProps: ChartContainerProps<"scatter", ScatterChartPluginSignatures>;
   chartsAxisProps: ChartsAxisProps;
   gridProps: ChartsGridProps;
   scatterPlotProps: ScatterPlotProps;

package/ScatterChart/useScatterChartProps.js

@@ -11,7 +11,7 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var React = _interopRequireWildcard(require("react"));
 var _ScatterChart = require("./ScatterChart.plugins");
-const _excluded = ["xAxis", "yAxis", "zAxis", "series", "axisHighlight", "voronoiMaxRadius", "disableVoronoi", "hideLegend", "width", "height", "margin", "colors", "sx", "grid", "onItemClick", "children", "slots", "slotProps", "loading", "highlightedItem", "onHighlightChange", "className", "showToolbar"];
+const _excluded = ["xAxis", "yAxis", "zAxis", "series", "axisHighlight", "voronoiMaxRadius", "disableVoronoi", "hideLegend", "width", "height", "margin", "colors", "sx", "grid", "onItemClick", "children", "slots", "slotProps", "loading", "highlightedItem", "onHighlightChange", "className", "showToolbar", "renderer"];
 /**
  * A helper function that extracts ScatterChartProps from the input props
  * and returns an object with props for the children components of ScatterChart.
@@ -41,12 +41,14 @@ const useScatterChartProps = props => {
       loading,
       highlightedItem,
       onHighlightChange,
-      className
+      className,
+      renderer
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   const seriesWithDefault = React.useMemo(() => series.map(s => (0, _extends2.default)({
     type: 'scatter'
   }, s)), [series]);
+  const useVoronoiOnItemClick = disableVoronoi !== true || renderer === 'svg-batch';
   const chartContainerProps = (0, _extends2.default)({}, other, {
     series: seriesWithDefault,
     width,
@@ -60,7 +62,7 @@ const useScatterChartProps = props => {
     onHighlightChange,
     disableVoronoi,
     voronoiMaxRadius,
-    onItemClick: disableVoronoi ? undefined : onItemClick,
+    onItemClick: useVoronoiOnItemClick ? onItemClick : undefined,
     className,
     plugins: _ScatterChart.SCATTER_CHART_PLUGINS,
     slots,
@@ -75,9 +77,10 @@ const useScatterChartProps = props => {
     horizontal: grid?.horizontal
   };
   const scatterPlotProps = {
-    onItemClick: disableVoronoi ? onItemClick : undefined,
+    onItemClick: useVoronoiOnItemClick ? undefined : onItemClick,
     slots,
-    slotProps
+    slotProps,
+    renderer
   };
   const overlayProps = {
     loading,

package/SparkLineChart/SparkLineChart.js

@@ -20,6 +20,7 @@ var _ChartsSurface = require("../ChartsSurface");
 var _constants = require("../constants");
 var _ChartsTooltip = require("../ChartsTooltip");
 var _ChartsAxisHighlight = require("../ChartsAxisHighlight");
+var _FocusedMark = require("../LineChart/FocusedMark");
 var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["xAxis", "yAxis", "width", "height", "margin", "color", "baseline", "sx", "showTooltip", "showHighlight", "axisHighlight", "children", "slots", "slotProps", "data", "plotType", "valueFormatter", "area", "curve", "className", "disableClipping", "clipAreaOffset", "onHighlightChange", "onHighlightedAxisChange", "highlightedAxis", "highlightedItem"];
 const SPARK_LINE_DEFAULT_MARGIN = 5;
@@ -144,9 +145,11 @@ const SparkLineChart = exports.SparkLineChart = /*#__PURE__*/React.forwardRef(fu
             slotProps: slotProps
           })]
         })]
-      }), plotType === 'line' && /*#__PURE__*/(0, _jsxRuntime.jsx)(_LineChart.LineHighlightPlot, {
-        slots: slots,
-        slotProps: slotProps
+      }), plotType === 'line' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_LineChart.LineHighlightPlot, {
+          slots: slots,
+          slotProps: slotProps
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_FocusedMark.FocusedMark, {})]
       }), disableClipping ? null : /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsClipPath.ChartsClipPath, {
         id: clipPathId,
         offset: clipPathOffset
@@ -232,6 +235,7 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    * If true, the voronoi interaction are ignored.
    */
   disableVoronoi: _propTypes.default.bool,
+  enableKeyboardNavigation: _propTypes.default.bool,
   /**
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
@@ -345,10 +349,11 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    */
   valueFormatter: _propTypes.default.func,
   /**
-   * Defines the maximal distance between a scatter point and the pointer that triggers the interaction.
+   * Defines the maximum distance between a scatter point and the pointer that triggers the interaction.
+   * If set to `'item'`, the radius is the `markerSize`.
    * If `undefined`, the radius is assumed to be infinite.
    */
-  voronoiMaxRadius: _propTypes.default.number,
+  voronoiMaxRadius: _propTypes.default.oneOfType([_propTypes.default.oneOf(['item']), _propTypes.default.number]),
   /**
    * The width of the chart in px. If not defined, it takes the width of the parent element.
    */

package/Toolbar/Toolbar.js

@@ -33,8 +33,7 @@ const ToolbarRoot = (0, _styles.styled)('div', {
   minHeight: 44,
   boxSizing: 'border-box',
   border: `1px solid ${(theme.vars || theme).palette.divider}`,
-  borderRadius: 4,
-  gridArea: 'toolbar'
+  borderRadius: 4
 }));
 const Toolbar = exports.Toolbar = /*#__PURE__*/React.forwardRef(function Toolbar(_ref, ref) {
   let {