@mui/x-charts 9.3.0 → 9.5.0

package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.js

@@ -11,6 +11,7 @@ var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/form
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var React = _interopRequireWildcard(require("react"));
 var _colorScale = require("../../../colorScale");
+var _sizeScale = require("../../../sizeScale");
 function addDefaultId(axisConfig, defaultId) {
   if (axisConfig.id !== undefined) {
     return axisConfig;
@@ -32,6 +33,19 @@ function processColorMap(axisConfig) {
     }, axisConfig.colorMap) : axisConfig.colorMap)
   });
 }
+function processSizeMap(axisConfig) {
+  if (!axisConfig.sizeMap) {
+    return axisConfig;
+  }
+  return (0, _extends2.default)({}, axisConfig, {
+    sizeScale: axisConfig.sizeMap.type === 'ordinal' ? (0, _sizeScale.getOrdinalSizeScale)((0, _extends2.default)({
+      values: axisConfig.data
+    }, axisConfig.sizeMap)) : (0, _sizeScale.getSizeScale)(axisConfig.sizeMap.type === 'continuous' ? (0, _extends2.default)({
+      min: axisConfig.min,
+      max: axisConfig.max
+    }, axisConfig.sizeMap) : axisConfig.sizeMap)
+  });
+}
 function getZAxisState(zAxis, dataset) {
   if (!zAxis || zAxis.length === 0) {
     return {
@@ -45,16 +59,16 @@ function getZAxisState(zAxis, dataset) {
     const dataKey = axisConfig.dataKey;
     const defaultizedId = axisConfig.id ?? `defaultized-z-axis-${index}`;
     if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
-      zAxisLookup[defaultizedId] = processColorMap(addDefaultId(axisConfig, defaultizedId));
+      zAxisLookup[defaultizedId] = processSizeMap(processColorMap(addDefaultId(axisConfig, defaultizedId)));
       axisIds.push(defaultizedId);
       return;
     }
     if (dataset === undefined) {
       throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` or `valueGetter` but no `dataset` is provided. ' + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : (0, _formatErrorMessage2.default)(41));
     }
-    zAxisLookup[defaultizedId] = processColorMap(addDefaultId((0, _extends2.default)({}, axisConfig, {
+    zAxisLookup[defaultizedId] = processSizeMap(processColorMap(addDefaultId((0, _extends2.default)({}, axisConfig, {
       data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
-    }), defaultizedId));
+    }), defaultizedId)));
     axisIds.push(defaultizedId);
   });
   return {

package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.mjs

@@ -4,6 +4,7 @@ import _formatErrorMessage from "@mui/x-internals/formatErrorMessage";
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import { getColorScale, getOrdinalColorScale } from "../../../colorScale.mjs";
+import { getSizeScale, getOrdinalSizeScale } from "../../../sizeScale.mjs";
 function addDefaultId(axisConfig, defaultId) {
   if (axisConfig.id !== undefined) {
     return axisConfig;
@@ -25,6 +26,19 @@ function processColorMap(axisConfig) {
     }, axisConfig.colorMap) : axisConfig.colorMap)
   });
 }
+function processSizeMap(axisConfig) {
+  if (!axisConfig.sizeMap) {
+    return axisConfig;
+  }
+  return _extends({}, axisConfig, {
+    sizeScale: axisConfig.sizeMap.type === 'ordinal' ? getOrdinalSizeScale(_extends({
+      values: axisConfig.data
+    }, axisConfig.sizeMap)) : getSizeScale(axisConfig.sizeMap.type === 'continuous' ? _extends({
+      min: axisConfig.min,
+      max: axisConfig.max
+    }, axisConfig.sizeMap) : axisConfig.sizeMap)
+  });
+}
 function getZAxisState(zAxis, dataset) {
   if (!zAxis || zAxis.length === 0) {
     return {
@@ -38,16 +52,16 @@ function getZAxisState(zAxis, dataset) {
     const dataKey = axisConfig.dataKey;
     const defaultizedId = axisConfig.id ?? `defaultized-z-axis-${index}`;
     if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
-      zAxisLookup[defaultizedId] = processColorMap(addDefaultId(axisConfig, defaultizedId));
+      zAxisLookup[defaultizedId] = processSizeMap(processColorMap(addDefaultId(axisConfig, defaultizedId)));
       axisIds.push(defaultizedId);
       return;
     }
     if (dataset === undefined) {
       throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` or `valueGetter` but no `dataset` is provided. ' + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : _formatErrorMessage(41));
     }
-    zAxisLookup[defaultizedId] = processColorMap(addDefaultId(_extends({}, axisConfig, {
+    zAxisLookup[defaultizedId] = processSizeMap(processColorMap(addDefaultId(_extends({}, axisConfig, {
       data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
-    }), defaultizedId));
+    }), defaultizedId)));
     axisIds.push(defaultizedId);
   });
   return {

package/internals/plugins/featurePlugins/useProgressiveRendering/index.d.mts

@@ -0,0 +1,3 @@
+export { useProgressiveRendering } from "./useProgressiveRendering.mjs";
+export type { UseProgressiveRenderingSignature, UseProgressiveRenderingInstance, UseProgressiveRenderingState } from "./useProgressiveRendering.types.mjs";
+export * from "./useProgressiveRendering.selectors.mjs";

package/internals/plugins/featurePlugins/useProgressiveRendering/index.d.ts

@@ -0,0 +1,3 @@
+export { useProgressiveRendering } from "./useProgressiveRendering.js";
+export type { UseProgressiveRenderingSignature, UseProgressiveRenderingInstance, UseProgressiveRenderingState } from "./useProgressiveRendering.types.js";
+export * from "./useProgressiveRendering.selectors.js";

package/internals/plugins/featurePlugins/useProgressiveRendering/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  useProgressiveRendering: true
+};
+Object.defineProperty(exports, "useProgressiveRendering", {
+  enumerable: true,
+  get: function () {
+    return _useProgressiveRendering.useProgressiveRendering;
+  }
+});
+var _useProgressiveRendering = require("./useProgressiveRendering");
+var _useProgressiveRendering2 = require("./useProgressiveRendering.selectors");
+Object.keys(_useProgressiveRendering2).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useProgressiveRendering2[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useProgressiveRendering2[key];
+    }
+  });
+});

package/internals/plugins/featurePlugins/useProgressiveRendering/index.mjs

@@ -0,0 +1,2 @@
+export { useProgressiveRendering } from "./useProgressiveRendering.mjs";
+export * from "./useProgressiveRendering.selectors.mjs";

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.d.mts

@@ -0,0 +1,13 @@
+import { type ChartPlugin } from "../../models/index.mjs";
+import { type UseProgressiveRenderingSignature } from "./useProgressiveRendering.types.mjs";
+/**
+ * Chart-wide progressive rendering coordinator.
+ *
+ * Lives on the chart store, so every renderer composed into the same chart
+ * (e.g. several `ScatterPlot` instances under one `ChartsContainer`) shares
+ * the same scheduler. Each renderer registers a plan via
+ * `setProgressivePlan(plotId, plan)`; the plugin aggregates them, computes a
+ * single per-tick budget, and ramps a global "rounds" counter — one round
+ * adds one batch in every registered series at once.
+ */
+export declare const useProgressiveRendering: ChartPlugin<UseProgressiveRenderingSignature>;

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.d.ts

@@ -0,0 +1,13 @@
+import { type ChartPlugin } from "../../models/index.js";
+import { type UseProgressiveRenderingSignature } from "./useProgressiveRendering.types.js";
+/**
+ * Chart-wide progressive rendering coordinator.
+ *
+ * Lives on the chart store, so every renderer composed into the same chart
+ * (e.g. several `ScatterPlot` instances under one `ChartsContainer`) shares
+ * the same scheduler. Each renderer registers a plan via
+ * `setProgressivePlan(plotId, plan)`; the plugin aggregates them, computes a
+ * single per-tick budget, and ramps a global "rounds" counter — one round
+ * adds one batch in every registered series at once.
+ */
+export declare const useProgressiveRendering: ChartPlugin<UseProgressiveRenderingSignature>;

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.js

@@ -0,0 +1,136 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useProgressiveRendering = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var React = _interopRequireWildcard(require("react"));
+var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
+var _useProgressiveRendering = require("./useProgressiveRendering.selectors");
+const EMPTY_PLANS = new Map();
+
+/**
+ * How many *rounds* are revealed per reveal tick once the render data is ready.
+ * A round reveals one batch in every series simultaneously, so the chart looks
+ * complete from the first paint rather than appearing series-by-series. Lower
+ * spreads the paint over more ticks (smoother, more visibly progressive);
+ * higher finishes sooner.
+ */
+const REVEAL_ROUNDS_PER_FRAME = 1;
+
+/**
+ * How many animation frames are skipped between two reveal ticks. `0` reveals
+ * on every frame; `1` reveals every other frame, leaving the browser an idle
+ * frame for layout, paint and input handling between commits. Higher values
+ * give the browser more CPU headroom at the cost of a slower paint.
+ */
+const REVEAL_FRAMES_SKIPPED = 0;
+
+/**
+ * Chart-wide progressive rendering coordinator.
+ *
+ * Lives on the chart store, so every renderer composed into the same chart
+ * (e.g. several `ScatterPlot` instances under one `ChartsContainer`) shares
+ * the same scheduler. Each renderer registers a plan via
+ * `setProgressivePlan(plotId, plan)`; the plugin aggregates them, computes a
+ * single per-tick budget, and ramps a global "rounds" counter — one round
+ * adds one batch in every registered series at once.
+ */
+const useProgressiveRendering = ({
+  store
+}) => {
+  const registerProgressivePlan = (0, _useEventCallback.default)((plotId, seriesIds, renderer) => {
+    if (!(0, _useProgressiveRendering.selectorShouldUseProgressiveRenderer)(store.state, seriesIds, renderer)) {
+      return undefined;
+    }
+    const current = store.state.progressiveRendering.plans.get(plotId);
+    if (!(0, _useProgressiveRendering.sameSeriesIds)(current, seriesIds)) {
+      const nextPlans = new Map(store.state.progressiveRendering.plans);
+      nextPlans.set(plotId, seriesIds);
+      // A real plan change restarts the progressive paint.
+      store.set('progressiveRendering', {
+        plans: nextPlans,
+        revealedRounds: 0
+      });
+    }
+    return () => {
+      if (!store.state.progressiveRendering.plans.has(plotId)) {
+        return;
+      }
+      const nextPlans = new Map(store.state.progressiveRendering.plans);
+      nextPlans.delete(plotId);
+      store.set('progressiveRendering', (0, _extends2.default)({}, store.state.progressiveRendering, {
+        plans: nextPlans
+      }));
+    };
+  });
+  const plans = store.use(_useProgressiveRendering.selectorProgressivePlans) ?? EMPTY_PLANS;
+  React.useEffect(() => {
+    const startTotal = (0, _useProgressiveRendering.selectorProgressiveTotalRounds)(store.state);
+    if (startTotal === 0) {
+      return undefined;
+    }
+    if (typeof requestAnimationFrame !== 'function') {
+      store.set('progressiveRendering', (0, _extends2.default)({}, store.state.progressiveRendering, {
+        revealedRounds: startTotal
+      }));
+      return undefined;
+    }
+    let frame = 0;
+    let cancelled = false;
+    // Tracked in a closure variable, not derived inside a state updater (those
+    // must be pure and StrictMode double-invokes them, which would schedule
+    // the animation-frame chain twice).
+    let revealed = 0;
+    function scheduleNext() {
+      let remaining = REVEAL_FRAMES_SKIPPED;
+      const tick = () => {
+        if (cancelled) {
+          return;
+        }
+        if (remaining > 0) {
+          remaining -= 1;
+          frame = requestAnimationFrame(tick);
+          return;
+        }
+        step();
+      };
+      frame = requestAnimationFrame(tick);
+    }
+    function step() {
+      if (cancelled) {
+        return;
+      }
+      const total = (0, _useProgressiveRendering.selectorProgressiveTotalRounds)(store.state);
+      revealed = Math.min(total, revealed + REVEAL_ROUNDS_PER_FRAME);
+      store.set('progressiveRendering', (0, _extends2.default)({}, store.state.progressiveRendering, {
+        revealedRounds: revealed
+      }));
+      if (revealed < total) {
+        scheduleNext();
+      }
+    }
+    frame = requestAnimationFrame(step);
+    return () => {
+      cancelled = true;
+      cancelAnimationFrame(frame);
+    };
+  }, [plans, store]);
+  return {
+    instance: {
+      registerProgressivePlan
+    }
+  };
+};
+exports.useProgressiveRendering = useProgressiveRendering;
+useProgressiveRendering.params = {};
+useProgressiveRendering.getInitialState = () => ({
+  progressiveRendering: {
+    plans: EMPTY_PLANS,
+    revealedRounds: 0
+  }
+});

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.mjs

@@ -0,0 +1,128 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import useEventCallback from '@mui/utils/useEventCallback';
+import { sameSeriesIds, selectorProgressivePlans, selectorProgressiveTotalRounds, selectorShouldUseProgressiveRenderer } from "./useProgressiveRendering.selectors.mjs";
+const EMPTY_PLANS = new Map();
+
+/**
+ * How many *rounds* are revealed per reveal tick once the render data is ready.
+ * A round reveals one batch in every series simultaneously, so the chart looks
+ * complete from the first paint rather than appearing series-by-series. Lower
+ * spreads the paint over more ticks (smoother, more visibly progressive);
+ * higher finishes sooner.
+ */
+const REVEAL_ROUNDS_PER_FRAME = 1;
+
+/**
+ * How many animation frames are skipped between two reveal ticks. `0` reveals
+ * on every frame; `1` reveals every other frame, leaving the browser an idle
+ * frame for layout, paint and input handling between commits. Higher values
+ * give the browser more CPU headroom at the cost of a slower paint.
+ */
+const REVEAL_FRAMES_SKIPPED = 0;
+
+/**
+ * Chart-wide progressive rendering coordinator.
+ *
+ * Lives on the chart store, so every renderer composed into the same chart
+ * (e.g. several `ScatterPlot` instances under one `ChartsContainer`) shares
+ * the same scheduler. Each renderer registers a plan via
+ * `setProgressivePlan(plotId, plan)`; the plugin aggregates them, computes a
+ * single per-tick budget, and ramps a global "rounds" counter — one round
+ * adds one batch in every registered series at once.
+ */
+export const useProgressiveRendering = ({
+  store
+}) => {
+  const registerProgressivePlan = useEventCallback((plotId, seriesIds, renderer) => {
+    if (!selectorShouldUseProgressiveRenderer(store.state, seriesIds, renderer)) {
+      return undefined;
+    }
+    const current = store.state.progressiveRendering.plans.get(plotId);
+    if (!sameSeriesIds(current, seriesIds)) {
+      const nextPlans = new Map(store.state.progressiveRendering.plans);
+      nextPlans.set(plotId, seriesIds);
+      // A real plan change restarts the progressive paint.
+      store.set('progressiveRendering', {
+        plans: nextPlans,
+        revealedRounds: 0
+      });
+    }
+    return () => {
+      if (!store.state.progressiveRendering.plans.has(plotId)) {
+        return;
+      }
+      const nextPlans = new Map(store.state.progressiveRendering.plans);
+      nextPlans.delete(plotId);
+      store.set('progressiveRendering', _extends({}, store.state.progressiveRendering, {
+        plans: nextPlans
+      }));
+    };
+  });
+  const plans = store.use(selectorProgressivePlans) ?? EMPTY_PLANS;
+  React.useEffect(() => {
+    const startTotal = selectorProgressiveTotalRounds(store.state);
+    if (startTotal === 0) {
+      return undefined;
+    }
+    if (typeof requestAnimationFrame !== 'function') {
+      store.set('progressiveRendering', _extends({}, store.state.progressiveRendering, {
+        revealedRounds: startTotal
+      }));
+      return undefined;
+    }
+    let frame = 0;
+    let cancelled = false;
+    // Tracked in a closure variable, not derived inside a state updater (those
+    // must be pure and StrictMode double-invokes them, which would schedule
+    // the animation-frame chain twice).
+    let revealed = 0;
+    function scheduleNext() {
+      let remaining = REVEAL_FRAMES_SKIPPED;
+      const tick = () => {
+        if (cancelled) {
+          return;
+        }
+        if (remaining > 0) {
+          remaining -= 1;
+          frame = requestAnimationFrame(tick);
+          return;
+        }
+        step();
+      };
+      frame = requestAnimationFrame(tick);
+    }
+    function step() {
+      if (cancelled) {
+        return;
+      }
+      const total = selectorProgressiveTotalRounds(store.state);
+      revealed = Math.min(total, revealed + REVEAL_ROUNDS_PER_FRAME);
+      store.set('progressiveRendering', _extends({}, store.state.progressiveRendering, {
+        revealedRounds: revealed
+      }));
+      if (revealed < total) {
+        scheduleNext();
+      }
+    }
+    frame = requestAnimationFrame(step);
+    return () => {
+      cancelled = true;
+      cancelAnimationFrame(frame);
+    };
+  }, [plans, store]);
+  return {
+    instance: {
+      registerProgressivePlan
+    }
+  };
+};
+useProgressiveRendering.params = {};
+useProgressiveRendering.getInitialState = () => ({
+  progressiveRendering: {
+    plans: EMPTY_PLANS,
+    revealedRounds: 0
+  }
+});

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.selectors.d.mts

@@ -0,0 +1,42 @@
+import { type SeriesId } from "../../../../models/seriesType/common.mjs";
+import type { RendererType } from "../../../../ScatterChart/index.mjs";
+/** Map of registered plots → their set of series ids. */
+export declare const selectorProgressivePlans: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => ReadonlyMap<string, readonly string[]> | undefined;
+/** Total number of rounds revealed across all plots so far. */
+export declare const selectorProgressiveRevealedRounds: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => number;
+/**
+ * Aggregated view of every registered plan: the per-series batch counts, the
+ * total number of rounds, and the per-series batch size (so every consumer
+ * sizes its batches the same way). Point counts are read straight from the
+ * processed series rather than carried by the registration.
+ */
+export declare const selectorProgressiveAggregate: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => {
+  nBatchesBySeries: Map<string, number>;
+  totalRounds: number;
+  batchSize: number;
+};
+export declare const selectorProgressiveBatchSize: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => number;
+export declare const selectorProgressiveTotalRounds: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => number;
+/**
+ * How many of `seriesId`'s own batches are revealed so far. Capped at that
+ * series' total batch count, so series with fewer batches simply stop
+ * progressing while longer ones keep filling in.
+ */
+export declare const selectorProgressiveSeriesRevealedBatches: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.mjs").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}, seriesId: string) => number;
+export declare const selectorShouldUseProgressiveRenderer: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}, seriesIds: readonly string[], renderer: RendererType | "svg-progressive" | undefined) => boolean;
+/** Order-sensitive equality between two registered series-id sets. */
+export declare function sameSeriesIds(a: readonly SeriesId[] | undefined, b: readonly SeriesId[]): boolean;

package/internals/plugins/featurePlugins/useProgressiveRendering/useProgressiveRendering.selectors.d.ts

@@ -0,0 +1,42 @@
+import { type SeriesId } from "../../../../models/seriesType/common.js";
+import type { RendererType } from "../../../../ScatterChart/index.js";
+/** Map of registered plots → their set of series ids. */
+export declare const selectorProgressivePlans: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => ReadonlyMap<string, readonly string[]> | undefined;
+/** Total number of rounds revealed across all plots so far. */
+export declare const selectorProgressiveRevealedRounds: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => number;
+/**
+ * Aggregated view of every registered plan: the per-series batch counts, the
+ * total number of rounds, and the per-series batch size (so every consumer
+ * sizes its batches the same way). Point counts are read straight from the
+ * processed series rather than carried by the registration.
+ */
+export declare const selectorProgressiveAggregate: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => {
+  nBatchesBySeries: Map<string, number>;
+  totalRounds: number;
+  batchSize: number;
+};
+export declare const selectorProgressiveBatchSize: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => number;
+export declare const selectorProgressiveTotalRounds: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => number;
+/**
+ * How many of `seriesId`'s own batches are revealed so far. Capped at that
+ * series' total batch count, so series with fewer batches simply stop
+ * progressing while longer ones keep filling in.
+ */
+export declare const selectorProgressiveSeriesRevealedBatches: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useProgressiveRendering.types.js").UseProgressiveRenderingState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}, seriesId: string) => number;
+export declare const selectorShouldUseProgressiveRenderer: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}, seriesIds: readonly string[], renderer: RendererType | "svg-progressive" | undefined) => boolean;
+/** Order-sensitive equality between two registered series-id sets. */
+export declare function sameSeriesIds(a: readonly SeriesId[] | undefined, b: readonly SeriesId[]): boolean;