@mui/x-charts 9.4.0 → 9.5.0

package/ScatterChart/async/ScatterAsyncBatch.mjs

@@ -0,0 +1,106 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["ownerState"];
+import * as React from 'react';
+import clsx from 'clsx';
+import useSlotProps from '@mui/utils/useSlotProps';
+import { getInteractionItemProps } from "../../hooks/useInteractionItemProps.mjs";
+import { useStore } from "../../internals/store/useStore.mjs";
+import { useItemHighlightStateGetter } from "../../hooks/useItemHighlightStateGetter.mjs";
+import { selectorChartsIsVoronoiEnabled } from "../../internals/plugins/featurePlugins/useChartClosestPoint/index.mjs";
+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 { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @ignore - internal component.
+ */
+function ScatterAsyncBatchComponent(props) {
+  const {
+    series,
+    colorGetter,
+    onItemClick,
+    slots,
+    slotProps,
+    start,
+    end,
+    revealed,
+    classes: inClasses
+  } = props;
+  const classes = useUtilityClasses({
+    classes: inClasses
+  });
+  const {
+    instance
+  } = useChartsContext();
+  const store = useStore();
+  const isVoronoiEnabled = store.use(selectorChartsIsVoronoiEnabled);
+  const skipInteractionHandlers = isVoronoiEnabled;
+  const getHighlightState = useItemHighlightStateGetter();
+  const renderData = store.use(selectorScatterSeriesRenderData, series.id);
+  const Marker = slots?.marker ?? ScatterMarker;
+  const _useSlotProps = useSlotProps({
+      elementType: Marker,
+      externalSlotProps: slotProps?.marker,
+      additionalProps: {
+        seriesId: series.id,
+        size: series.markerSize
+      },
+      ownerState: {}
+    }),
+    markerProps = _objectWithoutPropertiesLoose(_useSlotProps, _excluded);
+  if (renderData === undefined || !revealed) {
+    return /*#__PURE__*/_jsx("g", {
+      "data-series": series.id,
+      className: classes.series
+    });
+  }
+  const view = getScatterBatchView(renderData, start, end);
+  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 dataPoint = {
+      x,
+      y,
+      dataIndex,
+      seriesId: series.id,
+      type: 'scatter'
+    };
+    const highlightState = getHighlightState(dataPoint);
+    const isItemHighlighted = highlightState === 'highlighted';
+    const isItemFaded = highlightState === 'faded';
+    markers.push(/*#__PURE__*/_jsx(Marker, _extends({
+      className: clsx(classes.marker, markerProps.className),
+      dataIndex: dataIndex,
+      color: colorGetter(dataIndex),
+      isHighlighted: isItemHighlighted,
+      isFaded: isItemFaded,
+      x: x,
+      y: y,
+      onClick: onItemClick && (event => onItemClick(event, {
+        type: 'scatter',
+        seriesId: series.id,
+        dataIndex
+      })),
+      "data-highlighted": isItemHighlighted || undefined,
+      "data-faded": isItemFaded || undefined
+    }, skipInteractionHandlers ? undefined : getInteractionItemProps(instance, dataPoint), markerProps), dataIndex));
+  }
+  return /*#__PURE__*/_jsx("g", {
+    "data-series": series.id,
+    className: classes.series,
+    children: markers
+  });
+}
+
+// Memoized so a reveal tick (which re-renders every `ScatterAsync`) only
+// re-renders the one batch whose `revealed` prop 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

@@ -0,0 +1,38 @@
+/**
+ * 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}).
+ */
+export interface ScatterSeriesRenderData {
+  /** Packed projected pixel coordinates + dataIndex, stride 3. */
+  coords: Float64Array;
+  /** Number of visible points (i.e. `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.
+ */
+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>;
+/**
+ * Render data for a single scatter series, or `undefined` while it is not
+ * available yet (processors/axes still 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;

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

@@ -0,0 +1,38 @@
+/**
+ * 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}).
+ */
+export interface ScatterSeriesRenderData {
+  /** Packed projected pixel coordinates + dataIndex, stride 3. */
+  coords: Float64Array;
+  /** Number of visible points (i.e. `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.
+ */
+export declare const selectorScatterRenderData: (args_0: import("../../internals/plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../internals/index.js").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../internals/index.js").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../internals/index.js").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("../../internals/index.js").ChartStateCacheKey;
+}) => Map<string, ScatterSeriesRenderData>;
+/**
+ * Render data for a single scatter series, or `undefined` while it is not
+ * available yet (processors/axes still pending).
+ */
+export declare const selectorScatterSeriesRenderData: (args_0: import("../../internals/plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../internals/index.js").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../internals/index.js").ChartsSeriesConfig> & import("../../internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../internals/index.js").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("../../internals/index.js").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;

package/ScatterChart/async/scatterRenderData.selectors.js

@@ -0,0 +1,93 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getScatterBatchView = getScatterBatchView;
+exports.selectorScatterSeriesRenderData = exports.selectorScatterRenderData = void 0;
+var _store = require("@mui/x-internals/store");
+var _getValueToPositionMapper = require("../../hooks/getValueToPositionMapper");
+var _useChartSeries = require("../../internals/plugins/corePlugins/useChartSeries");
+var _useChartDimensions = require("../../internals/plugins/corePlugins/useChartDimensions");
+var _useChartCartesianAxis = require("../../internals/plugins/featurePlugins/useChartCartesianAxis");
+/**
+ * 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}).
+ */
+
+const EMPTY_RENDER_DATA = new Map();
+
+/**
+ * Packed projected coordinates for every scatter series, filtered to the
+ * drawing area. Recomputes when the processed series, axis scales, or drawing
+ * area change.
+ */
+const selectorScatterRenderData = exports.selectorScatterRenderData = (0, _store.createSelectorMemoized)(_useChartSeries.selectorChartSeriesProcessed, _useChartCartesianAxis.selectorChartXAxis, _useChartCartesianAxis.selectorChartYAxis, _useChartDimensions.selectorChartDrawingArea, function selectorScatterRenderData(processedSeries, xAxes, yAxes, drawingArea) {
+  const scatter = processedSeries.scatter;
+  if (scatter === undefined) {
+    return EMPTY_RENDER_DATA;
+  }
+  const defaultXAxisId = xAxes.axisIds[0];
+  const defaultYAxisId = yAxes.axisIds[0];
+  const result = new Map();
+  const xMin = drawingArea.left - 1;
+  const xMax = drawingArea.left + drawingArea.width;
+  const yMin = drawingArea.top - 1;
+  const yMax = drawingArea.top + drawingArea.height;
+  for (const seriesId of scatter.seriesOrder) {
+    const series = scatter.series[seriesId];
+    const xAxis = xAxes.axis[series.xAxisId ?? defaultXAxisId];
+    const yAxis = yAxes.axis[series.yAxisId ?? defaultYAxisId];
+    if (xAxis === undefined || yAxis === undefined) {
+      continue;
+    }
+    const getXPosition = (0, _getValueToPositionMapper.getValueToPositionMapper)(xAxis.scale);
+    const getYPosition = (0, _getValueToPositionMapper.getValueToPositionMapper)(yAxis.scale);
+    const data = series.data;
+    const n = data.length;
+    const packed = new Float64Array(n * 3);
+    let j = 0;
+    for (let i = 0; i < n; i += 1) {
+      const x = getXPosition(data[i].x);
+      if (!(x >= xMin && x <= xMax)) {
+        continue;
+      }
+      const y = getYPosition(data[i].y);
+      if (!(y >= yMin && y <= yMax)) {
+        continue;
+      }
+      packed[j] = x;
+      packed[j + 1] = y;
+      packed[j + 2] = i;
+      j += 3;
+    }
+    const coords = packed.slice(0, j);
+    result.set(seriesId, {
+      coords,
+      count: j / 3
+    });
+  }
+  return result;
+});
+
+/**
+ * Render data for a single scatter series, or `undefined` while it is not
+ * available yet (processors/axes still pending).
+ */
+const selectorScatterSeriesRenderData = exports.selectorScatterSeriesRenderData = (0, _store.createSelector)(selectorScatterRenderData, (renderData, seriesId) => renderData.get(seriesId));
+
+/**
+ * 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`.
+ */
+function getScatterBatchView(renderData, start, end) {
+  return renderData.coords.subarray(start * 3, end * 3);
+}

package/ScatterChart/async/scatterRenderData.selectors.mjs

@@ -0,0 +1,87 @@
+import { createSelector, createSelectorMemoized } from '@mui/x-internals/store';
+import { getValueToPositionMapper } from "../../hooks/getValueToPositionMapper.mjs";
+import { selectorChartSeriesProcessed } from "../../internals/plugins/corePlugins/useChartSeries/index.mjs";
+import { selectorChartDrawingArea } from "../../internals/plugins/corePlugins/useChartDimensions/index.mjs";
+import { selectorChartXAxis, selectorChartYAxis } from "../../internals/plugins/featurePlugins/useChartCartesianAxis/index.mjs";
+
+/**
+ * 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}).
+ */
+
+const EMPTY_RENDER_DATA = new Map();
+
+/**
+ * Packed projected coordinates for every scatter series, filtered to the
+ * drawing area. Recomputes when the processed series, axis scales, or drawing
+ * area change.
+ */
+export const selectorScatterRenderData = createSelectorMemoized(selectorChartSeriesProcessed, selectorChartXAxis, selectorChartYAxis, selectorChartDrawingArea, function selectorScatterRenderData(processedSeries, xAxes, yAxes, drawingArea) {
+  const scatter = processedSeries.scatter;
+  if (scatter === undefined) {
+    return EMPTY_RENDER_DATA;
+  }
+  const defaultXAxisId = xAxes.axisIds[0];
+  const defaultYAxisId = yAxes.axisIds[0];
+  const result = new Map();
+  const xMin = drawingArea.left - 1;
+  const xMax = drawingArea.left + drawingArea.width;
+  const yMin = drawingArea.top - 1;
+  const yMax = drawingArea.top + drawingArea.height;
+  for (const seriesId of scatter.seriesOrder) {
+    const series = scatter.series[seriesId];
+    const xAxis = xAxes.axis[series.xAxisId ?? defaultXAxisId];
+    const yAxis = yAxes.axis[series.yAxisId ?? defaultYAxisId];
+    if (xAxis === undefined || yAxis === undefined) {
+      continue;
+    }
+    const getXPosition = getValueToPositionMapper(xAxis.scale);
+    const getYPosition = getValueToPositionMapper(yAxis.scale);
+    const data = series.data;
+    const n = data.length;
+    const packed = new Float64Array(n * 3);
+    let j = 0;
+    for (let i = 0; i < n; i += 1) {
+      const x = getXPosition(data[i].x);
+      if (!(x >= xMin && x <= xMax)) {
+        continue;
+      }
+      const y = getYPosition(data[i].y);
+      if (!(y >= yMin && y <= yMax)) {
+        continue;
+      }
+      packed[j] = x;
+      packed[j + 1] = y;
+      packed[j + 2] = i;
+      j += 3;
+    }
+    const coords = packed.slice(0, j);
+    result.set(seriesId, {
+      coords,
+      count: j / 3
+    });
+  }
+  return result;
+});
+
+/**
+ * Render data for a single scatter series, or `undefined` while it is not
+ * available yet (processors/axes still pending).
+ */
+export const selectorScatterSeriesRenderData = createSelector(selectorScatterRenderData, (renderData, seriesId) => renderData.get(seriesId));
+
+/**
+ * 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 function getScatterBatchView(renderData, start, end) {
+  return renderData.coords.subarray(start * 3, end * 3);
+}

package/SparkLineChart/SparkLineChart.js

@@ -255,7 +255,8 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    * Options to enable features planned for the next major.
    */
   experimentalFeatures: _propTypes.default.shape({
-    enablePositionBasedPointerInteraction: _propTypes.default.bool
+    enablePositionBasedPointerInteraction: _propTypes.default.bool,
+    progressiveRendering: _propTypes.default.bool
   }),
   /**
    * The height of the chart in px. If not defined, it takes the height of the parent element.

package/SparkLineChart/SparkLineChart.mjs

@@ -248,7 +248,8 @@ process.env.NODE_ENV !== "production" ? SparkLineChart.propTypes = {
    * Options to enable features planned for the next major.
    */
   experimentalFeatures: PropTypes.shape({
-    enablePositionBasedPointerInteraction: PropTypes.bool
+    enablePositionBasedPointerInteraction: PropTypes.bool,
+    progressiveRendering: PropTypes.bool
   }),
   /**
    * The height of the chart in px. If not defined, it takes the height of the parent element.

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v9.4.0
+ * @mui/x-charts v9.5.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v9.4.0
+ * @mui/x-charts v9.5.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/getSeriesColorFn.d.mts

@@ -1,6 +1,6 @@
-import { type CommonSeriesType, type ColorCallbackValue } from "../models/seriesType/common.mjs";
-import { type ChartSeriesType } from "../models/seriesType/config.mjs";
-export declare function getSeriesColorFn<TValue>(series: {
-  color: NonNullable<CommonSeriesType<TValue, ChartSeriesType>['color']>;
-  colorGetter?: CommonSeriesType<TValue, ChartSeriesType>['colorGetter'];
+import { type ColorCallbackValue, type SeriesColor } from "../models/seriesType/common.mjs";
+import { type ChartSeriesType, type ChartsSeriesConfig } from "../models/seriesType/config.mjs";
+export declare function getSeriesColorFn<TValue extends ChartsSeriesConfig[ChartSeriesType]['valueType']>(series: {
+  color: NonNullable<SeriesColor<TValue>['color']>;
+  colorGetter?: SeriesColor<TValue>['colorGetter'];
 }): (data: ColorCallbackValue<TValue>) => string;

package/internals/getSeriesColorFn.d.ts

@@ -1,6 +1,6 @@
-import { type CommonSeriesType, type ColorCallbackValue } from "../models/seriesType/common.js";
-import { type ChartSeriesType } from "../models/seriesType/config.js";
-export declare function getSeriesColorFn<TValue>(series: {
-  color: NonNullable<CommonSeriesType<TValue, ChartSeriesType>['color']>;
-  colorGetter?: CommonSeriesType<TValue, ChartSeriesType>['colorGetter'];
+import { type ColorCallbackValue, type SeriesColor } from "../models/seriesType/common.js";
+import { type ChartSeriesType, type ChartsSeriesConfig } from "../models/seriesType/config.js";
+export declare function getSeriesColorFn<TValue extends ChartsSeriesConfig[ChartSeriesType]['valueType']>(series: {
+  color: NonNullable<SeriesColor<TValue>['color']>;
+  colorGetter?: SeriesColor<TValue>['colorGetter'];
 }): (data: ColorCallbackValue<TValue>) => string;

package/internals/index.d.mts

@@ -38,6 +38,7 @@ export * from "./plugins/featurePlugins/useChartKeyboardNavigation/index.mjs";
 export * from "./plugins/featurePlugins/useChartClosestPoint/index.mjs";
 export * from "./plugins/featurePlugins/useChartBrush/index.mjs";
 export * from "./plugins/featurePlugins/useChartItemClick/index.mjs";
+export * from "./plugins/featurePlugins/useProgressiveRendering/index.mjs";
 export * from "./plugins/utils/selectors.mjs";
 export { getAxisTriggerTooltip as getCartesianAxisTriggerTooltip } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisTriggerTooltip.mjs";
 export { getAxisIndex as getCartesianAxisIndex } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisValue.mjs";

package/internals/index.d.ts

@@ -38,6 +38,7 @@ export * from "./plugins/featurePlugins/useChartKeyboardNavigation/index.js";
 export * from "./plugins/featurePlugins/useChartClosestPoint/index.js";
 export * from "./plugins/featurePlugins/useChartBrush/index.js";
 export * from "./plugins/featurePlugins/useChartItemClick/index.js";
+export * from "./plugins/featurePlugins/useProgressiveRendering/index.js";
 export * from "./plugins/utils/selectors.js";
 export { getAxisTriggerTooltip as getCartesianAxisTriggerTooltip } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisTriggerTooltip.js";
 export { getAxisIndex as getCartesianAxisIndex } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisValue.js";

package/internals/index.js

@@ -541,6 +541,18 @@ Object.keys(_useChartItemClick).forEach(function (key) {
     }
   });
 });
+var _useProgressiveRendering = require("./plugins/featurePlugins/useProgressiveRendering");
+Object.keys(_useProgressiveRendering).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useProgressiveRendering[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useProgressiveRendering[key];
+    }
+  });
+});
 var _selectors = require("./plugins/utils/selectors");
 Object.keys(_selectors).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/internals/index.mjs

@@ -42,6 +42,7 @@ export * from "./plugins/featurePlugins/useChartKeyboardNavigation/index.mjs";
 export * from "./plugins/featurePlugins/useChartClosestPoint/index.mjs";
 export * from "./plugins/featurePlugins/useChartBrush/index.mjs";
 export * from "./plugins/featurePlugins/useChartItemClick/index.mjs";
+export * from "./plugins/featurePlugins/useProgressiveRendering/index.mjs";
 export * from "./plugins/utils/selectors.mjs";
 export { getAxisTriggerTooltip as getCartesianAxisTriggerTooltip } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisTriggerTooltip.mjs";
 export { getAxisIndex as getCartesianAxisIndex } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisValue.mjs";

package/internals/plugins/allPlugins.d.mts

@@ -9,6 +9,7 @@ import { type UseChartZAxisSignature } from "./featurePlugins/useChartZAxis/inde
 import { type UseChartBrushSignature } from "./featurePlugins/useChartBrush/index.mjs";
 import { type UseChartVisibilityManagerSignature } from "./featurePlugins/useChartVisibilityManager/index.mjs";
 import { type UseChartTooltipSignature } from "./featurePlugins/useChartTooltip/index.mjs";
-export type AllPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartPolarAxisSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export type DefaultPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export declare const DEFAULT_PLUGINS: readonly [import("./models/index.mjs").ChartPlugin<UseChartZAxisSignature>, import("./models/index.mjs").ChartPlugin<UseChartBrushSignature>, import("./models/index.mjs").ChartPlugin<UseChartTooltipSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartInteractionSignature>, import("./models/index.mjs").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartHighlightSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartVisibilityManagerSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.mjs").ChartPlugin<UseChartKeyboardNavigationSignature>];
+import { type UseProgressiveRenderingSignature } from "./featurePlugins/useProgressiveRendering/index.mjs";
+export type AllPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartPolarAxisSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
+export type DefaultPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
+export declare const DEFAULT_PLUGINS: readonly [import("./models/index.mjs").ChartPlugin<UseChartZAxisSignature>, import("./models/index.mjs").ChartPlugin<UseChartBrushSignature>, import("./models/index.mjs").ChartPlugin<UseChartTooltipSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartInteractionSignature>, import("./models/index.mjs").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartHighlightSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartVisibilityManagerSignature<any>>, import("./models/index.mjs").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.mjs").ChartPlugin<UseChartKeyboardNavigationSignature>, import("./models/index.mjs").ChartPlugin<UseProgressiveRenderingSignature>];

package/internals/plugins/allPlugins.d.ts

@@ -9,6 +9,7 @@ import { type UseChartZAxisSignature } from "./featurePlugins/useChartZAxis/inde
 import { type UseChartBrushSignature } from "./featurePlugins/useChartBrush/index.js";
 import { type UseChartVisibilityManagerSignature } from "./featurePlugins/useChartVisibilityManager/index.js";
 import { type UseChartTooltipSignature } from "./featurePlugins/useChartTooltip/index.js";
-export type AllPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartPolarAxisSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export type DefaultPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export declare const DEFAULT_PLUGINS: readonly [import("./models/index.js").ChartPlugin<UseChartZAxisSignature>, import("./models/index.js").ChartPlugin<UseChartBrushSignature>, import("./models/index.js").ChartPlugin<UseChartTooltipSignature<any>>, import("./models/index.js").ChartPlugin<UseChartInteractionSignature>, import("./models/index.js").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.js").ChartPlugin<UseChartHighlightSignature<any>>, import("./models/index.js").ChartPlugin<UseChartVisibilityManagerSignature<any>>, import("./models/index.js").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.js").ChartPlugin<UseChartKeyboardNavigationSignature>];
+import { type UseProgressiveRenderingSignature } from "./featurePlugins/useProgressiveRendering/index.js";
+export type AllPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartPolarAxisSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
+export type DefaultPluginSignatures<SeriesType extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature<SeriesType>, UseChartInteractionSignature, UseChartCartesianAxisSignature<SeriesType>, UseChartHighlightSignature<SeriesType>, UseChartVisibilityManagerSignature<SeriesType>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseProgressiveRenderingSignature];
+export declare const DEFAULT_PLUGINS: readonly [import("./models/index.js").ChartPlugin<UseChartZAxisSignature>, import("./models/index.js").ChartPlugin<UseChartBrushSignature>, import("./models/index.js").ChartPlugin<UseChartTooltipSignature<any>>, import("./models/index.js").ChartPlugin<UseChartInteractionSignature>, import("./models/index.js").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.js").ChartPlugin<UseChartHighlightSignature<any>>, import("./models/index.js").ChartPlugin<UseChartVisibilityManagerSignature<any>>, import("./models/index.js").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.js").ChartPlugin<UseChartKeyboardNavigationSignature>, import("./models/index.js").ChartPlugin<UseProgressiveRenderingSignature>];

package/internals/plugins/allPlugins.js

@@ -13,6 +13,7 @@ var _useChartZAxis = require("./featurePlugins/useChartZAxis");
 var _useChartBrush = require("./featurePlugins/useChartBrush");
 var _useChartVisibilityManager = require("./featurePlugins/useChartVisibilityManager");
 var _useChartTooltip = require("./featurePlugins/useChartTooltip");
+var _useProgressiveRendering = require("./featurePlugins/useProgressiveRendering");
 // This file should be removed after creating all plugins in favor of a file per chart type.
 
-const DEFAULT_PLUGINS = exports.DEFAULT_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartBrush.useChartBrush, _useChartTooltip.useChartTooltip, _useChartInteraction.useChartInteraction, _useChartCartesianAxis.useChartCartesianAxis, _useChartHighlight.useChartHighlight, _useChartVisibilityManager.useChartVisibilityManager, _useChartClosestPoint.useChartClosestPoint, _useChartKeyboardNavigation.useChartKeyboardNavigation];
+const DEFAULT_PLUGINS = exports.DEFAULT_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartBrush.useChartBrush, _useChartTooltip.useChartTooltip, _useChartInteraction.useChartInteraction, _useChartCartesianAxis.useChartCartesianAxis, _useChartHighlight.useChartHighlight, _useChartVisibilityManager.useChartVisibilityManager, _useChartClosestPoint.useChartClosestPoint, _useChartKeyboardNavigation.useChartKeyboardNavigation, _useProgressiveRendering.useProgressiveRendering];

package/internals/plugins/allPlugins.mjs

@@ -9,4 +9,5 @@ import { useChartZAxis } from "./featurePlugins/useChartZAxis/index.mjs";
 import { useChartBrush } from "./featurePlugins/useChartBrush/index.mjs";
 import { useChartVisibilityManager } from "./featurePlugins/useChartVisibilityManager/index.mjs";
 import { useChartTooltip } from "./featurePlugins/useChartTooltip/index.mjs";
-export const DEFAULT_PLUGINS = [useChartZAxis, useChartBrush, useChartTooltip, useChartInteraction, useChartCartesianAxis, useChartHighlight, useChartVisibilityManager, useChartClosestPoint, useChartKeyboardNavigation];
+import { useProgressiveRendering } from "./featurePlugins/useProgressiveRendering/index.mjs";
+export const DEFAULT_PLUGINS = [useChartZAxis, useChartBrush, useChartTooltip, useChartInteraction, useChartCartesianAxis, useChartHighlight, useChartVisibilityManager, useChartClosestPoint, useChartKeyboardNavigation, useProgressiveRendering];

package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.d.mts

@@ -1,4 +1,13 @@
 import type { ChartSeriesType } from "../../../../models/seriesType/config.mjs";
-import { type ChartRootSelector } from "../../utils/selectors.mjs";
-import type { UseChartExperimentalFeaturesSignature } from "./useChartExperimentalFeature.types.mjs";
-export declare const selectorChartExperimentalFeaturesState: ChartRootSelector<UseChartExperimentalFeaturesSignature<ChartSeriesType>>;
+import { type ChartState } from "../../models/chart.mjs";
+import type { ChartExperimentalFeatures, UseChartExperimentalFeaturesSignature } from "./useChartExperimentalFeature.types.mjs";
+/**
+ * Reads the value of a single experimental feature flag from the store.
+ *
+ * @example
+ * const enabled = store.use(
+ *   selectorChartExperimentalFeaturesState,
+ *   'progressiveRendering',
+ * );
+ */
+export declare const selectorChartExperimentalFeaturesState: <K extends keyof ChartExperimentalFeatures>(state: ChartState<[UseChartExperimentalFeaturesSignature<ChartSeriesType>]>, featureName: K) => ChartExperimentalFeatures[K] | undefined;

package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.d.ts

@@ -1,4 +1,13 @@
 import type { ChartSeriesType } from "../../../../models/seriesType/config.js";
-import { type ChartRootSelector } from "../../utils/selectors.js";
-import type { UseChartExperimentalFeaturesSignature } from "./useChartExperimentalFeature.types.js";
-export declare const selectorChartExperimentalFeaturesState: ChartRootSelector<UseChartExperimentalFeaturesSignature<ChartSeriesType>>;
+import { type ChartState } from "../../models/chart.js";
+import type { ChartExperimentalFeatures, UseChartExperimentalFeaturesSignature } from "./useChartExperimentalFeature.types.js";
+/**
+ * Reads the value of a single experimental feature flag from the store.
+ *
+ * @example
+ * const enabled = store.use(
+ *   selectorChartExperimentalFeaturesState,
+ *   'progressiveRendering',
+ * );
+ */
+export declare const selectorChartExperimentalFeaturesState: <K extends keyof ChartExperimentalFeatures>(state: ChartState<[UseChartExperimentalFeaturesSignature<ChartSeriesType>]>, featureName: K) => ChartExperimentalFeatures[K] | undefined;

package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.js

@@ -4,5 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.selectorChartExperimentalFeaturesState = void 0;
-const selectorChartExperimentalFeaturesState = state => state.experimentalFeatures;
+/**
+ * Reads the value of a single experimental feature flag from the store.
+ *
+ * @example
+ * const enabled = store.use(
+ *   selectorChartExperimentalFeaturesState,
+ *   'progressiveRendering',
+ * );
+ */
+const selectorChartExperimentalFeaturesState = (state, featureName) => state.experimentalFeatures?.[featureName];
 exports.selectorChartExperimentalFeaturesState = selectorChartExperimentalFeaturesState;

package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.mjs

@@ -1 +1,10 @@
-export const selectorChartExperimentalFeaturesState = state => state.experimentalFeatures;
+/**
+ * Reads the value of a single experimental feature flag from the store.
+ *
+ * @example
+ * const enabled = store.use(
+ *   selectorChartExperimentalFeaturesState,
+ *   'progressiveRendering',
+ * );
+ */
+export const selectorChartExperimentalFeaturesState = (state, featureName) => state.experimentalFeatures?.[featureName];

package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.d.mts

@@ -13,7 +13,21 @@ interface LineExperimentalFeatures {
    */
   enablePositionBasedPointerInteraction?: boolean;
 }
-export type ChartExperimentalFeatures<SeriesType extends ChartSeriesType = ChartSeriesType> = 'line' extends SeriesType ? LineExperimentalFeatures : {};
+interface ScatterExperimentalFeatures {
+  /**
+   * Enables automatic progressive (batched) rendering for scatter series.
+   *
+   * When enabled and the `renderer` prop is left unset, the chart switches to
+   * the `svg-progressive` renderer above an internal point-count threshold,
+   * painting points over several animation frames to keep the main thread
+   * responsive. When disabled, the unset `renderer` keeps the synchronous
+   * `svg-single` renderer. Setting `renderer` explicitly is unaffected.
+   *
+   * This behavior will become the default in the next major version.
+   */
+  progressiveRendering?: boolean;
+}
+export type ChartExperimentalFeatures<SeriesType extends ChartSeriesType = ChartSeriesType> = ('line' extends SeriesType ? LineExperimentalFeatures : {}) & ('scatter' extends SeriesType ? ScatterExperimentalFeatures : {});
 export interface UseChartExperimentalFeaturesParameters<SeriesType extends ChartSeriesType = ChartSeriesType> {
   /**
    * Options to enable features planned for the next major.