@mui/x-charts 9.5.0 → 9.7.0

package/ScatterChart/Scatter.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { type ScatterMarkerSlotProps, type ScatterMarkerSlots } from "./ScatterMarker.types.js";
-import { type DefaultizedScatterSeriesType, type ScatterItemIdentifier } from "../models/seriesType/scatter.js";
-import { type D3Scale } from "../models/axis.js";
-import { type ColorGetter } from "../internals/plugins/corePlugins/useChartSeriesConfig/index.js";
+import type { ScatterMarkerSlotProps, ScatterMarkerSlots } from "./ScatterMarker.types.js";
+import type { DefaultizedScatterSeriesType, ScatterItemIdentifier } from "../models/seriesType/scatter.js";
+import type { D3Scale } from "../models/axis.js";
+import type { ColorGetter } from "../internals/plugins/corePlugins/useChartSeriesConfig/index.js";
 import type { ScatterSizeGetter } from "./seriesConfig/getMarkerSize.js";
 import type { ScatterClasses } from "./scatterClasses.js";
 /**

package/ScatterChart/Scatter.js

@@ -104,7 +104,7 @@ function Scatter(props) {
     })
   });
 }
-process.env.NODE_ENV !== "production" ? Scatter.propTypes = {
+process.env.NODE_ENV !== "production" ? Scatter.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |

package/ScatterChart/Scatter.mjs

@@ -100,7 +100,7 @@ function Scatter(props) {
     })
   });
 }
-process.env.NODE_ENV !== "production" ? Scatter.propTypes = {
+process.env.NODE_ENV !== "production" ? Scatter.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |

package/ScatterChart/ScatterChart.d.mts

@@ -1,18 +1,18 @@
 import * as React from 'react';
-import { type MakeOptional } from '@mui/x-internals/types';
-import { type ChartsToolbarSlotProps, type ChartsToolbarSlots } from "../Toolbar/index.mjs";
-import { type ChartsSlots, type ChartsSlotProps } from "../internals/material/index.mjs";
-import { type ScatterPlotProps, type ScatterPlotSlotProps, type ScatterPlotSlots } from "./ScatterPlot.mjs";
-import { type ChartsContainerProps } from "../ChartsContainer/index.mjs";
-import { type ScatterSeriesType } from "../models/seriesType/scatter.mjs";
-import { type ChartsTooltipProps } from "../ChartsTooltip/index.mjs";
-import { type ChartsTooltipSlots, type ChartsTooltipSlotProps } from "../ChartsTooltip/ChartTooltip.types.mjs";
+import type { MakeOptional } from '@mui/x-internals/types';
+import type { ChartsToolbarSlotProps, ChartsToolbarSlots } from "../Toolbar/index.mjs";
+import type { ChartsSlots, ChartsSlotProps } from "../internals/material/index.mjs";
+import type { ScatterPlotProps, ScatterPlotSlotProps, ScatterPlotSlots } from "./ScatterPlot.mjs";
+import type { ChartsContainerProps } from "../ChartsContainer/index.mjs";
+import type { ScatterSeriesType } from "../models/seriesType/scatter.mjs";
+import type { ChartsTooltipProps } from "../ChartsTooltip/index.mjs";
+import type { ChartsTooltipSlots, ChartsTooltipSlotProps } from "../ChartsTooltip/ChartTooltip.types.mjs";
 import type { TooltipPropsOverrides } from "../models/chartsSlotsComponentsProps.mjs";
-import { type ChartsLegendSlotProps, type ChartsLegendSlots } from "../ChartsLegend/index.mjs";
-import { type ChartsOverlayProps, type ChartsOverlaySlotProps, type ChartsOverlaySlots } from "../ChartsOverlay/index.mjs";
-import { type ChartsAxisHighlightProps } from "../ChartsAxisHighlight/index.mjs";
-import { type ChartsAxisSlots, type ChartsAxisSlotProps } from "../models/axis.mjs";
-import { type ChartsGridProps } from "../ChartsGrid/index.mjs";
+import type { ChartsLegendSlotProps, ChartsLegendSlots } from "../ChartsLegend/index.mjs";
+import type { ChartsOverlayProps, ChartsOverlaySlotProps, ChartsOverlaySlots } from "../ChartsOverlay/index.mjs";
+import type { ChartsAxisHighlightProps } from "../ChartsAxisHighlight/index.mjs";
+import type { ChartsAxisSlots, ChartsAxisSlotProps } from "../models/axis.mjs";
+import type { ChartsGridProps } from "../ChartsGrid/index.mjs";
 import type { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.mjs";
 import type { ScatterChartPluginSignatures } from "./ScatterChart.plugins.mjs";
 export interface ScatterChartSlots extends ChartsAxisSlots, ScatterPlotSlots, ChartsLegendSlots, ChartsOverlaySlots, ChartsTooltipSlots, ChartsToolbarSlots, Partial<ChartsSlots> {}

package/ScatterChart/ScatterChart.d.ts

@@ -1,18 +1,18 @@
 import * as React from 'react';
-import { type MakeOptional } from '@mui/x-internals/types';
-import { type ChartsToolbarSlotProps, type ChartsToolbarSlots } from "../Toolbar/index.js";
-import { type ChartsSlots, type ChartsSlotProps } from "../internals/material/index.js";
-import { type ScatterPlotProps, type ScatterPlotSlotProps, type ScatterPlotSlots } from "./ScatterPlot.js";
-import { type ChartsContainerProps } from "../ChartsContainer/index.js";
-import { type ScatterSeriesType } from "../models/seriesType/scatter.js";
-import { type ChartsTooltipProps } from "../ChartsTooltip/index.js";
-import { type ChartsTooltipSlots, type ChartsTooltipSlotProps } from "../ChartsTooltip/ChartTooltip.types.js";
+import type { MakeOptional } from '@mui/x-internals/types';
+import type { ChartsToolbarSlotProps, ChartsToolbarSlots } from "../Toolbar/index.js";
+import type { ChartsSlots, ChartsSlotProps } from "../internals/material/index.js";
+import type { ScatterPlotProps, ScatterPlotSlotProps, ScatterPlotSlots } from "./ScatterPlot.js";
+import type { ChartsContainerProps } from "../ChartsContainer/index.js";
+import type { ScatterSeriesType } from "../models/seriesType/scatter.js";
+import type { ChartsTooltipProps } from "../ChartsTooltip/index.js";
+import type { ChartsTooltipSlots, ChartsTooltipSlotProps } from "../ChartsTooltip/ChartTooltip.types.js";
 import type { TooltipPropsOverrides } from "../models/chartsSlotsComponentsProps.js";
-import { type ChartsLegendSlotProps, type ChartsLegendSlots } from "../ChartsLegend/index.js";
-import { type ChartsOverlayProps, type ChartsOverlaySlotProps, type ChartsOverlaySlots } from "../ChartsOverlay/index.js";
-import { type ChartsAxisHighlightProps } from "../ChartsAxisHighlight/index.js";
-import { type ChartsAxisSlots, type ChartsAxisSlotProps } from "../models/axis.js";
-import { type ChartsGridProps } from "../ChartsGrid/index.js";
+import type { ChartsLegendSlotProps, ChartsLegendSlots } from "../ChartsLegend/index.js";
+import type { ChartsOverlayProps, ChartsOverlaySlotProps, ChartsOverlaySlots } from "../ChartsOverlay/index.js";
+import type { ChartsAxisHighlightProps } from "../ChartsAxisHighlight/index.js";
+import type { ChartsAxisSlots, ChartsAxisSlotProps } from "../models/axis.js";
+import type { ChartsGridProps } from "../ChartsGrid/index.js";
 import type { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";
 import type { ScatterChartPluginSignatures } from "./ScatterChart.plugins.js";
 export interface ScatterChartSlots extends ChartsAxisSlots, ScatterPlotSlots, ChartsLegendSlots, ChartsOverlaySlots, ChartsTooltipSlots, ChartsToolbarSlots, Partial<ChartsSlots> {}

package/ScatterChart/ScatterChart.js

@@ -72,7 +72,7 @@ const ScatterChart = exports.ScatterChart = /*#__PURE__*/React.forwardRef(functi
   }));
 });
 if (process.env.NODE_ENV !== "production") ScatterChart.displayName = "ScatterChart";
-process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterChart.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
@@ -394,11 +394,13 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
       color: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.string.isRequired), _propTypes.default.func]).isRequired,
       max: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
       min: _propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]),
-      type: _propTypes.default.oneOf(['continuous']).isRequired
+      type: _propTypes.default.oneOf(['continuous']).isRequired,
+      unknownColor: _propTypes.default.string
     }), _propTypes.default.shape({
       colors: _propTypes.default.arrayOf(_propTypes.default.string).isRequired,
       thresholds: _propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.instanceOf(Date), _propTypes.default.number]).isRequired).isRequired,
-      type: _propTypes.default.oneOf(['piecewise']).isRequired
+      type: _propTypes.default.oneOf(['piecewise']).isRequired,
+      unknownColor: _propTypes.default.string
     }), _propTypes.default.shape({
       colors: _propTypes.default.arrayOf(_propTypes.default.string).isRequired,
       type: _propTypes.default.oneOf(['ordinal']).isRequired,

package/ScatterChart/ScatterChart.mjs

@@ -65,7 +65,7 @@ const ScatterChart = /*#__PURE__*/React.forwardRef(function ScatterChart(inProps
   }));
 });
 if (process.env.NODE_ENV !== "production") ScatterChart.displayName = "ScatterChart";
-process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterChart.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
@@ -387,11 +387,13 @@ process.env.NODE_ENV !== "production" ? ScatterChart.propTypes = {
       color: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string.isRequired), PropTypes.func]).isRequired,
       max: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
       min: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
-      type: PropTypes.oneOf(['continuous']).isRequired
+      type: PropTypes.oneOf(['continuous']).isRequired,
+      unknownColor: PropTypes.string
     }), PropTypes.shape({
       colors: PropTypes.arrayOf(PropTypes.string).isRequired,
       thresholds: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]).isRequired).isRequired,
-      type: PropTypes.oneOf(['piecewise']).isRequired
+      type: PropTypes.oneOf(['piecewise']).isRequired,
+      unknownColor: PropTypes.string
     }), PropTypes.shape({
       colors: PropTypes.arrayOf(PropTypes.string).isRequired,
       type: PropTypes.oneOf(['ordinal']).isRequired,

package/ScatterChart/ScatterChart.plugins.d.mts

@@ -1,13 +1,13 @@
-import { type UseChartZAxisSignature } from "../internals/plugins/featurePlugins/useChartZAxis/index.mjs";
-import { type UseChartCartesianAxisSignature } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.mjs";
-import { type UseChartTooltipSignature } from "../internals/plugins/featurePlugins/useChartTooltip/index.mjs";
-import { type UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.mjs";
-import { type UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.mjs";
-import { type ConvertSignaturesIntoPlugins } from "../internals/plugins/models/helpers.mjs";
-import { type UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.mjs";
-import { type UseChartKeyboardNavigationSignature } from "../internals/plugins/featurePlugins/useChartKeyboardNavigation/index.mjs";
-import { type UseChartBrushSignature } from "../internals/plugins/featurePlugins/useChartBrush/index.mjs";
-import { type UseChartVisibilityManagerSignature } from "../internals/plugins/featurePlugins/useChartVisibilityManager/index.mjs";
-import { type UseProgressiveRenderingSignature } from "../internals/plugins/featurePlugins/useProgressiveRendering/index.mjs";
+import type { UseChartZAxisSignature } from "../internals/plugins/featurePlugins/useChartZAxis/index.mjs";
+import type { UseChartCartesianAxisSignature } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.mjs";
+import type { UseChartTooltipSignature } from "../internals/plugins/featurePlugins/useChartTooltip/index.mjs";
+import type { UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.mjs";
+import type { UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.mjs";
+import type { ConvertSignaturesIntoPlugins } from "../internals/plugins/models/helpers.mjs";
+import type { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.mjs";
+import type { UseChartKeyboardNavigationSignature } from "../internals/plugins/featurePlugins/useChartKeyboardNavigation/index.mjs";
+import type { UseChartBrushSignature } from "../internals/plugins/featurePlugins/useChartBrush/index.mjs";
+import type { UseChartVisibilityManagerSignature } from "../internals/plugins/featurePlugins/useChartVisibilityManager/index.mjs";
+import type { UseProgressiveRenderingSignature } from "../internals/plugins/featurePlugins/useProgressiveRendering/index.mjs";
 export type ScatterChartPluginSignatures = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<'scatter'>, UseChartInteractionSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartHighlightSignature<'scatter'>, UseChartVisibilityManagerSignature<'scatter'>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
 export declare const SCATTER_CHART_PLUGINS: ConvertSignaturesIntoPlugins<ScatterChartPluginSignatures>;

package/ScatterChart/ScatterChart.plugins.d.ts

@@ -1,13 +1,13 @@
-import { type UseChartZAxisSignature } from "../internals/plugins/featurePlugins/useChartZAxis/index.js";
-import { type UseChartCartesianAxisSignature } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
-import { type UseChartTooltipSignature } from "../internals/plugins/featurePlugins/useChartTooltip/index.js";
-import { type UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.js";
-import { type UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.js";
-import { type ConvertSignaturesIntoPlugins } from "../internals/plugins/models/helpers.js";
-import { type UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";
-import { type UseChartKeyboardNavigationSignature } from "../internals/plugins/featurePlugins/useChartKeyboardNavigation/index.js";
-import { type UseChartBrushSignature } from "../internals/plugins/featurePlugins/useChartBrush/index.js";
-import { type UseChartVisibilityManagerSignature } from "../internals/plugins/featurePlugins/useChartVisibilityManager/index.js";
-import { type UseProgressiveRenderingSignature } from "../internals/plugins/featurePlugins/useProgressiveRendering/index.js";
+import type { UseChartZAxisSignature } from "../internals/plugins/featurePlugins/useChartZAxis/index.js";
+import type { UseChartCartesianAxisSignature } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
+import type { UseChartTooltipSignature } from "../internals/plugins/featurePlugins/useChartTooltip/index.js";
+import type { UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.js";
+import type { UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.js";
+import type { ConvertSignaturesIntoPlugins } from "../internals/plugins/models/helpers.js";
+import type { UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";
+import type { UseChartKeyboardNavigationSignature } from "../internals/plugins/featurePlugins/useChartKeyboardNavigation/index.js";
+import type { UseChartBrushSignature } from "../internals/plugins/featurePlugins/useChartBrush/index.js";
+import type { UseChartVisibilityManagerSignature } from "../internals/plugins/featurePlugins/useChartVisibilityManager/index.js";
+import type { UseProgressiveRenderingSignature } from "../internals/plugins/featurePlugins/useProgressiveRendering/index.js";
 export type ScatterChartPluginSignatures = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<'scatter'>, UseChartInteractionSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartHighlightSignature<'scatter'>, UseChartVisibilityManagerSignature<'scatter'>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
 export declare const SCATTER_CHART_PLUGINS: ConvertSignaturesIntoPlugins<ScatterChartPluginSignatures>;

package/ScatterChart/ScatterMarker.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type SeriesId } from "../models/seriesType/common.mjs";
+import type { SeriesId } from "../models/seriesType/common.mjs";
 export interface ScatterMarkerProps {
   /**
    * The series ID.

package/ScatterChart/ScatterMarker.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type SeriesId } from "../models/seriesType/common.js";
+import type { SeriesId } from "../models/seriesType/common.js";
 export interface ScatterMarkerProps {
   /**
    * The series ID.

package/ScatterChart/ScatterMarker.js

@@ -32,7 +32,7 @@ function ScatterMarker(props) {
     cursor: other.onClick ? 'pointer' : 'unset'
   }, other));
 }
-process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
@@ -61,7 +61,7 @@ process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes = {
   /**
    * The series ID.
    */
-  seriesId: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]).isRequired,
+  seriesId: _propTypes.default.string.isRequired,
   /**
    * The size of the marker.
    */

package/ScatterChart/ScatterMarker.mjs

@@ -24,7 +24,7 @@ function ScatterMarker(props) {
     cursor: other.onClick ? 'pointer' : 'unset'
   }, other));
 }
-process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
@@ -53,7 +53,7 @@ process.env.NODE_ENV !== "production" ? ScatterMarker.propTypes = {
   /**
    * The series ID.
    */
-  seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+  seriesId: PropTypes.string.isRequired,
   /**
    * The size of the marker.
    */

package/ScatterChart/ScatterPlot.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ScatterProps, type ScatterSlotProps, type ScatterSlots } from "./Scatter.mjs";
+import type { ScatterProps, ScatterSlotProps, ScatterSlots } from "./Scatter.mjs";
 import type { ScatterPropsOverrides } from "../models/chartsSlotsComponentsProps.mjs";
 export interface ScatterPlotSlots extends ScatterSlots {
   scatter?: React.JSXElementConstructor<ScatterProps & ScatterPropsOverrides>;
@@ -8,8 +8,15 @@ export interface ScatterPlotSlotProps extends ScatterSlotProps {
   scatter?: Partial<ScatterProps> & ScatterPropsOverrides;
 }
 export type RendererType = 'svg-single' | 'svg-batch';
-export interface ScatterPlotProps extends Pick<ScatterProps, 'onItemClick' | 'classes'> {
+export interface ScatterPlotProps extends Pick<ScatterProps, 'classes'> {
   className?: string;
+  /**
+   * Callback fired when a marker is clicked directly.
+   * For closest-point clicks (the `ScatterChart` default), pass `onItemClick` to the chart container instead.
+   * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
+   * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+   */
+  onItemClick?: ScatterProps['onItemClick'];
   /**
    * Overridable component slots.
    * @default {}

package/ScatterChart/ScatterPlot.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ScatterProps, type ScatterSlotProps, type ScatterSlots } from "./Scatter.js";
+import type { ScatterProps, ScatterSlotProps, ScatterSlots } from "./Scatter.js";
 import type { ScatterPropsOverrides } from "../models/chartsSlotsComponentsProps.js";
 export interface ScatterPlotSlots extends ScatterSlots {
   scatter?: React.JSXElementConstructor<ScatterProps & ScatterPropsOverrides>;
@@ -8,8 +8,15 @@ export interface ScatterPlotSlotProps extends ScatterSlotProps {
   scatter?: Partial<ScatterProps> & ScatterPropsOverrides;
 }
 export type RendererType = 'svg-single' | 'svg-batch';
-export interface ScatterPlotProps extends Pick<ScatterProps, 'onItemClick' | 'classes'> {
+export interface ScatterPlotProps extends Pick<ScatterProps, 'classes'> {
   className?: string;
+  /**
+   * Callback fired when a marker is clicked directly.
+   * For closest-point clicks (the `ScatterChart` default), pass `onItemClick` to the chart container instead.
+   * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
+   * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
+   */
+  onItemClick?: ScatterProps['onItemClick'];
   /**
    * Overridable component slots.
    * @default {}

package/ScatterChart/ScatterPlot.js

@@ -127,13 +127,16 @@ function ScatterPlot(props) {
     })
   });
 }
-process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes /* remove-proptypes */ = {
   // ----------------------------- Warning --------------------------------
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
+  classes: _propTypes.default.object,
+  className: _propTypes.default.string,
   /**
-   * Callback fired when clicking on a scatter item.
+   * Callback fired when a marker is clicked directly.
+   * For closest-point clicks (the `ScatterChart` default), pass `onItemClick` to the chart container instead.
    * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
    * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
    */

package/ScatterChart/ScatterPlot.mjs

@@ -120,13 +120,16 @@ function ScatterPlot(props) {
     })
   });
 }
-process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes = {
+process.env.NODE_ENV !== "production" ? ScatterPlot.propTypes /* remove-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,
+  className: PropTypes.string,
   /**
-   * Callback fired when clicking on a scatter item.
+   * Callback fired when a marker is clicked directly.
+   * For closest-point clicks (the `ScatterChart` default), pass `onItemClick` to the chart container instead.
    * @param {MouseEvent} event Mouse event recorded on the `<svg/>` element.
    * @param {ScatterItemIdentifier} scatterItemIdentifier The scatter item identifier.
    */

package/ScatterChart/async/ScatterAsync.d.mts

@@ -1,4 +1,10 @@
-import { type ScatterProps } from "../Scatter.mjs";
+import type { ScatterProps } from "../Scatter.mjs";
+/**
+ * Interacting sample stride. Multiple of `nBatches` (batch 0's stride) so the
+ * sample is a subset of batch 0 — settling only adds points, no jump. Coarsened
+ * to stay within `budget`.
+ */
+export declare function getInteractionStep(count: number, nBatches: number, budget: number): number;
 /**
  * @ignore - internal component.
  */

package/ScatterChart/async/ScatterAsync.d.ts

@@ -1,4 +1,10 @@
-import { type ScatterProps } from "../Scatter.js";
+import type { ScatterProps } from "../Scatter.js";
+/**
+ * Interacting sample stride. Multiple of `nBatches` (batch 0's stride) so the
+ * sample is a subset of batch 0 — settling only adds points, no jump. Coarsened
+ * to stay within `budget`.
+ */
+export declare function getInteractionStep(count: number, nBatches: number, budget: number): number;
 /**
  * @ignore - internal component.
  */

package/ScatterChart/async/ScatterAsync.js

@@ -7,16 +7,33 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ScatterAsync = ScatterAsync;
+exports.getInteractionStep = getInteractionStep;
 var React = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _ScatterAsyncBatch = require("./ScatterAsyncBatch");
 var _useStore = require("../../internals/store/useStore");
 var _useProgressiveRendering = require("../../internals/plugins/featurePlugins/useProgressiveRendering");
+var _useChartCartesianAxis = require("../../internals/plugins/featurePlugins/useChartCartesianAxis");
 var _scatterRenderData = require("./scatterRenderData.selectors");
 var _jsxRuntime = require("react/jsx-runtime");
+/** Per-series points sampled while interacting; the rest fills in on settle. */const INTERACTION_POINT_BUDGET = 2000;
+
+/**
+ * Interacting sample stride. Multiple of `nBatches` (batch 0's stride) so the
+ * sample is a subset of batch 0 — settling only adds points, no jump. Coarsened
+ * to stay within `budget`.
+ */
+function getInteractionStep(count, nBatches, budget) {
+  if (nBatches <= 0) {
+    return 1;
+  }
+  return nBatches * Math.max(1, Math.ceil(count / (budget * nBatches)));
+}
+
 /**
  * @ignore - internal component.
- */function ScatterAsync(props) {
+ */
+function ScatterAsync(props) {
   const {
     series,
     colorGetter,
@@ -28,26 +45,31 @@ var _jsxRuntime = require("react/jsx-runtime");
   const store = (0, _useStore.useStore)();
   const batchSize = store.use(_useProgressiveRendering.selectorProgressiveBatchSize);
   const revealedBatches = store.use(_useProgressiveRendering.selectorProgressiveSeriesRevealedBatches, series.id);
-  // Size batches by the number of *visible* points so that zooming in (which
-  // shrinks the filtered set in the selector) collapses the progressive wave
-  // into a single tick once everything fits in one batch.
+  const isZoomInteracting = store.use(_useChartCartesianAxis.selectorChartZoomIsInteracting);
   const renderData = store.use(_scatterRenderData.selectorScatterSeriesRenderData, series.id);
   const count = renderData?.count ?? 0;
+  // Batch `b` = every `nBatches`-th point from `b`: a uniform sample whose
+  // membership depends only on `dataIndex` (stable across zoom/pan, no popping).
   const nBatches = count === 0 ? 0 : Math.ceil(count / Math.max(1, batchSize));
+  // Only the first level shows while interacting; skip mounting the rest (empty
+  // `<g>` still re-renders every frame, bypassing `React.memo`).
+  const mountedBatches = isZoomInteracting ? Math.min(1, nBatches) : nBatches;
+  // `count` (total points) is constant across zoom/pan, so the sampled set is
+  // stable while panning.
+  const interactionStep = getInteractionStep(count, nBatches, INTERACTION_POINT_BUDGET);
   const batches = [];
-  for (let b = 0; b < nBatches; b += 1) {
-    const start = b * batchSize;
-    const end = Math.min(count, start + batchSize);
+  for (let b = 0; b < mountedBatches; b += 1) {
     batches.push(/*#__PURE__*/(0, _jsxRuntime.jsx)(_ScatterAsyncBatch.ScatterAsyncBatch, {
       series: series,
       colorGetter: colorGetter,
       onItemClick: onItemClick,
       slots: slots,
       slotProps: slotProps,
-      start: start,
-      end: end,
+      start: isZoomInteracting ? 0 : b,
+      step: isZoomInteracting ? interactionStep : nBatches,
       classes: classes,
-      revealed: b < revealedBatches
+      revealed: isZoomInteracting || b < revealedBatches,
+      isInteracting: isZoomInteracting
     }, b));
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(React.Fragment, {

package/ScatterChart/async/ScatterAsync.mjs

@@ -5,12 +5,28 @@ import PropTypes from 'prop-types';
 import { ScatterAsyncBatch } from "./ScatterAsyncBatch.mjs";
 import { useStore } from "../../internals/store/useStore.mjs";
 import { selectorProgressiveBatchSize, selectorProgressiveSeriesRevealedBatches } from "../../internals/plugins/featurePlugins/useProgressiveRendering/index.mjs";
+import { selectorChartZoomIsInteracting } from "../../internals/plugins/featurePlugins/useChartCartesianAxis/index.mjs";
 import { selectorScatterSeriesRenderData } from "./scatterRenderData.selectors.mjs";
 
+/** Per-series points sampled while interacting; the rest fills in on settle. */
+import { jsx as _jsx } from "react/jsx-runtime";
+const INTERACTION_POINT_BUDGET = 2000;
+
+/**
+ * Interacting sample stride. Multiple of `nBatches` (batch 0's stride) so the
+ * sample is a subset of batch 0 — settling only adds points, no jump. Coarsened
+ * to stay within `budget`.
+ */
+export function getInteractionStep(count, nBatches, budget) {
+  if (nBatches <= 0) {
+    return 1;
+  }
+  return nBatches * Math.max(1, Math.ceil(count / (budget * nBatches)));
+}
+
 /**
  * @ignore - internal component.
  */
-import { jsx as _jsx } from "react/jsx-runtime";
 function ScatterAsync(props) {
   const {
     series,
@@ -23,26 +39,31 @@ function ScatterAsync(props) {
   const store = useStore();
   const batchSize = store.use(selectorProgressiveBatchSize);
   const revealedBatches = store.use(selectorProgressiveSeriesRevealedBatches, series.id);
-  // Size batches by the number of *visible* points so that zooming in (which
-  // shrinks the filtered set in the selector) collapses the progressive wave
-  // into a single tick once everything fits in one batch.
+  const isZoomInteracting = store.use(selectorChartZoomIsInteracting);
   const renderData = store.use(selectorScatterSeriesRenderData, series.id);
   const count = renderData?.count ?? 0;
+  // Batch `b` = every `nBatches`-th point from `b`: a uniform sample whose
+  // membership depends only on `dataIndex` (stable across zoom/pan, no popping).
   const nBatches = count === 0 ? 0 : Math.ceil(count / Math.max(1, batchSize));
+  // Only the first level shows while interacting; skip mounting the rest (empty
+  // `<g>` still re-renders every frame, bypassing `React.memo`).
+  const mountedBatches = isZoomInteracting ? Math.min(1, nBatches) : nBatches;
+  // `count` (total points) is constant across zoom/pan, so the sampled set is
+  // stable while panning.
+  const interactionStep = getInteractionStep(count, nBatches, INTERACTION_POINT_BUDGET);
   const batches = [];
-  for (let b = 0; b < nBatches; b += 1) {
-    const start = b * batchSize;
-    const end = Math.min(count, start + batchSize);
+  for (let b = 0; b < mountedBatches; b += 1) {
     batches.push(/*#__PURE__*/_jsx(ScatterAsyncBatch, {
       series: series,
       colorGetter: colorGetter,
       onItemClick: onItemClick,
       slots: slots,
       slotProps: slotProps,
-      start: start,
-      end: end,
+      start: isZoomInteracting ? 0 : b,
+      step: isZoomInteracting ? interactionStep : nBatches,
       classes: classes,
-      revealed: b < revealedBatches
+      revealed: isZoomInteracting || b < revealedBatches,
+      isInteracting: isZoomInteracting
     }, b));
   }
   return /*#__PURE__*/_jsx(React.Fragment, {

package/ScatterChart/async/ScatterAsyncBatch.d.mts

@@ -1,20 +1,25 @@
 import * as React from 'react';
-import { type DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.mjs";
+import type { DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.mjs";
 import type { ColorGetter } from "../../internals/plugins/corePlugins/useChartSeriesConfig/index.mjs";
-import { type ScatterProps } from "../Scatter.mjs";
+import type { ScatterProps } from "../Scatter.mjs";
 export interface ScatterAsyncBatchProps extends Pick<ScatterProps, 'series' | 'colorGetter' | 'onItemClick' | 'slots' | 'slotProps' | 'classes'> {
   series: DefaultizedScatterSeriesType;
   colorGetter: ColorGetter<'scatter'>;
-  /** First point index of this batch (inclusive). */
+  /** First `dataIndex` this batch renders. */
   start: number;
-  /** Last point index of this batch (exclusive). */
-  end: number;
+  /** Stride between rendered `dataIndex`es, so the batch is a uniform sample. */
+  step: number;
   /**
-   * Whether this batch is allowed to render its markers yet. `ScatterAsync`
-   * ramps this up batch by batch across animation frames for a progressive
-   * paint. When `false` the `<g>` still mounts but stays empty.
+   * Whether this batch may render its markers yet. Ramped batch by batch across
+   * frames for the progressive paint. When `false` the `<g>` mounts empty.
    */
   revealed: boolean;
+  /**
+   * Whether a zoom/pan interaction is in progress. While interacting, per-marker
+   * highlight state and interaction handlers are skipped: useless mid-drag and
+   * the dominant per-frame cost.
+   */
+  isInteracting?: boolean;
 }
 /**
  * @ignore - internal component.

package/ScatterChart/async/ScatterAsyncBatch.d.ts

@@ -1,20 +1,25 @@
 import * as React from 'react';
-import { type DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.js";
+import type { DefaultizedScatterSeriesType } from "../../models/seriesType/scatter.js";
 import type { ColorGetter } from "../../internals/plugins/corePlugins/useChartSeriesConfig/index.js";
-import { type ScatterProps } from "../Scatter.js";
+import type { ScatterProps } from "../Scatter.js";
 export interface ScatterAsyncBatchProps extends Pick<ScatterProps, 'series' | 'colorGetter' | 'onItemClick' | 'slots' | 'slotProps' | 'classes'> {
   series: DefaultizedScatterSeriesType;
   colorGetter: ColorGetter<'scatter'>;
-  /** First point index of this batch (inclusive). */
+  /** First `dataIndex` this batch renders. */
   start: number;
-  /** Last point index of this batch (exclusive). */
-  end: number;
+  /** Stride between rendered `dataIndex`es, so the batch is a uniform sample. */
+  step: number;
   /**
-   * Whether this batch is allowed to render its markers yet. `ScatterAsync`
-   * ramps this up batch by batch across animation frames for a progressive
-   * paint. When `false` the `<g>` still mounts but stays empty.
+   * Whether this batch may render its markers yet. Ramped batch by batch across
+   * frames for the progressive paint. When `false` the `<g>` mounts empty.
    */
   revealed: boolean;
+  /**
+   * Whether a zoom/pan interaction is in progress. While interacting, per-marker
+   * highlight state and interaction handlers are skipped: useless mid-drag and
+   * the dominant per-frame cost.
+   */
+  isInteracting?: boolean;
 }
 /**
  * @ignore - internal component.