@mui/x-charts 9.8.0 → 9.9.0

package/internals/index.mjs

@@ -22,6 +22,7 @@ export * from "../ChartsContainer/useChartsContainerProps.mjs";
 export * from "../ChartsDataProvider/useChartsDataProviderProps.mjs";
 export * from "../ChartsRadialDataProvider/useChartsRadialDataProviderProps.mjs";
 export * from "./seriesSelectorOfType.mjs";
+export * from "./createGetBarDimensions.mjs";
 export { useSkipAnimation } from "../hooks/useSkipAnimation.mjs";
 export { useRegisterPointerInteractions } from "./plugins/featurePlugins/shared/useRegisterPointerInteractions.mjs";
 
@@ -41,8 +42,6 @@ export * from "./plugins/featurePlugins/useChartVisibilityManager/index.mjs";
 export * from "./plugins/featurePlugins/useChartKeyboardNavigation/index.mjs";
 export * from "./plugins/featurePlugins/useChartClosestPoint/index.mjs";
 export * from "./plugins/featurePlugins/useChartBrush/index.mjs";
-export * as useGeoProjectionSelectors from "./plugins/featurePlugins/useGeoProjection/useGeoProjection.selectors.mjs";
-export * as useGeoProjectionTypes from "./plugins/featurePlugins/useGeoProjection/useGeoProjection.types.mjs";
 export * from "./plugins/featurePlugins/useChartItemClick/index.mjs";
 export * from "./plugins/featurePlugins/useProgressiveRendering/index.mjs";
 export * from "./plugins/utils/selectors.mjs";

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

@@ -32,13 +32,13 @@ export declare const selectorChartSeriesConfigGetter: (args_0: import("../useCha
   legendGetter: import("../useChartSeriesConfig/index.mjs").LegendGetter<"pie">;
   tooltipGetter: import("../useChartSeriesConfig/index.mjs").TooltipGetter<"pie">;
   ItemTooltipContent?: import("react").ComponentType<import("../useChartSeriesConfig/index.mjs").ItemTooltipContentProps<"pie">> | undefined;
-  tooltipItemPositionGetter?: import("../useChartSeriesConfig/index.mjs").TooltipItemPositionGetter<"pie"> | undefined;
-  selectorTooltipItemPosition?: import("../useChartSeriesConfig/index.mjs").TooltipItemPositionSelector;
+  selectorTooltipItemPosition?: import("../useChartSeriesConfig/index.mjs").TooltipItemPositionSelector<"pie"> | undefined;
   getSeriesWithDefaultValues: import("../useChartSeriesConfig/index.mjs").GetSeriesWithDefaultValues<"pie">;
   keyboardFocusHandler?: import("../../../index.mjs").KeyboardFocusHandler<"pie"> | undefined;
   identifierSerializer: import("../useChartSeriesConfig/index.mjs").IdentifierSerializer<"pie">;
   identifierCleaner: import("../useChartSeriesConfig/index.mjs").IdentifierCleaner<"pie">;
   getItemAtPosition?: import("../useChartSeriesConfig/index.mjs").GetItemAtPosition<"pie"> | undefined;
+  sampler?: import("../../../index.mjs").SamplingStrategy<"pie", unknown> | undefined;
   descriptionGetter: import("../useChartSeriesConfig/index.mjs").DescriptionGetter<"pie">;
   isHighlightedCreator: import("../../featurePlugins/useChartHighlight/highlightCreator.types.mjs").HighlightCreator<"pie">;
   isFadedCreator: import("../../featurePlugins/useChartHighlight/highlightCreator.types.mjs").HighlightCreator<"pie">;

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

@@ -32,13 +32,13 @@ export declare const selectorChartSeriesConfigGetter: (args_0: import("../useCha
   legendGetter: import("../useChartSeriesConfig/index.js").LegendGetter<"pie">;
   tooltipGetter: import("../useChartSeriesConfig/index.js").TooltipGetter<"pie">;
   ItemTooltipContent?: import("react").ComponentType<import("../useChartSeriesConfig/index.js").ItemTooltipContentProps<"pie">> | undefined;
-  tooltipItemPositionGetter?: import("../useChartSeriesConfig/index.js").TooltipItemPositionGetter<"pie"> | undefined;
-  selectorTooltipItemPosition?: import("../useChartSeriesConfig/index.js").TooltipItemPositionSelector;
+  selectorTooltipItemPosition?: import("../useChartSeriesConfig/index.js").TooltipItemPositionSelector<"pie"> | undefined;
   getSeriesWithDefaultValues: import("../useChartSeriesConfig/index.js").GetSeriesWithDefaultValues<"pie">;
   keyboardFocusHandler?: import("../../../index.js").KeyboardFocusHandler<"pie"> | undefined;
   identifierSerializer: import("../useChartSeriesConfig/index.js").IdentifierSerializer<"pie">;
   identifierCleaner: import("../useChartSeriesConfig/index.js").IdentifierCleaner<"pie">;
   getItemAtPosition?: import("../useChartSeriesConfig/index.js").GetItemAtPosition<"pie"> | undefined;
+  sampler?: import("../../../index.js").SamplingStrategy<"pie", unknown> | undefined;
   descriptionGetter: import("../useChartSeriesConfig/index.js").DescriptionGetter<"pie">;
   isHighlightedCreator: import("../../featurePlugins/useChartHighlight/highlightCreator.types.js").HighlightCreator<"pie">;
   isFadedCreator: import("../../featurePlugins/useChartHighlight/highlightCreator.types.js").HighlightCreator<"pie">;

package/internals/plugins/corePlugins/useChartSeriesConfig/types/index.d.mts

@@ -5,7 +5,7 @@ export * from "./seriesConfig.types.mjs";
 export * from "./seriesProcessor.types.mjs";
 export * from "./seriesLayout.types.mjs";
 export * from "./tooltipGetter.types.mjs";
-export * from "./tooltipItemPositionGetter.types.mjs";
+export * from "./tooltipItemPositionSelector.types.mjs";
 export * from "./legendGetter.types.mjs";
 export * from "./getSeriesWithDefaultValues.types.mjs";
 export * from "./identifierSerializer.types.mjs";

package/internals/plugins/corePlugins/useChartSeriesConfig/types/index.d.ts

@@ -5,7 +5,7 @@ export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./seriesLayout.types.js";
 export * from "./tooltipGetter.types.js";
-export * from "./tooltipItemPositionGetter.types.js";
+export * from "./tooltipItemPositionSelector.types.js";
 export * from "./legendGetter.types.js";
 export * from "./getSeriesWithDefaultValues.types.js";
 export * from "./identifierSerializer.types.js";

package/internals/plugins/corePlugins/useChartSeriesConfig/types/index.js

@@ -80,14 +80,14 @@ Object.keys(_tooltipGetter).forEach(function (key) {
     }
   });
 });
-var _tooltipItemPositionGetter = require("./tooltipItemPositionGetter.types");
-Object.keys(_tooltipItemPositionGetter).forEach(function (key) {
+var _tooltipItemPositionSelector = require("./tooltipItemPositionSelector.types");
+Object.keys(_tooltipItemPositionSelector).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _tooltipItemPositionGetter[key]) return;
+  if (key in exports && exports[key] === _tooltipItemPositionSelector[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _tooltipItemPositionGetter[key];
+      return _tooltipItemPositionSelector[key];
     }
   });
 });

package/internals/plugins/corePlugins/useChartSeriesConfig/types/index.mjs

@@ -5,7 +5,7 @@ export * from "./seriesConfig.types.mjs";
 export * from "./seriesProcessor.types.mjs";
 export * from "./seriesLayout.types.mjs";
 export * from "./tooltipGetter.types.mjs";
-export * from "./tooltipItemPositionGetter.types.mjs";
+export * from "./tooltipItemPositionSelector.types.mjs";
 export * from "./legendGetter.types.mjs";
 export * from "./getSeriesWithDefaultValues.types.mjs";
 export * from "./identifierSerializer.types.mjs";

package/internals/plugins/corePlugins/useChartSeriesConfig/types/seriesConfig.types.d.mts

@@ -7,7 +7,7 @@ import type { LegendGetter } from "./legendGetter.types.mjs";
 import type { AxisTooltipGetter, TooltipGetter } from "./tooltipGetter.types.mjs";
 import type { PolarExtremumGetter } from "./polarExtremumGetter.types.mjs";
 import type { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.mjs";
-import type { TooltipItemPositionGetter, TooltipItemPositionSelector } from "./tooltipItemPositionGetter.types.mjs";
+import type { TooltipItemPositionSelector } from "./tooltipItemPositionSelector.types.mjs";
 import type { SeriesLayoutGetter } from "./seriesLayout.types.mjs";
 import type { KeyboardFocusHandler } from "../../../featurePlugins/useChartKeyboardNavigation/keyboardFocusHandler.types.mjs";
 import type { IdentifierSerializer } from "./identifierSerializer.types.mjs";
@@ -18,6 +18,7 @@ import type { UseChartCartesianAxisSignature } from "../../../featurePlugins/use
 import type { UseChartPolarAxisSignature } from "../../../featurePlugins/useChartPolarAxis/index.mjs";
 import type { HighlightCreator } from "../../../featurePlugins/useChartHighlight/highlightCreator.types.mjs";
 import type { AxisTooltipContentProps, ItemTooltipContentProps } from "./TooltipContent.types.mjs";
+import type { SamplingStrategy } from "../../../featurePlugins/useChartCartesianAxis/sampling.types.mjs";
 export type ChartSeriesTypeRequiredPlugins<SeriesType extends ChartSeriesType> = ChartsSeriesConfig[SeriesType] extends {
   axisType: 'cartesian';
 } ? [UseChartCartesianAxisSignature] : ChartsSeriesConfig[SeriesType] extends {
@@ -33,13 +34,12 @@ export type ChartSeriesTypeConfig<SeriesType extends ChartSeriesType> = {
   legendGetter: LegendGetter<SeriesType>;
   tooltipGetter: TooltipGetter<SeriesType>;
   ItemTooltipContent?: React.ComponentType<ItemTooltipContentProps<SeriesType>>;
-  tooltipItemPositionGetter?: TooltipItemPositionGetter<SeriesType>;
   /**
-   * Computes the item tooltip position from the chart state, for series types
-   * whose position depends on state the core tooltip plugin doesn't track.
-   * Takes precedence over `tooltipItemPositionGetter`.
+   * Computes the item tooltip anchor position from the chart state. Provided by
+   * the series type so it reads only the state it needs (axes, layout, geo
+   * projection, …). When omitted, the item tooltip follows the pointer.
    */
-  selectorTooltipItemPosition?: TooltipItemPositionSelector;
+  selectorTooltipItemPosition?: TooltipItemPositionSelector<SeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<SeriesType>;
   keyboardFocusHandler?: KeyboardFocusHandler<SeriesType>;
   /**
@@ -56,6 +56,11 @@ export type ChartSeriesTypeConfig<SeriesType extends ChartSeriesType> = {
    */
   identifierCleaner: IdentifierCleaner<SeriesType>;
   getItemAtPosition?: GetItemAtPosition<SeriesType>;
+  /**
+   * Optional sampling strategy used to render large datasets. When set and sampling is enabled,
+   * the series is reduced to a zoom-appropriate level of detail before rendering.
+   */
+  sampler?: SamplingStrategy<SeriesType>;
   descriptionGetter: DescriptionGetter<SeriesType>;
   isHighlightedCreator: HighlightCreator<SeriesType>;
   isFadedCreator: HighlightCreator<SeriesType>;

package/internals/plugins/corePlugins/useChartSeriesConfig/types/seriesConfig.types.d.ts

@@ -7,7 +7,7 @@ import type { LegendGetter } from "./legendGetter.types.js";
 import type { AxisTooltipGetter, TooltipGetter } from "./tooltipGetter.types.js";
 import type { PolarExtremumGetter } from "./polarExtremumGetter.types.js";
 import type { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
-import type { TooltipItemPositionGetter, TooltipItemPositionSelector } from "./tooltipItemPositionGetter.types.js";
+import type { TooltipItemPositionSelector } from "./tooltipItemPositionSelector.types.js";
 import type { SeriesLayoutGetter } from "./seriesLayout.types.js";
 import type { KeyboardFocusHandler } from "../../../featurePlugins/useChartKeyboardNavigation/keyboardFocusHandler.types.js";
 import type { IdentifierSerializer } from "./identifierSerializer.types.js";
@@ -18,6 +18,7 @@ import type { UseChartCartesianAxisSignature } from "../../../featurePlugins/use
 import type { UseChartPolarAxisSignature } from "../../../featurePlugins/useChartPolarAxis/index.js";
 import type { HighlightCreator } from "../../../featurePlugins/useChartHighlight/highlightCreator.types.js";
 import type { AxisTooltipContentProps, ItemTooltipContentProps } from "./TooltipContent.types.js";
+import type { SamplingStrategy } from "../../../featurePlugins/useChartCartesianAxis/sampling.types.js";
 export type ChartSeriesTypeRequiredPlugins<SeriesType extends ChartSeriesType> = ChartsSeriesConfig[SeriesType] extends {
   axisType: 'cartesian';
 } ? [UseChartCartesianAxisSignature] : ChartsSeriesConfig[SeriesType] extends {
@@ -33,13 +34,12 @@ export type ChartSeriesTypeConfig<SeriesType extends ChartSeriesType> = {
   legendGetter: LegendGetter<SeriesType>;
   tooltipGetter: TooltipGetter<SeriesType>;
   ItemTooltipContent?: React.ComponentType<ItemTooltipContentProps<SeriesType>>;
-  tooltipItemPositionGetter?: TooltipItemPositionGetter<SeriesType>;
   /**
-   * Computes the item tooltip position from the chart state, for series types
-   * whose position depends on state the core tooltip plugin doesn't track.
-   * Takes precedence over `tooltipItemPositionGetter`.
+   * Computes the item tooltip anchor position from the chart state. Provided by
+   * the series type so it reads only the state it needs (axes, layout, geo
+   * projection, …). When omitted, the item tooltip follows the pointer.
    */
-  selectorTooltipItemPosition?: TooltipItemPositionSelector;
+  selectorTooltipItemPosition?: TooltipItemPositionSelector<SeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<SeriesType>;
   keyboardFocusHandler?: KeyboardFocusHandler<SeriesType>;
   /**
@@ -56,6 +56,11 @@ export type ChartSeriesTypeConfig<SeriesType extends ChartSeriesType> = {
    */
   identifierCleaner: IdentifierCleaner<SeriesType>;
   getItemAtPosition?: GetItemAtPosition<SeriesType>;
+  /**
+   * Optional sampling strategy used to render large datasets. When set and sampling is enabled,
+   * the series is reduced to a zoom-appropriate level of detail before rendering.
+   */
+  sampler?: SamplingStrategy<SeriesType>;
   descriptionGetter: DescriptionGetter<SeriesType>;
   isHighlightedCreator: HighlightCreator<SeriesType>;
   isFadedCreator: HighlightCreator<SeriesType>;

package/internals/plugins/corePlugins/useChartSeriesConfig/types/tooltipItemPositionSelector.types.d.mts

@@ -0,0 +1,18 @@
+import type { ChartSeriesType } from "../../../../../models/seriesType/config.mjs";
+import type { ChartState } from "../../../models/index.mjs";
+import type { UseChartCartesianAxisSignature } from "../../../featurePlugins/useChartCartesianAxis/index.mjs";
+import type { UseChartInteractionSignature } from "../../../featurePlugins/useChartInteraction/index.mjs";
+import type { UseChartTooltipSignature } from "../../../featurePlugins/useChartTooltip/index.mjs";
+/**
+ * Computes the anchor position of an item tooltip from the chart state. Each
+ * series type provides one of these so it reads only the state it needs (axes,
+ * layout, geo projection, …) and the feature-specific code stays out of the core
+ * bundle.
+ * @param {ChartState} state The chart state.
+ * @param {'top' | 'bottom' | 'left' | 'right' | undefined} position The preferred placement of the tooltip.
+ * @returns {{ x: number; y: number } | null} The tooltip anchor position, or `null` when it cannot be computed.
+ */
+export type TooltipItemPositionSelector<SeriesType extends ChartSeriesType> = (state: ChartState<[UseChartCartesianAxisSignature<SeriesType>, UseChartInteractionSignature, UseChartTooltipSignature<SeriesType>]>, position: 'top' | 'bottom' | 'left' | 'right' | undefined) => {
+  x: number;
+  y: number;
+} | null;

package/internals/plugins/corePlugins/useChartSeriesConfig/types/tooltipItemPositionSelector.types.d.ts

@@ -0,0 +1,18 @@
+import type { ChartSeriesType } from "../../../../../models/seriesType/config.js";
+import type { ChartState } from "../../../models/index.js";
+import type { UseChartCartesianAxisSignature } from "../../../featurePlugins/useChartCartesianAxis/index.js";
+import type { UseChartInteractionSignature } from "../../../featurePlugins/useChartInteraction/index.js";
+import type { UseChartTooltipSignature } from "../../../featurePlugins/useChartTooltip/index.js";
+/**
+ * Computes the anchor position of an item tooltip from the chart state. Each
+ * series type provides one of these so it reads only the state it needs (axes,
+ * layout, geo projection, …) and the feature-specific code stays out of the core
+ * bundle.
+ * @param {ChartState} state The chart state.
+ * @param {'top' | 'bottom' | 'left' | 'right' | undefined} position The preferred placement of the tooltip.
+ * @returns {{ x: number; y: number } | null} The tooltip anchor position, or `null` when it cannot be computed.
+ */
+export type TooltipItemPositionSelector<SeriesType extends ChartSeriesType> = (state: ChartState<[UseChartCartesianAxisSignature<SeriesType>, UseChartInteractionSignature, UseChartTooltipSignature<SeriesType>]>, position: 'top' | 'bottom' | 'left' | 'right' | undefined) => {
+  x: number;
+  y: number;
+} | null;

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

@@ -12,4 +12,6 @@ export { defaultizeXAxis, defaultizeYAxis } from "./defaultizeAxis.mjs";
 export * from "./computeAxisValue.mjs";
 export * from "./createZoomLookup.mjs";
 export * from "./zoom.types.mjs";
+export * from "./sampling.selectors.mjs";
+export type * from "./sampling.types.mjs";
 export { computeAxisAutoSize } from "./computeAxisAutoSize.mjs";

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

@@ -12,4 +12,6 @@ export { defaultizeXAxis, defaultizeYAxis } from "./defaultizeAxis.js";
 export * from "./computeAxisValue.js";
 export * from "./createZoomLookup.js";
 export * from "./zoom.types.js";
+export * from "./sampling.selectors.js";
+export type * from "./sampling.types.js";
 export { computeAxisAutoSize } from "./computeAxisAutoSize.js";

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

@@ -163,4 +163,16 @@ Object.keys(_zoom).forEach(function (key) {
     }
   });
 });
+var _sampling = require("./sampling.selectors");
+Object.keys(_sampling).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _sampling[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _sampling[key];
+    }
+  });
+});
 var _computeAxisAutoSize = require("./computeAxisAutoSize");

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

@@ -11,4 +11,5 @@ export { defaultizeXAxis, defaultizeYAxis } from "./defaultizeAxis.mjs";
 export * from "./computeAxisValue.mjs";
 export * from "./createZoomLookup.mjs";
 export * from "./zoom.types.mjs";
+export * from "./sampling.selectors.mjs";
 export { computeAxisAutoSize } from "./computeAxisAutoSize.mjs";

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.d.mts

@@ -0,0 +1,26 @@
+import type { AxisId } from "../../../../models/axis.mjs";
+import type { ChartRootSelector } from "../../utils/selectors.mjs";
+import type { UseChartCartesianAxisSignature } from "./useChartCartesianAxis.types.mjs";
+import type { SampledSeriesLookup } from "./sampling.types.mjs";
+import type { ZoomData } from "./zoom.types.mjs";
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+export declare function getFullRangeZoom(axisId: AxisId): ZoomData;
+export declare const selectorChartSamplingState: ChartRootSelector<UseChartCartesianAxisSignature, 'sampling'>;
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+export declare const selectorChartSamplingPyramids: (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 & import("./useChartCartesianAxis.types.mjs").UseChartCartesianAxisState & Partial<{}> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => SampledSeriesLookup;
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+export declare const selectorChartHighlightBucketSize: (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 & import("./useChartCartesianAxis.types.mjs").UseChartCartesianAxisState & Partial<{}> & {
+  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
+}) => Map<AxisId, number>;

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.d.ts

@@ -0,0 +1,26 @@
+import type { AxisId } from "../../../../models/axis.js";
+import type { ChartRootSelector } from "../../utils/selectors.js";
+import type { UseChartCartesianAxisSignature } from "./useChartCartesianAxis.types.js";
+import type { SampledSeriesLookup } from "./sampling.types.js";
+import type { ZoomData } from "./zoom.types.js";
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+export declare function getFullRangeZoom(axisId: AxisId): ZoomData;
+export declare const selectorChartSamplingState: ChartRootSelector<UseChartCartesianAxisSignature, 'sampling'>;
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+export declare const selectorChartSamplingPyramids: (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 & import("./useChartCartesianAxis.types.js").UseChartCartesianAxisState & Partial<{}> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => SampledSeriesLookup;
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+export declare const selectorChartHighlightBucketSize: (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 & import("./useChartCartesianAxis.types.js").UseChartCartesianAxisState & Partial<{}> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => Map<AxisId, number>;

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getFullRangeZoom = getFullRangeZoom;
+exports.selectorChartSamplingState = exports.selectorChartSamplingPyramids = exports.selectorChartHighlightBucketSize = void 0;
+var _store = require("@mui/x-internals/store");
+var _useChartSeries = require("../../corePlugins/useChartSeries");
+var _useChartSeriesConfig = require("../../corePlugins/useChartSeriesConfig");
+var _useChartDimensions = require("../../corePlugins/useChartDimensions");
+var _useChartCartesianAxisRendering = require("./useChartCartesianAxisRendering.selectors");
+const EMPTY_PYRAMIDS = {};
+const EMPTY_BUCKET_SIZES = new Map();
+
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+function getFullRangeZoom(axisId) {
+  return {
+    axisId,
+    start: 0,
+    end: 100
+  };
+}
+const selectorChartSamplingState = state => state.sampling;
+
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+exports.selectorChartSamplingState = selectorChartSamplingState;
+const selectorChartSamplingPyramids = exports.selectorChartSamplingPyramids = (0, _store.createSelectorMemoized)(selectorChartSamplingState, _useChartSeries.selectorChartSeriesProcessed, _useChartSeriesConfig.selectorChartSeriesConfig, function selectorChartSamplingPyramids(samplingState, processedSeries, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_PYRAMIDS;
+  }
+  let sampled;
+  Object.keys(processedSeries).forEach(seriesType => {
+    const method = samplingState.methods[seriesType];
+    if (!method || method === 'none') {
+      return;
+    }
+    const sampler = seriesConfig[seriesType]?.sampler;
+    const typeData = processedSeries[seriesType];
+    if (!sampler || !typeData) {
+      return;
+    }
+    for (const seriesId of typeData.seriesOrder) {
+      const built = sampler.build(typeData.series[seriesId]);
+      if (built) {
+        sampled ?? (sampled = {});
+        sampled[seriesId] = built;
+      }
+    }
+  });
+  return sampled ?? EMPTY_PYRAMIDS;
+});
+
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+const selectorChartHighlightBucketSize = exports.selectorChartHighlightBucketSize = (0, _store.createSelectorMemoized)(selectorChartSamplingState, _useChartCartesianAxisRendering.selectorChartZoomMap, _useChartCartesianAxisRendering.selectorChartXAxis, _useChartCartesianAxisRendering.selectorChartYAxis, _useChartDimensions.selectorChartDrawingArea, _useChartCartesianAxisRendering.selectorChartZoomOptionsLookup, _useChartSeriesConfig.selectorChartSeriesConfig, function selectorChartHighlightBucketSize(samplingState, zoomMap, xAxis, yAxis, drawingArea, zoomOptions, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizeAt = seriesConfig.bar?.sampler?.bucketSizeAt ?? seriesConfig.line?.sampler?.bucketSizeAt;
+  if (!bucketSizeAt) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizes = new Map();
+  [[xAxis, drawingArea.width], [yAxis, drawingArea.height]].forEach(([axes, availableSize]) => {
+    axes.axisIds.forEach(axisId => {
+      const data = axes.axis[axisId].data;
+      const zoom = zoomMap?.get(axisId) ?? getFullRangeZoom(axisId);
+      const minSpan = zoomOptions[axisId]?.minSpan ?? 0;
+      if (data) {
+        bucketSizes.set(axisId, bucketSizeAt(zoom.end - zoom.start, {
+          dataLength: data.length,
+          availableSize,
+          minSpan
+        }));
+      }
+    });
+  });
+  return bucketSizes;
+});

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.mjs

@@ -0,0 +1,81 @@
+import { createSelectorMemoized } from '@mui/x-internals/store';
+import { selectorChartSeriesProcessed } from "../../corePlugins/useChartSeries/index.mjs";
+import { selectorChartSeriesConfig } from "../../corePlugins/useChartSeriesConfig/index.mjs";
+import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/index.mjs";
+import { selectorChartXAxis, selectorChartYAxis, selectorChartZoomMap, selectorChartZoomOptionsLookup } from "./useChartCartesianAxisRendering.selectors.mjs";
+const EMPTY_PYRAMIDS = {};
+const EMPTY_BUCKET_SIZES = new Map();
+
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+export function getFullRangeZoom(axisId) {
+  return {
+    axisId,
+    start: 0,
+    end: 100
+  };
+}
+export const selectorChartSamplingState = state => state.sampling;
+
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+export const selectorChartSamplingPyramids = createSelectorMemoized(selectorChartSamplingState, selectorChartSeriesProcessed, selectorChartSeriesConfig, function selectorChartSamplingPyramids(samplingState, processedSeries, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_PYRAMIDS;
+  }
+  let sampled;
+  Object.keys(processedSeries).forEach(seriesType => {
+    const method = samplingState.methods[seriesType];
+    if (!method || method === 'none') {
+      return;
+    }
+    const sampler = seriesConfig[seriesType]?.sampler;
+    const typeData = processedSeries[seriesType];
+    if (!sampler || !typeData) {
+      return;
+    }
+    for (const seriesId of typeData.seriesOrder) {
+      const built = sampler.build(typeData.series[seriesId]);
+      if (built) {
+        sampled ??= {};
+        sampled[seriesId] = built;
+      }
+    }
+  });
+  return sampled ?? EMPTY_PYRAMIDS;
+});
+
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+export const selectorChartHighlightBucketSize = createSelectorMemoized(selectorChartSamplingState, selectorChartZoomMap, selectorChartXAxis, selectorChartYAxis, selectorChartDrawingArea, selectorChartZoomOptionsLookup, selectorChartSeriesConfig, function selectorChartHighlightBucketSize(samplingState, zoomMap, xAxis, yAxis, drawingArea, zoomOptions, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizeAt = seriesConfig.bar?.sampler?.bucketSizeAt ?? seriesConfig.line?.sampler?.bucketSizeAt;
+  if (!bucketSizeAt) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizes = new Map();
+  [[xAxis, drawingArea.width], [yAxis, drawingArea.height]].forEach(([axes, availableSize]) => {
+    axes.axisIds.forEach(axisId => {
+      const data = axes.axis[axisId].data;
+      const zoom = zoomMap?.get(axisId) ?? getFullRangeZoom(axisId);
+      const minSpan = zoomOptions[axisId]?.minSpan ?? 0;
+      if (data) {
+        bucketSizes.set(axisId, bucketSizeAt(zoom.end - zoom.start, {
+          dataLength: data.length,
+          availableSize,
+          minSpan
+        }));
+      }
+    });
+  });
+  return bucketSizes;
+});

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.types.d.mts

@@ -0,0 +1,93 @@
+import type { SeriesId } from "../../../../models/seriesType/common.mjs";
+import type { ChartSeriesType, ChartSeriesDefaultized, ChartsSeriesConfig } from "../../../../models/seriesType/config.mjs";
+import type { ZoomData } from "./zoom.types.mjs";
+/** Line sampling algorithms. `m4` pixel-accurate; `minmax` its 2-point subset; `lttb` keeps shape. */
+export type LineSamplingAlgorithm = 'm4' | 'minmax' | 'lttb';
+/** `sampling` prop method. `'none'` (default) disables; for lines it also picks the algorithm. */
+export type SamplingMethod = 'none' | LineSamplingAlgorithm;
+/** Bar `sampling` method. Bars always use a min/max envelope, so line-only algorithms are excluded. */
+export type BarSamplingMethod = 'none' | 'minmax';
+/**
+ * Per-series-type `sampling` prop on `ChartsDataProviderPro`. Derived from each type's
+ * `samplingMethod`, contributed by pro via the per-type series-config extensions (e.g.
+ * `BarSeriesExtension`). Empty in community-only builds.
+ */
+export type SamplingConfig = { [K in keyof ChartsSeriesConfig as ChartsSeriesConfig[K] extends {
+  samplingMethod: any;
+} ? K : never]?: ChartsSeriesConfig[K] extends {
+  samplingMethod: infer M;
+} ? M : never };
+/** State set by the pro `useChartProSampling` plugin; absent in community. */
+export interface SamplingState {
+  /** True when at least one series type is sampled. */
+  enabled: boolean;
+  /** Method per series type; absent/`'none'` = not sampled. */
+  methods: Partial<Record<ChartSeriesType, SamplingMethod>>;
+}
+/** Built sampling structures keyed by series id (type depends on the strategy). */
+export type SampledSeriesLookup = Record<SeriesId, unknown>;
+/**
+ * One bucket of the active level of detail: the index range it covers plus the indices to render.
+ * Lines flatten `indices` into a polyline; bars draw one merged rect over `[startIndex, endIndex]`.
+ */
+export interface SampledBucket {
+  /** First original index covered. */
+  startIndex: number;
+  /** Last original index covered (inclusive). */
+  endIndex: number;
+  /** Ascending original indices to render. */
+  indices: Int32Array;
+}
+/** Sampler inputs for one series. Bars omit `algorithm`/`getValues` (min/max envelope). */
+export interface SampleContext {
+  /** Opaque built structure (the strategy's `TBuilt`; the pyramid lives in pro). */
+  built: unknown;
+  /** Zoom of the sampled axis; `undefined` => sampler returns `null`. */
+  zoom: ZoomData | undefined;
+  /** Pixel extent along the sampled axis (band axis for bars, x-axis for lines). */
+  availableSize: number;
+  /** Axis zoom `minSpan`; level 0 (`span ≈ minSpan`) renders raw. */
+  minSpan: number;
+  /** Line algorithm. Omitted for bars, which always use the default min/max envelope. */
+  algorithm?: LineSamplingAlgorithm;
+  /**
+   * Lazy raw values, read only for `lttb`.
+   * @returns {ArrayLike<number>} The raw values.
+   */
+  getValues?: () => ArrayLike<number>;
+}
+/** Axis-level math inputs (no per-series built struct). */
+export interface AxisSamplingContext {
+  /** `axis.data.length`. */
+  dataLength: number;
+  /** Pixel extent along the band axis: width (x) / height (y). */
+  availableSize: number;
+  /** Axis zoom `minSpan`. */
+  minSpan: number;
+}
+/**
+ * Per-series-type sampling strategy, registered on `seriesConfig.sampler`. Owns both building the
+ * LOD structure and consuming it, so all algorithm code lives in pro; community calls through the
+ * pro-injected reference. `TBuilt` is opaque to community; pro narrows it per method.
+ */
+export interface SamplingStrategy<SeriesType extends ChartSeriesType = ChartSeriesType, TBuilt = unknown> {
+  /**
+   * Build the sampled structure for one series.
+   * @param {ChartSeriesDefaultized<SeriesType>} series The processed series.
+   * @returns {TBuilt | null} The built structure, or `null` if it can't be sampled.
+   */
+  build: (series: ChartSeriesDefaultized<SeriesType>) => TBuilt | null;
+  /**
+   * Active level of detail as buckets for the current zoom.
+   * @param {SampleContext} context The sampling inputs.
+   * @returns {SampledBucket[] | null} The buckets, or `null` to render raw.
+   */
+  sample?: (context: SampleContext) => SampledBucket[] | null;
+  /**
+   * Merged bucket size at a zoom span (`>= 1`; `1` = no merge), for axis-highlight widening.
+   * @param {number} span The zoom span (`end - start`).
+   * @param {AxisSamplingContext} context The axis inputs.
+   * @returns {number} The bucket size.
+   */
+  bucketSizeAt?: (span: number, context: AxisSamplingContext) => number;
+}