@mui/x-charts 9.6.0 → 9.8.0

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.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/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>;

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>;

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.

package/ScatterChart/async/ScatterAsyncBatch.js

@@ -33,8 +33,9 @@ function ScatterAsyncBatchComponent(props) {
     slots,
     slotProps,
     start,
-    end,
+    step,
     revealed,
+    isInteracting,
     classes: inClasses
   } = props;
   const classes = (0, _scatterClasses.useUtilityClasses)({
@@ -65,13 +66,19 @@ function ScatterAsyncBatchComponent(props) {
       className: classes.series
     });
   }
-  const view = (0, _scatterRenderData.getScatterBatchView)(renderData, start, end);
+  const {
+    coords,
+    count
+  } = renderData;
   const markers = [];
-  const nLocal = view.length / 3;
-  for (let local = 0; local < nLocal; local += 1) {
-    const x = view[local * 3];
-    const y = view[local * 3 + 1];
-    const dataIndex = view[local * 3 + 2];
+  const safeStep = Math.max(1, step);
+  for (let dataIndex = start; dataIndex < count; dataIndex += safeStep) {
+    // Skip off-screen points (kept in-array to keep batches stable across pan).
+    if (coords[dataIndex * 3 + 2] === 0) {
+      continue;
+    }
+    const x = coords[dataIndex * 3];
+    const y = coords[dataIndex * 3 + 1];
     const dataPoint = {
       x,
       y,
@@ -79,7 +86,7 @@ function ScatterAsyncBatchComponent(props) {
       seriesId: series.id,
       type: 'scatter'
     };
-    const highlightState = getHighlightState(dataPoint);
+    const highlightState = isInteracting ? 'none' : getHighlightState(dataPoint);
     const isItemHighlighted = highlightState === 'highlighted';
     const isItemFaded = highlightState === 'faded';
     markers.push(/*#__PURE__*/(0, _jsxRuntime.jsx)(Marker, (0, _extends2.default)({
@@ -97,7 +104,7 @@ function ScatterAsyncBatchComponent(props) {
       })),
       "data-highlighted": isItemHighlighted || undefined,
       "data-faded": isItemFaded || undefined
-    }, skipInteractionHandlers ? undefined : (0, _useInteractionItemProps.getInteractionItemProps)(instance, dataPoint), markerProps), dataIndex));
+    }, skipInteractionHandlers || isInteracting ? undefined : (0, _useInteractionItemProps.getInteractionItemProps)(instance, dataPoint), markerProps), dataIndex));
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)("g", {
     "data-series": series.id,
@@ -106,7 +113,6 @@ function ScatterAsyncBatchComponent(props) {
   });
 }
 
-// Memoized so a reveal tick (which re-renders every `ScatterAsync`) only
-// re-renders the one batch whose `revealed` prop changed.
+// Memoized so a reveal tick only re-renders the batch whose `revealed` changed.
 const ScatterAsyncBatch = exports.ScatterAsyncBatch = /*#__PURE__*/React.memo(ScatterAsyncBatchComponent);
 if (process.env.NODE_ENV !== "production") ScatterAsyncBatch.displayName = "ScatterAsyncBatch";

package/ScatterChart/async/ScatterAsyncBatch.mjs

@@ -13,7 +13,7 @@ import { selectorChartsIsVoronoiEnabled } from "../../internals/plugins/featureP
 import { ScatterMarker } from "../ScatterMarker.mjs";
 import { useUtilityClasses } from "../scatterClasses.mjs";
 import { useChartsContext } from "../../context/ChartsProvider/index.mjs";
-import { getScatterBatchView, selectorScatterSeriesRenderData } from "./scatterRenderData.selectors.mjs";
+import { selectorScatterSeriesRenderData } from "./scatterRenderData.selectors.mjs";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * @ignore - internal component.
@@ -26,8 +26,9 @@ function ScatterAsyncBatchComponent(props) {
     slots,
     slotProps,
     start,
-    end,
+    step,
     revealed,
+    isInteracting,
     classes: inClasses
   } = props;
   const classes = useUtilityClasses({
@@ -58,13 +59,19 @@ function ScatterAsyncBatchComponent(props) {
       className: classes.series
     });
   }
-  const view = getScatterBatchView(renderData, start, end);
+  const {
+    coords,
+    count
+  } = renderData;
   const markers = [];
-  const nLocal = view.length / 3;
-  for (let local = 0; local < nLocal; local += 1) {
-    const x = view[local * 3];
-    const y = view[local * 3 + 1];
-    const dataIndex = view[local * 3 + 2];
+  const safeStep = Math.max(1, step);
+  for (let dataIndex = start; dataIndex < count; dataIndex += safeStep) {
+    // Skip off-screen points (kept in-array to keep batches stable across pan).
+    if (coords[dataIndex * 3 + 2] === 0) {
+      continue;
+    }
+    const x = coords[dataIndex * 3];
+    const y = coords[dataIndex * 3 + 1];
     const dataPoint = {
       x,
       y,
@@ -72,7 +79,7 @@ function ScatterAsyncBatchComponent(props) {
       seriesId: series.id,
       type: 'scatter'
     };
-    const highlightState = getHighlightState(dataPoint);
+    const highlightState = isInteracting ? 'none' : getHighlightState(dataPoint);
     const isItemHighlighted = highlightState === 'highlighted';
     const isItemFaded = highlightState === 'faded';
     markers.push(/*#__PURE__*/_jsx(Marker, _extends({
@@ -90,7 +97,7 @@ function ScatterAsyncBatchComponent(props) {
       })),
       "data-highlighted": isItemHighlighted || undefined,
       "data-faded": isItemFaded || undefined
-    }, skipInteractionHandlers ? undefined : getInteractionItemProps(instance, dataPoint), markerProps), dataIndex));
+    }, skipInteractionHandlers || isInteracting ? undefined : getInteractionItemProps(instance, dataPoint), markerProps), dataIndex));
   }
   return /*#__PURE__*/_jsx("g", {
     "data-series": series.id,
@@ -99,8 +106,7 @@ function ScatterAsyncBatchComponent(props) {
   });
 }
 
-// Memoized so a reveal tick (which re-renders every `ScatterAsync`) only
-// re-renders the one batch whose `revealed` prop changed.
+// Memoized so a reveal tick only re-renders the batch whose `revealed` changed.
 const ScatterAsyncBatch = /*#__PURE__*/React.memo(ScatterAsyncBatchComponent);
 if (process.env.NODE_ENV !== "production") ScatterAsyncBatch.displayName = "ScatterAsyncBatch";
 export { ScatterAsyncBatch };

package/ScatterChart/async/scatterRenderData.selectors.d.mts

@@ -1,38 +1,35 @@
 /**
- * Pre-computed render data for a single scatter series.
- *
- * Coordinates are stored in a packed `Float64Array` (stride 3: `[x0, y0, i0,
- * x1, y1, i1, ...]`, where `iN` is the original `dataIndex`). Only points that
- * project inside the drawing area are kept, so the progressive renderer can
- * size its batches by the number of *visible* points — when zoomed in tightly
- * the wave finishes in a single tick. Batches are contiguous slices of this
- * array, so a batch's data is obtained with a zero-copy `subarray` view (see
- * {@link getScatterBatchView}).
+ * Render data for one scatter series. Packed `Float64Array` indexed by
+ * `dataIndex` (stride 3: `[x, y, visible]`). Off-screen points keep their slot
+ * so a point's batch stays fixed across zoom/pan (no popping).
  */
 export interface ScatterSeriesRenderData {
-  /** Packed projected pixel coordinates + dataIndex, stride 3. */
+  /** Packed projected coordinates + visibility flag, stride 3. */
   coords: Float64Array;
-  /** Number of visible points (i.e. `coords.length / 3`). */
+  /** Total number of points (`coords.length / 3`). */
   count: number;
 }
-/**
- * Packed projected coordinates for every scatter series, filtered to the
- * drawing area. Recomputes when the processed series, axis scales, or drawing
- * area change.
- */
+/** Packed projected coordinates for every scatter series, indexed by `dataIndex`. */
 export declare const selectorScatterRenderData: (args_0: import("../../internals/plugins/corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../internals/index.mjs").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../internals/index.mjs").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../internals/index.mjs").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("../../internals/index.mjs").ChartStateCacheKey;
 }) => Map<string, ScatterSeriesRenderData>;
+/** Pixel bounds (inclusive) a point must fall within to be flagged visible. */
+export interface ScatterVisibilityBounds {
+  xMin: number;
+  xMax: number;
+  yMin: number;
+  yMax: number;
+}
 /**
- * Render data for a single scatter series, or `undefined` while it is not
- * available yet (processors/axes still pending).
+ * Projects `data` into a `dataIndex`-indexed packed array (stride 3:
+ * `[x, y, visible]`). Every point keeps its slot; `visible` is `1` inside
+ * `bounds`, `0` otherwise.
  */
+export declare function packScatterSeriesCoords(data: readonly {
+  x: number | Date;
+  y: number | Date;
+}[], getXPosition: (value: number | Date) => number, getYPosition: (value: number | Date) => number, bounds: ScatterVisibilityBounds): ScatterSeriesRenderData;
+/** Render data for one series, or `undefined` while processors/axes are pending. */
 export declare const selectorScatterSeriesRenderData: (args_0: import("../../internals/plugins/corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../internals/index.mjs").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../internals/index.mjs").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../internals/index.mjs").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("../../internals/index.mjs").ChartStateCacheKey;
-}, seriesId: string) => ScatterSeriesRenderData | undefined;
-/**
- * Zero-copy view of one batch's coordinates. `start`/`end` are visible-point
- * indices (not original `dataIndex` values). The returned `Float64Array` shares
- * the buffer with `renderData.coords`.
- */
-export declare function getScatterBatchView(renderData: ScatterSeriesRenderData, start: number, end: number): Float64Array;
+}, seriesId: string) => ScatterSeriesRenderData | undefined;